@openclaw/ai 2026.7.2-beta.3 → 2026.7.2-beta.5

package/README.md

@@ -14,15 +14,16 @@ registerBuiltInApiProviders(runtime.registry);
 
 Provider-neutral contracts, validation, diagnostics, and event streams are
 available from the package root and focused subpaths such as
-`@openclaw/ai/event-stream` and `@openclaw/ai/validation`. No second OpenClaw
-runtime package is required.
+`@openclaw/ai/event-stream`, `@openclaw/ai/transports`, and
+`@openclaw/ai/validation`. No second OpenClaw runtime package is required.
 
 Provider ids, credentials, model catalogs, retries, and failover remain
 application concerns. OpenClaw supplies those policies around this package.
 Host policy (request fetch guarding, secret redaction, strict-tool defaults,
-diagnostics logging) can be injected with `configureAiTransportHost`; the
-defaults are inert.
+provider plugin hooks, and diagnostics logging) can be injected with
+`configureAiTransportHost`; the defaults are inert.
 
-`@openclaw/ai/internal/*` subpaths exist for the OpenClaw application itself.
+The explicit `@openclaw/ai/internal/anthropic`, `openai`, `retry-after`,
+`runtime`, and `shared` subpaths exist for the OpenClaw application itself.
 They carry no semver guarantee and can change or disappear in any release; do
 not depend on them outside OpenClaw.

package/dist/{anthropic-D7SyZQ5v.mjs → anthropic-CQVj3le6.mjs}

@@ -1,17 +1,129 @@
-import { n as getEnvApiKey, r as __exportAll } from "./env-api-keys-DnhYpc27.mjs";
-import { c as resolveClaudeNativeThinkingLevelMap, d as supportsClaudeNativeMaxEffort, f as supportsClaudeNativeXhighEffort, l as resolveClaudeSonnet5ModelIdentity, u as supportsClaudeAdaptiveThinking } from "./src-CXno1H5g.mjs";
+import { n as getEnvApiKey, r as __exportAll } from "./env-api-keys-DrgeBuva.mjs";
+import { d as resolveClaudeSonnet5ModelIdentity, g as supportsClaudeNativeXhighEffort, h as supportsClaudeNativeMaxEffort, l as resolveClaudeNativeThinkingLevelMap, o as resolveClaudeFable5ModelIdentity, p as supportsClaudeAdaptiveThinking, s as resolveClaudeModelIdentity, u as resolveClaudeOpus5ModelIdentity } from "./src-QkygScBs.mjs";
 import { t as AssistantMessageEventStream } from "./event-stream-D8n2uFee.mjs";
-import { n as getAiTransportHost, r as resolveAiTransportHeaderSentinels } from "./host-4t713IeR.mjs";
-import { n as calculateCost, r as clampThinkingLevel } from "./model-utils-1GiZ2_rr.mjs";
+import { n as getAiTransportHost, r as resolveAiTransportHeaderSentinels } from "./host-XYGZcgO8.mjs";
+import { A as buildBaseOptions, C as extractToolResultBlockText, E as isImageWithMediaPayload, O as isRecord, S as describeToolResultMediaPlaceholder, _ as usesClaudeStreamingRefusalContract, a as splitSystemPromptCacheBoundary, d as applyClaudeRequestContract, g as usesClaudeFable5MessagesContract, j as clampMaxTokensToModel, k as adjustMaxTokensForThinking, l as sortPromptCacheToolsByName, m as requiresClaudeAdaptiveThinking, o as stripSystemPromptCacheBoundary, p as prepareClaudeNoPrefillRequestContext, u as transformMessages, w as extractToolResultText } from "./shared-CdjNZd35.mjs";
+import { t as sanitizeSurrogates } from "./sanitize-unicode-DT5o51ur.mjs";
+import { c as calculateCost, l as clampThinkingLevel } from "./number-coercion-DvG7SNMg.mjs";
+import { d as transportAbortError } from "./transport-stream-shared-BbMELSI4.mjs";
 import { r as createDeferredEventBuffer, t as notifyLlmRequestActivity } from "./llm-request-activity-CehVkZP-.mjs";
 import { t as headersToRecord } from "./headers-B_e4-1J0.mjs";
 import { n as parseStreamingJson, t as parseJsonWithRepair } from "./json-parse-BvXNt1-7.mjs";
-import { t as sanitizeSurrogates } from "./sanitize-unicode-DT5o51ur.mjs";
-import { C as splitSystemPromptCacheBoundary, c as adjustMaxTokensForThinking, f as isRecord, g as requiresClaudeAdaptiveThinking, h as prepareClaudeSonnet5RequestContext, i as extractToolResultText, l as buildBaseOptions, n as describeToolResultMediaPlaceholder, o as isImageWithMediaPayload, p as applyClaudeRequestContract, r as extractToolResultBlockText, t as transformMessages, u as clampMaxTokensToModel, v as usesClaudeFable5MessagesContract, w as stripSystemPromptCacheBoundary, y as usesClaudeStreamingRefusalContract } from "./transform-messages-eb6lxDLB.mjs";
-import { t as projectRuntimeToolInputSchema } from "./tool-schema-json-projection-BwNu3nDi.mjs";
-import { a as resolveCacheRetention, i as resolveCloudflareBaseUrl, n as hasCopilotVisionInput, t as buildCopilotDynamicHeaders } from "./github-copilot-headers-BsH5cqGj.mjs";
+import { t as formatProviderError } from "./provider-error-apVOZI6G.mjs";
+import { a as resolveCacheRetention, i as resolveCloudflareBaseUrl, n as hasCopilotVisionInput, o as projectRuntimeToolInputSchema, t as buildCopilotDynamicHeaders } from "./github-copilot-headers-BCoBNmL7.mjs";
 import Anthropic from "@anthropic-ai/sdk";
 import { Stream } from "@anthropic-ai/sdk/core/streaming.js";
