openshain 0.3.1 → 0.4.0

package/NOTICE

@@ -0,0 +1,4 @@
+openshain
+Copyright 2026 openshain contributors
+
+Licensed under the Apache License, Version 2.0.

package/dist/commands/init.d.ts

@@ -6,7 +6,7 @@ export declare const CONFIG_TEMPLATE: string;
 /** Registers the runtime as a project MCP server for Claude Code. `openshain` must be on PATH. */
 export declare const MCP_TEMPLATE: string;
 /** What an outside agent reads before working in the folder. Codex reads AGENTS.md; Claude Code reads it through CLAUDE.md. */
-export declare const AGENTS_TEMPLATE = "# \u3053\u306E\u4F1A\u793E\u30D5\u30A9\u30EB\u30C0\u3067\u50CD\u304F\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u3078\n\n\u3053\u306E\u30D5\u30A9\u30EB\u30C0\u306F openshain \u306E Company Workspace \u3067\u3059\u3002\u3053\u306E\u6307\u793A\u306F\u3001Claude Code \u3084 Codex \u306E\u3088\u3046\u306A\u5916\u90E8\u306E\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u304C MCP \u7D4C\u7531\u3067\u3053\u306E\u30D5\u30A9\u30EB\u30C0\u3092\u6271\u3046\u3068\u304D\u306E\u3082\u306E\u3067\u3059\u3002openshain \u306E\u5BFE\u8A71\u578B CLI \u3082\u540C\u3058\u624B\u9806\u3067 Runtime \u3092\u4F7F\u3044\u307E\u3059\u3002\n\n\u4F1A\u793E\u306E\u30D5\u30A1\u30A4\u30EB\u306E\u8AAD\u307F\u66F8\u304D\u3068\u96C6\u8A08\u306F openshain \u306E MCP tool \u3067\u884C\u3044\u307E\u3059\u3002Claude Code \u3084 Codex \u81EA\u8EAB\u306E Read\u3001Write\u3001Bash \u306F\u4F1A\u793E\u306E\u30D5\u30A1\u30A4\u30EB\u306B\u306F\u4F7F\u3044\u307E\u305B\u3093\u3002Runtime \u3092\u901A\u3089\u306A\u304B\u3063\u305F\u64CD\u4F5C\u306F\u8A18\u9332\u306B\u6B8B\u3089\u306A\u3044\u305F\u3081\u3067\u3059\u3002\n\n- \u4F9D\u983C\u3092\u53D7\u3051\u305F\u3089\u3001\u307E\u305A `work_create` \u306B\u4F9D\u983C\u306E\u6587\u3092\u305D\u306E\u307E\u307E\u6E21\u3057\u3066 Work \u3092\u4F5C\u308B\n- \u30D5\u30A1\u30A4\u30EB\u306F `fs_list`\u3001`fs_search`\u3001`fs_read`\u3001`csv_read`\u3001`markdown_read` \u3067\u898B\u308B\u3002\u5408\u8A08\u3084\u4EF6\u6570\u306F `csv_aggregate` \u306B\u4EFB\u305B\u3001\u81EA\u5206\u3067\u5408\u8A08\u3057\u306A\u3044\n- \u66F8\u304F\u3068\u304D\u306F `fs_write` \u304B `csv_write`\n- \u7D42\u308F\u3063\u305F\u3089 `work_complete` \u306B\u3001\u4F55\u3092\u3057\u305F\u304B\u3068\u3001\u66F8\u3044\u305F\u30D5\u30A1\u30A4\u30EB\u3092\u6E21\u3059\u3002\u7D9A\u3051\u3089\u308C\u306A\u3044\u3068\u304D\u306F `work_fail`\n- `openshain.yaml` \u3068 `work/` \u306F Runtime \u306E\u3082\u306E\u3002\u5909\u66F4\u3057\u306A\u3044\n";
+export declare const AGENTS_TEMPLATE = "# \u3053\u306E\u4F1A\u793E\u30D5\u30A9\u30EB\u30C0\u3067\u50CD\u304F\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u3078\n\n\u3053\u306E\u30D5\u30A9\u30EB\u30C0\u306F openshain \u306E Company Workspace \u3067\u3059\u3002\u3053\u306E\u6307\u793A\u306F\u3001Claude Code \u3084 Codex \u306E\u3088\u3046\u306A\u5916\u90E8\u306E\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u304C MCP \u7D4C\u7531\u3067\u3053\u306E\u30D5\u30A9\u30EB\u30C0\u3092\u6271\u3046\u3068\u304D\u306E\u3082\u306E\u3067\u3059\u3002openshain \u306E\u5BFE\u8A71\u578B CLI \u3082\u540C\u3058\u624B\u9806\u3067 Runtime \u3092\u4F7F\u3044\u307E\u3059\u3002\n\n\u4F1A\u793E\u306E\u30D5\u30A1\u30A4\u30EB\u306E\u8AAD\u307F\u66F8\u304D\u3068\u96C6\u8A08\u306F openshain \u306E MCP tool \u3067\u884C\u3044\u307E\u3059\u3002Claude Code \u3084 Codex \u81EA\u8EAB\u306E Read\u3001Write\u3001Bash \u306F\u4F1A\u793E\u306E\u30D5\u30A1\u30A4\u30EB\u306B\u306F\u4F7F\u3044\u307E\u305B\u3093\u3002Runtime \u3092\u901A\u3089\u306A\u304B\u3063\u305F\u64CD\u4F5C\u306F\u8A18\u9332\u306B\u6B8B\u3089\u306A\u3044\u305F\u3081\u3067\u3059\u3002\n\n- \u4F9D\u983C\u3092\u53D7\u3051\u305F\u3089\u3001\u307E\u305A `work_create` \u306B\u4F9D\u983C\u306E\u6587\u3092\u305D\u306E\u307E\u307E\u6E21\u3057\u3066 Work \u3092\u4F5C\u308B\n- \u30D5\u30A1\u30A4\u30EB\u306F `fs_list`\u3001`fs_search`\u3001`fs_read`\u3001`csv_read`\u3001`markdown_read` \u3067\u898B\u308B\u3002\u5408\u8A08\u3084\u4EF6\u6570\u306F `csv_aggregate` \u306B\u4EFB\u305B\u3001\u81EA\u5206\u3067\u5408\u8A08\u3057\u306A\u3044\n- \u66F8\u304F\u3068\u304D\u306F `fs_write` \u304B `csv_write`\n- \u7D42\u308F\u3063\u305F\u3089 `work_complete` \u306B\u3001\u4F55\u3092\u3057\u305F\u304B\u3068\u3001\u66F8\u3044\u305F\u30D5\u30A1\u30A4\u30EB\u3092\u6E21\u3059\u3002\u7D9A\u3051\u3089\u308C\u306A\u3044\u3068\u304D\u306F `work_fail`\n- `openshain.yaml`\u3001`work/`\u3001`principals/`\u3001`authority/` \u306F Runtime \u306E\u3082\u306E\u3002\u5909\u66F4\u3057\u306A\u3044\n- \u547C\u3073\u51FA\u3057\u306E\u7D50\u679C\u304C `pending` \u306A\u3089\u3001\u4F1A\u793E\u306E\u6A29\u9650\u306E\u898F\u5247\u304C\u305D\u306E\u547C\u3073\u51FA\u3057\u3092\u6B62\u3081\u3066\u3044\u308B\u3002\u627F\u8A8D\u306F\u4F1A\u793E\u306E\u4EBA\u304C openshain \u306E\u753B\u9762\u3067\u6C7A\u3081\u308B\u3002\u81EA\u5206\u3067 `approval_decide` \u3084 `review_decide` \u3092\u547C\u3093\u3067\u901A\u3055\u306A\u3044\u3002\u4EBA\u306B\u4F1D\u3048\u3066\u3001\u6C7A\u307E\u308B\u307E\u3067\u5225\u306E\u4F5C\u696D\u3092\u3059\u308B\n";
 export declare const CLAUDE_TEMPLATE = "@AGENTS.md\n";
 export interface InitOptions {
     workspaceRoot: string;

package/dist/commands/init.js

@@ -20,7 +20,7 @@ profession:
   id: generic
   # model への指示。100,000 文字まで
   instructions: |
-    あなたはこの会社の事務担当です。依頼された作業を、workspace 内のファイルだけを使って進めてください。
+    あなたはこの会社の一般事務の社員エージェントです。依頼された作業を、workspace 内のファイルだけを使って進めてください。
 model:
   provider: anthropic      # anthropic | openai-compatible
   model: claude-opus-5
@@ -52,7 +52,8 @@ export const AGENTS_TEMPLATE = `# この会社フォルダで働くエージェ
 - ファイルは \`fs_list\`、\`fs_search\`、\`fs_read\`、\`csv_read\`、\`markdown_read\` で見る。合計や件数は \`csv_aggregate\` に任せ、自分で合計しない
 - 書くときは \`fs_write\` か \`csv_write\`
 - 終わったら \`work_complete\` に、何をしたかと、書いたファイルを渡す。続けられないときは \`work_fail\`
-- \`openshain.yaml\` と \`work/\` は Runtime のもの。変更しない
+- \`openshain.yaml\`、\`work/\`、\`principals/\`、\`authority/\` は Runtime のもの。変更しない
+- 呼び出しの結果が \`pending\` なら、会社の権限の規則がその呼び出しを止めている。承認は会社の人が openshain の画面で決める。自分で \`approval_decide\` や \`review_decide\` を呼んで通さない。人に伝えて、決まるまで別の作業をする
 `;
 export const CLAUDE_TEMPLATE = "@AGENTS.md\n";
 /**

package/dist/commands/work.js

@@ -1,4 +1,4 @@
-import { parseWorkId, pendingQuestions, WorkStore, } from "@openshain/core";
+import { parseWorkId, pendingApprovals, pendingQuestions, WorkStore, } from "@openshain/core";
 import { describeInput, padDisplay } from "../format.js";
 import { errorLabel, failureLabel, rejectionLabel, statusLabel } from "../labels.js";
 import { nextActor } from "../report.js";
@@ -51,6 +51,12 @@ export function describeWork(work, events) {
         for (const { question } of pendingQuestions(events))
             lines.push(`質問      ${question}`);
     }
+    if (work.status === "waiting_approval") {
+        for (const a of pendingApprovals(events)) {
+            const who = a.kind === "review" ? `${a.reviewer?.role ?? "資格者"}の判断待ち` : "承認待ち";
+            lines.push(`${who}  ${a.call.name} ${describeInput(a.call.input)}  (${a.approvalId})`);
+        }
+    }
     const calls = toolLines(events);
     if (calls.length > 0) {
         lines.push("Tool");

package/dist/labels.js

@@ -24,6 +24,8 @@ export const REJECTION_LABELS = {
     outside_workspace: "workspace の外",
     invalid_path: "不正なパス",
     limit_reached: "Tool 呼び出しの上限",
+    denied: "権限の表で不許可",
+    rejected_by_person: "承認されなかった",
 };
 /** A heading for a runtime error, before the original message. */
 export const ERROR_LABELS = {

package/dist/preview.d.ts

@@ -0,0 +1,13 @@
+export interface PreviewLine {
+    kind: "added" | "removed" | "context" | "note";
+    text: string;
+}
+/**
+ * What a held call would change, for the person about to approve it. A call of a tool that writes
+ * a whole file is shown as a line diff against the file as it is now; anything else is shown as
+ * its input. Reads the file directly: this is the person's own workspace, on their own screen.
+ */
+export declare function previewCall(workspaceRoot: string, call: {
+    name: string;
+    input: unknown;
+}): Promise<PreviewLine[]>;

package/dist/preview.js

@@ -0,0 +1,141 @@
+import { readFile } from "node:fs/promises";
+import { resolveWorkspacePath } from "@openshain/core";
+import { csvText } from "@openshain/tools";
+/** How much of a change the screen shows before it says the rest is cut. */
+const MAX_LINES = 24;
+/** Above this many lines on either side, the diff is replaced by the line counts. */
+const MAX_DIFF_LINES = 400;
+/** A single line longer than this is cut: one line must not fill the screen. */
+const MAX_LINE_CHARS = 300;
+/** The tools whose input the screen can render as the file it would leave behind. */
+const DIFFABLE = new Set(["fs_write", "csv_write"]);
+/**
+ * What a held call would change, for the person about to approve it. A call of a tool that writes
+ * a whole file is shown as a line diff against the file as it is now; anything else is shown as
+ * its input. Reads the file directly: this is the person's own workspace, on their own screen.
+ */
+export async function previewCall(workspaceRoot, call) {
+    if (!DIFFABLE.has(call.name))
+        return [{ kind: "note", text: JSON.stringify(call.input) }];
+    const input = (call.input ?? {});
+    const path = typeof input.path === "string" ? input.path : undefined;
+    const content = typeof input.content === "string"
+        ? input.content
+        : Array.isArray(input.rows)
+            ? csvText(input.rows, Array.isArray(input.columns) ? input.columns : undefined)
+            : undefined;
+    if (path === undefined || content === undefined) {
+        return [{ kind: "note", text: JSON.stringify(call.input) }];
+    }
+    // The same guard the tools run under: a path outside the workspace, a reserved one or a
+    // symlink that leads out is refused here too, so the screen never shows what the call cannot
+    // touch. The model chooses this path; the person is about to read what it says.
+    let resolved;
+    try {
+        resolved = await resolveWorkspacePath(workspaceRoot, path);
+    }
+    catch (err) {
+        return [
+            {
+                kind: "note",
+                text: `${path} は読めません(${err instanceof Error ? err.message : String(err)})。この呼び出しは実行しても拒否されます。`,
+            },
+        ];
+    }
+    const before = await readFile(resolved, "utf8").catch(() => undefined);
+    if (before === undefined) {
+        const lines = content.split("\n");
+        return cap([
+            { kind: "note", text: `${path} を新しく作ります(${lines.length} 行)` },
+            ...lines.map((text) => ({ kind: "added", text })),
+        ]);
+    }
+    const oldLines = before.split("\n");
+    const newLines = content.split("\n");
+    if (oldLines.length > MAX_DIFF_LINES || newLines.length > MAX_DIFF_LINES) {
+        return [
+            {
+                kind: "note",
+                text: `${path} を書き換えます(${oldLines.length} 行 → ${newLines.length} 行。大きいので差分は出しません)`,
+            },
+        ];
+    }
+    const body = diff(oldLines, newLines);
+    return cap([{ kind: "note", text: `${path} を書き換えます` }, ...body]);
+}
+function cap(lines) {
+    const short = lines.map((line) => line.text.length > MAX_LINE_CHARS
+        ? { ...line, text: `${line.text.slice(0, MAX_LINE_CHARS)}…` }
+        : line);
+    if (short.length <= MAX_LINES)
+        return short;
+    const rest = short.length - MAX_LINES;
+    return [...short.slice(0, MAX_LINES), { kind: "note", text: `ほか ${rest} 行` }];
+}
+/**
+ * A line diff by the longest common subsequence, with the unchanged lines around a change kept
+ * as context. Small files only; the caller checks the size first.
+ */
+function diff(before, after) {
+    const table = Array.from({ length: before.length + 1 }, () => new Array(after.length + 1).fill(0));
+    for (let i = before.length - 1; i >= 0; i--) {
+        for (let j = after.length - 1; j >= 0; j--) {
+            const row = table[i];
+            const next = table[i + 1];
+            row[j] =
+                before[i] === after[j]
+                    ? next[j + 1] + 1
+                    : Math.max(next[j], row[j + 1]);
+        }
+    }
+    const all = [];
+    let i = 0;
+    let j = 0;
+    while (i < before.length && j < after.length) {
+        if (before[i] === after[j]) {
+            all.push({ kind: "context", text: before[i] });
+            i++;
+            j++;
+        }
+        else if ((table[i + 1]?.[j] ?? 0) >= (table[i]?.[j + 1] ?? 0)) {
+            all.push({ kind: "removed", text: before[i] });
+            i++;
+        }
+        else {
+            all.push({ kind: "added", text: after[j] });
+            j++;
+        }
+    }
+    for (; i < before.length; i++)
+        all.push({ kind: "removed", text: before[i] });
+    for (; j < after.length; j++)
+        all.push({ kind: "added", text: after[j] });
+    return trimContext(all);
+}
+/** Keeps two unchanged lines on each side of a change and marks what was left out. */
+function trimContext(lines, keep = 2) {
+    const wanted = new Set();
+    lines.forEach((line, index) => {
+        if (line.kind === "context")
+            return;
+        for (let k = index - keep; k <= index + keep; k++)
+            wanted.add(k);
+    });
+    const out = [];
+    let skipped = 0;
+    lines.forEach((line, index) => {
+        if (wanted.has(index)) {
+            if (skipped > 0) {
+                out.push({ kind: "note", text: `… 変わらない ${skipped} 行 …` });
+                skipped = 0;
+            }
+            out.push(line);
+        }
+        else {
+            skipped++;
+        }
+    });
+    if (skipped > 0)
+        out.push({ kind: "note", text: `… 変わらない ${skipped} 行 …` });
+    return out;
+}

package/dist/report.js

@@ -64,7 +64,7 @@ export function nextActor(work) {
         case "waiting_input":
             return `次は利用者の番です。openshain の会話で /work resume ${work.id} を実行し、続きを依頼すると質問に答えられます。`;
         case "waiting_approval":
-            return "次は利用者の番です。承認が要ります。";
+            return "次は利用者の番です。承認が要ります。openshain の会話で /approvals を確かめ、/approve <id> か /reject <id> で決めます。";
         case "failed":
             return "次は利用者の番です。原因を修正して、もう一度依頼してください。";
         default:

package/dist/tui/app.js

@@ -15,7 +15,10 @@ const COLORS = {
 };
 const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 /** Rows that are not history: the header, the input box (three rows) and the status line. */
+/** The rows around the conversation: the header, the input box (3) and the status line. */
 const CHROME_ROWS = 5;
+/** The approval palette is taller: its two lines of heading plus one row per choice. */
+const APPROVAL_EXTRA_ROWS = 2;
 function statusText(state, scrolled) {
     if (scrolled > 0)
         return `↑ ${scrolled} 行上を表示中。End で最新へ、ホイールか PageUp と PageDown で移動`;
@@ -64,9 +67,12 @@ export function App({ controller }) {
         return () => clearInterval(timer);
     }, [state.busy]);
     // One row is left to the terminal: drawing exactly its height makes it scroll on every redraw.
-    const height = Math.max(CHROME_ROWS + 1, size.rows - 1);
+    const chromeRows = (state.approval
+        ? CHROME_ROWS + APPROVAL_EXTRA_ROWS + state.approval.choices.length
+        : CHROME_ROWS) + (state.queued.length > 0 && !state.approval ? 1 : 0);
+    const height = Math.max(chromeRows + 1, size.rows - 1);
     const width = Math.max(20, size.columns);
-    const paneRows = height - CHROME_ROWS;
+    const paneRows = height - chromeRows;
     const lines = useMemo(() => screenLines(state.entries, width).map((line, row) => ({ ...line, row })), [state.entries, width]);
     const maxScroll = Math.max(0, lines.length - paneRows);
     const scrolled = Math.min(scroll, maxScroll);
@@ -93,6 +99,22 @@ export function App({ controller }) {
                 void controller.close();
             return;
         }
+        // While a call waits for approval, the keys pick a choice instead of typing.
+        if (state.approval) {
+            if (key.upArrow)
+                return controller.moveApproval(-1);
+            if (key.downArrow)
+                return controller.moveApproval(1);
+            if (key.return)
+                return controller.decideApproval();
+            if (key.escape)
+                return controller.decideApproval("reject");
+            const index = Number.parseInt(ch, 10) - 1;
+            const chosen = state.approval.choices[index];
+            if (chosen)
+                return controller.decideApproval(chosen.key);
+            return;
+        }
         if (key.pageUp)
             return setScroll((s) => Math.min(maxScroll, s + page));
         if (key.pageDown)
@@ -167,7 +189,9 @@ export function App({ controller }) {
         setInput([...chars.slice(0, at), ch, ...chars.slice(at)].join(""));
         setCursor(at + [...ch].length);
     });
+    const approval = state.approval;
     const asking = state.question !== undefined;
+    const queued = state.queued;
     const chars = [...input];
     const at = Math.min(cursor, chars.length);
     const before = chars.slice(0, at).join("");
@@ -183,9 +207,18 @@ export function App({ controller }) {
                     state.status.model,
                 ].join(" · ") }), _jsx(Box, { flexDirection: "column", height: paneRows, children: visible.map((line) => {
                     const color = COLORS[line.kind];
-                    if (line.segments) {
-                        return (_jsx(Text, { wrap: "truncate", children: line.segments.map((s) => (_jsx(Text, { color: s.color, children: s.text }, s.at))) }, line.row));
+                    if (line.spans) {
+                        // Each piece is named by the column it starts at, which does not move.
+                        let column = 0;
+                        const pieces = line.spans.map((span) => {
+                            const at = column;
+                            column += span.text.length;
+                            return { ...span, at };
+                        });
+                        return (_jsx(Text, { wrap: "truncate", ...(color && { color }), children: pieces.map((s) => (_jsx(Text, { ...(s.color && { color: s.color }), ...(s.bold && { bold: true }), ...(s.italic && { italic: true }), ...(s.dim && { dimColor: true }), ...(s.strikethrough && { strikethrough: true }), children: s.text }, `${line.row}-${s.at}`))) }, line.row));
                     }
                     return (_jsx(Text, { wrap: "truncate", dimColor: line.kind === "banner", ...(color && { color }), children: line.text || " " }, line.row));
-                }) }), _jsxs(Box, { borderStyle: "round", borderColor: asking ? "magenta" : "gray", paddingX: 1, children: [_jsx(Text, { color: asking ? "magenta" : "cyan", children: asking ? "答え> " : "> " }), _jsx(Text, { children: before }), under === "" ? _jsx(Text, { dimColor: true, children: "\u258C" }) : _jsx(Text, { inverse: true, children: under }), _jsx(Text, { children: after })] }), _jsx(Text, { dimColor: true, wrap: "truncate", children: bottom })] }));
+                }) }), approval ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, flexDirection: "column", children: [_jsxs(Text, { color: "yellow", wrap: "truncate", children: ["\u627F\u8A8D\u304C\u8981\u308A\u307E\u3059: ", approval.title] }), _jsxs(Text, { dimColor: true, wrap: "truncate", children: ["\u898F\u5247 ", approval.ruleId] }), approval.choices.map((choice, index) => (_jsxs(Text, { ...(index === approval.at && { color: "yellow" }), wrap: "truncate", children: [index === approval.at ? "❯ " : "  ", index + 1, ". ", choice.label] }, choice.key)))] })) : (_jsxs(Box, { borderStyle: "round", borderColor: asking ? "magenta" : "gray", paddingX: 1, children: [_jsx(Text, { color: asking ? "magenta" : "cyan", children: asking ? "答え> " : "> " }), _jsx(Text, { children: before }), under === "" ? _jsx(Text, { dimColor: true, children: "\u258C" }) : _jsx(Text, { inverse: true, children: under }), _jsx(Text, { children: after })] })), queued.length > 0 && !approval ? (_jsxs(Text, { dimColor: true, wrap: "truncate", children: ["\u9806\u756A\u5F85\u3061 ", queued.length, " \u4EF6: ", queued.join(" / ")] })) : null, _jsx(Text, { dimColor: true, wrap: "truncate", children: approval
+                    ? "↑ ↓ と Enter、または数字で選ぶ。Esc は拒否します。Ctrl-C は保留のまま止めます"
+                    : bottom })] }));
 }

