@agent-phonon/protocol 0.2.0

package/dist/json-schema/skill.list.json

@@ -0,0 +1,101 @@
+{
+  "direction": "s2p",
+  "kind": "request",
+  "params": {
+    "$ref": "#/definitions/skill.list.params",
+    "definitions": {
+      "skill.list.params": {
+        "type": "object",
+        "properties": {
+          "agent": {
+            "type": "string",
+            "minLength": 1
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "global",
+              "project"
+            ]
+          },
+          "projectId": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  },
+  "result": {
+    "$ref": "#/definitions/skill.list.result",
+    "definitions": {
+      "skill.list.result": {
+        "type": "object",
+        "properties": {
+          "skills": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "agent": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "scope": {
+                  "type": "string",
+                  "enum": [
+                    "global",
+                    "project"
+                  ]
+                },
+                "projectId": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "version": {
+                  "type": "string"
+                },
+                "hash": {
+                  "type": "string"
+                },
+                "compatibleAgents": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/definitions/skill.list.result/properties/skills/items/properties/agent"
+                  }
+                },
+                "sourceTrusted": {
+                  "type": "boolean"
+                },
+                "installedPath": {
+                  "type": "string"
+                },
+                "installedAt": {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              },
+              "required": [
+                "name",
+                "agent",
+                "scope"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "skills"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  }
+}

package/dist/json-schema/skill.uninstall.json

@@ -0,0 +1,76 @@
+{
+  "direction": "s2p",
+  "kind": "request",
+  "params": {
+    "$ref": "#/definitions/skill.uninstall.params",
+    "definitions": {
+      "skill.uninstall.params": {
+        "type": "object",
+        "properties": {
+          "agent": {
+            "type": "string",
+            "minLength": 1
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "global",
+              "project"
+            ]
+          },
+          "projectId": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "agent",
+          "name",
+          "scope"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  },
+  "result": {
+    "$ref": "#/definitions/skill.uninstall.result",
+    "definitions": {
+      "skill.uninstall.result": {
+        "type": "object",
+        "properties": {
+          "agent": {
+            "type": "string",
+            "minLength": 1
+          },
+          "name": {
+            "type": "string"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "global",
+              "project"
+            ]
+          },
+          "uninstalled": {
+            "type": "boolean",
+            "const": true
+          }
+        },
+        "required": [
+          "agent",
+          "name",
+          "scope",
+          "uninstalled"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  }
+}

package/dist/json-schema/stream.ack.json

@@ -0,0 +1,36 @@
+{
+  "direction": "s2p",
+  "kind": "notification",
+  "params": {
+    "$ref": "#/definitions/stream.ack.params",
+    "definitions": {
+      "stream.ack.params": {
+        "type": "object",
+        "properties": {
+          "sessionId": {
+            "type": "string",
+            "minLength": 1
+          },
+          "lastSeq": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "required": [
+          "lastSeq"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  },
+  "result": {
+    "$ref": "#/definitions/stream.ack.result",
+    "definitions": {
+      "stream.ack.result": {
+        "not": {}
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  }
+}

package/dist/json-schema/stream.event.json

@@ -0,0 +1,381 @@
+{
+  "direction": "p2s",
+  "kind": "notification",
+  "params": {
+    "$ref": "#/definitions/stream.event.params",
+    "definitions": {
+      "stream.event.params": {
+        "anyOf": [
+          {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "turnId": {
+                "type": "string"
+              },
+              "origin": {
+                "type": "string",
+                "enum": [
+                  "solicited",
+                  "unsolicited"
+                ],
+                "default": "solicited"
+              },
+              "source": {
+                "type": "string"
+              },
+              "seq": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "at": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "type": {
+                "type": "string",
+                "const": "message"
+              },
+              "role": {
+                "type": "string",
+                "enum": [
+                  "assistant",
+                  "user",
+                  "system"
+                ],
+                "default": "assistant"
+              },
+              "text": {
+                "type": "string"
+              },
+              "delta": {
+                "type": "boolean",
+                "default": false
+              }
+            },
+            "required": [
+              "sessionId",
+              "turnId",
+              "seq",
+              "at",
+              "type",
+              "text"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/sessionId"
+              },
+              "turnId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/turnId"
+              },
+              "origin": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/origin"
+              },
+              "source": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/source"
+              },
+              "seq": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/seq"
+              },
+              "at": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/at"
+              },
+              "type": {
+                "type": "string",
+                "const": "thinking"
+              },
+              "text": {
+                "type": "string"
+              },
+              "delta": {
+                "type": "boolean",
+                "default": false
+              }
+            },
+            "required": [
+              "sessionId",
+              "turnId",
+              "seq",
+              "at",
+              "type",
+              "text"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/sessionId"
+              },
+              "turnId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/turnId"
+              },
+              "origin": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/origin"
+              },
+              "source": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/source"
+              },
+              "seq": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/seq"
+              },
+              "at": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/at"
+              },
+              "type": {
+                "type": "string",
+                "const": "tool_call"
+              },
+              "toolName": {
+                "type": "string"
+              },
+              "args": {},
+              "toolCallId": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "sessionId",
+              "turnId",
+              "seq",
+              "at",
+              "type",
+              "toolName"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/sessionId"
+              },
+              "turnId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/turnId"
+              },
+              "origin": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/origin"
+              },
+              "source": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/source"
+              },
+              "seq": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/seq"
+              },
+              "at": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/at"
+              },
+              "type": {
+                "type": "string",
+                "const": "tool_result"
+              },
+              "toolName": {
+                "type": "string"
+              },
+              "toolCallId": {
+                "type": "string"
+              },
+              "ok": {
+                "type": "boolean"
+              },
+              "output": {}
+            },
+            "required": [
+              "sessionId",
+              "turnId",
+              "seq",
+              "at",
+              "type",
+              "toolName",
+              "ok"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/sessionId"
+              },
+              "turnId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/turnId"
+              },
+              "origin": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/origin"
+              },
+              "source": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/source"
+              },
+              "seq": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/seq"
+              },
+              "at": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/at"
+              },
+              "type": {
+                "type": "string",
+                "const": "token"
+              },
+              "text": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "sessionId",
+              "turnId",
+              "seq",
+              "at",
+              "type",
+              "text"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/sessionId"
+              },
+              "turnId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/turnId"
+              },
+              "origin": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/origin"
+              },
+              "source": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/source"
+              },
+              "seq": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/seq"
+              },
+              "at": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/at"
+              },
+              "type": {
+                "type": "string",
+                "const": "result"
+              },
+              "text": {
+                "type": "string"
+              },
+              "usage": {
+                "type": "object",
+                "properties": {
+                  "inputTokens": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "outputTokens": {
+                    "type": "integer",
+                    "minimum": 0
+                  }
+                },
+                "additionalProperties": false
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "completed",
+                  "interrupted",
+                  "aborted",
+                  "failed",
+                  "timeout"
+                ],
+                "default": "completed"
+              },
+              "final": {
+                "type": "boolean",
+                "const": true
+              }
+            },
+            "required": [
+              "sessionId",
+              "turnId",
+              "seq",
+              "at",
+              "type",
+              "text",
+              "final"
+            ],
+            "additionalProperties": false
+          },
+          {
+            "type": "object",
+            "properties": {
+              "sessionId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/sessionId"
+              },
+              "turnId": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/turnId"
+              },
+              "origin": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/origin"
+              },
+              "source": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/source"
+              },
+              "seq": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/seq"
+              },
+              "at": {
+                "$ref": "#/definitions/stream.event.params/anyOf/0/properties/at"
+              },
+              "type": {
+                "type": "string",
+                "const": "error"
+              },
+              "message": {
+                "type": "string"
+              },
+              "appCode": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "failed",
+                  "aborted",
+                  "timeout",
+                  "interrupted"
+                ],
+                "default": "failed"
+              },
+              "final": {
+                "type": "boolean",
+                "const": true
+              }
+            },
+            "required": [
+              "sessionId",
+              "turnId",
+              "seq",
+              "at",
+              "type",
+              "message",
+              "final"
+            ],
+            "additionalProperties": false
+          }
+        ]
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  },
+  "result": {
+    "$ref": "#/definitions/stream.event.result",
+    "definitions": {
+      "stream.event.result": {
+        "not": {}
+      }
+    },
+    "$schema": "http://json-schema.org/draft-07/schema#"
+  }
+}

