@gigaflow/gmux 0.15.0

package/dist/services/pane-process.js

@@ -0,0 +1,183 @@
+/**
+ * Read which session a tmux pane is running from the pane's own process tree.
+ *
+ * The agent process carries the session id in its command line — `codex resume
+ * <id>`, `claude --resume <id>` — and both ids are exactly gmux's session
+ * id. That is a far stronger signal than the pane's working directory, which is
+ * the *shell's* cwd (usually `~`), not the agent's. Where the argv has no id (a
+ * fresh session), the agent process's real cwd stands in.
+ *
+ * The parsing here is pure and tested; `panePid`/`descendants`/`processCwd` are
+ * thin shells over `tmux`/`pgrep`/`ps`/`lsof`, and every one of them degrades to
+ * a null rather than throwing — a resolve must never fail because a process
+ * vanished mid-walk.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const run = promisify(execFile);
+const UUID = "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}";
+/** A harness binary invoked as a token — excludes MCP children and unrelated node procs. */
+const HARNESS_TOKEN = /(?:^|\/|\s)(?:claude|codex)(?:\s|$)/;
+/**
+ * The session id on an agent's command line, or null.
+ *
+ * Codex writes `codex resume <uuid>`; Claude Code writes `claude --resume <uuid>`
+ * (or `-r`). The id is the standard 8-4-4-4-12 hex form; anything else is not a
+ * session id we can trust, so it reads as null and the caller falls back to cwd.
+ */
+export function parseAgentSession(command) {
+    if (/(?:^|\/|\s)codex(?:\s|$)/.test(command)) {
+        const match = command.match(new RegExp(`resume\\s+(${UUID})`, "i"));
+        if (match)
+            return { harness: "codex", sessionId: match[1].toLowerCase() };
+    }
+    if (/(?:^|\/|\s)claude(?:\s|$)/.test(command)) {
+        const match = command.match(new RegExp(`(?:--resume|-r)\\s+(${UUID})`, "i"));
+        if (match)
+            return { harness: "claude-code", sessionId: match[1].toLowerCase() };
+    }
+    return null;
+}
+/** The harness a command names (claude / codex), even without a session id. */
+export function harnessFromCommand(command) {
+    if (/(?:^|\/|\s)claude(?:\s|$)/.test(command))
+        return "claude-code";
+    if (/(?:^|\/|\s)codex(?:\s|$)/.test(command))
+        return "codex";
+    return null;
+}
+/**
+ * The harness process among a pane's descendants, or null.
+ *
+ * Prefer a process whose argv already yields a session id — that is definitive.
+ * Otherwise the first process that looks like a harness invocation, for its cwd.
+ * An MCP-server child (`node ./mcp/server.mjs`) names no harness, so it is never
+ * chosen over the agent that spawned it.
+ */
+export function pickAgentProcess(procs) {
+    return (procs.find((p) => parseAgentSession(p.command) !== null) ??
+        procs.find((p) => HARNESS_TOKEN.test(p.command)) ??
+        null);
+}
+/**
+ * Parse a `ps` `etime` field — `[[DD-]HH:]MM:SS` — into seconds.
+ *
+ * We use `etime`, not `etimes`: BSD `ps` on macOS has no `etimes` keyword (it
+ * silently drops the column), while `etime` is portable across macOS and Linux.
+ * Only relative order matters to the caller, so absolute wall-clock is not needed.
+ */
+export function parseElapsedSeconds(etime) {
+    const match = etime.trim().match(/^(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+)$/);
+    if (!match)
+        return null;
+    const days = Number(match[1] ?? 0);
+    const hours = Number(match[2] ?? 0);
+    const mins = Number(match[3]);
+    const secs = Number(match[4]);
+    return days * 86400 + hours * 3600 + mins * 60 + secs;
+}
+export function parseProcessSnapshot(output) {
+    const snapshot = new Map();
+    for (const line of output.split("\n")) {
+        const match = line.match(/^\s*(\d+)\s+(\d+)\s+(\S+)\s+(.*)$/);
+        if (!match)
+            continue;
+        snapshot.set(Number(match[1]), {
+            ppid: Number(match[2]),
+            command: match[4].trim(),
+            elapsedSeconds: parseElapsedSeconds(match[3]),
+        });
+    }
+    return snapshot;
+}
+/**
+ * One snapshot of every process, taken once and walked in memory — instead of a
+ * `pgrep` per node down a deep agent tree, which spawned dozens of processes and
+ * dominated resolve latency.
+ */
+export async function processSnapshot() {
+    try {
+        const { stdout } = await run("ps", ["-eo", "pid=,ppid=,etime=,command="]);
+        return parseProcessSnapshot(stdout);
+    }
+    catch {
+        return new Map();
+    }
+}
+/** Every descendant of `rootPid` in the snapshot (pure breadth-first, cycle-safe). */
+export function descendantsOf(rootPid, snapshot) {
+    const childrenByParent = new Map();
+    for (const [pid, entry] of snapshot) {
+        const siblings = childrenByParent.get(entry.ppid);
+        if (siblings)
+            siblings.push(pid);
+        else
+            childrenByParent.set(entry.ppid, [pid]);
+    }
+    const out = [];
+    const seen = new Set([rootPid]);
+    let frontier = [rootPid];
+    while (frontier.length > 0) {
+        const next = [];
+        for (const parent of frontier) {
+            for (const child of childrenByParent.get(parent) ?? []) {
+                if (seen.has(child))
+                    continue;
+                seen.add(child);
+                out.push({ pid: child, command: snapshot.get(child)?.command ?? "" });
+                next.push(child);
+            }
+        }
+        frontier = next;
+    }
+    return out;
+}
+/** A process's real working directory: /proc on Linux, lsof on macOS. Null if unknown. */
+export async function processCwd(pid) {
+    if (process.platform === "linux") {
+        try {
+            const { readlink } = await import("node:fs/promises");
+            return await readlink(`/proc/${pid}/cwd`);
+        }
+        catch {
+            return null;
+        }
+    }
+    try {
+        const { stdout } = await run("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"]);
+        const line = stdout.split("\n").find((l) => l.startsWith("n"));
+        return line ? line.slice(1) : null;
+    }
+    catch {
+        return null;
+    }
+}
+const EMPTY_HINT = {
+    argvSession: null,
+    agentHarness: null,
+    agentCwd: null,
+    agentElapsedSeconds: null,
+};
+/**
+ * What the pane's running agent tells us about its session, from a shared process
+ * snapshot. Never throws — every failure (no agent, no permission) degrades to an
+ * empty hint, and the resolver falls back to its cwd heuristics.
+ */
+export async function paneProcessHint(panePid, snapshot) {
+    try {
+        const agent = pickAgentProcess(descendantsOf(panePid, snapshot));
+        if (!agent)
+            return EMPTY_HINT;
+        const argvSession = parseAgentSession(agent.command);
+        const agentHarness = argvSession?.harness ?? harnessFromCommand(agent.command);
+        // Only pay for the cwd lookup (lsof on macOS, ~100ms) when the argv had no
+        // session id — a resumed session is already resolved exactly, so skip it.
+        const agentCwd = argvSession ? null : await processCwd(agent.pid);
+        const agentElapsedSeconds = snapshot.get(agent.pid)?.elapsedSeconds ?? null;
+        return { argvSession, agentHarness, agentCwd, agentElapsedSeconds };
+    }
+    catch {
+        return EMPTY_HINT;
+    }
+}
+//# sourceMappingURL=pane-process.js.map

