@clawos-dev/clawd 0.2.186 → 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();
   }
 });
 
@@ -50174,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);
@@ -53760,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
   };
 }
 
@@ -56553,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,