cortico-world-hands 0.1.6 → 0.1.8

package/dist/index.js

@@ -15,7 +15,13 @@ var HANDS_DEFAULTS = {
   maxTextLength: 200,
   lookAttach: true,
   lookMaxWidth: 720,
-  lookQuality: 60
+  lookQuality: 60,
+  honchoEnabled: false,
+  honchoApiKey: "",
+  honchoBaseUrl: "https://api.honcho.dev",
+  honchoWorkspace: "dsh",
+  honchoPeerId: "\u4E3B\u4EBA",
+  honchoSessionId: "yixin"
 };
 var KEY_CODES = {
   back: 4,
@@ -37,6 +43,54 @@ var KEY_CODES = {
   menu: 82
 };
 var K = `worlds.${HANDS_ID}`;
+var HK = `worlds.${HANDS_ID}`;
+var HANDS_HONCHO_GROUP = {
+  id: `world:${HANDS_ID}:honcho`,
+  owner: `world:${HANDS_ID}`,
+  schema: {
+    type: "object",
+    title: "Honcho \u8BB0\u5FC6",
+    description: "\u628A\u684C\u5BA0\u7684\u957F\u671F\u8BB0\u5FC6\u540C\u6B65\u5230 Honcho\uFF08plastic-labs \u7684\u8BB0\u5FC6\u670D\u52A1\uFF09\uFF0C\u56DE\u60F3\u65F6\u628A\u4E91\u7AEF\u7ED3\u8BBA\u4E00\u8D77\u5E26\u56DE\u6765\u3002\u4E0D\u586B key \u5C31\u53EA\u7528\u672C\u5730 memory.jsonl\u3002",
+    properties: {
+      [`${HK}.honchoEnabled`]: {
+        type: "boolean",
+        title: "\u542F\u7528 Honcho \u8BB0\u5FC6",
+        description: "\u6253\u5F00\u540E memory_save \u4F1A\u540C\u65F6\u5199\u672C\u5730\u4E0E Honcho\uFF0Cmemory_search \u4F1A\u5408\u5E76\u4E91\u7AEF\u7ED3\u679C\u3002",
+        "x-hot": true
+      },
+      [`${HK}.honchoApiKey`]: {
+        type: "string",
+        title: "API Key",
+        description: "\u5728 app.honcho.dev \u7533\u8BF7\u3002\u53EA\u586B\u8FD9\u4E00\u9879\u5373\u53EF\uFF0C\u5176\u4F59\u4FDD\u6301\u9ED8\u8BA4\u3002",
+        "x-hot": true
+      },
+      [`${HK}.honchoBaseUrl`]: {
+        type: "string",
+        title: "\u670D\u52A1\u5730\u5740",
+        description: "\u9ED8\u8BA4 https://api.honcho.dev\uFF1B\u81EA\u5EFA\u5B9E\u4F8B\u586B\u81EA\u5DF1\u7684\u5730\u5740\u3002",
+        "x-hot": false
+      },
+      [`${HK}.honchoWorkspace`]: {
+        type: "string",
+        title: "\u5DE5\u4F5C\u533A",
+        description: "\u8BB0\u5FC6\u7684\u9694\u79BB\u8FB9\u754C\u3002\u60F3\u548C\u5176\u4ED6\u7AEF\uFF08claude-honcho \u7B49\uFF09\u5171\u4EAB\u8BB0\u5FC6\u5C31\u586B\u540C\u4E00\u4E2A workspace\u3002",
+        "x-hot": false
+      },
+      [`${HK}.honchoPeerId`]: {
+        type: "string",
+        title: "\u5173\u4E8E\u8C01",
+        description: "\u8BB0\u5FC6\u5F52\u5C5E\u7684 peer\uFF0C\u9ED8\u8BA4\u300C\u4E3B\u4EBA\u300D\u3002",
+        "x-hot": false
+      },
+      [`${HK}.honchoSessionId`]: {
+        type: "string",
+        title: "\u4F1A\u8BDD\u540D",
+        description: "Honcho \u91CC\u7684\u4F1A\u8BDD\u6807\u8BC6\uFF0C\u9ED8\u8BA4 yixin\u3002",
+        "x-hot": false
+      }
+    }
+  }
+};
 var HANDS_CONFIG_GROUP = {
   id: `world:${HANDS_ID}`,
   owner: `world:${HANDS_ID}`,
@@ -161,6 +215,98 @@ var HANDS_LOOK_CONFIG_GROUP = {
 // src/world.ts
 import { fileURLToPath } from "node:url";
 
+// src/honcho.ts
+var TIMEOUT_MS = 12e3;
+var Honcho = class {
+  cfg;
+  peerReady = false;
+  sessionReady = false;
+  constructor(cfg) {
+    this.cfg = cfg;
+  }
+  get configured() {
+    return this.cfg.enabled && this.cfg.apiKey.trim().length > 0;
+  }
+  base() {
+    return this.cfg.baseUrl.replace(/\/+$/, "");
+  }
+  async call(path, body) {
+    const url = `${this.base()}/v3/workspaces/${encodeURIComponent(this.cfg.workspace)}${path}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+      const res = await fetch(url, {
+        method: "POST",
+        headers: {
+          "content-type": "application/json",
+          authorization: `Bearer ${this.cfg.apiKey.trim()}`
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      const text = await res.text();
+      if (!res.ok) throw new Error(`honcho ${res.status}: ${text.slice(0, 160)}`);
+      return text ? JSON.parse(text) : {};
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async ensurePeer() {
+    if (this.peerReady) return;
+    await this.call("/peers", { id: this.cfg.peerId });
+    this.peerReady = true;
+  }
+  async ensureSession() {
+    if (this.sessionReady) return;
+    await this.ensurePeer();
+    await this.call("/sessions", { id: this.cfg.sessionId, peers: [this.cfg.peerId] });
+    this.sessionReady = true;
+  }
+  /** 把一条事实写进 Honcho 的会话里（后台 Deriver 会据此归纳结论）。 */
+  async remember(sentence) {
+    if (!this.configured) return;
+    await this.ensureSession();
+    await this.call(`/sessions/${encodeURIComponent(this.cfg.sessionId)}/messages`, {
+      messages: [{ peer_id: this.cfg.peerId, content: sentence }]
+    });
+  }
+  /** 在 Honcho 里搜相关记忆（原始消息 + 归纳结论）。 */
+  async search(query, limit = 8) {
+    if (!this.configured) return [];
+    await this.ensurePeer();
+    const raw = await this.call(`/peers/${encodeURIComponent(this.cfg.peerId)}/search`, {
+      query,
+      limit
+    });
+    const hits = [];
+    const push = (item, source) => {
+      if (typeof item === "string") {
+        hits.push({ text: item, source });
+        return;
+      }
+      if (!item || typeof item !== "object") return;
+      const row = item;
+      const text = [row.content, row.text, row.conclusion, row.observation].find((v) => typeof v === "string" && v.trim().length > 0);
+      if (text) hits.push({ text: text.trim(), source: String(row.session_id || row.type || source) });
+    };
+    const list = Array.isArray(raw) ? raw : raw.results || raw.messages || raw.conclusions || [];
+    for (const item of list) push(item, "\u7ED3\u8BBA");
+    return hits.slice(0, limit);
+  }
+  /** 让 Honcho 用自己的推理回答一个关于主人的问题（慢，但更“懂”）。 */
+  async ask(question) {
+    if (!this.configured) return "";
+    await this.ensurePeer();
+    const raw = await this.call(`/peers/${encodeURIComponent(this.cfg.peerId)}/chat`, {
+      query: question
+    });
+    const answer = [raw.content, raw.answer, raw.text, raw.reply].find(
+      (v) => typeof v === "string" && v.trim().length > 0
+    );
+    return answer ? answer.trim() : "";
+  }
+};
+
 // src/hands.ts
 import { execFile } from "node:child_process";
 import { readFileSync } from "node:fs";
@@ -670,6 +816,43 @@ var Hands = class {
     const ms = milliseconds(opts.ms, 900);
     return this.perform({ kind: "drag", x1: a, y1: b, x2: c, y2: d, ms });
   }
+  /** 长期记忆：存/改一条事实。 */
+  async memorySave(key, value, tags) {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `&t=${encodeURIComponent(credential)}` : "";
+    const tg = tags ? `&tags=${encodeURIComponent(tags)}` : "";
+    const path = `/hand/memory?key=${encodeURIComponent(key)}&value=${encodeURIComponent(value)}${tg}${t}`;
+    const res = await get(this.port(cfg.handPort), path, ACTION_TIMEOUT_MS);
+    let body = {};
+    try {
+      body = JSON.parse(res.body.toString("utf8"));
+    } catch {
+    }
+    return { ok: res.status === 200 && body.ok !== false, detail: flat(body.detail || body.error || "", 80) };
+  }
+  /** 长期记忆：按关键词回想（不传就全列）。 */
+  async memorySearch(query) {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `&t=${encodeURIComponent(credential)}` : "";
+    const q = query ? `?q=${encodeURIComponent(query)}${t}` : t ? `?${t.slice(1)}` : "";
+    const res = await get(this.port(cfg.handPort), `/hand/memories${q}`, ACTION_TIMEOUT_MS);
+    try {
+      const body = JSON.parse(res.body.toString("utf8"));
+      return Array.isArray(body.memories) ? body.memories : [];
+    } catch {
+      return [];
+    }
+  }
+  /** 长期记忆：忘掉一条。 */
+  async memoryForget(key) {
+    const cfg = this.cfg();
+    const credential = this.readToken();
+    const t = credential ? `&t=${encodeURIComponent(credential)}` : "";
+    const res = await get(this.port(cfg.handPort), `/hand/memory/forget?key=${encodeURIComponent(key)}${t}`, ACTION_TIMEOUT_MS);
+    return res.status === 200;
+  }
   /** 留言板：写一条。 */
   async noteAdd(text, kind) {
     const cfg = this.cfg();
@@ -973,6 +1156,42 @@ var HANDS_TOOL_DECLS = [
     description: "\u770B\u624B\u81EA\u5DF1\u7684\u72B6\u6001\uFF1A\u8D70\u54EA\u6761\u901A\u9053\u3001\u901A\u4E0D\u901A\u3001\u8FD9\u4E00\u5206\u949F\u52A8\u4E86\u51E0\u4E2A\u52A8\u4F5C\u3001\u521A\u624D\u90A3\u4E00\u4E0B\u6210\u4E86\u6CA1\u6709\u3002\u5BF9\u65B9\u95EE\u300C\u624B\u80FD\u7528\u5417\u300D\u300C\u4F60\u521A\u624D\u70B9\u4E86\u4EC0\u4E48\u300D\u65F6\u7528\u5B83\u3002",
     parameters: { type: "object", properties: {}, required: [] }
   },
+  {
+    name: "memory_save",
+    tags: ["act"],
+    description: "\u5F80\u957F\u671F\u8BB0\u5FC6\u91CC\u5B58\u4E00\u6761\u4E8B\u5B9E\uFF1A\u4E3B\u4EBA\u7684\u540D\u5B57/\u79F0\u547C\u3001\u559C\u597D\u5FCC\u8BB3\u3001\u4F5C\u606F\u4E60\u60EF\u3001\u6B63\u5728\u505A\u7684\u4E8B\u3001\u7EA6\u5B9A\u3001\u91CD\u8981\u65E5\u5B50\u3001\u4F60\u7B54\u5E94\u8FC7\u7684\u4E8B\u3002key \u7528\u7B80\u77ED\u4E3B\u9898\uFF08\u5982\u300C\u4E3B\u4EBA\u79F0\u547C\u300D\u300C\u5496\u5561\u504F\u597D\u300D\u300C\u5468\u672B\u5B89\u6392\u300D\uFF09\uFF0Cvalue \u5199\u6E05\u695A\uFF1B\u540C\u4E00\u4E2A key \u4F1A\u8986\u76D6\u3002",
+    parameters: {
+      type: "object",
+      properties: {
+        key: { type: "string", description: "\u7B80\u77ED\u4E3B\u9898\uFF0C\u6BD4\u5982\u300C\u4E3B\u4EBA\u7684\u732B\u300D\u300C\u751F\u65E5\u300D\u300C\u4E0D\u559C\u6B22\u300D" },
+        value: { type: "string", description: "\u8BB0\u7684\u5177\u4F53\u5185\u5BB9\uFF0C\u4E00\u53E5\u8BDD\u8BF4\u6E05\u3002" },
+        tags: { type: "string", description: "\u53EF\u9009\u6807\u7B7E\uFF0C\u9017\u53F7\u5206\u9694\u3002" }
+      },
+      required: ["key", "value"]
+    }
+  },
+  {
+    name: "memory_search",
+    tags: ["read"],
+    description: "\u56DE\u60F3\u957F\u671F\u8BB0\u5FC6\uFF1A\u6309\u5173\u952E\u8BCD\u67E5\uFF08\u4E0D\u4F20\u5173\u952E\u8BCD\u5C31\u5168\u90E8\u5217\u51FA\uFF09\u3002\u804A\u5929\u91CC\u6D89\u53CA\u4E3B\u4EBA\u7684\u504F\u597D\u3001\u7EA6\u5B9A\u3001\u4EE5\u524D\u8BF4\u8FC7\u7684\u4E8B\u65F6\u5148\u67E5\u4E00\u4E0B\uFF0C\u522B\u51ED\u611F\u89C9\u3002",
+    parameters: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "\u5173\u952E\u8BCD\uFF0C\u6BD4\u5982\u300C\u5496\u5561\u300D\u300C\u751F\u65E5\u300D\uFF1B\u7559\u7A7A\u770B\u5168\u90E8\u3002" }
+      },
+      required: []
+    }
+  },
+  {
+    name: "memory_forget",
+    tags: ["act"],
+    description: "\u5FD8\u6389\u4E00\u6761\u957F\u671F\u8BB0\u5FC6\uFF08\u8BB0\u9519\u4E86\u3001\u8FC7\u65F6\u4E86\u3001\u4E3B\u4EBA\u8BF4\u522B\u8BB0\u4E86\uFF09\u3002",
+    parameters: {
+      type: "object",
+      properties: { key: { type: "string", description: "\u8981\u5FD8\u6389\u7684\u4E3B\u9898 key\u3002" } },
+      required: ["key"]
+    }
+  },
   {
     name: "note_add",
     tags: ["act"],
@@ -1039,6 +1258,7 @@ var HandsWorld = class {
   hands;
   pausedUntil = 0;
   recent = [];
+  honchoClient = null;
   opts;
   constructor(opts) {
     this.opts = opts;
@@ -1100,6 +1320,12 @@ var HandsWorld = class {
           return await this.key(args);
         case "hand_status":
           return await this.statusText();
+        case "memory_save":
+          return await this.memorySave(args);
+        case "memory_search":
+          return await this.memorySearch(args);
+        case "memory_forget":
+          return await this.memoryForget(args);
         case "note_add":
           return await this.noteAdd(args);
         case "note_list":
@@ -1136,6 +1362,72 @@ var HandsWorld = class {
     return { text: report.text, ...blobs.length ? { blobs } : {} };
   }
   /** 给文字就先在屏幕上找，找到唯一一处才点；给坐标就直接点。 */
+  honcho() {
+    if (!this.honchoClient) {
+      this.honchoClient = new Honcho({
+        enabled: Boolean(this.opts.cfg.honchoEnabled),
+        apiKey: this.opts.cfg.honchoApiKey || "",
+        baseUrl: this.opts.cfg.honchoBaseUrl || "https://api.honcho.dev",
+        workspace: this.opts.cfg.honchoWorkspace || "dsh",
+        peerId: this.opts.cfg.honchoPeerId || "\u4E3B\u4EBA",
+        sessionId: this.opts.cfg.honchoSessionId || "yixin"
+      });
+    }
+    return this.honchoClient;
+  }
+  async memorySave(args) {
+    const key = typeof args.key === "string" ? args.key.trim() : "";
+    const value = typeof args.value === "string" ? args.value.trim() : "";
+    if (!key || !value) return failed("\u8981 key \u548C value\u3002");
+    const tags = typeof args.tags === "string" ? args.tags : void 0;
+    const r = await this.hands.memorySave(key, value, tags);
+    if (!r.ok) return failed(`\u6CA1\u8BB0\u4F4F\uFF1A${r.detail || "\u624B\u6CA1\u54CD\u5E94"}`);
+    let cloud = "";
+    const honcho = this.honcho();
+    if (honcho.configured) {
+      try {
+        await honcho.remember(`\u5173\u4E8E\u300C${key}\u300D\uFF1A${value}`);
+        cloud = "\uFF08\u5DF2\u540C\u6B65 Honcho\uFF09";
+      } catch (err) {
+        cloud = `\uFF08Honcho \u540C\u6B65\u5931\u8D25\uFF1A${err.message.slice(0, 60)}\uFF09`;
+      }
+    }
+    return `\u8BB0\u7262\u4E86\uFF1A\u300C${key}\u300D\u2192 ${value}${cloud}`;
+  }
+  async memorySearch(args) {
+    const query = typeof args.query === "string" ? args.query.trim() : "";
+    const rows = await this.hands.memorySearch(query);
+    const lines = rows.slice(0, 30).map((r) => `- ${r.key}\uFF1A${r.value}${r.ts ? `\uFF08${r.ts}\uFF09` : ""}`);
+    let cloudHits = [];
+    let cloudNote = "";
+    const honcho = this.honcho();
+    if (honcho.configured && query) {
+      try {
+        const hits = await honcho.search(query);
+        cloudHits = hits.map((h) => `- ${h.text}`);
+        if (cloudHits.length > 0) cloudNote = `
+
+Honcho \u8865\u5145 ${cloudHits.length} \u6761\uFF1A`;
+      } catch (err) {
+        cloudNote = `
+
+\uFF08Honcho \u67E5\u8BE2\u5931\u8D25\uFF1A${err.message.slice(0, 60)}\uFF09`;
+      }
+    }
+    if (lines.length === 0 && cloudHits.length === 0) {
+      return query ? `\u8BB0\u5FC6\u91CC\u6CA1\u6709\u548C\u300C${query}\u300D\u76F8\u5173\u7684\u3002` : "\u957F\u671F\u8BB0\u5FC6\u8FD8\u662F\u7A7A\u7684\u3002";
+    }
+    const local = lines.length > 0 ? `\u60F3\u8D77 ${rows.length} \u6761\uFF1A
+${lines.join("\n")}` : "\u672C\u5730\u8BB0\u5FC6\u6CA1\u6709\u76F4\u63A5\u547D\u4E2D\u3002";
+    return local + cloudNote + (cloudHits.length > 0 ? `
+${cloudHits.join("\n")}` : "");
+  }
+  async memoryForget(args) {
+    const key = typeof args.key === "string" ? args.key.trim() : "";
+    if (!key) return failed("\u8981\u5FD8\u6389\u54EA\u4E2A key\uFF1F");
+    const ok = await this.hands.memoryForget(key);
+    return ok ? `\u5FD8\u4E86\u300C${key}\u300D\u3002` : failed(`\u6CA1\u627E\u5230\u300C${key}\u300D\u8FD9\u6761\u8BB0\u5FC6\u3002`);
+  }
   async noteAdd(args) {
     const text = typeof args.text === "string" ? args.text.trim() : "";
     if (!text) return failed("\u8981\u5199\u4EC0\u4E48\uFF1F\u7ED9 text\u3002");
@@ -1313,7 +1605,7 @@ ${this.recent.map((r) => `- ${r}`).join("\n")}`);
         { label: zh ? "\u52A8\u8FC7" : "actions", value: stats.acts, tone: "plain" },
         { label: zh ? "\u770B\u8FC7" : "looks", value: stats.looks, tone: "plain" }
       ],
-      config: [HANDS_CONFIG_GROUP, HANDS_LOOK_CONFIG_GROUP],
+      config: [HANDS_CONFIG_GROUP, HANDS_LOOK_CONFIG_GROUP, HANDS_HONCHO_GROUP],
       promptDocs: [
         {
           key: `worlds.${HANDS_ID}.envPrompt`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-hands",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "description": "Cortico World: hands for the desktop pet — looks at the phone screen, then taps, swipes, pinches, drags, types and presses keys through whatever actuator the device actually has",
   "license": "MIT",