65 lines
2.4 KiB
Markdown
65 lines
2.4 KiB
Markdown
# lda.chat workflow platform
|
|
|
|
This repository is building a workflow runtime for AI-assisted digital work.
|
|
Agents discover capabilities, author typed workflows, validate them, deploy
|
|
them, and run them through a deterministic executor. The LLM plans; the runtime
|
|
executes.
|
|
|
|
## Quick Start
|
|
|
|
```powershell
|
|
uv run wf --help
|
|
uv run wf --local cap list --format ids
|
|
uv run wf --local cap inspect wf.std.constant
|
|
uv run wf --local cap call wf.std.constant --input '{"value":"hello"}'
|
|
uv run pytest -q
|
|
```
|
|
|
|
Run the durable JSON-RPC server:
|
|
|
|
```powershell
|
|
uv run wf-rpc-server --config wf.config.json --host 127.0.0.1 --port 8765
|
|
uv run wf --url http://127.0.0.1:8765/rpc cap list --format ids
|
|
```
|
|
|
|
## Current Shape
|
|
|
|
```text
|
|
wf_cli
|
|
-> wf_transport_rpc_http or local target
|
|
-> wf_server
|
|
-> wf_api
|
|
-> wf_core / wf_artifacts / wf_sources_*
|
|
```
|
|
|
|
- `wf_core`: deterministic graph/runtime kernel.
|
|
- `wf_authoring`: Python authoring helpers and `NodeSpec` creation.
|
|
- `wf_api`: workflow application surface shared by local and remote frontends.
|
|
- `wf_server`: durable server composition boundary.
|
|
- `wf_transport_rpc_http`: JSON-RPC-over-HTTP client/server transport.
|
|
- `wf_sources_mcp`: upstream MCP source implementation and persistent runtime.
|
|
- `wf_mcp`: MCP frontend, legacy entrypoints, proxy/admin glue, and compatibility
|
|
shims during extraction.
|
|
- `wf_cli`: command-line frontend over local or remote workflow APIs.
|
|
|
|
## Start Reading
|
|
|
|
- [docs/README.md](docs/README.md): documentation index.
|
|
- [docs/wf_cli.md](docs/wf_cli.md): CLI lifecycle, remote targets, and common
|
|
diagnostics.
|
|
- [docs/runbooks/python-source.md](docs/runbooks/python-source.md): trusted
|
|
project-local Python source setup and workflow-run flow.
|
|
- [docs/source_architecture.md](docs/source_architecture.md): source package
|
|
boundaries and terms such as source, tool, workflow capability, resource, and
|
|
prompt.
|
|
- [docs/wf_api_architecture.md](docs/wf_api_architecture.md): current API,
|
|
server, transport, and source package boundaries.
|
|
- [docs/project_map.md](docs/project_map.md): package map, entrypoints, examples,
|
|
and verification commands.
|
|
- [docs/current_roadmap.md](docs/current_roadmap.md): active next work.
|
|
|
|
Historical design notes and completed implementation plans live under
|
|
[docs/historical/](docs/historical/). The previous long top-level running-design
|
|
note is intentionally no longer the project front door; current model details
|
|
are split across the docs index above.
|