miii-agent 0.1.25 → 0.1.27

package/README.md

@@ -8,6 +8,7 @@
 
 <p align="center">
   <a href="https://www.npmjs.com/package/miii-agent"><img src="https://img.shields.io/npm/v/miii-agent" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/miii-agent"><img src="https://img.shields.io/npm/dt/miii-agent" alt="npm total downloads"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="node version"></a>
   <a href="https://ollama.com"><img src="https://img.shields.io/badge/powered%20by-Ollama-black" alt="powered by Ollama"></a>
@@ -29,10 +30,12 @@ Your code never leaves your disk. There's nothing to log in to. Pull a model, ty
 
 ```bash
 ollama pull qwen2.5-coder:14b   # any coding model works
-npm install -g miii-agent
+curl -fsSL https://raw.githubusercontent.com/maruakshay/miii-cli/main/install.sh | sh
 miii
 ```
 
+Prefer npm? `npm install -g miii-agent`.
+
 Then just talk to it:
 
 ```
@@ -43,6 +46,19 @@ Then just talk to it:
 
 > **Needs:** Node ≥ 18 and [Ollama](https://ollama.com/download) running locally.
 
+## Staying up to date
+
+miii checks npm on launch and, when a newer release exists, pulls it in the
+background — it applies the next time you start. Manual options:
+
+```bash
+miii update     # update now
+miii --version  # what you're running
+```
+
+Opt out of background updates by adding `"autoUpdate": false` to `~/.miii/config.json`,
+or re-run the install script (`curl … | sh`) any time to update by hand.
+
 ## Why local-first?
 
 Most "AI coding tools" are just wrappers around a cloud API — slow, metered, and they ship your private codebase to someone else's server.
@@ -68,6 +84,10 @@ It doesn't just chat, either — it decomposes the problem, calls tools, and che
   miii doctor                  # grade every installed model
   miii doctor qwen2.5-coder:7b # grade one
   ```
+- **🖼️ Paste images** — copy a screenshot and hit `Ctrl+V` to attach it to your message, or paste an image file path. Great for "why does this UI look broken?" or reading an error screenshot. **Needs a vision-capable model** (`llava`, `llama3.2-vision`, `qwen2-vl`, …) — text-only models silently ignore the image.
+  ```bash
+  ollama pull llava            # or llama3.2-vision
+  ```
 - **💧 Lossless output spill** — that 50K-line test log won't get truncated and leave the model guessing. miii spills the full output to disk and lets the model page through it. Nothing is ever lost.
 - **🔒 Permission-gated tools** — you approve what the agent can touch; "always" approvals persist. File tools are confined to your working directory.
 - **📄 `MIII.md`** — drop one in your repo to teach miii your conventions, build/test commands, and do's & don'ts. Same idea as `CLAUDE.md`, read every turn.
@@ -96,6 +116,7 @@ File tools (`read_file`, `write_file`, `edit_file`) reject `../` traversal and a
 |-----|--------|
 | `Enter` | Send prompt |
 | `@filename` | Attach file to context |
+| `Ctrl+V` | Paste clipboard image (needs a vision model) |
 | `/models` | Switch active model |
 | `/clear` | Reset conversation |
 | `Esc` | Stop generation or tool run |

package/dist/cli.js

@@ -35,9 +35,13 @@ function migrate(raw) {
     provider: raw.provider,
     effort: raw.effort,
     providers,
-    modelContexts: raw.modelContexts
+    modelContexts: raw.modelContexts,
+    autoUpdate: raw.autoUpdate
   };
 }
