@gigaflow/gmux 0.15.0

package/dist/cli/commands/__ask-send.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `gmux __ask-send` — what enter does in the picker's ask mode.
+ *
+ * ~170ms of work and then it is gone: take the lock, append the question,
+ * fork the worker, tell the pane to repaint. It never calls a model. The model
+ * call is `__ask-run`'s, in a detached grandchild, because a send that waited
+ * for an answer would hold fzf's binding for twenty seconds.
+ *
+ * **Why the sender writes the question and not the worker.** The worker costs
+ * ~170ms of Node startup before it could echo anything, and 170ms between your
+ * enter and your own words appearing reads as dropped input. Two writers is the
+ * price; `O_APPEND` plus the lock plus a seq-keyed fold is what makes it safe.
+ *
+ * **Read-your-writes.** The question is written and the fd closed BEFORE the
+ * spawn. That ordering is a happens-before rather than a hope: spawn first and
+ * the worker races the question it is supposed to answer.
+ *
+ * Hidden, and `__`-prefixed for three separate reasons — `shouldRunSetupWizard`
+ * bails on `__` so this cannot block on a human prompt while fzf owns the
+ * terminal, main.ts's `postAction` bails on `__` so typing a question does not
+ * fork a summarize pass, and it is not a thing a person runs.
+ */
+import type { Command } from "commander";
+import type { LsOptions } from "./ls.js";
+/** The hidden command fzf's `enter` binding runs in ask mode. */
+export declare const ASK_SEND_COMMAND = "__ask-send";
+export interface AskSendOptions extends LsOptions {
+    transcript: string;
+    question: string;
+    /**
+     * The row highlighted at the instant enter fired — fzf re-substitutes `{1}`
+     * per keypress, so this is "the focus at send time" with no state and no race.
+     */
+    focus?: string;
+    /** fzf's `$FZF_PORT`. On the argv, not in the env: it is not a secret. */
+    port?: string;
+    now?: Date;
+    /** Injected in tests, so no test forks a detached child. Returns the pid. */
+    spawnWorker?: (args: readonly string[]) => number | undefined;
+}
+export type AskSendStatus = "sent" | "locked" | "empty" | "no-provider" | "spawn-failed";
+/**
+ * Append one question and hand it to a worker.
+ *
+ * Never throws: fzf owns the terminal, so there is nowhere for an error to go
+ * but the transcript. Every "no" still repaints the pane — a key that appears
+ * to do nothing is the bug this repo already refuses to ship.
+ */
+export declare function sendAskQuestion(options: AskSendOptions): Promise<AskSendStatus>;
+export declare function registerAskSend(program: Command): void;

package/dist/cli/commands/__ask-send.js

