@gigaflow/gmux 0.15.0

package/dist/cli/format.js

@@ -0,0 +1,242 @@
+/**
+ * Rendering.
+ *
+ * Colour is applied only when stdout is a TTY and NO_COLOR is unset, so piping
+ * `gmux ls` into another program — or into an agent — yields clean text.
+ */
+import { cell, relativeAge, truncate, wrapText } from "../core/text.js";
+/** Colour is off unless the user leaves it on — a `NO_COLOR`/`dumb` opt-out we honour everywhere. */
+const colorEnabled = () => !process.env.NO_COLOR && process.env.TERM !== "dumb";
+const useColor = () => process.stdout.isTTY === true && colorEnabled();
+const wrap = (code) => (text) => (useColor() ? `[${code}m${text}` : text);
+export const dim = wrap("2");
+export const bold = wrap("1");
+export const cyan = wrap("36");
+export const yellow = wrap("33");
+export const red = wrap("31");
+export const green = wrap("32");
+/**
+ * Colour forced on for output we KNOW an ANSI renderer consumes, even off a TTY.
+ *
+ * The picker's preview command writes to a pipe, so `process.stdout.isTTY` is
+ * false and `useColor()` above is too — yet fzf renders that pipe with `--ansi`.
+ * These variants drop only the TTY test, so the pane can carry colour while
+ * `NO_COLOR` and `TERM=dumb` still turn it off. Used solely by `preview.ts`; the
+ * card and `gmux ls`/`gmux show` keep the gated `dim`/`cyan`/`bold` and stay clean
+ * when piped into another program.
+ */
+const wrapForced = (code) => (text) => colorEnabled() ? `[${code}m${text}` : text;
+export const paneCyan = wrapForced("36");
+export const paneBold = wrapForced("1");
+export const paneDim = wrapForced("2");
+/** Marks a session that stopped mid-task — usually the one you want to resume. */
+const MID_TASK = "⚠";
+/**
+ * Marks a row whose summary has not been written yet.
+ *
+ * One column, so a row that gains a summary does not shift the layout. It used
+ * to be a dim `~`, which was invisible next to the yellow `⚠` — and now that
+ * these rows are actively being summarized in the background, "pending" is a
+ * state worth seeing.
+ */
+const NO_SUMMARY = "○";
+/** Marks a row whose summary is being written right now, by the background worker. */
+const IN_PROGRESS = "◐";
+const MARKERS = [
+    {
+        icon: MID_TASK,
+        color: yellow,
+        label: "ended mid-task",
+        matches: (view) => view.record.endedMidTask === true,
+        counted: false,
+    },
+    {
+        icon: IN_PROGRESS,
+        color: green,
+        label: "summarizing now",
+        matches: (view, inProgress) => !view.summary && inProgress.has(view.record.sessionId),
+        counted: true,
+    },
+    {
+        icon: NO_SUMMARY,
+        color: cyan,
+        label: "no summary yet",
+        matches: (view, inProgress) => !view.summary && !inProgress.has(view.record.sessionId),
+        counted: true,
+    },
+];
+/** Wide enough to read as separate entries, narrow enough to hold one line. */
+const KEY_GAP = "   ";
+const keyEntry = (marker, label) => `${marker.color(marker.icon)} ${dim(label)}`;
+/** "repo/branch", or just "repo" when the branch adds nothing. */
+export function sessionLabel(record) {
+    const project = record.project ?? "?";
+    return record.gitBranch ? `${project}/${record.gitBranch}` : project;
+}
+const WHERE_WIDTH = 28;
+/** Never squeeze the description below this, however narrow the terminal. */
+const MIN_TEXT_WIDTH = 24;
+/** The description shown for a session: summary first, and never blank. */
+function rowText(view) {
+    const { record, summary } = view;
+    return summary?.headline ?? record.title ?? record.lastUserPrompt ?? "(no content)";
+}
+const NONE = new Set();
+/** The fixed-width columns before the description, coloured and plain. */
+function rowPrefix(view, now, inProgress = NONE) {
+    const { record, summary } = view;
+    const id = record.sessionId.slice(0, 8);
+    const age = cell(relativeAge(record.updatedAt, now), 4);
+    const where = cell(sessionLabel(record), WHERE_WIDTH);
+    const flag = record.endedMidTask ? yellow(MID_TASK) : " ";
+    const mark = summary
+        ? " "
+        : inProgress.has(record.sessionId)
+            ? green(IN_PROGRESS)
+            : cyan(NO_SUMMARY);
+    return {
+        colored: `${dim(id)} ${dim(age)} ${flag}${mark} ${cyan(where)} `,
+        // Measured from the plain text: colour codes take no screen columns.
+        width: id.length + 1 + age.length + 1 + 2 + 1 + where.length + 1,
+    };
+}
+/**
+ * One row, on exactly one line.
+ *
+ * Used by the picker, where a session must occupy a single line — fzf maps lines
+ * back to session ids, so a wrapped row would break selection.
+ */
+export function formatRow(view, now = new Date(), inProgress = NONE) {
+    return `${rowPrefix(view, now, inProgress).colored}${truncate(rowText(view), 72)}`;
+}
+/**
+ * One row of `gmux ls`, wrapped to the terminal so the whole description is
+ * readable rather than chopped off at the right edge. Continuation lines are
+ * indented to sit under the description column.
+ *
+ * Pass `width: Infinity` when the output is not a terminal: piped output should
+ * be one line per session, so `gmux ls | grep` behaves.
+ */
+export function formatRowLines(view, now = new Date(), width = terminalWidth(), inProgress = NONE) {
+    const prefix = rowPrefix(view, now, inProgress);
+    const text = rowText(view);
+    if (!Number.isFinite(width)) {
+        return [`${prefix.colored}${text}`]; // Piped: one line, nothing lost.
+    }
+    const available = width - prefix.width;
+    // On a terminal too narrow to hold the columns AND a readable description,
+    // giving the description a sliver of a column would just overflow anyway.
+    // Drop it onto its own indented lines instead.
+    if (available < MIN_TEXT_WIDTH) {
+        const indent = "  ";
+        return [
+            prefix.colored.trimEnd(),
+            ...wrapText(text, Math.max(MIN_TEXT_WIDTH, width - indent.length)).map((line) => `${indent}${line}`),
+        ];
+    }
+    const [first = "", ...rest] = wrapText(text, available);
+    const indent = " ".repeat(prefix.width);
+    return [`${prefix.colored}${first}`, ...rest.map((line) => `${indent}${dim(line)}`)];
+}
+/**
+ * The key under the list. Only mentions markers that actually appear, so a fully
+ * summarized list carries no footer at all.
+ */
+export function formatLegend(views, inProgress = NONE) {
+    return MARKERS.flatMap((marker) => {
+        const on = views.filter((view) => marker.matches(view, inProgress)).length;
+        if (on === 0)
+            return [];
+        return [keyEntry(marker, marker.counted ? `${marker.label} (${on})` : marker.label)];
+    }).join(KEY_GAP);
+}
+/**
+ * The key for a LIVE list: every marker, always, and never a count.
+ *
+ * The picker renders the same markers `gmux ls` does, so it needs the same
+ * explanation — but not `formatLegend`. fzf sets `--header` once, at spawn:
+ * `ctrl-r` reloads the item list and leaves the header untouched. Counts baked
+ * in there freeze at open and are wrong after the first refresh, and a key
+ * listing "only the markers present" goes stale the moment a refresh brings in
+ * one that wasn't. ctrl-r is precisely when both change.
+ *
+ * So: nothing here depends on the list. A stale key is worse than a fixed one —
+ * absent an explanation you go looking, given a wrong one you don't. The cost is
+ * one line naming `○` on a list that has none.
+ */
+export function formatMarkerKey() {
+    return MARKERS.map((marker) => keyEntry(marker, marker.label)).join(KEY_GAP);
+}
+/** Terminal width, or a sane default when we cannot tell. */
+export function terminalWidth() {
+    return process.stdout.columns && process.stdout.columns > 0 ? process.stdout.columns : 100;
+}
+/** The detail card shown by `gmux show` and in the picker's preview pane. */
+export function formatCard(view, now = new Date()) {
+    const { record, summary } = view;
+    const lines = [];
+    lines.push(bold(sessionLabel(record)), dim(`${record.harness} · ${record.sessionId} · ${relativeAge(record.updatedAt, now)} ago`));
+    lines.push("");
+    if (summary) {
+        // Widening zoom: the headline names the work, the overview frames it, the
+        // summary reorients you. `headline` is the one field parsing guarantees, so
+        // it stands in for the overview when that is empty.
+        lines.push(bold("HEADLINE"), indent(summary.headline), "");
+        if (summary.overview)
+            lines.push(bold("OVERVIEW"), indent(summary.overview), "");
+        if (summary.summary)
+            lines.push(bold("SUMMARY"), indent(summary.summary), "");
+        if (summary.landed)
+            lines.push(bold("RECENT WORK"), indent(summary.landed), "");
+        if (summary.open)
+            lines.push(bold("STILL OPEN"), indent(summary.open), "");
+        if (summary.nextStep)
+            lines.push(bold("NEXT STEP"), indent(green(summary.nextStep)), "");
+    }
+    else {
+        lines.push(dim("No summary yet."), dim(`Run: gmux summarize ${record.sessionId.slice(0, 8)}`), "");
+        if (record.title)
+            lines.push(bold("TITLE (recorded at session start)"), indent(record.title), "");
+    }
+    if (record.lastUserPrompt) {
+        lines.push(bold("LAST THING YOU SAID"), indent(`"${truncate(record.lastUserPrompt, 240)}"`), "");
+    }
+    if (record.filesTouched.length > 0) {
+        const shown = record.filesTouched.slice(0, 6);
+        const extra = record.filesTouched.length - shown.length;
+        lines.push(bold("FILES TOUCHED"), ...shown.map((f) => `  ${f}`), ...(extra > 0 ? [dim(`  … and ${extra} more`)] : []), "");
+    }
+    if (record.prLinks.length > 0) {
+        const shown = record.prLinks.slice(0, 8);
+        const extra = record.prLinks.length - shown.length;
+        lines.push(bold("PULL REQUESTS"), ...shown.map((pr) => `  #${pr.number}  ${pr.url}`), ...(extra > 0 ? [dim(`  … and ${extra} more`)] : []), "");
+    }
+    const facts = [`${record.messageCount} messages`, `${record.userPromptCount} prompts`];
+    if (record.endedMidTask)
+        facts.push(yellow("ended mid-task"));
+    if (record.lastToolFailure)
+        facts.push(red("last command failed"));
+    lines.push(dim(facts.join("  ·  ")));
+    if (record.cwd)
+        lines.push(dim(record.cwd));
+    return lines.join("\n");
+}
+/**
+ * Two spaces under a heading — the card's only body indent.
+ *
+ * Exported for the preview's chat half, whose speaker bodies sit under `you` and
+ * `gmux` exactly as the card's text sits under `WHERE IT LANDED`. Both halves share
+ * one pane, so a second indent idiom would show up as two columns that almost
+ * line up.
+ */
+export function indent(text) {
+    return text
+        .split("\n")
+        .map((line) => `  ${line}`)
+        .join("\n");
+}
+/** Stable JSON envelope. Everything machine-readable goes through here. */
+export function jsonEnvelope(schemaVersion, data) {
+    return JSON.stringify({ schemaVersion, data }, null, 2);
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/cli/gmux-render.d.ts

@@ -0,0 +1,11 @@
+import type { HostPressure, WorkspaceSnapshot } from "../core/gmux-types.js";
+export declare function formatBytes(n: number): string;
+export declare function relativeTime(ts: number, now: number): string;
+export declare function unattributedLine(host: HostPressure | null): string | null;
+export interface RenderCockpitOptions {
+    width?: number;
+    stale?: {
+        ageMs: number;
+    } | null;
+}
+export declare function renderCockpit(snapshot: WorkspaceSnapshot, now: number, widthOrOpts?: number | RenderCockpitOptions): string[];

package/dist/cli/gmux-render.js

@@ -0,0 +1,60 @@
+import { basename } from "node:path";
+import { stateGlyph } from "./tmux-label.js";
+export function formatBytes(n) {
+    const gb = n / (1024 ** 3);
+    if (gb >= 1)
+        return `${gb.toFixed(1)} GB`;
+    const mb = n / (1024 ** 2);
+    return `${mb.toFixed(0)} MB`;
+}
+export function relativeTime(ts, now) {
+    const s = Math.max(0, Math.round((now - ts) / 1000));
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.round(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    return `${Math.round(m / 60)}h ago`;
+}
+function paneRow(e, now) {
+    const name = e.identity.cwd ? basename(e.identity.cwd) : e.identity.command;
+    const label = e.semantics?.label ?? e.state;
+    const mem = e.resources ? formatBytes(e.resources.perPaneRss) : "—";
+    const activity = e.lastActivityTs ? relativeTime(e.lastActivityTs, now) : "—";
+    return `${stateGlyph(e.state)} ${name}  ${label}  [${mem}]  ${activity}`;
+}
+export function unattributedLine(host) {
+    if (!host || host.unattributed <= 0)
+        return null;
+    return `  unattributed: ${formatBytes(host.unattributed)} (source outside tracked panes)`;
+}
+/** Normalizes the legacy positional `width` arg and the newer options object into one shape. */
+function normalizeCockpitOptions(widthOrOpts) {
+    if (typeof widthOrOpts === "number")
+        return { width: widthOrOpts, stale: null };
+    return { width: widthOrOpts?.width ?? 120, stale: widthOrOpts?.stale ?? null };
+}
+export function renderCockpit(snapshot, now, widthOrOpts) {
+    const { stale } = normalizeCockpitOptions(widthOrOpts);
+    const lines = [];
+    if (stale)
+        lines.push(`⚠ daemon not connected — snapshot ${relativeTime(now - stale.ageMs, now)}`);
+    for (const g of snapshot.guardianLog.slice(-3))
+        lines.push(`⚠ ${g.message}`);
+    if (snapshot.guardianLog.length > 0)
+        lines.push("");
+    lines.push(`gmux — ${snapshot.panes.length} panes`);
+    // Sort panes by memory descending if any have resources
+    const hasResources = snapshot.panes.some((p) => p.resources);
+    const sortedPanes = hasResources
+        ? [...snapshot.panes].sort((a, b) => (b.resources?.perPaneRss ?? 0) - (a.resources?.perPaneRss ?? 0))
+        : snapshot.panes;
+    for (const e of sortedPanes)
+        lines.push(paneRow(e, now));
+    // Add unattributed line if present
+    const unattr = unattributedLine(snapshot.hostPressure);
+    if (unattr)
+        lines.push(unattr);
+    return lines;
+}
+//# sourceMappingURL=gmux-render.js.map

package/dist/cli/gmux-render.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * gmux — browse, search and resume agent coding sessions.
+ *
+ * Every read command supports `--json`. That is deliberate: gmux is a tool
+ * for agents as much as for people, and an agent can only use what it can parse.
+ */
+export {};

package/dist/cli/main.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+/**
+ * gmux — browse, search and resume agent coding sessions.
+ *
+ * Every read command supports `--json`. That is deliberate: gmux is a tool
+ * for agents as much as for people, and an agent can only use what it can parse.
+ */
+import { createRequire } from "node:module";
+import { Command } from "commander";
+import { GmuxError } from "../core/errors.js";
+import { maybeAutoSummarize } from "../services/auto-summarize.js";
+import { configExists, shouldRunSetupWizard } from "../services/config.js";
+import { registerAsk } from "./commands/ask.js";
+import { registerAskCancel } from "./commands/__ask-cancel.js";
+import { registerAskRun } from "./commands/__ask-run.js";
+import { registerAskSend } from "./commands/__ask-send.js";
+import { registerAutoSummarizeWorker } from "./commands/auto.js";
+import { registerCockpit } from "./commands/cockpit.js";
+import { registerDaemon } from "./commands/daemon.js";
+import { registerDoctor } from "./commands/doctor.js";
+import { registerSetup, runSetupWizard } from "./commands/setup.js";
+import { registerGrep } from "./commands/grep.js";
+import { registerIndex } from "./commands/index-cmd.js";
+import { registerLs } from "./commands/ls.js";
+import { registerOverlay } from "./commands/overlay.js";
+import { registerWatch } from "./commands/watch.js";
+import { registerPick } from "./commands/pick.js";
+import { registerPickerRows } from "./commands/picker-rows.js";
+import { registerPreviewCard } from "./commands/__preview-card.js";
+import { registerResume } from "./commands/resume.js";
+import { registerRun } from "./commands/run.js";
+import { registerShow } from "./commands/show.js";
+import { registerSummarize } from "./commands/summarize.js";
+import { registerTmux } from "./commands/tmux.js";
+import { red, dim } from "./format.js";
+/**
+ * Read the version from package.json rather than hardcoding it.
+ *
+ * A hardcoded string silently drifts on every release — v0.1.1 shipped
+ * reporting `0.1.0`. Resolves to the package root from both `dist/cli/` (built)
+ * and `src/cli/` (via tsx).
+ */
+const { version } = createRequire(import.meta.url)("../../package.json");
+const program = new Command();
+program
+    .name("gmux")
+    .description("Browse, search and resume your AI coding agent sessions.")
+    .version(version)
+    .option("--no-color", "disable coloured output")
+    .option("--no-auto-summarize", "do not summarize recent sessions in the background")
+    .hook("preAction", async (thisCommand, actionCommand) => {
+    if (thisCommand.opts()["color"] === false)
+        process.env.NO_COLOR = "1";
+    /**
+     * First run: ask who to call, before spending anything on calling them.
+     *
+     * Every gate here is load-bearing. `gmux ls --json` is an interface agents
+     * call, and a version of it that can block on a human prompt is a broken
+     * interface whatever it prints — so no TTY, or `--json`, or a `__`-prefixed
+     * internal command means we say nothing and behave exactly as gmux did before
+     * config existed: autodetect and carry on.
+     */
+    const gate = {
+        hasConfig: await configExists(),
+        isTty: process.stdin.isTTY === true && process.stdout.isTTY === true,
+        isJson: actionCommand.opts()["json"] === true,
+        commandName: actionCommand.name(),
+    };
+    if (shouldRunSetupWizard(gate))
+        await runSetupWizard({ firstRun: true });
+})
+    /**
+     * Keep the ten most recent sessions summarized — in the background, always.
+     *
+     * This runs in `postAction`, after the command has already written its output,
+     * so `gmux ls` still returns in ~60ms. The work itself is handed to a detached
+     * child that outlives us (see services/auto-summarize.ts); we only decide, and
+     * we tell the user on STDERR so `gmux ls --json` stays machine-readable.
+     *
+     * The worker command is exempt, or it would spawn a copy of itself forever.
+     */
+    .hook("postAction", async (thisCommand, actionCommand) => {
+    /**
+     * `__`-prefixed commands are the internals gmux spawns at itself, and none of
+     * them may decide anything here — by prefix, not by a list that the next
+     * hidden command has to remember to join. `__auto-summarize` would fork a
+     * copy of itself; `__picker-rows` runs its own pass first; `__ask-send`
+     * inherits fzf's env, so GMUX_CHILD is unset and every question typed
+     * into the chat pane would fork a summarize decision from inside fzf —
+     * whose `notify` writes to the stderr fzf is painting. Same convention
+     * `shouldRunSetupWizard` already uses.
+     */
+    if (actionCommand.name().startsWith("__"))
+        return;
+    // `ls` and `pick` run the pass themselves, BEFORE rendering, so they can
+    // mark the rows they just kicked off with ◐. Running it again here would be
+    // a wasted decision — and for `pick` a badly timed one: its action ends in
+    // `resumeSession`, which waits on your harness, so this hook would not fire
+    // until you quit Claude Code.
+    if (actionCommand.name() === "ls" || actionCommand.name() === "pick")
+        return;
+    await maybeAutoSummarize({
+        enabled: thisCommand.opts()["autoSummarize"] !== false,
+        notify: (message) => process.stderr.write(`${dim(message)}\n`),
+    });
+});
+registerLs(program);
+registerShow(program);
+registerGrep(program);
+registerAsk(program);
+registerResume(program);
+registerSummarize(program);
+registerSetup(program);
+registerIndex(program);
+registerDoctor(program);
+registerAutoSummarizeWorker(program);
+registerPickerRows(program);
+registerPreviewCard(program);
+registerAskSend(program);
+registerAskRun(program);
+registerAskCancel(program);
+registerPick(program); // Also the default action when `gmux` is run bare.
+registerOverlay(program);
+registerCockpit(program);
+registerTmux(program);
+registerRun(program);
+registerWatch(program);
+registerDaemon(program);
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        if (error instanceof GmuxError) {
+            process.stderr.write(`${red("error")} ${error.message}\n`);
+            if (error.fix)
+                process.stderr.write(`${dim("fix")}   ${error.fix}\n`);
+            process.exit(error.exitCode);
+        }
+        process.stderr.write(`${red("error")} ${error.message}\n`);
+        process.exit(1);
+    }
+}
+void main();
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/overlay-ask.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The ask box that sits at the bottom of the ctrl-g overlay. Pure string
+ * layout — the command positions it on the popup and drives the keystrokes.
+ */
+/** Rows the ask box occupies at the bottom of the overlay. */
+export declare const ASK_BOX_HEIGHT = 3;
+/**
+ * The three lines of the ask box (top border, the input line, bottom border),
+ * each clipped to `width`. A long input scrolls so its tail stays visible.
+ */
+export declare function askBoxLines(input: string, width: number): string[];
+/** The cursor's column (1-based) inside the input line, clamped to the field. */
+export declare function askCursorColumn(input: string, width: number): number;

