@metaphi-ai/hum 0.1.4 → 0.1.6

package/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2026 Metaphi, Inc. All rights reserved.
+
+Hum is proprietary software of Metaphi, Inc.
+
+Metaphi, Inc. grants users it has authorized a personal, non-exclusive,
+non-transferable, revocable right to install and run the distributed
+packages (hum-cli on PyPI, @metaphi-ai/hum on npm) for use with Metaphi
+services.
+
+No other right is granted. Do not copy, modify, distribute, sublicense,
+reverse engineer, or create derivative works from this software, in whole
+or in part, without prior written permission from Metaphi, Inc.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL METAPHI, INC. BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY ARISING FROM THE USE OF THE SOFTWARE.

package/dist/cli.mjs

@@ -1257,7 +1257,7 @@ var require_react_development = __commonJS({
           }
           return lazyType;
         }
-        function forwardRef2(render2) {
+        function forwardRef3(render2) {
           {
             if (render2 != null && render2.$$typeof === REACT_MEMO_TYPE) {
               error("forwardRef requires a render function but received a `memo` component. Instead of forwardRef(memo(...)), use memo(forwardRef(...)).");
@@ -1402,7 +1402,7 @@ var require_react_development = __commonJS({
           var dispatcher = resolveDispatcher();
           return dispatcher.useMemo(create2, deps);
         }
-        function useImperativeHandle(ref, create2, deps) {
+        function useImperativeHandle2(ref, create2, deps) {
           var dispatcher = resolveDispatcher();
           return dispatcher.useImperativeHandle(ref, create2, deps);
         }
@@ -2155,7 +2155,7 @@ var require_react_development = __commonJS({
         exports.createElement = createElement$1;
         exports.createFactory = createFactory;
         exports.createRef = createRef;
-        exports.forwardRef = forwardRef2;
+        exports.forwardRef = forwardRef3;
         exports.isValidElement = isValidElement;
         exports.lazy = lazy;
         exports.memo = memo;
@@ -2167,7 +2167,7 @@ var require_react_development = __commonJS({
         exports.useDeferredValue = useDeferredValue;
         exports.useEffect = useEffect5;
         exports.useId = useId;
-        exports.useImperativeHandle = useImperativeHandle;
+        exports.useImperativeHandle = useImperativeHandle2;
         exports.useInsertionEffect = useInsertionEffect;
         exports.useLayoutEffect = useLayoutEffect2;
         exports.useMemo = useMemo3;
@@ -83569,22 +83569,34 @@ function renderMarkdown(text, width) {
 // src/input.jsx
 var import_react23 = __toESM(require_react(), 1);
 var import_jsx_runtime = __toESM(require_jsx_runtime(), 1);
-function MultilineInput({
+var MultilineInput = (0, import_react23.forwardRef)(function MultilineInput2({
   value,
   onChange,
   onSubmit,
+  onPasteImage,
   focus = true,
   placeholder = "",
   history = [],
   navActive = true
-}) {
+}, ref) {
   const [cursor, setCursor] = (0, import_react23.useState)(value.length);
   const hist = (0, import_react23.useRef)({ index: null, stash: "" });
+  const latest = (0, import_react23.useRef)({ value, cursor });
+  latest.current = { value, cursor };
   const clamp = (n, len) => Math.max(0, Math.min(n, len));
   const set = (v, c2) => {
     onChange(v);
     setCursor(clamp(c2, v.length));
   };
+  (0, import_react23.useImperativeHandle)(ref, () => ({
+    // text placed at the cursor as it is NOW (an image chip arrives after a round trip)
+    insert(text) {
+      const { value: v, cursor: cu } = latest.current;
+      const c2 = clamp(cu, v.length);
+      const sep = c2 > 0 && !/\s$/.test(v.slice(0, c2)) ? " " : "";
+      set(v.slice(0, c2) + sep + text + v.slice(c2), c2 + sep.length + text.length);
+    }
+  }));
   const lineStart = (v, c2) => v.lastIndexOf("\n", c2 - 1) + 1;
   const lineEnd = (v, c2) => {
     const i = v.indexOf("\n", c2);
@@ -83660,6 +83672,8 @@ function MultilineInput({
       else if (input === "w") {
         const head = value.slice(0, c2).replace(/\S+\s*$/, "");
         set(head + value.slice(c2), head.length);
+      } else if (input === "v") {
+        if (onPasteImage) onPasteImage();
       }
       return;
     }
@@ -83684,7 +83698,8 @@ function MultilineInput({
     shown = value.slice(0, c) + source_default.inverse(value[c]) + value.slice(c + 1);
   }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: shown });
-}
+});
+var input_default = MultilineInput;
 
 // src/app.jsx
 var import_jsx_runtime2 = __toESM(require_jsx_runtime(), 1);
@@ -83717,12 +83732,18 @@ var COMMANDS = [
   { name: "/compact", desc: "summarise and restart the context now" },
   { name: "/model", desc: "switch the model for this session (/model <name>)" },
   { name: "/cost", desc: "tokens and cost so far" },
+  { name: "/approve", desc: "approvals on|off \u2014 whether changes and commands wait for you first" },
+  { name: "/continue", desc: "after a pause: let the agent carry on" },
+  { name: "/image", desc: "attach an image file to your next message (/image <path>); ctrl+v pastes a screenshot" },
   { name: "/tools", desc: "what is mounted" },
   { name: "/help", desc: "keys and commands" },
   { name: "/quit", desc: "save and leave" }
 ];
-var HELP = "!cmd runs a command as you \xB7 esc interrupts the model (what it had is kept) \xB7 type while it works to steer \xB7 edit files in your editor any time (recorded as your turn) \xB7 /resume picks a past session \xB7 /compact restarts the context from a summary \xB7 ctrl+c twice quits";
-function App2({ engine: engine2, task, resume }) {
+var HELP = "!cmd runs a command as you \xB7 esc interrupts the model (what it had is kept) \xB7 type while it works to steer \xB7 edit files in your editor any time (recorded as your turn) \xB7 ctrl+o shows the full output of the last tool result \xB7 ctrl+v pastes a screenshot from the clipboard \xB7 @path.png or /image <path> attaches an image file \xB7 /approve makes changes and commands wait for you (enter approves, a typed reason rejects) \xB7 /resume picks a past session \xB7 /compact restarts the context from a summary \xB7 ctrl+c twice quits";
+var DIFF_TAIL_LINES = 20;
+var OUTPUT_MAX_LINES = 200;
+var ERR_TAIL_LINES = 5;
+function App2({ engine: engine2, task, resume, images = [] }) {
   const { exit } = use_app_default();
   const { stdout } = use_stdout_default();
   const width = (stdout?.columns || 80) - 2;
@@ -83739,6 +83760,11 @@ function App2({ engine: engine2, task, resume }) {
   const [elapsed, setElapsed] = (0, import_react24.useState)(0);
   const [ctrlc, setCtrlc] = (0, import_react24.useState)(0);
   const [picker, setPicker] = (0, import_react24.useState)(null);
+  const [proposal, setProposal] = (0, import_react24.useState)(null);
+  const [gate, setGate] = (0, import_react24.useState)("off");
+  const [paused, setPaused] = (0, import_react24.useState)(false);
+  const attachRef = (0, import_react24.useRef)([]);
+  const inputRef = (0, import_react24.useRef)(null);
   const nextId = (0, import_react24.useRef)(0);
   const phaseRef = (0, import_react24.useRef)("connecting");
   const turnT0 = (0, import_react24.useRef)(null);
@@ -83747,12 +83773,15 @@ function App2({ engine: engine2, task, resume }) {
   const toolsRef = (0, import_react24.useRef)({});
   const historyRef = (0, import_react24.useRef)(loadHistory());
   const modelRef = (0, import_react24.useRef)("");
+  const lastOutRef = (0, import_react24.useRef)(null);
+  const [meter, setMeter] = (0, import_react24.useState)({ tokens: 0, cap: 0, input: 0, output: 0 });
   const setPhaseBoth = (p) => {
     phaseRef.current = p;
     setPhase(p);
   };
   const append = (item) => setItems((prev) => [...prev, { id: nextId.current++, ...item }]);
   const menu = value.trimStart().startsWith("/") && !value.includes(" ") ? COMMANDS.filter((c) => c.name.startsWith(value.trim())) : [];
+  const ctxPct = meter.cap > 0 && meter.tokens > 0 ? Math.round(meter.tokens / meter.cap * 100) : 0;
   (0, import_react24.useEffect)(() => {
     if (phase !== "busy" && phase !== "connecting") return void 0;
     const started = Date.now();
@@ -83814,13 +83843,21 @@ function App2({ engine: engine2, task, resume }) {
       case "hello":
         setHello(ev);
         modelRef.current = ev.model;
+        setMeter((m) => ({ ...m, tokens: 0, cap: ev.compact_at || 0 }));
+        setGate(ev.gate === "approve" ? "approve" : "off");
         append({ kind: "banner", text: `${ev.model}${ev.user ? ` \xB7 ${ev.user}` : ""} \xB7 ${ev.cwd} \xB7 tools: ${ev.tools.join(", ")}` });
-        if (task) engine2.send({ cmd: "start", task });
-        else if (resume === "pick") {
+        if (task) {
+          if (images.length && !ev.images) append({ kind: "warn", text: "this engine does not take images; update hum" });
+          engine2.send({ cmd: "start", task, images: ev.images ? images : [] });
+        } else if (resume === "pick") {
           setPhaseBoth("idle");
           engine2.send({ cmd: "sessions" });
         } else if (resume) engine2.send({ cmd: "resume", name: resume });
-        else setPhaseBoth("idle");
+        else {
+          setPhaseBoth("idle");
+          if (ev.images) images.forEach((p) => engine2.send({ cmd: "attach", path: p }));
+          else if (images.length) append({ kind: "warn", text: "this engine does not take images; update hum" });
+        }
         break;
       case "sessions":
         if (!ev.items || ev.items.length === 0) {
@@ -83832,6 +83869,8 @@ function App2({ engine: engine2, task, resume }) {
       case "session":
         setSession(ev.name);
         setSpend(0);
+        setPaused(false);
+        setProposal(null);
         if (ev.model) modelRef.current = ev.model;
         append({ kind: "info", text: `session ${ev.name}` });
         break;
@@ -83858,15 +83897,26 @@ function App2({ engine: engine2, task, resume }) {
       case "tool_pending":
         break;
       // the status line already shows it; the call itself lands as a transcript line
-      case "tool_call":
+      case "tool_call": {
         foldThinking();
         flushDraft();
         toolsRef.current[ev.id] = ev;
-        append({ kind: "tool", text: ev.desc || ev.name, name: ev.name, args: ev.args });
+        const label = ev.name === "write_file" && ev.lines != null ? `${ev.desc || ev.name}  (${ev.lines} lines)` : ev.desc || ev.name;
+        append({ kind: "tool", text: label, name: ev.name, args: ev.args });
+        if (ev.diff) {
+          const ls = ev.diff.split("\n");
+          append({ kind: "diff", lines: ls.slice(0, DIFF_TAIL_LINES), more: Math.max(0, ls.length - DIFF_TAIL_LINES) });
+        }
         break;
+      }
       case "tool_result": {
-        const more = (ev.lines || 0) > 1 ? `  (+${ev.lines - 1} lines)` : "";
+        lastOutRef.current = { name: ev.name, content: ev.content || "" };
+        const more = (ev.lines || 0) > 1 ? `  (+${ev.lines - 1} lines \xB7 ctrl+o expands)` : "";
         append({ kind: "tool_result", text: `${ev.summary || "(no output)"}${more}`, isError: !ev.ok });
+        if (!ev.ok && ev.content) {
+          const t = ev.content.split("\n").filter((l) => l.trim()).slice(-ERR_TAIL_LINES);
+          if (t.length > 1) append({ kind: "errtail", lines: t });
+        }
         break;
       }
       case "plan": {
@@ -83876,11 +83926,37 @@ function App2({ engine: engine2, task, resume }) {
         append({ kind: "plan", steps: (ev.steps || []).map((st) => ({ ...st, glyph: glyph[st.status] || "\u25FB" })), explanation: ev.explanation });
         break;
       }
+      case "proposal":
+        foldThinking();
+        flushDraft();
+        setProposal({ content: ev.content || "", calls: ev.calls || [] });
+        setStatus("waiting for your decision");
+        break;
+      case "paused":
+        foldThinking();
+        flushDraft();
+        setPaused(true);
+        append({ kind: "paused", text: ev.detail, trip: ev.kind });
+        break;
+      case "resumed":
+        setPaused(false);
+        turnT0.current = Date.now();
+        setPhaseBoth("busy");
+        break;
+      case "proposal_released":
+        setProposal(null);
+        append({ kind: "info", text: "approvals off: the waiting proposal ran" });
+        break;
+      case "gate":
+        setGate(ev.mode);
+        append({ kind: "info", text: ev.mode === "approve" ? "approvals on: changes and commands wait for you first" : "approvals off: the agent acts, you steer" });
+        break;
       case "human_edit":
         append({ kind: "info", text: `you edited files: ${ev.stat}` });
         break;
       case "compaction":
-        append({ kind: "info", text: "context summarised and restarted (the session keeps everything)" });
+        append({ kind: "info", text: `context summarised and restarted${ev.prompt_tokens_before ? ` at ${ev.prompt_tokens_before.toLocaleString()} tokens` : ""} (the session keeps everything)` });
+        setMeter((m) => ({ ...m, tokens: 0 }));
         break;
       case "retry":
         append({ kind: "info", text: `model connection: ${ev.text} \u2014 retrying (${ev.attempt})` });
@@ -83888,6 +83964,8 @@ function App2({ engine: engine2, task, resume }) {
       case "interrupted":
         foldThinking();
         flushDraft();
+        setProposal(null);
+        setPaused(false);
         append({ kind: "info", text: ev.kept ? "stopped \xB7 what it had so far is kept in the session" : "stopped" });
         setPhaseBoth("idle");
         setStatus("");
@@ -83895,14 +83973,22 @@ function App2({ engine: engine2, task, resume }) {
       case "turn_end": {
         foldThinking();
         flushDraft();
+        setMeter((m) => ({ ...m, tokens: ev.context_tokens ?? m.tokens, input: ev.input_tokens || 0, output: ev.output_tokens || 0 }));
         setSpend(ev.cost_usd);
         const dur = turnT0.current ? fmtDur((Date.now() - turnT0.current) / 1e3) : fmtDur(ev.elapsed_s);
         turnT0.current = null;
-        append({ kind: "turn", text: `${dur} \xB7 ${ev.turns} steps \xB7 ${fmtCost(ev.cost_usd)} session` + (ev.stop_reason !== "done" ? ` \xB7 stopped: ${ev.stop_reason}` : "") });
+        append({ kind: "turn", text: `${dur} \xB7 ${ev.turns} steps \xB7 ${fmtCost(ev.cost_usd)} session` + (ev.stop_reason !== "done" && !String(ev.stop_reason).startsWith("paused") ? ` \xB7 stopped: ${ev.stop_reason}` : "") });
         setPhaseBoth("idle");
         setStatus("");
         break;
       }
+      case "image": {
+        const n = attachRef.current.length + 1;
+        const { type, label, ...ref } = ev;
+        attachRef.current = [...attachRef.current, { ref, n, label: label || ref.name || "image", chip: `[Image #${n}]` }];
+        if (inputRef.current) inputRef.current.insert(`[Image #${n}] `);
+        break;
+      }
       case "info":
         append({ kind: "info", text: ev.text });
         break;
@@ -83952,6 +84038,25 @@ function App2({ engine: engine2, task, resume }) {
       quit();
       return;
     }
+    if (key.ctrl && input === "o") {
+      const last = lastOutRef.current;
+      if (last && last.content) {
+        const ls = last.content.split("\n");
+        append({ kind: "output", name: last.name, lines: ls.slice(0, OUTPUT_MAX_LINES), more: Math.max(0, ls.length - OUTPUT_MAX_LINES) });
+      }
+      return;
+    }
+    if (proposal && !picker) {
+      if (key.return && !value.trim()) {
+        decide("accept");
+        return;
+      }
+      if (key.escape) {
+        setProposal(null);
+        engine2.send({ cmd: "interrupt" });
+        return;
+      }
+    }
     if (picker) {
       if (key.upArrow) setPicker((p) => ({ ...p, index: (p.index + p.items.length - 1) % p.items.length }));
       else if (key.downArrow || key.tab) setPicker((p) => ({ ...p, index: (p.index + 1) % p.items.length }));
@@ -83973,6 +84078,13 @@ function App2({ engine: engine2, task, resume }) {
   (0, import_react24.useEffect)(() => {
     setMenuIndex(0);
   }, [value]);
+  const decide = (decision, note) => {
+    const p = proposal;
+    setProposal(null);
+    const what = p && p.calls.length ? p.calls.map((c) => c.desc).join(" \xB7 ") : "the proposal";
+    append({ kind: "you", text: decision === "accept" ? `approved: ${what}` : `rejected: ${what}${note ? ` \u2014 ${note}` : ""}` });
+    engine2.send({ cmd: "decide", decision, note: note || "" });
+  };
   const runCommand = (line) => {
     const [name, ...rest] = line.split(/\s+/);
     const arg = rest.join(" ").trim();
@@ -84000,12 +84112,27 @@ function App2({ engine: engine2, task, resume }) {
           engine2.send({ cmd: "model", name: arg });
         } else append({ kind: "info", text: `model: ${modelRef.current}` });
         break;
-      case "/cost":
-        append({ kind: "info", text: `${fmtCost(spend)} this session` });
+      case "/cost": {
+        const ctx = ctxPct > 0 ? ` \xB7 context ${ctxPct}% of the compaction threshold` : "";
+        append({ kind: "info", text: `${fmtCost(spend)} this session \xB7 ${meter.input.toLocaleString()}+${meter.output.toLocaleString()} tokens${ctx}` });
+        break;
+      }
+      case "/image":
+        if (!hello?.images) append({ kind: "warn", text: "this engine does not take images; update hum" });
+        else if (!arg) append({ kind: "info", text: "/image <path> attaches the file to your next message \xB7 ctrl+v pastes a screenshot \xB7 @path.png in a message works too" });
+        else engine2.send({ cmd: "attach", path: arg });
         break;
       case "/tools":
         append({ kind: "info", text: (hello?.tools || []).join(", ") });
         break;
+      case "/continue":
+        engine2.send({ cmd: "continue" });
+        break;
+      case "/approve": {
+        const mode = arg === "on" ? "approve" : arg === "off" ? "off" : gate === "approve" ? "off" : "approve";
+        engine2.send({ cmd: "gate", mode });
+        break;
+      }
       default:
         break;
     }
@@ -84013,12 +84140,20 @@ function App2({ engine: engine2, task, resume }) {
   const onSubmit = (line) => {
     const text = line.trim();
     setValue("");
-    if (!text) return;
+    const queued = attachRef.current;
+    const attached = text ? queued.filter((a) => text.includes(a.chip)) : queued;
+    const dropped = queued.filter((a) => !attached.includes(a));
+    if (!text && attached.length === 0) return;
+    if (!text && proposal) return;
     const hist = historyRef.current;
-    if (hist[hist.length - 1] !== text) {
+    if (text && hist[hist.length - 1] !== text) {
       hist.push(text);
       saveHistory(hist);
     }
+    if (proposal && !/^\/(approve|quit|exit)\b/.test(text)) {
+      decide("reject", text);
+      return;
+    }
     if (text.startsWith("/")) {
       runCommand(text);
       return;
@@ -84029,14 +84164,21 @@ function App2({ engine: engine2, task, resume }) {
       if (phaseRef.current === "idle") setPhaseBoth("busy");
       return;
     }
-    append({ kind: "you", text, steering: phaseRef.current === "busy" });
-    engine2.send({ cmd: "message", text });
+    if (paused && /^(continue|go on|carry on|keep going)\.?$/i.test(text)) {
+      runCommand("/continue");
+      return;
+    }
+    if (paused) setPaused(false);
+    if (dropped.length) append({ kind: "info", text: `not sent (chip removed): ${dropped.map((a) => a.label).join(", ")}` });
+    append({ kind: "you", text, images: attached.map((a) => `#${a.n} ${a.label}`), steering: phaseRef.current === "busy" });
+    engine2.send({ cmd: "message", text, images: attached.map((a) => a.ref) });
+    attachRef.current = [];
     if (phaseRef.current === "idle") {
       turnT0.current = Date.now();
       setPhaseBoth("busy");
     }
   };
-  const statusLine = phase === "connecting" ? "starting the engine \u2026" : `${modelRef.current || ""}${session ? ` \xB7 ${session}` : ""} \xB7 ${fmtCost(spend)}` + (ctrlc ? " \xB7 ctrl+c again to quit" : " \xB7 / for commands");
+  const statusLine = phase === "connecting" ? "starting the engine \u2026" : `${modelRef.current || ""}${session ? ` \xB7 ${session}` : ""} \xB7 ${fmtCost(spend)}` + (ctxPct >= 10 ? ` \xB7 ctx ${ctxPct}%` : "") + (gate === "approve" ? " \xB7 approvals on" : "") + (ctrlc ? " \xB7 ctrl+c again to quit" : " \xB7 / for commands");
   const spinnerLabel = phase === "connecting" ? " starting \u2026" : ` ${status || "working"}${elapsed >= 2 ? ` \xB7 ${fmtDur(elapsed)}` : ""}` + (thinkChars.current > 4e3 ? ` \xB7 ${(thinkChars.current / 1e3).toFixed(0)}k thinking` : "");
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Static, { items, children: (item) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", marginBottom: ["hum", "you", "banner", "turn"].includes(item.kind) ? 1 : 0, children: [
@@ -84057,9 +84199,15 @@ function App2({ engine: engine2, task, resume }) {
       ] }),
       item.kind === "you" && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { children: [
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Box_default, { width: 2, flexShrink: 0, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "cyan", bold: true, children: "\u276F" }) }),
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "white", children: [
-          item.text,
-          item.steering ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "  (steering)" }) : null
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", children: [
+          item.text ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "white", children: [
+            item.text,
+            item.steering ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "  (steering)" }) : null
+          ] }) : null,
+          (item.images || []).map((im, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { dimColor: true, children: [
+            "\u{1F4CE} ",
+            im
+          ] }, i))
         ] })
       ] }),
       item.kind === "agent" && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "magenta", children: [
@@ -84098,10 +84246,36 @@ function App2({ engine: engine2, task, resume }) {
         item.agent ? "        \u23BF " : "    \u23BF ",
         item.text
       ] })),
+      item.kind === "diff" && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", paddingLeft: 4, children: [
+        item.lines.map((l, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          Text,
+          {
+            color: l.startsWith("+") ? "green" : l.startsWith("-") ? "red" : void 0,
+            dimColor: !l.startsWith("+") && !l.startsWith("-"),
+            children: l || " "
+          },
+          i
+        )),
+        item.more > 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: `\u2026 +${item.more} more diff lines` }) : null
+      ] }),
+      item.kind === "errtail" && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Box_default, { flexDirection: "column", paddingLeft: 6, children: item.lines.map((l, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "red", dimColor: true, children: l }, i)) }),
+      item.kind === "output" && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", paddingLeft: 4, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: `full output \xB7 ${item.name}` }),
+        item.lines.map((l, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: l || " " }, i)),
+        item.more > 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: `\u2026 +${item.more} more lines (the session file keeps everything)` }) : null
+      ] }),
       item.kind === "turn" && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: ACCENT, children: "\u273B " }),
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: item.text })
       ] }),