+//#region packages/media-core/src/base64.ts
+/** Estimates decoded bytes without allocating a cleaned copy of the base64 payload. */
+function estimateBase64DecodedBytes(base64) {
+	let effectiveLen = 0;
+	for (let i = 0; i < base64.length; i += 1) {
+		if (base64.charCodeAt(i) <= 32) continue;
+		effectiveLen += 1;
+	}
+	if (effectiveLen === 0) return 0;
+	let padding = 0;
+	let end = base64.length - 1;
+	while (end >= 0 && base64.charCodeAt(end) <= 32) end -= 1;
+	if (end >= 0 && base64[end] === "=") {
+		padding = 1;
+		end -= 1;
+		while (end >= 0 && base64.charCodeAt(end) <= 32) end -= 1;
+		if (end >= 0 && base64[end] === "=") padding = 2;
+	}
+	const estimated = Math.floor(effectiveLen * 3 / 4) - padding;
+	return Math.max(0, estimated);
+}
+const CANONICALIZE_BASE64_CHUNK_SIZE = 8192;
+function isBase64DataChar(code) {
+	return code >= 65 && code <= 90 || code >= 97 && code <= 122 || code >= 48 && code <= 57 || code === 43 || code === 47;
+}
+function base64DataValue(code) {
+	if (code >= 65 && code <= 90) return code - 65;
+	if (code >= 97 && code <= 122) return code - 97 + 26;
+	if (code >= 48 && code <= 57) return code - 48 + 52;
+	return code === 43 ? 62 : 63;
+}
+/**
+* Normalizes and validates a base64 string, returning canonical no-whitespace
+* base64 only when the input has valid alphabet, padding, and length.
+*/
+function canonicalizeBase64(base64) {
+	const chunks = [];
+	let current = "";
+	let cleanedLength = 0;
+	let padding = 0;
+	let sawPadding = false;
+	let lastDataCode = 0;
+	const append = (char) => {
+		current += char;
+		cleanedLength += 1;
+		if (current.length >= CANONICALIZE_BASE64_CHUNK_SIZE) {
+			chunks.push(current);
+			current = "";
+		}
+	};
+	for (let i = 0; i < base64.length; i += 1) {
+		const code = base64.charCodeAt(i);
+		if (code <= 32) continue;
+		if (code === 61) {
+			padding += 1;
+			if (padding > 2) return;
+			sawPadding = true;
+			append("=");
+			continue;
+		}
+		if (sawPadding || !isBase64DataChar(code)) return;
+		lastDataCode = code;
+		append(base64[i] ?? "");
+	}
+	if (cleanedLength === 0) return;
+	const remainder = cleanedLength % 4;
+	if (remainder !== 0) {
+		if (sawPadding || remainder === 1) return;
+		current += "=".repeat(4 - remainder);
+	}
+	const effectivePadding = remainder === 0 ? padding : 4 - remainder;
+	const padBitMask = effectivePadding === 2 ? 15 : effectivePadding === 1 ? 3 : 0;
+	if (padBitMask !== 0 && (base64DataValue(lastDataCode) & padBitMask) !== 0) return;
+	if (current) chunks.push(current);
+	return chunks.join("");
+}
+//#endregion
+//#region packages/ai/src/internal/anthropic-inline-images.ts
+const ANTHROPIC_IMAGE_MEDIA_TYPE_SET = /* @__PURE__ */ new Set([
+	"image/jpeg",
+	"image/png",
+	"image/gif",
+	"image/webp"
+]);
+const ANTHROPIC_INLINE_IMAGES_DECODE_SAFETY_BYTES = 64 * 1024 * 1024;
+function createAnthropicInlineImageBudget() {
+	return { totalBytes: 0 };
+}
+function resolveAnthropicImageMediaType(value) {
+	if (ANTHROPIC_IMAGE_MEDIA_TYPE_SET.has(value)) return value;
+	throw new Error(`Unsupported Anthropic image media type after normalization: ${value}`);
+}
+async function normalizeAnthropicInlineContent(content, budget) {
+	if (!content.some((block) => block.type === "image")) return content.filter((block) => block.type === "text");
+	const inputBytes = content.reduce((total, block) => block.type === "image" ? total + estimateBase64DecodedBytes(block.data) : total, 0);
+	if (budget.totalBytes + inputBytes > ANTHROPIC_INLINE_IMAGES_DECODE_SAFETY_BYTES) throw new Error("Anthropic inline images exceed the 64 MB aggregate decoded safety limit.");
+	const normalized = [];
+	for (const block of content) {
+		if (block.type !== "image") {
+			normalized.push(block);
+			continue;
+		}
+		const normalizedBlocks = await getAiTransportHost().normalizeAnthropicInlineContentBlocks([block]);
+		const outputBytes = normalizedBlocks.reduce((total, normalizedBlock) => normalizedBlock.type === "image" ? total + estimateBase64DecodedBytes(normalizedBlock.data) : total, 0);
+		if (budget.totalBytes + outputBytes > ANTHROPIC_INLINE_IMAGES_DECODE_SAFETY_BYTES) throw new Error("Anthropic inline images exceed the 64 MB aggregate decoded safety limit.");
+		budget.totalBytes += outputBytes;
+		normalized.push(...normalizedBlocks);
+	}
+	return normalized;
+}
+//#endregion
 //#region packages/ai/src/providers/anthropic-auth-headers.ts
 function usesFoundryBearerAuth(model) {
 	return model.provider === "microsoft-foundry" && (model.authHeader === true || hasBearerAuthorizationHeader(model.headers));
@@ -66,16 +178,34 @@ function applyAnthropicRefusal(output, stopDetails, provider) {
 //#endregion
 //#region packages/ai/src/providers/anthropic-server-fallback.ts
 /** Anthropic beta that re-serves safety refusals on an allowed fallback model. */
-const ANTHROPIC_SERVER_SIDE_FALLBACK_BETA = "server-side-fallback-2026-06-01";
-const CLAUDE_FABLE_5_FALLBACK_MODEL = "claude-opus-4-8";
-const CLAUDE_FABLE_5_FALLBACK_MODEL_COST = {
+const ANTHROPIC_SERVER_SIDE_FALLBACK_BETA = "server-side-fallback-2026-07-01";
+/** Let Anthropic select the recommended model for each refusal category. */
+const ANTHROPIC_SERVER_SIDE_FALLBACKS = "default";
+const CLAUDE_OPUS_FALLBACK_MODEL_COST = {
 	input: 5,
 	output: 25,
 	cacheRead: .5,
 	cacheWrite: 6.25
 };
-function buildAnthropicServerSideFallbacks() {
-	return [{ model: CLAUDE_FABLE_5_FALLBACK_MODEL }];
+function resolveFallbackModelIdentity(modelId) {
+	if (!modelId?.trim()) return null;
+	const ref = { id: modelId };
+	const normalized = resolveClaudeModelIdentity(ref);
+	if (normalized === "opus" || normalized === "opus-5" || resolveClaudeOpus5ModelIdentity(ref)) return "claude-opus-5";
+	if (resolveClaudeFable5ModelIdentity(ref)) return "claude-fable-5";
+	if (/^claude-opus-4-8(?=$|[^a-z0-9])/.test(normalized)) return "claude-opus-4-8";
+	return normalized || null;
+}
+function isClaudeOpusFallbackModel(modelId) {
+	return modelId === "claude-opus-5" || modelId === "claude-opus-4-8";
+}
+/** Resolve billed rates from the serving model reported by Anthropic's fallback stream. */
+function resolveAnthropicFallbackServingModelCost(params) {
+	const requestedModelId = resolveFallbackModelIdentity(params.requestedModelId);
+	const servingModelId = resolveFallbackModelIdentity(params.servingModelId);
+	if (!servingModelId || servingModelId === requestedModelId || !isClaudeOpusFallbackModel(servingModelId)) return params.requestedCost;
+	if (requestedModelId && isClaudeOpusFallbackModel(requestedModelId)) return params.requestedCost;
+	return CLAUDE_OPUS_FALLBACK_MODEL_COST;
 }
 function readBoundaryModel(value) {
 	if (!value || typeof value !== "object") return null;
@@ -259,7 +389,7 @@ function projectAnthropicTools(tools, toWireName) {
 	return {
 		inputToolCount: tools.length,
 		unavailableOriginalNames,
-		tools: projectedTools
+		tools: sortPromptCacheToolsByName(projectedTools)
 	};
 }
 /** Keeps forced Anthropic tool choices aligned with the projected wire names. */
@@ -381,7 +511,7 @@ const toClaudeCodeName = (name) => ccToolLookup.get(name.toLowerCase()) ?? name;
 /**
 * Convert content blocks to Anthropic API format
 */
-function convertContentBlocks(content, isError) {
+async function convertContentBlocks(content, isError, imageBudget) {
 	const text = extractToolResultText(content);
 	const mediaPlaceholder = describeToolResultMediaPlaceholder(content);
 	if (!content.some(isImageWithMediaPayload)) {
@@ -402,12 +532,18 @@ function convertContentBlocks(content, isError) {
 			hasTextBlock = true;
 		}
 		if (!isImageWithMediaPayload(record)) continue;
+		const [normalizedImage] = await normalizeAnthropicInlineContent([{
+			type: "image",
+			data: typeof record.data === "string" ? record.data : "",
+			mimeType: typeof record.mimeType === "string" ? record.mimeType : "image/jpeg"
+		}], imageBudget);
+		if (normalizedImage?.type !== "image") continue;
 		blocks.push({
 			type: "image",
 			source: {
 				type: "base64",
-				media_type: typeof record.mimeType === "string" ? record.mimeType : "image/jpeg",
-				data: record.data
+				media_type: resolveAnthropicImageMediaType(normalizedImage.mimeType),
+				data: normalizedImage.data
 			}
 		});
 	}
@@ -465,7 +601,7 @@ async function* iterateAnthropicEvents(response, requireMessageStop = false) {
 }
 const streamAnthropic = (model, context, options) => {
 	const stream = new AssistantMessageEventStream();
-	const requestContext = prepareClaudeSonnet5RequestContext(model, context);
+	const requestContext = prepareClaudeNoPrefillRequestContext(model, context);
 	const requestOptions = normalizeAnthropicThinkingOptions(model, options);
 	(async () => {
 		const output = {
@@ -518,7 +654,7 @@ const streamAnthropic = (model, context, options) => {
 				isOAuth = created.isOAuthToken;
 				serverSideFallback = created.serverSideFallback;
 			}
-			const builtParams = buildParams(model, requestContext, isOAuth, requestOptions, serverSideFallback);
+			const builtParams = await buildParams(model, requestContext, isOAuth, requestOptions, serverSideFallback);
 			let params = builtParams.params;
 			const toolProjection = builtParams.toolProjection;
 			const nextParams = await requestOptions?.onPayload?.(params, model);
@@ -578,7 +714,11 @@ const streamAnthropic = (model, context, options) => {
 					});
 					costModel = {
 						...model,
-						cost: CLAUDE_FABLE_5_FALLBACK_MODEL_COST
+						cost: resolveAnthropicFallbackServingModelCost({
+							requestedModelId: model.id,
+							servingModelId: fallbackBoundary.toModel,
+							requestedCost: model.cost
+						})
 					};
 					calculateCost(costModel, output.usage);
 					eventSink.push({
@@ -773,7 +913,7 @@ const streamAnthropic = (model, context, options) => {
 				}
 				calculateCost(costModel, output.usage);
 			}
-			if (requestOptions?.signal?.aborted) throw new Error("Request was aborted");
+			if (requestOptions?.signal?.aborted) throw transportAbortError(requestOptions.signal);
 			if (output.stopReason === "aborted" || output.stopReason === "error") throw new Error(output.errorMessage ?? "An unknown error occurred");
 			refusalBuffer?.flush();
 			stream.push({
@@ -792,7 +932,7 @@ const streamAnthropic = (model, context, options) => {
 				output.content = [];
 			}
 			output.stopReason = requestOptions?.signal?.aborted ? "aborted" : "error";
-			output.errorMessage = error instanceof Error ? error.message : JSON.stringify(error);
+			output.errorMessage = formatProviderError(error);
 			stream.push({
 				type: "error",
 				reason: output.stopReason,
@@ -868,7 +1008,7 @@ const streamSimpleAnthropic = (model, context, options) => {
 		thinkingEnabled: false
 	});
 	const reasoning = options?.reasoning === "off" ? mandatoryAdaptiveThinking ? "low" : "high" : options?.reasoning;
-	if (resolveClaudeSonnet5ModelIdentity(model)) return streamAnthropic(model, context, {
+	if (resolveClaudeOpus5ModelIdentity(model) || resolveClaudeSonnet5ModelIdentity(model)) return streamAnthropic(model, context, {
 		...base,
 		thinkingEnabled: true,
 		effort: mapThinkingLevelToEffort(model, reasoning ?? "high")
@@ -913,7 +1053,7 @@ function isAnthropicPublicEndpoint(baseUrl) {
 * identity) requests are excluded until the beta is verified there.
 */
 function supportsAnthropicServerSideFallback(model) {
-	if (!usesClaudeFable5MessagesContract(model) || model.provider !== "anthropic") return false;
+	if (!usesClaudeFable5MessagesContract(model) && resolveClaudeOpus5ModelIdentity(model) === void 0 || model.provider !== "anthropic") return false;
 	return isAnthropicPublicEndpoint(model.baseUrl);
 }
 function createClient(model, apiKey, thinkingEnabled, interleavedThinking, useFineGrainedToolStreamingBeta, optionsHeaders, dynamicHeaders, sessionId) {
@@ -1017,7 +1157,7 @@ function createClient(model, apiKey, thinkingEnabled, interleavedThinking, useFi
 		serverSideFallback
 	};
 }
-function buildParams(model, context, isOAuthTokenResult, options, serverSideFallback = false) {
+async function buildParams(model, context, isOAuthTokenResult, options, serverSideFallback = false) {
 	const mandatoryAdaptiveThinking = requiresClaudeAdaptiveThinking(model);
 	const replayThinkingEnabled = mandatoryAdaptiveThinking || options?.thinkingEnabled === true;
 	const { cacheControl } = getCacheControl(model, options?.cacheRetention);
@@ -1031,12 +1171,12 @@ function buildParams(model, context, isOAuthTokenResult, options, serverSideFall
 	const messageCacheControlLimit = Math.max(0, ANTHROPIC_CACHE_CONTROL_LIMIT - systemCacheControlCount - toolCacheControlCount);
 	const params = {
 		model: model.id,
-		messages: convertMessages(context.messages, model, isOAuthTokenResult, cacheControl, messageCacheControlLimit, replayThinkingEnabled, compat.allowEmptySignature),
+		messages: await convertMessages(context.messages, model, isOAuthTokenResult, cacheControl, messageCacheControlLimit, replayThinkingEnabled, compat.allowEmptySignature),
 		max_tokens: options?.maxTokens ?? model.maxTokens,
 		stream: true
 	};
 	if (system) params.system = system;
-	if (serverSideFallback) params.fallbacks = buildAnthropicServerSideFallbacks();
+	if (serverSideFallback) params.fallbacks = ANTHROPIC_SERVER_SIDE_FALLBACKS;
 	if (options?.temperature !== void 0 && !options?.thinkingEnabled && !supportsNativeXhighEffort(model)) params.temperature = options.temperature;
 	if (options?.stop !== void 0 && options.stop.length > 0) params.stop_sequences = options.stop;
 	if (tools && tools.length > 0) params.tools = tools;
@@ -1074,8 +1214,9 @@ function buildParams(model, context, isOAuthTokenResult, options, serverSideFall
 function normalizeToolCallId(id) {
 	return id.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
 }
-function convertMessages(messages, model, isOAuthTokenValue, cacheControl, messageCacheControlLimit = 4, replayThinkingEnabled = true, allowEmptySignature = false) {
+async function convertMessages(messages, model, isOAuthTokenValue, cacheControl, messageCacheControlLimit = 4, replayThinkingEnabled = true, allowEmptySignature = false) {
 	const params = [];
+	const imageBudget = createAnthropicInlineImageBudget();
 	const cacheBreakpointOptOutParamIndexes = /* @__PURE__ */ new Set();
 	const transformedMessages = transformMessages(messages, model, normalizeToolCallId);
 	const activeToolTurnAssistantIndex = replayThinkingEnabled ? -1 : findActiveAnthropicToolTurnAssistantIndex(transformedMessages);
@@ -1093,7 +1234,7 @@ function convertMessages(messages, model, isOAuthTokenValue, cacheControl, messa
 					});
 				}
 			} else {
-				const filteredBlocks = msg.content.map((item) => {
+				const filteredBlocks = (await normalizeAnthropicInlineContent(msg.content, imageBudget)).map((item) => {
 					if (item.type === "text") return {
 						type: "text",
 						text: sanitizeSurrogates(item.text)
@@ -1102,7 +1243,7 @@ function convertMessages(messages, model, isOAuthTokenValue, cacheControl, messa
 						type: "image",
 						source: {
 							type: "base64",
-							media_type: item.mimeType,
+							media_type: resolveAnthropicImageMediaType(item.mimeType),
 							data: item.data
 						}
 					};
@@ -1174,7 +1315,7 @@ function convertMessages(messages, model, isOAuthTokenValue, cacheControl, messa
 			toolResults.push({
 				type: "tool_result",
 				tool_use_id: msg.toolCallId,
-				content: convertContentBlocks(msg.content, msg.isError),
+				content: await convertContentBlocks(msg.content, msg.isError, imageBudget),
 				is_error: msg.isError
 			});
 			let j = i + 1;
@@ -1184,7 +1325,7 @@ function convertMessages(messages, model, isOAuthTokenValue, cacheControl, messa
 				toolResults.push({
 					type: "tool_result",
 					tool_use_id: nextMsg.toolCallId,
-					content: convertContentBlocks(nextMsg.content, nextMsg.isError),
+					content: await convertContentBlocks(nextMsg.content, nextMsg.isError, imageBudget),
 					is_error: nextMsg.isError
 				});
 				j++;
@@ -1321,4 +1462,4 @@ function mapStopReason(reason) {
 	}
 }
 //#endregion
-export { buildAnthropicServerSideFallbacks as _, readAnthropicPromptUsageSnapshot as a, omitFoundryBearerCredentialHeaders as b, projectAnthropicTools as c, ANTHROPIC_OMITTED_REASONING_TEXT as d, findActiveAnthropicToolTurnAssistantIndex as f, applyAnthropicFallbackBoundary as g, CLAUDE_FABLE_5_FALLBACK_MODEL_COST as h, readAnthropicCacheWriteUsage as i, reconcileAnthropicToolChoice as l, CLAUDE_FABLE_5_FALLBACK_MODEL as m, streamAnthropic as n, readAnthropicUsageTokenCount as o, ANTHROPIC_SERVER_SIDE_FALLBACK_BETA as p, streamSimpleAnthropic as r, readLastAnthropicIterationUsage as s, anthropic_exports as t, resolveOriginalAnthropicToolName as u, readAnthropicFallbackBoundary as v, usesFoundryBearerAuth as x, applyAnthropicRefusal as y };
+export { normalizeAnthropicInlineContent as C, createAnthropicInlineImageBudget as S, canonicalizeBase64 as T, readAnthropicFallbackBoundary as _, readAnthropicPromptUsageSnapshot as a, omitFoundryBearerCredentialHeaders as b, projectAnthropicTools as c, ANTHROPIC_OMITTED_REASONING_TEXT as d, findActiveAnthropicToolTurnAssistantIndex as f, applyAnthropicFallbackBoundary as g, CLAUDE_OPUS_FALLBACK_MODEL_COST as h, readAnthropicCacheWriteUsage as i, reconcileAnthropicToolChoice as l, ANTHROPIC_SERVER_SIDE_FALLBACK_BETA as m, streamAnthropic as n, readAnthropicUsageTokenCount as o, ANTHROPIC_SERVER_SIDE_FALLBACKS as p, streamSimpleAnthropic as r, readLastAnthropicIterationUsage as s, anthropic_exports as t, resolveOriginalAnthropicToolName as u, resolveAnthropicFallbackServingModelCost as v, resolveAnthropicImageMediaType as w, usesFoundryBearerAuth as x, applyAnthropicRefusal as y };

package/dist/{index-BoTnz8cv.d.mts → anthropic-SrGtwsJu.d.mts}

@@ -47,6 +47,26 @@ declare const CLAUDE_SONNET_5_THINKING_PROFILE: {
   }];
   readonly defaultLevel: "high";
 };
+declare const CLAUDE_OPUS_5_THINKING_PROFILE: {
+  readonly levels: readonly [{
+    readonly id: "off";
+  }, {
+    readonly id: "minimal";
+  }, {
+    readonly id: "low";
+  }, {
+    readonly id: "medium";
+  }, {
+    readonly id: "high";
+  }, {
+    readonly id: "xhigh";
+  }, {
+    readonly id: "adaptive";
+  }, {
+    readonly id: "max";
+  }];
+  readonly defaultLevel: "high";
+};
 /** Resolve the canonical normalized Claude model id for one runtime model ref. */
 declare function resolveClaudeModelIdentity(ref: ClaudeModelRef): string;
 /** Resolve Claude Fable 5 through direct ids, cloud ids, or deployment metadata. */
@@ -57,8 +77,14 @@ declare function resolveClaudeMythos5ModelIdentity(ref: ClaudeModelRef): string
 declare function requiresClaudeMandatoryAdaptiveThinking(ref: ClaudeModelRef): boolean;
 /** Resolve Claude Sonnet 5 through direct ids, cloud ids, or deployment metadata. */
 declare function resolveClaudeSonnet5ModelIdentity(ref: ClaudeModelRef): string | undefined;
+/** Resolve Claude Opus 5 through aliases, direct ids, cloud ids, or deployment metadata. */
+declare function resolveClaudeOpus5ModelIdentity(ref: ClaudeModelRef): string | undefined;
 /** Return whether a Claude model supports adaptive thinking. */
 declare function supportsClaudeAdaptiveThinking(ref: ClaudeModelRef): boolean;
+/** Return whether a Claude model has a native 1M-token context window. */
+declare function supportsClaude1MContext(ref: ClaudeModelRef): boolean;
+/** Return whether a Claude model supports Anthropic's native fast mode. */
+declare function supportsClaudeFastMode(ref: ClaudeModelRef): boolean;
 /** Return whether a Claude model supports native max effort. */
 declare function supportsClaudeNativeMaxEffort(ref: ClaudeModelRef): boolean;
 /** Return whether a Claude model supports native xhigh effort. */
@@ -71,4 +97,4 @@ declare function requiresClaudeDefaultSampling(ref: ClaudeModelRef): boolean;
  */
 declare function resolveClaudeNativeThinkingLevelMap(ref: ClaudeEffortModelRef): Record<string, string | null | undefined> | undefined;
 //#endregion
-export { resolveClaudeFable5ModelIdentity as a, resolveClaudeNativeThinkingLevelMap as c, supportsClaudeNativeMaxEffort as d, supportsClaudeNativeXhighEffort as f, requiresClaudeMandatoryAdaptiveThinking as i, resolveClaudeSonnet5ModelIdentity as l, CLAUDE_SONNET_5_THINKING_PROFILE as n, resolveClaudeModelIdentity as o, requiresClaudeDefaultSampling as r, resolveClaudeMythos5ModelIdentity as s, CLAUDE_FABLE_5_THINKING_PROFILE as t, supportsClaudeAdaptiveThinking as u };
+export { requiresClaudeMandatoryAdaptiveThinking as a, resolveClaudeMythos5ModelIdentity as c, resolveClaudeSonnet5ModelIdentity as d, supportsClaude1MContext as f, supportsClaudeNativeXhighEffort as g, supportsClaudeNativeMaxEffort as h, requiresClaudeDefaultSampling as i, resolveClaudeNativeThinkingLevelMap as l, supportsClaudeFastMode as m, CLAUDE_OPUS_5_THINKING_PROFILE as n, resolveClaudeFable5ModelIdentity as o, supportsClaudeAdaptiveThinking as p, CLAUDE_SONNET_5_THINKING_PROFILE as r, resolveClaudeModelIdentity as s, CLAUDE_FABLE_5_THINKING_PROFILE as t, resolveClaudeOpus5ModelIdentity as u };

package/dist/{api-registry-DXBIXISf.d.mts → api-registry-DlMgPR39.d.mts}

@@ -1,5 +1,4 @@
-import { E as Model, F as SimpleStreamOptions, R as StreamFunction, n as Api, o as AssistantMessageEventStreamContract, u as Context, z as StreamOptions } from "./types-CYORveZ7.mjs";
-
+import { E as Model, F as SimpleStreamOptions, R as StreamFunction, n as Api, o as AssistantMessageEventStreamContract, u as Context, z as StreamOptions } from "./types-bzp5k29J.mjs";
 //#region packages/ai/src/api-registry.d.ts
 /** Runtime stream adapter signature stored in the API provider registry. */
 type ApiStreamFunction = (model: Model, context: Context, options?: StreamOptions) => AssistantMessageEventStreamContract;

package/dist/{azure-openai-responses-BkZgyZ3I.mjs → azure-openai-responses-DIYgsqFM.mjs}

@@ -1,10 +1,9 @@
-import { n as getEnvApiKey } from "./env-api-keys-DnhYpc27.mjs";
+import { n as getEnvApiKey } from "./env-api-keys-DrgeBuva.mjs";
 import { t as AssistantMessageEventStream } from "./event-stream-D8n2uFee.mjs";
-import { n as getAiTransportHost } from "./host-4t713IeR.mjs";
-import { l as buildBaseOptions } from "./transform-messages-eb6lxDLB.mjs";
-import { a as resolveResponsesReasoningEffort, n as convertResponsesMessages, o as runResponsesStreamLifecycle, r as createResponsesAssistantOutput, t as applyCommonResponsesParams } from "./openai-responses-shared-CwnGU0KW.mjs";
-import { i as resolveAzureDeploymentNameFromMap, t as isOpenAICompatibleAzureResponsesBaseUrl } from "./azure-openai-responses-client-compat-C7K7QfUE.mjs";
-import { a as clampOpenAIPromptCacheKey } from "./openai-tool-projection-WHf2nuOI.mjs";
+import { n as getAiTransportHost } from "./host-XYGZcgO8.mjs";
+import { n as clampOpenAIPromptCacheKey } from "./openai-prompt-cache-mZTCdRPo.mjs";
+import { A as buildBaseOptions } from "./shared-CdjNZd35.mjs";
+import { a as convertResponsesMessages, c as runResponsesStreamLifecycle, i as applyCommonResponsesParams, o as createResponsesAssistantOutput, s as resolveResponsesReasoningEffort, vt as isOpenAICompatibleAzureResponsesBaseUrl, xt as resolveAzureDeploymentNameFromMap } from "./openai-D3PD6PE-.mjs";
 import OpenAI, { AzureOpenAI } from "openai";
 //#region packages/ai/src/providers/azure-openai-responses.ts
 const DEFAULT_AZURE_API_VERSION = "v1";
@@ -94,11 +93,8 @@ function resolveAzureConfig(model, options) {
 	};
 }
 function createClient(model, apiKeyInput, options) {
-	let apiKey = apiKeyInput;
-	if (!apiKey) {
-		if (!process.env.AZURE_OPENAI_API_KEY) throw new Error("Azure OpenAI API key is required. Set AZURE_OPENAI_API_KEY environment variable or pass it as an argument.");
-		apiKey = process.env.AZURE_OPENAI_API_KEY;
-	}
+	const apiKey = apiKeyInput.trim();
+	if (!apiKey) throw new Error("Azure OpenAI API key is required. Set AZURE_OPENAI_API_KEY environment variable or pass it as an argument.");
 	const headers = { ...model.headers };
 	if (options?.headers) Object.assign(headers, options.headers);
 	const { baseUrl, apiVersion } = resolveAzureConfig(model, options);

package/dist/{env-api-keys-DnhYpc27.mjs → env-api-keys-DrgeBuva.mjs}

@@ -82,7 +82,7 @@ function getProcEnv(key) {
 	return procEnvCache.get(key);
 }
 function getEnvValue(key) {
-	return getProcessEnv()?.[key] || getProcEnv(key);
+	return (getProcessEnv()?.[key] || getProcEnv(key))?.trim() || void 0;
 }
 let cachedVertexAdcCredentialsExists = null;
 function hasVertexAdcCredentials() {

package/dist/error-coercion-DgxlWC0n.mjs

@@ -0,0 +1,15 @@
+//#region packages/normalization-core/src/error-coercion.ts
+/**
+* Normalizes an unknown thrown value into an Error. Non-Error objects become
+* the `cause` and have their enumerable fields copied so structured details
+* (codes, statuses) survive the coercion.
+*/
+function toErrorObject(value, fallbackMessage) {
+	if (value instanceof Error) return value;
+	if (typeof value === "string") return new Error(value);
+	const error = new Error(fallbackMessage, { cause: value });
+	if (typeof value === "object" && value !== null || typeof value === "function") Object.assign(error, value);
+	return error;
+}
+//#endregion
+export { toErrorObject as t };

package/dist/{event-stream-BPemFrFW.d.mts → event-stream-YjaPW20U.d.mts}

@@ -1,4 +1,4 @@
-import { a as AssistantMessageEvent, i as AssistantMessage, o as AssistantMessageEventStreamContract } from "./types-CYORveZ7.mjs";
+import { a as AssistantMessageEvent, i as AssistantMessage, o as AssistantMessageEventStreamContract } from "./types-bzp5k29J.mjs";
 
 //#region packages/llm-core/src/utils/event-stream.d.ts
 /** Generic async-iterable event stream with a separately awaited final result. */

package/dist/event-stream.d.mts

@@ -1,2 +1,2 @@
-import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-BPemFrFW.mjs";
+import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-YjaPW20U.mjs";
 export { AssistantMessageEventStream, EventStream, createAssistantMessageEventStream };

package/dist/{tool-schema-json-projection-BwNu3nDi.mjs → github-copilot-headers-BCoBNmL7.mjs}

@@ -91,4 +91,51 @@ function projectRuntimeToolInputSchema(schema, path = "parameters") {
 	};
 }
 //#endregion
-export { projectRuntimeToolInputSchema as t };
+//#region packages/ai/src/providers/cache-retention.ts
+/**
+* Resolve cache retention preference.
+* Defaults to "short" and uses OPENCLAW_CACHE_RETENTION for backward compatibility.
+*/
+function resolveCacheRetention(cacheRetention) {
+	if (cacheRetention) return cacheRetention;
+	if (typeof process !== "undefined" && process.env.OPENCLAW_CACHE_RETENTION === "long") return "long";
+	return "short";
+}
+//#endregion
+//#region packages/ai/src/providers/cloudflare.ts
+function isCloudflareProvider(provider) {
+	return provider === "cloudflare-workers-ai" || provider === "cloudflare-ai-gateway";
+}
+/** Substitute `{VAR}` placeholders in a Cloudflare baseUrl from process.env. */
+function resolveCloudflareBaseUrl(model) {
+	const url = model.baseUrl;
+	if (!url.includes("{")) return url;
+	return url.replace(/\{([A-Z_][A-Z0-9_]*)\}/g, (_match, name) => {
+		const value = process.env[name];
+		if (!value) throw new Error(`${name} is required for provider ${model.provider} but is not set.`);
+		return value;
+	});
+}
+//#endregion
+//#region packages/ai/src/providers/github-copilot-headers.ts
+function inferCopilotInitiator(messages) {
+	const last = messages[messages.length - 1];
+	return last && last.role !== "user" ? "agent" : "user";
+}
+function hasCopilotVisionInput(messages) {
+	return messages.some((msg) => {
+		if (msg.role === "user" && Array.isArray(msg.content)) return msg.content.some((c) => c.type === "image");
+		if (msg.role === "toolResult" && Array.isArray(msg.content)) return msg.content.some((c) => c.type === "image");
+		return false;
+	});
+}
+function buildCopilotDynamicHeaders(params) {
+	const headers = {
+		"X-Initiator": inferCopilotInitiator(params.messages),
+		"Openai-Intent": "conversation-edits"
+	};
+	if (params.hasImages) headers["Copilot-Vision-Request"] = "true";
+	return headers;
+}
+//#endregion
+export { resolveCacheRetention as a, resolveCloudflareBaseUrl as i, hasCopilotVisionInput as n, projectRuntimeToolInputSchema as o, isCloudflareProvider as r, buildCopilotDynamicHeaders as t };

package/dist/{google-C_biGbV7.mjs → google-f-A8xrae.mjs}

@@ -1,8 +1,8 @@
-import { n as getEnvApiKey } from "./env-api-keys-DnhYpc27.mjs";
+import { n as getEnvApiKey } from "./env-api-keys-DrgeBuva.mjs";
 import { t as AssistantMessageEventStream } from "./event-stream-D8n2uFee.mjs";
-import { n as getAiTransportHost, r as resolveAiTransportHeaderSentinels } from "./host-4t713IeR.mjs";
-import { l as buildBaseOptions } from "./transform-messages-eb6lxDLB.mjs";
-import { a as runGoogleGenerateContentLifecycle, i as getDisabledGoogleThinkingConfig, n as buildGoogleSimpleThinking, r as createGoogleAssistantOutput, t as buildGoogleGenerateContentParams } from "./google-shared-BK-NoHl8.mjs";
+import { n as getAiTransportHost, r as resolveAiTransportHeaderSentinels } from "./host-XYGZcgO8.mjs";
+import { A as buildBaseOptions } from "./shared-CdjNZd35.mjs";
+import { a as runGoogleGenerateContentLifecycle, i as getDisabledGoogleThinkingConfig, n as buildGoogleSimpleThinking, r as createGoogleAssistantOutput, t as buildGoogleGenerateContentParams } from "./google-shared-J6qvYINH.mjs";
 import { GoogleGenAI } from "@google/genai";
 //#region packages/ai/src/providers/google.ts
 let toolCallCounter = 0;

package/dist/{google-shared-BK-NoHl8.mjs → google-shared-J6qvYINH.mjs}

@@ -1,7 +1,8 @@
-import { n as calculateCost, r as clampThinkingLevel } from "./model-utils-1GiZ2_rr.mjs";
+import { E as isImageWithMediaPayload, S as describeToolResultMediaPlaceholder, o as stripSystemPromptCacheBoundary, u as transformMessages, w as extractToolResultText } from "./shared-CdjNZd35.mjs";
 import { t as sanitizeSurrogates } from "./sanitize-unicode-DT5o51ur.mjs";
-import { i as extractToolResultText, n as describeToolResultMediaPlaceholder, o as isImageWithMediaPayload, t as transformMessages, w as stripSystemPromptCacheBoundary } from "./transform-messages-eb6lxDLB.mjs";
-import { t as formatProviderError } from "./provider-error-LMfTEkfO.mjs";
+import { c as calculateCost, l as clampThinkingLevel } from "./number-coercion-DvG7SNMg.mjs";
+import { d as transportAbortError } from "./transport-stream-shared-BbMELSI4.mjs";
+import { t as formatProviderError } from "./provider-error-apVOZI6G.mjs";
 import { FinishReason, FunctionCallingConfigMode, ThinkingLevel } from "@google/genai";
 //#region packages/ai/src/providers/google-shared.ts
 /**
@@ -545,7 +546,7 @@ async function consumeGoogleGenerateContentStream(params) {
 		}
 	}
 	endCurrentBlock();
-	if (params.signal?.aborted) throw new Error("Request was aborted");
+	if (params.signal?.aborted) throw transportAbortError(params.signal);
 	if (params.output.stopReason === "aborted" || params.output.stopReason === "error") throw new Error("An unknown error occurred");
 	params.stream.push({
 		type: "done",

package/dist/{google-vertex-CvdzF1U7.mjs → google-vertex-D3yMVXIY.mjs}

@@ -1,7 +1,7 @@
 import { t as AssistantMessageEventStream } from "./event-stream-D8n2uFee.mjs";
-import { n as getAiTransportHost, r as resolveAiTransportHeaderSentinels } from "./host-4t713IeR.mjs";
-import { l as buildBaseOptions } from "./transform-messages-eb6lxDLB.mjs";
-import { a as runGoogleGenerateContentLifecycle, n as buildGoogleSimpleThinking, r as createGoogleAssistantOutput, t as buildGoogleGenerateContentParams } from "./google-shared-BK-NoHl8.mjs";
+import { n as getAiTransportHost, r as resolveAiTransportHeaderSentinels } from "./host-XYGZcgO8.mjs";
+import { A as buildBaseOptions } from "./shared-CdjNZd35.mjs";
+import { a as runGoogleGenerateContentLifecycle, n as buildGoogleSimpleThinking, r as createGoogleAssistantOutput, t as buildGoogleGenerateContentParams } from "./google-shared-J6qvYINH.mjs";
 import { GoogleGenAI, ResourceScope } from "@google/genai";
 //#region packages/ai/src/providers/google-vertex.ts
 const API_VERSION = "v1";