@clawos-dev/clawd 0.2.187-beta.372.beee855 → 0.2.187-beta.373.fba4299

package/dist/cli.cjs

@@ -157,7 +157,8 @@ var init_methods = __esm({
       // 写入路径：device:connect 落 store + 自动反向（决策 #11）；list / remove 作联系人列表读删。
       "contact:list",
       "contact:remove",
-      // ---- visitor:* (web 访客 · persona web 分享，spec 2026-06-24-persona-web-share-design) ----
+      "contact:set-note",
+      // ---- visitor:*(web 访客 · persona web 分享，spec 2026-06-24-persona-web-share-design) ----
       // owner-only：列出登录访问过本机 public persona 的 web 访客（零安装、飞书登录、daemon 自签
       // visitor token）。存储 ~/.clawd/visitors.json（VisitorStore），登录(exchange)即 upsert；
       // 访客身份用 TTC unique_id，会话按 creatorPrincipalId='visitor-<id>' 进现有会话用户分组。
@@ -5630,7 +5631,7 @@ var init_inbox = __esm({
 });
 
 // ../protocol/src/contact.ts
-var ContactSchema, ContactWireSchema, ContactRemoveArgsSchema, ContactRemoveOkSchema, ContactListOkSchema, ContactAddedFrameSchema, ContactRemovedFrameSchema;
+var ContactSchema, ContactWireSchema, ContactRemoveArgsSchema, ContactRemoveOkSchema, ContactListOkSchema, ContactAddedFrameSchema, ContactRemovedFrameSchema, ContactSetNoteArgsSchema, ContactSetNoteOkSchema;
 var init_contact = __esm({
   "../protocol/src/contact.ts"() {
     "use strict";
@@ -5659,7 +5660,12 @@ var init_contact = __esm({
       // 不用 .min(1)：自动反向路径合法地存空串，禁止填假 token 占位（不造假数据）。
       connectToken: external_exports.string(),
       grants: external_exports.array(GrantSchema),
-      addedAt: external_exports.number().int().nonnegative()
+      addedAt: external_exports.number().int().nonnegative(),
+      /**
+       * 本机私有备注（≤20 字）：owner 给该联系人加的标注，只存本机、不分享给对方。
+       * optional——老 contacts.json 记录无此字段，禁止必填（否则 strict parse 失败 orphan 全部联系人）。
+       */
+      note: external_exports.string().max(20).optional()
     }).strict();
     ContactWireSchema = ContactSchema;
     ContactRemoveArgsSchema = external_exports.object({
@@ -5681,6 +5687,15 @@ var init_contact = __esm({
       type: external_exports.literal("contact:removed"),
       deviceId: external_exports.string().min(1)
     }).strict();
+    ContactSetNoteArgsSchema = external_exports.object({
+      deviceId: external_exports.string().min(1),
+      note: external_exports.string().max(20)
+    }).strict();
+    ContactSetNoteOkSchema = external_exports.object({
+      type: external_exports.literal("contact:set-note:ok"),
+      deviceId: external_exports.string().min(1),
+      note: external_exports.string().max(20)
+    }).strict();
   }
 });
 
@@ -48858,24 +48873,8 @@ var SessionObserver = class {
     return import_node_path21.default.join(this.home, ".claude", "projects", cwdToHashDir(cwd), `${toolSessionId}.jsonl`);
   }
   start(args) {
+    this.stop(args.sessionId);
     const filePath = this.resolveJsonlPath(args.cwd, args.toolSessionId, args.jsonlPath);
-    const existing = this.watches.get(args.sessionId);
-    if (existing && existing.filePath === filePath) {
-      this.opts.logger?.info("observer.start no-op", {
-        sessionId: args.sessionId,
-        filePath,
-        reason: "already-watching-same-file"
-      });
-      return { filePath };
-    }
-    if (existing) {
-      this.stop(args.sessionId, "file-changed");
-    }
-    this.opts.logger?.info("observer.start", {
-      sessionId: args.sessionId,
-      filePath,
-      reason: existing ? "file-changed" : "first-attach"
-    });
     let size = 0;
     try {
       size = import_node_fs23.default.statSync(filePath).size;
@@ -49022,7 +49021,7 @@ var SessionObserver = class {
   isObserving(sessionId) {
     return this.watches.has(sessionId);
   }
-  stop(sessionId, reason = "session-delete") {
+  stop(sessionId) {
     const w2 = this.watches.get(sessionId);
     if (!w2) return false;
     try {
@@ -49033,11 +49032,6 @@ var SessionObserver = class {
     this.watches.delete(sessionId);
     this.metaObserver?.stop(sessionId);
     this.opts.onStatus?.(sessionId, "stopped");
-    this.opts.logger?.info("observer.stop", {
-      sessionId,
-      filePath: w2.filePath,
-      reason
-    });
     return true;
   }
   stopAll() {
@@ -50195,6 +50189,21 @@ var ContactStore = class {
     this.contacts.set(contact.deviceId, contact);
     this.flush();
   }
+  /**
+   * 设/改/清空单台设备的本机私有备注（决策：本机私有标注，只存本机不分享）。
+   * 命中返回更新后的 contact 并 flush；note 空串则删除 note 字段（保持 contacts.json 干净）；
+   * 未命中返回 null（不写盘）。
+   */
+  setNote(deviceId, note) {
+    const existing = this.contacts.get(deviceId);
+    if (!existing) return null;
+    const next = { ...existing };
+    if (note) next.note = note;
+    else delete next.note;
+    this.contacts.set(deviceId, next);
+    this.flush();
+    return next;
+  }
   /** 删单台设备（contact:remove 语义，决策 #16）：删该 deviceId 一条，返回是否删到 */
   removeByDeviceId(deviceId) {
     const existed = this.contacts.delete(deviceId);
@@ -53030,7 +53039,7 @@ function buildSessionHandlers(deps) {
   const newSession = async (frame, _client, ctx) => {
     const args = SessionIdArgs.parse(frame);
     ensureSessionAccess(ctx, args.sessionId, "send");
-    observer.stop(args.sessionId, "session-delete");
+    observer.stop(args.sessionId);
     const { response, broadcast } = manager.newSession(args);
     return { response: { type: "session:info", ...response }, broadcast };
   };
@@ -53781,9 +53790,30 @@ function buildContactHandlers(deps) {
       }
     };
   };
+  const setNote = async (frame, _client, ctx) => {
+    ensureOwner(ctx);
+    const { type: _t, requestId: _r, ...rest } = frame;
+    const args = ContactSetNoteArgsSchema.parse(rest);
+    const updated = deps.store.setNote(args.deviceId, args.note);
+    if (!updated) {
+      throw new ClawdError(
+        ERROR_CODES.INVALID_PARAM,
+        `INVALID_PARAM: contact ${args.deviceId} \u4E0D\u5B58\u5728`
+      );
+    }
+    deps.broadcast({ type: "contact:added", contact: updated });
+    return {
+      response: {
+        type: "contact:set-note:ok",
+        deviceId: args.deviceId,
+        note: args.note
+      }
+    };
+  };
   return {
     "contact:list": list,
-    "contact:remove": remove
+    "contact:remove": remove,
+    "contact:set-note": setNote
   };
 }
 
@@ -56574,6 +56604,7 @@ var METHOD_GRANT_MAP = {
   // 写入路径在 device:connect / 自动反向；list / remove 作联系人读 / 删，owner-only。
   "contact:list": ADMIN_ANY,
   "contact:remove": ADMIN_ANY,
+  "contact:set-note": ADMIN_ANY,
   // ---- visitor:* (访客名单，owner-only) ----
   // owner 看完整访客名单（含没开会话的）；guest 不可调（handler 内再 assertOwner 兜底）。
   "visitor:list": ADMIN_ANY,
@@ -57482,9 +57513,7 @@ async function startDaemon(config) {
     // daemon 内部转译，UI 看到的始终是 events 流里的 synth uuid（详见 manager 注释）
     onUserMessageObserved: (sessionId, realUuid, text) => {
       manager.recordRealUserUuid({ sessionId, realUuid, text });
-    },
-    // 永久取证 log：observer.start / start no-op / stop（spec 2026-06-26-observer-restart-fix §3.3）
-    logger
+    }
   });
   manager.attachObserver(observer);
   const claudeAdapter = config.mode === "tui" ? new ClaudeTuiAdapter({