agent.libx.js 0.94.1 → 0.94.3

package/README.md

@@ -89,6 +89,7 @@ Beyond file tools, the runtime ships the higher-altitude pieces too — each an
 - **Streaming** (`stream: true` → `text_delta` via `HostBridge.notify`) and **context compaction** (`compaction: { maxMessages }` → edge-safe summarize-and-boundary). Defaults preserve the original non-stream, drop-oldest behavior.
 - **Multi-turn + project context** — `Agent.send()` continues a conversation across turns (vs `run()`, which starts fresh); **project instructions** (`instructionFiles`: `AGENTS.md`/`CLAUDE.md` at the FS root) inject into the system prompt.
 - **DuplexAgent** (`src/duplex.ts`) — voice-optimized three-tier engine (reflex/act/think): a fast reflex agent streams instant replies and self-selects escalation — `Act` for standard tool work (Sonnet-class), `Think` for deep reasoning (Opus-class, configurable, default on). Results are pushed back and re-voiced by the reflex (turn mutex, coalesced completions, `TaskStatus`/`CancelTask`). See [`mind/10`](./mind/10-duplex.md).
+- **Scheduler** (`src/scheduler.ts`) — in-process scheduled tasks: one-off (`{at}`), interval (`{everyMs}`), cron (`{cron}`). Four agent tools (`ScheduleTask`/`ScheduleList`/`ScheduleCancel`/`Wakeup`). Fires while the session is alive; persisted in session JSON, re-armed on `--resume`. See [`mind/12`](./mind/12-scheduler.md).
 - **Budget kill-switches** — always-on per-run guards (`maxTokens`/`timeoutMs`/`maxRepeats`/`maxToolCalls`/`signal` → `finishReason` `budget`/`timeout`/`loop`/`max_tool_calls`/`aborted`) protect the API spend against runaway loops. The *enforceable* billing cap is server-side in the web key-proxy: a VFS-backed budget config (`/.agent/budget.json`, USD-metered, hot-reloaded, $100/wk default) a browser client can't bypass. See [`web/`](./web) and [`mind/06`](./mind/06-agent-features.md).
 
 ## The `agentx` CLI
