@ai-sdk/harness-codex 1.0.94 → 1.0.96

package/dist/bridge/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@openai/codex-sdk": "0.144.5",
+    "@openai/codex-sdk": "0.149.1",
     "ws": "8.21.0"
   }
 }

package/dist/bridge/pnpm-lock.yaml

@@ -9,55 +9,55 @@ importers:
   .:
     dependencies:
       '@openai/codex-sdk':
-        specifier: 0.144.5
-        version: 0.144.5
+        specifier: 0.149.1
+        version: 0.149.1
       ws:
         specifier: 8.21.0
         version: 8.21.0
 
 packages:
 
-  '@openai/codex-sdk@0.144.5':
-    resolution: {integrity: sha512-90wHPEGyk74On6gwQPNtw+wzuDJ2zYpiVADDxw43S1cWn3QbBh/21zFS2xlAWWCrdY0gE90yXfmmrzwdUDlBGw==}
+  '@openai/codex-sdk@0.149.1':
+    resolution: {integrity: sha512-R00Rz5327LefZggAxl28r7vFQq1vxa91OxtjZJOsQfAM/MyH8InW5qwwRu6pzUmRGp1E29XrOzm7u1TeV5Yz2A==}
     engines: {node: '>=18'}
 
-  '@openai/codex@0.144.5':
-    resolution: {integrity: sha512-jjB+K+OMv572mKhS+2QuLxWXDJNdpwbPenf+V+8bdq7wg4Scqt3cn6WEekD8wPqDVZqck0HSX17K9rD9kbDJQA==}
+  '@openai/codex@0.149.1':
+    resolution: {integrity: sha512-6q5pbcpFbJbqOpkubSDBwXmktQ55aD8eUzGzBF1zASob2DjwhBKDSNGtdZKalfrNJUdTDTPDMmzCXEXs5tMBYA==}
     engines: {node: '>=16'}
     hasBin: true
 
-  '@openai/codex@0.144.5-darwin-arm64':
-    resolution: {integrity: sha512-zcT6NfBCqLFt+BReNSETTZW6v6PdbH0dzNtm9j7l7mDGqwPbKZDGJdnpkBao2389I0ZacyIKgSZoI0vez1d4Dw==}
+  '@openai/codex@0.149.1-darwin-arm64':
+    resolution: {integrity: sha512-6X84kTCbnTgPIJ2EdcPsrvwS0Wxsqpa+bCswGmRf4BjhcQ5nPMnBC6yCAaCMj+vrbXQHj+L6sa9FaR4QkmA1qw==}
     engines: {node: '>=16'}
     cpu: [arm64]
     os: [darwin]
 
