@openclaw/codex 2026.7.2-beta.5 → 2026.7.33

package/dist/media-understanding-provider.js

@@ -1,174 +1,2 @@
-import { t as runBoundedCodexAppServerTurn } from "./bounded-turn-FEbUXoYT.js";
-import { validateJsonSchemaValue } from "openclaw/plugin-sdk/json-schema-runtime";
-//#region extensions/codex/media-understanding-provider.ts
-/**
-* Codex-backed media understanding provider for bounded image description and
-* structured extraction turns.
-*/
-const CODEX_MEDIA_PROVIDER_ID = "codex";
-const DEFAULT_CODEX_IMAGE_MODEL = "gpt-5.6-sol";
-const DEFAULT_CODEX_IMAGE_PROMPT = "Describe the image.";
-/**
-* Builds the media-understanding provider that delegates image tasks to an
-* isolated Codex app-server session.
-*/
-function buildCodexMediaUnderstandingProvider(options = {}) {
-	return {
-		id: CODEX_MEDIA_PROVIDER_ID,
-		capabilities: ["image"],
-		defaultModels: { image: DEFAULT_CODEX_IMAGE_MODEL },
-		describeImage: async (req) => describeCodexImages({
-			images: [{
-				buffer: req.buffer,
-				fileName: req.fileName,
-				mime: req.mime
-			}],
-			provider: req.provider,
-			model: req.model,
-			prompt: req.prompt,
-			maxTokens: req.maxTokens,
-			timeoutMs: req.timeoutMs,
-			...req.signal ? { signal: req.signal } : {},
-			profile: req.profile,
-			preferredProfile: req.preferredProfile,
-			authStore: req.authStore,
-			agentDir: req.agentDir,
-			cfg: req.cfg
-		}, options),
-		describeImages: async (req) => describeCodexImages(req, options),
-		extractStructured: async (req) => extractCodexStructured(req, options)
-	};
-}
-async function describeCodexImages(req, options) {
-	const model = req.model.trim();
-	if (!model) throw new Error("Codex image understanding requires model id.");
-	req.signal?.throwIfAborted();
-	const { text } = await runBoundedCodexAppServerTurn({
-		config: req.cfg,
-		model: {
-			mode: "required",
-			id: model
-		},
-		profile: req.profile,
-		timeoutMs: req.timeoutMs,
-		signal: req.signal,
-		agentDir: req.agentDir,
-		authProfileStore: req.authStore,
-		options,
-		taskLabel: "image understanding",
-		developerInstructions: "You are OpenClaw's bounded image-understanding worker. Describe only the provided image content. Do not call tools, edit files, or ask follow-up questions.",
-		input: [{
-			type: "text",
-			text: buildCodexImagePrompt(req),
-			text_elements: []
-		}, ...req.images.map((image) => ({
-			type: "image",
-			url: `data:${image.mime ?? "image/png"};base64,${image.buffer.toString("base64")}`
-		}))],
-		requiredModalities: ["text", "image"],
-		isolation: "configured-transport"
-	});
-	return {
-		text,
-		model
-	};
-}
-async function extractCodexStructured(req, options) {
-	const model = req.model.trim();
-	if (!model) throw new Error("Codex structured extraction requires model id.");
-	if (!req.instructions.trim()) throw new Error("Codex structured extraction requires instructions.");
-	if (req.input.length === 0) throw new Error("Codex structured extraction requires at least one input.");
-	if (!req.input.some((entry) => entry.type === "image")) throw new Error("Codex structured extraction requires at least one image input.");
-	req.signal?.throwIfAborted();
-	const { text } = await runBoundedCodexAppServerTurn({
-		config: req.cfg,
-		model: {
-			mode: "required",
-			id: model
-		},
-		profile: req.profile,
-		timeoutMs: req.timeoutMs,
-		signal: req.signal,
-		agentDir: req.agentDir,
-		authProfileStore: req.authStore,
-		options,
-		taskLabel: "structured extraction",
-		developerInstructions: "You are OpenClaw's bounded structured-extraction worker. Return only the requested extraction. Do not call tools, edit files, ask follow-up questions, or include secrets.",
-		input: buildCodexStructuredInput(req),
-		requiredModalities: requiredStructuredModalities(),
-		isolation: "configured-transport"
-	});
-	return normalizeStructuredExtractionResult({
-		text,
-		model,
-		provider: req.provider,
-		req
-	});
-}
-function buildCodexImagePrompt(req) {
-	const prompt = req.prompt?.trim() || DEFAULT_CODEX_IMAGE_PROMPT;
-	if (req.images.length <= 1) return prompt;
-	return `${prompt}\n\nAnalyze all ${req.images.length} images together.`;
-}
-function requiredStructuredModalities() {
-	return ["text", "image"];
-}
-function buildCodexStructuredInput(req) {
-	return [{
-		type: "text",
-		text: buildStructuredExtractionPrompt(req),
-		text_elements: []
-	}, ...req.input.map((entry) => {
-		if (entry.type === "text") return {
-			type: "text",
-			text: entry.text,
-			text_elements: []
-		};
-		return {
-			type: "image",
-			url: `data:${entry.mime ?? "image/png"};base64,${entry.buffer.toString("base64")}`
-		};
-	})];
-}
-function buildStructuredExtractionPrompt(req) {
-	return [
-		req.instructions.trim(),
-		req.schemaName ? `Schema name: ${req.schemaName}` : void 0,
-		req.jsonSchema ? `JSON schema:\n${JSON.stringify(req.jsonSchema)}` : void 0,
-		req.jsonMode === false ? "Return the extraction as concise text." : "Return valid JSON only. Do not wrap the JSON in Markdown fences."
-	].filter((part) => Boolean(part)).join("\n\n");
-}
-function isJsonSchemaObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function normalizeStructuredExtractionResult(params) {
-	const result = {
-		text: params.text,
-		model: params.model,
-		provider: params.provider,
-		contentType: params.req.jsonMode === false ? "text" : "json"
-	};
-	if (params.req.jsonMode !== false) {
-		try {
-			result.parsed = JSON.parse(params.text);
-		} catch {
-			throw new Error("Codex structured extraction returned invalid JSON.");
-		}
-		if (isJsonSchemaObject(params.req.jsonSchema)) {
-			const validation = validateJsonSchemaValue({
-				schema: params.req.jsonSchema,
-				cacheKey: "codex.media-understanding.extractStructured",
-				value: result.parsed,
-				cache: false
-			});
-			if (!validation.ok) {
-				const message = validation.errors.map((error) => error.text).join("; ") || "invalid";
-				throw new Error(`Codex structured extraction JSON did not match schema: ${message}`);
-			}
-			result.parsed = validation.value;
-		}
-	}
-	return result;
-}
-//#endregion
+import { t as buildCodexMediaUnderstandingProvider } from "./.setup/media-understanding-provider-EbJCyDqe.mjs";
 export { buildCodexMediaUnderstandingProvider };

