@gigaflow/gmux 0.15.0

package/dist/services/daemon.js.map

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

package/dist/services/distill.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Distillation: turn a session record into the small bundle of evidence a model
+ * needs to say where the work landed.
+ *
+ * This is the heart of the tool. Two properties matter:
+ *
+ * 1. **The arc, not one endpoint.** We send where the work started, a few
+ *    waypoints through it, and how it ended. Head-only is the bug we exist to
+ *    fix — that just restates the stale `aiTitle`. But tail-only overcorrects:
+ *    a status with no subject ("timestamp check still red") is unreadable next
+ *    to twenty others. Never head-only; never the head speaking alone.
+ *
+ * 2. **Small.** The distilled input is a couple of KB regardless of whether the
+ *    session was 20 messages or 2,000, so summarizing is cheap and bounded.
+ */
+import type { SessionRecord, SummaryInput } from "../core/types.js";
+/**
+ * Bump when `buildPrompt` changes what it asks for.
+ *
+ * The summary cache is keyed on the hash below, which covers session content
+ * only — so without this, editing the prompt would change nothing for anything
+ * already summarized: those sessions keep their old summaries until their
+ * transcripts happen to change, which for a finished session is never.
+ *
+ * Bumping marks every cached summary stale at once, and they regenerate through
+ * the normal background pass. No cache wipe, no migration.
+ *
+ * 2: headlines tightened to a short scannable clause (was "max 80 chars",
+ *    which overflowed the 72-char row and read as truncated).
+ * 3: summaries describe the arc, not just the tail — the prompt gained the
+ *    original ask, and the output gained `overview`. The headline changed
+ *    meaning: it now says what the work IS, not what state it is in.
+ * 4: added `summary` — a paragraph-or-two drilldown between `overview` and the
+ *    status fields, for reorienting on a session without opening it.
+ */
+export declare const PROMPT_VERSION = 4;
+export declare function distill(record: SessionRecord): SummaryInput;
+/** The instruction given to whichever model provider is configured. */
+export declare function buildPrompt(input: SummaryInput): string;

package/dist/services/distill.js

