@gigaflow/gmux 0.15.0

package/dist/cli/commands/setup.js

@@ -0,0 +1,200 @@
+/**
+ * `gmux setup` — choose the harness gmux calls for summaries and `gmux ask`.
+ *
+ * The wizard is the only place gmux asks a question. Everything it writes
+ * is a choice a human made, which is why it goes to the config dir rather than
+ * the cache — see core/paths.ts.
+ */
+import { createInterface } from "node:readline/promises";
+import { GmuxError } from "../../core/errors.js";
+import { DEFAULT_GMUX_CONFIG } from "../../core/gmux-types.js";
+import { configPath } from "../../core/paths.js";
+import { CONFIG_VERSION } from "../../core/types.js";
+import { CUSTOM_PROVIDER_ID, PROVIDERS, onPath, toChoice, } from "../../services/providers.js";
+import { parseCommand, readConfig, writeConfig } from "../../services/config.js";
+import { bold, cyan, dim, green, yellow } from "../format.js";
+function providerOption(spec) {
+    const installed = onPath(spec.binary);
+    return {
+        label: spec.displayName,
+        detail: installed ? `${spec.summaryArgv.join(" ")}` : `not installed — ${spec.install}`,
+        choose: async () => toChoice(spec),
+    };
+}
+/**
+ * The menu.
+ *
+ * Every catalog provider is listed, installed or not, and an uninstalled one is
+ * still selectable — you might be about to install it, and a wizard that hides
+ * the option you came for is a wizard that sends you to the docs. The line says
+ * what's missing and how to get it.
+ */
+export function buildOptions() {
+    const options = PROVIDERS.map(providerOption);
+    options.push({
+        label: "Something else",
+        detail: "any command that reads a prompt on stdin and writes text",
+        choose: async (rl) => {
+            for (;;) {
+                const raw = (await rl.question(`\n  command (e.g. ${dim("gemini -p")}): `)).trim();
+                const command = parseCommand(raw);
+                if (command.length > 0)
+                    return { id: CUSTOM_PROVIDER_ID, command };
+                process.stdout.write(`  ${yellow("A command is required.")}\n`);
+            }
+        },
+    });
+    options.push({
+        label: "Nothing — make no model calls",
+        detail: "no summaries, no `gmux ask`. `gmux ls` still works on hard facts alone",
+        choose: async () => null,
+    });
+    return options;
+}
+/**
+ * The wizard is a conversation, and it needs a terminal to have one.
+ *
+ * Not politeness — correctness. `readline/promises` drops lines that arrive
+ * while no `question()` is pending, which is every gap between our questions.
+ * Piped input therefore loses answers and then blocks on a line that will never
+ * come, and the process exits 0 having written nothing: the worst possible
+ * failure, because it looks like success.
+ *
+ * A TTY has no such gap — a human types *after* the prompt. So we require one,
+ * and point anyone scripting this at the two things that do work headlessly.
+ */
+function requireTty() {
+    if (process.stdin.isTTY === true && process.stdout.isTTY === true)
+        return;
+    throw new GmuxError("`gmux setup` needs an interactive terminal.", {
+        fix: `Run it in a terminal. To configure without one, set GMUX_SUMMARY_CMD='claude -p', or write ${configPath()} directly.`,
+        exitCode: 3,
+    });
+}
+/** Read a 1-based menu choice, re-asking until it is valid. */
+async function askChoice(rl, options, fallback) {
+    for (;;) {
+        const raw = (await rl.question(`\nwhich? [1-${options.length}, default ${fallback}] `)).trim();
+        if (raw === "")
+            return fallback;
+        const n = Number.parseInt(raw, 10);
+        if (Number.isFinite(n) && n >= 1 && n <= options.length)
+            return n;
+        process.stdout.write(`  ${yellow(`Enter a number between 1 and ${options.length}.`)}\n`);
+    }
+}
+async function askYesNo(rl, question, fallback) {
+    const hint = fallback ? "Y/n" : "y/N";
+    for (;;) {
+        const raw = (await rl.question(`${question} [${hint}] `)).trim().toLowerCase();
+        if (raw === "")
+            return fallback;
+        if (["y", "yes"].includes(raw))
+            return true;
+        if (["n", "no"].includes(raw))
+            return false;
+    }
+}
+/**
+ * The one place gmux discloses that gmux can act on its own.
+ *
+ * Every other config choice here is passive — which harness to call, whether
+ * to summarize in the background. This is the one that reaches into a pane
+ * and types something, so it gets its own prominent prompt rather than
+ * riding along inside another question, and an explicit default rather than
+ * a silent one: pressing enter is still a choice, just the one most people
+ * want (see DEFAULT_GMUX_CONFIG.guardianPolicy).
+ */
+async function askGuardianPolicy(rl) {
+    process.stdout.write(`\n${bold("The gmux memory guardian")}\n${dim('It can type a "checkpoint and pause" message INTO your agent panes when host memory\n' +
+        "runs critically low. This is the one action gmux takes on your behalf.")}\n\n`);
+    process.stdout.write(`  1. ${bold("auto")}     ${dim("broadcast the checkpoint message automatically (default)")}\n`);
+    process.stdout.write(`  2. ${bold("notify")}   ${dim("tell me, do not type anything")}\n`);
+    process.stdout.write(`  3. ${bold("off")}      ${dim("never act")}\n`);
+    for (;;) {
+        const raw = (await rl.question(`\nwhich? [1-3, default 1] `)).trim();
+        if (raw === "" || raw === "1")
+            return "auto";
+        if (raw === "2")
+            return "notify";
+        if (raw === "3")
+            return "off";
+        process.stdout.write(`  ${yellow("Enter 1, 2, or 3.")}\n`);
+    }
+}
+/**
+ * The wizard itself. Returns the config it wrote.
+ *
+ * Takes its own readline interface so the first-run caller and `gmux setup` share
+ * one implementation and one teardown.
+ */
+export async function runSetupWizard(options = {}) {
+    requireTty();
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const existing = await readConfig();
+        if (options.firstRun) {
+            process.stdout.write(`\n${bold("Welcome to gmux.")}\n${dim("One question before we start: summaries cost model calls, so gmux won't make any until you say who to call.")}\n`);
+        }
+        else {
+            process.stdout.write(`\n${bold("gmux setup")}\n`);
+        }
+        if (existing) {
+            const current = existing.provider
+                ? existing.provider.command.join(" ")
+                : "nothing — no model calls";
+            process.stdout.write(`${dim(`currently: ${current}`)}\n`);
+        }
+        process.stdout.write(`\n${bold("Which harness should gmux use for model calls?")}\n`);
+        process.stdout.write(`${dim("Used to summarize where your sessions landed, and to answer `gmux ask`.")}\n\n`);
+        const menu = buildOptions();
+        // Default to the first installed provider — the answer most people want,
+        // and the one that reproduces gmux's behavior before config existed.
+        const firstInstalled = menu.findIndex((_, i) => {
+            const spec = PROVIDERS[i];
+            return spec ? onPath(spec.binary) : false;
+        });
+        const fallback = firstInstalled === -1 ? menu.length : firstInstalled + 1;
+        for (const [i, option] of menu.entries()) {
+            const spec = PROVIDERS[i];
+            const installed = spec ? onPath(spec.binary) : true;
+            const mark = spec ? (installed ? green("✓") : dim("○")) : dim(" ");
+            process.stdout.write(`  ${mark} ${String(i + 1)}. ${bold(option.label)}  ${dim(option.detail)}\n`);
+        }
+        const picked = menu[(await askChoice(rl, menu, fallback)) - 1];
+        const provider = await picked.choose(rl);
+        if (existing?.gmux) {
+            process.stdout.write(`${dim(`guardian currently: ${existing.gmux.guardianPolicy}`)}\n`);
+        }
+        const guardianPolicy = await askGuardianPolicy(rl);
+        // Only worth asking when there is something to call. "None" already answered it.
+        const autoSummarize = provider
+            ? await askYesNo(rl, `\n${bold("Keep your 20 most recent sessions summarized in the background?")}\n${dim("This spends tokens as you work. gmux ls stays instant either way.")}\n`, true)
+            : false;
+        const config = {
+            version: CONFIG_VERSION,
+            provider,
+            autoSummarize,
+            gmux: { ...DEFAULT_GMUX_CONFIG, guardianPolicy },
+        };
+        await writeConfig(config);
+        process.stdout.write(`\n${green("✓")} ${dim(`saved to ${configPath()}`)}\n`);
+        process.stdout.write(provider
+            ? `${dim("gmux will call")} ${cyan(provider.command.join(" "))}${dim(". Change it any time with `gmux setup`.")}\n\n`
+            : `${dim("gmux will make no model calls. Run `gmux setup` if you change your mind.")}\n\n`);
+        process.stdout.write(`${dim(`guardian: ${guardianPolicy}. Change it any time with \`gmux setup\`.`)}\n\n`);
+        return config;
+    }
+    finally {
+        rl.close();
+    }
+}
+export function registerSetup(program) {
+    program
+        .command("setup")
+        .description("choose the harness gmux uses for model calls (summaries and `gmux ask`)")
+        .action(async () => {
+        await runSetupWizard();
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/commands/setup.js.map

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

package/dist/cli/commands/show.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerShow(program: Command): void;

package/dist/cli/commands/show.js

@@ -0,0 +1,24 @@
+import { SCHEMA_VERSION } from "../../core/types.js";
+import { loadRecords } from "../../services/views.js";
+import { resolveSession } from "../../services/resolve.js";
+import { readSummary } from "../../services/summarize.js";
+import { formatCard, jsonEnvelope } from "../format.js";
+export function registerShow(program) {
+    program
+        .command("show <id>")
+        .description("show the full context card for one session (id or unique prefix)")
+        .option("--json", "emit JSON for scripts and agents")
+        .action(async (id, options) => {
+        // Naming a session explicitly means you want it, whatever kind it is —
+        // including the ones `gmux ls` hides by default.
+        const records = await loadRecords({ includeSidechains: true, includeAutomated: true });
+        const record = resolveSession(records, id);
+        const summary = await readSummary(record);
+        if (options.json) {
+            process.stdout.write(`${jsonEnvelope(SCHEMA_VERSION, { record, summary })}\n`);
+            return;
+        }
+        process.stdout.write(`${formatCard({ record, summary })}\n`);
+    });
+}
+//# sourceMappingURL=show.js.map

package/dist/cli/commands/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC,QAAQ,EAAE,kCAAkC,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAA2B,EAAE,EAAE;QACxD,uEAAuE;QACvE,iDAAiD;QACjD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/summarize.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerSummarize(program: Command): void;

package/dist/cli/commands/summarize.js

@@ -0,0 +1,59 @@
+import { GmuxError, NoProviderError } from "../../core/errors.js";
+import { loadRecords } from "../../services/views.js";
+import { resolveSession } from "../../services/resolve.js";
+import { defaultSummaryProvider, summarizeBatch } from "../../services/summarize.js";
+import { bold, dim, green, yellow } from "../format.js";
+export function registerSummarize(program) {
+    program
+        .command("summarize [id]")
+        .description("write summaries of where sessions landed (cached; only regenerates when a session changed)")
+        .option("-r, --recent <count>", "summarize the N most recent sessions", "20")
+        .option("--all", "summarize every session (can be expensive — you have a lot)")
+        .option("--force", "regenerate even if a cached summary is still current")
+        .option("--harness <id>", "only this harness")
+        .option("-p, --project <name>", "only sessions whose project matches")
+        .action(async (id, options) => {
+        // Two different "no", and they need two different answers: "you chose
+        // none" is a decision to revisit, "it isn't installed" is a thing to fix.
+        const provider = await defaultSummaryProvider();
+        if (!provider)
+            throw new NoProviderError("`gmux summarize`");
+        if (!(await provider.isAvailable())) {
+            throw new GmuxError(`Summary provider "${provider.name}" is not on your PATH.`, {
+                fix: "Run `gmux setup` to choose a provider that is installed.",
+                exitCode: 6,
+            });
+        }
+        const all = await loadRecords({
+            ...(options.harness ? { harness: options.harness } : {}),
+            ...(options.project ? { project: options.project } : {}),
+        });
+        const targets = id
+            ? [resolveSession(all, id)]
+            : options.all
+                ? all
+                : all.slice(0, Number.parseInt(options.recent ?? "20", 10));
+        if (targets.length === 0) {
+            process.stdout.write(`${dim("Nothing to summarize.")}\n`);
+            return;
+        }
+        process.stdout.write(`${dim(`Summarizing ${targets.length} session${targets.length === 1 ? "" : "s"} with ${provider.name}…`)}\n`);
+        const result = await summarizeBatch(targets, provider, {
+            force: options.force === true,
+            onProgress: (done, total) => {
+                if (process.stdout.isTTY)
+                    process.stdout.write(`\r${dim(`  ${done}/${total}`)}`);
+            },
+        });
+        if (process.stdout.isTTY)
+            process.stdout.write("\r\x1b[K");
+        process.stdout.write(`${green(`✓ ${result.generated} written`)}  ${dim(`${result.skipped} already current`)}\n`);
+        if (result.failed.length > 0) {
+            process.stdout.write(`${yellow(`${result.failed.length} failed:`)}\n`);
+            for (const failure of result.failed.slice(0, 5)) {
+                process.stdout.write(`  ${bold(failure.sessionId.slice(0, 8))} ${dim(failure.reason)}\n`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=summarize.js.map

package/dist/cli/commands/summarize.js.map

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

package/dist/cli/commands/tmux.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from "commander";
+export declare const BLOCK_START = "# >>> gmux >>>";
+export declare const BLOCK_END = "# <<< gmux <<<";
+/**
+ * The bindings gmux manages. `ctrl+g` pulls up the whole-workspace cockpit;
+ * `ctrl+shift+g` opens the history picker, whose Enter resumes into a new window.
+ */
+export declare function bindingsBlock(): string;
+export declare function upsertBlock(existing: string, block: string): string;
+export declare function removeBlock(existing: string): string;
+export declare function registerTmux(program: Command): void;

package/dist/cli/commands/tmux.js

@@ -0,0 +1,90 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { dim, green } from "../format.js";
+import { toggleWatch } from "../tmux-label.js";
+export const BLOCK_START = "# >>> gmux >>>";
+export const BLOCK_END = "# <<< gmux <<<";
+/**
+ * The bindings gmux manages. `ctrl+g` pulls up the whole-workspace cockpit;
+ * `ctrl+shift+g` opens the history picker, whose Enter resumes into a new window.
+ */
+export function bindingsBlock() {
+    return [
+        BLOCK_START,
+        "# Pull up the whole-workspace cockpit; any close key dismisses.",
+        // Whole-workspace, so — unlike the overlay it replaced — this needs no
+        // window id resolved in-shell.
+        "bind -n C-g display-popup -w 100% -h 100% -x 0 -y 0 -B -E 'gmux cockpit'",
+        "# Toggle a headline label on every pane's border (leaves your panes visible).",
+        `bind -n M-g run-shell 'gmux tmux label "$(tmux display -p "#{window_id}")"'`,
+        "# Browse session history; Enter resumes into a new window.",
+        "bind -n C-S-g display-popup -w 80% -h 80% -E 'gmux pick --resume-in-window'",
+        BLOCK_END,
+    ].join("\n");
+}
+function blockRegion(text) {
+    const start = text.indexOf(BLOCK_START);
+    if (start === -1)
+        return null;
+    const endMarker = text.indexOf(BLOCK_END, start);
+    if (endMarker === -1)
+        return null;
+    return { start, end: endMarker + BLOCK_END.length };
+}
+export function upsertBlock(existing, block) {
+    const region = blockRegion(existing);
+    if (!region) {
+        const sep = existing.length === 0 || existing.endsWith("\n") ? "" : "\n";
+        return `${existing}${sep}${block}\n`;
+    }
+    return existing.slice(0, region.start) + block + existing.slice(region.end);
+}
+export function removeBlock(existing) {
+    const region = blockRegion(existing);
+    if (!region)
+        return existing;
+    let before = existing.slice(0, region.start);
+    let after = existing.slice(region.end);
+    if (before.endsWith("\n"))
+        before = before.slice(0, -1);
+    if (after.startsWith("\n"))
+        after = after.slice(1);
+    return before + (before && after ? "\n" : "") + after;
+}
+function confPath() {
+    return join(homedir(), ".tmux.conf");
+}
+async function readConf() {
+    try {
+        return await readFile(confPath(), "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+export function registerTmux(program) {
+    const tmux = program.command("tmux").description("manage gmux's tmux key bindings");
+    tmux
+        .command("install")
+        .description("add the gmux cockpit/picker key bindings to ~/.tmux.conf")
+        .action(async () => {
+        await writeFile(confPath(), upsertBlock(await readConf(), bindingsBlock()), "utf8");
+        process.stdout.write(`${green("installed")} bindings in ${confPath()}\n`);
+        process.stdout.write(`${dim("reload with `tmux source-file ~/.tmux.conf`; then ctrl-g pulls up the cockpit, ctrl-shift-g browses")}\n`);
+    });
+    tmux
+        .command("uninstall")
+        .description("remove the gmux block from ~/.tmux.conf")
+        .action(async () => {
+        await writeFile(confPath(), removeBlock(await readConf()), "utf8");
+        process.stdout.write(`${green("removed")} the gmux block from ${confPath()}\n`);
+    });
+    tmux
+        .command("label <window>")
+        .description("toggle the live pane-border label agent (used by the M-g binding)")
+        .action(async (windowId) => {
+        await toggleWatch(windowId);
+    });
+}
+//# sourceMappingURL=tmux.js.map

package/dist/cli/commands/tmux.js.map

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

package/dist/cli/commands/watch.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerWatch(program: Command): void;

package/dist/cli/commands/watch.js

@@ -0,0 +1,76 @@
+import { maybeAutoSummarize } from "../../services/auto-summarize.js";
+import { listAllPanes } from "../../services/tmux.js";
+import { WATCH_INTERVAL_MS, WATCH_WORKER_COMMAND, clearWatchPid, readWatchPid, startWatch, stopWatch, } from "../../services/watch.js";
+import { disableBorder, enableBorder, labelPanes } from "../tmux-label.js";
+import { dim, green } from "../format.js";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * The background agent's loop, running in the detached worker.
+ *
+ * Each tick: label every pane across every window from cache (cheap), then hand
+ * the on-screen sessions to the summariser — WITHOUT `force`, so the existing
+ * cooldown throttles how often divergence turns into a model call while the
+ * labels stay live. `shouldRefresh` (the SimHash gate) decides what's worth it.
+ *
+ * It exits cleanly when tmux is gone (`listAllPanes` throws), when its PID file
+ * is removed or replaced (the toggle's stop path), or on a terminating signal.
+ * A transient per-tick error never kills the loop.
+ */
+async function runWatch() {
+    const me = process.pid;
+    let running = true;
+    // Exit promptly on stop rather than waiting out the current sleep. The toggle's
+    // stop path has already cleared the pid file; a signal-kill without it leaves a
+    // stale pid the next start reclaims.
+    const stop = () => {
+        running = false;
+        process.exit(0);
+    };
+    process.on("SIGTERM", stop);
+    process.on("SIGINT", stop);
+    while (running) {
+        const record = await readWatchPid();
+        if (!record || record.pid !== me)
+            break; // toggled off, or superseded
+        let panes;
+        try {
+            panes = await listAllPanes();
+        }
+        catch {
+            break; // tmux server is gone
+        }
+        try {
+            const records = await labelPanes(panes);
+            await maybeAutoSummarize({ records });
+        }
+        catch {
+            // A transient read/tmux hiccup — skip this tick, keep watching.
+        }
+        await sleep(WATCH_INTERVAL_MS);
+    }
+    await clearWatchPid();
+}
+export function registerWatch(program) {
+    program
+        .command("watch")
+        .description("run gmux's background agent: keep pane labels and summaries current")
+        .option("--stop", "stop the running watcher")
+        .action(async (options) => {
+        if (options.stop) {
+            const was = await stopWatch();
+            await disableBorder();
+            process.stdout.write(`${was ? green("stopped") : dim("nothing was running")}\n`);
+            return;
+        }
+        const result = await startWatch();
+        if (result !== "failed")
+            await enableBorder();
+        process.stdout.write(`${dim(`watch ${result}`)}\n`);
+    });
+    // The detached loop. Hidden (`__`-prefixed), so the postAction summarize hook
+    // and the setup wizard both skip it.
+    program.command(WATCH_WORKER_COMMAND, { hidden: true }).action(async () => {
+        await runWatch();
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/cli/commands/watch.js.map

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

package/dist/cli/format.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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 type { SessionRecord, SessionView } from "../core/types.js";
+export declare const dim: (text: string) => string;
+export declare const bold: (text: string) => string;
+export declare const cyan: (text: string) => string;
+export declare const yellow: (text: string) => string;
+export declare const red: (text: string) => string;
+export declare const green: (text: string) => string;
+export declare const paneCyan: (text: string) => string;
+export declare const paneBold: (text: string) => string;
+export declare const paneDim: (text: string) => string;
+/** "repo/branch", or just "repo" when the branch adds nothing. */
+export declare function sessionLabel(record: SessionRecord): string;
+/**
+ * Rows whose summary the background worker is writing at this moment.
+ * Empty set = nothing in flight.
+ */
+export type InProgress = ReadonlySet<string>;
+/**
+ * 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 declare function formatRow(view: SessionView, now?: Date, inProgress?: InProgress): string;
+/**
+ * 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 declare function formatRowLines(view: SessionView, now?: Date, width?: number, inProgress?: InProgress): string[];
+/**
+ * The key under the list. Only mentions markers that actually appear, so a fully
+ * summarized list carries no footer at all.
+ */
+export declare function formatLegend(views: readonly SessionView[], inProgress?: InProgress): string;
+/**
+ * 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 declare function formatMarkerKey(): string;
+/** Terminal width, or a sane default when we cannot tell. */
+export declare function terminalWidth(): number;
+/** The detail card shown by `gmux show` and in the picker's preview pane. */
+export declare function formatCard(view: SessionView, now?: Date): string;
+/**
+ * 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 declare function indent(text: string): string;
+/** Stable JSON envelope. Everything machine-readable goes through here. */
+export declare function jsonEnvelope<T>(schemaVersion: number, data: T): string;