@openclaw/ai 2026.7.2-beta.7 → 2026.8.1-beta.1

package/dist/{types-bzp5k29J.d.mts → types-CH7ReIcU.d.mts}

@@ -217,6 +217,10 @@ interface Usage {
   output: number;
   cacheRead: number;
   cacheWrite: number;
+  /** Whether the provider reported a cache-read/write token split. */
+  cacheTelemetry?: {
+    state: "available" | "unavailable";
+  };
   /** Subset of `cacheWrite` written with 1-hour retention when reported. */
   cacheWrite1h?: number;
   /** Exact context snapshot for the final provider iteration. */

package/dist/types.d.mts

@@ -1,6 +1,6 @@
 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-SrGtwsJu.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 VercelGatewayRouting, A as OpenRouterRouting, B as TextContent, C as KnownImagesProvider, D as ModelThinkingLevel, E as Model, F as SimpleStreamOptions, G as ThinkingLevelMap, H as ThinkingBudgets, I as StopReason, J as ToolResultMessage, K as Tool, L as StreamFn, M as ProviderImagesOptions, N as ProviderResponse, O as OpenAICompletionsCompat, P as ProviderStreamOptions, Q as ValidateToolArgumentsFn, R as StreamFunction, S as KnownImagesApi, T as Message, U as ThinkingContent, V as TextSignatureV1, W as ThinkingLevel, X as Usage, Y as Transport, Z as UserMessage, _ as ImagesOptions, a as AssistantMessageEvent, b as ImagesStopReason, c as CacheRetention, d as ImageContent, f as ImagesApi, g as ImagesModel, h as ImagesInputContent, i as AssistantMessage, j as Provider, k as OpenAIResponsesCompat, l as CompleteSimpleFn, m as ImagesFunction, n as Api, o as AssistantMessageEventStreamContract, p as ImagesContext, q as ToolCall, r as AssistantImages, s as AssistantMessageEventStreamLike, t as AnthropicMessagesCompat, u as Context, v as ImagesOutputContent, w as MaybePromise, x as KnownApi, y as ImagesProvider, z as StreamOptions } from "./types-bzp5k29J.mjs";
-import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-YjaPW20U.mjs";
-import { n as validateToolCall, t as validateToolArguments } from "./validation-B-j7cOYp.mjs";
+import { $ as VercelGatewayRouting, A as OpenRouterRouting, B as TextContent, C as KnownImagesProvider, D as ModelThinkingLevel, E as Model, F as SimpleStreamOptions, G as ThinkingLevelMap, H as ThinkingBudgets, I as StopReason, J as ToolResultMessage, K as Tool, L as StreamFn, M as ProviderImagesOptions, N as ProviderResponse, O as OpenAICompletionsCompat, P as ProviderStreamOptions, Q as ValidateToolArgumentsFn, R as StreamFunction, S as KnownImagesApi, T as Message, U as ThinkingContent, V as TextSignatureV1, W as ThinkingLevel, X as Usage, Y as Transport, Z as UserMessage, _ as ImagesOptions, a as AssistantMessageEvent, b as ImagesStopReason, c as CacheRetention, d as ImageContent, f as ImagesApi, g as ImagesModel, h as ImagesInputContent, i as AssistantMessage, j as Provider, k as OpenAIResponsesCompat, l as CompleteSimpleFn, m as ImagesFunction, n as Api, o as AssistantMessageEventStreamContract, p as ImagesContext, q as ToolCall, r as AssistantImages, s as AssistantMessageEventStreamLike, t as AnthropicMessagesCompat, u as Context, v as ImagesOutputContent, w as MaybePromise, x as KnownApi, y as ImagesProvider, z as StreamOptions } from "./types-CH7ReIcU.mjs";
+import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-DRmDMRHH.mjs";
+import { n as validateToolCall, t as validateToolArguments } from "./validation-CcPcuEbR.mjs";
 export { AnthropicMessagesCompat, Api, AssistantImages, AssistantMessage, AssistantMessageDiagnostic, AssistantMessageEvent, AssistantMessageEventStream, AssistantMessageEventStreamContract, AssistantMessageEventStreamLike, CLAUDE_FABLE_5_THINKING_PROFILE, CLAUDE_OPUS_5_THINKING_PROFILE, CLAUDE_SONNET_5_THINKING_PROFILE, CacheRetention, CompleteSimpleFn, Context, DiagnosticErrorInfo, EventStream, ImageContent, ImagesApi, ImagesContext, ImagesFunction, ImagesInputContent, ImagesModel, ImagesOptions, ImagesOutputContent, ImagesProvider, ImagesStopReason, KnownApi, KnownImagesApi, KnownImagesProvider, MaybePromise, Message, Model, ModelThinkingLevel, OpenAICompletionsCompat, OpenAIResponsesCompat, OpenRouterRouting, Provider, ProviderImagesOptions, ProviderResponse, ProviderStreamOptions, SimpleStreamOptions, StopReason, StreamFn, StreamFunction, StreamOptions, TextContent, TextSignatureV1, ThinkingBudgets, ThinkingContent, ThinkingLevel, ThinkingLevelMap, Tool, ToolCall, ToolResultMessage, Transport, Usage, UserMessage, ValidateToolArgumentsFn, VercelGatewayRouting, appendAssistantMessageDiagnostic, createAssistantMessageDiagnostic, createAssistantMessageEventStream, extractDiagnosticError, formatThrownValue, requiresClaudeDefaultSampling, requiresClaudeMandatoryAdaptiveThinking, resolveClaudeFable5ModelIdentity, resolveClaudeModelIdentity, resolveClaudeMythos5ModelIdentity, resolveClaudeNativeThinkingLevelMap, resolveClaudeOpus5ModelIdentity, resolveClaudeSonnet5ModelIdentity, supportsClaude1MContext, supportsClaudeAdaptiveThinking, supportsClaudeFastMode, supportsClaudeNativeMaxEffort, supportsClaudeNativeXhighEffort, validateToolArguments, validateToolCall };

