@openclaw/ai 2026.7.2-beta.2 → 2026.7.2-beta.4

package/dist/{openai-tool-projection-CFqm42J2.mjs → openai-tool-projection-ITOU9bG1.mjs}

@@ -1,4 +1,4 @@
-import { d as isRecord } from "./transform-messages-BmS70CP5.mjs";
+import { T as isRecord } from "./system-prompt-cache-boundary-CbHeV4_l.mjs";
 import { t as projectRuntimeToolInputSchema } from "./tool-schema-json-projection-BwNu3nDi.mjs";
 //#region packages/ai/src/providers/openai-prompt-cache.ts
 /** Maximum prompt cache key length accepted by OpenAI-compatible request metadata. */

package/dist/provider-error-C4VvV_3t.mjs

@@ -0,0 +1,41 @@
+import { w as truncateUtf16Safe } from "./system-prompt-cache-boundary-CbHeV4_l.mjs";
+//#region packages/ai/src/utils/provider-error.ts
+const MAX_ERROR_BODY_LENGTH = 4e3;
+function stringify(value) {
+	try {
+		return JSON.stringify(value) ?? String(value);
+	} catch {
+		return String(value);
+	}
+}
+function readStatus(error) {
+	for (const value of [
+		error.status,
+		error.statusCode,
+		error.response?.status,
+		error.response?.statusCode
+	]) if (typeof value === "number" && Number.isFinite(value)) return value;
+}
+function readBody(error) {
+	for (const value of [
+		error.body,
+		error.error,
+		error.response?.body,
+		error.response?.data
+	]) {
+		if (value === void 0 || value === null) continue;
+		if (typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0) continue;
+		const body = (typeof value === "string" ? value : stringify(value)).trim();
+		if (body.length > 0) return body.length <= MAX_ERROR_BODY_LENGTH ? body : `${truncateUtf16Safe(body, MAX_ERROR_BODY_LENGTH)}... [truncated]`;
+	}
+}
+function formatProviderError(error) {
+	if (!(error instanceof Error)) return stringify(error);
+	const httpError = error;
+	const status = readStatus(httpError);
+	const body = readBody(httpError);
+	if (status === void 0 || body === void 0 || error.message.includes(body)) return error.message;
+	return `${status}: ${body}`;
+}
+//#endregion
+export { formatProviderError as t };

package/dist/providers.d.mts

@@ -1,4 +1,4 @@
-import { n as ApiRegistry } from "./api-registry-Byvoz8Ha.mjs";
+import { n as ApiRegistry } from "./api-registry-BMphkFf1.mjs";
 
 //#region packages/ai/src/providers/register-builtins.d.ts
 /** Source id used for built-in API provider registrations. */

package/dist/providers.mjs

