@metaphi-ai/hum 0.1.24 → 0.1.26

package/dist/cli.mjs

@@ -83714,7 +83714,9 @@ var MultilineInput = (0, import_react23.forwardRef)(function MultilineInput2({
   focus = true,
   placeholder = "",
   history = [],
-  navActive = true
+  navActive = true,
+  mask = false,
+  swallow = null
 }, ref) {
   const [cursor, setCursor] = (0, import_react23.useState)(value.length);
   const hist = (0, import_react23.useRef)({ index: null, stash: "" });
@@ -83815,24 +83817,26 @@ var MultilineInput = (0, import_react23.forwardRef)(function MultilineInput2({
       return;
     }
     if (key.escape || key.tab || key.meta) return;
+    if (swallow && swallow(input, key)) return;
     const text = [...input.replace(/\r\n?/g, "\n")].filter((ch) => ch === "\n" || ch === "	" || ch >= " ").join("");
     if (!text) return;
     hist.current.index = null;
     set(value.slice(0, c2) + text + value.slice(c2), c2 + text.length);
   }, { isActive: focus });
   if (!focus) {
-    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: value.length > 0 ? value : source_default.dim(placeholder) });
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: value.length > 0 ? mask ? "\u2022".repeat(value.length) : value : source_default.dim(placeholder) });
   }
   const c = clamp(cursor, value.length);
+  const value_ = mask ? "\u2022".repeat(value.length) : value;
   let shown;
   if (value.length === 0) {
     shown = placeholder ? source_default.inverse(placeholder.charAt(0) || " ") + source_default.dim(placeholder.slice(1)) : source_default.inverse(" ");
   } else if (c >= value.length) {
-    shown = value + source_default.inverse(" ");
-  } else if (value[c] === "\n") {
-    shown = value.slice(0, c) + source_default.inverse(" ") + value.slice(c);
+    shown = value_ + source_default.inverse(" ");
+  } else if (value_[c] === "\n") {
+    shown = value_.slice(0, c) + source_default.inverse(" ") + value_.slice(c);
   } else {
-    shown = value.slice(0, c) + source_default.inverse(value[c]) + value.slice(c + 1);
+    shown = value_.slice(0, c) + source_default.inverse(value_[c]) + value_.slice(c + 1);
   }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Text, { children: shown });
 });
@@ -83907,11 +83911,12 @@ var COMMANDS = [
   { name: "/mcp", desc: "the MCP servers in this session \u2014 what each mounted, and any that did not" },
   { name: "/tools", desc: "the tools the model has, and the sandbox they run in" },
   { name: "/hooks", desc: "the lifecycle hooks in scope (~/.hum/hooks.json, <repo>/.hum/hooks.json; Claude Code and Codex hook files too)" },
+  { name: "/permissions", desc: "the rules in force here \u2014 what runs without asking, what is refused, and where each rule came from" },
   { name: "/help", desc: "keys and commands" },
   { name: "/quit", desc: "leave; the session keeps running (hum resume brings you back)" },
-  { name: "/stop", desc: "end this session's engine (the record is saved)" }
+  { name: "/stop", desc: "end this session for good (the record is saved)" }
 ];
-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 commands run in a sandbox (writes in the working directory, no network); leaving it asks you first (enter approves, a typed reason rejects) \xB7 /approve makes every change and command wait for you \xB7 /mcp lists the tool servers \xB7 /resume picks a past session (a running one attaches) \xB7 /compact restarts the context from a summary \xB7 ctrl+c twice leaves and the session keeps running (`hum resume` brings you back) \xB7 /stop ends it";
+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 commands run in a sandbox (writes in the working directory, no network); leaving it asks you first (enter approves, a typed reason rejects) \xB7 /approve makes every change and command wait for you; at the panel, a allows that shape for the session and p writes it into the project \xB7 /permissions lists the rules in force \xB7 /mcp lists the tool servers \xB7 /resume picks a past session (a running one attaches) \xB7 /compact restarts the context from a summary \xB7 ctrl+c twice leaves and the session keeps running (`hum resume` brings you back) \xB7 /stop ends it";
 var DIFF_TAIL_LINES = 20;
 var OUTPUT_MAX_LINES = 200;
 var ERR_TAIL_LINES = 5;
