owlmem 0.7.9 → 0.8.0

package/owlmem.mjs

@@ -41,7 +41,7 @@ import { join, dirname, basename, relative, isAbsolute } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawn, spawnSync } from "node:child_process";
 
-export const VERSION = "0.7.9";
+export const VERSION = "0.8.0";
 const BASE = (process.env.OWLMEM_URL || "https://owlmem.com").replace(/\/$/, "");
 const DIR = process.env.OWLMEM_HOME || join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "owlmem");
 const enc = new TextEncoder(), dec = new TextDecoder();
@@ -1074,10 +1074,13 @@ export function prepareWorkdir(task, plan, dir = DIR, git = gitRun) {
   return { cwd: rel ? join(wt, rel) : wt, worktree: wt, branch, repo: plan.top };
 }
 
-// A job from OwlMem is a task given to this AI (type "task"), or the result of a task this AI gave someone else (type "reply":
-// the automatic note sent when that task was done or declined). Older OwlMem servers send no type: a task.
+// A job from OwlMem is a task given to this AI (type "task"), the result of a task this AI gave someone else (type "reply":
+// the automatic note sent when that task was done or declined), or a note a person sent this AI (type "note", 0.8.0).
+// Older OwlMem servers send no type: a task.
 const isReply = (t) => t?.type === "reply";
-const jobName = (t) => (isReply(t) ? "reply-" : "task-") + t.id;
+const isNote = (t) => t?.type === "note";
+const jobLabel = (t) => (isReply(t) ? "Reply #" : isNote(t) ? "Note #" : "Task #") + t.id;
+const jobName = (t) => (isReply(t) ? "reply-" : isNote(t) ? "note-" : "task-") + t.id;
 const shortName = (who) => { who = String(who || ""); return who.startsWith("user:") ? who.slice(5) : who.includes("/") ? who.split("/").slice(1).join("/") : who; };
 
 // Woken for a reply: read it (kb_inbox marks it read; that's how OwlMem knows it was handled), act on it only if needed.
