@spinabot/brigade 0.1.1 → 1.0.0

package/dist/ui/searchable-select.js

@@ -0,0 +1,108 @@
+/**
+ * `SearchableSelectList` — a Pi-TUI `SelectList` with a live type-to-filter
+ * search box on top. Drop-in for `SelectList`: same `SelectItem[]` +
+ * `onSelect`/`onCancel` contract, so callers swap one for the other and call
+ * `tui.setFocus(list)` as usual.
+ *
+ * Why not Pi's built-in `SelectList.setFilter`? It prefix-matches on the
+ * item's `value` only (`value.startsWith(query)`), so typing "opus" would NOT
+ * match "claude-opus-4-7", and it doesn't filter as you type. This wraps
+ * `SelectList` and drives Pi's own `fuzzyFilter` (all query tokens must appear
+ * in order across label+value+description) — so "opus" finds the Claude Opus
+ * row and "gpt mini" finds gpt-*-mini. Essential once a provider (OpenRouter)
+ * exposes 270+ models.
+ *
+ * Keys: ↑/↓ + Enter delegate to the inner SelectList; Esc/Ctrl+C cancels;
+ * Backspace edits the query; any printable character appends to the query and
+ * re-filters. The TUI re-renders after each `handleInput`, so mutating state
+ * here is enough (no explicit requestRender needed — same as SelectList).
+ */
+import { decodeKittyPrintable, fuzzyFilter, getKeybindings, Key, matchesKey, SelectList, } from "@mariozechner/pi-tui";
+export class SearchableSelectList {
+    allItems;
+    maxVisible;
+    theme;
+    options;
+    query = "";
+    inner;
+    /** Number of items currently matching the query (live; = total when empty). */
+    matchCount;
+    onSelect;
+    onCancel;
+    constructor(allItems, maxVisible, theme, options = {}) {
+        this.allItems = allItems;
+        this.maxVisible = maxVisible;
+        this.theme = theme;
+        this.options = options;
+        this.inner = this.buildInner(allItems);
+        this.matchCount = allItems.length;
+    }
+    buildInner(items) {
+        const visible = Math.min(Math.max(items.length, 1), this.maxVisible);
+        const list = new SelectList(items, visible, this.theme, this.options);
+        // Forward selection/cancel through this wrapper so callers wire onSelect
+        // on the SearchableSelectList, not the (recreated) inner list.
+        list.onSelect = (item) => this.onSelect?.(item);
+        list.onCancel = () => this.onCancel?.();
+        return list;
+    }
+    applyFilter() {
+        const q = this.query.trim();
+        const filtered = q
+            ? fuzzyFilter(this.allItems, q, (it) => `${it.label} ${it.value} ${it.description ?? ""}`)
+            : this.allItems;
+        this.matchCount = filtered.length;
+        // Rebuild the inner list so navigation + scroll operate on the filtered
+        // set and the selection resets to the top match.
+        this.inner = this.buildInner(filtered);
+    }
+    render(width) {
+        const total = this.allItems.length;
+        const header = this.options.formatHeader
+            ? this.options.formatHeader(this.query, this.matchCount, total)
+            : this.query
+                ? `  search: ${this.query}  (${this.matchCount}/${total})`
+                : `  ${total} items · type to filter · ↑↓ move · Enter select · Esc back`;
+        return [header, ...this.inner.render(width)];
+    }
+    handleInput(keyData) {
+        const kb = getKeybindings();
+        // Navigation + confirm → the inner list owns these.
+        if (kb.matches(keyData, "tui.select.up") ||
+            kb.matches(keyData, "tui.select.down") ||
+            kb.matches(keyData, "tui.select.confirm")) {
+            this.inner.handleInput(keyData);
+            return;
+        }
+        // Esc / Ctrl+C → cancel.
+        if (kb.matches(keyData, "tui.select.cancel")) {
+            this.onCancel?.();
+            return;
+        }
+        // Backspace → trim the query (matchesKey covers raw + kitty encodings).
+        if (matchesKey(keyData, Key.backspace) || keyData === "\x7f" || keyData === "\b") {
+            if (this.query.length > 0) {
+                this.query = this.query.slice(0, -1);
+                this.applyFilter();
+            }
+            return;
+        }
+        // Printable character → append to the query + re-filter. Handle the
+        // kitty-keyboard encoding first, then fall back to a plain ASCII byte.
+        const ch = decodeKittyPrintable(keyData) ??
+            (keyData.length === 1 && keyData.charCodeAt(0) >= 0x20 && keyData.charCodeAt(0) !== 0x7f
+                ? keyData
+                : undefined);
+        if (ch && ch.length === 1) {
+            this.query += ch;
+            this.applyFilter();
+        }
+    }
+    invalidate() {
+        this.inner.invalidate?.();
+    }
+    getSelectedItem() {
+        return this.inner.getSelectedItem();
+    }
+}
+//# sourceMappingURL=searchable-select.js.map

