{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://aps.local/contracts/http.schema.json",
  "title": "HTTP payloads",
  "description": "HTTP 请求体与响应体的形状。端点、方法与状态码见 docs/spec/protocol.md；本文件只定义数据形状。带自己文件的类型（会话、能力、回执、审批请求、错误）不在这里重复。",
  "$defs": {
    "HealthResponse": {
      "type": "object",
      "required": ["status", "version", "protocolVersion"],
      "properties": {
        "status": { "const": "ok" },
        "version": { "type": "string" },
        "protocolVersion": { "type": "integer" }
      },
      "additionalProperties": false
    },
    "MeResponse": {
      "type": "object",
      "required": ["userId", "tenantId", "displayName", "clientKind"],
      "properties": {
        "userId": { "type": "string" },
        "tenantId": { "type": "string" },
        "displayName": { "type": "string" },
        "clientKind": { "type": "string", "enum": ["desktop", "browser"] }
      },
      "additionalProperties": false
    },
    "ProjectSummary": {
      "type": "object",
      "required": ["projectId", "name", "status", "writable"],
      "properties": {
        "projectId": { "type": "string" },
        "name": { "type": "string" },
        "status": { "type": "string", "enum": ["active", "archived"] },
        "writable": { "type": "boolean", "description": "项目内可写；个人会话只读（ADR-0003）" }
      },
      "additionalProperties": false
    },
    "ProjectListResponse": {
      "type": "object",
      "required": ["projects"],
      "properties": {
        "projects": { "type": "array", "items": { "$ref": "#/$defs/ProjectSummary" } }
      },
      "additionalProperties": false
    },
    "CapabilitiesResponse": {
      "type": "object",
      "required": ["capabilities"],
      "properties": {
        "capabilities": { "type": "array", "items": { "$ref": "capability.schema.json#/$defs/CapabilitySummary" } }
      },
      "additionalProperties": false
    },
    "ChatMessage": {
      "type": "object",
      "required": ["messageId", "role", "ts", "text"],
      "properties": {
        "messageId": { "type": "string" },
        "role": { "type": "string", "enum": ["user", "assistant", "system"] },
        "ts": { "type": "integer" },
        "text": { "type": "string" }
      },
      "additionalProperties": false
    },
    "CreateSessionRequest": {
      "type": "object",
      "required": ["scope"],
      "properties": {
        "projectId": { "type": "string" },
        "scope": { "type": "string", "enum": ["personal", "project"] },
        "title": { "type": "string" }
      },
      "additionalProperties": false
    },
    "CreateSessionResponse": {
      "type": "object",
      "required": ["session"],
      "properties": {
        "session": { "$ref": "session.schema.json#/$defs/SessionSummary" }
      },
      "additionalProperties": false
    },
    "SessionListResponse": {
      "type": "object",
      "required": ["sessions"],
      "properties": {
        "sessions": { "type": "array", "items": { "$ref": "session.schema.json#/$defs/SessionSummary" } }
      },
      "additionalProperties": false
    },
    "SessionDetailResponse": {
      "type": "object",
      "required": ["session", "messages"],
      "properties": {
        "session": { "$ref": "session.schema.json#/$defs/SessionSummary" },
        "messages": { "type": "array", "items": { "$ref": "#/$defs/ChatMessage" } }
      },
      "additionalProperties": false
    },
    "SendMessageRequest": {
      "type": "object",
      "required": ["text", "idempotencyKey"],
      "properties": {
        "text": { "type": "string", "minLength": 1 },
        "idempotencyKey": { "type": "string", "minLength": 8 }
      },
      "additionalProperties": false
    },
    "SendMessageResponse": {
      "type": "object",
      "required": ["accepted", "messageId", "runId"],
      "properties": {
        "accepted": { "const": true },
        "messageId": { "type": "string" },
        "runId": { "type": "string" }
      },
      "additionalProperties": false
    },
    "CancelResponse": {
      "type": "object",
      "required": ["state"],
      "properties": {
        "state": { "type": "string", "enum": ["cancelling", "idle"] }
      },
      "additionalProperties": false
    },
    "ApprovalDecisionResponse": {
      "type": "object",
      "required": ["approvalId", "decision"],
      "properties": {
        "approvalId": { "type": "string" },
        "decision": { "type": "string", "enum": ["approved", "rejected", "expired"] },
        "receipt": { "$ref": "receipt.schema.json#/$defs/ExecutionReceipt" }
      },
      "additionalProperties": false
    }
  }
}