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

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:

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

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: documentation index.
docs/wf_cli.md: CLI lifecycle, remote targets, and common diagnostics.
docs/runbooks/python-source.md: trusted project-local Python source setup and workflow-run flow.
docs/source_architecture.md: source package boundaries and terms such as source, tool, workflow capability, resource, and prompt.
docs/wf_api_architecture.md: current API, server, transport, and source package boundaries.
docs/project_map.md: package map, entrypoints, examples, and verification commands.
docs/current_roadmap.md: active next work.

Historical design notes and completed implementation plans live under 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.