REST API

{
  "id":              "resp_abc123",
  "conversation_id": "conv_xyz",
  "input":           "Summarise last week's sales data",
  "output":          [{ "type": "text", "text": "Here is the summary..." }],
  "status":          "completed",  // "in_progress" | "completed" | "failed"
  "model":           "claude-opus-4-8",
  "usage":           { "input_tokens": 120, "output_tokens": 340 },
  "created_at":      "2026-06-11T10:00:00Z"
}

{
  "id":           "conv_abc123",
  "project_id":   "proj_xyz",           // null if not project-scoped
  "title":        "Q2 analysis",
  "goal":         "Analyse Q2 revenue by region",  // task prompt, optional
  "status":       "active",             // "active" | "archived"
  "created_at":   "2026-06-11T10:00:00Z",
  "updated_at":   "2026-06-11T10:04:12Z"
}

{
  "id":             "proj_abc123",
  "name":           "Sales Automation",
  "description":    "Weekly reporting flows",
  "connector_ids":  ["conn_001", "conn_002"],
  "skill_ids":      ["skill_abc"],
  "created_at":     "2026-06-11T10:00:00Z",
  "updated_at":     "2026-06-11T10:00:00Z"
}

{
  "id":          "art_abc123",
  "project_id":  "proj_xyz",
  "title":       "Sales Dashboard",
  "type":        "app",      // "app" | "report" | "doc" | "dashboard"
  "path":        "sales_dashboard/index.html",  // relative path within project
  "created_at":  "2026-06-11T10:00:00Z",
  "updated_at":  "2026-06-11T10:00:00Z"
}

{
  "id":              "sched_abc123",
  "project_id":      "proj_xyz",
  "cron":            "0 9 * * 1",       // standard 5-field cron expression
  "timezone":        "America/New_York",
  "prompt":          "Generate weekly sales digest",
  "conversation_id": null,             // null = create new conversation each run
  "status":          "active",         // "active" | "paused"
  "last_run_at":     "2026-06-09T09:00:00Z",
  "next_run_at":     "2026-06-16T09:00:00Z",
  "created_at":      "2026-06-01T00:00:00Z"
}

{
  "id":              "file_abc123",
  "name":            "Q2-report.pdf",
  "mime_type":       "application/pdf",
  "size":            204800,           // bytes
  "project_id":      "proj_xyz",       // null if conversation-scoped only
  "conversation_id": null,             // null if project-scoped only
  "created_at":      "2026-06-11T10:00:00Z"
}

{
  "id":           "postgres",
  "name":         "PostgreSQL",
  "description":  "Connect to any PostgreSQL-compatible database.",
  "auth_type":    "credentials",  // "credentials" | "oauth2"
  "fields": [                       // credential fields required at connection time
    { "key": "host",     "label": "Host",     "secret": false },
    { "key": "port",     "label": "Port",     "secret": false },
    { "key": "database", "label": "Database", "secret": false },
    { "key": "user",     "label": "User",     "secret": false },
    { "key": "password", "label": "Password", "secret": true  }
  ]
}

{
  "id":         "conn_abc123",
  "spec_id":    "postgres",       // which ConnectorSpec this uses
  "name":       "prod-db",
  "status":     "connected",      // "connected" | "error" | "pending"
  "created_at": "2026-06-11T10:00:00Z"
  // credentials are never returned
}

{
  "id":           "mem_abc123",
  "content":      "Prefers executive summaries under 200 words.",
  "project_id":   null,            // null = global; string = project-scoped
  "source":       "user",          // "user" | "agent" — who created it
  "created_at":   "2026-06-11T10:00:00Z",
  "updated_at":   "2026-06-11T10:00:00Z"
}

{
  "id":            "skill_abc123",
  "name":          "weekly-report",
  "description":   "Generates a weekly performance report from connected data sources.",
  "instructions":  "Always include a one-paragraph executive summary first. Use bullet points for metrics...",
  "tools": [        // external tool integrations this skill may invoke
    "sql_query",
    "send_email"
  ],
  "created_at":    "2026-06-11T10:00:00Z",
  "updated_at":    "2026-06-11T10:00:00Z"
}

{
  "id":              "sp_abc123",
  "conversation_id": "conv_xyz",
  "title":           "Sales analysis draft",
  "cells":           [ /* ordered array of Cell objects */ ],
  "saved":           false,     // true once promoted / pinned
  "created_at":      "2026-06-11T10:00:00Z",
  "updated_at":      "2026-06-11T10:04:12Z"
}

{
  "id":        "cell_001",
  "type":      "code",          // "markdown" | "code" | "output"
  "content":   "df.describe()",
  "language":  "python",        // present when type = "code"
  "status":    "success",       // "pending" | "running" | "success" | "error"
  "outputs":   [                 // present when type = "output"
    {
      "mime":    "text/plain",
      "data":    "count    12.0\nmean     4.2\n..."
    },
    {
      "mime":    "image/png",
      "data":    "data:image/png;base64,..."
    }
  ],
  "error":     null,            // error message when status = "error"
  "index":     0                 // display order within the scratchpad
}

{
  "type":       "conversation",   // "conversation" | "artifact" | "file" | "memory"
  "id":         "conv_abc123",
  "title":      "Sales forecast Q3",
  "excerpt":    "...the Q3 sales forecast shows a 12% increase over...",
  "score":      0.93,             // relevance score 0–1
  "project_id": "proj_xyz"        // null for global results
}