@guangnao/agent-cli 1.1.6 → 1.1.7

package/dist/cli.js

@@ -3413,7 +3413,7 @@ var shell = {
 };
 
 // src/tools/read_file.ts
-import { readFileSync, statSync } from "node:fs";
+import { readFileSync } from "node:fs";
 
 // src/tools/file.ts
 import { resolve, isAbsolute, relative } from "node:path";
@@ -3430,17 +3430,23 @@ function safePath(p) {
 var MAX = 64 * 1024;
 var readFile = {
   name: "read_file",
-  schema: { name: "read_file", description: "read a UTF-8 text file (confined to the launch dir)", parameters: { type: "object", required: ["path"], properties: {
-    path: { type: "string", description: "file path, relative to the launch dir" }
+  schema: { name: "read_file", description: "read a UTF-8 text file (confined to the launch dir). Large files page: pass `offset` (and the result\u2019s `nextOffset`) to read the rest.", parameters: { type: "object", required: ["path"], properties: {
+    path: { type: "string", description: "file path, relative to the launch dir" },
+    offset: { type: "number", description: "char index to start at (default 0); use the previous result\u2019s `nextOffset` to continue" },
+    limit: { type: "number", description: `max chars to return (default & cap ${MAX})` }
   } } },
   run: (i) => {
-    const { path } = i;
+    const { path, offset, limit } = i;
     const abs = safePath(path);
     if (!abs) return { error: `path escapes the working directory: ${path}` };
     try {
-      const size = statSync(abs).size;
       const content = readFileSync(abs, "utf8");
-      return size > MAX ? { path, truncated: true, content: content.slice(0, MAX) } : { path, content };
+      const total = content.length;
+      const start = Math.max(0, Math.floor(offset ?? 0));
+      if (start >= total) return total === 0 ? { path, content: "" } : { path, content: "", total, note: `offset ${start} is at/past end of file (${total} chars)` };
+      const slice = content.slice(start, start + Math.min(limit ?? MAX, MAX));
+      const end = start + slice.length;
+      return end < total ? { path, content: slice, truncated: true, total, offset: start, nextOffset: end, note: `showing chars ${start}\u2013${end} of ${total}; call read_file again with offset=${end} for the rest` } : { path, content: slice, ...start > 0 ? { offset: start, total } : {} };
     } catch (e) {
       return { error: e instanceof Error ? e.message : String(e) };
     }
@@ -3470,7 +3476,7 @@ var listDir = {
 };
 
 // src/tools/grep.ts
-import { readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync2 } from "node:fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync2, statSync } from "node:fs";
 import { join } from "node:path";
 var SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", ".next", "coverage", ".cache"]);
 var MAX_HITS = 100;
@@ -3509,7 +3515,7 @@ var grep = {
     const rootLen = base().length + 1;
     for (const f of walk(root)) {
       try {
-        if (statSync2(f).size > MAX_FILE) continue;
+        if (statSync(f).size > MAX_FILE) continue;
       } catch {
         continue;
       }
@@ -5436,13 +5442,99 @@ function nursery(sys) {
   };
 }
 
+// ../agent-os/src/kernel/blob.ts
+var PAGE = 8 * 1024;
+var GREP_MAX = 50;
+var BlobStore = class {
+  constructor(cap = 4 * 1024 * 1024) {
+    this.cap = cap;
+  }
+  cap;
+  map = /* @__PURE__ */ new Map();
+  // insertion order = LRU age (re-set on touch → newest)
+  seq = 0;
+  bytes = 0;
+  // 4 MB total
+  /** Store content; return a fresh handle. Evict the oldest blobs while over the char cap. */
+  put(content) {
+    const handle = `blob_${(++this.seq).toString(36)}`;
+    this.map.set(handle, content);
+    this.bytes += content.length;
+    while (this.bytes > this.cap && this.map.size > 1) {
+      const [old, v] = this.map.entries().next().value;
+      this.map.delete(old);
+      this.bytes -= v.length;
+    }
+    return handle;
+  }
+  touch(handle) {
+    const v = this.map.get(handle);
+    if (v === void 0) return void 0;
+    this.map.delete(handle);
+    this.map.set(handle, v);
+    return v;
+  }
+  /** A character window of a blob (paged like read_file). */
+  read(handle, offset = 0, limit = PAGE) {
+    const v = this.touch(handle);
+    if (v === void 0) return { error: `unknown blob handle: ${handle}` };
+    const total = v.length;
+    const start = Math.max(0, Math.floor(offset));
+    if (start >= total) return { handle, content: "", total, note: `offset ${start} is at/past end (${total} chars)` };
+    const slice = v.slice(start, start + Math.min(Math.max(1, Math.floor(limit)), PAGE));
+    const end = start + slice.length;
+    return end < total ? { handle, content: slice, truncated: true, total, offset: start, nextOffset: end, note: `chars ${start}\u2013${end} of ${total}; call blob_read with offset=${end} for more` } : { handle, content: slice, total, offset: start };
+  }
+  /** Search a blob for a JS regex; return a short SNIPPET (char offset + surrounding window) per match. Snippet
+   *  rather than whole line because a blob is often one long line (JSON.stringify escapes newlines) — a line view
+   *  would return the entire blob and just overflow again. The offset lets the model blob_read around it. */
+  grep(handle, pattern, max = GREP_MAX) {
+    const v = this.touch(handle);
+    if (v === void 0) return { error: `unknown blob handle: ${handle}` };
+    let re;
+    try {
+      re = new RegExp(pattern, "g");
+    } catch {
+      return { error: `invalid pattern: ${pattern}` };
+    }
+    const PAD = 80, matches = [];
+    let m;
+    while ((m = re.exec(v)) && matches.length < max) {
+      const at = m.index, from = Math.max(0, at - PAD), to = Math.min(v.length, at + m[0].length + PAD);
+      matches.push(`@${at}: ${from > 0 ? "\u2026" : ""}${v.slice(from, to)}${to < v.length ? "\u2026" : ""}`);
+      if (re.lastIndex === at) re.lastIndex++;
+    }
+    return { handle, total: v.length, matches, ...matches.length >= max ? { truncated: true } : {} };
+  }
+};
+var BLOB_TOOLS = [
+  { name: "blob_read", description: "read a window of a large stored tool output by its blob handle (paged like read_file; use when a result said it was stored as blob_\u2026)", parameters: { type: "object", required: ["handle"], properties: {
+    handle: { type: "string", description: "the blob_\u2026 handle from a truncated result" },
+    offset: { type: "number", description: "char index to start at (default 0; use the previous result\u2019s nextOffset)" },
+    limit: { type: "number", description: `max chars (default & cap ${PAGE})` }
+  } } },
+  { name: "blob_grep", description: "find lines matching a JS regex inside a large stored tool output, by blob handle (search without re-reading it all)", parameters: { type: "object", required: ["handle", "pattern"], properties: {
+    handle: { type: "string", description: "the blob_\u2026 handle" },
+    pattern: { type: "string", description: "JS regex, matched per line" }
+  } } }
+];
+var BLOB_NAMES = new Set(BLOB_TOOLS.map((t) => t.name));
+var isBlobTool = (name) => BLOB_NAMES.has(name);
+function execBlobTool(store, name, input) {
+  const a = input ?? {};
+  if (!a.handle) return { error: "handle is required" };
+  if (name === "blob_read") return store.read(a.handle, a.offset, a.limit);
+  if (name === "blob_grep") return a.pattern ? store.grep(a.handle, a.pattern) : { error: "pattern is required" };
+  return { error: `not a blob tool: ${name}` };
+}
+
 // ../agent-os/src/userland/agent.ts
 var DEFAULT_SYSTEM = "You are a capable autonomous agent. Break the task into steps and keep going \u2014 investigate with tools, then act \u2014 until it is fully done; never stop at a plan or a partial result. Verify before answering, then reply concisely.";
 var HARD_MAX = 384;
 var MAX_TOOL_CHARS = 8e3;
 var isMessage = (b) => !!b && typeof b.role === "string";
-var capResult = (s) => s.length > MAX_TOOL_CHARS ? s.slice(0, MAX_TOOL_CHARS) + `
-\u2026[truncated ${s.length - MAX_TOOL_CHARS} chars]` : s;
+var capResult = (s, blobs) => s.length <= MAX_TOOL_CHARS ? s : s.slice(0, MAX_TOOL_CHARS) + `
+\u2026[+${s.length - MAX_TOOL_CHARS} chars \u2014 full result stored as ${blobs.put(s)}; call blob_read(handle, offset=${MAX_TOOL_CHARS}) or blob_grep(handle, pattern) for the rest]`;
 function orderForCache(segs) {
   const lead = [], sums = [], rest = [];
   for (const s of segs) (s.pinned && !s.summary ? lead : s.summary ? sums : rest).push(s);
@@ -5470,7 +5562,7 @@ function unproductive(out) {
   const st = o["status"];
   return typeof st === "number" && (st < 200 || st >= 300);
 }
-async function runTurn(sys, llm, tools2, spec) {
+async function runTurn(sys, llm, tools2, spec, blobs) {
   const ceil = Math.max(1, Math.min(spec.maxSteps ?? HARD_MAX, HARD_MAX));
   const base2 = Math.max(1, spec.baseSteps ?? 16);
   const stallMax = Math.max(1, spec.stallLimit ?? 3);
@@ -5493,6 +5585,7 @@ async function runTurn(sys, llm, tools2, spec) {
     }
     const messages = promptMessages();
     let offer = noTools ? void 0 : spec.tools;
+    if (offer && tools2) offer = [...offer, ...BLOB_TOOLS];
     if (steer && offer && del) offer = offer.filter((t) => !del.withhold.includes(t.name));
     const reply = await sys.read(llm, { messages, tools: offer, maxTokens: spec.maxTokens });
     for (const s of sys.workingSet()) {
@@ -5513,13 +5606,15 @@ async function runTurn(sys, llm, tools2, spec) {
         }
       }
       if (fresh.length) {
-        const outs = await sys.readAll(tools2, fresh.map((f) => f.req));
-        fresh.forEach((f, j) => cache.set(f.key, outs[j]));
+        const viaDevice = fresh.filter((f) => !isBlobTool(f.req.tool));
+        const devOuts = viaDevice.length ? await sys.readAll(tools2, viaDevice.map((f) => f.req)) : [];
+        let di = 0;
+        for (const f of fresh) cache.set(f.key, isBlobTool(f.req.tool) ? execBlobTool(blobs, f.req.tool, f.req.input) : devOuts[di++]);
       }
       let progressed = false;
       for (let i = 0; i < calls.length; i++) {
         const out = cache.get(keys[i]);
-        await sys.remember({ role: "tool", toolCallId: calls[i].id, name: calls[i].name, content: capResult(JSON.stringify(out)) });
+        await sys.remember({ role: "tool", toolCallId: calls[i].id, name: calls[i].name, content: capResult(JSON.stringify(out), blobs) });
         if (ran.has(keys[i]) && !unproductive(out)) progressed = true;
       }
       if (del) {
@@ -5570,7 +5665,7 @@ function reactAgent(spec) {
     const { llm, tools: tools2, parent } = await openDevices(sys);
     await sys.remember({ role: "system", content: spec.system ?? DEFAULT_SYSTEM }, { pin: true });
     await sys.remember({ role: "user", content: spec.task ?? "" }, { pin: true });
-    const r = await runTurn(sys, llm, tools2, spec);
+    const r = await runTurn(sys, llm, tools2, spec, new BlobStore());
     if (parent) await sys.send(parent, { $: "result", answer: r.answer, steps: r.steps });
   } };
 }
@@ -5588,13 +5683,14 @@ function conversationAgent(spec = {}) {
     } else {
       await sys.remember({ role: "system", content: spec.system ?? DEFAULT_SYSTEM }, { pin: true });
     }
+    const blobs = new BlobStore();
     for (; ; ) {
       const msg = await sys.recv();
       const userTurn = { role: "user", content: msg.body.task, ...msg.body.images?.length ? { images: msg.body.images } : {} };
       await sys.remember(userTurn);
       let r;
       try {
-        r = await runTurn(sys, llm, tools2, spec);
+        r = await runTurn(sys, llm, tools2, spec, blobs);
       } catch (e) {
         r = { answer: "", steps: 0, error: e instanceof Error ? e.message : String(e) };
       }
@@ -6037,7 +6133,7 @@ import { homedir } from "node:os";
 import { join as join3 } from "node:path";
 
 // src/skills/loader.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync6, existsSync as existsSync4, statSync as statSync3, openSync, readSync, closeSync } from "node:fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync6, existsSync as existsSync4, statSync as statSync2, openSync, readSync, closeSync } from "node:fs";
 import { join as join2, basename, extname } from "node:path";
 var FM_RE = /^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/;
 var HEAD_BYTES = 8192;
@@ -6083,7 +6179,7 @@ function loadSkillsDir(dir) {
   for (const entry of readdirSync3(dir)) {
     try {
       const p = join2(dir, entry);
-      if (statSync3(p).isDirectory()) {
+      if (statSync2(p).isDirectory()) {
         const md = join2(p, "SKILL.md");
         if (existsSync4(md)) out.push(lazyFromFile(md, entry));
       } else if (extname(entry) === ".md") out.push(lazyFromFile(p, basename(entry, ".md")));
@@ -9910,7 +10006,7 @@ function codingReflect(plan) {
 }
 
 // src/agent/session.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync4, readdirSync as readdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync5, statSync as statSync4, renameSync as renameSync2, unlinkSync as unlinkSync3 } from "node:fs";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4, readdirSync as readdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync5, statSync as statSync3, renameSync as renameSync2, unlinkSync as unlinkSync3 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join7 } from "node:path";
 var oneLine = (s) => typeof s === "string" ? s.replace(/\s+/g, " ").trim() : "";
@@ -9968,7 +10064,7 @@ function sessionIdsByRecency() {
   if (!existsSync8(dir)) return [];
   return readdirSync5(dir).filter((f) => f.endsWith(".json")).map((f) => {
     try {
-      return { id: f.slice(0, -5), mt: statSync4(join7(dir, f)).mtimeMs };
+      return { id: f.slice(0, -5), mt: statSync3(join7(dir, f)).mtimeMs };
     } catch {
       return { id: f.slice(0, -5), mt: 0 };
     }
@@ -9982,12 +10078,12 @@ function loadSessionMeta(id) {
 // src/ui/app.ts
 import { resolve as resolve3, join as join11 } from "node:path";
 import { homedir as homedir6, tmpdir as tmpdir3 } from "node:os";
-import { statSync as statSync6, readFileSync as readFileSync14, unlinkSync as unlinkSync6 } from "node:fs";
+import { statSync as statSync5, readFileSync as readFileSync14, unlinkSync as unlinkSync6 } from "node:fs";
 
 // package.json
 var package_default = {
   name: "@guangnao/agent-cli",
-  version: "1.1.6",
+  version: "1.1.7",
   description: "AgentOS terminal CLI \u2014 drive a real LLM agent on the microkernel; strongest-UX shell, advanced agent core",
   type: "module",
   bin: {
@@ -10145,7 +10241,7 @@ var modeLabel = (m) => m === "auto" ? "auto" : m === "acceptEdits" ? "auto-edits
 
 // src/ui/clipboard.ts
 import { execFile } from "node:child_process";
-import { existsSync as existsSync10, readFileSync as readFileSync12, statSync as statSync5, unlinkSync as unlinkSync5 } from "node:fs";
+import { existsSync as existsSync10, readFileSync as readFileSync12, statSync as statSync4, unlinkSync as unlinkSync5 } from "node:fs";
 import { tmpdir } from "node:os";
 import { join as join9 } from "node:path";
 var MACOS_JXA = `(function(){
@@ -10249,7 +10345,7 @@ async function shrinkImage(src) {
     const maxEdge = dims ? Math.max(dims.w, dims.h) : Infinity;
     let origBytes = Infinity;
     try {
-      origBytes = statSync5(src).size;
+      origBytes = statSync4(src).size;
     } catch {
     }
     if (maxEdge <= MAX_EDGE && origBytes <= PASSTHROUGH_BYTES) return fallback;
@@ -10265,7 +10361,7 @@ async function shrinkImage(src) {
     await sips([...resize, "-s", "format", "png", src, "--out", pngOut]);
     let pngBytes = Infinity;
     try {
-      pngBytes = statSync5(pngOut).size;
+      pngBytes = statSync4(pngOut).size;
     } catch {
     }
     if (pngBytes > PNG_TO_JPEG_BYTES) {
@@ -11954,7 +12050,7 @@ ${c.done("\u2713")} ${c.dim("Saved connection cleared. Run ")}${c.bold("agentos"
   static dirOk(d) {
     if (!d) return false;
     try {
-      return statSync6(d).isDirectory();
+      return statSync5(d).isDirectory();
     } catch {
       return false;
     }
@@ -11982,7 +12078,7 @@ ${c.dim("set: /cwd <path>  \xB7  global default: /cwd -g <path>")}`);
     const expanded = path === "~" || path.startsWith("~/") ? homedir6() + path.slice(1) : path;
     const abs = resolve3(process.env["AGENTOS_CWD"] || process.cwd(), expanded);
     try {
-      if (!statSync6(abs).isDirectory()) {
+      if (!statSync5(abs).isDirectory()) {
         this.note(c.fail(`not a directory: ${abs}`));
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guangnao/agent-cli",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "AgentOS terminal CLI — drive a real LLM agent on the microkernel; strongest-UX shell, advanced agent core",
   "type": "module",
   "bin": {