@clawos-dev/clawd 0.2.261 → 0.2.263

package/dist/dispatch/mcp-server.cjs

@@ -21114,54 +21114,6 @@ var import_node_child_process = require("child_process");
 var import_node_child_process2 = require("child_process");
 var import_node_fs2 = __toESM(require("fs"), 1);
 
-// ../protocol/src/methods.ts
-var RPC_METHOD_STATUSES = ["allowed", "conditional", "denied"];
-var RpcMethodStatusSchema = external_exports.enum(RPC_METHOD_STATUSES);
-var RpcMethodInfoSchema = external_exports.object({
-  /** canonical method 名，直接可作为 clawd-rpc call 的 method 参数 */
-  name: external_exports.string().min(1),
-  status: RpcMethodStatusSchema,
-  /**
-   * `denied` 必带：daemon error code（`UNAUTHORIZED` / `FEISHU_LOGIN_REQUIRED` /
-   * `METHOD_NOT_IMPLEMENTED`）。`conditional` 必带：谁来做二次校验。
-   * `allowed` 恒无。
-   */
-  reason: external_exports.string().optional()
-});
-var MetaMethodsResultSchema = external_exports.object({
-  type: external_exports.literal("meta:methods"),
-  /** METHOD_NAMES 全集，顺序与之一致 */
-  methods: external_exports.array(RpcMethodInfoSchema)
-});
-
-// ../protocol/src/events.ts
-var SESSION_STATUS_VALUES = [
-  "idle",
-  "running",
-  "running-idle",
-  "stopped",
-  "error",
-  "observing"
-];
-var HISTORY_USER_META_VALUES = [
-  "task-notification",
-  "slash-command",
-  "local-command",
-  "system-reminder",
-  "skill-hint",
-  "meta-text",
-  "attachment-skills",
-  "attachment-deferred-tools"
-];
-var SKILL_SOURCE_VALUES = ["builtin", "global", "project", "plugin"];
-var AGENT_SOURCE_VALUES = [
-  "builtin",
-  "global",
-  "project",
-  "policy",
-  "plugin"
-];
-
 // ../protocol/src/attachment-schemas.ts
 var TOKEN_ROLES = ["owner"];
 var GROUP_FILE_SOURCES = ["agent", "owner", "user-upload"];
@@ -21239,1575 +21191,2133 @@ var AttachmentUploadResponseSchema = external_exports.object({
   mimeType: external_exports.string().min(1)
 });
 