package/dist/ui/searchable-select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchable-select.js","sourceRoot":"","sources":["../../src/ui/searchable-select.ts"],"names":[],"mappings":"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"}

package/dist/ui/syntax-theme.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Syntax-highlight theme for fenced code blocks in the TUI.
+ *
+ * Wired through `cli-highlight` (a wrapper around highlight.js) — Brigade's
+ * `markdownTheme.highlightCode` hook hands the fenced source + language tag
+ * to `highlight()`, gets back ANSI-coloured output, and Pi-TUI's Markdown
+ * renderer applies the block-level styling (border, indent) around it.
+ *
+ * Token palette tuned for an amber-on-dark Brigade brand: same VS Code-ish
+ * hues common to most syntax themes (purple keywords, teal built-ins,
+ * orange strings, green comments) so the agent's output looks like
+ * something you'd see in a normal editor while still feeling Brigade-y.
+ *
+ * Fallback colour = the brand's `code` orange. Pi-TUI's `markdownTheme.code`
+ * already uses this; the syntax theme defaults to it so a `cli-highlight`
+ * library miss (illegal syntax / unknown language) still renders in a
+ * cohesive palette instead of stark white.
+ */
+import type { Theme } from "cli-highlight";
+/**
+ * Token → ANSI styler map consumed by `cli-highlight`. Highlight.js
+ * emits class names like `keyword`, `string`, `function` for each parsed
+ * span; we map each to a `chalk.hex(...)` formatter that wraps the text
+ * in the right SGR sequence.
+ *
+ * The token list mirrors highlight.js's CSS class names — additions or
+ * tweaks just add a key here without touching any plumbing.
+ */
+export declare const syntaxTheme: Theme;
+//# sourceMappingURL=syntax-theme.d.ts.map

package/dist/ui/syntax-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-theme.d.ts","sourceRoot":"","sources":["../../src/ui/syntax-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAI3C;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,KAyCzB,CAAC"}

package/dist/ui/syntax-theme.js