package/dist/services/pane-process.js.map

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

package/dist/services/pane-registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Diffs the live tmux pane set into durable `PaneIdentity` records, resolving
+ * each pane's harness/session, and reports which panes appeared or vanished
+ * since the last diff.
+ */
+import type { PaneLink, SessionRecord, TmuxPane } from "../core/types.js";
+import type { PaneIdentity } from "../core/gmux-types.js";
+import type { TmuxGateway } from "./tmux-gateway.js";
+export interface RegistryDiff {
+    present: PaneIdentity[];
+    appeared: string[];
+    vanished: string[];
+}
+export type ResolveFn = (panes: TmuxPane[], records: SessionRecord[], links: PaneLink[]) => Promise<Array<{
+    pane: TmuxPane;
+    record: SessionRecord | null;
+}>>;
+export declare class PaneRegistry {
+    private readonly gateway;
+    private readonly resolve;
+    private known;
+    constructor(gateway: TmuxGateway, resolve?: ResolveFn);
+    diff(): Promise<RegistryDiff>;
+}

package/dist/services/pane-registry.js

@@ -0,0 +1,40 @@
+/**
+ * Diffs the live tmux pane set into durable `PaneIdentity` records, resolving
+ * each pane's harness/session, and reports which panes appeared or vanished
+ * since the last diff.
+ */
+import { cachedRecords } from "./index-store.js";
+import { prunePaneLinks, readPaneLinks } from "./pane-links.js";
+import { resolvePanesLive } from "./tmux-resolve.js";
+export class PaneRegistry {
+    gateway;
+    resolve;
+    known = new Set();
+    constructor(gateway, resolve = resolvePanesLive) {
+        this.gateway = gateway;
+        this.resolve = resolve;
+    }
+    async diff() {
+        const panes = await this.gateway.listPanes();
+        const liveIds = panes.map((p) => p.paneId);
+        const links = await prunePaneLinks(liveIds).catch(() => readPaneLinks());
+        const records = await cachedRecords().catch(() => []);
+        const resolved = await this.resolve(panes, records, links);
+        const present = resolved.map(({ pane, record }) => ({
+            paneId: pane.paneId,
+            windowId: pane.windowId,
+            active: pane.active,
+            harness: record?.harness ?? null,
+            sessionId: record?.sessionId ?? null,
+            cwd: pane.cwd,
+            command: pane.command,
+            pid: pane.pid,
+        }));
+        const liveSet = new Set(liveIds);
+        const appeared = liveIds.filter((id) => !this.known.has(id));
+        const vanished = [...this.known].filter((id) => !liveSet.has(id));
+        this.known = liveSet;
+        return { present, appeared, vanished };
+    }
+}
+//# sourceMappingURL=pane-registry.js.map