+function autoUpdateEnabled(cfg = loadConfig()) {
+  return cfg.autoUpdate !== false;
+}
 function readRawConfig() {
   if (!existsSync(CONFIG_PATH)) return {};
   try {
@@ -129,6 +133,15 @@ function isConnectionError(err) {
   const msg = err instanceof Error ? err.message : String(err);
   return msg.includes("ECONNREFUSED") || msg.includes("fetch failed") || msg.includes("connect");
 }
+function isNoVisionError(err) {
+  const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+  return msg.includes("does not support image") || msg.includes("image input");
+}
+function noVisionError(model) {
+  return new Error(
+    `"${model}" can't read images \u2014 it has no vision support. Switch to a vision-capable model (e.g. llava, llama3.2-vision, qwen2-vl) with /models, then resend. Pull one with: ollama pull llava`
+  );
+}
 async function listModels(entry) {
   try {
     const { models } = await makeClient(entry).list();
@@ -208,6 +221,7 @@ async function* chat(entry, model, messages, tools, opts) {
     }
   } catch (err) {
     if (signal?.aborted) return;
+    if (isNoVisionError(err)) throw noVisionError(model);
     if (isConnectionError(err)) {
       throw new Error(NOT_RUNNING);
     }
@@ -233,6 +247,7 @@ async function* chat(entry, model, messages, tools, opts) {
     }
   } catch (err) {
     if (opts?.signal?.aborted) return;
+    if (isNoVisionError(err)) throw noVisionError(model);
     if (isConnectionError(err)) {
       throw new Error(NOT_RUNNING);
     }
@@ -1292,7 +1307,8 @@ Ask in a numbered list. One round of questions per turn. Then wait.
 
 # Tool calls
 - When you need a tool, emit the tool call directly. No preamble, no narration, no "I will use X".
-- Never describe a tool call instead of emitting it. If you cannot emit the call, answer in plain text.
+- Use the native function-calling interface as the ONLY channel for tool calls. Never print a tool call as text \u2014 not as JSON, not as a fenced code block, not as \`call:name{...}\`, not in any custom or tagged syntax. Text-form calls do NOT execute; they leak to the user and nothing happens.
+- If you cannot emit a real function call, do not fake one in prose \u2014 answer in plain text instead.
 - After a tool result, move directly to the next tool call or the final answer. Do not restate what the previous tool did.
 
 # Tools
@@ -1429,7 +1445,9 @@ function toOllamaMessages(history, system) {
   const out = [{ role: "system", content: system }];
   for (const msg of history) {
     if (typeof msg.content === "string") {
-      out.push({ role: msg.role === "system" ? "system" : msg.role, content: msg.content });
+      const om = { role: msg.role === "system" ? "system" : msg.role, content: msg.content };
+      if (msg.role === "user" && msg.images && msg.images.length > 0) om.images = msg.images;
+      out.push(om);
       continue;
     }
     if (msg.role === "assistant") {
@@ -1462,6 +1480,11 @@ function parseTextToolCalls(text, knownToolNames) {
   if (!text) return { calls: [], cleanedText: text };
   const calls = [];
   let cleaned = text;
+  const callSyntax = parseCallSyntax(cleaned, knownToolNames);
+  if (callSyntax.calls.length > 0) {
+    calls.push(...callSyntax.calls);
+    cleaned = callSyntax.cleanedText;
+  }
   const tagRe = /<\|?tool_call\|?>\s*([\s\S]*?)\s*<\|?\/?tool_call\|?>/g;
   cleaned = cleaned.replace(tagRe, (_m, body) => {
     const c = tryParse(body, knownToolNames);
@@ -1502,6 +1525,74 @@ function tryParse(raw, knownToolNames) {
     return null;
   }
 }
+function parseCallSyntax(text, knownToolNames) {
+  const calls = [];
+  const headRe = /call:\s*([a-zA-Z_]\w*)\s*\{/g;
+  let m;
+  let cleaned = "";
+  let lastEnd = 0;
+  while ((m = headRe.exec(text)) !== null) {
+    const name = m[1];
+    const body = parseCallBody(text, m.index + m[0].length);
+    if (!body) continue;
+    headRe.lastIndex = body.end;
+    if (!knownToolNames.includes(name)) continue;
+    calls.push({ function: { name, arguments: body.args } });
+    cleaned += text.slice(lastEnd, m.index);
+    lastEnd = body.end;
+  }
+  cleaned += text.slice(lastEnd);
+  return { calls, cleanedText: cleaned.trim() };
+}
+function parseCallBody(text, start) {
+  const args2 = {};
+  let i = start;
+  const isWs = (c) => c === " " || c === "	" || c === "\n" || c === "\r";
+  while (i < text.length) {
+    while (i < text.length && (isWs(text[i]) || text[i] === ",")) i++;
+    if (i >= text.length) return null;
+    if (text[i] === "}") return { args: args2, end: i + 1 };
+    const keyStart = i;
+    while (i < text.length && text[i] !== ":" && text[i] !== "}") i++;
+    if (i >= text.length || text[i] !== ":") return null;
+    const key = text.slice(keyStart, i).trim().replace(/^["']|["']$/g, "");
+    i++;
+    while (i < text.length && isWs(text[i])) i++;
+    if (text.startsWith(VAL_DELIM, i)) {
+      const vStart = i + VAL_DELIM.length;
+      const vEnd = text.indexOf(VAL_DELIM, vStart);
+      if (vEnd === -1) return null;
+      args2[key] = text.slice(vStart, vEnd);
+      i = vEnd + VAL_DELIM.length;
+    } else {
+      const vStart = i;
+      let depth = 0;
+      let inStr = null;
+      let esc = false;
+      while (i < text.length) {
+        const ch = text[i];
+        if (inStr) {
+          if (esc) esc = false;
+          else if (ch === "\\") esc = true;
+          else if (ch === inStr) inStr = null;
+        } else if (ch === '"' || ch === "'") inStr = ch;
+        else if (ch === "{" || ch === "[") depth++;
+        else if (ch === "}" || ch === "]") {
+          if (depth === 0) break;
+          depth--;
+        } else if (ch === "," && depth === 0) break;
+        i++;
+      }
+      const rawVal = text.slice(vStart, i).trim();
+      try {
+        args2[key] = JSON.parse(rawVal);
+      } catch {
+        args2[key] = rawVal.replace(/^["']|["']$/g, "");
+      }
+    }
+  }
+  return null;
+}
 function extractFirstJsonObject(s) {
   const start = s.indexOf("{");
   if (start === -1) return null;
@@ -1528,6 +1619,18 @@ function extractFirstJsonObject(s) {
   }
   return null;
 }
+function looksLikeLeakedToolCall(text, knownToolNames) {
+  if (!text) return false;
+  if (text.includes(VAL_DELIM)) return true;
+  if (/<\|?tool_call/i.test(text)) return true;
+  const callMatch = text.match(/\bcall:\s*(\w+)\s*\{/);
+  if (callMatch && knownToolNames.includes(callMatch[1])) return true;
+  if (/"name"\s*:\s*"([^"]+)"/.test(text) && /"(arguments|parameters|input)"\s*:/.test(text)) {
+    const name = text.match(/"name"\s*:\s*"([^"]+)"/)?.[1];
+    if (name && knownToolNames.includes(name)) return true;
+  }
+  return false;
+}
 function blocksFromOllama(text, tool_calls, knownToolNames = []) {
   const blocks = [];
   let finalText = text;
@@ -1550,9 +1653,11 @@ function blocksFromOllama(text, tool_calls, knownToolNames = []) {
   }
   return blocks;
 }
+var VAL_DELIM;
 var init_adapter = __esm({
   "src/agent/adapter.ts"() {
     "use strict";
+    VAL_DELIM = '<|"|>';
   }
 });
 
@@ -1615,12 +1720,17 @@ async function* runAgent(opts) {
   const effort = EFFORT_OPTIONS[loadConfig().effort ?? "medium"];
   const history = [
     ...opts.history,
-    { role: "user", content: opts.userText }
+    {
+      role: "user",
+      content: opts.userText,
+      ...opts.images && opts.images.length > 0 ? { images: opts.images } : {}
+    }
   ];
   let promptTokens = 0;
   let evalTokens = 0;
   let lastAssistantSig = "";
   let repeatCount = 0;
+  let leakNudges = 0;
   const seenPaths = /* @__PURE__ */ new Set();
   for (let turn = 0; turn < MAX_TURNS; turn++) {
     let text = "";
@@ -1705,6 +1815,16 @@ async function* runAgent(opts) {
       continue;
     }
     if (tool_uses.length === 0) {
+      const assistantText = blocks.filter((b) => b.type === "text").map((b) => b.text).join("");
+      if (leakNudges < MAX_LEAK_NUDGES && looksLikeLeakedToolCall(assistantText, toolNames)) {
+        leakNudges++;
+        history.push({
+          role: "user",
+          content: "That tool call was written as plain text, so it did not run and nothing happened. Re-issue it using the function-calling interface only \u2014 do not print the call as text, JSON, or any custom syntax. If you did not mean to call a tool, answer in prose."
+        });
+        yield { type: "turn-end", stop_reason: "tool_use" };
+        continue;
+      }
       yield { type: "turn-end", stop_reason: "end_turn" };
       break;
     }
@@ -1812,7 +1932,7 @@ async function* runAgent(opts) {
   yield { type: "done", prompt_tokens: promptTokens, eval_tokens: evalTokens };
   return history;
 }
-var MAX_TURNS, REPEAT_TAIL, REPEAT_KILL, BIG_WRITE_TOOLS;
+var MAX_TURNS, REPEAT_TAIL, REPEAT_KILL, MAX_LEAK_NUDGES, BIG_WRITE_TOOLS;
 var init_loop = __esm({
   "src/agent/loop.ts"() {
     "use strict";
@@ -1828,21 +1948,22 @@ var init_loop = __esm({
     MAX_TURNS = 25;
     REPEAT_TAIL = 120;
     REPEAT_KILL = 4;
+    MAX_LEAK_NUDGES = 2;
     BIG_WRITE_TOOLS = /* @__PURE__ */ new Set(["write_file", "edit_file"]);
   }
 });
 
 // eval/runner.ts
-import { mkdtempSync, writeFileSync as writeFileSync7, mkdirSync as mkdirSync6, rmSync as rmSync3 } from "fs";
-import { dirname as dirname3, join as join8 } from "path";
-import { tmpdir } from "os";
+import { mkdtempSync, writeFileSync as writeFileSync8, mkdirSync as mkdirSync7, rmSync as rmSync4 } from "fs";
+import { dirname as dirname3, join as join11 } from "path";
+import { tmpdir as tmpdir2 } from "os";
 async function runScenario(model, s) {
-  const dir = mkdtempSync(join8(tmpdir(), "miii-eval-"));
+  const dir = mkdtempSync(join11(tmpdir2(), "miii-eval-"));
   const prevCwd = process.cwd();
   for (const [rel, content] of Object.entries(s.files ?? {})) {
-    const abs = join8(dir, rel);
-    mkdirSync6(dirname3(abs), { recursive: true });
-    writeFileSync7(abs, content, "utf-8");
+    const abs = join11(dir, rel);
+    mkdirSync7(dirname3(abs), { recursive: true });
+    writeFileSync8(abs, content, "utf-8");
   }
   const r = {
     name: s.name,
@@ -1880,7 +2001,7 @@ async function runScenario(model, s) {
   r.durationMs = Date.now() - start;
   if (r.error) {
     r.reason = `loop error: ${r.error}`;
-    rmSync3(dir, { recursive: true, force: true });
+    rmSync4(dir, { recursive: true, force: true });
     return r;
   }
   try {
@@ -1890,7 +2011,7 @@ async function runScenario(model, s) {
   } catch (err) {
     r.reason = `check threw: ${err instanceof Error ? err.message : String(err)}`;
   }
-  rmSync3(dir, { recursive: true, force: true });
+  rmSync4(dir, { recursive: true, force: true });
   return r;
 }
 var autoYes;
@@ -1903,13 +2024,13 @@ var init_runner = __esm({
 });
 
 // eval/scenarios.ts
-import { readFileSync as readFileSync7, existsSync as existsSync6 } from "fs";
-import { join as join9 } from "path";
+import { readFileSync as readFileSync10, existsSync as existsSync8 } from "fs";
+import { join as join12 } from "path";
 var read, scenarios;
 var init_scenarios = __esm({
   "eval/scenarios.ts"() {
     "use strict";
-    read = (dir, f) => existsSync6(join9(dir, f)) ? readFileSync7(join9(dir, f), "utf-8") : null;
+    read = (dir, f) => existsSync8(join12(dir, f)) ? readFileSync10(join12(dir, f), "utf-8") : null;
     scenarios = [
       {
         name: "edit-exact-string",
@@ -2059,13 +2180,25 @@ init_client();
 init_config();
 import { useState as useState5, useEffect as useEffect4, useRef as useRef2 } from "react";
 import { Box as Box13, Text as Text13, useApp } from "ink";
-import { homedir as homedir6 } from "os";
+import { homedir as homedir8 } from "os";
 import { sep as sep2 } from "path";
 
 // src/ui/WelcomeBlock.tsx
 import { Box, Text } from "ink";
 import { jsx, jsxs } from "react/jsx-runtime";
-function WelcomeBlock({ model, activeCtx, effort, cwd, updateAvailable }) {
+function updateBannerText(version, status) {
+  switch (status) {
+    case "downloading":
+      return `\u2191 v${version} downloading in the background \u2014 restart miii to apply`;
+    case "installed":
+      return `\u2713 v${version} installed \u2014 restart miii to apply`;
+    case "failed":
+      return `\u2191 v${version} update failed \u2014 run \`miii update\` manually`;
+    default:
+      return `\u2191 v${version} available \u2014 run \`miii update\` to upgrade`;
+  }
+}
+function WelcomeBlock({ model, activeCtx, effort, cwd, updateAvailable, updateStatus = "idle" }) {
   const ctxLabel = activeCtx != null ? `${Math.round(activeCtx / 1024)}k ctx` : "\u2014 ctx";
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [
     /* @__PURE__ */ jsxs(
@@ -2092,7 +2225,7 @@ function WelcomeBlock({ model, activeCtx, effort, cwd, updateAvailable }) {
         ]
       }
     ),
-    updateAvailable && /* @__PURE__ */ jsx(Text, { color: "yellow", children: `\u2191 update available: v${updateAvailable} \u2014 run: miii --update` })
+    updateAvailable && /* @__PURE__ */ jsx(Text, { color: updateStatus === "failed" ? "red" : updateStatus === "installed" ? "green" : "yellow", children: updateBannerText(updateAvailable, updateStatus) })
   ] });
 }
 
