Dispatch

Dispatch is a generic webhook-to-steer service for Codex app-server based systems. It is the product-neutral port of the dispatch.key.store resident identity pattern:

1. Providers or MCP tools send notifications.
2. Dispatch authenticates and normalizes the event.
3. Dispatch writes an idempotent steer to SQLite.
4. A supervisor can deliver the steer into a resident Codex app-server thread for the configured identity.

The service is intentionally configured from TOML. New identities, webhook sources, routes, and small program hooks do not require a Rust edit.

Quick Start

cargo run -- serve --config examples/dispatch.toml
curl -s http://127.0.0.1:9120/healthz
curl -s -X POST http://127.0.0.1:9120/webhook/generic \
  -H 'content-type: application/json' \
  -d '{"event":"book.search.changed","identity":"assistant","query":"octavia butler"}'
curl -s http://127.0.0.1:9120/v1/steers?status=pending

Use --with-supervisor or [dispatch.appserver] enabled = true when the host has an authenticated Codex home and a resident identity policy. The supervisor uses the app-server protocol directly and rejects interactive approval or elicitation requests fail-closed.

Capabilities

• Dynamic webhook sources under /webhook/{source} or source-owned paths.
• Auth modes: none, bearer token, query token, HMAC-SHA256.
• Secret-free topology view at GET /topology.
• Idempotent event and steer persistence.
• Basic MCP endpoint at POST /mcp with tools for recording notifications, listing steers, and reading topology.
• Command programs for JavaScript or other scripting runtimes.
• Optional wasm_c_abi program type when built with --features wasm.
• Codex app-server supervisor that maintains resident identity threads.

Documentation

• Configuration
• Ontology
• Programs
• MCP
• 8914 Deployment