Supervisor API

The Supervisor worker orchestrates agent execution and manages project state, artifacts, and execution traces.

Base URL

Local: http://localhost:8787
Production: https://parti-supervisor.your-subdomain.workers.dev

Endpoints

Project Management

GET /api/projects

List all projects.

[
  {
    "id": "project-uuid",
    "name": "Project Name",
    "product_seed": "Product description...",
    "current_phase": "prd",
    "status": "active",
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z"
  }
]

GET /api/hydrate/:projectId

Master hydration endpoint for project state.

{
  "project": {
    "id": "project-uuid",
    "name": "Project Name",
    "current_phase": "prd",
    "status": "active"
  },
  "history": {
    "logs": [...],
    "artifacts": [...],
    "checkpoints": [...]
  }
}

Project Creation

POST /api/projects

Create a new project.

{
  "name": "Project Name",
  "product_seed": "Product description..."
}

{
  "id": "project-uuid",
  "name": "Project Name",
  "product_seed": "Product description...",
  "current_phase": "prd",
  "status": "active",
  "created_at": "2024-01-01T00:00:00.000Z"
}

Agent Execution

POST /api/execute

Execute agent workflow (streaming). Headers:

Accept: text/event-stream - For SSE streaming
X-Project-ID: project-uuid - Project identifier

{
  "projectId": "project-uuid",
  "phase": "prd"
}

Streaming Response (SSE):

event: agent_start
data: {"agent": "prd", "phase": "prd"}

event: agent_progress
data: {"agent": "prd", "progress": 50}

event: agent_complete
data: {"agent": "prd", "artifact": {...}}

event: phase_complete
data: {"phase": "prd", "status": "complete"}

Artifact Management

GET /api/artifacts/:projectId

Get all artifacts for a project.

[
  {
    "id": "artifact-uuid",
    "project_id": "project-uuid",
    "phase": "prd",
    "type": "markdown",
    "content": "# Product Requirements...",
    "created_at": "2024-01-01T00:00:00.000Z"
  }
]

Execution Traces

GET /api/traces/:projectId

Get execution traces for a project.

[
  {
    "id": "trace-uuid",
    "project_id": "project-uuid",
    "phase": "prd",
    "agent": "prd-agent",
    "status": "complete",
    "created_at": "2024-01-01T00:00:00.000Z"
  }
]

Streaming API

The supervisor supports Server-Sent Events (SSE) for real-time progress updates:

const eventSource = new EventSource(
  '/api/execute?projectId=project-uuid&phase=prd',
  { headers: { 'X-Project-ID': 'project-uuid' } }
);

eventSource.addEventListener('agent_start', (e) => {
  const data = JSON.parse(e.data);
  console.log(`Agent started: ${data.agent}`);
});

eventSource.addEventListener('agent_complete', (e) => {
  const data = JSON.parse(e.data);
  console.log(`Agent completed: ${data.agent}`);
});

Human-in-the-Loop (HITL)

The supervisor supports interrupt signals for human review:

Interrupt Signal: system_state.interrupt_signal: true
Status: system_state.status: "interrupted"
Review Required: Agent execution pauses for human approval

Agent API - Agent worker APIs
Backend Supervisor - Implementation details

Getting Started

Gateway API

MetaCogna RAG

MetaCogna.ai Landing

Parti Architecture

Design System

Base URL

Endpoints

Project Management

GET /api/projects

GET /api/hydrate/:projectId

Project Creation

POST /api/projects

Agent Execution

POST /api/execute

Artifact Management

GET /api/artifacts/:projectId

Execution Traces

GET /api/traces/:projectId

Streaming API

Human-in-the-Loop (HITL)

​Base URL

​Endpoints

​Project Management

​GET /api/projects

​GET /api/hydrate/:projectId

​Project Creation

​POST /api/projects

​Agent Execution

​POST /api/execute

​Artifact Management

​GET /api/artifacts/:projectId

​Execution Traces

​GET /api/traces/:projectId

​Streaming API

​Human-in-the-Loop (HITL)

​Related Documentation

Base URL

Endpoints

Project Management

GET /api/projects

GET /api/hydrate/:projectId

Project Creation

POST /api/projects

Agent Execution

POST /api/execute

Artifact Management

GET /api/artifacts/:projectId

Execution Traces

GET /api/traces/:projectId

Streaming API

Human-in-the-Loop (HITL)

Related Documentation