@openclaw/ai 2026.9.1 → 2026.9.3

package/dist/types-BADKjDBI.d.mts

@@ -0,0 +1 @@
+import "./index-CQ6LTHw8.mjs";

package/dist/{types-DbrhszyQ.d.mts → types-Dy1q0CSu.d.mts}

@@ -1,5 +1,64 @@
 import { t as AssistantMessageDiagnostic } from "./diagnostics-DnPnOui6.mjs";
 import { TSchema } from "typebox";
+//#region packages/llm-core/src/model-data.d.ts
+declare const MODEL_DATA_THINKING_FORMATS: readonly ["openai", "openrouter", "deepseek", "together", "qwen", "qwen-chat-template", "zai"];
+type ModelDataThinkingFormat = (typeof MODEL_DATA_THINKING_FORMATS)[number];
+declare const MODEL_DATA_THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+type ModelDataThinkingLevel = (typeof MODEL_DATA_THINKING_LEVELS)[number];
+type ModelDataThinkingLevelMap = Partial<Record<ModelDataThinkingLevel, string | null>>;
+type ModelDataImageInputConfig = {
+  /** Provider-documented maximum encoded image payload size. */
+  maxBytes?: number;
+  /** Provider-documented maximum accepted input pixels. */
+  maxPixels?: number;
+  /** Provider-documented maximum accepted width/height in pixels. */
+  maxSidePx?: number;
+  /** Preferred resize side for the default balanced compression policy. */
+  preferredSidePx?: number;
+  /** Token accounting style, used as documentation for provider-owned policy. */
+  tokenMode?: "tile" | "detail" | "provider";
+};
+type ModelDataMediaInputConfig = {
+  /** Image input limits and accounting hints for this model. */
+  image?: ModelDataImageInputConfig;
+};
+/** Per-million-token rates for separately billed token buckets. */
+type ModelDataCostRates = {
+  input: number;
+  output: number;
+  cacheRead: number;
+  cacheWrite: number;
+};
+type ModelDataRawPricingTier = ModelDataCostRates & {
+  /** Half-open prompt-token interval; `[start]` is an open-ended upper tier. */
+  range: [number, number] | [number];
+};
+type ModelRoutingSortConfig = {
+  /** The sorting metric: "price", "throughput", "latency". */
+  by?: string;
+  /** Partitioning strategy: "model" (default) or "none". */
+  partition?: string | null;
+};
+type ModelRoutingMaxPrice = {
+  /** Price per million prompt tokens. */
+  prompt?: number | string;
+  /** Price per million completion tokens. */
+  completion?: number | string;
+  /** Price per image. */
+  image?: number | string;
+  /** Price per audio unit. */
+  audio?: number | string;
+  /** Price per request. */
+  request?: number | string;
+};
+/** Percentile targets in the owning field's throughput or latency units. */
+type ModelRoutingPercentiles = {
+  p50?: number;
+  p75?: number;
+  p90?: number;
+  p99?: number;
+};
+//#endregion
 //#region packages/llm-core/src/types.d.ts
 /** Provider API families with first-class request/stream adapters in OpenClaw. */
 type KnownApi = "openai-completions" | "mistral-conversations" | "openai-responses" | "azure-openai-responses" | "openai-chatgpt-responses" | "anthropic-messages" | "bedrock-converse-stream" | "google-generative-ai" | "google-vertex";
@@ -16,11 +75,11 @@ type KnownImagesProvider = "openrouter";
 /** Image provider id used for routing, diagnostics, and config lookups. */
 type ImagesProvider = string;
 /** Normalized reasoning-effort levels shared across provider-specific knobs. */
-type ThinkingLevel = "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+type ThinkingLevel = Exclude<ModelDataThinkingLevel, "off">;
 /** Model thinking setting including explicit disabled state. */
-type ModelThinkingLevel = "off" | ThinkingLevel;
+type ModelThinkingLevel = ModelDataThinkingLevel;
 /** Provider-specific values for normalized thinking levels. */
