@openclaw/codex 2026.8.1-beta.3 → 2026.9.1-beta.1

package/dist/{thread-ownership-i2NBwDUL.js → thread-ownership-DZeuKH1j.js}

@@ -1,5 +1,5 @@
-import { J as releaseCodexAppServerLiveThread, K as isCodexAppServerLiveThreadClaimed, Y as retainCodexAppServerLiveThread, d as retainSharedCodexAppServerClientByInstanceId } from "./shared-client-Dw-rzii0.js";
-import { a as closeCodexStartupClientBestEffort, d as unsubscribeCodexThreadBestEffort, r as CodexAppServerUnsafeSubscriptionError } from "./attempt-client-cleanup-URjUlCHg.js";
+import { $ as releaseCodexAppServerLiveThread, Z as isCodexAppServerLiveThreadClaimed, et as retainCodexAppServerLiveThread, h as retainSharedCodexAppServerClientByInstanceId } from "./shared-client-DKz23hHY.js";
+import { a as closeCodexStartupClientBestEffort, d as unsubscribeCodexThreadBestEffort, r as CodexAppServerUnsafeSubscriptionError } from "./attempt-client-cleanup-bfsmcQ6m.js";
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 //#region extensions/codex/src/app-server/thread-ownership.ts
 const nativeThreadOwners = new KeyedAsyncQueue();

package/dist/{thread-resume-CdJk2Ehf.js → thread-resume-BE9qNEW0.js}

@@ -1,6 +1,6 @@
-import { B as CodexAppServerRpcError, F as isCodexAppServerPrewriteRequestCancellationError, s as isCodexAppServerStartSelectionChangedError } from "./shared-client-Dw-rzii0.js";
-import { i as assertCodexThreadResumeSubscription, r as CodexAppServerUnsafeSubscriptionError } from "./attempt-client-cleanup-URjUlCHg.js";
-import { i as assertCodexThreadResumeResponse } from "./protocol-validators-VAVyEnDp.js";
+import { B as isCodexAppServerPrewriteRequestCancellationError, G as CodexAppServerRpcError, c as isCodexAppServerStartSelectionChangedError } from "./shared-client-DKz23hHY.js";
+import { i as assertCodexThreadResumeSubscription, r as CodexAppServerUnsafeSubscriptionError } from "./attempt-client-cleanup-bfsmcQ6m.js";
+import { i as assertCodexThreadResumeResponse } from "./protocol-validators-VeJxxJ0U.js";
 //#region extensions/codex/src/app-server/thread-resume.ts
 /** Owns Codex thread/resume subscription safety. */
 /** Resumes one thread and retires the physical client when acceptance is indeterminate. */

package/dist/{transcript-mirror-BU0_LKAL.js → transcript-mirror-DsCMWBca.js}