@@ -0,0 +1,138 @@
+/**
+ * `gmux __ask-send` — what enter does in the picker's ask mode.
+ *
+ * ~170ms of work and then it is gone: take the lock, append the question,
+ * fork the worker, tell the pane to repaint. It never calls a model. The model
+ * call is `__ask-run`'s, in a detached grandchild, because a send that waited
+ * for an answer would hold fzf's binding for twenty seconds.
+ *
+ * **Why the sender writes the question and not the worker.** The worker costs
+ * ~170ms of Node startup before it could echo anything, and 170ms between your
+ * enter and your own words appearing reads as dropped input. Two writers is the
+ * price; `O_APPEND` plus the lock plus a seq-keyed fold is what makes it safe.
+ *
+ * **Read-your-writes.** The question is written and the fd closed BEFORE the
+ * spawn. That ordering is a happens-before rather than a hope: spawn first and
+ * the worker races the question it is supposed to answer.
+ *
+ * Hidden, and `__`-prefixed for three separate reasons — `shouldRunSetupWizard`
+ * bails on `__` so this cannot block on a human prompt while fzf owns the
+ * terminal, main.ts's `postAction` bails on `__` so typing a question does not
+ * fork a summarize pass, and it is not a thing a person runs.
+ */
+import { NoProviderError } from "../../core/errors.js";
+import { acquireAskLock, appendAskEvent, askRunIdOf, closeAskTranscript, nextSeq, openAskTranscript, readAskTranscript, releaseAskLock, spawnAskWorker, writeAskLockPid, } from "../../services/ask-transcript.js";
+import { readConfig, resolveAskCommand } from "../../services/config.js";
+import { refreshNotifier } from "./__ask-refresh.js";
+import { ASK_RUN_COMMAND } from "./__ask-run.js";
+import { filterArgs } from "./pick.js";
+/** The hidden command fzf's `enter` binding runs in ask mode. */
+export const ASK_SEND_COMMAND = "__ask-send";
+/**
+ * Append one question and hand it to a worker.
+ *
+ * Never throws: fzf owns the terminal, so there is nowhere for an error to go
+ * but the transcript. Every "no" still repaints the pane — a key that appears
+ * to do nothing is the bug this repo already refuses to ship.
+ */
+export async function sendAskQuestion(options) {
+    const notify = refreshNotifier(options.port);
+    const now = options.now ?? new Date();
+    const question = options.question.trim();
+    if (question === "")
+        return "empty"; // Enter on an empty query. Nothing was asked.
+    // The second enter appends nothing and refreshes a pane that already says
+    // "still answering". Two workers interleaving chunks is the one thing that
+    // makes the fold ambiguous, and it is the one thing this stops.
+    if (!(await acquireAskLock(options.transcript, now))) {
+        notify();
+        return "locked";
+    }
+    const argv = resolveAskCommand(await readConfig());
+    const existing = await readAskTranscript(options.transcript);
+    const seq = nextSeq(existing.events);
+    const fd = openAskTranscript(options.transcript);
+    try {
+        // `meta` has one writer and one reader: whoever `cat`s a transcript whose
+        // answers look wrong. Written inside the open that creates the file.
+        if (existing.events.length === 0) {
+            appendAskEvent(fd, {
+                t: "meta",
+                runId: askRunIdOf(options.transcript),
+                startedAt: now.toISOString(),
+                // The argv, never the environment — that is where the api key lives.
+                provider: argv ? argv.join(" ") : "(none)",
+            });
+        }
+        appendAskEvent(fd, {
+            t: "question",
+            seq,
+            at: now.toISOString(),
+            // Focus is captured per question and lives in the record, not on the
+            // worker's argv: the transcript is then self-describing, and there is one
+            // source of truth for what the model was told.
+            focus: options.focus?.trim() ? options.focus.trim() : null,
+            text: question,
+        });
+        // Configured "none" means no model calls. The picker does not bind ctrl-o
+        // without a provider, so reaching here means config changed under a live
+        // picker — the question is still echoed, and the answer slot says why.
+        if (!argv) {
+            const failed = new NoProviderError("`gmux ask`");
+            appendAskEvent(fd, {
+                t: "error",
+                seq,
+                at: now.toISOString(),
+                message: failed.fix ? `${failed.message}\n${failed.fix}` : failed.message,
+            });
+            await releaseAskLock(options.transcript);
+            notify();
+            return "no-provider";
+        }
+    }
+    finally {
+        closeAskTranscript(fd);
+    }
+    const workerArgs = [
+        ASK_RUN_COMMAND,
+        "--transcript",
+        options.transcript,
+        "--seq",
+        String(seq),
+        ...(options.port ? ["--port", options.port] : []),
+        // The same filters this picker was opened with. Without them the worker
+        // re-derives its own window from defaults and `--focus` resolves to a
+        // session that is not in it — the answer is then about a list nobody was
+        // looking at, with no sign anything went wrong.
+        ...filterArgs(options),
+    ];
+    const pid = (options.spawnWorker ?? spawnAskWorker)(workerArgs);
+    if (pid === undefined) {
+        await releaseAskLock(options.transcript);
+        notify();
+        return "spawn-failed";
+    }
+    await writeAskLockPid(options.transcript, pid, now);
+    notify();
+    return "sent";
+}
+export function registerAskSend(program) {
+    program
+        .command(ASK_SEND_COMMAND, { hidden: true })
+        .description("internal: append a question and fork a worker (run by the picker's enter binding)")
+        .requiredOption("--transcript <path>", "the picker's chat transcript")
+        .requiredOption("--question <text>", "what was typed")
+        .option("--focus <id>", "the session highlighted when enter fired")
+        .option("--port <port>", "fzf's listen port, for the repaint")
+        .option("--harness <id>", "only this harness")
+        .option("-p, --project <name>", "only sessions whose project matches")
+        .option("-b, --branch <name>", "only sessions whose git branch matches")
+        .option("-s, --since <when>", "only sessions newer than this")
+        .option("-n, --limit <count>", "how many recent sessions to consider")
+        .option("--include-sidechains", "include subagent transcripts")
+        .option("--include-automated", "include non-interactive runs")
+        .action(async (options) => {
+        await sendAskQuestion(options);
+    });
+}
+//# sourceMappingURL=__ask-send.js.map