+      item.kind === "paused" && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { borderStyle: "round", borderColor: "yellow", paddingX: 1, flexDirection: "column", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "yellow", bold: true, children: [
+          "\u23F8 paused \u2014 ",
+          item.trip === "spend" ? "spend cap" : item.trip === "repeat" ? "repeating itself" : "no progress"
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { children: item.text }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "say what to do next \xB7 /continue lets it carry on" })
+      ] }),
       item.kind === "info" && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: item.text }),
       item.kind === "warn" && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "yellow", children: item.text }),
       item.kind === "error" && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "red", children: item.text })
@@ -84118,6 +84292,41 @@ function App2({ engine: engine2, task, resume }) {
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: ACCENT, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(build_default, { type: "dots" }) }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: spinnerLabel })
     ] }),
+    proposal && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", borderStyle: "round", borderColor: ACCENT, paddingX: 1, marginTop: 1, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: ACCENT, bold: true, children: "? " }),
+        "hum wants to ",
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "\xB7 enter approves \xB7 type a reason to reject \xB7 esc stops" })
+      ] }),
+      proposal.content ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { dimColor: true, children: [
+        "  ",
+        proposal.content.split("\n")[0].slice(0, width - 4)
+      ] }) : null,
+      proposal.calls.map((c) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
+          "  \xB7 ",
+          c.desc,
+          c.lines != null ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: `  (${c.lines} lines)` }) : null
+        ] }),
+        c.name === "bash" || c.name === "powershell" ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "cyan", children: [
+          "    $ ",
+          String(c.args?.command || "").split("\n").join(" \u23CE ").slice(0, 300)
+        ] }) : null,
+        c.diff ? c.diff.split("\n").slice(0, DIFF_TAIL_LINES).map((l, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+          Text,
+          {
+            color: l.startsWith("+") ? "green" : l.startsWith("-") ? "red" : void 0,
+            dimColor: !l.startsWith("+") && !l.startsWith("-"),
+            children: [
+              "    ",
+              l || " "
+            ]
+          },
+          i
+        )) : null,
+        c.diff && c.diff.split("\n").length > DIFF_TAIL_LINES ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: `    \u2026 +${c.diff.split("\n").length - DIFF_TAIL_LINES} more diff lines` }) : null
+      ] }, c.id))
+    ] }),
     picker && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", paddingX: 1, marginTop: 1, children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
         "pick a session to continue ",