package/dist/services/pane-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane-registry.js","sourceRoot":"","sources":["../../src/services/pane-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAerD,MAAM,OAAO,YAAY;IAIJ;IACA;IAJX,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,YACmB,OAAoB,EACpB,UAAqB,gBAAgB;QADrC,YAAO,GAAP,OAAO,CAAa;QACpB,YAAO,GAAP,OAAO,CAA8B;IACrD,CAAC;IAEJ,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAqB,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAmB,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAClE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI;YAChC,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI;YACpC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC,CAAC;QAEJ,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/services/provider-process.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Running a provider CLI: prompt in on stdin, text out on stdout.
+ *
+ * The whole vendor abstraction lives here. Both consumers — summaries and
+ * `gmux ask` — spawn the same way and differ only in argv and timeout, so the
+ * spawn, the timeout, the kill and the stderr capture are written once.
+ *
+ * Errors are plain `Error`s with a readable message; callers wrap them in their
+ * own typed error so the `fix` line can say something specific to what failed.
+ */
+export interface RunProviderOptions {
+    timeoutMs: number;
+    /**
+     * Environment for the child.
+     *
+     * Defaults to `childEnv()` — ours plus GMUX_CHILD=1 — because every
+     * provider we spawn is an agent that may shell back into `gmux`, and a nested
+     * `gmux` must not start a background summarize pass of its own.
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Decoded stdout as it arrives, in order, never a partial UTF-8 sequence,
+     * never after the promise settles. Throwing here is swallowed.
+     *
+     * Every byte handed here is also in the resolved string, in the same order:
+     * `resolved === chunks.join("")`. That is what lets a caller record the
+     * answer from the resolved string without a late chunk racing it.
+     *
+     * A tee, not a mechanism. `claude -p` buffers, so against it this fires
+     * exactly once — but gmux is provider-agnostic, and a provider that trickles
+     * gets incremental rendering out of it for free, with no second code path.
+     */
+    onChunk?: (text: string) => void;
+    /** Aborting SIGKILLs the child and rejects. */
+    signal?: AbortSignal;
+}
+export declare function runProviderCommand(argv: readonly string[], prompt: string, options: RunProviderOptions): Promise<string>;

