FastAPI Shell

create_strategy_app(strategy) exposes the shell as a FastAPI application. Requests and responses use Pydantic models, so the same shell can be called by an app, a local script, an agent, or another system in the loop. Responses use a simple envelope:

{
  "output": {},
  "strategy": "analysis-shell",
  "metadata": {}
}

Health And Metadata

GET /health
GET /strategy
GET /resources
GET /packages
GET /tactics
GET /channels

These endpoints are read-only and useful for smoke tests, UI surfaces, and agent handoff. They are the shell's ls and env.

Shell Run

POST /run

Request:

{
  "input": {"task": "summarize"},
  "context": {"request": "demo"}
}

/run calls the shell runner. If no runner is configured, it returns the default shell pack.

Tactic Run

POST /tactics/{name}/run

This invokes the resource named {name} and marks the response metadata endpoint as tactic.

Generic Resource Invocation

POST /resources/{name}/invoke

This is the universal escape hatch. It can invoke tactics, services, channels, or custom resources by local shell name.

Channel Events

POST /channels/{name}/events
GET /channels/{name}/events

Append request:

{
  "input": {
    "kind": "record",
    "source": "client",
    "payload": {"text": "hello"},
    "metadata": {"demo": true}
  }
}

Query parameters:

• after_cursor: non-negative integer, default 0.
• limit: positive integer, default 100.
• kind: optional event kind filter.

AAAX converts channel validation errors into 400 responses and missing resources into 404 responses.