@agent-phonon/protocol 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../src/schemas/interaction.ts"],"names":[],"mappings":"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"}

package/dist/schemas/interaction.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { SessionId, Timestamp } from "./common.js";
+/**
+ * 人机交互协议（design 平面③ / D21）。
+ *
+ * 场景：HITL 时、或 agent 主动想问人，发一个**可交互卡片/表单**（抽象结构），
+ * phonon → server 渲染给人（飞书卡片/网页/TG 按钮…由服务端决定，复用「甩锅服务端」原则），
+ * 人填完 → 原路返回 → 注入回 agent。
+ *
+ * 两个层次：
+ *   - InteractionDirective ：agent emit 的表单定义（skill 教，让任何模型都能发）
+ *   - interaction.request   ：phonon → server 线协议（带 requestId，阻塞等回填）
+ *   - interaction.response  ：server → phonon 线协议（人填完的值）
+ *
+ * 表单只定义**抽象字段结构**，不绑定任何渲染方式——服务端自由渲染。
+ */
+/** 字段类型（抽象，渲染由服务端决定）。 */
+export const FieldType = z.enum([
+    "text", // 单行文本
+    "textarea", // 多行文本
+    "number",
+    "boolean", // 开关/勾选
+    "select", // 单选
+    "multiselect", // 多选
+    "date",
+]);
+export const FormFieldOption = z.object({
+    label: z.string(),
+    value: z.string(),
+});
+/**
+ * 表单字段——按 type 的 discriminated union（P2-16）。
+ * 每种类型携自己的 defaultValue 类型与专属字段，避免「select 该传 string 还是 string[]」的歧义。
+ */
+const FieldBase = { key: z.string().min(1), label: z.string().min(1), required: z.boolean().default(false), help: z.string().optional() };
+export const FormField = z.discriminatedUnion("type", [
+    z.object({ ...FieldBase, type: z.literal("text"), placeholder: z.string().optional(), defaultValue: z.string().optional() }),
+    z.object({ ...FieldBase, type: z.literal("textarea"), placeholder: z.string().optional(), defaultValue: z.string().optional() }),
+    z.object({ ...FieldBase, type: z.literal("number"), defaultValue: z.number().optional() }),
+    z.object({ ...FieldBase, type: z.literal("boolean"), defaultValue: z.boolean().optional() }),
+    z.object({ ...FieldBase, type: z.literal("select"), options: z.array(FormFieldOption), defaultValue: z.string().optional() }),
+    z.object({ ...FieldBase, type: z.literal("multiselect"), options: z.array(FormFieldOption), defaultValue: z.array(z.string()).optional() }),
+    z.object({ ...FieldBase, type: z.literal("date"), defaultValue: z.string().optional() }),
+]);
+/** 表单/卡片定义（抽象）。 */
+export const InteractionForm = z.object({
+    title: z.string().min(1),
+    /** 卡片正文/说明（可选）。 */
+    description: z.string().optional(),
+    fields: z.array(FormField).default([]),
+    /** 提交/操作按钮；纯通知类可只放一个「知道了」。 */
+    submitLabel: z.string().default("提交"),
+    cancelLabel: z.string().optional(),
+});
+/**
+ * agent emit 的指令（skill 教）——和 interaction.request 结构基本一致，
+ * 但不带 requestId（由 phonon 生成）。
+ */
+export const InteractionDirective = z.object({
+    form: InteractionForm,
+    /** 是否阻塞等待人回填（true=问答；false=纯通知不等）。 */
+    blocking: z.boolean().default(true),
+    /** 关联 hookId（若由 HITL hook 触发，便于和 hook.resolve 合流）。 */
+    hookId: z.string().optional(),
+});
+// --- interaction.request（phonon → server）---
+export const InteractionRequestParams = z.object({
+    /** 本次交互唯一 id，response 用它配对。 */
+    requestId: z.string().min(1),
+    sessionId: SessionId.optional(),
+    turnId: z.string().optional(),
+    form: InteractionForm,
+    blocking: z.boolean().default(true),
+    /** 关联 hookId（HITL 场景）。 */
+    hookId: z.string().optional(),
+    /**
+     * 可选超时（秒，P1-5）。超时后 phonon 以 timeout 收尾本次交互，agent 按预设继续。
+     * 0 或缺省 = 不超时（人可能去开会/带娃，长期挂起）。
+     */
+    timeoutSeconds: z.number().int().nonnegative().optional(),
+    at: Timestamp,
+});
+/** 人机交互的生命周期状态（P1-5）：pending → submitted | cancelled | timeout。 */
+export const InteractionStatus = z.enum(["pending", "submitted", "cancelled", "timeout"]);
+/** 阻塞模式下，request 的最终结果（人填完后服务端回的）。 */
+export const InteractionRequestResult = z.object({
+    requestId: z.string(),
+    /** 结果状态：submit | cancel | timeout。 */
+    action: z.enum(["submit", "cancel", "timeout"]),
+    /** 提交时各字段值（key → 值）。 */
+    values: z.record(z.union([z.string(), z.array(z.string()), z.boolean(), z.number()])).optional(),
+});
+// --- interaction.cancel（server → phonon 或 phonon 内部）：主动取消一个 pending 交互 ---
+export const InteractionCancelParams = z.object({
+    requestId: z.string().min(1),
+    reason: z.string().optional(),
+});
+export const InteractionCancelResult = z.object({
+    requestId: z.string(),
+    cancelled: z.boolean(),
+});
+/**
+ * server → phonon 的回填（非阻塞模式或异步回填走这个 notification；
+ * 阻塞模式可直接用 interaction.request 的 result 返回，二选一，实现可都支持）。
+ */
+export const InteractionResponseParams = z.object({
+    requestId: z.string().min(1),
+    action: z.enum(["submit", "cancel", "timeout"]),
+    values: z.record(z.union([z.string(), z.array(z.string()), z.boolean(), z.number()])).optional(),
+    at: Timestamp,
+});
+//# sourceMappingURL=interaction.js.map