@@ -0,0 +1,93 @@
+/**
+ * Distillation: turn a session record into the small bundle of evidence a model
+ * needs to say where the work landed.
+ *
+ * This is the heart of the tool. Two properties matter:
+ *
+ * 1. **The arc, not one endpoint.** We send where the work started, a few
+ *    waypoints through it, and how it ended. Head-only is the bug we exist to
+ *    fix — that just restates the stale `aiTitle`. But tail-only overcorrects:
+ *    a status with no subject ("timestamp check still red") is unreadable next
+ *    to twenty others. Never head-only; never the head speaking alone.
+ *
+ * 2. **Small.** The distilled input is a couple of KB regardless of whether the
+ *    session was 20 messages or 2,000, so summarizing is cheap and bounded.
+ */
+import { hash } from "../core/text.js";
+/**
+ * Bump when `buildPrompt` changes what it asks for.
+ *
+ * The summary cache is keyed on the hash below, which covers session content
+ * only — so without this, editing the prompt would change nothing for anything
+ * already summarized: those sessions keep their old summaries until their
+ * transcripts happen to change, which for a finished session is never.
+ *
+ * Bumping marks every cached summary stale at once, and they regenerate through
+ * the normal background pass. No cache wipe, no migration.
+ *
+ * 2: headlines tightened to a short scannable clause (was "max 80 chars",
+ *    which overflowed the 72-char row and read as truncated).
+ * 3: summaries describe the arc, not just the tail — the prompt gained the
+ *    original ask, and the output gained `overview`. The headline changed
+ *    meaning: it now says what the work IS, not what state it is in.
+ * 4: added `summary` — a paragraph-or-two drilldown between `overview` and the
+ *    status fields, for reorienting on a session without opening it.
+ */
+export const PROMPT_VERSION = 4;
+export function distill(record) {
+    const input = {
+        promptVersion: PROMPT_VERSION,
+        harness: record.harness,
+        sessionId: record.sessionId,
+        project: record.project,
+        gitBranch: record.gitBranch,
+        title: record.title,
+        recentUserPrompts: record.recentUserPrompts,
+        arcPrompts: record.arcPrompts,
+        lastAssistantText: record.lastAssistantText,
+        // Cap the file list: a refactor touching 200 files should not dominate the prompt.
+        filesTouched: record.filesTouched.slice(0, 25),
+        lastToolFailure: record.lastToolFailure,
+        endedMidTask: record.endedMidTask,
+    };
+    return { ...input, hash: hash(JSON.stringify(input)) };
+}
+/** The instruction given to whichever model provider is configured. */
+export function buildPrompt(input) {
+    const lines = [];
+    lines.push("You are summarizing a coding-agent session so a developer can decide, at a glance, whether to pick it back up.", "", "You are shown the ARC of the session: where it started, waypoints through the middle, and how it ended. Describe where the work ACTUALLY LANDED — and what it is fundamentally about, which may not be what it set out to do.", "", "## Session", `harness: ${input.harness}`);
+    if (input.project)
+        lines.push(`project: ${input.project}`);
+    if (input.gitBranch)
+        lines.push(`branch: ${input.gitBranch}`);
+    if (input.title)
+        lines.push(`title recorded at session START (may be stale): ${input.title}`);
+    lines.push(`ended mid-task: ${input.endedMidTask ? "yes" : "no"}`);
+    if (input.filesTouched.length > 0) {
+        lines.push("", "## Files the agent changed", ...input.filesTouched.map((f) => `- ${f}`));
+    }
+    // Only what the tail does not already carry. On a short session the sampler
+    // and the tail window hold the same turns, and printing both would make the
+    // model read the duplication as emphasis.
+    const tail = new Set(input.recentUserPrompts);
+    const [anchor, ...waypoints] = input.arcPrompts;
+    const freshWaypoints = waypoints.filter((p) => !tail.has(p));
+    if (anchor !== undefined && !tail.has(anchor)) {
+        lines.push("", "## The original ask (how this session opened)", anchor);
+    }
+    if (freshWaypoints.length > 0) {
+        lines.push("", "## How the work moved (sampled across the session, oldest first)", ...freshWaypoints.map((p) => `- ${p}`));
+    }
+    if (input.recentUserPrompts.length > 0) {
+        lines.push("", "## The developer's most recent instructions (oldest first — the LAST one matters most)", ...input.recentUserPrompts.map((p) => `- ${p}`));
+    }
+    if (input.lastAssistantText) {
+        lines.push("", "## The agent's final message", input.lastAssistantText);
+    }
+    if (input.lastToolFailure) {
+        lines.push("", "## The last failing command", input.lastToolFailure);
+    }
+    lines.push("", "## Output", "Reply with ONLY a JSON object, no code fence, no commentary:", "{", '  "headline": "what this work IS, one clause, under 60 chars, no trailing period",', '  "overview": "2-3 sentences: what this session is fundamentally about, including how the goal shifted if it did",', '  "summary": "a paragraph or two: the real drilldown. Trace how the work evolved — the original goal, the turns it took, decisions and dead ends — and land on where it stands now. Enough that a developer who has not seen this session can reorient. Longer sessions warrant more; short ones stay short.",', '  "landed": "1-2 sentences: the MOST RECENT work done",', '  "open": "1-2 sentences: what is unresolved, blocked, or broken. \'Nothing outstanding.\' if genuinely finished",', '  "nextStep": "one concrete next action a developer would take"', "}", "", "These three describe the same work at widening zoom — never contradicting, each adding detail:", "  headline  — a scannable clause, read at a glance next to twenty others;", "  overview  — 2-3 sentences of what it is about;", "  summary   — a paragraph or two that actually reorients you.", "Write a clause, not a sentence:", '  good: "Migrating webhook retries to the new queue backend"', '  bad:  "The retry logic has been partially applied, but the signature verification test is still failing."', "", "`landed` is the LATEST work, not a recap of the whole session — that is what `overview` is for.", "", "Be specific and factual. Name the files, tests, and errors involved. Never speculate beyond the evidence above.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=distill.js.map

package/dist/services/distill.js.map

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

package/dist/services/guardian.d.ts

@@ -0,0 +1,26 @@
+import type { GuardianPolicy, HostPressure, PaneEntry } from "../core/gmux-types.js";
+export interface GuardianDecision {
+    action: "broadcast" | "notify" | "log-only" | "none";
+    culpritPaneId: string | null;
+    culpritLabel: string;
+    message: string;
+}
+/**
+ * Pure policy state machine: pressure + policy + clock in, a decision out.
+ * The ONE component that acts (types into agents via the caller), so it
+ * carries no I/O of its own — decide() is a pure function of its inputs
+ * plus the instance's own fire-history state (firedAt/belowSinceFire).
+ */
+export declare class Guardian {
+    private readonly opts;
+    private firedAt;
+    private belowSinceFire;
+    constructor(opts: {
+        policy: GuardianPolicy;
+        threshold: number;
+        cooldownSeconds: number;
+    });
+    decide(host: HostPressure, panes: PaneEntry[], now: number): GuardianDecision;
+    private fire;
+    private none;
+}

package/dist/services/guardian.js

@@ -0,0 +1,71 @@
+import { basename } from "node:path";
+/**
+ * Pure policy state machine: pressure + policy + clock in, a decision out.
+ * The ONE component that acts (types into agents via the caller), so it
+ * carries no I/O of its own — decide() is a pure function of its inputs
+ * plus the instance's own fire-history state (firedAt/belowSinceFire).
+ */
+export class Guardian {
+    opts;
+    firedAt = null;
+    belowSinceFire = false;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    decide(host, panes, now) {
+        const over = host.usedRatio >= this.opts.threshold;
+        if (!over) {
+            if (this.firedAt !== null)
+                this.belowSinceFire = true;
+            return this.none();
+        }
+        // In cooldown? Stay quiet unless pressure dropped and re-crossed since the
+        // last fire (hysteresis), or the cooldown window has fully elapsed.
+        if (this.firedAt !== null) {
+            const elapsed = (now - this.firedAt) / 1000;
+            const mayRefire = this.belowSinceFire || elapsed >= this.opts.cooldownSeconds;
+            if (!mayRefire)
+                return this.none();
+        }
+        const { culprit, label } = topConsumer(panes, host);
+        const agents = panes.filter((p) => p.identity.harness && p.identity.sessionId);
+        const pct = Math.round(host.usedRatio * 100);
+        const message = `host memory ${pct}% — top consumer: ${label}; checkpoint your work and pause non-essential tasks.`;
+        if (this.opts.policy === "off") {
+            return { action: "log-only", culpritPaneId: culprit, culpritLabel: label, message };
+        }
+        if (this.opts.policy === "notify") {
+            return this.fire("notify", culprit, label, message, now);
+        }
+        // policy === "auto"
+        if (agents.length === 0) {
+            return { action: "log-only", culpritPaneId: culprit, culpritLabel: label, message };
+        }
+        return this.fire("broadcast", culprit, label, message, now);
+    }
+    fire(action, culprit, label, message, now) {
+        this.firedAt = now;
+        this.belowSinceFire = false;
+        return { action, culpritPaneId: culprit, culpritLabel: label, message };
+    }
+    none() {
+        return { action: "none", culpritPaneId: null, culpritLabel: "", message: "" };
+    }
+}
+function topConsumer(panes, host) {
+    let best = null;
+    for (const p of panes) {
+        if (p.resources && (!best || p.resources.perPaneRss > best.resources.perPaneRss))
+            best = p;
+    }
+    const bestRss = best?.resources?.perPaneRss ?? 0;
+    if (!best || host.unattributed > bestRss) {
+        return { culprit: null, label: "a source outside tracked panes" };
+    }
+    const name = best.identity.cwd ? basename(best.identity.cwd) : best.identity.command;
+    // Binary units (matches the cockpit's formatBytes) so the same pane shows
+    // the same GB figure in both the cockpit memory column and this message.
+    const gb = (bestRss / 1024 ** 3).toFixed(1);
+    return { culprit: best.identity.paneId, label: `window \`${name}\` (${gb} GB)` };
+}
+//# sourceMappingURL=guardian.js.map

package/dist/services/guardian.js.map

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

package/dist/services/index-store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The session index.
+ *
+ * Parsing 1,000+ sessions on every invocation would make `gmux` unusable, so we
+ * cache parsed records keyed on each file's (mtime, size). A file whose stats
+ * are unchanged is served from cache; anything else is re-parsed. That keeps a
+ * warm `gmux ls` in the millisecond range while staying correct as sessions grow.
+ */
+import type { ListFilters, SessionRecord, SessionRef } from "../core/types.js";
+export interface RefreshResult {
+    records: SessionRecord[];
+    parsed: number;
+    cached: number;
+}
+/** Every session file every installed harness knows about. */
+export declare function discover(): Promise<SessionRef[]>;
+/**
+ * Bring the index up to date and return every known session record.
+ *
+ * `force` re-parses everything, for when a parser bug is fixed and the cached
+ * records are wrong rather than stale.
+ */
+export declare function refreshIndex(options?: {
+    force?: boolean;
+}): Promise<RefreshResult>;
+/**
+ * Records straight from the on-disk cache — no directory discovery, no re-stat.
+ *
+ * A fast, slightly-stale read for latency-sensitive callers (the overlay's first
+ * paint): it skips the thousands-of-files scan `refreshIndex` does, at the cost
+ * of missing sessions created since the last refresh. The caller upgrades to
+ * `refreshIndex` in the background.
+ */
+export declare function cachedRecords(): Promise<SessionRecord[]>;
+/** Apply the shared `ls`/picker filters. Pure — exported for tests. */
+export declare function filterRecords(records: readonly SessionRecord[], filters: ListFilters): SessionRecord[];

package/dist/services/index-store.js

@@ -0,0 +1,125 @@
+/**
+ * The session index.
+ *
+ * Parsing 1,000+ sessions on every invocation would make `gmux` unusable, so we
+ * cache parsed records keyed on each file's (mtime, size). A file whose stats
+ * are unchanged is served from cache; anything else is re-parsed. That keeps a
+ * warm `gmux ls` in the millisecond range while staying correct as sessions grow.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { indexPath } from "../core/paths.js";
+import { availableAdapters, adapterById } from "../adapters/registry.js";
+import { mapLimit } from "./concurrency.js";
+const PARSE_CONCURRENCY = 16;
+/** Bump whenever SessionRecord changes shape, so stale caches are discarded. */
+const INDEX_VERSION = 3;
+async function loadIndexFile() {
+    try {
+        const raw = await readFile(indexPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== INDEX_VERSION || !Array.isArray(parsed.entries))
+            return new Map();
+        return new Map(parsed.entries.map((e) => [e.record.filePath, e]));
+    }
+    catch {
+        return new Map(); // Missing or corrupt cache is not an error; rebuild it.
+    }
+}
+async function saveIndexFile(entries) {
+    const path = indexPath();
+    await mkdir(dirname(path), { recursive: true });
+    const payload = { version: INDEX_VERSION, entries: [...entries.values()] };
+    // Write-then-rename: a killed `gmux` must never leave a half-written index.
+    const temp = `${path}.${process.pid}.tmp`;
+    await writeFile(temp, JSON.stringify(payload), "utf8");
+    await rename(temp, path);
+}
+/** Every session file every installed harness knows about. */
+export async function discover() {
+    const adapters = await availableAdapters();
+    const lists = await Promise.all(adapters.map((a) => a.listSessions()));
+    return lists.flat();
+}
+/**
+ * Bring the index up to date and return every known session record.
+ *
+ * `force` re-parses everything, for when a parser bug is fixed and the cached
+ * records are wrong rather than stale.
+ */
+export async function refreshIndex(options = {}) {
+    const cache = options.force ? new Map() : await loadIndexFile();
+    const refs = await discover();
+    let parsed = 0;
+    let cached = 0;
+    const records = await mapLimit(refs, PARSE_CONCURRENCY, async (ref) => {
+        const hit = cache.get(ref.filePath);
+        if (hit && hit.mtimeMs === ref.mtimeMs && hit.size === ref.size) {
+            cached += 1;
+            return hit.record;
+        }
+        const adapter = adapterById(ref.harness);
+        if (!adapter)
+            return null;
+        try {
+            const record = await adapter.parseSession(ref);
+            parsed += 1;
+            return record;
+        }
+        catch {
+            return null; // One unreadable session must not sink the whole index.
+        }
+    });
+    const next = new Map();
+    for (let i = 0; i < refs.length; i++) {
+        const record = records[i];
+        const ref = refs[i];
+        if (!record)
+            continue;
+        next.set(ref.filePath, { mtimeMs: ref.mtimeMs, size: ref.size, record });
+    }
+    await saveIndexFile(next);
+    const all = [...next.values()].map((e) => e.record);
+    all.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    return { records: all, parsed, cached };
+}
+/**
+ * Records straight from the on-disk cache — no directory discovery, no re-stat.
+ *
+ * A fast, slightly-stale read for latency-sensitive callers (the overlay's first
+ * paint): it skips the thousands-of-files scan `refreshIndex` does, at the cost
+ * of missing sessions created since the last refresh. The caller upgrades to
+ * `refreshIndex` in the background.
+ */
+export async function cachedRecords() {
+    const records = [...(await loadIndexFile()).values()].map((e) => e.record);
+    records.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    return records;
+}
+/** Apply the shared `ls`/picker filters. Pure — exported for tests. */
+export function filterRecords(records, filters) {
+    let out = [...records];
+    if (!filters.includeSidechains)
+        out = out.filter((r) => !r.isSidechain);
+    if (!filters.includeAutomated)
+        out = out.filter((r) => !r.isAutomated);
+    if (filters.harness)
+        out = out.filter((r) => r.harness === filters.harness);
+    if (filters.project) {
+        const needle = filters.project.toLowerCase();
+        out = out.filter((r) => (r.project ?? "").toLowerCase().includes(needle));
+    }
+    if (filters.branch) {
+        const needle = filters.branch.toLowerCase();
+        out = out.filter((r) => (r.gitBranch ?? "").toLowerCase().includes(needle));
+    }
+    if (filters.since) {
+        const cutoff = filters.since;
+        out = out.filter((r) => r.updatedAt >= cutoff);
+    }
+    out.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    if (filters.limit != null && filters.limit > 0)
+        out = out.slice(0, filters.limit);
+    return out;
+}
+//# sourceMappingURL=index-store.js.map

package/dist/services/index-store.js.map

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

package/dist/services/log-rotation.d.ts

@@ -0,0 +1,3 @@
+export declare const MAX_PANE_LOG_BYTES: number;
+export declare function rotateIfLarge(logPath: string, maxBytes: number): Promise<boolean>;
+export declare function pruneLog(logPath: string): Promise<void>;

package/dist/services/log-rotation.js

@@ -0,0 +1,28 @@
+import { rm, stat, open } from "node:fs/promises";
+export const MAX_PANE_LOG_BYTES = 5 * 1024 * 1024;
+export async function rotateIfLarge(logPath, maxBytes) {
+    let size;
+    try {
+        size = (await stat(logPath)).size;
+    }
+    catch {
+        return false;
+    }
+    if (size <= maxBytes)
+        return false;
+    const fh = await open(logPath, "r+");
+    try {
+        const keep = Buffer.alloc(maxBytes);
+        await fh.read(keep, 0, maxBytes, size - maxBytes);
+        await fh.truncate(0);
+        await fh.write(keep, 0, maxBytes, 0);
+    }
+    finally {
+        await fh.close();
+    }
+    return true;
+}
+export async function pruneLog(logPath) {
+    await rm(logPath, { force: true });
+}
+//# sourceMappingURL=log-rotation.js.map

package/dist/services/log-rotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-rotation.js","sourceRoot":"","sources":["../../src/services/log-rotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,QAAgB;IAEhB,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEnC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe;IAC5C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * The pane→session links `gmux run` records, so the overlay maps a live pane to
+ * the exact session it launched rather than guessing. Cache, disposable, pruned
+ * to the live pane set on every overlay render.
+ */
+import type { PaneLink } from "../core/types.js";
+export declare function readPaneLinks(): Promise<PaneLink[]>;
+export declare function writePaneLink(link: PaneLink): Promise<void>;
+export declare function prunePaneLinks(livePaneIds: Iterable<string>): Promise<PaneLink[]>;
+export declare function linkForPane(links: readonly PaneLink[], paneId: string): PaneLink | null;

package/dist/services/pane-links.js

@@ -0,0 +1,47 @@
+/**
+ * The pane→session links `gmux run` records, so the overlay maps a live pane to
+ * the exact session it launched rather than guessing. Cache, disposable, pruned
+ * to the live pane set on every overlay render.
+ */
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { paneLinksPath } from "../core/paths.js";
+function isPaneLink(value) {
+    const link = value;
+    return (!!link &&
+        typeof link.paneId === "string" &&
+        typeof link.harness === "string" &&
+        typeof link.sessionId === "string");
+}
+export async function readPaneLinks() {
+    try {
+        const parsed = JSON.parse(await readFile(paneLinksPath(), "utf8"));
+        return Array.isArray(parsed) ? parsed.filter(isPaneLink) : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function persist(links) {
+    const path = paneLinksPath();
+    await mkdir(dirname(path), { recursive: true });
+    // Write-then-rename: a killed `gmux run` must never leave a half-written pane-links.json.
+    const temp = `${path}.${process.pid}.tmp`;
+    await writeFile(temp, JSON.stringify(links), "utf8");
+    await rename(temp, path);
+}
+export async function writePaneLink(link) {
+    const links = (await readPaneLinks()).filter((l) => l.paneId !== link.paneId);
+    links.push(link);
+    await persist(links);
+}
+export async function prunePaneLinks(livePaneIds) {
+    const live = new Set(livePaneIds);
+    const kept = (await readPaneLinks()).filter((l) => live.has(l.paneId));
+    await persist(kept);
+    return kept;
+}
+export function linkForPane(links, paneId) {
+    return links.find((l) => l.paneId === paneId) ?? null;
+}
+//# sourceMappingURL=pane-links.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pane-links.js","sourceRoot":"","sources":["../../src/services/pane-links.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,IAAI,GAAG,KAAiB,CAAC;IAC/B,OAAO,CACL,CAAC,CAAC,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC/B,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAChC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CACnC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAY,CAAC;QAC9E,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,KAA0B;IAC/C,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,0FAA0F;IAC1F,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,KAAK,GAAG,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAA6B;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA0B,EAAE,MAAc;IACpE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,95 @@
+/**
+ * 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 type { HarnessId } from "../core/types.js";
+export interface AgentProcess {
+    pid: number;
+    command: string;
+}
+export interface AgentSession {
+    harness: HarnessId;
+    sessionId: string;
+}
+/**
+ * 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 declare function parseAgentSession(command: string): AgentSession | null;
+/** The harness a command names (claude / codex), even without a session id. */
+export declare function harnessFromCommand(command: string): HarnessId | 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 declare function pickAgentProcess(procs: readonly AgentProcess[]): AgentProcess | null;
+interface SnapshotEntry {
+    ppid: number;
+    command: string;
+    /** Seconds since the process started (`ps etime`). Older process → larger. Null if unparsed. */
+    elapsedSeconds: number | null;
+}
+/** The whole process table, pid → {ppid, command, elapsedSeconds}. One `ps` — the parser is pure. */
+export type ProcessSnapshot = Map<number, SnapshotEntry>;
+/**
+ * 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 declare function parseElapsedSeconds(etime: string): number | null;
+export declare function parseProcessSnapshot(output: string): ProcessSnapshot;
+/**
+ * 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 declare function processSnapshot(): Promise<ProcessSnapshot>;
+/** Every descendant of `rootPid` in the snapshot (pure breadth-first, cycle-safe). */
+export declare function descendantsOf(rootPid: number, snapshot: ProcessSnapshot): AgentProcess[];
+/** A process's real working directory: /proc on Linux, lsof on macOS. Null if unknown. */
+export declare function processCwd(pid: number): Promise<string | null>;
+export interface PaneProcessHint {
+    /** Session id read straight off the agent's argv — exact when present. */
+    argvSession: AgentSession | null;
+    /** Which harness the agent is (from its command line) — so a fresh session
+     *  resolves to that harness, never another. Null when no agent was found;
+     *  absent on hints from callers that don't inspect the process. */
+    agentHarness?: HarnessId | null;
+    /** The agent process's real cwd, for a fresh session with no id on the line. */
+    agentCwd: string | null;
+    /**
+     * Seconds since the agent process started (`ps etime`). Older process → larger.
+     *
+     * This is the discriminator between fresh same-cwd panes: with no session id on
+     * the command line, the process's start ORDER matches the sessions' start order,
+     * so a group of panes pairs to its sessions by this rather than by array order.
+     * Absent on hints from callers that don't inspect the process.
+     */
+    agentElapsedSeconds?: number | 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 declare function paneProcessHint(panePid: number, snapshot: ProcessSnapshot): Promise<PaneProcessHint>;
+export {};