@gigaflow/gmux 0.15.0

package/dist/cli/preview.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The preview pane — both halves of it.
+ *
+ * fzf has exactly ONE preview pane and cannot split it. So gmux renders the card
+ * and the chat into one command's output and owns the boundary itself: fzf does
+ * not gain a pane, it gains a longer string.
+ *
+ * ```
+ * ┌─ sessions ─────┬─ preview ──────────────────┐
+ * │ > webshop  2h  │ 4998a936  webshop  2h ago  │
+ * │   api      4h  │ WHERE IT LANDED …          │  ← formatCard, clipped
+ * │   docs     1d  │ ── ask ────────────────────│  ← the divider
+ * │                │ you                        │
+ * │                │   why did this one fail?   │  ← the transcript
+ * │                │ gmux                         │
+ * │                │   The run died in apply_…  │
+ * └────────────────┴────────────────────────────┘
+ * ```
+ *
+ * **No conversation ⇒ the card gets the whole pane, byte-identical to today.**
+ * That is the deal, not a nicety: a picker run where nobody presses ctrl-o must
+ * render exactly what it rendered before this file existed. It needs no flag and
+ * no branch — a missing transcript reads as zero events, `splitPreview` hands the
+ * card every row, and `formatPreview` returns `formatCard` and nothing else.
+ *
+ * **Nothing here calls a model, and nothing here may ever learn how.** The
+ * preview command re-runs on every cursor move, so a model call in this file is
+ * a model call per keystroke. The chat renders from the transcript file or it
+ * does not render.
+ *
+ * **Colour is an accent, never the message.** The preview's stdout is a pipe,
+ * not a tty, so `format.ts`'s gated `dim`/`cyan` are no-ops here and the CARD
+ * stays monochrome, exactly as it shipped. The divider and the `you`/`gmux`
+ * speakers use the `paneCyan`/`paneBold` variants instead, which fzf renders
+ * with `--ansi` — so the seam between card and chat pops in colour. But the
+ * divider is still carried by GLYPHS and the speakers by LAYOUT, so `NO_COLOR`,
+ * `TERM=dumb` or a colourless pane loses only the accent, never the structure.
+ */
+import type { SessionView } from "../core/types.js";
+import type { AskTranscript } from "../services/ask-transcript.js";
+/** Row budget for one render. Sums to the pane height. */
+export interface PreviewSplit {
+    cardRows: number;
+    dividerRows: 0 | 1;
+    chatRows: number;
+}
+/**
+ * How the pane's rows are divided.
+ *
+ * `paneRows` arrives from `$FZF_PREVIEW_LINES` via a shell and a commander flag,
+ * which makes it environment-controlled text. Treat it as hostile: anything
+ * non-positive is the guess, and no arithmetic below may go negative or throw.
+ */
+export declare function splitPreview(paneRows: number, hasChat: boolean): PreviewSplit;
+/** `Math.max(0, …)`: `String.repeat` throws RangeError on a negative count, and
+ *  the width came from the environment. A narrow pane must not crash the pane.
+ *  The colour is zero display columns, so the rule is still exactly `width`. */
+export declare function askDivider(width: number): string;
+/**
+ * Is there a conversation at all?
+ *
+ * A question is the only thing that makes one. `meta` alone is a transcript the
+ * sender created and nothing more, and it must still render the empty state —
+ * otherwise a `no-provider` send would put a divider over an empty half.
+ */
+export declare function hasChatContent(transcript: AskTranscript | null): boolean;
+/**
+ * The chat half: the last `rows` wrapped rows of the thread.
+ *
+ * **Auto-tail.** New text appears at the bottom, old text slides up. That is what
+ * makes it read as a chat rather than a document, it composes with the refresh
+ * loop for free, and it means the common case needs no scrolling at all. There is
+ * deliberately no scroll: fzf's own `shift-up` scrolls the WHOLE preview, which
+ * in split mode drags the card off the top and reveals nothing, because there is
+ * only one pane. If you hit the ceiling, `cat` the transcript.
+ *
+ * `now` is a parameter so the `thinking… Ns` count is testable without a clock.
+ */
+export declare function formatChat(transcript: AskTranscript, rows: number, width: number, now?: Date): string;
+/**
+ * One preview command's whole output: the card, and the chat if there is one.
+ *
+ * **The empty state returns `formatCard` and NOTHING else** — not "the card plus
+ * an empty tail", not "the card with a trailing divider". Byte-identical, because
+ * that is what decision 4 promises to everyone who never presses ctrl-o.
+ */
+export declare function formatPreview(view: SessionView, transcript: AskTranscript | null, split: PreviewSplit, width: number, now?: Date): string;