package/dist/services/provider-process.js

@@ -0,0 +1,105 @@
+/**
+ * Running a provider CLI: prompt in on stdin, text out on stdout.
+ *
+ * The whole vendor abstraction lives here. Both consumers — summaries and
+ * `gmux ask` — spawn the same way and differ only in argv and timeout, so the
+ * spawn, the timeout, the kill and the stderr capture are written once.
+ *
+ * Errors are plain `Error`s with a readable message; callers wrap them in their
+ * own typed error so the `fix` line can say something specific to what failed.
+ */
+import { spawn } from "node:child_process";
+import { StringDecoder } from "node:string_decoder";
+import { childEnv } from "./config.js";
+export async function runProviderCommand(argv, prompt, options) {
+    const [binary, ...args] = argv;
+    if (!binary)
+        throw new Error("provider command is empty");
+    return new Promise((resolve, reject) => {
+        // Checked before the spawn: a caller that aborts first must not leave a
+        // provider running that nobody is waiting for — it would keep billing.
+        if (options.signal?.aborted) {
+            reject(new Error("aborted"));
+            return;
+        }
+        const child = spawn(binary, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: options.env ?? childEnv(),
+        });
+        // Not `String(chunk)`: Node splits a stream at arbitrary byte boundaries, so
+        // a 3-byte `—` straddling one decodes as `��` on both sides. The decoder
+        // holds the incomplete tail until the rest of it arrives.
+        const outDecoder = new StringDecoder("utf8");
+        const errDecoder = new StringDecoder("utf8");
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        const timer = setTimeout(() => {
+            finish(() => {
+                child.kill("SIGKILL");
+                reject(new Error(`timed out after ${options.timeoutMs}ms`));
+            });
+        }, options.timeoutMs);
+        // Not `detached: true`, and that is deliberate: the caller that cancels us
+        // is itself the group leader (`spawn(…, { detached: true })` in the worker),
+        // and it kills the whole group. A provider in a group of its own would
+        // survive that kill — the exact orphan the group kill exists to prevent.
+        const onAbort = () => {
+            finish(() => {
+                child.kill("SIGKILL");
+                reject(new Error("aborted"));
+            });
+        };
+        options.signal?.addEventListener("abort", onAbort, { once: true });
+        function finish(fn) {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            options.signal?.removeEventListener("abort", onAbort);
+            fn();
+        }
+        // Ordered before the string it tees, so the resolved value can never contain
+        // a byte the caller was not handed first. Throwing is the caller's problem,
+        // not the provider run's.
+        const tee = (text) => {
+            if (settled || !text)
+                return;
+            try {
+                options.onChunk?.(text);
+            }
+            catch {
+                /* swallowed */
+            }
+        };
+        child.stdout.on("data", (chunk) => {
+            const text = outDecoder.write(chunk);
+            stdout += text;
+            tee(text);
+        });
+        child.stderr.on("data", (chunk) => (stderr += errDecoder.write(chunk)));
+        child.on("error", (error) => finish(() => reject(new Error(error.message))));
+        child.on("close", (code) => {
+            // `end()` flushes a trailing incomplete sequence — a truncated output's
+            // last bytes become `�` rather than vanishing. Teed before settle, so the
+            // ordering guarantee holds through the flush.
+            const rest = outDecoder.end();
+            stdout += rest;
+            tee(rest);
+            stderr += errDecoder.end();
+            finish(() => {
+                if (code === 0)
+                    resolve(stdout);
+                else
+                    reject(new Error(stderr.trim() || `exited with code ${code}`));
+            });
+        });
+        // EPIPE: a provider that exits before reading its prompt would otherwise
+        // take the whole process down with an unhandled error event, turning a
+        // provider bug into a gmux crash.
+        child.stdin.on("error", () => { });
+        child.stdin.write(prompt);
+        child.stdin.end();
+    });
+}
+//# sourceMappingURL=provider-process.js.map

