@livx.cc/agentx 0.99.72 → 0.99.73

package/dist/index.js

@@ -18,8 +18,192 @@ var init_logging = __esm({
   }
 });
 
+// src/imageWire.ts
+import { readFileSync, writeFileSync, statSync, mkdtempSync, rmSync } from "fs";
+import { spawnSync } from "child_process";
+import { createHash } from "crypto";
+import { tmpdir } from "os";
+import { join } from "path";
+import { PNG } from "pngjs";
+import jpeg from "jpeg-js";
+function imageSize(b) {
+  const u16 = (i) => b[i] << 8 | b[i + 1];
+  const le16 = (i) => b[i] | b[i + 1] << 8;
+  const u32 = (i) => (b[i] << 24 >>> 0) + (b[i + 1] << 16) + (b[i + 2] << 8) + b[i + 3];
+  if (b[0] === 137 && b[1] === 80 && b.length >= 24) return { w: u32(16), h: u32(20) };
+  if (b[0] === 71 && b[1] === 73 && b.length >= 10) return { w: le16(6), h: le16(8) };
+  if (b[0] === 255 && b[1] === 216) {
+    for (let i = 2; i + 9 < b.length; ) {
+      if (b[i] !== 255) return null;
+      const m = b[i + 1];
+      if (m >= 192 && m <= 207 && m !== 196 && m !== 200 && m !== 204) return { w: u16(i + 7), h: u16(i + 5) };
+      i += 2 + u16(i + 2);
+    }
+    return null;
+  }
+  if (b.length >= 30 && String.fromCharCode(...b.subarray(8, 12)) === "WEBP") {
+    const kind = String.fromCharCode(...b.subarray(12, 16));
+    if (kind === "VP8X") return { w: 1 + (b[24] | b[25] << 8 | b[26] << 16), h: 1 + (b[27] | b[28] << 8 | b[29] << 16) };
+    if (kind === "VP8 ") return { w: le16(26) & 16383, h: le16(28) & 16383 };
+    if (kind === "VP8L") {
+      const v = b[21] | b[22] << 8 | b[23] << 16 | b[24] << 24;
+      return { w: (v & 16383) + 1, h: (v >> 14 & 16383) + 1 };
+    }
+  }
+  return null;
+}
+function imageNote(what, bytes, dims, why) {
+  return `[image ${what}${dims ? `, ${dims.w}x${dims.h}` : ""}, ${fmtBytes(bytes)} \u2014 not sent: ${why}]`;
+}
+function downscaleJs(buf, maxSide) {
+  let src;
+  try {
+    if (buf[0] === 137 && buf[1] === 80) src = PNG.sync.read(buf);
+    else if (buf[0] === 255 && buf[1] === 216) src = jpeg.decode(buf, { useTArray: true, maxMemoryUsageInMB: 1024 });
+    else return null;
+  } catch (e) {
+    log2.warn("pure-JS image decode failed", e);
+    return null;
+  }
+  const { width: sw, height: sh, data: s } = src;
+  const k = Math.min(1, maxSide / Math.max(sw, sh));
+  const w = Math.max(1, Math.round(sw * k)), h = Math.max(1, Math.round(sh * k));
+  const d = new Uint8Array(w * h * 4);
+  for (let y = 0; y < h; y++) {
+    const y0 = Math.floor(y * sh / h), y1 = Math.max(y0 + 1, Math.floor((y + 1) * sh / h));
+    for (let x = 0; x < w; x++) {
+      const x0 = Math.floor(x * sw / w), x1 = Math.max(x0 + 1, Math.floor((x + 1) * sw / w));
+      let r = 0, g = 0, b = 0, a = 0;
+      for (let yy = y0; yy < y1; yy++) for (let xx = x0; xx < x1; xx++) {
+        const i = (yy * sw + xx) * 4, al = s[i + 3];
+        r += s[i] * al;
+        g += s[i + 1] * al;
+        b += s[i + 2] * al;
+        a += al;
+      }
+      const o = (y * w + x) * 4, n = (y1 - y0) * (x1 - x0), bg = 255 * (n - a / 255);
+      d[o] = (r / 255 + bg) / n;
+      d[o + 1] = (g / 255 + bg) / n;
+      d[o + 2] = (b / 255 + bg) / n;
+      d[o + 3] = 255;
+    }
+  }
+  let out = Buffer.alloc(0);
+  for (const q of [80, 60, 40]) {
+    out = Buffer.from(jpeg.encode({ width: w, height: h, data: d }, q).data);
+    if (out.length <= IMAGE_MAX_BYTES) break;
+  }
+  return out;
+}
+function downscale(path, maxSide) {
+  const dir = mkdtempSync(join(tmpdir(), "agentx-img-"));
+  const out = join(dir, "x.jpg");
+  try {
+    const tries = [
+      ["sips", ["-Z", String(maxSide), "-s", "format", "jpeg", "-s", "formatOptions", "80", path, "--out", out]],
+      ["magick", [path, "-resize", `${maxSide}x${maxSide}>`, "-quality", "80", out]],
+      ["convert", [path, "-resize", `${maxSide}x${maxSide}>`, "-quality", "80", out]]
+    ];
+    for (const [cmd, args] of tries) {
+      const r = spawnSync(cmd, args, { stdio: "ignore", timeout: 15e3 });
+      if (r.status !== 0) continue;
+      try {
+        const o = readFileSync(out);
+        if (o.length <= IMAGE_MAX_BYTES) return o;
+        break;
+      } catch {
+      }
+    }
+    const js = downscaleJs(readFileSync(path), maxSide);
+    if (!js) log2.warn(`could not downscale ${path} (tried sips/magick/convert/pure JS)`);
+    return js;
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
+function remember(id, w) {
+  cache.delete(id);
+  cache.set(id, w);
+  if (cache.size > CACHE_MAX) cache.delete(cache.keys().next().value);
+  return w;
+}
+function wireOf(key, buf, mime, label, file) {
+  const dims = imageSize(buf);
+  const fits = buf.length <= IMAGE_MAX_BYTES && (!dims || Math.max(dims.w, dims.h) <= IMAGE_MAX_SIDE);
+  let small = null;
+  if (!fits) {
+    if (file) small = downscale(file, IMAGE_MAX_SIDE);
+    else {
+      const dir = mkdtempSync(join(tmpdir(), "agentx-img-in-"));
+      try {
+        const f = join(dir, `in.${mime.split("/")[1] || "img"}`);
+        writeFileSync(f, buf);
+        small = downscale(f, IMAGE_MAX_SIDE);
+      } finally {
+        rmSync(dir, { recursive: true, force: true });
+      }
+    }
+  }
+  const url = fits ? `data:${mime};base64,${buf.toString("base64")}` : small && small.length <= IMAGE_MAX_BYTES ? `data:image/jpeg;base64,${small.toString("base64")}` : null;
+  return { key, url, note: imageNote(label, buf.length, dims, url ? "this model can't see images" : "too large and it couldn't be downscaled") };
+}
+function imageForWire(path, mime, vision) {
+  let st;
+  try {
+    st = statSync(path);
+  } catch (e) {
+    log2.warn(`image unreadable: ${path}`, e);
+    return null;
+  }
+  const key = `${st.mtimeMs}:${st.size}`;
+  let hit = cache.get(path);
+  if (!hit || hit.key !== key) hit = remember(path, wireOf(key, readFileSync(path), mime, path, path));
+  return vision && hit.url ? { url: hit.url } : { note: hit.note };
+}
+function inlineImageForWire(url, vision) {
+  const comma = url.indexOf(",");
+  const mime = url.slice(5, url.indexOf(";"));
+  if (vision && url.length < 3e5) {
+    const b64 = url.slice(comma + 1);
+    const dims = imageSize(Buffer.from(b64.slice(0, 4096), "base64")) ?? imageSize(Buffer.from(b64, "base64"));
+    if (!dims || Math.max(dims.w, dims.h) <= IMAGE_MAX_SIDE) return { url };
+  }
+  const id = `inline:${createHash("sha1").update(url).digest("base64")}`;
+  let hit = cache.get(id);
+  if (!hit) {
+    const buf = Buffer.from(url.slice(comma + 1), "base64");
+    hit = remember(id, wireOf(id, buf, mime, `(${mime})`));
+  }
+  return vision && hit.url ? { url: hit.url } : { note: hit.note };
+}
+function imageWireBytes(path, mime, vision) {
+  const r = imageForWire(path, mime, vision);
+  return !r ? 0 : "url" in r ? r.url.length : r.note.length;
+}
+function scrubBase64Text(s) {
+  if (s.length < 2e3) return s;
+  const out = s.replace(DATA_URI, (m) => imageNote(m.slice(5, m.indexOf(";")), Math.floor((m.length - m.indexOf(",") - 1) * 3 / 4), null, "base64 is never sent as text")).replace(B64_RUN, (m) => !/[+/]/.test(m) || !/\d/.test(m) ? m : `[base64 data, ${fmtBytes(Math.floor(m.length * 3 / 4))} \u2014 not sent: base64 is never sent as text]`);
+  if (out !== s) log2.warn(`scrubbed base64 from request text (${s.length} \u2192 ${out.length} chars)`);
+  return out;
+}
+var log2, IMAGE_MAX_SIDE, IMAGE_MAX_BYTES, fmtBytes, cache, CACHE_MAX, DATA_URI, B64_RUN;
+var init_imageWire = __esm({
+  "src/imageWire.ts"() {
+    "use strict";
+    init_logging();
+    log2 = forComponent("imageWire");
+    IMAGE_MAX_SIDE = 1568;
+    IMAGE_MAX_BYTES = 1e6;
+    fmtBytes = (n) => n >= 1e6 ? `${(n / 1e6).toFixed(1)} MB` : n >= 1e3 ? `${Math.round(n / 1e3)} KB` : `${n} B`;
+    cache = /* @__PURE__ */ new Map();
+    CACHE_MAX = 8;
+    DATA_URI = /data:image\/[\w.+-]+;base64,[A-Za-z0-9+/=]+/g;
+    B64_RUN = /[A-Za-z0-9+/=]{2000,}/g;
+  }
+});
+
 // src/llm.ts
-import { readFileSync, statSync, realpathSync } from "fs";
+import { statSync as statSync2, realpathSync } from "fs";
 import { resolve, sep } from "path";
 import { randomBytes } from "crypto";
 function passesBackReasoning(model) {
@@ -76,9 +260,9 @@ function mintImageRef(path, mime) {
   const token = randomBytes(16).toString("hex");
   let bytes = 0;
   try {
-    bytes = Math.ceil(statSync(path).size * 4 / 3);
+    bytes = Math.ceil(statSync2(path).size * 4 / 3);
   } catch (e) {
-    log2.warn(`image ref stat failed, weighing as 0: ${path}`, e);
+    log3.warn(`image ref stat failed, weighing as 0: ${path}`, e);
   }
   refRegistry.set(token, { mime, path, bytes });
   while (refRegistry.size > REF_REGISTRY_MAX) refRegistry.delete(refRegistry.keys().next().value);
@@ -94,7 +278,7 @@ function parseImageRef(url) {
   const parts = refUrlParts(url);
   const ref = parts && refRegistry.get(parts.token);
   if (!ref) {
-    log2.debug("image ref not in registry \u2014 treating as non-image text");
+    log3.debug("image ref not in registry \u2014 treating as non-image text");
     return null;
   }
   return ref;
@@ -113,7 +297,7 @@ function remintImageRefs(messages, roots) {
     try {
       allowed.push(realpathSync(resolve(r)));
     } catch (e) {
-      log2.debug(`image-ref root unavailable: ${r}`, e);
+      log3.debug(`image-ref root unavailable: ${r}`, e);
     }
   }
   if (allowed.length === 0) return messages;
@@ -130,11 +314,11 @@ function remintImageRefs(messages, roots) {
       try {
         real = realpathSync(f.path);
       } catch (e) {
-        log2.warn(`resumed image ref unreadable, will stub: ${f.path}`, e);
+        log3.warn(`resumed image ref unreadable, will stub: ${f.path}`, e);
         return p;
       }
       if (!inside(real)) {
-        log2.warn(`resumed image ref outside the allowed roots, will stub: ${f.path} -> ${real}`);
+        log3.warn(`resumed image ref outside the allowed roots, will stub: ${f.path} -> ${real}`);
         return p;
       }
       touched = true;
@@ -161,7 +345,7 @@ function toolImageRef(content) {
   try {
     return parseImageRef(JSON.parse(content).imageRef);
   } catch (e) {
-    log2.debug("bad imageRef tool result", e);
+    log3.debug("bad imageRef tool result", e);
     return null;
   }
 }
@@ -189,32 +373,41 @@ function imageWindows(messages, keepRecent) {
   const k = Math.max(0, keepRecent);
   return /* @__PURE__ */ new Set([...attach.slice(Math.max(0, attach.length - k)), ...tool.slice(Math.max(0, tool.length - k))]);
 }
-function expandImagesForSend(messages, keepRecent = 1, stub = IMAGE_ELIDE_STUB) {
+function expandImagesForSend(messages, keepRecent = 1, stub = IMAGE_ELIDE_STUB, vision = true) {
   if (!messages.some(bearsImage)) return messages;
   const keep = imageWindows(messages, keepRecent);
   let changed = false;
   const out = messages.map((m, i) => {
-    const content = keep.has(i) ? expandContent(m.content, stub) : stripContent(m.content, stub);
+    const content = keep.has(i) ? expandContent(m.content, vision) : stripContent(m.content, stub);
     if (content === m.content) return m;
     changed = true;
     return { ...m, content };
   });
   return changed ? out : messages;
 }
-function sendBytes(messages, keepRecent = 1, stub = IMAGE_ELIDE_STUB) {
+function sendBytes(messages, keepRecent = 1, vision = true, stub = IMAGE_ELIDE_STUB) {
   let n = 0;
-  for (const b of sendBytesPer(messages, keepRecent, stub)) n += b;
+  for (const b of sendBytesPer(messages, keepRecent, vision, stub)) n += b;
   return n;
 }
-function sendBytesPer(messages, keepRecent = 1, stub = IMAGE_ELIDE_STUB) {
+function sendBytesPer(messages, keepRecent = 1, vision = true, stub = IMAGE_ELIDE_STUB) {
   const keep = messages.some(bearsImage) ? imageWindows(messages, keepRecent) : null;
-  return messages.map((m, i) => wireBytes(m.content, keep == null || keep.has(i), stub) + (m.tool_calls ? JSON.stringify(m.tool_calls).length : 0) + (m.reasoning_content?.length ?? 0));
+  return messages.map((m, i) => wireBytes(m.content, keep == null || keep.has(i), vision, stub) + (m.tool_calls ? JSON.stringify(m.tool_calls).length : 0) + (m.reasoning_content?.length ?? 0));
 }
-function wireBytes(content, kept, stub) {
+function wireBytes(content, kept, vision, stub) {
   const tool = toolImageRef(content);
-  if (tool) return kept ? tool.bytes : stub.length;
+  if (tool) return kept ? imageWireBytes(tool.path, tool.mime, vision) || stub.length : stub.length;
   if (content == null || typeof content === "string") return contentBytes(content);
-  if (kept) return contentBytes(content);
+  if (kept) {
+    let n2 = 0;
+    for (const p of content) {
+      const url = p.type === "image_url" ? p.image_url?.url ?? "" : "";
+      const ref = url ? parseImageRef(url) : null;
+      const inline = url.startsWith("data:") ? inlineImageForWire(url, vision) : null;
+      n2 += ref ? imageWireBytes(ref.path, ref.mime, vision) : inline ? ("url" in inline ? inline.url : inline.note).length : contentBytes([p]);
+    }
+    return n2;
+  }
   let n = 0;
   for (const p of content) {
     if (p.type === "text") {
@@ -226,31 +419,70 @@ function wireBytes(content, kept, stub) {
   }
   return n;
 }
-function readRefDataUrl(ref) {
-  try {
-    return `data:${ref.mime};base64,${readFileSync(ref.path).toString("base64")}`;
-  } catch (e) {
-    log2.warn(`image ref unreadable, sending stub instead: ${ref.path}`, e);
-    return null;
-  }
-}
-function expandContent(content, stub) {
+function expandContent(content, vision) {
   const tool = toolImageRef(content);
   if (tool) {
-    const url = readRefDataUrl(tool);
-    return url ? JSON.stringify({ dataUrl: url, image: tool.path }) : stub;
+    const w = imageForWire(tool.path, tool.mime, vision);
+    if (!w) return IMAGE_ELIDE_STUB;
+    return "url" in w ? [{ type: "text", text: `image: ${tool.path}` }, imagePart(w.url)] : w.note;
   }
   if (typeof content === "string") return content;
   let changed = false;
   const out = content.map((p) => {
-    if (p.type !== "image_url" || !isImageRefUrl(p.image_url?.url)) return p;
+    if (p.type !== "image_url") return p;
+    const url = p.image_url?.url ?? "";
+    if (url.startsWith("data:")) {
+      const w2 = inlineImageForWire(url, vision);
+      if ("url" in w2 && w2.url === url) return p;
+      changed = true;
+      return "url" in w2 ? imagePart(w2.url) : { type: "text", text: w2.note };
+    }
+    if (!isImageRefUrl(url)) return p;
     changed = true;
-    const ref = parseImageRef(p.image_url?.url);
-    const url = ref && readRefDataUrl(ref);
-    return url ? imagePart(url) : { type: "text", text: stub };
+    const ref = parseImageRef(url);
+    if (!ref) return { type: "text", text: IMAGE_ELIDE_STUB };
+    const w = imageForWire(ref.path, ref.mime, vision);
+    if (!w) return { type: "text", text: IMAGE_ELIDE_STUB };
+    return "url" in w ? imagePart(w.url) : { type: "text", text: w.note };
   });
   return changed ? out : content;
 }
+function hoistToolImages(messages) {
+  if (!messages.some((m) => m.role === "tool" && Array.isArray(m.content) && m.content.some((p) => p.type === "image_url"))) return messages;
+  const out = [];
+  let pending = [];
+  const flush = () => {
+    if (pending.length) out.push({ role: "user", content: [{ type: "text", text: "Image output from the tool call above:" }, ...pending] });
+    pending = [];
+  };
+  for (const m of messages) {
+    if (m.role !== "tool") flush();
+    if (m.role === "tool" && Array.isArray(m.content) && m.content.some((p) => p.type === "image_url")) {
+      const imgs = m.content.filter((p) => p.type === "image_url");
+      pending.push(...imgs);
+      const text = m.content.filter((p) => p.type === "text").map((p) => p.text).join("\n");
+      out.push({ ...m, content: text || `[${imgs.length} image(s) returned; shown below]` });
+    } else out.push(m);
+  }
+  flush();
+  return out;
+}
+function scrubBase64(messages) {
+  let changed = false;
+  const out = messages.map((m) => {
+    const c = m.content;
+    let next = c;
+    if (typeof c === "string") next = scrubBase64Text(c);
+    else if (Array.isArray(c)) {
+      const parts = c.map((p) => p.type === "text" && p.text ? { ...p, text: scrubBase64Text(p.text) } : p);
+      if (parts.some((p, i) => p.text !== c[i].text)) next = parts;
+    }
+    if (next === c) return m;
+    changed = true;
+    return { ...m, content: next };
+  });
+  return changed ? out : messages;
+}
 function stripContent(content, stub) {
   if (toolImageRef(content)) return stub;
   if (typeof content === "string") return content;
@@ -273,12 +505,13 @@ function endsOnAnnouncedAction(text) {
   if (PROGRESSIVE.test(last)) return true;
   return clauses(last).some((c) => !NEXT_STEP.test(c) && !SIGN_OFF.test(c) && COMMITMENT.test(c));
 }
-var log2, p_sep, IMAGE_ELIDE_STUB, IMAGE_REF_SCHEME, REF_REGISTRY_MAX, refRegistry, isImageRefUrl, bearsImage, COMMITMENT, PROGRESSIVE, NEXT_STEP, SIGN_OFF;
+var log3, p_sep, IMAGE_ELIDE_STUB, IMAGE_REF_SCHEME, REF_REGISTRY_MAX, refRegistry, isImageRefUrl, bearsImage, COMMITMENT, PROGRESSIVE, NEXT_STEP, SIGN_OFF;
 var init_llm = __esm({
   "src/llm.ts"() {
     "use strict";
     init_logging();
-    log2 = forComponent("llm");
+    init_imageWire();
+    log3 = forComponent("llm");
     p_sep = (parts) => parts.length > 1 ? "\n" : "";
     IMAGE_ELIDE_STUB = "[image elided \u2014 re-attach @path or /paste to view again]";
     IMAGE_REF_SCHEME = "agentx-image:";
@@ -965,7 +1198,7 @@ function makeWebFetchTool(options = {}) {
 
 ${capped}`;
       } catch (e) {
-        log3.debug(`WebFetch ${u} failed`, e);
+        log4.debug(`WebFetch ${u} failed`, e);
         return `Error fetching ${u}: ${e?.name === "AbortError" ? `timed out after ${timeoutMs}ms` : e?.message ?? e}`;
       } finally {
         clearTimeout(timer);
@@ -1089,7 +1322,7 @@ function makeWebSearchTool(options = {}) {
         if (!res.ok) return `Error: search returned ${res.status} ${res.statusText}`;
         return formatHits(parseDdgHtml(await res.text(), maxResults));
       } catch (e) {
-        log3.debug("WebSearch failed", e);
+        log4.debug("WebSearch failed", e);
         return `Error searching: ${e?.name === "AbortError" ? `timed out after ${timeoutMs}ms` : e?.message ?? e}`;
       } finally {
         clearTimeout(timer);
@@ -1100,12 +1333,12 @@ function makeWebSearchTool(options = {}) {
 function makeWebSearchAnthropicTool(opts = {}) {
   return makeWebSearchTool({ provider: "anthropic", name: "WebSearchAnthropic", description: ANTHROPIC_SEARCH_DESC, anthropicApiKey: opts.anthropicApiKey, model: opts.model });
 }
-var log3, _dnsLookup, webFetchTool, webSearchTool, ANTHROPIC_SEARCH_DESC, webSearchAnthropicTool;
+var log4, _dnsLookup, webFetchTool, webSearchTool, ANTHROPIC_SEARCH_DESC, webSearchAnthropicTool;
 var init_tools_web = __esm({
   "src/tools.web.ts"() {
     "use strict";
     init_logging();
-    log3 = forComponent("web");
+    log4 = forComponent("web");
     webFetchTool = makeWebFetchTool();
     webSearchTool = makeWebSearchTool();
     ANTHROPIC_SEARCH_DESC = "High-quality web search via Anthropic's native search index. Returns concise, sourced findings \u2014 one claim per line, each with its source URL. Prefer this over WebSearch when accuracy and citations matter; it is slower (~3\u20138s) and bills the Anthropic API account per call (one cheap-model turn + search fee).";
@@ -1325,7 +1558,7 @@ function realPathOf(fs, path) {
   try {
     return fs.realPath(path);
   } catch (e) {
-    log4.debug(`realPath unavailable for ${path} \u2014 inlining image bytes instead`, e);
+    log5.debug(`realPath unavailable for ${path} \u2014 inlining image bytes instead`, e);
     return null;
   }
 }
@@ -1377,7 +1610,7 @@ function toolsByName(names, available) {
     return t;
   });
 }
-var log4, numberLines, bashTool, IMG_MIME, readTool, editTool;
+var log5, numberLines, bashTool, IMG_MIME, readTool, editTool;
 var init_tools = __esm({
   "src/tools.ts"() {
     "use strict";
@@ -1388,7 +1621,7 @@ var init_tools = __esm({
     init_tools_web();
     init_OverlayFilesystem();
     init_redact();
-    log4 = forComponent("tools");
+    log5 = forComponent("tools");
     numberLines = (content, offset = 0, limit) => {
       const lines = content.split("\n");
       const start = Math.max(0, offset);
@@ -1570,12 +1803,12 @@ ${tail || "(no output)"}`;
     }
   ];
 }
-var log5, JobRegistryOptions, secs, JobRegistry, SandboxJobRegistry, NO_JOB, describe;
+var log6, JobRegistryOptions, secs, JobRegistry, SandboxJobRegistry, NO_JOB, describe;
 var init_tools_jobs = __esm({
   "src/tools.jobs.ts"() {
     "use strict";
     init_logging();
-    log5 = forComponent("jobs");
+    log6 = forComponent("jobs");
     JobRegistryOptions = class {
       /** Tail buffer cap per job (chars). */
       maxBuffer = 256 * 1024;
@@ -1754,7 +1987,7 @@ var init_tools_jobs = __esm({
           try {
             onExit({ id: job.id, kind: job.kind, label: job.label, status, reason: job.reason, tail: job.buf.slice(-4e3), result });
           } catch (e) {
-            log5.warn(`job onExit handler threw for ${job.id}: ${e}`);
+            log6.warn(`job onExit handler threw for ${job.id}: ${e}`);
           }
         }
       }
@@ -1808,7 +2041,7 @@ var init_tools_jobs = __esm({
           try {
             j.onKill?.(reason);
           } catch (e) {
-            log5.warn(`onKill for ${id} threw: ${e}`);
+            log6.warn(`onKill for ${id} threw: ${e}`);
           }
         }
         return true;
@@ -1855,7 +2088,7 @@ var init_tools_jobs = __esm({
           try {
             cpu = await j.cpuTime();
           } catch (e) {
-            log5.debug(`cpu probe for ${j.id} failed: ${e}`);
+            log6.debug(`cpu probe for ${j.id} failed: ${e}`);
           }
           if (cpu != null && j.lastCpu != null && cpu > j.lastCpu) j.lastActivityAt = this.options.now();
           const prev = j.lastCpu;
@@ -1863,7 +2096,7 @@ var init_tools_jobs = __esm({
           const verdict = this.verdict(j, now3);
           if (!verdict?.idle || j.status !== "running") continue;
           if (cpu == null) {
-            log5.debug(`not reaping ${j.id}: ${verdict.reason} but CPU unknown`);
+            log6.debug(`not reaping ${j.id}: ${verdict.reason} but CPU unknown`);
             continue;
           }
           if (prev == null) continue;
@@ -1877,7 +2110,7 @@ var init_tools_jobs = __esm({
         return null;
       }
       stuck(j, reason, now3) {
-        log5.warn(`reaping ${j.id} (${j.kind} "${j.label}"): ${reason} \u2014 age ${secs(now3 - j.startedAt)}, last activity ${secs(now3 - j.lastActivityAt)} ago, idleMs=${j.idleMs}, hardCapMs=${j.hardCapMs}, ${j.bytes} byte(s) output`);
+        log6.warn(`reaping ${j.id} (${j.kind} "${j.label}"): ${reason} \u2014 age ${secs(now3 - j.startedAt)}, last activity ${secs(now3 - j.lastActivityAt)} ago, idleMs=${j.idleMs}, hardCapMs=${j.hardCapMs}, ${j.bytes} byte(s) output`);
         if (j.onKill) j.notify = true;
         this.kill(j.id, reason);
       }
@@ -1891,7 +2124,7 @@ var init_tools_jobs = __esm({
             this.timer = void 0;
             return;
           }
-          void this.sweep().catch((e) => log5.warn(`job sweep failed: ${e}`));
+          void this.sweep().catch((e) => log6.warn(`job sweep failed: ${e}`));
         }, this.options.sweepMs);
         this.timer.unref?.();
       }
@@ -2402,7 +2635,7 @@ async function psGroupCpuSeconds(pgid) {
     const out = await new Promise((res, rej) => execFile("ps", ["-A", "-o", "pid=,ppid=,pgid=,time="], { timeout: 5e3, env: { ...process.env, LC_ALL: "C" } }, (e, so) => e ? rej(e) : res(String(so))));
     return sumTreeCpu(out, pgid);
   } catch (e) {
-    log8.debug(`ps cpu probe failed for group ${pgid}: ${e}`);
+    log9.debug(`ps cpu probe failed for group ${pgid}: ${e}`);
     return void 0;
   }
 }
@@ -2550,7 +2783,7 @@ function makeRealShellTool(options) {
           proc.stderr?.on("data", collect);
           proc.on("error", (err) => {
             if (err?.name === "AbortError" || ctl.signal.aborted) return finish(reasonFor(timedOut, timeoutMs, clean(out)));
-            log8.debug("shell spawn error", err);
+            log9.debug("shell spawn error", err);
             finish(`[exit 1] ${err?.message ?? err}${out ? "\n" + clean(out) : ""}`);
           });
           proc.on("close", (code) => {
@@ -2623,7 +2856,7 @@ ${clean(out) || "(no output yet)"}`;
     }
   ];
 }
-var log8, clean, DETACHED, SECRET_ENV_RE, _spawn, ShellJobRegistry, shellStatus, NO_JOB2;
+var log9, clean, DETACHED, SECRET_ENV_RE, _spawn, ShellJobRegistry, shellStatus, NO_JOB2;
 var init_tools_shell = __esm({
   "src/tools.shell.ts"() {
     "use strict";
@@ -2632,7 +2865,7 @@ var init_tools_shell = __esm({
     init_logging();
     init_shell_sandbox();
     init_tools_jobs();
-    log8 = forComponent("shell");
+    log9 = forComponent("shell");
     clean = (s) => truncateOutput(redactSecrets(s.replace(/\n+$/, "")));
     DETACHED = { stdio: ["ignore", "pipe", "pipe"], detached: true };
     SECRET_ENV_RE = /(_API_KEY|_TOKEN|_SECRET|_PASSWORD|_PRIVATE_KEY|^AWS_|^GITHUB_TOKEN$|^OPENAI_|^ANTHROPIC_|^GOOGLE_|^GEMINI_|^GROQ_|^NPM_TOKEN$)/i;
@@ -3409,8 +3642,8 @@ ${sections.join("\n\n---\n\n")}`;
 
 // src/subagent.ts
 init_tools();
-import { mkdirSync as mkdirSync2, writeFileSync } from "fs";
-import { join as join3 } from "path";
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
 
 // src/models.ts
 var MODEL_ALIASES = {
@@ -3607,9 +3840,9 @@ function composeHooks(...list) {
 init_OverlayFilesystem();
 
 // src/worktree.ts
-import { spawnSync } from "child_process";
-import { symlinkSync, mkdirSync, statSync as statSync2, readFileSync as readFileSync2, rmSync } from "fs";
-import { join } from "path";
+import { spawnSync as spawnSync2 } from "child_process";
+import { symlinkSync, mkdirSync, statSync as statSync3, readFileSync as readFileSync3, rmSync as rmSync2 } from "fs";
+import { join as join2 } from "path";
 var VALID_SEGMENT = /^[a-zA-Z0-9._-]+$/;
 var MAX_SLUG_LENGTH = 64;
 var GIT_NO_PROMPT_ENV = { GIT_TERMINAL_PROMPT: "0", GIT_ASKPASS: "" };
@@ -3628,13 +3861,13 @@ function worktreeBranchName(slug2) {
   return `worktree-${flattenSlug(slug2)}`;
 }
 function worktreesDir(repoRoot) {
-  return join(repoRoot, ".claude", "worktrees");
+  return join2(repoRoot, ".claude", "worktrees");
 }
 function worktreePathFor(repoRoot, slug2) {
-  return join(worktreesDir(repoRoot), flattenSlug(slug2));
+  return join2(worktreesDir(repoRoot), flattenSlug(slug2));
 }
 function git(args, cwd) {
-  const r = spawnSync("git", args, {
+  const r = spawnSync2("git", args, {
     cwd,
     stdio: ["ignore", "pipe", "pipe"],
     env: { ...process.env, ...GIT_NO_PROMPT_ENV }
@@ -3647,16 +3880,16 @@ function findGitRoot(from) {
 }
 function readWorktreeHead(worktreePath) {
   try {
-    const gitFile = readFileSync2(join(worktreePath, ".git"), "utf-8").trim();
+    const gitFile = readFileSync3(join2(worktreePath, ".git"), "utf-8").trim();
     const m = gitFile.match(/^gitdir:\s*(.+)$/);
     if (!m) return null;
-    const headPath = join(m[1], "HEAD");
-    const head = readFileSync2(headPath, "utf-8").trim();
+    const headPath = join2(m[1], "HEAD");
+    const head = readFileSync3(headPath, "utf-8").trim();
     const refMatch = head.match(/^ref:\s*(.+)$/);
     if (!refMatch) return head.length === 40 ? head : null;
-    const refPath = join(m[1], "..", refMatch[1]);
+    const refPath = join2(m[1], "..", refMatch[1]);
     try {
-      return readFileSync2(refPath, "utf-8").trim();
+      return readFileSync3(refPath, "utf-8").trim();
     } catch {
     }
     const r = git(["rev-parse", "HEAD"], worktreePath);
@@ -3689,10 +3922,10 @@ function getOrCreateWorktree(repoRoot, slug2) {
 }
 function symlinkDirs(repoRoot, worktreePath, dirs) {
   for (const dir of dirs) {
-    const src = join(repoRoot, dir);
-    const dst = join(worktreePath, dir);
+    const src = join2(repoRoot, dir);
+    const dst = join2(worktreePath, dir);
     try {
-      statSync2(src);
+      statSync3(src);
     } catch {
       continue;
     }
@@ -3708,7 +3941,7 @@ function cleanupWorktree(repoRoot, slug2, opts) {
   const worktreePath = worktreePathFor(repoRoot, slug2);
   const branch = worktreeBranchName(slug2);
   try {
-    statSync2(worktreePath);
+    statSync3(worktreePath);
   } catch {
     return { removed: false, reason: "not found" };
   }
@@ -3718,7 +3951,7 @@ function cleanupWorktree(repoRoot, slug2, opts) {
   }
   for (const dir of ["node_modules", ".bun"]) {
     try {
-      rmSync(join(worktreePath, dir));
+      rmSync2(join2(worktreePath, dir));
     } catch {
     }
   }
@@ -3758,7 +3991,7 @@ function exitWorktree() {
 // src/subagent.ts
 init_NodeDiskFilesystem();
 init_logging();
-var log6 = forComponent("subagent");
+var log7 = forComponent("subagent");
 async function boundedPool(items, limit, fn) {
   const out = new Array(items.length);
   let next = 0;
@@ -3830,17 +4063,17 @@ function traceFileFor(dir, label, depth) {
   try {
     mkdirSync2(dir, { recursive: true });
     const id = `${Date.now().toString(36)}-${(traceSeq++).toString(36)}`;
-    return join3(dir, `${id}-d${depth}-${sanitizeSlug(label) || "sub"}.json`);
+    return join4(dir, `${id}-d${depth}-${sanitizeSlug(label) || "sub"}.json`);
   } catch (e) {
-    log6.warn(`subagent trace dir unavailable (${dir}) \u2014 running without a trace: ${e instanceof Error ? e.message : String(e)}`);
+    log7.warn(`subagent trace dir unavailable (${dir}) \u2014 running without a trace: ${e instanceof Error ? e.message : String(e)}`);
     return void 0;
   }
 }
 function flushTrace(file, meta, messages, status) {
   try {
-    writeFileSync(file, JSON.stringify({ ...meta, status, updated: Date.now(), messages }, null, 2));
+    writeFileSync2(file, JSON.stringify({ ...meta, status, updated: Date.now(), messages }, null, 2));
   } catch (e) {
-    log6.warn(`subagent trace flush failed (${file}): ${e instanceof Error ? e.message : String(e)}`);
+    log7.warn(`subagent trace flush failed (${file}): ${e instanceof Error ? e.message : String(e)}`);
   }
 }
 function installTrace(child, file, meta) {
@@ -3881,7 +4114,7 @@ async function runChildTraced(args) {
   if (file) flushTrace(file, meta, child.transcript, wc.timedOut() ? "deadline" : res.finishReason);
   let result = res.finishReason === "stop" ? res.text || `(child '${label}' finished with no summary; finishReason=${res.finishReason})` : abortHint(label, res, file);
   if (wc.timedOut()) {
-    log6.warn(`sub-task '${label}' hit its ${deadlineMs}ms wall-clock deadline (steps=${res.steps})`);
+    log7.warn(`sub-task '${label}' hit its ${deadlineMs}ms wall-clock deadline (steps=${res.steps})`);
     result += deadlineNote(deadlineMs);
   }
   await opts.hooks?.onSubagentStop?.(result, { label, agentType });
@@ -4210,7 +4443,7 @@ function reasoningToChatFragment(model, effort) {
 }
 
 // src/Agent.ts
-var log7 = forComponent("Agent");
+var log8 = forComponent("Agent");
 function envInt(key, fallback) {
   const n = typeof process !== "undefined" ? Number(process.env?.[key]) : NaN;
   return Number.isFinite(n) && n >= 0 ? n : fallback;
@@ -4291,6 +4524,9 @@ var AgentOptions = class {
    *  `maxTokens`: that is the cumulative SPEND kill-switch, and a spend budget must never be able to
    *  drive destructive compaction (`--max-tokens 50000` would otherwise shred the transcript). */
   contextWindow = 0;
+  /** Does a model take image input? true/false from the host's model catalog; undefined = unknown (images are tried,
+   *  and turned off for the run when the adapter refuses them). Unset = always try. */
+  imageInput;
   /** Pagination ceiling for a SINGLE tool result (bytes). A result over this is cropped to page 1 with
    *  a marker telling the model it was cropped (refine the query, or page further). Guards against one
    *  Grep/Read/MCP call blowing the whole context window. 0 = off. Default 60k (~15k tokens). */
@@ -4590,7 +4826,7 @@ var Agent = class _Agent {
       const disk = new NodeDiskFilesystem2(process.cwd());
       await disk.init();
       this.options.fs = new JailedFilesystem2(disk);
-      log7.info(`no fs provided \u2014 defaulting to jailed real disk at ${process.cwd()}`);
+      log8.info(`no fs provided \u2014 defaulting to jailed real disk at ${process.cwd()}`);
     }
     this.buildCtx();
   }
@@ -4735,7 +4971,8 @@ var Agent = class _Agent {
     const cap = _Agent.contextCap(this.options);
     const target = Math.round(cap * _Agent.COMPACT_TARGET);
     const kr = this.options.keepRecentImages ?? 1;
-    const tokensBefore = estimateTokens(this.transcript, kr);
+    const vis = this.sendsImages();
+    const tokensBefore = estimateTokens(this.transcript, kr, vis);
     const msgsBefore = this.transcript.length;
     let max = Math.max(2, maxMessages);
     if (this.transcript.length <= max && tokensBefore <= target)
@@ -4743,18 +4980,18 @@ var Agent = class _Agent {
     void this.activeHooks?.onPreCompact?.(this.transcript);
     let out = this.transcript;
     if (out.length > max) out = compact(out, max, focus);
-    if (estimateTokens(out, kr) > target) out = elideOversizedImages(out, target, true, kr);
-    if (estimateTokens(out, kr) > target) out = capOversizedBodies(out, target, kr);
-    if (estimateTokens(out, kr) > target) out = elideOversizedImages(out, target, false, kr);
-    while (estimateTokens(out, kr) > target && max > 2 && out.length > 2) {
+    if (estimateTokens(out, kr, vis) > target) out = elideOversizedImages(out, target, true, kr);
+    if (estimateTokens(out, kr, vis) > target) out = capOversizedBodies(out, target, kr);
+    if (estimateTokens(out, kr, vis) > target) out = elideOversizedImages(out, target, false, kr);
+    while (estimateTokens(out, kr, vis) > target && max > 2 && out.length > 2) {
       max = Math.max(2, Math.floor(max / 2));
       out = capOversizedBodies(compact(out, max, focus), target, kr);
     }
-    if (estimateTokens(out, kr) > target) out = fitTokenBudget(out, target, kr);
+    if (estimateTokens(out, kr, vis) > target) out = fitTokenBudget(out, target, kr);
     out = dropOrphanToolResults(out);
     this.transcript = out;
     this.releaseStaleImages();
-    return { tokensBefore, tokensAfter: estimateTokens(this.transcript, kr), target, cap, removed: msgsBefore - this.transcript.length };
+    return { tokensBefore, tokensAfter: estimateTokens(this.transcript, kr, vis), target, cap, removed: msgsBefore - this.transcript.length };
   }
   /** Drop inline base64 images from older messages so Bun/JSC can reclaim the heap (see contentBytes). */
   releaseStaleImages(keepRecent = 1) {
@@ -4778,7 +5015,7 @@ var Agent = class _Agent {
     let closureNudged = false;
     let lastProgressAt = start;
     const kill = (finishReason) => {
-      log7.warn(`kill-switch: ${finishReason} (steps=${steps}, tokens=${usage.totalTokens}, budgetTokens=${Math.round(usage.totalTokens - 0.9 * usage.cacheReadTokens)}, ms=${Date.now() - start - this.parkedMs}${finishReason === "timeout" ? `, idle=${Date.now() - lastProgressAt - this.parkedMs}ms` : ""}${this.parkedMs ? ` +${this.parkedMs} parked` : ""})`);
+      log8.warn(`kill-switch: ${finishReason} (steps=${steps}, tokens=${usage.totalTokens}, budgetTokens=${Math.round(usage.totalTokens - 0.9 * usage.cacheReadTokens)}, ms=${Date.now() - start - this.parkedMs}${finishReason === "timeout" ? `, idle=${Date.now() - lastProgressAt - this.parkedMs}ms` : ""}${this.parkedMs ? ` +${this.parkedMs} parked` : ""})`);
       this.jobs.killAll(`run ended: ${finishReason}`, true);
       const claims = this.survivingClaims();
       return { text: lastAssistantText(this.transcript), steps, finishReason, messages: this.transcript, usage, usageEstimated, ...claims.length ? { fabricatedToolClaims: claims } : {} };
@@ -4793,7 +5030,7 @@ var Agent = class _Agent {
       steps++;
       this.options.host?.notify?.({ kind: "turn_start", message: `step ${steps}` });
       let res;
-      const sent = this.trimContext();
+      let sent = this.trimContext();
       const frag = reasoningToChatFragment(o.model, o.reasoning);
       const sentTools = o.model.startsWith("claude-code/") ? [] : wireTools;
       const isCursorWithTools = o.model.startsWith("cursor/") && wireTools.length > 0;
@@ -4804,9 +5041,9 @@ var Agent = class _Agent {
       this.nativeHoldMs = o.nativeHoldMs;
       if (isCursorWithTools) {
         if (typeof hostToolTimeoutMs === "number" && effectiveToolTimeoutMs !== hostToolTimeoutMs) {
-          log7.warn(`providerOptions.toolTimeoutMs=${hostToolTimeoutMs}ms is below what the registered tools need \u2014 RAISED to ${effectiveToolTimeoutMs}ms. ${toolTimeoutViolations(this.activeTools, hostToolTimeoutMs).length} tool(s) could outlive it, and the transport would have destroyed their results. To lower it, lower the tools' own maxDurationMs (e.g. the Shell tool's maxTimeoutMs) instead.`);
+          log8.warn(`providerOptions.toolTimeoutMs=${hostToolTimeoutMs}ms is below what the registered tools need \u2014 RAISED to ${effectiveToolTimeoutMs}ms. ${toolTimeoutViolations(this.activeTools, hostToolTimeoutMs).length} tool(s) could outlive it, and the transport would have destroyed their results. To lower it, lower the tools' own maxDurationMs (e.g. the Shell tool's maxTimeoutMs) instead.`);
         }
-        for (const v of toolTimeoutViolations(this.activeTools, effectiveToolTimeoutMs)) log7.warn(v);
+        for (const v of toolTimeoutViolations(this.activeTools, effectiveToolTimeoutMs)) log8.warn(v);
       }
       const hostExec = async (name, args) => {
         const tc = { id: `host-${Date.now()}`, type: "function", function: { name, arguments: JSON.stringify(args) } };
@@ -4865,12 +5102,20 @@ var Agent = class _Agent {
               res = r;
             }
             if (steps === 1 && this.isEmptyStop(res) && !this.pendingInjections.length) {
-              const e = new Error("model returned an empty turn (finishReason=stop, no text, no tools)");
+              const e = new Error(`model returned an empty turn (finishReason=${res.finishReason ?? "n/a"}, no text, no tools)`);
               e.code = "empty";
+              if (res.finishReason) e.providerFinishReason = res.finishReason;
               throw e;
             }
             break;
           } catch (err) {
+            if (!this.imagesOff && /does not support .*input/i.test(String(err?.message ?? "")) && sent.some((m) => Array.isArray(m.content) && m.role === "tool")) {
+              this.imagesOff = true;
+              log8.warn(`model refused image input (${err?.message}) \u2014 resending with image Reads as text stubs`);
+              sent = this.trimContext();
+              attempt--;
+              continue;
+            }
             const sc = err?.statusCode;
             const serverSide = sc >= 500 || sc === 408 || /Service Unavailable|overloaded|Internal server error|Bad gateway|Gateway time/i.test(String(err?.message ?? ""));
             const network = !sc && /ECONNRESET|ECONNREFUSED|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|EPIPE|socket hang up|fetch failed|network|terminated|UND_ERR/i.test(String(err?.message ?? err?.code ?? err));
@@ -4878,11 +5123,11 @@ var Agent = class _Agent {
             const empty = err?.code === "empty" || err?.code === "cursor_silent";
             const maxAttempts = empty ? Math.max(o.emptyRetries, 0) : 2;
             const replaysTool = stalled && this.toolRanThisAttempt;
-            if (replaysTool) log7.warn("model stall after tool(s) already ran this step \u2014 not retrying (a retry would replay them)");
+            if (replaysTool) log8.warn("model stall after tool(s) already ran this step \u2014 not retrying (a retry would replay them)");
             const transient = !o.signal?.aborted && !isAbortError(err) && !replaysTool && attempt < maxAttempts && (network || serverSide || stalled || empty);
             if (!transient) throw err;
             const waitMs = (empty ? o.emptyRetryBaseMs : 1e3) * (attempt + 1);
-            log7.warn(`${empty ? "empty model turn" : stalled ? "model stall" : "network drop"} mid-step (${err?.message ?? err}) \u2014 retrying in ${waitMs}ms`);
+            log8.warn(`${empty ? "empty model turn" : stalled ? "model stall" : "network drop"} mid-step (${err?.message ?? err}) \u2014 retrying in ${waitMs}ms`);
             o.host?.notify?.({ kind: "retry", message: `${empty ? "model returned nothing" : stalled ? "model stalled" : "connection dropped"} \u2014 retrying step (#${attempt + 1})` });
             await new Promise((r) => setTimeout(r, waitMs));
           }
@@ -4890,13 +5135,14 @@ var Agent = class _Agent {
       } catch (err) {
         if (err?.code === "budget") return kill("budget");
         if (err?.code === "stall") {
-          log7.warn(`model stalled out after retries: ${err?.message ?? err}`);
-          return { ...kill("timeout"), error: err };
+          log8.warn(`model stalled out after retries: ${err?.message ?? err}`);
+          return { ...kill("timeout"), providerFinishReason: "none (stalled)", error: err };
         }
         if (o.signal?.aborted || isAbortError(err)) return kill("aborted");
         if (err?.code === "empty" || err?.code === "cursor_silent") {
-          log7.warn(`model returned empty/silent turns after retries \u2014 surfacing as failed`);
-          return { text: "", steps, finishReason: "empty", messages: this.transcript, usage, usageEstimated, error: err };
+          log8.warn(`model returned empty/silent turns after retries \u2014 surfacing as failed`);
+          const pfr = err?.providerFinishReason;
+          return { text: "", steps, finishReason: "empty", ...pfr ? { providerFinishReason: pfr } : {}, messages: this.transcript, usage, usageEstimated, error: err };
         }
         const body = err?.body ?? err?.response?.data ?? err?.error;
         let bodyStr;
@@ -4907,13 +5153,13 @@ var Agent = class _Agent {
         }
         if (bodyStr && err instanceof Error && !err.message.includes(bodyStr)) err.detail = bodyStr;
         const errLog = err instanceof Error ? { message: err.message, ...err.detail ? { detail: err.detail } : {}, stack: err.stack } : err;
-        log7.error(`chat() failed: ${err?.message ?? err}${bodyStr ? ` \u2014 ${bodyStr}` : ""}`, errLog);
+        log8.error(`chat() failed: ${err?.message ?? err}${bodyStr ? ` \u2014 ${bodyStr}` : ""}`, errLog);
         return { text: "", steps, finishReason: "error", messages: this.transcript, usage, usageEstimated, error: err };
       }
       if (o.signal?.aborted) return kill("aborted");
       if (res.finishReason === "error" && !res.toolCalls?.length) {
         const err = new Error(contentText(res.content ?? "").trim() || "provider error");
-        log7.error(`chat() failed: ${err.message}`);
+        log8.error(`chat() failed: ${err.message}`);
         return { text: "", steps, finishReason: "error", messages: this.transcript, usage, usageEstimated, error: err };
       }
       if (!res.usage) {
@@ -4971,21 +5217,21 @@ var Agent = class _Agent {
         if (emptyTurn && o.failEmptyTurns) {
           if (!emptyNudged && canNudge()) {
             emptyNudged = true;
-            log7.warn(`empty model turn after tool work (step ${steps}, provider finishReason=${res.finishReason ?? "n/a"}) \u2014 nudging once`);
+            log8.warn(`empty model turn after tool work (step ${steps}, provider finishReason=${res.finishReason ?? "n/a"}) \u2014 nudging once`);
             this.transcript.push({ role: "user", content: "Continue \u2014 you returned nothing. Answer the user now using the tool results above, or keep working if you are not done." });
             continue;
           }
-          log7.warn(`model returned empty turns after tool work \u2014 surfacing as failed`);
+          log8.warn(`model returned empty turns after tool work \u2014 surfacing as failed`);
           const e = new Error("empty_response: model returned an empty turn (no text, no tools) after a re-prompt");
           e.code = "empty";
           return { text: "", steps, finishReason: "empty", ...res.finishReason ? { providerFinishReason: res.finishReason } : {}, messages: this.transcript, usage, usageEstimated, error: e };
         }
         const fabricated = o.catchFabricatedToolUse && !closureNudged ? this.fabricatedToolNames(contentText(res.content ?? "")) : [];
         for (const n of fabricated) this.fabricatedClaims.add(n);
-        if (fabricated.length && !canNudge()) log7.warn(`fabricated tool use: text names ${fabricated.join(", ")} but no step/budget left to demand the call \u2014 finishing with the existing answer`);
+        if (fabricated.length && !canNudge()) log8.warn(`fabricated tool use: text names ${fabricated.join(", ")} but no step/budget left to demand the call \u2014 finishing with the existing answer`);
         if (fabricated.length && canNudge()) {
           closureNudged = true;
-          log7.warn(`fabricated tool use: text names ${fabricated.join(", ")} but the run invoked ${this.invokedTools.size ? [...this.invokedTools].join(", ") : "nothing"} \u2014 demanding the real call`);
+          log8.warn(`fabricated tool use: text names ${fabricated.join(", ")} but the run invoked ${this.invokedTools.size ? [...this.invokedTools].join(", ") : "nothing"} \u2014 demanding the real call`);
           this.transcript.push({
             role: "user",
             content: `You referred to ${fabricated.map((n) => `\`${n}\``).join(", ")} in your reply, but you never actually called ${fabricated.length > 1 ? "those tools" : "that tool"} \u2014 no tool call was made, so any result you reported for ${fabricated.length > 1 ? "them" : "it"} was invented. Either call ${fabricated.length > 1 ? "them" : "it"} for real now, or answer without ${fabricated.length > 1 ? "them" : "it"} and do NOT claim any outcome \u2014 including a failure or a timeout \u2014 for a call you did not make.`
@@ -4994,14 +5240,14 @@ var Agent = class _Agent {
         }
         if (o.closeDelegatedTurns && res.endedWithoutClosing && !closureNudged && canNudge()) {
           closureNudged = true;
-          log7.verbose("delegated turn went silent after a tool \u2014 nudging a closing answer");
+          log8.verbose("delegated turn went silent after a tool \u2014 nudging a closing answer");
           this.transcript.push({
             role: "user",
             content: "You ran tools but did not reply. Answer the user now using the tool results above; if a tool failed, say so plainly. Do NOT re-run those tools, do NOT narrate what you did, and do NOT ask for permission to continue."
           });
           continue;
         }
-        log7.verbose(`completed in ${steps} step(s)`);
+        log8.verbose(`completed in ${steps} step(s)`);
         const drained = await this.jobs.drain(o.signal);
         if (o.signal?.aborted) return kill("aborted");
         if (drained.length) lastProgressAt = Date.now();
@@ -5035,7 +5281,7 @@ var Agent = class _Agent {
       if (this.ctx.needsInput) {
         const question = this.ctx.needsInput;
         this.ctx.needsInput = void 0;
-        log7.warn(`needs_input: ${question.question} (steps=${steps})`);
+        log8.warn(`needs_input: ${question.question} (steps=${steps})`);
         await this.jobs.drain();
         const text = [
           `OPEN QUESTION (run paused \u2014 no human was reachable): ${question.question}`,
@@ -5077,12 +5323,12 @@ var Agent = class _Agent {
         if (this.toolHoldActive()) {
           const now3 = Date.now();
           const who = this.jobs.holding().map((j) => `${j.kind} "${j.label}" (${Math.round((now3 - j.startedAt) / 1e3)}s, quiet ${Math.round((now3 - j.lastActivityAt) / 1e3)}s)`).join(", ");
-          log7.warn(`stall watchdog: no stream output for ${stallMs}ms \u2014 held by ${who}`);
+          log8.warn(`stall watchdog: no stream output for ${stallMs}ms \u2014 held by ${who}`);
           this.options.host?.notify?.({ kind: "tool_hold", message: `waiting on ${who}` });
           return poke();
         }
         const inFlight = this.jobs.list().filter((j) => j.status === "running");
-        log7.warn(`stall watchdog: no stream output for ${stallMs}ms and no tool holding the stream \u2014 aborting the request` + (inFlight.length ? ` (${inFlight.length} detached job(s) running, not awaited by the stream: ${inFlight.map((j) => `${j.id}/${j.kind}`).join(", ")})` : ""));
+        log8.warn(`stall watchdog: no stream output for ${stallMs}ms and no tool holding the stream \u2014 aborting the request` + (inFlight.length ? ` (${inFlight.length} detached job(s) running, not awaited by the stream: ${inFlight.map((j) => `${j.id}/${j.kind}`).join(", ")})` : ""));
         fired = true;
         ac.abort(stallError());
       }, stallMs);
@@ -5252,13 +5498,13 @@ var Agent = class _Agent {
     const decision = await this.park(Promise.resolve(hooks?.preToolUse?.(call, meta)));
     if (decision?.block) {
       const blocked = `Blocked by hook: ${decision.reason ?? "no reason given"}`;
-      log7.debug(`${tc.function.name} -> ${blocked}`);
+      log8.debug(`${tc.function.name} -> ${blocked}`);
       await hooks?.postToolUse?.(call, blocked, meta);
       return blocked;
     }
     this.options.host?.notify?.({ kind: "tool_use", id: tc.id ?? "", name: tc.function.name, input: args });
     if (earlyError) {
-      log7.debug(`${tc.function.name} -> ${earlyError}`);
+      log8.debug(`${tc.function.name} -> ${earlyError}`);
       await hooks?.postToolUse?.(call, earlyError, meta);
       this.options.host?.notify?.({ kind: "tool_result", id: tc.id ?? "", output: earlyError, isError: true });
       return earlyError;
@@ -5267,12 +5513,12 @@ var Agent = class _Agent {
     let images;
     let threw = false;
     try {
-      log7.debug(`${tc.function.name}(${tc.function.arguments})`);
+      log8.debug(`${tc.function.name}(${tc.function.arguments})`);
       this.ctx.emit = hooks?.onToolOutput ? (chunk) => {
         try {
           hooks.onToolOutput(call, chunk, meta);
         } catch (e) {
-          log7.debug(`onToolOutput hook error: ${e}`);
+          log8.debug(`onToolOutput hook error: ${e}`);
         }
       } : void 0;
       const raw = await tool.run(args, this.ctx);
@@ -5284,7 +5530,7 @@ var Agent = class _Agent {
       }
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
-      log7.debug(`${tc.function.name} -> error: ${msg}`);
+      log8.debug(`${tc.function.name} -> error: ${msg}`);
       result = `Error: ${msg}`;
       threw = true;
     } finally {
@@ -5344,6 +5590,13 @@ ${out}`;
    *  3. token-aware backstop (`maxContextTokens`) — drop oldest messages until under an estimated token ceiling.
    * With every knob off, returns the transcript unchanged (same reference).
    */
+  /** Set when the model refused image parts this run: tool image Reads go as text stubs from then on. */
+  imagesOff = false;
+  /** Send tool image Reads as images? Known models by their catalog flag; unknown ones try (and latch off on refusal). */
+  sendsImages() {
+    if (this.imagesOff) return false;
+    return this.options.imageInput?.(this.options.model) ?? true;
+  }
   trimContext() {
     const o = this.options;
     const m = this.transcript;
@@ -5353,17 +5606,19 @@ ${out}`;
     const browserKeep = this.browserActive ? o.browserTrim?.keepOutputs : void 0;
     const keep = browserKeep != null ? o.keepToolOutputs ? Math.min(o.keepToolOutputs, browserKeep) : browserKeep : o.keepToolOutputs;
     if (keep) out = stubOldToolResults(out ?? m, keep);
-    out = expandImagesForSend(dropOrphanToolResults(out ?? m), o.keepRecentImages ?? 1);
+    out = expandImagesForSend(dropOrphanToolResults(out ?? m), o.keepRecentImages ?? 1, void 0, this.sendsImages());
     if (o.maxContextTokens) {
       const pre = out.length;
-      out = fitTokenBudget(out, o.maxContextTokens, o.keepRecentImages ?? 1);
+      out = fitTokenBudget(out, o.maxContextTokens, o.keepRecentImages ?? 1, this.sendsImages());
       const dropped = pre - out.length;
       if (dropped > 0 && dropped !== this.lastTrimNotified) {
         this.lastTrimNotified = dropped;
         o.host?.notify?.({ kind: "compaction", message: `context full \u2014 auto-trimmed ${dropped} oldest message(s) to fit ~${Math.round(o.maxContextTokens / 1e3)}k tokens` });
       }
     }
-    return dropOrphanToolResults(out);
+    out = dropOrphanToolResults(out);
+    if (/^google\//.test(o.model ?? "")) out = hoistToolImages(out);
+    return scrubBase64(out);
   }
 };
 function dropOldest(m, max) {
@@ -5372,8 +5627,8 @@ function dropOldest(m, max) {
 }
 var ANTHROPIC_WINDOW_WITHOUT_1M_BETA = 2e5;
 var isAnthropicModel = (m) => !!m && (m.startsWith("anthropic/") || /(^|\/)claude-/.test(m));
-function estimateTokens(m, keepRecentImages = 1) {
-  return Math.ceil(sendBytes(m, keepRecentImages) / 4);
+function estimateTokens(m, keepRecentImages = 1, vision = true) {
+  return Math.ceil(sendBytes(m, keepRecentImages, vision) / 4);
 }
 var TRANSPORT_TOOL_TIMEOUT_FLOOR_MS = 18e5;
 var isMcpTool = (t) => t.name.startsWith("mcp__") || t.name === "McpCall";
@@ -5542,8 +5797,8 @@ function dropOrphanToolResults(messages) {
   const ok = (m) => m.role !== "tool" || ids.has(m.tool_call_id ?? "");
   return messages.every(ok) ? messages : messages.filter(ok);
 }
-function fitTokenBudget(messages, maxTokens, keepRecentImages = 1) {
-  const per = sendBytesPer(messages, keepRecentImages).map((b) => Math.ceil(b / 4));
+function fitTokenBudget(messages, maxTokens, keepRecentImages = 1, vision = true) {
+  const per = sendBytesPer(messages, keepRecentImages, vision).map((b) => Math.ceil(b / 4));
   let total = per.reduce((a, b) => a + b, 0);
   if (total <= maxTokens) return messages;
   const head = messages[0]?.role === "system" ? [messages[0]] : [];
@@ -5552,7 +5807,7 @@ function fitTokenBudget(messages, maxTokens, keepRecentImages = 1) {
   const ids = callIdSet(messages.slice(from));
   while (from < messages.length && messages[from].role === "tool" && !ids.has(messages[from].tool_call_id ?? "")) total -= per[from++];
   if (total > maxTokens)
-    log7.warn(`context ~${total} tok still over maxContextTokens=${maxTokens} after trimming (system head can't be dropped)`);
+    log8.warn(`context ~${total} tok still over maxContextTokens=${maxTokens} after trimming (system head can't be dropped)`);
   return [...head, ...messages.slice(from)];
 }
 function compact(m, max, focus) {
@@ -6235,7 +6490,7 @@ init_tools_web();
 init_tools();
 init_tools_structured();
 init_logging();
-var log9 = forComponent("scratch");
+var log10 = forComponent("scratch");
 var SCRATCH_DIR = "/scratch";
 function shortArgs(args) {
   try {
@@ -6275,7 +6530,7 @@ var Scratch = class {
           await (this.dirReady ??= mkdirp(this.fs, dir));
           await this.fs.writeFile(path, header + raw);
         } catch (e) {
-          log9.debug("scratch write failed; returning raw", e);
+          log10.debug("scratch write failed; returning raw", e);
           return raw;
         }
         const preview = raw.slice(0, previewChars).replace(/\s+/g, " ").trim();
@@ -6305,7 +6560,7 @@ To pull a specific detail, Grep/Read ${path}, or call Ask({ question: "\u2026",
       await (this.dirReady ??= mkdirp(this.fs, dir));
       await this.fs.writeFile(path, header + full);
     } catch (e) {
-      log9.debug("scratch spill failed; cropping lossy", e);
+      log10.debug("scratch spill failed; cropping lossy", e);
       return full.slice(0, pageBytes) + `
 
 [output cropped to ${pageBytes} of ${full.length} bytes; full output unavailable (scratch write failed) \u2014 refine your query]`;
@@ -6351,7 +6606,7 @@ Question: ${q}`);
         const answer = (res.text ?? "").trim();
         return answer || "(no answer found in scratch)";
       } catch (e) {
-        log9.debug("Ask peek failed", e);
+        log10.debug("Ask peek failed", e);
         return `Error querying scratch: ${e?.message ?? e}`;
       }
     }
@@ -6360,7 +6615,7 @@ Question: ${q}`);
 
 // src/lessons.ts
 init_logging();
-var log10 = forComponent("Lessons");
+var log11 = forComponent("Lessons");
 var LessonOptionsDefaults = class {
   minRepeats = 2;
 };
@@ -6385,8 +6640,8 @@ function lessonCapture(options) {
       counts.set(lesson.slug, n);
       if (n < o.minRepeats) return;
       written.add(lesson.slug);
-      await writeFact(o.fs, o.dir, lesson.slug, lesson.body).catch((e) => log10.warn(`could not persist ${lesson.slug}: ${e?.message ?? e}`));
-      log10.debug(`captured lesson ${lesson.slug} (recurred ${n}\xD7)`);
+      await writeFact(o.fs, o.dir, lesson.slug, lesson.body).catch((e) => log11.warn(`could not persist ${lesson.slug}: ${e?.message ?? e}`));
+      log11.debug(`captured lesson ${lesson.slug} (recurred ${n}\xD7)`);
     }
   };
 }
@@ -6394,7 +6649,7 @@ function lessonCapture(options) {
 // src/reflect.ts
 init_llm();
 init_logging();
-var log11 = forComponent("Reflect");
+var log12 = forComponent("Reflect");
 async function reflectOnRun(o) {
   const digest = digestRun(o.result.messages, o.maxDigestChars ?? 6e3);
   if (!digest.trim()) return null;
@@ -6410,7 +6665,7 @@ If the run was fine or the issue was purely task-specific (not generalizable), r
     const r = await o.ai.chat({ model: o.model, messages: [{ role: "user", content: prompt }], stream: false });
     text = r?.content ?? "";
   } catch (e) {
-    log11.warn(`reflection call failed: ${e?.message ?? e}`);
+    log12.warn(`reflection call failed: ${e?.message ?? e}`);
     return null;
   }
   const m = text.match(/LESSON:\s*(.+)/i);
@@ -6420,10 +6675,10 @@ If the run was fine or the issue was purely task-specific (not generalizable), r
   try {
     await writeFact(o.fs, o.dir, slug2, lesson);
   } catch (e) {
-    log11.warn(`could not persist lesson: ${e?.message ?? e}`);
+    log12.warn(`could not persist lesson: ${e?.message ?? e}`);
     return null;
   }
-  log11.debug(`reflection persisted ${slug2}`);
+  log12.debug(`reflection persisted ${slug2}`);
   return slug2;
 }
 function digestRun(messages, maxChars) {
@@ -6472,7 +6727,7 @@ function forComponent2(name) {
 }
 
 // node_modules/@bod.ee/voice/src/core/emotion.ts
-var log12 = forComponent2("Emotion");
+var log13 = forComponent2("Emotion");
 var EMOTIONS = [
   // primary (best results)
   "neutral",
@@ -6626,7 +6881,7 @@ var EmotionStream = class {
       if (tag) {
         this.pending = tag;
         if (this.show) display += m[0];
-      } else log12.debug(`dropping unknown emotion tag ${m[0]}`);
+      } else log13.debug(`dropping unknown emotion tag ${m[0]}`);
       last = m.index + m[0].length;
     }
     this.emit(body.slice(last), (s, d, p) => {
@@ -6773,7 +7028,7 @@ function computeHoldMs(ctx) {
 }
 
 // node_modules/@bod.ee/voice/src/core/engine.ts
-var log13 = forComponent2("VoiceEngine");
+var log14 = forComponent2("VoiceEngine");
 var realClock = {
   now: () => performance.now(),
   setTimeout: (fn, ms) => setTimeout(fn, ms),
@@ -7161,8 +7416,8 @@ var VoiceEngine = class _VoiceEngine {
     this.tts.warmup?.();
     this.setState("listening");
     if (this.options.bargeInMode === "aec" && !this.stt.usingAec)
-      log13.warn("bargeInMode=aec but mic does not report echoCancellation applied \u2014 STT may transcribe the assistant");
-    log13.debug(`voice I/O up (${this.usingAec ? "AEC" : "heuristic echo"} capture, mode=${this.options.bargeInMode}, mic reports aec=${this.stt.usingAec})`);
+      log14.warn("bargeInMode=aec but mic does not report echoCancellation applied \u2014 STT may transcribe the assistant");
+    log14.debug(`voice I/O up (${this.usingAec ? "AEC" : "heuristic echo"} capture, mode=${this.options.bargeInMode}, mic reports aec=${this.stt.usingAec})`);
   }
   /** The RESOLVED barge-in tier (the single seam every tier branch reads). `bargeInMode` overrides
    *  the mic's self-report — see the option doc for why the report is not trustworthy on mobile. */
@@ -7187,7 +7442,7 @@ var VoiceEngine = class _VoiceEngine {
       this.options.onDiag({ t: this.clock.now(), kind, ...fields });
     } catch (e) {
       this.diagOn = false;
-      log13.debug(`onDiag threw \u2014 diagnostics disabled: ${e instanceof Error ? e.message : e}`);
+      log14.debug(`onDiag threw \u2014 diagnostics disabled: ${e instanceof Error ? e.message : e}`);
     }
   }
   idleWaiters = [];
@@ -7326,7 +7581,7 @@ var VoiceEngine = class _VoiceEngine {
     }
     for (const w of this.words(this.reply)) this.echoWords.add(w);
     this.tts.speak(forSpeech(speech), true);
-    if (!this.spokeDeltas && this.turnStartAt) log13.debug(`ttft: ${Math.round(this.clock.now() - this.turnStartAt)}ms`);
+    if (!this.spokeDeltas && this.turnStartAt) log14.debug(`ttft: ${Math.round(this.clock.now() - this.turnStartAt)}ms`);
     this.spokeDeltas = true;
     this.setState("speaking");
     if (this.options.revealMode !== "off" && display) {
@@ -7439,13 +7694,13 @@ var VoiceEngine = class _VoiceEngine {
       this.drainTimer = null;
       this.speaking = false;
       this.stopWordReveal(true);
-      if (this.turnStartAt) log13.debug(`turn: ${Math.round(this.clock.now() - this.turnStartAt)}ms (incl. playback)`);
+      if (this.turnStartAt) log14.debug(`turn: ${Math.round(this.clock.now() - this.turnStartAt)}ms (incl. playback)`);
       this.echoUntil = this.clock.now() + 2500;
       if (!this.usingAec) this.stt.reset();
       try {
         this.options.onSpeechEnd();
       } catch (e) {
-        log13.warn(`onSpeechEnd threw: ${e instanceof Error ? e.message : e}`);
+        log14.warn(`onSpeechEnd threw: ${e instanceof Error ? e.message : e}`);
       }
       this.setState("listening");
       if (this.uttQueue.length) this.pumpQueue();
@@ -7519,7 +7774,7 @@ var VoiceEngine = class _VoiceEngine {
     if (!host) return pick;
     const ctx = { text: this.lastDispatchText, question: this.lastDispatchWasQuestion, barged: this.bargedBeforeDispatch };
     const fallback = (e) => {
-      log13.warn(`pickAck failed \u2014 using the default pools: ${e instanceof Error ? e.message : e}`);
+      log14.warn(`pickAck failed \u2014 using the default pools: ${e instanceof Error ? e.message : e}`);
       pick.picked = false;
       return void 0;
     };
@@ -7609,7 +7864,7 @@ var VoiceEngine = class _VoiceEngine {
     this.ackProbe = null;
     const queued = this.uttQueue.splice(0);
     const droppedQueued = queued.length;
-    if (droppedQueued) log13.info(`barge-in cut ${droppedQueued} queued worker utterance(s) \u2014 handed to the host`);
+    if (droppedQueued) log14.info(`barge-in cut ${droppedQueued} queued worker utterance(s) \u2014 handed to the host`);
     this.overlapKeptUntil = 0;
     if (!this.speaking && !this.drainTimer) {
       if (droppedQueued) this.lastInterrupted = { full: "", heard: "", queued, queuedTurn: false };
@@ -7838,7 +8093,7 @@ var VoiceEngine = class _VoiceEngine {
       if (flat && this.lastDispatchFlat && this.clock.now() - this.lastDispatchAt < _VoiceEngine.DUP_FINAL_MS && (this.lastDispatchFlat.startsWith(flat) || flat.startsWith(this.lastDispatchFlat))) return;
       this.specSpent = true;
       this.specText = this.specPartial;
-      log13.debug(`speculate: "${this.specText.slice(0, 60)}"`);
+      log14.debug(`speculate: "${this.specText.slice(0, 60)}"`);
       this.diag("speculate", { text: this.specText });
       this.options.onSpeculate(this.specText);
     }, this.options.speculativeMs);
@@ -7907,7 +8162,7 @@ var VoiceEngine = class _VoiceEngine {
     };
     this.tts.newContext();
     this.tts.speak(phrase, false);
-    log13.debug(`backchannel: "${phrase}"`);
+    log14.debug(`backchannel: "${phrase}"`);
     this.diag("backchannel", { phrase });
     this.options.onBackchannel(phrase);
   }
@@ -7940,7 +8195,7 @@ var VoiceEngine = class _VoiceEngine {
     });
     if (idx < 0) return text;
     toks.splice(idx, 1);
-    log13.verbose(`stripped backchannel echo "${this.lastBcPhrase}" from dispatching final`);
+    log14.verbose(`stripped backchannel echo "${this.lastBcPhrase}" from dispatching final`);
     return toks.join(" ");
   }
   /** Merge a resumed utterance into the pending one, deduping any word-overlap. Soniox re-finalizes
@@ -8126,7 +8381,7 @@ var VoiceEngine = class _VoiceEngine {
     }
     const bargeHold = !this.looksIncomplete(this.pendingUtt) && this.unfinishedBargeLine(this.pendingUtt);
     if (this.options.incompleteMergeMs && (bargeHold || this.looksIncomplete(this.pendingUtt))) {
-      log13.verbose(`hold: incomplete utterance "${this.pendingUtt.slice(-40)}"`);
+      log14.verbose(`hold: incomplete utterance "${this.pendingUtt.slice(-40)}"`);
       this.diag("hold", { reason: bargeHold ? "barge_unfinished" : "incomplete", tail: this.pendingUtt.slice(-40) });
       this.options.onHold();
       if (this.options.holdFiller && !this.speaking) this.speakFiller(this.options.holdFiller);
@@ -8165,13 +8420,13 @@ var VoiceEngine = class _VoiceEngine {
       const answered = this.answeredSinceDispatch();
       const part = flat !== this.lastDispatchFlat && !answered && this.echoesDispatch(text);
       if (part || flat && flat === this.lastDispatchFlat && !answered && this.clock.now() - this.lastDispatchAt < _VoiceEngine.DUP_FINAL_MS) {
-        log13.verbose(`dropped duplicate final "${text.slice(0, 40)}" (identical to the just-dispatched utterance, no reply between)`);
+        log14.verbose(`dropped duplicate final "${text.slice(0, 40)}" (identical to the just-dispatched utterance, no reply between)`);
         this.diag("utterance_drop", { reason: "dup_final", text: text.slice(0, 60) });
         return;
       }
       const refinal = this.refinalizes(text);
       if (refinal && this.repliedSinceDispatch) {
-        log13.verbose(`dropped re-finalization "${text.slice(0, 60)}" (superset of the just-dispatched utterance, reply already flowing)`);
+        log14.verbose(`dropped re-finalization "${text.slice(0, 60)}" (superset of the just-dispatched utterance, reply already flowing)`);
         this.diag("utterance_drop", { reason: "refinalized", text: text.slice(0, 60) });
         this.lastDispatchFlat = flat;
         this.lastDispatchWords = text.trim().split(/\s+/);
@@ -8450,7 +8705,7 @@ var SpokenSplitter = class {
 };
 
 // node_modules/@bod.ee/voice/src/adapters/soniox.ts
-var log14 = forComponent2("SonioxSTT");
+var log15 = forComponent2("SonioxSTT");
 var now = () => performance.now();
 var SonioxSTTOptions = class {
   auth = "";
@@ -8495,7 +8750,7 @@ var SonioxSTT = class {
       this.onDiag({ t: now(), kind, ...fields });
     } catch (e) {
       this.diagOn = false;
-      log14.debug(`onDiag threw \u2014 STT diagnostics disabled: ${e instanceof Error ? e.message : e}`);
+      log15.debug(`onDiag threw \u2014 STT diagnostics disabled: ${e instanceof Error ? e.message : e}`);
     }
   }
   lastChunkAt = 0;
@@ -8537,11 +8792,11 @@ var SonioxSTT = class {
     this.ws.onmessage = (ev) => this.handle(JSON.parse(String(ev.data)));
     this.ws.onclose = (ev) => {
       if (this.stopped) return;
-      log14.warn(`soniox ws closed (${ev.code} ${ev.reason || ""}) \u2014 reconnecting`);
+      log15.warn(`soniox ws closed (${ev.code} ${ev.reason || ""}) \u2014 reconnecting`);
       this.diag("stt_ws_closed", { code: ev.code, reason: String(ev.reason || ""), reconnecting: true });
       this.reset();
       this.connectWs().catch((e) => {
-        log14.error(`soniox reconnect failed: ${e.message}`);
+        log15.error(`soniox reconnect failed: ${e.message}`);
         this.diag("stt_reconnect_failed", { message: e.message });
       });
     };
@@ -8553,7 +8808,7 @@ var SonioxSTT = class {
     this.endpointTimer = setInterval(() => {
       const combined = (this.finalText + this.partialText).trim();
       if (!combined || now() - this.lastChangeAt < this.options.silenceEndpointMs) return;
-      if (this.firstTokenAt) log14.debug(`stt: ${Math.round(now() - this.firstTokenAt)}ms first-token\u2192silence-endpoint, "${combined.slice(0, 60)}"`);
+      if (this.firstTokenAt) log15.debug(`stt: ${Math.round(now() - this.firstTokenAt)}ms first-token\u2192silence-endpoint, "${combined.slice(0, 60)}"`);
       this.reset();
       this.onUtterance(combined, now());
     }, 120);
@@ -8565,7 +8820,7 @@ var SonioxSTT = class {
         if (this.stopped) return;
         const ref = this.lastChunkAt || this.startedChunksAt;
         if (now() - ref > noAudioMs) {
-          log14.error(`stt: no mic audio for >${Math.round(noAudioMs / 1e3)}s \u2014 capture device stopped delivering`);
+          log15.error(`stt: no mic audio for >${Math.round(noAudioMs / 1e3)}s \u2014 capture device stopped delivering`);
           this.diag("stt_watchdog_fatal", { noAudioMs });
           this.onFatal("microphone stopped delivering audio (try a different input device, e.g. AirPods, or check System Settings \u2192 Sound \u2192 Input)");
           this.stop();
@@ -8588,7 +8843,7 @@ var SonioxSTT = class {
   handle(m) {
     if (m.error_message) {
       this.diag("stt_error", { message: String(m.error_message), code: m.error_code });
-      return log14.error(`soniox: ${m.error_message}`);
+      return log15.error(`soniox: ${m.error_message}`);
     }
     let endpoint = false;
     for (const t of m.tokens ?? []) {
@@ -8605,7 +8860,7 @@ var SonioxSTT = class {
     this.onPartial(combined);
     if (endpoint && this.finalText.trim()) {
       const utterance = this.finalText.trim();
-      if (this.firstTokenAt) log14.debug(`stt: ${Math.round(now() - this.firstTokenAt)}ms first-token\u2192endpoint, "${utterance.slice(0, 60)}"`);
+      if (this.firstTokenAt) log15.debug(`stt: ${Math.round(now() - this.firstTokenAt)}ms first-token\u2192endpoint, "${utterance.slice(0, 60)}"`);
       this.reset();
       this.onUtterance(utterance, now());
     }
@@ -8627,7 +8882,7 @@ var SonioxSTT = class {
 };
 
 // node_modules/@bod.ee/voice/src/adapters/cartesia.ts
-var log15 = forComponent2("CartesiaTTS");
+var log16 = forComponent2("CartesiaTTS");
 var now2 = () => performance.now();
 var CartesiaTTSOptions = class {
   auth = "";
@@ -8663,7 +8918,7 @@ var CartesiaTTS = class _CartesiaTTS {
       this.onDiag({ t: now2(), kind, ...fields });
     } catch (e) {
       this.diagOn = false;
-      log15.debug(`onDiag threw \u2014 TTS diagnostics disabled: ${e instanceof Error ? e.message : e}`);
+      log16.debug(`onDiag threw \u2014 TTS diagnostics disabled: ${e instanceof Error ? e.message : e}`);
     }
   }
   firstAudioAt = 0;
@@ -8698,11 +8953,11 @@ var CartesiaTTS = class _CartesiaTTS {
       this.ws.onerror = (e) => rej(new Error(`cartesia ws: ${e.message || "connect failed"}`));
     });
     this.ws.onclose = (ev) => {
-      log15.warn(`cartesia ws closed (${ev.code} ${ev.reason || ""})`);
+      log16.warn(`cartesia ws closed (${ev.code} ${ev.reason || ""})`);
       this.diag("tts_ws_closed", { code: ev.code, reason: String(ev.reason || ""), reconnecting: !this.closed });
       if (!this.closed) {
         this.connecting = this.doConnect().catch((e) => {
-          log15.error(`cartesia reconnect failed: ${e.message}`);
+          log16.error(`cartesia reconnect failed: ${e.message}`);
           this.diag("tts_reconnect_failed", { message: e.message });
         });
       }
@@ -8730,12 +8985,12 @@ var CartesiaTTS = class _CartesiaTTS {
           this.down = true;
           this.downAt = now2();
           this.consecutiveOk = 0;
-          log15.warn(`TTS circuit breaker open \u2014 ${this.consecutiveErrors} consecutive errors, switching to text-only`);
+          log16.warn(`TTS circuit breaker open \u2014 ${this.consecutiveErrors} consecutive errors, switching to text-only`);
           this.diag("tts_breaker_open", { errors: this.consecutiveErrors });
           this.onDone();
           this.startProbe();
         } else if (!this.down) {
-          (/No valid transcripts/i.test(m.message || "") ? log15.debug : log15.warn)(`cartesia: ${JSON.stringify(m)}`);
+          (/No valid transcripts/i.test(m.message || "") ? log16.debug : log16.warn)(`cartesia: ${JSON.stringify(m)}`);
         }
       }
     };
@@ -8750,7 +9005,7 @@ var CartesiaTTS = class _CartesiaTTS {
     this.stopProbe();
     const downMs = this.downAt ? now2() - this.downAt : 0;
     this.diag("tts_breaker_close", { downMs: Math.round(downMs) });
-    (downMs < 2e3 ? log15.debug : log15.info)(`TTS recovered${downMs ? ` (down ${downMs}ms)` : ""}`);
+    (downMs < 2e3 ? log16.debug : log16.info)(`TTS recovered${downMs ? ` (down ${downMs}ms)` : ""}`);
   }
   /** Ensure the WS is open before sending — reconnects if idle-closed. */
   async ensureConnected() {
@@ -8833,13 +9088,13 @@ function base64ToBytes(b64) {
 }
 
 // node_modules/@bod.ee/voice/src/adapters/fish.ts
-var log16 = forComponent2("FishTTS");
+var log17 = forComponent2("FishTTS");
 
 // node_modules/@bod.ee/voice/src/adapters/grok.ts
-var log17 = forComponent2("GrokTTS");
+var log18 = forComponent2("GrokTTS");
 
 // node_modules/@bod.ee/voice/src/adapters/grok-stt.ts
-var log18 = forComponent2("GrokSTT");
+var log19 = forComponent2("GrokSTT");
 
 // src/voice/engine.ts
 init_logging();
@@ -8851,7 +9106,7 @@ configureLogging((name) => {
 
 // src/voice/instinct.ts
 init_logging();
-var log19 = forComponent("Instinct");
+var log20 = forComponent("Instinct");
 var ACK_SITUATIONS = {
   hard_question: `a question that takes real thought, judgment or looking something up ("what's the biggest takeaway?", "how should I structure this?")`,
   simple_question: 'a quick question with an instant, obvious answer ("how are you?", "what time is it?", "can you hear me?")',
@@ -8890,7 +9145,7 @@ function interruptionNote(cut, intent) {
 
 // src/voice/unsaid.ts
 init_logging();
-var log20 = forComponent("Unsaid");
+var log21 = forComponent("Unsaid");
 var STOP2 = new Set("that this with have from they them their there then than what when were will would your about into just also been some only over more most very which while after before because these those does here".split(" "));
 var contentStems = (s) => (s.toLowerCase().match(/[a-z0-9']+/g) ?? []).filter((w) => w.length >= 4 && !STOP2.has(w)).map((w) => w.slice(0, 4));
 var SAID_OVERLAP = 0.6;
@@ -8930,7 +9185,7 @@ async function unsaidClauses(pieces, spoken, decider, timeoutMs = 5e3) {
       return p < CONVEYED_MIN;
     }).map((x) => x.c);
   } catch (e) {
-    log20.warn(`unsaid judge failed \u2014 only near-zero-overlap clauses count as unsaid: ${e.message}`);
+    log21.warn(`unsaid judge failed \u2014 only near-zero-overlap clauses count as unsaid: ${e.message}`);
     return fallback();
   } finally {
     clearTimeout(timer);
@@ -9001,7 +9256,7 @@ async function judgeLeak(decider, sentence, userSaid) {
 }
 
 // src/duplex.ts
-var log21 = forComponent("DuplexAgent");
+var log22 = forComponent("DuplexAgent");
 function describeCall(call) {
   const v = call.args && Object.values(call.args).find((x) => typeof x === "string" && x.trim());
   const hint = v ? ` (${String(v).replace(/\s+/g, " ").trim().slice(0, 48)})` : "";
@@ -9261,7 +9516,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
           const m = this.reflexBuf.match(RESERVED_EVENT_MARKER) ?? this.reflexBuf.match(RESERVED_EVENT_OPENER);
           if (m) {
             this.fabricationCut = true;
-            log21.warn(`reflex fabricated a [task \u2026] event in its spoken stream \u2014 cutting it (kept ${m.index} chars)`);
+            log22.warn(`reflex fabricated a [task \u2026] event in its spoken stream \u2014 cutting it (kept ${m.index} chars)`);
             this.reflexBuf = this.reflexBuf.slice(0, Math.max(m.index, this.reflexForwarded));
             this.pumpReflex(true);
             return;
@@ -9353,7 +9608,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
       const at = from + ok;
       this.leakHit = true;
       this.leakCuts.push(leak.trim().slice(0, 40));
-      log21.warn(`reflex spoke its own analysis ("${leak.trim().slice(0, 40)}\u2026") \u2014 cut before TTS`);
+      log22.warn(`reflex spoke its own analysis ("${leak.trim().slice(0, 40)}\u2026") \u2014 cut before TTS`);
       this.notify("diag", "analysis_leak", { text: leak.trim().slice(0, 80), at: this.turnSpoken.trim() ? "mid_reply" : "before_speech" });
       const next = this.stepMarks.find((k) => k > at);
       if (next === void 0) {
@@ -9393,7 +9648,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
       this.notify("diag", "leak_judge", { text: s.slice(0, 80), p: Math.round(p * 100) / 100, ms: Math.round(performance.now() - t0) });
       return p >= LEAK_JUDGE_THRESHOLD;
     }, (e) => {
-      log21.warn(`leak judge failed \u2014 speaking the sentence: ${e.message}`);
+      log22.warn(`leak judge failed \u2014 speaking the sentence: ${e.message}`);
       return false;
     }).then((leak) => {
       clearTimeout(timer);
@@ -9427,7 +9682,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
       let i = t.length - 1;
       while (i >= this.turnBase && !(t[i].role === "assistant" && typeof t[i].content === "string" && t[i].content.includes(key))) i--;
       if (i < this.turnBase) {
-        log21.warn("analysis leak cut, but its text was not found in the transcript to scrub");
+        log22.warn("analysis leak cut, but its text was not found in the transcript to scrub");
         continue;
       }
       const m = t[i];
@@ -9507,7 +9762,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
     return {
       preToolUse: (call) => {
         if (this.spec?.state === "pending" && !_DuplexAgent.SPEC_SAFE_TOOLS.has(call.name)) {
-          log21.verbose(`speculation aborted: reflex called ${call.name} on unconfirmed input`);
+          log22.verbose(`speculation aborted: reflex called ${call.name} on unconfirmed input`);
           this.abortSpeculation();
           return { block: true, reason: "Speculative turn aborted." };
         }
@@ -9552,7 +9807,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
     try {
       await this.voice.send(reminder);
     } catch (e) {
-      log21.warn(`ack nudge failed: ${e instanceof Error ? e.message : e}`);
+      log22.warn(`ack nudge failed: ${e instanceof Error ? e.message : e}`);
     } finally {
       this.nudging = false;
       const i = this.voice.transcript.findIndex((m, k) => k >= base && m.role === "user" && m.content === reminder);
@@ -9604,7 +9859,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
       const accepted = this.offerOpen && this.parkedRedeliver.length > 0 && this.parkedRedeliver.every((p) => p.task === this.offer.task) && (isOfferAcceptance(content) || isTrivialBarge(content));
       const judge = accepted ? void 0 : this.options.bargeIntent;
       return (accepted ? Promise.resolve("resume") : judge ? judge(content).catch((e) => {
-        log21.warn(`bargeIntent judge failed \u2014 using the allowlist: ${e.message}`);
+        log22.warn(`bargeIntent judge failed \u2014 using the allowlist: ${e.message}`);
         return fallback();
       }) : Promise.resolve(fallback())).then((intent) => {
         this.notify("diag", "barge_intent", { intent, text: content.slice(0, 80) });
@@ -9800,7 +10055,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
       try {
         res = await this.voice.send(spec.text);
       } catch (e) {
-        log21.warn(`speculative turn failed: ${e instanceof Error ? e.message : e}`);
+        log22.warn(`speculative turn failed: ${e instanceof Error ? e.message : e}`);
       } finally {
         this.voice.options.signal = prevSignal;
       }
@@ -9814,7 +10069,7 @@ ${nowLine()}. Anchor every relative or time-sensitive reference \u2014 "today",
       if (d === "abort") {
         if (this.voice.transcript.length > base) this.voice.transcript.length = base;
         this.speculativeAbortedCalls++;
-        log21.verbose(`speculation aborted (${this.speculativeAbortedCalls} total): "${spec.text.slice(0, 50)}"`);
+        log22.verbose(`speculation aborted (${this.speculativeAbortedCalls} total): "${spec.text.slice(0, 50)}"`);
         if (this.spec === spec) this.spec = void 0;
         return res ?? empty;
       }
@@ -10164,7 +10419,7 @@ Another agent just implemented the above. Independently check the CURRENT state
     this.notify("task_verify", `task ${id}: verifying`, { id });
     const cres = await new Agent(checkerOpts).run(checkBrief);
     if (cres.finishReason !== "stop") {
-      log21.warn(`task ${id}: verify inconclusive (${cres.finishReason})`);
+      log22.warn(`task ${id}: verify inconclusive (${cres.finishReason})`);
       this.notify("task_verify", `task ${id}: verify inconclusive (${cres.finishReason})`, { id, finishReason: cres.finishReason });
     }
     const sum = (a = 0, b = 0) => a + b;
@@ -10300,7 +10555,7 @@ Another agent just implemented the above. Independently check the CURRENT state
     rec.status = "done";
     rec.result = res.text;
     const incomplete = res.finishReason !== "stop" && res.finishReason !== "empty";
-    log21.verbose(`task ${id} done (${res.steps} steps${incomplete ? `, INCOMPLETE: ${res.finishReason}` : ""})`);
+    log22.verbose(`task ${id} done (${res.steps} steps${incomplete ? `, INCOMPLETE: ${res.finishReason}` : ""})`);
     this.notify("task_done", `task ${id} (${rec.label}) completed`, {
       id,
       text: res.text,
@@ -10334,14 +10589,14 @@ Another agent just implemented the above. Independently check the CURRENT state
   foldIfSuperseded(rec, note) {
     if (rec.deliveryParked !== "moved_on") return false;
     if (note.trim()) this.voice.transcript.push({ role: "assistant", content: note });
-    log21.verbose(`task ${rec.id} settled but superseded (${rec.status}) \u2014 folded into transcript, not voiced`);
+    log22.verbose(`task ${rec.id} settled but superseded (${rec.status}) \u2014 folded into transcript, not voiced`);
     return true;
   }
   failTask(rec, msg) {
     this.dropAsk(rec.id);
     rec.status = "error";
     rec.result = msg;
-    log21.warn(`task ${rec.id} failed: ${msg}`);
+    log22.warn(`task ${rec.id} failed: ${msg}`);
     this.notify("task_error", `task ${rec.id} (${rec.label}) failed: ${msg}`, { id: rec.id });
     if (this.foldIfSuperseded(rec, `The "${rec.label}" task failed: ${msg}`)) return;
     this.dropParked(rec);
@@ -10580,7 +10835,7 @@ Another agent just implemented the above. Independently check the CURRENT state
 // src/modelRouter.ts
 init_llm();
 init_logging();
-var log22 = forComponent("ModelRouter");
+var log23 = forComponent("ModelRouter");
 var ModelRouterOptions = class {
   classifier = jevClassifier();
   /** Capability tiers → model id (any provider). basic/standard run the main session; premium is only ever an offload. */
@@ -10664,10 +10919,10 @@ var ModelRouter = class {
       if (tier === "premium") d.offload = this.state.offload && (c.sameThread ?? 0) >= o.sameThreadAt ? "continue" : "fresh";
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
-      log22.warn(`classifier failed, falling back to standard: ${msg}`);
+      log23.warn(`classifier failed, falling back to standard: ${msg}`);
       d = { tier: "standard", model: o.models.standard, probs: {}, fallback: msg, classifyMs: Math.round(performance.now() - t0) };
     }
-    log22.info(`route ${d.tier}${d.offload ? `(${d.offload})` : ""} \xB7 argmax=${d.choice ?? "-"} \xB7 p=${JSON.stringify(d.probs)}${d.sameThread != null ? ` \xB7 same=${d.sameThread.toFixed(2)}` : ""} \xB7 ${d.classifyMs}ms`);
+    log23.info(`route ${d.tier}${d.offload ? `(${d.offload})` : ""} \xB7 argmax=${d.choice ?? "-"} \xB7 p=${JSON.stringify(d.probs)}${d.sameThread != null ? ` \xB7 same=${d.sameThread.toFixed(2)}` : ""} \xB7 ${d.classifyMs}ms`);
     return d;
   }
   /** Run one user turn on `agent` with routing. Returns a RunResult carrying `costUsd` + `routing`. */
@@ -10719,7 +10974,7 @@ ${text}`;
     const answer = res.text || `(premium sub-agent finished with no reply; finishReason=${res.finishReason})`;
     agent.transcript.push({ role: "user", content }, { role: "assistant", content: answer });
     this.state.offload = { messages: child.transcript, mainLen: agent.transcript.length, question: text };
-    log22.info(`offload ${cont ? "continue" : "fresh"} done \xB7 ${res.finishReason} \xB7 ${res.steps} steps`);
+    log23.info(`offload ${cont ? "continue" : "fresh"} done \xB7 ${res.finishReason} \xB7 ${res.steps} steps`);
     const costUsd = o.costOf(main, briefUsage) + o.costOf(o.models.premium, res.usage);
     return { ...res, text: answer, messages: agent.transcript, usage: addUsage(briefUsage, res.usage), costUsd, routing: d };
   }
@@ -10735,7 +10990,7 @@ The request:
 ${text}`);
       return { text: r.text.trim() || text, usage: r.usage };
     } catch (e) {
-      log22.warn(`brief failed, sending the raw request: ${e instanceof Error ? e.message : String(e)}`);
+      log23.warn(`brief failed, sending the raw request: ${e instanceof Error ? e.message : String(e)}`);
       return { text };
     } finally {
       agent.transcript = snap;
@@ -10767,8 +11022,8 @@ async function loadJev(opts) {
   const env = { ...process.env };
   const file = opts.envFile ?? process.env.AGENTX_JEV_ENV;
   if (file) {
-    const { readFileSync: readFileSync3 } = await import("fs");
-    for (const l of readFileSync3(file, "utf8").split("\n")) {
+    const { readFileSync: readFileSync4 } = await import("fs");
+    for (const l of readFileSync4(file, "utf8").split("\n")) {
       const m = l.match(/^\s*([A-Z0-9_]+)\s*=\s*(.*?)\s*$/);
       if (m && !env[m[1]]) env[m[1]] = m[2].replace(/^['"]|['"]$/g, "");
     }
@@ -10780,7 +11035,7 @@ async function jevAvailable(opts = {}) {
     const { env } = await loadJev(opts);
     return JEV_KEYS.some((k) => env[k]?.trim());
   } catch (e) {
-    log22.debug(`jev unavailable: ${e instanceof Error ? e.message : String(e)}`);
+    log23.debug(`jev unavailable: ${e instanceof Error ? e.message : String(e)}`);
     return false;
   }
 }