API Reference

Agent endpoints are mounted at /agent.

Status

GET /agent/status

Returns provider name and configuration flags.

Workflows

GET /agent/workflows

List registered domains and stages.

GET /agent/workflows/{slug}

Project workflow state (requires auth + existing project).

PUT /agent/workflows/{slug}

Update domain/stage for a project.

{ "domain": "pdlc", "stage": "develop" }

Public demo

POST /agent/demo — no authentication required.

{
  "message": "Discover requirements for a todo app",
  "session_id": "optional-session-id",
  "domain": "pdlc",
  "stage": "discover",
  "advance": false
}

Response includes message, session_id, workflow, and demo: true.

Chat (sync)

POST /agent/chat — requires authentication.

{
  "message": "Implement the todo list",
  "project_slug": "my-app",
  "domain": "pdlc",
  "stage": "develop",
  "advance": false
}

Stream (SSE)

GET /agent/stream?message=...&project_slug=...&domain=pdlc&stage=develop&advance=false

Events: status, workflow, stage, content, tool_call, tool_result, files_changed, error, done, close.

History

GET /agent/history/{slug} — conversation history for a project.

AgentMessage fields

Field	Type	Required	Description
`message`	string	yes	User prompt
`project_slug`	string	yes (chat)	Project identifier
`domain`	string	no	Workflow domain (default: `pdlc`)
`stage`	string	no	Active stage (default: saved or first)
`advance`	bool	no	Advance to next stage before running