@@ -1099,8 +1102,44 @@ Never put passwords, tokens, keys or other secrets in any message. You have ${mi
 `;
 }
 
+// Woken for a note a person sent this AI: a person writing to an AI usually wants something done, whichever kind they picked.
+// Read it (kb_inbox marks it read; that's how OwlMem knows it was handled), do it if it asks for something, and tell them the result.
+export function notePrompt(n, place, o = {}) {
+  const who = shortName(n.from), mins = o.timeout_min || WAKE_DEFAULTS.timeout_min;
+  const where = place.worktree
+    ? (n.zh ? `在 ${place.cwd} 里做（${place.repo} 的独立 git 工作树，分支 ${place.branch}；只在这个分支提交，不合并、不推送别的分支，结果里写上分支名）。`
+      : `Work in ${place.cwd}. It is a separate git worktree of ${place.repo} on the branch ${place.branch}. Commit on this branch only, don't merge or push other branches, and put the branch name in your result.`)
+    : place.scratch ? (n.zh ? `留言没指定目录：你在一个空文件夹（${place.cwd}）里。` : `The note names no project directory: you are in an empty folder (${place.cwd}).`)
+    : (n.zh ? `在 ${place.cwd} 里做。` : `Work in ${place.cwd}.`);
+  if (n.zh) return `奥麦自动唤醒在 ${o.machine || "这台电脑"} 上启动了你（${n.agent}），因为 ${who}（人）给你发了一条留言。没有人在看这个会话，也没人能回答问题。
+
+留言 #${n.id}：${n.title}
+
+${n.body || "（没有正文）"}
+
+先用 kb_inbox 看这条留言（会标成已读）。${where}
+- 它要你做事：不需要人参与的就直接做完，然后用 kb_send 发给 ${n.from}（kind=note）报结果，标题一句话说结果。
+- 做不了（要人输验证码、被安全检查拦下、要动有风险的线上服务）：不要硬做，用 kb_send 告诉 ${n.from} 卡在哪、需要他做什么。
+- 只是告诉你一件事、不用做什么：看完就结束，不要发消息。
+不要把密码、令牌、密钥写进任何消息。你有 ${mins} 分钟。
+`;
+  return `OwlMem auto-wake started you (${n.agent}) on ${o.machine || "this computer"} because ${who}, a person, sent you a note. Nobody is watching this session and nobody can answer questions.
+
+Note #${n.id}: ${n.title}
+
+${n.body || "(no details)"}
+
+First read it with kb_inbox (that marks it read). ${where}
+- If it asks you to do something you can do without a person, do it, then tell ${n.from} the result with kb_send (kind=note), with the result in one line as the title.
+- If you can't (it needs a code typed in, a safety check stops you, or it means a risky change to a live service), don't force it: tell ${n.from} with kb_send what is blocking and what they need to do.
+- If it only tells you something, end here and don't send any message.
+Never put passwords, tokens, keys or other secrets in any message. You have ${mins} minutes.
+`;
+}
+
 export function wakePrompt(task, place, o = {}) {
   if (isReply(task)) return replyPrompt(task, o);
+  if (isNote(task)) return notePrompt(task, place, o);
   const id = task.id, mins = o.timeout_min || WAKE_DEFAULTS.timeout_min;
   const where = place.worktree
     ? `Work in ${place.cwd}. It is a separate git worktree of ${place.repo} on the branch ${place.branch}, made for this task so it doesn't collide with other work. Commit your changes on this branch only. Don't merge, rebase or push other branches, and don't touch ${place.repo} itself. Put the branch name in your result so a person can review and merge it.`
@@ -1142,7 +1181,7 @@ export async function runTask(task, cfg, o = {}) {
       let ch, timedOut = false, killer = null;
       try {
         ch = spawn(argv[0], argv.slice(1), { cwd: place.cwd, stdio: ["pipe", fd, fd], detached: !win, shell: win, windowsHide: true,
-          env: { ...process.env, OWLMEM_NO_BROWSER: "1", [isReply(task) ? "OWLMEM_WAKE_REPLY" : "OWLMEM_WAKE_TASK"]: String(task.id) } });
+          env: { ...process.env, OWLMEM_NO_BROWSER: "1", [isReply(task) ? "OWLMEM_WAKE_REPLY" : isNote(task) ? "OWLMEM_WAKE_NOTE" : "OWLMEM_WAKE_TASK"]: String(task.id) } });
       } catch (e) { res({ outcome: "error", detail: "couldn't start " + argv[0] + ": " + e.message }); return; }
       const kill = (sig) => { try { if (win) spawnSync("taskkill", ["/T", "/F", "/PID", String(ch.pid)]); else process.kill(-ch.pid, sig); } catch { try { ch.kill(sig); } catch {} } };
       const timer = setTimeout(() => { timedOut = true; kill("SIGTERM"); killer = setTimeout(() => kill("SIGKILL"), 10000); }, ms);