@@ -103,14 +104,14 @@ agentx --resume <id> "…"    # resume a specific session
 ```
 
 - **Filesystem + Shell** — by default the CLI has **full real-filesystem access like Claude Code** (root `/` is the machine root, the launch dir is the working dir, absolute host paths and above-cwd reach both work) with a **real `/bin/sh`** (`Shell` tool) so the agent can run git, bun, node, curl, and any installed binary. Secrets (`.env`, `.ssh`, keys, `.git`) stay hidden by the jail; env secrets are scrubbed from the child shell. `--sandbox` instead operates over an in-memory copy of the working dir with a VFS-only `bash` — the real disk is never touched. `--boddb <dir>` runs over a **persistent database workspace** (a bod-db store at `<dir>` — `meta.db` tree + `files/` bytes) that survives across runs while the real disk stays untouched; DB-native by default, or add `--seed` to hydrate it from cwd on the first run. `--no-shell` forces the VFS bash in disk mode. (`/sandbox` shows the active mode.)
-- **Sessions** — every conversation persists to `./.agent/sessions/<id>.json`; `--continue`/`--resume` (and `/sessions`, `/resume`) pick it back up, *with memory across turns* — a REPL turn sees the previous one.
+- **Sessions** — every conversation persists to `./.agent/sessions/<id>.json`; `--continue`/`--resume` (and `/sessions`, `/resume`) pick it back up, *with memory across turns* — a REPL turn sees the previous one. A global symlink index at `~/.agent/sessions/` enables cross-project lookup: `--resume 090715-335` resolves from any directory, and `/sessions all` lists every project's sessions in one picker.
 - **Diffs** — every `Edit`/`Write`/`MultiEdit` renders a colorized `+/-` diff (TTY-gated; plain when piped).
 - **Slash commands** — `/help /tools /model /compact /clear /sessions /resume /commands /init`; user-defined `./.agent/commands/<name>.md` are invokable directly as `/<name>` (the same registry the model's `SlashCommand` tool uses).
 - **Project instructions** — `./AGENTS.md` (or `CLAUDE.md`) auto-loads into every run; `/init` scaffolds one.
 - **Any provider** — set `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` / `GOOGLE_API_KEY` / `GROQ_API_KEY`; choose with `-m provider/model`.
 - **@-file mentions & headless JSON** — reference files inline in a prompt with `@path` (e.g. `explain @src/Agent.ts`); script with `-p --output-format json` to get one machine-readable result object on stdout (activity stays on stderr).
 - **Tab-completion** — `Tab` completes `/<command>` names and `@<path>` file/dir references (descends subdirs, dotfiles hidden unless typed) straight from the working tree.
-- **Duplex mode** — `agentx --duplex` runs the full standard REPL (slash commands, sessions, postures, rewind, MCP) with the three-tier engine driving turns: a fast voice model (`--voice-model`, default `groq/openai/gpt-oss-120b`) answers every line instantly and delegates real work to background workers built with the same wiring as a normal run (fs mode, permissions, MCP); worker activity shows as dim chrome and results are re-voiced when ready. Switch any tier live with `/model` (opens a reflex/act/think picker), or the `/voice-model` · `/think-model` shortcuts.
+- **Duplex mode** — `agentx --duplex` runs the full standard REPL (slash commands, sessions, postures, rewind, MCP) with the three-tier engine driving turns: a fast voice model (`--voice-model`, default `groq/openai/gpt-oss-120b`) answers every line instantly and delegates real work to background workers built with the same wiring as a normal run (fs mode, permissions, MCP); worker activity shows as dim chrome and results are re-voiced when ready. Switch any tier live with `/model` (opens a reflex/act/think picker), or the `/voice-model` · `/think-model` shortcuts. `/tasks` lists background tasks and cancels a running one from a picker (Esc mid-turn cancels the foreground turn; Esc again at the idle prompt cancels running workers).
 - **MCP servers** — declare `mcpServers: { name: { command, args } | { url } }` in config and they're auto-mounted at startup (in parallel, with an optional `mountTimeoutMs` deadline so one slow/dead server never blocks the rest): the client does the JSON-RPC handshake (stdio or HTTP) + `tools/list`, and the discovered tools appear as `mcp__<name>__<tool>` in `/tools` (inspect with `/mcp`). A bad server is logged and skipped, never blocking the agent. For large tool sets, **deferred mode** (`makeMcpToolSearch` / `mountMcpDeferred`) exposes just two bounded tools (`ToolSearch` + `McpCall`) instead of N defs — dodging the provider tool-cap and improving selection accuracy. **`mountMcpCatalog`** goes further: a cached, hash-keyed catalog + lazy connect means a turn that uses no MCP tool opens **zero** connections, and one that uses a tool connects exactly that server — latency scales with tools-used, not servers-configured. A down server is **negative-cached** (`failureCooldownMs`) so it never re-floors a later turn at the deadline. For zero turn-path latency even on a cold process, call **`warmMcpCatalog`** at boot + on a timer (off-turn discovery) and mount with **`{ discover: 'cache-only' }`** — the turn then never synchronously connects: it serves the warmed catalog and discovers any miss in the background.
 
 ## 🧬 It improves itself

package/dist/cli.js

@@ -1620,7 +1620,7 @@ var init_tools_shell = __esm({
 // cli/cli.ts
 import { createInterface } from "readline/promises";
 import { existsSync as existsSync8, readFileSync as readFileSync5, appendFileSync, mkdirSync as mkdirSync7, writeFileSync as writeFileSync6, readdirSync as readdirSync2, statSync as statSync3 } from "fs";
-import { homedir as homedir5, tmpdir as tmpdir2 } from "os";
+import { homedir as homedir6, tmpdir as tmpdir2 } from "os";
 
 // cli/clipboard.ts
 import { execFileSync } from "child_process";
@@ -4192,6 +4192,15 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
       return res;
     });
   }
+  /** Cancel a running background task — shared by the CancelTask tool and the CLI /tasks picker. */
+  cancelTask(id) {
+    const rec = this.tasks.get(id);
+    if (!rec) return `No task '${id}'.`;
+    if (rec.status !== "running") return `Task ${rec.id} is already ${rec.status}.`;
+    rec.status = "cancelled";
+    rec.controller.abort();
+    return `Task ${rec.id} (${rec.label}) cancelled.`;
+  }
   /** Resolve when all queued voice turns AND all in-flight worker tasks have settled (tests, graceful shutdown). */
   async idle() {
     while (true) {
@@ -4608,14 +4617,7 @@ Another agent just implemented the above. Independently check the CURRENT state
       name: "CancelTask",
       description: "Cancel a running background task by id.",
       parameters: { type: "object", required: ["id"], properties: { id: { type: "string" } } },
-      run: async ({ id }) => {
-        const rec = this.tasks.get(String(id));
-        if (!rec) return `No task '${id}'.`;
-        if (rec.status !== "running") return `Task ${rec.id} is already ${rec.status}.`;
-        rec.status = "cancelled";
-        rec.controller.abort();
-        return `Task ${rec.id} (${rec.label}) cancelled.`;
-      }
+      run: async ({ id }) => this.cancelTask(String(id))
     };
   }
 };
@@ -6564,9 +6566,11 @@ function formatDiff(ops, opts = {}) {
 }
 
 // cli/session.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3, readdirSync, renameSync } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3, readdirSync, renameSync, symlinkSync, unlinkSync, readlinkSync } from "fs";
+import { homedir as homedir4 } from "os";
 import { join as join6 } from "path";
 var log15 = forComponent("session");
+var globalDir = () => join6(homedir4(), ".agent", "sessions");
 var SessionStore = class {
   dir;
   constructor(cwd) {
@@ -6589,6 +6593,13 @@ var SessionStore = class {
     const tmp = `${path}.${process.pid}.tmp`;
     writeFileSync3(tmp, JSON.stringify(data));
     renameSync(tmp, path);
+    try {
+      const gd = globalDir();
+      if (!existsSync5(gd)) mkdirSync4(gd, { recursive: true });
+      const link2 = join6(gd, `${data.meta.id}.json`);
+      if (!existsSync5(link2)) symlinkSync(path, link2);
+    } catch {
+    }
   }
   load(id) {
     if (!this.safeId(id)) {
@@ -6627,6 +6638,52 @@ var SessionStore = class {
     return m ? this.load(m.id) : void 0;
   }
 };
+function globalSessionLoad(idOrPrefix) {
+  const gd = globalDir();
+  if (!existsSync5(gd)) return void 0;
+  const exact = join6(gd, `${idOrPrefix}.json`);
+  if (existsSync5(exact)) {
+    try {
+      const target = readlinkSync(exact);
+      return JSON.parse(readFileSync3(target, "utf8"));
+    } catch {
+      return void 0;
+    }
+  }
+  try {
+    for (const f of readdirSync(gd)) {
+      if (!f.endsWith(".json")) continue;
+      const base = f.slice(0, -5);
+      if (base.includes(idOrPrefix) || base.endsWith(idOrPrefix)) {
+        const target = readlinkSync(join6(gd, f));
+        return JSON.parse(readFileSync3(target, "utf8"));
+      }
+    }
+  } catch {
+  }
+  return void 0;
+}
+function globalSessionList() {
+  const gd = globalDir();
+  if (!existsSync5(gd)) return [];
+  const metas = [];
+  for (const f of readdirSync(gd)) {
+    if (!f.endsWith(".json")) continue;
+    try {
+      const target = readlinkSync(join6(gd, f));
+      if (!existsSync5(target)) {
+        try {
+          unlinkSync(join6(gd, f));
+        } catch {
+        }
+        continue;
+      }
+      metas.push(JSON.parse(readFileSync3(target, "utf8")).meta);
+    } catch {
+    }
+  }
+  return metas.sort((a, b) => b.updated - a.updated);
+}
 function titleOf(messages) {
   const u = messages.find((m) => m.role === "user");
   const t = contentText(u?.content).replace(/\s+/g, " ").trim();
@@ -6930,7 +6987,7 @@ var GitCheckpointsOptions = class {
 
 // cli/permissions.ts
 import { existsSync as existsSync7, readFileSync as readFileSync4, writeFileSync as writeFileSync5, mkdirSync as mkdirSync6 } from "fs";
-import { homedir as homedir4 } from "os";
+import { homedir as homedir5 } from "os";
 import { join as join8 } from "path";
 var RULE_RE = /^(\w+)(?:\((.+)\))?$/;
 function parseOne(raw, decision) {
@@ -6964,7 +7021,7 @@ function loadPersistedRules(cwd) {
     return {};
   }
 }
-function loadClaudeSettings(cwd, home = homedir4()) {
+function loadClaudeSettings(cwd, home = homedir5()) {
   const files = [join8(home, ".claude", "settings.json"), join8(cwd, ".claude", "settings.json"), join8(cwd, ".claude", "settings.local.json")];
   let out = {};
   for (const p of files) {
@@ -6996,7 +7053,7 @@ function mergePerms(a, b) {
   }
   return Object.keys(out).length ? out : void 0;
 }
-var TRUST_FILE = join8(homedir4(), ".agent", "trusted.json");
+var TRUST_FILE = join8(homedir5(), ".agent", "trusted.json");
 function isTrusted(cwd, file = TRUST_FILE) {
   try {
     return existsSync7(file) && JSON.parse(readFileSync4(file, "utf8")).includes(cwd);
@@ -7881,6 +7938,11 @@ function createLineEditor(out) {
           }
           return;
         }
+        if (key?.name === "escape" && !s.buf.length && !s.menuOpen && !s.searching && !s.prevEsc && opts.onEscapeIdle?.()) {
+          curRow = 0;
+          redraw();
+          return;
+        }
         if (key?.meta && key.name === "p" && opts.onPickModel) {
           process.stdin.off("keypress", onKey);
           void opts.onPickModel().finally(() => {
@@ -8488,7 +8550,7 @@ Project instructions: ./AGENTS.md or ./CLAUDE.md are auto-loaded (scaffold with
 Auto-loaded from ./.agent/: commands/, skills/, memory/, agents/.
 
 REPL shortcuts: !<cmd> runs a shell command inline \xB7 #<note> saves a memory \xB7 @path inlines a file
-REPL slash commands: /help /version /tools /permissions /status /cost /context /cwd /model /reasoning /config /rename /compact /rewind /undo /clear /sessions /resume /commands /skills /mcp /init /export /paste /goal /exit (duplex: /act /think /voice /voice-model /think-model)
+REPL slash commands: /help /version /tools /permissions /status /cost /context /cwd /model /reasoning /config /rename /compact /rewind /undo /clear /sessions /resume /commands /skills /mcp /init /export /paste /goal /exit (duplex: /act /think /tasks /voice /voice-model /think-model)
 REPL completion: type / (commands+skills) or @ (files) for a LIVE menu \u2014 \u2191/\u2193 select, \u23CE/Tab accept, Esc dismiss.
 REPL multi-line: Option/Alt+Enter inserts a newline, or end a line with \\ to continue. Esc cancels a running turn / clears the input line; double-Esc jumps back to edit a previous message.
 REPL shortcuts: Shift+Tab cycles permission posture (ask \u2192 accept-edits \u2192 plan) \xB7 Alt+T toggles reasoning \xB7 Alt+P switches model \xB7 Ctrl+O toggles verbose tool output \xB7 \u2192 or Tab accepts the dim history ghost-suggestion \xB7 Alt+S/Ctrl+S stash/unstash.
@@ -9001,7 +9063,7 @@ function pastePathClassifier(cwd) {
     t = t.replace(/\\ /g, " ").replace(/^['"]|['"]$/g, "");
     if (/\s/.test(t)) return null;
     if (!/^(\/|~\/|\.\/|\.\.\/)/.test(t)) return null;
-    const abs = t.startsWith("~/") ? join9(homedir5(), t.slice(2)) : resolve3(cwd, t);
+    const abs = t.startsWith("~/") ? join9(homedir6(), t.slice(2)) : resolve3(cwd, t);
     try {
       if (!statSync3(abs).isFile()) return null;
     } catch {
@@ -9106,12 +9168,15 @@ async function runTurn(agent, store, session, task, cp, cwd = process.cwd(), sen
   const tools = res.messages.slice(lastUser).filter((m2) => m2.role === "tool").length;
   const ok = res.finishReason === "stop";
   const shortId = session.meta.id.slice(-10);
-  err("\n" + (process.stderr.isTTY ? "\r\x1B[0J" : "") + (ok ? green("  \u2713 done") : red(`  \u2717 ${res.finishReason}`)) + dim(` \xB7 ${res.steps} steps \xB7 ${tools} tools \xB7 ${tok}${secs}s \xB7 ${shortId}
+  const silentAbort = res.finishReason === "aborted" && !res.usage?.totalTokens;
+  if (!silentAbort)
+    err("\n" + (process.stderr.isTTY ? "\r\x1B[0J" : "") + (ok ? green("  \u2713 done") : red(`  \u2717 ${res.finishReason}`)) + dim(` \xB7 ${res.steps} steps \xB7 ${tools} tools \xB7 ${tok}${secs}s \xB7 ${shortId}
 `));
   if (res.finishReason === "error" && res.error) {
     const e = res.error;
     err(red(`    ${e?.message ?? e}`) + (e?.statusCode ? dim(` (${e.statusCode}${e.code ? " " + e.code : ""})`) : "") + "\n");
   }