package/dist/schemas/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/schemas/interaction.ts"],"names":[],"mappings":"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"}

package/dist/schemas/jsonrpc.d.ts

@@ -0,0 +1,314 @@
+import { z } from "zod";
+/**
+ * JSON-RPC 2.0 信封（design D2）。
+ *
+ * 单条 WebSocket 上双向跑 JSON-RPC 2.0：两端皆可作 requester。
+ * - server → phonon：session.* / discovery.* / hook.resolve
+ * - phonon → server：stream.event / hook.fired / discovery.changed / connect.hello
+ *
+ * 这里只定义「信封」的通用形状；具体方法的 params/result 由 methods.ts 绑定。
+ */
+export declare const JsonRpcVersion: z.ZodLiteral<"2.0">;
+/** 请求 id：字符串或数字（JSON-RPC 允许两者；notification 无 id）。 */
+export declare const JsonRpcId: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+export type JsonRpcId = z.infer<typeof JsonRpcId>;
+/** 请求（需要响应）。 */
+export declare const JsonRpcRequest: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}, {
+    id: string | number;
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}>;
+export type JsonRpcRequest = z.infer<typeof JsonRpcRequest>;
+/** 通知（不需要响应，无 id）——用于 stream.event / hook.fired / discovery.changed。 */
+export declare const JsonRpcNotification: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}>;
+export type JsonRpcNotification = z.infer<typeof JsonRpcNotification>;
+/** 成功响应。 */
+export declare const JsonRpcSuccess: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    result: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    jsonrpc: "2.0";
+    result?: unknown;
+}, {
+    id: string | number;
+    jsonrpc: "2.0";
+    result?: unknown;
+}>;
+export type JsonRpcSuccess = z.infer<typeof JsonRpcSuccess>;
+/** JSON-RPC error 对象；data 携带 phonon 应用级错误结构。 */
+export declare const JsonRpcErrorObject: z.ZodObject<{
+    /** JSON-RPC 传输级 code（-32700..-32600 保留；应用错误用 data.appCode 判别）。 */
+    code: z.ZodNumber;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodObject<{
+        appCode: z.ZodEnum<["errProtocolMismatch", "errUnauthorized", "errSessionNotInTenant", "errTenantQuotaExceeded", "errDeviceQuotaExceeded", "errAgentUnavailable", "errModelUnavailable", "errSessionNotFound", "errSessionTerminated", "errSessionBusy", "errCapabilityUnsupported", "errHookResolveInvalid", "errHookTimeout", "errProjectNotFound", "errProjectExists", "errProjectHasActiveSessions", "errSkillNotFound", "errSkillScopeInvalid", "errSkillInstallFailed", "errWorktreeNotFound", "errWorktreeHasChanges", "errWorktreeInUse", "errBranchNotMerged", "errBranchInUse", "errDocumentTooLarge", "errDocumentPathDenied", "errPolicyDenied", "errDuplicateRequest", "errInvalidParams", "errInternal"]>;
+        detail: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+        agentId: z.ZodOptional<z.ZodBranded<z.ZodString, "AgentId">>;
+        tenantId: z.ZodOptional<z.ZodBranded<z.ZodString, "TenantId">>;
+    }, "strip", z.ZodTypeAny, {
+        appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+        detail?: string | undefined;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        agentId?: (string & z.BRAND<"AgentId">) | undefined;
+        tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+    }, {
+        appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+        detail?: string | undefined;
+        sessionId?: string | undefined;
+        agentId?: string | undefined;
+        tenantId?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    code: number;
+    message: string;
+    data?: {
+        appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+        detail?: string | undefined;
+        sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+        agentId?: (string & z.BRAND<"AgentId">) | undefined;
+        tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+    } | undefined;
+}, {
+    code: number;
+    message: string;
+    data?: {
+        appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+        detail?: string | undefined;
+        sessionId?: string | undefined;
+        agentId?: string | undefined;
+        tenantId?: string | undefined;
+    } | undefined;
+}>;
+export type JsonRpcErrorObject = z.infer<typeof JsonRpcErrorObject>;
+/** 失败响应。 */
+export declare const JsonRpcError: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    error: z.ZodObject<{
+        /** JSON-RPC 传输级 code（-32700..-32600 保留；应用错误用 data.appCode 判别）。 */
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodObject<{
+            appCode: z.ZodEnum<["errProtocolMismatch", "errUnauthorized", "errSessionNotInTenant", "errTenantQuotaExceeded", "errDeviceQuotaExceeded", "errAgentUnavailable", "errModelUnavailable", "errSessionNotFound", "errSessionTerminated", "errSessionBusy", "errCapabilityUnsupported", "errHookResolveInvalid", "errHookTimeout", "errProjectNotFound", "errProjectExists", "errProjectHasActiveSessions", "errSkillNotFound", "errSkillScopeInvalid", "errSkillInstallFailed", "errWorktreeNotFound", "errWorktreeHasChanges", "errWorktreeInUse", "errBranchNotMerged", "errBranchInUse", "errDocumentTooLarge", "errDocumentPathDenied", "errPolicyDenied", "errDuplicateRequest", "errInvalidParams", "errInternal"]>;
+            detail: z.ZodOptional<z.ZodString>;
+            sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+            agentId: z.ZodOptional<z.ZodBranded<z.ZodString, "AgentId">>;
+            tenantId: z.ZodOptional<z.ZodBranded<z.ZodString, "TenantId">>;
+        }, "strip", z.ZodTypeAny, {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            agentId?: (string & z.BRAND<"AgentId">) | undefined;
+            tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+        }, {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: string | undefined;
+            agentId?: string | undefined;
+            tenantId?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            agentId?: (string & z.BRAND<"AgentId">) | undefined;
+            tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+        } | undefined;
+    }, {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: string | undefined;
+            agentId?: string | undefined;
+            tenantId?: string | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            agentId?: (string & z.BRAND<"AgentId">) | undefined;
+            tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+        } | undefined;
+    };
+    jsonrpc: "2.0";
+}, {
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: string | undefined;
+            agentId?: string | undefined;
+            tenantId?: string | undefined;
+        } | undefined;
+    };
+    jsonrpc: "2.0";
+}>;
+export type JsonRpcError = z.infer<typeof JsonRpcError>;
+/** 任意一条 JSON-RPC 报文。 */
+export declare const JsonRpcMessage: z.ZodUnion<[z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}, {
+    id: string | number;
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: unknown;
+}>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    result: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    id: string | number;
+    jsonrpc: "2.0";
+    result?: unknown;
+}, {
+    id: string | number;
+    jsonrpc: "2.0";
+    result?: unknown;
+}>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    error: z.ZodObject<{
+        /** JSON-RPC 传输级 code（-32700..-32600 保留；应用错误用 data.appCode 判别）。 */
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodObject<{
+            appCode: z.ZodEnum<["errProtocolMismatch", "errUnauthorized", "errSessionNotInTenant", "errTenantQuotaExceeded", "errDeviceQuotaExceeded", "errAgentUnavailable", "errModelUnavailable", "errSessionNotFound", "errSessionTerminated", "errSessionBusy", "errCapabilityUnsupported", "errHookResolveInvalid", "errHookTimeout", "errProjectNotFound", "errProjectExists", "errProjectHasActiveSessions", "errSkillNotFound", "errSkillScopeInvalid", "errSkillInstallFailed", "errWorktreeNotFound", "errWorktreeHasChanges", "errWorktreeInUse", "errBranchNotMerged", "errBranchInUse", "errDocumentTooLarge", "errDocumentPathDenied", "errPolicyDenied", "errDuplicateRequest", "errInvalidParams", "errInternal"]>;
+            detail: z.ZodOptional<z.ZodString>;
+            sessionId: z.ZodOptional<z.ZodBranded<z.ZodString, "SessionId">>;
+            agentId: z.ZodOptional<z.ZodBranded<z.ZodString, "AgentId">>;
+            tenantId: z.ZodOptional<z.ZodBranded<z.ZodString, "TenantId">>;
+        }, "strip", z.ZodTypeAny, {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            agentId?: (string & z.BRAND<"AgentId">) | undefined;
+            tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+        }, {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: string | undefined;
+            agentId?: string | undefined;
+            tenantId?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            agentId?: (string & z.BRAND<"AgentId">) | undefined;
+            tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+        } | undefined;
+    }, {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: string | undefined;
+            agentId?: string | undefined;
+            tenantId?: string | undefined;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: (string & z.BRAND<"SessionId">) | undefined;
+            agentId?: (string & z.BRAND<"AgentId">) | undefined;
+            tenantId?: (string & z.BRAND<"TenantId">) | undefined;
+        } | undefined;
+    };
+    jsonrpc: "2.0";
+}, {
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: {
+            appCode: "errProtocolMismatch" | "errUnauthorized" | "errSessionNotInTenant" | "errTenantQuotaExceeded" | "errDeviceQuotaExceeded" | "errAgentUnavailable" | "errModelUnavailable" | "errSessionNotFound" | "errSessionTerminated" | "errSessionBusy" | "errCapabilityUnsupported" | "errHookResolveInvalid" | "errHookTimeout" | "errProjectNotFound" | "errProjectExists" | "errProjectHasActiveSessions" | "errSkillNotFound" | "errSkillScopeInvalid" | "errSkillInstallFailed" | "errWorktreeNotFound" | "errWorktreeHasChanges" | "errWorktreeInUse" | "errBranchNotMerged" | "errBranchInUse" | "errDocumentTooLarge" | "errDocumentPathDenied" | "errPolicyDenied" | "errDuplicateRequest" | "errInvalidParams" | "errInternal";
+            detail?: string | undefined;
+            sessionId?: string | undefined;
+            agentId?: string | undefined;
+            tenantId?: string | undefined;
+        } | undefined;
+    };
+    jsonrpc: "2.0";
+}>]>;
+export type JsonRpcMessage = z.infer<typeof JsonRpcMessage>;
+/** 标准 JSON-RPC 传输级错误码。 */
+export declare const JSON_RPC_CODES: {
+    readonly parseError: -32700;
+    readonly invalidRequest: -32600;
+    readonly methodNotFound: -32601;
+    readonly invalidParams: -32602;
+    readonly internalError: -32603;
+    /** 应用级错误统一用这个 code，细分看 data.appCode。 */
+    readonly applicationError: -32000;
+};
+//# sourceMappingURL=jsonrpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.d.ts","sourceRoot":"","sources":["../../src/schemas/jsonrpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AAEH,eAAO,MAAM,cAAc,qBAAmB,CAAC;AAE/C,qDAAqD;AACrD,eAAO,MAAM,SAAS,wCAAoC,CAAC;AAC3D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,gBAAgB;AAChB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,wEAAwE;AACxE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,YAAY;AACZ,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,gDAAgD;AAChD,eAAO,MAAM,kBAAkB;IAC7B,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIlE,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,YAAY;AACZ,eAAO,MAAM,YAAY;;;;QARvB,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYlE,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,wBAAwB;AACxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAhBzB,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqBlE,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,0BAA0B;AAC1B,eAAO,MAAM,cAAc;;;;;;IAMzB,wCAAwC;;CAEhC,CAAC"}

