@gigaflow/gmux 0.15.0

package/dist/cli/commands/pick.js

@@ -0,0 +1,254 @@
+import { rm } from "node:fs/promises";
+import { shellQuote } from "../../core/text.js";
+import { askBrowseQueryPath, askLockPath, newAskTranscriptPath, readAskLock, sweepAskTranscripts, } from "../../services/ask-transcript.js";
+import { inProgressIds, isLockStale, maybeAutoSummarize } from "../../services/auto-summarize.js";
+import { loadViews } from "../../services/views.js";
+import { listWidth, pickSession, selfCommandHere } from "../picker.js";
+import { dim } from "../format.js";
+import { ASK_CANCEL_COMMAND } from "./__ask-cancel.js";
+import { ASK_SEND_COMMAND } from "./__ask-send.js";
+import { askAboutSessions, askIsAvailable } from "./ask.js";
+import { resumeInNewWindow, resumeSession } from "./resume.js";
+import { autoSummarizeRequested, toFilters } from "./ls.js";
+/** The hidden command fzf's ctrl-r binding runs. Not a thing a person runs. */
+export const PICKER_ROWS_COMMAND = "__picker-rows";
+/**
+ * The filter flags this picker was opened with, as argv.
+ *
+ * One copy, because every command the picker spawns must describe the *same*
+ * window. A filter that drifts in one of several copies is the silent
+ * wrong-window bug the `pickerAskArgs` comment below exists to warn about —
+ * nothing errors, the answers are just about other sessions.
+ *
+ * Values are NOT quoted here — the caller joins and quotes, because argv and a
+ * shell command string want different escaping.
+ */
+export function filterArgs(options) {
+    const args = [];
+    if (options.harness)
+        args.push("--harness", options.harness);
+    if (options.project)
+        args.push("-p", options.project);
+    if (options.branch)
+        args.push("-b", options.branch);
+    if (options.since)
+        args.push("-s", options.since);
+    if (options.limit)
+        args.push("-n", options.limit);
+    if (options.includeSidechains === true)
+        args.push("--include-sidechains");
+    if (options.includeAutomated === true)
+        args.push("--include-automated");
+    return args;
+}
+/**
+ * The argv behind ctrl-o, reproducing this picker's filter set for `gmux ask`.
+ *
+ * Pure, and separate from `pickerReloadArgs` only because the two target
+ * different commands — they carry the same filters for the same reason.
+ *
+ * THE FILTERS ARE THE POINT. `gmux ask` builds its own window; left to its
+ * defaults it takes the 20 most recent sessions across every project, which for
+ * `gmux pick -p webshop` (or any pick past the 20th row) does not contain the
+ * session you are highlighting. `--focus` then finds nothing, resolves to null,
+ * and the chat answers about sessions you were not looking at — with no sign
+ * anything went wrong.
+ *
+ * `-n` is forwarded too: the window ask reasons over should be the list you are
+ * looking at, not a shorter one it chose for itself.
+ *
+ * `--focus {1}` is NOT added here. fzf substitutes that token, so it is appended
+ * unquoted by the picker; a shell-quoted `{1}` would arrive as a literal.
+ */
+export function pickerAskArgs(options) {
+    return ["ask", ...filterArgs(options)];
+}
+/**
+ * The argv that reproduces this picker's filter set, for fzf's reload binding.
+ *
+ * Pure, so the thing a refresh actually runs is testable without spawning fzf.
+ *
+ * `--width` is passed explicitly: the reload child's stdout is a pipe, so it
+ * cannot measure the terminal and would fall back to a default width, reflowing
+ * every row on refresh. Only the parent, inside fzf, knows the real width.
+ */
+export function pickerReloadArgs(options, width, autoSummarize = true) {
+    const args = [PICKER_ROWS_COMMAND, "--width", String(width), ...filterArgs(options)];
+    // The opt-out MUST cross the process boundary. ctrl-r forces a pass — it
+    // bypasses the cooldown — so a dropped flag here would spend tokens the user
+    // explicitly declined, with the one thing that might have throttled it
+    // removed. Commander reads a root option after the subcommand name fine.
+    if (!autoSummarize)
+        args.push("--no-auto-summarize");
+    return args;
+}
+/**
+ * The chat pane's shell commands, or undefined when it cannot be offered.
+ *
+ * **Built here and not in the picker**, which is the same call `askArgs` already
+ * makes: opaque strings in, shell commands out. `pick.ts` owns the provider
+ * question (`askIsAvailable`) and the transcript path, so it owns everything the
+ * picker would otherwise have to learn — and the picker's import list stays free
+ * of `node:fs`, of the lock's shape, and of a provider.
+ *
+ * **The path is allocated and NOTHING is created.** It has to exist as a string
+ * before fzf starts, because it is baked into the preview command; the first
+ * `__ask-send` creates the file as a side effect of opening it for append. A run
+ * where nobody presses ctrl-o therefore never touches the disk, and a missing
+ * file is exactly the empty state.
+ *
+ * `--port`, `--focus` and `--question` are NOT here: fzf substitutes `{1}` and
+ * expands `$FZF_PORT`/`$FZF_QUERY`, and `shellQuote`'s allowed class contains
+ * neither `$` nor `{`, so all three would arrive at the child as literal strings.
+ * The picker appends them unquoted, after these.
+ */
+function pickerChatSpec(options, transcript) {
+    const self = selfCommandHere();
+    if (!self)
+        return undefined;
+    const command = (name, args) => `${self} ${[name, "--transcript", transcript, ...args].map(shellQuote).join(" ")}`;
+    return {
+        transcript,
+        // THE FILTERS ARE THE POINT, for the reason `pickerAskArgs` records: the
+        // worker builds its own window, and a window built from defaults does not
+        // contain the session you are pointing at — `--focus` then resolves to null
+        // and the chat answers about a list you never asked about, looking normal the
+        // whole time. Baked in at picker start, exactly as ctrl-r's are.
+        sendCmd: command(ASK_SEND_COMMAND, filterArgs(options)),
+        cancelCmd: command(ASK_CANCEL_COMMAND, []),
+    };
+}
+/**
+ * Everything the thread leaves on disk, gone when the picker is.
+ *
+ * **The group kill is here and not only in `__ask-cancel`** because accept and
+ * abort never run the esc binding: quit the picker mid-answer and `claude -p`
+ * would otherwise keep running, keep billing, and keep writing into a transcript
+ * nobody will ever read. Measured — `kill -TERM <worker>` leaves the provider
+ * orphaned and alive; only the group dies together.
+ *
+ * Never throws. A cleanup that fails must not become the way `gmux pick` reports
+ * that you picked a session.
+ */
+function closeChatThread(transcript) {
+    return async () => {
+        try {
+            const lock = await readAskLock(transcript);
+            // Liveness ANDed with age, exactly as `isLockStale` already does — a stale
+            // lock's pid is either dead or recycled into some innocent process, and
+            // signalling a stranger's group is the worst thing on this path.
+            if (lock && lock.pid > 0 && !isLockStale(lock, new Date())) {
+                try {
+                    process.kill(-lock.pid, "SIGTERM");
+                }
+                catch {
+                    // ESRCH: it finished on its own. Nothing to reap.
+                }
+            }
+            await rm(transcript, { force: true });
+            await rm(askLockPath(transcript), { force: true });
+            await rm(askBrowseQueryPath(transcript), { force: true });
+        }
+        catch {
+            // An orphan is a few KB of disposable cache and the sweep will get it.
+        }
+    };
+}
+/**
+ * Load the list and start summaries for whatever needs them.
+ *
+ * Both the initial paint and a refresh go through here, so `r` in the numbered
+ * fallback does what ctrl-r does in fzf rather than only re-rendering stale
+ * rows. `force` is set for a refresh: a keypress is an explicit request.
+ */
+async function refresh(options, enabled, force, notify) {
+    const views = await loadViews(toFilters(options, 50));
+    const started = await maybeAutoSummarize({
+        records: views.map((v) => v.record),
+        enabled,
+        force,
+        ...(notify ? { notify } : {}),
+    });
+    return { views, inProgress: new Set([...(await inProgressIds()), ...started.targetIds]) };
+}
+/**
+ * The bare `gmux` command: pick a recent session, then resume it.
+ * This is the whole point of the tool — everything else is in service of it.
+ *
+ * Registered as commander's *default* command rather than as options on the root
+ * program. Hanging `-n`/`-p` off the root would shadow the identically-named
+ * flags on `gmux ls`, so `gmux ls -n 8` would silently ignore the 8.
+ */
+export function registerPick(program) {
+    program
+        .command("pick", { isDefault: true })
+        .description("pick a recent session and resume it (this is what bare `gmux` does)")
+        .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 sessions to offer", "50")
+        .option("--include-sidechains", "include subagent transcripts")
+        .option("--include-automated", "include non-interactive runs (claude -p, codex exec)")
+        .option("--resume-in-window", "resume the choice in a new tmux window (used by the tmux ctrl-shift-g binding)")
+        .action(async (options, command) => {
+        const enabled = autoSummarizeRequested(command);
+        // Kick the pass off over the sessions we are about to offer, exactly as
+        // `ls` does — the postAction hook cannot serve the picker, because our
+        // action ends in `resumeSession`, which waits on your harness. That hook
+        // fires when you quit Claude Code, not when the list is drawn.
+        //
+        // The notice goes to stderr, which fzf does not capture, so it prints
+        // before the picker paints rather than on top of it.
+        const opened = await refresh(options, enabled, false, (message) => process.stderr.write(`${dim(message)}\n`));
+        if (opened.views.length === 0) {
+            process.stdout.write(`${dim("No sessions found. If you expected some, run `gmux doctor`.")}\n`);
+            return;
+        }
+        // Ask is offered only when it would actually answer. Advertising ctrl-o to
+        // someone who chose "no model calls" — or who never installed what they
+        // chose — binds a key that opens a chat which dies instantly, and fzf
+        // repaints the list over the explanation before it can be read. That is
+        // the "key that does nothing" this file already refuses to offer.
+        const canAsk = await askIsAvailable();
+        // Reap transcripts left behind by pickers that were `kill -9`d. The
+        // parent's job, not the picker's, and it runs before we open so a live
+        // pane's file is never the one being read while we consider removing it.
+        await sweepAskTranscripts();
+        // Allocated whatever the fzf version is: only the `split` tier renders a
+        // chat, and it is the picker that knows which tier this is. A tier that
+        // ignores this never creates the file, so the cleanup below removes
+        // nothing and costs nothing.
+        const transcript = newAskTranscriptPath();
+        const chat = canAsk ? pickerChatSpec(options, transcript) : undefined;
+        const chosen = await pickSession(opened.views, {
+            inProgress: opened.inProgress,
+            reloadArgs: pickerReloadArgs(options, listWidth(), enabled),
+            ...(canAsk ? { askArgs: pickerAskArgs(options) } : {}),
+            ...(chat ? { chat, onClose: closeChatThread(transcript) } : {}),
+            // `a` in the numbered fallback. fzf's ctrl-o does NOT come through here:
+            // it runs its own `execute` binding against this build, so the chat gets
+            // a clean terminal instead of one fzf is painting.
+            ...(canAsk ? { ask: () => askAboutSessions(options) } : {}),
+            // `r` in the numbered fallback: forced, like the ctrl-r it stands in for.
+            reload: () => refresh(options, enabled, true),
+            // ctrl-r can surface a session that did not exist when we opened. Look
+            // it up the way `gmux resume <id>` does — naming a session explicitly
+            // means you want it, even if the list filters would now hide it.
+            resolve: async (id) => {
+                const fresh = await loadViews({ includeSidechains: true, includeAutomated: true });
+                return fresh.find((v) => v.record.sessionId === id) ?? null;
+            },
+        });
+        if (!chosen) {
+            process.stdout.write(`${dim("Nothing selected.")}\n`);
+            return;
+        }
+        if (options.resumeInWindow === true && process.env.TMUX) {
+            await resumeInNewWindow(chosen.record);
+            return;
+        }
+        await resumeSession(chosen.record);
+    });
+}
+//# sourceMappingURL=pick.js.map

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

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