-type ThinkingLevelMap = Partial<Record<ModelThinkingLevel, string | null>>;
+type ThinkingLevelMap = ModelDataThinkingLevelMap;
 /** Token budgets for each thinking level (token-based providers only) */
 interface ThinkingBudgets {
   minimal?: number;
@@ -93,6 +152,23 @@ interface StreamOptions {
    * its body stream is consumed.
    */
   onResponse?: (response: ProviderResponse, model: Model) => void | Promise<void>;
+  /**
+   * Observe a live response that accepts user input before generation finishes.
+   * `steer` resolves false only when the input was definitely not admitted;
+   * admitted input cannot be withdrawn. Providers settle pending submissions
+   * before closing the response and call the returned cleanup on closure.
+   */
+  onActiveResponse?: (control: {
+    steer(messages: readonly UserMessage[]): Promise<boolean>;
+    /** Read-only after closure: deferred input still needs an explicit continuation request. */
+    needsContinuation?: () => boolean;
+  }) => (() => void) | void;
+  /**
+   * The caller can execute completed async calls before generation finishes.
+   * Providers advertise async tools only with this host capability; this is
+   * independent of parallel execution of an ordinary completed tool batch.
+   */
+  asyncToolExecution?: boolean;
   /**
    * Optional custom HTTP headers to include in API requests.
    * Merged with provider defaults; can override default headers.
@@ -104,6 +180,8 @@ interface StreamOptions {
    * For example, OpenAI and Anthropic SDK clients default to 10 minutes.
    */
   timeoutMs?: number;
+  /** @deprecated Ignored by built-in text transports; retries are owned by the host runner. */
+  maxRetries?: number;
   /**
    * Maximum delay in milliseconds to wait for a retry when the server requests a long wait.
    * If the server's requested delay exceeds this value, the request fails immediately
@@ -212,6 +290,8 @@ interface ImageContent {
 }
 /** Normalized assistant tool call emitted by providers or repaired from text. */
 interface ToolCall {
+  /** The provider completed this call and permits generation to continue without its result. */
+  async?: true;
   type: "toolCall";
   id: string;
   name: string;
@@ -251,16 +331,13 @@ interface Usage {
   };
 }
 /** Per-million-token rates for separately billed token buckets. */
-type ModelCostRates = Pick<Usage["cost"], "input" | "output" | "cacheRead" | "cacheWrite">;
+type ModelCostRates = ModelDataCostRates;
 /** One whole-request tier on the cache-inclusive prompt-token axis. */
 type PricingTier = ModelCostRates & {
   /** Half-open prompt-token interval `[start, end)`. */
   range: [number, number];
 };
-type RawPricingTier = ModelCostRates & {
-  /** `[start]` is an open-ended upper tier. */
-  range: [number, number] | [number];
-};
+type RawPricingTier = ModelDataRawPricingTier;
 /** Normalized pricing used by token accounting and usage summaries. */
 type ModelCostConfig = ModelCostRates & {
   tieredPricing?: PricingTier[];
@@ -279,12 +356,9 @@ interface UserMessage {
   content: string | (TextContent | ImageContent)[];
   timestamp: number;
   /**
-   * Marks a user message that carries transient current-turn runtime context
-   * (e.g. an OpenClaw runtime-context carrier appended after the active user
-   * turn). Such messages are volatile — present only on the turn they belong to
-   * and stripped on replay — so providers must NOT anchor a prompt-cache
-   * breakpoint on them, or the breakpoint would land on bytes that change every
-   * turn. Anchoring stays on the last stable (non-carrier) user message.
+   * Marks a user message carrying runtime context. Provider replay policy decides
+   * whether the carrier is transient or retained append-only; only retained
+   * carriers are stable prompt-cache anchors.
    */
   runtimeContextCarrier?: boolean;
 }
@@ -479,7 +553,7 @@ interface OpenAICompletionsCompat {
   /** Whether all replayed assistant messages must include an empty reasoning_content field when reasoning is enabled. Default: auto-detected from URL. */
   requiresReasoningContentOnAssistantMessages?: boolean;
   /** Format for reasoning/thinking parameter. "openai" uses reasoning_effort, "openrouter" uses reasoning: { effort }, "deepseek" uses thinking: { type } plus reasoning_effort, "together" uses reasoning: { enabled } plus reasoning_effort when supported, "zai" uses top-level enable_thinking: boolean, "qwen" uses top-level enable_thinking: boolean, and "qwen-chat-template" uses chat_template_kwargs.enable_thinking. Default: "openai". */
-  thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
+  thinkingFormat?: ModelDataThinkingFormat;
   /** OpenRouter-specific routing preferences. Only used when baseUrl points to OpenRouter. */
   openRouterRouting?: OpenRouterRouting;
   /** Vercel AI Gateway routing preferences. Only used when baseUrl points to Vercel AI Gateway. */
@@ -503,6 +577,10 @@ interface OpenAICompletionsCompat {
 interface OpenAIResponsesCompat {
   /** Whether the provider supports the `developer` role (vs `system`). Default: true. */
   supportsDeveloperRole?: boolean;
+  /** Whether to send reasoning effort settings. Defaults to the model's known capabilities. */
+  supportsReasoningEffort?: boolean;
+  /** Provider-native reasoning efforts accepted by the model. Overrides known model defaults. */
+  supportedReasoningEfforts?: string[];
   /** Whether the model accepts the `temperature` parameter. Default: true. */
   supportsTemperature?: boolean;
   /** Whether to send the OpenAI `session_id` cache-affinity header from `options.sessionId` when caching is enabled. Default: true. */
@@ -547,6 +625,7 @@ interface AnthropicMessagesCompat {
  * OpenRouter provider routing preferences.
  * Controls which upstream providers OpenRouter routes requests to.
  * Sent as the `provider` field in the OpenRouter API request body.
+ * Own member declarations preserve existing module-augmentation semantics.
  * @see https://openrouter.ai/docs/guides/routing/provider-selection
  */
 interface OpenRouterRouting {
@@ -569,47 +648,13 @@ interface OpenRouterRouting {
   /** A list of quantization levels to filter providers by (e.g., ["fp16", "bf16", "fp8", "fp6", "int8", "int4", "fp4", "fp32"]). */
   quantizations?: string[];
   /** Sorting strategy. Can be a string (e.g., "price", "throughput", "latency") or an object with `by` and `partition`. */
-  sort?: string | {
-    /** The sorting metric: "price", "throughput", "latency". */
-    by?: string;
-    /** Partitioning strategy: "model" (default) or "none". */
-    partition?: string | null;
-  };
+  sort?: string | ModelRoutingSortConfig;
   /** Maximum price per million tokens (USD). */
-  max_price?: {
-    /** Price per million prompt tokens. */
-    prompt?: number | string;
-    /** Price per million completion tokens. */
-    completion?: number | string;
-    /** Price per image. */
-    image?: number | string;
-    /** Price per audio unit. */
-    audio?: number | string;
-    /** Price per request. */
-    request?: number | string;
-  };
+  max_price?: ModelRoutingMaxPrice;
   /** Preferred minimum throughput (tokens/second). Can be a number (applies to p50) or an object with percentile-specific cutoffs. */
-  preferred_min_throughput?: number | {
-    /** Minimum tokens/second at the 50th percentile. */
-    p50?: number;
-    /** Minimum tokens/second at the 75th percentile. */
-    p75?: number;
-    /** Minimum tokens/second at the 90th percentile. */
-    p90?: number;
-    /** Minimum tokens/second at the 99th percentile. */
-    p99?: number;
-  };
+  preferred_min_throughput?: number | ModelRoutingPercentiles;
   /** Preferred maximum latency (seconds). Can be a number (applies to p50) or an object with percentile-specific cutoffs. */
-  preferred_max_latency?: number | {
-    /** Maximum latency in seconds at the 50th percentile. */
-    p50?: number;
-    /** Maximum latency in seconds at the 75th percentile. */
-    p75?: number;
-    /** Maximum latency in seconds at the 90th percentile. */
-    p90?: number;
-    /** Maximum latency in seconds at the 99th percentile. */
-    p99?: number;
-  };
+  preferred_max_latency?: number | ModelRoutingPercentiles;
 }
 /**
  * Vercel AI Gateway routing preferences.
@@ -650,17 +695,9 @@ interface Model<TApi extends Api = Api> {
   /** Sends runtime credentials as Authorization: Bearer instead of provider-specific key headers. */
   authHeader?: boolean;
   /** Compatibility overrides for OpenAI-compatible APIs. If not set, auto-detected from baseUrl. */
-  compat?: TApi extends "openai-completions" ? OpenAICompletionsCompat : TApi extends "openai-responses" ? OpenAIResponsesCompat : TApi extends "anthropic-messages" ? AnthropicMessagesCompat : never;
+  compat?: TApi extends "openai-completions" ? OpenAICompletionsCompat : TApi extends "openai-responses" | "azure-openai-responses" | "openai-codex-responses" ? OpenAIResponsesCompat : TApi extends "anthropic-messages" ? AnthropicMessagesCompat : never;
   /** Provider-documented media input limits used by attachment preprocessing. */
-  mediaInput?: {
-    image?: {
-      maxBytes?: number;
-      maxPixels?: number;
-      maxSidePx?: number;
-      preferredSidePx?: number;
-      tokenMode?: "tile" | "detail" | "provider";
-    };
-  };
+  mediaInput?: ModelDataMediaInputConfig;
 }
 interface ImagesModel<TApi extends ImagesApi = ImagesApi> extends Omit<Model, "api" | "provider" | "reasoning" | "contextWindow" | "maxTokens" | "compat"> {
   api: TApi;
@@ -671,4 +708,4 @@ type StreamFn = (model: Model, context: Context, options?: SimpleStreamOptions)
 type CompleteSimpleFn = (model: Model, context: Pick<Context, "systemPrompt" | "messages">, options?: SimpleStreamOptions) => Promise<AssistantMessage>;
 type ValidateToolArgumentsFn = (tool: Tool, toolCall: ToolCall) => unknown;
 //#endregion
-export { ThinkingLevel as $, ModelThinkingLevel as A, ProviderResponse as B, KnownImagesApi as C, Model as D, Message as E, PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE as F, StopReason as G, RawModelCostConfig as H, PricingTier as I, StreamOptions as J, StreamFn as K, Provider as L, OpenAIResponsesCompat as M, OpenRouterRouting as N, ModelCostConfig as O, PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE as P, ThinkingContent as Q, ProviderImagesOptions as R, KnownApi as S, MaybePromise as T, RawPricingTier as U, ProviderStreamOptions as V, SimpleStreamOptions as W, TextSignatureV1 as X, TextContent as Y, ThinkingBudgets as Z, ImagesModel as _, AssistantMessage as a, Usage as at, ImagesProvider as b, AssistantMessageEventStreamLike as c, VercelGatewayRouting as ct, Context as d, ThinkingLevelMap as et, ImageContent as f, ImagesInputContent as g, ImagesFunction as h, AssistantImages as i, Transport as it, OpenAICompletionsCompat as j, ModelCostRates as k, CacheRetention as l, ImagesContext as m, Api as n, ToolCall as nt, AssistantMessageEvent as o, UserMessage as ot, ImagesApi as p, StreamFunction as q, AssistantDeliveryTtsFacts as r, ToolResultMessage as rt, AssistantMessageEventStreamContract as s, ValidateToolArgumentsFn as st, AnthropicMessagesCompat as t, Tool as tt, CompleteSimpleFn as u, ImagesOptions as v, KnownImagesProvider as w, ImagesStopReason as x, ImagesOutputContent as y, ProviderReplayState as z };
+export { ThinkingLevel as $, ModelThinkingLevel as A, ProviderResponse as B, KnownImagesApi as C, Model as D, Message as E, PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE as F, StopReason as G, RawModelCostConfig as H, PricingTier as I, StreamOptions as J, StreamFn as K, Provider as L, OpenAIResponsesCompat as M, OpenRouterRouting as N, ModelCostConfig as O, PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE as P, ThinkingContent as Q, ProviderImagesOptions as R, KnownApi as S, MaybePromise as T, RawPricingTier as U, ProviderStreamOptions as V, SimpleStreamOptions as W, TextSignatureV1 as X, TextContent as Y, ThinkingBudgets as Z, ImagesModel as _, AssistantMessage as a, Usage as at, ImagesProvider as b, AssistantMessageEventStreamLike as c, VercelGatewayRouting as ct, Context as d, ThinkingLevelMap as et, ImageContent as f, ImagesInputContent as g, ImagesFunction as h, AssistantImages as i, Transport as it, OpenAICompletionsCompat as j, ModelCostRates as k, CacheRetention as l, ModelDataThinkingFormat as lt, ImagesContext as m, Api as n, ToolCall as nt, AssistantMessageEvent as o, UserMessage as ot, ImagesApi as p, StreamFunction as q, AssistantDeliveryTtsFacts as r, ToolResultMessage as rt, AssistantMessageEventStreamContract as s, ValidateToolArgumentsFn as st, AnthropicMessagesCompat as t, Tool as tt, CompleteSimpleFn as u, ImagesOptions as v, KnownImagesProvider as w, ImagesStopReason as x, ImagesOutputContent as y, ProviderReplayState as z };

package/dist/types.d.mts

@@ -1,7 +1,7 @@
-import { _ as supportsClaudeAdaptiveThinking, a as CLAUDE_FABLE_5_THINKING_PROFILE, b as supportsClaudeNativeXhighEffort, c as requiresClaudeDefaultSampling, d as resolveClaudeModelIdentity, f as resolveClaudeMythos5ModelIdentity, g as supportsClaude1MContext, h as resolveClaudeSonnet5ModelIdentity, i as normalizeResolvedPricing, l as requiresClaudeMandatoryAdaptiveThinking, m as resolveClaudeOpus5ModelIdentity, n as calculateUsageCost, o as CLAUDE_OPUS_5_THINKING_PROFILE, p as resolveClaudeNativeThinkingLevelMap, r as normalizeModelCostConfig, s as CLAUDE_SONNET_5_THINKING_PROFILE, u as resolveClaudeFable5ModelIdentity, v as supportsClaudeFastMode, y as supportsClaudeNativeMaxEffort } from "./index-AfaxKT8w.mjs";
+import { _ as supportsClaude1MContext, a as CLAUDE_FABLE_5_THINKING_PROFILE, b as supportsClaudeNativeMaxEffort, c as bindsClaudeThinkingPrefix, d as resolveClaudeFable5ModelIdentity, f as resolveClaudeModelIdentity, g as resolveClaudeSonnet5ModelIdentity, h as resolveClaudeOpus5ModelIdentity, i as normalizeResolvedPricing, l as requiresClaudeDefaultSampling, m as resolveClaudeNativeThinkingLevelMap, n as calculateUsageCost, o as CLAUDE_OPUS_5_THINKING_PROFILE, p as resolveClaudeMythos5ModelIdentity, r as normalizeModelCostConfig, s as CLAUDE_SONNET_5_THINKING_PROFILE, u as requiresClaudeMandatoryAdaptiveThinking, v as supportsClaudeAdaptiveThinking, x as supportsClaudeNativeXhighEffort, y as supportsClaudeFastMode } from "./index-CQ6LTHw8.mjs";
+import { $ as ThinkingLevel, A as ModelThinkingLevel, B as ProviderResponse, C as KnownImagesApi, D as Model, E as Message, F as PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, G as StopReason, H as RawModelCostConfig, I as PricingTier, J as StreamOptions, K as StreamFn, L as Provider, M as OpenAIResponsesCompat, N as OpenRouterRouting, O as ModelCostConfig, P as PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, Q as ThinkingContent, R as ProviderImagesOptions, S as KnownApi, T as MaybePromise, U as RawPricingTier, V as ProviderStreamOptions, W as SimpleStreamOptions, X as TextSignatureV1, Y as TextContent, Z as ThinkingBudgets, _ as ImagesModel, a as AssistantMessage, at as Usage, b as ImagesProvider, c as AssistantMessageEventStreamLike, ct as VercelGatewayRouting, d as Context, et as ThinkingLevelMap, f as ImageContent, g as ImagesInputContent, h as ImagesFunction, i as AssistantImages, it as Transport, j as OpenAICompletionsCompat, k as ModelCostRates, l as CacheRetention, m as ImagesContext, n as Api, nt as ToolCall, o as AssistantMessageEvent, ot as UserMessage, p as ImagesApi, q as StreamFunction, r as AssistantDeliveryTtsFacts, rt as ToolResultMessage, s as AssistantMessageEventStreamContract, st as ValidateToolArgumentsFn, t as AnthropicMessagesCompat, tt as Tool, u as CompleteSimpleFn, v as ImagesOptions, w as KnownImagesProvider, x as ImagesStopReason, y as ImagesOutputContent, z as ProviderReplayState } from "./types-Dy1q0CSu.mjs";
 import { a as extractDiagnosticError, i as createAssistantMessageDiagnostic, n as DiagnosticErrorInfo, o as formatThrownValue, r as appendAssistantMessageDiagnostic, s as isProviderRefusalAssistantError, t as AssistantMessageDiagnostic } from "./diagnostics-DnPnOui6.mjs";
-import { $ as ThinkingLevel, A as ModelThinkingLevel, B as ProviderResponse, C as KnownImagesApi, D as Model, E as Message, F as PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, G as StopReason, H as RawModelCostConfig, I as PricingTier, J as StreamOptions, K as StreamFn, L as Provider, M as OpenAIResponsesCompat, N as OpenRouterRouting, O as ModelCostConfig, P as PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, Q as ThinkingContent, R as ProviderImagesOptions, S as KnownApi, T as MaybePromise, U as RawPricingTier, V as ProviderStreamOptions, W as SimpleStreamOptions, X as TextSignatureV1, Y as TextContent, Z as ThinkingBudgets, _ as ImagesModel, a as AssistantMessage, at as Usage, b as ImagesProvider, c as AssistantMessageEventStreamLike, ct as VercelGatewayRouting, d as Context, et as ThinkingLevelMap, f as ImageContent, g as ImagesInputContent, h as ImagesFunction, i as AssistantImages, it as Transport, j as OpenAICompletionsCompat, k as ModelCostRates, l as CacheRetention, m as ImagesContext, n as Api, nt as ToolCall, o as AssistantMessageEvent, ot as UserMessage, p as ImagesApi, q as StreamFunction, r as AssistantDeliveryTtsFacts, rt as ToolResultMessage, s as AssistantMessageEventStreamContract, st as ValidateToolArgumentsFn, t as AnthropicMessagesCompat, tt as Tool, u as CompleteSimpleFn, v as ImagesOptions, w as KnownImagesProvider, x as ImagesStopReason, y as ImagesOutputContent, z as ProviderReplayState } from "./types-DbrhszyQ.mjs";
-import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-vK_7r3bj.mjs";
-import { n as validateToolCall, t as validateToolArguments } from "./validation-BOwtcl9X.mjs";
-import "./types-B5EFUmXs.mjs";
-export { AnthropicMessagesCompat, Api, AssistantDeliveryTtsFacts, 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, ModelCostConfig, ModelCostRates, ModelThinkingLevel, OpenAICompletionsCompat, OpenAIResponsesCompat, OpenRouterRouting, PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, PricingTier, Provider, ProviderImagesOptions, ProviderReplayState, ProviderResponse, ProviderStreamOptions, RawModelCostConfig, RawPricingTier, SimpleStreamOptions, StopReason, StreamFn, StreamFunction, StreamOptions, TextContent, TextSignatureV1, ThinkingBudgets, ThinkingContent, ThinkingLevel, ThinkingLevelMap, Tool, ToolCall, ToolResultMessage, Transport, Usage, UserMessage, ValidateToolArgumentsFn, VercelGatewayRouting, appendAssistantMessageDiagnostic, calculateUsageCost, createAssistantMessageDiagnostic, createAssistantMessageEventStream, extractDiagnosticError, formatThrownValue, isProviderRefusalAssistantError, normalizeModelCostConfig, normalizeResolvedPricing, requiresClaudeDefaultSampling, requiresClaudeMandatoryAdaptiveThinking, resolveClaudeFable5ModelIdentity, resolveClaudeModelIdentity, resolveClaudeMythos5ModelIdentity, resolveClaudeNativeThinkingLevelMap, resolveClaudeOpus5ModelIdentity, resolveClaudeSonnet5ModelIdentity, supportsClaude1MContext, supportsClaudeAdaptiveThinking, supportsClaudeFastMode, supportsClaudeNativeMaxEffort, supportsClaudeNativeXhighEffort, validateToolArguments, validateToolCall };
+import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-C1Z2piyk.mjs";
+import { n as validateToolCall, t as validateToolArguments } from "./validation-CaFUZN9B.mjs";
+import "./types-BADKjDBI.mjs";
+export { AnthropicMessagesCompat, Api, AssistantDeliveryTtsFacts, 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, ModelCostConfig, ModelCostRates, ModelThinkingLevel, OpenAICompletionsCompat, OpenAIResponsesCompat, OpenRouterRouting, PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, PricingTier, Provider, ProviderImagesOptions, ProviderReplayState, ProviderResponse, ProviderStreamOptions, RawModelCostConfig, RawPricingTier, SimpleStreamOptions, StopReason, StreamFn, StreamFunction, StreamOptions, TextContent, TextSignatureV1, ThinkingBudgets, ThinkingContent, ThinkingLevel, ThinkingLevelMap, Tool, ToolCall, ToolResultMessage, Transport, Usage, UserMessage, ValidateToolArgumentsFn, VercelGatewayRouting, appendAssistantMessageDiagnostic, bindsClaudeThinkingPrefix, calculateUsageCost, createAssistantMessageDiagnostic, createAssistantMessageEventStream, extractDiagnosticError, formatThrownValue, isProviderRefusalAssistantError, normalizeModelCostConfig, normalizeResolvedPricing, requiresClaudeDefaultSampling, requiresClaudeMandatoryAdaptiveThinking, resolveClaudeFable5ModelIdentity, resolveClaudeModelIdentity, resolveClaudeMythos5ModelIdentity, resolveClaudeNativeThinkingLevelMap, resolveClaudeOpus5ModelIdentity, resolveClaudeSonnet5ModelIdentity, supportsClaude1MContext, supportsClaudeAdaptiveThinking, supportsClaudeFastMode, supportsClaudeNativeMaxEffort, supportsClaudeNativeXhighEffort, validateToolArguments, validateToolCall };

package/dist/types.mjs

@@ -1,6 +1,6 @@
-import { _ as supportsClaudeFastMode, a as CLAUDE_OPUS_5_THINKING_PROFILE, c as requiresClaudeMandatoryAdaptiveThinking, d as resolveClaudeMythos5ModelIdentity, f as resolveClaudeNativeThinkingLevelMap, g as supportsClaudeAdaptiveThinking, h as supportsClaude1MContext, i as CLAUDE_FABLE_5_THINKING_PROFILE, l as resolveClaudeFable5ModelIdentity, m as resolveClaudeSonnet5ModelIdentity, n as normalizeModelCostConfig, o as CLAUDE_SONNET_5_THINKING_PROFILE, p as resolveClaudeOpus5ModelIdentity, r as normalizeResolvedPricing, s as requiresClaudeDefaultSampling, t as calculateUsageCost, u as resolveClaudeModelIdentity, v as supportsClaudeNativeMaxEffort, y as supportsClaudeNativeXhighEffort } from "./src-C8U7lkoa.mjs";
+import { _ as supportsClaudeAdaptiveThinking, a as CLAUDE_OPUS_5_THINKING_PROFILE, b as supportsClaudeNativeXhighEffort, c as requiresClaudeDefaultSampling, d as resolveClaudeModelIdentity, f as resolveClaudeMythos5ModelIdentity, g as supportsClaude1MContext, h as resolveClaudeSonnet5ModelIdentity, i as CLAUDE_FABLE_5_THINKING_PROFILE, l as requiresClaudeMandatoryAdaptiveThinking, m as resolveClaudeOpus5ModelIdentity, n as normalizeModelCostConfig, o as CLAUDE_SONNET_5_THINKING_PROFILE, p as resolveClaudeNativeThinkingLevelMap, r as normalizeResolvedPricing, s as bindsClaudeThinkingPrefix, t as calculateUsageCost, u as resolveClaudeFable5ModelIdentity, v as supportsClaudeFastMode, y as supportsClaudeNativeMaxEffort } from "./src-B2Q_6G8V.mjs";
 import { n as PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, t as PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE } from "./types-BDdaOVi2.mjs";
 import { a as isProviderRefusalAssistantError, i as formatThrownValue, n as createAssistantMessageDiagnostic, r as extractDiagnosticError, t as appendAssistantMessageDiagnostic } from "./diagnostics-CPeq9F7y.mjs";
-import { n as EventStream, r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-uSMZJ3FA.mjs";
-import { n as validateToolCall, t as validateToolArguments } from "./validation-CJZtym2g.mjs";
-export { AssistantMessageEventStream, CLAUDE_FABLE_5_THINKING_PROFILE, CLAUDE_OPUS_5_THINKING_PROFILE, CLAUDE_SONNET_5_THINKING_PROFILE, EventStream, PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, appendAssistantMessageDiagnostic, calculateUsageCost, createAssistantMessageDiagnostic, createAssistantMessageEventStream, extractDiagnosticError, formatThrownValue, isProviderRefusalAssistantError, normalizeModelCostConfig, normalizeResolvedPricing, requiresClaudeDefaultSampling, requiresClaudeMandatoryAdaptiveThinking, resolveClaudeFable5ModelIdentity, resolveClaudeModelIdentity, resolveClaudeMythos5ModelIdentity, resolveClaudeNativeThinkingLevelMap, resolveClaudeOpus5ModelIdentity, resolveClaudeSonnet5ModelIdentity, supportsClaude1MContext, supportsClaudeAdaptiveThinking, supportsClaudeFastMode, supportsClaudeNativeMaxEffort, supportsClaudeNativeXhighEffort, validateToolArguments, validateToolCall };
+import { i as createAssistantMessageEventStream, n as EventStream, t as AssistantMessageEventStream } from "./event-stream-D8PARQfL.mjs";
+import { n as validateToolCall, t as validateToolArguments } from "./validation-BDzVDnTs.mjs";
+export { AssistantMessageEventStream, CLAUDE_FABLE_5_THINKING_PROFILE, CLAUDE_OPUS_5_THINKING_PROFILE, CLAUDE_SONNET_5_THINKING_PROFILE, EventStream, PROVIDER_FAILURE_WITH_OUTPUT_ERROR_CODE, PROVIDER_POST_DISPATCH_AMBIGUITY_ERROR_CODE, appendAssistantMessageDiagnostic, bindsClaudeThinkingPrefix, calculateUsageCost, createAssistantMessageDiagnostic, createAssistantMessageEventStream, extractDiagnosticError, formatThrownValue, isProviderRefusalAssistantError, normalizeModelCostConfig, normalizeResolvedPricing, requiresClaudeDefaultSampling, requiresClaudeMandatoryAdaptiveThinking, resolveClaudeFable5ModelIdentity, resolveClaudeModelIdentity, resolveClaudeMythos5ModelIdentity, resolveClaudeNativeThinkingLevelMap, resolveClaudeOpus5ModelIdentity, resolveClaudeSonnet5ModelIdentity, supportsClaude1MContext, supportsClaudeAdaptiveThinking, supportsClaudeFastMode, supportsClaudeNativeMaxEffort, supportsClaudeNativeXhighEffort, validateToolArguments, validateToolCall };

package/dist/utf16-slice-CvGodqok.mjs

@@ -0,0 +1,29 @@
+//#region packages/normalization-core/src/utf16-slice.ts
+function isHighSurrogate(codeUnit) {
+	return codeUnit >= 55296 && codeUnit <= 56319;
+}
+function isLowSurrogate(codeUnit) {
+	return codeUnit >= 56320 && codeUnit <= 57343;
+}
+/** Slices a UTF-16 string without returning dangling surrogate halves at either edge. */
+function sliceUtf16Safe(input, start, end) {
+	const len = input.length;
+	let from = start < 0 ? Math.max(len + start, 0) : Math.min(start, len);
+	let to = end === void 0 ? len : end < 0 ? Math.max(len + end, 0) : Math.min(end, len);
+	if (to <= from) return "";
+	if (from > 0 && from < len) {
+		if (isLowSurrogate(input.charCodeAt(from)) && isHighSurrogate(input.charCodeAt(from - 1))) from += 1;
+	}
+	if (to > 0 && to < len) {
+		if (isHighSurrogate(input.charCodeAt(to - 1)) && isLowSurrogate(input.charCodeAt(to))) to -= 1;
+	}
+	return input.slice(from, to);
+}
+/** Truncates a UTF-16 string without cutting a surrogate pair in half. */
+function truncateUtf16Safe(input, maxLen) {
+	const limit = Math.max(0, Math.floor(maxLen));
+	if (input.length <= limit) return input;
+	return sliceUtf16Safe(input, 0, limit);
+}
+//#endregion
+export { truncateUtf16Safe as t };

package/dist/{validation-CJZtym2g.mjs → validation-BDzVDnTs.mjs}

@@ -127,6 +127,8 @@ function coerceWithUnionSchema(value, schemas) {
 		}
 	}
 	for (const schema of schemas) {
+		const types = getSchemaTypes(schema);
+		if (value !== null && types.length === 1 && types[0] === "null") continue;
 		const coerced = coerceWithJsonSchema(structuredClone(value), schema);
 		if (getSubSchemaValidator(schema)?.Check(coerced)) return coerced;
 	}
@@ -174,11 +176,15 @@ function validateToolCall(tools, toolCall) {
 	if (!tool) throw new Error(`Tool "${toolCall.name}" not found`);
 	return validateToolArguments(tool, toolCall);
 }
+function introducesNullValue(previous, converted) {
+	if (converted === null) return previous !== null;
+	if (!isObjectBackedRecord(previous) || !isObjectBackedRecord(converted)) return false;
+	return Object.entries(converted).some(([key, value]) => introducesNullValue(previous[key], value));
+}
 /** Validates tool arguments against TypeBox or plain JSON-schema parameters. */
 function validateToolArguments(tool, toolCall) {
 	const args = structuredClone(toolCall.arguments);
 	const validator = getValidator(tool.parameters);
-	validator.Convert(args);
 	if (isJsonSchemaObject(tool.parameters)) {
 		const coerced = coerceWithJsonSchema(args, tool.parameters);
 		if (coerced !== args) {
@@ -189,6 +195,8 @@ function validateToolArguments(tool, toolCall) {
 		}
 	}
 	if (validator.Check(args)) return args;
+	const converted = validator.Convert(structuredClone(args));
+	if (!introducesNullValue(args, converted) && validator.Check(converted)) return converted;
 	const errors = validator.Errors(args).map((error) => `  - ${formatValidationPath(error)}: ${error.message}`).join("\n") || "Unknown validation error";
 	throw new Error(`Validation failed for tool "${toolCall.name}":\n${errors}\n\nReceived arguments:\n${JSON.stringify(toolCall.arguments, null, 2)}`);
 }

package/dist/{validation-BOwtcl9X.d.mts → validation-CaFUZN9B.d.mts}

@@ -1,4 +1,4 @@
-import { nt as ToolCall, tt as Tool } from "./types-DbrhszyQ.mjs";
+import { nt as ToolCall, tt as Tool } from "./types-Dy1q0CSu.mjs";
 //#region packages/llm-core/src/validation.d.ts
 /** Finds the target tool and validates/coerces a model-emitted tool call. */
 declare function validateToolCall(tools: Tool[], toolCall: ToolCall): unknown;

package/dist/validation.d.mts

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

package/dist/validation.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/ai",
-  "version": "2026.9.1",
+  "version": "2026.9.3",
   "description": "Reusable model provider adapters and streaming runtime from OpenClaw",
   "keywords": [
     "ai",
@@ -76,6 +76,11 @@
       "import": "./dist/internal/anthropic.mjs",
       "default": "./dist/internal/anthropic.mjs"
     },
+    "./internal/google-model-family": {
+      "types": "./dist/internal/google-model-family.d.mts",
+      "import": "./dist/internal/google-model-family.mjs",
+      "default": "./dist/internal/google-model-family.mjs"
+    },
     "./internal/openai": {
       "types": "./dist/internal/openai.d.mts",
       "import": "./dist/internal/openai.mjs",
@@ -100,15 +105,20 @@
       "types": "./dist/internal/shared.d.mts",
       "import": "./dist/internal/shared.mjs",
       "default": "./dist/internal/shared.mjs"
+    },
+    "./internal/tool-schema": {
+      "types": "./dist/internal/tool-schema.d.mts",
+      "import": "./dist/internal/tool-schema.mjs",
+      "default": "./dist/internal/tool-schema.mjs"
     }
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.120.0",
-    "@google/genai": "2.18.0",
+    "@google/genai": "2.19.0",
     "@mistralai/mistralai": "2.6.4",
-    "openai": "7.5.0",
+    "openai": "7.8.0",
     "partial-json": "0.1.7",
-    "typebox": "1.3.17"
+    "typebox": "1.3.18"
   },
   "devDependencies": {
     "@openclaw/model-catalog-core": "0.0.0-private",