@clawos-dev/clawd 0.2.87 → 0.2.88

package/dist/cli.cjs

@@ -65,6 +65,14 @@ var init_methods = __esm({
       "session:unsubscribe",
       "session:pin",
       "session:reorderPins",
+      // mirror peer sessions (2026-05-26): owner-only RPC，写/删本机 mirror SessionFile —
+      // mirror 是「**我**在朋友 daemon 上自己创建的 session」的本机持久化副本（不是朋友的会话），
+      // 方便 sidebar 跨设备聚合。daemon dumb 写删，**不广播任何 push 帧** (不发 session:info /
+      // session:deleted)；UI 是写入唯一源，双写完成后通过 cache.setData('sessions', ...) 同步
+      // 本地 sidebar state。native session:* handler 完全不感知 mirror (UI 操作 mirror 不复用
+      // native 路径)。
+      "peerSession:upsert",
+      "peerSession:remove",
       "permission:respond",
       // AskUserQuestion 表单回写：UI 答完所有 question 后调用，daemon 把答案合并进 updated_input
       // 写一条 control_response 到 CC stdin（详见 events.ts session:question JSDoc）
@@ -4493,7 +4501,7 @@ var init_persona_schemas = __esm({
 });
 
 // ../protocol/src/schemas.ts
-var SessionStatusSchema, UsageSchema, ContextUsageSchema, sessionMetaShape, SessionMetaSchema, ModelInfoSchema, ModeInfoSchema, ConfigFieldSchemaSchema, CapabilitiesGetArgs, CapabilitiesResponseSchema, AllowRuleSchema, SessionFileSchema, ParsedEventBase, HistoryUserMetaSchema, SubagentToolStatsSchema, StructuredPatchHunkSchema, ToolResultExtraSchema, MemoryEntrySchema, AskQuestionOptionSchema, AskQuestionItemSchema, ParsedEventSchema, SessionCreateArgs, SessionIdArgs, SessionUpdateArgs, SessionSendArgs, SessionRewindArgs, SessionRewindResponseSchema, SessionRewindDiffArgs, RewindDiffHunkSchema, RewindDiffFileSchema, SessionRewindDiffResponseSchema, SessionRewindableMessageIdsArgs, SessionRewindableMessageIdsResponseSchema, SessionResumeArgs, SessionForkArgs, SessionForkResponseSchema, SessionObserveArgs, SessionEventsArgs, PermissionRespondArgs, HistoryListArgs, HistoryReadArgs, HistorySubagentsArgs, HistorySubagentReadArgs, WorkspaceListArgs, WorkspaceReadArgs, SkillsListArgs, SkillEntrySchema, AgentEntrySchema, AgentsListArgs, AgentsListResponseSchema, SessionSubscribeArgs, SessionPinArgs, SessionReorderPinsArgs, GitRootArgs, GitRootResponseSchema, GitBranchArgs, GitBranchResponseSchema, GitBranchesArgs, GitBranchesResponseSchema, HistoryRecentDirsArgs, RecentDirEntrySchema, HistoryRecentDirsResponseSchema, SessionQuestionFrameSchema, SessionQuestionClearedFrameSchema, AnswerQuestionArgs, AnswerQuestionResponseSchema, CancelQuestionArgs, CancelQuestionResponseSchema, AuthRequestFrameSchema, AuthOkFrameSchema, TunnelExitedEventSchema, TunnelUnavailableEventSchema, InfoRunningSessionSchema, InfoResponseSchema;
+var SessionStatusSchema, UsageSchema, ContextUsageSchema, sessionMetaShape, SessionMetaSchema, ModelInfoSchema, ModeInfoSchema, ConfigFieldSchemaSchema, CapabilitiesGetArgs, CapabilitiesResponseSchema, AllowRuleSchema, SessionFileSchema, ParsedEventBase, HistoryUserMetaSchema, SubagentToolStatsSchema, StructuredPatchHunkSchema, ToolResultExtraSchema, MemoryEntrySchema, AskQuestionOptionSchema, AskQuestionItemSchema, ParsedEventSchema, SessionCreateArgs, SessionIdArgs, SessionUpdateArgs, SessionSendArgs, SessionRewindArgs, SessionRewindResponseSchema, SessionRewindDiffArgs, RewindDiffHunkSchema, RewindDiffFileSchema, SessionRewindDiffResponseSchema, SessionRewindableMessageIdsArgs, SessionRewindableMessageIdsResponseSchema, SessionResumeArgs, SessionForkArgs, SessionForkResponseSchema, SessionObserveArgs, SessionEventsArgs, PermissionRespondArgs, HistoryListArgs, HistoryReadArgs, HistorySubagentsArgs, HistorySubagentReadArgs, WorkspaceListArgs, WorkspaceReadArgs, SkillsListArgs, SkillEntrySchema, AgentEntrySchema, AgentsListArgs, AgentsListResponseSchema, SessionSubscribeArgs, SessionPinArgs, PeerSessionUpsertArgs, PeerSessionUpsertResponseSchema, PeerSessionRemoveArgs, PeerSessionRemoveResponseSchema, SessionReorderPinsArgs, GitRootArgs, GitRootResponseSchema, GitBranchArgs, GitBranchResponseSchema, GitBranchesArgs, GitBranchesResponseSchema, HistoryRecentDirsArgs, RecentDirEntrySchema, HistoryRecentDirsResponseSchema, SessionQuestionFrameSchema, SessionQuestionClearedFrameSchema, AnswerQuestionArgs, AnswerQuestionResponseSchema, CancelQuestionArgs, CancelQuestionResponseSchema, AuthRequestFrameSchema, AuthOkFrameSchema, TunnelExitedEventSchema, TunnelUnavailableEventSchema, InfoRunningSessionSchema, InfoResponseSchema;
 var init_schemas = __esm({
   "../protocol/src/schemas.ts"() {
     "use strict";
@@ -4621,6 +4629,35 @@ var init_schemas = __esm({
        * 当前为 caller 自报，daemon 不密码学验证真伪；强身份验签是独立工作（B 方案）。
        */
       creatorOwnerPrincipalId: external_exports.string().min(1).optional(),
+      /**
+       * Mirror peer sessions (2026-05-26): mirror 标识。**我在朋友 daemon 上以 guest ctx
+       * 创建的 session**，远端是 source of truth，本机是该 session 的持久化副本，方便
+       * sidebar 跨设备聚合。字段值是远端 daemon 的 ownerPrincipalId（即我接入的那位朋友）。
+       *
+       * 语义关键澄清：mirror **不是朋友创建给我的会话**——它是我自己的会话，只是在朋友
+       * 的机器上跑。sidebar chip 显示 `@<朋友>` 暗示「位置」，不是「来源」。
+       *
+       *   - undefined / 缺省 → 本机 native session（在我自己机器上跑）
+       *   - 非空 → 我的会话在该 ownerPrincipalId 朋友的 daemon 上跑，本机为持久化副本
+       *
+       * 与 `creatorPrincipalId` / `creatorOwnerPrincipalId` 在四类 session 下取值矩阵：
+       *   | 形态                                | creatorPrincipalId       | creatorOwnerPrincipalId | originOwnerPrincipalId |
+       *   |-------------------------------------|--------------------------|-------------------------|------------------------|
+       *   | 本机 owner 自创                      | 本机 ownerPrincipalId    | 本机 ownerPrincipalId   | undefined              |
+       *   | 本机被别人通过 personal token 接入创建 | 远端接入者 cap.id        | 远端接入者 ownerPrincipalId | undefined          |
+       *   | 我在朋友 daemon 上以 guest ctx 创建（mirror 回本机） | 朋友 daemon personal cap.id | 我自己 ownerPrincipalId | 朋友 ownerPrincipalId |
+       *
+       * UI 用法：
+       *   - sidebar Active/Pinned/Recents 过滤：`origin 非空 → 一律视作 self`（绕过 #739 隔离）
+       *   - 行内显示 `@<朋友>` chip 暗示位置
+       *   - 进 ChatPanel 时按 origin 路由到 `pool.ensureRemoteForOwner(origin)` 走远端
+       *
+       * 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(),
       createdAt: external_exports.string().min(1),
       updatedAt: external_exports.string().min(1)
     });
@@ -4976,6 +5013,14 @@ var init_schemas = __esm({
       sessionId: external_exports.string().min(1),
       pinned: external_exports.boolean()
     });
+    PeerSessionUpsertArgs = SessionFileSchema;
+    PeerSessionUpsertResponseSchema = external_exports.object({
+      type: external_exports.literal("peerSession:upsert:ok")
+    });
+    PeerSessionRemoveArgs = external_exports.object({ sessionId: external_exports.string().min(1) });
+    PeerSessionRemoveResponseSchema = external_exports.object({
+      type: external_exports.literal("peerSession:remove:ok")
+    });
     SessionReorderPinsArgs = external_exports.object({
       orderedIds: external_exports.array(external_exports.string().min(1)).min(1)
     });
@@ -22884,6 +22929,25 @@ var SessionManager = class {
     const file = this.getFile(args.sessionId);
     return { response: file, broadcast: [] };
   }
+  // mirror peer sessions (2026-05-26)：把来自朋友 daemon 的 SessionFile（originOwnerPrincipalId
+  // 非空）持久化到本机 default store。dumb write，**不广播 push 帧**——UI 是写入唯一源，
+  // 双写完成后通过 cache.setData 同步 sidebar 本地 state。
+  //
+  // 强制走 deps.store（即 default scope），不走 scopeForFile：即使 mirror SessionFile 带
+  // 远端 ownerPersonaId（远端 persona session），本机也落 default，不创建本机 persona 目录。
+  // 远端 creator / origin 字段原值保留（不被本机 ctx 派生覆写）。
+  //
+  // 与 manager.create / manager.update 区别：
+  //   - 不走 newRunner / attachObserver / cwd 校验（mirror 是纯 metadata 层）
+  //   - 不发 session:info 帧（manager.create / .update 通过 reducer/wireCollector 发 push）
+  mirrorUpsert(file) {
+    return this.deps.store.write(file);
+  }
+  // mirror peer sessions：删本机 mirror SessionFile。强制 default store。
+  // idempotent：找不到不 throw（UI 反复点删容错）。**不广播 session:deleted**。
+  mirrorRemove(sessionId) {
+    this.deps.store.delete(sessionId);
+  }
   // observer 上报"jsonl 写入了一条 user 行"时调用：在 buffer 里找到与之对应的、
   // 还没建立映射的最早一条 synth user_text，记下 synth → real 映射。
   // 找不到匹配的 synth（runner 不存在 / buffer 已被 /clear 清空 / 真 uuid 来自纯 history
@@ -28992,6 +29056,28 @@ function buildSessionHandlers(deps) {
       }
     };
   };
+  const peerSessionUpsert = async (frame, _client, ctx) => {
+    if (ctx && ctx.principal.kind !== "owner") {
+      throw new ClawdError(
+        ERROR_CODES.UNAUTHORIZED,
+        `principal ${ctx.principal.kind}:${ctx.principal.id} cannot peerSession:upsert`
+      );
+    }
+    const file = PeerSessionUpsertArgs.parse(frame);
+    manager.mirrorUpsert(file);
+    return { response: { type: "peerSession:upsert:ok" }, broadcast: [] };
+  };
+  const peerSessionRemove = async (frame, _client, ctx) => {
+    if (ctx && ctx.principal.kind !== "owner") {
+      throw new ClawdError(
+        ERROR_CODES.UNAUTHORIZED,
+        `principal ${ctx.principal.kind}:${ctx.principal.id} cannot peerSession:remove`
+      );
+    }
+    const args = PeerSessionRemoveArgs.parse(frame);
+    manager.mirrorRemove(args.sessionId);
+    return { response: { type: "peerSession:remove:ok" }, broadcast: [] };
+  };
   return {
     "session:create": create,
     "session:list": list,
@@ -29017,7 +29103,9 @@ function buildSessionHandlers(deps) {
     "session:cancelQuestion": cancelQuestion,
     "session:pty:input": ptyInput,
     "session:pty:resize": ptyResize,
-    "session:pty:snapshot": ptySnapshot
+    "session:pty:snapshot": ptySnapshot,
+    "peerSession:upsert": peerSessionUpsert,
+    "peerSession:remove": peerSessionRemove
   };
 }
 
@@ -30095,6 +30183,11 @@ var METHOD_GRANT_MAP = {
   "session:pin": CAPABILITY_SCOPED,
   "session:reorderPins": ADMIN_ANY,
   // owner 全局操作，无 personaId 维度
+  // mirror peer sessions (2026-05-26)：owner-only — guest 不应能写/删本机 mirror SessionFile
+  // (会绕过 #739 隔离规则把伪造身份的 SessionFile 写进 default store)。handler 端内部 ctx
+  // 校验，dispatcher 层一刀切 admin 也兜底。
+  "peerSession:upsert": ADMIN_ANY,
+  "peerSession:remove": ADMIN_ANY,
   "permission:respond": CAPABILITY_SCOPED,
   "session:answerQuestion": CAPABILITY_SCOPED,
   "session:cancelQuestion": CAPABILITY_SCOPED,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawos-dev/clawd",
-  "version": "0.2.87",
+  "version": "0.2.88",
   "description": "Standalone clawd daemon — Claude Code (and future Codex) session server over WebSocket",
   "type": "module",
   "license": "MIT",