package/dist/cli/overlay-ask.js

@@ -0,0 +1,32 @@
+/**
+ * The ask box that sits at the bottom of the ctrl-g overlay. Pure string
+ * layout — the command positions it on the popup and drives the keystrokes.
+ */
+/** Rows the ask box occupies at the bottom of the overlay. */
+export const ASK_BOX_HEIGHT = 3;
+const LABEL = "ask · Enter send · ^R refresh · ^G/Esc close";
+/**
+ * The three lines of the ask box (top border, the input line, bottom border),
+ * each clipped to `width`. A long input scrolls so its tail stays visible.
+ */
+export function askBoxLines(input, width) {
+    const w = Math.max(12, Math.floor(width));
+    const inner = w - 2; // between the │ │ borders
+    const dashes = Math.max(0, inner - LABEL.length - 3);
+    const top = `╭─ ${LABEL} ${"─".repeat(dashes)}╮`.slice(0, w);
+    const field = inner - 2; // inside "│ … │"
+    const prompt = `> ${input}`;
+    const shown = prompt.length > field ? prompt.slice(prompt.length - field) : prompt;
+    const mid = `│ ${shown.padEnd(field, " ")} │`.slice(0, w);
+    const bottom = `╰${"─".repeat(inner)}╯`.slice(0, w);
+    return [top, mid, bottom];
+}
+/** The cursor's column (1-based) inside the input line, clamped to the field. */
+export function askCursorColumn(input, width) {
+    const inner = Math.max(12, Math.floor(width)) - 2;
+    const field = inner - 2;
+    const prompt = `> ${input}`;
+    const offset = Math.min(prompt.length, field);
+    return 3 + offset; // "│ " is 2 cols, field starts at col 3
+}
+//# sourceMappingURL=overlay-ask.js.map

