weave-codex 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,16 @@
+export declare const WEAVE_CODEX_HOME: string;
+export declare const SETTINGS_FILE: string;
+export declare const LOG_FILE: string;
+export declare const CODEX_HOME: string;
+export declare const CODEX_HOOKS_FILE: string;
+export declare const DEFAULT_TRACE_BASE_URL = "https://trace.wandb.ai";
+export declare const GENAI_OTLP_PATH = "/agents/otel/v1/traces";
+export declare const ENV: {
+    readonly WANDB_API_KEY: "WANDB_API_KEY";
+    readonly WANDB_BASE_URL: "WANDB_BASE_URL";
+    readonly WEAVE_PROJECT: "WEAVE_PROJECT";
+    /** Set to "0"/"false" to drop all prompt/code/output content from spans. */
+    readonly CAPTURE_CONTENT: "WEAVE_CODEX_CAPTURE_CONTENT";
+    readonly DEBUG: "WEAVE_CODEX_DEBUG";
+};
+export declare const VERSION: string;

package/dist/constants.js

@@ -0,0 +1,42 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+/**
+ * Cross-cutting constants shared across modules: filesystem paths, environment
+ * variable names, the package version, and the Weave ingest endpoint. Constants
+ * used by only one module live at the top of that module instead.
+ */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// --- Our own state lives under ~/.weave-codex (override for tests via env) ---
+export const WEAVE_CODEX_HOME = process.env.WEAVE_CODEX_HOME ?? join(homedir(), '.weave-codex');
+export const SETTINGS_FILE = join(WEAVE_CODEX_HOME, 'settings.json');
+export const LOG_FILE = join(WEAVE_CODEX_HOME, 'logs', 'collector.log');
+// --- Codex layout we read (rollouts) and modify (hooks.json) ---
+export const CODEX_HOME = process.env.CODEX_HOME ?? join(homedir(), '.codex');
+export const CODEX_HOOKS_FILE = join(CODEX_HOME, 'hooks.json');
+// --- Weave / W&B trace ingest (external contract; kept central) ---
+export const DEFAULT_TRACE_BASE_URL = 'https://trace.wandb.ai';
+// Agents OTLP path (not the legacy /otel/v1/traces calls path) — feeds the Agents UI.
+export const GENAI_OTLP_PATH = '/agents/otel/v1/traces';
+// --- Environment variable names (referenced, never inlined as literals) ---
+export const ENV = {
+    WANDB_API_KEY: 'WANDB_API_KEY',
+    WANDB_BASE_URL: 'WANDB_BASE_URL',
+    WEAVE_PROJECT: 'WEAVE_PROJECT',
+    /** Set to "0"/"false" to drop all prompt/code/output content from spans. */
+    CAPTURE_CONTENT: 'WEAVE_CODEX_CAPTURE_CONTENT',
+    DEBUG: 'WEAVE_CODEX_DEBUG',
+};
+// --- Version, read from package.json so it can never drift from a hardcoded copy ---
+// We ship package.json with the package, so an unreadable file or a missing
+// version is a packaging bug — let it throw loudly rather than mask it as 0.0.0.
+function readVersion() {
+    const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    if (!version)
+        throw new Error('weave-codex: package.json is missing a "version" field');
+    return version;
+}
+export const VERSION = readVersion();
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC;AAEhC;;;;GAIG;AACH,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AACrC,OAAO,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAChC,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAC3B,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;AAExE,kEAAkE;AAClE,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AAE/D,qEAAqE;AACrE,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAC/D,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAExD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,4EAA4E;IAC5E,eAAe,EAAE,6BAA6B;IAC9C,KAAK,EAAE,mBAAmB;CAClB,CAAC;AAEX,sFAAsF;AACtF,4EAA4E;AAC5E,iFAAiF;AACjF,SAAS,WAAW;IAClB,MAAM,EAAC,OAAO,EAAC,GAAG,IAAI,CAAC,KAAK,CAC1B,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC5C,CAAC;IACxB,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The hooks.json command. Run via shell (Codex expands `~`). The trailing `#`
+ * comment is ignored on execution but gives us a stable marker to match on.
+ */
+export declare function hookCommand(): string;
+export declare function writeShim(nodePath: string, collectorJs: string): Promise<string>;
+interface MergeResult {
+    added: string[];
+    alreadyPresent: string[];
+}
+export declare function mergeHooks(): Promise<MergeResult>;
+export declare function removeHooks(): Promise<string[]>;
+export declare function hooksInstalled(): Promise<boolean>;
+export {};

