@agent-phonon/protocol 0.2.0

package/dist/schemas/capabilities.js

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

package/dist/schemas/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/schemas/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC;IAC7B,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,kCAAkC;IACjD,gBAAgB,EAAE,OAAO;IACzB,aAAa,EAAE,aAAa;IAC5B,eAAe,EAAE,OAAO;IACxB,aAAa,EAAE,OAAO;IACtB,cAAc,EAAE,uBAAuB;CACxC,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,4CAA4C;IAC5C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,qDAAqD;IACrD,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC9B,eAAe;IACf,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC7B;;;;;OAKG;IACH,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;IAC5B,iCAAiC;IACjC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;IACxB,oEAAoE;IACpE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,wDAAwD;IACxD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,gDAAgD;IAChD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;IAC5B,uCAAuC;IACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IACxB,gBAAgB;IAChB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB;;OAEG;IACH,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAC7D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACxD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KACxD,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/dist/schemas/common.d.ts

@@ -0,0 +1,66 @@
+import { z } from "zod";
+/**
+ * agent-phonon wire protocol — shared primitives.
+ *
+ * 设计参考 docs/design.md。本文件定义全协议复用的基础类型：
+ * 协议版本、各类 ID、verbosity、错误码。
+ */
+/** 协议语义版本。device 与 server 握手时比对（见 connect.hello）。 */
+export declare const PROTOCOL_VERSION: "0.1.0";
+/** phonon 侧全局唯一的 session id（归属某一 tenant）。 */
+export declare const SessionId: z.ZodBranded<z.ZodString, "SessionId">;
+export type SessionId = z.infer<typeof SessionId>;
+/** discovery 返回的 agent 标识，也是 session.create 的 `agent` 入参。 */
+export declare const AgentId: z.ZodBranded<z.ZodString, "AgentId">;
+export type AgentId = z.infer<typeof AgentId>;
+/** 项目标识（项目 = 目录 + Git）。所有 session 必须绑定一个项目。 */
+export declare const ProjectId: z.ZodBranded<z.ZodString, "ProjectId">;
+export type ProjectId = z.infer<typeof ProjectId>;
+/** 本地配置赋予的稳定租户 id（= 一条服务端连接，见 design D13）。 */
+export declare const TenantId: z.ZodBranded<z.ZodString, "TenantId">;
+export type TenantId = z.infer<typeof TenantId>;
+/** 设备自身标识（一台设备一个，用于服务端区分多设备，但 phonon 不感知其他设备）。 */
+export declare const DeviceId: z.ZodBranded<z.ZodString, "DeviceId">;
+export type DeviceId = z.infer<typeof DeviceId>;
+/**
+ * 4 档详细度，create 时设定、send 可覆盖：
+ * - final    : 仅最终结果
+ * - messages : 每轮消息
+ * - tools    : 含工具调用
+ * - trace    : 全量（含思考）
+ */
+export declare const Verbosity: z.ZodEnum<["final", "messages", "tools", "trace"]>;
+export type Verbosity = z.infer<typeof Verbosity>;
+/**
+ * 应用级错误码（区别于 JSON-RPC 传输级 code）。
+ * 放在 JSON-RPC error 对象的 `data.appCode` 字段，便于调用方稳定判别。
+ */
+export declare const PhononErrorCode: 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"]>;
+export type PhononErrorCode = z.infer<typeof PhononErrorCode>;
+/** 统一附在 JSON-RPC error.data 上的结构。 */
+export declare const PhononErrorData: 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>;
+    /** 可选：相关 session/agent/tenant，便于服务端定位。 */
+    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;
+}>;
+export type PhononErrorData = z.infer<typeof PhononErrorData>;
+/** ISO-8601 时间戳字符串（统一用字符串，避免时区/精度歧义）。 */
+export declare const Timestamp: z.ZodString;
+export type Timestamp = z.infer<typeof Timestamp>;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AAMjD,6CAA6C;AAC7C,eAAO,MAAM,SAAS,wCAAyC,CAAC;AAChE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,OAAO,sCAAuC,CAAC;AAC5D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,+CAA+C;AAC/C,eAAO,MAAM,SAAS,wCAAyC,CAAC;AAChE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,8CAA8C;AAC9C,eAAO,MAAM,QAAQ,uCAAwC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,kDAAkD;AAClD,eAAO,MAAM,QAAQ,uCAAwC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAMhD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,oDAAkD,CAAC;AACzE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAMlD;;;GAGG;AACH,eAAO,MAAM,eAAe,grBA2C1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,qCAAqC;AACrC,eAAO,MAAM,eAAe;;IAE1B,0BAA0B;;IAE1B,0CAA0C;;;;;;;;;;;;;;;;EAI1C,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,yCAAyC;AACzC,eAAO,MAAM,SAAS,aAAwC,CAAC;AAC/D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+/**
+ * agent-phonon wire protocol — shared primitives.
+ *
+ * 设计参考 docs/design.md。本文件定义全协议复用的基础类型：
+ * 协议版本、各类 ID、verbosity、错误码。
+ */
+/** 协议语义版本。device 与 server 握手时比对（见 connect.hello）。 */
+export const PROTOCOL_VERSION = "0.1.0";
+// ---------------------------------------------------------------------------
+// ID 原语（全部是不透明字符串，调用方不应解析其结构）
+// ---------------------------------------------------------------------------
+/** phonon 侧全局唯一的 session id（归属某一 tenant）。 */
+export const SessionId = z.string().min(1).brand();
+/** discovery 返回的 agent 标识，也是 session.create 的 `agent` 入参。 */
+export const AgentId = z.string().min(1).brand();
+/** 项目标识（项目 = 目录 + Git）。所有 session 必须绑定一个项目。 */
+export const ProjectId = z.string().min(1).brand();
+/** 本地配置赋予的稳定租户 id（= 一条服务端连接，见 design D13）。 */
+export const TenantId = z.string().min(1).brand();
+/** 设备自身标识（一台设备一个，用于服务端区分多设备，但 phonon 不感知其他设备）。 */
+export const DeviceId = z.string().min(1).brand();
+// ---------------------------------------------------------------------------
+// Verbosity — 控制 session 返回内容的多少（design §4）
+// ---------------------------------------------------------------------------
+/**
+ * 4 档详细度，create 时设定、send 可覆盖：
+ * - final    : 仅最终结果
+ * - messages : 每轮消息
+ * - tools    : 含工具调用
+ * - trace    : 全量（含思考）
+ */
+export const Verbosity = z.enum(["final", "messages", "tools", "trace"]);
+// ---------------------------------------------------------------------------
+// 错误码 — JSON-RPC error.data.code 用（design 中提到的归一化错误）
+// ---------------------------------------------------------------------------
+/**
+ * 应用级错误码（区别于 JSON-RPC 传输级 code）。
+ * 放在 JSON-RPC error 对象的 `data.appCode` 字段，便于调用方稳定判别。
+ */
+export const PhononErrorCode = z.enum([
+    // 协议/握手
+    "errProtocolMismatch", // device 与 server 协议版本不兼容
+    "errUnauthorized", // device key 无效（注：终端用户鉴权在 server，不在此）
+    // 租户隔离（design §6 / D13）
+    "errSessionNotInTenant", // 跨租户访问 session
+    "errTenantQuotaExceeded", // 触达 per-tenant 配额
+    "errDeviceQuotaExceeded", // 触达全局配额
+    // 发现 / agent 绑定（design §5 / D14 / D15）
+    "errAgentUnavailable", // 目标 agent 不存在或不可用
+    "errModelUnavailable", // 模型不在该 agent 的可用列表内
+    // session 生命周期
+    "errSessionNotFound",
+    "errSessionTerminated", // 操作了已结束的 session
+    "errSessionBusy", // session 正忙（如上一轮未结束）
+    // 能力
+    "errCapabilityUnsupported", // adapter 不支持该操作（如 native 压缩缺失）
+    // hook / HITL
+    "errHookResolveInvalid", // hook.resolve 的裁决非法
+    "errHookTimeout", // 等待服务端裁决超时
+    // 项目 / skill（D23-D26）
+    "errProjectNotFound",
+    "errProjectExists", // 同名/同路径项目已存在
+    "errProjectHasActiveSessions", // 项目下还有 active session（remove 拦）
+    "errSkillNotFound",
+    "errSkillScopeInvalid", // scope=project 但缺 projectId 等
+    "errSkillInstallFailed",
+    // git / worktree（D25）
+    "errWorktreeNotFound",
+    "errWorktreeHasChanges", // 未提交变更，非 force 不清
+    "errWorktreeInUse", // worktree 还有 active session
+    "errBranchNotMerged", // 分支未合并，非 force 不删
+    "errBranchInUse", // 分支仍被某 worktree 检出
+    // 文档 / 上传（D20）
+    "errDocumentTooLarge", // 超 maxUploadBytes
+    "errDocumentPathDenied", // 路径不在项目范围 / 命中 deny
+    // 本地 policy（D27）
+    "errPolicyDenied", // 被设备本地安全策略拦截
+    // 幂等
+    "errDuplicateRequest", // clientRequestId 重复（已处理过）
+    // 通用
+    "errInvalidParams",
+    "errInternal",
+]);
+/** 统一附在 JSON-RPC error.data 上的结构。 */
+export const PhononErrorData = z.object({
+    appCode: PhononErrorCode,
+    /** 可选的人类可读补充（不用于程序判别）。 */
+    detail: z.string().optional(),
+    /** 可选：相关 session/agent/tenant，便于服务端定位。 */
+    sessionId: SessionId.optional(),
+    agentId: AgentId.optional(),
+    tenantId: TenantId.optional(),
+});
+/** ISO-8601 时间戳字符串（统一用字符串，避免时区/精度歧义）。 */
+export const Timestamp = z.string().datetime({ offset: true });
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

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