package/dist/cli/overlay-ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-ask.js","sourceRoot":"","sources":["../../src/cli/overlay-ask.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,KAAK,GAAG,8CAA8C,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,KAAa;IACtD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,0BAA0B;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,iBAAiB;IAC1C,MAAM,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,MAAM,GAAG,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAa;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,wCAAwC;AAC7D,CAAC"}

package/dist/cli/overlay.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Draw every pane's summary card in place. Pure: given resolved cells and the
+ * clock, produce one string of ANSI cursor moves that paints a full-screen
+ * overlay. The command layer supplies the cells and the terminal; nothing here
+ * reads tmux, stdin, or the clock on its own.
+ *
+ * A compact sibling of `formatCard`: same summary fields and section names,
+ * sized to a rectangle with a degradation ladder — full card, then title +
+ * what-landed, then just the title, then a muted placeholder for a pane with no
+ * agent. Monochrome: the structure is carried by layout, so it survives a pane
+ * that cannot render colour.
+ */
+import type { SessionView, TmuxPane } from "../core/types.js";
+export interface OverlayCell {
+    pane: TmuxPane;
+    /** null when the pane runs no resolvable agent. */
+    view: SessionView | null;
+    /** True while a background refresh for this session is in flight. */
+    refreshing: boolean;
+    /** A broadcast question is being answered for this pane's session right now. */
+    asking?: boolean;
+    /** This pane's own answer to the current broadcast question, if it has landed. */
+    answer?: string | null;
+}
+export declare function cellLines(cell: OverlayCell, width: number, height: number, now: Date): string[];
+export declare function renderOverlay(cells: readonly OverlayCell[], now?: Date): string;