package/dist/cli/commands/picker-rows.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from "commander";
+/**
+ * The picker's ctrl-r target, re-entered as `gmux __picker-rows`.
+ *
+ * Hidden: like `__auto-summarize`, it is not a thing a person runs. fzf's
+ * `reload` binding replaces its item list with a command's stdout, so refresh
+ * is exactly "print the records again, having first kicked off summaries".
+ *
+ * Two rules, both because fzf owns the terminal while this runs:
+ *
+ * 1. NOTHING goes to stderr. `maybeAutoSummarize`'s notice would land on top of
+ *    the picker and corrupt the display. The `◐` markers are the notice here.
+ * 2. Width comes from `--width`, not from measuring. Our stdout is a pipe, so
+ *    `terminalWidth()` would report its default and every row would reflow to a
+ *    different width than it had on open.
+ */
+export declare function registerPickerRows(program: Command): void;

package/dist/cli/commands/picker-rows.js

@@ -0,0 +1,47 @@
+import { inProgressIds, maybeAutoSummarize } from "../../services/auto-summarize.js";
+import { loadViews } from "../../services/views.js";
+import { buildFzfRecords, fzfVersion, supportsMultiline } from "../picker.js";
+import { PICKER_ROWS_COMMAND } from "./pick.js";
+import { autoSummarizeRequested, toFilters } from "./ls.js";
+/**
+ * The picker's ctrl-r target, re-entered as `gmux __picker-rows`.
+ *
+ * Hidden: like `__auto-summarize`, it is not a thing a person runs. fzf's
+ * `reload` binding replaces its item list with a command's stdout, so refresh
+ * is exactly "print the records again, having first kicked off summaries".
+ *
+ * Two rules, both because fzf owns the terminal while this runs:
+ *
+ * 1. NOTHING goes to stderr. `maybeAutoSummarize`'s notice would land on top of
+ *    the picker and corrupt the display. The `◐` markers are the notice here.
+ * 2. Width comes from `--width`, not from measuring. Our stdout is a pipe, so
+ *    `terminalWidth()` would report its default and every row would reflow to a
+ *    different width than it had on open.
+ */
+export function registerPickerRows(program) {
+    program
+        .command(PICKER_ROWS_COMMAND, { hidden: true })
+        .description("internal: print picker rows (run by the picker's ctrl-r binding)")
+        .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 sessions to offer", "50")
+        .option("--include-sidechains", "include subagent transcripts")
+        .option("--include-automated", "include non-interactive runs")
+        .option("--width <columns>", "list column width, measured by the parent")
+        .action(async (options, command) => {
+        const views = await loadViews(toFilters(options, 50));
+        // Forced: the user pressed a key. The lock still stops a stampede, and
+        // `--no-auto-summarize` — forwarded by pickerReloadArgs — still wins.
+        const started = await maybeAutoSummarize({
+            records: views.map((v) => v.record),
+            enabled: autoSummarizeRequested(command),
+            force: true,
+        });
+        const inProgress = new Set([...(await inProgressIds()), ...started.targetIds]);
+        const width = Number.parseInt(options.width ?? "", 10);
+        process.stdout.write(buildFzfRecords(views, supportsMultiline(fzfVersion()), Number.isFinite(width) && width > 0 ? width : undefined, new Date(), inProgress));
+    });
+}
+//# sourceMappingURL=picker-rows.js.map

