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

package/dist/{provider-error-C8mBRJDl.mjs → provider-error-DDOs_Bz0.mjs}

@@ -1,6 +1,4 @@
-import { o as normalizeStringifiedOptionalString } from "./string-coerce-fsri9iCu.mjs";
-import { i as asOptionalRecord } from "./record-coerce-DdXsgUd_.mjs";
-import { t as truncateUtf16Safe } from "./utf16-slice-CvGodqok.mjs";
+import { a as asOptionalRecord, f as normalizeStringifiedOptionalString, t as truncateUtf16Safe } from "./utf16-slice-qz3nsy87.mjs";
 import "./number-coercion-H9qHik3g.mjs";
 //#region packages/normalization-core/src/balanced-json.ts
 function isJsonOpeningDelimiter(char, openers) {

package/dist/{provider-options-Cc5ZQ6Aa.d.mts → provider-options-MdMBLzlU.d.mts}

@@ -1,8 +1,8 @@
-import { U as StreamOptions } from "./types-DTAP49HF.mjs";
+import { U as StreamOptions } from "./types-DhLoJbFm.mjs";
+import "./types-GiAjXatj.mjs";
 import OpenAI from "openai";
 import Anthropic from "@anthropic-ai/sdk";
 import { ResponseCreateParamsStreaming } from "openai/resources/responses/responses.js";
-
 //#region packages/ai/src/providers/openai-reasoning-effort.d.ts
 type OpenAIReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 type OpenAIApiReasoningEffort = OpenAIReasoningEffort | (string & {});
@@ -142,7 +142,8 @@ type BaseOpenAIStreamOptions = StreamOptions & {
   topP?: number;
   authProfileId?: string;
   firstEventTimeoutMs?: number;
-  onFirstEventTimeout?: (reason: Error) => void; /** Internal owner notification after a server rejects a persisted compaction checkpoint. */
+  onFirstEventTimeout?: (reason: Error) => void;
+  /** Internal owner notification after a server rejects a persisted compaction checkpoint. */
   onCompactionRejected?: (checkpoint: OpenAIResponsesCompactionRejection) => void;
   openclawCodeModeToolSurface?: boolean;
   openclawCodeModeAllowedHostedToolTypes?: Set<string>;

package/dist/{provider-transcript-transform--gtf0ZbR.mjs → provider-transcript-transform-C01bQ5a3.mjs}

@@ -1,4 +1,4 @@
-import { i as transformMessages } from "./host-DF_yxOsA.mjs";
+import { i as transformMessages } from "./host-D51fmkH6.mjs";
 //#region packages/ai/src/provider-transcript-transform.ts
 const IMAGE_OMISSION = "(image omitted: model does not support images)";
 const VIDEO_OMISSION = "(video omitted: provider does not support video input)";

package/dist/provider-types.d.mts

@@ -1,8 +1,10 @@
 import { a as requiresClaudeMandatoryAdaptiveThinking, c as resolveClaudeMythos5ModelIdentity, d as resolveClaudeSonnet5ModelIdentity, f as supportsClaude1MContext, g as supportsClaudeNativeXhighEffort, h as supportsClaudeNativeMaxEffort, i as requiresClaudeDefaultSampling, l as resolveClaudeNativeThinkingLevelMap, m as supportsClaudeFastMode, n as CLAUDE_OPUS_5_THINKING_PROFILE, o as resolveClaudeFable5ModelIdentity, p as supportsClaudeAdaptiveThinking, r as CLAUDE_SONNET_5_THINKING_PROFILE, s as resolveClaudeModelIdentity, t as CLAUDE_FABLE_5_THINKING_PROFILE, u as resolveClaudeOpus5ModelIdentity } from "./anthropic-BECQCNdF.mjs";
 import { a as extractDiagnosticError, i as createAssistantMessageDiagnostic, n as DiagnosticErrorInfo, o as formatThrownValue, r as appendAssistantMessageDiagnostic, t as AssistantMessageDiagnostic } from "./diagnostics-BaTA9eVl.mjs";
-import { $ as Transport, A as OpenAIResponsesCompat, B as StopReason, C as KnownImagesApi, D as Model, F as ProviderImagesOptions, G as TextSignatureV1, I as ProviderReplayState, J as ThinkingLevel, K as ThinkingBudgets, L as ProviderResponse, M as PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, N as PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, O as ModelThinkingLevel, P as Provider, Q as ToolResultMessage, S as KnownApi, T as MaybePromise, U as StreamOptions, V as StreamFn, W as TextContent, X as Tool, Y as ThinkingLevelMap, Z as ToolCall, _ as ImagesModel, a as AssistantMessage, b as ImagesProvider, c as AssistantMessageEventStreamLike, d as Context, et as Usage, f as ImageContent, g as ImagesInputContent, h as ImagesFunction, i as AssistantImages, j as OpenRouterRouting, k as OpenAICompletionsCompat, l as CacheRetention, m as ImagesContext, n as Api, nt as ValidateToolArgumentsFn, o as AssistantMessageEvent, p as ImagesApi, q as ThinkingContent, r as AssistantDeliveryTtsFacts, rt as VercelGatewayRouting, s as AssistantMessageEventStreamContract, t as AnthropicMessagesCompat, tt as UserMessage, u as CompleteSimpleFn, v as ImagesOptions, w as KnownImagesProvider, x as ImagesStopReason, y as ImagesOutputContent, z as SimpleStreamOptions } from "./types-DTAP49HF.mjs";
-import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-D91-ohD_.mjs";
-import { n as validateToolCall, t as validateToolArguments } from "./validation-DYNNrU9u.mjs";
+import { $ as Transport, A as OpenAIResponsesCompat, B as StopReason, C as KnownImagesApi, D as Model, F as ProviderImagesOptions, G as TextSignatureV1, I as ProviderReplayState, J as ThinkingLevel, K as ThinkingBudgets, L as ProviderResponse, M as PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, N as PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, O as ModelThinkingLevel, P as Provider, Q as ToolResultMessage, S as KnownApi, T as MaybePromise, U as StreamOptions, V as StreamFn, W as TextContent, X as Tool, Y as ThinkingLevelMap, Z as ToolCall, _ as ImagesModel, a as AssistantMessage, b as ImagesProvider, c as AssistantMessageEventStreamLike, d as Context, et as Usage, f as ImageContent, g as ImagesInputContent, h as ImagesFunction, i as AssistantImages, j as OpenRouterRouting, k as OpenAICompletionsCompat, l as CacheRetention, m as ImagesContext, n as Api, nt as ValidateToolArgumentsFn, o as AssistantMessageEvent, p as ImagesApi, q as ThinkingContent, r as AssistantDeliveryTtsFacts, rt as VercelGatewayRouting, s as AssistantMessageEventStreamContract, t as AnthropicMessagesCompat, tt as UserMessage, u as CompleteSimpleFn, v as ImagesOptions, w as KnownImagesProvider, x as ImagesStopReason, y as ImagesOutputContent, z as SimpleStreamOptions } from "./types-DhLoJbFm.mjs";
+import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-LiXePESD.mjs";
+import { n as validateToolCall, t as validateToolArguments } from "./validation-Dk7q7NMN.mjs";
+import "./index-Qbej8io0.mjs";
+import "./types-GiAjXatj.mjs";
 //#region packages/ai/src/provider-types.d.ts
 declare const PROVIDER_CONTEXT_HANDOFF: unique symbol;
 type VideoContent = Omit<ImageContent, "type"> & {

package/dist/providers.d.mts

@@ -1,6 +1,5 @@
-import { n as ApiRegistry } from "./api-registry-DFxSnFqG.mjs";
+import { n as ApiRegistry } from "./api-registry-CTd8NzcD.mjs";
 import { n as clampOpenAIPromptCacheKey, t as OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH } from "./openai-prompt-cache-2uo_1OR1.mjs";
-
 //#region packages/ai/src/providers/register-builtins.d.ts
 /** Source id used for built-in API provider registrations. */
 declare const BUILT_IN_API_PROVIDER_SOURCE_ID = "core:built-in";

package/dist/providers.mjs

@@ -1,5 +1,5 @@
 import { t as AssistantMessageEventStream } from "./event-stream-uSMZJ3FA.mjs";
-import { n as projectProviderError } from "./provider-error-C8mBRJDl.mjs";
+import { n as projectProviderError } from "./provider-error-DDOs_Bz0.mjs";
 import { n as clampOpenAIPromptCacheKey, t as OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH } from "./openai-prompt-cache-mZTCdRPo.mjs";
 //#region packages/ai/src/providers/register-builtins.ts
 /** Source id used for built-in API provider registrations. */
@@ -62,35 +62,35 @@ function createLazyRegistration(api, importModule, select) {
 	};
 }
 const registerBuiltIns = [
-	createLazyRegistration("anthropic-messages", () => import("./anthropic-B8KwTtlb.mjs").then((n) => n.t), (module) => ({
+	createLazyRegistration("anthropic-messages", () => import("./anthropic-DI4PZKKB.mjs").then((n) => n.t), (module) => ({
 		stream: module.streamAnthropic,
 		streamSimple: module.streamSimpleAnthropic
 	})),
-	createLazyRegistration("openai-completions", () => import("./openai-completions-D88orSJ9.mjs").then((n) => n.t), (module) => ({
+	createLazyRegistration("openai-completions", () => import("./openai-completions-EFPiUGfS.mjs").then((n) => n.t), (module) => ({
 		stream: module.streamOpenAICompletions,
 		streamSimple: module.streamSimpleOpenAICompletions
 	})),
-	createLazyRegistration("mistral-conversations", () => import("./mistral-D6hRXI7A.mjs"), (module) => ({
+	createLazyRegistration("mistral-conversations", () => import("./mistral-EiHdymeb.mjs"), (module) => ({
 		stream: module.streamMistral,
 		streamSimple: module.streamSimpleMistral
 	})),
-	createLazyRegistration("openai-responses", () => import("./openai-responses-BXEcr-Tp.mjs").then((n) => n.t), (module) => ({
+	createLazyRegistration("openai-responses", () => import("./openai-responses-BogP8OjX.mjs").then((n) => n.t), (module) => ({
 		stream: module.streamOpenAIResponses,
 		streamSimple: module.streamSimpleOpenAIResponses
 	})),
-	createLazyRegistration("azure-openai-responses", () => import("./azure-openai-responses-Aa4mVcYG.mjs"), (module) => ({
+	createLazyRegistration("azure-openai-responses", () => import("./azure-openai-responses-D8dI0ekg.mjs"), (module) => ({
 		stream: module.streamAzureOpenAIResponses,
 		streamSimple: module.streamSimpleAzureOpenAIResponses
 	})),
-	createLazyRegistration("openai-chatgpt-responses", () => import("./openai-chatgpt-responses-C339VIfT.mjs"), (module) => ({
+	createLazyRegistration("openai-chatgpt-responses", () => import("./openai-chatgpt-responses-DHpF9o1e.mjs"), (module) => ({
 		stream: module.streamOpenAICodexResponses,
 		streamSimple: module.streamSimpleOpenAICodexResponses
 	})),
-	createLazyRegistration("google-generative-ai", () => import("./google-yDRnipeq.mjs"), (module) => ({
+	createLazyRegistration("google-generative-ai", () => import("./google-Od-LLdVK.mjs"), (module) => ({
 		stream: module.streamGoogle,
 		streamSimple: module.streamSimpleGoogle
 	})),
-	createLazyRegistration("google-vertex", () => import("./google-vertex-DCJHM_a5.mjs"), (module) => ({
+	createLazyRegistration("google-vertex", () => import("./google-vertex-aerRSXc4.mjs"), (module) => ({
 		stream: module.streamGoogleVertex,
 		streamSimple: module.streamSimpleGoogleVertex
 	}))

package/dist/{sanitize-unicode-BP7HLLZn.mjs → sanitize-unicode-DCkltN94.mjs}

@@ -1,5 +1,4 @@
-import { a as requiresClaudeMandatoryAdaptiveThinking, l as resolveClaudeNativeThinkingLevelMap } from "./anthropic-BQXQudmA.mjs";
-import "./src-D2H6yKkH.mjs";
+import { a as requiresClaudeMandatoryAdaptiveThinking, l as resolveClaudeNativeThinkingLevelMap } from "./src-Bu3FiFAG.mjs";
 //#region packages/ai/src/model-utils.ts
 /** Calculates and stores model cost fields from token usage and per-million pricing. */
 function calculateCost(model, usage) {

package/dist/simple-options-CFj7x3J4.mjs

@@ -0,0 +1,118 @@
+import { c as normalizeLowercaseStringOrEmpty } from "./utf16-slice-qz3nsy87.mjs";
+import { t as sanitizeSurrogates } from "./sanitize-unicode-DCkltN94.mjs";
+import { r as copyProviderAcceptanceObserver } from "./transport-stream-shared-ljShVIZB.mjs";
+//#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.
+*/
+/** Canonicalizes provider tool order without relying on host locale settings. */
+function sortPromptCacheToolsByName(tools) {
+	const compareText = (left, right) => {
+		const leftText = left ?? "";
+		const rightText = right ?? "";
+		return leftText < rightText ? -1 : leftText > rightText ? 1 : 0;
+	};
+	return tools.toSorted((left, right) => compareText(left.wireName ?? left.name, right.wireName ?? right.name) || compareText(left.description, right.description));
+}
+/** 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/simple-options.ts
+function buildBaseOptions(model, options, apiKey) {
+	const firstEventOptions = options;
+	return copyProviderAcceptanceObserver(options, {
+		temperature: options?.temperature,
+		maxTokens: options?.maxTokens,
+		stop: options?.stop,
+		signal: options?.signal,
+		apiKey: apiKey || options?.apiKey,
+		transport: options?.transport,
+		cacheRetention: options?.cacheRetention,
+		sessionId: options?.sessionId,
+		promptCacheKey: options?.promptCacheKey,
+		headers: options?.headers,
+		onPayload: options?.onPayload,
+		onResponse: options?.onResponse,
+		timeoutMs: options?.timeoutMs,
+		firstEventTimeoutMs: firstEventOptions?.firstEventTimeoutMs,
+		onFirstEventTimeout: firstEventOptions?.onFirstEventTimeout,
+		maxRetries: options?.maxRetries,
+		maxRetryDelayMs: options?.maxRetryDelayMs,
+		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;
+}
+function adjustMaxTokensForThinking(baseMaxTokens, modelMaxTokens, reasoningLevel, customBudgets) {
+	const budgets = {
+		minimal: 1024,
+		low: 2048,
+		medium: 8192,
+		high: 16384,
+		max: 32768,
+		...customBudgets
+	};
+	const minOutputTokens = 1024;
+	let thinkingBudget = budgets[clampReasoning(reasoningLevel)];
+	const maxTokens = baseMaxTokens === void 0 ? modelMaxTokens : Math.min(baseMaxTokens + thinkingBudget, modelMaxTokens);
+	if (maxTokens <= thinkingBudget) thinkingBudget = Math.max(0, maxTokens - minOutputTokens);
+	return {
+		maxTokens,
+		thinkingBudget
+	};
+}
+//#endregion
+export { SYSTEM_PROMPT_CACHE_BOUNDARY as a, splitSystemPromptCacheBoundary as c, normalizeStructuredPromptSection as d, sortPromptCacheToolsByName as f, clampReasoning as i, stripSystemPromptCacheBoundary as l, buildBaseOptions as n, ensureSystemPromptCacheBoundary as o, clampMaxTokensToModel as r, prependSystemPromptAdditionAfterCacheBoundary as s, adjustMaxTokensForThinking as t, normalizePromptCapabilityIds as u };

package/dist/{anthropic-BQXQudmA.mjs → src-Bu3FiFAG.mjs}

@@ -1,3 +1,4 @@
+import "./validation-B61OhAio.mjs";
 //#region packages/llm-core/src/model-contracts/anthropic.ts
 function normalizeClaudeModelId(modelId) {
 	const normalized = modelId?.trim().toLowerCase() ?? "";

package/dist/{streaming-byte-guard-BrbkbwUu.mjs → streaming-byte-guard-CC-HMn_u.mjs}

@@ -5,6 +5,9 @@ function createSseByteGuard(reader, opts) {
 	let total = 0;
 	let overflowedFlag = false;
 	let cancelledFlag = false;
+	const cancelReaderBestEffort = (reason) => {
+		reader.cancel(reason).catch(() => void 0);
+	};
 	return {
 		read: async () => {
 			if (overflowedFlag || cancelledFlag) return {
@@ -22,9 +25,7 @@ function createSseByteGuard(reader, opts) {
 					size: next,
 					maxBytes: opts.maxBytes
 				});
-				try {
-					await reader.cancel(err);
-				} catch {}
+				cancelReaderBestEffort(err);
 				throw err;
 			}
 			total = next;
@@ -33,9 +34,7 @@ function createSseByteGuard(reader, opts) {
 		cancel: async (reason) => {
 			if (overflowedFlag) return;
 			cancelledFlag = true;
-			try {
-				await reader.cancel(reason);
-			} catch {}
+			cancelReaderBestEffort(reason);
 		},
 		totalBytes: () => total,
 		overflowed: () => overflowedFlag,

package/dist/string-normalization--fwJ4S2q.mjs

@@ -0,0 +1,16 @@
+import { d as normalizeOptionalString } from "./utf16-slice-qz3nsy87.mjs";
+//#region packages/normalization-core/src/string-normalization.ts
+/** Coerces entries to strings, trims them, and drops empty results. */
+function normalizeStringEntries(list) {
+	return (list ?? []).map((entry) => normalizeOptionalString(String(entry)) ?? "").filter(Boolean);
+}
+/** Returns first-seen unique values while preserving insertion order. */
+function uniqueValues(values) {
+	return [...new Set(values)];
+}
+/** Returns first-seen unique strings while preserving insertion order. */
+function uniqueStrings(values) {
+	return uniqueValues(values);
+}
+//#endregion
+export { uniqueStrings as n, uniqueValues as r, normalizeStringEntries as t };

package/dist/{tool-schema-json-projection-FEr-jOoZ.mjs → tool-schema-json-projection-qvTEs5Am.mjs}

@@ -1,5 +1,5 @@
-import { n as getAiTransportHost } from "./host-DF_yxOsA.mjs";
-import { a as isRecord } from "./record-coerce-DdXsgUd_.mjs";
+import { o as isRecord } from "./utf16-slice-qz3nsy87.mjs";
+import { n as getAiTransportHost } from "./host-D51fmkH6.mjs";
 import { types } from "node:util";
 //#region packages/ai/src/transports/host-policy.ts
 function buildGuardedModelFetch(model, timeoutMs, options) {

package/dist/{simple-options-oqsXB6U3.mjs → transport-stream-shared-ljShVIZB.mjs}

@@ -1,72 +1,13 @@
 import { r as createAssistantMessageEventStream } from "./event-stream-uSMZJ3FA.mjs";
-import { n as normalizeLowercaseStringOrEmpty } from "./string-coerce-fsri9iCu.mjs";
-import { t as sanitizeSurrogates } from "./sanitize-unicode-BP7HLLZn.mjs";
-import { i as asOptionalRecord, n as asNullableRecord, t as asNonArrayRecord } from "./record-coerce-DdXsgUd_.mjs";
-import { n as projectProviderError } from "./provider-error-C8mBRJDl.mjs";
-import { t as headersToRecord } from "./headers-B_e4-1J0.mjs";
-//#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.
-*/
-/** Canonicalizes provider tool order without relying on host locale settings. */
-function sortPromptCacheToolsByName(tools) {
-	const compareText = (left, right) => {
-		const leftText = left ?? "";
-		const rightText = right ?? "";
-		return leftText < rightText ? -1 : leftText > rightText ? 1 : 0;
-	};
-	return tools.toSorted((left, right) => compareText(left.wireName ?? left.name, right.wireName ?? right.name) || compareText(left.description, right.description));
-}
-/** 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}`;
+import { a as asOptionalRecord, n as asNonArrayRecord, r as asNullableRecord } from "./utf16-slice-qz3nsy87.mjs";
+import { t as sanitizeSurrogates } from "./sanitize-unicode-DCkltN94.mjs";
+import { n as projectProviderError } from "./provider-error-DDOs_Bz0.mjs";
+//#region packages/ai/src/utils/headers.ts
+/** Converts a Headers object to a plain record for provider request handling. */
+function headersToRecord(headers) {
+	const result = {};
+	for (const [key, value] of headers.entries()) result[key] = value;
+	return result;
 }
 //#endregion
 //#region packages/ai/src/transports/json-unsafe-integers.ts
@@ -398,53 +339,4 @@ function failTransportStream(params) {
 	stream.end();
 }
 //#endregion
-//#region packages/ai/src/providers/simple-options.ts
-function buildBaseOptions(model, options, apiKey) {
-	const firstEventOptions = options;
-	return copyProviderAcceptanceObserver(options, {
-		temperature: options?.temperature,
-		maxTokens: options?.maxTokens,
-		stop: options?.stop,
-		signal: options?.signal,
-		apiKey: apiKey || options?.apiKey,
-		transport: options?.transport,
-		cacheRetention: options?.cacheRetention,
-		sessionId: options?.sessionId,
-		promptCacheKey: options?.promptCacheKey,
-		headers: options?.headers,
-		onPayload: options?.onPayload,
-		onResponse: options?.onResponse,
-		timeoutMs: options?.timeoutMs,
-		firstEventTimeoutMs: firstEventOptions?.firstEventTimeoutMs,
-		onFirstEventTimeout: firstEventOptions?.onFirstEventTimeout,
-		maxRetries: options?.maxRetries,
-		maxRetryDelayMs: options?.maxRetryDelayMs,
-		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;
-}
-function adjustMaxTokensForThinking(baseMaxTokens, modelMaxTokens, reasoningLevel, customBudgets) {
-	const budgets = {
-		minimal: 1024,
-		low: 2048,
-		medium: 8192,
-		high: 16384,
-		max: 32768,
-		...customBudgets
-	};
-	const minOutputTokens = 1024;
-	let thinkingBudget = budgets[clampReasoning(reasoningLevel)];
-	const maxTokens = baseMaxTokens === void 0 ? modelMaxTokens : Math.min(baseMaxTokens + thinkingBudget, modelMaxTokens);
-	if (maxTokens <= thinkingBudget) thinkingBudget = Math.max(0, maxTokens - minOutputTokens);
-	return {
-		maxTokens,
-		thinkingBudget
-	};
-}
-//#endregion
-export { splitSystemPromptCacheBoundary as A, withProviderResponseHook as C, SYSTEM_PROMPT_CACHE_BOUNDARY as D, quoteUnsafeIntegerLiterals as E, normalizePromptCapabilityIds as M, normalizeStructuredPromptSection as N, ensureSystemPromptCacheBoundary as O, sortPromptCacheToolsByName as P, withProviderAcceptanceObserver as S, parseJsonPreservingUnsafeIntegers as T, notifyProviderStreamOpened as _, assignTransportErrorDetails as a, sanitizeTransportPayloadText as b, createEmptyTransportUsage as c, finalizeTerminalToolCallArguments as d, finalizeTransportStream as f, notifyProviderHttpResponse as g, notifyProviderHttpMetadata as h, clampReasoning as i, stripSystemPromptCacheBoundary as j, prependSystemPromptAdditionAfterCacheBoundary as k, createWritableTransportEventStream as l, mergeTransportMetadata as m, buildBaseOptions as n, coerceTransportToolCallArguments as o, mergeTransportHeaders as p, clampMaxTokensToModel as r, copyProviderAcceptanceObserver as s, adjustMaxTokensForThinking as t, failTransportStream as u, parseTerminalToolCallArguments as v, parseJsonObjectPreservingUnsafeIntegers as w, transportAbortError as x, sanitizeNonEmptyTransportPayloadText as y };
+export { headersToRecord as C, quoteUnsafeIntegerLiterals as S, transportAbortError as _, createWritableTransportEventStream as a, parseJsonObjectPreservingUnsafeIntegers as b, finalizeTransportStream as c, notifyProviderHttpMetadata as d, notifyProviderHttpResponse as f, sanitizeTransportPayloadText as g, sanitizeNonEmptyTransportPayloadText as h, createEmptyTransportUsage as i, mergeTransportHeaders as l, parseTerminalToolCallArguments as m, coerceTransportToolCallArguments as n, failTransportStream as o, notifyProviderStreamOpened as p, copyProviderAcceptanceObserver as r, finalizeTerminalToolCallArguments as s, assignTransportErrorDetails as t, mergeTransportMetadata as u, withProviderAcceptanceObserver as v, parseJsonPreservingUnsafeIntegers as x, withProviderResponseHook as y };

package/dist/transport-stream-shared-rvaCyFYt.d.mts

@@ -0,0 +1,138 @@
+import { D as Model, L as ProviderResponse, U as StreamOptions, a as AssistantMessage, et as Usage } from "./types-DhLoJbFm.mjs";
+import { r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-LiXePESD.mjs";
+import "./index-Qbej8io0.mjs";
+import "./event-stream-BKp4fOt_.mjs";
+import { t as ProviderErrorProjection } from "./provider-error-CzNw4BWX.mjs";
+//#region packages/ai/src/utils/stream-first-event-timeout.d.ts
+type StreamStage = "responses" | "completions";
+type FirstStreamEventTimeoutContext = {
+  provider?: string;
+  api?: string;
+  model?: string;
+  timeoutMs: number;
+  stage?: StreamStage;
+  hint?: string;
+  abort?: (reason: Error) => void;
+  onTimeout?: (reason: Error) => void;
+};
+type FirstStreamEventInternalOptions = {
+  firstEventTimeoutMs?: number;
+  abortFirstEventStream?: (reason: Error) => void;
+  onFirstEventTimeout?: (reason: Error) => void;
+};
+type FirstStreamEventAbortController = {
+  signal: AbortSignal;
+  abort: (reason: Error) => void;
+  dispose: () => void;
+};
+declare function getFirstStreamEventTimeoutMs(options: unknown): number | undefined;
+declare function getFirstStreamEventTimeoutHandler(options: unknown): ((reason: Error) => void) | undefined;
+declare function createFirstStreamEventTimeoutError(context: FirstStreamEventTimeoutContext): Error;
+declare function createFirstStreamEventAbortController(parentSignal?: AbortSignal): FirstStreamEventAbortController;
+declare function withFirstStreamEventTimeout<T>(stream: AsyncIterable<T>, context: FirstStreamEventTimeoutContext): AsyncIterable<T>;
+//#endregion
+//#region packages/ai/src/transports/transport-stream-shared.d.ts
+type ContextUsage = NonNullable<Usage["contextUsage"]>;
+type TransportUsage = {
+  input: number;
+  output: number;
+  cacheRead: number;
+  cacheWrite: number;
+  contextUsage?: ContextUsage;
+  totalTokens: number;
+  cost: {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    total: number;
+  };
+};
+type WritableTransportStream = Pick<ReturnType<typeof createAssistantMessageEventStream>, "push" | "end">;
+declare function sanitizeTransportPayloadText(text: string): string;
+declare function sanitizeNonEmptyTransportPayloadText(text: string, fallback?: string): string;
+declare function coerceTransportToolCallArguments(argumentsValue: unknown): Record<string, unknown>;
+/** Admit only complete object-shaped terminal tool arguments; partial parsing is preview-only. */
+declare function parseTerminalToolCallArguments(value: unknown, errorMessage?: string): Record<string, unknown>;
+/** Validate a complete sibling set before mutating any call into executable state. */
+declare function finalizeTerminalToolCallArguments<T extends {
+  arguments: Record<string, unknown>;
+}>(calls: readonly T[], readArguments: (call: T) => unknown, errorMessage?: string): void;
+declare function mergeTransportHeaders(...headerSources: Array<Record<string, string> | undefined>): Record<string, string> | undefined;
+declare function mergeTransportMetadata<T extends Record<string, unknown>>(payload: T, metadata?: Record<string, string>): T;
+declare function createEmptyTransportUsage(): TransportUsage;
+declare function createWritableTransportEventStream(): {
+  eventStream: AssistantMessageEventStream;
+  stream: AssistantMessageEventStream;
+};
+/**
+ * Abort error to surface for an aborted `signal`.
+ *
+ * Rethrows the caller's abort reason only when it carries a `code`, so that code
+ * survives into `errorCode` on the persisted assistant message and consumers can
+ * recognize an abort's origin without matching error text. A default
+ * `abort()` reason is an uncoded DOMException that carries nothing the synthetic
+ * error does not, so it keeps the "Request was aborted" text every transport
+ * already emits rather than churning it.
+ */
+declare function transportAbortError(signal?: AbortSignal): Error;
+type ProviderAcceptance = {
+  kind: "http_response";
+  status: number;
+  headers: Record<string, string>;
+} | {
+  kind: "provider_stream_opened";
+};
+type ProviderAcceptanceObserver = (acceptance: ProviderAcceptance) => void;
+type ProviderAcceptanceOptions = Pick<StreamOptions, "onResponse" | "signal">;
+type ProviderStreamCancel = (reason: Error) => void | Promise<void>;
+/** Attach an OpenClaw-internal provider acceptance observer to one model call. */
+declare function withProviderAcceptanceObserver<T extends object>(options: T, observer: ProviderAcceptanceObserver): T;
+/** Preserve the private provider acceptance observer when a built-in wrapper rebuilds options. */
+declare function copyProviderAcceptanceObserver<T extends object>(source: unknown, target: T): T;
+/** Report observed HTTP metadata; rejected responses use only onResponse. */
+declare function notifyProviderHttpMetadata(params: {
+  options?: ProviderAcceptanceOptions;
+  response: ProviderResponse;
+  model: Model;
+  cancelStream: ProviderStreamCancel;
+  signal?: AbortSignal;
+}): Promise<void>;
+/** Report a real HTTP response before body consumption. */
+declare function notifyProviderHttpResponse(params: {
+  options?: ProviderAcceptanceOptions;
+  response: Response;
+  model: Model;
+  cancelStream?: ProviderStreamCancel;
+  signal?: AbortSignal;
+}): Promise<void>;
+/** Report an accepted SDK stream when the SDK does not expose HTTP metadata. */
+declare function notifyProviderStreamOpened(params: {
+  options?: Pick<StreamOptions, "signal">;
+  cancelStream: ProviderStreamCancel;
+  signal?: AbortSignal;
+}): Promise<void>;
+/** Run a provider-response hook before start/body consumption inside the first-event deadline. */
+declare function withProviderResponseHook<T = never>(params: {
+  stream?: AsyncIterable<T>;
+  signal: AbortSignal;
+  abort: (reason: Error) => void;
+  hook?: () => void | Promise<void>;
+  onReady?: () => void;
+}): AsyncIterable<T>;
+declare function finalizeTransportStream(params: {
+  stream: WritableTransportStream;
+  output: AssistantMessage;
+  signal?: AbortSignal;
+}): void;
+/** @deprecated Use projectProviderError. v2026.7.2-beta.5 compatibility; remove after 2026.10. */
+declare function assignTransportErrorDetails(output: AssistantMessage, error: unknown, signal?: AbortSignal): ProviderErrorProjection;
+declare function failTransportStream(params: {
+  stream: WritableTransportStream;
+  output: AssistantMessage;
+  signal?: AbortSignal;
+  error: unknown;
+  cleanup?: () => void;
+}): void;
+//#endregion
+export { FirstStreamEventInternalOptions as C, getFirstStreamEventTimeoutHandler as D, createFirstStreamEventTimeoutError as E, getFirstStreamEventTimeoutMs as O, FirstStreamEventAbortController as S, createFirstStreamEventAbortController as T, sanitizeNonEmptyTransportPayloadText as _, copyProviderAcceptanceObserver as a, withProviderAcceptanceObserver as b, failTransportStream as c, mergeTransportHeaders as d, mergeTransportMetadata as f, parseTerminalToolCallArguments as g, notifyProviderStreamOpened as h, coerceTransportToolCallArguments as i, withFirstStreamEventTimeout as k, finalizeTerminalToolCallArguments as l, notifyProviderHttpResponse as m, WritableTransportStream as n, createEmptyTransportUsage as o, notifyProviderHttpMetadata as p, assignTransportErrorDetails as r, createWritableTransportEventStream as s, ProviderAcceptance as t, finalizeTransportStream as u, sanitizeTransportPayloadText as v, FirstStreamEventTimeoutContext as w, withProviderResponseHook as x, transportAbortError as y };

package/dist/{transport-utils-Bv0FHkd0.mjs → transport-utils-LJ1_rbi-.mjs}

@@ -1,13 +1,16 @@
-import { a as normalizeOptionalString } from "./string-coerce-fsri9iCu.mjs";
-import { n as getAiTransportHost } from "./host-DF_yxOsA.mjs";
-import { t as truncateUtf16Safe } from "./utf16-slice-CvGodqok.mjs";
-import { a as parseStrictFiniteNumber, n as asFiniteNumberInRange, o as parseStrictNonNegativeInteger } from "./number-coercion-H9qHik3g.mjs";
+import { d as normalizeOptionalString, t as truncateUtf16Safe } from "./utf16-slice-qz3nsy87.mjs";
+import { n as getAiTransportHost } from "./host-D51fmkH6.mjs";
+import { a as parseStrictFiniteNumber, n as asFiniteNumberInRange, o as parseStrictNonNegativeInteger, s as parseStrictPositiveInteger } from "./number-coercion-H9qHik3g.mjs";
 import { parseRetryAfterHttpDateMs } from "./internal/retry-after.mjs";
 import { createHash } from "node:crypto";
 //#region packages/ai/src/transports/transport-utils.ts
 const MALFORMED_STREAMING_FRAGMENT_ERROR_MESSAGE = "OpenClaw transport error: malformed_streaming_fragment";
 const NON_LATIN_RE = /[\u2E80-\u9FFF\uA000-\uA4FF\uAC00-\uD7AF\uF900-\uFAFF\uFF01-\uFF60\uFFE0-\uFFE6\u{20000}-\u{2FA1F}]/gu;
 const CJK_SURROGATE_HIGH_RE = /[\uD840-\uD87E][\uDC00-\uDFFF]/g;
+function parsePositiveInteger(value) {
+	if (typeof value === "number" && Number.isFinite(value) && value > 0) return Math.floor(value);
+	return typeof value === "string" ? parseStrictPositiveInteger(value) : void 0;
+}
 function sha256Hex(value) {
 	return createHash("sha256").update(value).digest("hex");
 }
@@ -135,4 +138,4 @@ async function readResponseTextSnippet(response, options) {
 	return truncated ? `${collapsed}…` : collapsed;
 }
 //#endregion
-export { isGoogleGemini3FlashModel as a, readResponseTextSnippet as c, resolveModelHeaderSentinels as d, resolveSecretSentinel as f, isCodeModeModelVisibleToolName as i, redactIdentifier as l, supportsModelTools as m, createAbortError as n, isGoogleGemini3ProModel as o, sha256Hex as p, estimateStringChars as r, parseRetryAfterSeconds as s, MALFORMED_STREAMING_FRAGMENT_ERROR_MESSAGE as t, redactSensitiveText as u };
+export { isGoogleGemini3FlashModel as a, parseRetryAfterSeconds as c, redactSensitiveText as d, resolveModelHeaderSentinels as f, supportsModelTools as h, isCodeModeModelVisibleToolName as i, readResponseTextSnippet as l, sha256Hex as m, createAbortError as n, isGoogleGemini3ProModel as o, resolveSecretSentinel as p, estimateStringChars as r, parsePositiveInteger as s, MALFORMED_STREAMING_FRAGMENT_ERROR_MESSAGE as t, redactIdentifier as u };