POST /v1/context · GET /v1/inspect

curl -X POST http://localhost:8100/v1/context \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer hk_..." \
  -d '{
    "project_id": "prj_support", "subject_id": "usr_42",
    "query": "dans quelle langue envoyer la facture ?",
    "budget_tokens": 900
  }'

response = client.context(
    subject_id="usr_42",
    query="dans quelle langue envoyer la facture ?",
    project_id="prj_support",
    budget_tokens=900,
)

const { packet, trace_id } = await client.context({
  subjectId: "usr_42",
  query: "dans quelle langue envoyer la facture ?",
  projectId: "prj_support",
});

{
  "packet": {
    "facts": [{
      "id": "f8a1c9de-...",
      "predicate": "invoice_language",
      "value": {"language": "fr"},
      "confidence": 0.9,
      "valid_from": "2026-08-01T10:00:00+00:00",
      "source_event_ids": ["7c21e4c2-..."]
    }],
    "episodes": [],
    "warnings": [],
    "status": "ok",
    "empty_reason": null
  },
  "token_count": 18,
  "trace_id": "0587fc4f-74a1-46af-a592-5789d1269072"
}

curl "http://localhost:8100/v1/inspect/0587fc4f-74a1-46af-a592-5789d1269072?project_id=prj_support&subject_id=usr_42" \
  -H "Authorization: Bearer hk_..."

{
  "trace_id": "0587fc4f-74a1-46af-a592-5789d1269072",
  "project_id": "prj_support",
  "subject_id": "usr_42",
  "query": "dans quelle langue envoyer la facture ?",
  "purpose": null,
  "packet": { "facts": [ /* ... */ ], "episodes": [], "warnings": [] },
  "decisions": [
    {"fact_id": "f8a1c9de-...", "episode_id": null, "action": "included", "reason_code": "top_score"}
  ],
  "token_count": 18
}