package/dist/install.js

@@ -0,0 +1,177 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+/**
+ * Install/uninstall mechanics: write the detach shim and merge our Stop entry
+ * into ~/.codex/hooks.json without clobbering anything.
+ *
+ * hooks.json is array-based per event, so we APPEND our entry and remove only
+ * our own hook (not the enclosing group) on uninstall. We refuse to overwrite a
+ * corrupt hooks.json, and back it up only once (never clobbering the pristine
+ * copy). Our entry is tagged with a stable marker comment so identification
+ * survives a changed install path.
+ */
+import { promises as fs } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { CODEX_HOOKS_FILE, LOG_FILE, WEAVE_CODEX_HOME } from './constants.js';
+const HOOK_SHIM_FILE = join(WEAVE_CODEX_HOME, 'stop-hook.sh');
+/**
+ * v1 registers only Stop. SubagentStop would fire a redundant worker on the
+ * PARENT rollout (racing the parent's own Stop) — we re-add it when subagent
+ * nesting lands and reads the child transcript.
+ */
+const HOOK_EVENTS = ['Stop'];
+const HOOK_TIMEOUT_SEC = 30;
+/** Stable identity for our hook, independent of the install path. */
+const OWNER_MARKER = 'weave-codex-hook';
+/** POSIX single-quote escaping so apostrophes/backslashes in paths can't break the shell. */
+function shellQuote(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+/**
+ * The hooks.json command. Run via shell (Codex expands `~`). The trailing `#`
+ * comment is ignored on execution but gives us a stable marker to match on.
+ */
+export function hookCommand() {
+    return `sh ${shellQuote(HOOK_SHIM_FILE)} # ${OWNER_MARKER}`;
+}
+function shimContents(nodePath, collectorJs) {
+    return `#!/bin/sh
+# weave-codex Stop-hook shim (generated by \`weave-codex install\`).
+# Hands the Stop payload to a fully-detached worker and returns immediately so
+# Codex is NEVER blocked. Emits nothing on stdout (a stdout decision payload
+# would alter Codex's turn flow).
+NODE=${shellQuote(nodePath)}
+COLLECTOR=${shellQuote(collectorJs)}
+LOG=${shellQuote(LOG_FILE)}
+mkdir -p "$(dirname "$LOG")" 2>/dev/null
+TMP="$(mktemp "\${TMPDIR:-/tmp}/weave-codex.XXXXXX")" || exit 0
+cat > "$TMP"
+# Detach: background subshell with all fds redirected away from Codex's pipes.
+( "$NODE" "$COLLECTOR" "$TMP" >>"$LOG" 2>&1 </dev/null & ) >/dev/null 2>&1
+exit 0
+`;
+}
+export async function writeShim(nodePath, collectorJs) {
+    await fs.mkdir(WEAVE_CODEX_HOME, { recursive: true });
+    await fs.writeFile(HOOK_SHIM_FILE, shimContents(nodePath, collectorJs), {
+        mode: 0o755,
+    });
+    return HOOK_SHIM_FILE;
+}
+export async function mergeHooks() {
+    const file = await readHooksFile(); // throws on corrupt JSON → caller aborts without writing
+    const command = hookCommand();
+    const hooks = (file.hooks ??= {});
+    const added = [];
+    const alreadyPresent = [];
+    for (const event of HOOK_EVENTS) {
+        const groups = (hooks[event] ??= []);
+        if (groups.some(isOurGroup)) {
+            alreadyPresent.push(event);
+            continue;
+        }
+        groups.push({
+            hooks: [{ type: 'command', command, timeout: HOOK_TIMEOUT_SEC }],
+        });
+        added.push(event);
+    }
+    if (added.length > 0) {
+        await backupHooksFile();
+        await writeHooksFile(file);
+    }
+    return { added, alreadyPresent };
+}
+export async function removeHooks() {
+    let file;
+    try {
+        file = await readHooksFile();
+    }
+    catch {
+        return []; // missing or corrupt — nothing safe to do
+    }
+    if (!file.hooks)
+        return [];
+    const removed = [];
+    for (const event of HOOK_EVENTS) {
+        const groups = file.hooks[event];
+        if (!groups)
+            continue;
+        const nextGroups = [];
+        for (const group of groups) {
+            const original = group.hooks ?? [];
+            const kept = original.filter(h => !isOurHook(h)); // remove only OUR hook
+            if (kept.length === original.length) {
+                nextGroups.push(group); // untouched
+            }
+            else {
+                removed.push(event);
+                if (kept.length > 0)
+                    nextGroups.push({ ...group, hooks: kept }); // preserve co-located hooks
+            }
+        }
+        if (nextGroups.length > 0)
+            file.hooks[event] = nextGroups;
+        else
+            delete file.hooks[event];
+    }
+    if (removed.length > 0) {
+        await backupHooksFile();
+        await writeHooksFile(file);
+    }
+    return removed;
+}
+export async function hooksInstalled() {
+    try {
+        const file = await readHooksFile();
+        return HOOK_EVENTS.some(e => (file.hooks?.[e] ?? []).some(isOurGroup));
+    }
+    catch {
+        return false;
+    }
+}
+function isOurHook(handler) {
+    return (typeof handler.command === 'string' &&
+        handler.command.includes(OWNER_MARKER));
+}
+function isOurGroup(group) {
+    return (group.hooks ?? []).some(isOurHook);
+}
+async function readHooksFile() {
+    let raw;
+    try {
+        raw = await fs.readFile(CODEX_HOOKS_FILE, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return {}; // no file yet — fine
+        throw err;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${CODEX_HOOKS_FILE} is not valid JSON — refusing to overwrite it. Fix or remove it, then re-run.`);
+    }
+}
+async function writeHooksFile(file) {
+    await fs.mkdir(dirname(CODEX_HOOKS_FILE), { recursive: true });
+    await fs.writeFile(CODEX_HOOKS_FILE, JSON.stringify(file, null, 2));
+}
+async function backupHooksFile() {
+    const backup = `${CODEX_HOOKS_FILE}.bak`;
+    try {
+        await fs.access(backup);
+        return; // a backup already exists; never clobber the pristine copy
+    }
+    catch {
+        // no backup yet
+    }
+    try {
+        await fs.writeFile(backup, await fs.readFile(CODEX_HOOKS_FILE));
+    }
+    catch {
+        // nothing to back up
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC;AAEhC;;;;;;;;;GASG;AACH,OAAO,EAAC,QAAQ,IAAI,EAAE,EAAC,MAAM,SAAS,CAAC;AACvC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,MAAM,WAAW,CAAC;AAExC,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAE5E,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,MAAM,CAAU,CAAC;AACtC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,qEAAqE;AACrE,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAiBxC,6FAA6F;AAC7F,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,UAAU,CAAC,cAAc,CAAC,MAAM,YAAY,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,WAAmB;IACzD,OAAO;;;;;OAKF,UAAU,CAAC,QAAQ,CAAC;YACf,UAAU,CAAC,WAAW,CAAC;MAC7B,UAAU,CAAC,QAAQ,CAAC;;;;;;;CAOzB,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,WAAmB;IAEnB,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE;QACtE,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,OAAO,cAAc,CAAC;AACxB,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC,CAAC,yDAAyD;IAC7F,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,cAAc,GAAa,EAAE,CAAC;IAEpC,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,CAAC,EAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAC,CAAC;SAC/D,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,eAAe,EAAE,CAAC;QACxB,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,EAAC,KAAK,EAAE,cAAc,EAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,IAAe,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,0CAA0C;IACvD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,UAAU,GAAmB,EAAE,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;YACzE,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY;YACtC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;oBAAE,UAAU,CAAC,IAAI,CAAC,EAAC,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC,4BAA4B;YAC7F,CAAC;QACH,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;;YACrD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,eAAe,EAAE,CAAC;QACxB,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;QACnC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAoB;IACrC,OAAO,CACL,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB;IACrC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC,CAAC,qBAAqB;QACtF,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,GAAG,gBAAgB,+EAA+E,CACnG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAe;IAC3C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,MAAM,MAAM,GAAG,GAAG,gBAAgB,MAAM,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,CAAC,2DAA2D;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;AACH,CAAC"}

package/dist/lock.d.ts

@@ -0,0 +1,7 @@
+type ReleaseLock = () => Promise<void>;
+/**
+ * Returns a release function if the lock was acquired, or null if another live
+ * worker holds it (caller should skip — a later Stop re-reads from the cursor).
+ */
+export declare function acquireLock(sessionId: string): Promise<ReleaseLock | null>;
+export {};

package/dist/lock.js

@@ -0,0 +1,67 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+/**
+ * Per-session advisory lock so two collector workers never process the same
+ * session concurrently (which would double-emit spans or rewind the cursor).
+ *
+ * Uses an O_EXCL create as the lock primitive. A lock older than LOCK_STALE_MS
+ * is assumed orphaned by a crashed worker and stolen, so a killed worker can
+ * never wedge a session permanently.
+ */
+import { createHash } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { WEAVE_CODEX_HOME } from './constants.js';
+const LOCK_DIR = join(WEAVE_CODEX_HOME, 'locks');
+/** A lock older than this is assumed orphaned by a crashed worker and stealable. */
+const LOCK_STALE_MS = 60_000;
+function lockPath(sessionId) {
+    const safe = createHash('sha256')
+        .update(sessionId)
+        .digest('hex')
+        .slice(0, 32);
+    return join(LOCK_DIR, `${safe}.lock`);
+}
+/**
+ * Returns a release function if the lock was acquired, or null if another live
+ * worker holds it (caller should skip — a later Stop re-reads from the cursor).
+ */
+export async function acquireLock(sessionId) {
+    await fs.mkdir(LOCK_DIR, { recursive: true });
+    const path = lockPath(sessionId);
+    if (await tryCreate(path))
+        return makeRelease(path);
+    if (await isStale(path)) {
+        await fs.unlink(path).catch(() => { });
+        if (await tryCreate(path))
+            return makeRelease(path);
+    }
+    return null;
+}
+async function tryCreate(path) {
+    try {
+        const handle = await fs.open(path, 'wx'); // 'wx' = O_CREAT | O_EXCL: fails if it exists
+        await handle.writeFile(String(process.pid));
+        await handle.close();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isStale(path) {
+    try {
+        const { mtimeMs } = await fs.stat(path);
+        return Date.now() - mtimeMs > LOCK_STALE_MS;
+    }
+    catch {
+        return true; // vanished between checks → treat as stealable
+    }
+}
+function makeRelease(path) {
+    return async () => {
+        await fs.unlink(path).catch(() => { });
+    };
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC;AAEhC;;;;;;;GAOG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AACvC,OAAO,EAAC,QAAQ,IAAI,EAAE,EAAC,MAAM,SAAS,CAAC;AACvC,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAE/B,OAAO,EAAC,gBAAgB,EAAC,MAAM,gBAAgB,CAAC;AAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACjD,oFAAoF;AACpF,MAAM,aAAa,GAAG,MAAM,CAAC;AAI7B,SAAS,QAAQ,CAAC,SAAiB;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,SAAS,CAAC;SACjB,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB;IAEjB,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEjC,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtC,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC;YAAE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,8CAA8C;QACxF,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,MAAM,EAAC,OAAO,EAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,aAAa,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC"}

package/dist/log.d.ts

@@ -0,0 +1,4 @@
+type Level = 'info' | 'warn' | 'error';
+export declare function setVerbose(enabled: boolean): void;
+export declare function log(level: Level, message: string, extra?: Record<string, unknown>): void;
+export {};

package/dist/log.js

@@ -0,0 +1,45 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+/**
+ * Minimal append-only JSONL logger for the worker. Errors here must never
+ * surface to Codex, so every write is best-effort. Mirrors to stderr only when
+ * WEAVE_CODEX_DEBUG is set (the detached worker's stderr goes to the log file).
+ */
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { LOG_FILE } from './constants.js';
+/**
+ * Errors always log (they're the actionable failures). info/warn are opt-in via
+ * the `debug` user setting, so the log stays quiet by default — the worker should
+ * be invisible unless something is wrong. The worker calls setVerbose() once it
+ * has resolved config.
+ */
+let verbose = false;
+export function setVerbose(enabled) {
+    verbose = enabled;
+}
+let dirReady = false;
+export function log(level, message, extra) {
+    if (level !== 'error' && !verbose)
+        return;
+    const entry = JSON.stringify({
+        ts: new Date().toISOString(),
+        level,
+        message,
+        ...extra,
+    });
+    try {
+        if (!dirReady) {
+            mkdirSync(dirname(LOG_FILE), { recursive: true });
+            dirReady = true;
+        }
+        appendFileSync(LOG_FILE, `${entry}\n`);
+    }
+    catch {
+        // Logging is best-effort; never throw.
+    }
+    if (verbose)
+        process.stderr.write(`${entry}\n`);
+}
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC;AAEhC;;;;GAIG;AACH,OAAO,EAAC,cAAc,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AAClD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAIxC;;;;;GAKG;AACH,IAAI,OAAO,GAAG,KAAK,CAAC;AACpB,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,MAAM,UAAU,GAAG,CACjB,KAAY,EACZ,OAAe,EACf,KAA+B;IAE/B,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,OAAO;QAAE,OAAO;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,KAAK;QACL,OAAO;QACP,GAAG,KAAK;KACT,CAAC,CAAC;IACH,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;YAChD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,cAAc,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IACD,IAAI,OAAO;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Internal domain model — the reconstructed shape of one Codex turn, decoupled
+ * from both the rollout wire format (rollout/types.ts) and the OTEL span output.
+ * camelCase here; the wire format stays snake_case. This is the seam the parser
+ * produces and the span emitter consumes.
+ */
+/** Normalized token usage for a single model call or a turn total. */
+export interface NormalizedUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    reasoningOutputTokens: number;
+}
+export type ToolKind = 'function' | 'local_shell' | 'web_search' | 'custom' | 'mcp';
+/** A tool execution → one `execute_tool` span. */
+export interface ToolCall {
+    callId: string;
+    name: string;
+    kind: ToolKind;
+    startTime: Date;
+    endTime: Date;
+    arguments?: string;
+    result?: string;
+    error?: string;
+    mcpServer?: string;
+}
+/** A tool the model requested within a chat (for that chat's output.messages). */
+export interface ChatToolRef {
+    callId: string;
+    name: string;
+    arguments?: string;
+}
+/** A single model round-trip → one `chat` span. */
+export interface ChatCall {
+    startTime: Date;
+    endTime: Date;
+    text?: string;
+    reasoning?: string;
+    toolCalls: ChatToolRef[];
+    usage?: NormalizedUsage;
+    finishReason: string;
+}
+/** One completed user→agent turn → one trace rooted at an `invoke_agent` span. */
+export interface ReconstructedTurn {
+    sessionId: string;
+    turnId: string;
+    conversationId: string;
+    model: string;
+    startTime: Date;
+    endTime: Date;
+    cwd?: string;
+    cliVersion?: string;
+    userMessage?: string;
+    finalAssistantMessage?: string;
+    chats: ChatCall[];
+    tools: ToolCall[];
+    usageTotal: NormalizedUsage;
+}

package/dist/model.js

@@ -0,0 +1,5 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,+BAA+B;AAC/B,gCAAgC"}

package/dist/rollout/cursor.d.ts

@@ -0,0 +1,13 @@
+export declare function readOffset(sessionId: string): Promise<number>;
+export declare function writeOffset(sessionId: string, offset: number): Promise<void>;
+interface NewLinesResult {
+    lines: string[];
+    /** End of the last COMPLETE line read; commit only after successful emit. */
+    nextOffset: number;
+}
+/**
+ * Read complete (newline-terminated) lines from `fromOffset` to EOF. A trailing
+ * partial line (writer mid-flush) is left unconsumed for the next read.
+ */
+export declare function readNewLines(filePath: string, fromOffset: number): Promise<NewLinesResult>;
+export {};

package/dist/rollout/cursor.js

@@ -0,0 +1,74 @@
+// SPDX-FileCopyrightText: 2026 CoreWeave, Inc.
+// SPDX-License-Identifier: MIT
+// SPDX-PackageName: weave-codex
+/**
+ * Per-session byte-offset cursor so each Stop hook reads only the rollout bytes
+ * appended since the previous turn. Rollout files are strictly append-only, so a
+ * byte offset is a safe, simple cursor.
+ */
+import { createHash } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { WEAVE_CODEX_HOME } from '../constants.js';
+/** Per-session byte-offset cursors so each turn reads only new rollout lines. */
+const CURSOR_DIR = join(WEAVE_CODEX_HOME, 'cursors');
+function cursorPath(sessionId) {
+    // Session ids are UUID-ish but hash anyway so the filename is always safe.
+    const safe = createHash('sha256')
+        .update(sessionId)
+        .digest('hex')
+        .slice(0, 32);
+    return join(CURSOR_DIR, `${safe}.offset`);
+}
+export async function readOffset(sessionId) {
+    try {
+        const raw = await fs.readFile(cursorPath(sessionId), 'utf8');
+        const n = Number.parseInt(raw.trim(), 10);
+        return Number.isFinite(n) && n >= 0 ? n : 0;
+    }
+    catch {
+        return 0; // no cursor yet → read from the start of the file
+    }
+}
+export async function writeOffset(sessionId, offset) {
+    await fs.mkdir(CURSOR_DIR, { recursive: true });
+    // Never move the cursor backward: a slow/racing worker must not rewind past a
+    // newer worker's commit (which would re-emit later turns).
+    const current = await readOffset(sessionId);
+    if (offset <= current)
+        return;
+    await fs.writeFile(cursorPath(sessionId), String(offset), 'utf8');
+}
+/**
+ * Read complete (newline-terminated) lines from `fromOffset` to EOF. A trailing
+ * partial line (writer mid-flush) is left unconsumed for the next read.
+ */
+export async function readNewLines(filePath, fromOffset) {
+    const handle = await fs.open(filePath, 'r');
+    try {
+        const { size } = await handle.stat();
+        if (size <= fromOffset)
+            return { lines: [], nextOffset: fromOffset };
+        const length = size - fromOffset;
+        const buffer = Buffer.allocUnsafe(length);
+        // Honor bytesRead: a short read leaves the buffer tail uninitialized, so we
+        // must only decode the bytes actually read (a rare under-read of the tail is
+        // re-read from the same offset on the next Stop).
+        const { bytesRead } = await handle.read(buffer, 0, length, fromOffset);
+        const text = buffer.subarray(0, bytesRead).toString('utf8');
+        const lastNewline = text.lastIndexOf('\n');
+        if (lastNewline === -1)
+            return { lines: [], nextOffset: fromOffset };
+        const complete = text.slice(0, lastNewline);
+        // Keep lines 1:1 with newline-delimited records (no empty filter) so the
+        // caller can map line index → byte offset exactly when committing the cursor.
+        const lines = complete.split('\n');
+        // +1 for the consumed newline byte. byteLength because offsets are bytes.
+        const nextOffset = fromOffset + Buffer.byteLength(complete, 'utf8') + 1;
+        return { lines, nextOffset };
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/rollout/cursor.js.map

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

package/dist/rollout/parser.d.ts

@@ -0,0 +1,26 @@
+import type { ReconstructedTurn } from '../model.js';
+import type { RolloutLine } from './types.js';
+/** Fallbacks for fields a read slice may lack (no session_meta/turn_context in this chunk). */
+interface ReconstructContext {
+    fallbackSessionId: string;
+    fallbackModel?: string;
+}
+export interface ReconstructResult {
+    turns: ReconstructedTurn[];
+    /**
+     * Count of input lines belonging to fully-completed turns. The caller commits
+     * its cursor only this far so a not-yet-flushed trailing turn is re-read next
+     * time rather than skipped (exactly-once for complete turns, no loss).
+     */
+    consumedLines: number;
+    /**
+     * Turns that began but never completed before a new turn started (e.g. an
+     * aborted turn). They are intentionally dropped (out of v1 scope); the count
+     * lets the caller log that something was discarded.
+     */
+    abandonedTurns: number;
+}
+/** Parse one raw line, or null if malformed/blank (kept aligned by the caller). */
+export declare function parseLineMaybe(raw: string): RolloutLine | null;
+export declare function reconstructTurns(lines: ReadonlyArray<RolloutLine | null>, context: ReconstructContext): ReconstructResult;
+export {};