@parall/codex-agent 1.45.0 → 1.47.0

package/dist/session-manager.d.ts

@@ -13,10 +13,22 @@ export declare class CodexSessionManager {
     private readonly stateFilePath;
     private readonly logger?;
     private readonly threadIds;
+    private readonly effectiveInstructionsShas;
     constructor(mainSessionKey: string, stateFilePath: string, logger?: Logger | undefined);
     isMain(sessionKey: string): boolean;
     getThreadId(sessionKey: string): string | undefined;
     recordThreadId(sessionKey: string, threadId: string): void;
+    /**
+     * Record a freshly-STARTED thread together with the sha of the
+     * instructions baked into it — one atomic state-file write. Two separate
+     * writes (thread id, then sha) would leave a crash window whose survivor
+     * looks exactly like a pre-tracking legacy file, and the reconcile path
+     * deliberately does NOT compact legacy state — a stale thread would then
+     * be recorded as carrying instructions it never saw.
+     */
+    recordStartedThread(sessionKey: string, threadId: string, effectiveSha: string | undefined): void;
+    getEffectiveInstructionsSha(sessionKey: string): string | undefined;
+    recordEffectiveInstructionsSha(sessionKey: string, sha: string): void;
     createForkSessionKey(): ForkSessionHandle;
     cleanupFork(sessionKey: string): void;
     /** Clear the main thread id when app-server rejects it (stale / deleted). */

package/dist/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAO5D,KAAK,MAAM,GAAG;IAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,mBAAmB;IAI5B,QAAQ,CAAC,cAAc,EAAE,MAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAL1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;gBAG5C,cAAc,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,YAAA;IAKlC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAInC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAInD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAOnD,oBAAoB,IAAI,iBAAiB;IAOzC,WAAW,CAAC,UAAU,EAAE,MAAM;IAI9B,6EAA6E;IAC7E,eAAe;IAWf,OAAO,CAAC,OAAO;IAoBf,OAAO,CAAC,OAAO;CAqBhB"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuB5D,KAAK,MAAM,GAAG;IAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,mBAAmB;IAK5B,QAAQ,CAAC,cAAc,EAAE,MAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAN1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA6B;gBAG5D,cAAc,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,MAAM,YAAA;IAKlC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAInC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAInD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAcnD;;;;;;;OAOG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS;IAY1F,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAInE,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAO9D,oBAAoB,IAAI,iBAAiB;IAOzC,WAAW,CAAC,UAAU,EAAE,MAAM;IAK9B,6EAA6E;IAC7E,eAAe;IAYf,OAAO,CAAC,OAAO;IA6Bf,OAAO,CAAC,OAAO;CAuBhB"}

package/dist/session-manager.js