@@ -0,0 +1,72 @@
+/**
+ * Syntax-highlight theme for fenced code blocks in the TUI.
+ *
+ * Wired through `cli-highlight` (a wrapper around highlight.js) — Brigade's
+ * `markdownTheme.highlightCode` hook hands the fenced source + language tag
+ * to `highlight()`, gets back ANSI-coloured output, and Pi-TUI's Markdown
+ * renderer applies the block-level styling (border, indent) around it.
+ *
+ * Token palette tuned for an amber-on-dark Brigade brand: same VS Code-ish
+ * hues common to most syntax themes (purple keywords, teal built-ins,
+ * orange strings, green comments) so the agent's output looks like
+ * something you'd see in a normal editor while still feeling Brigade-y.
+ *
+ * Fallback colour = the brand's `code` orange. Pi-TUI's `markdownTheme.code`
+ * already uses this; the syntax theme defaults to it so a `cli-highlight`
+ * library miss (illegal syntax / unknown language) still renders in a
+ * cohesive palette instead of stark white.
+ */
+import chalk from "chalk";
+const BRAND_CODE_ORANGE = "#F0C987";
+/**
+ * Token → ANSI styler map consumed by `cli-highlight`. Highlight.js
+ * emits class names like `keyword`, `string`, `function` for each parsed
+ * span; we map each to a `chalk.hex(...)` formatter that wraps the text
+ * in the right SGR sequence.
+ *
+ * The token list mirrors highlight.js's CSS class names — additions or
+ * tweaks just add a key here without touching any plumbing.
+ */
+export const syntaxTheme = {
+    keyword: chalk.hex("#C586C0"),
+    "selector-tag": chalk.hex("#C586C0"),
+    literal: chalk.hex("#569CD6"),
+    doctag: chalk.hex("#569CD6"),
+    title: chalk.bold.hex("#DCDCAA"),
+    section: chalk.bold.hex("#4EC9B0"),
+    type: chalk.hex("#4EC9B0"),
+    class: chalk.hex("#4EC9B0"),
+    function: chalk.hex("#DCDCAA"),
+    built_in: chalk.hex("#4EC9B0"),
+    "builtin-name": chalk.hex("#4EC9B0"),
+    number: chalk.hex("#B5CEA8"),
+    string: chalk.hex("#CE9178"),
+    regexp: chalk.hex("#D16969"),
+    tag: chalk.hex("#569CD6"),
+    "selector-id": chalk.hex("#D7BA7D"),
+    "selector-class": chalk.hex("#D7BA7D"),
+    "selector-attr": chalk.hex("#D7BA7D"),
+    "selector-pseudo": chalk.hex("#D7BA7D"),
+    attr: chalk.hex("#9CDCFE"),
+    attribute: chalk.hex("#9CDCFE"),
+    name: chalk.hex("#9CDCFE"),
+    variable: chalk.hex("#9CDCFE"),
+    "template-variable": chalk.hex("#9CDCFE"),
+    "template-tag": chalk.hex("#569CD6"),
+    params: chalk.hex("#9CDCFE"),
+    symbol: chalk.hex("#9CDCFE"),
+    subst: chalk.hex("#9CDCFE"),
+    "meta-string": chalk.hex("#CE9178"),
+    meta: chalk.hex("#9B9B9B"),
+    "meta-keyword": chalk.hex("#C586C0"),
+    comment: chalk.italic.hex("#6A9955"),
+    quote: chalk.italic.hex("#6A9955"),
+    deletion: chalk.bgHex("#3F1F1F").hex("#F97066"),
+    addition: chalk.bgHex("#1F2D23").hex("#7DD3A5"),
+    emphasis: chalk.italic,
+    strong: chalk.bold,
+    bullet: chalk.hex("#FBBF24"),
+    link: chalk.hex("#60A5FA"),
+    default: chalk.hex(BRAND_CODE_ORANGE),
+};
+//# sourceMappingURL=syntax-theme.js.map

package/dist/ui/syntax-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-theme.js","sourceRoot":"","sources":["../../src/ui/syntax-theme.ts"],"names":[],"mappings":"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"}