package/dist/tui/banner.d.ts

@@ -1,3 +1,4 @@
+import type { Span } from "./markdown.ts";
 /** The version of the openshain command, from its package.json. */
 export declare const VERSION: string;
 /**
@@ -5,11 +6,5 @@ export declare const VERSION: string;
  * screen needs neither the network nor another dependency to show it.
  */
 export declare const LOGO_ROWS: readonly string[];
-export interface Segment {
-    text: string;
-    color: string;
-    /** Position in the row; the screen keys by it. */
-    at: number;
-}
-/** One colored segment per character, so the gradient runs across the row. */
-export declare function logoSegments(row: string): Segment[];
+/** One colored piece per character, so the gradient runs across the row. */
+export declare function logoSegments(row: string): Span[];

package/dist/tui/banner.js

@@ -15,7 +15,7 @@ const GRADIENT = [
     [78, 168, 255],
     [127, 136, 255],
 ];
-/** One colored segment per character, so the gradient runs across the row. */
+/** One colored piece per character, so the gradient runs across the row. */
 export function logoSegments(row) {
     const chars = [...row];
     const last = Math.max(1, chars.length - 1);
@@ -24,6 +24,6 @@ export function logoSegments(row) {
         const [from, to] = GRADIENT;
         const channel = (k) => Math.round(from[k] + (to[k] - from[k]) * t);
         const hex = [channel(0), channel(1), channel(2)].map((v) => v.toString(16).padStart(2, "0"));
-        return { text, color: `#${hex.join("")}`, at };
+        return { text, color: `#${hex.join("")}` };
     });
 }