package/dist/services/provider-process.js.map

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

package/dist/services/providers.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The catalog of model CLIs gmux knows how to call.
+ *
+ * This is deliberately NOT `adapters/registry.ts`, and the two must not be
+ * merged. They are different axes that only coincidentally share names today:
+ *
+ * - An **adapter** reads sessions off disk. It answers "what happened?"
+ * - A **provider** makes a model call. It answers "what does it mean?"
+ *
+ * You might read Claude Code transcripts while running summaries through Codex.
+ * A provider may exist that no adapter parses. Conflating them would couple two
+ * things that have no reason to move together.
+ *
+ * A provider is described by argv, not by an SDK. That is the entire abstraction
+ * — see docs/architecture.md — and it is why adding one is four lines here.
+ */
+import type { ProviderChoice } from "../core/types.js";
+export interface ProviderSpec {
+    /** Stable id, recorded in config. */
+    id: string;
+    displayName: string;
+    /** The binary probed on PATH. */
+    binary: string;
+    /** argv for a one-shot summary call: prompt on stdin, text on stdout. */
+    summaryArgv: string[];
+    /**
+     * argv for an `gmux ask` call.
+     *
+     * Differs from `summaryArgv` in exactly one way: it grants the model
+     * permission to run `gmux grep`, so it can dig past the summaries into the
+     * transcripts. The tool loop is the harness's — we parse no tool calls.
+     */
+    askArgv: string[];
+    /** What to tell a user who hasn't got it. */
+    install: string;
+}
+/** The id used when a user supplies their own command. */
+export declare const CUSTOM_PROVIDER_ID = "custom";
+/**
+ * Known providers, in preference order — the first one detected becomes the
+ * default when there is no config, which reproduces today's `claude -p`.
+ */
+export declare const PROVIDERS: readonly ProviderSpec[];
+/** True when `binary` resolves on PATH. */
+export declare function onPath(binary: string): boolean;
+export declare function providerById(id: string): ProviderSpec | null;
+/** Every catalog provider actually installed on this machine, in catalog order. */
+export declare function detectProviders(): ProviderSpec[];
+/** The provider we'd pick for someone who has never run `gmux setup`. */
+export declare function firstDetected(): ProviderSpec | null;
+/**
+ * The summary argv for a configured choice.
+ *
+ * A catalog provider gets its current `summaryArgv` — NOT the `command` frozen
+ * into config at setup time. That stored command is only ever a snapshot of the
+ * catalog, and a snapshot goes stale: codex gained `--skip-git-repo-check` after
+ * it shipped, and a config written before that would otherwise call codex
+ * without the flag forever, failing every summary with "not inside a trusted
+ * directory". The catalog is the source of truth for a known id; the stored
+ * command matters only for a `custom` provider, whose flags we cannot invent.
+ *
+ * The exact mirror of `askArgvFor` — the two must move together, or ask
+ * self-heals across catalog fixes while summarize silently does not.
+ */
+export declare function summaryArgvFor(choice: ProviderChoice): string[];
+/**
+ * The ask argv for a configured choice.
+ *
+ * A catalog provider gets its `askArgv` — the variant with the grep grant. A
+ * custom command cannot: we don't know its flags, so we run it exactly as the
+ * user wrote it. It may still answer from the summaries alone, which is the
+ * degraded-but-working outcome rather than a broken one.
+ */
+export declare function askArgvFor(choice: ProviderChoice): string[];
+/** Turn a catalog entry into the thing that gets written to config. */
+export declare function toChoice(spec: ProviderSpec): ProviderChoice;

