@openclaw/codex 2026.5.12 → 2026.5.14-beta.2

package/dist/{run-attempt-4t06MuNr.js → run-attempt-DG9NQab2.js}

@@ -1,18 +1,17 @@
 import { l as resolveCodexPluginsPolicy, o as readCodexPluginConfig, s as resolveCodexAppServerRuntimeOptions, u as withMcpElicitationsApprovalPolicy } from "./config-0rd3LnKg.js";
 import { a as readCodexDynamicToolCallParams, c as readCodexTurn, i as assertCodexTurnStartResponse } from "./protocol-validators-CSY0BFBo.js";
 import { t as isJsonObject } from "./protocol-C9UWI98H.js";
-import { i as isCodexAppServerConnectionClosedError, r as isCodexAppServerApprovalRequest } from "./client-iRf11BEu.js";
-import { n as CODEX_CONTROL_METHODS } from "./request-ohCy5ASa.js";
-import { d as resolveCodexUsageLimitResetAtMs, f as shouldRefreshCodexRateLimitsForUsageLimitMessage, r as formatCodexDisplayText, u as formatCodexUsageLimitErrorMessage } from "./command-formatters-Ttwc_kgX.js";
-import { c as resolveCodexAppServerAuthProfileId, l as resolveCodexAppServerAuthProfileIdForAgent, o as refreshCodexAppServerAuthTokens, s as resolveCodexAppServerAuthAccountCacheKey, t as clearSharedCodexAppServerClientIfCurrent, u as resolveCodexAppServerEnvApiKeyCacheKey } from "./shared-client-Cr6W-a2G.js";
+import { i as isCodexAppServerConnectionClosedError, r as isCodexAppServerApprovalRequest } from "./client-CoctX13d.js";
+import { n as buildCodexPluginAppCacheKey, r as CODEX_CONTROL_METHODS } from "./request-CKYiRqsN.js";
+import { d as resolveCodexUsageLimitResetAtMs, f as shouldRefreshCodexRateLimitsForUsageLimitMessage, r as formatCodexDisplayText, u as formatCodexUsageLimitErrorMessage } from "./command-formatters-DRJaVHhN.js";
+import { c as resolveCodexAppServerAuthAccountCacheKey, d as resolveCodexAppServerEnvApiKeyCacheKey, l as resolveCodexAppServerAuthProfileId, n as clearSharedCodexAppServerClientIfCurrent, s as refreshCodexAppServerAuthTokens, u as resolveCodexAppServerAuthProfileIdForAgent } from "./shared-client-BwUqd3lh.js";
 import { i as readCodexAppServerBinding, t as clearCodexAppServerBinding } from "./session-binding-CMTXuyoz.js";
-import { a as defaultCodexAppInventoryCache } from "./plugin-activation-PXGqUjwY.js";
-import { t as buildCodexPluginAppCacheKey } from "./plugin-app-cache-key-B7eU8fNZ.js";
-import { _ as resolveCodexContextEngineProjectionReserveTokens, b as normalizeCodexDynamicToolName, d as buildCodexPluginThreadConfig, f as buildCodexPluginThreadConfigInputFingerprint, g as resolveCodexContextEngineProjectionMaxChars, h as projectContextEngineAssemblyForCodex, m as shouldBuildCodexPluginThreadConfig, o as buildTurnStartParams, p as mergeCodexThreadConfigs, r as buildDeveloperInstructions, s as codexDynamicToolsFingerprint, t as areCodexDynamicToolFingerprintsCompatible, u as startOrResumeThread, v as createCodexDynamicToolBridge, y as filterCodexDynamicTools } from "./thread-lifecycle-CJppEyYT.js";
-import { n as defaultCodexAppServerClientFactory } from "./client-factory-DfnbdQv7.js";
-import { n as handleCodexAppServerElicitationRequest, r as handleCodexAppServerApprovalRequest, t as filterToolsForVisionInputs } from "./vision-tools-DHyuabWn.js";
-import { t as ensureCodexComputerUse } from "./computer-use-Ct3ngNBt.js";
-import { n as rememberCodexRateLimits, t as readRecentCodexRateLimits } from "./rate-limit-cache-BFi-50LG.js";
+import { a as defaultCodexAppInventoryCache } from "./plugin-activation-aQOmRQwA.js";
+import { _ as resolveCodexContextEngineProjectionReserveTokens, b as normalizeCodexDynamicToolName, d as buildCodexPluginThreadConfig, f as buildCodexPluginThreadConfigInputFingerprint, g as resolveCodexContextEngineProjectionMaxChars, h as projectContextEngineAssemblyForCodex, m as shouldBuildCodexPluginThreadConfig, o as buildTurnStartParams, p as mergeCodexThreadConfigs, r as buildDeveloperInstructions, s as codexDynamicToolsFingerprint, t as areCodexDynamicToolFingerprintsCompatible, u as startOrResumeThread, v as createCodexDynamicToolBridge, y as filterCodexDynamicTools } from "./thread-lifecycle-DrbViNpf.js";
+import { t as defaultCodexAppServerClientFactory } from "./client-factory-Be6RD28K.js";
+import { n as handleCodexAppServerElicitationRequest, r as handleCodexAppServerApprovalRequest, t as filterToolsForVisionInputs } from "./vision-tools-CzTdigBu.js";
+import { t as ensureCodexComputerUse } from "./computer-use-DsJxRRtm.js";
+import { n as rememberCodexRateLimits, t as readRecentCodexRateLimits } from "./rate-limit-cache-dvhq-4pi.js";
 import { createHash } from "node:crypto";
 import nodeFs from "node:fs";
 import { TOOL_PROGRESS_OUTPUT_MAX_CHARS, acquireSessionWriteLock, appendSessionTranscriptMessage, assembleHarnessContextEngine, bootstrapHarnessContextEngine, buildEmbeddedAttemptToolRunContext, buildHarnessContextEngineRuntimeContext, buildHarnessContextEngineRuntimeContextFromUsage, classifyAgentHarnessTerminalOutcome, clearActiveEmbeddedRun, embeddedAgentLog, emitAgentEvent, emitSessionTranscriptUpdate, finalizeHarnessContextEngineTurn, formatErrorMessage, formatToolAggregate, formatToolProgressOutput, inferToolMetaFromArgs, isActiveHarnessContextEngine, isSubagentSessionKey, loadCodexBundleMcpThreadConfig, normalizeAgentRuntimeTools, normalizeUsage, registerNativeHookRelay, resolveAgentHarnessBeforePromptBuildResult, resolveAttemptSpawnWorkspaceDir, resolveBootstrapContextForRun, resolveModelAuthMode, resolveSandboxContext, resolveSessionAgentIds, resolveSessionWriteLockAcquireTimeoutMs, resolveUserPath, runAgentCleanupStep, runAgentHarnessAfterCompactionHook, runAgentHarnessAfterToolCallHook, runAgentHarnessAgentEndHook, runAgentHarnessBeforeCompactionHook, runAgentHarnessBeforeMessageWriteHook, runAgentHarnessLlmInputHook, runAgentHarnessLlmOutputHook, runHarnessContextEngineMaintenance, setActiveEmbeddedRun, supportsModelTools } from "openclaw/plugin-sdk/agent-harness-runtime";