-// ../protocol/src/principal.ts
-var PrincipalKindSchema = external_exports.enum(["owner", "guest"]);
-var PrincipalSchema = external_exports.object({
+// ../protocol/src/capability.ts
+var ResourceSchema2 = external_exports.discriminatedUnion("type", [
+  external_exports.object({ type: external_exports.literal("persona"), id: external_exports.string().min(1) }).strict(),
+  external_exports.object({ type: external_exports.literal("chat"), id: external_exports.string().min(1) }).strict(),
+  external_exports.object({ type: external_exports.literal("*") }).strict()
+]);
+var ActionSchema = external_exports.enum(["read", "send", "admin"]);
+var GrantSchema = external_exports.object({
+  resource: ResourceSchema2,
+  actions: external_exports.array(ActionSchema).min(1)
+}).strict();
+var CapabilitySchema = external_exports.object({
   id: external_exports.string().min(1),
-  kind: PrincipalKindSchema,
+  // sha256(token) hex 64
+  secretHash: external_exports.string().regex(/^[a-f0-9]{64}$/),
   displayName: external_exports.string(),
+  // 空数组合法 = 纯访客（只能 DM）
+  grants: external_exports.array(GrantSchema),
+  issuedAt: external_exports.number().int().nonnegative(),
+  expiresAt: external_exports.number().int().positive().optional(),
+  maxUses: external_exports.number().int().positive().optional(),
+  usedCount: external_exports.number().int().nonnegative(),
   /**
-   * 飞书 union_id。owner: 本机 daemon 已飞书登录时透传自 owner-identity.json；未登录 undefined。
-   * guest: v1 保持 undefined（connect token 当前不携带 unionId；未来若签名 payload 加字段可透传）。
-   * 消费方（如 ticket MCP / 未来别的飞书身份挂钩场景）按 undefined 决定是否降级；本层不做 fallback。
+   * guest 在 auth 帧捎带 selfPrincipalId 时由 AuthGate.authenticate 回写；
+   * 未被消费的 cap 此字段缺失。
    */
-  feishuUnionId: external_exports.string().optional()
+  peerOwnerId: external_exports.string().min(1).optional(),
+  /** 首次 client hello 时间戳（与 peerOwnerId 同步写入） */
+  firstUsedByPeerAt: external_exports.number().int().positive().optional(),
+  /**
+   * 对方 daemon owner 的 displayName，guest auth 帧 selfDisplayName 触发
+   * recordPeerHello 时同步回写。视角 B (2026-05-23) UI 派生联系人列表用此字段
+   * 显示对方名字（避免 fallback 到我颁 cap 时填的 displayName）。
+   */
+  peerDisplayName: external_exports.string().optional()
 }).strict();
-var SenderInfoSchema = external_exports.object({
-  /** = principal.id = deviceId（决策 #16）。稳定路由 id */
-  did: external_exports.string().min(1),
-  displayName: external_exports.string(),
-  /** owner 未登录 / guest 无飞书身份时缺省。消费方各自决定是否降级 */
-  feishuUnionId: external_exports.string().optional(),
-  principal: PrincipalKindSchema
+var CapabilityWireSchema = CapabilitySchema.omit({ secretHash: true });
+var WhoamiResponseSchema = external_exports.object({
+  type: external_exports.literal("whoami:ok"),
+  owner: external_exports.object({
+    id: external_exports.string(),
+    kind: external_exports.enum(["owner", "guest"]),
+    displayName: external_exports.string(),
+    /** 归属人 id（决策 #16：TTC unique_id 等，落 contact.ownerId） */
+    ownerId: external_exports.string(),
+    /** 身份来源（决策 #16：'ttc'/'google'，落 contact.provider） */
+    provider: external_exports.string()
+  }).strict(),
+  capability: CapabilityWireSchema,
+  grantedPersonas: external_exports.array(
+    external_exports.object({
+      id: external_exports.string().min(1),
+      displayName: external_exports.string()
+    }).strict()
+  )
 }).strict();
+var PERSONAL_CAP_GRANTS = Object.freeze([
+  Object.freeze({
+    resource: Object.freeze({ type: "persona", id: "*" }),
+    actions: Object.freeze(["read", "send"])
+  })
+]);
 
-// ../protocol/src/persona-schemas.ts
-var PersonaFileSchema = external_exports.object({
-  personaId: external_exports.string(),
-  label: external_exports.string(),
-  model: external_exports.string().optional(),
-  public: external_exports.boolean(),
-  // 8-key set defined UI-side in `lib/session-icons.ts`; protocol stays plain string
-  // for forward compatibility, consumer fallbacks to default when key not found.
-  iconKey: external_exports.string().optional(),
-  // 绑定的 agent tool（'claude' / 'codex'）；缺省消费侧按 'claude' 兜底。
-  // 与 model 平行：persona 新建 session 的默认 tool，可平滑切换。
-  tool: external_exports.string().optional(),
-  createdAt: external_exports.number(),
-  updatedAt: external_exports.number()
-}).strict();
-var PersonaSkillSummarySchema = external_exports.object({
-  // 目录名作为 skill name（对齐 CC：frontmatter `name:` 仅作 displayName 用）
-  name: external_exports.string().min(1),
-  // SKILL.md frontmatter `description:`；缺省时省略字段
-  description: external_exports.string().optional()
-});
-var PersonaPluginSummarySchema = external_exports.object({
-  // settings.json 中 enabledPlugins 的 key，例如 'superpowers@claude-plugins-official'
-  id: external_exports.string().min(1)
-});
-var PersonaSandboxSettingsSchema = external_exports.object({
-  permissions: external_exports.object({
-    defaultMode: external_exports.string().optional(),
-    // CC 工具 allowlist（'Bash'/'Read'/...）。per-persona profile 在最严格 base 上追加放开。
-    allow: external_exports.array(external_exports.string()).optional(),
-    // deny 优先级最高；强制底座（persona 私密区）由 daemon compose 强制 union，owner 删不掉。
-    deny: external_exports.array(external_exports.string()).optional()
-  }).optional(),
-  sandbox: external_exports.object({
-    enabled: external_exports.boolean().optional(),
-    autoAllowBashIfSandboxed: external_exports.boolean().optional(),
-    allowUnsandboxedCommands: external_exports.boolean().optional(),
-    // 命令前缀白名单（CC `sandbox.excludedCommands`）：匹配的命令在沙箱外运行，
-    // 用于需逃出沙箱的工具（如 'docker *' / 'aliyun *' 要访问宿主 socket / 凭证）。
-    excludedCommands: external_exports.array(external_exports.string()).optional(),
-    filesystem: external_exports.object({
-      denyRead: external_exports.array(external_exports.string()).optional(),
-      allowRead: external_exports.array(external_exports.string()).optional(),
-      denyWrite: external_exports.array(external_exports.string()).optional(),
-      allowWrite: external_exports.array(external_exports.string()).optional()
-    }).optional(),
-    // 出站网络 + 本机端口。base 不放（空），profile 按需追加域名（app-builder = ['*']）。
-    network: external_exports.object({
-      allowedDomains: external_exports.array(external_exports.string()).optional(),
-      allowLocalBinding: external_exports.boolean().optional()
-    }).optional()
-  }).optional()
+// ../protocol/src/contact-handshake.ts
+var ContactHandshakeArgsSchema = external_exports.object({
+  selfUrl: external_exports.string().min(1)
 });
-var PersonaInfoResponseSchema = PersonaFileSchema.extend({
-  personality: external_exports.string().optional(),
-  // 仅 'persona:get' 携带；null = 文件不存在 / parse 失败；undefined = 不在该响应类型上
-  skills: external_exports.array(PersonaSkillSummarySchema).optional(),
-  // 仅 'persona:get' 携带；空数组 = 没启用任何插件 / settings.json 不存在；undefined = 不在该响应类型上
-  plugins: external_exports.array(PersonaPluginSummarySchema).optional(),
-  sandboxSettings: PersonaSandboxSettingsSchema.nullable().optional()
+var ContactHandshakeOkSchema = external_exports.object({
+  type: external_exports.literal("contact:handshake:ok"),
+  owner: external_exports.object({
+    /** 被调方 deviceId（路由主键；调用方落 Contact 的主键用自己请求的 args.deviceId，此值供校验/展示） */
+    id: external_exports.string(),
+    /** 归属人（落 Contact.ownerId / provider，显示分组用） */
+    ownerId: external_exports.string(),
+    provider: external_exports.string(),
+    displayName: external_exports.string()
+  }),
+  /** 被调方授调用方的 grants（落 Contact.grants） */
+  grants: external_exports.array(GrantSchema)
 });
-var PersonaCreateArgsSchema = external_exports.object({
-  label: external_exports.string().min(1),
-  personality: external_exports.string(),
-  model: external_exports.string().optional(),
-  tool: external_exports.string().optional(),
-  public: external_exports.boolean().optional(),
-  iconKey: external_exports.string().optional()
+
+// ../protocol/src/contact-remote-access.ts
+var ContactSetRemoteAccessArgsSchema = external_exports.object({
+  deviceId: external_exports.string().min(1),
+  remoteAccessAllowed: external_exports.boolean()
 }).strict();
-var PersonaIdArgsSchema = external_exports.object({
-  personaId: external_exports.string().min(1)
-});
-var PersonaUpdateArgsSchema = external_exports.object({
-  personaId: external_exports.string().min(1),
-  patch: external_exports.object({
-    label: external_exports.string().min(1).optional(),
-    model: external_exports.string().optional(),
-    tool: external_exports.string().optional(),
-    personality: external_exports.string().optional(),
-    public: external_exports.boolean().optional(),
-    // pass `null` to clear; daemon strips the field from PersonaFile on null
-    iconKey: external_exports.string().nullable().optional()
-  }).strict()
+var ContactSetRemoteAccessOkSchema = external_exports.object({
+  type: external_exports.literal("contact:setRemoteAccess:ok"),
+  deviceId: external_exports.string().min(1),
+  remoteAccessAllowed: external_exports.boolean()
 }).strict();
-var CodexSandboxSettingsSchema = external_exports.object({
-  // 额外可写的绝对路径或 ~ 路径（pnpm 工具链等）；workspace(cwd) 和 userWorkDir 由 daemon 自动加，不用列。
-  writableRoots: external_exports.array(external_exports.string()).optional(),
-  // 禁读 glob（相对 workspace root 或绝对），如 ".secrets/**"、"**/*.env"。
-  denyRead: external_exports.array(external_exports.string()).optional(),
-  // true → 网络全放(*)；缺省/false → 断网。
-  network: external_exports.boolean().optional()
+var ContactRemoteAccessUpdatedFrameSchema = external_exports.object({
+  type: external_exports.literal("contact:remote-access-updated"),
+  deviceId: external_exports.string().min(1),
+  remoteAccessAllowed: external_exports.boolean()
 }).strict();
 
-// ../protocol/src/schemas.ts
-var SessionStatusSchema = external_exports.enum(SESSION_STATUS_VALUES);
-var UsageSchema = external_exports.object({
-  input_tokens: external_exports.number().int().nonnegative().optional(),
-  cache_read_input_tokens: external_exports.number().int().nonnegative().optional(),
-  cache_creation_input_tokens: external_exports.number().int().nonnegative().optional(),
-  output_tokens: external_exports.number().int().nonnegative().optional()
-});
-var ContextUsageSchema = external_exports.object({
-  inputTokens: external_exports.number().int().nonnegative(),
-  outputTokens: external_exports.number().int().nonnegative(),
-  cacheReadTokens: external_exports.number().int().nonnegative().optional(),
-  cacheCreateTokens: external_exports.number().int().nonnegative().optional()
-});
-var sessionMetaShape = {
-  gitBranch: external_exports.string().optional(),
-  resolvedModel: external_exports.string().optional(),
-  contextUsage: ContextUsageSchema.optional(),
-  contextWindowSize: external_exports.number().int().positive().optional()
-};
-var SessionMetaSchema = external_exports.object(sessionMetaShape);
-var ModelInfoSchema = external_exports.object({
-  id: external_exports.string().min(1),
-  label: external_exports.string().min(1),
-  description: external_exports.string().optional(),
-  contextWindowSize: external_exports.number().int().positive(),
-  default: external_exports.boolean().optional()
-});
-var ModeInfoSchema = external_exports.object({
-  id: external_exports.string().min(1),
-  label: external_exports.string().min(1),
-  description: external_exports.string().optional()
-});
-var ConfigFieldSchemaSchema = external_exports.object({
-  name: external_exports.string().min(1),
-  type: external_exports.enum(["string", "select", "toggle"]),
-  label: external_exports.string().min(1),
-  description: external_exports.string().optional(),
-  options: external_exports.array(
-    external_exports.object({
-      value: external_exports.string(),
-      label: external_exports.string(),
-      description: external_exports.string().optional()
-    })
-  ).optional(),
-  default: external_exports.unknown().optional(),
-  scope: external_exports.enum(["core", "tool-specific"])
-});
-var CapabilitiesGetArgs = external_exports.object({
-  tool: external_exports.string().min(1)
-});
-var ToolFeaturesSchema = external_exports.object({
-  rewind: external_exports.boolean(),
-  subagents: external_exports.boolean(),
-  tui: external_exports.boolean(),
-  observe: external_exports.boolean(),
-  fileSharing: external_exports.boolean(),
-  // fork：session:fork 走 forkSession（claude jsonl 专用，派生新 jsonl）。codex 无 claude jsonl
-  // → fork 不可用。UI 据此 gate assistant 消息上的 fork 按钮（codex 一轮多条消息会刷出一堆按钮且点了报错）。
-  fork: external_exports.boolean()
-});
-var CapabilitiesResponseSchema = external_exports.object({
-  tool: external_exports.string().min(1),
-  toolSessionIdLabel: external_exports.string().optional(),
-  models: external_exports.array(ModelInfoSchema),
-  permissionModes: external_exports.array(ModeInfoSchema),
-  configSchema: external_exports.array(ConfigFieldSchemaSchema),
-  features: ToolFeaturesSchema
-});
-var AllowRuleSchema = external_exports.object({
-  tool: external_exports.string().min(1),
-  pattern: external_exports.string().min(1),
-  createdAt: external_exports.string().min(1).optional()
-});
-var SessionFileSchema = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  cwd: external_exports.string().min(1),
-  tool: external_exports.literal("claude").or(external_exports.string().min(1)).default("claude"),
-  // 归一化 tool 侧 session id（CC = claude session uuid，Codex = codex 自己的 id）
-  toolSessionId: external_exports.string().optional(),
-  label: external_exports.string().optional(),
-  model: external_exports.string().optional(),
-  permissionMode: external_exports.string().optional(),
-  effort: external_exports.string().optional(),
-  // 归一化运行时观测字段（daemon 独立计算，session:update 不接受；meta_update 事件投递）
-  ...sessionMetaShape,
-  permissionRules: external_exports.array(AllowRuleSchema).optional(),
-  // Sidebar 置顶时间戳；null/undefined 表示未置顶
-  pinnedAt: external_exports.number().int().nonnegative().nullable().optional(),
-  // pinned 行手动拖拽顺序；越小越靠前。session:reorderPins 整体重写所有 pinned 的此字段。
-  // 缺失时 view-state 排序回退到 pinnedAt desc（旧数据兼容）
-  pinSortOrder: external_exports.number().int().nullable().optional(),
-  // daemon 权威的共享未读标记（spec 2026-07-20-shared-session-unread）：
-  // session wire status 从 running 跃迁为非 running 时 daemon 置为当时 ISO 时间戳；
-  // session:markRead RPC 或新 turn 开始（→ running）时清为 null。
-  // 所有客户端（desktop / mobile）共享同一份，任一端标读全端清。
-  unreadAt: external_exports.string().min(1).nullable().optional(),
-  // 用户在 NewSessionDialog 或 Edit modal 选择的 icon 标识；UI 端做 enum 兜底
-  iconKey: external_exports.string().optional(),
-  // 由 session:fork 派生的 session 在 create 时记录源 session 的 sessionId（稳定 key，
-  // 不受 parent clear / re-spawn 影响）；sidebar 据此挂 fork 图标。非 fork session 该字段缺省。
-  // 旧字段 forkedFromToolSessionId 已弃用，daemon 启动时一次性迁移老数据
-  forkedFromSessionId: external_exports.string().min(1).optional(),
-  // 快速问答临时会话标记（spec 2026-06-23-fork-quick-ask）：true = 关闭抽屉即删、
-  // 不进 sidebar 树、daemon 启动清扫孤儿。普通会话缺省。
-  ephemeral: external_exports.boolean().optional(),
-  // owner-mode persona session 身份标识；UI 用它在 SessionList 过滤 + jump，
-  // daemon 用它做 idempotent dedupe + spawn 时派生 ctx.personaMode='owner'
-  ownerPersonaId: external_exports.string().min(1).optional(),
-  // app-builder Project 反向索引（spec: superpowers/specs/2026-06-01-app-builder-project-picker-design.md）。
-  // 当此 session 绑定到某个 build 中的 project 时填写；name 与 projects/<name>/ 子目录同名，
-  // 受 projectNameSchema regex 约束。daemon session:resume 时校验该目录存在，不存在则拒。
-  appBuilderProject: external_exports.string().regex(/^[a-z][a-z0-9-]{0,39}$/).optional(),
-  // listener-mode sub-session 的原始 chatId（owner-mode 不写；listener-scope 强制写入）。
-  // 派生 sessionId 是单向 hash `${personaId}-${tokenHash12}-${chatHash8}`，必须保留原始 chatId
-  // 才能让 alice 重连同一 sub-session（持久化在 alice localStorage 之外，由 daemon push 同步）。
-  // optional 是因为 owner-mode session 不带；只要写入就是 listener-mode 必填三元组。
-  chatId: external_exports.string().min(1).optional(),
-  /**
-   * 创建该 session 的设备 id（决策 #16：从 ctx.principal.id 派生 = deviceId）。
-   * UI 端 self 判定收敛为单一比较 `!creatorPrincipalId || creatorPrincipalId === 本机 deviceId`
-   * → 「我自己创建」vs「别的设备接入创建」。MyPersonas 二级分组按 creatorPrincipalId(设备)
-   * 分桶、按 contact(deviceId→ownerName) 反查显示名。
-   *
-   * 命名保留 creatorPrincipalId（命名债，语义已是 creatorDeviceId）；值由 connect token
-   * subDevice 背书（guest ctx）或本机 deviceId（owner ctx）。optional 兼容老 session。
-   *
-   * 决策 #16 删除了 creatorOwnerPrincipalId（personal token #735 遗留）——当年 guest 的
-   * principal.id 都是同张 cap.id 区分不了人才加它；现在 principal.id = 设备 deviceId、
-   * 归属人由 contact(deviceId→ownerId) 反查，该字段理由消失。
-   */
-  creatorPrincipalId: external_exports.string().min(1).optional(),
+// ../protocol/src/contact.ts
+var ContactSchema = external_exports.object({
   /**
-   * 创建该 session 的连接者飞书 displayName（一次性 stamp）。session:create handler
-   * 从 ctx.principal.displayName 传入；newRunner 时读这个字段派生 SubSessionMeta.callerDisplayName，
-   * 注入到 cc system prompt 引导自我介绍（见 connection-prompt.ts）。
-   * Optional 兼容老 SessionFile——newRunner 读不到时 fallback ContactStore 反查（guest）
-   * 或 deps.ownerDisplayName（owner）。
+   * 对方设备标识（主键）：对方 daemon 自己生成并持久化的标识（auth.json deviceId，
+   * 如 dev-<uuid>），provider 无关。同 deviceId 重复 upsert 覆盖。
    */
-  creatorDisplayName: external_exports.string().min(1).optional(),
+  deviceId: external_exports.string().min(1),
   /**
-   * 创建该 session 的连接者飞书 union_id（一次性 stamp，T-31 persona prompt injection）。
-   * session:create / dispatch spawnB handler 从 ctx.principal.feishuUnionId（guest 场景来自
-   * connect token subOwner）或 deps.ownerFeishuUnionId（owner 场景）传入；newRunner 时读这个
-   * 字段派生 SubSessionMeta.callerFeishuUnionId 注入 cc system prompt「身份卡」的 union_id 行。
-   * Optional：老 SessionFile / owner 未登飞书路径缺省，缺省时 prompt 不渲染该行（向后兼容）。
+   * 归属人 id（决策 #16）：TTC unique_id 等，由 connect token subOwner 签名背书。
+   * 与 provider 一起唯一标识一个人。DM 不再按它路由（路由用 deviceId），仅显示/分组用。
    */
-  creatorFeishuUnionId: external_exports.string().min(1).optional(),
+  ownerId: external_exports.string().min(1),
+  /** 身份来源（决策 #16）：'ttc'（飞书/手机/邮箱登入 TTC）| 'google' | ...，token 背书 */
+  provider: external_exports.string().min(1),
+  /** 联系人显示名 */
+  displayName: external_exports.string(),
+  /** 该设备可达的 ws/tunnel 地址 */
+  remoteUrl: external_exports.string().min(1),
+  // 自动反向建立联系人（spec 决策 #11）：被连接方本地验票成功后自动落 A 为
+  // 联系人，但它不持有 A 颁发的 token（A 从未给它换票）→ connectToken 为空串。
+  // device:connect 出站路径仍存中心 server 签发的真实 connect token（断线重连复用）。
+  // 不用 .min(1)：自动反向路径合法地存空串，禁止填假 token 占位（不造假数据）。
+  connectToken: external_exports.string(),
+  grants: external_exports.array(GrantSchema),
+  addedAt: external_exports.number().int().nonnegative(),
   /**
-   * Mirror peer sessions (2026-05-26): mirror 标识。**我在朋友 daemon 上创建的 session**，
-   * 远端是 source of truth，本机是持久化副本，方便 sidebar 跨设备聚合。
-   * 字段值 = 远端 daemon 的 deviceId（决策 #16：朋友设备标识，即我接入的那台机器）。
-   *
-   * 语义关键澄清：mirror **不是朋友创建给我的会话**——它是我自己的会话，只是在朋友
-   * 的机器上跑。sidebar chip 显示 `@<朋友>` 暗示「位置」，不是「来源」。
-   *
-   *   - undefined / 缺省 → 本机 native session（在我自己机器上跑）
-   *   - 非空 → 我的会话在该 deviceId 朋友的 daemon 上跑，本机为持久化副本
-   *
-   * 四类 session 取值矩阵（决策 #16 deviceId 版，creatorOwnerPrincipalId 列已删）：
-   *   | 形态                                | creatorPrincipalId(=设备) | originOwnerPrincipalId(=朋友设备) |
-   *   |-------------------------------------|--------------------------|----------------------------------|
-   *   | 本机 owner 自创                      | 本机 deviceId            | undefined                        |
-   *   | 本机被别的设备接入创建               | 接入者 deviceId(token 背书) | undefined                     |
-   *   | 我在朋友 daemon 上创建（mirror 回本机） | 我的 deviceId          | 朋友 deviceId                    |
-   *
-   * UI 用法：
-   *   - sidebar Active/Pinned/Recents 过滤：`origin 非空 → 一律视作 self`（绕过 #739 隔离）
-   *   - 行内显示 `@<朋友>` chip 暗示位置
-   *   - 进 ChatPanel 时按 origin 路由到 `pool.ensureRemoteForOwner(origin)` 走远端（按 deviceId）
-   *
-   * daemon 用法：
-   *   - `peerSession:upsert` / `peerSession:remove` 一族 RPC 专管 mirror 写删；
-   *     daemon dumb write/delete，**不广播任何 push 帧**，UI 是写入唯一源
-   *   - native `session:*` handler 完全不感知 mirror（UI 操作 mirror 不走 native 路径）
+   * pin 时间戳（ms，Date.now() 语义）；null = 未 pin。sidebar 顶部固定区渲染由此驱动。
+   * 老 contacts.json 缺此字段 → zod default 补 null（无破坏性升级；不 orphan）。
+   * 对齐 SessionFile.pinnedAt 语义（daemon 侧持久化，contact:pin RPC 更新 → contact:pinned push）。
    */
-  originOwnerPrincipalId: external_exports.string().min(1).optional(),
+  pinnedAt: external_exports.number().int().nullable().default(null),
   /**
-   * Mirror 的 persona 身份（2026-07-17 android-dispatch-task spec §3.2）：
-   * 该 mirror 在朋友 daemon 上是用哪个 persona 创建的（朋友侧的 persona id）。
-   * 与 originOwnerPrincipalId 平行的「位置」语义——**不参与**本机 persona 反查
-   * （那是 ownerPersonaId 的职责，mirror 上按 #750 防线 strip）。
-   * 消费方：mobile picker「借的」组按 (originOwnerPrincipalId, originOwnerPersonaId) 去重。
-   * 写入方：ui toMirrorSessionFile / mobile buildMirrorUpsertArgs 在 strip ownerPersonaId 时 stamp。
+   * 远程访问授权（spec 2026-07-16）。owner 视角：允许该 contact 反向操作我的设备——
+   * 跨设备 exec 的总开关（peerExec:run handler 运行时判它）。default=false，owner 显式开。
+   * 授权粒度 per-people (per-contact)：借用别人 persona 本来就带信任对方本人的前提。
    */
-  originOwnerPersonaId: external_exports.string().min(1).optional(),
+  remoteAccessAllowed: external_exports.boolean().default(false)
+}).strict();
+var ContactWireSchema = ContactSchema;
+var ContactRemoveArgsSchema = external_exports.object({
+  deviceId: external_exports.string().min(1)
+}).strict();
+var ContactRemoveOkSchema = external_exports.object({
+  type: external_exports.literal("contact:remove:ok"),
+  deviceId: external_exports.string().min(1)
+}).strict();
+var ContactListOkSchema = external_exports.object({
+  type: external_exports.literal("contact:list:ok"),
+  contacts: external_exports.array(ContactWireSchema)
+}).strict();
+var ContactAddedFrameSchema = external_exports.object({
+  type: external_exports.literal("contact:added"),
+  contact: ContactWireSchema
+}).strict();
+var ContactRemovedFrameSchema = external_exports.object({
+  type: external_exports.literal("contact:removed"),
+  deviceId: external_exports.string().min(1)
+}).strict();
+var ContactPinArgsSchema = external_exports.object({
+  deviceId: external_exports.string().min(1),
+  pinned: external_exports.boolean()
+}).strict();
+var ContactPinOkSchema = external_exports.object({
+  type: external_exports.literal("contact:pin:ok"),
+  deviceId: external_exports.string().min(1),
+  pinnedAt: external_exports.number().int().nullable()
+}).strict();
+var ContactPinnedFrameSchema = external_exports.object({
+  type: external_exports.literal("contact:pinned"),
+  deviceId: external_exports.string().min(1),
+  pinnedAt: external_exports.number().int().nullable()
+}).strict();
+
+// ../protocol/src/feishu-auth.ts
+var DeviceEntrySchema = external_exports.object({
   /**
-   * Dispatch 派生的 session 在 create 时记录源 session 的 sessionId（稳定 key）；
-   * sidebar 据此把 dispatch 出来的 sub-session 折叠在源 session 下。非 dispatch session 缺省。
-   * mirror SessionFile 上必须 strip（朋友 daemon 上的 sessionId 在本机无意义，会让本机
-   * 反查路径走错；按 #750 一族防线处理，跟 ownerPersonaId 同地点 strip）。
+   * 设备标识（决策 #15：daemon 本地生成的 dev-<uuid>，与人的身份 unionId 无关）。
+   * 中心 server clawd_devices 注册表仅作服务发现（url 下发 + 目录），不在安全路径上。
    */
-  dispatchedFromSessionId: external_exports.string().min(1).optional(),
+  deviceId: external_exports.string().min(1),
+  /** 显示名 */
+  name: external_exports.string().min(1),
+  /** ws/tunnel 地址 */
+  url: external_exports.string().min(1)
+});
+var DeviceListResponseSchema = external_exports.object({
+  type: external_exports.literal("device:list:ok"),
+  devices: external_exports.array(DeviceEntrySchema)
+});
+var DeviceConnectArgsSchema = external_exports.object({
+  /** 目标设备的 deviceId（对方 daemon 生成的 dev-<uuid>） */
+  deviceId: external_exports.string().min(1),
   /**
-   * Shift fire 派生的 session 记录调 addShift 的 source cc session id（稳定 key）；
-   * sidebar 据此把 fire 出的 session 折叠在 source session 下，跟 dispatchedFromSessionId
-   * 平行但渲染不同 icon（AlarmClock 区别于 dispatch 的 CornerDownRight），让 owner 一眼
-   * 分清"派生于人为委派"还是"派生于定时唤起"。非 shift fire session 缺省。
-   * 跟 dispatchedFromSessionId / forkedFromSessionId 三者互斥（同一 session 不会兼任）。
-   * mirror SessionFile 同 dispatchedFromSessionId 处理（shift fire 本地概念，理论上不会
-   * mirror，留 strip 防御）。
+   * 目标设备的 ws/tunnel 地址（可选）：
+   *   - 公开目录点击：带 url（device:list 已下发，省一次 server 查询）
+   *   - 凭 deviceId 连接：缺省 url → daemon exchange 时由中心 server 下发该设备上报的 url
+   *   - 注册表不在安全路径上：知道对方 url 时显式传入即可连接（不依赖中心 server 服务发现）
    */
-  shiftFiredFromSessionId: external_exports.string().min(1).optional(),
-  createdAt: external_exports.string().min(1),
-  updatedAt: external_exports.string().min(1)
+  url: external_exports.string().min(1).optional(),
+  /** 显示名（公共设备来自目录；缺省时连上后用 whoami 回填） */
+  name: external_exports.string().optional()
 });
-var ParsedEventBase = {
-  seq: external_exports.number().int().nonnegative().optional(),
-  ts: external_exports.string().optional(),
-  // CC top-level uuid：同一逻辑帧从 stream-json stdout 和 JSONL 落地时携带相同值，
-  // reducer 用它做跨路径去重（managed stdout 和 observer JSONL 双写）。对齐 cc-direct cc-event-store
-  uuid: external_exports.string().optional()
-};
-var HistoryUserMetaSchema = external_exports.enum(HISTORY_USER_META_VALUES);
-var SubagentToolStatsSchema = external_exports.object({
-  readCount: external_exports.number().int().nonnegative().optional(),
-  searchCount: external_exports.number().int().nonnegative().optional(),
-  bashCount: external_exports.number().int().nonnegative().optional(),
-  editFileCount: external_exports.number().int().nonnegative().optional(),
-  linesAdded: external_exports.number().int().nonnegative().optional(),
-  linesRemoved: external_exports.number().int().nonnegative().optional(),
-  otherToolCount: external_exports.number().int().nonnegative().optional()
+var DeviceConnectResponseSchema = external_exports.object({
+  type: external_exports.literal("device:connect:ok"),
+  /** 连接的目标设备标识（= 请求 args.deviceId） */
+  deviceId: external_exports.string(),
+  name: external_exports.string(),
+  url: external_exports.string()
 });
-var StructuredPatchHunkSchema = external_exports.object({
-  oldStart: external_exports.number().int().nonnegative(),
-  oldLines: external_exports.number().int().nonnegative(),
-  newStart: external_exports.number().int().nonnegative(),
-  newLines: external_exports.number().int().nonnegative(),
-  // 每行以 '+' / '-' / ' ' 开头（diff npm 包的标准 hunk lines）
-  lines: external_exports.array(external_exports.string())
+var FeishuIdentitySchema = external_exports.object({
+  /** 归属人 id（决策 #16：TTC unique_id，取代飞书 union_id；跨登录方式稳定） */
+  ownerId: external_exports.string().min(1),
+  /** 身份来源：'ttc'（飞书/手机/邮箱登入 TTC）| 'google' | ...（决策 #16，拓展用） */
+  provider: external_exports.string().min(1),
+  /** 显示名。TTC user_info 接口 data.name */
+  displayName: external_exports.string().min(1),
+  /** TTC user_info 接口 data.avatar_url，可缺省 */
+  avatarUrl: external_exports.string().optional(),
+  /** TTC user_info 接口 data.union_id（飞书 union_id；dataclaw 可信入口 X-User-UnionId 用），可缺省 */
+  unionId: external_exports.string().optional()
 });
-var ToolResultExtraSchema = external_exports.object({
-  agentId: external_exports.string().optional(),
-  agentType: external_exports.string().optional(),
-  status: external_exports.string().optional(),
-  prompt: external_exports.string().optional(),
-  // CC File*Tool 结果里的 filePath / structuredPatch：UI rewind 预览据此本地渲染 diff。
-  // 两者同时存在才有意义；缺任一则 UI 降级为仅显示"受影响文件"摘要
-  filePath: external_exports.string().optional(),
-  structuredPatch: external_exports.array(StructuredPatchHunkSchema).optional(),
-  stats: external_exports.object({
-    durationMs: external_exports.number().int().nonnegative().optional(),
-    tokens: external_exports.number().int().nonnegative().optional(),
-    toolUseCount: external_exports.number().int().nonnegative().optional(),
-    toolStats: SubagentToolStatsSchema.optional(),
-    usage: UsageSchema.optional()
-  }).optional()
+var AuthLoginStartResponseSchema = external_exports.object({
+  type: external_exports.literal("auth:login:start:ok"),
+  /** 完整 TTC 授权页 URL（含 callback_url + state + auto=1），UI 直接 window.open */
+  authUrl: external_exports.string().min(1),
+  /** 防 CSRF 的一次性 nonce；回调时 daemon 校验 */
+  state: external_exports.string().min(1)
 });
-var MemoryEntrySchema = external_exports.object({
-  path: external_exports.string(),
-  content: external_exports.string(),
-  mtimeMs: external_exports.number().optional()
+var AuthGetIdentityResponseSchema = external_exports.object({
+  type: external_exports.literal("auth:getIdentity:ok"),
+  /** null = 未登录 */
+  identity: FeishuIdentitySchema.nullable(),
+  /**
+   * 本机设备标识（决策 #15：daemon 生成并持久化在 auth.json，如 dev-<uuid>）。
+   * 设备属性，与登录态无关、登录登出不变。UI"我的设备标识"用它拼
+   * clawos://device/<deviceId>（替代旧的 unionId——不再向外暴露人的身份标识）。
+   */
+  deviceId: external_exports.string().min(1)
 });
-var AskQuestionOptionSchema = external_exports.object({
-  label: external_exports.string().min(1),
-  description: external_exports.string().optional()
+var AuthLogoutResponseSchema = external_exports.object({
+  type: external_exports.literal("auth:logout:ok")
 });
-var AskQuestionItemSchema = external_exports.object({
-  question: external_exports.string().min(1),
-  // multiSelect 必填（boolean 不给默认值）：daemon emit 时必须显式传，避免 UI 端漂移
-  multiSelect: external_exports.boolean(),
-  options: external_exports.array(AskQuestionOptionSchema).min(1)
+var AuthLoginDoneEventSchema = external_exports.object({
+  type: external_exports.literal("auth:login:done"),
+  identity: FeishuIdentitySchema
 });
-var ParsedEventSchema = external_exports.discriminatedUnion("kind", [
-  // session_init 仅携带 session 标识；resolvedModel 等元信息走 meta_update
+var AuthLoginFailedEventSchema = external_exports.object({
+  type: external_exports.literal("auth:login:failed"),
+  reason: external_exports.string()
+});
+
+// ../protocol/src/dispatch.ts
+var DispatchOutcomeSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("session_init"),
-    toolSessionId: external_exports.string().optional()
+    kind: external_exports.literal("success"),
+    text: external_exports.string(),
+    filePaths: external_exports.array(external_exports.string()).optional()
   }),
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("thinking"),
-    text: external_exports.string(),
-    // 同一思考块的多次 stream_event 增量带相同 partialId（= `${sessionId}-${blockIndex}`）；
-    // 不带表示是 assistant 帧的整段快照。UI 用 partialId 累积 / 用快照覆盖。
-    partialId: external_exports.string().optional()
+    kind: external_exports.literal("failure"),
+    reason: external_exports.string()
+  })
+]);
+var DispatchRunArgsSchema = external_exports.object({
+  // 新开必填；续派（dispatchId 非空）时可省略——targetPersonaId 从台账行取。
+  targetPersona: external_exports.string().min(1).optional(),
+  // 续派（spec 2026-07-21，单 dispatchId 语义：一件事一行一 id）：非空 = 把 prompt
+  // 作为新 turn 打进该 dispatch 的原 worker session 接着干（台账行复位 running）。
+  // 省略 = 新开一件事，daemon 铸新 id。
+  dispatchId: external_exports.string().min(1).optional(),
+  prompt: external_exports.string(),
+  // 跨设备 dispatch：非空 = A 角色，转发到该 contact deviceId 的 peer daemon；
+  // 省略 = 本地 dispatch / B 角色本地执行。A 转发给 B 时 body 不带此字段。
+  targetDeviceId: external_exports.string().min(1).optional(),
+  // 可选：override B session 使用的 claude 模型。缺省 = 用 persona 默认。
+  // 合法值集与 claude adapter capabilities.models[].id 一致（见 daemon
+  // tools/claude.ts CLAUDE_MODEL_IDS）；handler 层做二次校验，非法值 fail-fast。
+  // protocol 层保持 string 便于未来跨 tool 扩展（届时 union 收合法字面量）。
+  model: external_exports.string().min(1).optional(),
+  // 可选：给新 worker session 起 label（写入 SessionFile.label，sidebar 显示）。
+  // 仅在**新开 dispatch**（dispatchId 缺席）时生效；续派（dispatchId 非空）
+  // 时 daemon 层静默丢弃（避免半途改 label 造成 sidebar 抖动）。
+  // 上限 60 字符——sidebar 显示 tolerance，卡在 dispatch 入口即可。
+  // 协议层不硬拒 sessionLabel + dispatchId 同传，保留 forward-compat。
+  sessionLabel: external_exports.string().min(1).max(60).optional()
+}).refine((v) => v.targetPersona !== void 0 || v.dispatchId !== void 0, {
+  message: "either targetPersona (new dispatch) or dispatchId (follow-up) is required"
+}).refine((v) => !(v.dispatchId !== void 0 && v.targetDeviceId !== void 0), {
+  message: "cross-device dispatch cannot be continued (dispatchId + targetDeviceId are mutually exclusive)"
+});
+var DispatchCompleteArgsSchema = external_exports.object({
+  dispatchId: external_exports.string().min(1),
+  outcome: DispatchOutcomeSchema
+});
+var DISPATCH_STATUSES = ["running", "completed", "failed"];
+var DispatchStatusSchema = external_exports.enum(DISPATCH_STATUSES);
+var DispatchRecordSchema = external_exports.object({
+  dispatchId: external_exports.string().min(1),
+  sourceSessionId: external_exports.string().min(1),
+  sourcePersonaId: external_exports.string().min(1).optional(),
+  targetPersonaId: external_exports.string().min(1),
+  /** B 的 sessionId；registerBSession 后回填 */
+  workerSessionId: external_exports.string().min(1).optional(),
+  /** 任务摘要；截断（≤500 字符）在 daemon store.add 处保证 */
+  taskText: external_exports.string(),
+  status: DispatchStatusSchema,
+  outcome: DispatchOutcomeSchema.optional(),
+  /** 上层消费者语义（如司礼监的口谕/验收状态），daemon 不解释 */
+  meta: external_exports.record(external_exports.unknown()).optional(),
+  createdAt: external_exports.string().min(1),
+  completedAt: external_exports.string().min(1).optional(),
+  /** 结果注入 source session 成功时戳，兼当投递 dedup 标记 */
+  deliveredAt: external_exports.string().min(1).optional()
+});
+var DispatchListArgsSchema = external_exports.object({
+  sourceSessionId: external_exports.string().min(1).optional()
+});
+var DispatchListResultSchema = external_exports.object({
+  records: external_exports.array(DispatchRecordSchema)
+});
+var DispatchGetArgsSchema = external_exports.object({
+  dispatchId: external_exports.string().min(1)
+});
+var DispatchGetOkSchema = external_exports.object({
+  type: external_exports.literal("personaDispatch:get:ok"),
+  status: DispatchStatusSchema,
+  outcome: DispatchOutcomeSchema.optional()
+});
+
+// ../protocol/src/extension.ts
+var EXT_ID_REGEX = /^[a-z0-9][a-z0-9-]*$/;
+var ExtensionStateSchema = external_exports.enum([
+  "stopped",
+  "starting",
+  "running",
+  "crashed",
+  "invalid"
+]);
+var LOCALHOST_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1"]);
+function isAllowedHostedUrl(raw) {
+  let u;
+  try {
+    u = new URL(raw);
+  } catch {
+    return false;
+  }
+  if (u.protocol === "https:") return true;
+  if (u.protocol === "http:" && LOCALHOST_HOSTS.has(u.hostname)) return true;
+  return false;
+}
+var ExtensionManifestSchema = external_exports.object({
+  id: external_exports.string().regex(EXT_ID_REGEX),
+  name: external_exports.string().min(1),
+  version: external_exports.string().min(1),
+  apiVersion: external_exports.literal("1"),
+  runtime: external_exports.object({ startCommand: external_exports.string().min(1) }).passthrough().optional(),
+  entry: external_exports.object({
+    url: external_exports.string().url().refine(isAllowedHostedUrl, {
+      message: "INVALID_URL_SCHEME: only https or http://localhost is allowed"
+    })
+  }).strict().optional()
+}).passthrough().superRefine((m, ctx) => {
+  const hasRuntime = !!m.runtime;
+  const hasUrl = !!m.entry?.url;
+  if (hasRuntime && hasUrl) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: "INVALID_MANIFEST: entry.url and runtime cannot coexist"
+    });
+  }
+  if (!hasRuntime && !hasUrl) {
+    ctx.addIssue({
+      code: external_exports.ZodIssueCode.custom,
+      message: "INVALID_MANIFEST: must have either entry.url or runtime"
+    });
+  }
+});
+var ExtensionTargetSchema = external_exports.discriminatedUnion("kind", [
+  external_exports.object({ kind: external_exports.literal("local"), port: external_exports.number().int().min(1).max(65535) }),
+  external_exports.object({ kind: external_exports.literal("hosted"), url: external_exports.string().url() })
+]);
+var ExtensionRecordSchema = external_exports.discriminatedUnion("state", [
+  external_exports.object({
+    extId: external_exports.string(),
+    manifest: ExtensionManifestSchema,
+    state: external_exports.literal("stopped")
   }),
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("text"),
-    text: external_exports.string(),
-    // 同一文本块的多次 stream_event 增量带相同 partialId；语义同 thinking
-    partialId: external_exports.string().optional()
+    extId: external_exports.string(),
+    manifest: ExtensionManifestSchema,
+    state: external_exports.literal("starting")
   }),
-  // 真实用户输入：daemon 通过 --replay-user-messages 拿到 stdin 回显，区分于 assistant text。
-  // meta 非空表示是 CC 注入的系统消息（task-notification / slash-command / system-reminder 等），
-  // UI 据此走低视觉权重渲染或子 agent 通知卡。
-  //
-  // sender（2026-07-08 spec §4.1）：daemon 'send' 命令 synth 的 user_text 携带发起人 SenderInfo；
-  // observer 回灌路径（cc jsonl）永远不带 —— cc 自己写盘不知道 daemon 层身份。
-  // UI 端 sender 缺省 → 不渲染 displayName label；有 → 气泡下方渲染。
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("user_text"),
-    text: external_exports.string(),
-    meta: HistoryUserMetaSchema.optional(),
-    taskId: external_exports.string().optional(),
-    parentToolUseId: external_exports.string().optional(),
-    sender: SenderInfoSchema.optional()
-  }),
-  external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("tool_call"),
-    toolUseId: external_exports.string(),
-    tool: external_exports.string(),
-    // 等于 session.tool；UI 按 {toolKind, tool} 分派渲染。additive 可选，旧 adapter 不填也能解析
-    toolKind: external_exports.string().optional(),
-    input: external_exports.unknown()
-  }),
-  external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("tool_result"),
-    toolUseId: external_exports.string(),
-    output: external_exports.unknown().optional(),
-    error: external_exports.string().optional(),
-    // CC Agent / Task tool 完成后在 JSONL 顶层挂的 toolUseResult 元信息（非 content 字段）
-    // 老 CC 走 <task-notification> user 消息携带统计，新 CC 直接挂在这里——兼容期两者可能并存
-    toolResultExtra: ToolResultExtraSchema.optional(),
-    // 精确指向发起 tool 的 assistant 消息顶层 uuid；toolUseId 已够 UI 聚合，这个仅作调试辅助
-    sourceToolAssistantUUID: external_exports.string().optional(),
-    // AskUserQuestion 实时回放（plan: clawd-ask-user-question 任务 B 修复）：
-    //   CC 用户答完后把 answers 写在 user 帧顶层 toolUseResult.answers，daemon parser
-    //   抽到这里。UI eventsToLines 用 toolUseId 配对到 question-card line，把卡片转为
-    //   只读态显示用户的答案。仅 AskUserQuestion 配对的 tool_result 行携带；普通工具不带。
-    //   等价于 HistoryMessage.askQuestionAnswers（历史回放路径），两端字段名对齐。
-    askQuestionAnswers: external_exports.record(external_exports.string(), external_exports.string()).optional()
+    extId: external_exports.string(),
+    manifest: ExtensionManifestSchema,
+    state: external_exports.literal("running"),
+    target: ExtensionTargetSchema
   }),
-  // CC 命中项目记忆（`type:"attachment"`，`attachment.type:"memories"`）的独立事件；
-  // 其它 attachment 子类型（skills / hook_context / deferred_tools / hook_success / unknown）
-  // 视觉权重低，daemon 直接走 user_text + HistoryUserMeta 折叠，不另开 kind
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("attachment_memories"),
-    memories: external_exports.array(MemoryEntrySchema)
+    extId: external_exports.string(),
+    manifest: ExtensionManifestSchema,
+    state: external_exports.literal("crashed")
   }),
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("permission_request"),
-    requestId: external_exports.string(),
-    tool: external_exports.string(),
-    input: external_exports.unknown(),
-    // CC `control_request.request.tool_use_id` 对应的 tool_use id；UI 用它把队列项与
-    // 后续 tool_result.toolUseId 关联做跨客户端 dequeue（plan permission-multi-pending-queue.md
-    // 选项 ii）。老 daemon / legacy CC 不发该字段时保持向后兼容（optional）。
-    toolUseId: external_exports.string().optional()
-  }),
-  // AskUserQuestion 工具调用的内联锚点（plan: clawd-ask-user-question 问题 1 修复）：
-  //   daemon parser 把 assistant tool_use AskUserQuestion 翻译成本 kind（不是 permission_request、
-  //   也不是 tool_call），让 UI 在事件流自然位置渲染问答卡（紧跟 assistant 消息 / 在后续消息之前），
-  //   而不是被强行挂在末尾。permission_request 帧仍正常下发驱动 pendingQuestions 状态机，
-  //   但只走 wire 帧不入 ring buffer——状态由 daemon pendingQuestions 持有，
-  //   渲染锚点由本 kind 的 ParsedEvent 提供。
-  // 历史回放：history-to-lines.ts 在 jsonl tool_use AskUserQuestion 处插入对应 'question-card' line，
-  //   配对的 tool_result 携带 toolUseResult.answers，已答完的展示只读态。
+    extId: external_exports.string(),
+    manifest: external_exports.unknown().nullable(),
+    state: external_exports.literal("invalid"),
+    invalidReason: external_exports.string().min(1)
+  })
+]);
+var PublishedSnapshotSchema = external_exports.object({
+  snapshotHash: external_exports.string().min(1),
+  version: external_exports.string().min(1),
+  publishedAt: external_exports.number()
+});
+var ChannelRefSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("ask_user_question"),
-    toolUseId: external_exports.string(),
-    questions: external_exports.array(AskQuestionItemSchema)
-  }),
-  // turn_end —— 一轮 AI 响应结束。消费者：reducer pushEventToBuffer 翻 turnOpen=false；
-  // UI useChatPanelState 收 "Claude is working" spinner（lastEventKind===turn_end）。
-  // 三个产生来源：
-  //   ① SDK 模式 stream-json `result` 帧（claude.ts）—— stdout 最后一帧，可靠
-  //   ② TUI 模式 observer 读 JSONL `system/turn_duration` 行（claude-tui.ts parseLine）
-  //      ⚠️ CC 写此行早于该轮尾段正文落盘，可能被尾随 text 覆盖 lastEventKind（③ 存在的原因）
-  //   ③ TUI 模式屏幕静止 AND observer 静止（observeScreenIdle + manager.observerIdleWaitMs 复合闸 →
-  //      dispatchTurnIdle inject）—— 兜 ② 的覆盖；等尾随 text 全部 poll 落盘后补，排在 buffer 末条
+    kind: external_exports.literal("p2p-tunnel"),
+    ownerPrincipalId: external_exports.string().min(1),
+    extId: external_exports.string().min(1)
+  })
+]);
+var SourceRefSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("turn_end")
-  }),
-  // SDK system 帧 task_started / task_progress / task_notification 的归一化产物：
-  // 子 agent 执行过程中实时上报 agentId / lastToolName / stats，UI pending 期就能开抽屉、看进度。
-  // toolUseId 对齐父 Agent 工具的 tool_use_id；status 由 SDK subtype 派生。
+    kind: external_exports.literal("p2p-tunnel"),
+    ownerPrincipalId: external_exports.string().min(1),
+    extId: external_exports.string().min(1),
+    snapshotHash: external_exports.string().min(1)
+  })
+]);
+var PublishedExtensionRecordSchema = external_exports.object({
+  extId: external_exports.string().min(1),
+  name: external_exports.string().min(1),
+  version: external_exports.string().min(1),
+  contentHash: external_exports.string().min(1),
+  publishedAt: external_exports.number()
+});
+var PublishCheckSchema = external_exports.discriminatedUnion("kind", [
+  external_exports.object({ kind: external_exports.literal("clean") }),
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("subagent_progress"),
-    toolUseId: external_exports.string(),
-    agentId: external_exports.string(),
-    status: external_exports.enum(["started", "running", "completed", "failed"]),
-    description: external_exports.string().optional(),
-    lastToolName: external_exports.string().optional(),
-    prompt: external_exports.string().optional(),
-    stats: external_exports.object({
-      durationMs: external_exports.number().int().nonnegative().optional(),
-      tokens: external_exports.number().int().nonnegative().optional(),
-      toolUseCount: external_exports.number().int().nonnegative().optional()
-    }).optional()
+    kind: external_exports.literal("ready-new-version"),
+    fromVersion: external_exports.string().min(1),
+    toVersion: external_exports.string().min(1)
   }),
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("error"),
-    message: external_exports.string()
+    kind: external_exports.literal("error-same-hash"),
+    version: external_exports.string().min(1)
   }),