@@ -83935,6 +83940,10 @@ function App2({ engine: engine2, task, resume, images = [] }) {
   const [picker, setPicker] = (0, import_react24.useState)(null);
   const [proposal, setProposal] = (0, import_react24.useState)(null);
   const [question, setQuestion] = (0, import_react24.useState)(null);
+  const [qStep, setQStep] = (0, import_react24.useState)(0);
+  const [qAnswers, setQAnswers] = (0, import_react24.useState)({});
+  const [qPicks, setQPicks] = (0, import_react24.useState)([]);
+  const [qCursor, setQCursor] = (0, import_react24.useState)(0);
   const [gate, setGate] = (0, import_react24.useState)("off");
   const [paused, setPaused] = (0, import_react24.useState)(false);
   const attachRef = (0, import_react24.useRef)([]);
@@ -83951,6 +83960,7 @@ function App2({ engine: engine2, task, resume, images = [] }) {
   const modelRef = (0, import_react24.useRef)("");
   const lastOutRef = (0, import_react24.useRef)(null);
   const helloRef = (0, import_react24.useRef)(false);
+  const startedRef = (0, import_react24.useRef)(false);
   const preHello = (0, import_react24.useRef)([]);
   const [meter, setMeter] = (0, import_react24.useState)({ tokens: 0, cap: 0, input: 0, output: 0 });
   const setPhaseBoth = (p) => {
@@ -83958,6 +83968,10 @@ function App2({ engine: engine2, task, resume, images = [] }) {
     setPhase(p);
   };
   const append = (item) => setItems((prev) => [...prev, { id: nextId.current++, ...item }]);
+  const steps = question ? question.questions && question.questions.length ? question.questions : [{ id: question.id, question: question.question, options: (question.options || []).map((o) => ({ label: o })), default: question.default }] : [];
+  const step = steps.length ? steps[Math.min(qStep, steps.length - 1)] : null;
+  const stepOptions = step ? (step.options || []).map((o) => typeof o === "string" ? { label: o } : o) : [];
+  const stepLabels = stepOptions.map((o) => o.label);
   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)(() => {
@@ -83976,6 +83990,31 @@ function App2({ engine: engine2, task, resume, images = [] }) {
     thinkChars.current = 0;
     thinkT0.current = null;
   };
+  const resetForSession = () => {
+    setItems([]);
+    setDraft("");
+    draftRef.current = "";
+    thoughtRef.current = null;
+    setThinking("");
+    thinkChars.current = 0;
+    setProposal(null);
+    setQuestion(null);
+    setQStep(0);
+    setQAnswers({});
+    setQPicks([]);
+    setQCursor(0);
+    setPaused(false);
+    setPicker(null);
+    setSpend(0);
+    setGoal(null);
+    setSession(null);
+    setStatus("");
+    turnT0.current = null;
+    toolsRef.current = {};
+    lastOutRef.current = null;
+    attachRef.current = [];
+    setMeter((m) => ({ ...m, tokens: 0, input: 0, output: 0 }));
+  };
   const flushDraft = () => {
     const d = draftRef.current.trim();
     draftRef.current = "";
@@ -84023,6 +84062,7 @@ function App2({ engine: engine2, task, resume, images = [] }) {
         append({ kind: "agent_end", text: `agent ${ev.n} done \xB7 ${plural(ev.steps, "step")} \xB7 ${fmtCost(ev.cost_usd)}${ev.reason !== "done" ? ` \xB7 ${ev.reason}` : ""}` });
         break;
       case "hello": {
+        if (helloRef.current) resetForSession();
         setHello(ev);
         helloRef.current = true;
         modelRef.current = ev.model;
@@ -84042,6 +84082,10 @@ function App2({ engine: engine2, task, resume, images = [] }) {
             setStatus(ev.phase || "");
             turnT0.current = Date.now();
           } else setPhaseBoth("idle");
+        }
+        if (startedRef.current) break;
+        startedRef.current = true;
+        if (ev.session) {
           if (resume === "pick") engine2.send({ cmd: "sessions" });
         } else if (task) {
           if (images.length && !ev.images) append({ kind: "warn", text: "this version of hum does not take images; update hum" });
@@ -84166,6 +84210,7 @@ function App2({ engine: engine2, task, resume, images = [] }) {
         setStatus(ev.phase || "");
         break;
       case "idle":
+        setPhaseBoth("idle");
         setStatus("");
         break;
       case "reasoning_delta":
@@ -84213,16 +84258,30 @@ function App2({ engine: engine2, task, resume, images = [] }) {
       case "proposal":
         foldThinking();
         flushDraft();
-        setProposal({ content: ev.content || "", calls: ev.calls || [] });
+        setProposal({ content: ev.content || "", calls: ev.calls || [], remember: ev.remember || [], remember_text: ev.remember_text || "" });
         setStatus("waiting for your decision");
         break;
       case "question":
         foldThinking();
         flushDraft();
-        setQuestion({ id: ev.id, question: ev.question || "", options: ev.options || [], default: ev.default || null });
+        setQuestion({
+          id: ev.id,
+          question: ev.question || "",
+          options: ev.options || [],
+          default: ev.default || null,
+          questions: ev.questions || null
+        });
+        setQStep(0);
+        setQAnswers({});
+        setQPicks([]);
+        setQCursor(0);
         break;
       case "question_closed":
         setQuestion(null);
+        setQStep(0);
+        setQAnswers({});
+        setQPicks([]);
+        setQCursor(0);
         append({ kind: "info", text: `answered: ${ev.answer}` });
         break;
       case "paused":
@@ -84316,7 +84375,7 @@ function App2({ engine: engine2, task, resume, images = [] }) {
   (0, import_react24.useEffect)(() => {
     if (!hello) return void 0;
     let live = true;
-    updateNotice(true ? "0.1.24" : hello.version || "0.0.0").then((line) => {
+    updateNotice(true ? "0.1.26" : hello.version || "0.0.0").then((line) => {
       if (live && line) append({ kind: "info", text: line });
     }).catch(() => {
     });
@@ -84369,15 +84428,49 @@ function App2({ engine: engine2, task, resume, images = [] }) {
         decide("accept");
         return;
       }
+      if (!value.trim() && (input === "a" || input === "p") && (proposal.remember || []).length) {
+        decide("accept", "", input === "a" ? "session" : "project");
+        return;
+      }
       if (key.escape) {
         setProposal(null);
         engine2.send({ cmd: "interrupt" });
         return;
       }
     }
-    if (question && !picker) {
+    if (question && step && !picker) {
+      const n = stepLabels.length;
+      if (step.multi && n) {
+        if (key.upArrow) {
+          setQCursor((c) => (c + n - 1) % n);
+          return;
+        }
+        if (key.downArrow || key.tab) {
+          setQCursor((c) => (c + 1) % n);
+          return;
+        }
+        if (input === " " && !value.trim()) {
+          togglePick(stepLabels[Math.min(qCursor, n - 1)]);
+          return;
+        }
+      }
+      if (!value.trim() && /^[1-9]$/.test(input) && Number(input) <= n) {
+        const label = stepLabels[Number(input) - 1];
+        if (step.multi) {
+          setQCursor(Number(input) - 1);
+          togglePick(label);
+        } else answerStep(label);
+        return;
+      }
       if (key.return && !value.trim() || key.escape) {
-        if (question.default) engine2.send({ cmd: "answer", id: question.id, text: "" });
+        if (step.multi && qPicks.length) {
+          answerStep(qPicks.join(", "));
+          return;
+        }
+        if (step.default) {
+          answerStep("");
+          return;
+        }
         return;
       }
     }
@@ -84432,29 +84525,45 @@ function App2({ engine: engine2, task, resume, images = [] }) {
     setMenuIndex(0);
   }, [value]);
   const attachTo = (port2) => {
-    setItems([]);
-    setDraft("");
-    draftRef.current = "";
-    thoughtRef.current = null;
-    setThinking("");
-    thinkChars.current = 0;
-    setProposal(null);
-    setPaused(false);
-    setSpend(0);
+    resetForSession();
     helloRef.current = false;
     setPhaseBoth("connecting");
-    setStatus("");
     engine2.reconnect(port2).catch((e) => {
       append({ kind: "error", text: `could not attach: ${e.message}` });
       setPhaseBoth("idle");
     });
   };
-  const decide = (decision, note) => {
+  const decide = (decision, note, remember) => {
     const p = proposal;
     setProposal(null);
+    setValue("");
     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 also = remember ? ` \xB7 ${p.remember_text || "that shape"} allowed for ${remember === "session" ? "this session" : "this project"}` : "";
+    append({ kind: "you", text: decision === "accept" ? `approved: ${what}${also}` : `rejected: ${what}${note ? ` \u2014 ${note}` : ""}` });
+    engine2.send({ cmd: "decide", decision, note: note || "", ...remember ? { remember } : {} });
+  };
+  const togglePick = (label) => {
+    setValue("");
+    setQPicks((ps) => ps.includes(label) ? ps.filter((x) => x !== label) : [...ps, label]);
+  };
+  const answerStep = (text) => {
+    if (!question || !step) return;
+    setValue("");
+    append({ kind: "you", text: step.secret ? "(kept to yourself)" : text || `(the default: ${step.default})` });
+    const answers = { ...qAnswers, [step.id]: text };
+    if (qStep + 1 < steps.length) {
+      setQAnswers(answers);
+      setQStep(qStep + 1);
+      setQPicks([]);
+      setQCursor(0);
+      return;
+    }
+    setQuestion(null);
+    setQStep(0);
+    setQAnswers({});
+    setQPicks([]);
+    setQCursor(0);
+    engine2.send({ cmd: "answer", id: question.id, answers });
   };
   const runCommand = (line) => {
     const [name, ...rest] = line.split(/\s+/);
@@ -84500,12 +84609,15 @@ function App2({ engine: engine2, task, resume, images = [] }) {
         append({ kind: "info", text: `${(hello?.tools || []).join(", ")} \xB7 sandbox: ${hello?.sandbox || "none"}` });
         break;
       case "/mcp":
-        if (hello?.mcp === void 0) append({ kind: "warn", text: "this engine does not say what is mounted; update hum (/stop, then hum)" });
+        if (hello?.mcp === void 0) append({ kind: "warn", text: "this version of hum does not say what is mounted; update hum (/stop, then hum)" });
         else engine2.send({ cmd: "mcp" });
         break;
       case "/hooks":
         engine2.send({ cmd: "hooks" });
         break;
+      case "/permissions":
+        engine2.send({ cmd: "permissions" });
+        break;
       case "/continue":
         engine2.send({ cmd: "continue" });
         break;
@@ -84539,9 +84651,8 @@ function App2({ engine: engine2, task, resume, images = [] }) {
       decide("reject", text);
       return;
     }
-    if (question && !/^\/(quit|exit|stop)\b/.test(text)) {
-      append({ kind: "you", text });
-      engine2.send({ cmd: "answer", id: question.id, text });
+    if (question && step && !/^\/(quit|exit|stop)\b/.test(text)) {
+      answerStep(text);
       return;
     }
     if (text.startsWith("/")) {
@@ -84695,23 +84806,35 @@ function App2({ engine: engine2, task, resume, images = [] }) {
       /* @__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 })
     ] }),
-    question && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", borderStyle: "round", borderColor: ACCENT, paddingX: 1, marginTop: 1, children: [
+    question && step && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", borderStyle: "round", borderColor: ACCENT, paddingX: 1, marginTop: 1, children: [
+      step.header ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { dimColor: true, children: [
+        "  ",
+        step.header
+      ] }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: ACCENT, bold: true, children: "? " }),
-        question.question
+        step.question,
+        steps.length > 1 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: `  (${qStep + 1} of ${steps.length})` }) : null
       ] }),
-      question.options.map((o, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
-        "  ",
+      stepOptions.map((o, i) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { children: [
+        step.multi ? i === Math.min(qCursor, stepLabels.length - 1) ? "\u203A " : "  " : "  ",
+        step.multi ? qPicks.includes(o.label) ? "[x] " : "[ ] " : "",
         i + 1,
         ". ",
-        o,
-        question.default === o ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "  (default)" }) : null
+        o.label,
+        o.description ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { dimColor: true, children: [
+          " \u2014 ",
+          o.description
+        ] }) : null,
+        step.default === o.label ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "  (default)" }) : null
       ] }, i)),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { dimColor: true, children: [
         "  ",
-        question.options.length ? "a number picks \xB7 " : "",
+        stepLabels.length ? step.multi ? "a number ticks \xB7 space ticks the one marked \xB7 " : "a number picks \xB7 " : "",
         "type an answer",
-        question.default ? " \xB7 enter takes the default" : ""
+        step.default ? " \xB7 enter takes the default" : "",
+        step.multi && stepLabels.length ? " \xB7 enter takes what is ticked" : "",
+        step.secret ? " \xB7 it is not shown and not recorded" : ""
       ] })
     ] }),
     proposal && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", borderStyle: "round", borderColor: ACCENT, paddingX: 1, marginTop: 1, children: [
@@ -84722,6 +84845,14 @@ function App2({ engine: engine2, task, resume, images = [] }) {
         " ",
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { dimColor: true, children: "\xB7 enter approves \xB7 type a reason to reject \xB7 esc stops" })
       ] }),
+      (proposal.remember || []).length ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { dimColor: true, children: [
+        "  a ",
+        "allows ",
+        proposal.remember_text,
+        " for this session",
+        " \xB7 p ",
+        "for this project"
+      ] }) : null,
       proposal.content ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { dimColor: true, children: [
         "  ",
         proposal.content.split("\n")[0].slice(0, width - 4)
@@ -84842,7 +84973,15 @@ function App2({ engine: engine2, task, resume, images = [] }) {
           focus: phase !== "dead" && !picker,
           navActive: menu.length === 0,
           history: historyRef.current,
-          placeholder: question ? question.options.length ? "a number, or your answer" : "your answer" : 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?"
+          mask: !!(step && step.secret),
+          swallow: (input, key) => {
+            if (picker || value.trim()) return false;
+            if (proposal && (input === "a" || input === "p") && (proposal.remember || []).length) return true;
+            if (!question || !step) return false;
+            if (/^[1-9]$/.test(input) && Number(input) <= stepLabels.length) return true;
+            return !!(step.multi && stepLabels.length && input === " ");
+          },
+          placeholder: question && step ? stepLabels.length ? "a number, or your answer" : "your answer" : proposal ? (proposal.remember || []).length ? "enter approves \xB7 a / p allow this shape \xB7 or type why not" : "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?"
         }
       )
     ] }),
@@ -85135,7 +85274,7 @@ import { spawnSync as spawnSync3 } from "node:child_process";
 var ENGINE_COMMANDS = /* @__PURE__ */ new Set(["run", "login", "logout", "whoami", "model", "key", "sessions", "show", "sync", "skill", "ps", "stop", "hooks", "engine"]);
 var argv0 = process.argv.slice(2);
 if (argv0[0] === "--version" || argv0[0] === "-V") {
-  process.stdout.write(`hum ${true ? "0.1.24" : "0.0.0"}
+  process.stdout.write(`hum ${true ? "0.1.26" : "0.0.0"}
 `);
   process.exit(0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metaphi-ai/hum",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Hum (हम): a self-improving coding agent for your terminal.",
   "license": "UNLICENSED",
   "type": "module",