@@ -1,6 +1,6 @@
 import { i as readUpstreamUserText, n as attachUpstreamUserText, r as readMirrorIdentity, t as attachCodexMirrorIdentity } from "./upstream-prompt-provenance-CFmsKwr9.js";
 import { asOptionalRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { embeddedAgentLog, formatErrorMessage, projectAgentHarnessTranscriptMessageForDisplay, runAgentHarnessBeforeMessageWriteHook } from "openclaw/plugin-sdk/agent-harness-runtime";
+import { deliverAgentHarnessUserInputPrompt, embeddedAgentLog, formatErrorMessage, projectAgentHarnessTranscriptMessageForDisplay, runAgentHarnessBeforeMessageWriteHook } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { createHash } from "node:crypto";
 import { truncateUtf8Prefix } from "openclaw/plugin-sdk/text-utility-runtime";
 import { withCodexSessionTranscriptMirrorWriteLock } from "openclaw/plugin-sdk/codex-session-transcript-runtime";
@@ -82,6 +82,8 @@ function projectCodexThreadHistory(params) {
 		const role = item.type === "userMessage" ? "user" : item.type === "agentMessage" ? "assistant" : void 0;
 		itemOffset += 1;
 		if (!text || !role) continue;
+		const phase = item.phase === "commentary" || item.phase === "final_answer" ? item.phase : void 0;
+		const asyncDelivery = item.delivery === "async";
 		const message = role === "assistant" ? attachCodexMirrorIdentity({
 			role,
 			content: [{
@@ -94,13 +96,14 @@ function projectCodexThreadHistory(params) {
 			usage: CODEX_HISTORY_ZERO_USAGE,
 			stopReason: turn.status === "interrupted" ? "aborted" : turn.status === "failed" ? "error" : "stop",
 			...turn.status === "failed" && turn.error?.message ? { errorMessage: turn.error.message } : {},
+			...phase ? { phase } : {},
+			...asyncDelivery && itemId ? { openclawAsyncDelivery: { itemId } } : {},
 			timestamp
 		}, identity) : attachCodexMirrorIdentity({
 			role,
 			content: text,
 			timestamp
 		}, identity);
-		const phase = item.phase === "commentary" || item.phase === "final_answer" ? item.phase : void 0;
 		projected.push({
 			message,
 			responseItem: {
@@ -141,7 +144,7 @@ function projectBoundedCodexThreadHistory(params) {
 	return {
 		importedMessages: selected.length,
 		omittedMessages: projected.length - selected.length,
-		responseItems: selected.filter(({ message }) => message.role !== "assistant" || message.stopReason !== "aborted" && message.stopReason !== "error").map(({ responseItem }) => responseItem),
+		responseItems: selected.filter(({ message }) => message.role !== "assistant" || message.stopReason !== "aborted" && message.stopReason !== "error" && !("openclawAsyncDelivery" in message)).map(({ responseItem }) => responseItem),
 		transcriptMessages: selected.map(({ message }) => message)
 	};
 }
@@ -150,7 +153,7 @@ function projectBoundedCodexVisibleSessionHistory(entries) {
 	const projected = [];
 	for (const entry of entries) {
 		if (entry.role !== "user" && entry.role !== "assistant" || !("content" in entry.message)) continue;
-		if (entry.role === "assistant" && "stopReason" in entry.message && (entry.message.stopReason === "aborted" || entry.message.stopReason === "error")) continue;
+		if (entry.role === "assistant" && ("stopReason" in entry.message && (entry.message.stopReason === "aborted" || entry.message.stopReason === "error") || "openclawAsyncDelivery" in entry.message)) continue;
 		const content = entry.message.content;
 		const text = normalizeImportedHistoryText(typeof content === "string" ? content : Array.isArray(content) ? content.flatMap((part) => part && typeof part === "object" && "text" in part && typeof part.text === "string" ? [part.text] : []).join("\n") : void 0);
 		if (!text) continue;
@@ -270,6 +273,10 @@ async function buildResolvedCodexUserPromptMessage(params) {
 function isMirroredAgentMessage(message) {
 	return message.role === "user" || message.role === "assistant" || message.role === "toolResult";
 }
+function readMirroredAssistantText(message) {
+	if (message?.role !== "assistant") return;
+	return message.content.flatMap((part) => part.type === "text" ? [part.text] : []).join("\n") || void 0;
+}
 /** Imports a bounded, user-visible Codex history tail into a new OpenClaw transcript. */
 async function importCodexThreadHistoryToTranscript(params) {
 	const projection = projectBoundedCodexThreadHistory({
@@ -431,6 +438,7 @@ function buildMirrorDedupeIdentity(message) {
 async function mirror(params) {
 	const messages = params.messages.filter(isMirroredAgentMessage);
 	if (messages.length === 0) return {
+		assistantMirrorIdentitiesAppended: [],
 		assistantMirrorIdentitiesOwned: [],
 		anchorsByMirrorIdentity: /* @__PURE__ */ new Map(),
 		messagesPresent: [],
@@ -449,11 +457,12 @@ async function mirror(params) {
 	});
 	const candidateIdempotencyKeys = candidates.flatMap(({ idempotencyKey }) => idempotencyKey ? [idempotencyKey] : []);
 	const transcriptTarget = resolveCodexMirrorTranscriptTarget(params);
-	const { appendedUpdates, assistantMirrorIdentitiesOwned, anchorsByMirrorIdentity, messagesPresent, userMessageReceipts, userMessagesPresent } = await withCodexSessionTranscriptMirrorWriteLock({
+	const { appendedUpdates, assistantMirrorIdentitiesAppended, assistantMirrorIdentitiesOwned, anchorsByMirrorIdentity, messagesPresent, userMessageReceipts, userMessagesPresent } = await withCodexSessionTranscriptMirrorWriteLock({
 		...transcriptTarget,
 		config: params.config
 	}, async (transcript) => {
 		const nextAppendedUpdates = [];
+		const nextAssistantMirrorIdentitiesAppended = /* @__PURE__ */ new Set();
 		const nextAssistantMirrorIdentitiesOwned = /* @__PURE__ */ new Set();
 		const nextAnchorsByMirrorIdentity = /* @__PURE__ */ new Map();
 		const nextMessagesPresent = [];
@@ -501,6 +510,7 @@ async function mirror(params) {
 			} : attachCodexMirrorAttestation(nextMessage, sourceFingerprint);
 			if (mirrorIdentity) messageToAppend = attachCodexMirrorIdentity(messageToAppend, mirrorIdentity);
 			if (ownsRun && params.runId) messageToAppend = attachCodexMirrorRunId(messageToAppend, params.runId, ownsTerminal);
+			if (message.role === "assistant" && message.openclawAsyncDelivery) messageToAppend = Object.assign(messageToAppend, { openclawAsyncDelivery: { itemId: message.openclawAsyncDelivery.itemId } });
 			messageToAppend = projectAgentHarnessTranscriptMessageForDisplay({
 				hidden: message.display === false,
 				message: messageToAppend
@@ -525,11 +535,14 @@ async function mirror(params) {
 					message: appendedMessage
 				});
 			}
-			if (appended.appended) nextAppendedUpdates.push({
-				messageId,
-				message: appendedMessage,
-				...messageSeq !== void 0 ? { messageSeq } : {}
-			});
+			if (appended.appended) {
+				if (message.role === "assistant") nextAssistantMirrorIdentitiesAppended.add(dedupeIdentity);
+				nextAppendedUpdates.push({
+					messageId,
+					message: appendedMessage,
+					...messageSeq !== void 0 ? { messageSeq } : {}
+				});
+			}
 			if (idempotencyKey) {
 				mirrorFacts.existingIdempotencyKeys.add(idempotencyKey);
 				if (appended.anchor) mirrorFacts.anchorsByIdempotencyKey.set(idempotencyKey, appended.anchor);
@@ -537,6 +550,7 @@ async function mirror(params) {
 		}
 		return {
 			appendedUpdates: nextAppendedUpdates,
+			assistantMirrorIdentitiesAppended: [...nextAssistantMirrorIdentitiesAppended],
 			assistantMirrorIdentitiesOwned: [...nextAssistantMirrorIdentitiesOwned],
 			anchorsByMirrorIdentity: nextAnchorsByMirrorIdentity,
 			messagesPresent: nextMessagesPresent,
@@ -562,6 +576,7 @@ async function mirror(params) {
 		embeddedAgentLog.warn("failed to publish codex app-server transcript update", { error: formatErrorMessage(error) });
 	}
 	return {
+		assistantMirrorIdentitiesAppended,
 		assistantMirrorIdentitiesOwned,
 		anchorsByMirrorIdentity,
 		messagesPresent,
@@ -569,10 +584,76 @@ async function mirror(params) {
 		userMessagesPresent
 	};
 }
+async function deliverAsyncMessageBestEffort(params) {
+	const mirrorIdentity = `${params.turnId}:async:${params.itemId}`;
+	const deliveryIntentId = `block-reply:v1:codex-app-server:${[
+		params.threadId,
+		params.turnId,
+		params.itemId
+	].map(encodeURIComponent).join(":")}`;
+	const target = params.params.sessionTarget;
+	if (!target) {
+		if (!params.params.onBlockReply) return "retry";
+		try {
+			await deliverAsyncBlockReply(params.params.onBlockReply, params.text, deliveryIntentId);
+			return "settled";
+		} catch (error) {
+			embeddedAgentLog.warn("failed to deliver codex async agent message", {
+				error: formatErrorMessage(error),
+				itemId: params.itemId,
+				runId: params.params.runId,
+				threadId: params.threadId,
+				turnId: params.turnId
+			});
+			return "retry";
+		}
+	}
+	let result;
+	try {
+		result = await mirror({
+			agentId: target.agentId ?? params.params.agentId,
+			sessionId: target.sessionId ?? params.params.sessionId,
+			sessionKey: target.sessionKey ?? params.params.sessionKey,
+			storePath: target.storePath,
+			cwd: params.cwd,
+			config: params.params.config,
+			messages: [attachCodexMirrorIdentity(params.message, mirrorIdentity)],
+			idempotencyScope: `codex-app-server:${params.threadId}`
+		});
+	} catch (error) {
+		embeddedAgentLog.warn("failed to persist codex async agent message", {
+			error: formatErrorMessage(error),
+			itemId: params.itemId,
+			runId: params.params.runId,
+			threadId: params.threadId,
+			turnId: params.turnId
+		});
+		return "retry";
+	}
+	if (!result.assistantMirrorIdentitiesOwned.includes(mirrorIdentity)) return "retry";
+	const persistedText = readMirroredAssistantText(result.messagesPresent.find((message) => readMirrorIdentity(message) === mirrorIdentity));
+	if (params.params.onBlockReply && persistedText !== void 0) try {
+		await deliverAsyncBlockReply(params.params.onBlockReply, persistedText, deliveryIntentId);
+	} catch (error) {
+		embeddedAgentLog.warn("failed to deliver persisted codex async agent message", {
+			error: formatErrorMessage(error),
+			itemId: params.itemId,
+			runId: params.params.runId,
+			threadId: params.threadId,
+			turnId: params.turnId
+		});
+		return "retry";
+	}
+	return "settled";
+}
 const codexTranscriptMirrorRuntime = {
+	deliverAsyncMessageBestEffort,
 	mirror,
 	mirrorBestEffort
 };
+async function deliverAsyncBlockReply(onBlockReply, text, deliveryIntentId) {
+	await deliverAgentHarnessUserInputPrompt({ onBlockReply: (payload) => onBlockReply(payload, { deliveryIntentId }) }, [], { intro: text });
+}
 function resolveCodexMirrorTranscriptTarget(params) {
 	const sessionKey = params.sessionKey?.trim();
 	const storePath = params.storePath?.trim();

package/dist/{upstream-session-fork-BDVJCLAD.js → upstream-session-fork-DlaHxSLC.js}

@@ -1,7 +1,7 @@
-import { d as sessionBindingIdentity } from "./session-binding-BTrLf9Qm.js";
-import { r as assertCodexThreadForkResponse } from "./protocol-validators-VAVyEnDp.js";
+import { d as sessionBindingIdentity } from "./session-binding-Bcynfd-_.js";
+import { r as assertCodexThreadForkResponse } from "./protocol-validators-VeJxxJ0U.js";
 import { t as isIncognitoSessionKey } from "./incognito-session-ET_ufDH-.js";
-import { i as createImportedCodexSession, n as codexUpstreamBaseline, t as codexLastTerminalTurnId } from "./session-upstream-marker-D_2npHlA.js";
+import { i as createImportedCodexSession, n as codexUpstreamBaseline, t as codexLastTerminalTurnId } from "./session-upstream-marker-BIkusb95.js";
 import { isRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { readVisibleSessionTranscriptMessageEntries } from "openclaw/plugin-sdk/session-transcript-runtime";
 import { deleteSessionUpstreamLink, upsertSessionUpstreamLink } from "openclaw/plugin-sdk/session-catalog";

package/dist/{usage-9dKJCgcy.js → usage-ROIaW3wo.js}

@@ -1,6 +1,6 @@
-import { i as resolveCodexAppServerRuntimeOptions } from "./config-CpNeo5AE.js";
-import { t as buildCodexAppServerUsageSnapshot } from "./rate-limits-BI1dMHDG.js";
-import { t as readCodexAppServerUsage } from "./request-DSK0W6YI.js";
+import { i as resolveCodexAppServerRuntimeOptions } from "./config-giW8X0QA.js";
+import { t as buildCodexAppServerUsageSnapshot } from "./rate-limits-C5_D8Gmb.js";
+import { t as readCodexAppServerUsage } from "./request-DXXGHko0.js";
 import { CODEX_APP_SERVER_AUTH_MARKER } from "openclaw/plugin-sdk/agent-runtime";
 //#region extensions/codex/src/app-server/usage.ts
 /** Handles the synthetic usage credential for a Codex-backed OpenAI route. */

package/dist/{web-search-provider.runtime-DCdx4DGu.js → web-search-provider.runtime-ClaNPV7N.js}

@@ -1,6 +1,6 @@
-import { ut as isJsonObject } from "./shared-client-Dw-rzii0.js";
-import { d as buildCodexNativeWebSearchThreadConfig } from "./thread-lifecycle-DKdrnTMX.js";
-import { t as runBoundedCodexAppServerTurn } from "./bounded-turn-4BjrZEwW.js";
+import { vt as isJsonObject } from "./shared-client-DKz23hHY.js";
+import { P as buildCodexNativeWebSearchThreadConfig } from "./thread-lifecycle-L7oEkTlq.js";
+import { t as runBoundedCodexAppServerTurn } from "./bounded-turn-B7iBUcuP.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { readStringParam, resolveSearchTimeoutSeconds, wrapWebContent } from "openclaw/plugin-sdk/provider-web-search";
 //#region extensions/codex/src/web-search-provider.runtime.ts

package/openclaw.plugin.json

@@ -1,5 +1,22 @@
 {
   "id": "codex",
+  "backupResources": [
+    {
+      "disposition": "regenerable",
+      "scope": "agent",
+      "relativePath": "codex-home/tmp/arg0"
+    },
+    {
+      "disposition": "regenerable",
+      "scope": "agent",
+      "relativePath": "codex-home/.tmp/plugins"
+    },
+    {
+      "disposition": "regenerable",
+      "scope": "agent",
+      "relativePath": "codex-home/.tmp/bundled-marketplaces"
+    }
+  ],
   "doctorContract": {
     "configRepair": true,
     "stateMigrations": true
@@ -497,7 +514,7 @@
     },
     "computerUse.autoRepair": {
       "label": "Auto Repair",
-      "help": "When true, failed Computer Use live tests repair stale scoped Computer Use MCP children before retrying once.",
+      "help": "When true, failed Computer Use live tests reload the Codex-owned MCP runtime before retrying once.",
       "advanced": true
     },
     "computerUse.marketplaceSource": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/codex",
-  "version": "2026.8.1-beta.3",
+  "version": "2026.9.1-beta.1",
   "description": "OpenClaw Codex app-server harness and native session supervision plugin.",
   "repository": {
     "type": "git",
@@ -8,11 +8,11 @@
   },
   "type": "module",
   "dependencies": {
-    "@openai/codex": "0.149.1",
+    "@openai/codex": "0.150.1",
     "semver": "7.8.5",
-    "smol-toml": "1.7.1",
-    "typebox": "1.3.6",
-    "ws": "8.21.1",
+    "smol-toml": "1.8.0",
+    "typebox": "1.3.16",
+    "ws": "8.21.3",
     "zod": "4.4.3"
   },
   "devDependencies": {
@@ -36,10 +36,10 @@
       ]
     },
     "compat": {
-      "pluginApi": ">=2026.8.1-beta.3"
+      "pluginApi": ">=2026.9.1-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.8.1-beta.3"
+      "openclawVersion": "2026.9.1-beta.1"
     },
     "release": {
       "publishToClawHub": true,
@@ -59,7 +59,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.8.1-beta.3"
+    "openclaw": ">=2026.9.1-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/app-server-policy-bg5QPSVP.js

@@ -1,25 +0,0 @@
-import { b as canUseCodexModelBackedApprovalsReviewerForModel } from "./config-CpNeo5AE.js";
-//#region extensions/codex/src/app-server/app-server-policy.ts
-function resolveCodexAppServerForModelProvider(params) {
-	const explicitProvider = normalizeModelBackedReviewerProvider(params.provider);
-	if (!isCodexModelBackedApprovalsReviewer(params.appServer.approvalsReviewer) || canUseCodexModelBackedApprovalsReviewerForModel({
-		modelProvider: explicitProvider,
-		model: params.model,
-		config: params.config,
-		env: params.env,
-		agentDir: params.agentDir,
-		codexConfigToml: params.codexConfigToml
-	})) return params.appServer;
-	return {
-		...params.appServer,
-		approvalsReviewer: "user"
-	};
-}
-function isCodexModelBackedApprovalsReviewer(value) {
-	return value === "auto_review" || value === "guardian_subagent";
-}
-function normalizeModelBackedReviewerProvider(provider) {
-	return provider?.trim().toLowerCase() || void 0;
-}
-//#endregion
-export { resolveCodexAppServerForModelProvider as t };