package/dist/schemas/jsonrpc.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { PhononErrorData } from "./common.js";
+/**
+ * JSON-RPC 2.0 信封（design D2）。
+ *
+ * 单条 WebSocket 上双向跑 JSON-RPC 2.0：两端皆可作 requester。
+ * - server → phonon：session.* / discovery.* / hook.resolve
+ * - phonon → server：stream.event / hook.fired / discovery.changed / connect.hello
+ *
+ * 这里只定义「信封」的通用形状；具体方法的 params/result 由 methods.ts 绑定。
+ */
+export const JsonRpcVersion = z.literal("2.0");
+/** 请求 id：字符串或数字（JSON-RPC 允许两者；notification 无 id）。 */
+export const JsonRpcId = z.union([z.string(), z.number()]);
+/** 请求（需要响应）。 */
+export const JsonRpcRequest = z.object({
+    jsonrpc: JsonRpcVersion,
+    id: JsonRpcId,
+    method: z.string(),
+    params: z.unknown().optional(),
+});
+/** 通知（不需要响应，无 id）——用于 stream.event / hook.fired / discovery.changed。 */
+export const JsonRpcNotification = z.object({
+    jsonrpc: JsonRpcVersion,
+    method: z.string(),
+    params: z.unknown().optional(),
+});
+/** 成功响应。 */
+export const JsonRpcSuccess = z.object({
+    jsonrpc: JsonRpcVersion,
+    id: JsonRpcId,
+    result: z.unknown(),
+});
+/** JSON-RPC error 对象；data 携带 phonon 应用级错误结构。 */
+export const JsonRpcErrorObject = z.object({
+    /** JSON-RPC 传输级 code（-32700..-32600 保留；应用错误用 data.appCode 判别）。 */
+    code: z.number().int(),
+    message: z.string(),
+    data: PhononErrorData.optional(),
+});
+/** 失败响应。 */
+export const JsonRpcError = z.object({
+    jsonrpc: JsonRpcVersion,
+    id: JsonRpcId.nullable(),
+    error: JsonRpcErrorObject,
+});
+/** 任意一条 JSON-RPC 报文。 */
+export const JsonRpcMessage = z.union([
+    JsonRpcRequest,
+    JsonRpcNotification,
+    JsonRpcSuccess,
+    JsonRpcError,
+]);
+/** 标准 JSON-RPC 传输级错误码。 */
+export const JSON_RPC_CODES = {
+    parseError: -32700,
+    invalidRequest: -32600,
+    methodNotFound: -32601,
+    invalidParams: -32602,
+    internalError: -32603,
+    /** 应用级错误统一用这个 code，细分看 data.appCode。 */
+    applicationError: -32000,
+};
+//# sourceMappingURL=jsonrpc.js.map

package/dist/schemas/jsonrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/schemas/jsonrpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAE/C,qDAAqD;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAG3D,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,cAAc;IACvB,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAGH,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAGH,YAAY;AACZ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,cAAc;IACvB,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC;AAGH,gDAAgD;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,kEAAkE;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAGH,YAAY;AACZ,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,cAAc;IACvB,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE;IACxB,KAAK,EAAE,kBAAkB;CAC1B,CAAC,CAAC;AAGH,wBAAwB;AACxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,cAAc;IACd,mBAAmB;IACnB,cAAc;IACd,YAAY;CACb,CAAC,CAAC;AAGH,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,CAAC,KAAK;IAClB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;IACrB,aAAa,EAAE,CAAC,KAAK;IACrB,wCAAwC;IACxC,gBAAgB,EAAE,CAAC,KAAK;CAChB,CAAC"}