@spinabot/brigade 0.1.1 → 1.0.0

package/dist/ui/brand-frames-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-frames-cli.js","sourceRoot":"","sources":["../../src/ui/brand-frames-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAW,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,UAAU,GAAW,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAW,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAW,GAAG,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAuD,IAAI,CAAC,KAAK,CAAC,mpz/DAAmpz/D,CAAC,CAAC"}

package/dist/ui/brand.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Brigade brand mark — animated coloured ASCII video clip beside a chunky wordmark.
+ *
+ * Layout (top to bottom):
+ *
+ *     [pad]
+ *     [ASCII video LEFT (56×30)]   GAP   [BRIGADE wordmark RIGHT (12 rows)]
+ *     [tagline below the whole thing — cornsilk fullwidth]
+ *     [pad]
+ *
+ * The video is a 56-col × 30-row × 89-frame char-based ASCII clip baked at
+ * module-build time (see scripts/gen-brand-frames-cli.mjs and brand-frames-cli.ts).
+ * Each cell carries a unicode codepoint and an RGB colour; we paint cells with
+ * `chalk.hex(toHex(r,g,b))(char)`, plus a skip-on-space-and-black optimisation
+ * that emits a literal space (no chalk wrapper) for empty/black cells so the
+ * pre-rendered string size stays sane while remaining visually identical.
+ * 89 frames at 15 fps play once, then the last frame holds.
+ *
+ * Wordmark colours are unchanged from the prior pure-text mark: a 4-stop
+ * vertical metallic gradient (cornsilk → gold → amber → bronze) so the
+ * lettering still reads as polished metal.
+ */
+import { type Component, type TUI } from "@mariozechner/pi-tui";
+export declare const SIDE_BY_SIDE_THRESHOLD = 210;
+export declare const WORDMARK_MIN_WIDTH = 125;
+export declare const ASCII_MIN_WIDTH = 56;
+/**
+ * Render the wordmark + video clip + tagline. By default spawns a setInterval
+ * that drives the animation; the frame index wraps via modulo so the clip
+ * loops continuously for the rest of the session. Pass `{ animate: false }` to
+ * render a single still frame (the last frame, which is the intended "hold"
+ * state) and skip the interval entirely — used by the chat surface where the
+ * looping clip would compete with the conversation for attention.
+ *
+ * Returns the components added to the TUI (caller can use these to remove or
+ * inspect them).
+ */
+export declare function renderBrandHeader(tui: TUI, opts?: {
+    animate?: boolean;
+}): Component[];
+//# sourceMappingURL=brand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/ui/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,GAAG,EAAQ,MAAM,sBAAsB,CAAC;AAoHtE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAG1C,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAGtC,eAAO,MAAM,eAAe,KAAK,CAAC;AAwLlC;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,EAAE,CA0HzF"}

package/dist/ui/brand.js

@@ -111,7 +111,7 @@ function toFullwidth(s) {
     }
     return out;
 }
-const TAGLINE = chalk.hex(BRIGADE_HIGHLIGHT)(toFullwidth("your personal AI crew  ·  by spinabot"));
+const TAGLINE = chalk.hex(BRIGADE_HIGHLIGHT)(toFullwidth("🦁  your personal AI crew  ·  by spinabot"));
 // Three spaces between the video block and the wordmark. The video is now
 // 56 cells wide (the char-based render) and the wordmark is ~146 cells once
 // pixel-doubled, so the whole composite is ~205 cols wide and requires a