package/dist/schemas/connect.d.ts

@@ -0,0 +1,111 @@
+import { z } from "zod";
+/**
+ * 连接握手（design §6）。
+ *
+ * phonon 拨出连接后，首先发 connect.hello 表明：协议版本、设备身份。
+ * device key 的鉴权由传输层/服务端处理（如 WS header / 首帧），不在业务 params 里明文带。
+ * server 回 connect.welcome 确认，并可下发 tenant 绑定与服务端能力。
+ */
+export declare const ConnectHelloParams: z.ZodObject<{
+    /** 本端协议版本（= PROTOCOL_VERSION）。 */
+    protocolVersion: z.ZodString;
+    /** 设备标识（服务端用于区分多设备）。 */
+    deviceId: z.ZodBranded<z.ZodString, "DeviceId">;
+    /** phonon 实现版本（软件版本，便于服务端兼容处理）。 */
+    phononVersion: z.ZodOptional<z.ZodString>;
+    /** 本端声明支持的可选特性开关，便于前向兼容。 */
+    features: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** 设备鉴权（可选）：server 据此验证设备身份。也可走传输层 header。 */
+    auth: z.ZodOptional<z.ZodObject<{
+        deviceKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        deviceKey: string;
+    }, {
+        deviceKey: string;
+    }>>;
+    /**
+     * 重连时携带（P0-4）：phonon 本地 outbox 中每个 session 尚未被 ack 的起始 seq，
+     * 让 server 知道哪些要补发 / 从哪重放。首次连接可省略。
+     */
+    resumeFrom: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        fromSeq: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        sessionId: string;
+        fromSeq: number;
+    }, {
+        sessionId: string;
+        fromSeq: number;
+    }>, "many">>;
+    at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    protocolVersion: string;
+    deviceId: string & z.BRAND<"DeviceId">;
+    features: string[];
+    phononVersion?: string | undefined;
+    auth?: {
+        deviceKey: string;
+    } | undefined;
+    resumeFrom?: {
+        sessionId: string;
+        fromSeq: number;
+    }[] | undefined;
+}, {
+    at: string;
+    protocolVersion: string;
+    deviceId: string;
+    phononVersion?: string | undefined;
+    features?: string[] | undefined;
+    auth?: {
+        deviceKey: string;
+    } | undefined;
+    resumeFrom?: {
+        sessionId: string;
+        fromSeq: number;
+    }[] | undefined;
+}>;
+export type ConnectHelloParams = z.infer<typeof ConnectHelloParams>;
+export declare const ConnectWelcomeResult: z.ZodObject<{
+    /** 服务端协议版本。 */
+    protocolVersion: z.ZodString;
+    /** 服务端为本连接分配/确认的租户身份（= 一条服务端连接，design D13）。 */
+    tenantId: z.ZodBranded<z.ZodString, "TenantId">;
+    /** 服务端声明支持的可选特性。 */
+    features: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * 重连时服务端告知「我各 session 最后收到的 seq」（P0-4），
+     * phonon 据此从 outbox 精确补发（> lastSeq 的），避免重复/遗漏。
+     */
+    ackedSeqs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        lastSeq: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        sessionId: string;
+        lastSeq: number;
+    }, {
+        sessionId: string;
+        lastSeq: number;
+    }>, "many">>;
+    at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    tenantId: string & z.BRAND<"TenantId">;
+    protocolVersion: string;
+    features: string[];
+    ackedSeqs?: {
+        sessionId: string;
+        lastSeq: number;
+    }[] | undefined;
+}, {
+    at: string;
+    tenantId: string;
+    protocolVersion: string;
+    features?: string[] | undefined;
+    ackedSeqs?: {
+        sessionId: string;
+        lastSeq: number;
+    }[] | undefined;
+}>;
+export type ConnectWelcomeResult = z.infer<typeof ConnectWelcomeResult>;
+//# sourceMappingURL=connect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/schemas/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB;IAC7B,kCAAkC;;IAElC,wBAAwB;;IAExB,mCAAmC;;IAEnC,4BAA4B;;IAE5B,8CAA8C;;;;;;;;IAE9C;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKH,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;IAC/B,eAAe;;IAEf,+CAA+C;;IAE/C,oBAAoB;;IAEpB;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKH,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/schemas/connect.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { DeviceId, TenantId, Timestamp } from "./common.js";
+/**
+ * 连接握手（design §6）。
+ *
+ * phonon 拨出连接后，首先发 connect.hello 表明：协议版本、设备身份。
+ * device key 的鉴权由传输层/服务端处理（如 WS header / 首帧），不在业务 params 里明文带。
+ * server 回 connect.welcome 确认，并可下发 tenant 绑定与服务端能力。
+ */
+export const ConnectHelloParams = z.object({
+    /** 本端协议版本（= PROTOCOL_VERSION）。 */
+    protocolVersion: z.string(),
+    /** 设备标识（服务端用于区分多设备）。 */
+    deviceId: DeviceId,
+    /** phonon 实现版本（软件版本，便于服务端兼容处理）。 */
+    phononVersion: z.string().optional(),
+    /** 本端声明支持的可选特性开关，便于前向兼容。 */
+    features: z.array(z.string()).default([]),
+    /** 设备鉴权（可选）：server 据此验证设备身份。也可走传输层 header。 */
+    auth: z.object({ deviceKey: z.string() }).optional(),
+    /**
+     * 重连时携带（P0-4）：phonon 本地 outbox 中每个 session 尚未被 ack 的起始 seq，
+     * 让 server 知道哪些要补发 / 从哪重放。首次连接可省略。
+     */
+    resumeFrom: z
+        .array(z.object({ sessionId: z.string(), fromSeq: z.number().int().nonnegative() }))
+        .optional(),
+    at: Timestamp,
+});
+export const ConnectWelcomeResult = z.object({
+    /** 服务端协议版本。 */
+    protocolVersion: z.string(),
+    /** 服务端为本连接分配/确认的租户身份（= 一条服务端连接，design D13）。 */
+    tenantId: TenantId,
+    /** 服务端声明支持的可选特性。 */
+    features: z.array(z.string()).default([]),
+    /**
+     * 重连时服务端告知「我各 session 最后收到的 seq」（P0-4），
+     * phonon 据此从 outbox 精确补发（> lastSeq 的），避免重复/遗漏。
+     */
+    ackedSeqs: z
+        .array(z.object({ sessionId: z.string(), lastSeq: z.number().int().nonnegative() }))
+        .optional(),
+    at: Timestamp,
+});
+//# sourceMappingURL=connect.js.map