@@ -2346,7 +2479,8 @@ function persistSession(id, messages, title) {
   };
   const lines = [JSON.stringify({ type: "meta", ...meta })];
   for (const message of messages) {
-    lines.push(JSON.stringify({ type: "message", message }));
+    const { images: _img, ...rest } = message;
+    lines.push(JSON.stringify({ type: "message", message: rest }));
   }
   writeFileSync2(sessionPath(id), lines.join("\n") + "\n", "utf-8");
 }
@@ -3240,6 +3374,7 @@ var EMPTY_STATE_HINTS = [
   "\u2022 /models \u2014 switch model or effort",
   "\u2022 /new \u2014 start a new chat",
   "\u2022 /sessions \u2014 view saved chats",
+  "\u2022 ctrl+v \u2014 paste an image (needs a vision model)",
   "\u2022 ctrl+t \u2014 toggle thinking"
 ];
 var EMPTY_STATE_TITLE = "Ask anything, or try:";
@@ -3685,7 +3820,7 @@ function useAgentRunner(model, activeCtx) {
     setPendingPermission(null);
     req.resolve(answers[cursor]);
   }
-  async function sendMessage(text) {
+  async function sendMessage(text, images) {
     if (busyRef.current || !model) return;
     busyRef.current = true;
     setBusy(true);
@@ -3743,6 +3878,7 @@ function useAgentRunner(model, activeCtx) {
         cwd: process.cwd(),
         history: agentHistory,
         userText: text,
+        images,
         permissions: { ask: askPermission },
         signal: controller.signal,
         num_ctx: activeCtx ?? void 0
@@ -3872,16 +4008,141 @@ function useAgentRunner(model, activeCtx) {
 }
 
 // src/ui/hooks/useKeyboard.ts
-init_config();
+import { existsSync as existsSync7, readFileSync as readFileSync8 } from "fs";
+import { basename, join as join9 } from "path";
+import { homedir as homedir6 } from "os";
 import { useInput, useStdout } from "ink";
+
+// src/ui/clipboard.ts
+import { execFileSync as execFileSync2 } from "child_process";
+import { existsSync as existsSync6, readFileSync as readFileSync7, rmSync as rmSync3 } from "fs";
+import { join as join8 } from "path";
+import { tmpdir } from "os";
+function safeRm(p) {
+  try {
+    rmSync3(p, { force: true });
+  } catch {
+  }
+}
+function consume(p) {
+  try {
+    const b64 = readFileSync7(p).toString("base64");
+    return b64.length > 0 ? b64 : null;
+  } catch {
+    return null;
+  } finally {
+    safeRm(p);
+  }
+}
+function readMac(out) {
+  try {
+    execFileSync2("pngpaste", [out], { stdio: "ignore" });
+    if (existsSync6(out)) return consume(out);
+  } catch {
+  }
+  const png = "\xABclass PNGf\xBB";
+  const script = [
+    "try",
+    `set f to open for access (POSIX file "${out}") with write permission`,
+    `set theData to (the clipboard as ${png})`,
+    "write theData to f",
+    "close access f",
+    "on error",
+    "try",
+    "close access f",
+    "end try",
+    'return "NOIMG"',
+    "end try"
+  ];
+  try {
+    const res = execFileSync2("osascript", script.flatMap((s) => ["-e", s]), { encoding: "utf8" });
+    if (res.includes("NOIMG")) {
+      safeRm(out);
+      return null;
+    }
+    if (existsSync6(out)) return consume(out);
+  } catch {
+  }
+  safeRm(out);
+  return null;
+}
+function readLinux(out) {
+  for (const [cmd2, args2] of [
+    ["wl-paste", ["--type", "image/png"]],
+    ["xclip", ["-selection", "clipboard", "-t", "image/png", "-o"]]
+  ]) {
+    try {
+      const buf = execFileSync2(cmd2, args2, { maxBuffer: 64 * 1024 * 1024 });
+      if (buf.length > 0) return buf.toString("base64");
+    } catch {
+    }
+  }
+  return null;
+}
+function readWindows(out) {
+  const ps = [
+    "Add-Type -AssemblyName System.Windows.Forms,System.Drawing;",
+    "$img = [System.Windows.Forms.Clipboard]::GetImage();",
+    // Single-quoted PS string → backslashes are literal, no escaping needed.
+    `if ($img -ne $null) { $img.Save('${out}', [System.Drawing.Imaging.ImageFormat]::Png); 'OK' } else { 'NOIMG' }`
+  ].join(" ");
+  try {
+    const res = execFileSync2(
+      "powershell",
+      ["-NoProfile", "-NonInteractive", "-STA", "-Command", ps],
+      { encoding: "utf8" }
+    );
+    if (res.includes("NOIMG")) {
+      safeRm(out);
+      return null;
+    }
+    if (existsSync6(out)) return consume(out);
+  } catch {
+  }
+  safeRm(out);
+  return null;
+}
+function readClipboardImage() {
+  const out = join8(tmpdir(), `miii-clip-${Date.now()}-${Math.random().toString(36).slice(2)}.png`);
+  if (process.platform === "darwin") return readMac(out);
+  if (process.platform === "linux") return readLinux(out);
+  if (process.platform === "win32") return readWindows(out);
+  return null;
+}
+
+// src/ui/hooks/useKeyboard.ts
+init_config();
 var EFFORTS = ["low", "medium", "high"];
 var PASTE_CHIP_LINES = 4;
 var PASTE_CHIP_CHARS = 200;
 var pasteStore = /* @__PURE__ */ new Map();
 var pasteCounter = 0;
+var imageStore = /* @__PURE__ */ new Map();
+var imageCounter = 0;
+var IMAGE_EXT_RE = /\.(png|jpe?g|webp|gif|bmp)$/i;
 function clearPasteStore() {
   pasteStore.clear();
   pasteCounter = 0;
+  imageStore.clear();
+  imageCounter = 0;
+}
+function tryImagePaste(cleaned) {
+  let p = cleaned.trim();
+  if (p.startsWith('"') && p.endsWith('"') || p.startsWith("'") && p.endsWith("'")) {
+    p = p.slice(1, -1);
+  }
+  p = p.replace(/\\ /g, " ");
+  if (p.includes("\n") || !IMAGE_EXT_RE.test(p)) return null;
+  if (p.startsWith("~/")) p = join9(homedir6(), p.slice(2));
+  if (!existsSync7(p)) return null;
+  try {
+    const b64 = readFileSync8(p).toString("base64");
+    const chip = `[Image #${++imageCounter} \xB7 ${basename(p)}]`;
+    imageStore.set(chip, b64);
+    return chip;
+  } catch {
+    return null;
+  }
 }
 var inputHistory = [];
 var historyIndex = -1;
@@ -3902,6 +4163,8 @@ function stripControls(chunk) {
 function sanitizePaste(chunk) {
   if (chunk.length <= 1) return chunk;
   const cleaned = stripControls(chunk).replace(/\r/g, "");
+  const imageChip = tryImagePaste(cleaned);
+  if (imageChip) return imageChip;
   const lines = cleaned.split("\n").length;
   if (lines > PASTE_CHIP_LINES || cleaned.length > PASTE_CHIP_CHARS) {
     const chip = `[Pasted #${++pasteCounter} \xB7 ${lines} line${lines === 1 ? "" : "s"}]`;
@@ -4136,6 +4399,19 @@ function useKeyboard(opts) {
     }
     if (state === "ready") {
       if (busyRef.current) return;
+      if (key.ctrl && char === "v") {
+        const b64 = readClipboardImage();
+        if (!b64) {
+          setNotice("no image in clipboard");
+          return;
+        }
+        const chip = `[Image #${++imageCounter} \xB7 clipboard]`;
+        imageStore.set(chip, b64);
+        historyIndex = -1;
+        setInput((s) => s.slice(0, caret) + chip + s.slice(caret));
+        setCaret((i) => i + chip.length);
+        return;
+      }
       const paletteOpen = input.startsWith("/");
       const matches2 = paletteOpen ? filteredCommands(input) : [];
       const mention = !paletteOpen ? parseMention(input) : null;
@@ -4248,8 +4524,16 @@ function useKeyboard(opts) {
           }
         } else if (trimmed) {
           setNotice(null);
-          const message = expandPastes(trimmed);
-          sendMessage(message);
+          const images = [];
+          let textPart = trimmed;
+          for (const [chip, b64] of imageStore) {
+            if (textPart.includes(chip)) {
+              images.push(b64);
+              textPart = textPart.split(chip).join("").trim();
+            }
+          }
+          const message = expandPastes(textPart) || "Describe the attached image.";
+          sendMessage(message, images.length ? images : void 0);
         }
         clearPasteStore();
         setInput(() => "");
@@ -4283,8 +4567,14 @@ function useKeyboard(opts) {
         for (const chip of pasteStore.keys()) {
           if (before.endsWith(chip) && chip.length > match.length) match = chip;
         }
+        for (const chip of imageStore.keys()) {
+          if (before.endsWith(chip) && chip.length > match.length) match = chip;
+        }
         const cut = match ? match.length : 1;
-        if (match) pasteStore.delete(match);
+        if (match) {
+          pasteStore.delete(match);
+          imageStore.delete(match);
+        }
         setInput((s) => s.slice(0, caret - cut) + s.slice(caret));
         setCaret((i) => Math.max(0, i - cut));
       } else if (char && !key.ctrl && !key.meta && !key.tab) {
@@ -4303,8 +4593,28 @@ function useKeyboard(opts) {
 
 // src/updateCheck.ts
 import { createRequire } from "module";
+import { homedir as homedir7 } from "os";
+import { join as join10 } from "path";
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync7, mkdirSync as mkdirSync6 } from "fs";
 var require2 = createRequire(import.meta.url);
 var PKG_NAME = "miii-agent";
+var UPDATE_ATTEMPT_PATH = join10(homedir7(), ".miii", ".last-update-attempt");
+var UPDATE_ATTEMPT_COOLDOWN_MS = 10 * 60 * 1e3;
+function recentlyAttemptedUpdate() {
+  try {
+    const last = Number(readFileSync9(UPDATE_ATTEMPT_PATH, "utf8").trim());
+    return Number.isFinite(last) && Date.now() - last < UPDATE_ATTEMPT_COOLDOWN_MS;
+  } catch {
+    return false;
+  }
+}
+function markUpdateAttempt() {
+  try {
+    mkdirSync6(join10(homedir7(), ".miii"), { recursive: true });
+    writeFileSync7(UPDATE_ATTEMPT_PATH, String(Date.now()));
+  } catch {
+  }
+}
 function currentVersion() {
   try {
     return require2("../package.json").version;
@@ -4320,6 +4630,30 @@ function newerVersion(current, latest) {
   if (lb !== cb) return lb > cb;
   return lc > cc;
 }
+function autoUpdate(onDone) {
+  if (recentlyAttemptedUpdate()) return false;
+  try {
+    markUpdateAttempt();
+    const { spawn } = require2("child_process");
+    const child = spawn("npm", ["i", "-g", `${PKG_NAME}@latest`], {
+      detached: true,
+      stdio: "ignore",
+      shell: process.platform === "win32"
+    });
+    let settled = false;
+    const settle = (ok) => {
+      if (settled) return;
+      settled = true;
+      onDone?.(ok);
+    };
+    child.on("error", () => settle(false));
+    child.on("exit", (code) => settle(code === 0));
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function checkForUpdate() {
   try {
     const res = await fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`, {
@@ -4340,7 +4674,7 @@ async function checkForUpdate() {
 import { Fragment as Fragment3, jsx as jsx13, jsxs as jsxs13 } from "react/jsx-runtime";
 function App() {
   const { exit } = useApp();
-  const cwd = process.cwd().replace(homedir6(), "~").split(sep2).join("/");
+  const cwd = process.cwd().replace(homedir8(), "~").split(sep2).join("/");
   const [cfg, setCfg] = useState5(loadConfig());
   const [models, setModels] = useState5([]);
   const [contexts, setContexts] = useState5(() => cfg.modelContexts ?? {});
@@ -4351,6 +4685,7 @@ function App() {
   const [cursor, setCursor] = useState5(0);
   const [pickerQuery, setPickerQuery] = useState5("");
   const [updateAvailable, setUpdateAvailable] = useState5(null);
+  const [updateStatus, setUpdateStatus] = useState5("idle");
   const [providerDown, setProviderDown] = useState5(false);
   const [sessionId, setSessionId] = useState5(() => newSessionId());
   const [sessions, setSessions] = useState5([]);
@@ -4362,7 +4697,12 @@ function App() {
   const agent = useAgentRunner(cfg.model, activeCtx);
   useEffect4(() => {
     checkForUpdate().then((v) => {
-      if (v) setUpdateAvailable(v);
+      if (!v) return;
+      setUpdateAvailable(v);
+      if (autoUpdateEnabled()) {
+        const started = autoUpdate((ok) => setUpdateStatus(ok ? "installed" : "failed"));
+        if (started) setUpdateStatus("downloading");
+      }
     });
   }, []);
   const titledSessions = useRef2(/* @__PURE__ */ new Set());
@@ -4479,7 +4819,7 @@ function App() {
     return Math.round(used / activeCtx * 100);
   })();
   return /* @__PURE__ */ jsxs13(Box13, { flexDirection: "column", paddingX: 1, children: [
-    state !== "ready" && /* @__PURE__ */ jsx13(WelcomeBlock, { model: cfg.model, activeCtx, effort, cwd, error: agent.error, updateAvailable }),
+    state !== "ready" && /* @__PURE__ */ jsx13(WelcomeBlock, { model: cfg.model, activeCtx, effort, cwd, error: agent.error, updateAvailable, updateStatus }),
     state === "loading" && !agent.error && /* @__PURE__ */ jsx13(Box13, { marginLeft: 2, marginBottom: 1, children: /* @__PURE__ */ jsx13(Text13, { dimColor: true, children: `connecting to ${provName}\u2026` }) }),
     agent.error && state !== "ready" && /* @__PURE__ */ jsx13(
       ChatView,
@@ -4540,7 +4880,8 @@ function App() {
         return /* @__PURE__ */ jsx13(FilePicker, { matches: searchFiles(process.cwd(), m.query), cursor: filePickerCursor });
       })(),
       /* @__PURE__ */ jsx13(InputBar, { input, caret, disabled: agent.busy, processingLabel: agent.processingLabel }),
-      !agent.busy && /* @__PURE__ */ jsx13(Box13, { marginLeft: 2, marginBottom: 1, children: /* @__PURE__ */ jsx13(Text13, { dimColor: true, children: providerDown ? "provider unavailable \u2014 /provider to switch \xB7 /models to pick a model" : "type / to see commands" }) })
+      !agent.busy && /* @__PURE__ */ jsx13(Box13, { marginLeft: 2, marginBottom: 1, children: /* @__PURE__ */ jsx13(Text13, { dimColor: true, children: providerDown ? "provider unavailable \u2014 /provider to switch \xB7 /models to pick a model" : "type / to see commands" }) }),
+      updateAvailable && /* @__PURE__ */ jsx13(Box13, { marginLeft: 2, marginBottom: 1, children: /* @__PURE__ */ jsx13(Text13, { color: updateStatus === "failed" ? "red" : updateStatus === "installed" ? "green" : "yellow", children: updateBannerText(updateAvailable, updateStatus) }) })
     ] })
   ] });
 }
@@ -4559,7 +4900,12 @@ for (let i = 0; i < args.length; i++) {
     cmd = args[i];
   }
 }
-if (cmd === "update" || cmd === "--update" || cmd === "-u") {
+if (cmd === "version" || cmd === "--version" || cmd === "-v") {
+  const { createRequire: createRequire2 } = await import("module");
+  const pkg = createRequire2(import.meta.url)("../package.json");
+  console.log(pkg.version);
+  process.exit(0);
+} else if (cmd === "update" || cmd === "--update" || cmd === "-u") {
   const { spawnSync } = await import("child_process");
   console.log("Updating miii-agent\u2026");
   const r = spawnSync("npm", ["i", "-g", "miii-agent@latest"], { stdio: "inherit", shell: process.platform === "win32" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miii-agent",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Cursor / Claude Code, but local. An offline AI pair-programmer in your terminal, powered by Ollama. Private by default, free forever.",
   "type": "module",
   "bin": {