package/dist/services/providers.js

@@ -0,0 +1,104 @@
+/**
+ * The catalog of model CLIs gmux knows how to call.
+ *
+ * This is deliberately NOT `adapters/registry.ts`, and the two must not be
+ * merged. They are different axes that only coincidentally share names today:
+ *
+ * - An **adapter** reads sessions off disk. It answers "what happened?"
+ * - A **provider** makes a model call. It answers "what does it mean?"
+ *
+ * You might read Claude Code transcripts while running summaries through Codex.
+ * A provider may exist that no adapter parses. Conflating them would couple two
+ * things that have no reason to move together.
+ *
+ * A provider is described by argv, not by an SDK. That is the entire abstraction
+ * — see docs/architecture.md — and it is why adding one is four lines here.
+ */
+import { spawnSync } from "node:child_process";
+/** The id used when a user supplies their own command. */
+export const CUSTOM_PROVIDER_ID = "custom";
+/**
+ * Known providers, in preference order — the first one detected becomes the
+ * default when there is no config, which reproduces today's `claude -p`.
+ */
+export const PROVIDERS = [
+    {
+        id: "claude-code",
+        displayName: "Claude Code",
+        binary: "claude",
+        summaryArgv: ["claude", "-p"],
+        // Bash is scoped to `gmux grep` alone: the model may read what it already has
+        // the ids for, and nothing else. A blanket Bash grant would hand a session
+        // summariser the whole machine.
+        askArgv: ["claude", "-p", "--allowedTools", "Bash(gmux grep:*)"],
+        install: "npm install -g @anthropic-ai/claude-code",
+    },
+    {
+        id: "codex",
+        displayName: "Codex",
+        binary: "codex",
+        // These prompts describe sessions, not the repository gmux happens to be
+        // launched from. Codex must therefore work outside a trusted git checkout.
+        summaryArgv: ["codex", "exec", "--skip-git-repo-check"],
+        askArgv: [
+            "codex",
+            "exec",
+            "--sandbox",
+            "read-only",
+            "--skip-git-repo-check",
+        ],
+        install: "npm install -g @openai/codex",
+    },
+];
+/** True when `binary` resolves on PATH. */
+export function onPath(binary) {
+    if (binary.trim() === "")
+        return false;
+    return spawnSync("which", [binary], { stdio: "ignore" }).status === 0;
+}
+export function providerById(id) {
+    return PROVIDERS.find((p) => p.id === id) ?? null;
+}
+/** Every catalog provider actually installed on this machine, in catalog order. */
+export function detectProviders() {
+    return PROVIDERS.filter((provider) => onPath(provider.binary));
+}
+/** The provider we'd pick for someone who has never run `gmux setup`. */
+export function firstDetected() {
+    return detectProviders()[0] ?? null;
+}
+/**
+ * The summary argv for a configured choice.
+ *
+ * A catalog provider gets its current `summaryArgv` — NOT the `command` frozen
+ * into config at setup time. That stored command is only ever a snapshot of the
+ * catalog, and a snapshot goes stale: codex gained `--skip-git-repo-check` after
+ * it shipped, and a config written before that would otherwise call codex
+ * without the flag forever, failing every summary with "not inside a trusted
+ * directory". The catalog is the source of truth for a known id; the stored
+ * command matters only for a `custom` provider, whose flags we cannot invent.
+ *
+ * The exact mirror of `askArgvFor` — the two must move together, or ask
+ * self-heals across catalog fixes while summarize silently does not.
+ */
+export function summaryArgvFor(choice) {
+    const spec = providerById(choice.id);
+    return spec ? [...spec.summaryArgv] : [...choice.command];
+}
+/**
+ * The ask argv for a configured choice.
+ *
+ * A catalog provider gets its `askArgv` — the variant with the grep grant. A
+ * custom command cannot: we don't know its flags, so we run it exactly as the
+ * user wrote it. It may still answer from the summaries alone, which is the
+ * degraded-but-working outcome rather than a broken one.
+ */
+export function askArgvFor(choice) {
+    const spec = providerById(choice.id);
+    return spec ? [...spec.askArgv] : [...choice.command];
+}
+/** Turn a catalog entry into the thing that gets written to config. */
+export function toChoice(spec) {
+    return { id: spec.id, command: [...spec.summaryArgv] };
+}
+//# sourceMappingURL=providers.js.map

