@gigaflow/gmux 0.15.0

package/dist/adapters/claude-code.js

@@ -0,0 +1,315 @@
+/**
+ * Claude Code adapter.
+ *
+ * Layout: ~/.claude/projects/<slugified-cwd>/<session-uuid>.jsonl
+ * Each line is a tagged record; the ones we care about are `user`, `assistant`,
+ * `ai-title`, `last-prompt` and `pr-link`.
+ *
+ * Note on `ai-title`: Claude Code writes it early and never revises it, so it
+ * describes where a session STARTED. We keep it as `title` for reference, but
+ * the summary layer is what tells you where the work LANDED.
+ */
+import { readdir, stat } from "node:fs/promises";
+import { basename, join, sep } from "node:path";
+import { existsSync } from "node:fs";
+import { harnessHome } from "../core/paths.js";
+import { truncate } from "../core/text.js";
+import { readJsonl, DecimatingSampler, RingBuffer } from "./jsonl.js";
+/** How many recent human turns to keep for the summarizer. */
+const RECENT_PROMPT_COUNT = 12;
+/** Waypoints sampled across the whole session. See DecimatingSampler. */
+const ARC_PROMPT_COUNT = 8;
+/** A failure or interruption this close to the end means the work was cut short. */
+const END_WINDOW = 10;
+const EDIT_TOOLS = new Set(["Edit", "Write", "MultiEdit", "NotebookEdit"]);
+export class ClaudeCodeAdapter {
+    id = "claude-code";
+    displayName = "Claude Code";
+    processNames = ["claude"];
+    launchCommand = "claude";
+    root() {
+        return join(harnessHome(), ".claude", "projects");
+    }
+    async isAvailable() {
+        return existsSync(this.root());
+    }
+    /**
+     * Discovery walks the whole tree, not just the top level.
+     *
+     * A project directory holds its top-level sessions as `<uuid>.jsonl`, but
+     * subagent transcripts live deeper, under `<uuid>/subagents/agent-*.jsonl`,
+     * and can nest again inside each other. Those are the sidechains: on this
+     * author's machine they outnumber real sessions roughly nine to one, which is
+     * exactly why they are hidden by default — and why they must still be found,
+     * so `--include-sidechains` and `gmux grep` can reach them.
+     */
+    async listSessions() {
+        const root = this.root();
+        if (!existsSync(root))
+            return [];
+        return this.walk(root);
+    }
+    async walk(dir) {
+        const refs = [];
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return refs;
+        }
+        for (const entry of entries) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                refs.push(...(await this.walk(path)));
+                continue;
+            }
+            if (!entry.name.endsWith(".jsonl"))
+                continue;
+            try {
+                const stats = await stat(path);
+                if (!stats.isFile() || stats.size === 0)
+                    continue;
+                refs.push({
+                    harness: this.id,
+                    sessionId: entry.name.replace(/\.jsonl$/, ""),
+                    filePath: path,
+                    mtimeMs: stats.mtimeMs,
+                    size: stats.size,
+                });
+            }
+            catch {
+                continue; // Vanished mid-scan; a live harness rewrites these constantly.
+            }
+        }
+        return refs;
+    }
+    async parseSession(ref) {
+        const prompts = new RingBuffer(RECENT_PROMPT_COUNT);
+        const arc = new DecimatingSampler(ARC_PROMPT_COUNT);
+        const filesTouched = new Set();
+        const prLinks = [];
+        let cwd = null;
+        let gitBranch = null;
+        let title = null;
+        let lastPrompt = null;
+        let startedAt = null;
+        let updatedAt = null;
+        let lastAssistantText = null;
+        let lastToolFailure = null;
+        // A transcript under `subagents/` is a sidechain even if no line says so.
+        let isSidechain = ref.filePath.includes(`${sep}subagents${sep}`);
+        let isAutomated = false;
+        let messageCount = 0;
+        let userPromptCount = 0;
+        let interruptedAt = -1;
+        let failureAt = -1;
+        for await (const entry of readJsonl(ref.filePath)) {
+            const type = str(entry["type"]);
+            // Session-level metadata lines.
+            if (type === "ai-title") {
+                title = str(entry["aiTitle"]) ?? title;
+                continue;
+            }
+            if (type === "last-prompt") {
+                lastPrompt = str(entry["lastPrompt"]) ?? lastPrompt;
+                continue;
+            }
+            if (type === "pr-link") {
+                // Claude Code re-emits this line on every turn, so the same PR appears
+                // hundreds of times in a long session. Keep one entry per PR.
+                const number = num(entry["prNumber"]);
+                const url = str(entry["prUrl"]);
+                if (number !== null && url && !prLinks.some((pr) => pr.url === url)) {
+                    prLinks.push({ number, url, repository: str(entry["prRepository"]) ?? undefined });
+                }
+                continue;
+            }
+            if (type !== "user" && type !== "assistant")
+                continue;
+            messageCount += 1;
+            const timestamp = str(entry["timestamp"]);
+            if (timestamp) {
+                startedAt ??= timestamp;
+                updatedAt = timestamp;
+            }
+            cwd ??= str(entry["cwd"]);
+            gitBranch ??= str(entry["gitBranch"]);
+            if (entry["isSidechain"] === true)
+                isSidechain = true;
+            // `sdk-cli` / `sdk` mark a headless `claude -p` run rather than a
+            // conversation someone actually had.
+            if (str(entry["entrypoint"])?.startsWith("sdk") || str(entry["promptSource"]) === "sdk") {
+                isAutomated = true;
+            }
+            if (entry["interruptedMessageId"] != null)
+                interruptedAt = messageCount;
+            const message = obj(entry["message"]);
+            const content = message?.["content"];
+            if (type === "user") {
+                // A `user` line is either a real human turn or a tool result being fed
+                // back to the model. Only the former is a prompt.
+                if (entry["isMeta"] === true)
+                    continue;
+                const text = humanText(content);
+                if (text) {
+                    userPromptCount += 1;
+                    prompts.push(text);
+                    arc.push(text);
+                }
+                if (hasToolError(content)) {
+                    failureAt = messageCount;
+                    lastToolFailure = truncate(toolErrorText(content) ?? "tool call failed", 300);
+                }
+                continue;
+            }
+            // Assistant turn.
+            const text = assistantText(content);
+            if (text)
+                lastAssistantText = text;
+            for (const file of editedFiles(content))
+                filesTouched.add(file);
+        }
+        const endedMidTask = (interruptedAt > 0 && messageCount - interruptedAt <= END_WINDOW) ||
+            (failureAt > 0 && messageCount - failureAt <= END_WINDOW);
+        const recentUserPrompts = prompts.toArray();
+        const arcPrompts = arc.toArray();
+        return {
+            harness: this.id,
+            sessionId: ref.sessionId,
+            filePath: ref.filePath,
+            cwd,
+            project: projectName(cwd),
+            // "HEAD" means detached or unknown; it tells the reader nothing.
+            gitBranch: gitBranch === "HEAD" ? null : gitBranch,
+            startedAt,
+            updatedAt: updatedAt ?? new Date(ref.mtimeMs).toISOString(),
+            messageCount,
+            userPromptCount,
+            title,
+            lastUserPrompt: lastPrompt ?? recentUserPrompts[recentUserPrompts.length - 1] ?? null,
+            recentUserPrompts,
+            arcPrompts,
+            filesTouched: [...filesTouched],
+            prLinks,
+            lastAssistantText: lastAssistantText ? truncate(lastAssistantText, 1500) : null,
+            lastToolFailure,
+            endedMidTask,
+            isSidechain,
+            isAutomated,
+        };
+    }
+    resumeCommand(record) {
+        return {
+            command: "claude",
+            args: ["--resume", record.sessionId],
+            cwd: record.cwd ?? process.cwd(),
+        };
+    }
+}
+/**
+ * Display name for a session's project.
+ *
+ * Worktrees live at `<repo>/.claude/worktrees/<branch>`, which would otherwise
+ * show up as a project named after the branch. Attribute those to the repo.
+ */
+export function projectName(cwd) {
+    if (!cwd)
+        return null;
+    const marker = `${sep}.claude${sep}worktrees${sep}`;
+    const at = cwd.indexOf(marker);
+    const path = at === -1 ? cwd : cwd.slice(0, at);
+    const name = basename(path);
+    return name === "" ? null : name;
+}
+function str(value) {
+    return typeof value === "string" && value !== "" ? value : null;
+}
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function obj(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function blocks(content) {
+    return Array.isArray(content) ? content.filter((b) => !!obj(b)) : [];
+}
+/**
+ * Text the human actually typed.
+ *
+ * Filters out the machinery Claude Code injects into `user` lines: tool results,
+ * slash-command envelopes, and `<system-reminder>` blocks. Those are not prompts,
+ * and letting them through would poison the summaries.
+ */
+export function humanText(content) {
+    let raw = null;
+    if (typeof content === "string") {
+        raw = content;
+    }
+    else {
+        const texts = blocks(content)
+            .filter((b) => b["type"] === "text")
+            .map((b) => str(b["text"]))
+            .filter((t) => t !== null);
+        if (texts.length > 0)
+            raw = texts.join("\n");
+    }
+    if (raw === null)
+        return null;
+    const cleaned = raw
+        .replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g, "")
+        .replace(/<command-(name|message|args)>[\s\S]*?<\/command-\1>/g, "")
+        .replace(/<local-command-[\s\S]*?<\/local-command-[a-z-]+>/g, "")
+        .trim();
+    if (cleaned === "")
+        return null;
+    if (cleaned.startsWith("Caveat: The messages below"))
+        return null;
+    return truncate(cleaned, 600);
+}
+function assistantText(content) {
+    if (typeof content === "string")
+        return content.trim() || null;
+    const texts = blocks(content)
+        .filter((b) => b["type"] === "text")
+        .map((b) => str(b["text"]))
+        .filter((t) => t !== null);
+    return texts.length > 0 ? texts.join("\n").trim() || null : null;
+}
+/** Files the assistant edited, read off its `tool_use` blocks. */
+export function editedFiles(content) {
+    const files = [];
+    for (const block of blocks(content)) {
+        if (block["type"] !== "tool_use")
+            continue;
+        const name = str(block["name"]);
+        if (!name || !EDIT_TOOLS.has(name))
+            continue;
+        const input = obj(block["input"]);
+        const file = input ? str(input["file_path"]) : null;
+        if (file)
+            files.push(file);
+    }
+    return files;
+}
+function hasToolError(content) {
+    return blocks(content).some((b) => b["type"] === "tool_result" && b["is_error"] === true);
+}
+function toolErrorText(content) {
+    for (const block of blocks(content)) {
+        if (block["type"] !== "tool_result" || block["is_error"] !== true)
+            continue;
+        const inner = block["content"];
+        if (typeof inner === "string")
+            return inner;
+        const text = blocks(inner)
+            .map((b) => str(b["text"]))
+            .find((t) => t !== null);
+        if (text)
+            return text;
+    }
+    return null;
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/claude-code.js.map

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

package/dist/adapters/codex.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Codex adapter.
+ *
+ * Layout: ~/.codex/sessions/YYYY/MM/DD/rollout-<ISO>-<uuid>.jsonl
+ * Lines are tagged `session_meta`, `event_msg`, `response_item` or `turn_context`.
+ *
+ * We read human turns and agent replies from `event_msg` rather than
+ * `response_item/message`, because the latter also carries `developer`-role
+ * system injections that are not conversation.
+ *
+ * Codex gives us a signal Claude Code does not: a `task_started` with no matching
+ * `task_complete` means the session was genuinely cut off mid-task.
+ */
+import type { SessionRecord, SessionRef } from "../core/types.js";
+import type { HarnessAdapter, ResumeCommand } from "./types.js";
+export declare class CodexAdapter implements HarnessAdapter {
+    readonly id = "codex";
+    readonly displayName = "Codex";
+    readonly processNames: readonly ["codex"];
+    readonly launchCommand = "codex";
+    private root;
+    isAvailable(): Promise<boolean>;
+    listSessions(): Promise<SessionRef[]>;
+    /** Sessions nest under year/month/day, so discovery is a bounded recursive walk. */
+    private walk;
+    parseSession(ref: SessionRef): Promise<SessionRecord>;
+    resumeCommand(record: SessionRecord): ResumeCommand;
+}
+/**
+ * Pull file paths out of an apply_patch payload, wherever it is embedded.
+ *
+ * The payload usually arrives inside a JSON-encoded argument string, so the
+ * patch's own newlines show up as the two characters `\` `n` rather than as a
+ * line break. A path therefore ends at the first backslash or quote, not at the
+ * end of the line.
+ */
+export declare function patchedFiles(args: string): string[];
+/** Codex reports shell failures in prose; a nonzero exit is the signal. */
+export declare function exitFailure(output: string | null): string | null;

package/dist/adapters/codex.js

@@ -0,0 +1,233 @@
+/**
+ * Codex adapter.
+ *
+ * Layout: ~/.codex/sessions/YYYY/MM/DD/rollout-<ISO>-<uuid>.jsonl
+ * Lines are tagged `session_meta`, `event_msg`, `response_item` or `turn_context`.
+ *
+ * We read human turns and agent replies from `event_msg` rather than
+ * `response_item/message`, because the latter also carries `developer`-role
+ * system injections that are not conversation.
+ *
+ * Codex gives us a signal Claude Code does not: a `task_started` with no matching
+ * `task_complete` means the session was genuinely cut off mid-task.
+ */
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { harnessHome } from "../core/paths.js";
+import { truncate } from "../core/text.js";
+import { readJsonl, DecimatingSampler, RingBuffer } from "./jsonl.js";
+import { projectName } from "./claude-code.js";
+const RECENT_PROMPT_COUNT = 12;
+/** Waypoints sampled across the whole session. See DecimatingSampler. */
+const ARC_PROMPT_COUNT = 8;
+/** `rollout-2026-06-05T18-06-20-<uuid>.jsonl` → the uuid. */
+const ROLLOUT_FILE = /^rollout-.*?-([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl$/i;
+/** Markers inside an apply_patch payload naming the files it changes. */
+const PATCH_TARGET = /\*\*\* (?:Update|Add|Delete) File: (.+)/g;
+export class CodexAdapter {
+    id = "codex";
+    displayName = "Codex";
+    processNames = ["codex"];
+    launchCommand = "codex";
+    root() {
+        return join(harnessHome(), ".codex", "sessions");
+    }
+    async isAvailable() {
+        return existsSync(this.root());
+    }
+    async listSessions() {
+        const root = this.root();
+        if (!existsSync(root))
+            return [];
+        return this.walk(root);
+    }
+    /** Sessions nest under year/month/day, so discovery is a bounded recursive walk. */
+    async walk(dir) {
+        const refs = [];
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return refs;
+        }
+        for (const entry of entries) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                refs.push(...(await this.walk(path)));
+                continue;
+            }
+            const match = ROLLOUT_FILE.exec(entry.name);
+            if (!match)
+                continue;
+            try {
+                const stats = await stat(path);
+                if (!stats.isFile() || stats.size === 0)
+                    continue;
+                refs.push({
+                    harness: this.id,
+                    sessionId: match[1],
+                    filePath: path,
+                    mtimeMs: stats.mtimeMs,
+                    size: stats.size,
+                });
+            }
+            catch {
+                continue;
+            }
+        }
+        return refs;
+    }
+    async parseSession(ref) {
+        const prompts = new RingBuffer(RECENT_PROMPT_COUNT);
+        const arc = new DecimatingSampler(ARC_PROMPT_COUNT);
+        const filesTouched = new Set();
+        let cwd = null;
+        let startedAt = null;
+        let updatedAt = null;
+        let lastAssistantText = null;
+        let lastToolFailure = null;
+        let messageCount = 0;
+        let userPromptCount = 0;
+        let tasksStarted = 0;
+        let tasksCompleted = 0;
+        let isAutomated = false;
+        for await (const entry of readJsonl(ref.filePath)) {
+            const type = str(entry["type"]);
+            const payload = obj(entry["payload"]);
+            const timestamp = str(entry["timestamp"]);
+            if (timestamp) {
+                startedAt ??= timestamp;
+                updatedAt = timestamp;
+            }
+            if (!payload)
+                continue;
+            if (type === "session_meta") {
+                cwd ??= str(payload["cwd"]);
+                // `codex exec` is the non-interactive entrypoint — automation, not a
+                // conversation someone sat through.
+                if (str(payload["originator"]) === "codex_exec" || str(payload["source"]) === "exec") {
+                    isAutomated = true;
+                }
+                continue;
+            }
+            if (type === "turn_context") {
+                cwd ??= str(payload["cwd"]);
+                continue;
+            }
+            if (type === "event_msg") {
+                const kind = str(payload["type"]);
+                if (kind === "user_message") {
+                    const text = str(payload["message"]);
+                    if (text) {
+                        messageCount += 1;
+                        userPromptCount += 1;
+                        const prompt = truncate(text, 600);
+                        prompts.push(prompt);
+                        arc.push(prompt);
+                    }
+                }
+                else if (kind === "agent_message") {
+                    const text = str(payload["message"]);
+                    if (text) {
+                        messageCount += 1;
+                        lastAssistantText = text;
+                    }
+                }
+                else if (kind === "task_started") {
+                    tasksStarted += 1;
+                }
+                else if (kind === "task_complete") {
+                    tasksCompleted += 1;
+                    lastAssistantText = str(payload["last_agent_message"]) ?? lastAssistantText;
+                }
+                continue;
+            }
+            if (type === "response_item") {
+                const kind = str(payload["type"]);
+                if (kind === "function_call") {
+                    const args = str(payload["arguments"]);
+                    if (args)
+                        for (const file of patchedFiles(args))
+                            filesTouched.add(file);
+                }
+                else if (kind === "function_call_output") {
+                    const output = str(payload["output"]);
+                    const failure = exitFailure(output);
+                    if (failure)
+                        lastToolFailure = truncate(failure, 300);
+                }
+            }
+        }
+        const recentUserPrompts = prompts.toArray();
+        const arcPrompts = arc.toArray();
+        // A turn was started and never completed: the session was interrupted.
+        const endedMidTask = tasksStarted > tasksCompleted;
+        return {
+            harness: this.id,
+            sessionId: ref.sessionId,
+            filePath: ref.filePath,
+            cwd,
+            project: projectName(cwd),
+            gitBranch: null, // Codex does not record the branch in its rollout files.
+            startedAt,
+            updatedAt: updatedAt ?? new Date(ref.mtimeMs).toISOString(),
+            messageCount,
+            userPromptCount,
+            title: null, // Codex writes no title; the summary layer supplies one.
+            lastUserPrompt: recentUserPrompts[recentUserPrompts.length - 1] ?? null,
+            recentUserPrompts,
+            arcPrompts,
+            filesTouched: [...filesTouched],
+            prLinks: [],
+            lastAssistantText: lastAssistantText ? truncate(lastAssistantText, 1500) : null,
+            lastToolFailure,
+            endedMidTask,
+            isSidechain: false,
+            isAutomated,
+        };
+    }
+    resumeCommand(record) {
+        return {
+            command: "codex",
+            args: ["resume", record.sessionId],
+            cwd: record.cwd ?? process.cwd(),
+        };
+    }
+}
+/**
+ * Pull file paths out of an apply_patch payload, wherever it is embedded.
+ *
+ * The payload usually arrives inside a JSON-encoded argument string, so the
+ * patch's own newlines show up as the two characters `\` `n` rather than as a
+ * line break. A path therefore ends at the first backslash or quote, not at the
+ * end of the line.
+ */
+export function patchedFiles(args) {
+    const files = [];
+    for (const match of args.matchAll(PATCH_TARGET)) {
+        const file = match[1]?.split(/[\\"']/)[0]?.trim();
+        if (file)
+            files.push(file);
+    }
+    return files;
+}
+/** Codex reports shell failures in prose; a nonzero exit is the signal. */
+export function exitFailure(output) {
+    if (!output)
+        return null;
+    const match = /Process exited with code (\d+)/.exec(output);
+    if (!match || match[1] === "0")
+        return null;
+    return output.trim();
+}
+function str(value) {
+    return typeof value === "string" && value !== "" ? value : null;
+}
+function obj(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

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

package/dist/adapters/jsonl.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Streaming JSONL reader shared by adapters.
+ *
+ * Sessions run to hundreds of megabytes in aggregate, so we stream line by line
+ * and never hold a whole file as one string. Malformed lines are skipped rather
+ * than thrown: a truncated final line is normal for a session that is still open.
+ */
+export declare function readJsonl(filePath: string): AsyncGenerator<Record<string, unknown>>;
+/** Keep only the last `n` items pushed. Used for message tails. */
+export declare class RingBuffer<T> {
+    private readonly capacity;
+    private items;
+    constructor(capacity: number);
+    push(item: T): void;
+    toArray(): T[];
+    get last(): T | undefined;
+}
+/**
+ * Keep an evenly-spaced sample of an unbounded stream, in bounded memory.
+ *
+ * `RingBuffer` above answers "how did this end?". This answers "what shape was
+ * it?" — and crucially it never drops the FIRST item, which is the developer's
+ * original ask. A summarizer that never sees that writes the same thing the
+ * stale harness title already says.
+ *
+ * Every `stride`-th item is a candidate; when the buffer fills we drop every
+ * other one and double the stride. Stride is therefore always a power of two,
+ * and the retained set lands between `ceil((capacity + 1) / 2)` and `capacity`
+ * — evenly spaced, not exactly `capacity` long. A few waypoints is all the
+ * prompt needs.
+ */
+export declare class DecimatingSampler<T> {
+    private readonly capacity;
+    private items;
+    private stride;
+    private seen;
+    constructor(capacity: number);
+    push(item: T): void;
+    toArray(): T[];
+}