+  if (silentAbort) return { ok: false, res };
   session.messages = agent.transcript;
   session.meta.turns += 1;
   session.meta.tokens = (session.meta.tokens ?? 0) + (res.usage?.totalTokens ?? 0);
@@ -9133,7 +9198,7 @@ async function runTurn(agent, store, session, task, cp, cwd = process.cwd(), sen
 }
 function startSession(args, store, agent, cwd) {
   if (args.resume || args.cont) {
-    const data = args.resume ? store.load(args.resume) : store.latestData();
+    const data = args.resume ? store.load(args.resume) ?? globalSessionLoad(args.resume) : store.latestData();
     if (data) {
       agent.transcript = data.messages;
       if (args.fork) {
@@ -9597,7 +9662,7 @@ async function repl(args, ai, cfg, cwd) {
   const fs = agent.options.fs;
   const fsBase = fs.getCwd() === "/" ? "" : fs.getCwd();
   const adot = (sub) => `${fsBase}/.agent/${sub}`;
-  const adots = (sub) => [adot(sub), `${fsBase}/.claude/${sub}`, `${homedir5()}/.agent/${sub}`, `${homedir5()}/.claude/${sub}`];
+  const adots = (sub) => [adot(sub), `${fsBase}/.claude/${sub}`, `${homedir6()}/.agent/${sub}`, `${homedir6()}/.claude/${sub}`];
   const cmds = (await loadCommands(fs, adots("commands"))).commands;
   const skills = (await loadSkills(fs, adots("skills"))).skills;
   const histPath = join9(cwd, ".agent", "history");
@@ -9685,16 +9750,20 @@ async function repl(args, ai, cfg, cwd) {
     }
     return void 0;
   };
-  const pickSession = async () => {
-    const list = store.list();
+  const pickSession = async (global = false) => {
+    const list = global ? globalSessionList() : store.list();
     if (!list.length) {
-      err(dim("  (no saved sessions yet)\n"));
+      err(dim(`  (no saved sessions${global ? "" : " in this project"} yet)
+`));
       return;
     }
-    const items = list.slice(0, 50).map((m) => ({ label: `${m.id}  ${m.title || "(untitled)"}`, value: m.id, desc: `${ago(m.updated)} \xB7 ${m.turns} turn${m.turns === 1 ? "" : "s"}` }));
-    const id = await selectMenu(process.stderr, { title: "Resume a session", items, current: session.meta.id });
+    const items = list.slice(0, 50).map((m) => {
+      const where = global && m.cwd !== cwd ? ` \xB7 ${m.cwd.split("/").pop()}` : "";
+      return { label: `${m.id}  ${m.title || "(untitled)"}`, value: m.id, desc: `${ago(m.updated)} \xB7 ${m.turns} turn${m.turns === 1 ? "" : "s"}${where}` };
+    });
+    const id = await selectMenu(process.stderr, { title: global ? "Resume a session (all projects)" : "Resume a session", items, current: session.meta.id });
     if (!id) return;
-    const data = store.load(id);
+    const data = store.load(id) ?? globalSessionLoad(id);
     if (data) resumeInto(data);
     else err(red("  no such session\n"));
   };
@@ -9994,6 +10063,34 @@ ${extra}` : body);
         const off = dx.options.thinkModel === false;
         const id = await dx.dispatch(a.join(" "), "think");
         err(dim(`  \u2192 task ${id} ${off ? "(think tier off \u2014 running as act)" : "(think)"} started
+`));
+      }
+    }, tasks: {
+      desc: "background tasks \u2014 /tasks [cancel <id>], or alone for a picker (\u21B5 cancels the selected running task)",
+      run: async (a) => {
+        const all = [...dx.tasks.values()];
+        if (!all.length) {
+          err(dim("  no background tasks\n"));
+          return;
+        }
+        if (a[0]?.toLowerCase() === "cancel") {
+          if (!a[1]) {
+            err(yellow("  usage: /tasks cancel <id>\n"));
+            return;
+          }
+          err(dim(`  ${dx.cancelTask(a[1])}
+`));
+          return;
+        }
+        const mark = (s) => s === "running" ? cyan("\u25D4 running") : s === "done" ? green("\u2713 done") : s === "cancelled" ? yellow("\u2298 cancelled") : red(`\u2717 ${s}`);
+        if (!process.stderr.isTTY || !process.stdin.isTTY) {
+          for (const t of all) err(`  ${t.id}  ${mark(t.status)}  ${dim(t.label.slice(0, 60))}
+`);
+          return;
+        }
+        const items = all.map((t) => ({ label: `${t.id}  ${t.label.slice(0, 60)}`, value: t.id, desc: mark(t.status) + (t.status === "running" ? " \xB7 \u21B5 to cancel" : "") }));
+        const id = await selectMenu(process.stderr, { title: "Background tasks \xB7 \u21B5 cancel running \xB7 esc close", items });
+        if (id) err(dim(`  ${dx.cancelTask(String(id))}
 `));
       }
     } } : {},
@@ -10137,7 +10234,10 @@ ${extra}` : body);
         err("\x1Bc");
       }
     },
-    sessions: { desc: "pick a saved session to resume (interactive)", run: () => pickSession() },
+    sessions: {
+      desc: "pick a saved session to resume \u2014 /sessions [all] (all = across all projects)",
+      run: (a) => pickSession(a[0] === "all")
+    },
     resume: {
       desc: "resume a session \u2014 /resume <id>, or /resume alone to pick from a list",
       run: async (a) => {
@@ -10145,7 +10245,7 @@ ${extra}` : body);
           await pickSession();
           return;
         }
-        const data = store.load(a[0]);
+        const data = store.load(a[0]) ?? globalSessionLoad(a[0]);
         if (data) resumeInto(data);
         else err(red(`  no such session
 `));
@@ -10717,6 +10817,13 @@ ${extra}` : body);
       vimMode: cfg.editorMode === "vim",
       statusTickMs: dx ? 1e3 : void 0,
       // duplex: animate the running-task footer while idle at the prompt
+      // Esc at the idle prompt with workers running → cancel them (CC-style: Esc stops the work).
+      onEscapeIdle: dx ? () => {
+        const running = [...dx.tasks.values()].filter((t) => t.status === "running");
+        if (!running.length) return false;
+        for (const t of running) err("\r\x1B[0J" + yellow(`  \u2298 ${dx.cancelTask(t.id)}`) + "\n");
+        return true;
+      } : void 0,
       onCyclePosture: cyclePosture,
       onToggleThinking: toggleReasoning,
       onToggleVerbose: toggleVerbose,