@@ -1200,7 +1239,7 @@ export async function wakeLoop(o) {
     backoff = 0;
     for (const t of r.data.tasks || []) {
       const plan = isReply(t) ? { kind: "scratch" } : o.plan ? o.plan(t) : planWorkdir(t);      // a reply is read in an empty folder
-      log((isReply(t) ? "Reply #" + t.id + " (task #" + t.task_id + ")" : "Task #" + t.id) + " for " + t.agent + ": starting " + t.client + (plan.dir ? " in " + plan.dir : "") + ".");
+      log((isReply(t) ? "Reply #" + t.id + " (task #" + t.task_id + ")" : jobLabel(t)) + " for " + t.agent + ": starting " + t.client + (plan.dir ? " in " + plan.dir : "") + ".");
       sched.add({ id: t.id, agent: t.agent, lock: plan.lock || null, task: t, plan });
     }
     // OwlMem says a newer version is out: update only while nothing runs or waits (no task is cut off), then restart
@@ -1216,12 +1255,13 @@ export async function wakeLoop(o) {
 // The program runs its own copy (wake/owlmem.mjs). When OwlMem's poll answer names a newer version (latest), and nothing is
 // running: download that version's package from the npm registry, check it against the registry's sha512, take owlmem.mjs
 // out of it, check that it runs and says it is that version, then swap it in (rename in the same folder, so it's all or
-// nothing) and restart. If anything fails the old copy keeps running, and that version isn't tried again for 24 hours.
+// nothing) and restart. If anything fails the old copy keeps running, and that version isn't tried again for 24 hours;
+// except a 404 for the version: npm takes a few minutes to serve a new one everywhere, so that's tried again in 10 minutes.
 // Restart: on Linux and macOS the program exits with WAKE_RESTART_CODE; the systemd unit (Restart=on-failure) and the
 // LaunchAgent (KeepAlive unless the exit was successful) start it again 30 s later. On Windows nothing watches it, so it
 // starts the new copy itself (detached, like the logon launcher) and then exits.
 export const WAKE_RESTART_CODE = 75;
-const UPDATE_RETRY = 24 * 3600 * 1000;
+const UPDATE_RETRY = 24 * 3600 * 1000, UPDATE_NOT_YET = 10 * 60 * 1000;
 const REGISTRY = () => String(process.env.npm_config_registry || "https://registry.npmjs.org").replace(/\/+$/, "");
 export function newer(a, b) {
   const p = (v) => (/^\d+\.\d+\.\d+$/.test(String(v || "")) ? String(v).split(".").map(Number) : null);
@@ -1243,16 +1283,22 @@ export function tarFile(tgz, want = "package/owlmem.mjs") {
   }
   return null;
 }
-// → "restart" (new copy in place) | "skip" (tried that version less than 24 h ago) | "failed" (old copy stays)
+// → "restart" (new copy in place) | "skip" (tried that version less than 24 h ago, or 10 min for a 404) | "failed" (old copy stays)
 export async function wakeUpdate(latest, o = {}) {
   const dir = o.dir || DIR, log = o.log || (() => {}), now = o.now || Date.now, get = o.fetch || fetch;
   const wd = wakeDir(dir), state = join(wd, "update.json"), target = join(wd, "owlmem.mjs"), tmpFile = join(wd, "owlmem.update.mjs");
   let st = {}; try { st = JSON.parse(readFileSync(state, "utf8")); } catch {}
-  if (st.version === latest && now() - (st.at || 0) < UPDATE_RETRY) return "skip";
-  try { mkdirSync(wd, { recursive: true }); writeFileSync(state, JSON.stringify({ version: latest, at: now() }) + "\n"); } catch {}
+  if (st.version === latest && now() - (st.at || 0) < (st.wait || UPDATE_RETRY)) return "skip";
+  const mark = (wait) => { try { mkdirSync(wd, { recursive: true }); writeFileSync(state, JSON.stringify({ version: latest, at: now(), ...(wait ? { wait } : {}) }) + "\n"); } catch {} };
+  mark();
   log("Updating auto-wake from " + VERSION + " to " + latest + ".");
   try {
     const meta = await get(REGISTRY() + "/owlmem/" + encodeURIComponent(latest), { signal: AbortSignal.timeout(60000) });
+    if (meta.status === 404) {
+      mark(UPDATE_NOT_YET);
+      log(latest + " isn't on npm yet; trying again in 10 minutes.");
+      return "failed";
+    }
     if (!meta.ok) throw new Error("registry answered HTTP " + meta.status);
     const dist = (await meta.json())?.dist || {};
     const m = /^sha512-(.+)$/.exec(String(dist.integrity || ""));
@@ -1328,7 +1374,7 @@ async function wakeRun() {
   const log = wakeLogger(), api = wakeApi();
   try { if (wakeTools(cfg)) { saveWake(DIR, cfg); log("Unattended runs may now also use: " + WAKE_TOOLS.join(", ") + "."); } } catch (e) { log("tools: " + e.message); }
   const report = async (j, res) => {
-    log((isReply(j.task) ? "Reply #" : "Task #") + j.id + ": " + res.outcome + (res.code != null ? " (exit code " + res.code + ")" : "") + (res.detail ? " — " + res.detail : ""));
+    log(jobLabel(j.task) + ": " + res.outcome + (res.code != null ? " (exit code " + res.code + ")" : "") + (res.detail ? " — " + res.detail : ""));
     for (let i = 0; i < 5; i++) {
       const r = await api("report", { id: j.id, outcome: res.outcome, code: res.code ?? null, detail: res.detail || "" });
       if (r.status === 200 || r.status === 404 || r.status === 401) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "owlmem",
-  "version": "0.7.9",
+  "version": "0.8.0",
   "description": "OwlMem command line: connect your AI apps to OwlMem in one command (npx -y owlmem install), an end-to-end encrypted vault for your AI agents, and a local MCP server.",
   "type": "module",
   "bin": { "owlmem": "owlmem.mjs" },