package/dist/prompt-overlay.js

@@ -0,0 +1,15 @@
+import { GPT5_BEHAVIOR_CONTRACT, GPT5_HEARTBEAT_PROMPT_OVERLAY, resolveGpt5SystemPromptContribution } from "openclaw/plugin-sdk/provider-model-shared";
+//#region extensions/codex/prompt-overlay.ts
+/**
+* Codex prompt-overlay facade for GPT-5 behavior and heartbeat guidance.
+*/
+/** GPT-5 behavior contract re-exported under the Codex provider namespace. */
+const CODEX_GPT5_BEHAVIOR_CONTRACT = GPT5_BEHAVIOR_CONTRACT;
+/** Heartbeat prompt overlay re-exported under the Codex provider namespace. */
+const CODEX_GPT5_HEARTBEAT_PROMPT_OVERLAY = GPT5_HEARTBEAT_PROMPT_OVERLAY;
+/** Resolves the Codex system-prompt contribution for GPT-5-family models. */
+function resolveCodexSystemPromptContribution(params) {
+	return resolveGpt5SystemPromptContribution(params);
+}
+//#endregion
+export { CODEX_GPT5_BEHAVIOR_CONTRACT, CODEX_GPT5_HEARTBEAT_PROMPT_OVERLAY, resolveCodexSystemPromptContribution };

package/dist/provider-catalog.js