-  // 元信息投递：daemon adapter 从任意来源（stream-json / JSONL）抽出的 SessionMeta 子集
-  // reducer 做 patch merge + diff + persist + 广播 session:info；不入 ring buffer
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("meta_update"),
-    patch: SessionMetaSchema
+    kind: external_exports.literal("error-version-not-bumped"),
+    localVersion: external_exports.string().min(1),
+    publishedVersion: external_exports.string().min(1)
   }),
-  // 系统消息（CC 自家系统提示 / 老板插话补充）；persona 场景下区分两类：
-  //   metaSource='cc'    → CC 注入的系统消息（默认低视觉权重渲染）
-  //   metaSource='owner' → 老板通过 persona:appendOwnerMessage 插入的话（蓝色气泡）
-  // 缺省视为 'cc'；现有非 persona 场景保持兼容（不需要 owner 时不下发该字段）
   external_exports.object({
-    ...ParsedEventBase,
-    kind: external_exports.literal("meta-text"),
-    text: external_exports.string(),
-    metaSource: external_exports.enum(["cc", "owner"]).optional()
+    kind: external_exports.literal("error-version-regression"),
+    localVersion: external_exports.string().min(1),
+    publishedVersion: external_exports.string().min(1)
   })
 ]);
-var SessionCreateArgs = external_exports.object({
-  // 当 ownerPersonaId 存在时 cwd 由 daemon 派生，UI 可不传
-  cwd: external_exports.string().min(1).optional(),
-  tool: external_exports.string().optional(),
-  label: external_exports.string().optional(),
-  model: external_exports.string().optional(),
-  permissionMode: external_exports.string().optional(),
-  effort: external_exports.string().optional(),
-  // 用户在 NewSessionDialog 选择的 icon 标识；UI 端做 enum 兜底
-  iconKey: external_exports.string().optional(),
-  // session:fork 派生 session 时由 UI 传入源 sessionId，daemon 写到 SessionFile.forkedFromSessionId
-  forkedFromSessionId: external_exports.string().min(1).optional(),
-  // 快速问答：创建时打 ephemeral 标记，daemon 写到 SessionFile.ephemeral
-  ephemeral: external_exports.boolean().optional(),
-  // owner-mode persona session：传此字段时 daemon 自行派生 cwd 和启动参数，
-  // 且按 ownerPersonaId 做 idempotent dedupe（每 persona 永远只有一个 owner session）
-  ownerPersonaId: external_exports.string().min(1).optional()
-  // 单栏默认 refactor (spec 2026-06-02)：appBuilderProject 字段已从 SessionCreateArgs 砍掉。
-  // 绑定路径收敛到 appBuilder:createProject —— 先创建空 session（仅传 ownerPersonaId=persona-app-builder），
-  // 后通过 createProject RPC 创建 project 并 daemon 内部 mutate 写入 appBuilderProject。
-  // SessionFile schema 仍保留该字段供 daemon 内部 mutate（manager.update 内部调用通道）。
-}).refine((args) => args.cwd != null || args.ownerPersonaId != null, {
-  message: "cwd \u4E0E ownerPersonaId \u81F3\u5C11\u4F20\u4E00\u4E2A"
+var PublishStatusResultSchema = external_exports.object({
+  localManifest: external_exports.object({
+    name: external_exports.string().min(1),
+    version: external_exports.string().min(1),
+    contentHash: external_exports.string().min(1)
+  }),
+  publishState: external_exports.discriminatedUnion("kind", [
+    external_exports.object({ kind: external_exports.literal("unpublished") }),
+    external_exports.object({
+      kind: external_exports.literal("published"),
+      version: external_exports.string().min(1),
+      contentHash: external_exports.string().min(1),
+      publishedAt: external_exports.number()
+    })
+  ]),
+  check: PublishCheckSchema
 });
-var SessionListArgs = external_exports.object({
-  /** true = 只返回 mirror（originOwnerPrincipalId 非空，即「我在朋友 daemon 上创建」的本机存证）。 */
-  originOnly: external_exports.boolean().optional(),
-  /**
-   * 按 own persona 窄化（2026-07-21 self-persona-sessions 追加）：只留
-   * `s.ownerPersonaId === args.ownerPersonaId` 的 sessions。
-   * - mirror 行（`ownerPersonaId` 恒 null）天然排除
-   * - 与 `originOnly=true` 同传恒返 0
-   * - 老 daemon 不识别时忽略字段返回全量，客户端消费侧本就自带过滤/截断，天然向后兼容
-   */
-  ownerPersonaId: external_exports.string().min(1).optional(),
-  /** 按 updatedAt desc（list 的既有排序）截断前 N 条。 */
-  limit: external_exports.number().int().positive().optional(),
+var ExtensionPublishArgs = external_exports.object({
+  extId: external_exports.string().min(1),
   /**
-   * 分页起点（2026-07-18 android-tasks-tab 迭代追加）：originOnly / ownerPersonaId 过滤后、
-   * limit 截断前跳过前 N 条。与 limit 组合 = updatedAt desc 序上的一页。响应带 total
-   * （过滤后总数，见 handler）供客户端判 hasMore。老 daemon 不识别时忽略 → 回全量，
-   * 客户端按全量兼容。
+   * 可选版本号：给了就在 publish-check 之前重写 manifest.json 的 version。
+   * nullish 而非 optional —— 改造前的 pickOptionalString 显式把 null 当「没给」处理，
+   * 换成纯 optional 会让 `newVersion: null` 从「不 bump」变成 INVALID_PARAM。
    */
-  offset: external_exports.number().int().nonnegative().optional()
-});
-var SessionIdArgs = external_exports.object({ sessionId: external_exports.string().min(1) });
-var SessionUpdateArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  patch: external_exports.object({
-    label: external_exports.string().optional(),
-    model: external_exports.string().optional(),
-    permissionMode: external_exports.string().optional(),
-    effort: external_exports.string().optional(),
-    cwd: external_exports.string().optional(),
-    // 用户在 Edit modal 选择的 icon 标识；UI 端做 enum 兜底
-    iconKey: external_exports.string().optional()
-    // 注意：appBuilderProject 字段已从 patch 中砍掉（spec 2026-06-02-app-builder-single-pane-default-design）。
-    // 绑定单向不可变 —— 由 appBuilder:createProject 在 daemon 内部一次写入；UI / assistant 不再
-    // 通过 sessionUpdate 修改这个字段。SessionFile 仍保留 appBuilderProject 字段供 daemon 内部 mutate。
-  })
-});
-var SessionSendArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  text: external_exports.string()
+  newVersion: external_exports.string().min(1).nullish()
 });
-var SessionRewindArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  userMessageId: external_exports.string().min(1),
-  dryRun: external_exports.boolean().optional()
+var ExtensionIdArgs = external_exports.object({
+  extId: external_exports.string().min(1)
 });
-var SessionRewindResponseSchema = external_exports.object({
-  canRewind: external_exports.boolean(),
-  error: external_exports.string().optional(),
-  filesChanged: external_exports.array(external_exports.string()).optional(),
-  insertions: external_exports.number().int().nonnegative().optional(),
-  deletions: external_exports.number().int().nonnegative().optional()
+var ExtensionFetchBundleArgs = external_exports.object({
+  extId: external_exports.string().min(1),
+  snapshotHash: external_exports.string().min(1)
 });
-var SessionRewindDiffArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  userMessageId: external_exports.string().min(1)
+var ExtensionFromChannelArgs = external_exports.object({
+  channelRef: ChannelRefSchema,
+  snapshotHash: external_exports.string().min(1),
+  zipBase64: external_exports.string().min(1)
 });
-var RewindDiffHunkSchema = external_exports.object({
-  oldStart: external_exports.number().int().nonnegative(),
-  oldLines: external_exports.number().int().nonnegative(),
-  newStart: external_exports.number().int().nonnegative(),
-  newLines: external_exports.number().int().nonnegative(),
-  lines: external_exports.array(external_exports.string())
-});
-var RewindDiffFileSchema = external_exports.object({
-  filePath: external_exports.string().min(1),
-  hunks: external_exports.array(RewindDiffHunkSchema),
-  insertions: external_exports.number().int().nonnegative(),
-  deletions: external_exports.number().int().nonnegative(),
-  status: external_exports.enum(["modified", "added", "deleted"]).optional()
-});
-var SessionRewindDiffResponseSchema = external_exports.object({
-  canRewind: external_exports.boolean(),
-  error: external_exports.string().optional(),
-  files: external_exports.array(RewindDiffFileSchema),
-  totalInsertions: external_exports.number().int().nonnegative(),
-  totalDeletions: external_exports.number().int().nonnegative()
-});
-var SessionRewindableMessageIdsResponseSchema = external_exports.object({
-  userMessageIds: external_exports.array(external_exports.string())
-});
-var SessionResumeArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  toolSessionId: external_exports.string().min(1)
-});
-var SessionForkArgs = external_exports.object({
-  cwd: external_exports.string().min(1),
-  toolSessionId: external_exports.string().min(1),
-  messageUuid: external_exports.string().min(1)
-});
-var SessionForkResponseSchema = external_exports.object({
-  forkedToolSessionId: external_exports.string().min(1),
-  forkedFilePath: external_exports.string().min(1)
-});
-var SessionObserveArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  toolSessionId: external_exports.string().min(1),
-  jsonlPath: external_exports.string().optional()
-});
-var SessionEventsArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  // -1 表示"从头拉全量"（尚未见过任何事件）；seq 从 0 起，所以合法下界是 -1
-  afterSeq: external_exports.number().int().min(-1)
-});
-var PermissionRespondArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  // 权限请求 id 用 `permissionRequestId`，**不能**叫 `requestId`：WS 传输层用帧顶层的
-  // `requestId` 做 RPC 请求/响应关联（daemon-client 发帧时 `{...args, type, requestId}`，
-  // 传输 id 在最后会覆盖 args 同名字段）。若沿用 `requestId`，权限 id 会被传输 id（如 "r61"）
-  // 覆盖，daemon 查 pendingPermissions 永远 miss → 点了允许一直卡住。
-  permissionRequestId: external_exports.string().min(1),
-  allow: external_exports.boolean(),
-  permanent: external_exports.boolean().optional(),
-  pattern: external_exports.string().optional()
-});
-var HistoryListArgs = external_exports.object({ projectPath: external_exports.string().min(1) });
-var HistoryReadArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  limit: external_exports.number().int().positive().max(5e3).optional(),
-  /** 不传时走 tail 语义：daemon 返回最后 limit 条（offset = max(0, total - limit)） */
-  offset: external_exports.number().int().nonnegative().optional(),
-  /**
-   * 瘦身投影（2026-07-18 android-tasks-tab 迭代，v2 语义）：true = daemon 裁掉窄消费面客户端
-   * （mobile）不渲染的大字段（input / output / raw / toolResultExtra / memories /
-   * sourceToolAssistantUUID），meta 注入行 text 截 500 字符。**例外：出错的工具调用全量保留**——
-   * 本页内 error 非空的 tool_result 保留 output，且其同 toolUseId 的 tool_call 保留 input
-   * （用户要能看清「啥错了」；老板 2026-07-18 拍板：普通工具调用手机不渲染，错误全量展示）。
-   * desktop 渲染 tool card 需全文，不用此参数。老 daemon 不识别 → 回全量，客户端向后兼容。
-   */
-  slim: external_exports.boolean().optional()
-});
-var HistorySubagentsArgs = external_exports.object({
-  cwd: external_exports.string().min(1),
-  toolSessionId: external_exports.string().min(1)
-});
-var HistorySubagentReadArgs = external_exports.object({
-  cwd: external_exports.string().min(1),
-  toolSessionId: external_exports.string().min(1),
-  subagentId: external_exports.string().min(1)
-});
-var WorkspaceListArgs = external_exports.object({
-  // cwd 缺省则 daemon 兜底 os.homedir()；UI 的 DirBrowser 首次浏览就走这条路径
-  cwd: external_exports.string().min(1).optional(),
-  path: external_exports.string().optional(),
-  showHidden: external_exports.boolean().optional()
-});
-var WorkspaceReadArgs = external_exports.object({
-  cwd: external_exports.string().min(1),
-  path: external_exports.string().min(1)
+
+// ../protocol/src/inbox.ts
+var InboxMessageSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  peerDeviceId: external_exports.string().min(1),
+  senderDeviceId: external_exports.string().min(1),
+  text: external_exports.string().min(1),
+  createdAt: external_exports.number().int().nonnegative(),
+  readBy: external_exports.record(external_exports.string().min(1), external_exports.number().int().positive()).default({}),
+  // persona 代发署名（B 版设计）：非空 = 该消息由某 persona 代发，非真人手打。
+  // 缺省 = 真人。routing 身份仍看 senderDeviceId；origin 只用于末端 UI 渲染来源。
+  origin: external_exports.object({ kind: external_exports.literal("persona"), personaId: external_exports.string().min(1) }).optional()
+}).strict();
+var InboxPostMessageArgsSchema = external_exports.object({
+  peerDeviceId: external_exports.string().min(1).optional(),
+  id: external_exports.string().min(1),
+  text: external_exports.string().min(1),
+  createdAt: external_exports.number().int().nonnegative(),
+  // persona 代发署名（跨 daemon forward 时随远程腿透传；真人发缺省）。
+  origin: external_exports.object({ kind: external_exports.literal("persona"), personaId: external_exports.string().min(1) }).optional()
+}).strict();
+var InboxListArgsSchema = external_exports.object({
+  peerDeviceId: external_exports.string().min(1),
+  sinceCreatedAt: external_exports.number().int().nonnegative().optional()
+}).strict();
+var InboxMarkReadArgsSchema = external_exports.object({
+  peerDeviceId: external_exports.string().min(1),
+  upToCreatedAt: external_exports.number().int().nonnegative()
+}).strict();
+var InboxSendDmArgsSchema = external_exports.object({
+  peerDeviceId: external_exports.string().min(1).optional(),
+  text: external_exports.string().min(1)
 });