package/dist/cli/commands/picker-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker-rows.js","sourceRoot":"","sources":["../../../src/cli/commands/picker-rows.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAA0B,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAC9C,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;SAC7C,MAAM,CAAC,sBAAsB,EAAE,qCAAqC,CAAC;SACrE,MAAM,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;SACvE,MAAM,CAAC,oBAAoB,EAAE,+BAA+B,CAAC;SAC7D,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,EAAE,IAAI,CAAC;SACjE,MAAM,CAAC,sBAAsB,EAAE,8BAA8B,CAAC;SAC9D,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,2CAA2C,CAAC;SACxE,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,OAAgB,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAEtD,uEAAuE;QACvE,sEAAsE;QACtE,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;YACvC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YACnC,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC;YACxC,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,aAAa,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAEvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,CACb,KAAK,EACL,iBAAiB,CAAC,UAAU,EAAE,CAAC,EAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EACvD,IAAI,IAAI,EAAE,EACV,UAAU,CACX,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { Command } from "commander";
+import type { SessionRecord } from "../../core/types.js";
+import type { ResumeCommand } from "../../adapters/types.js";
+/**
+ * Hand control to the harness that owns this session.
+ *
+ * We replace this process rather than wrapping it: the user wants to be *in*
+ * Claude Code or Codex, not in a gmux shell that proxies keystrokes.
+ */
+export declare function resumeSession(record: SessionRecord, dryRun?: boolean): Promise<never | void>;
+/**
+ * The tmux argv that opens the resume command in a new window in the current
+ * session. Args are passed after `--` so nothing has to be shell-escaped — tmux
+ * runs the vector directly. Pure, so the shape is tested without spawning tmux.
+ */
+export declare function newWindowArgv(resume: ResumeCommand): string[];
+/**
+ * Resume a session in a NEW tmux window instead of replacing this process.
+ *
+ * Used only by the picker bridge (`gmux pick --resume-in-window`), which runs
+ * inside a `display-popup`: exec'ing the harness there would trap it in the
+ * ephemeral popup, gone the moment it exits. A new window is a persistent pane.
+ */
+export declare function resumeInNewWindow(record: SessionRecord): Promise<void>;
+export declare function registerResume(program: Command): void;