package/dist/cli/commands/__ask-send.js.map

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

package/dist/cli/commands/__preview-card.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `gmux __preview-card` — what fills the picker's preview pane.
+ *
+ * **Not `gmux show --chat <path>`.** `gmux show` is a public command and `--chat` is
+ * a private IPC channel: it is meaningless to a human at a terminal and exists
+ * only because fzf's preview command must be a shell string. So the preview gets
+ * a hidden command that calls the same renderer, `__picker-rows`' precedent, and
+ * **`gmux show`'s flags, output and `--json` schema are exactly as they were.**
+ *
+ * **It re-runs on EVERY cursor move, and it must never call a model.** That is
+ * the hard correctness constraint the whole chat design hangs off: the chat half
+ * renders from the transcript file or it does not render. A model call here is a
+ * model call per keystroke.
+ *
+ * Geometry is passed in, never measured. `--pane-lines` carries the pane's
+ * height because our stdout is a pipe — `process.stdout.columns` is undefined and
+ * `terminalWidth()` would return its 100 default — and because `$LINES` is the
+ * TERMINAL, not the pane: verified on a 40x120 terminal, the preview saw
+ * `LINES=40` but `FZF_PREVIEW_LINES=32`. Using `$LINES` overestimates by up to 2x.
+ * Same rule, same reason as `__picker-rows --width`.
+ */
+import type { Command } from "commander";
+/** The hidden command fzf's preview binding runs. Not a thing a person runs. */
+export declare const PREVIEW_CARD_COMMAND = "__preview-card";
+export interface PreviewCardOptions {
+    /** The picker's transcript. Absent — or missing on disk — is the empty state. */
+    chat?: string;
+    paneLines?: string;
+}
+export declare function renderPreviewCard(id: string, options: PreviewCardOptions, env?: NodeJS.ProcessEnv, now?: Date): Promise<string>;
+export declare function registerPreviewCard(program: Command): void;

package/dist/cli/commands/__preview-card.js