@@ -84137,15 +84346,17 @@ function App2({ engine: engine2, task, resume }) {
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { borderStyle: "round", borderColor: "gray", paddingX: 1, marginTop: 1, children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "cyan", children: "\u276F " }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-        MultilineInput,
+        input_default,
         {
+          ref: inputRef,
+          onPasteImage: () => hello?.images ? engine2.send({ cmd: "paste_image" }) : append({ kind: "warn", text: "this engine does not take images; update hum" }),
           value,
           onChange: setValue,
           onSubmit,
           focus: phase !== "dead" && !picker,
           navActive: menu.length === 0,
           history: historyRef.current,
-          placeholder: phase === "busy" ? "type to steer \xB7 esc to stop \xB7 !cmd runs a command" : session ? "what next?" : "what are we doing?"
+          placeholder: proposal ? "enter to approve \xB7 or type why not" : paused ? "paused \xB7 say what to do, or /continue" : phase === "busy" ? "type to steer \xB7 esc to stop \xB7 !cmd runs a command" : session ? "what next?" : "what are we doing?"
         }
       )
     ] }),
@@ -84264,15 +84475,17 @@ var Engine = class {
 // src/cli.jsx
 var import_jsx_runtime3 = __toESM(require_jsx_runtime(), 1);
 function parseArgs(argv) {
-  const a = { task: null, resume: null, cwd: process.cwd() };
+  const a = { task: null, resume: null, cwd: process.cwd(), images: [] };
   for (let i = 0; i < argv.length; i += 1) {
     const x = argv[i];
     if (x === "resume") {
       a.resume = argv[i + 1] && !argv[i + 1].startsWith("-") ? argv[++i] : "pick";
     } else if ((x === "-C" || x === "--cwd") && argv[i + 1]) {
       a.cwd = argv[++i];
+    } else if (x === "--image" && argv[i + 1]) {
+      a.images.push(argv[++i]);
     } else if (x === "-h" || x === "--help") {
-      process.stdout.write("usage: hum [task]  |  hum resume [name]\nIn a session: type to talk, !cmd runs a command, esc stops the model, / for commands.\n");
+      process.stdout.write("usage: hum [task] [--image path]  |  hum resume [name]\nIn a session: type to talk, !cmd runs a command, esc stops the model, ctrl+v pastes a screenshot, / for commands.\n");
       process.exit(0);
     } else if (!x.startsWith("-")) {
       a.task = a.task ? `${a.task} ${x}` : x;
@@ -84303,7 +84516,7 @@ try {
   process.stderr.write(exc.message + "\n");
   process.exit(1);
 }
-var { waitUntilExit } = render_default(/* @__PURE__ */ (0, import_jsx_runtime3.jsx)(App2, { engine, task: args.task, resume: args.resume }), { exitOnCtrlC: false });
+var { waitUntilExit } = render_default(/* @__PURE__ */ (0, import_jsx_runtime3.jsx)(App2, { engine, task: args.task, resume: args.resume, images: args.images }), { exitOnCtrlC: false });
 waitUntilExit().then(() => {
   engine.close();
   if (child) setTimeout(() => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@metaphi-ai/hum",
-  "version": "0.1.4",
-  "description": "Hum — हम. Human and model, one harness. A coding agent for your terminal.",
+  "version": "0.1.6",
+  "description": "Hum (हम): a self-improving coding agent for your terminal.",
   "license": "UNLICENSED",
   "type": "module",
   "bin": { "hum": "bin/hum.js" },