aps-agent/contracts/schemas/envelope.schema.json

26 lines
1.2 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://aps.local/contracts/envelope.schema.json",
"title": "EventEnvelope",
"description": "服务端推给客户端的事件信封(协议 v1)。界面只依赖这一层,不感知引擎差异。",
"$defs": {
"status": {
"type": "string",
"enum": ["accepted", "pending-confirmation", "succeeded", "failed"]
},
"envelope": {
"type": "object",
"required": ["v", "seq", "ts", "sessionId", "type", "data"],
"properties": {
"v": { "const": 1, "description": "协议版本;改协议就加版本,不改这一版" },
"seq": { "type": "integer", "minimum": 1, "description": "会话内单调递增;断点续传与去重靠它" },
"ts": { "type": "integer", "description": "发生时间,整数毫秒(ADR-0007)" },
"sessionId": { "type": "string", "minLength": 1 },
"runId": { "type": "string", "description": "一次运行(回合)的标识;同会话可先后多个 run" },
"type": { "type": "string" },
"data": { "type": "object" }
},
"additionalProperties": false
}
}
}