package/dist/cli/preview.js

@@ -0,0 +1,292 @@
+/**
+ * The preview pane — both halves of it.
+ *
+ * fzf has exactly ONE preview pane and cannot split it. So gmux renders the card
+ * and the chat into one command's output and owns the boundary itself: fzf does
+ * not gain a pane, it gains a longer string.
+ *
+ * ```
+ * ┌─ sessions ─────┬─ preview ──────────────────┐
+ * │ > webshop  2h  │ 4998a936  webshop  2h ago  │
+ * │   api      4h  │ WHERE IT LANDED …          │  ← formatCard, clipped
+ * │   docs     1d  │ ── ask ────────────────────│  ← the divider
+ * │                │ you                        │
+ * │                │   why did this one fail?   │  ← the transcript
+ * │                │ gmux                         │
+ * │                │   The run died in apply_…  │
+ * └────────────────┴────────────────────────────┘
+ * ```
+ *
+ * **No conversation ⇒ the card gets the whole pane, byte-identical to today.**
+ * That is the deal, not a nicety: a picker run where nobody presses ctrl-o must
+ * render exactly what it rendered before this file existed. It needs no flag and
+ * no branch — a missing transcript reads as zero events, `splitPreview` hands the
+ * card every row, and `formatPreview` returns `formatCard` and nothing else.
+ *
+ * **Nothing here calls a model, and nothing here may ever learn how.** The
+ * preview command re-runs on every cursor move, so a model call in this file is
+ * a model call per keystroke. The chat renders from the transcript file or it
+ * does not render.
+ *
+ * **Colour is an accent, never the message.** The preview's stdout is a pipe,
+ * not a tty, so `format.ts`'s gated `dim`/`cyan` are no-ops here and the CARD
+ * stays monochrome, exactly as it shipped. The divider and the `you`/`gmux`
+ * speakers use the `paneCyan`/`paneBold` variants instead, which fzf renders
+ * with `--ansi` — so the seam between card and chat pops in colour. But the
+ * divider is still carried by GLYPHS and the speakers by LAYOUT, so `NO_COLOR`,
+ * `TERM=dumb` or a colourless pane loses only the accent, never the structure.
+ */
+import { wrapText } from "../core/text.js";
+import { formatCard, indent, paneBold, paneCyan, paneDim } from "./format.js";
+/** Below this the card is a fragment and the chat is unreadable. See COLLAPSED. */
+const MIN_SPLIT = 15;
+/** Enough card to be a card: label, meta, blank, a heading and two lines under it. */
+const CARD_MIN = 6;
+/** Enough chat to read as one: two speakers, two bodies, the blank between them. */
+const CHAT_MIN = 8;
+const DIVIDER_ROWS = 1;
+/**
+ * What we assume when fzf did not tell us the pane height.
+ *
+ * A guess rather than a refusal to split, deliberately: the chat auto-tails, so
+ * an over-guess costs a little fzf scrolling, while refusing shows no chat at all
+ * to someone who just asked for one.
+ */
+const ASSUMED_PANE_ROWS = 24;
+/**
+ * How the pane's rows are divided.
+ *
+ * `paneRows` arrives from `$FZF_PREVIEW_LINES` via a shell and a commander flag,
+ * which makes it environment-controlled text. Treat it as hostile: anything
+ * non-positive is the guess, and no arithmetic below may go negative or throw.
+ */
+export function splitPreview(paneRows, hasChat) {
+    const rows = Number.isFinite(paneRows) && paneRows > 0 ? Math.floor(paneRows) : ASSUMED_PANE_ROWS;
+    // The empty state, and the whole of it. `cardRows` is the pane because there
+    // is nothing to share it with.
+    if (!hasChat)
+        return { cardRows: rows, dividerRows: 0, chatRows: 0 };
+    if (rows < MIN_SPLIT) {
+        // COLLAPSED — the answer to "what about a 20-line terminal?", where the pane
+        // is 14 rows and two 7-row halves are useless to everybody. The card drops to
+        // `formatCard`'s first line (`bold(sessionLabel)`) and the chat takes the
+        // rest: you still know which session "this" is, which is the entire point of
+        // the focus model, and the chat stays readable. A better failure than an
+        // 8-row card fragment.
+        const chatRows = Math.max(0, rows - 1 - DIVIDER_ROWS);
+        const dividerRows = chatRows > 0 ? 1 : 0;
+        return { cardRows: rows - chatRows - dividerRows, dividerRows, chatRows };
+    }
+    const chatRows = Math.min(Math.max(Math.floor(rows / 2), CHAT_MIN), rows - DIVIDER_ROWS - CARD_MIN);
+    return { cardRows: rows - chatRows - DIVIDER_ROWS, dividerRows: 1, chatRows };
+}
+/**
+ * `"── ask "` is 7 display columns, so the rendered rule is exactly `width`.
+ *
+ * Labelled because `format.ts`'s idiom is named sections (`WHERE IT LANDED`,
+ * `NEXT STEP`) and an anonymous rule would be the only unnamed boundary on
+ * screen. `paneCyan` — gmux's own accent, the `gmux` speaker's colour — so the seam
+ * between the monochrome card and the chat is the one line that pops, which is
+ * the whole reason it is coloured rather than dim. `paneCyan` not `cyan`: the
+ * pane is a pipe, so the gated `cyan` is a no-op here; `paneCyan` drops only the
+ * TTY test and still honours `NO_COLOR`. The unicode needs no ASCII fallback —
+ * `format.ts` already ships `⚠ ○ ◐ ·` unconditionally.
+ */
+const DIVIDER_LABEL = "── ask ";
+/** `Math.max(0, …)`: `String.repeat` throws RangeError on a negative count, and
+ *  the width came from the environment. A narrow pane must not crash the pane.
+ *  The colour is zero display columns, so the rule is still exactly `width`. */
+export function askDivider(width) {
+    const fill = Number.isFinite(width) ? Math.floor(width) - DIVIDER_LABEL.length : 0;
+    return paneCyan(`${DIVIDER_LABEL}${"─".repeat(Math.max(0, fill))}`);
+}
+/**
+ * Is there a conversation at all?
+ *
+ * A question is the only thing that makes one. `meta` alone is a transcript the
+ * sender created and nothing more, and it must still render the empty state —
+ * otherwise a `no-provider` send would put a divider over an empty half.
+ */
+export function hasChatContent(transcript) {
+    return transcript !== null && transcript.events.some((event) => event.t === "question");
+}
+function foldBySeq(events) {
+    const questions = [];
+    const chunks = new Map();
+    const settled = new Map();
+    for (const event of events) {
+        switch (event.t) {
+            case "question":
+                questions.push(event);
+                break;
+            case "chunk": {
+                const existing = chunks.get(event.seq);
+                if (existing)
+                    existing.push(event.text);
+                else
+                    chunks.set(event.seq, [event.text]);
+                break;
+            }
+            case "end":
+            case "aborted":
+                settled.set(event.seq, { t: event.t });
+                break;
+            case "error":
+                settled.set(event.seq, { t: "error", message: event.message });
+                break;
+            default:
+                break;
+        }
+    }
+    // Keyed by `seq`, never file order — the same rule `foldCompletedTurns` folds
+    // by, and for the same reason: correctness here must not depend on a lock in
+    // another module.
+    questions.sort((a, b) => a.seq - b.seq);
+    return { questions, chunks, settled };
+}
+/** Elapsed whole seconds since a question landed. Computed at render time and
+ *  never stored — a number written into the transcript is stale on arrival. */
+function elapsedSeconds(at, now) {
+    const started = Date.parse(at);
+    if (!Number.isFinite(started))
+        return 0;
+    return Math.max(0, Math.floor((now.getTime() - started) / 1000));
+}
+/**
+ * The answer slot, in every state a turn can be in.
+ *
+ * The in-flight render is specified rather than implied because it IS the UX for
+ * most of a turn's life: the provider buffers, so `thinking… 14s` is what the
+ * pane says for ~9–20s and the answer then lands in one paint.
+ */
+function answerText(seq, question, folded, now) {
+    const partial = (folded.chunks.get(seq) ?? []).join("").trim();
+    const settled = folded.settled.get(seq);
+    if (!settled) {
+        return partial === ""
+            ? `thinking… ${elapsedSeconds(question.at, now)}s   (esc to cancel)`
+            : partial;
+    }
+    if (settled.t === "error")
+        return settled.message ?? "the answer failed";
+    if (settled.t === "aborted") {
+        // The human still SEES an aborted turn here; only the model's view loses it
+        // (`foldCompletedTurns` drops it, so "ok but briefly" after an esc has no
+        // antecedent — which beats telling the model it failed and being apologized
+        // at instead of answered).
+        return partial === "" ? "(cancelled)" : `${partial}\n(cancelled)`;
+    }
+    return partial;
+}
+/**
+ * `you` / `gmux`, with the body indented under it.
+ *
+ * Legible with colour off, which the pane requires: the speaker sits on its own
+ * line above an indented body, so the LAYOUT distinguishes them and the colour
+ * only accelerates it. `paneBold` is the section-heading idiom; `paneCyan` is
+ * already gmux's own colour (the `where` column, the `○` marker) — the forced
+ * variants, because the pane is a pipe and the gated ones would be no-ops here.
+ */
+function speaker(head, body, width) {
+    const wrapped = body
+        .split("\n")
+        .flatMap((line) => wrapText(line, Math.max(1, Math.floor(width) - 2)));
+    return [head, ...indent(wrapped.join("\n")).split("\n")];
+}
+/**
+ * The `· re:` suffix marks a CHANGE of focus, and nothing else.
+ *
+ * Focus re-points per question, so a thread of five questions can span five
+ * sessions and an answer rendered under a cursor that has since moved reads as
+ * being about the wrong one. But stamping every question with the same id when
+ * focus never moved is noise on the half of the pane with least room for it. The
+ * change is the only moment it carries information — plus the first question,
+ * which has nothing to differ from and everything to establish.
+ */
+function questionHead(question, previousFocus, first) {
+    const focus = question.focus;
+    if (!focus || (!first && focus === previousFocus))
+        return paneBold("you");
+    return `${paneBold("you")} ${paneDim(`· re: ${focus.slice(0, 8)}`)}`;
+}
+/**
+ * The chat half: the last `rows` wrapped rows of the thread.
+ *
+ * **Auto-tail.** New text appears at the bottom, old text slides up. That is what
+ * makes it read as a chat rather than a document, it composes with the refresh
+ * loop for free, and it means the common case needs no scrolling at all. There is
+ * deliberately no scroll: fzf's own `shift-up` scrolls the WHOLE preview, which
+ * in split mode drags the card off the top and reveals nothing, because there is
+ * only one pane. If you hit the ceiling, `cat` the transcript.
+ *
+ * `now` is a parameter so the `thinking… Ns` count is testable without a clock.
+ */
+export function formatChat(transcript, rows, width, now = new Date()) {
+    const folded = foldBySeq(transcript.events);
+    const lines = [];
+    let previousFocus = null;
+    for (const [index, question] of folded.questions.entries()) {
+        if (index > 0)
+            lines.push("");
+        lines.push(...speaker(questionHead(question, previousFocus, index === 0), question.text, width));
+        lines.push("");
+        lines.push(...speaker(paneCyan("gmux"), answerText(question.seq, question, folded, now), width));
+        previousFocus = question.focus;
+    }
+    const budget = Number.isFinite(rows) && rows > 0 ? Math.floor(rows) : 0;
+    return lines.slice(-budget || lines.length).join("\n");
+}
+/**
+ * The card, clipped at the divider, counted in DISPLAY rows.
+ *
+ * `--preview-window=…,wrap` breaks a card line at the pane's right edge, and
+ * `formatCard` emits lines up to 647 columns — so a divider placed after
+ * `cardRows` *logical* lines would be shoved off the pane it exists to split.
+ * Breaking at the same column fzf would gives the same picture and puts the
+ * divider where we said it goes.
+ *
+ * The card is clipped and not rewritten: measured, it renders 23–83 rows against
+ * a 14–41 row pane, so it already overflows the FULL pane by 1.2x–6x at every
+ * realistic size. The split does not break the card; the card was already
+ * clipped, and fixing that is `gmux show`'s bug, not this pane's.
+ */
+function clipToRows(lines, rows, width) {
+    const out = [];
+    for (const line of lines) {
+        if (out.length >= rows)
+            break;
+        for (const piece of hardWrap(line, width)) {
+            if (out.length >= rows)
+                break;
+            out.push(piece);
+        }
+    }
+    return out;
+}
+function hardWrap(line, width) {
+    const w = Math.floor(width);
+    if (!Number.isFinite(w) || w <= 0 || line.length <= w)
+        return [line];
+    const pieces = [];
+    for (let i = 0; i < line.length; i += w)
+        pieces.push(line.slice(i, i + w));
+    return pieces;
+}
+/**
+ * One preview command's whole output: the card, and the chat if there is one.
+ *
+ * **The empty state returns `formatCard` and NOTHING else** — not "the card plus
+ * an empty tail", not "the card with a trailing divider". Byte-identical, because
+ * that is what decision 4 promises to everyone who never presses ctrl-o.
+ */
+export function formatPreview(view, transcript, split, width, now = new Date()) {
+    const card = formatCard(view, now);
+    if (transcript === null || split.chatRows <= 0 || !hasChatContent(transcript))
+        return card;
+    return [
+        ...clipToRows(card.split("\n"), split.cardRows, width),
+        askDivider(width),
+        formatChat(transcript, split.chatRows, width, now),
+    ].join("\n");
+}
+//# sourceMappingURL=preview.js.map

