@excitedjs/agent-runtime-codex 0.3.5-beta.167 → 1.0.0-beta.169

package/dist/supervisor.js

@@ -22,6 +22,9 @@ export class CodexProcess {
     cwd;
     supervisor = null;
     _pid = null;
+    startTask = null;
+    reapTask = null;
+    reapRequested = false;
     reaped = false;
     exitHandlers = [];
     constructor(opts) {
@@ -37,9 +40,21 @@ export class CodexProcess {
     }
     /** Spawn the daemon and resolve once its listen socket is bound. */
     async start() {
-        if (this.supervisor !== null) {
+        if (this.supervisor !== null || this.startTask !== null) {
             throw new Error('CodexProcess.start: already started');
         }
+        this.assertStartAllowed();
+        const task = this.startProcess();
+        this.startTask = task;
+        try {
+            await task;
+        }
+        finally {
+            if (this.startTask === task)
+                this.startTask = null;
+        }
+    }
+    async startProcess() {
         const binPath = this.opts.binPath ?? (process.env['CODEX_HOST_CODEX_BIN'] || 'codex');
         const args = [
             'app-server',
@@ -66,58 +81,91 @@ export class CodexProcess {
         // so they cannot be garbage-collected — and thus closed out from under the
         // child — between open and spawn. They are closed once the child owns the
         // inherited fds, matching the previous openSync/closeSync timing.
-        const stdoutHandle = await open(this.opts.stdoutLogPath, 'a', 0o600);
-        const stderrHandle = await open(this.opts.stderrLogPath, 'a', 0o600);
-        const supervisor = new SupervisedChild({
-            kind: 'spawn',
-            command: binPath,
-            args,
-            options: {
-                cwd: this.opts.cwd,
-                env: this.opts.env ?? process.env,
-                stdio: ['ignore', stdoutHandle.fd, stderrHandle.fd],
-            },
-        });
-        supervisor.onError(() => {
-            /* daemon-side error, can no longer affect this process */
-        });
-        supervisor.onExit((exit) => {
-            if (this.reaped)
-                return;
-            for (const handler of this.exitHandlers) {
+        const logHandles = [];
+        try {
+            const stdoutHandle = await open(this.opts.stdoutLogPath, 'a', 0o600);
+            logHandles.push(stdoutHandle);
+            const stderrHandle = await open(this.opts.stderrLogPath, 'a', 0o600);
+            logHandles.push(stderrHandle);
+            this.assertStartAllowed();
+            const supervisor = new SupervisedChild({
+                kind: 'spawn',
+                command: binPath,
+                args,
+                options: {
+                    cwd: this.opts.cwd,
+                    env: this.opts.env ?? process.env,
+                    stdio: ['ignore', stdoutHandle.fd, stderrHandle.fd],
+                },
+            });
+            supervisor.onError(() => {
+                /* daemon-side error, can no longer affect this process */
+            });
+            supervisor.onExit((exit) => {
+                if (this.reapRequested || this.reaped)
+                    return;
+                for (const handler of this.exitHandlers) {
+                    try {
+                        handler(exit);
+                    }
+                    catch {
+                        /* exit observers must not poison process event dispatch */
+                    }
+                }
+            });
+            // Publish termination authority before the spawn await. A concurrent
+            // reap waits for this start task and can never miss a late child.
+            this.supervisor = supervisor;
+            try {
+                const child = await supervisor.start();
+                this.assertStartAllowed();
+                const pid = child.pid;
+                this._pid = pid;
+                await waitForSocket(this.opts.socketPath, pid, this.opts.readyTimeoutMs ?? 10000);
+                this.assertStartAllowed();
+            }
+            catch (error) {
                 try {
-                    handler(exit);
+                    await this.terminateSpawnedProcess();
                 }
-                catch {
-                    /* exit observers must not poison process event dispatch */
+                catch (stopError) {
+                    throw new AggregateError([error, stopError], 'Codex process start failed and termination could not be proved');
                 }
+                throw error;
             }
-        });
-        let child;
-        try {
-            child = await supervisor.start();
         }
         finally {
-            await stdoutHandle.close();
-            await stderrHandle.close();
-        }
-        const pid = child.pid;
-        this.supervisor = supervisor;
-        this._pid = pid;
-        try {
-            await waitForSocket(this.opts.socketPath, pid, this.opts.readyTimeoutMs ?? 10000);
-        }
-        catch (e) {
-            await this.reap();
-            throw e;
+            // The child already inherited these descriptors. Parent-side close
+            // errors cannot make a successfully supervised child unowned.
+            await Promise.all(logHandles.map((handle) => handle.close().catch(() => undefined)));
         }
     }
     /** SIGTERM → 1s wait → SIGKILL group. Idempotent. */
-    async reap() {
+    reap() {
         if (this.reaped)
-            return;
+            return Promise.resolve();
+        if (this.reapTask !== null)
+            return this.reapTask;
+        this.reapRequested = true;
+        const task = this.reapProcess();
+        this.reapTask = task;
+        void task.catch(() => {
+            if (this.reapTask === task)
+                this.reapTask = null;
+        });
+        return task;
+    }
+    async reapProcess() {
+        // If no supervisor has been published, `reapRequested` is itself the
+        // fence: every later pre-spawn seam checks it before creating a child. Do
+        // not join an arbitrary filesystem/startup wait that owns no process yet.
+        if (this.supervisor !== null)
+            await this.terminateSpawnedProcess();
         this.reaped = true;
-        await this.supervisor?.stop();
+    }
+    async terminateSpawnedProcess() {
+        const supervisor = this.supervisor;
+        await supervisor?.stop();
         try {
             await rm(this.opts.socketPath, { force: true });
         }
@@ -129,7 +177,15 @@ export class CodexProcess {
         // flows over the socket, so they are usually empty (issue #182 logs stage).
         await removeEmptyLogFile(this.opts.stdoutLogPath);
         await removeEmptyLogFile(this.opts.stderrLogPath);
-        this.supervisor = null;
+        if (this.supervisor === supervisor) {
+            this.supervisor = null;
+            this._pid = null;
+        }
+    }
+    assertStartAllowed() {
+        if (this.reapRequested || this.reaped) {
+            throw new Error('CodexProcess.start: stopped during start');
+        }
     }
 }
 async function waitForSocket(path, pid, timeoutMs) {

package/dist/supervisor.js.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AA4BlC,8DAA8D;AAC9D,MAAM,OAAO,YAAY;IAWM;IAVpB,UAAU,CAAS;IACnB,GAAG,CAAS;IACb,UAAU,GAA2B,IAAI,CAAC;IAC1C,IAAI,GAAkB,IAAI,CAAC;IAC3B,SAAS,GAAyB,IAAI,CAAC;IACvC,QAAQ,GAAyB,IAAI,CAAC;IACtC,aAAa,GAAG,KAAK,CAAC;IACtB,MAAM,GAAG,KAAK,CAAC;IACN,YAAY,GAA8B,EAAE,CAAC;IAE9D,YAA6B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;QACpD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACtB,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,OAAgC;QACrC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC;QACb,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;gBAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACrD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,OAAO,GACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,OAAO,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG;YACX,YAAY;YACZ,UAAU;YACV,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;SAC/B,CAAC;QAEF,wEAAwE;QACxE,wEAAwE;QACxE,2DAA2D;QAC3D,MAAM,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACxD,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,mEAAmE;QACnE,2BAA2B;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;QAED,sEAAsE;QACtE,0EAA0E;QAC1E,2EAA2E;QAC3E,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,UAAU,GAA4C,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACrE,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACrE,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9B,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC;gBACrC,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO;gBAChB,IAAI;gBACJ,OAAO,EAAE;oBACP,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG;oBAClB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;oBACjC,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC;iBACpD;aACF,CAAC,CAAC;YACH,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;gBACtB,0DAA0D;YAC5D,CAAC,CAAC,CAAC;YACH,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM;oBAAE,OAAO;gBAC9C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACxC,IAAI,CAAC;wBACH,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChB,CAAC;oBAAC,MAAM,CAAC;wBACP,2DAA2D;oBAC7D,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YACH,qEAAqE;YACrE,kEAAkE;YAClE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;YAE7B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;gBACvC,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAI,CAAC;gBACvB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;gBAChB,MAAM,aAAa,CACjB,IAAI,CAAC,IAAI,CAAC,UAAU,EACpB,GAAG,EACH,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,KAAK,CAClC,CAAC;gBACF,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;gBACvC,CAAC;gBAAC,OAAO,SAAS,EAAE,CAAC;oBACnB,MAAM,IAAI,cAAc,CACtB,CAAC,KAAK,EAAE,SAAS,CAAC,EAClB,gEAAgE,CACjE,CAAC;gBACJ,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,mEAAmE;YACnE,8DAA8D;YAC9D,MAAM,OAAO,CAAC,GAAG,CACf,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,IAAI;QACF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACjD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACnB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,qEAAqE;QACrE,0EAA0E;QAC1E,0EAA0E;QAC1E,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,MAAM,UAAU,EAAE,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,yEAAyE;QACzE,4EAA4E;QAC5E,4EAA4E;QAC5E,MAAM,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAED,KAAK,UAAU,aAAa,CAC1B,IAAY,EACZ,GAAW,EACX,SAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,EAAE,CAAC,QAAQ,EAAE;gBAAE,OAAO;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,2BAA2B,IAAI,EAAE,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,kBAAkB,IAAI,WAAW,SAAS,IAAI,CACvE,CAAC;AACJ,CAAC"}

package/dist/transcript/budget.d.ts

@@ -0,0 +1,8 @@
+import { type TranscriptScanBudget } from '@excitedjs/dreamux-utils';
+export type CodexTranscriptBudget = TranscriptScanBudget;
+export declare function createCodexTranscriptBudget(input?: {
+    maxEntries?: number;
+    maxElapsedMs?: number;
+    now?: () => number;
+}): CodexTranscriptBudget;
+//# sourceMappingURL=budget.d.ts.map

package/dist/transcript/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/transcript/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAIlC,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD,wBAAgB,2BAA2B,CAAC,KAAK,GAAE;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACf,GAAG,qBAAqB,CAS7B"}

package/dist/transcript/budget.js

@@ -0,0 +1,9 @@
+import { createTranscriptScanBudget, } from '@excitedjs/dreamux-utils';
+import { CodexTranscriptError } from './error.js';
+export function createCodexTranscriptBudget(input = {}) {
+    return createTranscriptScanBudget({
+        ...input,
+        limitError: () => new CodexTranscriptError('scan_unsupported', 'Codex transcript discovery exceeded its bounded scan limit'),
+    });
+}
+//# sourceMappingURL=budget.js.map

package/dist/transcript/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/transcript/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,GAE3B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,UAAU,2BAA2B,CAAC,QAIxC,EAAE;IACJ,OAAO,0BAA0B,CAAC;QAChC,GAAG,KAAK;QACR,UAAU,EAAE,GAAG,EAAE,CACf,IAAI,oBAAoB,CACtB,kBAAkB,EAClB,4DAA4D,CAC7D;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist/transcript/cursor.d.ts

@@ -0,0 +1,23 @@
+import { transcriptDigest } from '@excitedjs/dreamux-utils';
+export interface CodexCursorPosition {
+    segment: number;
+    offset: number;
+}
+interface CodexCursorEnvelope {
+    v: 1;
+    p: 'codex';
+    fp: string;
+    gen: string;
+    pos: CodexCursorPosition;
+    bd: string;
+}
+export declare function codexQueryFingerprint(includeTools: boolean): string;
+export declare function encodeCodexCursor(input: {
+    fingerprint: string;
+    generation: string;
+    position: CodexCursorPosition;
+    boundaryDigest: string;
+}): string;
+export declare function decodeCodexCursor(cursor: string, expectedFingerprint: string): CodexCursorEnvelope;
+export { transcriptDigest as digest };
+//# sourceMappingURL=cursor.d.ts.map

package/dist/transcript/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/transcript/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAIlC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,mBAAmB;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,OAAO,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,mBAAmB,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAUT;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,MAAM,GAC1B,mBAAmB,CA0BrB;AAyBD,OAAO,EAAE,gBAAgB,IAAI,MAAM,EAAE,CAAC"}

package/dist/transcript/cursor.js

@@ -0,0 +1,57 @@
+import { isTranscriptDigest, transcriptDigest, } from '@excitedjs/dreamux-utils';
+import { CodexTranscriptError } from './error.js';
+export function codexQueryFingerprint(includeTools) {
+    return transcriptDigest(JSON.stringify({ include_tools: includeTools }));
+}
+export function encodeCodexCursor(input) {
+    const envelope = {
+        v: 1,
+        p: 'codex',
+        fp: input.fingerprint,
+        gen: input.generation,
+        pos: input.position,
+        bd: input.boundaryDigest,
+    };
+    return Buffer.from(JSON.stringify(envelope), 'utf8').toString('base64url');
+}
+export function decodeCodexCursor(cursor, expectedFingerprint) {
+    let value;
+    try {
+        const decoded = Buffer.from(cursor, 'base64url');
+        if (decoded.length === 0 || decoded.length > 3072)
+            throw new Error('size');
+        value = JSON.parse(decoded.toString('utf8'));
+    }
+    catch (error) {
+        throw new CodexTranscriptError('cursor_invalid', 'Codex transcript cursor is invalid', { cause: error });
+    }
+    if (!isCursorEnvelope(value)) {
+        throw new CodexTranscriptError('cursor_invalid', 'Codex transcript cursor is invalid');
+    }
+    if (value.fp !== expectedFingerprint) {
+        throw new CodexTranscriptError('cursor_query_mismatch', 'Codex transcript cursor belongs to a different query');
+    }
+    return value;
+}
+function isCursorEnvelope(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const record = value;
+    const position = record['pos'];
+    return (Object.keys(record).length === 6 &&
+        record['v'] === 1 &&
+        record['p'] === 'codex' &&
+        isTranscriptDigest(record['fp']) &&
+        isTranscriptDigest(record['gen']) &&
+        isTranscriptDigest(record['bd']) &&
+        position !== null &&
+        typeof position === 'object' &&
+        !Array.isArray(position) &&
+        Number.isInteger(position['segment']) &&
+        position['segment'] >= 0 &&
+        Number.isSafeInteger(position['offset']) &&
+        position['offset'] >= 0);
+}
+export { transcriptDigest as digest };
+//# sourceMappingURL=cursor.js.map

package/dist/transcript/cursor.js.map

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

package/dist/transcript/error.d.ts

@@ -0,0 +1,9 @@
+import type { AgentRuntimeTranscriptError } from '@excitedjs/dreamux-types';
+export declare class CodexTranscriptError extends Error implements AgentRuntimeTranscriptError {
+    readonly reason: AgentRuntimeTranscriptError['reason'];
+    readonly name = "AgentRuntimeTranscriptError";
+    constructor(reason: AgentRuntimeTranscriptError['reason'], message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/transcript/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/transcript/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAE5E,qBAAa,oBACX,SAAQ,KACR,YAAW,2BAA2B;IAKpC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC;IAHxD,QAAQ,CAAC,IAAI,iCAAiC;gBAGnC,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,EACtD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAIpC"}

package/dist/transcript/error.js

@@ -0,0 +1,9 @@
+export class CodexTranscriptError extends Error {
+    reason;
+    name = 'AgentRuntimeTranscriptError';
+    constructor(reason, message, options = {}) {
+        super(message, options);
+        this.reason = reason;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/transcript/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/transcript/error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBACX,SAAQ,KAAK;IAMF;IAHF,IAAI,GAAG,6BAA6B,CAAC;IAE9C,YACW,MAA6C,EACtD,OAAe,EACf,UAA+B,EAAE;QAEjC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAJf,WAAM,GAAN,MAAM,CAAuC;IAKxD,CAAC;CACF"}

package/dist/transcript/opened-file.d.ts

@@ -0,0 +1,10 @@
+import { type FileHandle } from 'node:fs/promises';
+export interface CodexOpenedTranscript {
+    handle: FileHandle;
+    path: string;
+    size: number;
+    dev: number | bigint;
+    ino: number | bigint;
+}
+export declare function openCodexTranscript(candidate: string, canonicalRoots: readonly string[]): Promise<CodexOpenedTranscript>;
+//# sourceMappingURL=opened-file.d.ts.map

package/dist/transcript/opened-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opened-file.d.ts","sourceRoot":"","sources":["../../src/transcript/opened-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAAC,qBAAqB,CAAC,CA4DhC"}

package/dist/transcript/opened-file.js

@@ -0,0 +1,61 @@
+import { constants } from 'node:fs';
+import { open, realpath } from 'node:fs/promises';
+import { isPathWithin } from '@excitedjs/dreamux-utils';
+import { CodexTranscriptError } from './error.js';
+export async function openCodexTranscript(candidate, canonicalRoots) {
+    let handle;
+    try {
+        handle = await open(candidate, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+    }
+    catch (error) {
+        throw classifyOpenError(error);
+    }
+    try {
+        const [opened, canonicalPath] = await Promise.all([
+            handle.stat(),
+            realpath(candidate),
+        ]);
+        if (!opened.isFile()) {
+            throw new CodexTranscriptError('invalid', 'Codex transcript is not a regular file');
+        }
+        if (!canonicalRoots.some((root) => isPathWithin(root, canonicalPath))) {
+            throw new CodexTranscriptError('locator_outside_root', 'Codex transcript locator is outside the native transcript roots');
+        }
+        const current = await open(canonicalPath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0)).catch((error) => {
+            throw classifyOpenError(error);
+        });
+        try {
+            const currentStat = await current.stat();
+            if (opened.dev !== currentStat.dev || opened.ino !== currentStat.ino) {
+                throw new CodexTranscriptError('unreadable', 'Codex transcript changed while opening');
+            }
+        }
+        finally {
+            await current.close();
+        }
+        return {
+            handle,
+            path: canonicalPath,
+            size: opened.size,
+            dev: opened.dev,
+            ino: opened.ino,
+        };
+    }
+    catch (error) {
+        await handle.close().catch(() => undefined);
+        if (error instanceof CodexTranscriptError)
+            throw error;
+        throw new CodexTranscriptError('unreadable', 'Codex transcript is unreadable', { cause: error });
+    }
+}
+function classifyOpenError(error) {
+    const code = error.code;
+    if (code === 'ENOENT') {
+        return new CodexTranscriptError('not_found', 'Codex transcript is unavailable', { cause: error });
+    }
+    if (code === 'ELOOP') {
+        return new CodexTranscriptError('locator_outside_root', 'Codex transcript locator is outside the native transcript roots', { cause: error });
+    }
+    return new CodexTranscriptError('unreadable', 'Codex transcript is unreadable', { cause: error });
+}
+//# sourceMappingURL=opened-file.js.map

package/dist/transcript/opened-file.js.map

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

package/dist/transcript/path.d.ts

@@ -0,0 +1,28 @@
+import type { DreamuxEnvironment } from '@excitedjs/dreamux-types';
+import { type CodexTranscriptBudget } from './budget.js';
+import { type CodexOpenedTranscript } from './opened-file.js';
+export interface CodexTranscriptRoots {
+    home: string;
+    sessions: string;
+    archived: string;
+}
+export interface CodexValidatedTranscript {
+    path: string;
+    root: string;
+    sessionId: string;
+    rolloutId: string;
+    historyBase: CodexHistoryBase | null;
+    dev: number | bigint;
+    ino: number | bigint;
+}
+export interface CodexHistoryBase {
+    rolloutId: string;
+    endByteOffset: number;
+}
+export declare function resolveCodexTranscriptRoots(env?: DreamuxEnvironment): Promise<CodexTranscriptRoots>;
+export declare function validateCodexThreadPath(candidate: string, expectedSessionId: string, roots: CodexTranscriptRoots): Promise<CodexValidatedTranscript>;
+export declare function validateCodexTranscriptLocator(candidate: string, expectedSessionId: string, roots: CodexTranscriptRoots): Promise<CodexValidatedTranscript>;
+export declare function locateCodexTranscript(locator: string | null | undefined, expectedSessionId: string, roots: CodexTranscriptRoots, budget?: CodexTranscriptBudget): Promise<CodexValidatedTranscript>;
+export declare function findCodexRolloutById(roots: CodexTranscriptRoots, rolloutId: string, budget?: CodexTranscriptBudget): Promise<CodexValidatedTranscript>;
+export declare function readCodexTranscriptText(opened: CodexOpenedTranscript, maxDecodedBytes: number): Promise<string>;
+//# sourceMappingURL=path.d.ts.map

package/dist/transcript/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/transcript/path.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,2BAA2B,CAC/C,GAAG,GAAE,kBAAgC,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAuC/B;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CAoCnC;AAED,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CAMnC;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,oBAAoB,EAC3B,MAAM,GAAE,qBAAqD,GAC5D,OAAO,CAAC,wBAAwB,CAAC,CA4CnC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,qBAAqD,GAC5D,OAAO,CAAC,wBAAwB,CAAC,CA2BnC;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,qBAAqB,EAC7B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAwCjB"}