package/dist/schemas/capabilities.d.ts

@@ -0,0 +1,90 @@
+import { z } from "zod";
+/**
+ * Hook 类型 — 归一化的拦截点（design §8）。
+ * adapter 负责把各家原生 hook 点（Codex hooks / Claude Code PreToolUse /
+ * OpenClaw 审批…）映射成这些归一化类型。
+ */
+export declare const HookType: z.ZodEnum<["pre_tool", "post_tool", "pre_command", "pre_file_write", "pre_network", "session_start", "session_end", "notification"]>;
+export type HookType = z.infer<typeof HookType>;
+/**
+ * Adapter 能力声明（design §7）。
+ * adapter 不假装统一，而是声明自己原生支持什么，phonon core 据此补齐缺口。
+ * 这份能力随 discovery 一起暴露给服务端，服务端先知能力再决定怎么用。
+ */
+export declare const AgentCapabilities: z.ZodObject<{
+    /** 原生 session / resume（无则由 core 用注册表模拟）。 */
+    nativeSession: z.ZodBoolean;
+    /** 原生上下文压缩（决定 session.compress mode=native 是否可用）。 */
+    nativeCompression: z.ZodBoolean;
+    /** 原生上下文注入。 */
+    contextInjection: z.ZodBoolean;
+    /**
+     * 是否会**主动/非请求触发地输出**（design 订阅模型）。
+     * OpenClaw 这类有 cron/心跳/定时任务，同一 session 内会不定期自发冲泡 → true；
+     * Codex 这类一次性，流到结果就结束 → false。
+     * server 据此判断哪些 session 需要长期保持监听。
+     */
+    proactiveOutput: z.ZodBoolean;
+    /** 是否支持同会话中途切换模型（design D16）。 */
+    modelSwitch: z.ZodBoolean;
+    /** 是否支持打断正在进行的 turn（session.interrupt / whenBusy=interrupt，D18）。 */
+    interrupt: z.ZodBoolean;
+    /** 是否支持中途插入输入（下一次 tool call 边界，whenBusy=inject，D18）。 */
+    injectMidTurn: z.ZodBoolean;
+    /** 是否支持给该 agent 安装/卸载 skill（skill.* 接口，D24）。 */
+    skillManagement: z.ZodBoolean;
+    /** 原生支持的 hook 点（其余由 core 尽力补齐或不支持）。 */
+    hooks: z.ZodArray<z.ZodEnum<["pre_tool", "post_tool", "pre_command", "pre_file_write", "pre_network", "session_start", "session_end", "notification"]>, "many">;
+    /** 是否支持流式输出。 */
+    streaming: z.ZodBoolean;
+    /**
+     * 可选调度限制（P2-13）：server 据此做调度/背压。
+     */
+    limits: z.ZodOptional<z.ZodObject<{
+        maxConcurrentSessions: z.ZodOptional<z.ZodNumber>;
+        maxContextTokens: z.ZodOptional<z.ZodNumber>;
+        maxMessageBytes: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxConcurrentSessions?: number | undefined;
+        maxContextTokens?: number | undefined;
+        maxMessageBytes?: number | undefined;
+    }, {
+        maxConcurrentSessions?: number | undefined;
+        maxContextTokens?: number | undefined;
+        maxMessageBytes?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    nativeSession: boolean;
+    nativeCompression: boolean;
+    contextInjection: boolean;
+    proactiveOutput: boolean;
+    modelSwitch: boolean;
+    interrupt: boolean;
+    injectMidTurn: boolean;
+    skillManagement: boolean;
+    hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+    streaming: boolean;
+    limits?: {
+        maxConcurrentSessions?: number | undefined;
+        maxContextTokens?: number | undefined;
+        maxMessageBytes?: number | undefined;
+    } | undefined;
+}, {
+    nativeSession: boolean;
+    nativeCompression: boolean;
+    contextInjection: boolean;
+    proactiveOutput: boolean;
+    modelSwitch: boolean;
+    interrupt: boolean;
+    injectMidTurn: boolean;
+    skillManagement: boolean;
+    hooks: ("pre_tool" | "post_tool" | "pre_command" | "pre_file_write" | "pre_network" | "session_start" | "session_end" | "notification")[];
+    streaming: boolean;
+    limits?: {
+        maxConcurrentSessions?: number | undefined;
+        maxContextTokens?: number | undefined;
+        maxMessageBytes?: number | undefined;
+    } | undefined;
+}>;
+export type AgentCapabilities = z.infer<typeof AgentCapabilities>;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/schemas/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/schemas/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,QAAQ,sIASnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,4CAA4C;;IAE5C,qDAAqD;;IAErD,eAAe;;IAEf;;;;;OAKG;;IAEH,iCAAiC;;IAEjC,oEAAoE;;IAEpE,wDAAwD;;IAExD,gDAAgD;;IAEhD,uCAAuC;;IAEvC,gBAAgB;;IAEhB;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQH,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}