package/dist/cli/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/cli/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAS9E,mFAAmF;AACnF,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,sFAAsF;AACtF,MAAM,QAAQ,GAAG,CAAC,CAAC;AACnB,oFAAoF;AACpF,MAAM,QAAQ,GAAG,CAAC,CAAC;AACnB,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAgB;IAC7D,MAAM,IAAI,GACR,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEvF,6EAA6E;IAC7E,+BAA+B;IAC/B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAErE,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;QACrB,6EAA6E;QAC7E,8EAA8E;QAC9E,0EAA0E;QAC1E,6EAA6E;QAC7E,yEAAyE;QACzE,uBAAuB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;QACtD,MAAM,WAAW,GAAU,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,EACxC,IAAI,GAAG,YAAY,GAAG,QAAQ,CAC/B,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,YAAY,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC;;gFAEgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,OAAO,QAAQ,CAAC,GAAG,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,UAAgC;IAC7D,OAAO,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC;AAC1F,CAAC;AAUD,SAAS,SAAS,CAAC,MAA2B;IAK5C,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,UAAU;gBACb,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,MAAM;YACR,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvC,IAAI,QAAQ;oBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;oBACnC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACzC,MAAM;YACR,CAAC;YACD,KAAK,KAAK,CAAC;YACX,KAAK,SAAS;gBACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/D,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,6EAA6E;IAC7E,kBAAkB;IAClB,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED;+EAC+E;AAC/E,SAAS,cAAc,CAAC,EAAU,EAAE,GAAS;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,GAAW,EAAE,QAAkB,EAAE,MAAoC,EAAE,GAAS;IAClG,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,KAAK,EAAE;YACnB,CAAC,CAAC,aAAa,cAAc,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,qBAAqB;YACpE,CAAC,CAAC,OAAO,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,IAAI,mBAAmB,CAAC;IACzE,IAAI,OAAO,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC5B,4EAA4E;QAC5E,0EAA0E;QAC1E,4EAA4E;QAC5E,2BAA2B;QAC3B,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,eAAe,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY,EAAE,KAAa;IACxD,MAAM,OAAO,GAAG,IAAI;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,QAAkB,EAAE,aAA4B,EAAE,KAAc;IACpF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,KAAK,aAAa,CAAC;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1E,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,UAAyB,EACzB,IAAY,EACZ,KAAa,EACb,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,aAAa,GAAkB,IAAI,CAAC;IAExC,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,IAAI,KAAK,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACjG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACjG,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,UAAU,CAAC,KAAwB,EAAE,IAAY,EAAE,KAAa;IACvE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,MAAM,IAAI,IAAI;YAAE,MAAM;QAC9B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,GAAG,CAAC,MAAM,IAAI,IAAI;gBAAE,MAAM;YAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAiB,EACjB,UAAgC,EAChC,KAAmB,EACnB,KAAa,EACb,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,IAAI,UAAU,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3F,OAAO;QACL,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;QACtD,UAAU,CAAC,KAAK,CAAC;QACjB,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC;KACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/cli/tmux-label.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The pane-border-label HUD: each pane's session headline, written into its tmux
+ * pane title and shown on the pane border. The `gmux watch` service repaints these
+ * on a loop; `Alt-g` toggles the service.
+ *
+ * Labels live in a per-pane `@gm_label` option, NOT `#{pane_title}`: a running
+ * agent sets its pane title via OSC escape sequences (a progress spinner), which
+ * would clobber a title we wrote. A `@`-prefixed user option is ours alone.
+ */
+import type { PaneEntry, PaneState } from "../core/gmux-types.js";
+import type { SessionRecord, SessionView, TmuxPane } from "../core/types.js";
+/**
+ * The label for a pane: `project — headline`, `project — gmux summaries loading…`
+ * while a refresh is in flight, `○ project` when resolved but not yet summarised,
+ * or empty for a pane with no resolvable agent. Not truncated — tmux clips it to
+ * the pane's width at render.
+ */
+export declare function paneLabel(view: SessionView | null, refreshing?: boolean): string;
+/** Phase 0 state glyph, shown in the daemon-driven border label ahead of the project name. */
+export declare function stateGlyph(state: PaneState): string;
+/**
+ * The daemon-driven border label for one pane: `<glyph> <project> — <headline>`.
+ * Zero sensing — reads only the model entry. Falls back to the pane's command
+ * when the cwd is empty, and to the raw state name until semantics arrive.
+ */
+export declare function snapshotLabel(entry: PaneEntry): string;
+/**
+ * Resolve a set of panes and write each one's `@gm_label`. Returns the resolved
+ * session records, so the caller can feed exactly the on-screen sessions to the
+ * summariser. No model calls here — labels render from the cache.
+ */
+export declare function labelPanes(panes: readonly TmuxPane[]): Promise<SessionRecord[]>;
+/** Label every pane in a window (or all windows when `windowId` is null). */
+export declare function paintLabels(windowId: string | null): Promise<SessionRecord[]>;
+/** Show the label borders across all windows, driven purely by the global option. */
+export declare function enableBorder(): Promise<void>;
+/**
+ * Hide the label borders. Sets the global off, then clears any per-window
+ * override (older versions set `pane-border-status` per window, which would
+ * override the global and keep the border up) and wipes every pane's `@gm_label`,
+ * so no headline lingers regardless of theme or leftover settings.
+ */
+export declare function disableBorder(): Promise<void>;
+/**
+ * `Alt-g`: toggle the background label agent. On when off (enable the borders,
+ * paint an immediate first frame for the current window, start the watcher); off
+ * when on (stop the watcher, hide the borders). "On" is the service running, not
+ * the border option — a theme may set the border for its own reasons.
+ */
+export declare function toggleWatch(windowId: string): Promise<"on" | "off">;