-var SkillsListArgs = external_exports.object({ cwd: external_exports.string().min(1), tool: external_exports.string().optional() });
-var SkillEntrySchema = external_exports.object({
+
+// ../protocol/src/peer-exec.ts
+var PeerExecRunArgsSchema = external_exports.object({
+  /** A 侧发起时带：目标设备 deviceId。peer-forward 转发前 strip 掉，B 侧本地执行时无此字段。 */
+  peerDeviceId: external_exports.string().min(1).optional(),
+  /** 交给对端 `bash -c` 的命令；cc 自拼完整路径（一发一收，无跨命令会话状态）。 */
+  command: external_exports.string().min(1),
+  /** 超时上限（ms）；缺省用 handler 默认 30_000，clamp 300_000。 */
+  timeoutMs: external_exports.number().int().positive().optional()
+}).strict();
+var PeerExecRunOkSchema = external_exports.object({
+  type: external_exports.literal("peerExec:run:ok"),
+  stdout: external_exports.string(),
+  stderr: external_exports.string(),
+  /** 进程退出码；被超时 kill 时 null。 */
+  exitCode: external_exports.number().int().nullable(),
+  timedOut: external_exports.boolean(),
+  stdoutTruncated: external_exports.boolean(),
+  stderrTruncated: external_exports.boolean()
+}).strict();
+
+// ../protocol/src/shift-internal.ts
+var ShiftScheduleSchema = external_exports.discriminatedUnion("kind", [
+  /** ISO-8601 时间点；时区随字符串自带 */
+  external_exports.object({ kind: external_exports.literal("at"), at: external_exports.string().min(1) }),
+  /** 固定间隔；anchorMs 缺省 = 从登记时刻起算 */
+  external_exports.object({
+    kind: external_exports.literal("every"),
+    everyMs: external_exports.number().int().positive(),
+    anchorMs: external_exports.number().int().nonnegative().optional()
+  }),
+  /** 5 字段 cron 表达式；tz 缺省 = 系统本地时区 */
+  external_exports.object({ kind: external_exports.literal("cron"), expr: external_exports.string().min(1), tz: external_exports.string().min(1).optional() })
+]);
+var personaId = external_exports.string().trim().min(1);
+var ShiftInternalAddArgs = external_exports.object({
+  personaId,
   name: external_exports.string().min(1),
-  source: external_exports.enum(SKILL_SOURCE_VALUES),
-  path: external_exports.string().optional(),
-  description: external_exports.string().optional(),
-  plugin: external_exports.string().optional()
+  schedule: ShiftScheduleSchema,
+  prompt: external_exports.string().min(1),
+  /** 缺省 = 派给调用方自己 */
+  targetPersona: external_exports.string().min(1).optional(),
+  timeoutMs: external_exports.number().int().positive().optional()
 });
-var AgentEntrySchema = external_exports.object({
-  name: external_exports.string().min(1),
-  source: external_exports.enum(AGENT_SOURCE_VALUES),
-  path: external_exports.string().optional(),
-  description: external_exports.string().optional(),
-  whenToUse: external_exports.string().optional(),
-  plugin: external_exports.string().optional()
+var ShiftInternalListArgs = external_exports.object({
+  personaId,
+  /** 缺省 true —— 只列本 persona 建的 */
+  onlyMine: external_exports.boolean().optional()
 });
-var AgentsListArgs = external_exports.object({ cwd: external_exports.string().min(1), tool: external_exports.string().optional() });
-var AgentsListResponseSchema = external_exports.object({
-  agents: external_exports.array(AgentEntrySchema)
+var ShiftInternalCancelArgs = external_exports.object({
+  personaId,
+  shiftId: external_exports.string().min(1)
 });
-var SessionSubscribeArgs = external_exports.object({ sessionId: external_exports.string().min(1) });
-var SessionPinArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  pinned: external_exports.boolean()
+var ShiftPatchSchema = external_exports.object({
+  name: external_exports.string().min(1).optional(),
+  schedule: ShiftScheduleSchema.optional(),
+  prompt: external_exports.string().min(1).optional(),
+  targetPersona: external_exports.string().min(1).optional(),
+  timeoutMs: external_exports.number().int().positive().optional(),
+  enabled: external_exports.boolean().optional()
 });
-var PeerSessionUpsertResponseSchema = external_exports.object({
-  type: external_exports.literal("peerSession:upsert:ok")
+var ShiftInternalUpdateArgs = external_exports.object({
+  personaId,
+  shiftId: external_exports.string().min(1),
+  patch: ShiftPatchSchema
 });
-var PeerSessionRemoveArgs = external_exports.object({ sessionId: external_exports.string().min(1) });
-var PeerSessionRemoveResponseSchema = external_exports.object({
-  type: external_exports.literal("peerSession:remove:ok")
+var ShiftInternalHistoryArgs = external_exports.object({
+  personaId,
+  shiftId: external_exports.string().min(1),
+  limit: external_exports.number().int().positive().optional()
 });
-var SessionReorderPinsArgs = external_exports.object({
-  orderedIds: external_exports.array(external_exports.string().min(1)).min(1)
+
+// ../protocol/src/persona-schemas.ts
+var PersonaFileSchema = external_exports.object({
+  personaId: external_exports.string(),
+  label: external_exports.string(),
+  model: external_exports.string().optional(),
+  public: external_exports.boolean(),
+  // 8-key set defined UI-side in `lib/session-icons.ts`; protocol stays plain string
+  // for forward compatibility, consumer fallbacks to default when key not found.
+  iconKey: external_exports.string().optional(),
+  // 绑定的 agent tool（'claude' / 'codex'）；缺省消费侧按 'claude' 兜底。
+  // 与 model 平行：persona 新建 session 的默认 tool，可平滑切换。
+  tool: external_exports.string().optional(),
+  createdAt: external_exports.number(),
+  updatedAt: external_exports.number()
+}).strict();
+var PersonaSkillSummarySchema = external_exports.object({
+  // 目录名作为 skill name（对齐 CC：frontmatter `name:` 仅作 displayName 用）
+  name: external_exports.string().min(1),
+  // SKILL.md frontmatter `description:`；缺省时省略字段
+  description: external_exports.string().optional()
 });
-var GitRootArgs = external_exports.object({ cwd: external_exports.string().min(1) });
-var GitRootResponseSchema = external_exports.object({
-  isGitRoot: external_exports.boolean(),
-  gitRoot: external_exports.string().nullable()
+var PersonaPluginSummarySchema = external_exports.object({
+  // settings.json 中 enabledPlugins 的 key，例如 'superpowers@claude-plugins-official'
+  id: external_exports.string().min(1)
 });
-var GitBranchArgs = external_exports.object({ cwd: external_exports.string().min(1) });
-var GitBranchResponseSchema = external_exports.object({
-  branch: external_exports.string().nullable()
+var PersonaSandboxSettingsSchema = external_exports.object({
+  permissions: external_exports.object({
+    defaultMode: external_exports.string().optional(),
+    // CC 工具 allowlist（'Bash'/'Read'/...）。per-persona profile 在最严格 base 上追加放开。
+    allow: external_exports.array(external_exports.string()).optional(),
+    // deny 优先级最高；强制底座（persona 私密区）由 daemon compose 强制 union，owner 删不掉。
+    deny: external_exports.array(external_exports.string()).optional()
+  }).optional(),
+  sandbox: external_exports.object({
+    enabled: external_exports.boolean().optional(),
+    autoAllowBashIfSandboxed: external_exports.boolean().optional(),
+    allowUnsandboxedCommands: external_exports.boolean().optional(),
+    // 命令前缀白名单（CC `sandbox.excludedCommands`）：匹配的命令在沙箱外运行，
+    // 用于需逃出沙箱的工具（如 'docker *' / 'aliyun *' 要访问宿主 socket / 凭证）。
+    excludedCommands: external_exports.array(external_exports.string()).optional(),
+    filesystem: external_exports.object({
+      denyRead: external_exports.array(external_exports.string()).optional(),
+      allowRead: external_exports.array(external_exports.string()).optional(),
+      denyWrite: external_exports.array(external_exports.string()).optional(),
+      allowWrite: external_exports.array(external_exports.string()).optional()
+    }).optional(),
+    // 出站网络 + 本机端口。base 不放（空），profile 按需追加域名（app-builder = ['*']）。
+    network: external_exports.object({
+      allowedDomains: external_exports.array(external_exports.string()).optional(),
+      allowLocalBinding: external_exports.boolean().optional()
+    }).optional()
+  }).optional()
 });
-var GitBranchesArgs = external_exports.object({ cwd: external_exports.string().min(1) });
-var GitBranchesResponseSchema = external_exports.object({
-  branches: external_exports.array(external_exports.string()),
-  head: external_exports.string().nullable()
+var PersonaInfoResponseSchema = PersonaFileSchema.extend({
+  personality: external_exports.string().optional(),
+  // 仅 'persona:get' 携带；null = 文件不存在 / parse 失败；undefined = 不在该响应类型上
+  skills: external_exports.array(PersonaSkillSummarySchema).optional(),
+  // 仅 'persona:get' 携带；空数组 = 没启用任何插件 / settings.json 不存在；undefined = 不在该响应类型上
+  plugins: external_exports.array(PersonaPluginSummarySchema).optional(),
+  sandboxSettings: PersonaSandboxSettingsSchema.nullable().optional()
 });
-var HistoryRecentDirsArgs = external_exports.object({}).optional();
-var RecentDirEntrySchema = external_exports.object({
-  cwd: external_exports.string().min(1),
-  updatedAt: external_exports.string().min(1)
+var PersonaCreateArgsSchema = external_exports.object({
+  label: external_exports.string().min(1),
+  personality: external_exports.string(),
+  model: external_exports.string().optional(),
+  tool: external_exports.string().optional(),
+  public: external_exports.boolean().optional(),
+  iconKey: external_exports.string().optional()
+}).strict();
+var PersonaIdArgsSchema = external_exports.object({
+  personaId: external_exports.string().min(1)
 });
-var HistoryRecentDirsResponseSchema = external_exports.object({
-  dirs: external_exports.array(RecentDirEntrySchema)
-});
-var SessionQuestionFrameSchema = external_exports.object({
-  type: external_exports.literal("session:question"),
-  sessionId: external_exports.string().min(1),
-  toolUseId: external_exports.string().min(1),
-  requestId: external_exports.string().min(1),
-  // UI 单卡承载多 question；空数组语义无效，schema 必拒
-  questions: external_exports.array(AskQuestionItemSchema).min(1)
+var PersonaUpdateArgsSchema = external_exports.object({
+  personaId: external_exports.string().min(1),
+  patch: external_exports.object({
+    label: external_exports.string().min(1).optional(),
+    model: external_exports.string().optional(),
+    tool: external_exports.string().optional(),
+    personality: external_exports.string().optional(),
+    public: external_exports.boolean().optional(),
+    // pass `null` to clear; daemon strips the field from PersonaFile on null
+    iconKey: external_exports.string().nullable().optional()
+  }).strict()
+}).strict();
+var CodexSandboxSettingsSchema = external_exports.object({
+  // 额外可写的绝对路径或 ~ 路径（pnpm 工具链等）；workspace(cwd) 和 userWorkDir 由 daemon 自动加，不用列。
+  writableRoots: external_exports.array(external_exports.string()).optional(),
+  // 禁读 glob（相对 workspace root 或绝对），如 ".secrets/**"、"**/*.env"。
+  denyRead: external_exports.array(external_exports.string()).optional(),
+  // true → 网络全放(*)；缺省/false → 断网。
+  network: external_exports.boolean().optional()
+}).strict();
+
+// ../protocol/src/events.ts
+var SESSION_STATUS_VALUES = [
+  "idle",
+  "running",
+  "running-idle",
+  "stopped",
+  "error",
+  "observing"
+];
+var HISTORY_USER_META_VALUES = [
+  "task-notification",
+  "slash-command",
+  "local-command",
+  "system-reminder",
+  "skill-hint",
+  "meta-text",
+  "attachment-skills",
+  "attachment-deferred-tools"
+];
+var SKILL_SOURCE_VALUES = ["builtin", "global", "project", "plugin"];
+var AGENT_SOURCE_VALUES = [
+  "builtin",
+  "global",
+  "project",
+  "policy",
+  "plugin"
+];
+
+// ../protocol/src/principal.ts
+var PrincipalKindSchema = external_exports.enum(["owner", "guest"]);
+var PrincipalSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  kind: PrincipalKindSchema,
+  displayName: external_exports.string(),
+  /**
+   * 飞书 union_id。owner: 本机 daemon 已飞书登录时透传自 owner-identity.json；未登录 undefined。
+   * guest: v1 保持 undefined（connect token 当前不携带 unionId；未来若签名 payload 加字段可透传）。
+   * 消费方（如 ticket MCP / 未来别的飞书身份挂钩场景）按 undefined 决定是否降级；本层不做 fallback。
+   */
+  feishuUnionId: external_exports.string().optional()
+}).strict();
+var SenderInfoSchema = external_exports.object({
+  /** = principal.id = deviceId（决策 #16）。稳定路由 id */
+  did: external_exports.string().min(1),
+  displayName: external_exports.string(),
+  /** owner 未登录 / guest 无飞书身份时缺省。消费方各自决定是否降级 */
+  feishuUnionId: external_exports.string().optional(),
+  principal: PrincipalKindSchema
+}).strict();
+
+// ../protocol/src/schemas.ts
+var SessionStatusSchema = external_exports.enum(SESSION_STATUS_VALUES);
+var UsageSchema = external_exports.object({
+  input_tokens: external_exports.number().int().nonnegative().optional(),
+  cache_read_input_tokens: external_exports.number().int().nonnegative().optional(),
+  cache_creation_input_tokens: external_exports.number().int().nonnegative().optional(),
+  output_tokens: external_exports.number().int().nonnegative().optional()
 });
-var SessionQuestionClearedFrameSchema = external_exports.object({
-  type: external_exports.literal("session:question:cleared"),
-  sessionId: external_exports.string().min(1),
-  toolUseId: external_exports.string().min(1),
-  // record<string,string>：与 AnswerQuestionArgs.answers 同形状（question text → label）
-  answers: external_exports.record(external_exports.string(), external_exports.string()).optional()
+var ContextUsageSchema = external_exports.object({
+  inputTokens: external_exports.number().int().nonnegative(),
+  outputTokens: external_exports.number().int().nonnegative(),
+  cacheReadTokens: external_exports.number().int().nonnegative().optional(),
+  cacheCreateTokens: external_exports.number().int().nonnegative().optional()
 });
-var AnswerQuestionArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  toolUseId: external_exports.string().min(1),
-  answers: external_exports.record(external_exports.string(), external_exports.string())
+var sessionMetaShape = {
+  gitBranch: external_exports.string().optional(),
+  resolvedModel: external_exports.string().optional(),
+  contextUsage: ContextUsageSchema.optional(),
+  contextWindowSize: external_exports.number().int().positive().optional()
+};
+var SessionMetaSchema = external_exports.object(sessionMetaShape);
+var ModelInfoSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  label: external_exports.string().min(1),
+  description: external_exports.string().optional(),
+  contextWindowSize: external_exports.number().int().positive(),
+  default: external_exports.boolean().optional()
 });
-var AnswerQuestionResponseSchema = external_exports.object({ ok: external_exports.literal(true) });
-var CancelQuestionArgs = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  toolUseId: external_exports.string().min(1)
+var ModeInfoSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  label: external_exports.string().min(1),
+  description: external_exports.string().optional()
 });
-var CancelQuestionResponseSchema = external_exports.object({ ok: external_exports.literal(true) });
-var AuthRequestFrameSchema = external_exports.object({
-  type: external_exports.literal("auth"),
-  token: external_exports.string().min(1),
-  scheme: external_exports.literal("bearer").optional(),
-  /**
-   * 决策 #16：自报身份字段（selfPrincipalId / selfDisplayName / selfDeviceId）全部删除——
-   * guest 的设备 id / 人 id / 来源全部由 connect token 的 subDevice/subOwner/provider 签名背书
-   * （server 签、目标设备本地验签，不可伪造），不再接受任何自报身份。
-   *
-   * selfUrl 已废弃（spec 2026-07-22 双向确认建联）：可达地址自报移入 contact:handshake
-   * args——auth 层回归纯验票。旧客户端发来的 selfUrl 被 strip（zod 默认），无害；
-   * 旧客户端本身由 whoami 的 connect-token 拒绝路径拦截（CLIENT_OUTDATED）。
-   */
-  /**
-   * 客户端自报的 user-agent 性质标签（诊断/展示用）。
-   * 「自报事实」，非身份（决策 #16 边界）：不参与鉴权、不参与路由、
-   * 任何 handler 不得据此做权限判断。name 约定命名（'clawd-desktop' / 'clawd-web' /
-   * 'clawd-mobile-android' / ...），宽容未知值（将来加新客户端不动 schema）。
-   * instanceId：客户端首启生成 UUID 并本地持久化——区分同种类多实例（多手机/多 desktop 同连）。
-   */
-  clientInfo: external_exports.object({
-    name: external_exports.string().min(1),
-    version: external_exports.string().min(1),
-    instanceId: external_exports.string().min(1)
-  }).optional()
+var ConfigFieldSchemaSchema = external_exports.object({
+  name: external_exports.string().min(1),
+  type: external_exports.enum(["string", "select", "toggle"]),
+  label: external_exports.string().min(1),
+  description: external_exports.string().optional(),
+  options: external_exports.array(
+    external_exports.object({
+      value: external_exports.string(),
+      label: external_exports.string(),
+      description: external_exports.string().optional()
+    })
+  ).optional(),
+  default: external_exports.unknown().optional(),
+  scope: external_exports.enum(["core", "tool-specific"])
 });
-var AuthOkFrameSchema = external_exports.object({
-  type: external_exports.literal("auth:ok"),
-  version: external_exports.string().min(1).optional(),
-  protocolVersion: external_exports.number().int().nonnegative().optional()
+var CapabilitiesGetArgs = external_exports.object({
+  tool: external_exports.string().min(1)
 });
-var TunnelReadyEventSchema = external_exports.object({
-  type: external_exports.literal("tunnel:ready"),
-  url: external_exports.string().min(1),
-  subdomain: external_exports.string().min(1)
+var ToolFeaturesSchema = external_exports.object({
+  rewind: external_exports.boolean(),
+  subagents: external_exports.boolean(),
+  tui: external_exports.boolean(),
+  observe: external_exports.boolean(),
+  fileSharing: external_exports.boolean(),
+  // fork：session:fork 走 forkSession（claude jsonl 专用，派生新 jsonl）。codex 无 claude jsonl
+  // → fork 不可用。UI 据此 gate assistant 消息上的 fork 按钮（codex 一轮多条消息会刷出一堆按钮且点了报错）。
+  fork: external_exports.boolean()
 });
-var TunnelExitedEventSchema = external_exports.object({
-  type: external_exports.literal("tunnel:exited"),
-  code: external_exports.number().int().nullable(),
-  subdomain: external_exports.string().nullable(),
-  url: external_exports.string().nullable()
+var CapabilitiesResponseSchema = external_exports.object({
+  tool: external_exports.string().min(1),
+  toolSessionIdLabel: external_exports.string().optional(),
+  models: external_exports.array(ModelInfoSchema),
+  permissionModes: external_exports.array(ModeInfoSchema),
+  configSchema: external_exports.array(ConfigFieldSchemaSchema),
+  features: ToolFeaturesSchema
 });
-var TunnelUnavailableEventSchema = external_exports.object({
-  type: external_exports.literal("tunnel:unavailable"),
-  reason: external_exports.string().min(1),
-  failedAt: external_exports.string().min(1)
+var AllowRuleSchema = external_exports.object({
+  tool: external_exports.string().min(1),
+  pattern: external_exports.string().min(1),
+  createdAt: external_exports.string().min(1).optional()
 });
-var InfoRunningSessionSchema = external_exports.object({
+var SessionFileSchema = external_exports.object({
   sessionId: external_exports.string().min(1),
-  status: SessionStatusSchema,
-  freshSpawn: external_exports.boolean(),
-  pendingPermissionRequestIds: external_exports.array(external_exports.string().min(1)),
-  pendingQuestionToolUseIds: external_exports.array(external_exports.string().min(1))
-});
-var InfoResponseSchema = external_exports.object({
-  type: external_exports.literal("info"),
-  version: external_exports.string(),
-  protocolVersion: external_exports.number(),
-  hostname: external_exports.string(),
-  os: external_exports.string(),
-  tools: external_exports.array(external_exports.object({ id: external_exports.string(), available: external_exports.boolean() })),
-  runningSessions: external_exports.array(InfoRunningSessionSchema),
-  // ── file-sharing 会话身份回执（spec: superpowers/specs/2026-05-19-clawd-file-sharing-design.md §8） ──
-  // PR 1 阶段标 optional（daemon 还没下发，旧 daemon info 响应不带这五个字段）；
-  // PR 2 daemon 实现 single HTTP server + auth-context 后，daemon 必返这五个字段，
-  // 届时可考虑改成 required。spec §11 第 3 条："tokenRole 是协议字段，daemon 查 token
-  // 表后显式下发，UI 不自行推导"——所以 UI 一律读这里，禁止本地推导。
-  /** 'owner' = 拿到 owner-token 的连接（不限来源 IP）。来源 TOKEN_ROLES（spec §11 #1 中央真理源）。
-   *  历史 'personal' role（persona file-sharing token）在 2026-05-21 删除；tokenPersonaId 一同移除。 */
-  tokenRole: external_exports.enum(TOKEN_ROLES).optional(),
-  /** socket.remoteAddress 是否落在 127.0.0.1 / ::1；本期无 RPC 消费，保留协议槽位给未来 "Reveal in Finder" 等本机动作 */
-  isLoopback: external_exports.boolean().optional(),
-  /** UI 拼 file-sharing HTTP 路由的前缀（http(s)://host:port），不含尾斜杠；frpc 反代时返反代地址 */
-  httpBaseUrl: external_exports.string().optional(),
-  /** file-sharing HTTP 路由的 Authorization: Bearer token；与 WS token 解耦，HTTP 401 仅触发 ReAuth 不强踢 WS（spec §11 第 4 条） */
-  httpToken: external_exports.string().optional()
-});
-var PROJECT_PORT_MIN = 6173;
-var PROJECT_PORT_MAX = 6272;
-var projectNameRegex = /^[a-z][a-z0-9-]{0,39}$/;
-var ProjectMetadataSchema = external_exports.object({
-  name: external_exports.string().regex(projectNameRegex, {
-    message: "kebab-case, \u5C0F\u5199\u5B57\u6BCD\u5F00\u5934\uFF0C\u53EA\u5141\u8BB8\u5C0F\u5199\u5B57\u6BCD / \u6570\u5B57 / -\uFF0C\u6700\u957F 40 \u5B57\u7B26"
-  }),
-  port: external_exports.number().int().min(PROJECT_PORT_MIN).max(PROJECT_PORT_MAX),
-  createdAt: external_exports.string().datetime(),
-  /** dev server 启动命令（shell 字符串）；占位符 $CLAWD_PREVIEW_PORT 替换 + env 注入 */
-  devCommand: external_exports.string().min(1),
-  /**
-   * 发布上线后的公网 URL（spec 2026-06-02-app-builder-single-pane-default-design §5.6.1）。
-   * assistant 跑完 publish.sh 后调 appBuilder:setProdUrl 写入；UI 读这个字段切预览栏到线上 URL，
-   * 取代旧 `<builder-preview url=... label="prod" />` marker 机制。
-   * 老 project 元数据无此字段（optional 兼容）。
-   */
-  prodUrl: external_exports.string().url().optional(),
-  /**
-   * dev server 就绪 stdout regex（spec 2026-06-02-app-builder-explicit-dev-server-control §2）。
-   * supervisor spawn 后会监听子进程 stdout，命中此 regex 视为 dev server 真 ready；
-   * 仅当 await ready 后才把 stage 切到 'running'，避免 cold start race 导致 iframe 502。
-   * optional：缺省时 supervisor 用默认 /Local:\s+https?:\/\//（vite "Local: http://..." 输出）。
-   * 老板换非 vite 技术栈（Next.js "Ready in"、webpack "Compiled" 等）时自定义这个字段。
-   */
-  readyPattern: external_exports.string().optional(),
+  cwd: external_exports.string().min(1),
+  tool: external_exports.literal("claude").or(external_exports.string().min(1)).default("claude"),
+  // 归一化 tool 侧 session id（CC = claude session uuid，Codex = codex 自己的 id）
+  toolSessionId: external_exports.string().optional(),
+  label: external_exports.string().optional(),
+  model: external_exports.string().optional(),
+  permissionMode: external_exports.string().optional(),
+  effort: external_exports.string().optional(),
+  // 归一化运行时观测字段（daemon 独立计算，session:update 不接受；meta_update 事件投递）
+  ...sessionMetaShape,
+  permissionRules: external_exports.array(AllowRuleSchema).optional(),
+  // Sidebar 置顶时间戳；null/undefined 表示未置顶
+  pinnedAt: external_exports.number().int().nonnegative().nullable().optional(),
+  // pinned 行手动拖拽顺序；越小越靠前。session:reorderPins 整体重写所有 pinned 的此字段。
+  // 缺失时 view-state 排序回退到 pinnedAt desc（旧数据兼容）
+  pinSortOrder: external_exports.number().int().nullable().optional(),
+  // daemon 权威的共享未读标记（spec 2026-07-20-shared-session-unread）：
+  // session wire status 从 running 跃迁为非 running 时 daemon 置为当时 ISO 时间戳；
+  // session:markRead RPC 或新 turn 开始（→ running）时清为 null。
+  // 所有客户端（desktop / mobile）共享同一份，任一端标读全端清。
+  unreadAt: external_exports.string().min(1).nullable().optional(),
+  // 用户在 NewSessionDialog 或 Edit modal 选择的 icon 标识；UI 端做 enum 兜底
+  iconKey: external_exports.string().optional(),
+  // 由 session:fork 派生的 session 在 create 时记录源 session 的 sessionId（稳定 key，
+  // 不受 parent clear / re-spawn 影响）；sidebar 据此挂 fork 图标。非 fork session 该字段缺省。
+  // 旧字段 forkedFromToolSessionId 已弃用，daemon 启动时一次性迁移老数据
+  forkedFromSessionId: external_exports.string().min(1).optional(),
+  // 快速问答临时会话标记（spec 2026-06-23-fork-quick-ask）：true = 关闭抽屉即删、
+  // 不进 sidebar 树、daemon 启动清扫孤儿。普通会话缺省。
+  ephemeral: external_exports.boolean().optional(),
+  // owner-mode persona session 身份标识；UI 用它在 SessionList 过滤 + jump，
+  // daemon 用它做 idempotent dedupe + spawn 时派生 ctx.personaMode='owner'
+  ownerPersonaId: external_exports.string().min(1).optional(),
+  // app-builder Project 反向索引（spec: superpowers/specs/2026-06-01-app-builder-project-picker-design.md）。
+  // 当此 session 绑定到某个 build 中的 project 时填写；name 与 projects/<name>/ 子目录同名，
+  // 受 projectNameSchema regex 约束。daemon session:resume 时校验该目录存在，不存在则拒。
+  appBuilderProject: external_exports.string().regex(/^[a-z][a-z0-9-]{0,39}$/).optional(),
+  // listener-mode sub-session 的原始 chatId（owner-mode 不写；listener-scope 强制写入）。
+  // 派生 sessionId 是单向 hash `${personaId}-${tokenHash12}-${chatHash8}`，必须保留原始 chatId
+  // 才能让 alice 重连同一 sub-session（持久化在 alice localStorage 之外，由 daemon push 同步）。
+  // optional 是因为 owner-mode session 不带；只要写入就是 listener-mode 必填三元组。
+  chatId: external_exports.string().min(1).optional(),
   /**
-   * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.1.4)：
-   * in-flight 发布 job 的元数据。仅承载"in-flight"或"中断残骸"两种状态：
-   *   - daemon spawn publish.sh + 收到第一个 ::stage::build marker 时写入
-   *   - 每次 stage 切换更新 stage 字段
-   *   - 成功 / 正常失败 / 用户 dismiss 时立即清掉
-   *   - 只有 daemon 崩才会留残骸（子进程随 daemon 一起死）
-   * status 字段在 ProjectWithStatus 派生而不在这里 —— 本 schema 是落盘形态，
-   * "in-flight vs interrupted" 区分由 daemon 响应时实时拼 registry 状态得出。
+   * 创建该 session 的设备 id（决策 #16：从 ctx.principal.id 派生 = deviceId）。
+   * UI 端 self 判定收敛为单一比较 `!creatorPrincipalId || creatorPrincipalId === 本机 deviceId`
+   * → 「我自己创建」vs「别的设备接入创建」。MyPersonas 二级分组按 creatorPrincipalId(设备)
+   * 分桶、按 contact(deviceId→ownerName) 反查显示名。
+   *
+   * 命名保留 creatorPrincipalId（命名债，语义已是 creatorDeviceId）；值由 connect token
+   * subDevice 背书（guest ctx）或本机 deviceId（owner ctx）。optional 兼容老 session。
+   *
+   * 决策 #16 删除了 creatorOwnerPrincipalId（personal token #735 遗留）——当年 guest 的
+   * principal.id 都是同张 cap.id 区分不了人才加它；现在 principal.id = 设备 deviceId、
+   * 归属人由 contact(deviceId→ownerId) 反查，该字段理由消失。
    */
-  publishJob: external_exports.object({
-    jobId: external_exports.string().min(1),
-    stage: external_exports.enum(["build", "deploy", "verify"]),
-    startedAt: external_exports.number().int().nonnegative()
-  }).optional()
-});
-var PROJECT_STAGE_VALUES = [
-  "install-pending",
-  // createProject 刚返回，scaffold 已完成（daemon 同步内联跑），等 assistant pnpm install
-  "installing",
-  // assistant pnpm install 中
-  "starting-dev-server",
-  // startDevServer 已调，supervisor spawn 子进程中（await ready 期间也在此 stage）
-  "running",
-  // dev server 跑起来了（supervisor stdout 命中 readyPattern + 端口已监听）
-  "stopped",
-  // 用户显式点"收起预览"停掉 / daemon 重启后默认；UI 渲染折叠条 + "展开预览"按钮
-  "failed"
-  // 某个阶段失败（stageReason 字段携带原因，含 dev server cold start timeout）
-];
-var ProjectStageSchema = external_exports.enum(PROJECT_STAGE_VALUES);
-var ProjectWithStatusSchema = ProjectMetadataSchema.extend({
-  isRunning: external_exports.boolean(),
-  boundSessionId: external_exports.string().nullable(),
+  creatorPrincipalId: external_exports.string().min(1).optional(),
   /**
-   * 单栏 refactor stage fix (spec 2026-06-02 §5.6.2)：daemon 内存维护的当前 stage。
-   * UI 据此切 PreviewPane spinner / iframe / error。
-   * optional 兼容启动后 daemon 还没有 stage 记录的 fresh project（按 isRunning 推断兜底）。
+   * 创建该 session 的连接者飞书 displayName（一次性 stamp）。session:create handler
+   * 从 ctx.principal.displayName 传入；newRunner 时读这个字段派生 SubSessionMeta.callerDisplayName，
+   * 注入到 cc system prompt 引导自我介绍（见 connection-prompt.ts）。
+   * Optional 兼容老 SessionFile——newRunner 读不到时 fallback ContactStore 反查（guest）
+   * 或 deps.ownerDisplayName（owner）。
    */
-  stage: ProjectStageSchema.optional(),
-  /** stage='failed' 时携带失败原因 */
-  stageReason: external_exports.string().optional(),
+  creatorDisplayName: external_exports.string().min(1).optional(),
   /**
-   * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.1.3)：
-   * ProjectMetadata.publishJob 的 status 派生版。daemon 响应时按以下规则实时拼装：
-   *   - 落盘字段存在 + PublishJobRegistry 有匹配 jobId → 'in-flight'
-   *   - 落盘字段存在 + Registry 无匹配（jobId 对不上或 entry 缺失）→ 'interrupted'（daemon 崩残骸）
-   *   - 落盘字段不存在 → undefined（字段省略）
-   * UI 用 status 决定 PreviewPane 渲染分支（in-flight 三段 checklist / interrupted 恢复条）。
+   * 创建该 session 的连接者飞书 union_id（一次性 stamp，T-31 persona prompt injection）。
+   * session:create / dispatch spawnB handler 从 ctx.principal.feishuUnionId（guest 场景来自
+   * connect token subOwner）或 deps.ownerFeishuUnionId（owner 场景）传入；newRunner 时读这个
+   * 字段派生 SubSessionMeta.callerFeishuUnionId 注入 cc system prompt「身份卡」的 union_id 行。
+   * Optional：老 SessionFile / owner 未登飞书路径缺省，缺省时 prompt 不渲染该行（向后兼容）。
    */
-  publishJob: external_exports.object({
-    jobId: external_exports.string().min(1),
-    stage: external_exports.enum(["build", "deploy", "verify"]),
-    startedAt: external_exports.number().int().nonnegative(),
-    status: external_exports.enum(["in-flight", "interrupted"])
+  creatorFeishuUnionId: external_exports.string().min(1).optional(),
+  /**
+   * Mirror peer sessions (2026-05-26): mirror 标识。**我在朋友 daemon 上创建的 session**，
+   * 远端是 source of truth，本机是持久化副本，方便 sidebar 跨设备聚合。
+   * 字段值 = 远端 daemon 的 deviceId（决策 #16：朋友设备标识，即我接入的那台机器）。
+   *
+   * 语义关键澄清：mirror **不是朋友创建给我的会话**——它是我自己的会话，只是在朋友
+   * 的机器上跑。sidebar chip 显示 `@<朋友>` 暗示「位置」，不是「来源」。
+   *
+   *   - undefined / 缺省 → 本机 native session（在我自己机器上跑）
+   *   - 非空 → 我的会话在该 deviceId 朋友的 daemon 上跑，本机为持久化副本
+   *
+   * 四类 session 取值矩阵（决策 #16 deviceId 版，creatorOwnerPrincipalId 列已删）：
+   *   | 形态                                | creatorPrincipalId(=设备) | originOwnerPrincipalId(=朋友设备) |
+   *   |-------------------------------------|--------------------------|----------------------------------|
+   *   | 本机 owner 自创                      | 本机 deviceId            | undefined                        |
+   *   | 本机被别的设备接入创建               | 接入者 deviceId(token 背书) | undefined                     |
+   *   | 我在朋友 daemon 上创建（mirror 回本机） | 我的 deviceId          | 朋友 deviceId                    |
+   *
+   * UI 用法：
+   *   - sidebar Active/Pinned/Recents 过滤：`origin 非空 → 一律视作 self`（绕过 #739 隔离）
+   *   - 行内显示 `@<朋友>` chip 暗示位置
+   *   - 进 ChatPanel 时按 origin 路由到 `pool.ensureRemoteForOwner(origin)` 走远端（按 deviceId）
+   *
+   * daemon 用法：
+   *   - `peerSession:upsert` / `peerSession:remove` 一族 RPC 专管 mirror 写删；
+   *     daemon dumb write/delete，**不广播任何 push 帧**，UI 是写入唯一源
+   *   - native `session:*` handler 完全不感知 mirror（UI 操作 mirror 不走 native 路径）
+   */
+  originOwnerPrincipalId: external_exports.string().min(1).optional(),
+  /**
+   * Mirror 的 persona 身份（2026-07-17 android-dispatch-task spec §3.2）：
+   * 该 mirror 在朋友 daemon 上是用哪个 persona 创建的（朋友侧的 persona id）。
+   * 与 originOwnerPrincipalId 平行的「位置」语义——**不参与**本机 persona 反查
+   * （那是 ownerPersonaId 的职责，mirror 上按 #750 防线 strip）。
+   * 消费方：mobile picker「借的」组按 (originOwnerPrincipalId, originOwnerPersonaId) 去重。
+   * 写入方：ui toMirrorSessionFile / mobile buildMirrorUpsertArgs 在 strip ownerPersonaId 时 stamp。
+   */
+  originOwnerPersonaId: external_exports.string().min(1).optional(),
+  /**
+   * Dispatch 派生的 session 在 create 时记录源 session 的 sessionId（稳定 key）；
+   * sidebar 据此把 dispatch 出来的 sub-session 折叠在源 session 下。非 dispatch session 缺省。
+   * mirror SessionFile 上必须 strip（朋友 daemon 上的 sessionId 在本机无意义，会让本机
+   * 反查路径走错；按 #750 一族防线处理，跟 ownerPersonaId 同地点 strip）。
+   */
+  dispatchedFromSessionId: external_exports.string().min(1).optional(),
+  /**
+   * Shift fire 派生的 session 记录调 addShift 的 source cc session id（稳定 key）；
+   * sidebar 据此把 fire 出的 session 折叠在 source session 下，跟 dispatchedFromSessionId
+   * 平行但渲染不同 icon（AlarmClock 区别于 dispatch 的 CornerDownRight），让 owner 一眼
+   * 分清"派生于人为委派"还是"派生于定时唤起"。非 shift fire session 缺省。
+   * 跟 dispatchedFromSessionId / forkedFromSessionId 三者互斥（同一 session 不会兼任）。
+   * mirror SessionFile 同 dispatchedFromSessionId 处理（shift fire 本地概念，理论上不会
+   * mirror，留 strip 防御）。
+   */
+  shiftFiredFromSessionId: external_exports.string().min(1).optional(),
+  createdAt: external_exports.string().min(1),
+  updatedAt: external_exports.string().min(1)
+});
+var ParsedEventBase = {
+  seq: external_exports.number().int().nonnegative().optional(),
+  ts: external_exports.string().optional(),
+  // CC top-level uuid：同一逻辑帧从 stream-json stdout 和 JSONL 落地时携带相同值，
+  // reducer 用它做跨路径去重（managed stdout 和 observer JSONL 双写）。对齐 cc-direct cc-event-store
+  uuid: external_exports.string().optional()
+};
+var HistoryUserMetaSchema = external_exports.enum(HISTORY_USER_META_VALUES);
+var SubagentToolStatsSchema = external_exports.object({
+  readCount: external_exports.number().int().nonnegative().optional(),
+  searchCount: external_exports.number().int().nonnegative().optional(),
+  bashCount: external_exports.number().int().nonnegative().optional(),
+  editFileCount: external_exports.number().int().nonnegative().optional(),
+  linesAdded: external_exports.number().int().nonnegative().optional(),
+  linesRemoved: external_exports.number().int().nonnegative().optional(),
+  otherToolCount: external_exports.number().int().nonnegative().optional()
+});
+var StructuredPatchHunkSchema = external_exports.object({
+  oldStart: external_exports.number().int().nonnegative(),
+  oldLines: external_exports.number().int().nonnegative(),
+  newStart: external_exports.number().int().nonnegative(),
+  newLines: external_exports.number().int().nonnegative(),
+  // 每行以 '+' / '-' / ' ' 开头（diff npm 包的标准 hunk lines）
+  lines: external_exports.array(external_exports.string())
+});
+var ToolResultExtraSchema = external_exports.object({
+  agentId: external_exports.string().optional(),
+  agentType: external_exports.string().optional(),
+  status: external_exports.string().optional(),
+  prompt: external_exports.string().optional(),
+  // CC File*Tool 结果里的 filePath / structuredPatch：UI rewind 预览据此本地渲染 diff。
+  // 两者同时存在才有意义；缺任一则 UI 降级为仅显示"受影响文件"摘要
+  filePath: external_exports.string().optional(),
+  structuredPatch: external_exports.array(StructuredPatchHunkSchema).optional(),
+  stats: external_exports.object({
+    durationMs: external_exports.number().int().nonnegative().optional(),
+    tokens: external_exports.number().int().nonnegative().optional(),
+    toolUseCount: external_exports.number().int().nonnegative().optional(),
+    toolStats: SubagentToolStatsSchema.optional(),
+    usage: UsageSchema.optional()
   }).optional()
 });
-var ListProjectsArgsSchema = external_exports.object({}).strict();
-var ListProjectsResultSchema = external_exports.object({
-  projects: external_exports.array(ProjectWithStatusSchema)
-}).strict();
-var GetProjectArgsSchema = external_exports.object({
-  sessionId: external_exports.string().min(1)
-}).strict();
-var GetProjectResultSchema = external_exports.object({
-  /** session 未绑 project / project 不存在时为 null（UI 走单栏 / 折叠） */
-  project: ProjectWithStatusSchema.nullable()
-}).strict();
-var CreateProjectArgsSchema = external_exports.object({
-  /** 必填：caller session，daemon 自动绑过去（spec 2026-06-02 §3 invariant 1 Session ↔ 1 Project） */
-  sessionId: external_exports.string().min(1),
-  name: external_exports.string()
-}).strict();
-var CreateProjectResultSchema = external_exports.object({
-  project: ProjectMetadataSchema
-}).strict();
-var DeleteProjectArgsSchema = external_exports.object({
-  name: external_exports.string()
-}).strict();
-var DeleteProjectResultSchema = external_exports.object({}).strict();
-var UpdateProjectPortArgsSchema = external_exports.object({
-  name: external_exports.string(),
-  newPort: external_exports.number().int()
-}).strict();
-var UpdateProjectPortResultSchema = external_exports.object({
-  project: ProjectMetadataSchema
-}).strict();
-var SetProdUrlArgsSchema = external_exports.object({
-  name: external_exports.string().regex(projectNameRegex),
-  url: external_exports.string().url()
-}).strict();
-var SetProdUrlResultSchema = external_exports.object({
-  project: ProjectMetadataSchema
-}).strict();
-var StartDevServerArgsSchema = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  force: external_exports.boolean().optional()
-}).strict();
-var StartDevServerResultSchema = external_exports.object({
-  project: ProjectMetadataSchema
-}).strict();
-var ASSISTANT_REPORTABLE_STAGES = [
+var MemoryEntrySchema = external_exports.object({
+  path: external_exports.string(),
+  content: external_exports.string(),
+  mtimeMs: external_exports.number().optional()
+});
+var AskQuestionOptionSchema = external_exports.object({
+  label: external_exports.string().min(1),
+  description: external_exports.string().optional()
+});
+var AskQuestionItemSchema = external_exports.object({
+  question: external_exports.string().min(1),
+  // multiSelect 必填（boolean 不给默认值）：daemon emit 时必须显式传，避免 UI 端漂移
+  multiSelect: external_exports.boolean(),
+  options: external_exports.array(AskQuestionOptionSchema).min(1)
+});
+var ParsedEventSchema = external_exports.discriminatedUnion("kind", [
+  // session_init 仅携带 session 标识；resolvedModel 等元信息走 meta_update
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("session_init"),
+    toolSessionId: external_exports.string().optional()
+  }),
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("thinking"),
+    text: external_exports.string(),
+    // 同一思考块的多次 stream_event 增量带相同 partialId（= `${sessionId}-${blockIndex}`）；
+    // 不带表示是 assistant 帧的整段快照。UI 用 partialId 累积 / 用快照覆盖。
+    partialId: external_exports.string().optional()
+  }),
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("text"),
+    text: external_exports.string(),
+    // 同一文本块的多次 stream_event 增量带相同 partialId；语义同 thinking
+    partialId: external_exports.string().optional()
+  }),
+  // 真实用户输入：daemon 通过 --replay-user-messages 拿到 stdin 回显，区分于 assistant text。
+  // meta 非空表示是 CC 注入的系统消息（task-notification / slash-command / system-reminder 等），
+  // UI 据此走低视觉权重渲染或子 agent 通知卡。
+  //
+  // sender（2026-07-08 spec §4.1）：daemon 'send' 命令 synth 的 user_text 携带发起人 SenderInfo；
+  // observer 回灌路径（cc jsonl）永远不带 —— cc 自己写盘不知道 daemon 层身份。
+  // UI 端 sender 缺省 → 不渲染 displayName label；有 → 气泡下方渲染。
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("user_text"),
+    text: external_exports.string(),
+    meta: HistoryUserMetaSchema.optional(),
+    taskId: external_exports.string().optional(),
+    parentToolUseId: external_exports.string().optional(),
+    sender: SenderInfoSchema.optional()
+  }),
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("tool_call"),
+    toolUseId: external_exports.string(),
+    tool: external_exports.string(),
+    // 等于 session.tool；UI 按 {toolKind, tool} 分派渲染。additive 可选，旧 adapter 不填也能解析
+    toolKind: external_exports.string().optional(),
+    input: external_exports.unknown()
+  }),
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("tool_result"),
+    toolUseId: external_exports.string(),
+    output: external_exports.unknown().optional(),
+    error: external_exports.string().optional(),
+    // CC Agent / Task tool 完成后在 JSONL 顶层挂的 toolUseResult 元信息（非 content 字段）
+    // 老 CC 走 <task-notification> user 消息携带统计，新 CC 直接挂在这里——兼容期两者可能并存
+    toolResultExtra: ToolResultExtraSchema.optional(),
+    // 精确指向发起 tool 的 assistant 消息顶层 uuid；toolUseId 已够 UI 聚合，这个仅作调试辅助
+    sourceToolAssistantUUID: external_exports.string().optional(),
+    // AskUserQuestion 实时回放（plan: clawd-ask-user-question 任务 B 修复）：
+    //   CC 用户答完后把 answers 写在 user 帧顶层 toolUseResult.answers，daemon parser
+    //   抽到这里。UI eventsToLines 用 toolUseId 配对到 question-card line，把卡片转为
+    //   只读态显示用户的答案。仅 AskUserQuestion 配对的 tool_result 行携带；普通工具不带。
+    //   等价于 HistoryMessage.askQuestionAnswers（历史回放路径），两端字段名对齐。
+    askQuestionAnswers: external_exports.record(external_exports.string(), external_exports.string()).optional()
+  }),
+  // CC 命中项目记忆（`type:"attachment"`，`attachment.type:"memories"`）的独立事件；
+  // 其它 attachment 子类型（skills / hook_context / deferred_tools / hook_success / unknown）
+  // 视觉权重低，daemon 直接走 user_text + HistoryUserMeta 折叠，不另开 kind
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("attachment_memories"),
+    memories: external_exports.array(MemoryEntrySchema)
+  }),
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("permission_request"),
+    requestId: external_exports.string(),
+    tool: external_exports.string(),
+    input: external_exports.unknown(),
+    // CC `control_request.request.tool_use_id` 对应的 tool_use id；UI 用它把队列项与
+    // 后续 tool_result.toolUseId 关联做跨客户端 dequeue（plan permission-multi-pending-queue.md
+    // 选项 ii）。老 daemon / legacy CC 不发该字段时保持向后兼容（optional）。
+    toolUseId: external_exports.string().optional()
+  }),
+  // AskUserQuestion 工具调用的内联锚点（plan: clawd-ask-user-question 问题 1 修复）：
+  //   daemon parser 把 assistant tool_use AskUserQuestion 翻译成本 kind（不是 permission_request、
+  //   也不是 tool_call），让 UI 在事件流自然位置渲染问答卡（紧跟 assistant 消息 / 在后续消息之前），
+  //   而不是被强行挂在末尾。permission_request 帧仍正常下发驱动 pendingQuestions 状态机，
+  //   但只走 wire 帧不入 ring buffer——状态由 daemon pendingQuestions 持有，
+  //   渲染锚点由本 kind 的 ParsedEvent 提供。
+  // 历史回放：history-to-lines.ts 在 jsonl tool_use AskUserQuestion 处插入对应 'question-card' line，
+  //   配对的 tool_result 携带 toolUseResult.answers，已答完的展示只读态。
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("ask_user_question"),
+    toolUseId: external_exports.string(),
+    questions: external_exports.array(AskQuestionItemSchema)
+  }),
+  // turn_end —— 一轮 AI 响应结束。消费者：reducer pushEventToBuffer 翻 turnOpen=false；
+  // UI useChatPanelState 收 "Claude is working" spinner（lastEventKind===turn_end）。
+  // 三个产生来源：
+  //   ① SDK 模式 stream-json `result` 帧（claude.ts）—— stdout 最后一帧，可靠
+  //   ② TUI 模式 observer 读 JSONL `system/turn_duration` 行（claude-tui.ts parseLine）
+  //      ⚠️ CC 写此行早于该轮尾段正文落盘，可能被尾随 text 覆盖 lastEventKind（③ 存在的原因）
+  //   ③ TUI 模式屏幕静止 AND observer 静止（observeScreenIdle + manager.observerIdleWaitMs 复合闸 →
+  //      dispatchTurnIdle inject）—— 兜 ② 的覆盖；等尾随 text 全部 poll 落盘后补，排在 buffer 末条
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("turn_end")
+  }),
+  // SDK system 帧 task_started / task_progress / task_notification 的归一化产物：
+  // 子 agent 执行过程中实时上报 agentId / lastToolName / stats，UI pending 期就能开抽屉、看进度。
+  // toolUseId 对齐父 Agent 工具的 tool_use_id；status 由 SDK subtype 派生。
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("subagent_progress"),
+    toolUseId: external_exports.string(),
+    agentId: external_exports.string(),
+    status: external_exports.enum(["started", "running", "completed", "failed"]),
+    description: external_exports.string().optional(),
+    lastToolName: external_exports.string().optional(),
+    prompt: external_exports.string().optional(),
+    stats: external_exports.object({
+      durationMs: external_exports.number().int().nonnegative().optional(),
+      tokens: external_exports.number().int().nonnegative().optional(),
+      toolUseCount: external_exports.number().int().nonnegative().optional()
+    }).optional()
+  }),
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("error"),
+    message: external_exports.string()
+  }),
+  // 元信息投递：daemon adapter 从任意来源（stream-json / JSONL）抽出的 SessionMeta 子集
+  // reducer 做 patch merge + diff + persist + 广播 session:info；不入 ring buffer
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("meta_update"),
+    patch: SessionMetaSchema
+  }),
+  // 系统消息（CC 自家系统提示 / 老板插话补充）；persona 场景下区分两类：
+  //   metaSource='cc'    → CC 注入的系统消息（默认低视觉权重渲染）
+  //   metaSource='owner' → 老板通过 persona:appendOwnerMessage 插入的话（蓝色气泡）
+  // 缺省视为 'cc'；现有非 persona 场景保持兼容（不需要 owner 时不下发该字段）
+  external_exports.object({
+    ...ParsedEventBase,
+    kind: external_exports.literal("meta-text"),
+    text: external_exports.string(),
+    metaSource: external_exports.enum(["cc", "owner"]).optional()
+  })
+]);
+var SessionCreateArgs = external_exports.object({
+  // 当 ownerPersonaId 存在时 cwd 由 daemon 派生，UI 可不传
+  cwd: external_exports.string().min(1).optional(),
+  tool: external_exports.string().optional(),
+  label: external_exports.string().optional(),
+  model: external_exports.string().optional(),
+  permissionMode: external_exports.string().optional(),
+  effort: external_exports.string().optional(),
+  // 用户在 NewSessionDialog 选择的 icon 标识；UI 端做 enum 兜底
+  iconKey: external_exports.string().optional(),
+  // session:fork 派生 session 时由 UI 传入源 sessionId，daemon 写到 SessionFile.forkedFromSessionId
+  forkedFromSessionId: external_exports.string().min(1).optional(),
+  // 快速问答：创建时打 ephemeral 标记，daemon 写到 SessionFile.ephemeral
+  ephemeral: external_exports.boolean().optional(),
+  // owner-mode persona session：传此字段时 daemon 自行派生 cwd 和启动参数，
+  // 且按 ownerPersonaId 做 idempotent dedupe（每 persona 永远只有一个 owner session）
+  ownerPersonaId: external_exports.string().min(1).optional()
+  // 单栏默认 refactor (spec 2026-06-02)：appBuilderProject 字段已从 SessionCreateArgs 砍掉。
+  // 绑定路径收敛到 appBuilder:createProject —— 先创建空 session（仅传 ownerPersonaId=persona-app-builder），
+  // 后通过 createProject RPC 创建 project 并 daemon 内部 mutate 写入 appBuilderProject。
+  // SessionFile schema 仍保留该字段供 daemon 内部 mutate（manager.update 内部调用通道）。
+}).refine((args) => args.cwd != null || args.ownerPersonaId != null, {
+  message: "cwd \u4E0E ownerPersonaId \u81F3\u5C11\u4F20\u4E00\u4E2A"
+});
+var SessionListArgs = external_exports.object({
+  /** true = 只返回 mirror（originOwnerPrincipalId 非空，即「我在朋友 daemon 上创建」的本机存证）。 */
+  originOnly: external_exports.boolean().optional(),
+  /**
+   * 按 own persona 窄化（2026-07-21 self-persona-sessions 追加）：只留
+   * `s.ownerPersonaId === args.ownerPersonaId` 的 sessions。
+   * - mirror 行（`ownerPersonaId` 恒 null）天然排除
+   * - 与 `originOnly=true` 同传恒返 0
+   * - 老 daemon 不识别时忽略字段返回全量，客户端消费侧本就自带过滤/截断，天然向后兼容
+   */
+  ownerPersonaId: external_exports.string().min(1).optional(),
+  /** 按 updatedAt desc（list 的既有排序）截断前 N 条。 */
+  limit: external_exports.number().int().positive().optional(),
+  /**
+   * 分页起点（2026-07-18 android-tasks-tab 迭代追加）：originOnly / ownerPersonaId 过滤后、
+   * limit 截断前跳过前 N 条。与 limit 组合 = updatedAt desc 序上的一页。响应带 total
+   * （过滤后总数，见 handler）供客户端判 hasMore。老 daemon 不识别时忽略 → 回全量，
+   * 客户端按全量兼容。
+   */
+  offset: external_exports.number().int().nonnegative().optional()
+});
+var SessionIdArgs = external_exports.object({ sessionId: external_exports.string().min(1) });
+var SessionUpdateArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  patch: external_exports.object({
+    label: external_exports.string().optional(),
+    model: external_exports.string().optional(),
+    permissionMode: external_exports.string().optional(),
+    effort: external_exports.string().optional(),
+    cwd: external_exports.string().optional(),
+    // 用户在 Edit modal 选择的 icon 标识；UI 端做 enum 兜底
+    iconKey: external_exports.string().optional()
+    // 注意：appBuilderProject 字段已从 patch 中砍掉（spec 2026-06-02-app-builder-single-pane-default-design）。
+    // 绑定单向不可变 —— 由 appBuilder:createProject 在 daemon 内部一次写入；UI / assistant 不再
+    // 通过 sessionUpdate 修改这个字段。SessionFile 仍保留 appBuilderProject 字段供 daemon 内部 mutate。
+  })
+});
+var SessionSendArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  text: external_exports.string()
+});
+var SessionInterruptArgs = SessionIdArgs;
+var SessionRewindArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  userMessageId: external_exports.string().min(1),
+  dryRun: external_exports.boolean().optional()
+});
+var SessionRewindResponseSchema = external_exports.object({
+  canRewind: external_exports.boolean(),
+  error: external_exports.string().optional(),
+  filesChanged: external_exports.array(external_exports.string()).optional(),
+  insertions: external_exports.number().int().nonnegative().optional(),
+  deletions: external_exports.number().int().nonnegative().optional()
+});
+var SessionRewindDiffArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  userMessageId: external_exports.string().min(1)
+});
+var RewindDiffHunkSchema = external_exports.object({
+  oldStart: external_exports.number().int().nonnegative(),
+  oldLines: external_exports.number().int().nonnegative(),
+  newStart: external_exports.number().int().nonnegative(),
+  newLines: external_exports.number().int().nonnegative(),
+  lines: external_exports.array(external_exports.string())
+});
+var RewindDiffFileSchema = external_exports.object({
+  filePath: external_exports.string().min(1),
+  hunks: external_exports.array(RewindDiffHunkSchema),
+  insertions: external_exports.number().int().nonnegative(),
+  deletions: external_exports.number().int().nonnegative(),
+  status: external_exports.enum(["modified", "added", "deleted"]).optional()
+});
+var SessionRewindDiffResponseSchema = external_exports.object({
+  canRewind: external_exports.boolean(),
+  error: external_exports.string().optional(),
+  files: external_exports.array(RewindDiffFileSchema),
+  totalInsertions: external_exports.number().int().nonnegative(),
+  totalDeletions: external_exports.number().int().nonnegative()
+});
+var SessionRewindableMessageIdsArgs = SessionIdArgs;
+var SessionRewindableMessageIdsResponseSchema = external_exports.object({
+  userMessageIds: external_exports.array(external_exports.string())
+});
+var SessionResumeArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  toolSessionId: external_exports.string().min(1)
+});
+var SessionForkArgs = external_exports.object({
+  cwd: external_exports.string().min(1),
+  toolSessionId: external_exports.string().min(1),
+  messageUuid: external_exports.string().min(1)
+});
+var SessionForkResponseSchema = external_exports.object({
+  forkedToolSessionId: external_exports.string().min(1),
+  forkedFilePath: external_exports.string().min(1)
+});
+var SessionObserveArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  toolSessionId: external_exports.string().min(1),
+  jsonlPath: external_exports.string().optional()
+});
+var SessionEventsArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  // -1 表示"从头拉全量"（尚未见过任何事件）；seq 从 0 起，所以合法下界是 -1
+  afterSeq: external_exports.number().int().min(-1)
+});
+var PermissionRespondArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  // 权限请求 id 用 `permissionRequestId`，**不能**叫 `requestId`：WS 传输层用帧顶层的
+  // `requestId` 做 RPC 请求/响应关联（daemon-client 发帧时 `{...args, type, requestId}`，
+  // 传输 id 在最后会覆盖 args 同名字段）。若沿用 `requestId`，权限 id 会被传输 id（如 "r61"）
+  // 覆盖，daemon 查 pendingPermissions 永远 miss → 点了允许一直卡住。
+  permissionRequestId: external_exports.string().min(1),
+  allow: external_exports.boolean(),
+  permanent: external_exports.boolean().optional(),
+  pattern: external_exports.string().optional()
+});
+var HistoryListArgs = external_exports.object({ projectPath: external_exports.string().min(1) });
+var HistoryReadArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  limit: external_exports.number().int().positive().max(5e3).optional(),
+  /** 不传时走 tail 语义：daemon 返回最后 limit 条（offset = max(0, total - limit)） */
+  offset: external_exports.number().int().nonnegative().optional(),
+  /**
+   * 瘦身投影（2026-07-18 android-tasks-tab 迭代，v2 语义）：true = daemon 裁掉窄消费面客户端
+   * （mobile）不渲染的大字段（input / output / raw / toolResultExtra / memories /
+   * sourceToolAssistantUUID），meta 注入行 text 截 500 字符。**例外：出错的工具调用全量保留**——
+   * 本页内 error 非空的 tool_result 保留 output，且其同 toolUseId 的 tool_call 保留 input
+   * （用户要能看清「啥错了」；老板 2026-07-18 拍板：普通工具调用手机不渲染，错误全量展示）。
+   * desktop 渲染 tool card 需全文，不用此参数。老 daemon 不识别 → 回全量，客户端向后兼容。
+   */
+  slim: external_exports.boolean().optional()
+});
+var HistorySubagentsArgs = external_exports.object({
+  cwd: external_exports.string().min(1),
+  toolSessionId: external_exports.string().min(1)
+});
+var HistorySubagentReadArgs = external_exports.object({
+  cwd: external_exports.string().min(1),
+  toolSessionId: external_exports.string().min(1),
+  subagentId: external_exports.string().min(1)
+});
+var WorkspaceListArgs = external_exports.object({
+  // cwd 缺省则 daemon 兜底 os.homedir()；UI 的 DirBrowser 首次浏览就走这条路径
+  cwd: external_exports.string().min(1).optional(),
+  path: external_exports.string().optional(),
+  showHidden: external_exports.boolean().optional()
+});
+var WorkspaceReadArgs = external_exports.object({
+  cwd: external_exports.string().min(1),
+  path: external_exports.string().min(1)
+});
+var SkillsListArgs = external_exports.object({ cwd: external_exports.string().min(1), tool: external_exports.string().optional() });
+var SkillEntrySchema = external_exports.object({
+  name: external_exports.string().min(1),
+  source: external_exports.enum(SKILL_SOURCE_VALUES),
+  path: external_exports.string().optional(),
+  description: external_exports.string().optional(),
+  plugin: external_exports.string().optional()
+});
+var AgentEntrySchema = external_exports.object({
+  name: external_exports.string().min(1),
+  source: external_exports.enum(AGENT_SOURCE_VALUES),
+  path: external_exports.string().optional(),
+  description: external_exports.string().optional(),
+  whenToUse: external_exports.string().optional(),
+  plugin: external_exports.string().optional()
+});
+var AgentsListArgs = external_exports.object({ cwd: external_exports.string().min(1), tool: external_exports.string().optional() });
+var AgentsListResponseSchema = external_exports.object({
+  agents: external_exports.array(AgentEntrySchema)
+});
+var SessionCurrentTurnSenderArgs = external_exports.object({
+  // 刻意不加 .min(1)：空串是被依赖的软路径（handler 见空即返 sender:null，
+  // session-current-turn-sender.spec 有用例守着）。加了 min 会把它变成硬报错。
+  sessionId: external_exports.string().optional()
+});
+var SessionSubscribeArgs = external_exports.object({ sessionId: external_exports.string().min(1).optional() });
+var SessionPinArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  pinned: external_exports.boolean()
+});
+var PeerSessionUpsertArgs = SessionFileSchema;
+var PeerSessionUpsertResponseSchema = external_exports.object({
+  type: external_exports.literal("peerSession:upsert:ok")
+});
+var PeerSessionRemoveArgs = external_exports.object({ sessionId: external_exports.string().min(1) });
+var PeerSessionRemoveResponseSchema = external_exports.object({
+  type: external_exports.literal("peerSession:remove:ok")
+});
+var SessionReorderPinsArgs = external_exports.object({
+  orderedIds: external_exports.array(external_exports.string().min(1)).min(1)
+});
+var GitRootArgs = external_exports.object({ cwd: external_exports.string().min(1) });
+var GitRootResponseSchema = external_exports.object({
+  isGitRoot: external_exports.boolean(),
+  gitRoot: external_exports.string().nullable()
+});
+var GitBranchArgs = external_exports.object({ cwd: external_exports.string().min(1) });
+var GitBranchResponseSchema = external_exports.object({
+  branch: external_exports.string().nullable()
+});
+var GitBranchesArgs = external_exports.object({ cwd: external_exports.string().min(1) });
+var GitBranchesResponseSchema = external_exports.object({
+  branches: external_exports.array(external_exports.string()),
+  head: external_exports.string().nullable()
+});
+var HistoryRecentDirsArgs = external_exports.object({}).optional();
+var RecentDirEntrySchema = external_exports.object({
+  cwd: external_exports.string().min(1),
+  updatedAt: external_exports.string().min(1)
+});
+var HistoryRecentDirsResponseSchema = external_exports.object({
+  dirs: external_exports.array(RecentDirEntrySchema)
+});
+var SessionQuestionFrameSchema = external_exports.object({
+  type: external_exports.literal("session:question"),
+  sessionId: external_exports.string().min(1),
+  toolUseId: external_exports.string().min(1),
+  requestId: external_exports.string().min(1),
+  // UI 单卡承载多 question；空数组语义无效，schema 必拒
+  questions: external_exports.array(AskQuestionItemSchema).min(1)
+});
+var SessionQuestionClearedFrameSchema = external_exports.object({
+  type: external_exports.literal("session:question:cleared"),
+  sessionId: external_exports.string().min(1),
+  toolUseId: external_exports.string().min(1),
+  // record<string,string>：与 AnswerQuestionArgs.answers 同形状（question text → label）
+  answers: external_exports.record(external_exports.string(), external_exports.string()).optional()
+});
+var AnswerQuestionArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  toolUseId: external_exports.string().min(1),
+  answers: external_exports.record(external_exports.string(), external_exports.string())
+});
+var AnswerQuestionResponseSchema = external_exports.object({ ok: external_exports.literal(true) });
+var CancelQuestionArgs = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  toolUseId: external_exports.string().min(1)
+});
+var CancelQuestionResponseSchema = external_exports.object({ ok: external_exports.literal(true) });
+var AuthRequestFrameSchema = external_exports.object({
+  type: external_exports.literal("auth"),
+  token: external_exports.string().min(1),
+  scheme: external_exports.literal("bearer").optional(),
+  /**
+   * 决策 #16：自报身份字段（selfPrincipalId / selfDisplayName / selfDeviceId）全部删除——
+   * guest 的设备 id / 人 id / 来源全部由 connect token 的 subDevice/subOwner/provider 签名背书
+   * （server 签、目标设备本地验签，不可伪造），不再接受任何自报身份。
+   *
+   * selfUrl 已废弃（spec 2026-07-22 双向确认建联）：可达地址自报移入 contact:handshake
+   * args——auth 层回归纯验票。旧客户端发来的 selfUrl 被 strip（zod 默认），无害；
+   * 旧客户端本身由 whoami 的 connect-token 拒绝路径拦截（CLIENT_OUTDATED）。
+   */
+  /**
+   * 客户端自报的 user-agent 性质标签（诊断/展示用）。
+   * 「自报事实」，非身份（决策 #16 边界）：不参与鉴权、不参与路由、
+   * 任何 handler 不得据此做权限判断。name 约定命名（'clawd-desktop' / 'clawd-web' /
+   * 'clawd-mobile-android' / ...），宽容未知值（将来加新客户端不动 schema）。
+   * instanceId：客户端首启生成 UUID 并本地持久化——区分同种类多实例（多手机/多 desktop 同连）。
+   */
+  clientInfo: external_exports.object({
+    name: external_exports.string().min(1),
+    version: external_exports.string().min(1),
+    instanceId: external_exports.string().min(1)
+  }).optional()
+});
+var AuthOkFrameSchema = external_exports.object({
+  type: external_exports.literal("auth:ok"),
+  version: external_exports.string().min(1).optional(),
+  protocolVersion: external_exports.number().int().nonnegative().optional()
+});
+var TunnelReadyEventSchema = external_exports.object({
+  type: external_exports.literal("tunnel:ready"),
+  url: external_exports.string().min(1),
+  subdomain: external_exports.string().min(1)
+});
+var TunnelExitedEventSchema = external_exports.object({
+  type: external_exports.literal("tunnel:exited"),
+  code: external_exports.number().int().nullable(),
+  subdomain: external_exports.string().nullable(),
+  url: external_exports.string().nullable()
+});
+var TunnelUnavailableEventSchema = external_exports.object({
+  type: external_exports.literal("tunnel:unavailable"),
+  reason: external_exports.string().min(1),
+  failedAt: external_exports.string().min(1)
+});
+var InfoRunningSessionSchema = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  status: SessionStatusSchema,
+  freshSpawn: external_exports.boolean(),
+  pendingPermissionRequestIds: external_exports.array(external_exports.string().min(1)),
+  pendingQuestionToolUseIds: external_exports.array(external_exports.string().min(1))
+});
+var InfoResponseSchema = external_exports.object({
+  type: external_exports.literal("info"),
+  version: external_exports.string(),
+  protocolVersion: external_exports.number(),
+  hostname: external_exports.string(),
+  os: external_exports.string(),
+  tools: external_exports.array(external_exports.object({ id: external_exports.string(), available: external_exports.boolean() })),
+  runningSessions: external_exports.array(InfoRunningSessionSchema),
+  // ── file-sharing 会话身份回执（spec: superpowers/specs/2026-05-19-clawd-file-sharing-design.md §8） ──
+  // PR 1 阶段标 optional（daemon 还没下发，旧 daemon info 响应不带这五个字段）；
+  // PR 2 daemon 实现 single HTTP server + auth-context 后，daemon 必返这五个字段，
+  // 届时可考虑改成 required。spec §11 第 3 条："tokenRole 是协议字段，daemon 查 token
+  // 表后显式下发，UI 不自行推导"——所以 UI 一律读这里，禁止本地推导。
+  /** 'owner' = 拿到 owner-token 的连接（不限来源 IP）。来源 TOKEN_ROLES（spec §11 #1 中央真理源）。
+   *  历史 'personal' role（persona file-sharing token）在 2026-05-21 删除；tokenPersonaId 一同移除。 */
+  tokenRole: external_exports.enum(TOKEN_ROLES).optional(),
+  /** socket.remoteAddress 是否落在 127.0.0.1 / ::1；本期无 RPC 消费，保留协议槽位给未来 "Reveal in Finder" 等本机动作 */
+  isLoopback: external_exports.boolean().optional(),
+  /** UI 拼 file-sharing HTTP 路由的前缀（http(s)://host:port），不含尾斜杠；frpc 反代时返反代地址 */
+  httpBaseUrl: external_exports.string().optional(),
+  /** file-sharing HTTP 路由的 Authorization: Bearer token；与 WS token 解耦，HTTP 401 仅触发 ReAuth 不强踢 WS（spec §11 第 4 条） */
+  httpToken: external_exports.string().optional()
+});
+var PROJECT_PORT_MIN = 6173;
+var PROJECT_PORT_MAX = 6272;
+var projectNameRegex = /^[a-z][a-z0-9-]{0,39}$/;
+var ProjectMetadataSchema = external_exports.object({
+  name: external_exports.string().regex(projectNameRegex, {
+    message: "kebab-case, \u5C0F\u5199\u5B57\u6BCD\u5F00\u5934\uFF0C\u53EA\u5141\u8BB8\u5C0F\u5199\u5B57\u6BCD / \u6570\u5B57 / -\uFF0C\u6700\u957F 40 \u5B57\u7B26"
+  }),
+  port: external_exports.number().int().min(PROJECT_PORT_MIN).max(PROJECT_PORT_MAX),
+  createdAt: external_exports.string().datetime(),
+  /** dev server 启动命令（shell 字符串）；占位符 $CLAWD_PREVIEW_PORT 替换 + env 注入 */
+  devCommand: external_exports.string().min(1),
+  /**
+   * 发布上线后的公网 URL（spec 2026-06-02-app-builder-single-pane-default-design §5.6.1）。
+   * assistant 跑完 publish.sh 后调 appBuilder:setProdUrl 写入；UI 读这个字段切预览栏到线上 URL，
+   * 取代旧 `<builder-preview url=... label="prod" />` marker 机制。
+   * 老 project 元数据无此字段（optional 兼容）。
+   */
+  prodUrl: external_exports.string().url().optional(),
+  /**
+   * dev server 就绪 stdout regex（spec 2026-06-02-app-builder-explicit-dev-server-control §2）。
+   * supervisor spawn 后会监听子进程 stdout，命中此 regex 视为 dev server 真 ready；
+   * 仅当 await ready 后才把 stage 切到 'running'，避免 cold start race 导致 iframe 502。
+   * optional：缺省时 supervisor 用默认 /Local:\s+https?:\/\//（vite "Local: http://..." 输出）。
+   * 老板换非 vite 技术栈（Next.js "Ready in"、webpack "Compiled" 等）时自定义这个字段。
+   */
+  readyPattern: external_exports.string().optional(),
+  /**
+   * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.1.4)：
+   * in-flight 发布 job 的元数据。仅承载"in-flight"或"中断残骸"两种状态：
+   *   - daemon spawn publish.sh + 收到第一个 ::stage::build marker 时写入
+   *   - 每次 stage 切换更新 stage 字段
+   *   - 成功 / 正常失败 / 用户 dismiss 时立即清掉
+   *   - 只有 daemon 崩才会留残骸（子进程随 daemon 一起死）
+   * status 字段在 ProjectWithStatus 派生而不在这里 —— 本 schema 是落盘形态，
+   * "in-flight vs interrupted" 区分由 daemon 响应时实时拼 registry 状态得出。
+   */
+  publishJob: external_exports.object({
+    jobId: external_exports.string().min(1),
+    stage: external_exports.enum(["build", "deploy", "verify"]),
+    startedAt: external_exports.number().int().nonnegative()
+  }).optional()
+});
+var PROJECT_STAGE_VALUES = [
+  "install-pending",
+  // createProject 刚返回，scaffold 已完成（daemon 同步内联跑），等 assistant pnpm install
   "installing",
+  // assistant pnpm install 中
+  "starting-dev-server",
+  // startDevServer 已调，supervisor spawn 子进程中（await ready 期间也在此 stage）
+  "running",
+  // dev server 跑起来了（supervisor stdout 命中 readyPattern + 端口已监听）
+  "stopped",
+  // 用户显式点"收起预览"停掉 / daemon 重启后默认；UI 渲染折叠条 + "展开预览"按钮
   "failed"
+  // 某个阶段失败（stageReason 字段携带原因，含 dev server cold start timeout）
 ];