package/dist/cli/commands/resume.js

@@ -0,0 +1,88 @@
+import { execFile, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { GmuxError } from "../../core/errors.js";
+import { shellQuote } from "../../core/text.js";
+import { adapterById } from "../../adapters/registry.js";
+import { loadRecords } from "../../services/views.js";
+import { resolveSession } from "../../services/resolve.js";
+import { dim } from "../format.js";
+/**
+ * Hand control to the harness that owns this session.
+ *
+ * We replace this process rather than wrapping it: the user wants to be *in*
+ * Claude Code or Codex, not in a gmux shell that proxies keystrokes.
+ */
+export async function resumeSession(record, dryRun = false) {
+    const adapter = adapterById(record.harness);
+    if (!adapter) {
+        throw new GmuxError(`No adapter is registered for harness "${record.harness}".`, {
+            fix: "This session was indexed by a version of gmux that supported more harnesses. Run `gmux index --rebuild`.",
+        });
+    }
+    const { command, args, cwd } = adapter.resumeCommand(record);
+    if (!existsSync(cwd)) {
+        throw new GmuxError(`The session's directory no longer exists: ${cwd}`, {
+            fix: "The repo or worktree was moved or deleted. Recreate it, or resume manually from another directory.",
+            exitCode: 3,
+        });
+    }
+    if (dryRun) {
+        // Quote it: this line is meant to be pasted into a shell, and a repo path
+        // with a space in it would otherwise silently run in the wrong directory.
+        process.stdout.write(`cd ${shellQuote(cwd)} && ${command} ${args.map(shellQuote).join(" ")}\n`);
+        return;
+    }
+    process.stderr.write(`${dim(`→ ${command} ${args.join(" ")}  (in ${cwd})`)}\n`);
+    const child = spawn(command, args, { cwd, stdio: "inherit" });
+    child.on("error", (error) => {
+        if (error.code === "ENOENT") {
+            process.stderr.write(`error  "${command}" is not on your PATH, so this session cannot be resumed.\n` +
+                `fix    Install ${adapter.displayName}, or run \`gmux resume ${record.sessionId.slice(0, 8)} --print\` to see the command.\n`);
+            process.exit(6);
+        }
+        process.stderr.write(`error  ${error.message}\n`);
+        process.exit(1);
+    });
+    child.on("close", (code) => process.exit(code ?? 0));
+}
+/**
+ * The tmux argv that opens the resume command in a new window in the current
+ * session. Args are passed after `--` so nothing has to be shell-escaped — tmux
+ * runs the vector directly. Pure, so the shape is tested without spawning tmux.
+ */
+export function newWindowArgv(resume) {
+    return ["new-window", "-c", resume.cwd, "--", resume.command, ...resume.args];
+}
+/**
+ * Resume a session in a NEW tmux window instead of replacing this process.
+ *
+ * Used only by the picker bridge (`gmux pick --resume-in-window`), which runs
+ * inside a `display-popup`: exec'ing the harness there would trap it in the
+ * ephemeral popup, gone the moment it exits. A new window is a persistent pane.
+ */
+export async function resumeInNewWindow(record) {
+    const adapter = adapterById(record.harness);
+    if (!adapter) {
+        throw new GmuxError(`No adapter is registered for harness "${record.harness}".`, {
+            fix: "Run `gmux index --rebuild`.",
+        });
+    }
+    const argv = newWindowArgv(adapter.resumeCommand(record));
+    await new Promise((resolve, reject) => {
+        execFile("tmux", argv, (error) => (error ? reject(error) : resolve()));
+    });
+}
+export function registerResume(program) {
+    program
+        .command("resume <id>")
+        .description("resume a session in its original harness and directory")
+        .option("--print", "print the command instead of running it")
+        .action(async (id, options) => {
+        // As with `show`: naming a session explicitly means you want it, even if
+        // `gmux ls` would hide it by default.
+        const records = await loadRecords({ includeSidechains: true, includeAutomated: true });
+        const record = resolveSession(records, id);
+        await resumeSession(record, options.print === true);
+    });
+}
+//# sourceMappingURL=resume.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+import type { HarnessAdapter } from "../../adapters/types.js";
+import type { SessionRef } from "../../core/types.js";
+/** Match `gmux run <arg>` to a harness by id or by a process-name alias. */
+export declare function resolveHarnessArg(arg: string): HarnessAdapter | null;
+/**
+ * The session the harness just started or touched: newest among those whose id
+ * is either new (a fresh session) or whose mtime advanced since `before` (a
+ * resumed one — `gmux run codex resume`, `gmux run claude --resume <id>` write to
+ * an EXISTING session file, so no new id ever appears for those).
+ */
+export declare function pickChangedSession(before: readonly SessionRef[], after: readonly SessionRef[]): SessionRef | null;
+export declare function registerRun(program: Command): void;

package/dist/cli/commands/run.js

@@ -0,0 +1,78 @@
+import { spawn } from "node:child_process";
+import { adapterById, allAdapters } from "../../adapters/registry.js";
+import { writePaneLink } from "../../services/pane-links.js";
+import { dim } from "../format.js";
+/** How long to watch for the harness's freshly-written session file. */
+const DETECT_WINDOW_MS = 8000;
+const DETECT_POLL_MS = 500;
+/** Match `gmux run <arg>` to a harness by id or by a process-name alias. */
+export function resolveHarnessArg(arg) {
+    const needle = arg.trim().toLowerCase();
+    return (adapterById(needle) ??
+        allAdapters().find((a) => a.processNames.some((n) => n.toLowerCase() === needle)) ??
+        null);
+}
+/**
+ * The session the harness just started or touched: newest among those whose id
+ * is either new (a fresh session) or whose mtime advanced since `before` (a
+ * resumed one — `gmux run codex resume`, `gmux run claude --resume <id>` write to
+ * an EXISTING session file, so no new id ever appears for those).
+ */
+export function pickChangedSession(before, after) {
+    const beforeMtimes = new Map(before.map((r) => [r.sessionId, r.mtimeMs]));
+    const changed = after.filter((r) => {
+        const priorMtime = beforeMtimes.get(r.sessionId);
+        return priorMtime === undefined || r.mtimeMs > priorMtime;
+    });
+    return [...changed].sort((a, b) => b.mtimeMs - a.mtimeMs)[0] ?? null;
+}
+async function captureLink(adapter, paneId, before) {
+    const deadline = Date.now() + DETECT_WINDOW_MS;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, DETECT_POLL_MS));
+        try {
+            const after = await adapter.listSessions();
+            const picked = pickChangedSession(before, after);
+            if (picked) {
+                await writePaneLink({ paneId, harness: adapter.id, sessionId: picked.sessionId });
+                return;
+            }
+        }
+        catch {
+            // The harness may not have written its dir yet; keep watching.
+        }
+    }
+    process.stderr.write(`${dim("gmux: could not link this pane automatically (the overlay will fall back to the cwd heuristic)")}\n`);
+}
+export function registerRun(program) {
+    program
+        .command("run <harness> [args...]")
+        .description("launch an agent and record which pane it runs in, for exact overlay mapping")
+        .allowUnknownOption(true)
+        .action(async (harness, args = []) => {
+        const adapter = resolveHarnessArg(harness);
+        if (!adapter) {
+            process.stderr.write(`error  unknown harness "${harness}". Known: ${allAdapters().map((a) => a.id).join(", ")}\n`);
+            process.exit(2);
+        }
+        const paneId = process.env.TMUX_PANE;
+        const before = paneId ? await adapter.listSessions().catch(() => []) : [];
+        // The wrapper lingers only to capture the session id; stdio is inherited,
+        // so the pane is the agent for all interactive purposes.
+        const child = spawn(adapter.launchCommand, args, { stdio: "inherit" });
+        if (paneId) {
+            process.stderr.write(`${dim(`gmux: linking pane ${paneId} to this ${adapter.displayName} session`)}\n`);
+            void captureLink(adapter, paneId, before);
+        }
+        child.on("error", (error) => {
+            if (error.code === "ENOENT") {
+                process.stderr.write(`error  "${adapter.launchCommand}" is not on your PATH.\n`);
+                process.exit(6);
+            }
+            process.stderr.write(`error  ${error.message}\n`);
+            process.exit(1);
+        });
+        child.on("close", (code) => process.exit(code ?? 0));
+    });
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * `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 { type Interface } from "node:readline/promises";
+import type { Command } from "commander";
+import { type GmConfig, type ProviderChoice } from "../../core/types.js";
+/** One selectable answer to "which provider?". */
+interface Option {
+    label: string;
+    detail: string;
+    /** null = make no model calls. */
+    choose: (rl: Interface) => Promise<ProviderChoice | null>;
+}
+/**
+ * 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 declare function buildOptions(): Option[];
+/**
+ * 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 declare function runSetupWizard(options?: {
+    firstRun?: boolean;
+}): Promise<GmConfig>;
+export declare function registerSetup(program: Command): void;
+export {};