@@ -202,7 +202,7 @@ const PRE_RENDERED_FRAMES = VIDEO_FRAMES.map(({ chars, rgb }) => {
 // the ASCII video doesn't shift right on the tagline row.
 function visibleWidth(s) {
     // Strip ANSI escapes first.
-    const stripped = s.replace(/\[[0-9;]*m/g, "");
+    const stripped = s.replace(/\x1b\[[0-9;]*m/g, "");
     // Count visual cells: fullwidth / wide characters take 2 cells, the rest 1.
     // We approximate "wide" via the common East Asian Width / Halfwidth-Fullwidth
     // ranges that toFullwidth produces, plus CJK ideographs and the
@@ -221,7 +221,9 @@ function visibleWidth(s) {
             (cp >= 0x3400 && cp <= 0x4dbf) || // CJK Ext A
             (cp >= 0x4e00 && cp <= 0x9fff) || // CJK Unified
             (cp >= 0xa000 && cp <= 0xa4cf) || // Yi
-            (cp >= 0xac00 && cp <= 0xd7a3); // Hangul Syllables
+            (cp >= 0xac00 && cp <= 0xd7a3) || // Hangul Syllables
+            (cp >= 0x1f300 && cp <= 0x1faff) || // emoji (incl. the 🦁 mascot)
+            (cp >= 0x2600 && cp <= 0x27bf); // misc symbols / dingbats
         cells += wide ? 2 : 1;
     }
     return cells;
@@ -302,6 +304,15 @@ function composeFrame(frameIdx, termCols) {
     }
     return lines.join("\n");
 }
+// Only ONE brand header is ever on screen at a time — each renderScreen()
+// rebuilds the whole screen. Track the live header's timer + resize listener at
+// module scope so a re-render tears down the PRIOR one. Without this, onboarding
+// (which calls renderBrandHeader once per step) accumulates an animation
+// interval AND a process.stdout "resize" listener on every step → a
+// MaxListenersExceededWarning plus several independent animation loops fighting
+// over the brand row.
+let liveHeaderTimer;
+let liveHeaderOnResize;
 /**
  * Render the wordmark + video clip + tagline. By default spawns a setInterval
  * that drives the animation; the frame index wraps via modulo so the clip
@@ -316,14 +327,23 @@ function composeFrame(frameIdx, termCols) {
 export function renderBrandHeader(tui, opts = {}) {
     const animate = opts.animate ?? true;
     const components = [];
+    // Tear down the previous header's timer + resize listener before installing
+    // this one, so repeated renders can't accumulate either.
+    if (liveHeaderTimer) {
+        clearInterval(liveHeaderTimer);
+        liveHeaderTimer = undefined;
+    }
+    if (liveHeaderOnResize) {
+        process.stdout.removeListener("resize", liveHeaderOnResize);
+        liveHeaderOnResize = undefined;
+    }
     // Pi-TUI's TUI exposes the underlying Terminal which has a `columns` getter
     // (see node_modules/@mariozechner/pi-tui/dist/terminal.d.ts). Prefer that
     // over process.stdout.columns since it's the value pi-tui itself uses for
     // rendering, but pickLayout falls back if either is unavailable.
     const getCols = () => tui.terminal?.columns ?? process.stdout.columns;
-    // Static-mode start frame is the LAST frame — the artist's intended resting
-    // pose (see header docstring "the last frame holds"). Animated mode starts
-    // at frame 0 and advances from there.
+    // Static mode (chat/connect) holds the LAST frame — the clip's resting pose.
+    // Animated mode starts at frame 0 and advances from there.
     const initialFrameIdx = animate ? 0 : VIDEO_FRAME_COUNT - 1;
     const padTop = new Text("\n\n", 0, 0);
     tui.addChild(padTop);
@@ -403,6 +423,7 @@ export function renderBrandHeader(tui, opts = {}) {
         // quits, the process should be free to exit even if the timer hasn't yet
         // reached the final frame.
         timer.unref?.();
+        liveHeaderTimer = timer;
     }
     // Re-compose the brand block on terminal resize so the responsive layout
     // (side / stack / ascii-only / empty) keeps working as the animation
@@ -413,6 +434,7 @@ export function renderBrandHeader(tui, opts = {}) {
         safeRender(composeFrame(frameIdx, getCols()));
     };
     process.stdout.on("resize", onResize);
+    liveHeaderOnResize = onResize;
     return components;
 }
 //# sourceMappingURL=brand.js.map

package/dist/ui/brand.js.map

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

package/dist/ui/editor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Brigade's Editor — thin Pi-TUI subclass that fixes one UX quirk.
+ *
+ * Pi-TUI's stock `Editor` treats Enter on a slash-command suggestion as
+ * "accept + submit-immediately" (`editor.js:507-519` — `tui.select.confirm`
+ * applies the completion and falls through to `submitValue()`). That works
+ * for arg-less commands (`/help`, `/exit`) but is wrong for commands that
+ * take a REQUIRED argument (`/reasoning <on|off>`, `/thinking <level>`,
+ * `/mute <agent-id>`) — the user expects to inspect / edit the inserted
+ * text before sending.
+ *
+ * Pi already has an "accept + don't submit" path on Tab
+ * (`editor.js:492-505`). When the autocomplete popup is showing AND the
+ * user has typed a command that needs an argument, we translate Enter →
+ * Tab so the user's Enter on a popup selection just inserts the command
+ * into the editor with a trailing space and waits for them to type the
+ * arg + a real Enter to submit.
+ *
+ * For arg-less / optional-arg commands (`/agents`, `/help`, `/agent`,
+ * `/sessions`, etc.) the user expects a single Enter to submit — same
+ * as Pi's default. Two-Enter behaviour is a UX regression we explicitly
+ * opt OUT of here.
+ *
+ * Outside the popup, Enter retains its normal "submit" semantics.
+ */
+import { Editor } from "@mariozechner/pi-tui";
+export declare class BrigadeEditor extends Editor {
+    handleInput(data: string): void;
+}
+//# sourceMappingURL=editor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../../src/ui/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAoB9C,qBAAa,aAAc,SAAQ,MAAM;IAC/B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CA2BxC"}

package/dist/ui/editor.js

@@ -0,0 +1,73 @@
+/**
+ * Brigade's Editor — thin Pi-TUI subclass that fixes one UX quirk.
+ *
+ * Pi-TUI's stock `Editor` treats Enter on a slash-command suggestion as
+ * "accept + submit-immediately" (`editor.js:507-519` — `tui.select.confirm`
+ * applies the completion and falls through to `submitValue()`). That works
+ * for arg-less commands (`/help`, `/exit`) but is wrong for commands that
+ * take a REQUIRED argument (`/reasoning <on|off>`, `/thinking <level>`,
+ * `/mute <agent-id>`) — the user expects to inspect / edit the inserted
+ * text before sending.
+ *
+ * Pi already has an "accept + don't submit" path on Tab
+ * (`editor.js:492-505`). When the autocomplete popup is showing AND the
+ * user has typed a command that needs an argument, we translate Enter →
+ * Tab so the user's Enter on a popup selection just inserts the command
+ * into the editor with a trailing space and waits for them to type the
+ * arg + a real Enter to submit.
+ *
+ * For arg-less / optional-arg commands (`/agents`, `/help`, `/agent`,
+ * `/sessions`, etc.) the user expects a single Enter to submit — same
+ * as Pi's default. Two-Enter behaviour is a UX regression we explicitly
+ * opt OUT of here.
+ *
+ * Outside the popup, Enter retains its normal "submit" semantics.
+ */
+import { Editor } from "@mariozechner/pi-tui";
+// Slash commands whose argument is OPTIONAL (or absent) — Enter should
+// submit immediately even when the autocomplete popup is showing. Kept
+// in sync with `SLASH_COMMANDS` in `src/cli/commands/connect.ts`.
+const NO_REQUIRED_ARG = new Set([
+    "help",
+    "exit",
+    "quit",
+    "abort",
+    "usage",
+    "compact",
+    "agents", // no arg
+    "agent", // [<agent-id>] — optional
+    "session", // [<session-key>] — optional
+    "sessions", // [--all] — optional
+    "model", // [<model-id>] — optional
+    "reasoning", // [on|off] — optional toggle
+]);
+export class BrigadeEditor extends Editor {
+    handleInput(data) {
+        // Pi's handleInput recognises both `\r` and `\n` as Enter (see
+        // `editor.js:586-613`). Translate either to Tab `\t` ONLY when the
+        // autocomplete popup is showing AND the command needs a required
+        // argument. Otherwise Enter submits normally.
+        if (this.isShowingAutocomplete() && (data === "\r" || data === "\n")) {
+            const text = this.getText();
+            // Match a slash command that hasn't been argument-typed yet:
+            // `/<name>` with optional trailing whitespace. If the user has
+            // already typed an arg (text contains a space + chars), we keep
+            // Pi's default submit path too — the autocomplete popup at that
+            // point is showing argument completions, not command completions.
+            const match = text.match(/^\/([a-z][a-z0-9_-]*)\s*$/);
+            if (match && NO_REQUIRED_ARG.has(match[1] ?? "")) {
+                // Arg-less or optional-arg command typed in full — let Pi
+                // accept + submit in one Enter (the default behaviour).
+                super.handleInput(data);
+                return;
+            }
+            // Either the command needs a required arg, the text is partial,
+            // or the popup is showing argument completions — translate to
+            // Tab so the user can edit before sending.
+            super.handleInput("\t");
+            return;
+        }
+        super.handleInput(data);
+    }
+}
+//# sourceMappingURL=editor.js.map

package/dist/ui/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../src/ui/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,uEAAuE;AACvE,uEAAuE;AACvE,kEAAkE;AAClE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC/B,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,SAAS;IACT,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,0BAA0B;IACnC,SAAS,EAAE,6BAA6B;IACxC,UAAU,EAAE,qBAAqB;IACjC,OAAO,EAAE,0BAA0B;IACnC,WAAW,EAAE,6BAA6B;CAC1C,CAAC,CAAC;AAEH,MAAM,OAAO,aAAc,SAAQ,MAAM;IAC/B,WAAW,CAAC,IAAY;QAChC,+DAA+D;QAC/D,mEAAmE;QACnE,iEAAiE;QACjE,8CAA8C;QAC9C,IAAI,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,6DAA6D;YAC7D,+DAA+D;YAC/D,gEAAgE;YAChE,gEAAgE;YAChE,kEAAkE;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACtD,IAAI,KAAK,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAClD,0DAA0D;gBAC1D,wDAAwD;gBACxD,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACxB,OAAO;YACR,CAAC;YACD,gEAAgE;YAChE,8DAA8D;YAC9D,2CAA2C;YAC3C,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACR,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;CACD"}

package/dist/ui/format-session.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Brigade-style human labels for session keys.
+ *
+ * Session keys are canonical `agent:<id>:<rest>` strings — clear for the
+ * routing layer, ugly for an operator skimming the TUI. This module turns
+ * the raw key into a short Brigade-friendly chip the connect-mode TUI
+ * header, approval prompts, and `/status` overlays can render.
+ *
+ * Design rules:
+ *
+ *   - **Home is silent.** The operator's default `:main` session returns
+ *     `undefined` so the TUI omits the chip entirely. No `· main` noise
+ *     in the 95% common case.
+ *   - **Surface the peer.** DMs and groups carry the peer / room id —
+ *     the operator needs to know WHO they're chatting with, not just
+ *     that it's a "DM".
+ *   - **Visual signals.** `↳` precedes sub-agents (nested), `⤳` flags
+ *     threads (branches), `⏰` marks cron-triggered turns. Each chip
+ *     telegraphs its kind at a glance.
+ *   - **Mascot stays exclusive to the brand.** The 🦁 emoji rides only
+ *     on the persona name; sub-agents get the "cub" framing without
+ *     doubling the lion.
+ *
+ * Examples:
+ *
+ *   agent:main:main                            → undefined (omit chip)
+ *   agent:ops:main                             → undefined (crew badge carries it)
+ *   agent:main:whatsapp:direct:+919876543210   → "WhatsApp · +919876543210"
+ *   agent:ops:slack:group:c012abc              → "Slack · c012abc"
+ *   agent:work:telegram:channel:@news          → "Telegram · @news"
+ *   agent:ops:whatsapp:group:c1:thread:t42     → "WhatsApp · c1 ⤳ t42"
+ *   agent:main:subagent:abc-def-uuid           → "↳ cub abc-de…"
+ *   agent:main:cron:morning-summary            → "⏰ morning-summary"
+ *
+ * Casing note: Brigade canonicalises session keys to lowercase at the
+ * key-builder layer, so peer ids that were uppercase upstream (e.g. a
+ * Slack channel id `C012ABC`) reach this formatter as their lowercase
+ * canonical form. We render whatever's in the key — preserving the
+ * canonical form is the simplest contract.
+ *
+ * The agent id is intentionally omitted from the session label — the
+ * caller renders it separately as the "crew" badge (e.g. `crew ops`) so
+ * the operator sees agent + session as distinct chips, not glued together.
+ */
+/**
+ * Convert a raw session key to a Brigade-friendly chip — or `undefined`
+ * if the chip should be omitted (the default `:main` home session, or an
+ * empty / unparseable key).
+ *
+ * Callers should treat `undefined` as "render nothing here" so the
+ * header stays clean in the common case.
+ */
+export declare function formatSessionLabel(sessionKey: string | undefined | null): string | undefined;
+/**
+ * Compose a Brigade-style "crew" badge for the agent id. Returns the
+ * empty string when there's nothing useful to show (caller skips the
+ * segment in that case).
+ *
+ *   - default agent (`"main"`) WITH a persona name set → "" (the persona
+ *     name is enough; we don't double-label).
+ *   - default agent without persona name                → "crew main"
+ *   - non-default agent                                 → "crew ops"
+ */
+export declare function formatCrewLabel(params: {
+    agentId: string | undefined | null;
+    personaName?: string | undefined | null;
+}): string;
+//# sourceMappingURL=format-session.d.ts.map

package/dist/ui/format-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-session.d.ts","sourceRoot":"","sources":["../../src/ui/format-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AA2CH;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAuE5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACvC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;CACxC,GAAG,MAAM,CAMT"}

package/dist/ui/format-session.js

@@ -0,0 +1,181 @@
+/**
+ * Brigade-style human labels for session keys.
+ *
+ * Session keys are canonical `agent:<id>:<rest>` strings — clear for the
+ * routing layer, ugly for an operator skimming the TUI. This module turns
+ * the raw key into a short Brigade-friendly chip the connect-mode TUI
+ * header, approval prompts, and `/status` overlays can render.
+ *
+ * Design rules:
+ *
+ *   - **Home is silent.** The operator's default `:main` session returns
+ *     `undefined` so the TUI omits the chip entirely. No `· main` noise
+ *     in the 95% common case.
+ *   - **Surface the peer.** DMs and groups carry the peer / room id —
+ *     the operator needs to know WHO they're chatting with, not just
+ *     that it's a "DM".
+ *   - **Visual signals.** `↳` precedes sub-agents (nested), `⤳` flags
+ *     threads (branches), `⏰` marks cron-triggered turns. Each chip
+ *     telegraphs its kind at a glance.
+ *   - **Mascot stays exclusive to the brand.** The 🦁 emoji rides only
+ *     on the persona name; sub-agents get the "cub" framing without
+ *     doubling the lion.
+ *
+ * Examples:
+ *
+ *   agent:main:main                            → undefined (omit chip)
+ *   agent:ops:main                             → undefined (crew badge carries it)
+ *   agent:main:whatsapp:direct:+919876543210   → "WhatsApp · +919876543210"
+ *   agent:ops:slack:group:c012abc              → "Slack · c012abc"
+ *   agent:work:telegram:channel:@news          → "Telegram · @news"
+ *   agent:ops:whatsapp:group:c1:thread:t42     → "WhatsApp · c1 ⤳ t42"
+ *   agent:main:subagent:abc-def-uuid           → "↳ cub abc-de…"
+ *   agent:main:cron:morning-summary            → "⏰ morning-summary"
+ *
+ * Casing note: Brigade canonicalises session keys to lowercase at the
+ * key-builder layer, so peer ids that were uppercase upstream (e.g. a
+ * Slack channel id `C012ABC`) reach this formatter as their lowercase
+ * canonical form. We render whatever's in the key — preserving the
+ * canonical form is the simplest contract.
+ *
+ * The agent id is intentionally omitted from the session label — the
+ * caller renders it separately as the "crew" badge (e.g. `crew ops`) so
+ * the operator sees agent + session as distinct chips, not glued together.
+ */
+import { parseAgentSessionKey } from "../sessions/session-key-utils.js";
+/** Canonical channel id → human label. Anything missing falls back to the raw id title-cased. */
+const CHANNEL_LABELS = {
+    whatsapp: "WhatsApp",
+    telegram: "Telegram",
+    slack: "Slack",
+    discord: "Discord",
+    signal: "Signal",
+    imessage: "iMessage",
+    matrix: "Matrix",
+    email: "Email",
+    sms: "SMS",
+    webhook: "Webhook",
+};
+/** Max chars before we truncate a peer / room id with an ellipsis. */
+const PEER_ID_MAX = 24;
+/** Max chars before we truncate a sub-agent uuid. */
+const SUBAGENT_ID_MAX = 8;
+/** Max chars before we truncate a cron job id. */
+const CRON_ID_MAX = 24;
+/** Max chars before we truncate a thread id. */
+const THREAD_ID_MAX = 12;
+function titleCase(raw) {
+    if (!raw)
+        return raw;
+    return raw.charAt(0).toUpperCase() + raw.slice(1);
+}
+function humanChannel(channelId) {
+    const lowered = channelId.toLowerCase();
+    return CHANNEL_LABELS[lowered] ?? titleCase(channelId);
+}
+function shortenId(id, max) {
+    if (!id)
+        return id;
+    if (id.length <= max)
+        return id;
+    return `${id.slice(0, Math.max(1, max - 1))}…`;
+}
+/**
+ * Convert a raw session key to a Brigade-friendly chip — or `undefined`
+ * if the chip should be omitted (the default `:main` home session, or an
+ * empty / unparseable key).
+ *
+ * Callers should treat `undefined` as "render nothing here" so the
+ * header stays clean in the common case.
+ */
+export function formatSessionLabel(sessionKey) {
+    const raw = (sessionKey ?? "").trim();
+    if (!raw)
+        return undefined;
+    const parsed = parseAgentSessionKey(raw);
+    if (!parsed)
+        return raw;
+    const rest = parsed.rest.trim();
+    // Home / main session → omit the chip entirely. The crew badge
+    // already tells the operator which agent's home they're in.
+    if (!rest || rest === "main")
+        return undefined;
+    // Strip an optional :thread:<id> suffix BEFORE further parsing so the
+    // thread tag never confuses the channel/peerKind split below. The
+    // curved arrow `⤳` reads as "branch into" — picks out the thread
+    // inline without spelling out the word.
+    let threadSuffix = "";
+    let body = rest;
+    const threadIdx = body.lastIndexOf(":thread:");
+    if (threadIdx >= 0) {
+        const threadId = body.slice(threadIdx + ":thread:".length);
+        threadSuffix = ` ⤳ ${shortenId(threadId, THREAD_ID_MAX)}`;
+        body = body.slice(0, threadIdx);
+    }
+    // Sub-agent: `subagent:<uuid>` — Brigade's brand framing calls
+    // nested agents "cubs" (part of the Pride). The `↳` arrow telegraphs
+    // "this is a child of the parent agent" without re-using the 🦁
+    // mascot that already rides the persona label.
+    if (body.startsWith("subagent:")) {
+        const id = body.slice("subagent:".length).split(":")[0] ?? "";
+        return `↳ cub ${shortenId(id, SUBAGENT_ID_MAX)}${threadSuffix}`;
+    }
+    // Cron: `cron:<jobId>` — clock emoji is universal; drop the literal
+    // "cron · " prefix in favour of just the job id.
+    if (body.startsWith("cron:")) {
+        const jobId = body.slice("cron:".length).split(":")[0] ?? "";
+        return `⏰ ${shortenId(jobId, CRON_ID_MAX)}${threadSuffix}`;
+    }
+    const parts = body.split(":");
+    if (parts.length === 1) {
+        // Single token after agent id — likely a custom alias. Keep as-is.
+        return `${parts[0]}${threadSuffix}`;
+    }
+    // Channel-routed: `<channel>:<peerKind>:<peerId>` OR
+    // `<channel>:<accountId>:<peerKind>:<peerId>`. The peer id is the
+    // operator-recognisable bit (phone number, @handle, Slack channel id)
+    // so we surface it; the peer KIND (direct / group / channel) is
+    // implicit from the channel + peer id format and we drop it.
+    const channel = parts[0] ?? "";
+    const second = parts[1] ?? "";
+    const peerKindCandidates = new Set(["direct", "group", "channel"]);
+    const isPeerKindAtSecond = peerKindCandidates.has(second.toLowerCase());
+    let peerId = "";
+    if (isPeerKindAtSecond) {
+        peerId = parts.slice(2).join(":");
+    }
+    else if (parts.length >= 3 && peerKindCandidates.has((parts[2] ?? "").toLowerCase())) {
+        // Per-account-channel-peer shape: <channel>:<account>:<peerKind>:<peerId>
+        peerId = parts.slice(3).join(":");
+    }
+    const channelLabel = channel ? humanChannel(channel) : "";
+    const peerLabel = peerId ? shortenId(peerId, PEER_ID_MAX) : "";
+    if (channelLabel && peerLabel) {
+        return `${channelLabel} · ${peerLabel}${threadSuffix}`;
+    }
+    if (channelLabel) {
+        return `${channelLabel}${threadSuffix}`;
+    }
+    // Fallback — return the rest verbatim so we never lose information.
+    return `${rest}`;
+}
+/**
+ * Compose a Brigade-style "crew" badge for the agent id. Returns the
+ * empty string when there's nothing useful to show (caller skips the
+ * segment in that case).
+ *
+ *   - default agent (`"main"`) WITH a persona name set → "" (the persona
+ *     name is enough; we don't double-label).
+ *   - default agent without persona name                → "crew main"
+ *   - non-default agent                                 → "crew ops"
+ */
+export function formatCrewLabel(params) {
+    const id = (params.agentId ?? "").trim();
+    if (!id)
+        return "";
+    const hasPersona = !!params.personaName?.trim();
+    if (id === "main" && hasPersona)
+        return "";
+    return `crew ${id}`;
+}
+//# sourceMappingURL=format-session.js.map

package/dist/ui/format-session.js.map

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

package/dist/ui/markdown.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Pi-TUI `Markdown` wrapper that normalizes underscored italic spans before
+ * the widget's parser sees them.
+ *
+ * The bug it fixes: Pi-TUI's Markdown parser handles `**bold**` and
+ * `*italic*` correctly but renders `_text_` as LITERAL underscores. The
+ * CommonMark spec says `_text_` should produce italic when the underscores
+ * are at flank boundaries (e.g. `_(pick something you like)_`), but Pi-TUI
+ * v0.70.x doesn't follow that path. Without this wrapper, agent replies
+ * that quote markdown using underscored emphasis — most visibly the
+ * placeholders inside the workspace template files (`_(pick something you
+ * like)_`, `_Fill this in._`, etc.) — leak through with raw underscores.
+ *
+ * This is a Brigade-side fix in the renderer (templates stay untouched,
+ * agent outputs aren't post-processed elsewhere — only the renderer is
+ * taught to accept both italic flavours).
+ *
+ * Replacement scope (`normalizeMarkdownItalic`):
+ *   - Convert `_X_` to `*X*` ONLY when:
+ *       • opening `_` is at start-of-string OR follows whitespace/punctuation
+ *       • closing `_` is at end-of-string OR precedes whitespace/punctuation
+ *       • span contents have no newlines and no nested underscores
+ *   - Skip `snake_case` identifiers (the underscores are between word chars
+ *     so the boundary check naturally excludes them).
+ *   - Skip URLs that contain underscores (those get caught by the
+ *     "preceded-by-`/` or `:`" cases — neither is in our flank set, so the
+ *     pattern doesn't fire mid-URL).
+ *
+ * Drop-in shape: same constructor + setText signature as Pi-TUI's
+ * `Markdown`, so callsites can just swap the import line.
+ */
+import { Markdown as PiMarkdown } from "@mariozechner/pi-tui";
+import type { DefaultTextStyle, MarkdownTheme } from "@mariozechner/pi-tui";
+/**
+ * Convert `_text_` italic markdown into `*text*` so Pi-TUI's parser renders
+ * it as italic. Idempotent — running on already-normalized text is a no-op.
+ */
+export declare function normalizeMarkdownItalic(text: string): string;
+/**
+ * Brigade's drop-in `Markdown` — same surface as Pi-TUI's, but normalises
+ * underscored italics on every text mutation. Use this everywhere the TUI
+ * renders user/agent text.
+ */
+export declare class Markdown extends PiMarkdown {
+    constructor(text: string, paddingX: number, paddingY: number, theme: MarkdownTheme, defaultTextStyle?: DefaultTextStyle);
+    setText(text: string): void;
+}
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/ui/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,UAAU;gBAEpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,gBAAgB,CAAC,EAAE,gBAAgB;IAK5B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGrC"}