package/dist/types.mjs

@@ -1,5 +1,5 @@
 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 "./src-QkygScBs.mjs";
 import { i as formatThrownValue, n as createAssistantMessageDiagnostic, r as extractDiagnosticError, t as appendAssistantMessageDiagnostic } from "./diagnostics-COpOtRwq.mjs";
-import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-D8n2uFee.mjs";
+import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-CEV9t6da.mjs";
 import { n as validateToolCall, t as validateToolArguments } from "./validation-DAa_yFOM.mjs";
 export { AssistantMessageEventStream, CLAUDE_FABLE_5_THINKING_PROFILE, CLAUDE_OPUS_5_THINKING_PROFILE, CLAUDE_SONNET_5_THINKING_PROFILE, EventStream, appendAssistantMessageDiagnostic, createAssistantMessageDiagnostic, createAssistantMessageEventStream, extractDiagnosticError, formatThrownValue, requiresClaudeDefaultSampling, requiresClaudeMandatoryAdaptiveThinking, resolveClaudeFable5ModelIdentity, resolveClaudeModelIdentity, resolveClaudeMythos5ModelIdentity, resolveClaudeNativeThinkingLevelMap, resolveClaudeOpus5ModelIdentity, resolveClaudeSonnet5ModelIdentity, supportsClaude1MContext, supportsClaudeAdaptiveThinking, supportsClaudeFastMode, supportsClaudeNativeMaxEffort, supportsClaudeNativeXhighEffort, validateToolArguments, validateToolCall };

package/dist/{validation-B-j7cOYp.d.mts → validation-CcPcuEbR.d.mts}

@@ -1,4 +1,4 @@
-import { K as Tool, q as ToolCall } from "./types-bzp5k29J.mjs";
+import { K as Tool, q as ToolCall } from "./types-CH7ReIcU.mjs";
 
 //#region packages/llm-core/src/validation.d.ts
 /** Finds the target tool and validates/coerces a model-emitted tool call. */

package/dist/validation.d.mts

