@corenel/term 0.1.0

package/dist/ink/index.js

@@ -0,0 +1,573 @@
+import {
+  STANDARD_POLICY,
+  TermSession,
+  matchesAnyGlob,
+  parseMarkdown
+} from "../chunk-HYWLODZT.js";
+import "../chunk-47IH6X5H.js";
+import {
+  filterCommands
+} from "../chunk-R6AXTD55.js";
+import "../chunk-TCVDVYMF.js";
+import "../chunk-HAQGHLW6.js";
+
+// src/ink/index.tsx
+import { useCallback, useState as useState2, useSyncExternalStore } from "react";
+import { render, useApp, useInput } from "ink";
+
+// ../harness/guardrail/permission-service.ts
+var LEVEL_RANK = { allow: 0, ask: 1, deny: 2 };
+function subjectMatches(tool, glob) {
+  if (tool.address && matchesAnyGlob(tool.address, [glob])) return true;
+  return matchesAnyGlob(tool.name, [glob]);
+}
+function specificity(glob) {
+  const literal = glob.replace(/\*/g, "").length;
+  return (glob.includes("*") ? 0 : 1e4) + literal;
+}
+function matchLevel(tool, rules) {
+  let best;
+  let bestScore = -1;
+  for (const [glob, level] of Object.entries(rules)) {
+    if (!subjectMatches(tool, glob)) continue;
+    const score = specificity(glob);
+    if (score > bestScore) {
+      bestScore = score;
+      best = level;
+    }
+  }
+  return best;
+}
+function mostRestrictive(a, b) {
+  return LEVEL_RANK[a] >= LEVEL_RANK[b] ? a : b;
+}
+var PermissionService = class {
+  policy;
+  prompt;
+  defaultForReadOnly;
+  defaultForMutating;
+  ceiling;
+  sessionAllow = /* @__PURE__ */ new Set();
+  constructor(opts) {
+    this.policy = opts.policy;
+    if (opts.prompt) this.prompt = opts.prompt;
+    this.defaultForReadOnly = opts.defaultForReadOnly ?? "allow";
+    this.defaultForMutating = opts.defaultForMutating ?? "ask";
+    if (opts.ceiling) this.ceiling = opts.ceiling;
+  }
+  /** Pre-approve a tool-name glob for the rest of the session (an "ask" becomes "allow"). */
+  preApprove(toolGlob) {
+    this.sessionAllow.add(toolGlob);
+  }
+  reset() {
+    this.sessionAllow.clear();
+  }
+  async check(tool, input) {
+    const level = this.resolveLevel(tool);
+    return this.decide(level, tool.name, input);
+  }
+  /**
+   * Resolve the effective level. Base precedence (highest first):
+   *   policy.permissions glob > tool.permission > mutates heuristic > policy.defaultPermission.
+   * Then the ceiling clamps to the more restrictive of base and ceiling.
+   */
+  resolveLevel(tool) {
+    return mostRestrictive(this.resolveBaseLevel(tool), this.resolveCeilingLevel(tool));
+  }
+  resolveBaseLevel(tool) {
+    const matched = this.policy.permissions && matchLevel(tool, this.policy.permissions);
+    if (matched) return matched;
+    if (tool.mutates && this.policy.mutatingDefault) return this.policy.mutatingDefault;
+    if (tool.permission) return tool.permission;
+    if (this.policy.defaultPermission) return this.policy.defaultPermission;
+    if (tool.mutates) return this.defaultForMutating;
+    return this.defaultForReadOnly;
+  }
+  resolveCeilingLevel(tool) {
+    const c = this.ceiling;
+    if (!c) return "allow";
+    const matched = c.overrides && matchLevel(tool, c.overrides);
+    if (matched) return matched;
+    return c.defaultLevel ?? "allow";
+  }
+  async decide(level, name, input) {
+    if (level === "allow") return "allow";
+    if (level === "deny") return "deny";
+    if (this.sessionAllow.size && matchesAnyGlob(name, [...this.sessionAllow])) return "allow";
+    if (!this.prompt) return "deny";
+    return this.prompt.ask({ tool: name, input });
+  }
+};
+
+// src/ink/App.tsx
+import { useEffect, useState } from "react";
+import { homedir } from "node:os";
+import { Box as Box4, Static, Text as Text4, useStdout } from "ink";
+import TextInput from "ink-text-input";
+
+// src/ink/items.tsx
+import { Box, Text } from "ink";
+
+// src/ink/theme.ts
+var palette = {
+  ember: "#e2622a",
+  amber: "#f0b429",
+  ink: "#f6ece3",
+  dim: "#8d7d6f",
+  soft: "#c2b1a2",
+  good: "#63a375",
+  warn: "#d9a227",
+  bad: "#d9483b",
+  tool: "#c4b5fd"
+};
+var glyph = {
+  prompt: "\u203A",
+  bullet: "\xB7",
+  ok: "\u2713",
+  fail: "\u2717",
+  bar: "\u2502",
+  sep: "\xB7"
+};
+function tokens(n) {
+  return n >= 1e3 ? `${(n / 1e3).toFixed(1)}k` : `${n}`;
+}
+
+// src/ink/items.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function CommittedRow({ item }) {
+  switch (item.kind) {
+    case "user":
+      return /* @__PURE__ */ jsxs(Box, { marginTop: 1, children: [
+        /* @__PURE__ */ jsxs(Text, { color: palette.ember, children: [
+          glyph.prompt,
+          " "
+        ] }),
+        /* @__PURE__ */ jsx(Text, { bold: true, children: item.text })
+      ] });
+    case "assistant":
+      return /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: parseMarkdown(item.text).map((b, i) => /* @__PURE__ */ jsx(MdLine, { block: b }, i)) });
+    case "tool":
+      return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsxs(Box, { children: [
+          /* @__PURE__ */ jsxs(Text, { color: palette.dim, children: [
+            glyph.bullet,
+            " "
+          ] }),
+          /* @__PURE__ */ jsx(Text, { color: palette.tool, children: item.name.padEnd(11) }),
+          /* @__PURE__ */ jsx(Text, { color: palette.ink, children: item.subject }),
+          /* @__PURE__ */ jsxs(Text, { color: item.isError ? palette.bad : palette.good, children: [
+            "  ",
+            item.isError ? glyph.fail : glyph.ok
+          ] }),
+          /* @__PURE__ */ jsxs(Text, { color: palette.dim, children: [
+            item.durationMs !== void 0 ? ` ${(item.durationMs / 1e3).toFixed(1)}s` : "",
+            item.offloadedBytes !== void 0 ? ` offloaded ${Math.round(item.offloadedBytes / 1024)} KB` : "",
+            "  ",
+            "#",
+            item.ord
+          ] })
+        ] }),
+        item.preview.map((line, i) => /* @__PURE__ */ jsxs(Box, { children: [
+          /* @__PURE__ */ jsxs(Text, { color: palette.dim, children: [
+            "  ",
+            glyph.bar,
+            " "
+          ] }),
+          /* @__PURE__ */ jsx(Text, { color: item.isError ? palette.bad : palette.soft, children: line })
+        ] }, i))
+      ] });
+    case "note":
+      return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: item.level === "info" ? 1 : 0, children: [
+        /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, { color: item.level === "error" ? palette.bad : item.level === "warn" ? palette.warn : palette.dim, children: [
+          item.level === "info" ? "  " : "  ! ",
+          item.text
+        ] }) }),
+        item.detail ? /* @__PURE__ */ jsxs(Text, { color: palette.dim, children: [
+          "  ",
+          item.detail
+        ] }) : null
+      ] });
+  }
+}
+function MdLine({ block }) {
+  switch (block.kind) {
+    case "h":
+      return /* @__PURE__ */ jsx(Text, { color: palette.ember, bold: true, children: block.text });
+    case "li":
+      return /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: palette.tool, children: "  \u2022 " }),
+        /* @__PURE__ */ jsx(Text, { color: palette.soft, children: block.text })
+      ] });
+    case "code":
+      return /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginY: 1, children: block.text.split("\n").map((l, i) => /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsxs(Text, { color: palette.dim, children: [
+          "  ",
+          glyph.bar,
+          " "
+        ] }),
+        /* @__PURE__ */ jsx(Text, { color: palette.amber, children: l })
+      ] }, i)) });
+    case "blank":
+      return /* @__PURE__ */ jsx(Text, { children: " " });
+    default:
+      return /* @__PURE__ */ jsx(Text, { color: palette.soft, children: block.text });
+  }
+}
+function LiveToolRow({ tool }) {
+  return /* @__PURE__ */ jsxs(Box, { children: [
+    /* @__PURE__ */ jsxs(Text, { color: palette.amber, children: [
+      glyph.bullet,
+      " "
+    ] }),
+    /* @__PURE__ */ jsx(Text, { color: palette.tool, children: tool.name.padEnd(11) }),
+    /* @__PURE__ */ jsx(Text, { color: palette.ink, children: tool.subject }),
+    /* @__PURE__ */ jsxs(Text, { color: palette.dim, children: [
+      "  ",
+      "running\u2026 #",
+      tool.ord
+    ] })
+  ] });
+}
+
+// src/ink/Modal.tsx
+import { Box as Box2, Text as Text2 } from "ink";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function ModalView({ modal }) {
+  if (modal.kind === "permission") {
+    return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", borderStyle: "round", borderColor: palette.warn, paddingX: 1, children: [
+      /* @__PURE__ */ jsxs2(Text2, { color: palette.warn, children: [
+        modal.tool,
+        " wants to run"
+      ] }),
+      /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: /* @__PURE__ */ jsx2(Text2, { bold: true, children: modal.detail }) }),
+      /* @__PURE__ */ jsxs2(Box2, { marginTop: 1, children: [
+        /* @__PURE__ */ jsx2(Text2, { color: palette.good, children: "[y]" }),
+        /* @__PURE__ */ jsx2(Text2, { color: palette.dim, children: " run it   " }),
+        /* @__PURE__ */ jsx2(Text2, { color: palette.bad, children: "[n]" }),
+        /* @__PURE__ */ jsx2(Text2, { color: palette.dim, children: " deny   esc denies" })
+      ] })
+    ] });
+  }
+  const q = modal.questions[0];
+  return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", borderStyle: "round", borderColor: palette.ember, paddingX: 1, children: [
+    /* @__PURE__ */ jsx2(Text2, { color: palette.dim, children: q?.header }),
+    /* @__PURE__ */ jsx2(Text2, { bold: true, children: q?.question }),
+    /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", marginTop: 1, children: (q?.options ?? []).map((o, i) => /* @__PURE__ */ jsxs2(Box2, { children: [
+      /* @__PURE__ */ jsxs2(Text2, { color: palette.amber, children: [
+        i + 1,
+        "  "
+      ] }),
+      /* @__PURE__ */ jsx2(Text2, { children: o.label }),
+      o.description ? /* @__PURE__ */ jsxs2(Text2, { color: palette.dim, children: [
+        "   ",
+        o.description
+      ] }) : null
+    ] }, o.label)) }),
+    /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: /* @__PURE__ */ jsxs2(Text2, { color: palette.dim, children: [
+      "1-",
+      (q?.options ?? []).length,
+      " choose \xB7 \u21B5 confirm \xB7 or type your own answer \xB7 esc dismisses"
+    ] }) })
+  ] });
+}
+
+// src/ink/Palette.tsx
+import { Box as Box3, Text as Text3 } from "ink";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function PaletteView({ items, selected }) {
+  return /* @__PURE__ */ jsxs3(Box3, { flexDirection: "column", children: [
+    items.map((c, i) => /* @__PURE__ */ jsxs3(Box3, { children: [
+      /* @__PURE__ */ jsxs3(Text3, { color: i === selected ? palette.ember : palette.dim, children: [
+        i === selected ? "\u203A " : "  ",
+        "/",
+        c.name,
+        c.args ? ` ${c.args}` : ""
+      ] }),
+      /* @__PURE__ */ jsxs3(Text3, { color: palette.dim, children: [
+        "   ",
+        c.summary
+      ] })
+    ] }, c.name)),
+    /* @__PURE__ */ jsx3(Text3, { color: palette.dim, children: "  \u2191\u2193 choose \xB7 tab completes \xB7 esc closes" })
+  ] });
+}
+
+// src/ink/status.ts
+var DEFAULT_COLUMNS = 80;
+var MIN_GAP = 2;
+var SEP = " \xB7 ";
+var ELLIPSIS = "\u2026";
+function shortenHome(cwd, home) {
+  if (!home) return cwd;
+  if (cwd === home) return "~";
+  for (const slash of ["\\", "/"]) {
+    const prefix = home.endsWith(slash) ? home : `${home}${slash}`;
+    if (cwd.startsWith(prefix)) return `~${slash}${cwd.slice(prefix.length)}`;
+  }
+  return cwd;
+}
+function shortenTrailing(path, budget) {
+  if (path.length <= budget) return path;
+  if (budget <= ELLIPSIS.length) return "";
+  const parts = path.split(/[\\/]/).filter((p) => p.length > 0);
+  let kept = "";
+  for (let i = parts.length - 1; i >= 0; i--) {
+    const candidate = `${ELLIPSIS}${parts.slice(i).join("/")}`;
+    if (candidate.length > budget) break;
+    kept = candidate;
+  }
+  return kept;
+}
+function fitStatus(left, identity, columns) {
+  const cols = columns !== void 0 && columns > 0 ? columns : DEFAULT_COLUMNS;
+  const budget = cols - left.length - MIN_GAP;
+  if (budget <= 0) return { left, right: "" };
+  const cwd = shortenHome(identity.cwd, identity.home);
+  const full = `${identity.model}${SEP}${cwd}`;
+  if (full.length <= budget) return { left, right: full };
+  const cwdBudget = budget - identity.model.length - SEP.length;
+  if (cwdBudget > 0) {
+    const shrunkCwd = shortenTrailing(cwd, cwdBudget);
+    if (shrunkCwd) return { left, right: `${identity.model}${SEP}${shrunkCwd}` };
+  }
+  if (identity.model.length <= budget) return { left, right: identity.model };
+  return { left, right: "" };
+}
+
+// src/ink/App.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function useColumns() {
+  const { stdout } = useStdout();
+  const [columns, setColumns] = useState(stdout?.columns ?? DEFAULT_COLUMNS);
+  useEffect(() => {
+    if (!stdout) return;
+    const onResize = () => setColumns(stdout.columns ?? DEFAULT_COLUMNS);
+    onResize();
+    stdout.on("resize", onResize);
+    return () => {
+      stdout.off("resize", onResize);
+    };
+  }, [stdout]);
+  return columns;
+}
+function App(props) {
+  const { state } = props;
+  const paletteItems = props.value.startsWith("/") ? filterCommands(props.value) : [];
+  const paletteSelected = Math.min(props.paletteSelected, Math.max(paletteItems.length - 1, 0));
+  const busy = state.status !== "idle";
+  const columns = useColumns();
+  const statusWord = busy ? "running" : "idle";
+  const roundSeg = state.live ? ` ${glyph.sep} turn ${state.live.turn}` : ` ${glyph.sep} ${props.toolCount} tools`;
+  const turnTokens = tokens(state.turnUsage.promptTokens + state.turnUsage.completionTokens);
+  const totalTokens = tokens(state.usage.promptTokens + state.usage.completionTokens);
+  const tokenSeg = ` ${glyph.sep} ${turnTokens} turn ${glyph.sep} ${totalTokens} total`;
+  const escSeg = busy ? ` ${glyph.sep} esc stops` : "";
+  const queuedSeg = state.queued.length ? ` ${glyph.sep} ${state.queued.length} queued` : "";
+  const shellSeg = !busy ? ` ${glyph.sep} shell ${props.approveAll ? "auto-approved" : "asks first"}` : "";
+  const statusLeft = `  ${statusWord}${roundSeg}${tokenSeg}${escSeg}${queuedSeg}${shellSeg}`;
+  const { right: statusRight } = fitStatus(statusLeft, { model: props.model, cwd: props.cwd, home: homedir() }, columns);
+  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx4(Static, { items: state.committed, children: (item) => /* @__PURE__ */ jsx4(CommittedRow, { item }, item.id) }, `transcript-${state.transcriptGen}`),
+    state.committed.length === 0 ? /* @__PURE__ */ jsx4(Box4, { marginBottom: 1, children: /* @__PURE__ */ jsxs4(Text4, { color: palette.soft, children: [
+      "Type a request. ",
+      /* @__PURE__ */ jsxs4(Text4, { color: palette.dim, children: [
+        "/help for commands ",
+        glyph.sep,
+        " Ctrl-C stops a turn ",
+        glyph.sep,
+        " Ctrl-D leaves"
+      ] })
+    ] }) }) : null,
+    state.live?.tools.map((t) => /* @__PURE__ */ jsx4(LiveToolRow, { tool: t }, t.callId)),
+    state.live?.streaming ? /* @__PURE__ */ jsx4(Box4, { marginTop: 1, children: /* @__PURE__ */ jsx4(Text4, { color: palette.soft, children: state.live.streaming }) }) : null,
+    state.modal ? /* @__PURE__ */ jsx4(Box4, { marginTop: 1, children: /* @__PURE__ */ jsx4(ModalView, { modal: state.modal }) }) : null,
+    paletteItems.length && !state.modal ? /* @__PURE__ */ jsx4(Box4, { marginTop: 1, children: /* @__PURE__ */ jsx4(PaletteView, { items: paletteItems, selected: paletteSelected }) }) : null,
+    /* @__PURE__ */ jsxs4(Box4, { borderStyle: "round", borderColor: palette.dim, paddingX: 1, marginTop: 1, children: [
+      /* @__PURE__ */ jsxs4(Text4, { color: palette.ember, children: [
+        glyph.prompt,
+        " "
+      ] }),
+      /* @__PURE__ */ jsx4(
+        TextInput,
+        {
+          value: props.value,
+          onChange: props.onChange,
+          onSubmit: state.modal ? props.onAnswer : props.onSubmit,
+          placeholder: "",
+          focus: props.focus
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs4(Box4, { justifyContent: "space-between", children: [
+      /* @__PURE__ */ jsxs4(Box4, { children: [
+        /* @__PURE__ */ jsxs4(Text4, { color: busy ? palette.amber : palette.dim, children: [
+          "  ",
+          statusWord
+        ] }),
+        /* @__PURE__ */ jsxs4(Text4, { color: palette.dim, children: [
+          roundSeg,
+          tokenSeg,
+          escSeg,
+          queuedSeg
+        ] }),
+        !busy ? /* @__PURE__ */ jsx4(Text4, { color: props.approveAll ? palette.ember : palette.warn, children: shellSeg }) : null
+      ] }),
+      statusRight ? /* @__PURE__ */ jsx4(Text4, { color: palette.dim, children: statusRight }) : null
+    ] })
+  ] });
+}
+
+// src/ink/scroll.ts
+function primeScroll(out, opts) {
+  if (out.isTTY !== true) return 0;
+  if (opts.resuming) return 0;
+  const rows = out.rows;
+  if (typeof rows !== "number" || !Number.isFinite(rows) || rows <= 0) return 0;
+  out.write("\n".repeat(rows));
+  return rows;
+}
+
+// src/ink/index.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function Root({ session, deps }) {
+  const state = useSyncExternalStore(
+    useCallback((fn) => session.subscribe(fn), [session]),
+    useCallback(() => session.getSnapshot(), [session])
+  );
+  const [value, setValue] = useState2("");
+  const { exit } = useApp();
+  const [sawSigint, setSawSigint] = useState2(false);
+  const [paletteIndex, setPaletteIndex] = useState2(0);
+  const handleChange = (v) => {
+    const cleaned = v.replace(/\x1b/g, "");
+    if (state.modal?.kind === "user" && value === "" && cleaned.length === 1) {
+      const q = state.modal.questions[0];
+      const n = Number(cleaned);
+      if (q && Number.isInteger(n) && n >= 1 && n <= q.options.length) {
+        const answers = { [q.header]: [q.options[n - 1].label] };
+        session.answer(answers);
+        return;
+      }
+    }
+    setValue(cleaned);
+    setPaletteIndex(0);
+  };
+  useInput((input, key) => {
+    if (state.modal) {
+      if (key.escape) {
+        session.answer(state.modal.kind === "permission" ? "deny" : null);
+        return;
+      }
+      if (state.modal.kind === "permission") {
+        if (input.toLowerCase() === "y") {
+          session.answer("allow");
+          return;
+        }
+        if (input.toLowerCase() === "n") {
+          session.answer("deny");
+          return;
+        }
+      }
+      return;
+    }
+    const paletteItems = value.startsWith("/") ? filterCommands(value) : [];
+    if (paletteItems.length > 0) {
+      if (key.escape) {
+        setValue("");
+        setPaletteIndex(0);
+        return;
+      }
+      if (key.upArrow) {
+        setPaletteIndex((i) => (i - 1 + paletteItems.length) % paletteItems.length);
+        return;
+      }
+      if (key.downArrow) {
+        setPaletteIndex((i) => (i + 1) % paletteItems.length);
+        return;
+      }
+      if (key.tab) {
+        const chosen = paletteItems[Math.min(paletteIndex, paletteItems.length - 1)];
+        if (chosen) setValue(`/${chosen.name} `);
+        setPaletteIndex(0);
+        return;
+      }
+    }
+    if (key.escape && state.status !== "idle") {
+      session.abort();
+      return;
+    }
+    if (key.ctrl && input === "c") {
+      if (state.status !== "idle" && !sawSigint) {
+        session.abort();
+        setSawSigint(true);
+        return;
+      }
+      exit();
+      return;
+    }
+    if (key.ctrl && input === "d") {
+      if (state.status === "idle" && value === "") exit();
+      return;
+    }
+    if (sawSigint) setSawSigint(false);
+  });
+  return /* @__PURE__ */ jsx5(
+    App,
+    {
+      state,
+      model: deps.model,
+      cwd: deps.cwd,
+      version: deps.version,
+      toolCount: deps.tools.length,
+      approveAll: deps.approveAll === true,
+      value,
+      onChange: handleChange,
+      onSubmit: (v) => {
+        setValue("");
+        void session.submit(v).then(() => {
+          if (session.wantsExit) exit();
+        });
+      },
+      onAnswer: (v) => {
+        setValue("");
+        const modal = session.getSnapshot().modal;
+        if (!modal) return;
+        if (modal.kind === "permission") session.answer(/^y(es)?$/i.test(v.trim()) ? "allow" : "deny");
+        else session.answer(v.trim() ? { [modal.questions[0].header]: [v.trim()] } : null);
+      },
+      focus: state.modal?.kind !== "permission",
+      paletteSelected: paletteIndex
+    }
+  );
+}
+async function runTui(deps) {
+  const session = new TermSession(deps);
+  if (deps.resume) await session.resume(deps.resume.id);
+  const permission = new PermissionService({
+    policy: STANDARD_POLICY,
+    prompt: { ask: (req) => session.askPermission(req) }
+  });
+  session.attachPermission(permission);
+  primeScroll(process.stdout, { resuming: deps.resume != null });
+  const app = render(/* @__PURE__ */ jsx5(Root, { session, deps }), {
+    /* LOAD-BEARING — do not "clean up" or default this away. Ink's own App
+     * component (build/components/App.js, handleInput) intercepts the raw
+     * \x03 byte and calls handleExit() BEFORE it ever emits the 'input'
+     * event that `useInput` listens on, whenever this flag is left at its
+     * default of `true`. With the default, our press-once-to-abort /
+     * press-twice-to-exit handler in `Root` above could never run at all —
+     * Ink would kill the process on the very first Ctrl-C, mid-turn,
+     * silently. This exact regression cannot be caught by
+     * `interaction.test.tsx`: `ink-testing-library`'s own `render()`
+     * hardcodes `exitOnCtrlC: false` for every tree it mounts, so no test
+     * run through that harness can tell this line apart from its absence.
+     * This comment is the only guard that's left. */
+    exitOnCtrlC: false
+  });
+  await app.waitUntilExit();
+  return 0;
+}
+export {
+  Root,
+  runTui
+};

package/dist/ink/items.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { CommittedItem, LiveTool } from '../state';
+/** One finished item. Rendered ONCE inside <Static> — never re-rendered, or the
+ * block duplicates in the user's scrollback. */
+export declare function CommittedRow({ item }: {
+    item: CommittedItem;
+}): React.ReactElement;
+/** A call that has been announced and has not come back yet. */
+export declare function LiveToolRow({ tool }: {
+    tool: LiveTool;
+}): React.ReactElement;
+//# sourceMappingURL=items.d.ts.map

package/dist/ink/items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/ink/items.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIxD;gDACgD;AAChD,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAmDlF;AAiCD,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,CAS5E"}

package/dist/ink/scroll.d.ts

@@ -0,0 +1,17 @@
+export interface ScrollableOut {
+    readonly isTTY?: boolean;
+    readonly rows?: number;
+    write(chunk: string): void;
+}
+export interface PrimeScrollOptions {
+    /** True when `runTui` is reopening a saved conversation. Restored content
+     * usually already fills the screen; priming would push it into scrollback
+     * before the user ever sees it. */
+    resuming: boolean;
+}
+/** Writes `out.rows` newlines to `out` and returns how many were written (0
+ * when priming is skipped). Skips whenever `out.isTTY` is not `true`,
+ * `out.rows` is not a positive number, or `opts.resuming` is true. Must be
+ * called before the first Ink `render()`. */
+export declare function primeScroll(out: ScrollableOut, opts: PrimeScrollOptions): number;
+//# sourceMappingURL=scroll.d.ts.map

package/dist/ink/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../src/ink/scroll.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC;;uCAEmC;IACnC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;6CAG6C;AAC7C,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAOhF"}

package/dist/ink/status.d.ts

@@ -0,0 +1,21 @@
+export interface StatusIdentity {
+    model: string;
+    /** Absolute working directory, as-is (not yet home-shortened). */
+    cwd: string;
+    /** The user's home directory, if known, for the `~` substitution. */
+    home?: string;
+}
+export interface StatusLine {
+    /** Always exactly what was passed in -- the left half is never truncated. */
+    left: string;
+    /** The identity segment, or '' when there is no room for any of it. */
+    right: string;
+}
+/** Terminals that don't report `columns` (some pipes, some Windows hosts) get
+ * this instead of a crash or a blank render. */
+export declare const DEFAULT_COLUMNS = 80;
+/** Decide what the status row's right (identity) half should render, given
+ * the already-finalized left half and the terminal's current width. Never
+ * touches `left`; never returns a total wider than `columns`. */
+export declare function fitStatus(left: string, identity: StatusIdentity, columns: number | undefined): StatusLine;
+//# sourceMappingURL=status.d.ts.map

package/dist/ink/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/ink/status.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;gDACgD;AAChD,eAAO,MAAM,eAAe,KAAK,CAAC;AAiClC;;iEAEiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAkBzG"}

package/dist/ink/theme.d.ts

@@ -0,0 +1,22 @@
+export declare const palette: {
+    readonly ember: "#e2622a";
+    readonly amber: "#f0b429";
+    readonly ink: "#f6ece3";
+    readonly dim: "#8d7d6f";
+    readonly soft: "#c2b1a2";
+    readonly good: "#63a375";
+    readonly warn: "#d9a227";
+    readonly bad: "#d9483b";
+    readonly tool: "#c4b5fd";
+};
+export declare const glyph: {
+    readonly prompt: "›";
+    readonly bullet: "·";
+    readonly ok: "✓";
+    readonly fail: "✗";
+    readonly bar: "│";
+    readonly sep: "·";
+};
+/** Tokens, abbreviated the way a status line has room for. */
+export declare function tokens(n: number): string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/ink/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/ink/theme.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO;;;;;;;;;;CAUV,CAAC;AAEX,eAAO,MAAM,KAAK;;;;;;;CAOR,CAAC;AAEX,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC"}