@@ -63,35 +63,35 @@ function createLazyRegistration(api, importModule, select) {
 	};
 }
 const registerBuiltIns = [
-	createLazyRegistration("anthropic-messages", () => import("./anthropic-BIRSg5x9.mjs").then((n) => n.t), (module) => ({
+	createLazyRegistration("anthropic-messages", () => import("./anthropic-CrUDIBpM.mjs").then((n) => n.t), (module) => ({
 		stream: module.streamAnthropic,
 		streamSimple: module.streamSimpleAnthropic
 	})),
-	createLazyRegistration("openai-completions", () => import("./openai-completions-DPR_O2RW.mjs").then((n) => n.n), (module) => ({
+	createLazyRegistration("openai-completions", () => import("./openai-completions-exO8NFQf.mjs").then((n) => n.n), (module) => ({
 		stream: module.streamOpenAICompletions,
 		streamSimple: module.streamSimpleOpenAICompletions
 	})),
-	createLazyRegistration("mistral-conversations", () => import("./mistral-DxMPt9q9.mjs"), (module) => ({
+	createLazyRegistration("mistral-conversations", () => import("./mistral-D5Ps7Led.mjs"), (module) => ({
 		stream: module.streamMistral,
 		streamSimple: module.streamSimpleMistral
 	})),
-	createLazyRegistration("openai-responses", () => import("./openai-responses-Cov-Vdc2.mjs").then((n) => n.t), (module) => ({
+	createLazyRegistration("openai-responses", () => import("./openai-responses-BHpmtUKo.mjs").then((n) => n.t), (module) => ({
 		stream: module.streamOpenAIResponses,
 		streamSimple: module.streamSimpleOpenAIResponses
 	})),
-	createLazyRegistration("azure-openai-responses", () => import("./azure-openai-responses-CHi7Wo4A.mjs"), (module) => ({
+	createLazyRegistration("azure-openai-responses", () => import("./azure-openai-responses-CbrpVeEv.mjs"), (module) => ({
 		stream: module.streamAzureOpenAIResponses,
 		streamSimple: module.streamSimpleAzureOpenAIResponses
 	})),
-	createLazyRegistration("openai-chatgpt-responses", () => import("./openai-chatgpt-responses-BuH2NvsR.mjs"), (module) => ({
+	createLazyRegistration("openai-chatgpt-responses", () => import("./openai-chatgpt-responses-h0o5yV8Y.mjs"), (module) => ({
 		stream: module.streamOpenAICodexResponses,
 		streamSimple: module.streamSimpleOpenAICodexResponses
 	})),
-	createLazyRegistration("google-generative-ai", () => import("./google-BmsqsNwR.mjs"), (module) => ({
+	createLazyRegistration("google-generative-ai", () => import("./google-Cs62KA7t.mjs"), (module) => ({
 		stream: module.streamGoogle,
 		streamSimple: module.streamSimpleGoogle
 	})),
-	createLazyRegistration("google-vertex", () => import("./google-vertex-HZ_0rTwS.mjs"), (module) => ({
+	createLazyRegistration("google-vertex", () => import("./google-vertex-B4SD3U0f.mjs"), (module) => ({
 		stream: module.streamGoogleVertex,
 		streamSimple: module.streamSimpleGoogleVertex
 	}))

package/dist/{stream-first-event-timeout-RjWszj8c.mjs → stream-first-event-timeout-DP4xEyBY.mjs}

@@ -3,6 +3,40 @@
 function asFiniteNumber(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
+/** Returns a finite number only when it satisfies the supplied inclusive/exclusive bounds. */
+function asFiniteNumberInRange(value, range) {
+	const number = asFiniteNumber(value);
+	if (number === void 0) return;
+	if (range.min !== void 0) {
+		if (range.minExclusive ? number <= range.min : number < range.min) return;
+	}
+	if (range.max !== void 0) {
+		if (range.maxExclusive ? number >= range.max : number > range.max) return;
+	}
+	return number;
+}
+function normalizeNumericString(value) {
+	const trimmed = value.trim();
+	return trimmed ? trimmed : void 0;
+}
+/** Parses only safe integer numbers or base-10 integer strings. */
+function parseStrictInteger(value) {
+	if (typeof value === "number") return Number.isSafeInteger(value) ? value : void 0;
+	if (typeof value !== "string") return;
+	const normalized = normalizeNumericString(value);
+	if (!normalized || !/^[+-]?\d+$/.test(normalized)) return;
+	const parsed = Number(normalized);
+	return Number.isSafeInteger(parsed) ? parsed : void 0;
+}
+/** Parses only finite decimal/scientific string tokens, rejecting partial numbers. */
+function parseStrictFiniteNumber(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+	if (typeof value !== "string") return;
+	const normalized = normalizeNumericString(value);
+	if (!normalized || !/^[+-]?(?:(?:\d+\.?\d*)|(?:\.\d+))(?:e[+-]?\d+)?$/i.test(normalized)) return;
+	const parsed = Number(normalized);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
 /** Conservative upper bound for Node timer delays. */
 const MAX_TIMER_TIMEOUT_MS = 2147e6;
 /** Clamps finite millisecond values into the Node-safe timer range. */
@@ -18,6 +52,16 @@ function resolveTimerTimeoutMs(valueMs, fallbackMs, minMs = 1) {
 	if (value === void 0) return min;
 	return Math.min(Math.max(Math.floor(value), min), MAX_TIMER_TIMEOUT_MS);
 }
+/** Parses strict positive integer values from numbers or strings. */
+function parseStrictPositiveInteger(value) {
+	const parsed = parseStrictInteger(value);
+	return parsed !== void 0 && parsed > 0 ? parsed : void 0;
+}
+/** Parses strict non-negative integer values from numbers or strings. */
+function parseStrictNonNegativeInteger(value) {
+	const parsed = parseStrictInteger(value);
+	return parsed !== void 0 && parsed >= 0 ? parsed : void 0;
+}
 //#endregion
 //#region packages/ai/src/utils/stream-first-event-timeout.ts
 function getFirstStreamEventTimeoutMs(options) {
@@ -103,4 +147,4 @@ function withFirstStreamEventTimeout(stream, context) {
 	} };
 }
 //#endregion
-export { withFirstStreamEventTimeout as a, getFirstStreamEventTimeoutMs as i, createFirstStreamEventTimeoutError as n, clampTimerTimeoutMs as o, getFirstStreamEventTimeoutHandler as r, resolveTimerTimeoutMs as s, createFirstStreamEventAbortController as t };
+export { withFirstStreamEventTimeout as a, parseStrictFiniteNumber as c, resolveTimerTimeoutMs as d, getFirstStreamEventTimeoutMs as i, parseStrictNonNegativeInteger as l, createFirstStreamEventTimeoutError as n, asFiniteNumberInRange as o, getFirstStreamEventTimeoutHandler as r, clampTimerTimeoutMs as s, createFirstStreamEventAbortController as t, parseStrictPositiveInteger as u };

package/dist/{transform-messages-BmS70CP5.mjs → system-prompt-cache-boundary-CbHeV4_l.mjs}

@@ -1,164 +1,6 @@
 import { a as resolveClaudeFable5ModelIdentity, i as requiresClaudeMandatoryAdaptiveThinking, l as resolveClaudeSonnet5ModelIdentity, r as requiresClaudeDefaultSampling, s as resolveClaudeMythos5ModelIdentity } from "./src-CXno1H5g.mjs";
-import { n as getAiTransportHost } from "./host-4t713IeR.mjs";
+import { n as getAiTransportHost } from "./host-XYGZcgO8.mjs";
 import { t as sanitizeSurrogates } from "./sanitize-unicode-DT5o51ur.mjs";
-//#region packages/normalization-core/src/string-coerce.ts
-/** Trims string input and returns null for non-strings or empty strings. */
-function normalizeNullableString(value) {
-	if (typeof value !== "string") return null;
-	const trimmed = value.trim();
-	return trimmed ? trimmed : null;
-}
-/** Trims string input and returns undefined for non-strings or empty strings. */
-function normalizeOptionalString(value) {
-	return normalizeNullableString(value) ?? void 0;
-}
-/** Lowercases a normalized optional string. */
-function normalizeOptionalLowercaseString(value) {
-	return normalizeOptionalString(value)?.toLowerCase();
-}
-/** Lowercases a normalized string or returns an empty string when absent. */
-function normalizeLowercaseStringOrEmpty(value) {
-	return normalizeOptionalLowercaseString(value) ?? "";
-}
-//#endregion
-//#region packages/ai/src/utils/prompt-cache-stability.ts
-/**
-* Prompt-cache normalization helpers. They keep generated prompt sections
-* deterministic across platform newlines, trailing whitespace, and input
-* ordering.
-*/
-/** Normalize structured prompt text before hashing or snapshot comparison. */
-function normalizeStructuredPromptSection(text) {
-	return sanitizeSurrogates(text).replace(/\r\n?/g, "\n").replace(/[ \t]+$/gm, "").trim();
-}
-/** Normalize, de-dupe, and sort capability ids for stable prompt payloads. */
-function normalizePromptCapabilityIds(capabilities) {
-	const seen = /* @__PURE__ */ new Set();
-	const normalized = [];
-	for (const capability of capabilities) {
-		const value = normalizeLowercaseStringOrEmpty(normalizeStructuredPromptSection(capability));
-		if (!value || seen.has(value)) continue;
-		seen.add(value);
-		normalized.push(value);
-	}
-	return normalized.toSorted((left, right) => left.localeCompare(right));
-}
-//#endregion
-//#region packages/ai/src/utils/system-prompt-cache-boundary.ts
-/**
-* System prompt cache-boundary helpers.
-*
-* Keeps stable prompt prefixes separate from dynamic runtime additions for provider prompt caching.
-*/
-const SYSTEM_PROMPT_CACHE_BOUNDARY = "\n<!-- OPENCLAW_CACHE_BOUNDARY -->\n";
-function stripSystemPromptCacheBoundary(text) {
-	return text.replaceAll(SYSTEM_PROMPT_CACHE_BOUNDARY, "\n");
-}
-function ensureSystemPromptCacheBoundary(systemPrompt) {
-	if (systemPrompt.trim().length === 0) return systemPrompt;
-	return systemPrompt.includes("\n<!-- OPENCLAW_CACHE_BOUNDARY -->\n") ? systemPrompt : `${systemPrompt}${SYSTEM_PROMPT_CACHE_BOUNDARY}`;
-}
-function splitSystemPromptCacheBoundary(text) {
-	const boundaryIndex = text.indexOf(SYSTEM_PROMPT_CACHE_BOUNDARY);
-	if (boundaryIndex === -1) return;
-	return {
-		stablePrefix: text.slice(0, boundaryIndex).trimEnd(),
-		dynamicSuffix: text.slice(boundaryIndex + 34).trimStart()
-	};
-}
-function prependSystemPromptAdditionAfterCacheBoundary(params) {
-	const systemPromptAddition = typeof params.systemPromptAddition === "string" ? normalizeStructuredPromptSection(params.systemPromptAddition) : "";
-	if (!systemPromptAddition) return params.systemPrompt;
-	if (params.systemPrompt.trim().length === 0) return systemPromptAddition;
-	const split = splitSystemPromptCacheBoundary(params.systemPrompt);
-	if (!split) return `${systemPromptAddition}\n\n${params.systemPrompt}`;
-	const dynamicSuffix = split.dynamicSuffix ? normalizeStructuredPromptSection(split.dynamicSuffix) : "";
-	if (!dynamicSuffix) return `${split.stablePrefix}${SYSTEM_PROMPT_CACHE_BOUNDARY}${systemPromptAddition}`;
-	return `${split.stablePrefix}${SYSTEM_PROMPT_CACHE_BOUNDARY}${systemPromptAddition}\n\n${dynamicSuffix}`;
-}
-//#endregion
-//#region packages/ai/src/providers/anthropic-model-contract.ts
-function normalizeModelId(modelId) {
-	const normalized = normalizeLowercaseStringOrEmpty(modelId);
-	return (normalized.startsWith("anthropic/") ? normalized.slice(10) : normalized).replace(/[._\s]+/g, "-");
-}
-function normalizeApi(api) {
-	const normalized = normalizeLowercaseStringOrEmpty(api);
-	return normalized === "openclaw-anthropic-messages-transport" ? "anthropic-messages" : normalized;
-}
-function hasConcreteResponseModel(ref) {
-	const responseModelId = normalizeModelId(ref.responseModelId);
-	return responseModelId.length > 0 && responseModelId !== normalizeModelId(ref.modelId);
-}
-function usesClaudeFable5MessagesContract(model) {
-	return normalizeApi(model.api) === "anthropic-messages" && resolveClaudeFable5ModelIdentity(model) !== void 0;
-}
-/** Return whether streamed output must wait for the terminal refusal decision. */
-function usesClaudeStreamingRefusalContract(model) {
-	if (normalizeApi(model.api) !== "anthropic-messages") return false;
-	return resolveClaudeFable5ModelIdentity(model) !== void 0 || resolveClaudeMythos5ModelIdentity(model) !== void 0 || resolveClaudeSonnet5ModelIdentity(model) !== void 0;
-}
-function requiresClaudeAdaptiveThinking(model) {
-	if (normalizeApi(model.api) !== "anthropic-messages") return false;
-	return requiresClaudeMandatoryAdaptiveThinking(model);
-}
-/** Return whether omitted thinking should default to adaptive/high. */
-function defaultsClaudeAdaptiveThinking(model) {
-	return requiresClaudeAdaptiveThinking(model) || normalizeApi(model.api) === "anthropic-messages" && resolveClaudeSonnet5ModelIdentity(model) !== void 0;
-}
-/** Remove Sonnet 5 assistant prefills while preserving completed tool-use turns. */
-function prepareClaudeSonnet5RequestContext(model, context) {
-	if (!resolveClaudeSonnet5ModelIdentity(model)) return context;
-	let end = context.messages.length;
-	while (end > 0) {
-		const message = context.messages[end - 1];
-		if (message?.role !== "assistant" || Array.isArray(message.content) && message.content.some((block) => block.type === "toolCall")) break;
-		end -= 1;
-	}
-	return end === context.messages.length ? context : {
-		...context,
-		messages: context.messages.slice(0, end)
-	};
-}
-function applyClaudeRequestContract(params, model) {
-	if (normalizeApi(model.api) !== "anthropic-messages") return;
-	const sonnet5 = resolveClaudeSonnet5ModelIdentity(model) !== void 0;
-	if (!requiresClaudeDefaultSampling(model) && !sonnet5) return;
-	delete params.temperature;
-	delete params.top_p;
-	delete params.top_k;
-	if (sonnet5) delete params.service_tier;
-}
-function resolveReplayModelBoundIdentity(ref) {
-	if (normalizeApi(ref.api) !== "anthropic-messages") return;
-	const modelRef = hasConcreteResponseModel(ref) ? { id: ref.responseModelId } : {
-		id: ref.modelId,
-		params: ref.modelParams
-	};
-	const fableIdentity = resolveClaudeFable5ModelIdentity(modelRef);
-	if (fableIdentity) return `fable:${fableIdentity}`;
-	const mythosIdentity = resolveClaudeMythos5ModelIdentity(modelRef);
-	if (mythosIdentity) return `mythos:${mythosIdentity}`;
-	const sonnetIdentity = resolveClaudeSonnet5ModelIdentity(modelRef);
-	return sonnetIdentity ? `sonnet:${sonnetIdentity}` : void 0;
-}
-function resolveModelBoundThinkingReplayMode(params) {
-	const sourceApi = normalizeApi(params.source.api);
-	const targetApi = normalizeApi(params.target.api);
-	const sourceIdentity = resolveReplayModelBoundIdentity(params.source);
-	const targetIdentity = resolveReplayModelBoundIdentity(params.target);
-	const sameRoute = normalizeLowercaseStringOrEmpty(params.source.provider) === normalizeLowercaseStringOrEmpty(params.target.provider) && sourceApi === targetApi && normalizeModelId(params.source.modelId) === normalizeModelId(params.target.modelId);
-	if (!sourceIdentity && !targetIdentity) return "default";
-	if (!sourceIdentity && !hasConcreteResponseModel(params.source) && targetIdentity && sameRoute) return "preserve";
-	return sourceApi === targetApi && sourceIdentity === targetIdentity ? "preserve" : "drop";
-}
-//#endregion
-//#region packages/normalization-core/src/record-coerce.ts
-/** Type guard for non-array object records at browser-safe boundaries. */
-function isRecord(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-//#endregion
 //#region packages/ai/src/providers/simple-options.ts
 function buildBaseOptions(model, options, apiKey) {
 	const firstEventOptions = options;
@@ -183,6 +25,9 @@ function buildBaseOptions(model, options, apiKey) {
 		metadata: options?.metadata
 	};
 }
+function clampMaxTokensToModel(model, requestedMaxTokens) {
+	return requestedMaxTokens === void 0 ? void 0 : Math.max(1, Math.min(requestedMaxTokens, model.maxTokens));
+}
 function clampReasoning(effort) {
 	return effort === "xhigh" ? "high" : effort;
 }
@@ -205,6 +50,12 @@ function adjustMaxTokensForThinking(baseMaxTokens, modelMaxTokens, reasoningLeve
 	};
 }
 //#endregion
+//#region packages/normalization-core/src/record-coerce.ts
+/** Type guard for non-array object records at browser-safe boundaries. */
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//#endregion
 //#region packages/normalization-core/src/utf16-slice.ts
 function isHighSurrogate(codeUnit) {
 	return codeUnit >= 55296 && codeUnit <= 56319;
@@ -362,6 +213,106 @@ function extractToolResultText(blocks) {
 	return sanitizeSurrogates(truncateProviderToolText(structuredTexts.join("\n")));
 }
 //#endregion
+//#region packages/normalization-core/src/string-coerce.ts
+/** Reads a value only when it is already a string, preserving whitespace. */
+function readStringValue(value) {
+	return typeof value === "string" ? value : void 0;
+}
+/** Trims string input and returns null for non-strings or empty strings. */
+function normalizeNullableString(value) {
+	if (typeof value !== "string") return null;
+	const trimmed = value.trim();
+	return trimmed ? trimmed : null;
+}
+/** Trims string input and returns undefined for non-strings or empty strings. */
+function normalizeOptionalString(value) {
+	return normalizeNullableString(value) ?? void 0;
+}
+/** Lowercases a normalized optional string. */
+function normalizeOptionalLowercaseString(value) {
+	return normalizeOptionalString(value)?.toLowerCase();
+}
+/** Lowercases a normalized string or returns an empty string when absent. */
+function normalizeLowercaseStringOrEmpty(value) {
+	return normalizeOptionalLowercaseString(value) ?? "";
+}
+//#endregion
+//#region packages/ai/src/providers/anthropic-model-contract.ts
+function normalizeModelId(modelId) {
+	const normalized = normalizeLowercaseStringOrEmpty(modelId);
+	return (normalized.startsWith("anthropic/") ? normalized.slice(10) : normalized).replace(/[._\s]+/g, "-");
+}
+function normalizeApi(api) {
+	const normalized = normalizeLowercaseStringOrEmpty(api);
+	return normalized === "openclaw-anthropic-messages-transport" ? "anthropic-messages" : normalized;
+}
+function hasConcreteResponseModel(ref) {
+	const responseModelId = normalizeModelId(ref.responseModelId);
+	return responseModelId.length > 0 && responseModelId !== normalizeModelId(ref.modelId);
+}
+function usesClaudeFable5MessagesContract(model) {
+	return normalizeApi(model.api) === "anthropic-messages" && resolveClaudeFable5ModelIdentity(model) !== void 0;
+}
+/** Return whether streamed output must wait for the terminal refusal decision. */
+function usesClaudeStreamingRefusalContract(model) {
+	if (normalizeApi(model.api) !== "anthropic-messages") return false;
+	return resolveClaudeFable5ModelIdentity(model) !== void 0 || resolveClaudeMythos5ModelIdentity(model) !== void 0 || resolveClaudeSonnet5ModelIdentity(model) !== void 0;
+}
+function requiresClaudeAdaptiveThinking(model) {
+	if (normalizeApi(model.api) !== "anthropic-messages") return false;
+	return requiresClaudeMandatoryAdaptiveThinking(model);
+}
+/** Return whether omitted thinking should default to adaptive/high. */
+function defaultsClaudeAdaptiveThinking(model) {
+	return requiresClaudeAdaptiveThinking(model) || normalizeApi(model.api) === "anthropic-messages" && resolveClaudeSonnet5ModelIdentity(model) !== void 0;
+}
+/** Remove Sonnet 5 assistant prefills while preserving completed tool-use turns. */
+function prepareClaudeSonnet5RequestContext(model, context) {
+	if (!resolveClaudeSonnet5ModelIdentity(model)) return context;
+	let end = context.messages.length;
+	while (end > 0) {
+		const message = context.messages[end - 1];
+		if (message?.role !== "assistant" || Array.isArray(message.content) && message.content.some((block) => block.type === "toolCall")) break;
+		end -= 1;
+	}
+	return end === context.messages.length ? context : {
+		...context,
+		messages: context.messages.slice(0, end)
+	};
+}
+function applyClaudeRequestContract(params, model) {
+	if (normalizeApi(model.api) !== "anthropic-messages") return;
+	const sonnet5 = resolveClaudeSonnet5ModelIdentity(model) !== void 0;
+	if (!requiresClaudeDefaultSampling(model) && !sonnet5) return;
+	delete params.temperature;
+	delete params.top_p;
+	delete params.top_k;
+	if (sonnet5) delete params.service_tier;
+}
+function resolveReplayModelBoundIdentity(ref) {
+	if (normalizeApi(ref.api) !== "anthropic-messages") return;
+	const modelRef = hasConcreteResponseModel(ref) ? { id: ref.responseModelId } : {
+		id: ref.modelId,
+		params: ref.modelParams
+	};
+	const fableIdentity = resolveClaudeFable5ModelIdentity(modelRef);
+	if (fableIdentity) return `fable:${fableIdentity}`;
+	const mythosIdentity = resolveClaudeMythos5ModelIdentity(modelRef);
+	if (mythosIdentity) return `mythos:${mythosIdentity}`;
+	const sonnetIdentity = resolveClaudeSonnet5ModelIdentity(modelRef);
+	return sonnetIdentity ? `sonnet:${sonnetIdentity}` : void 0;
+}
+function resolveModelBoundThinkingReplayMode(params) {
+	const sourceApi = normalizeApi(params.source.api);
+	const targetApi = normalizeApi(params.target.api);
+	const sourceIdentity = resolveReplayModelBoundIdentity(params.source);
+	const targetIdentity = resolveReplayModelBoundIdentity(params.target);
+	const sameRoute = normalizeLowercaseStringOrEmpty(params.source.provider) === normalizeLowercaseStringOrEmpty(params.target.provider) && sourceApi === targetApi && normalizeModelId(params.source.modelId) === normalizeModelId(params.target.modelId);
+	if (!sourceIdentity && !targetIdentity) return "default";
+	if (!sourceIdentity && !hasConcreteResponseModel(params.source) && targetIdentity && sameRoute) return "preserve";
+	return sourceApi === targetApi && sourceIdentity === targetIdentity ? "preserve" : "drop";
+}
+//#endregion
 //#region packages/ai/src/providers/transform-messages.ts
 const NON_VISION_USER_IMAGE_PLACEHOLDER = "(image omitted: model does not support images)";
 const NON_VISION_TOOL_IMAGE_PLACEHOLDER = "(tool image omitted: model does not support images)";
@@ -404,7 +355,10 @@ function downgradeUnsupportedImages(messages, model) {
 */
 function transformMessages(messages, model, normalizeToolCallId) {
 	const toolCallIdMap = /* @__PURE__ */ new Map();
-	const transformed = downgradeUnsupportedImages(messages, model).map((msg) => {
+	const transformed = downgradeUnsupportedImages(messages.map((msg) => msg.content == null ? {
+		...msg,
+		content: []
+	} : msg), model).map((msg) => {
 		if (msg.role === "user") return msg;
 		if (msg.role === "toolResult") {
 			const normalizedId = toolCallIdMap.get(msg.toolCallId);
@@ -513,4 +467,60 @@ function transformMessages(messages, model, normalizeToolCallId) {
 	return result;
 }
 //#endregion
-export { stripSystemPromptCacheBoundary as C, normalizeOptionalString as D, normalizeLowercaseStringOrEmpty as E, splitSystemPromptCacheBoundary as S, normalizeStructuredPromptSection as T, usesClaudeFable5MessagesContract as _, hasMediaPayload as a, ensureSystemPromptCacheBoundary as b, adjustMaxTokensForThinking as c, isRecord as d, applyClaudeRequestContract as f, resolveModelBoundThinkingReplayMode as g, requiresClaudeAdaptiveThinking as h, extractToolResultText as i, buildBaseOptions as l, prepareClaudeSonnet5RequestContext as m, describeToolResultMediaPlaceholder as n, isImageWithMediaPayload as o, defaultsClaudeAdaptiveThinking as p, extractToolResultBlockText as r, truncateUtf16Safe as s, transformMessages as t, clampReasoning as u, usesClaudeStreamingRefusalContract as v, normalizePromptCapabilityIds as w, prependSystemPromptAdditionAfterCacheBoundary as x, SYSTEM_PROMPT_CACHE_BOUNDARY as y };
+//#region packages/ai/src/utils/prompt-cache-stability.ts
+/**
+* Prompt-cache normalization helpers. They keep generated prompt sections
+* deterministic across platform newlines, trailing whitespace, and input
+* ordering.
+*/
+/** Normalize structured prompt text before hashing or snapshot comparison. */
+function normalizeStructuredPromptSection(text) {
+	return sanitizeSurrogates(text).replace(/\r\n?/g, "\n").replace(/[ \t]+$/gm, "").trim();
+}
+/** Normalize, de-dupe, and sort capability ids for stable prompt payloads. */
+function normalizePromptCapabilityIds(capabilities) {
+	const seen = /* @__PURE__ */ new Set();
+	const normalized = [];
+	for (const capability of capabilities) {
+		const value = normalizeLowercaseStringOrEmpty(normalizeStructuredPromptSection(capability));
+		if (!value || seen.has(value)) continue;
+		seen.add(value);
+		normalized.push(value);
+	}
+	return normalized.toSorted((left, right) => left.localeCompare(right));
+}
+//#endregion
+//#region packages/ai/src/utils/system-prompt-cache-boundary.ts
+/**
+* System prompt cache-boundary helpers.
+*
+* Keeps stable prompt prefixes separate from dynamic runtime additions for provider prompt caching.
+*/
+const SYSTEM_PROMPT_CACHE_BOUNDARY = "\n<!-- OPENCLAW_CACHE_BOUNDARY -->\n";
+function stripSystemPromptCacheBoundary(text) {
+	return text.replaceAll(SYSTEM_PROMPT_CACHE_BOUNDARY, "\n");
+}
+function ensureSystemPromptCacheBoundary(systemPrompt) {
+	if (systemPrompt.trim().length === 0) return systemPrompt;
+	return systemPrompt.includes("\n<!-- OPENCLAW_CACHE_BOUNDARY -->\n") ? systemPrompt : `${systemPrompt}${SYSTEM_PROMPT_CACHE_BOUNDARY}`;
+}
+function splitSystemPromptCacheBoundary(text) {
+	const boundaryIndex = text.indexOf(SYSTEM_PROMPT_CACHE_BOUNDARY);
+	if (boundaryIndex === -1) return;
+	return {
+		stablePrefix: text.slice(0, boundaryIndex).trimEnd(),
+		dynamicSuffix: text.slice(boundaryIndex + 34).trimStart()
+	};
+}
+function prependSystemPromptAdditionAfterCacheBoundary(params) {
+	const systemPromptAddition = typeof params.systemPromptAddition === "string" ? normalizeStructuredPromptSection(params.systemPromptAddition) : "";
+	if (!systemPromptAddition) return params.systemPrompt;
+	if (params.systemPrompt.trim().length === 0) return systemPromptAddition;
+	const split = splitSystemPromptCacheBoundary(params.systemPrompt);
+	if (!split) return `${systemPromptAddition}\n\n${params.systemPrompt}`;
+	const dynamicSuffix = split.dynamicSuffix ? normalizeStructuredPromptSection(split.dynamicSuffix) : "";
+	if (!dynamicSuffix) return `${split.stablePrefix}${SYSTEM_PROMPT_CACHE_BOUNDARY}${systemPromptAddition}`;
+	return `${split.stablePrefix}${SYSTEM_PROMPT_CACHE_BOUNDARY}${systemPromptAddition}\n\n${dynamicSuffix}`;
+}
+//#endregion
+export { isImageWithMediaPayload as C, buildBaseOptions as D, adjustMaxTokensForThinking as E, clampMaxTokensToModel as O, hasMediaPayload as S, isRecord as T, normalizeOptionalString as _, stripSystemPromptCacheBoundary as a, extractToolResultBlockText as b, transformMessages as c, prepareClaudeSonnet5RequestContext as d, requiresClaudeAdaptiveThinking as f, normalizeLowercaseStringOrEmpty as g, usesClaudeStreamingRefusalContract as h, splitSystemPromptCacheBoundary as i, clampReasoning as k, applyClaudeRequestContract as l, usesClaudeFable5MessagesContract as m, ensureSystemPromptCacheBoundary as n, normalizePromptCapabilityIds as o, resolveModelBoundThinkingReplayMode as p, prependSystemPromptAdditionAfterCacheBoundary as r, normalizeStructuredPromptSection as s, SYSTEM_PROMPT_CACHE_BOUNDARY as t, defaultsClaudeAdaptiveThinking as u, readStringValue as v, truncateUtf16Safe as w, extractToolResultText as x, describeToolResultMediaPlaceholder as y };