@@ -1,2 +1,2 @@
-import { n as validateToolCall, t as validateToolArguments } from "./validation-B-j7cOYp.mjs";
+import { n as validateToolCall, t as validateToolArguments } from "./validation-CcPcuEbR.mjs";
 export { validateToolArguments, validateToolCall };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/ai",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.1",
   "description": "Reusable model provider adapters and streaming runtime from OpenClaw",
   "keywords": [
     "ai",

package/dist/error-coercion-DgxlWC0n.mjs

@@ -1,15 +0,0 @@
-//#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/number-coercion-DvG7SNMg.mjs

@@ -1,129 +0,0 @@
-import { a as requiresClaudeMandatoryAdaptiveThinking, l as resolveClaudeNativeThinkingLevelMap } from "./src-QkygScBs.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) {
-	const cacheWrite1h = Math.min(usage.cacheWrite, Math.max(0, usage.cacheWrite1h ?? 0));
-	const cacheWrite5m = usage.cacheWrite - cacheWrite1h;
-	usage.cost.input = model.cost.input / 1e6 * usage.input;
-	usage.cost.output = model.cost.output / 1e6 * usage.output;
-	usage.cost.cacheRead = model.cost.cacheRead / 1e6 * usage.cacheRead;
-	usage.cost.cacheWrite = (model.cost.cacheWrite * cacheWrite5m + model.cost.input * 2 * cacheWrite1h) / 1e6;
-	usage.cost.total = usage.cost.input + usage.cost.output + usage.cost.cacheRead + usage.cost.cacheWrite;
-	return usage.cost;
-}
-/** Replaces the catalog estimate when the provider reports an authoritative billed total. */
-function applyProviderReportedUsageCost(usage, reportedCost) {
-	if (typeof reportedCost !== "number" || !Number.isFinite(reportedCost) || reportedCost < 0) return;
-	usage.cost.total = reportedCost;
-	usage.cost.totalOrigin = "provider-billed";
-}
-const EXTENDED_THINKING_LEVELS = [
-	"off",
-	"minimal",
-	"low",
-	"medium",
-	"high",
-	"xhigh",
-	"max"
-];
-function resolveThinkingLevelMap(model) {
-	return model.api === "anthropic-messages" ? resolveClaudeNativeThinkingLevelMap(model) ?? model.thinkingLevelMap : model.thinkingLevelMap;
-}
-/** Returns thinking levels exposed by a reasoning-capable model. */
-function getSupportedThinkingLevels(model) {
-	const mandatoryAdaptiveContract = model.api === "anthropic-messages" && requiresClaudeMandatoryAdaptiveThinking(model);
-	if (!model.reasoning && !mandatoryAdaptiveContract) return ["off"];
-	const thinkingLevelMap = resolveThinkingLevelMap(model);
-	return EXTENDED_THINKING_LEVELS.filter((level) => {
-		const mapped = thinkingLevelMap?.[level];
-		if (mapped === null) return false;
-		if (level === "xhigh" || level === "max") return mapped !== void 0;
-		return true;
-	});
-}
-/** Clamps a requested thinking level to the closest supported level for a model. */
-function clampThinkingLevel(model, level) {
-	const availableLevels = getSupportedThinkingLevels(model);
-	if (availableLevels.includes(level)) return level;
-	const requestedIndex = EXTENDED_THINKING_LEVELS.indexOf(level);
-	if (requestedIndex === -1) return availableLevels[0] ?? "off";
-	const thinkingLevelMap = resolveThinkingLevelMap(model);
-	if ((level === "xhigh" || level === "max") && thinkingLevelMap?.[level] === null) {
-		for (const candidate of EXTENDED_THINKING_LEVELS.slice(0, requestedIndex).toReversed()) if (availableLevels.includes(candidate)) return candidate;
-	}
-	for (const candidate of EXTENDED_THINKING_LEVELS.slice(requestedIndex)) if (availableLevels.includes(candidate)) return candidate;
-	for (const candidate of EXTENDED_THINKING_LEVELS.slice(0, requestedIndex).toReversed()) if (availableLevels.includes(candidate)) return candidate;
-	return availableLevels[0] ?? "off";
-}
-/** Compares model identity by provider and id. */
-function modelsAreEqual(a, b) {
-	if (!a || !b) return false;
-	return a.id === b.id && a.provider === b.provider;
-}
-//#endregion
-//#region packages/normalization-core/src/number-coercion.ts
-/** Returns a number only when the input is already finite. */
-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. */
-function clampTimerTimeoutMs(valueMs, minMs = 1) {
-	const value = asFiniteNumber(valueMs);
-	if (value === void 0) return;
-	return Math.min(Math.max(Math.floor(value), Math.max(1, Math.floor(minMs))), MAX_TIMER_TIMEOUT_MS);
-}
-/** Resolves arbitrary timeout input with fallback and minimum timer bounds. */
-function resolveTimerTimeoutMs(valueMs, fallbackMs, minMs = 1) {
-	const value = asFiniteNumber(valueMs) ?? asFiniteNumber(fallbackMs);
-	const min = Math.max(0, Math.floor(minMs));
-	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
-export { parseStrictPositiveInteger as a, calculateCost as c, modelsAreEqual as d, parseStrictNonNegativeInteger as i, clampThinkingLevel as l, clampTimerTimeoutMs as n, resolveTimerTimeoutMs as o, parseStrictFiniteNumber as r, applyProviderReportedUsageCost as s, asFiniteNumberInRange as t, getSupportedThinkingLevels as u };

package/dist/openai-completions-compat-DBWjXoMZ.d.mts

@@ -1,43 +0,0 @@
-import { E as Model, O as OpenAICompletionsCompat } from "./types-bzp5k29J.mjs";
-import { a as AiProviderRequestPolicyInput, i as AiProviderRequestCapabilities } from "./host-B9GUmcra.mjs";
-
-//#region packages/ai/src/transports/openai-completions-compat.d.ts
-type ProviderRequestCapabilities = AiProviderRequestCapabilities;
-type OpenAICompletionsSessionAffinity = "none" | "openai" | "openrouter";
-type OpenAICompletionsCompatDefaults = {
-  supportsStore: boolean;
-  supportsDeveloperRole: boolean;
-  supportsReasoningEffort: boolean;
-  supportsUsageInStreaming: boolean;
-  maxTokensField: "max_completion_tokens" | "max_tokens";
-  thinkingFormat: "openai" | "openrouter" | "deepseek" | "together" | "zai";
-  visibleReasoningDetailTypes: string[];
-  supportsStrictMode: boolean;
-  supportsJsonSchemaResponseFormat: boolean;
-  requiresReasoningContentOnAssistantMessages: boolean;
-  requiresNonEmptyUserOrAssistantMessage: boolean;
-  cacheControlFormat?: OpenAICompletionsCompat["cacheControlFormat"];
-  sessionAffinityFormat: Exclude<OpenAICompletionsSessionAffinity, "none">;
-  supportsLongCacheRetention: boolean;
-};
-type DetectedOpenAICompletionsCompat = {
-  capabilities: ProviderRequestCapabilities;
-  defaults: OpenAICompletionsCompatDefaults;
-};
-type ResolvedOpenAICompletionsCompat = Omit<Required<OpenAICompletionsCompat>, "cacheControlFormat" | "openRouterRouting" | "sendSessionAffinityHeaders"> & {
-  cacheControlFormat?: OpenAICompletionsCompat["cacheControlFormat"];
-  openRouterRouting?: OpenAICompletionsCompat["openRouterRouting"];
-  sessionAffinity: OpenAICompletionsSessionAffinity;
-  visibleReasoningDetailTypes: string[];
-  requiresNonEmptyUserOrAssistantMessage: boolean;
-};
-/** Detects endpoint capabilities and defaults for an OpenAI-completions model. */
-declare function detectOpenAICompletionsCompat(model: Pick<Model<"openai-completions">, "provider" | "baseUrl" | "id"> & {
-  compat?: {
-    supportsStore?: boolean;
-  } | null;
-}, resolveCapabilities?: (input: AiProviderRequestPolicyInput) => ProviderRequestCapabilities): DetectedOpenAICompletionsCompat;
-/** Applies explicit model overrides once on top of the canonical transport defaults. */
-declare function resolveOpenAICompletionsCompat(model: Model<"openai-completions">, resolveCapabilities?: (input: AiProviderRequestPolicyInput) => ProviderRequestCapabilities): ResolvedOpenAICompletionsCompat;
-//#endregion
-export { detectOpenAICompletionsCompat as n, resolveOpenAICompletionsCompat as r, ResolvedOpenAICompletionsCompat as t };

package/dist/simple-options-9lhRrN73.mjs

@@ -1,50 +0,0 @@
-//#region packages/ai/src/providers/simple-options.ts
-function buildBaseOptions(model, options, apiKey) {
-	const firstEventOptions = options;
-	return {
-		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 { clampReasoning as i, buildBaseOptions as n, clampMaxTokensToModel as r, adjustMaxTokensForThinking as t };

package/dist/transform-messages-C8mBqZxF.mjs

@@ -1,2 +0,0 @@
-import "./host-Dog2WQiR.mjs";
-export {};