@nanonets/graft 0.24.0 → 0.25.0

package/dist/trace/claude.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Reading a Claude Code transcript: whose words each line holds.
+ *
+ * Only what the person typed can teach Trail anything. A transcript's `user`
+ * lines also carry text the agent read: compaction summaries (the model's
+ * own retelling, which can repeat what a tool returned), task notices from
+ * background work, slash-command wrappers, other sessions' hand-backs,
+ * subagent lines, tool results. About a third of what a naive `type: user`
+ * test calls a prompt is one of these. The flags Claude Code writes
+ * (`origin.kind`, `isMeta`, `isCompactSummary`, `isSidechain`) and the
+ * wrappers it puts around harness text decide; a line from a build too old to
+ * stamp `origin` is judged by its wrappers alone. `promptSource` does not
+ * decide: the desktop app and the IDE extension mark typed prompts `sdk`.
+ * A row from `claude -p` or an SDK (`entrypoint: sdk…`) is a script's prompt,
+ * never the person's, except in a lab home with the lab switch on (D26, D99),
+ * where the lab's headless runs stand in for a person.
+ *
+ * IDE context (`<ide_opened_file>`, `<ide_selection>`) and reminders ride in
+ * the same message as a real prompt, so they are stripped and the prompt is
+ * kept. A pasted block becomes a marker: the person sent it, but didn't write
+ * it.
+ *
+ * This is the one filter every learning path uses: cold start, the trace
+ * stream, provenance.
+ *
+ * `readNewEvents` turns what a transcript gained since the last read into one
+ * stream: typed words, injected text, tool calls, their results (failed or
+ * not), assistant text and compactions. Built in memory, never stored.
+ */
+import { type Memo, type ReadOptions } from "./cursor.js";
+/**
+ * `offset` is the byte offset of the line the event came from (the save gate
+ * re-reads that line). A call carries the folder (`cwd`) and branch
+ * (`gitBranch`) the host recorded on its line; a result carries the host's own
+ * error flag (`isError`) apart from `ok`, which also reads failure text.
+ * `uuid` is the line's entry id: a transcript that repeats a block of its
+ * history repeats the ids, so the fold can tell old lines from new (D56d).
+ */
+export type TraceEvent = {
+    kind: "typed";
+    text: string;
+    at: string;
+    offset?: number;
+    uuid?: string;
+} | {
+    kind: "injected";
+    text: string;
+    at: string;
+    offset?: number;
+    uuid?: string;
+} | {
+    kind: "tool_call";
+    id: string;
+    name: string;
+    input: unknown;
+    at: string;
+    offset?: number;
+    uuid?: string;
+    cwd?: string;
+    branch?: string;
+} | {
+    kind: "tool_result";
+    id: string;
+    ok: boolean;
+    text: string;
+    at: string;
+    offset?: number;
+    uuid?: string;
+    isError?: boolean;
+} | {
+    kind: "compaction";
+    at: string;
+    offset?: number;
+    uuid?: string;
+} | {
+    kind: "assistant";
+    text: string;
+    at: string;
+    offset?: number;
+    uuid?: string;
+};
+/** What stands for a pasted block in the person's words. */
+export declare const PASTE_MARK = "[pasted text]";
+/** The text parts of a message's content, joined; images, tool parts and the rest left out. */
+export declare function textOf(content: unknown): string;
+/**
+ * The person's own words in one message's raw text: wrappers stripped,
+ * pastes marked, and "" when what's left is harness text or nothing typed.
+ */
+export declare function ownText(raw: string): string;
+/**
+ * What the person typed in this transcript line, IDE tags and reminders stripped; "" when it isn't theirs.
+ * `env` decides only whether an sdk row can be typed (a lab home with the switch, D99).
+ */
+export declare function typedText(entry: unknown, env?: NodeJS.ProcessEnv): string;
+/** Whether this transcript line is something the person typed. */
+export declare function isTypedByPerson(entry: unknown, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * The events one parsed transcript line holds: the reader `readNewEvents` uses, for a caller that walks a file
+ * itself (init's replay over a byte range, b5). `memo` carries the open tool calls from line to line: start it
+ * as `{}` and pass the same object for every line of one read. Never throws on a line that isn't an entry.
+ */
+export declare function lineEvents(entry: unknown, memo: Memo, offset?: number, env?: NodeJS.ProcessEnv): TraceEvent[];
+export interface EventReadOptions extends ReadOptions {
+    /**
+     * Each line read, parsed, before its events: for a reader that needs what
+     * the events leave out (a reply's uuid, a response's usage). `memo` is the
+     * one saved with the cursor and started over with it; keep the caller's
+     * state under one key of its own. A throw is the caller's to avoid: it
+     * ends the read without saving the cursor.
+     */
+    onEntry?: (entry: Record<string, unknown>, memo: Memo) => void;
+    /** Whose env decides whether an sdk row is typed (`typedText`); default `process.env`. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * The events a Claude Code transcript gained since the last call with the
+ * same `cursorPath`. The first call with no cursor reads at most the last
+ * 8 MB (`opts.firstReadBytes`; `Infinity` for the whole file). Never throws: a
+ * transcript that can't be read gives no events, and a cursor that can't be
+ * saved still returns what was read.
+ */
+export declare function readNewEvents(transcriptPath: string, cursorPath: string, opts?: EventReadOptions): TraceEvent[];
+//# sourceMappingURL=claude.d.ts.map

package/dist/trace/claude.d.ts.map

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

package/dist/trace/claude.js

@@ -0,0 +1,303 @@
+/**
+ * Reading a Claude Code transcript: whose words each line holds.
+ *
+ * Only what the person typed can teach Trail anything. A transcript's `user`
+ * lines also carry text the agent read: compaction summaries (the model's
+ * own retelling, which can repeat what a tool returned), task notices from
+ * background work, slash-command wrappers, other sessions' hand-backs,
+ * subagent lines, tool results. About a third of what a naive `type: user`
+ * test calls a prompt is one of these. The flags Claude Code writes
+ * (`origin.kind`, `isMeta`, `isCompactSummary`, `isSidechain`) and the
+ * wrappers it puts around harness text decide; a line from a build too old to
+ * stamp `origin` is judged by its wrappers alone. `promptSource` does not
+ * decide: the desktop app and the IDE extension mark typed prompts `sdk`.
+ * A row from `claude -p` or an SDK (`entrypoint: sdk…`) is a script's prompt,
+ * never the person's, except in a lab home with the lab switch on (D26, D99),
+ * where the lab's headless runs stand in for a person.
+ *
+ * IDE context (`<ide_opened_file>`, `<ide_selection>`) and reminders ride in
+ * the same message as a real prompt, so they are stripped and the prompt is
+ * kept. A pasted block becomes a marker: the person sent it, but didn't write
+ * it.
+ *
+ * This is the one filter every learning path uses: cold start, the trace
+ * stream, provenance.
+ *
+ * `readNewEvents` turns what a transcript gained since the last read into one
+ * stream: typed words, injected text, tool calls, their results (failed or
+ * not), assistant text and compactions. Built in memory, never stored.
+ */
+import { readAppended } from "./cursor.js";
+import { failedText } from "./failure.js";
+import { labInteractive } from "../skills/host-facts.js";
+/** What stands for a pasted block in the person's words. */
+export const PASTE_MARK = "[pasted text]";
+/** Context the harness or IDE wraps around a real prompt: stripped, the prompt kept. */
+const WRAPPED = /<(ide_[a-z_]+|system-reminder|user-prompt-submit-hook)\b[^>]*>[\s\S]*?<\/\1>/g;
+/** Claude Code writes `<pasted_content id="1">…</pasted_content id="1">`; a cut-off one runs to the end. */
+const PASTED = /<pasted_content\b[^>]*>[\s\S]*?(?:<\/pasted_content[^>]*>|$)/g;
+/**
+ * Harness text that stands where a prompt would: a leading tag
+ * (`<task-notification>`, `<command-name>`, `<local-command-stdout>`,
+ * `<bash-input>`, `<agent-message>`, …), an interruption, a resumed
+ * session's preamble, a hand-back from another session.
+ */
+const NOT_TYPED = [
+    /^<[a-z][a-z0-9_-]*(?:\s[^>]*)?>/,
+    /^Caveat:/,
+    /^Another Claude session sent a message/,
+    /^\[Request interrupted/,
+    /^This session is being continued/,
+];
+/** The text parts of a message's content, joined; images, tool parts and the rest left out. */
+export function textOf(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    const out = [];
+    for (const p of content) {
+        if (p && typeof p === "object" && p.type === "text" && typeof p.text === "string") {
+            out.push(p.text);
+        }
+    }
+    return out.join("\n");
+}
+/**
+ * The person's own words in one message's raw text: wrappers stripped,
+ * pastes marked, and "" when what's left is harness text or nothing typed.
+ */
+export function ownText(raw) {
+    const t = raw.replace(WRAPPED, "").replace(PASTED, PASTE_MARK).trim();
+    if (!t || NOT_TYPED.some((re) => re.test(t)))
+        return "";
+    if (!t.split(PASTE_MARK).join("").trim())
+        return "";
+    return t;
+}
+/** The raw text of a line that could be the person's, or null when its flags say it isn't. */
+function candidateText(entry, env) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry))
+        return null;
+    const e = entry;
+    if (e.isMeta || e.isSidechain || e.isCompactSummary || e.isVisibleInTranscriptOnly)
+        return null;
+    // `claude -p` and the SDKs: a script's prompt, written once and replayed. Only a lab home with the switch (D99) reads it.
+    if (typeof e.entrypoint === "string" && e.entrypoint.startsWith("sdk") && !labInteractive(env))
+        return null;
+    const human = (o) => o === undefined || o === null || (typeof o === "object" && o.kind === "human");
+    if (e.type === "user") {
+        if (!human(e.origin))
+            return null;
+        const content = e.message?.content;
+        if (Array.isArray(content) && content.some((p) => p && typeof p === "object" && p.type === "tool_result"))
+            return null;
+        return textOf(content);
+    }
+    // A message typed while the agent was busy is queued and lands as an attachment.
+    if (e.type === "attachment") {
+        const a = e.attachment;
+        if (!a || a.type !== "queued_command" || a.commandMode !== "prompt" || a.isMeta || !human(a.origin))
+            return null;
+        return textOf(a.prompt);
+    }
+    return null;
+}
+/**
+ * What the person typed in this transcript line, IDE tags and reminders stripped; "" when it isn't theirs.
+ * `env` decides only whether an sdk row can be typed (a lab home with the switch, D99).
+ */
+export function typedText(entry, env = process.env) {
+    try {
+        const raw = candidateText(entry, env);
+        return raw === null ? "" : ownText(raw);
+    }
+    catch {
+        return "";
+    }
+}
+/** Whether this transcript line is something the person typed. */
+export function isTypedByPerson(entry, env = process.env) {
+    return typedText(entry, env) !== "";
+}
+/* -------------------------------------------------------------------------- */
+/* The event stream                                                           */
+/* -------------------------------------------------------------------------- */
+/** Tools whose results are command output, so their text can say they failed. */
+const SHELL_TOOLS = new Set(["Bash", "PowerShell"]);
+/** Open tool calls carried between reads, so a late result still knows its tool. */
+const MAX_PENDING = 500;
+/** Text kept per event: the head, and the tail where outcomes print. */
+const MAX_TEXT = 40_000;
+const KEEP_HEAD = 8_000;
+function clip(t) {
+    return t.length > MAX_TEXT ? `${t.slice(0, KEEP_HEAD)}\n…\n${t.slice(-(MAX_TEXT - KEEP_HEAD))}` : t;
+}
+/** The wrapped and pasted blocks taken out of a typed message: text the agent saw, not the person's words. */
+function strippedBlocks(raw) {
+    return [...raw.matchAll(WRAPPED), ...raw.matchAll(PASTED)].map((m) => m[0]).join("\n").trim();
+}
+function pendingOf(memo) {
+    const p = memo.pending;
+    if (p && typeof p === "object" && !Array.isArray(p))
+        return p;
+    return (memo.pending = {});
+}
+function hookText(content) {
+    if (typeof content === "string")
+        return content;
+    return Array.isArray(content) ? content.filter((c) => typeof c === "string").join("\n") : "";
+}
+/** The events one transcript line holds, appended to `out`. `offset`: where the line starts in the file. */
+function eventsOf(e, memo, out, offset, env) {
+    const at = typeof e.timestamp === "string" ? e.timestamp : "";
+    // Subagent lines are another context's work; their hand-back arrives as a result or a notice.
+    if (e.isSidechain)
+        return;
+    const where = { ...(offset === undefined ? {} : { offset }), ...(typeof e.uuid === "string" && e.uuid ? { uuid: e.uuid } : {}) };
+    const push = (ev) => {
+        if (ev.kind !== "injected")
+            memo.boundary = false;
+        out.push({ ...ev, ...where });
+    };
+    const injected = (text) => {
+        const t = text.trim();
+        if (t)
+            out.push({ kind: "injected", text: clip(t), at, ...where });
+    };
+    const cwd = typeof e.cwd === "string" && e.cwd ? { cwd: e.cwd } : {};
+    const branch = typeof e.gitBranch === "string" && e.gitBranch ? { branch: e.gitBranch } : {};
+    if (e.type === "system") {
+        if (e.subtype === "compact_boundary") {
+            push({ kind: "compaction", at });
+            memo.boundary = true;
+        }
+        return;
+    }
+    if (e.type === "assistant") {
+        if (e.isApiErrorMessage)
+            return;
+        const content = e.message?.content;
+        if (typeof content === "string") {
+            if (content.trim())
+                push({ kind: "assistant", text: clip(content), at });
+            return;
+        }
+        if (!Array.isArray(content))
+            return;
+        const pending = pendingOf(memo);
+        for (const part of content) {
+            if (!part || typeof part !== "object")
+                continue;
+            if (part.type === "text" && typeof part.text === "string" && part.text.trim())
+                push({ kind: "assistant", text: clip(part.text), at });
+            if (part.type === "tool_use") {
+                const id = String(part.id ?? "");
+                const name = String(part.name ?? "");
+                pending[id] = name;
+                push({ kind: "tool_call", id, name, input: part.input ?? null, at, ...cwd, ...branch });
+            }
+        }
+        const ids = Object.keys(pending);
+        for (const id of ids.slice(0, Math.max(0, ids.length - MAX_PENDING)))
+            delete pending[id];
+        return;
+    }
+    if (e.type === "user") {
+        const content = e.message?.content;
+        if (e.isCompactSummary) {
+            // Older builds write the summary with no boundary line before it.
+            if (!memo.boundary)
+                push({ kind: "compaction", at });
+            memo.boundary = false;
+            injected(textOf(content));
+            return;
+        }
+        if (Array.isArray(content) && content.some((p) => p && typeof p === "object" && p.type === "tool_result")) {
+            const pending = pendingOf(memo);
+            for (const part of content) {
+                if (!part || typeof part !== "object" || part.type !== "tool_result")
+                    continue;
+                const id = String(part.tool_use_id ?? "");
+                const name = pending[id];
+                delete pending[id];
+                const text = typeof part.content === "string" ? part.content : textOf(part.content);
+                // A call never seen (read before this window) is judged as a command.
+                const isError = part.is_error === true;
+                const ok = !(isError || ((name === undefined || SHELL_TOOLS.has(name)) && failedText(text)));
+                push({ kind: "tool_result", id, ok, text: clip(text), at, isError });
+            }
+            return;
+        }
+        const typed = typedText(e, env);
+        if (typed) {
+            push({ kind: "typed", text: typed, at });
+            injected(strippedBlocks(textOf(content)));
+            return;
+        }
+        injected(textOf(content));
+        return;
+    }
+    if (e.type === "attachment") {
+        const a = e.attachment;
+        if (!a || typeof a !== "object")
+            return;
+        if (a.type === "queued_command") {
+            const typed = typedText(e, env);
+            if (typed) {
+                push({ kind: "typed", text: typed, at });
+                injected(strippedBlocks(textOf(a.prompt)));
+            }
+            else
+                injected(textOf(a.prompt));
+        }
+        else if (a.type === "hook_additional_context") {
+            injected(hookText(a.content));
+        }
+    }
+}
+/**
+ * The events one parsed transcript line holds: the reader `readNewEvents` uses, for a caller that walks a file
+ * itself (init's replay over a byte range, b5). `memo` carries the open tool calls from line to line: start it
+ * as `{}` and pass the same object for every line of one read. Never throws on a line that isn't an entry.
+ */
+export function lineEvents(entry, memo, offset, env = process.env) {
+    const out = [];
+    if (!entry || typeof entry !== "object" || Array.isArray(entry))
+        return out;
+    eventsOf(entry, memo, out, offset, env);
+    return out;
+}
+/**
+ * The events a Claude Code transcript gained since the last call with the
+ * same `cursorPath`. The first call with no cursor reads at most the last
+ * 8 MB (`opts.firstReadBytes`; `Infinity` for the whole file). Never throws: a
+ * transcript that can't be read gives no events, and a cursor that can't be
+ * saved still returns what was read.
+ */
+export function readNewEvents(transcriptPath, cursorPath, opts = {}) {
+    const out = [];
+    const onEntry = opts.onEntry;
+    const env = opts.env ?? process.env;
+    try {
+        readAppended(transcriptPath, cursorPath, (line, memo, offset) => {
+            let e;
+            try {
+                e = JSON.parse(line);
+            }
+            catch {
+                return;
+            }
+            if (!e || typeof e !== "object" || Array.isArray(e))
+                return;
+            if (onEntry)
+                onEntry(e, memo);
+            eventsOf(e, memo, out, offset, env);
+        }, opts);
+    }
+    catch {
+        /* fail open */
+    }
+    return out;
+}
+//# sourceMappingURL=claude.js.map

package/dist/trace/claude.js.map

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

package/dist/trace/codex-exec.d.ts

@@ -0,0 +1,22 @@
+/** The text of a `function_call_output.output`: a string, or the text of an array of content parts. */
+export declare function outputText(out: unknown): string;
+/** 4.15: the exit an output's header names, `{ running }` for a command still running, null when it names none. */
+export declare function codexExitOf(output: string): {
+    code: number;
+} | {
+    running: number;
+} | null;
+/** The output without its header: what the command printed. */
+export declare function outputBody(output: string): string;
+/** One word as a shell would need it written. */
+export declare function shellQuote(w: string): string;
+/** The command an argument vector runs: `bash -lc X` and `sh -c X` read as X; any other vector joined with quoting. */
+export declare function argvCommand(argv: unknown): string | null;
+/** The files an apply_patch body names, in order, each once. */
+export declare function patchFiles(patch: unknown): string[];
+/**
+ * The files a shell command patches when it runs apply_patch (`apply_patch <<'EOF'`, `["apply_patch", patch]`, after
+ * a `cd`), absolute against the folder it runs in when that is known. [] for any other command (review).
+ */
+export declare function shellPatchFiles(cmd: string, cwd: string | undefined): string[];
+//# sourceMappingURL=codex-exec.d.ts.map

package/dist/trace/codex-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-exec.d.ts","sourceRoot":"","sources":["../../src/trace/codex-exec.ts"],"names":[],"mappings":"AAkBA,uGAAuG;AACvG,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAW/C;AA2BD,mHAAmH;AACnH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASzF;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKjD;AAKD,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED,uHAAuH;AACvH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKxD;AAID,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CASnD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAK9E"}

package/dist/trace/codex-exec.js

@@ -0,0 +1,129 @@
+/**
+ * The text-level facts of a Codex tool call (design 4.15): which exit an
+ * output's header names, the output's body without that header, the shell
+ * line an argument vector stands for, and the files an apply_patch touches.
+ * Codex keeps a command's exit only as text in the model-facing output
+ * (`Process exited with code N`, or the older `Exit code: N`, or JSON
+ * `metadata.exit_code`), so these readers look only at the header, never at
+ * the body, where a command's own output could print the same words.
+ * Pure: no disk, no clock.
+ */
+import { isAbsolute, resolve } from 'node:path';
+/** Where the header ends: unified exec and the older shell both put `Output:` on a line of its own. */
+const OUTPUT_LINE = /^Output:\s*$/m;
+const EXITED = /^Process exited with code (-?\d+)\s*$/m;
+const RUNNING = /^Process running with session ID (\d+)\s*$/m;
+const EXIT_CODE = /^Exit code: (-?\d+)\s*$/m;
+/** The text of a `function_call_output.output`: a string, or the text of an array of content parts. */
+export function outputText(out) {
+    if (typeof out === 'string')
+        return out;
+    if (Array.isArray(out)) {
+        return out.flatMap((p) => (p && typeof p === 'object' && typeof p.text === 'string' ? [p.text] : [])).join('\n');
+    }
+    if (out && typeof out === 'object') {
+        const o = out;
+        if (typeof o.content === 'string')
+            return o.content;
+        if (o.content !== undefined)
+            return outputText(o.content);
+    }
+    return '';
+}
+function jsonOutput(text) {
+    const t = text.trimStart();
+    if (!t.startsWith('{'))
+        return null;
+    try {
+        const v = JSON.parse(t);
+        if (!v || typeof v !== 'object' || Array.isArray(v))
+            return null;
+        const code = typeof v.metadata?.exit_code === 'number' && Number.isInteger(v.metadata.exit_code) ? v.metadata.exit_code : null;
+        if (code === null && typeof v.output !== 'string')
+            return null;
+        return { output: typeof v.output === 'string' ? v.output : '', code };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The header part of an output text: before its `Output:` line. Every exec output Codex writes has that line; a text
+ * without one has no header at all, so a command that prints `Process exited with code 0` can't name its own exit
+ * (review: its first lines were read as a header).
+ */
+function headerOf(text) {
+    const m = OUTPUT_LINE.exec(text);
+    if (m)
+        return { head: text.slice(0, m.index), body: text.slice(m.index + m[0].length).replace(/^\r?\n/, '') };
+    return { head: '', body: text };
+}
+/** 4.15: the exit an output's header names, `{ running }` for a command still running, null when it names none. */
+export function codexExitOf(output) {
+    if (typeof output !== 'string' || !output)
+        return null;
+    const j = jsonOutput(output);
+    if (j)
+        return j.code === null ? null : { code: j.code };
+    const { head } = headerOf(output);
+    const run = RUNNING.exec(head);
+    if (run)
+        return { running: Number(run[1]) };
+    const m = EXITED.exec(head) ?? EXIT_CODE.exec(head);
+    return m ? { code: Number(m[1]) } : null;
+}
+/** The output without its header: what the command printed. */
+export function outputBody(output) {
+    const j = jsonOutput(output);
+    if (j)
+        return j.output;
+    const { head, body } = headerOf(output);
+    return EXITED.test(head) || EXIT_CODE.test(head) || RUNNING.test(head) ? body : output;
+}
+const SHELLS = /^(?:\/(?:usr\/)?(?:local\/)?bin\/)?(?:bash|zsh|sh|dash|ksh|fish)$/;
+const SAFE_WORD = /^[A-Za-z0-9_@%+=:,./-]+$/;
+/** One word as a shell would need it written. */
+export function shellQuote(w) {
+    if (w !== '' && SAFE_WORD.test(w))
+        return w;
+    return `'${w.replace(/'/g, `'\\''`)}'`;
+}
+/** The command an argument vector runs: `bash -lc X` and `sh -c X` read as X; any other vector joined with quoting. */
+export function argvCommand(argv) {
+    if (!Array.isArray(argv) || !argv.length || !argv.every((w) => typeof w === 'string'))
+        return null;
+    const w = argv;
+    if (w.length === 3 && SHELLS.test(w[0]) && /^-l?c$|^-cl$/.test(w[1]))
+        return w[2];
+    return w.map(shellQuote).join(' ');
+}
+const PATCH_FILE = /^\*\*\* (?:Add|Update|Delete) File: (.+)$|^\*\*\* Move to: (.+)$/gm;
+/** The files an apply_patch body names, in order, each once. */
+export function patchFiles(patch) {
+    if (typeof patch !== 'string')
+        return [];
+    const out = [];
+    for (const m of patch.matchAll(PATCH_FILE)) {
+        const f = (m[1] ?? m[2] ?? '').trim();
+        if (f && !out.includes(f))
+            out.push(f);
+        if (out.length >= 50)
+            break;
+    }
+    return out;
+}
+/** apply_patch run as a command: Codex applies the patch itself (its shell handler reads these forms). */
+const SHELL_PATCH = /(?:^|[\s;&|(])(?:apply_patch|applypatch)(?![\w-])/;
+const PATCH_BEGIN = /(?:^|['"])\*\*\* Begin Patch\s*$/m;
+/**
+ * The files a shell command patches when it runs apply_patch (`apply_patch <<'EOF'`, `["apply_patch", patch]`, after
+ * a `cd`), absolute against the folder it runs in when that is known. [] for any other command (review).
+ */
+export function shellPatchFiles(cmd, cwd) {
+    if (!SHELL_PATCH.test(cmd) || !PATCH_BEGIN.test(cmd))
+        return [];
+    const cd = /^\s*cd\s+('[^']*'|"[^"]*"|[^\s;&|]+)\s*&&/.exec(cmd)?.[1]?.replace(/^(['"])(.*)\1$/, '$2');
+    const base = cd ? (isAbsolute(cd) ? cd : cwd ? resolve(cwd, cd) : undefined) : cwd;
+    return patchFiles(cmd).map((f) => (base && !isAbsolute(f) ? resolve(base, f) : f));
+}
+//# sourceMappingURL=codex-exec.js.map

package/dist/trace/codex-exec.js.map

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

package/dist/trace/codex-meta.d.ts

@@ -0,0 +1,23 @@
+import type { CodexMeta } from './types.js';
+/** CODEX_HOME, else $HOME/.codex. */
+export declare function codexHome(env?: NodeJS.ProcessEnv): string;
+/** The rollout's first line, read with one positioned read of at most 64 KB; null when it isn't a session_meta line. */
+export declare function codexMeta(rolloutPath: string): CodexMeta | null;
+/**
+ * D133, fail closed: a rollout whose session_meta names `forked_from_id` starts with a copy of another session's
+ * lines, and Codex lines carry no id that tells the copy from this session's own. A copied typed line whose words the
+ * person types again would count, and the copied calls with it (review). So a fork is read as nothing, like an import.
+ */
+export declare function isForkedRollout(rolloutPath: string): boolean;
+/** P39: the rollout is one `external_agent_session_imports.json` lists (by its session id): another host's session. */
+export declare function isImportedRollout(path: string, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * 4.16, D82's first half for Codex: the receipt names this session's own rollout where Codex keeps it: a regular
+ * file (not a link), under `codexHome(env)/sessions/` through realpath, named `rollout-*-<session>.jsonl`, whose
+ * `session_meta.id` is the session (HC6).
+ */
+export declare function codexTranscriptOk(r: {
+    transcriptPath: string;
+    session: string;
+}, env?: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=codex-meta.d.ts.map

package/dist/trace/codex-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-meta.d.ts","sourceRoot":"","sources":["../../src/trace/codex-meta.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEtE;AA6BD,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAc/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG5D;AAKD,uHAAuH;AACvH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAY7F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAY/H"}