package/dist/cli/tmux-label.js

@@ -0,0 +1,146 @@
+/**
+ * The pane-border-label HUD: each pane's session headline, written into its tmux
+ * pane title and shown on the pane border. The `gmux watch` service repaints these
+ * on a loop; `Alt-g` toggles the service.
+ *
+ * Labels live in a per-pane `@gm_label` option, NOT `#{pane_title}`: a running
+ * agent sets its pane title via OSC escape sequences (a progress spinner), which
+ * would clobber a title we wrote. A `@`-prefixed user option is ours alone.
+ */
+import { execFile } from "node:child_process";
+import { basename } from "node:path";
+import { promisify } from "node:util";
+import { inProgressIds } from "../services/auto-summarize.js";
+import { prunePaneLinks } from "../services/pane-links.js";
+import { listAllPanes, listPanes } from "../services/tmux.js";
+import { resolvePanesLive } from "../services/tmux-resolve.js";
+import { attachSummaries, loadCachedRecords } from "../services/views.js";
+import { isWatchRunning, startWatch, stopWatch, } from "../services/watch.js";
+const run = promisify(execFile);
+/**
+ * Active pane emphasised, label centred. Forces its own foreground colour so it
+ * doesn't inherit a themed, dimmed `pane-border-style` (which would leave every
+ * inactive pane's label invisible).
+ */
+const PANE_BORDER_FORMAT = "#[align=centre]#[fg=colour252]#{?pane_active,#[reverse],} #{@gm_label} #[default]";
+/**
+ * The label for a pane: `project — headline`, `project — gmux summaries loading…`
+ * while a refresh is in flight, `○ project` when resolved but not yet summarised,
+ * or empty for a pane with no resolvable agent. Not truncated — tmux clips it to
+ * the pane's width at render.
+ */
+export function paneLabel(view, refreshing = false) {
+    if (!view)
+        return "";
+    const project = view.record.project ?? view.record.harness;
+    if (refreshing)
+        return `${project} — gmux summaries loading…`;
+    if (!view.summary)
+        return `○ ${project}`;
+    return `${project} — ${view.summary.headline}`;
+}
+/** Phase 0 state glyph, shown in the daemon-driven border label ahead of the project name. */
+export function stateGlyph(state) {
+    switch (state) {
+        case "working": return "●";
+        case "waiting": return "◔";
+        case "error": return "✗";
+        case "done": return "✓";
+        case "idle": return "○";
+    }
+}
+/**
+ * The daemon-driven border label for one pane: `<glyph> <project> — <headline>`.
+ * Zero sensing — reads only the model entry. Falls back to the pane's command
+ * when the cwd is empty, and to the raw state name until semantics arrive.
+ */
+export function snapshotLabel(entry) {
+    const name = entry.identity.cwd ? basename(entry.identity.cwd) : entry.identity.command;
+    const text = entry.semantics?.label ?? entry.state;
+    return `${stateGlyph(entry.state)} ${name} — ${text}`;
+}
+async function tmux(args) {
+    const { stdout } = await run("tmux", args);
+    return stdout;
+}
+/**
+ * Resolve a set of panes and write each one's `@gm_label`. Returns the resolved
+ * session records, so the caller can feed exactly the on-screen sessions to the
+ * summariser. No model calls here — labels render from the cache.
+ */
+export async function labelPanes(panes) {
+    const links = await prunePaneLinks(panes.map((p) => p.paneId));
+    const records = await loadCachedRecords();
+    const resolved = await resolvePanesLive(panes, records, links);
+    const present = resolved
+        .map((r) => r.record)
+        .filter((r) => r !== null);
+    const views = await attachSummaries(present);
+    const bySession = new Map(views.map((v) => [v.record.sessionId, v]));
+    const refreshing = await inProgressIds();
+    for (const { pane, record } of resolved) {
+        const view = record
+            ? bySession.get(record.sessionId) ?? { record, summary: null }
+            : null;
+        const isRefreshing = record ? refreshing.has(record.sessionId) : false;
+        await tmux(["set-option", "-p", "-t", pane.paneId, "@gm_label", paneLabel(view, isRefreshing)]);
+    }
+    return present;
+}
+/** Label every pane in a window (or all windows when `windowId` is null). */
+export async function paintLabels(windowId) {
+    const panes = windowId === null ? await listAllPanes() : await listPanes(windowId);
+    return labelPanes(panes);
+}
+async function windowIds() {
+    const out = await tmux(["list-windows", "-a", "-F", "#{window_id}"]);
+    return out.split("\n").map((line) => line.trim()).filter(Boolean);
+}
+/** Clear any per-window `pane-border-status` so the global option governs every window. */
+async function clearWindowOverrides() {
+    for (const w of await windowIds()) {
+        await tmux(["set-option", "-w", "-u", "-t", w, "pane-border-status"]);
+    }
+}
+/** Show the label borders across all windows, driven purely by the global option. */
+export async function enableBorder() {
+    await clearWindowOverrides();
+    await tmux(["set-option", "-g", "pane-border-format", PANE_BORDER_FORMAT]);
+    await tmux(["set-option", "-g", "pane-border-status", "top"]);
+}
+/**
+ * Hide the label borders. Sets the global off, then clears any per-window
+ * override (older versions set `pane-border-status` per window, which would
+ * override the global and keep the border up) and wipes every pane's `@gm_label`,
+ * so no headline lingers regardless of theme or leftover settings.
+ */
+export async function disableBorder() {
+    await tmux(["set-option", "-g", "pane-border-status", "off"]);
+    try {
+        await clearWindowOverrides();
+        for (const pane of await listAllPanes()) {
+            await tmux(["set-option", "-p", "-u", "-t", pane.paneId, "@gm_label"]);
+        }
+    }
+    catch {
+        // Best-effort cleanup; the global 'off' has already hidden the borders.
+    }
+}
+/**
+ * `Alt-g`: toggle the background label agent. On when off (enable the borders,
+ * paint an immediate first frame for the current window, start the watcher); off
+ * when on (stop the watcher, hide the borders). "On" is the service running, not
+ * the border option — a theme may set the border for its own reasons.
+ */
+export async function toggleWatch(windowId) {
+    if (await isWatchRunning()) {
+        await stopWatch();
+        await disableBorder();
+        return "off";
+    }
+    await enableBorder();
+    await paintLabels(windowId); // instant first paint, before the loop's first tick
+    await startWatch();
+    return "on";
+}
+//# sourceMappingURL=tmux-label.js.map