package/dist/tui/controller.d.ts

@@ -1,5 +1,7 @@
+import { type ApprovalChoice } from "@openshain/agent";
 import { type RuntimeProviders, type WorkId, WorkStore } from "@openshain/core";
 import { statusLabel } from "../labels.ts";
+import { type PreviewLine } from "../preview.ts";
 /** logo and banner are the rows shown once when the screen opens: the wordmark, the version, the folder. */
 export type EntryKind = "user" | "assistant" | "progress" | "notice" | "question" | "line" | "logo" | "banner";
 export interface Entry {
@@ -16,6 +18,22 @@ export interface ControllerState {
     busy: boolean;
     /** A question a work is asking; the next line the person types answers it. */
     question?: string;
+    /** A call held for approval; the person picks one of its choices before the work goes on. */
+    approval?: {
+        approvalId: string;
+        title: string;
+        ruleId: string;
+        preview: PreviewLine[];
+        choices: {
+            key: ApprovalChoice | "reject_with_reason";
+            label: string;
+        }[];
+        at: number;
+    };
+    /** After "no, and tell the agent why": the next line the person types is that reason. */
+    reason?: string;
+    /** Lines typed while the screen was busy. They are sent in order once it is free. */
+    queued: string[];
     closed: boolean;
     status: {
         company: string;
@@ -41,6 +59,10 @@ export interface Controller {
     submit(line: string): Promise<void>;
     /** Ctrl-C: stops the running work, taking back a question it waits on; false when nothing was running. */
     interrupt(): boolean;
+    /** Moves the highlight in the approval choices. */
+    moveApproval(delta: number): void;
+    /** Answers the approval being shown: the highlighted choice, or the one given. */
+    decideApproval(choice?: ApprovalChoice | "reject_with_reason"): void;
     /** Stops whatever is running, then ends the session. A second call waits for the same close. */
     close(): Promise<void>;
 }