api/conversational_api_v0.json

{
  "version": "v0",
  "one_liner": "one front door over graph state and control policy",
  "request_contract": {
    "fields": [
      "user_input",
      "thread_state",
      "receipt_state",
      "task_state",
      "tool_state",
      "alpha_state"
    ],
    "auto_hydrated_context": [
      "system_context",
      "policy_context",
      "lineage_context"
    ]
  },
  "response_contract": {
    "fields": [
      "lane",
      "control_vector",
      "tensor_surface",
      "execution_gate",
      "receipt_requirements",
      "ui_projection",
      "decision_brief",
      "inference",
      "system_context"
    ],
    "context_contract_ref": "api/system_context_v0.json"
  },
  "orientation_rule": "a fresh agent should read one API packet and immediately know where it is, what governs it, and which payload shapes it can emit",
  "lane_rule": "the runtime should not open the broad codebase until a bounded execution task exists",
  "why": "graph-first reasoning should stay the default and code access should stay narrow"
}