package/dist/ui/terminal-cleanup.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Centralized terminal-state restoration on TUI exit.
+ *
+ * After a Brigade TUI session ends (clean exit, Ctrl+C, crash, signal,
+ * `process.exit`, anything), the user's shell prompt must look like Brigade
+ * was never there. The kitty keyboard protocol in particular is sticky: if
+ * the push (CSI > 1 u) isn't matched by a pop (CSI < u) on the way out,
+ * terminals that support it (Kitty, Ghostty, WezTerm, recent Windows
+ * Terminal) keep emitting key release events into the next program — which
+ * the shell then renders as visible garbage like `[57361;1:3u`.
+ *
+ * Why we don't rely solely on Pi-TUI's ProcessTerminal.stop():
+ *   1. Its kitty pop is gated on a `_kittyProtocolActive` flag that gets
+ *      set lazily after the terminal answers the capability query. If the
+ *      user exits between query-write and response-read, the push happens
+ *      anyway (or rather: kitty mode is left in whatever state the terminal
+ *      already held) and the pop is skipped.
+ *   2. It only runs on graceful `tui.stop()` paths. A crash that bypasses
+ *      `tui.stop()` leaves the terminal in raw + kitty + bracketed-paste
+ *      mode forever.
+ *   3. It never emits the broader safety net (focus reporting, mouse
+ *      tracking, synchronized output, alt-screen) which other libraries
+ *      sometimes leave on.
+ *
+ * `restoreTerminal()` is idempotent — every escape sequence here is a
+ * "disable" or "show", and terminals tolerate disable-when-disabled. Safe
+ * to wire into multiple exit paths and to call repeatedly.
+ *
+ * IMPORTANT: writes go to stderr, never stdout. stderr is the conventional
+ * channel for terminal control and is unbuffered + always-on; stdout might
+ * be redirected to a file or pipe, in which case writing escape sequences
+ * there would corrupt the captured output.
+ */
+export declare function markTuiActive(): void;
+/**
+ * Emit every escape sequence needed to restore the terminal to a known-good
+ * state. Called from every Brigade exit path (signal handlers, normal exit,
+ * crash, `process.on("exit")`).
+ *
+ * No-op when no TUI command marked itself active — a one-shot CLI command
+ * exiting has nothing to clean up, and emitting "disable" escapes pollutes
+ * the operator's terminal scrollback.
+ */
+export declare function restoreTerminal(): void;
+export declare function installTerminalCleanupHandler(): void;
+//# sourceMappingURL=terminal-cleanup.d.ts.map

package/dist/ui/terminal-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-cleanup.d.ts","sourceRoot":"","sources":["../../src/ui/terminal-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAYH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,IAAI,CA0CtC;AAYD,wBAAgB,6BAA6B,IAAI,IAAI,CAmCpD"}

package/dist/ui/terminal-cleanup.js

@@ -32,12 +32,29 @@
  * there would corrupt the captured output.
  */
 import process from "node:process";