@@ -20,7 +19,6 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { markAuthProfileBlockedUntil, resolveAgentDir as resolveAgentDir$1 } from "openclaw/plugin-sdk/agent-runtime";
 import { appendRegularFile, pathExists } from "openclaw/plugin-sdk/security-runtime";
-import { AsyncLocalStorage } from "node:async_hooks";
 import { emitTrustedDiagnosticEvent } from "openclaw/plugin-sdk/diagnostic-runtime";
 import { createRunningTaskRun, finalizeTaskRunByRunId, recordTaskRunProgressByRunId } from "openclaw/plugin-sdk/codex-native-task-runtime";
 import { buildSessionContext, migrateSessionEntries, parseSessionEntries } from "@earendil-works/pi-coding-agent";
@@ -490,6 +488,8 @@ var CodexAppServerEventProjector = class {
 		this.options = options;
 		this.assistantTextByItem = /* @__PURE__ */ new Map();
 		this.assistantItemOrder = [];
+		this.assistantPhaseByItem = /* @__PURE__ */ new Map();
+		this.lastCommentaryProgressTextByItem = /* @__PURE__ */ new Map();
 		this.reasoningTextByItem = /* @__PURE__ */ new Map();
 		this.planTextByItem = /* @__PURE__ */ new Map();
 		this.activeItemIds = /* @__PURE__ */ new Set();
@@ -694,6 +694,10 @@ var CodexAppServerEventProjector = class {
 		this.rememberAssistantItem(itemId);
 		const text = `${this.assistantTextByItem.get(itemId) ?? ""}${delta}`;
 		this.assistantTextByItem.set(itemId, text);
+		if (this.isCommentaryAssistantItem(itemId)) this.emitCommentaryProgress({
+			itemId,
+			text
+		});
 	}
 	async handleReasoningDelta(params) {
 		const itemId = readString$2(params, "itemId") ?? readString$2(params, "id") ?? "reasoning";
@@ -730,6 +734,7 @@ var CodexAppServerEventProjector = class {
 	async handleItemStarted(params) {
 		const item = readItem(params.item);
 		const itemId = item?.id ?? readString$2(params, "itemId") ?? readString$2(params, "id");
+		this.rememberAssistantPhase(item);
 		if (itemId) this.activeItemIds.add(itemId);
 		if (item?.type === "contextCompaction" && itemId) {
 			this.activeCompactionItemIds.add(itemId);
@@ -784,9 +789,14 @@ var CodexAppServerEventProjector = class {
 			this.activeItemIds.delete(itemId);
 			this.completedItemIds.add(itemId);
 		}
+		this.rememberAssistantPhase(item);
 		if (item?.type === "agentMessage" && typeof item.text === "string" && item.text) {
 			this.rememberAssistantItem(item.id);
 			this.assistantTextByItem.set(item.id, item.text);
+			if (this.isCommentaryAssistantItem(item.id)) this.emitCommentaryProgress({
+				itemId: item.id,
+				text: item.text
+			});
 		}
 		this.recordNativeGeneratedMedia(item);
 		if (item?.type === "plan" && typeof item.text === "string" && item.text) {
@@ -914,6 +924,7 @@ var CodexAppServerEventProjector = class {
 			this.promptErrorSource = "prompt";
 		}
 		for (const item of turn.items ?? []) {
+			this.rememberAssistantPhase(item);
 			if (item.type === "agentMessage" && typeof item.text === "string" && item.text) {
 				this.rememberAssistantItem(item.id);
 				this.assistantTextByItem.set(item.id, item.text);
@@ -1006,6 +1017,30 @@ var CodexAppServerEventProjector = class {
 			}
 		});
 	}
+	rememberAssistantPhase(item) {
+		if (item?.type !== "agentMessage") return;
+		const phase = readItemString(item, "phase");
+		if (phase) this.assistantPhaseByItem.set(item.id, phase);
+	}
+	isCommentaryAssistantItem(itemId) {
+		return this.assistantPhaseByItem.get(itemId) === "commentary";
+	}
+	emitCommentaryProgress(params) {
+		const progressText = params.text.replace(/\s+/g, " ").trim();
+		if (!progressText || this.lastCommentaryProgressTextByItem.get(params.itemId) === progressText) return;
+		this.lastCommentaryProgressTextByItem.set(params.itemId, progressText);
+		this.emitAgentEvent({
+			stream: "item",
+			data: {
+				itemId: params.itemId,
+				kind: "preamble",
+				title: "Preamble",
+				phase: "update",
+				progressText,
+				source: "codex-app-server"
+			}
+		});
+	}
 	emitStandardItemEvent(params) {
 		const { item } = params;
 		if (!item) return;
@@ -1249,6 +1284,7 @@ var CodexAppServerEventProjector = class {
 			const itemId = this.assistantItemOrder[i];
 			if (!itemId) continue;
 			const text = this.assistantTextByItem.get(itemId)?.trim();
+			if (this.assistantPhaseByItem.get(itemId) === "commentary") continue;
 			if (text && !this.toolProgressTexts.has(text)) return text;
 		}
 	}
@@ -2094,12 +2130,7 @@ const CODEX_BOOTSTRAP_CONTEXT_ORDER = new Map([
 	["memory.md", 60],
 	["heartbeat.md", 70]
 ]);
-const testClientFactoryStorage = new AsyncLocalStorage();
-const clientFactory = defaultCodexAppServerClientFactory;
 let openClawCodingToolsFactoryForTests;
-function resolveCodexAppServerClientFactory() {
-	return testClientFactoryStorage.getStore() ?? clientFactory;
-}
 function emitCodexAppServerEvent(params, event) {
 	try {
 		emitAgentEvent({
@@ -2181,7 +2212,8 @@ function createCodexSteeringQueue(params) {
 		}
 	};
 	const sendTexts = async (texts) => {
-		if (texts.length === 0 || params.signal.aborted) return;
+		if (texts.length === 0) return;
+		if (params.signal.aborted) throw new Error("codex app-server steering queue aborted");
 		await params.client.request("turn/steer", {
 			threadId: params.threadId,
 			expectedTurnId: params.turnId,
@@ -2189,39 +2221,49 @@ function createCodexSteeringQueue(params) {
 		});
 	};
 	const enqueueSend = (texts) => {
-		sendChain = sendChain.then(() => sendTexts(texts)).catch((error) => {
+		const send = sendChain.then(() => sendTexts(texts));
+		sendChain = send.catch((error) => {
 			embeddedAgentLog.debug("codex app-server queued steer failed", { error });
 		});
-		return sendChain;
+		return send;
 	};
 	const flushBatch = () => {
 		clearBatchTimer();
-		const texts = batchedTexts;
+		const items = batchedTexts;
 		batchedTexts = [];
-		return enqueueSend(texts);
+		const send = enqueueSend(items.map((item) => item.text));
+		send.then(() => {
+			for (const item of items) item.resolve();
+		}, (error) => {
+			for (const item of items) item.reject(error);
+		});
+		return send;
 	};
 	return {
 		async queue(text, options) {
 			if (params.answerPendingUserInput(text)) return;
-			if (options?.steeringMode === "one-at-a-time") {
-				await flushBatch();
-				await enqueueSend([text]);
-				return;
-			}
-			batchedTexts.push(text);
-			clearBatchTimer();
-			const debounceMs = normalizeCodexSteerDebounceMs(options?.debounceMs);
-			batchTimer = setTimeout(() => {
-				batchTimer = void 0;
-				flushBatch();
-			}, debounceMs);
+			return await new Promise((resolve, reject) => {
+				batchedTexts.push({
+					text,
+					resolve,
+					reject
+				});
+				clearBatchTimer();
+				const debounceMs = normalizeCodexSteerDebounceMs(options?.debounceMs);
+				batchTimer = setTimeout(() => {
+					batchTimer = void 0;
+					flushBatch().catch(() => void 0);
+				}, debounceMs);
+			});
 		},
 		async flushPending() {
-			await flushBatch();
+			await flushBatch().catch(() => void 0);
 		},
 		cancel() {
 			clearBatchTimer();
+			const items = batchedTexts;
 			batchedTexts = [];
+			for (const item of items) item.reject(/* @__PURE__ */ new Error("codex app-server steering queue cancelled"));
 		}
 	};
 }
@@ -2244,7 +2286,7 @@ function restrictCodexAppServerSandboxForOpenClawSandbox(appServer, sandbox) {
 }
 async function runCodexAppServerAttempt(params, options = {}) {
 	const attemptStartedAt = Date.now();
-	const attemptClientFactory = resolveCodexAppServerClientFactory();
+	const attemptClientFactory = options.clientFactory ?? defaultCodexAppServerClientFactory;
 	const pluginConfig = readCodexPluginConfig(options.pluginConfig);
 	const configuredAppServer = resolveCodexAppServerRuntimeOptions({ pluginConfig });
 	const resolvedWorkspace = resolveUserPath(params.workspaceDir);
@@ -2335,6 +2377,11 @@ async function runCodexAppServerAttempt(params, options = {}) {
 	});
 	const hadSessionFile = await pathExists(params.sessionFile);
 	let historyMessages = await readMirroredSessionHistoryMessages(params.sessionFile) ?? [];
+	const hookContextWindowFields = {
+		...params.contextWindowInfo?.tokens ? { contextTokenBudget: params.contextWindowInfo.tokens } : params.contextTokenBudget ? { contextTokenBudget: params.contextTokenBudget } : {},
+		...params.contextWindowInfo?.source ? { contextWindowSource: params.contextWindowInfo.source } : {},
+		...params.contextWindowInfo?.referenceTokens ? { contextWindowReferenceTokens: params.contextWindowInfo.referenceTokens } : {}
+	};
 	const hookContext = {
 		runId: params.runId,
 		agentId: sessionAgentId,
@@ -2343,7 +2390,8 @@ async function runCodexAppServerAttempt(params, options = {}) {
 		workspaceDir: params.workspaceDir,
 		messageProvider: params.messageProvider ?? void 0,
 		trigger: params.trigger,
-		channelId: params.messageChannel ?? params.messageProvider ?? void 0
+		channelId: params.messageChannel ?? params.messageProvider ?? void 0,
+		...hookContextWindowFields
 	};
 	if (activeContextEngine) {
 		await bootstrapHarnessContextEngine({
@@ -3125,6 +3173,7 @@ async function runCodexAppServerAttempt(params, options = {}) {
 					sessionId: params.sessionId,
 					provider: params.provider,
 					model: params.modelId,
+					...hookContextWindowFields,
 					resolvedRef: params.runtimePlan?.observability.resolvedRef ?? `${params.provider}/${params.modelId}`,
 					...params.runtimePlan?.observability.harnessId ? { harnessId: params.runtimePlan.observability.harnessId } : {},
 					assistantTexts: []
@@ -3324,6 +3373,7 @@ async function runCodexAppServerAttempt(params, options = {}) {
 				sessionId: params.sessionId,
 				provider: params.provider,
 				model: params.modelId,
+				...hookContextWindowFields,
 				resolvedRef: params.runtimePlan?.observability.resolvedRef ?? `${params.provider}/${params.modelId}`,
 				...params.runtimePlan?.observability.harnessId ? { harnessId: params.runtimePlan.observability.harnessId } : {},
 				assistantTexts: result.assistantTexts,
@@ -3674,7 +3724,7 @@ async function buildDynamicTools(input) {
 	}), input.pluginConfig), {
 		modelHasVision,
 		hasInboundImages: (params.images?.length ?? 0) > 0
-	}), params.toolsAllow);
+	}), includeForcedMessageToolAllow(params.toolsAllow, params));
 	return normalizeAgentRuntimeTools({
 		runtimePlan: params.runtimePlan,
 		tools: filteredTools,
@@ -3687,6 +3737,12 @@ async function buildDynamicTools(input) {
 		model: params.model
 	});
 }
+function includeForcedMessageToolAllow(toolsAllow, params) {
+	if (!shouldForceMessageTool(params)) return toolsAllow;
+	if (toolsAllow === void 0) return toolsAllow;
+	if (toolsAllow.length === 0) return ["message"];
+	return new Set(toolsAllow.map((name) => normalizeCodexDynamicToolName(name))).has("message") ? toolsAllow : [...toolsAllow, "message"];
+}
 function filterCodexDynamicToolsForAllowlist(tools, toolsAllow) {
 	if (!toolsAllow || toolsAllow.length === 0) return tools;
 	const allowSet = new Set(toolsAllow.map((name) => normalizeCodexDynamicToolName(name)).filter(Boolean));
@@ -4118,7 +4174,7 @@ function renderCodexWorkspaceBootstrapInstructions(contextFiles) {
 }
 function remapCodexContextFilePath(params) {
 	const relativePath = path.relative(params.sourceWorkspaceDir, params.file.path);
-	if (!relativePath || relativePath.startsWith("..") || path.isAbsolute(relativePath) || params.sourceWorkspaceDir === params.targetWorkspaceDir) return params.file;
+	if (!relativePath || relativePath === ".." || relativePath.startsWith(`..${path.sep}`) || path.isAbsolute(relativePath) || params.sourceWorkspaceDir === params.targetWorkspaceDir) return params.file;
 	return {
 		...params.file,
 		path: path.join(params.targetWorkspaceDir, relativePath)

package/dist/{shared-client-Cr6W-a2G.js → shared-client-BwUqd3lh.js}

@@ -1,12 +1,12 @@
 import { t as __exportAll } from "./rolldown-runtime-DUslC3ob.js";
 import { n as codexAppServerStartOptionsKey, s as resolveCodexAppServerRuntimeOptions } from "./config-0rd3LnKg.js";
-import { a as MANAGED_CODEX_APP_SERVER_PACKAGE, o as resolveCodexAppServerSpawnEnv, t as CodexAppServerClient } from "./client-iRf11BEu.js";
+import { a as MANAGED_CODEX_APP_SERVER_PACKAGE, o as resolveCodexAppServerSpawnEnv, t as CodexAppServerClient } from "./client-CoctX13d.js";
 import { createRequire } from "node:module";
 import { createHash } from "node:crypto";
 import { constants, readFileSync } from "node:fs";
 import fs, { access } from "node:fs/promises";
 import path from "node:path";
-import { ensureAuthProfileStore, ensureAuthProfileStoreWithoutExternalProfiles, loadAuthProfileStoreForSecretsRuntime, refreshOAuthCredentialForRuntime, resolveApiKeyForProfile, resolveAuthProfileOrder, resolveDefaultAgentDir, resolvePersistedAuthProfileOwnerAgentDir, resolveProviderIdForAuth, saveAuthProfileStore } from "openclaw/plugin-sdk/agent-runtime";
+import { ensureAuthProfileStore, ensureAuthProfileStoreWithoutExternalProfiles, loadAuthProfileStoreForSecretsRuntime, refreshOAuthCredentialForRuntime, resolveApiKeyForProfile, resolveAuthProfileOrder, resolveDefaultAgentDir, resolvePersistedAuthProfileOwnerAgentDir, resolveProviderIdForAuth } from "openclaw/plugin-sdk/agent-runtime";
 import { fileURLToPath } from "node:url";
 import { withTimeout } from "openclaw/plugin-sdk/security-runtime";
 //#region extensions/codex/src/app-server/auth-bridge.ts
@@ -283,24 +283,17 @@ async function resolveOAuthCredentialForCodexAppServer(profileId, credential, pa
 	const persistedOAuthCredential = persistedCredential?.type === "oauth" && isCodexAppServerAuthProvider(persistedCredential.provider, params.config) ? persistedCredential : void 0;
 	const ownerCredential = store.profiles[profileId];
 	const overlaidOAuthCredential = ownerCredential?.type === "oauth" && isCodexAppServerAuthProvider(ownerCredential.provider, params.config) ? ownerCredential : void 0;
-	const credentialForOwner = persistedOAuthCredential ?? overlaidOAuthCredential ?? credential;
 	if (params.forceRefresh && !persistedOAuthCredential && overlaidOAuthCredential) {
 		const refreshedRuntimeCredential = await refreshOAuthCredentialForRuntime({ credential: overlaidOAuthCredential });
 		if (!refreshedRuntimeCredential?.access?.trim()) throw new Error(`Codex app-server auth profile "${profileId}" could not refresh.`);
 		store.profiles[profileId] = refreshedRuntimeCredential;
 		return refreshedRuntimeCredential;
 	}
-	if (params.forceRefresh && persistedOAuthCredential) {
-		store.profiles[profileId] = {
-			...credentialForOwner,
-			expires: 0
-		};
-		saveAuthProfileStore(store, ownerAgentDir);
-	}
 	const resolved = await resolveApiKeyForProfile({
 		store,
 		profileId,
-		agentDir: ownerAgentDir
+		agentDir: ownerAgentDir,
+		forceRefresh: params.forceRefresh && Boolean(persistedOAuthCredential)
 	});
 	const refreshed = loadAuthProfileStoreForSecretsRuntime(ownerAgentDir).profiles[profileId];
 	const storedCredential = store.profiles[profileId];
@@ -601,4 +594,4 @@ function clearSharedClientIfCurrent(client) {
 	state.key = void 0;
 }
 //#endregion
-export { withTimeout$1 as a, resolveCodexAppServerAuthProfileId as c, resolveCodexAppServerHomeDir as d, shared_client_exports as i, resolveCodexAppServerAuthProfileIdForAgent as l, createIsolatedCodexAppServerClient as n, refreshCodexAppServerAuthTokens as o, getSharedCodexAppServerClient as r, resolveCodexAppServerAuthAccountCacheKey as s, clearSharedCodexAppServerClientIfCurrent as t, resolveCodexAppServerEnvApiKeyCacheKey as u };
+export { shared_client_exports as a, resolveCodexAppServerAuthAccountCacheKey as c, resolveCodexAppServerEnvApiKeyCacheKey as d, resolveCodexAppServerHomeDir as f, getSharedCodexAppServerClient as i, resolveCodexAppServerAuthProfileId as l, clearSharedCodexAppServerClientIfCurrent as n, withTimeout$1 as o, createIsolatedCodexAppServerClient as r, refreshCodexAppServerAuthTokens as s, clearSharedCodexAppServerClientAndWait as t, resolveCodexAppServerAuthProfileIdForAgent as u };

package/dist/{side-question-DV7KYIB8.js → side-question-CVWPOkY-.js}

@@ -1,13 +1,13 @@
 import { o as readCodexPluginConfig, s as resolveCodexAppServerRuntimeOptions } from "./config-0rd3LnKg.js";
 import { a as readCodexDynamicToolCallParams, i as assertCodexTurnStartResponse, l as readCodexTurnCompletedNotification, t as assertCodexThreadForkResponse } from "./protocol-validators-CSY0BFBo.js";
 import { t as isJsonObject } from "./protocol-C9UWI98H.js";
-import { r as isCodexAppServerApprovalRequest } from "./client-iRf11BEu.js";
-import { u as formatCodexUsageLimitErrorMessage } from "./command-formatters-Ttwc_kgX.js";
-import { o as refreshCodexAppServerAuthTokens, r as getSharedCodexAppServerClient } from "./shared-client-Cr6W-a2G.js";
+import { r as isCodexAppServerApprovalRequest } from "./client-CoctX13d.js";
+import { u as formatCodexUsageLimitErrorMessage } from "./command-formatters-DRJaVHhN.js";
+import { i as getSharedCodexAppServerClient, s as refreshCodexAppServerAuthTokens } from "./shared-client-BwUqd3lh.js";
 import { i as readCodexAppServerBinding } from "./session-binding-CMTXuyoz.js";
-import { c as resolveCodexAppServerModelProvider, l as resolveReasoningEffort, n as buildCodexRuntimeThreadConfig, v as createCodexDynamicToolBridge, y as filterCodexDynamicTools } from "./thread-lifecycle-CJppEyYT.js";
-import { n as handleCodexAppServerElicitationRequest, r as handleCodexAppServerApprovalRequest, t as filterToolsForVisionInputs } from "./vision-tools-DHyuabWn.js";
-import { n as rememberCodexRateLimits, t as readRecentCodexRateLimits } from "./rate-limit-cache-BFi-50LG.js";
+import { c as resolveCodexAppServerModelProvider, l as resolveReasoningEffort, n as buildCodexRuntimeThreadConfig, v as createCodexDynamicToolBridge, y as filterCodexDynamicTools } from "./thread-lifecycle-DrbViNpf.js";
+import { n as handleCodexAppServerElicitationRequest, r as handleCodexAppServerApprovalRequest, t as filterToolsForVisionInputs } from "./vision-tools-CzTdigBu.js";
+import { n as rememberCodexRateLimits, t as readRecentCodexRateLimits } from "./rate-limit-cache-dvhq-4pi.js";
 import { embeddedAgentLog, formatErrorMessage, resolveAgentDir, resolveAttemptSpawnWorkspaceDir, resolveModelAuthMode, resolveSandboxContext, resolveSessionAgentIds, supportsModelTools } from "openclaw/plugin-sdk/agent-harness-runtime";
 //#region extensions/codex/src/app-server/side-question.ts
 const CODEX_SIDE_DYNAMIC_TOOL_TIMEOUT_MS = 3e4;

package/dist/test-api.js

@@ -1,5 +1,5 @@
 import { s as resolveCodexAppServerRuntimeOptions } from "./config-0rd3LnKg.js";
-import { a as buildThreadStartParams, i as buildThreadResumeParams, o as buildTurnStartParams, r as buildDeveloperInstructions, v as createCodexDynamicToolBridge, y as filterCodexDynamicTools } from "./thread-lifecycle-CJppEyYT.js";
+import { a as buildThreadStartParams, i as buildThreadResumeParams, o as buildTurnStartParams, r as buildDeveloperInstructions, v as createCodexDynamicToolBridge, y as filterCodexDynamicTools } from "./thread-lifecycle-DrbViNpf.js";
 //#region extensions/codex/test-api.ts
 function resolveCodexPromptSnapshotAppServerOptions(pluginConfig) {
 	return resolveCodexAppServerRuntimeOptions({

package/dist/{thread-lifecycle-CJppEyYT.js → thread-lifecycle-DrbViNpf.js}

@@ -3,9 +3,9 @@ import { n as assertCodexThreadResumeResponse, r as assertCodexThreadStartRespon
 import { t as isJsonObject } from "./protocol-C9UWI98H.js";
 import { CODEX_GPT5_HEARTBEAT_PROMPT_OVERLAY, renderCodexPromptOverlay } from "./prompt-overlay.js";
 import { isModernCodexModel } from "./provider.js";
-import { i as isCodexAppServerConnectionClosedError } from "./client-iRf11BEu.js";
+import { i as isCodexAppServerConnectionClosedError } from "./client-CoctX13d.js";
 import { i as readCodexAppServerBinding, n as isCodexAppServerNativeAuthProfile, o as writeCodexAppServerBinding, t as clearCodexAppServerBinding } from "./session-binding-CMTXuyoz.js";
-import { a as defaultCodexAppInventoryCache, r as readCodexPluginInventory, t as ensureCodexPluginActivation } from "./plugin-activation-PXGqUjwY.js";
+import { a as defaultCodexAppInventoryCache, r as readCodexPluginInventory, t as ensureCodexPluginActivation } from "./plugin-activation-aQOmRQwA.js";
 import crypto from "node:crypto";
 import { HEARTBEAT_RESPONSE_TOOL_NAME, createAgentToolResultMiddlewareRunner, createCodexAppServerToolResultExtensionRunner, embeddedAgentLog, extractToolResultMediaArtifact, filterToolResultMediaUrls, isActiveHarnessContextEngine, isMessagingTool, isMessagingToolSendAction, isToolWrappedWithBeforeToolCallHook, normalizeHeartbeatToolResponse, runAgentHarnessAfterToolCallHook, wrapToolWithBeforeToolCallHook } from "openclaw/plugin-sdk/agent-harness-runtime";
 import { buildCodexUserMcpServersThreadConfigPatch } from "openclaw/plugin-sdk/codex-mcp-projection";
@@ -297,14 +297,33 @@ function readFirstString(record, keys) {
 }
 function collectMediaUrls(record) {
 	const urls = [];
+	const pushMediaUrl = (value) => {
+		if (typeof value === "string" && value.trim()) urls.push(value.trim());
+	};
+	const pushAttachment = (value) => {
+		if (!value || typeof value !== "object" || Array.isArray(value)) return;
+		const attachment = value;
+		for (const key of [
+			"media",
+			"mediaUrl",
+			"path",
+			"filePath",
+			"fileUrl",
+			"url"
+		]) pushMediaUrl(attachment[key]);
+	};
 	for (const key of [
+		"media",
 		"mediaUrl",
 		"media_url",
+		"path",
+		"filePath",
+		"fileUrl",
 		"imageUrl",
 		"image_url"
 	]) {
 		const value = record[key];
-		if (typeof value === "string" && value.trim()) urls.push(value.trim());
+		pushMediaUrl(value);
 	}
 	for (const key of [
 		"mediaUrls",
@@ -314,8 +333,10 @@ function collectMediaUrls(record) {
 	]) {
 		const value = record[key];
 		if (!Array.isArray(value)) continue;
-		for (const entry of value) if (typeof entry === "string" && entry.trim()) urls.push(entry.trim());
+		for (const entry of value) pushMediaUrl(entry);
 	}
+	const attachments = record.attachments;
+	if (Array.isArray(attachments)) for (const attachment of attachments) pushAttachment(attachment);
 	return urls;
 }
 function isCronAddAction(args) {
@@ -680,6 +701,7 @@ const CODEX_CODE_MODE_THREAD_CONFIG = {
 	"features.code_mode": true,
 	"features.code_mode_only": true
 };
+const CODEX_LIGHTWEIGHT_CONTEXT_THREAD_CONFIG = { project_doc_max_bytes: 0 };
 async function startOrResumeThread(params) {
 	const dynamicToolsFingerprint = fingerprintDynamicTools(params.dynamicTools);
 	const contextEngineBinding = buildContextEngineBinding(params.params);
@@ -939,7 +961,7 @@ function buildThreadStartParams(params, options) {
 		sandbox: options.appServer.sandbox,
 		...options.appServer.serviceTier ? { serviceTier: options.appServer.serviceTier } : {},
 		serviceName: "OpenClaw",
-		config: buildCodexRuntimeThreadConfig(options.config),
+		config: buildCodexRuntimeThreadConfigForRun(params, options.config),
 		developerInstructions: options.developerInstructions ?? buildDeveloperInstructions(params),
 		dynamicTools: options.dynamicTools,
 		experimentalRawEvents: true,
@@ -962,7 +984,7 @@ function buildThreadResumeParams(params, options) {
 		approvalsReviewer: options.appServer.approvalsReviewer,
 		sandbox: options.appServer.sandbox,
 		...options.appServer.serviceTier ? { serviceTier: options.appServer.serviceTier } : {},
-		config: buildCodexRuntimeThreadConfig(options.config),
+		config: buildCodexRuntimeThreadConfigForRun(params, options.config),
 		developerInstructions: options.developerInstructions ?? buildDeveloperInstructions(params),
 		persistExtendedHistory: true
 	};
@@ -970,6 +992,14 @@ function buildThreadResumeParams(params, options) {
 function buildCodexRuntimeThreadConfig(config) {
 	return mergeCodexThreadConfigs(config, CODEX_CODE_MODE_THREAD_CONFIG) ?? { ...CODEX_CODE_MODE_THREAD_CONFIG };
 }
+function buildCodexRuntimeThreadConfigForRun(params, config) {
+	const runtimeConfig = buildCodexRuntimeThreadConfig(config);
+	if (params.bootstrapContextMode !== "lightweight") return runtimeConfig;
+	return mergeCodexThreadConfigs(runtimeConfig, CODEX_LIGHTWEIGHT_CONTEXT_THREAD_CONFIG) ?? {
+		...runtimeConfig,
+		...CODEX_LIGHTWEIGHT_CONTEXT_THREAD_CONFIG
+	};
+}
 function buildTurnStartParams(params, options) {
 	return {
 		threadId: options.threadId,
@@ -990,10 +1020,23 @@ function buildTurnCollaborationMode(params) {
 		settings: {
 			model: params.modelId,
 			reasoning_effort: resolveReasoningEffort(params.thinkLevel, params.modelId),
-			developer_instructions: params.trigger === "heartbeat" ? buildHeartbeatCollaborationInstructions() : null
+			developer_instructions: buildTurnScopedCollaborationInstructions(params)
 		}
 	};
 }
+function buildTurnScopedCollaborationInstructions(params) {
+	if (params.trigger === "cron") return buildCronCollaborationInstructions();
+	if (params.trigger === "heartbeat") return buildHeartbeatCollaborationInstructions();
+	return null;
+}
+function buildCronCollaborationInstructions() {
+	return [
+		"This is an OpenClaw cron automation turn. Apply these instructions only to this scheduled job; ordinary chat turns should stay in Codex Default mode.",
+		"Execute the cron payload directly. If it asks you to run an exact command, run that command before doing any investigation, planning, memory review, or workspace bootstrap.",
+		"Use context already provided by the runtime, but do not spend time loading or re-reading workspace bootstrap, memory, or project-doc files before executing the cron payload. Inspect those files only if the payload asks for them or the command fails and they are needed to diagnose it.",
+		"Keep output concise and automation-oriented. Prefer the final command result or a short failure summary over status narration."
+	].join("\n\n");
+}
 function buildHeartbeatCollaborationInstructions() {
 	return [
 		"This is an OpenClaw heartbeat turn. Apply these instructions only to this heartbeat wake; ordinary chat turns should stay in Codex Default mode.",

package/dist/{vision-tools-DHyuabWn.js → vision-tools-CzTdigBu.js}

@@ -1,5 +1,5 @@
 import { t as isJsonObject } from "./protocol-C9UWI98H.js";
-import { r as formatCodexDisplayText } from "./command-formatters-Ttwc_kgX.js";
+import { r as formatCodexDisplayText } from "./command-formatters-DRJaVHhN.js";
 import { callGatewayTool, embeddedAgentLog, formatApprovalDisplayPath } from "openclaw/plugin-sdk/agent-harness-runtime";
 //#region extensions/codex/src/app-server/plugin-approval-roundtrip.ts
 const DEFAULT_CODEX_APPROVAL_TIMEOUT_MS = 12e4;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/codex",
-  "version": "2026.5.12",
+  "version": "2026.5.14-beta.2",
   "description": "OpenClaw Codex harness and model provider plugin",
   "repository": {
     "type": "git",
@@ -11,7 +11,7 @@
     "@earendil-works/pi-coding-agent": "0.74.0",
     "@openai/codex": "0.130.0",
     "ajv": "8.20.0",
-    "ws": "8.20.0",
+    "ws": "8.20.1",
     "zod": "4.4.3"
   },
   "devDependencies": {
@@ -27,10 +27,10 @@
       "minHostVersion": ">=2026.5.1-beta.1"
     },
     "compat": {
-      "pluginApi": ">=2026.5.12"
+      "pluginApi": ">=2026.5.14-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.5.12"
+      "openclawVersion": "2026.5.14-beta.2"
     },
     "release": {
       "publishToClawHub": true,
@@ -45,7 +45,7 @@
     "openclaw.plugin.json"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.5.12"
+    "openclaw": ">=2026.5.14-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/client-factory-DfnbdQv7.js

@@ -1,19 +0,0 @@
-//#region extensions/codex/src/app-server/client-factory.ts
-const defaultCodexAppServerClientFactory = (startOptions, authProfileId, agentDir, config) => import("./shared-client-Cr6W-a2G.js").then((n) => n.i).then(({ getSharedCodexAppServerClient }) => getSharedCodexAppServerClient({
-	startOptions,
-	authProfileId,
-	agentDir,
-	config
-}));
-function createCodexAppServerClientFactoryTestHooks(setFactory) {
-	return {
-		setCodexAppServerClientFactoryForTests(factory) {
-			setFactory(factory);
-		},
-		resetCodexAppServerClientFactoryForTests() {
-			setFactory(defaultCodexAppServerClientFactory);
-		}
-	};
-}
-//#endregion
-export { defaultCodexAppServerClientFactory as n, createCodexAppServerClientFactoryTestHooks as t };

package/dist/request-ohCy5ASa.js

@@ -1,45 +0,0 @@
-import { n as CodexAppServerRpcError } from "./client-iRf11BEu.js";
-import { a as withTimeout, n as createIsolatedCodexAppServerClient, r as getSharedCodexAppServerClient } from "./shared-client-Cr6W-a2G.js";
-//#region extensions/codex/src/app-server/capabilities.ts
-const CODEX_CONTROL_METHODS = {
-	account: "account/read",
-	compact: "thread/compact/start",
-	feedback: "feedback/upload",
-	listMcpServers: "mcpServerStatus/list",
-	listSkills: "skills/list",
-	listThreads: "thread/list",
-	rateLimits: "account/rateLimits/read",
-	resumeThread: "thread/resume",
-	review: "review/start"
-};
-function describeControlFailure(error) {
-	if (isUnsupportedControlError(error)) return "unsupported by this Codex app-server";
-	return error instanceof Error ? error.message : String(error);
-}
-function isUnsupportedControlError(error) {
-	return error instanceof CodexAppServerRpcError && error.code === -32601;
-}
-//#endregion
-//#region extensions/codex/src/app-server/request.ts
-async function requestCodexAppServerJson(params) {
-	const timeoutMs = params.timeoutMs ?? 6e4;
-	return await withTimeout((async () => {
-		const client = await (params.isolated ? createIsolatedCodexAppServerClient : getSharedCodexAppServerClient)({
-			startOptions: params.startOptions,
-			timeoutMs,
-			authProfileId: params.authProfileId,
-			agentDir: params.agentDir,
-			config: params.config
-		});
-		try {
-			return await client.request(params.method, params.requestParams, { timeoutMs });
-		} finally {
-			if (params.isolated) await client.closeAndWait({
-				exitTimeoutMs: 2e3,
-				forceKillDelayMs: 250
-			});
-		}
-	})(), timeoutMs, `codex app-server ${params.method} timed out`);
-}
-//#endregion
-export { CODEX_CONTROL_METHODS as n, describeControlFailure as r, requestCodexAppServerJson as t };