@@ -11,6 +11,7 @@ export class CodexSessionManager {
     stateFilePath;
     logger;
     threadIds = new Map();
+    effectiveInstructionsShas = new Map();
     constructor(mainSessionKey, stateFilePath, logger) {
         this.mainSessionKey = mainSessionKey;
         this.stateFilePath = stateFilePath;
@@ -24,9 +25,45 @@ export class CodexSessionManager {
         return this.threadIds.get(sessionKey);
     }
     recordThreadId(sessionKey, threadId) {
+        // An effective-instructions sha is a fact about one specific thread.
+        // Recording a DIFFERENT thread id under the same session invalidates it;
+        // re-recording the same id (the resume path) must preserve it, or every
+        // bridge restart would trigger a redundant refresh.
+        if (this.threadIds.get(sessionKey) !== threadId) {
+            this.effectiveInstructionsShas.delete(sessionKey);
+        }
+        this.threadIds.set(sessionKey, threadId);
+        if (sessionKey === this.mainSessionKey) {
+            this.persist();
+        }
+    }
+    /**
+     * Record a freshly-STARTED thread together with the sha of the
+     * instructions baked into it — one atomic state-file write. Two separate
+     * writes (thread id, then sha) would leave a crash window whose survivor
+     * looks exactly like a pre-tracking legacy file, and the reconcile path
+     * deliberately does NOT compact legacy state — a stale thread would then
+     * be recorded as carrying instructions it never saw.
+     */
+    recordStartedThread(sessionKey, threadId, effectiveSha) {
         this.threadIds.set(sessionKey, threadId);
+        if (effectiveSha) {
+            this.effectiveInstructionsShas.set(sessionKey, effectiveSha);
+        }
+        else {
+            this.effectiveInstructionsShas.delete(sessionKey);
+        }
+        if (sessionKey === this.mainSessionKey) {
+            this.persist();
+        }
+    }
+    getEffectiveInstructionsSha(sessionKey) {
+        return this.effectiveInstructionsShas.get(sessionKey);
+    }
+    recordEffectiveInstructionsSha(sessionKey, sha) {
+        this.effectiveInstructionsShas.set(sessionKey, sha);
         if (sessionKey === this.mainSessionKey) {
-            this.persist(threadId);
+            this.persist();
         }
     }
     createForkSessionKey() {
@@ -37,10 +74,12 @@ export class CodexSessionManager {
     }
     cleanupFork(sessionKey) {
         this.threadIds.delete(sessionKey);
+        this.effectiveInstructionsShas.delete(sessionKey);
     }
     /** Clear the main thread id when app-server rejects it (stale / deleted). */
     clearMainThread() {
         this.threadIds.delete(this.mainSessionKey);
+        this.effectiveInstructionsShas.delete(this.mainSessionKey);
         try {
             fs.rmSync(this.stateFilePath, { force: true });
         }
@@ -56,6 +95,10 @@ export class CodexSessionManager {
                 typeof parsed.threadId === 'string' &&
                 parsed.threadId.trim()) {
                 this.threadIds.set(this.mainSessionKey, parsed.threadId.trim());
+                if (typeof parsed.effectiveInstructionsSha === 'string' &&
+                    parsed.effectiveInstructionsSha.trim()) {
+                    this.effectiveInstructionsShas.set(this.mainSessionKey, parsed.effectiveInstructionsSha.trim());
+                }
             }
         }
         catch (error) {
@@ -64,7 +107,10 @@ export class CodexSessionManager {
             }
         }
     }
-    persist(threadId) {
+    persist() {
+        const threadId = this.threadIds.get(this.mainSessionKey);
+        if (!threadId)
+            return;
         // Atomic write: truncate-in-place risks leaving a half-written / zero-byte
         // state file if the process dies between `open(O_TRUNC)` and the final
         // fsync. Since this file is the sole source of cross-restart `resume`
@@ -74,7 +120,11 @@ export class CodexSessionManager {
         try {
             fs.mkdirSync(path.dirname(this.stateFilePath), { recursive: true });
             const tmpPath = `${this.stateFilePath}.tmp`;
-            fs.writeFileSync(tmpPath, JSON.stringify({ runtimeKey: this.mainSessionKey, threadId }, null, 2));
+            const state = { runtimeKey: this.mainSessionKey, threadId };
+            const effectiveSha = this.effectiveInstructionsShas.get(this.mainSessionKey);
+            if (effectiveSha)
+                state.effectiveInstructionsSha = effectiveSha;
+            fs.writeFileSync(tmpPath, JSON.stringify(state, null, 2));
             fs.renameSync(tmpPath, this.stateFilePath);
         }
         catch (error) {

package/dist/turn-sink.d.ts

@@ -19,5 +19,8 @@ export declare class TurnSink {
     push(envelope: TurnEventEnvelope): void;
     next(): Promise<TurnEventEnvelope>;
     close(): void;
+    /** True once close() ran — the sink's terminal state (queued envelopes may
+     * still drain via next()). */
+    get isClosed(): boolean;
 }
 //# sourceMappingURL=turn-sink.d.ts.map

package/dist/turn-sink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-sink.d.ts","sourceRoot":"","sources":["../src/turn-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,mEAAmE;AACnE,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,cAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,MAAM,CAAS;IAEvB,IAAI,CAAC,QAAQ,EAAE,iBAAiB;IAWhC,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAelC,KAAK;CAMN"}
+{"version":3,"file":"turn-sink.d.ts","sourceRoot":"","sources":["../src/turn-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,mEAAmE;AACnE,qBAAa,QAAQ;IACnB,QAAQ,CAAC,MAAM,cAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,MAAM,CAAS;IAEvB,IAAI,CAAC,QAAQ,EAAE,iBAAiB;IAWhC,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAelC,KAAK;IAOL;kCAC8B;IAC9B,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF"}

package/dist/turn-sink.js

@@ -37,4 +37,9 @@ export class TurnSink {
         this.resolver = null;
         r?.({ kind: 'turn_end' });
     }
+    /** True once close() ran — the sink's terminal state (queued envelopes may
+     * still drain via next()). */
+    get isClosed() {
+        return this.closed;
+    }
 }

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAC;AAUF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAAG,SAAS,EAChD,EAAE,EAAE,MAAM,IAAI,GACb,IAAI,CAkJN;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE;IACnC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAuJP;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAK/E;AAED;;;;;;;;;;;;;GAaG;AACH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAerD;AAED,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0BD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACrC,IAAI,CAAC,EAAE,yBAAyB,GAC/B,IAAI,CAEN;AAkFD,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,aAAa,EAC7B,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAC7B,MAAM,CAwBR;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACrC,aAAa,CAAC,EAAE,aAAa,EAC7B,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAC7B,MAAM,CA+BR"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB;;;;CAI/B,CAAC;AAUF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAAG,SAAS,EAChD,EAAE,EAAE,MAAM,IAAI,GACb,IAAI,CAkJN;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE;IACnC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAuJP;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAK/E;AAED;;;;;;;;;;;;;GAaG;AACH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAerD;AAED,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0BD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACrC,IAAI,CAAC,EAAE,yBAAyB,GAC/B,IAAI,CAEN;AAiFD,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,aAAa,EAC7B,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAC7B,MAAM,CAwBR;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACrC,aAAa,CAAC,EAAE,aAAa,EAC7B,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAC7B,MAAM,CA+BR"}

package/dist/workspace.js

@@ -547,12 +547,11 @@ function systemPromptCopyPath(workspaceDir) {
 // guide, before skill references; empty/absent = no capability section.
 // Split out from ensureCodexWorkspace so the bridge can rebuild the prompt on
 // a platform-config heat-update and hand the new value to
-// adapter.updateConfig, which carries it into the NEXT thread/start. A thread
-// that is already open keeps the instructions it was started with — codex
-// bakes them into the thread at start and neither thread/resume nor
-// thread/fork replaces them (verified against a live 0.144.1 app-server; the
-// retired workspace-config channel behaved identically). See
-// docs/tech-debt/codex-persisted-thread-prompt-refresh.md.
+// adapter.updateConfig. Delivery to threads is the adapter's job: baked into
+// new threads at thread/start; converged onto the persisted main thread via
+// the lazy restart's fresh-process thread/resume (canonical configuration)
+// plus an explicit compaction (model-visible context) — see
+// src/instructions-refresh.ts for the two-plane semantics.
 // Throws on failure BY DESIGN — at boot the prompt is mandatory, so a write
 // failure must fail startup loudly; the refresh hot path wraps this in
 // try/catch and retries next refresh.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/codex-agent",
-  "version": "1.45.0",
+  "version": "1.47.0",
   "description": "Codex CLI bridge runtime for self-hosted Parall agents",
   "license": "MIT",
   "repository": {
@@ -25,9 +25,9 @@
     "src"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.45.0",
-    "@parall/cli": "1.45.0",
-    "@parall/sdk": "1.45.0"
+    "@parall/agent-core": "1.47.0",
+    "@parall/sdk": "1.47.0",
+    "@parall/cli": "1.47.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",