cortico-world-hands 0.1.7 → 0.1.9

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: "morse",
+  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\u53EA\u80FD\u7528\u5B57\u6BCD/\u6570\u5B57/\u4E0B\u5212\u7EBF/\u8FDE\u5B57\u7B26\uFF08\u9ED8\u8BA4 morse\uFF0C\u4E2D\u6587\u4F1A\u88AB\u6362\u6210 morse\uFF09\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,103 @@ 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;
+  }
+  /** Honcho 只接受 ^[a-zA-Z0-9_-]+$ 的 peer id，中文名要退化成 morse 这类。 */
+  safePeer() {
+    const raw = (this.cfg.peerId || "").trim();
+    return /^[a-zA-Z0-9_-]+$/.test(raw) ? raw : "morse";
+  }
+  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.safePeer() });
+    this.peerReady = true;
+  }
+  async ensureSession() {
+    if (this.sessionReady) return;
+    await this.ensurePeer();
+    await this.call("/sessions", { id: this.cfg.sessionId });
+    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.safePeer(), content: sentence }]
+    });
+  }
+  /** 在 Honcho 里搜相关记忆（原始消息 + 归纳结论）。 */
+  async search(query, limit = 8) {
+    if (!this.configured) return [];
+    await this.ensurePeer();
+    const raw = await this.call(`/peers/${encodeURIComponent(this.safePeer())}/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.safePeer())}/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";
@@ -1112,6 +1263,7 @@ var HandsWorld = class {
   hands;
   pausedUntil = 0;
   recent = [];
+  honchoClient = null;
   opts;
   constructor(opts) {
     this.opts = opts;
@@ -1215,21 +1367,65 @@ 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);
-    return r.ok ? `\u8BB0\u7262\u4E86\uFF1A\u300C${key}\u300D\u2192 ${value}` : failed(`\u6CA1\u8BB0\u4F4F\uFF1A${r.detail || "\u624B\u6CA1\u54CD\u5E94"}`);
+    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);
-    if (rows.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 lines = rows.slice(0, 30).map((r) => `- ${r.key}\uFF1A${r.value}${r.ts ? `\uFF08${r.ts}\uFF09` : ""}`).join("\n");
-    return `\u60F3\u8D77 ${rows.length} \u6761\uFF1A
-${lines}`;
+    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() : "";
@@ -1414,7 +1610,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.7",
+  "version": "0.1.9",
   "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",