package/dist/cli/tmux-label.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Error taxonomy.
+ *
+ * Harness-engineering rule: an error message carries the fix inline. A user —
+ * or an agent — should never have to guess the next command. `fix` is printed
+ * directly beneath the message and included in `--json` output.
+ */
+export declare class GmuxError extends Error {
+    /** The exact command or action that resolves this error. */
+    readonly fix: string | undefined;
+    /** Process exit code. */
+    readonly exitCode: number;
+    constructor(message: string, options?: {
+        fix?: string;
+        exitCode?: number;
+    });
+}
+/** No session matched the given id or prefix. */
+export declare class SessionNotFoundError extends GmuxError {
+    constructor(id: string);
+}
+/** A prefix matched more than one session. */
+export declare class AmbiguousSessionError extends GmuxError {
+    constructor(id: string, matches: string[]);
+}
+/** A required external binary is missing. */
+export declare class MissingDependencyError extends GmuxError {
+    constructor(binary: string, fix: string);
+}
+/** A summary provider returned something unusable. */
+export declare class SummaryProviderError extends GmuxError {
+    constructor(provider: string, detail: string);
+}
+/**
+ * The chat provider behind `gmux ask` failed or said nothing.
+ *
+ * The fix names the provider that actually failed. It used to hardcode
+ * `claude -p`, which told a user who had configured Codex to go and test a
+ * binary they may not even have — non-negotiable #5 asks for the fix to the
+ * problem in front of you, not to the common case.
+ */
+export declare class AskProviderError extends GmuxError {
+    constructor(provider: string, detail: string);
+}
+/**
+ * No provider is configured — because the user chose "none" in `gmux setup`.
+ *
+ * Distinct from a missing binary, and it must stay distinct: this is a choice
+ * being honored, not a fault. The fix says how to change your mind, not how to
+ * install something.
+ */
+export declare class NoProviderError extends GmuxError {
+    constructor(what: string);
+}