@clawos-dev/clawd 0.2.254 → 0.2.256

package/dist/dispatch/mcp-server.cjs

@@ -22009,13 +22009,13 @@ var AuthRequestFrameSchema = external_exports.object({
    * guest 的设备 id / 人 id / 来源全部由 connect token 的 subDevice/subOwner/provider 签名背书
    * （server 签、目标设备本地验签，不可伪造），不再接受任何自报身份。
    *
-   * selfUrl 保留：它只是"可达地址"（auto-reverse 反向连接用），不是身份——填错只影响
-   * 反向连通性，不构成伪造风险，且 url 不在 token 里（token 只签身份不签地址）。
+   * selfUrl 已废弃（spec 2026-07-22 双向确认建联）：可达地址自报移入 contact:handshake
+   * args——auth 层回归纯验票。旧客户端发来的 selfUrl 被 strip（zod 默认），无害；
+   * 旧客户端本身由 whoami 的 connect-token 拒绝路径拦截（CLIENT_OUTDATED）。
    */
-  selfUrl: external_exports.string().min(1).optional(),
   /**
    * 客户端自报的 user-agent 性质标签（诊断/展示用）。
-   * 同 selfUrl 性质的「自报事实」，非身份（决策 #16 边界）：不参与鉴权、不参与路由、
+   * 「自报事实」，非身份（决策 #16 边界）：不参与鉴权、不参与路由、
    * 任何 handler 不得据此做权限判断。name 约定命名（'clawd-desktop' / 'clawd-web' /
    * 'clawd-mobile-android' / ...），宽容未知值（将来加新客户端不动 schema）。
    * instanceId：客户端首启生成 UUID 并本地持久化——区分同种类多实例（多手机/多 desktop 同连）。
@@ -22427,6 +22427,24 @@ var ContactPinnedFrameSchema = external_exports.object({
   pinnedAt: external_exports.number().int().nullable()
 }).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),
@@ -22716,7 +22734,13 @@ var DispatchRunArgsSchema = external_exports.object({
   // 合法值集与 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()
+  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), {
@@ -23539,7 +23563,10 @@ async function handlePersonaDispatchToolCall(input, ctx) {
         ...input.targetDeviceId ? { targetDeviceId: input.targetDeviceId } : {},
         // T-20: 可选 override B session 使用的 claude 模型；MCP tool 层已 enum 校验，
         // daemon handler 层还会再校验一次（fail-fast）。
-        ...input.model ? { model: input.model } : {}
+        ...input.model ? { model: input.model } : {},
+        // butler 顶部入口：可选 sessionLabel 落到新 worker SessionFile.label。
+        // 长度 1-60 由 protocol schema 强约束；续派场景（dispatchId 非空）daemon 层静默丢弃。
+        ...input.sessionLabel ? { sessionLabel: input.sessionLabel } : {}
       })
     });
   } catch (err) {
@@ -23720,6 +23747,13 @@ async function main() {
         // 精确校验（按 target persona tool 选表）在 daemon handler 层做（fail-fast）。
         model: external_exports.enum([...CLAUDE_MODEL_IDS, ...CODEX_MODEL_IDS]).optional().describe(
           "override the target persona's default model. Omit to use the persona default. Claude personas: " + CLAUDE_MODEL_IDS.join(" / ") + ". Codex personas: " + CODEX_MODEL_IDS.join(" / ") + "."
+        ),
+        // butler 顶部入口 (spec 2026-07-27)：butler 给新 worker session 起 label 用。
+        // Sidebar 直接显示这个 label（否则兜底 cwd-basename 都是 persona 目录名，同一
+        // persona 的 dispatched session 长得都一样）。仅新开 dispatch 生效；续派
+        // (dispatchId set) 时 daemon 静默丢弃，保 worker session 稳定命名。
+        sessionLabel: external_exports.string().optional().describe(
+          'short human-readable label for the new worker session (shown in sidebar, e.g. "\u4FEE sidebar \u9876\u90E8\u5165\u53E3" / "\u67E5\u6628\u665A SLS \u767B\u5F55\u5931\u8D25"). aim for 8-14 chars, verb-led. ignored when continuing an existing dispatch via dispatchId (worker session keeps its original label).'
         )
       }
     },