@@ -0,0 +1,72 @@
+/**
+ * `gmux __preview-card` — what fills the picker's preview pane.
+ *
+ * **Not `gmux show --chat <path>`.** `gmux show` is a public command and `--chat` is
+ * a private IPC channel: it is meaningless to a human at a terminal and exists
+ * only because fzf's preview command must be a shell string. So the preview gets
+ * a hidden command that calls the same renderer, `__picker-rows`' precedent, and
+ * **`gmux show`'s flags, output and `--json` schema are exactly as they were.**
+ *
+ * **It re-runs on EVERY cursor move, and it must never call a model.** That is
+ * the hard correctness constraint the whole chat design hangs off: the chat half
+ * renders from the transcript file or it does not render. A model call here is a
+ * model call per keystroke.
+ *
+ * Geometry is passed in, never measured. `--pane-lines` carries the pane's
+ * height because our stdout is a pipe — `process.stdout.columns` is undefined and
+ * `terminalWidth()` would return its 100 default — and because `$LINES` is the
+ * TERMINAL, not the pane: verified on a 40x120 terminal, the preview saw
+ * `LINES=40` but `FZF_PREVIEW_LINES=32`. Using `$LINES` overestimates by up to 2x.
+ * Same rule, same reason as `__picker-rows --width`.
+ */
+import { readAskTranscript } from "../../services/ask-transcript.js";
+import { resolveSession } from "../../services/resolve.js";
+import { readSummary } from "../../services/summarize.js";
+import { loadRecords } from "../../services/views.js";
+import { formatPreview, hasChatContent, splitPreview } from "../preview.js";
+/** The hidden command fzf's preview binding runs. Not a thing a person runs. */
+export const PREVIEW_CARD_COMMAND = "__preview-card";
+/**
+ * The pane width when fzf did not say. Not `terminalWidth()`: our stdout is a
+ * pipe, so it would answer with its default for the whole TERMINAL — roughly
+ * twice the pane, since the preview window is 55% of it.
+ */
+const ASSUMED_PANE_COLUMNS = 80;
+/**
+ * A positive integer out of environment-controlled text, or null.
+ *
+ * Hostile input, and the `${FZF_PREVIEW_LINES:-0}` in the preview command is the
+ * other half of the same rule: a bare `$FZF_PREVIEW_LINES` that expands to
+ * nothing makes commander read the NEXT FLAG NAME as the pane height.
+ */
+function positiveInt(value) {
+    const parsed = Number.parseInt(value ?? "", 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+}
+export async function renderPreviewCard(id, options, env = process.env, now = new Date()) {
+    // Naming a session explicitly means you want it, whatever kind it is — the
+    // same rule `gmux show` follows, because this is the same card.
+    const records = await loadRecords({ includeSidechains: true, includeAutomated: true });
+    const record = resolveSession(records, id);
+    const summary = await readSummary(record);
+    // ENOENT is a STATE, not an error, and so is a malformed file:
+    // `readAskTranscript` returns zero events either way and the card takes the
+    // whole pane. That is how the empty state costs no flag and no branch.
+    const transcript = options.chat ? await readAskTranscript(options.chat) : null;
+    // Read from our own environment rather than passed as a flag: fzf exports it to
+    // the preview process, and unlike the height nothing else needs it.
+    const width = positiveInt(env["FZF_PREVIEW_COLUMNS"]) ?? ASSUMED_PANE_COLUMNS;
+    const split = splitPreview(positiveInt(options.paneLines) ?? 0, hasChatContent(transcript));
+    return formatPreview({ record, summary }, transcript, split, width, now);
+}
+export function registerPreviewCard(program) {
+    program
+        .command(`${PREVIEW_CARD_COMMAND} <id>`, { hidden: true })
+        .description("internal: render the picker's preview pane (run by fzf on every cursor move)")
+        .option("--chat <path>", "the picker's chat transcript, rendered under the card")
+        .option("--pane-lines <n>", "the preview pane's height, which we cannot measure")
+        .action(async (id, options) => {
+        process.stdout.write(`${await renderPreviewCard(id, options)}\n`);
+    });
+}
+//# sourceMappingURL=__preview-card.js.map

package/dist/cli/commands/__preview-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__preview-card.js","sourceRoot":"","sources":["../../../src/cli/commands/__preview-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE5E,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAErD;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAQhC;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,KAAyB;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAU,EACV,OAA2B,EAC3B,MAAyB,OAAO,CAAC,GAAG,EACpC,MAAY,IAAI,IAAI,EAAE;IAEtB,2EAA2E;IAC3E,gEAAgE;IAChE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1C,+DAA+D;IAC/D,4EAA4E;IAC5E,uEAAuE;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE/E,gFAAgF;IAChF,oEAAoE;IACpE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,IAAI,oBAAoB,CAAC;IAC9E,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IAE5F,OAAO,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,GAAG,oBAAoB,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SACzD,WAAW,CAAC,8EAA8E,CAAC;SAC3F,MAAM,CAAC,eAAe,EAAE,uDAAuD,CAAC;SAChF,MAAM,CAAC,kBAAkB,EAAE,oDAAoD,CAAC;SAChF,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAA2B,EAAE,EAAE;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * `gmux ask` — ask questions about your sessions.
+ *
+ * Two shapes, one implementation:
+ *
+ *   gmux ask                  a REPL. What ctrl-o in the picker opens.
+ *   gmux ask "<question>"     one-shot, for a shell or an agent.
+ *   gmux ask "<q>" --json     the same, parseable.
+ *
+ * The one-shot is not a convenience — non-negotiable #4 says every read command
+ * supports `--json`, and an agent can only use what it can parse.
+ */
+import type { Command } from "commander";
+import { type AskContext } from "../../core/types.js";
+import { type LsOptions } from "./ls.js";
+export interface AskOptions extends LsOptions {
+    /** Session the picker was highlighting when ctrl-o was pressed. */
+    focus?: string;
+    /** Ask across the agent sessions in this tmux window (the ctrl-g overlay passes it). */
+    window?: string;
+    json?: boolean;
+}
+/** How many sessions had a summary — the honest measure of how much gmux knows. */
+export declare function summarizedCount(context: AskContext): number;
+/**
+ * Warn when the answer is going to be thin.
+ *
+ * Asking "what should I focus on?" against twenty un-summarized sessions gets
+ * you a shrug, and a user who doesn't know why will read that as the feature
+ * being useless rather than as the summaries not being written yet.
+ */
+export declare function thinContextNotice(context: AskContext): string | null;
+/**
+ * Open the chat layer from inside the picker's numbered fallback.
+ *
+ * Never throws. The picker is mid-flow and the user is going straight back to
+ * the list — a missing provider is a line of advice, not a crash that loses the
+ * list they were reading.
+ */
+export declare function askAboutSessions(options: AskOptions): Promise<void>;
+/**
+ * Whether `gmux ask` would work right now.
+ *
+ * The picker asks before advertising ctrl-o. A key that opens a chat which
+ * immediately dies — and, under fzf, gets repainted over before you can read
+ * why — is exactly the "key that does nothing" this codebase already refuses to
+ * offer for ctrl-r.
+ */
+export declare function askIsAvailable(): Promise<boolean>;
+export declare function registerAsk(program: Command): void;

package/dist/cli/commands/ask.js

@@ -0,0 +1,240 @@
+/**
+ * `gmux ask` — ask questions about your sessions.
+ *
+ * Two shapes, one implementation:
+ *
+ *   gmux ask                  a REPL. What ctrl-o in the picker opens.
+ *   gmux ask "<question>"     one-shot, for a shell or an agent.
+ *   gmux ask "<q>" --json     the same, parseable.
+ *
+ * The one-shot is not a convenience — non-negotiable #4 says every read command
+ * supports `--json`, and an agent can only use what it can parse.
+ */
+import { createInterface } from "node:readline/promises";
+import { GmuxError, NoProviderError } from "../../core/errors.js";
+import { SCHEMA_VERSION, } from "../../core/types.js";
+import { ASK_SESSION_LIMIT, buildAskContext, buildAskPrompt, defaultAskProvider, } from "../../services/ask.js";
+import { prunePaneLinks } from "../../services/pane-links.js";
+import { listAllPanes, listPanes } from "../../services/tmux.js";
+import { resolvePanesLive } from "../../services/tmux-resolve.js";
+import { attachSummaries, loadRecords, loadViews } from "../../services/views.js";
+import { bold, cyan, dim, jsonEnvelope, yellow } from "../format.js";
+import { toFilters } from "./ls.js";
+/** How many sessions had a summary — the honest measure of how much gmux knows. */
+export function summarizedCount(context) {
+    return context.sessions.filter((v) => v.summary !== null).length;
+}
+/**
+ * Warn when the answer is going to be thin.
+ *
+ * Asking "what should I focus on?" against twenty un-summarized sessions gets
+ * you a shrug, and a user who doesn't know why will read that as the feature
+ * being useless rather than as the summaries not being written yet.
+ */
+export function thinContextNotice(context) {
+    const total = context.sessions.length;
+    if (total === 0)
+        return "No sessions indexed. `gmux doctor` will say why.";
+    const summarized = summarizedCount(context);
+    if (summarized === 0) {
+        return "None of these sessions is summarized yet — answers will be thin. `gmux summarize` writes them.";
+    }
+    if (summarized < total / 2) {
+        return `Only ${summarized} of ${total} sessions are summarized — answers may be thin.`;
+    }
+    return null;
+}
+async function loadContext(options) {
+    if (options.window) {
+        const views = await windowViews(options.window);
+        return buildAskContext(views, options.focus ?? null, Math.max(views.length, 1));
+    }
+    const views = await loadViews(toFilters(options, ASK_SESSION_LIMIT));
+    return buildAskContext(views, options.focus ?? null, Number(options.limit) || ASK_SESSION_LIMIT);
+}
+/**
+ * The distinct agent sessions running in a tmux window, with their summaries.
+ * Resolves every pane in the server (so a fresh pane can't claim a session
+ * another window's pane owns), then keeps this window's.
+ */
+async function windowViews(windowId) {
+    const all = await listAllPanes();
+    const links = await prunePaneLinks(all.map((p) => p.paneId));
+    const records = await loadRecords();
+    const windowPaneIds = new Set((await listPanes(windowId)).map((p) => p.paneId));
+    const resolved = (await resolvePanesLive(all, records, links)).filter((r) => windowPaneIds.has(r.pane.paneId));
+    const seen = new Set();
+    const unique = resolved
+        .map((r) => r.record)
+        .filter((r) => r !== null)
+        .filter((r) => (seen.has(r.sessionId) ? false : (seen.add(r.sessionId), true)));
+    return attachSummaries(unique);
+}
+/**
+ * The provider for this run, or a typed error saying which kind of "no" it is.
+ *
+ * Three different answers, and they must stay three:
+ *
+ * - configured "none"   -> a decision to revisit (`gmux setup`)
+ * - configured, missing -> a binary to install, named by its own name
+ * - present            -> go
+ *
+ * The availability check mirrors what `gmux summarize` already does. Without it a
+ * user who picked Codex and never installed it gets a raw `spawn codex ENOENT`
+ * from deep inside the spawn, which is not an error that carries its fix.
+ */
+async function resolveProvider() {
+    const provider = await defaultAskProvider();
+    if (!provider)
+        throw new NoProviderError("`gmux ask`");
+    if (!(await provider.isAvailable())) {
+        throw new GmuxError(`Ask provider "${provider.name}" is not on your PATH.`, {
+            fix: "Run `gmux setup` to choose a provider that is installed.",
+            exitCode: 6,
+        });
+    }
+    return provider;
+}
+/**
+ * Read one question, holding readline open for no longer than it takes to ask.
+ *
+ * The interface is created and closed per question, and that is NOT ceremony.
+ * `readline/promises` drops any line that arrives while no `question()` is
+ * pending: the model call between turns takes tens of seconds, and anything the
+ * user typed during it — echoed to the terminal, so it looks accepted — would be
+ * silently thrown away.
+ *
+ * With no interface open, those keystrokes stay in the tty buffer and are
+ * delivered to the next `question()` instead of being lost. Same reason the
+ * picker closes its readline before opening the chat, and the same trap that
+ * made `gmux setup` require a TTY.
+ *
+ * Returns null on ctrl-d, which rejects the promise rather than resolving it.
+ */
+async function readQuestion() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return (await rl.question(`\n${cyan("?")} `)).trim();
+    }
+    catch {
+        return null; // ctrl-d. An exit, not an error.
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * The REPL.
+ *
+ * Turns accumulate in memory and are replayed into each prompt, because the
+ * providers we call are one-shot — see services/ask.ts. Blank line or ctrl-d
+ * exits, which is what returns you to the picker when fzf spawned us.
+ */
+async function repl(context, provider) {
+    const turns = [];
+    const notice = thinContextNotice(context);
+    process.stdout.write(`\n${bold("gmux ask")} ${dim(`— ${context.sessions.length} recent session${context.sessions.length === 1 ? "" : "s"} loaded, ${summarizedCount(context)} summarized · ${provider.name}`)}\n`);
+    if (notice)
+        process.stdout.write(`${yellow(notice)}\n`);
+    process.stdout.write(`${dim("Ask anything. Blank line or ctrl-d to go back.")}\n`);
+    for (;;) {
+        const question = await readQuestion();
+        if (question === null || question === "")
+            return;
+        process.stdout.write(`${dim("  thinking…")}`);
+        let answer;
+        try {
+            answer = await provider.ask(buildAskPrompt(context, turns, question));
+        }
+        catch (error) {
+            // A failed turn must not end the conversation: the next question may be
+            // cheaper, or the provider may just have been slow once.
+            process.stdout.write(`\r\x1b[K${yellow(error.message)}\n`);
+            continue;
+        }
+        process.stdout.write("\r\x1b[K");
+        process.stdout.write(`${answer}\n`);
+        turns.push({ question, answer });
+    }
+}
+/**
+ * Open the chat layer from inside the picker's numbered fallback.
+ *
+ * Never throws. The picker is mid-flow and the user is going straight back to
+ * the list — a missing provider is a line of advice, not a crash that loses the
+ * list they were reading.
+ */
+export async function askAboutSessions(options) {
+    try {
+        const provider = await resolveProvider();
+        await repl(await loadContext(options), provider);
+    }
+    catch (error) {
+        const fix = error instanceof GmuxError ? error.fix : undefined;
+        process.stdout.write(`\n${yellow(error.message)}\n`);
+        if (fix)
+            process.stdout.write(`${dim(fix)}\n`);
+    }
+}
+/**
+ * Whether `gmux ask` would work right now.
+ *
+ * The picker asks before advertising ctrl-o. A key that opens a chat which
+ * immediately dies — and, under fzf, gets repainted over before you can read
+ * why — is exactly the "key that does nothing" this codebase already refuses to
+ * offer for ctrl-r.
+ */
+export async function askIsAvailable() {
+    const provider = await defaultAskProvider();
+    return provider !== null && (await provider.isAvailable());
+}
+export function registerAsk(program) {
+    program
+        .command("ask [question]")
+        .description("ask about your recent sessions — what landed, what to pick up next")
+        .option("--focus <id>", "the session you're looking at (the picker passes this)")
+        .option("--window <id>", "ask across the agent sessions in this tmux window (the ctrl-g overlay passes it)")
+        .option("--harness <id>", "only this harness")
+        .option("-p, --project <name>", "only sessions whose project matches")
+        .option("-b, --branch <name>", "only sessions whose git branch matches")
+        .option("-s, --since <when>", "only sessions newer than this (3d, 12h, 2w)")
+        .option("-n, --limit <count>", "how many recent sessions to consider", String(ASK_SESSION_LIMIT))
+        // These two exist because the picker forwards them: ctrl-o reproduces the
+        // filter set the list was opened with, and an option the child does not
+        // declare is one commander rejects outright — so `gmux pick --include-automated`
+        // would bind a ctrl-o that dies on "unknown option".
+        .option("--include-sidechains", "include subagent transcripts")
+        .option("--include-automated", "include non-interactive runs (claude -p, codex exec)")
+        .option("--json", "emit JSON for scripts and agents")
+        .action(async (question, options) => {
+        const context = await loadContext(options);
+        const provider = await resolveProvider();
+        if (!question) {
+            if (options.json) {
+                // A REPL cannot emit an envelope. Failing loudly beats handing an
+                // agent an interactive process that looks like a hang.
+                throw new GmuxError("`gmux ask --json` needs a question.", {
+                    fix: 'Pass one: gmux ask "what should I pick up?" --json',
+                    exitCode: 2,
+                });
+            }
+            await repl(context, provider);
+            return;
+        }
+        const answer = await provider.ask(buildAskPrompt(context, [], question));
+        if (options.json) {
+            process.stdout.write(`${jsonEnvelope(SCHEMA_VERSION, {
+                answer,
+                provider: provider.name,
+                sessionCount: context.sessions.length,
+                summarizedCount: summarizedCount(context),
+            })}\n`);
+            return;
+        }
+        const notice = thinContextNotice(context);
+        if (notice)
+            process.stderr.write(`${yellow(notice)}\n`);
+        process.stdout.write(`${answer}\n`);
+    });
+}
+//# sourceMappingURL=ask.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { Command } from "commander";
+/**
+ * The background worker, re-entered as `gmux __auto-summarize`.
+ *
+ * Hidden: it is not a thing a person runs. It exists so the foreground command
+ * can hand the slow model calls to a detached copy of itself and exit.
+ *
+ * It writes nothing to stdout or stderr — its stdio is `ignore`d anyway — and it
+ * exits 0 whatever happens. A failed background summary is not the user's
+ * problem; the row simply stays marked "no summary yet".
+ */
+export declare function registerAutoSummarizeWorker(program: Command): void;

package/dist/cli/commands/auto.js

@@ -0,0 +1,28 @@
+import { AUTO_SUMMARIZE_COMMAND, releaseLock, runAutoSummarize, } from "../../services/auto-summarize.js";
+import { defaultSummaryProvider } from "../../services/summarize.js";
+/**
+ * The background worker, re-entered as `gmux __auto-summarize`.
+ *
+ * Hidden: it is not a thing a person runs. It exists so the foreground command
+ * can hand the slow model calls to a detached copy of itself and exit.
+ *
+ * It writes nothing to stdout or stderr — its stdio is `ignore`d anyway — and it
+ * exits 0 whatever happens. A failed background summary is not the user's
+ * problem; the row simply stays marked "no summary yet".
+ */
+export function registerAutoSummarizeWorker(program) {
+    program
+        .command(AUTO_SUMMARIZE_COMMAND, { hidden: true })
+        .description("internal: write summaries for recent sessions (run detached by gmux itself)")
+        .action(async () => {
+        // A null provider means the user configured "no model calls". Same
+        // outcome as a missing binary: drop the lock and do nothing.
+        const provider = await defaultSummaryProvider();
+        if (!provider || !(await provider.isAvailable())) {
+            await releaseLock();
+            return;
+        }
+        await runAutoSummarize(provider);
+    });
+}
+//# sourceMappingURL=auto.js.map