package/dist/schemas/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/schemas/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,kCAAkC;IAClC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,QAAQ;IAClB,mCAAmC;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,4BAA4B;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,8CAA8C;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD;;;OAGG;IACH,UAAU,EAAE,CAAC;SACV,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;SACnF,QAAQ,EAAE;IACb,EAAE,EAAE,SAAS;CACd,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,eAAe;IACf,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,+CAA+C;IAC/C,QAAQ,EAAE,QAAQ;IAClB,oBAAoB;IACpB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC;;;OAGG;IACH,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;SACnF,QAAQ,EAAE;IACb,EAAE,EAAE,SAAS;CACd,CAAC,CAAC"}

package/dist/schemas/device.d.ts

@@ -0,0 +1,221 @@
+import { z } from "zod";
+/**
+ * 设备级信息与可观测协议。
+ *
+ * device.info：相对静态的 OS/机器信息，用于服务端按需调度。
+ * device.resources：运行时资源快照，用于 debug，不做资源调度或限制。
+ */
+export declare const DeviceInfoParams: z.ZodDefault<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+export type DeviceInfoParams = z.infer<typeof DeviceInfoParams>;
+export declare const DeviceInfoResult: z.ZodObject<{
+    at: z.ZodString;
+    hostname: z.ZodString;
+    os: z.ZodObject<{
+        platform: z.ZodUnion<[z.ZodEnum<["aix", "darwin", "freebsd", "linux", "openbsd", "sunos", "win32", "cygwin", "netbsd"]>, z.ZodString]>;
+        type: z.ZodString;
+        release: z.ZodString;
+        arch: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        platform: string;
+        release: string;
+        arch: string;
+    }, {
+        type: string;
+        platform: string;
+        release: string;
+        arch: string;
+    }>;
+    runtime: z.ZodOptional<z.ZodObject<{
+        node: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        node?: string | undefined;
+    }, {
+        node?: string | undefined;
+    }>>;
+    /** 便于 server 做粗粒度任务路由：ios-development/windows-desktop-development/nvidia-gpu 等。 */
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    capabilities: string[];
+    hostname: string;
+    os: {
+        type: string;
+        platform: string;
+        release: string;
+        arch: string;
+    };
+    runtime?: {
+        node?: string | undefined;
+    } | undefined;
+}, {
+    at: string;
+    hostname: string;
+    os: {
+        type: string;
+        platform: string;
+        release: string;
+        arch: string;
+    };
+    capabilities?: string[] | undefined;
+    runtime?: {
+        node?: string | undefined;
+    } | undefined;
+}>;
+export type DeviceInfoResult = z.infer<typeof DeviceInfoResult>;
+export declare const DeviceResourcesParams: z.ZodDefault<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+export type DeviceResourcesParams = z.infer<typeof DeviceResourcesParams>;
+export declare const DeviceResourcesResult: z.ZodObject<{
+    at: z.ZodString;
+    cpu: z.ZodOptional<z.ZodObject<{
+        loadavg: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        cores: z.ZodOptional<z.ZodNumber>;
+        usagePercent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        usagePercent?: number | undefined;
+        loadavg?: number[] | undefined;
+        cores?: number | undefined;
+    }, {
+        usagePercent?: number | undefined;
+        loadavg?: number[] | undefined;
+        cores?: number | undefined;
+    }>>;
+    memory: z.ZodObject<{
+        totalBytes: z.ZodNumber;
+        freeBytes: z.ZodNumber;
+        usedBytes: z.ZodNumber;
+        usagePercent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalBytes: number;
+        freeBytes: number;
+        usedBytes: number;
+        usagePercent?: number | undefined;
+    }, {
+        totalBytes: number;
+        freeBytes: number;
+        usedBytes: number;
+        usagePercent?: number | undefined;
+    }>;
+    disk: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        totalBytes: z.ZodOptional<z.ZodNumber>;
+        freeBytes: z.ZodOptional<z.ZodNumber>;
+        usedBytes: z.ZodOptional<z.ZodNumber>;
+        usagePercent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        usagePercent?: number | undefined;
+        totalBytes?: number | undefined;
+        freeBytes?: number | undefined;
+        usedBytes?: number | undefined;
+    }, {
+        path: string;
+        usagePercent?: number | undefined;
+        totalBytes?: number | undefined;
+        freeBytes?: number | undefined;
+        usedBytes?: number | undefined;
+    }>>;
+    gpu: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        memoryTotalBytes: z.ZodOptional<z.ZodNumber>;
+        memoryUsedBytes: z.ZodOptional<z.ZodNumber>;
+        utilizationPercent: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        memoryTotalBytes?: number | undefined;
+        memoryUsedBytes?: number | undefined;
+        utilizationPercent?: number | undefined;
+    }, {
+        name?: string | undefined;
+        memoryTotalBytes?: number | undefined;
+        memoryUsedBytes?: number | undefined;
+        utilizationPercent?: number | undefined;
+    }>, "many">>;
+    process: z.ZodOptional<z.ZodObject<{
+        pid: z.ZodNumber;
+        uptimeSeconds: z.ZodNumber;
+        rssBytes: z.ZodOptional<z.ZodNumber>;
+        heapUsedBytes: z.ZodOptional<z.ZodNumber>;
+        heapTotalBytes: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        pid: number;
+        uptimeSeconds: number;
+        rssBytes?: number | undefined;
+        heapUsedBytes?: number | undefined;
+        heapTotalBytes?: number | undefined;
+    }, {
+        pid: number;
+        uptimeSeconds: number;
+        rssBytes?: number | undefined;
+        heapUsedBytes?: number | undefined;
+        heapTotalBytes?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    memory: {
+        totalBytes: number;
+        freeBytes: number;
+        usedBytes: number;
+        usagePercent?: number | undefined;
+    };
+    cpu?: {
+        usagePercent?: number | undefined;
+        loadavg?: number[] | undefined;
+        cores?: number | undefined;
+    } | undefined;
+    disk?: {
+        path: string;
+        usagePercent?: number | undefined;
+        totalBytes?: number | undefined;
+        freeBytes?: number | undefined;
+        usedBytes?: number | undefined;
+    } | undefined;
+    gpu?: {
+        name?: string | undefined;
+        memoryTotalBytes?: number | undefined;
+        memoryUsedBytes?: number | undefined;
+        utilizationPercent?: number | undefined;
+    }[] | undefined;
+    process?: {
+        pid: number;
+        uptimeSeconds: number;
+        rssBytes?: number | undefined;
+        heapUsedBytes?: number | undefined;
+        heapTotalBytes?: number | undefined;
+    } | undefined;
+}, {
+    at: string;
+    memory: {
+        totalBytes: number;
+        freeBytes: number;
+        usedBytes: number;
+        usagePercent?: number | undefined;
+    };
+    cpu?: {
+        usagePercent?: number | undefined;
+        loadavg?: number[] | undefined;
+        cores?: number | undefined;
+    } | undefined;
+    disk?: {
+        path: string;
+        usagePercent?: number | undefined;
+        totalBytes?: number | undefined;
+        freeBytes?: number | undefined;
+        usedBytes?: number | undefined;
+    } | undefined;
+    gpu?: {
+        name?: string | undefined;
+        memoryTotalBytes?: number | undefined;
+        memoryUsedBytes?: number | undefined;
+        utilizationPercent?: number | undefined;
+    }[] | undefined;
+    process?: {
+        pid: number;
+        uptimeSeconds: number;
+        rssBytes?: number | undefined;
+        heapUsedBytes?: number | undefined;
+        heapTotalBytes?: number | undefined;
+    } | undefined;
+}>;
+export type DeviceResourcesResult = z.infer<typeof DeviceResourcesResult>;
+//# sourceMappingURL=device.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/schemas/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,8DAA2B,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;IAY3B,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEnF,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB,8DAA2B,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiChC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}