REST API.

curl "http://localhost:4000/v1/oauth/preview?slug=my-app"

{
  "app": { "name": "My App", "slug": "my-app", "iconUrl": "https://..." },
  "manifest": {
    "scopes": ["identity:read", "memory:read:fitness", "memory:write:fitness"],
    "eventTypes": ["workout.completed"],
    "intents": ["coach"]
  }
}

curl -X POST http://localhost:4000/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "code": "oc_a1b2c3...",
    "client_id": "app_123",
    "client_secret": "sk_live_..."
  }'

{
  "connection_token": "ct_9f8e7d...",
  "ai_id": "ai_42",
  "scopes": ["identity:read", "memory:read:fitness", "memory:write:fitness"]
}

curl http://localhost:4000/v1/identity/brief \
  -H "Authorization: Bearer $CONNECTION_TOKEN"

{
  "brief": "Goes by Nova. Prefers concise, encouraging replies and metric units.",
  "ai_name": "Nova",
  "generated_at": "2026-05-21T10:00:00.000Z",
  "source_memory_count": 37,
  "cached": true
}

curl -X POST http://localhost:4000/v1/memories \
  -H "Authorization: Bearer $CONNECTION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "memories": [
    { "content": "Ran 5k in 28:10.", "kind": "event", "scope": "fitness.running" }
  ] }'

{
  "accepted": true,
  "memoryIds": ["mem_1c2d..."]
}

curl -X POST http://localhost:4000/v1/signals \
  -H "Authorization: Bearer $CONNECTION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "type": "calendar.slot_free", "payload": { "start": "14:00" } }'

curl "http://localhost:4000/v1/memories?scope=fitness&query=marathon&limit=5" \
  -H "Authorization: Bearer $CONNECTION_TOKEN"

{
  "memories": [
    {
      "id": "mem_1c2d...",
      "type": "goal",
      "scope": "fitness",
      "content": "Training for a spring marathon, target sub-4:00.",
      "importance": 80,
      "confidence": 90,
      "pinned": true,
      "occurredAt": "2026-04-02T09:12:00.000Z",
      "sourceApp": "my-app"
    }
  ],
  "next_cursor": null
}

curl "http://localhost:4000/v1/context?intent=coach&query=today%27s%20plan&limit=8" \
  -H "Authorization: Bearer $CONNECTION_TOKEN"

{
  "identity": { "aiId": "ai_42", "name": "Nova" },
  "memories": [
    { "id": "mem_1c2d...", "type": "goal", "scope": "fitness",
      "content": "Sub-4:00 marathon by spring.", "importance": 80,
      "occurredAt": "2026-04-02T09:12:00.000Z", "sourceApp": "my-app" }
  ],
  "relationships": [
    { "subject": "user", "relation": "trains_with", "object": "running club" }
  ],
  "suggestions": { "adaptation": "Be concise and encouraging.", "tags": ["concise"] },
  "generatedAt": "2026-05-21T10:00:00.000Z"
}

curl -X POST http://localhost:4000/v1/gateway/chat \
  -H "Authorization: Bearer $CONNECTION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "coach",
    "userMessage": "How did my week go?",
    "appContext": { "view": "weekly-summary" }
  }'

{
  "reply": "Strong week — three runs, 18 km total. One more easy run keeps you on pace.",
  "toneTags": ["encouraging", "concise"],
  "memoryCandidates": [
    { "type": "event", "scope": "fitness",
      "content": "Ran 18 km across three sessions this week.", "importance": 40 }
  ],
  "usage": { "tokensIn": 812, "tokensOut": 96, "model": "pambase-host-1" }
}

curl -X POST http://localhost:4000/v1/schedule \
  -H "Authorization: Bearer $CONNECTION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fireAt": "2026-05-22T07:00:00.000Z",
    "kind": "morning-checkin",
    "payload": { "tip": "Easy run today" }
  }'

{ "id": "trg_5e6f...", "fireAt": "2026-05-22T07:00:00.000Z" }

curl http://localhost:4000/v1/catalog

{
  "version": "1.0.0",
  "memoryKinds": [{ "type": "goal", "description": "..." }],
  "systemScopes": [{ "scope": "identity:read", "description": "..." }],
  "standardScopes": [{ "namespace": "fitness", "description": "..." }],
  "standardEvents": [{ "type": "workout.completed", "payload": [/* ... */] }],
  "standardIntents": [{ "intent": "coach", "description": "..." }]
}