-  '@openai/codex@0.144.5-darwin-x64':
-    resolution: {integrity: sha512-//Mo0m1MwaoT6psu5xsmofXpKx4/0irIkeq10xJvk59+886EG355ibjA+ZmlRcKhE3bLjsKD7p81nTbAdRL/bw==}
+  '@openai/codex@0.149.1-darwin-x64':
+    resolution: {integrity: sha512-MfLBQLfcElJL9tvj6y45qVHHMGSXCPnQOixuD3/Zq0g1BW/eFizkrGLdn48cFpc+l8cK+gt5nYG5pQYwVs6g4A==}
     engines: {node: '>=16'}
     cpu: [x64]
     os: [darwin]
 
-  '@openai/codex@0.144.5-linux-arm64':
-    resolution: {integrity: sha512-zAHggxVwR2TBxKmybXY7ZMiB0G8DMonY2YPdwNNjwXcf+LOIqNGgswwNCDMbP/HEe6r8j+R9ZX/yYoo8f+n/RQ==}
+  '@openai/codex@0.149.1-linux-arm64':
+    resolution: {integrity: sha512-OqxUfZ1TVvHd18zHPKK/8ZRlpk8Vy11mg5CMHaLxNWldTbwVImDKtSLWT+m8m4NM5Sz4PbjtZMrVT/RfpBW/mQ==}
     engines: {node: '>=16'}
     cpu: [arm64]
     os: [linux]
 
-  '@openai/codex@0.144.5-linux-x64':
-    resolution: {integrity: sha512-FalLJlBQGFdK8Gc3kj9sa/ekNdgkHhUawLaKkvy5CtB18JaP2YxtTP/Pe1pD2iBiq8mMUliRnafpF6AdBdQMbg==}
+  '@openai/codex@0.149.1-linux-x64':
+    resolution: {integrity: sha512-Of5fGYgr7tAMsyj6vhXb4/RM/UoA3Zq8BLegUBDC09UNy1XTLGYP/2XD+UX8z3qh0NDwxYdCjFIWdDNijKZggQ==}
     engines: {node: '>=16'}
     cpu: [x64]
     os: [linux]
 
-  '@openai/codex@0.144.5-win32-arm64':
-    resolution: {integrity: sha512-0Pj7iqjEOEvPQPO3kFfCy9vGX4BTu76ChFFZHr2eNNIfVc3FOENAv/X98u4L+iIUtDOK9DbqmfUudW3DPapshg==}
+  '@openai/codex@0.149.1-win32-arm64':
+    resolution: {integrity: sha512-5K0DmOKGK9Bos627p8sK8ATHjovPK0sDyT6h9Cb+4v+5CW5SGw1HLgjGxoLfJ8g3cg6mtg/pRCXXo2L/j71UVA==}
     engines: {node: '>=16'}
     cpu: [arm64]
     os: [win32]
 
-  '@openai/codex@0.144.5-win32-x64':
-    resolution: {integrity: sha512-DnsSTlnnzleTxvLwIGnBitKInscxn2I7qASqosS8Fv+qysBygd+ZiBn/SQsRCgQ28PAlsNzmd3Gf3ZTecolAmg==}
+  '@openai/codex@0.149.1-win32-x64':
+    resolution: {integrity: sha512-G3QXGAg7nyyhqOeooAMUekBCeHd8a1QByhKcVAFyzNBaI06t6Ft7nsF+1SzFS0spuIdU4YyMi5YD26ukADBQUQ==}
     engines: {node: '>=16'}
     cpu: [x64]
     os: [win32]
@@ -76,35 +76,35 @@ packages:
 
 snapshots:
 
-  '@openai/codex-sdk@0.144.5':
+  '@openai/codex-sdk@0.149.1':
     dependencies:
-      '@openai/codex': 0.144.5
+      '@openai/codex': 0.149.1
 
-  '@openai/codex@0.144.5':
+  '@openai/codex@0.149.1':
     optionalDependencies:
-      '@openai/codex-darwin-arm64': '@openai/codex@0.144.5-darwin-arm64'
-      '@openai/codex-darwin-x64': '@openai/codex@0.144.5-darwin-x64'
-      '@openai/codex-linux-arm64': '@openai/codex@0.144.5-linux-arm64'
-      '@openai/codex-linux-x64': '@openai/codex@0.144.5-linux-x64'
-      '@openai/codex-win32-arm64': '@openai/codex@0.144.5-win32-arm64'
-      '@openai/codex-win32-x64': '@openai/codex@0.144.5-win32-x64'
-
-  '@openai/codex@0.144.5-darwin-arm64':
+      '@openai/codex-darwin-arm64': '@openai/codex@0.149.1-darwin-arm64'
+      '@openai/codex-darwin-x64': '@openai/codex@0.149.1-darwin-x64'
+      '@openai/codex-linux-arm64': '@openai/codex@0.149.1-linux-arm64'
+      '@openai/codex-linux-x64': '@openai/codex@0.149.1-linux-x64'
+      '@openai/codex-win32-arm64': '@openai/codex@0.149.1-win32-arm64'
+      '@openai/codex-win32-x64': '@openai/codex@0.149.1-win32-x64'
+
+  '@openai/codex@0.149.1-darwin-arm64':
     optional: true
 
-  '@openai/codex@0.144.5-darwin-x64':
+  '@openai/codex@0.149.1-darwin-x64':
     optional: true
 
-  '@openai/codex@0.144.5-linux-arm64':
+  '@openai/codex@0.149.1-linux-arm64':
     optional: true
 
-  '@openai/codex@0.144.5-linux-x64':
+  '@openai/codex@0.149.1-linux-x64':
     optional: true
 
-  '@openai/codex@0.144.5-win32-arm64':
+  '@openai/codex@0.149.1-win32-arm64':
     optional: true
 
-  '@openai/codex@0.144.5-win32-x64':
+  '@openai/codex@0.149.1-win32-x64':
     optional: true
 
   ws@8.21.0: {}

package/dist/index.d.ts

@@ -25,13 +25,15 @@ type CodexHarnessSettings = {
     /**
      * OpenAI model id the underlying `codex` CLI should use. Leaving this unset
      * pins the adapter default (`DEFAULT_CODEX_MODEL`).
+     *
+     * @deprecated Use `model` on `HarnessAgent` instead.
      */
     readonly model?: string;
     /**
      * Reasoning effort for reasoning-capable models. Leaving this unset
      * defers to the CLI's default.
      */
-    readonly reasoningEffort?: 'low' | 'medium' | 'high';
+    readonly reasoningEffort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
     /**
      * When `true`, allow the underlying runtime to use live web search.
      */

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/codex-harness.ts
-import { randomBytes } from "crypto";
+import { createHash, randomBytes } from "crypto";
 import path from "path";
 import {
   commonTool,
@@ -175,7 +175,7 @@ import { z } from "zod/v4";
 var outboundMessageSchema = harnessV1BridgeOutboundMessageSchema;
 var startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
   instructions: z.string().optional(),
-  reasoningEffort: z.enum(["low", "medium", "high"]).optional(),
+  reasoningEffort: z.enum(["low", "medium", "high", "xhigh", "max"]).optional(),
   webSearch: z.boolean().optional(),
   codexConfig: z.record(z.string(), z.unknown()).optional(),
   mcpServers: z.record(z.string(), z.unknown()).optional(),
@@ -183,7 +183,8 @@ var startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
   // `codex.resumeThread(resumeThreadId, …)` instead of starting a fresh thread.
   // The host sources the id from lifecycle state `data` cached from a prior
   // `agent.detach`.
-  resumeThreadId: z.string().optional()
+  resumeThreadId: z.string().optional(),
+  restartThread: z.boolean().optional()
 });
 var inboundMessageSchema = z.discriminatedUnion("type", [
   startMessageSchema,
@@ -194,7 +195,7 @@ var inboundMessageSchema = z.discriminatedUnion("type", [
 var CLI_SHIM_FILENAME = "harness-tool.mjs";
 
 // src/version.ts
-var VERSION = true ? "1.0.94" : "0.0.0-test";
+var VERSION = true ? "1.0.96" : "0.0.0-test";
 
 // src/codex-harness.ts
 var DEFAULT_CODEX_MODEL = "gpt-5.5";
@@ -221,6 +222,7 @@ var codexBridgeCoordsSchema = z2.object({
 });
 var codexResumeStateSchema = z2.object({
   threadId: z2.string().optional(),
+  turnConfigurationFingerprint: z2.string().optional(),
   bridge: codexBridgeCoordsSchema.optional(),
   sandboxCredentialEnvironment: z2.record(z2.string(), z2.string()).optional()
 });
@@ -233,6 +235,7 @@ function createCodex(settings = {}) {
     lifecycleStateSchema: codexResumeStateSchema,
     getBootstrap: getCodexBootstrap,
     doStart: async (startOpts) => {
+      const model = settings.model ?? DEFAULT_CODEX_MODEL;
       if (startOpts.builtinToolFiltering != null) {
         throw new HarnessCapabilityUnsupportedError({
           message: "Harness 'codex' does not support built-in tool filtering controls.",
@@ -269,6 +272,7 @@ function createCodex(settings = {}) {
       const resumeData = isResume && typeof lifecycleState?.data === "object" ? lifecycleState.data : void 0;
       const resumeThreadId = resumeData?.threadId;
       const resumeThreadIdString = typeof resumeThreadId === "string" && resumeThreadId.length > 0 ? resumeThreadId : void 0;
+      const turnConfigurationFingerprint = typeof resumeData?.turnConfigurationFingerprint === "string" ? resumeData.turnConfigurationFingerprint : void 0;
       const coords = resumeData?.bridge;
       const authenticationMode = resolveCodexAuthenticationMode(settings.auth);
       const resolvedAuthEnvironment = resolveCodexEnv(settings.auth);
@@ -307,6 +311,10 @@ function createCodex(settings = {}) {
         CODEX_BOOTSTRAP_DIR
       );
       const workDir = startOpts.sessionWorkDir;
+      const sandboxHomeDir = await resolveSandboxHomeDir({
+        sandbox: toolSafeSandboxSession,
+        abortSignal: startOpts.abortSignal
+      });
       const sessionDataDir = `${defaultWorkingDirectory}/.agent-runs/${startOpts.sessionId}`;
       const bridgeStateDir = `${sessionDataDir}/bridge`;
       const cliShimDir = `${sessionDataDir}/codex`;
@@ -348,7 +356,7 @@ function createCodex(settings = {}) {
             cliShimPath,
             // The live bridge was spawned by another process; no process handle.
             proc: void 0,
-            model: settings.model ?? DEFAULT_CODEX_MODEL,
+            model,
             reasoningEffort: settings.reasoningEffort,
             webSearch: settings.webSearch,
             codexConfig: settings.codexConfig,
@@ -362,7 +370,10 @@ function createCodex(settings = {}) {
             sandboxId,
             sandboxCredentialEnvironment,
             debug: startOpts.observability?.debug,
-            permissionMode: startOpts.permissionMode
+            permissionMode: startOpts.permissionMode,
+            sandbox: toolSafeSandboxSession,
+            sandboxHomeDir,
+            turnConfigurationFingerprint
           });
         } catch {
         }
@@ -389,20 +400,11 @@ function createCodex(settings = {}) {
         credentialEnvironmentVariables: CODEX_CREDENTIAL_ENVIRONMENT_VARIABLES,
         credentialForwarding: settings.credentialForwarding
       });
-      const codexSkillSetup = startOpts.skills && startOpts.skills.length > 0 ? await writeCodexSkills({
-        sandbox: toolSafeSandboxSession,
-        skills: startOpts.skills,
-        abortSignal: startOpts.abortSignal
-      }) : void 0;
       const env = {
         ...forwardedAuthEnvironment,
         AI_SDK_HARNESS_CLIENT_APP: CODEX_CLIENT_APP,
         BRIDGE_CHANNEL_TOKEN: token,
         BRIDGE_WS_PORT: String(port),
-        ...codexSkillSetup ? {
-          HOME: codexSkillSetup.homeDir,
-          CODEX_HOME: codexSkillSetup.codexHomeDir
-        } : {},
         ...respawnStrategy === "replay" ? { BRIDGE_REPLAY_FROM_DISK: "1" } : {}
       };
       if (respawnStrategy === void 0) {
@@ -476,7 +478,7 @@ function createCodex(settings = {}) {
         channel,
         cliShimPath,
         proc,
-        model: settings.model ?? DEFAULT_CODEX_MODEL,
+        model,
         reasoningEffort: settings.reasoningEffort,
         webSearch: settings.webSearch,
         codexConfig: settings.codexConfig,
@@ -490,7 +492,10 @@ function createCodex(settings = {}) {
         sandboxId,
         sandboxCredentialEnvironment,
         debug: startOpts.observability?.debug,
-        permissionMode: startOpts.permissionMode
+        permissionMode: startOpts.permissionMode,
+        sandbox: toolSafeSandboxSession,
+        sandboxHomeDir,
+        turnConfigurationFingerprint
       });
     }
   };
@@ -543,17 +548,12 @@ async function resolveBridgeEndpoint({
 }
 async function writeCodexSkills({
   sandbox,
+  sandboxHomeDir,
   skills,
   abortSignal
 }) {
-  const homeDir = await resolveSandboxHomeDir({ sandbox, abortSignal });
-  const codexHomeDir = path.posix.join(homeDir, ".codex");
-  await sandbox.run({
-    command: `mkdir -p ${shellQuote(codexHomeDir)}`,
-    abortSignal
-  });
-  const rootDir = path.posix.join(homeDir, ".agents", "skills");
-  await writeHarnessSkills({
+  const rootDir = path.posix.join(sandboxHomeDir, ".agents", "skills");
+  return writeHarnessSkills({
     sandbox,
     rootDir,
     skills,
@@ -561,10 +561,6 @@ async function writeCodexSkills({
     invalidSkillNameMessage: ({ name }) => `Invalid Codex skill name: ${name}`,
     invalidSkillFilePathMessage: ({ skillName, filePath }) => `Invalid Codex skill file path for ${skillName}: ${filePath}`
   });
-  return {
-    homeDir,
-    codexHomeDir
-  };
 }
 function openWebSocket({
   url,
@@ -613,16 +609,44 @@ function createSession({
   sandboxId,
   sandboxCredentialEnvironment,
   debug,
-  permissionMode
+  permissionMode,
+  sandbox,
+  sandboxHomeDir,
+  turnConfigurationFingerprint
 }) {
   let stopped = false;
   let stopPromise;
   let pendingResumeThreadId = seedResumeThreadOnFirstPrompt ? resumeThreadId : void 0;
   let initialPromptGuidanceApplied = isResume;
   let latestThreadId = resumeThreadId;
+  let latestTurnConfigurationFingerprint = turnConfigurationFingerprint;
   channel.on("bridge-thread", (msg) => {
     latestThreadId = msg.threadId;
   });
+  const synchronizeTurnConfiguration = async ({
+    skills,
+    instructions,
+    tools,
+    abortSignal
+  }) => {
+    const skillsResult = await writeCodexSkills({
+      sandbox,
+      sandboxHomeDir,
+      skills,
+      abortSignal
+    });
+    const nextFingerprint = fingerprintCodexTurnConfiguration({
+      instructions,
+      tools
+    });
+    const restartThread = latestThreadId != null && (skillsResult.changed || latestTurnConfigurationFingerprint != null && latestTurnConfigurationFingerprint !== nextFingerprint);
+    latestTurnConfigurationFingerprint = nextFingerprint;
+    if (restartThread) {
+      initialPromptGuidanceApplied = false;
+      pendingResumeThreadId = void 0;
+    }
+    return { restartThread };
+  };
   const wireTurn = (turnOpts) => {
     let pendingResolve;
     let pendingReject;
@@ -749,7 +773,6 @@ function createSession({
   return {
     sessionId,
     isResume,
-    modelId: model,
     doPromptTurn: async (promptOpts) => {
       if (promptOpts.responseFormat?.type === "json" && promptOpts.responseFormat.schema == null) {
         throw new HarnessCapabilityUnsupportedError({
@@ -757,15 +780,21 @@ function createSession({
           harnessId: "codex"
         });
       }
-      const turn = wireTurn({
-        emit: promptOpts.emit,
-        abortSignal: promptOpts.abortSignal
-      });
       const tools = (promptOpts.tools ?? []).map((t) => ({
         name: t.name,
         description: t.description,
         inputSchema: t.inputSchema
       }));
+      const { restartThread } = await synchronizeTurnConfiguration({
+        skills: promptOpts.skills,
+        instructions: promptOpts.instructions,
+        tools,
+        abortSignal: promptOpts.abortSignal
+      });
+      const turn = wireTurn({
+        emit: promptOpts.emit,
+        abortSignal: promptOpts.abortSignal
+      });
       let promptText = extractUserText(promptOpts.prompt);
       if (!initialPromptGuidanceApplied) {
         promptText = frameInitialPromptGuidance({
@@ -783,13 +812,14 @@ function createSession({
         tools,
         ...promptOpts.responseFormat == null ? {} : { responseFormat: promptOpts.responseFormat },
         ...promptOpts.instructions ? { instructions: promptOpts.instructions } : {},
-        model,
+        model: promptOpts.model ?? model,
         reasoningEffort,
         webSearch,
         ...codexConfig == null ? {} : { codexConfig },
         ...mcpServers == null ? {} : { mcpServers },
         ...permissionMode ? { permissionMode } : {},
         ...pendingResumeThreadId ? { resumeThreadId: pendingResumeThreadId } : {},
+        ...restartThread ? { restartThread: true } : {},
         ...debug ? { debug } : {}
       };
       pendingResumeThreadId = void 0;
@@ -803,6 +833,17 @@ function createSession({
           harnessId: "codex"
         });
       }
+      const tools = (continueOpts.tools ?? []).map((t) => ({
+        name: t.name,
+        description: t.description,
+        inputSchema: t.inputSchema
+      }));
+      const { restartThread } = await synchronizeTurnConfiguration({
+        skills: continueOpts.skills,
+        instructions: continueOpts.instructions,
+        tools,
+        abortSignal: continueOpts.abortSignal
+      });
       const turn = wireTurn({
         emit: continueOpts.emit,
         abortSignal: continueOpts.abortSignal
@@ -821,20 +862,17 @@ function createSession({
              * empty text block trips the Anthropic API's `cache_control` rule).
              */
             prompt: "Continue.",
-            tools: (continueOpts.tools ?? []).map((t) => ({
-              name: t.name,
-              description: t.description,
-              inputSchema: t.inputSchema
-            })),
+            tools,
             ...continueOpts.responseFormat == null ? {} : { responseFormat: continueOpts.responseFormat },
             ...continueOpts.instructions ? { instructions: continueOpts.instructions } : {},
-            model,
+            model: continueOpts.model ?? model,
             reasoningEffort,
             webSearch,
             ...codexConfig == null ? {} : { codexConfig },
             ...mcpServers == null ? {} : { mcpServers },
             ...permissionMode ? { permissionMode } : {},
             ...threadId ? { resumeThreadId: threadId } : {},
+            ...restartThread ? { restartThread: true } : {},
             ...debug ? { debug } : {}
           })
         );
@@ -861,6 +899,9 @@ function createSession({
         specificationVersion: "harness-v1",
         data: {
           ...latestThreadId ? { threadId: latestThreadId } : {},
+          ...latestTurnConfigurationFingerprint ? {
+            turnConfigurationFingerprint: latestTurnConfigurationFingerprint
+          } : {},
           ...sandboxCredentialEnvironment == null ? {} : { sandboxCredentialEnvironment },
           bridge: {
             port: bridgePort,
@@ -962,6 +1003,9 @@ function createSession({
         specificationVersion: "harness-v1",
         data: {
           ...lifecycleData,
+          ...latestTurnConfigurationFingerprint ? {
+            turnConfigurationFingerprint: latestTurnConfigurationFingerprint
+          } : {},
           ...sandboxCredentialEnvironment == null ? {} : { sandboxCredentialEnvironment }
         }
       };
@@ -981,6 +1025,9 @@ function createSession({
         specificationVersion: "harness-v1",
         data: {
           ...latestThreadId ? { threadId: latestThreadId } : {},
+          ...latestTurnConfigurationFingerprint ? {
+            turnConfigurationFingerprint: latestTurnConfigurationFingerprint
+          } : {},
           ...sandboxCredentialEnvironment == null ? {} : { sandboxCredentialEnvironment },
           bridge: {
             port: bridgePort,
@@ -994,6 +1041,12 @@ function createSession({
     }
   };
 }
+function fingerprintCodexTurnConfiguration({
+  instructions,
+  tools
+}) {
+  return createHash("sha256").update(JSON.stringify({ instructions: instructions ?? null, tools })).digest("hex");
+}
 function frameInitialPromptGuidance({
   toolUsageBlock,
   userText