+/**
+ * Active only after a TUI command (chat/connect/onboard) explicitly enters
+ * raw/alt-screen/kitty/etc. mode. Non-TUI subcommands (`channels list`,
+ * `pairing approve`, …) never set this, so their exit doesn't emit cleanup
+ * escapes — which would otherwise render as visible garbage on terminals
+ * (notably older PowerShell hosts) that don't parse the full set.
+ */
+let tuiActive = false;
+export function markTuiActive() {
+    tuiActive = true;
+}
 /**
  * Emit every escape sequence needed to restore the terminal to a known-good
  * state. Called from every Brigade exit path (signal handlers, normal exit,
  * crash, `process.on("exit")`).
+ *
+ * No-op when no TUI command marked itself active — a one-shot CLI command
+ * exiting has nothing to clean up, and emitting "disable" escapes pollutes
+ * the operator's terminal scrollback.
  */
 export function restoreTerminal() {
+    if (!tuiActive)
+        return;
     const out = process.stderr;
     try {
         out.write(
@@ -116,11 +133,6 @@ export function installTerminalCleanupHandler() {
         // (where restoreTerminal will run again, harmlessly, via idempotency).
         process.exit(code);
     };
-    // Use addListener (not once) so we don't disarm if any subcommand-specific
-    // handler also fires — but DON'T register if a listener with the same
-    // effective intent already exists (chat-cmd / connect-cmd install their own
-    // SIGINT handlers that call tui.stop() first; ours runs alongside).
-    //
     // We only register SIGTERM and SIGHUP here. SIGINT is owned by the
     // per-subcommand handler (which has UI state to tear down — abort an
     // in-flight turn first, etc.); that handler calls `restoreTerminal()`

package/dist/ui/terminal-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-cleanup.js","sourceRoot":"","sources":["../../src/ui/terminal-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;;;;;GAMG;AACH,IAAI,SAAS,GAAG,KAAK,CAAC;AACtB,MAAM,UAAU,aAAa;IAC3B,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC;QACH,GAAG,CAAC,KAAK;QACP,mEAAmE;QACnE,oEAAoE;QACpE,8BAA8B;QAC9B,SAAS;YACP,4DAA4D;YAC5D,4DAA4D;YAC5D,uDAAuD;YACvD,UAAU;YACV,6DAA6D;YAC7D,gDAAgD;YAChD,YAAY;YACZ,iEAAiE;YACjE,aAAa;YACb,4DAA4D;YAC5D,WAAW;YACX,4DAA4D;YAC5D,sCAAsC;YACtC,aAAa;YACb,8BAA8B;YAC9B,aAAa;YACb,+DAA+D;YAC/D,8CAA8C;YAC9C,0DAA0D;YAC1D,UAAU;YACV,4DAA4D;YAC5D,8CAA8C;YAC9C,SAAS;YACT,iEAAiE;YACjE,6DAA6D;YAC7D,4DAA4D;YAC5D,6DAA6D;YAC7D,iEAAiE;YACjE,aAAa,CAChB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,IAAI,oBAAoB,GAAG,KAAK,CAAC;AACjC,MAAM,UAAU,6BAA6B;IAC3C,IAAI,oBAAoB;QAAE,OAAO;IACjC,oBAAoB,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEpC,8EAA8E;IAC9E,wEAAwE;IACxE,yEAAyE;IACzE,yEAAyE;IACzE,4CAA4C;IAC5C,MAAM,aAAa,GAAG,CAAC,GAAmB,EAAE,EAAE;QAC5C,eAAe,EAAE,CAAC;QAClB,2EAA2E;QAC3E,4DAA4D;QAC5D,MAAM,IAAI,GACR,GAAG,KAAK,QAAQ;YACd,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,GAAG,KAAK,SAAS;gBACjB,CAAC,CAAC,GAAG;gBACL,CAAC,CAAC,GAAG,KAAK,QAAQ;oBAChB,CAAC,CAAC,GAAG;oBACL,CAAC,CAAC,GAAG,KAAK,SAAS;wBACjB,CAAC,CAAC,GAAG;wBACL,CAAC,CAAC,CAAC,CAAC;QACd,sEAAsE;QACtE,uEAAuE;QACvE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC;IACF,mEAAmE;IACnE,qEAAqE;IACrE,sEAAsE;IACtE,wEAAwE;IACxE,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AACtC,CAAC"}

package/dist/ui/theme.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared Pi-TUI themes for Brigade.
+ *
+ * One canonical place so onboarding + chat feel like the same app.
+ */
+import type { EditorTheme, MarkdownTheme, SelectListTheme } from "@mariozechner/pi-tui";
+export declare const markdownTheme: MarkdownTheme;
+export declare const editorTheme: EditorTheme;
+export declare const selectListTheme: SelectListTheme;
+/** Brand color helpers (used for status bars, dividers, accents). */
+export declare const brand: {
+    amber: (s: string) => string;
+    amberDeep: (s: string) => string;
+    dim: (s: string) => string;
+    white: (s: string) => string;
+    user: (s: string) => string;
+    agent: (s: string) => string;
+    tool: (s: string) => string;
+    error: (s: string) => string;
+};
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiExF,eAAO,MAAM,aAAa,EAAE,aAgB3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WASzB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAM7B,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,KAAK;eACL,MAAM;mBACF,MAAM;aACZ,MAAM;eACJ,MAAM;cACP,MAAM;eACL,MAAM;cACP,MAAM;eACL,MAAM;CAClB,CAAC"}

package/dist/ui/theme.js

@@ -4,14 +4,77 @@
  * One canonical place so onboarding + chat feel like the same app.
  */
 import chalk from "chalk";
+import { highlight, supportsLanguage } from "cli-highlight";
+import { syntaxTheme } from "./syntax-theme.js";
+const CODE_FALLBACK = "#fde7c4";
+/**
+ * Detect compact JSON the model emitted on a single line and reformat
+ * with 2-space indentation. Only fires when the lang tag is `json` AND
+ * the body parses cleanly; everything else is passed through untouched.
+ *
+ * Why: gpt-class models often emit `{"a":1,"b":2}` even when the user
+ * asked "show me a JSON object" — the structure is correct but reads
+ * worse than multi-line in a chat UI. We catch the compact form at
+ * render time so the rest of the pipeline stays unchanged.
+ */
+function maybePrettyPrintJson(code, lang) {
+    if (lang !== "json" && lang !== "jsonc")
+        return code;
+    const trimmed = code.trim();
+    if (trimmed.length === 0)
+        return code;
+    // Cheap shape check before paying for JSON.parse: must look like an
+    // object or array. Avoids spurious parsing on bash output that
+    // happens to have braces.
+    const first = trimmed[0];
+    if (first !== "{" && first !== "[")
+        return code;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return JSON.stringify(parsed, null, 2);
+    }
+    catch {
+        return code;
+    }
+}
+/**
+ * Plug into Pi-TUI's `MarkdownTheme.highlightCode` slot. Pi-TUI calls
+ * this for every fenced code block (` ```bash `, ` ```json `, etc.) and
+ * applies the result line-by-line through `markdownTheme.codeBlock`.
+ * Returning ANSI-coloured lines gives us syntax-highlighted blocks for
+ * free without touching the markdown parser.
+ *
+ * Behaviour:
+ *   - Known language → highlight with that grammar (e.g. `bash`, `json`).
+ *   - JSON → pretty-printed across multiple lines before highlighting.
+ *   - Unknown / missing tag → fall back to highlight.js auto-detect.
+ *   - Auto-detect throws (illegal syntax / weird input) → return plain
+ *     lines styled with the code-fallback colour so the block still looks
+ *     like code, just unstyled.
+ */
+function highlightCode(code, lang) {
+    const formatted = maybePrettyPrintJson(code, lang);
+    try {
+        const language = lang && supportsLanguage(lang) ? lang : undefined;
+        const out = highlight(formatted, {
+            language,
+            theme: syntaxTheme,
+            ignoreIllegals: true,
+        });
+        return out.split("\n");
+    }
+    catch {
+        return formatted.split("\n").map((line) => chalk.hex(CODE_FALLBACK)(line));
+    }
+}
 export const markdownTheme = {
     heading: (s) => chalk.bold.hex("#fbbf24")(s), // amber
     link: (s) => chalk.hex("#60a5fa")(s),
     linkUrl: (s) => chalk.dim(s),
-    code: (s) => chalk.hex("#fde7c4")(s),
+    code: (s) => chalk.hex(CODE_FALLBACK)(s),
     codeBlock: (s) => chalk.hex("#a7f3d0")(s),
     codeBlockBorder: (s) => chalk.dim.hex("#92400e")(s),
-    quote: (s) => chalk.italic.hex("#fde7c4")(s),
+    quote: (s) => chalk.italic.hex(CODE_FALLBACK)(s),
     quoteBorder: (s) => chalk.dim.hex("#92400e")(s),
     hr: (s) => chalk.dim(s),
     listBullet: (s) => chalk.hex("#fbbf24")(s),
@@ -19,6 +82,7 @@ export const markdownTheme = {
     italic: (s) => chalk.italic(s),
     strikethrough: (s) => chalk.strikethrough(s),
     underline: (s) => chalk.underline(s),
+    highlightCode,
 };
 export const editorTheme = {
     borderColor: (s) => chalk.dim(s),

package/dist/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"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"}

package/dist/ui/tool-result.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Summarize a Pi tool-execution result into a short single-line preview for
+ * the chat / connect TUIs.
+ *
+ * Pi's `ToolExecutionEndEvent` carries `result: any` — the shape varies by
+ * tool (string for `bash`, object for `read`/`grep`, array of blocks for
+ * MCP-style tools). We don't want to dump JSON into the chat; we want
+ * something legible after the `✓ tool_name` line.
+ *
+ * Two render modes:
+ *   - SUCCESS — collapse to a 120-char one-line preview ("✓ bash · 7
+ *     packages installed"). Tool output is usually long and bulky; the
+ *     model already sees the full result, the operator just needs the
+ *     gist.
+ *   - ERROR (`{ isError: true }` from Pi, or `opts.preserveNewlines`) —
+ *     keep newlines + raise the cap to ~800 chars. Refusals from the
+ *     exec-gate / exec-approvals refusals carry multi-line instructions
+ *     ("blocked: command 'ls' is not on the allowlist. Operator must
+ *     run\n  brigade exec allow ...\n…"). A 120-char single-line preview
+ *     would chop the magic `brigade exec allow` incantation in half and
+ *     leave the operator guessing. The model already self-corrects from
+ *     the FULL reason (Pi pipes that into the synthetic tool_result it
+ *     sees), so the operator deserves the same fidelity.
+ *
+ * Renders tool results using Pi-TUI's MarkdownComponent.append for
+ * streamed output. Brigade's shorter format trades depth for compactness
+ * — a one-line preview keeps the chat scannable, but ERROR results break
+ * that rule because their call-to-action lives in the body.
+ */
+export interface ToolResultSummary {
+    /** Preview text. For errors, may contain newlines; for success, single line. */
+    preview: string;
+    /** Whether the result was non-empty (false → caller may hide entirely) */
+    hasContent: boolean;
+    /** True when the preview is multi-line (caller should render with line breaks). */
+    multiline: boolean;
+}
+export interface SummarizeOpts {
+    maxLength?: number;
+    /**
+     * When true, preserve newlines + use the error budget. Set by the TUI
+     * for `isError` tool results. Defaults to false (success render).
+     */
+    preserveNewlines?: boolean;
+}
+export declare function summarizeToolResult(result: unknown, opts?: SummarizeOpts): ToolResultSummary;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/ui/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../src/ui/tool-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,iBAAiB;IACjC,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;IACpB,mFAAmF;IACnF,SAAS,EAAE,OAAO,CAAC;CACnB;AAKD,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,OAAO,EACf,IAAI,GAAE,aAAkB,GACtB,iBAAiB,CAoFnB"}

package/dist/ui/tool-result.js

@@ -0,0 +1,100 @@
+const DEFAULT_MAX_LENGTH = 120;
+const ERROR_MAX_LENGTH = 800;
+export function summarizeToolResult(result, opts = {}) {
+    const isError = opts.preserveNewlines === true;
+    const maxLength = opts.maxLength ?? (isError ? ERROR_MAX_LENGTH : DEFAULT_MAX_LENGTH);
+    if (result == null)
+        return { preview: "", hasContent: false, multiline: false };
+    let text;
+    if (typeof result === "string") {
+        text = result;
+    }
+    else if (Array.isArray(result)) {
+        // MCP-style: array of `{ type: "text", text: string }` blocks. Join them.
+        const pieces = [];
+        for (const block of result) {
+            if (block && typeof block === "object") {
+                const b = block;
+                if (typeof b.text === "string")
+                    pieces.push(b.text);
+                else if (typeof b.content === "string")
+                    pieces.push(b.content);
+            }
+            else if (typeof block === "string") {
+                pieces.push(block);
+            }
+        }
+        text = pieces.join("\n");
+    }
+    else if (typeof result === "object") {
+        // Pi's `AgentToolResult` shape — `content: (TextContent | ImageContent)[]` —
+        // is the canonical envelope every Brigade-native tool returns. We have to
+        // peel it FIRST: a previous version of this code only handled `content`
+        // as a plain string, so the array shape fell through to `JSON.stringify`
+        // and the operator saw `{"content":[{"type":"text","text":"..."}]}`
+        // dumped verbatim in the TUI tool-result preview. Iterate the array,
+        // keep only the `type === "text"` blocks, concatenate their `text`.
+        const r = result;
+        if (Array.isArray(r.content)) {
+            const pieces = [];
+            for (const block of r.content) {
+                if (block && typeof block === "object") {
+                    const b = block;
+                    if (b.type === "text" && typeof b.text === "string")
+                        pieces.push(b.text);
+                    else if (b.type === "image" && typeof b.mimeType === "string") {
+                        pieces.push(`[image ${b.mimeType}]`);
+                    }
+                }
+                else if (typeof block === "string") {
+                    pieces.push(block);
+                }
+            }
+            text = pieces.join("\n");
+        }
+        else if (typeof r.content === "string")
+            text = r.content;
+        else if (typeof r.output === "string")
+            text = r.output;
+        else if (typeof r.text === "string")
+            text = r.text;
+        else if (typeof r.message === "string")
+            text = r.message;
+        else {
+            try {
+                text = JSON.stringify(result);
+            }
+            catch {
+                text = String(result);
+            }
+        }
+    }
+    else {
+        text = String(result);
+    }
+    if (isError) {
+        // Trim leading/trailing whitespace but preserve internal newlines
+        // + indentation so the "brigade exec allow ..." line stays
+        // visually aligned in the rendered block.
+        const trimmed = text.replace(/^\s+|\s+$/g, "");
+        if (!trimmed)
+            return { preview: "", hasContent: false, multiline: false };
+        const sliced = trimmed.length <= maxLength ? trimmed : `${trimmed.slice(0, maxLength - 1)}…`;
+        return {
+            preview: sliced,
+            hasContent: true,
+            multiline: sliced.includes("\n"),
+        };
+    }
+    // Success path: collapse whitespace so a multi-line bash output renders
+    // on one line. Tabs → space, CR/LF → space, runs of whitespace → single
+    // space. Same shape as before.
+    const collapsed = text.replace(/\s+/g, " ").trim();
+    if (!collapsed)
+        return { preview: "", hasContent: false, multiline: false };
+    if (collapsed.length <= maxLength) {
+        return { preview: collapsed, hasContent: true, multiline: false };
+    }
+    return { preview: `${collapsed.slice(0, maxLength - 1)}…`, hasContent: true, multiline: false };
+}
+//# sourceMappingURL=tool-result.js.map

package/dist/ui/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../src/ui/tool-result.ts"],"names":[],"mappings":"AAsCA,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAW7B,MAAM,UAAU,mBAAmB,CAClC,MAAe,EACf,OAAsB,EAAE;IAExB,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAEtF,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAEhF,IAAI,IAAY,CAAC;IACjB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,IAAI,GAAG,MAAM,CAAC;IACf,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,0EAA0E;QAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACxC,MAAM,CAAC,GAAG,KAAgC,CAAC;gBAC3C,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBAC/C,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;oBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAChE,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACF,CAAC;QACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvC,6EAA6E;QAC7E,0EAA0E;QAC1E,wEAAwE;QACxE,yEAAyE;QACzE,oEAAoE;QACpE,qEAAqE;QACrE,oEAAoE;QACpE,MAAM,CAAC,GAAG,MAAiC,CAAC;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACxC,MAAM,CAAC,GAAG,KAAgC,CAAC;oBAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;wBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;yBACpE,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;wBAC/D,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;oBACtC,CAAC;gBACF,CAAC;qBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpB,CAAC;YACF,CAAC;YACD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC;aACtD,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;YAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;aAClD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;aAC9C,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC;aACpD,CAAC;YACL,IAAI,CAAC;gBACJ,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACR,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACF,CAAC;IACF,CAAC;SAAM,CAAC;QACP,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACb,kEAAkE;QAClE,2DAA2D;QAC3D,0CAA0C;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC;QAC7F,OAAO;YACN,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;SAChC,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,+BAA+B;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAE5E,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACjG,CAAC"}