@akanjs/cli 3.0.0-beta.13 → 3.0.0-beta.15

package/CodeTui-6c9a2wtk.js

@@ -0,0 +1,1103 @@
+// @bun
+import {
+  SubagentPool2
+} from "./index-x7g1qzpt.js";
+import {
+  CodeTuiClipboard2,
+  CodeTuiCommands2,
+  CodeTuiLines2,
+  CodeTuiEditor2,
+  CodeTuiFiles2,
+  CodeTuiMarkdown2,
+  CodeTuiParts2
+} from "./index-sxg87a8f.js";
+
+// pkgs/@akanjs/cli/code/CodeTui.tsx
+import {
+  CodeTranscript,
+  codeAgentClip
+} from "akanjs/common";
+import { render } from "ink";
+
+// pkgs/@akanjs/cli/ui/CodeTuiApp.tsx
+import { Box, Text, useCursor, useInput } from "ink";
+import { useEffect, useRef, useState } from "react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+var promptMarkWidth = 2;
+var pasteOpen = "[200~";
+var pasteClose = "[201~";
+var Styled = ({ span }) => /* @__PURE__ */ jsxDEV(Text, {
+  bold: span.bold,
+  color: span.color,
+  dimColor: span.dim,
+  italic: span.italic,
+  strikethrough: span.strikethrough,
+  underline: span.underline,
+  children: span.text
+}, undefined, false, undefined, this);
+var Line = ({ line }) => /* @__PURE__ */ jsxDEV(Text, {
+  wrap: "truncate",
+  children: line.spans.map((span, at) => /* @__PURE__ */ jsxDEV(Styled, {
+    span
+  }, `${line.key}:${at}`, false, undefined, this))
+}, undefined, false, undefined, this);
+var Transcript = ({ lines, width, height }) => /* @__PURE__ */ jsxDEV(Box, {
+  flexDirection: "column",
+  width,
+  height,
+  paddingX: 1,
+  children: lines.map((line) => /* @__PURE__ */ jsxDEV(Line, {
+    line
+  }, line.key, false, undefined, this))
+}, undefined, false, undefined, this);
+var Overlay = ({
+  overlay,
+  width,
+  height
+}) => /* @__PURE__ */ jsxDEV(Box, {
+  borderDimColor: true,
+  borderStyle: "round",
+  flexDirection: "column",
+  height,
+  paddingX: 1,
+  width,
+  children: [
+    /* @__PURE__ */ jsxDEV(Text, {
+      wrap: "truncate",
+      children: [
+        /* @__PURE__ */ jsxDEV(Text, {
+          bold: true,
+          color: "cyan",
+          children: overlay.title
+        }, undefined, false, undefined, this),
+        overlay.above || overlay.below ? /* @__PURE__ */ jsxDEV(Text, {
+          dimColor: true,
+          children: `  \u25B2${overlay.above} \u25BC${overlay.below}`
+        }, undefined, false, undefined, this) : null
+      ]
+    }, undefined, true, undefined, this),
+    overlay.lines.map((line) => /* @__PURE__ */ jsxDEV(Line, {
+      line
+    }, line.key, false, undefined, this))
+  ]
+}, undefined, true, undefined, this);
+var Rule = ({ spans }) => /* @__PURE__ */ jsxDEV(Text, {
+  wrap: "truncate",
+  children: spans.map((span, at) => /* @__PURE__ */ jsxDEV(Styled, {
+    span
+  }, `${at}:${span.text}`, false, undefined, this))
+}, undefined, false, undefined, this);
+var Menu = ({ options, selected, marker, checked }) => /* @__PURE__ */ jsxDEV(Box, {
+  flexDirection: "column",
+  children: options.map((option, idx) => /* @__PURE__ */ jsxDEV(Text, {
+    wrap: "truncate",
+    children: [
+      /* @__PURE__ */ jsxDEV(Text, {
+        color: idx === selected ? "cyan" : undefined,
+        children: idx === selected ? "\u276F " : "  "
+      }, undefined, false, undefined, this),
+      checked ? /* @__PURE__ */ jsxDEV(Text, {
+        children: checked.includes(option.key) ? "[x] " : "[ ] "
+      }, undefined, false, undefined, this) : null,
+      /* @__PURE__ */ jsxDEV(Text, {
+        bold: idx === selected && marker,
+        children: option.label
+      }, undefined, false, undefined, this),
+      option.detail ? /* @__PURE__ */ jsxDEV(Text, {
+        dimColor: true,
+        children: `  ${option.detail}`
+      }, undefined, false, undefined, this) : null
+    ]
+  }, option.key, true, undefined, this))
+}, undefined, false, undefined, this);
+var CodeTuiApp = ({ actions }) => {
+  const [snapshot, setSnapshot] = useState(actions.snapshot);
+  const pasting = useRef(null);
+  const { setCursorPosition } = useCursor();
+  useEffect(() => {
+    const unsubscribe = actions.subscribe(() => setSnapshot(actions.snapshot()));
+    setSnapshot(actions.snapshot());
+    return unsubscribe;
+  }, [actions]);
+  setCursorPosition(snapshot.cursor ?? undefined);
+  useInput((input, key) => {
+    const page = Math.max(1, snapshot.bodyHeight - 3);
+    if (input === pasteOpen) {
+      pasting.current = [];
+      return;
+    }
+    if (input === pasteClose) {
+      const text = pasting.current?.join("") ?? "";
+      pasting.current = null;
+      return actions.pasted(text);
+    }
+    if (pasting.current) {
+      pasting.current.push(key.return ? `
+` : key.tab ? "\t" : input);
+      return;
+    }
+    if (key.ctrl && input === "c")
+      return actions.interrupt();
+    if (key.pageUp)
+      return actions.scroll(-page);
+    if (key.pageDown)
+      return actions.scroll(page);
+    if (key.escape)
+      return actions.cancel();
+    if (snapshot.overlay) {
+      if (key.upArrow)
+        return actions.scroll(-1);
+      if (key.downArrow)
+        return actions.scroll(1);
+      if (key.return)
+        return snapshot.overlay.selectable ? actions.submit() : actions.cancel();
+      return;
+    }
+    if (snapshot.mode === "confirm") {
+      if (input === "y" || input === "Y")
+        return actions.answerConfirm(true);
+      if (input === "n" || input === "N")
+        return actions.answerConfirm(false);
+      return;
+    }
+    if (snapshot.mode === "select") {
+      if (key.upArrow)
+        return actions.move(-1);
+      if (key.downArrow)
+        return actions.move(1);
+      if (input === " " && snapshot.multiSelect)
+        return actions.toggle();
+      if (key.return)
+        return actions.submit();
+      return;
+    }
+    if (key.tab)
+      return actions.complete();
+    if (key.upArrow)
+      return actions.vertical(-1);
+    if (key.downArrow)
+      return actions.vertical(1);
+    if (key.leftArrow)
+      return actions.edit(key.meta ? "wordLeft" : "left");
+    if (key.rightArrow)
+      return actions.edit(key.meta ? "wordRight" : "right");
+    if (key.return && (key.shift || key.meta))
+      return actions.newline();
+    if (key.ctrl && input === "j")
+      return actions.newline();
+    if (key.return)
+      return actions.submit();
+    if (key.backspace || key.delete)
+      return actions.edit(key.meta ? "deleteWord" : "backspace");
+    if (key.ctrl && input === "w")
+      return actions.edit("deleteWord");
+    if (key.ctrl && input === "u")
+      return actions.edit("deleteToStart");
+    if (key.ctrl && input === "a")
+      return actions.edit("home");
+    if (key.ctrl && input === "e")
+      return actions.edit("end");
+    if (key.ctrl && input === "d")
+      return actions.edit("delete");
+    if (key.ctrl && input === "v")
+      return actions.paste();
+    if (input && !key.ctrl && !key.meta)
+      return actions.type(input);
+  });
+  const paneWidth = snapshot.columns;
+  return /* @__PURE__ */ jsxDEV(Box, {
+    flexDirection: "column",
+    width: paneWidth,
+    height: snapshot.frameRows,
+    children: [
+      snapshot.overlay ? /* @__PURE__ */ jsxDEV(Overlay, {
+        height: snapshot.bodyHeight,
+        overlay: snapshot.overlay,
+        width: paneWidth
+      }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(Transcript, {
+        height: snapshot.bodyHeight,
+        lines: snapshot.lines,
+        width: paneWidth
+      }, undefined, false, undefined, this),
+      snapshot.menu.length ? /* @__PURE__ */ jsxDEV(Menu, {
+        marker: true,
+        options: snapshot.menu,
+        selected: snapshot.menuSelected
+      }, undefined, false, undefined, this) : null,
+      /* @__PURE__ */ jsxDEV(Rule, {
+        spans: snapshot.topRule
+      }, undefined, false, undefined, this),
+      snapshot.mode === "input" ? /* @__PURE__ */ jsxDEV(Box, {
+        flexDirection: "column",
+        children: [
+          snapshot.offered ? /* @__PURE__ */ jsxDEV(Text, {
+            dimColor: true,
+            wrap: "truncate",
+            children: "  \u29C9 an image is on your clipboard \u2014 cmd+v or ^v attaches it"
+          }, undefined, false, undefined, this) : null,
+          snapshot.input.map((row, at) => /* @__PURE__ */ jsxDEV(Text, {
+            wrap: "truncate",
+            children: [
+              /* @__PURE__ */ jsxDEV(Text, {
+                color: snapshot.status ? "yellow" : "cyan",
+                children: at === 0 ? snapshot.status ? "\u25D0 " : "\u203A " : "  "
+              }, undefined, false, undefined, this),
+              at === 0 && !row && snapshot.input.length === 1 ? /* @__PURE__ */ jsxDEV(Text, {
+                dimColor: true,
+                children: snapshot.placeholder
+              }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(Text, {
+                children: row
+              }, undefined, false, undefined, this)
+            ]
+          }, `in:${at}`, true, undefined, this))
+        ]
+      }, undefined, true, undefined, this) : /* @__PURE__ */ jsxDEV(Box, {
+        flexDirection: "column",
+        children: [
+          /* @__PURE__ */ jsxDEV(Text, {
+            color: "yellow",
+            wrap: "truncate",
+            children: snapshot.prompt
+          }, undefined, false, undefined, this),
+          snapshot.options.length ? /* @__PURE__ */ jsxDEV(Menu, {
+            checked: snapshot.multiSelect ? snapshot.checked : undefined,
+            marker: false,
+            options: snapshot.options,
+            selected: snapshot.selected
+          }, undefined, false, undefined, this) : null
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(Rule, {
+        spans: snapshot.bottomRule
+      }, undefined, false, undefined, this),
+      snapshot.notice ? /* @__PURE__ */ jsxDEV(Text, {
+        color: "cyan",
+        wrap: "truncate",
+        children: snapshot.notice
+      }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(Text, {
+        dimColor: true,
+        wrap: "truncate",
+        children: snapshot.hint
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+};
+
+// pkgs/@akanjs/cli/code/CodeTui.tsx
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+
+class CodeTui {
+  static frameMs = 34;
+  static clipboardMs = 2000;
+  static noticeMs = 4000;
+  static chromeRows = 1;
+  static promptRuleRows = 1;
+  static minBodyRows = 3;
+  static maxInputRows = 8;
+  static title = "Akan \u2014 write one line, deploy every stack";
+  static imageMark = /\[image #(\d+)] ?/g;
+  static pasteOn = "\x1B[?2004h";
+  static pasteOff = "\x1B[?2004l";
+  #agent;
+  #transcript = new CodeTranscript;
+  #editor = new CodeTuiEditor2;
+  #files;
+  #listeners = new Set;
+  #history = [];
+  #instance;
+  #stdout;
+  #historyAt = -1;
+  #anchor = null;
+  #selected = 0;
+  #menuAt = 0;
+  #checked = [];
+  #overlay = null;
+  #overlayAt = 0;
+  #picker = null;
+  #images = [];
+  #switchTo;
+  #offered = false;
+  #clipboardTimer = null;
+  #notice = "";
+  #opening;
+  #thinking;
+  #noticeTimer = null;
+  #frameTimer = null;
+  #cached = null;
+  #unsubscribe;
+  #exiting = false;
+  constructor(agent, { thinking = false, notice, ...streams } = {}) {
+    this.#agent = agent;
+    this.#thinking = thinking;
+    this.#opening = notice ?? "";
+    this.#files = new CodeTuiFiles2(agent.profile.paths.root);
+    this.#stdout = streams.stdout ?? process.stdout;
+    this.#stdout.on("resize", this.#onResize);
+    this.#instance = render(/* @__PURE__ */ jsxDEV2(CodeTuiApp, {
+      actions: {
+        subscribe: this.#subscribe,
+        snapshot: this.#snapshot,
+        type: this.#type,
+        edit: this.#edit,
+        submit: this.#submit,
+        newline: this.#newline,
+        paste: this.#paste,
+        pasted: this.#pasted,
+        complete: this.#complete,
+        vertical: this.#vertical,
+        scroll: this.#scroll,
+        move: this.#move,
+        toggle: this.#toggle,
+        answerConfirm: this.#answerConfirm,
+        cancel: this.#cancel,
+        interrupt: this.#interrupt
+      }
+    }, undefined, false, undefined, this), {
+      patchConsole: true,
+      exitOnCtrlC: false,
+      kittyKeyboard: { mode: "auto" },
+      ...streams
+    });
+  }
+  async run(seed) {
+    this.#stdout.write(CodeTui.pasteOn);
+    if (this.#opening)
+      this.#say(this.#opening);
+    this.#unsubscribe = this.#agent.on((event) => {
+      this.#transcript.apply(event);
+      this.#scheduleFrame();
+    });
+    this.#agent.announce();
+    this.#files.load().then(() => this.#renderNow());
+    this.#watchClipboard();
+    if (seed?.trim())
+      this.#send(seed.trim());
+    await this.#instance.waitUntilExit();
+    this.#close();
+    return this.#switchTo;
+  }
+  close() {
+    this.#quit();
+  }
+  #watchClipboard() {
+    if (!this.#agent.canSeeImages)
+      return;
+    this.#clipboardTimer = setInterval(() => {
+      const offered = CodeTuiClipboard2.has();
+      if (offered === this.#offered)
+        return;
+      this.#offered = offered;
+      this.#renderNow();
+    }, CodeTui.clipboardMs);
+  }
+  #close() {
+    if (this.#clipboardTimer)
+      clearInterval(this.#clipboardTimer);
+    this.#clipboardTimer = null;
+    if (this.#frameTimer)
+      clearTimeout(this.#frameTimer);
+    if (this.#noticeTimer)
+      clearTimeout(this.#noticeTimer);
+    this.#frameTimer = null;
+    this.#noticeTimer = null;
+    this.#stdout.off("resize", this.#onResize);
+    this.#unsubscribe?.();
+    this.#farewell();
+  }
+  #farewell() {
+    const info = this.#transcript.info;
+    if (this.#switchTo || !info?.sessionId || !this.#agent.sessions().length)
+      return;
+    if (!this.#transcript.parts.some((part) => part.kind === "user"))
+      return;
+    const name = info.name ? ` (${info.name})` : "";
+    this.#stdout.write(`Resume this session${name} with:
+  akan code --resume ${info.sessionId}
+`);
+  }
+  #onResize = () => this.#renderNow();
+  #subscribe = (listener) => {
+    this.#listeners.add(listener);
+    return () => this.#listeners.delete(listener);
+  };
+  #scheduleFrame() {
+    if (this.#frameTimer)
+      return;
+    this.#frameTimer = setTimeout(() => {
+      this.#frameTimer = null;
+      this.#renderNow();
+    }, CodeTui.frameMs);
+  }
+  #renderNow() {
+    this.#cached = null;
+    for (const listener of this.#listeners)
+      listener();
+  }
+  static layout(frameRows, askRows) {
+    const room = Math.max(1, frameRows - CodeTui.minBodyRows - CodeTui.chromeRows);
+    const ask = Math.max(1, Math.min(askRows, room));
+    return { ask, bodyHeight: Math.max(CodeTui.minBodyRows, frameRows - ask - CodeTui.chromeRows) };
+  }
+  static frameRowsOf(terminalRows) {
+    return Math.max(CodeTui.minBodyRows + CodeTui.chromeRows + 1, terminalRows - 1);
+  }
+  #snapshot = () => {
+    if (this.#cached)
+      return this.#cached;
+    const columns = Math.max(40, this.#stdout.columns || 80);
+    const frameRows = CodeTui.frameRowsOf(Math.max(10, this.#stdout.rows || 24));
+    const question = this.#transcript.question;
+    const approval = this.#transcript.approval;
+    const mode = CodeTui.#modeOf(question, approval);
+    const ask = mode === "input" ? this.#inputBlock(columns, frameRows) : this.#askBlock(question, frameRows);
+    const { bodyHeight } = CodeTui.layout(frameRows, ask.rows);
+    const width = columns - 2;
+    const lines = this.#lines(width);
+    const end = this.#anchor === null ? lines.length : Math.min(lines.length, Math.max(bodyHeight, this.#anchor));
+    const start = Math.max(0, end - bodyHeight);
+    const above = start;
+    const below = lines.length - end;
+    this.#cached = {
+      topRule: CodeTui.rule(this.#anchor === null ? "" : `\u25B2${above} \u25BC${below} paused`, this.#transcript.info?.name ?? this.#transcript.info?.sessionId.slice(0, 8) ?? "", columns),
+      bottomRule: CodeTui.rule(this.#queueLabel(), this.#statusLabel(), columns),
+      lines: lines.slice(start, end),
+      above,
+      below,
+      following: this.#anchor === null,
+      overlay: this.#overlayBlock(width, bodyHeight),
+      status: this.#status(),
+      mode,
+      placeholder: this.#transcript.streaming ? "type to steer, esc to interrupt" : "ask for something, / for commands",
+      offered: this.#offered,
+      prompt: CodeTui.#promptOf(question, approval),
+      selected: ask.selected,
+      checked: this.#checked,
+      multiSelect: !!question?.multiSelect,
+      notice: this.#notice,
+      hint: this.#overlay ? "esc close \xB7 \u2191\u2193 scroll" : CodeTui.#hintOf(mode, !!question?.multiSelect),
+      columns,
+      frameRows,
+      bodyHeight,
+      cursor: ask.caret ? { x: promptMarkWidth + ask.caret.col, y: bodyHeight + ask.above + ask.caret.row } : null,
+      ...ask.snapshot
+    };
+    return this.#cached;
+  };
+  #lines(width) {
+    return [
+      ...CodeTuiLines2.rows(this.#banner(), width, "banner"),
+      ...CodeTuiParts2.lines(this.#transcript.parts, width, { thinking: this.#thinking })
+    ];
+  }
+  #banner() {
+    const cwd = this.#transcript.info?.cwd;
+    return [
+      { prefix: { text: "\u273B ", color: "cyan" }, spans: [{ text: CodeTui.title, bold: true }] },
+      {
+        prefix: { text: "  " },
+        spans: [{ text: cwd ? `${cwd} \xB7 /help for commands` : "/help for commands", dim: true }]
+      }
+    ];
+  }
+  static rule(left, right, width) {
+    const room = (label) => label ? 3 + CodeTuiLines2.width(label) : 1;
+    const tail = right ? codeAgentClip(right, Math.max(1, width - 4)) : "";
+    const head = width - room(left) - room(tail) >= 0 ? left : "";
+    const fill = Math.max(0, width - room(head) - room(tail));
+    return [
+      ...head ? [
+        { text: "\u2500 ", dim: true },
+        { text: head, color: "cyan" },
+        { text: " ", dim: true }
+      ] : [{ text: "\u2500", dim: true }],
+      { text: "\u2500".repeat(fill), dim: true },
+      ...tail ? [
+        { text: " ", dim: true },
+        { text: tail, dim: true },
+        { text: " \u2500", dim: true }
+      ] : [{ text: "\u2500", dim: true }]
+    ];
+  }
+  #overlayBlock(width, height) {
+    if (this.#picker)
+      return this.#pickerBlock(width, height);
+    const overlay = this.#overlay;
+    if (!overlay)
+      return null;
+    const room = Math.max(1, height - 3);
+    const body = Math.max(8, width - 4);
+    const all = CodeTui.#overlayRows(overlay.text, body);
+    const first = Math.max(0, Math.min(this.#overlayAt, all.length - room));
+    return {
+      title: overlay.title,
+      lines: all.slice(first, first + room),
+      above: first,
+      below: Math.max(0, all.length - first - room),
+      selectable: false
+    };
+  }
+  #pickerBlock(width, height) {
+    const picker = this.#picker;
+    if (!picker)
+      return null;
+    const room = Math.max(1, height - 3);
+    const body = Math.max(8, width - 4);
+    const first = Math.max(0, Math.min(picker.at - Math.floor(room / 2), picker.entries.length - room));
+    const rows = picker.entries.slice(first, first + room).map((entry, at) => CodeTui.#sessionRow(entry, first + at === picker.at));
+    return {
+      title: `sessions \xB7 ${picker.entries.length}`,
+      lines: rows.flatMap((row, at) => CodeTuiLines2.rows([row], body, `sessions:${first + at}`).slice(0, 1)),
+      above: first,
+      below: Math.max(0, picker.entries.length - first - room),
+      selectable: true
+    };
+  }
+  static #sessionRow(entry, selected) {
+    const label = entry.name ?? entry.id.slice(0, 8);
+    return {
+      prefix: { text: selected ? "\u276F " : "  ", color: "cyan" },
+      spans: [
+        { text: label, bold: selected },
+        { text: `  ${CodeTui.#ago(entry.updatedAt)} \xB7 ${entry.turns} turn${entry.turns === 1 ? "" : "s"}`, dim: true },
+        ...entry.opening ? [{ text: `  ${entry.opening}`, dim: true }] : []
+      ]
+    };
+  }
+  static #ago(at) {
+    const minutes = Math.max(0, Math.round((Date.now() - at) / 60000));
+    if (minutes < 60)
+      return `${minutes}m ago`;
+    if (minutes < 60 * 24)
+      return `${Math.round(minutes / 60)}h ago`;
+    return `${Math.round(minutes / (60 * 24))}d ago`;
+  }
+  #inputBlock(columns, frameRows) {
+    const all = this.#menu()?.options ?? [];
+    const { rows, row, col } = this.#editor.layout(columns - promptMarkWidth - 1);
+    const offered = this.#offered ? 1 : 0;
+    const room = frameRows - CodeTui.minBodyRows - CodeTui.chromeRows - 2 * CodeTui.promptRuleRows - offered;
+    const menuRows = Math.max(0, Math.min(all.length, room - 1));
+    const menuFrom = Math.max(0, Math.min(this.#menuAt - Math.floor(menuRows / 2), all.length - menuRows));
+    const menu = all.slice(menuFrom, menuFrom + menuRows);
+    const above = menu.length + CodeTui.promptRuleRows + offered;
+    const chrome = above + CodeTui.promptRuleRows;
+    const budget = Math.max(1, Math.min(CodeTui.maxInputRows, room - menu.length));
+    const first = Math.max(0, Math.min(row - budget + 1, rows.length - budget));
+    const shown = rows.slice(first, first + budget);
+    return {
+      rows: chrome + shown.length,
+      above,
+      selected: 0,
+      caret: { row: row - first, col },
+      snapshot: {
+        input: shown.map((entry) => entry.text),
+        menu,
+        menuSelected: this.#menuAt - menuFrom,
+        options: []
+      }
+    };
+  }
+  #askBlock(question, frameRows) {
+    const all = CodeTui.#optionsOf(question);
+    const chrome = 1 + 2 * CodeTui.promptRuleRows;
+    const budget = Math.max(1, frameRows - CodeTui.minBodyRows - CodeTui.chromeRows - chrome);
+    const shown = Math.min(all.length, budget);
+    const first = Math.max(0, Math.min(this.#selected - Math.floor(shown / 2), all.length - shown));
+    return {
+      rows: chrome + shown,
+      above: CodeTui.promptRuleRows,
+      selected: this.#selected - first,
+      caret: undefined,
+      snapshot: {
+        input: [],
+        menu: [],
+        menuSelected: 0,
+        options: all.slice(first, first + shown)
+      }
+    };
+  }
+  #menu() {
+    const prefix = CodeTuiCommands2.prefixOf(this.#editor.text, this.#editor.caret);
+    if (prefix !== undefined)
+      return {
+        kind: "command",
+        from: 0,
+        to: this.#editor.text.length,
+        options: CodeTuiCommands2.matches(prefix).map((command) => ({
+          key: command.name,
+          label: `/${command.name}${command.arg ? ` ${command.arg}` : ""}`,
+          detail: command.desc
+        }))
+      };
+    const token = this.#editor.token();
+    if (!token.text.startsWith("@"))
+      return null;
+    const options = this.#files.match(token.text.slice(1)).map((file) => ({ key: file, label: `@${file}` }));
+    if (!options.length && this.#files.ready)
+      return null;
+    return { kind: "file", from: token.from, to: token.to, options };
+  }
+  static #overlayRows(text, width) {
+    return text.split(`
+`).flatMap((line, at) => CodeTuiLines2.rows(line.trim() ? CodeTuiMarkdown2.rows(line, width) : [{ spans: [{ text: " " }] }], width, `overlay:${at}`));
+  }
+  #queueLabel() {
+    const queue = this.#transcript.queue;
+    const parts = [];
+    if (queue.steering || queue.followUp)
+      parts.push(`queued ${queue.steering + queue.followUp}`);
+    if (this.#transcript.compacting)
+      parts.push("compacting");
+    return parts.join(" \xB7 ");
+  }
+  #statusLabel() {
+    const info = this.#transcript.info;
+    if (!info)
+      return "starting\u2026";
+    const context = this.#transcript.context;
+    const window = info.contextTokens ? `${Math.round(info.contextTokens / 1000)}k` : "";
+    const used = context?.max ? `${Math.round(context.used / context.max * 100)}% of ${window}` : "";
+    return [info.model?.name ?? "no model", used || window && `${window} ctx`, info.profile, info.effort].filter((part) => !!part).join(" \xB7 ");
+  }
+  #status() {
+    if (this.#transcript.compacting)
+      return "compacting";
+    return this.#transcript.streaming ? "working" : "";
+  }
+  static #modeOf(question, approval) {
+    if (approval)
+      return "confirm";
+    if (!question)
+      return "input";
+    if (question.kind === "confirm")
+      return "confirm";
+    if (question.kind === "select" && question.options?.length)
+      return "select";
+    return "input";
+  }
+  static #optionsOf(question) {
+    return (question?.options ?? []).map((option) => ({
+      key: option.key,
+      label: option.label,
+      ...option.detail ? { detail: option.detail } : {}
+    }));
+  }
+  static #promptOf(question, approval) {
+    if (approval)
+      return `approve? ${approval.summary}  [y/n]`;
+    return question ? `? ${question.prompt}` : "";
+  }
+  static #hintOf(mode, multiSelect) {
+    if (mode === "confirm")
+      return "y yes \xB7 n no \xB7 esc no";
+    if (mode === "select")
+      return `\u2191\u2193 choose${multiSelect ? " \xB7 space toggle" : ""} \xB7 enter answer \xB7 esc skip \xB7 pgup/pgdn scroll`;
+    return "enter send \xB7 shift+enter newline \xB7 \u2191\u2193 move \xB7 esc interrupt \xB7 pgup/pgdn scroll \xB7 ^c quit \xB7 /help";
+  }
+  #type = (text) => {
+    const pasted = this.#agent.canSeeImages ? CodeTuiClipboard2.imagePathsIn(text) : undefined;
+    if (pasted?.images.length) {
+      for (const file of pasted.images)
+        this.#attach(file);
+      if (pasted.rest)
+        this.#editor.insert(pasted.rest);
+    } else
+      this.#editor.insert(text);
+    this.#menuAt = 0;
+    this.#historyAt = -1;
+    this.#renderNow();
+  };
+  #newline = () => {
+    this.#editor.newline();
+    this.#historyAt = -1;
+    this.#renderNow();
+  };
+  #edit = (action) => {
+    const width = this.#snapshot().columns - promptMarkWidth - 1;
+    const run = {
+      backspace: () => this.#editor.backspace(),
+      delete: () => this.#editor.deleteForward(),
+      left: () => this.#editor.caret ? this.#editor.left() : this.#openSessions(),
+      right: () => this.#editor.right(),
+      wordLeft: () => this.#editor.wordLeft(),
+      wordRight: () => this.#editor.wordRight(),
+      home: () => this.#editor.homeOfRow(width),
+      end: () => this.#editor.endOfRow(width),
+      deleteWord: () => this.#editor.deleteWord(),
+      deleteToStart: () => this.#editor.deleteToLineStart()
+    };
+    run[action]();
+    if (action.startsWith("delete") || action === "backspace")
+      this.#historyAt = -1;
+    this.#renderNow();
+  };
+  #vertical = (delta) => {
+    if (this.#picker)
+      return this.#move(delta);
+    if (this.#overlay)
+      return this.#scroll(delta);
+    const menu = this.#menu()?.options ?? [];
+    if (menu.length) {
+      this.#menuAt = (this.#menuAt + delta + menu.length) % menu.length;
+      return this.#renderNow();
+    }
+    if (this.#historyAt < 0 && this.#editor.move(delta, this.#snapshot().columns - promptMarkWidth - 1))
+      return this.#renderNow();
+    if (delta < 0)
+      return this.#historyPrev();
+    return this.#historyNext();
+  };
+  #complete = () => {
+    const menu = this.#menu();
+    const chosen = menu?.options[this.#menuAt];
+    if (!menu || !chosen)
+      return;
+    const command = CodeTuiCommands2.all.find((entry) => entry.name === chosen.key);
+    const text = menu.kind === "command" ? `/${chosen.key}${command?.arg ? " " : ""}` : `@${chosen.key} `;
+    this.#editor.replace(menu.from, menu.to, text);
+    this.#menuAt = 0;
+    this.#renderNow();
+  };
+  #historyPrev() {
+    if (!this.#history.length)
+      return;
+    this.#historyAt = this.#historyAt < 0 ? this.#history.length - 1 : Math.max(0, this.#historyAt - 1);
+    this.#editor.set(this.#history[this.#historyAt] ?? "");
+    this.#renderNow();
+  }
+  #historyNext() {
+    if (this.#historyAt < 0)
+      return;
+    this.#historyAt += 1;
+    if (this.#historyAt >= this.#history.length) {
+      this.#historyAt = -1;
+      this.#editor.clear();
+    } else
+      this.#editor.set(this.#history[this.#historyAt] ?? "");
+    this.#renderNow();
+  }
+  #scroll = (delta) => {
+    if (this.#picker)
+      return this.#move(Math.sign(delta));
+    if (this.#overlay) {
+      this.#overlayAt = Math.max(0, this.#overlayAt + Math.trunc(delta));
+      return this.#renderNow();
+    }
+    const snapshot = this.#snapshot();
+    const total = snapshot.above + snapshot.lines.length + snapshot.below;
+    const rows = Math.max(1, snapshot.lines.length);
+    if (total <= rows)
+      return;
+    const end = this.#anchor === null ? total : this.#anchor;
+    const next = Math.min(total, Math.max(rows, end + Math.trunc(delta)));
+    this.#anchor = next >= total ? null : next;
+    this.#renderNow();
+  };
+  #move = (delta) => {
+    const picker = this.#picker;
+    if (picker) {
+      picker.at = Math.max(0, Math.min(picker.entries.length - 1, picker.at + delta));
+      return this.#renderNow();
+    }
+    const count = this.#transcript.question?.options?.length ?? 0;
+    if (!count)
+      return;
+    this.#selected = (this.#selected + delta + count) % count;
+    this.#renderNow();
+  };
+  #toggle = () => {
+    const option = this.#transcript.question?.options?.[this.#selected];
+    if (!option)
+      return;
+    this.#checked = this.#checked.includes(option.key) ? this.#checked.filter((key) => key !== option.key) : [...this.#checked, option.key];
+    this.#renderNow();
+  };
+  #answerConfirm = (value) => {
+    const approval = this.#transcript.approval;
+    if (approval)
+      return void this.#agent.approve(approval.approvalId, value);
+    const question = this.#transcript.question;
+    if (question)
+      this.#answer(question.questionId, { text: value ? "yes" : "no" });
+  };
+  #cancel = () => {
+    if (this.#overlay || this.#picker)
+      return this.#dismiss();
+    const approval = this.#transcript.approval;
+    if (approval)
+      return void this.#agent.approve(approval.approvalId, false);
+    const question = this.#transcript.question;
+    if (question)
+      return void this.#answer(question.questionId, {});
+    if (this.#transcript.streaming)
+      return void this.#agent.abort();
+    if (!this.#editor.isEmpty) {
+      this.#editor.clear();
+      this.#renderNow();
+    }
+  };
+  #interrupt = () => {
+    if (this.#transcript.streaming) {
+      this.#agent.abort();
+      this.#say("interrupted \u2014 ^c again to quit");
+      return;
+    }
+    this.#quit();
+  };
+  #quit() {
+    if (this.#exiting)
+      return;
+    this.#exiting = true;
+    this.#stdout.write(CodeTui.pasteOff);
+    this.#instance.clear();
+    this.#instance.unmount();
+  }
+  #submit = () => {
+    if (this.#picker)
+      return this.#resume(this.#picker.entries[this.#picker.at]?.id);
+    const question = this.#transcript.question;
+    if (question)
+      return void this.#answerCurrent(question.questionId);
+    const menu = this.#menu();
+    if (menu?.kind === "file")
+      return this.#complete();
+    const chosen = menu?.options[this.#menuAt];
+    const raw = chosen ? `/${chosen.key}` : this.#editor.text;
+    const pending = this.#pending(raw);
+    if (!pending.text && !pending.images.length)
+      return;
+    this.#editor.clear();
+    this.#historyAt = -1;
+    if (pending.text)
+      this.#history.push(pending.text);
+    if (pending.text.startsWith("/"))
+      return this.#command(pending.text);
+    this.#send(pending.text, pending.images);
+  };
+  #send(text, images = []) {
+    this.#images = [];
+    this.#transcript.echo(text, images.length);
+    this.#renderNow();
+    this.#agent.prompt(text, images).catch((error) => this.#fail(error));
+  }
+  #paste = () => {
+    if (!this.#agent.canSeeImages)
+      return this.#open("images", CodeTui.#imageHelp(this.#transcript.info?.model));
+    CodeTuiClipboard2.image().then((file) => file ? this.#attach(file) : this.#say("nothing on the clipboard we can attach")).catch((error) => this.#fail(error));
+  };
+  #pasted = (text) => {
+    if (text)
+      return this.#type(text.replace(/\r\n?/g, `
+`));
+    if (CodeTuiClipboard2.has())
+      this.#paste();
+  };
+  #attach(file) {
+    this.#images.push(file);
+    this.#editor.insert(`[image #${this.#images.length}] `);
+    this.#renderNow();
+  }
+  #pending(text) {
+    const marks = [...text.matchAll(CodeTui.imageMark)].map((match) => Number(match[1]));
+    const images = marks.map((mark) => this.#images[mark - 1]).filter((file) => !!file).map((path) => ({ path }));
+    return { images, text: text.replace(CodeTui.imageMark, "").trim() };
+  }
+  static #imageHelp(model) {
+    const provider = model?.provider ?? "<provider>";
+    const id = model?.id ?? "<model>";
+    return [
+      `The model catalogue declares ${provider}/${id} text-only, so an image would go to a model that cannot read it.`,
+      "",
+      "If that is wrong, override the entry in ~/.akan/code/models.json:",
+      "",
+      `{"providers":{"${provider}":{"modelOverrides":{"${id}":{"input":["text","image"]}}}}}`
+    ].join(`
+`);
+  }
+  #openSessions = () => {
+    const entries = this.#agent.sessions();
+    if (!entries.length)
+      return this.#say("no stored sessions yet");
+    const current = this.#transcript.info?.sessionId;
+    this.#picker = {
+      entries,
+      at: Math.max(0, entries.findIndex((entry) => entry.id === current))
+    };
+    this.#renderNow();
+  };
+  #resume(id) {
+    if (!id)
+      return this.#dismiss();
+    if (id === this.#transcript.info?.sessionId)
+      return this.#dismiss();
+    this.#switchTo = { id };
+    this.#quit();
+  }
+  #fork(argument) {
+    if (!this.#transcript.parts.some((part) => part.kind === "user"))
+      return this.#open("fork", "Nothing has been said in this session yet, so a fork of it is a new session.");
+    const from = this.#transcript.info?.sessionId ?? "";
+    try {
+      const forked = this.#agent.fork(argument.trim() || undefined);
+      this.#switchTo = { id: forked.id, notice: `forked \u2014 the original is akan code --resume ${from}` };
+      this.#quit();
+    } catch (error) {
+      this.#fail(error);
+    }
+  }
+  #answerCurrent(questionId) {
+    const options = this.#transcript.question?.options ?? [];
+    const answer = options.length ? { keys: this.#transcript.question?.multiSelect ? this.#checked : [options[this.#selected]?.key ?? ""] } : { text: this.#editor.text.trim() };
+    this.#editor.clear();
+    this.#answer(questionId, answer);
+  }
+  async#answer(questionId, answer) {
+    this.#selected = 0;
+    this.#checked = [];
+    this.#renderNow();
+    await this.#agent.answer(questionId, answer);
+  }
+  #command(line) {
+    const [name, ...rest] = line.slice(1).split(" ");
+    const argument = rest.join(" ").trim();
+    switch (name) {
+      case "help":
+        return this.#open("help", CodeTuiCommands2.help());
+      case "quit":
+      case "exit":
+        return this.#quit();
+      case "abort":
+        return void this.#agent.abort();
+      case "clear":
+        this.#anchor = null;
+        this.#transcript.clear();
+        return this.#say("screen cleared \xB7 the model still remembers \xB7 /compact shortens what it carries");
+      case "compact":
+        return void this.#agent.compact(argument || undefined).catch((error) => this.#fail(error));
+      case "thinking":
+        this.#thinking = !this.#thinking;
+        return this.#say(this.#thinking ? "showing the model's reasoning" : "reasoning folded back to one line");
+      case "tools": {
+        const tools = this.#transcript.info?.tools ?? [];
+        return this.#open("tools", `${tools.length} tools
+
+${tools.join(" \xB7 ")}`);
+      }
+      case "model":
+        return this.#setModel(argument);
+      case "effort":
+        return this.#setEffort(argument);
+      case "peers":
+        return this.#open("peers", CodeTui.#peerList(this.#agent.peers()));
+      case "msg":
+        return this.#message(argument);
+      case "fork":
+        return this.#fork(argument);
+      case "agents":
+        return this.#open("agents", this.#agentList());
+      case "name":
+        if (!argument)
+          return this.#open("name", "Usage: /name <what this session is about>");
+        this.#agent.setName(argument);
+        return this.#say(`session named ${argument}`);
+      default:
+        return this.#open("unknown command", `There is no /${name}.
+
+${CodeTuiCommands2.help()}`);
+    }
+  }
+  #agentList() {
+    const budget = this.#agent.profile.tools.subagent;
+    if (!budget)
+      return "Sub-agents are off in this profile.";
+    const column = Math.max(...Object.keys(SubagentPool2.kinds).map((kind) => kind.length)) + 2;
+    const kinds = Object.entries(SubagentPool2.kinds).map(([kind, spec]) => `${kind.padEnd(column)}${spec.desc}`);
+    return [
+      ...kinds,
+      "",
+      `At most ${budget.maxConcurrent} at once, ${budget.maxDepth} deep, ${budget.budget} tokens for the whole tree.`,
+      "",
+      "Ask for one in a sentence \u2014 the model calls the tool. Its reading never enters this conversation."
+    ].join(`
+`);
+  }
+  static #peerList(peers) {
+    if (!peers.length)
+      return "No other akan code session is running in this workspace.";
+    const column = Math.max(...peers.map((peer) => peer.name.length)) + 2;
+    const rows = peers.map((peer) => `${peer.name.padEnd(column)}${peer.id.slice(0, 8)}  ${peer.cwd}`);
+    return [...rows, "", "/msg <peer> <text> hands one of them a message."].join(`
+`);
+  }
+  #message(argument) {
+    const [target, ...rest] = argument.split(" ");
+    const text = rest.join(" ").trim();
+    if (!target || !text)
+      return this.#open("msg", `Usage: /msg <peer> <text>
+
+${CodeTui.#peerList(this.#agent.peers())}`);
+    try {
+      const peer = this.#agent.send(target, text);
+      this.#say(`sent to ${peer.name}`);
+    } catch (error) {
+      this.#fail(error);
+    }
+  }
+  #setEffort(argument) {
+    const levels = this.#agent.efforts();
+    if (!levels.length)
+      return this.#open("effort", "This model does no reasoning, so it has no effort to set.");
+    const wanted = argument.trim().toLowerCase();
+    if (!levels.includes(wanted))
+      return this.#open("effort", `Usage: /effort <level>
+
+now: ${this.#transcript.info?.effort ?? "unknown"}
+${levels.join(" \xB7 ")}`);
+    try {
+      this.#agent.setEffort(wanted);
+      this.#say(`effort ${this.#transcript.info?.effort ?? wanted}`);
+    } catch (error) {
+      this.#fail(error);
+    }
+  }
+  #setModel(argument) {
+    const [provider, ...rest] = argument.split("/");
+    if (!provider || !rest.length)
+      return this.#open("model", `Usage: /model <provider>/<id>
+
+e.g. /model deepseek/deepseek-v4-pro`);
+    this.#agent.setModel({ provider, id: rest.join("/") }).catch((error) => this.#fail(error));
+  }
+  #open(title, text) {
+    this.#overlay = { title, text };
+    this.#overlayAt = 0;
+    this.#renderNow();
+  }
+  #dismiss() {
+    this.#overlay = null;
+    this.#overlayAt = 0;
+    this.#picker = null;
+    this.#renderNow();
+  }
+  #fail(error) {
+    this.#transcript.note("error", String(error));
+    this.#renderNow();
+  }
+  #note(text) {
+    this.#transcript.note("info", text);
+    this.#renderNow();
+  }
+  #say(text) {
+    this.#notice = text;
+    if (this.#noticeTimer)
+      clearTimeout(this.#noticeTimer);
+    this.#noticeTimer = setTimeout(() => {
+      this.#notice = "";
+      this.#renderNow();
+    }, CodeTui.noticeMs);
+    this.#renderNow();
+  }
+}
+export {
+  CodeTui
+};