-var ReportStageArgsSchema = external_exports.object({
-  sessionId: external_exports.string().min(1),
-  stage: external_exports.enum(ASSISTANT_REPORTABLE_STAGES),
-  /** stage='failed' 时必填的原因（一句话），其它 stage optional */
-  reason: external_exports.string().optional()
-}).strict();
-var ReportStageResultSchema = external_exports.object({
-  ok: external_exports.literal(true)
-}).strict();
-var StopDevServerArgsSchema = external_exports.object({
-  sessionId: external_exports.string().min(1)
-}).strict();
-var StopDevServerResultSchema = external_exports.object({
-  ok: external_exports.literal(true)
-}).strict();
-var AppBuilderProjectUpdatedEventSchema = external_exports.object({
-  type: external_exports.literal("appBuilder:project-updated"),
-  project: ProjectWithStatusSchema,
-  stage: ProjectStageSchema,
-  /** stage='failed' 时的失败原因 */
-  stageReason: external_exports.string().optional()
-}).strict();
-var PublishArgsSchema = external_exports.object({
-  name: external_exports.string().regex(projectNameRegex)
-});
-var PublishResultSchema = external_exports.object({
-  jobId: external_exports.string().min(1),
-  status: external_exports.enum(["started", "already-publishing"])
-}).strict();
-var DismissPublishJobArgsSchema = external_exports.object({
-  name: external_exports.string().regex(projectNameRegex)
-});
-var DismissPublishJobResultSchema = external_exports.object({
-  ok: external_exports.literal(true)
-}).strict();
-var AppBuilderPublishProgressEventSchema = external_exports.object({
-  type: external_exports.literal("appBuilder:publish-progress"),
-  name: external_exports.string().regex(projectNameRegex),
-  jobId: external_exports.string().min(1),
-  stage: external_exports.enum(["build", "deploy", "verify"]),
-  status: external_exports.enum(["started", "completed"])
-}).strict();
-var AppBuilderPublishFailedEventSchema = external_exports.object({
-  type: external_exports.literal("appBuilder:publish-failed"),
-  name: external_exports.string().regex(projectNameRegex),
-  jobId: external_exports.string().min(1),
-  stage: external_exports.enum(["build", "deploy", "verify", "unknown"]),
-  errorSummary: external_exports.string()
-}).strict();
-
-// ../protocol/src/capability.ts
-var ResourceSchema2 = external_exports.discriminatedUnion("type", [
-  external_exports.object({ type: external_exports.literal("persona"), id: external_exports.string().min(1) }).strict(),
-  external_exports.object({ type: external_exports.literal("chat"), id: external_exports.string().min(1) }).strict(),
-  external_exports.object({ type: external_exports.literal("*") }).strict()
-]);
-var ActionSchema = external_exports.enum(["read", "send", "admin"]);
-var GrantSchema = external_exports.object({
-  resource: ResourceSchema2,
-  actions: external_exports.array(ActionSchema).min(1)
-}).strict();
-var CapabilitySchema = external_exports.object({
-  id: external_exports.string().min(1),
-  // sha256(token) hex 64
-  secretHash: external_exports.string().regex(/^[a-f0-9]{64}$/),
-  displayName: external_exports.string(),
-  // 空数组合法 = 纯访客（只能 DM）
-  grants: external_exports.array(GrantSchema),
-  issuedAt: external_exports.number().int().nonnegative(),
-  expiresAt: external_exports.number().int().positive().optional(),
-  maxUses: external_exports.number().int().positive().optional(),
-  usedCount: external_exports.number().int().nonnegative(),
+var ProjectStageSchema = external_exports.enum(PROJECT_STAGE_VALUES);
+var ProjectWithStatusSchema = ProjectMetadataSchema.extend({
+  isRunning: external_exports.boolean(),
+  boundSessionId: external_exports.string().nullable(),
   /**
-   * guest 在 auth 帧捎带 selfPrincipalId 时由 AuthGate.authenticate 回写；
-   * 未被消费的 cap 此字段缺失。
+   * 单栏 refactor stage fix (spec 2026-06-02 §5.6.2)：daemon 内存维护的当前 stage。
+   * UI 据此切 PreviewPane spinner / iframe / error。
+   * optional 兼容启动后 daemon 还没有 stage 记录的 fresh project（按 isRunning 推断兜底）。
    */
-  peerOwnerId: external_exports.string().min(1).optional(),
-  /** 首次 client hello 时间戳（与 peerOwnerId 同步写入） */
-  firstUsedByPeerAt: external_exports.number().int().positive().optional(),
+  stage: ProjectStageSchema.optional(),
+  /** stage='failed' 时携带失败原因 */
+  stageReason: external_exports.string().optional(),
   /**
-   * 对方 daemon owner 的 displayName，guest auth 帧 selfDisplayName 触发
-   * recordPeerHello 时同步回写。视角 B (2026-05-23) UI 派生联系人列表用此字段
-   * 显示对方名字（避免 fallback 到我颁 cap 时填的 displayName）。
+   * 发布上线脚手架化 (spec 2026-06-03-app-builder-publish-scaffold-design §5.1.3)：
+   * ProjectMetadata.publishJob 的 status 派生版。daemon 响应时按以下规则实时拼装：
+   *   - 落盘字段存在 + PublishJobRegistry 有匹配 jobId → 'in-flight'
+   *   - 落盘字段存在 + Registry 无匹配（jobId 对不上或 entry 缺失）→ 'interrupted'（daemon 崩残骸）
+   *   - 落盘字段不存在 → undefined（字段省略）
+   * UI 用 status 决定 PreviewPane 渲染分支（in-flight 三段 checklist / interrupted 恢复条）。
    */
-  peerDisplayName: external_exports.string().optional()
+  publishJob: external_exports.object({
+    jobId: external_exports.string().min(1),
+    stage: external_exports.enum(["build", "deploy", "verify"]),
+    startedAt: external_exports.number().int().nonnegative(),
+    status: external_exports.enum(["in-flight", "interrupted"])
+  }).optional()
+});
+var ListProjectsArgsSchema = external_exports.object({}).strict();
+var ListProjectsResultSchema = external_exports.object({
+  projects: external_exports.array(ProjectWithStatusSchema)
 }).strict();
-var CapabilityWireSchema = CapabilitySchema.omit({ secretHash: true });
-var WhoamiResponseSchema = external_exports.object({
-  type: external_exports.literal("whoami:ok"),
-  owner: external_exports.object({
-    id: external_exports.string(),
-    kind: external_exports.enum(["owner", "guest"]),
-    displayName: external_exports.string(),
-    /** 归属人 id（决策 #16：TTC unique_id 等，落 contact.ownerId） */
-    ownerId: external_exports.string(),
-    /** 身份来源（决策 #16：'ttc'/'google'，落 contact.provider） */
-    provider: external_exports.string()
-  }).strict(),
-  capability: CapabilityWireSchema,
-  grantedPersonas: external_exports.array(
-    external_exports.object({
-      id: external_exports.string().min(1),
-      displayName: external_exports.string()
-    }).strict()
-  )
+var GetProjectArgsSchema = external_exports.object({
+  sessionId: external_exports.string().min(1)
 }).strict();
-var PERSONAL_CAP_GRANTS = Object.freeze([
-  Object.freeze({
-    resource: Object.freeze({ type: "persona", id: "*" }),
-    actions: Object.freeze(["read", "send"])
-  })
-]);
-
-// ../protocol/src/inbox.ts
-var InboxMessageSchema = external_exports.object({
-  id: external_exports.string().min(1),
-  peerDeviceId: external_exports.string().min(1),
-  senderDeviceId: external_exports.string().min(1),
-  text: external_exports.string().min(1),
-  createdAt: external_exports.number().int().nonnegative(),
-  readBy: external_exports.record(external_exports.string().min(1), external_exports.number().int().positive()).default({}),
-  // persona 代发署名（B 版设计）：非空 = 该消息由某 persona 代发，非真人手打。
-  // 缺省 = 真人。routing 身份仍看 senderDeviceId；origin 只用于末端 UI 渲染来源。
-  origin: external_exports.object({ kind: external_exports.literal("persona"), personaId: external_exports.string().min(1) }).optional()
+var GetProjectResultSchema = external_exports.object({
+  /** session 未绑 project / project 不存在时为 null（UI 走单栏 / 折叠） */
+  project: ProjectWithStatusSchema.nullable()
 }).strict();
-var InboxPostMessageArgsSchema = external_exports.object({
-  peerDeviceId: external_exports.string().min(1).optional(),
-  id: external_exports.string().min(1),
-  text: external_exports.string().min(1),
-  createdAt: external_exports.number().int().nonnegative(),
-  // persona 代发署名（跨 daemon forward 时随远程腿透传；真人发缺省）。
-  origin: external_exports.object({ kind: external_exports.literal("persona"), personaId: external_exports.string().min(1) }).optional()
+var CreateProjectArgsSchema = external_exports.object({
+  /** 必填：caller session，daemon 自动绑过去（spec 2026-06-02 §3 invariant 1 Session ↔ 1 Project） */
+  sessionId: external_exports.string().min(1),
+  // .min(1)：改造前手写校验是 `!f.name` 明确拒空串；空 name 会让 projectDir('')
+  // 落到 projects 根目录，scaffold 往根上铺模板。
+  name: external_exports.string().min(1)
 }).strict();
-var InboxListArgsSchema = external_exports.object({
-  peerDeviceId: external_exports.string().min(1),
-  sinceCreatedAt: external_exports.number().int().nonnegative().optional()
+var CreateProjectResultSchema = external_exports.object({
+  project: ProjectMetadataSchema
 }).strict();
-var InboxMarkReadArgsSchema = external_exports.object({
-  peerDeviceId: external_exports.string().min(1),
-  upToCreatedAt: external_exports.number().int().nonnegative()
+var DeleteProjectArgsSchema = external_exports.object({
+  name: external_exports.string()
 }).strict();
-var InboxSendDmArgsSchema = external_exports.object({
-  peerDeviceId: external_exports.string().min(1).optional(),
-  text: external_exports.string().min(1)
-});
-
-// ../protocol/src/contact.ts
-var ContactSchema = external_exports.object({
-  /**
-   * 对方设备标识（主键）：对方 daemon 自己生成并持久化的标识（auth.json deviceId，
-   * 如 dev-<uuid>），provider 无关。同 deviceId 重复 upsert 覆盖。
-   */
-  deviceId: external_exports.string().min(1),
-  /**
-   * 归属人 id（决策 #16）：TTC unique_id 等，由 connect token subOwner 签名背书。
-   * 与 provider 一起唯一标识一个人。DM 不再按它路由（路由用 deviceId），仅显示/分组用。
-   */
-  ownerId: external_exports.string().min(1),
-  /** 身份来源（决策 #16）：'ttc'（飞书/手机/邮箱登入 TTC）| 'google' | ...，token 背书 */
-  provider: external_exports.string().min(1),
-  /** 联系人显示名 */
-  displayName: external_exports.string(),
-  /** 该设备可达的 ws/tunnel 地址 */
-  remoteUrl: external_exports.string().min(1),
-  // 自动反向建立联系人（spec 决策 #11）：被连接方本地验票成功后自动落 A 为
-  // 联系人，但它不持有 A 颁发的 token（A 从未给它换票）→ connectToken 为空串。
-  // device:connect 出站路径仍存中心 server 签发的真实 connect token（断线重连复用）。
-  // 不用 .min(1)：自动反向路径合法地存空串，禁止填假 token 占位（不造假数据）。
-  connectToken: external_exports.string(),
-  grants: external_exports.array(GrantSchema),
-  addedAt: external_exports.number().int().nonnegative(),
-  /**
-   * pin 时间戳（ms，Date.now() 语义）；null = 未 pin。sidebar 顶部固定区渲染由此驱动。
-   * 老 contacts.json 缺此字段 → zod default 补 null（无破坏性升级；不 orphan）。
-   * 对齐 SessionFile.pinnedAt 语义（daemon 侧持久化，contact:pin RPC 更新 → contact:pinned push）。
-   */
-  pinnedAt: external_exports.number().int().nullable().default(null),
-  /**
-   * 远程访问授权（spec 2026-07-16）。owner 视角：允许该 contact 反向操作我的设备——
-   * 跨设备 exec 的总开关（peerExec:run handler 运行时判它）。default=false，owner 显式开。
-   * 授权粒度 per-people (per-contact)：借用别人 persona 本来就带信任对方本人的前提。
-   */
-  remoteAccessAllowed: external_exports.boolean().default(false)
+var DeleteProjectResultSchema = external_exports.object({}).strict();
+var UpdateProjectPortArgsSchema = external_exports.object({
+  name: external_exports.string(),
+  newPort: external_exports.number().int()
 }).strict();
-var ContactWireSchema = ContactSchema;
-var ContactRemoveArgsSchema = external_exports.object({
-  deviceId: external_exports.string().min(1)
+var UpdateProjectPortResultSchema = external_exports.object({
+  project: ProjectMetadataSchema
 }).strict();
-var ContactRemoveOkSchema = external_exports.object({
-  type: external_exports.literal("contact:remove:ok"),
-  deviceId: external_exports.string().min(1)
+var SetProdUrlArgsSchema = external_exports.object({
+  name: external_exports.string().regex(projectNameRegex),
+  url: external_exports.string().url()
 }).strict();
-var ContactListOkSchema = external_exports.object({
-  type: external_exports.literal("contact:list:ok"),
-  contacts: external_exports.array(ContactWireSchema)
+var SetProdUrlResultSchema = external_exports.object({
+  project: ProjectMetadataSchema
 }).strict();
-var ContactAddedFrameSchema = external_exports.object({
-  type: external_exports.literal("contact:added"),
-  contact: ContactWireSchema
+var StartDevServerArgsSchema = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  force: external_exports.boolean().optional()
 }).strict();
-var ContactRemovedFrameSchema = external_exports.object({
-  type: external_exports.literal("contact:removed"),
-  deviceId: external_exports.string().min(1)
+var StartDevServerResultSchema = external_exports.object({
+  project: ProjectMetadataSchema
+}).strict();
+var ASSISTANT_REPORTABLE_STAGES = [
+  "installing",
+  "failed"
+];
+var ReportStageArgsSchema = external_exports.object({
+  sessionId: external_exports.string().min(1),
+  stage: external_exports.enum(ASSISTANT_REPORTABLE_STAGES),
+  /** stage='failed' 时必填的原因（一句话），其它 stage optional */
+  reason: external_exports.string().optional()
 }).strict();
-var ContactPinArgsSchema = external_exports.object({
-  deviceId: external_exports.string().min(1),
-  pinned: external_exports.boolean()
+var ReportStageResultSchema = external_exports.object({
+  ok: external_exports.literal(true)
 }).strict();
-var ContactPinOkSchema = external_exports.object({
-  type: external_exports.literal("contact:pin:ok"),
-  deviceId: external_exports.string().min(1),
-  pinnedAt: external_exports.number().int().nullable()
+var StopDevServerArgsSchema = external_exports.object({
+  sessionId: external_exports.string().min(1)
 }).strict();
-var ContactPinnedFrameSchema = external_exports.object({
-  type: external_exports.literal("contact:pinned"),
-  deviceId: external_exports.string().min(1),
-  pinnedAt: external_exports.number().int().nullable()
+var StopDevServerResultSchema = external_exports.object({
+  ok: external_exports.literal(true)
 }).strict();
-
-// ../protocol/src/contact-handshake.ts
-var ContactHandshakeArgsSchema = external_exports.object({
-  selfUrl: external_exports.string().min(1)
-});
-var ContactHandshakeOkSchema = external_exports.object({
-  type: external_exports.literal("contact:handshake:ok"),
-  owner: external_exports.object({
-    /** 被调方 deviceId（路由主键；调用方落 Contact 的主键用自己请求的 args.deviceId，此值供校验/展示） */
-    id: external_exports.string(),
-    /** 归属人（落 Contact.ownerId / provider，显示分组用） */
-    ownerId: external_exports.string(),
-    provider: external_exports.string(),
-    displayName: external_exports.string()
-  }),
-  /** 被调方授调用方的 grants（落 Contact.grants） */
-  grants: external_exports.array(GrantSchema)
-});
-
-// ../protocol/src/contact-remote-access.ts
-var ContactSetRemoteAccessArgsSchema = external_exports.object({
-  deviceId: external_exports.string().min(1),
-  remoteAccessAllowed: external_exports.boolean()
+var AppBuilderProjectUpdatedEventSchema = external_exports.object({
+  type: external_exports.literal("appBuilder:project-updated"),
+  project: ProjectWithStatusSchema,
+  stage: ProjectStageSchema,
+  /** stage='failed' 时的失败原因 */
+  stageReason: external_exports.string().optional()
 }).strict();
-var ContactSetRemoteAccessOkSchema = external_exports.object({
-  type: external_exports.literal("contact:setRemoteAccess:ok"),
-  deviceId: external_exports.string().min(1),
-  remoteAccessAllowed: external_exports.boolean()
+var PublishArgsSchema = external_exports.object({
+  name: external_exports.string().regex(projectNameRegex)
+});
+var PublishResultSchema = external_exports.object({
+  jobId: external_exports.string().min(1),
+  status: external_exports.enum(["started", "already-publishing"])
 }).strict();
-var ContactRemoteAccessUpdatedFrameSchema = external_exports.object({
-  type: external_exports.literal("contact:remote-access-updated"),
-  deviceId: external_exports.string().min(1),
-  remoteAccessAllowed: external_exports.boolean()
+var DismissPublishJobArgsSchema = external_exports.object({
+  name: external_exports.string().regex(projectNameRegex)
+});
+var DismissPublishJobResultSchema = external_exports.object({
+  ok: external_exports.literal(true)
 }).strict();
-
-// ../protocol/src/peer-exec.ts
-var PeerExecRunArgsSchema = external_exports.object({
-  /** A 侧发起时带：目标设备 deviceId。peer-forward 转发前 strip 掉，B 侧本地执行时无此字段。 */
-  peerDeviceId: external_exports.string().min(1).optional(),
-  /** 交给对端 `bash -c` 的命令；cc 自拼完整路径（一发一收，无跨命令会话状态）。 */
-  command: external_exports.string().min(1),
-  /** 超时上限（ms）；缺省用 handler 默认 30_000，clamp 300_000。 */
-  timeoutMs: external_exports.number().int().positive().optional()
+var AppBuilderPublishProgressEventSchema = external_exports.object({
+  type: external_exports.literal("appBuilder:publish-progress"),
+  name: external_exports.string().regex(projectNameRegex),
+  jobId: external_exports.string().min(1),
+  stage: external_exports.enum(["build", "deploy", "verify"]),
+  status: external_exports.enum(["started", "completed"])
 }).strict();
-var PeerExecRunOkSchema = external_exports.object({
-  type: external_exports.literal("peerExec:run:ok"),
-  stdout: external_exports.string(),
-  stderr: external_exports.string(),
-  /** 进程退出码；被超时 kill 时 null。 */
-  exitCode: external_exports.number().int().nullable(),
-  timedOut: external_exports.boolean(),
-  stdoutTruncated: external_exports.boolean(),
-  stderrTruncated: external_exports.boolean()
+var AppBuilderPublishFailedEventSchema = external_exports.object({
+  type: external_exports.literal("appBuilder:publish-failed"),
+  name: external_exports.string().regex(projectNameRegex),
+  jobId: external_exports.string().min(1),
+  stage: external_exports.enum(["build", "deploy", "verify", "unknown"]),
+  errorSummary: external_exports.string()
 }).strict();
 
-// ../protocol/src/extension.ts
-var EXT_ID_REGEX = /^[a-z0-9][a-z0-9-]*$/;
-var ExtensionStateSchema = external_exports.enum([
-  "stopped",
-  "starting",
-  "running",
-  "crashed",
-  "invalid"
-]);
-var LOCALHOST_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1"]);
-function isAllowedHostedUrl(raw) {
-  let u;
-  try {
-    u = new URL(raw);
-  } catch {
-    return false;
-  }
-  if (u.protocol === "https:") return true;
-  if (u.protocol === "http:" && LOCALHOST_HOSTS.has(u.hostname)) return true;
-  return false;
-}
-var ExtensionManifestSchema = external_exports.object({
-  id: external_exports.string().regex(EXT_ID_REGEX),
-  name: external_exports.string().min(1),
-  version: external_exports.string().min(1),
-  apiVersion: external_exports.literal("1"),
-  runtime: external_exports.object({ startCommand: external_exports.string().min(1) }).passthrough().optional(),
-  entry: external_exports.object({
-    url: external_exports.string().url().refine(isAllowedHostedUrl, {
-      message: "INVALID_URL_SCHEME: only https or http://localhost is allowed"
-    })
-  }).strict().optional()
-}).passthrough().superRefine((m, ctx) => {
-  const hasRuntime = !!m.runtime;
-  const hasUrl = !!m.entry?.url;
-  if (hasRuntime && hasUrl) {
-    ctx.addIssue({
-      code: external_exports.ZodIssueCode.custom,
-      message: "INVALID_MANIFEST: entry.url and runtime cannot coexist"
-    });
-  }
-  if (!hasRuntime && !hasUrl) {
-    ctx.addIssue({
-      code: external_exports.ZodIssueCode.custom,
-      message: "INVALID_MANIFEST: must have either entry.url or runtime"
-    });
-  }
-});
-var ExtensionTargetSchema = external_exports.discriminatedUnion("kind", [
-  external_exports.object({ kind: external_exports.literal("local"), port: external_exports.number().int().min(1).max(65535) }),
-  external_exports.object({ kind: external_exports.literal("hosted"), url: external_exports.string().url() })
-]);
-var ExtensionRecordSchema = external_exports.discriminatedUnion("state", [
-  external_exports.object({
-    extId: external_exports.string(),
-    manifest: ExtensionManifestSchema,
-    state: external_exports.literal("stopped")
-  }),
-  external_exports.object({
-    extId: external_exports.string(),
-    manifest: ExtensionManifestSchema,
-    state: external_exports.literal("starting")
-  }),
-  external_exports.object({
-    extId: external_exports.string(),
-    manifest: ExtensionManifestSchema,
-    state: external_exports.literal("running"),
-    target: ExtensionTargetSchema
-  }),
-  external_exports.object({
-    extId: external_exports.string(),
-    manifest: ExtensionManifestSchema,
-    state: external_exports.literal("crashed")
-  }),
-  external_exports.object({
-    extId: external_exports.string(),
-    manifest: external_exports.unknown().nullable(),
-    state: external_exports.literal("invalid"),
-    invalidReason: external_exports.string().min(1)
-  })
-]);
-var PublishedSnapshotSchema = external_exports.object({
-  snapshotHash: external_exports.string().min(1),
-  version: external_exports.string().min(1),
-  publishedAt: external_exports.number()
-});
-var ChannelRefSchema = external_exports.discriminatedUnion("kind", [
-  external_exports.object({
-    kind: external_exports.literal("p2p-tunnel"),
-    ownerPrincipalId: external_exports.string().min(1),
-    extId: external_exports.string().min(1)
-  })
-]);
-var SourceRefSchema = external_exports.discriminatedUnion("kind", [
-  external_exports.object({
-    kind: external_exports.literal("p2p-tunnel"),
-    ownerPrincipalId: external_exports.string().min(1),
-    extId: external_exports.string().min(1),
-    snapshotHash: external_exports.string().min(1)
-  })
-]);
-var PublishedExtensionRecordSchema = external_exports.object({
-  extId: external_exports.string().min(1),
-  name: external_exports.string().min(1),
-  version: external_exports.string().min(1),
-  contentHash: external_exports.string().min(1),
-  publishedAt: external_exports.number()
-});
-var PublishCheckSchema = external_exports.discriminatedUnion("kind", [
-  external_exports.object({ kind: external_exports.literal("clean") }),
-  external_exports.object({
-    kind: external_exports.literal("ready-new-version"),
-    fromVersion: external_exports.string().min(1),
-    toVersion: external_exports.string().min(1)
-  }),
-  external_exports.object({
-    kind: external_exports.literal("error-same-hash"),
-    version: external_exports.string().min(1)
-  }),
-  external_exports.object({
-    kind: external_exports.literal("error-version-not-bumped"),
-    localVersion: external_exports.string().min(1),
-    publishedVersion: external_exports.string().min(1)
-  }),
-  external_exports.object({
-    kind: external_exports.literal("error-version-regression"),
-    localVersion: external_exports.string().min(1),
-    publishedVersion: external_exports.string().min(1)
-  })
-]);
-var PublishStatusResultSchema = external_exports.object({
-  localManifest: external_exports.object({
-    name: external_exports.string().min(1),
-    version: external_exports.string().min(1),
-    contentHash: external_exports.string().min(1)
-  }),
-  publishState: external_exports.discriminatedUnion("kind", [
-    external_exports.object({ kind: external_exports.literal("unpublished") }),
-    external_exports.object({
-      kind: external_exports.literal("published"),
-      version: external_exports.string().min(1),
-      contentHash: external_exports.string().min(1),
-      publishedAt: external_exports.number()
-    })
-  ]),
-  check: PublishCheckSchema
-});
-
-// ../protocol/src/feishu-auth.ts
-var DeviceEntrySchema = external_exports.object({
-  /**
-   * 设备标识（决策 #15：daemon 本地生成的 dev-<uuid>，与人的身份 unionId 无关）。
-   * 中心 server clawd_devices 注册表仅作服务发现（url 下发 + 目录），不在安全路径上。
-   */
-  deviceId: external_exports.string().min(1),
-  /** 显示名 */
+// ../protocol/src/methods.ts
+var NO_ARGS = external_exports.object({});
+var METHOD_DOCS = {
+  "session:create": {
+    summary: "\u65B0\u5EFA\u4F1A\u8BDD\u5E76\u62C9\u8D77 tool \u8FDB\u7A0B\uFF08claude / codex\uFF09\u3002**cwd \u4E0E ownerPersonaId \u81F3\u5C11\u4F20\u4E00\u4E2A**\uFF08\u5E26 ownerPersonaId \u65F6 cwd \u7531 daemon \u6D3E\u751F\uFF09\u2014\u2014\u8FD9\u6761\u4E92\u65A5\u7EA6\u675F\u662F schema \u7684 refine\uFF0C\u53CD\u5C04\u4E0D\u51FA\u6765",
+    args: SessionCreateArgs
+  },
+  "session:list": {
+    summary: "\u5217\u51FA\u5F53\u524D\u8EAB\u4EFD\u53EF\u89C1\u7684\u4F1A\u8BDD\uFF08owner \u5168\u91CF\uFF1Bguest \u9650\u88AB\u6388\u6743 persona\uFF09",
+    args: SessionListArgs
+  },
+  "session:get": {
+    summary: "\u53D6\u5355\u4E2A\u4F1A\u8BDD\u7684\u5B8C\u6574 SessionFile\uFF08\u5143\u6570\u636E + \u72B6\u6001\uFF09",
+    args: SessionIdArgs
+  },
+  "session:update": {
+    summary: "\u6539\u4F1A\u8BDD\u5143\u6570\u636E\uFF0C\u4E0D\u5F71\u54CD\u8FDB\u7A0B\u3002patch \u5141\u8BB8\u7684\u952E\uFF1Alabel / model / permissionMode / effort / cwd / iconKey\u2014\u2014**\u4F20\u522B\u7684\u952E\u4F1A\u88AB\u9759\u9ED8\u4E22\u5F03**\uFF08zod strip\uFF09\uFF0Chandler \u7167\u6837\u8FD4 ok",
+    args: SessionUpdateArgs
+  },
+  "session:delete": {
+    summary: "\u5220\u4F1A\u8BDD\uFF1A\u505C\u8FDB\u7A0B + \u5220 SessionFile\uFF0C\u5E76\u8054\u52A8\u6E05\u7406\u7ED1\u5B9A\u7684 app-builder project",
+    args: SessionIdArgs
+  },
+  "session:send": {
+    summary: "\u5411\u4F1A\u8BDD\u53D1\u4E00\u6761\u7528\u6237\u6D88\u606F\uFF08\u89E6\u53D1\u65B0\u4E00\u8F6E turn\uFF09",
+    args: SessionSendArgs
+  },
+  "session:currentTurnSender": {
+    summary: "\u67E5\u5F53\u524D turn \u7684\u9A71\u52A8\u8005\uFF08owner / guest \u7684 SenderInfo\uFF09\u3002\u7701\u7565 sessionId \u6216\u4F20\u7A7A\u4E32 \u2192 \u76F4\u63A5\u8FD4 sender:null\uFF0C\u4E0D\u62A5\u9519",
+    args: SessionCurrentTurnSenderArgs
+  },
+  "session:stop": {
+    summary: "\u505C\u6389\u4F1A\u8BDD\u7684 tool \u8FDB\u7A0B\uFF08\u6740\u8FDB\u7A0B\uFF0C\u4F1A\u8BDD\u672C\u8EAB\u4FDD\u7559\uFF09",
+    args: SessionIdArgs
+  },
+  "session:interrupt": {
+    summary: "\u6E29\u67D4\u4E2D\u65AD\u5F53\u524D\u8F6E\u6B21\uFF0C\u4E0D\u6740\u8FDB\u7A0B\uFF08\u8D70 CC IPC control_request.subtype=interrupt\uFF09",
+    args: SessionInterruptArgs
+  },
+  "session:rewind": {
+    summary: "\u56DE\u6EDA\u5230\u6307\u5B9A user message\uFF0C\u5E76\u64A4\u9500\u5176\u540E CC \u505A\u7684\u6587\u4EF6\u7F16\u8F91",
+    args: SessionRewindArgs
+  },
+  "session:rewind-diff": {
+    summary: "\u56DE\u6EDA\u9884\u89C8\uFF1A\u8BFB ~/.claude/file-history \u5FEB\u7167 + \u78C1\u76D8\u73B0\u72B6\u7B97\u771F\u5B9E diff\uFF0C\u4E0D\u4F9D\u8D56 CC \u8FDB\u7A0B",
+    args: SessionRewindDiffArgs
+  },
+  "session:rewindable-message-ids": {
+    summary: "\u4E00\u6B21\u6027\u62FF\u5230\u300C\u6709\u771F\u5B9E diff\u300D\u7684 user message id \u96C6\u5408\uFF0CUI \u636E\u6B64\u51B3\u5B9A\u54EA\u4E9B\u6D88\u606F\u663E\u793A\u56DE\u6EDA\u6309\u94AE",
+    args: SessionRewindableMessageIdsArgs
+  },
+  "session:fork": {
+    summary: "\u4ECE\u6307\u5B9A message \u5904 fork \u51FA\u65B0 transcript\uFF08\u622A\u65AD + \u91CD\u5199 sessionId/parentUuid\uFF09\uFF0C\u8FD4\u56DE\u65B0 toolSessionId\uFF1B\u4E0D\u81EA\u52A8\u62C9\u8D77\u8FDB\u7A0B",
+    args: SessionForkArgs
+  },
+  "session:new": {
+    summary: "\u5728**\u5DF2\u6709**\u4F1A\u8BDD\u4E0A\u6E05\u7A7A\u4E0A\u4E0B\u6587\u5F00\u65B0\u4E00\u8F6E\uFF0C\u76F8\u5F53\u4E8E CC \u7684 /clear\uFF08\u4E0D\u662F\u5EFA\u65B0\u4F1A\u8BDD\u2014\u2014\u5EFA\u65B0\u4F1A\u8BDD\u7528 session:create\uFF09",
+    args: SessionIdArgs
+  },
+  "session:resume": {
+    summary: "\u628A\u4F1A\u8BDD\u6062\u590D\u5230\u6307\u5B9A\u7684 tool \u4F1A\u8BDD\uFF08CC transcript\uFF09\u4E0A\u7EE7\u7EED",
+    args: SessionResumeArgs
+  },
+  "session:observe": {
+    summary: "\u6302 observer \u76D1\u542C\u8BE5\u4F1A\u8BDD\u7684 CC jsonl\uFF0C\u628A daemon \u4E4B\u5916\u542F\u52A8\u7684 CC \u6D3B\u52A8\u56DE\u704C\u8FDB\u6765\uFF08\u591A\u7AEF\u5171\u4EAB / \u63A5\u7BA1\u5916\u90E8\u4F1A\u8BDD\uFF09\u3002\u4EC5 claude \u652F\u6301",
+    args: SessionObserveArgs
+  },
+  "session:events": {
+    summary: "\u62C9\u53D6\u4F1A\u8BDD\u7684\u5386\u53F2\u4E8B\u4EF6\uFF08\u6309 seq \u589E\u91CF\uFF09\uFF0C\u7528\u4E8E\u65AD\u7EBF\u91CD\u8FDE\u8865\u5E27",
+    args: SessionEventsArgs
+  },
+  "session:subscribe": {
+    summary: "\u8BA2\u9605\u8BE5\u4F1A\u8BDD\u7684 push \u5E27\uFF08\u672C\u8FDE\u63A5\u751F\u6548\uFF0CrefCount \u8BA1\u6570\uFF09\u3002**\u7701\u7565 sessionId = \u4E0D\u5EFA\u7ACB\u4EFB\u4F55\u8BA2\u9605**\uFF0C\u4F46\u7167\u6837\u8FD4 subscribed \u2014\u2014 \u4E0D\u662F\u300C\u8BA2\u9605\u5168\u90E8\u300D",
+    args: SessionSubscribeArgs
+  },
+  "session:unsubscribe": {
+    summary: "\u53D6\u6D88\u8BA2\u9605\u8BE5\u4F1A\u8BDD\u7684 push \u5E27\u3002\u7701\u7565 sessionId \u65F6\u4E0D\u53D6\u6D88\u4EFB\u4F55\u8BA2\u9605\uFF0C\u7167\u6837\u8FD4 ok",
+    args: SessionSubscribeArgs
+  },
+  "session:pin": {
+    summary: "\u7F6E\u9876 / \u53D6\u6D88\u7F6E\u9876\u4F1A\u8BDD",
+    args: SessionPinArgs
+  },
+  "session:markRead": {
+    summary: "\u6E05\u6389\u4F1A\u8BDD\u7684\u5171\u4EAB\u672A\u8BFB\u6807\u8BB0\u5E76\u5E7F\u64AD session:info\uFF1B\u5E42\u7B49",
+    args: SessionIdArgs
+  },
+  "session:reorderPins": {
+    summary: "\u6574\u4F53\u91CD\u5199\u6240\u6709\u7F6E\u9876\u4F1A\u8BDD\u7684\u6392\u5E8F\uFF08sidebar \u62D6\u62FD\u5B8C\u6210\u65F6\u8C03\uFF09",
+    args: SessionReorderPinsArgs
+  },
+  "peerSession:upsert": {
+    summary: "\u5199\u5165 / \u66F4\u65B0\u4E00\u6761 mirror SessionFile \u2014\u2014 \u300C\u6211\u5728\u670B\u53CB daemon \u4E0A\u521B\u5EFA\u7684\u4F1A\u8BDD\u300D\u5728\u672C\u673A\u7684\u526F\u672C\uFF0C\u4EC5\u4F9B sidebar \u8DE8\u8BBE\u5907\u805A\u5408\uFF1Bdaemon \u53EA dumb \u5199\uFF0C\u4E0D\u5E7F\u64AD\u4EFB\u4F55 push \u5E27",
+    args: PeerSessionUpsertArgs
+  },
+  "peerSession:remove": {
+    summary: "\u5220\u9664\u4E00\u6761 mirror SessionFile\uFF08\u540C\u6837\u4E0D\u5E7F\u64AD\uFF09",
+    args: PeerSessionRemoveArgs
+  },
+  "permission:respond": {
+    summary: "\u56DE\u5E94 CC \u7684\u6743\u9650\u8BF7\u6C42\uFF08\u5141\u8BB8 / \u62D2\u7EDD / \u8BB0\u4F4F\u89C4\u5219\uFF09",
+    args: PermissionRespondArgs
+  },
+  "session:answerQuestion": {
+    summary: "\u56DE\u586B AskUserQuestion \u8868\u5355\u7B54\u6848\uFF0Cdaemon \u5408\u5E76\u8FDB updated_input \u5199 control_response \u7ED9 CC",
+    args: AnswerQuestionArgs
+  },
+  "session:cancelQuestion": {
+    summary: "\u7528\u6237\u8DF3\u8FC7 AskUserQuestion\uFF1Adaemon \u56DE allow + \u7A7A\u7B54\u6848\u8BA9 tool \u8D70\u7A7A\u8DEF\u5F84\uFF0C\u5E76\u5E7F\u64AD cleared \u5E27",
+    args: CancelQuestionArgs
+  },
+  "history:projects": {
+    summary: "\u5217\u51FA CC \u5386\u53F2\u91CC\u7684\u5168\u90E8\u9879\u76EE\uFF08\u6309 projectPath \u805A\u5408\uFF09\uFF1Bguest \u53EA\u770B\u5230\u81EA\u5DF1\u88AB\u6388\u6743 persona \u5B50\u6811\u4E0B\u7684",
+    args: NO_ARGS
+  },
+  "history:list": {
+    summary: "\u5217\u51FA\u67D0\u4E2A\u9879\u76EE\u4E0B\u7684\u5386\u53F2\u4F1A\u8BDD",
+    args: HistoryListArgs
+  },
+  "history:read": {
+    summary: "\u8BFB\u4E00\u6761\u5386\u53F2\u4F1A\u8BDD\u7684\u5B8C\u6574\u6D88\u606F\uFF08\u89E3\u6790 CC jsonl\uFF09",
+    args: HistoryReadArgs
+  },
+  "history:subagents": {
+    summary: "\u5217\u51FA\u67D0\u6B21\u4F1A\u8BDD\u91CC\u7684 subagent \u8FD0\u884C\u8BB0\u5F55",
+    args: HistorySubagentsArgs
+  },
+  "history:subagent-read": {
+    summary: "\u8BFB\u4E00\u6761 subagent \u7684\u5B8C\u6574\u8BB0\u5F55",
+    args: HistorySubagentReadArgs
+  },
+  "history:recentDirs": {
+    summary: "\u6700\u8FD1\u7528\u8FC7\u7684\u5DE5\u4F5C\u76EE\u5F55\u5217\u8868\uFF08\u6309 cwd \u53BB\u91CD\u3001\u53D6\u6700\u65B0 updatedAt\uFF09\u3002\u65E0\u53C2\u6570",
+    args: NO_ARGS
+  },
+  "workspace:list": {
+    summary: "\u5217\u76EE\u5F55\u5185\u5BB9\uFF08\u6587\u4EF6\u6D4F\u89C8\uFF09\uFF1Bguest \u88AB\u9650\u5236\u5728\u88AB\u6388\u6743 persona \u5B50\u6811\u5185",
+    args: WorkspaceListArgs
+  },
+  "workspace:read": {
+    summary: "\u8BFB\u6587\u4EF6\u5185\u5BB9\uFF1Bguest \u8DEF\u5F84\u8FB9\u754C\u4E0E workspace:list \u540C",
+    args: WorkspaceReadArgs
+  },
+  "shift:list": {
+    summary: "\u5217\u51FA owner \u7684\u5168\u90E8 shift\uFF08\u6392\u73ED\uFF09\uFF0C\u7ED9 UI \u65E5\u5386\u6E32\u67D3\u7528\uFF1Bowner-only",
+    args: NO_ARGS
+  },
+  "shift-internal:add": {
+    summary: "\u6392\u4E00\u4E2A shift\uFF08\u5230\u70B9\u81EA\u52A8\u62C9\u8D77 persona \u5E72\u6D3B\uFF09\u3002\u7701\u7565 targetPersona = \u6D3E\u7ED9\u8C03\u7528\u65B9\u81EA\u5DF1",
+    args: ShiftInternalAddArgs
+  },
+  "shift-internal:list": {
+    summary: "\u5217 shift\u3002\u7701\u7565 onlyMine \u9ED8\u8BA4 true \u2014\u2014 \u53EA\u5217\u672C persona \u5EFA\u7684",
+    args: ShiftInternalListArgs
+  },
+  "shift-internal:cancel": {
+    summary: "\u53D6\u6D88 shift\uFF08\u4EC5\u521B\u5EFA\u5B83\u7684 persona \u53EF\u64CD\u4F5C\uFF09",
+    args: ShiftInternalCancelArgs
+  },
+  "shift-internal:update": {
+    summary: "\u4FEE\u6539 shift \u5B57\u6BB5\uFF08\u4EC5\u521B\u5EFA\u8005\uFF09\u3002patch \u5141\u8BB8\u7684\u952E\uFF1Aname / schedule / prompt / targetPersona / timeoutMs / enabled\uFF1Bschedule \u53D8\u4E86 store \u81EA\u52A8\u91CD\u7B97 nextRunAtMs",
+    args: ShiftInternalUpdateArgs
+  },
+  "shift-internal:history": {
+    summary: "\u67E5 shift \u7684\u6267\u884C\u5386\u53F2\uFF08\u4EC5\u521B\u5EFA\u8005\uFF09",
+    args: ShiftInternalHistoryArgs
+  },
+  "skills:list": {
+    summary: "\u626B\u63CF\u5E76\u5217\u51FA\u8BE5\u76EE\u5F55\u53EF\u7528\u7684 skill",
+    args: SkillsListArgs
+  },
+  "agents:list": {
+    summary: "\u626B\u63CF\u5E76\u5217\u51FA\u8BE5\u76EE\u5F55\u53EF\u7528\u7684 subagent \u5B9A\u4E49",
+    args: AgentsListArgs
+  },
+  "git:root": {
+    summary: "\u53D6\u8BE5\u8DEF\u5F84\u6240\u5C5E git \u4ED3\u5E93\u7684\u6839\u76EE\u5F55\uFF08\u4E0D\u5728\u4ED3\u5E93\u91CC\u8FD4 null\uFF09",
+    args: GitRootArgs
+  },
+  "git:branch": {
+    summary: "\u53D6\u5F53\u524D\u5206\u652F\u540D",
+    args: GitBranchArgs
+  },
+  "git:branches": {
+    summary: "\u5217\u51FA\u672C\u5730\u5206\u652F",
+    args: GitBranchesArgs
+  },
+  "capabilities:get": {
+    summary: "\u53D6\u67D0\u4E2A tool \u7684\u80FD\u529B\u96C6\uFF1A\u53EF\u7528\u6A21\u578B\u5217\u8868 / permissionModes / configSchema",
+    args: CapabilitiesGetArgs
+  },
+  "persona:create": {
+    summary: "\u65B0\u5EFA persona\uFF08\u5199 PersonaFile + CLAUDE.md \u9AA8\u67B6\uFF09\u3002owner-only",
+    args: PersonaCreateArgsSchema
+  },
+  "persona:list": {
+    summary: "\u5217\u51FA persona \u5143\u6570\u636E\uFF08\u4E0D\u542B CLAUDE.md \u6B63\u6587\uFF09\u3002owner \u8FD4\u5168\u91CF\u542B private\uFF1Bguest \u53EA\u8FD4 public \u4E14\u88AB\u6388\u6743\u7684",
+    args: NO_ARGS
+  },
+  "persona:get": {
+    summary: "\u53D6\u5355\u4E2A persona \u8BE6\u60C5\uFF0C**\u542B personality\uFF08CLAUDE.md \u6B63\u6587\uFF09**\u2014\u2014\u552F\u4E00\u643A\u5E26\u6B63\u6587\u7684 method",
+    args: PersonaIdArgsSchema
+  },
+  "persona:update": {
+    summary: "\u6539 persona\uFF08label / model / public / CLAUDE.md \u7B49\uFF09\u3002owner-only",
+    args: PersonaUpdateArgsSchema
+  },
+  "persona:delete": {
+    summary: "\u5220 persona\u3002owner-only",
+    args: PersonaIdArgsSchema
+  },
+  "personaDispatch:run": {
+    summary: "\u628A\u4EFB\u52A1\u59D4\u6D3E\u7ED9\u53E6\u4E00\u4E2A persona\uFF08\u53EF\u8DE8\u8BBE\u5907\uFF09\uFF0C\u5F02\u6B65\u79D2\u56DE { dispatchId }\u3002targetPersona \u4E0E dispatchId **\u81F3\u5C11\u7ED9\u4E00\u4E2A**\uFF08\u524D\u8005\u65B0\u5F00\u3001\u540E\u8005\u7EED\u6D3E\uFF09\uFF1BdispatchId \u4E0E targetDeviceId **\u4E92\u65A5**",
+    args: DispatchRunArgsSchema
+  },
+  "personaDispatch:complete": {
+    summary: '\u88AB\u59D4\u6D3E\u65B9\u56DE\u62A5\u7ED3\u679C\uFF1A\u5199\u53F0\u8D26\u5E76\u628A\u7ED3\u679C\u6295\u9012\u56DE\u53D1\u8D77\u65B9\u4F1A\u8BDD\u3002outcome \u662F { kind:"success", text, filePaths? } \u6216 { kind:"failure", reason } \u4E8C\u9009\u4E00',
+    args: DispatchCompleteArgsSchema
+  },
+  "personaDispatch:list": {
+    summary: "\u67E5 dispatch \u53F0\u8D26\uFF08\u72B6\u6001 / \u7ED3\u679C / \u65F6\u95F4\u6233\uFF09\u3002\u7701\u7565 sourceSessionId = \u8FD4\u5168\u91CF",
+    args: DispatchListArgsSchema
+  },
+  "personaDispatch:get": {
+    summary: "\u67E5\u5355\u6761 dispatch \u53F0\u8D26\u7EC8\u6001\uFF1B\u8DE8\u8BBE\u5907\u65F6 A \u7AEF\u51ED connect token \u8F6E\u8BE2 B \u7AEF\u7528",
+    args: DispatchGetArgsSchema
+  },
+  "peerExec:run": {
+    summary: "\u5728\u8054\u7CFB\u4EBA\u8BBE\u5907\u4E0A\u8DD1\u4E00\u6761 bash \u547D\u4EE4\uFF08\u4E00\u53D1\u4E00\u6536\uFF0C\u65E0\u8DE8\u547D\u4EE4\u4F1A\u8BDD\u72B6\u6001\uFF09\u3002**\u672C\u673A\u53D1\u8D77\u5FC5\u586B peerDeviceId**\u2014\u2014\u7701\u7565\u4EC5\u7528\u4E8E\u5BF9\u7AEF guest \u53CD\u5411\u5165\u53E3\uFF0Cowner ctx \u7701\u7565\u4F1A\u88AB\u62D2\uFF1B\u9700\u5BF9\u65B9\u5F00\u4E86 remoteAccess",
+    args: PeerExecRunArgsSchema
+  },
+  "session:pty:input": {
+    summary: "\u628A\u7528\u6237\u952E\u76D8\u5B57\u8282\u5199\u8FDB pty stdin\uFF08\u4EC5 CLAWD_CC_MODE=tui\uFF09\u3002\u9AD8\u9891\u5E27\uFF0C\u4E0D\u5165 reducer\u3002body: { sessionId, data\uFF08base64-utf8\uFF09 }"
+  },
+  "session:pty:resize": {
+    summary: "\u540C\u6B65\u7EC8\u7AEF\u5C3A\u5BF8\u7ED9 pty\uFF08\u4EC5 tui \u6A21\u5F0F\uFF09\u3002body: { sessionId, cols, rows }"
+  },
+  "session:pty:snapshot": {
+    summary: "\u62C9\u5F53\u524D pty \u5C4F\u5E55\u5168\u91CF\u5FEB\u7167\uFF08\u5207\u56DE\u4F1A\u8BDD / \u5237\u65B0\u65F6\u7528\uFF09\uFF0C\u8FD4\u56DE { data, atSeq, popupKind }\uFF1B\u975E tui \u6216\u5DF2\u9000\u51FA\u65F6 data=null\u3002body: { sessionId }"
+  },
+  "attachment.signUrl": {
+    summary: "\u7ED9\u5DF2\u5165\u7FA4\u7684\u6587\u4EF6\u7B7E\u53D1 HMAC \u4E0B\u8F7D URL\uFF08\u8DE8\u8BBE\u5907\u53EF\u76F4\u63A5\u6253\u5F00\uFF09",
+    args: AttachmentSignUrlArgs
+  },
+  "attachment.groupAdd": {
+    summary: "\u628A\u6587\u4EF6\u767B\u8BB0\u8FDB\u672C\u4F1A\u8BDD\u7684\u5171\u4EAB\u6E05\u5355\uFF08\u7B7E URL \u524D\u5FC5\u987B\u5148\u5165\u7FA4\uFF09",
+    args: AttachmentGroupAddArgs
+  },
+  "attachment.groupRemove": {
+    summary: "\u628A\u6587\u4EF6\u79FB\u51FA\u5171\u4EAB\u6E05\u5355",
+    args: AttachmentGroupRemoveArgs
+  },
+  "attachment.groupList": {
+    summary: "\u5217\u51FA\u672C\u4F1A\u8BDD\u5171\u4EAB\u6E05\u5355\u91CC\u7684\u6587\u4EF6",
+    args: AttachmentGroupListArgs
+  },
+  "inbox:list": {
+    summary: "\u62C9\u67D0\u4E2A peer \u7684 DM / \u901A\u77E5\u961F\u5217",
+    args: InboxListArgsSchema
+  },
+  "inbox:markRead": {
+    summary: "\u628A\u67D0 peer \u961F\u5217\u6807\u8BB0\u4E3A\u5DF2\u8BFB\u5230\u67D0\u65F6\u95F4\u70B9",
+    args: InboxMarkReadArgsSchema
+  },
+  "inbox:postMessage": {
+    summary: "\u6295\u9012\u4E00\u6761 P2P IM \u6D88\u606F\uFF08\u53CC\u6295\uFF1A\u672C\u673A\u843D\u5E93 + \u8F6C\u53D1\u5BF9\u7AEF\uFF09\u3002**owner \u8C03\u7528\u5FC5\u586B peerDeviceId**\uFF0C\u4EC5 guest \u53EF\u7701\uFF08\u4ECE ctx \u63A8\uFF09",
+    args: InboxPostMessageArgsSchema
+  },
+  "inbox:sendDm": {
+    summary: "\u4EE5\u5F53\u524D\u4F1A\u8BDD\u7684\u8EAB\u4EFD\u53D1\u4E00\u6761 DM\uFF08\u53D1\u4FE1\u4EBA\u7531 session scope \u5F52\u56E0\uFF0C\u4E0D\u53EF\u4F2A\u9020\uFF09\u3002**owner \u9A71\u52A8\u7684\u4F1A\u8BDD\u5FC5\u586B peerDeviceId**\uFF0Cguest \u9A71\u52A8\u7684\u53EF\u7701",
+    args: InboxSendDmArgsSchema
+  },
+  "contact:list": {
+    summary: "\u5217\u51FA\u8054\u7CFB\u4EBA\uFF08\u5DF2\u5EFA\u8054\u7684\u8BBE\u5907\uFF09\u3002owner-only",
+    args: NO_ARGS
+  },
+  "contact:pin": {
+    summary: "\u7F6E\u9876 / \u53D6\u6D88\u7F6E\u9876\u8054\u7CFB\u4EBA",
+    args: ContactPinArgsSchema
+  },
+  "contact:remove": {
+    summary: "\u5220\u9664\u8054\u7CFB\u4EBA\u5E76\u6E05\u6389\u5BF9\u5E94\u7684 inbox \u961F\u5217",
+    args: ContactRemoveArgsSchema
+  },
+  "contact:setRemoteAccess": {
+    summary: "\u5F00\u5173\u67D0\u8054\u7CFB\u4EBA\u7684\u8FDC\u7A0B\u8BBF\u95EE\u6388\u6743\uFF08\u63A7\u5236\u5B83\u80FD\u5426\u53CD\u5411 peerExec \u6211\u7684\u8BBE\u5907\uFF09",
+    args: ContactSetRemoteAccessArgsSchema
+  },
+  "contact:handshake": {
+    summary: "\u53CC\u5411\u786E\u8BA4\u5EFA\u8054\u63E1\u624B\uFF1A\u8FDE\u63A5\u65B9\u81EA\u62A5 selfUrl\uFF0C\u88AB\u8FDE\u65B9\u843D\u5E93 + \u5E7F\u64AD\u540E\u56DE\u8EAB\u4EFD\u8F7D\u8377\u3002\u7531 device:connect \u7684\u4E34\u65F6\u8FDE\u63A5\u8C03\u7528",
+    args: ContactHandshakeArgsSchema
+  },
+  "visitor:list": {
+    summary: "\u5217\u51FA\u767B\u5F55\u8BBF\u95EE\u8FC7\u672C\u673A public persona \u7684 web \u8BBF\u5BA2\u3002owner-only",
+    args: NO_ARGS
+  },
+  "whoami": {
+    summary: "\u8FD4\u56DE\u672C\u8FDE\u63A5\u7684\u8EAB\u4EFD\uFF1Aowner \u663E\u793A\u540D + capability wire \u5F62\u6001 + \u88AB\u6388\u6743\u7684 persona \u5217\u8868\u3002\u4EFB\u4F55 authed \u8FDE\u63A5\u53EF\u8C03",
+    args: NO_ARGS
+  },
+  "info": {
+    summary: "daemon \u8FD0\u884C\u65F6\u4FE1\u606F\uFF1A\u7248\u672C / \u534F\u8BAE\u7248\u672C / \u4E3B\u673A / \u53EF\u7528 tool / \u5728\u8DD1\u7684\u4F1A\u8BDD / tunnel URL \u7B49",
+    args: NO_ARGS
+  },
+  "ping": {
+    summary: "\u5B58\u6D3B\u63A2\u6D4B\uFF0C\u56DE pong",
+    args: NO_ARGS
+  },
+  "meta:methods": {
+    summary: "RPC \u81EA\u7701\uFF1A\u8FD4\u56DE METHOD_NAMES \u5168\u96C6 + **\u5BF9\u672C\u8FDE\u63A5**\u7684\u53EF\u8C03\u7528\u6027\u4E09\u6001\uFF08allowed / conditional / denied\uFF09+ \u6BCF\u6761\u7684\u8BF4\u660E\u3002agent \u4FA7 clawd-rpc \u7684 list tool \u662F\u552F\u4E00\u6D88\u8D39\u65B9",
+    args: NO_ARGS
+  },
+  "extension.list": {
+    summary: "\u5217\u51FA\u5DF2\u5B89\u88C5\u7684 extension",
+    args: NO_ARGS
+  },
+  "extension.open": {
+    summary: "\u62C9\u8D77\u67D0\u4E2A extension\uFF08local-spawn \u8D77\u8FDB\u7A0B\u5E76\u7B49 healthz\uFF09",
+    args: ExtensionIdArgs
+  },
+  "extension.close": {
+    summary: "\u5173\u6389\u67D0\u4E2A\u6B63\u5728\u8DD1\u7684 extension",
+    args: ExtensionIdArgs
+  },
+  "extension.uninstall": {
+    summary: "\u5378\u8F7D extension\uFF08\u5220\u5B89\u88C5\u76EE\u5F55\uFF09",
+    args: ExtensionIdArgs
+  },
+  "extension.publish": {
+    summary: "\u628A\u672C\u673A extension \u516C\u5F00\u5230\u5206\u4EAB\u9891\u9053\uFF0C\u4F9B\u8054\u7CFB\u4EBA\u62C9\u53D6\u3002owner-only",
+    args: ExtensionPublishArgs
+  },
+  "extension.unpublish": {
+    summary: "\u64A4\u56DE\u5DF2\u516C\u5F00\u7684 extension\u3002owner-only",
+    args: ExtensionIdArgs
+  },
+  "extension.publish:status": {
+    summary: "\u67E5\u67D0\u4E2A extension \u7684\u516C\u5F00\u72B6\u6001\u3002owner-only",
+    args: ExtensionIdArgs
+  },
+  "extension.list-published": {
+    summary: "\uFF08\u8DE8\u8BBE\u5907\uFF09\u4ECE\u5BF9\u7AEF owner \u62C9\u5B83\u516C\u5F00\u7684 extension \u6E05\u5355",
+    args: NO_ARGS
+  },
+  "extension.fetchBundle": {
+    summary: "\uFF08\u8DE8\u8BBE\u5907\uFF09\u4ECE\u5BF9\u7AEF owner \u4E0B\u8F7D extension bundle \u5B57\u8282\u3002extId \u5FC5\u4F20\u4F46\u4E0D\u53C2\u4E0E\u7D22\u5F15\u2014\u2014\u771F\u6B63\u7684\u952E\u662F snapshotHash\uFF08publish \u90A3\u523B\u51BB\u7ED3\u7684\u90A3\u4EFD\uFF0C\u4E0E owner \u5DE5\u4F5C\u76EE\u5F55\u540E\u7EED\u53D8\u5316\u89E3\u8026\uFF09",
+    args: ExtensionFetchBundleArgs
+  },
+  "extension.install-from-channel": {
+    summary: "\u5728\u81EA\u5DF1 daemon \u4E0A\u4ECE\u5206\u4EAB\u9891\u9053\u5B89\u88C5 extension",
+    args: ExtensionFromChannelArgs
+  },
+  "extension.update-from-channel": {
+    summary: "\u5728\u81EA\u5DF1 daemon \u4E0A\u628A\u5DF2\u88C5 extension \u66F4\u65B0\u5230\u9891\u9053\u6700\u65B0\u7248",
+    args: ExtensionFromChannelArgs
+  },
+  "auth:login:start": {
+    summary: "\u8D77\u98DE\u4E66\u767B\u5F55\u6D41\u7A0B\uFF1A\u751F\u6210 state \u5E76\u8FD4\u56DE\u6388\u6743 URL\uFF0C\u56DE\u8C03\u8D70 HTTP /auth/callback \u843D\u76D8\u3002owner-only",
+    args: NO_ARGS
+  },
+  "auth:getIdentity": {
+    summary: "\u53D6\u672C\u673A owner \u7684\u98DE\u4E66\u8EAB\u4EFD\uFF08ownerId / provider / displayName / unionId\uFF09+ **\u672C\u673A deviceId**\uFF08\u8BBE\u5907\u5C5E\u6027\uFF0C\u4E0E\u767B\u5F55\u6001\u65E0\u5173\uFF1Bdevice:connect / contact:* / inbox:* \u7684\u4E3B\u952E\u90FD\u662F\u5B83\uFF09\uFF1B\u7EDD\u4E0D\u8FD4\u56DE ttcToken",
+    args: NO_ARGS
+  },
+  "auth:logout": {
+    summary: "\u767B\u51FA\u98DE\u4E66\u8EAB\u4EFD\uFF08\u6E05 owner-identity \u843D\u76D8\uFF09\u3002owner-only",
+    args: NO_ARGS
+  },
+  "device:list": {
+    summary: "\u5217\u51FA\u516C\u5171\u8BBE\u5907\u76EE\u5F55\u91CC\u53EF\u8FDE\u63A5\u7684\u8BBE\u5907\uFF08daemon \u4EE3\u7406\u4E2D\u5FC3 server\uFF09\u3002owner-only",
+    args: NO_ARGS
+  },
+  "device:connect": {
+    summary: "\u8FDE\u63A5\u76EE\u6807\u8BBE\u5907\uFF1A\u6362 aud \u7ED1\u5B9A\u7684\u7B7E\u540D token \u5E76\u8D70 contact:handshake \u5EFA\u8054\u3002owner-only",
+    args: DeviceConnectArgsSchema
+  },
+  "appBuilder:listProjects": {
+    summary: "\u5217\u51FA app-builder project\uFF08\u542B dev server \u72B6\u6001\uFF09",
+    args: ListProjectsArgsSchema
+  },
+  "appBuilder:getProject": {
+    summary: "\u6309 sessionId \u53D6\u5355\u4E2A\u7ED1\u5B9A\u7684 project\uFF08\u542B status\uFF09",
+    args: GetProjectArgsSchema
+  },
+  "appBuilder:createProject": {
+    summary: "\u7ED9\u4F1A\u8BDD\u7ED1\u5B9A\u65B0 project\uFF1A\u6821\u9A8C\u540D + \u4ECE 6173-6182 \u6BB5\u5206\u914D\u7AEF\u53E3 + \u5EFA\u76EE\u5F55\u5199\u5143\u6570\u636E",
+    args: CreateProjectArgsSchema
+  },
+  "appBuilder:deleteProject": {
+    summary: "\u505C dev server + \u5220 project \u76EE\u5F55\uFF08\u7ED1\u5B9A\u7684\u4F1A\u8BDD\u4E0D\u5728\u8FD9\u91CC\u5220\uFF09",
+    args: DeleteProjectArgsSchema
+  },
+  "appBuilder:updateProjectPort": {
+    summary: "\u6539 dev server \u7AEF\u53E3\uFF08\u6821\u9A8C\u6BB5\u5185 + \u4E0D\u649E\u8F66\uFF09\u5E76\u91CD\u542F",
+    args: UpdateProjectPortArgsSchema
+  },
+  "appBuilder:setProdUrl": {
+    summary: "\u53D1\u5E03\u4E0A\u7EBF\u540E\u56DE\u586B\u7EBF\u4E0A\u5730\u5740\u5230 .clawd-project.json",
+    args: SetProdUrlArgsSchema
+  },
+  "appBuilder:startDevServer": {
+    summary: "scaffold + \u4F9D\u8D56\u5B89\u88C5\u5B8C\u6210\u540E\u663E\u5F0F\u62C9\u8D77 dev server\uFF08createProject \u4E0D\u518D\u81EA\u52A8\u8D77\uFF09",
+    args: StartDevServerArgsSchema
+  },
+  "appBuilder:reportStage": {
+    summary: "\u4E0A\u62A5\u811A\u624B\u67B6\u9636\u6BB5\uFF08scaffolding / installing / failed \u7B49\uFF09\uFF0Cdaemon \u5E7F\u64AD\u5E27\u8BA9 UI \u5207 PreviewPane",
+    args: ReportStageArgsSchema
+  },
+  "appBuilder:stopDevServer": {
+    summary: "\u6536\u8D77\u9884\u89C8\uFF1A\u505C\u6389 dev server\uFF08\u5BF9\u79F0 startDevServer\uFF09",
+    args: StopDevServerArgsSchema
+  },
+  "appBuilder:publish": {
+    summary: "\u53D1\u5E03\u4E0A\u7EBF\uFF1A\u4E32\u884C\u5316 spawn publish.sh \u5E76\u5E7F\u64AD\u9636\u6BB5\u8FDB\u5EA6\u5E27\uFF1B\u540C project \u5DF2\u6709 in-flight job \u65F6\u8FD4\u56DE already-publishing",
+    args: PublishArgsSchema
+  },
+  "appBuilder:dismissPublishJob": {
+    summary: "\u53D6\u6D88 in-flight publish\uFF08SIGTERM \u5B50\u8FDB\u7A0B\uFF09\u6216\u6E05\u6389 daemon \u5D29\u6E83\u7559\u4E0B\u7684\u6B8B\u9AB8 publishJob \u5B57\u6BB5",
+    args: DismissPublishJobArgsSchema
+  }
+};
+var METHOD_NAMES = Object.keys(METHOD_DOCS);
+var RPC_METHOD_STATUSES = ["allowed", "conditional", "denied"];
+var RpcMethodStatusSchema = external_exports.enum(RPC_METHOD_STATUSES);
+var RpcMethodInfoSchema = external_exports.object({
+  /** canonical method 名，直接可作为 clawd-rpc call 的 method 参数 */
   name: external_exports.string().min(1),
-  /** ws/tunnel 地址 */
-  url: external_exports.string().min(1)
-});
-var DeviceListResponseSchema = external_exports.object({
-  type: external_exports.literal("device:list:ok"),
-  devices: external_exports.array(DeviceEntrySchema)
-});
-var DeviceConnectArgsSchema = external_exports.object({
-  /** 目标设备的 deviceId（对方 daemon 生成的 dev-<uuid>） */
-  deviceId: external_exports.string().min(1),
+  status: RpcMethodStatusSchema,
+  /** 该 method 干什么，取自 {@link METHOD_DOCS} 的 summary */
+  description: external_exports.string().min(1),
   /**
-   * 目标设备的 ws/tunnel 地址（可选）：
-   *   - 公开目录点击：带 url（device:list 已下发，省一次 server 查询）
-   *   - 凭 deviceId 连接：缺省 url → daemon exchange 时由中心 server 下发该设备上报的 url
-   *   - 注册表不在安全路径上：知道对方 url 时显式传入即可连接（不依赖中心 server 服务发现）
+   * 参数字段，从 {@link METHOD_DOCS} 的 args schema **反射**得来（不手写）。
+   * `null` = 该 method 还没有中央 zod schema（欠账，见 RpcMethodDoc），调用方需自行试探。
    */
-  url: external_exports.string().min(1).optional(),
-  /** 显示名（公共设备来自目录；缺省时连上后用 whoami 回填） */
-  name: external_exports.string().optional()
-});
-var DeviceConnectResponseSchema = external_exports.object({
-  type: external_exports.literal("device:connect:ok"),
-  /** 连接的目标设备标识（= 请求 args.deviceId） */
-  deviceId: external_exports.string(),
-  name: external_exports.string(),
-  url: external_exports.string()
-});
-var FeishuIdentitySchema = external_exports.object({
-  /** 归属人 id（决策 #16：TTC unique_id，取代飞书 union_id；跨登录方式稳定） */
-  ownerId: external_exports.string().min(1),
-  /** 身份来源：'ttc'（飞书/手机/邮箱登入 TTC）| 'google' | ...（决策 #16，拓展用） */
-  provider: external_exports.string().min(1),
-  /** 显示名。TTC user_info 接口 data.name */
-  displayName: external_exports.string().min(1),
-  /** TTC user_info 接口 data.avatar_url，可缺省 */
-  avatarUrl: external_exports.string().optional(),
-  /** TTC user_info 接口 data.union_id（飞书 union_id；dataclaw 可信入口 X-User-UnionId 用），可缺省 */
-  unionId: external_exports.string().optional()
-});
-var AuthLoginStartResponseSchema = external_exports.object({
-  type: external_exports.literal("auth:login:start:ok"),
-  /** 完整 TTC 授权页 URL（含 callback_url + state + auto=1），UI 直接 window.open */
-  authUrl: external_exports.string().min(1),
-  /** 防 CSRF 的一次性 nonce；回调时 daemon 校验 */
-  state: external_exports.string().min(1)
-});
-var AuthGetIdentityResponseSchema = external_exports.object({
-  type: external_exports.literal("auth:getIdentity:ok"),
-  /** null = 未登录 */
-  identity: FeishuIdentitySchema.nullable(),
+  args: external_exports.array(external_exports.object({ name: external_exports.string(), required: external_exports.boolean() })).nullable(),
   /**
-   * 本机设备标识（决策 #15：daemon 生成并持久化在 auth.json，如 dev-<uuid>）。
-   * 设备属性，与登录态无关、登录登出不变。UI"我的设备标识"用它拼
-   * clawos://device/<deviceId>（替代旧的 unionId——不再向外暴露人的身份标识）。
+   * `denied` 必带：daemon error code（`UNAUTHORIZED` / `FEISHU_LOGIN_REQUIRED` /
+   * `METHOD_NOT_IMPLEMENTED`）。`conditional` 必带：谁来做二次校验。
+   * `allowed` 恒无。
    */
-  deviceId: external_exports.string().min(1)
-});
-var AuthLogoutResponseSchema = external_exports.object({
-  type: external_exports.literal("auth:logout:ok")
-});
-var AuthLoginDoneEventSchema = external_exports.object({
-  type: external_exports.literal("auth:login:done"),
-  identity: FeishuIdentitySchema
-});
-var AuthLoginFailedEventSchema = external_exports.object({
-  type: external_exports.literal("auth:login:failed"),
-  reason: external_exports.string()
-});
-
-// ../protocol/src/dispatch.ts
-var DispatchOutcomeSchema = external_exports.discriminatedUnion("kind", [
-  external_exports.object({
-    kind: external_exports.literal("success"),
-    text: external_exports.string(),
-    filePaths: external_exports.array(external_exports.string()).optional()
-  }),
-  external_exports.object({
-    kind: external_exports.literal("failure"),
-    reason: external_exports.string()
-  })
-]);
-var DispatchRunArgsSchema = external_exports.object({
-  // 新开必填；续派（dispatchId 非空）时可省略——targetPersonaId 从台账行取。
-  targetPersona: external_exports.string().min(1).optional(),
-  // 续派（spec 2026-07-21，单 dispatchId 语义：一件事一行一 id）：非空 = 把 prompt
-  // 作为新 turn 打进该 dispatch 的原 worker session 接着干（台账行复位 running）。
-  // 省略 = 新开一件事，daemon 铸新 id。
-  dispatchId: external_exports.string().min(1).optional(),
-  prompt: external_exports.string(),
-  // 跨设备 dispatch：非空 = A 角色，转发到该 contact deviceId 的 peer daemon；
-  // 省略 = 本地 dispatch / B 角色本地执行。A 转发给 B 时 body 不带此字段。
-  targetDeviceId: external_exports.string().min(1).optional(),
-  // 可选：override B session 使用的 claude 模型。缺省 = 用 persona 默认。
-  // 合法值集与 claude adapter capabilities.models[].id 一致（见 daemon
-  // tools/claude.ts CLAUDE_MODEL_IDS）；handler 层做二次校验，非法值 fail-fast。
-  // protocol 层保持 string 便于未来跨 tool 扩展（届时 union 收合法字面量）。
-  model: external_exports.string().min(1).optional(),
-  // 可选：给新 worker session 起 label（写入 SessionFile.label，sidebar 显示）。
-  // 仅在**新开 dispatch**（dispatchId 缺席）时生效；续派（dispatchId 非空）
-  // 时 daemon 层静默丢弃（避免半途改 label 造成 sidebar 抖动）。
-  // 上限 60 字符——sidebar 显示 tolerance，卡在 dispatch 入口即可。
-  // 协议层不硬拒 sessionLabel + dispatchId 同传，保留 forward-compat。
-  sessionLabel: external_exports.string().min(1).max(60).optional()
-}).refine((v) => v.targetPersona !== void 0 || v.dispatchId !== void 0, {
-  message: "either targetPersona (new dispatch) or dispatchId (follow-up) is required"
-}).refine((v) => !(v.dispatchId !== void 0 && v.targetDeviceId !== void 0), {
-  message: "cross-device dispatch cannot be continued (dispatchId + targetDeviceId are mutually exclusive)"
-});
-var DispatchCompleteArgsSchema = external_exports.object({
-  dispatchId: external_exports.string().min(1),
-  outcome: DispatchOutcomeSchema
-});
-var DISPATCH_STATUSES = ["running", "completed", "failed"];
-var DispatchStatusSchema = external_exports.enum(DISPATCH_STATUSES);
-var DispatchRecordSchema = external_exports.object({
-  dispatchId: external_exports.string().min(1),
-  sourceSessionId: external_exports.string().min(1),
-  sourcePersonaId: external_exports.string().min(1).optional(),
-  targetPersonaId: external_exports.string().min(1),
-  /** B 的 sessionId；registerBSession 后回填 */
-  workerSessionId: external_exports.string().min(1).optional(),
-  /** 任务摘要；截断（≤500 字符）在 daemon store.add 处保证 */
-  taskText: external_exports.string(),
-  status: DispatchStatusSchema,
-  outcome: DispatchOutcomeSchema.optional(),
-  /** 上层消费者语义（如司礼监的口谕/验收状态），daemon 不解释 */
-  meta: external_exports.record(external_exports.unknown()).optional(),
-  createdAt: external_exports.string().min(1),
-  completedAt: external_exports.string().min(1).optional(),
-  /** 结果注入 source session 成功时戳，兼当投递 dedup 标记 */
-  deliveredAt: external_exports.string().min(1).optional()
-});
-var DispatchListArgsSchema = external_exports.object({
-  sourceSessionId: external_exports.string().min(1).optional()
-});
-var DispatchListResultSchema = external_exports.object({
-  records: external_exports.array(DispatchRecordSchema)
-});
-var DispatchGetArgsSchema = external_exports.object({
-  dispatchId: external_exports.string().min(1)
+  reason: external_exports.string().optional()
 });
-var DispatchGetOkSchema = external_exports.object({
-  type: external_exports.literal("personaDispatch:get:ok"),
-  status: DispatchStatusSchema,
-  outcome: DispatchOutcomeSchema.optional()
+var MetaMethodsResultSchema = external_exports.object({
+  type: external_exports.literal("meta:methods"),
+  /** METHOD_NAMES 全集，顺序与之一致 */
+  methods: external_exports.array(RpcMethodInfoSchema)
 });
 
 // ../protocol/src/log.ts