@@ -0,0 +1,79 @@
+//#region extensions/codex/provider-catalog.ts
+/** Provider id used by Codex model refs. */
+const CODEX_PROVIDER_ID = "codex";
+/** Synthetic base URL used to route Codex app-server model requests. */
+const CODEX_BASE_URL = "https://chatgpt.com/backend-api";
+/** Synthetic auth marker understood by Codex app-server runtime paths. */
+const CODEX_APP_SERVER_AUTH_MARKER = "codex-app-server";
+const DEFAULT_CONTEXT_WINDOW = 272e3;
+const DEFAULT_MAX_TOKENS = 128e3;
+/** Offline fallback catalog used when live app-server discovery is unavailable. */
+const FALLBACK_CODEX_MODELS = [{
+	id: "gpt-5.5",
+	model: "gpt-5.5",
+	displayName: "gpt-5.5",
+	description: "Latest frontier agentic coding model.",
+	isDefault: true,
+	inputModalities: ["text", "image"],
+	supportedReasoningEfforts: [
+		"low",
+		"medium",
+		"high",
+		"xhigh"
+	]
+}, {
+	id: "gpt-5.4-mini",
+	model: "gpt-5.4-mini",
+	displayName: "GPT-5.4-Mini",
+	description: "Smaller frontier agentic coding model.",
+	inputModalities: ["text", "image"],
+	supportedReasoningEfforts: [
+		"low",
+		"medium",
+		"high",
+		"xhigh"
+	]
+}];
+/**
+* Converts a Codex app-server model record into OpenClaw provider model config.
+*/
+function buildCodexModelDefinition(model) {
+	const id = model.id.trim() || model.model.trim();
+	const supportedReasoningEfforts = model.supportedReasoningEfforts;
+	return {
+		id,
+		name: model.displayName?.trim() || id,
+		api: "openai-chatgpt-responses",
+		reasoning: supportedReasoningEfforts !== void 0 ? supportedReasoningEfforts.length > 0 : shouldDefaultToReasoningModel(id),
+		input: model.inputModalities.includes("image") ? ["text", "image"] : ["text"],
+		cost: {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0
+		},
+		contextWindow: DEFAULT_CONTEXT_WINDOW,
+		maxTokens: DEFAULT_MAX_TOKENS,
+		compat: {
+			...supportedReasoningEfforts !== void 0 ? { supportsReasoningEffort: supportedReasoningEfforts.length > 0 } : {},
+			...supportedReasoningEfforts && supportedReasoningEfforts.length > 0 ? { supportedReasoningEfforts: [...supportedReasoningEfforts] } : {},
+			supportsUsageInStreaming: true
+		}
+	};
+}
+/** Builds the synthetic Codex provider config for a model list. */
+function buildCodexProviderConfig(models) {
+	return {
+		baseUrl: CODEX_BASE_URL,
+		apiKey: CODEX_APP_SERVER_AUTH_MARKER,
+		auth: "token",
+		api: "openai-chatgpt-responses",
+		models: models.map(buildCodexModelDefinition)
+	};
+}
+function shouldDefaultToReasoningModel(modelId) {
+	const lower = modelId.toLowerCase();
+	return lower.startsWith("gpt-5") || lower.startsWith("o1") || lower.startsWith("o3") || lower.startsWith("o4");
+}
+//#endregion
+export { CODEX_APP_SERVER_AUTH_MARKER, CODEX_BASE_URL, CODEX_PROVIDER_ID, FALLBACK_CODEX_MODELS, buildCodexModelDefinition, buildCodexProviderConfig };

package/dist/provider-discovery.js

@@ -0,0 +1,34 @@
+import { CODEX_APP_SERVER_AUTH_MARKER, CODEX_PROVIDER_ID, FALLBACK_CODEX_MODELS, buildCodexProviderConfig } from "./provider-catalog.js";
+//#region extensions/codex/provider-discovery.ts
+function resolveCodexPluginConfig(ctx) {
+	return (ctx.config.plugins?.entries)?.codex?.config;
+}
+async function runCodexCatalog(ctx) {
+	const { buildCodexProviderCatalog } = await import("./provider.js");
+	return await buildCodexProviderCatalog({
+		env: ctx.env,
+		pluginConfig: resolveCodexPluginConfig(ctx)
+	});
+}
+/** Provider discovery descriptor with static fallback and synthetic auth. */
+const codexProviderDiscovery = {
+	id: CODEX_PROVIDER_ID,
+	label: "Codex",
+	docsPath: "/providers/models",
+	auth: [],
+	catalog: {
+		order: "late",
+		run: runCodexCatalog
+	},
+	staticCatalog: {
+		order: "late",
+		run: async () => ({ provider: buildCodexProviderConfig(FALLBACK_CODEX_MODELS) })
+	},
+	resolveSyntheticAuth: () => ({
+		apiKey: CODEX_APP_SERVER_AUTH_MARKER,
+		source: "codex-app-server",
+		mode: "token"
+	})
+};
+//#endregion
+export { codexProviderDiscovery, codexProviderDiscovery as default };

package/dist/provider.js

@@ -0,0 +1,2 @@
+import { a as readCodexSupportedReasoningEfforts, i as isModernCodexModel, n as buildCodexProviderCatalog, o as resolveCodexFallbackReasoningEfforts, r as isMaxReasoningCodexModel, s as resolveCodexSupportedReasoningEffort, t as buildCodexProvider } from "./.setup/provider-DGxDs6g8.mjs";
+export { buildCodexProvider, buildCodexProviderCatalog, isMaxReasoningCodexModel, isModernCodexModel, readCodexSupportedReasoningEfforts, resolveCodexFallbackReasoningEfforts, resolveCodexSupportedReasoningEffort };

package/dist/web-search-contract-api.js

@@ -1,4 +1,4 @@
-import { t as createCodexWebSearchProviderBase } from "./web-search-provider.shared-BrZmlqyR.js";
+import { t as createCodexWebSearchProviderBase } from "./.setup/web-search-provider.shared-BrZmlqyR.mjs";
 //#region extensions/codex/web-search-contract-api.ts
 function createCodexWebSearchProvider() {
 	return {