package/dist/services/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/services/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAwB/C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAA4B;IAChD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,aAAa;QAC1B,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC7B,8EAA8E;QAC9E,2EAA2E;QAC3E,gCAAgC;QAChC,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;QAChE,OAAO,EAAE,0CAA0C;KACpD;IACD;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,OAAO;QACf,yEAAyE;QACzE,2EAA2E;QAC3E,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,uBAAuB,CAAC;QACvD,OAAO,EAAE;YACP,OAAO;YACP,MAAM;YACN,WAAW;YACX,WAAW;YACX,uBAAuB;SACxB;QACD,OAAO,EAAE,8BAA8B;KACxC;CACF,CAAC;AAEF,2CAA2C;AAC3C,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC;AACpD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,IAAkB;IACzC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;AACzD,CAAC"}

package/dist/services/resolve.d.ts

@@ -0,0 +1,3 @@
+/** Resolve a user-typed id — usually a short prefix — to exactly one session. */
+import type { SessionRecord } from "../core/types.js";
+export declare function resolveSession(records: readonly SessionRecord[], id: string): SessionRecord;

package/dist/services/resolve.js

@@ -0,0 +1,18 @@
+/** Resolve a user-typed id — usually a short prefix — to exactly one session. */
+import { AmbiguousSessionError, SessionNotFoundError } from "../core/errors.js";
+export function resolveSession(records, id) {
+    const needle = id.trim().toLowerCase();
+    if (needle === "")
+        throw new SessionNotFoundError(id);
+    const exact = records.find((r) => r.sessionId.toLowerCase() === needle);
+    if (exact)
+        return exact;
+    const matches = records.filter((r) => r.sessionId.toLowerCase().startsWith(needle));
+    if (matches.length === 0)
+        throw new SessionNotFoundError(id);
+    if (matches.length > 1) {
+        throw new AmbiguousSessionError(id, matches.map((m) => m.sessionId));
+    }
+    return matches[0];
+}
+//# sourceMappingURL=resolve.js.map

package/dist/services/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/services/resolve.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGhF,MAAM,UAAU,cAAc,CAAC,OAAiC,EAAE,EAAU;IAC1E,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IACxE,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,qBAAqB,CAC7B,EAAE,EACF,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAChC,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC"}

package/dist/services/resources.d.ts

@@ -0,0 +1,17 @@
+import type { HostPressure, PaneResources } from "../core/gmux-types.js";
+export interface ResourceDeps {
+    psSnapshot: () => Promise<string>;
+    hostMemory: () => Promise<{
+        usedRatio: number;
+        usedBytes: number;
+    }>;
+}
+export declare function defaultResourceDeps(): ResourceDeps;
+export declare class ResourceMonitor {
+    private deps;
+    constructor(deps?: Partial<ResourceDeps>);
+    sample(panePids: Map<string, number>): Promise<{
+        perPane: Map<string, PaneResources>;
+        host: HostPressure;
+    }>;
+}