@openclaw/ai 2026.8.1-beta.3 → 2026.8.2

package/dist/transports.d.mts

@@ -1,23 +1,22 @@
-import { D as Model, I as ProviderReplayState, L as ProviderResponse, U as StreamOptions, V as StreamFn, W as TextContent, Z as ToolCall, a as AssistantMessage, d as Context, et as Usage, k as OpenAICompletionsCompat, n as Api, o as AssistantMessageEvent, q as ThinkingContent } from "./types-DTAP49HF.mjs";
-import { r as createAssistantMessageEventStream, t as AssistantMessageEventStream } from "./event-stream-D91-ohD_.mjs";
-import { n as ApiRegistry } from "./api-registry-DFxSnFqG.mjs";
-import { a as CodeModeToolSurfaceObservation, i as BaseOpenAIStreamOptions, o as OpenAICompletionsOptions, s as OpenAIResponsesCompactionRejection, u as OpenAIToolProjection } from "./provider-options-Cc5ZQ6Aa.mjs";
-import { a as resolveAnthropicPayloadPolicy, i as resolveAnthropicEphemeralCacheControl, n as applyAnthropicEphemeralCacheControlMarkers, o as resolveAnthropicServerCompactionPlan, r as applyAnthropicPayloadPolicyToParams, t as applyAnthropicCacheControlToMessages } from "./anthropic-payload-policy-CSx7MoKH.mjs";
-import { a as ReplayableResponseCompactionItem, i as OpenAIResponsesRequestParams, n as OpenAIResponsesOptions, o as ResponsesPromptObservation, r as OpenAIResponsesReasoningReplayMetadata } from "./openai-responses-contracts-CD75pQ0m.mjs";
-import { i as resolveOpenAIResponsesServerCompactionPlan, n as resolveOpenAIResponsesCompactEndpointPlan, r as resolveOpenAIResponsesPayloadPolicy, t as applyOpenAIResponsesPayloadPolicy } from "./openai-responses-payload-policy-CNGFT9zr.mjs";
-import { n as detectOpenAICompletionsCompat, r as resolveOpenAICompletionsCompat, t as ResolvedOpenAICompletionsCompat } from "./openai-completions-compat-B0KTleXp.mjs";
-import { n as FirstStreamEventInternalOptions } from "./stream-first-event-timeout-DvDeSucC.mjs";
+import "./index-CefaUGSS.mjs";
+import { D as Model, K as StreamFn, Q as ThinkingContent, Y as TextContent, a as AssistantMessage, at as Usage, d as Context, j as OpenAICompletionsCompat, n as Api, nt as ToolCall, o as AssistantMessageEvent, z as ProviderReplayState } from "./types-Beemor2E.mjs";
+import { n as ApiRegistry } from "./api-registry-BbUHEKER.mjs";
+import { a as CodeModeToolSurfaceObservation, d as OpenAIToolProjection, i as BaseOpenAIStreamOptions, o as OpenAICompletionsOptions, s as OpenAIResponsesCompactionRejection } from "./provider-options-DJd_9euj.mjs";
+import "./types-COdhCX0U.mjs";
+import { a as resolveAnthropicPayloadPolicy, i as resolveAnthropicEphemeralCacheControl, n as applyAnthropicEphemeralCacheControlMarkers, o as resolveAnthropicServerCompactionPlan, r as applyAnthropicPayloadPolicyToParams, t as applyAnthropicCacheControlToMessages } from "./anthropic-payload-policy-BTzmNC14.mjs";
+import { a as ReplayableResponseCompactionItem, c as OpenAIResponsesCompactionOutput, i as OpenAIResponsesRequestParams, n as OpenAIResponsesOptions, o as ResponsesPromptObservation, r as OpenAIResponsesReasoningReplayMetadata } from "./openai-responses-contracts-BthRXano.mjs";
+import { i as resolveOpenAIResponsesServerCompactionPlan, n as resolveOpenAIResponsesCompactEndpointPlan, r as resolveOpenAIResponsesPayloadPolicy, t as applyOpenAIResponsesPayloadPolicy } from "./openai-responses-payload-policy-rLRPsSmB.mjs";
+import { n as detectOpenAICompletionsCompat, r as resolveOpenAICompletionsCompat, t as ResolvedOpenAICompletionsCompat } from "./openai-completions-compat-SZhi0Lf4.mjs";
+import { C as FirstStreamEventInternalOptions, _ as sanitizeNonEmptyTransportPayloadText, a as copyProviderAcceptanceObserver, b as withProviderAcceptanceObserver, c as failTransportStream, d as mergeTransportHeaders, f as mergeTransportMetadata, g as parseTerminalToolCallArguments, h as notifyProviderStreamOpened, i as coerceTransportToolCallArguments, l as finalizeTerminalToolCallArguments, m as notifyProviderHttpResponse, n as WritableTransportStream, o as createEmptyTransportUsage, p as notifyProviderHttpMetadata, r as assignTransportErrorDetails, s as createWritableTransportEventStream, t as ProviderAcceptance, u as finalizeTransportStream, v as sanitizeTransportPayloadText, x as withProviderResponseHook, y as transportAbortError } from "./transport-stream-shared-BbG7PThh.mjs";
 import { r as sortPromptCacheToolsByName } from "./prompt-cache-stability-Cwcjv_fx.mjs";
-import { t as ProviderErrorProjection } from "./provider-error-CzNw4BWX.mjs";
 import OpenAI from "openai";
-import { ResponseCreateParamsStreaming, ResponseInput } from "openai/resources/responses/responses.js";
+import { ResponseCreateParamsStreaming, ResponseInput, ResponseInputItem as ResponseInputItem$1 } from "openai/resources/responses/responses.js";
 import { ChatCompletionChunk } from "openai/resources/chat/completions.js";
-
 //#region packages/ai/src/transports/anthropic-transport-stream.d.ts
 /** Resolve the Anthropic Messages endpoint URL for the effective base URL. */
-declare function resolveAnthropicMessagesUrl(baseUrl?: string): string;
+export declare function resolveAnthropicMessagesUrl(baseUrl?: string): string;
 /** Create the stream function used by Anthropic Messages transport models. */
-declare function createAnthropicMessagesTransportStreamFn(): StreamFn;
+export declare function createAnthropicMessagesTransportStreamFn(): StreamFn;
 //#endregion
 //#region packages/ai/src/transports/deepseek-text-filter.d.ts
 interface DeepSeekTextFilter {
@@ -27,28 +26,28 @@ interface DeepSeekTextFilter {
   flush(): string[];
 }
 /** Create an incremental text filter that strips DeepSeek DSML tool blocks. */
-declare function createDeepSeekTextFilter(): DeepSeekTextFilter;
+export declare function createDeepSeekTextFilter(): DeepSeekTextFilter;
 //#endregion
 //#region packages/ai/src/transports/google-thinking-level.d.ts
 /** Returns whether a Gemini Flash model accepts the MINIMAL thinking level. */
-declare function googleFlashSupportsMinimalThinking(modelId: string): boolean;
+export declare function googleFlashSupportsMinimalThinking(modelId: string): boolean;
 //#endregion
 //#region packages/ai/src/transports/json-unsafe-integers.d.ts
 /** Quotes integer literals above Number.MAX_SAFE_INTEGER before JSON.parse. */
-declare function quoteUnsafeIntegerLiterals(input: string): string;
+export declare function quoteUnsafeIntegerLiterals(input: string): string;
 /** Parses JSON while preserving unsafe integer literals as strings. */
-declare function parseJsonPreservingUnsafeIntegers(input: string): unknown;
+export declare function parseJsonPreservingUnsafeIntegers(input: string): unknown;
 /** Parses or accepts an object while preserving unsafe integer literals in string input. */
-declare function parseJsonObjectPreservingUnsafeIntegers(value: unknown): Record<string, unknown> | null;
+export declare function parseJsonObjectPreservingUnsafeIntegers(value: unknown): Record<string, unknown> | null;
 //#endregion
 //#region packages/ai/src/transports/model-max-tokens-params.d.ts
 /** Resolve the first supported max-token parameter present in a params object. */
-declare function resolveMaxTokensParam(params: Record<string, unknown> | undefined): number | undefined;
+export declare function resolveMaxTokensParam(params: Record<string, unknown> | undefined): number | undefined;
 /**
  * Canonicalize merged params to `maxTokens`, preserving source precedence from
  * left to right across the provided source objects.
  */
-declare function canonicalizeMaxTokensParam(params: {
+export declare function canonicalizeMaxTokensParam(params: {
   merged: Record<string, unknown>;
   sources: Array<Record<string, unknown> | undefined>;
 }): void;
@@ -64,11 +63,11 @@ type ModelPayloadDebugMode = "off" | "summary" | "tools" | "full-redacted";
 /** SSE debug detail levels accepted by `OPENCLAW_DEBUG_SSE`. */
 type ModelSseDebugMode = "off" | "events" | "peek";
 /** Resolves model payload debug verbosity from `OPENCLAW_DEBUG_MODEL_PAYLOAD`. */
-declare function resolveModelPayloadDebugMode(env?: ModelTransportDebugEnv): ModelPayloadDebugMode;
+export declare function resolveModelPayloadDebugMode(env?: ModelTransportDebugEnv): ModelPayloadDebugMode;
 /** Resolves SSE stream debug verbosity from `OPENCLAW_DEBUG_SSE`. */
-declare function resolveModelSseDebugMode(env?: ModelTransportDebugEnv): ModelSseDebugMode;
+export declare function resolveModelSseDebugMode(env?: ModelTransportDebugEnv): ModelSseDebugMode;
 /** Emits model-fetch metadata at info level by default; other diagnostics require debug env. */
-declare function emitModelTransportDebug(log: SubsystemLogger, message: string): void;
+export declare function emitModelTransportDebug(log: SubsystemLogger, message: string): void;
 //#endregion
 //#region packages/ai/src/transports/model-transport-url.d.ts
 /**
@@ -76,29 +75,30 @@ declare function emitModelTransportDebug(log: SubsystemLogger, message: string):
  * Keeps logs useful without exposing credentials, request params, or fragments.
  */
 /** Return a sanitized URL suitable for logs and diagnostics. */
-declare function formatModelTransportDebugUrl(rawUrl: string): string;
+export declare function formatModelTransportDebugUrl(rawUrl: string): string;
 /** Format a configured base URL for debug output, or the implicit default. */
-declare function formatModelTransportDebugBaseUrl(rawUrl: string | undefined): string;
+export declare function formatModelTransportDebugBaseUrl(rawUrl: string | undefined): string;
 //#endregion
 //#region packages/ai/src/transports/openai-compatible-conversation-turn.d.ts
 /** Returns whether an OpenAI-compatible messages payload contains a usable turn. */
-declare function hasOpenAICompatibleConversationTurn(messages: unknown): boolean;
+export declare function hasOpenAICompatibleConversationTurn(messages: unknown): boolean;
 //#endregion
 //#region packages/ai/src/transports/openai-completions-string-content.d.ts
 /** Flatten string-only text block content arrays into newline-joined strings. */
-declare function flattenCompletionMessagesToStringContent(messages: unknown[]): unknown[];
+export declare function flattenCompletionMessagesToStringContent(messages: unknown[]): unknown[];
 /** Strip completion messages to role/content fields for strict providers. */
-declare function stripCompletionMessagesToRoleContent(messages: unknown[]): unknown[];
+export declare function stripCompletionMessagesToRoleContent(messages: unknown[]): unknown[];
 //#endregion
 //#region packages/ai/src/transports/openai-transport-shared.d.ts
-declare const GEMINI_THOUGHT_SIGNATURE_VALIDATOR_SKIP = "skip_thought_signature_validator";
-declare const log: {
+export declare const GEMINI_THOUGHT_SIGNATURE_VALIDATOR_SKIP = "skip_thought_signature_validator";
+export declare const log: {
   debug(message: string, data?: Record<string, unknown>): void;
   info(message: string, data?: Record<string, unknown>): void;
   warn(message: string, data?: Record<string, unknown>): void;
 };
-type OpenAICompletionsTextSource = "reasoning_detail" | "refusal";
-type OpenAICompletionsContentDelta = {
+export declare function resolveOpenAIClientBaseUrl(model: Pick<Model, "provider" | "baseUrl">, baseUrl?: string | undefined): string | undefined;
+export type OpenAICompletionsTextSource = "reasoning_detail" | "refusal";
+export type OpenAICompletionsContentDelta = {
   kind: "thinking";
   signature?: string;
   text: string;
@@ -113,7 +113,7 @@ type OpenAICompletionsReasoningBatch = {
   readonly hasThinking: boolean;
   readonly hasVisibleText: boolean;
 };
-declare function readOpenAICompletionsReasoningBatch(delta: Record<string, unknown>, visibleReasoningDetailTypes: ReadonlySet<string>): OpenAICompletionsReasoningBatch;
+export declare function readOpenAICompletionsReasoningBatch(delta: Record<string, unknown>, visibleReasoningDetailTypes: ReadonlySet<string>): OpenAICompletionsReasoningBatch;
 type OpenAIModeCompatInput = Omit<OpenAICompletionsCompat, "thinkingFormat"> & {
   thinkingFormat?: string;
   requiresStringContent?: boolean;
@@ -122,45 +122,48 @@ type OpenAIModeCompatInput = Omit<OpenAICompletionsCompat, "thinkingFormat"> & {
   omitEmptyArrayItems?: unknown;
   visibleReasoningDetailTypes?: string[];
 };
-type OpenAIModeModel = Omit<Model, "compat"> & {
+export type OpenAIModeModel = Omit<Model, "compat"> & {
   compat?: OpenAIModeCompatInput | null;
 };
 type MutableToolCall = ToolCall & {
   partialArgs?: string;
 };
-type MutableAssistantOutput = Omit<AssistantMessage, "content" | "usage"> & {
+export type MutableAssistantOutput = Omit<AssistantMessage, "content" | "usage"> & {
   content: Array<TextContent | ThinkingContent | MutableToolCall>;
   usage: Usage & {
     reasoningTokens?: number;
   };
 };
-declare function parseOpenAICompletionsUsage(rawUsage: NonNullable<ChatCompletionChunk["usage"]> & {
+export declare function parseOpenAICompletionsUsage(rawUsage: NonNullable<ChatCompletionChunk["usage"]> & {
   cost?: unknown;
   prompt_cache_hit_tokens?: number;
+  prompt_tokens_details?: {
+    cache_creation_input_tokens?: number;
+  };
 }, model: Model, options?: {
   includeReasoningTokens?: boolean;
 }): MutableAssistantOutput["usage"];
-declare function createOpenAIResponseHook(onResponse: BaseOpenAIStreamOptions["onResponse"], response: Response, model: Model): (() => void | Promise<void>) | undefined;
-declare function createOpenAIProviderAcceptanceHook(options: Pick<BaseOpenAIStreamOptions, "onResponse" | "signal"> | undefined, response: Response, model: Model): () => Promise<void>;
+export declare function createOpenAIResponseHook(onResponse: BaseOpenAIStreamOptions["onResponse"], response: Response, model: Model): (() => void | Promise<void>) | undefined;
+export declare function createOpenAIProviderAcceptanceHook(options: Pick<BaseOpenAIStreamOptions, "onResponse" | "signal"> | undefined, response: Response, model: Model): () => Promise<void>;
 type ModelStreamCooperativeScheduler = {
   afterEvent: () => Promise<void>;
 };
-declare function throwIfModelStreamAborted(signal?: AbortSignal): void;
+export declare function throwIfModelStreamAborted(signal?: AbortSignal): void;
 /** Measure one UTF-8 append without double-counting a surrogate pair split across chunks. */
-declare function measureUtf8AppendBytes(bufferEndsWithHighSurrogate: boolean, chunk: string): {
+export declare function measureUtf8AppendBytes(bufferEndsWithHighSurrogate: boolean, chunk: string): {
   bytes: number;
   endsWithHighSurrogate: boolean;
 };
-declare function createModelStreamCooperativeScheduler(signal?: AbortSignal): ModelStreamCooperativeScheduler;
-declare function resolvePromptCacheKey(options: Pick<BaseOpenAIStreamOptions, "promptCacheKey" | "sessionId"> | undefined, cacheRetention: "short" | "long" | "none"): string | undefined;
-declare function isOpenAICompletionsThinkingEnabled(effort: string): boolean;
-declare function readOpenAICompletionsContentDeltas(content: unknown, topLevelRefusal?: unknown, mirroredThinking?: readonly string[]): OpenAICompletionsContentDelta[];
+export declare function createModelStreamCooperativeScheduler(signal?: AbortSignal): ModelStreamCooperativeScheduler;
+export declare function resolvePromptCacheKey(options: Pick<BaseOpenAIStreamOptions, "promptCacheKey" | "sessionId"> | undefined, cacheRetention: "short" | "long" | "none"): string | undefined;
+export declare function isOpenAICompletionsThinkingEnabled(effort: string): boolean;
+export declare function readOpenAICompletionsContentDeltas(content: unknown, topLevelRefusal?: unknown, mirroredThinking?: readonly string[]): OpenAICompletionsContentDelta[];
 //#endregion
 //#region packages/ai/src/transports/openai-completions-params.d.ts
-declare function buildOpenAICompletionsParams(model: OpenAIModeModel, context: Context, options: OpenAICompletionsOptions | undefined): Record<string, unknown>;
+export declare function buildOpenAICompletionsParams(model: OpenAIModeModel, context: Context, options: OpenAICompletionsOptions | undefined): Record<string, unknown>;
 //#endregion
 //#region packages/ai/src/transports/openai-completions-transport.d.ts
-declare function createOpenAICompletionsTransportStreamFn(): StreamFn;
+export declare function createOpenAICompletionsTransportStreamFn(): StreamFn;
 //#endregion
 //#region packages/ai/src/transports/openai-reasoning-compat.d.ts
 /** Minimal model fields needed to resolve OpenAI reasoning effort compatibility. */
@@ -170,11 +173,11 @@ type OpenAIReasoningCompatModel = {
   compat?: unknown;
 };
 /** Resolves the reasoning effort remap for an OpenAI-compatible model. */
-declare function resolveOpenAIReasoningEffortMap(model: OpenAIReasoningCompatModel, fallbackMap?: Record<string, string>): Record<string, string>;
+export declare function resolveOpenAIReasoningEffortMap(model: OpenAIReasoningCompatModel, fallbackMap?: Record<string, string>): Record<string, string>;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-replay.d.ts
 /** Resolves the assistant message id that can be replayed to OpenAI Responses. */
-declare function resolveReplayableResponsesMessageId(params: {
+export declare function resolveReplayableResponsesMessageId(params: {
   replayResponsesItemIds: boolean;
   textSignatureId?: string;
   fallbackId: string;
@@ -183,14 +186,17 @@ declare function resolveReplayableResponsesMessageId(params: {
 }): string | undefined;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-client.d.ts
-declare function createOpenAIResponsesClient(model: Model, context: Context, apiKey: string, optionHeaders?: Record<string, string>, turnHeaders?: Record<string, string>, sessionId?: string): OpenAI;
-declare function createOpenAIResponsesTransportStreamFn(): StreamFn;
-declare function createAzureOpenAIResponsesTransportStreamFn(): StreamFn;
-declare function createAzureOpenAIClient(model: Model, context: Context, apiKey: string, optionHeaders?: Record<string, string>, turnHeaders?: Record<string, string>): OpenAI;
+declare function createOpenAIResponsesClient(model: Model, context: Context, apiKey: string, optionHeaders?: Record<string, string>, turnHeaders?: Record<string, string>, sessionId?: string, fetchOverride?: typeof globalThis.fetch): OpenAI;
+export declare function createOpenAIResponsesTransportStreamFn(): StreamFn;
+export declare function createAzureOpenAIResponsesTransportStreamFn(): StreamFn;
+declare function createAzureOpenAIClient(model: Model, context: Context, apiKey: string, optionHeaders?: Record<string, string>, turnHeaders?: Record<string, string>, _sessionId?: string, fetchOverride?: typeof globalThis.fetch): OpenAI;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-compaction-replay.d.ts
-declare function captureOpenAIResponsesCompaction(output: Pick<AssistantMessage, "providerReplay">, item: ReplayableResponseCompactionItem, boundary: number | "retained-users", model: Model, captureMetadata?: OpenAIResponsesReasoningReplayMetadata): void;
+export declare function captureOpenAIResponsesCompaction(output: Pick<AssistantMessage, "providerReplay">, item: ReplayableResponseCompactionItem, boundary: number | "retained-users", model: Model, captureMetadata?: OpenAIResponsesReasoningReplayMetadata, compactedOutput?: OpenAIResponsesCompactionOutput): void;
 type OpenAIResponsesReplayMode = "checkpoint" | "full-history";
+export declare class CompactionReplayRefreshRequiredError extends Error {
+  constructor();
+}
 declare function buildOpenAIResponsesReasoningReplayMetadata(model: Model, options?: Pick<BaseOpenAIStreamOptions, "authProfileId" | "sessionId">): OpenAIResponsesReasoningReplayMetadata;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-debug.d.ts
@@ -215,6 +221,7 @@ type ResponsesFailedNoDetailsObservation = {
 type ResponsesFailedEventSummary = {
   message: string;
   responseId?: string;
+  code?: string;
   observation?: ResponsesFailedNoDetailsObservation;
 };
 declare function buildResponsesFailedNoDetailsObservation(event: Record<string, unknown>, model: Model, response?: Record<string, unknown> | undefined): ResponsesFailedNoDetailsObservation;
@@ -249,12 +256,20 @@ type ResponsesEncryptedContentAttempt<TRequest extends ResponsesEncryptedContent
 declare function createResponsesStreamWithEncryptedContentRetry(params: {
   client: ResponsesClientLike;
   request: OpenAIResponsesRequestParams;
-  requestOptions: unknown;
+  requestOptions: {
+    signal?: AbortSignal;
+  } | undefined;
   model: Model;
   observePrompt?: NonNullable<ReturnType<typeof createResponsesPromptEgressObserver>>;
   initialAttemptKind?: ResponsesEncryptedContentAttemptKind;
   initialRejectedCompaction?: OpenAIResponsesCompactionRejection;
   onCompactionRejected?: (checkpoint: OpenAIResponsesCompactionRejection) => void;
+  canRetryStream?: () => boolean;
+  wrapStream?: (result: {
+    stream: AsyncIterable<unknown>;
+    response: Response;
+    attempt: ResponsesEncryptedContentAttempt<OpenAIResponsesRequestParams>;
+  }) => AsyncIterable<unknown>;
   buildFullHistoryRequest?: () => OpenAIResponsesRequestParams | Promise<OpenAIResponsesRequestParams>;
 }): Promise<{
   stream: AsyncIterable<unknown>;
@@ -268,7 +283,7 @@ type ResponsesEventSink = {
   push(event: AssistantMessageEvent): void;
 };
 //#endregion
-//#region packages/ai/src/transports/openai-responses-stream-internal.d.ts
+//#region packages/ai/src/transports/openai-responses-stream-types-internal.d.ts
 type ResponsesStreamOptions = FirstStreamEventInternalOptions & {
   serviceTier?: ResponseCreateParamsStreaming["service_tier"];
   resolveServiceTier?: (responseServiceTier: ResponseCreateParamsStreaming["service_tier"] | undefined, requestServiceTier: ResponseCreateParamsStreaming["service_tier"] | undefined) => ResponseCreateParamsStreaming["service_tier"] | undefined;
@@ -276,25 +291,27 @@ type ResponsesStreamOptions = FirstStreamEventInternalOptions & {
   signal?: AbortSignal;
   reasoningReplayMetadata?: OpenAIResponsesReasoningReplayMetadata;
 };
+//#endregion
+//#region packages/ai/src/transports/openai-responses-stream-internal.d.ts
 declare function processResponsesStream<TApi extends Api>(openaiStream: AsyncIterable<unknown>, output: AssistantMessage, stream: ResponsesEventSink, model: Model<TApi>, options?: ResponsesStreamOptions): Promise<import("openai/resources/responses/responses.js").Response | undefined>;
 //#endregion
 //#region packages/ai/src/transports/openai-transport-params.d.ts
-declare function readCodeModePayloadToolName(tool: unknown): string | undefined;
-declare function filterCodeModePayloadTools(payload: unknown, visibleToolNames: ReadonlySet<string>, allowedHostedToolTypes?: ReadonlySet<string>, observer?: (observation: CodeModeToolSurfaceObservation) => void): void;
-declare function resolveCodeModeResponsesVisibleToolNames(context: Pick<Context, "tools">): ReadonlySet<string>;
-declare function enforceCodeModeResponsesToolSurface(payload: unknown, visibleToolNames: ReadonlySet<string>, allowedHostedToolTypes?: ReadonlySet<string>, observer?: (observation: CodeModeToolSurfaceObservation) => void): void;
-declare function assertCodeModeResponsesToolSurface(payload: unknown, visibleToolNames: ReadonlySet<string>, allowedHostedToolTypes?: ReadonlySet<string>): void;
-declare function resolveOpenAIStrictToolFlagWithDiagnostics(projection: OpenAIToolProjection, strictSetting: boolean | null | undefined, context: {
+export declare function readCodeModePayloadToolName(tool: unknown): string | undefined;
+export declare function filterCodeModePayloadTools(payload: unknown, visibleToolNames: ReadonlySet<string>, allowedHostedToolTypes?: ReadonlySet<string>, observer?: (observation: CodeModeToolSurfaceObservation) => void): void;
+export declare function resolveCodeModeResponsesVisibleToolNames(context: Pick<Context, "tools">): ReadonlySet<string>;
+export declare function enforceCodeModeResponsesToolSurface(payload: unknown, visibleToolNames: ReadonlySet<string>, allowedHostedToolTypes?: ReadonlySet<string>, observer?: (observation: CodeModeToolSurfaceObservation) => void): void;
+export declare function assertCodeModeResponsesToolSurface(payload: unknown, visibleToolNames: ReadonlySet<string>, allowedHostedToolTypes?: ReadonlySet<string>): void;
+export declare function resolveOpenAIStrictToolFlagWithDiagnostics(projection: OpenAIToolProjection, strictSetting: boolean | null | undefined, context: {
   transport: "responses" | "completions";
   model: OpenAIModeModel;
 }): boolean | undefined;
-declare function isOpenAICodexResponsesModel(model: Model): boolean;
-declare function usesNativeOpenAICodexResponsesBackend(model: Model): boolean;
-declare function buildOpenAIClientHeaders(model: Model, context: Context, optionHeaders?: Record<string, string>, turnHeaders?: Record<string, string>, sessionId?: string): Record<string, string>;
-declare function buildOpenAISdkClientOptions(model: Model): {
+export declare function isOpenAICodexResponsesModel(model: Model): boolean;
+export declare function usesNativeOpenAICodexResponsesBackend(model: Model): boolean;
+export declare function buildOpenAIClientHeaders(model: Model, context: Context, optionHeaders?: Record<string, string>, turnHeaders?: Record<string, string>, sessionId?: string): Record<string, string>;
+export declare function buildOpenAISdkClientOptions(model: Model): {
   timeout?: number;
 };
-declare function buildOpenAISdkRequestOptions(model: Model, signal?: AbortSignal, options?: {
+export declare function buildOpenAISdkRequestOptions(model: Model, signal?: AbortSignal, options?: {
   stream?: boolean;
   timeoutMs?: number;
   maxRetries?: number;
@@ -304,7 +321,7 @@ declare function buildOpenAISdkRequestOptions(model: Model, signal?: AbortSignal
   maxRetries?: number;
   headers?: Record<string, string>;
 } | undefined;
-declare function getCompat(model: OpenAIModeModel): {
+export declare function getCompat(model: OpenAIModeModel): {
   cacheControlFormat: "anthropic" | undefined;
   reasoningEffortMap: Record<string, string>;
   openRouterRouting: Record<string, unknown>;
@@ -333,6 +350,7 @@ declare function getCompat(model: OpenAIModeModel): {
 //#endregion
 //#region packages/ai/src/transports/openai-responses-compact-request.d.ts
 type OpenAIResponsesCompactEndpointResult = {
+  output: OpenAIResponsesCompactionOutput;
   item: {
     type: "compaction";
     id?: string;
@@ -347,7 +365,7 @@ type OpenAIResponsesCompactEndpointResult = {
   replayMetadata: OpenAIResponsesReasoningReplayMetadata;
 };
 /** Run a compact-endpoint request through the session's prepared stream stack. */
-declare function requestPreparedOpenAIResponsesCompaction(streamFn: StreamFn, model: Model, context: Context, options: OpenAIResponsesOptions): Promise<OpenAIResponsesCompactEndpointResult>;
+export declare function requestPreparedOpenAIResponsesCompaction(streamFn: StreamFn, model: Model, context: Context, options: OpenAIResponsesOptions): Promise<OpenAIResponsesCompactEndpointResult>;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-transport.d.ts
 declare const responsesTesting: {
@@ -380,16 +398,43 @@ declare global {
 }
 //#endregion
 //#region packages/ai/src/transports/provider-compaction-replay.d.ts
+type ReplayIdentity = {
+  sessionId?: string;
+  authProfileId?: string;
+  enabled?: boolean;
+};
+type ReplayMessage = {
+  role: string;
+};
+type ReplayPressureEstimator = {
+  text(value: string): number;
+  image(): number;
+  json(value: unknown): number;
+};
+/** Resolve from prepared transport facts; never retain or return credential material. */
+export declare function resolveCompactionReplayEligibility(model: Model, options: {
+  extraParams?: Record<string, unknown>;
+  apiKey?: string;
+}): boolean;
+/** Manual recovery uses the durable client compactor, never a guessed retained-user prefix. */
+export declare function requiresCompactionReplayRefresh(messages: readonly ReplayMessage[], model: Model, identity: ReplayIdentity): boolean;
+/** Carry a checkpoint immediately after reference-preserving history limiting, before repair. */
+export declare function preserveCompactionReplayWindow<T extends ReplayMessage>(source: readonly T[], windowed: T[], model: Model, identity: ReplayIdentity): T[];
+/** Estimate the canonical prefix and its tail once, independent of unbound usage snapshots. */
+export declare function resolveCompactionReplayPressure<T extends ReplayMessage>(messages: T[], model: Model, identity: ReplayIdentity, estimate: ReplayPressureEstimator): {
+  messages: T[];
+  prefixTokens: number;
+} | undefined;
 /** Whether provider replay state is a prefix-bound server compaction checkpoint. */
-declare function isCompactionReplayCheckpoint(replay: unknown): replay is ProviderReplayState;
+export declare function isCompactionReplayCheckpoint(replay: unknown): replay is ProviderReplayState;
 /** Strip prefix-bound checkpoints after local history rewrites. */
-declare function stripCompactionReplayCheckpoint(message: AssistantMessage): AssistantMessage;
+export declare function stripCompactionReplayCheckpoint(message: AssistantMessage): AssistantMessage;
 /** Strip prefix-bound checkpoint state from an in-place message rewrite. */
-declare function stripCompactionReplayCheckpointInPlace(message: {
+export declare function stripCompactionReplayCheckpointInPlace(message: {
   providerReplay?: unknown;
 }): void;
 /** Reindex a prefix-bound checkpoint after known content removals. */
-declare function replaceCompactionReplayOwnerContent(message: AssistantMessage, content: AssistantMessage["content"]): AssistantMessage;
+export declare function replaceCompactionReplayOwnerContent(message: AssistantMessage, content: AssistantMessage["content"]): AssistantMessage;
 //#endregion
 //#region packages/ai/src/transports/provider-transport-stream.d.ts
 type ProviderTransportStreamContext = {
@@ -399,133 +444,29 @@ type ProviderTransportStreamContext = {
   env?: NodeJS.ProcessEnv;
 };
 /** Maps public model APIs to the internal transport API id used by simple runtime dispatch. */
-declare function resolveTransportAwareSimpleApi(api: Api): Api | undefined;
+export declare function resolveTransportAwareSimpleApi(api: Api): Api | undefined;
 /** Creates a managed transport stream only when request overrides require it. */
-declare function createTransportAwareStreamFnForModel(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
+export declare function createTransportAwareStreamFnForModel(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
 /** Creates a managed OpenClaw transport stream for explicit fallback/runtime callers. */
-declare function createOpenClawTransportStreamFnForModel(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
-declare function createBoundaryAwareStreamFnForModel(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
-declare function prepareTransportAwareSimpleModel<TApi extends Api>(model: Model<TApi>, ctx?: ProviderTransportStreamContext): Model;
-declare function buildTransportAwareSimpleStreamFn(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
+export declare function createOpenClawTransportStreamFnForModel(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
+export declare function createBoundaryAwareStreamFnForModel(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
+export declare function prepareTransportAwareSimpleModel<TApi extends Api>(model: Model<TApi>, ctx?: ProviderTransportStreamContext): Model;
+export declare function buildTransportAwareSimpleStreamFn(model: Model, ctx?: ProviderTransportStreamContext): StreamFn | undefined;
 //#endregion
 //#region packages/ai/src/transports/responses-image-payload-sanitizer.d.ts
 /** Sanitize inline image fields inside a Responses API payload. */
-declare function sanitizeResponsesImagePayload<T extends Record<string, unknown>>(params: T): T;
+export declare function sanitizeResponsesImagePayload<T extends Record<string, unknown>>(params: T): T;
 //#endregion
 //#region packages/ai/src/transports/simple-completion-transport.d.ts
-declare function normalizeCodexResponsesBaseUrlForOpenAISdk(baseUrl?: string): string;
-declare function prepareModelForSimpleCompletion<TApi extends Api>(params: {
+export declare function normalizeCodexResponsesBaseUrlForOpenAISdk(baseUrl?: string): string;
+export declare function prepareModelForSimpleCompletion<TApi extends Api>(params: {
   apiRegistry: ApiRegistry;
   model: Model<TApi>;
   cfg?: unknown;
 }): Model;
 //#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
 //#region packages/ai/src/transports/transport-utils.d.ts
-declare const MALFORMED_STREAMING_FRAGMENT_ERROR_MESSAGE = "OpenClaw transport error: malformed_streaming_fragment";
-declare function isCodeModeModelVisibleToolName(name: string, visibleToolNames: ReadonlySet<string>): boolean;
+export declare const MALFORMED_STREAMING_FRAGMENT_ERROR_MESSAGE = "OpenClaw transport error: malformed_streaming_fragment";
+export declare function isCodeModeModelVisibleToolName(name: string, visibleToolNames: ReadonlySet<string>): boolean;
 //#endregion
-export { GEMINI_THOUGHT_SIGNATURE_VALIDATOR_SKIP, MALFORMED_STREAMING_FRAGMENT_ERROR_MESSAGE, MutableAssistantOutput, OpenAICompletionsContentDelta, type OpenAICompletionsOptions, OpenAICompletionsTextSource, OpenAIModeModel, type OpenAIResponsesCompactionRejection, ProviderAcceptance, ResolvedOpenAICompletionsCompat, WritableTransportStream, applyAnthropicCacheControlToMessages, applyAnthropicEphemeralCacheControlMarkers, applyAnthropicPayloadPolicyToParams, applyOpenAIResponsesPayloadPolicy, assertCodeModeResponsesToolSurface, assignTransportErrorDetails, buildOpenAIClientHeaders, buildOpenAICompletionsParams, buildOpenAISdkClientOptions, buildOpenAISdkRequestOptions, buildTransportAwareSimpleStreamFn, canonicalizeMaxTokensParam, captureOpenAIResponsesCompaction, coerceTransportToolCallArguments, copyProviderAcceptanceObserver, createAnthropicMessagesTransportStreamFn, createAzureOpenAIResponsesTransportStreamFn, createBoundaryAwareStreamFnForModel, createDeepSeekTextFilter, createEmptyTransportUsage, createModelStreamCooperativeScheduler, createOpenAICompletionsTransportStreamFn, createOpenAIProviderAcceptanceHook, createOpenAIResponseHook, createOpenAIResponsesTransportStreamFn, createOpenClawTransportStreamFnForModel, createTransportAwareStreamFnForModel, createWritableTransportEventStream, detectOpenAICompletionsCompat, emitModelTransportDebug, enforceCodeModeResponsesToolSurface, failTransportStream, filterCodeModePayloadTools, finalizeTerminalToolCallArguments, finalizeTransportStream, flattenCompletionMessagesToStringContent, formatModelTransportDebugBaseUrl, formatModelTransportDebugUrl, getCompat, googleFlashSupportsMinimalThinking, hasOpenAICompatibleConversationTurn, isCodeModeModelVisibleToolName, isCompactionReplayCheckpoint, isOpenAICodexResponsesModel, isOpenAICompletionsThinkingEnabled, log, measureUtf8AppendBytes, mergeTransportHeaders, mergeTransportMetadata, normalizeCodexResponsesBaseUrlForOpenAISdk, notifyProviderHttpMetadata, notifyProviderHttpResponse, notifyProviderStreamOpened, parseJsonObjectPreservingUnsafeIntegers, parseJsonPreservingUnsafeIntegers, parseOpenAICompletionsUsage, parseTerminalToolCallArguments, prepareModelForSimpleCompletion, prepareTransportAwareSimpleModel, quoteUnsafeIntegerLiterals, readCodeModePayloadToolName, readOpenAICompletionsContentDeltas, readOpenAICompletionsReasoningBatch, replaceCompactionReplayOwnerContent, requestPreparedOpenAIResponsesCompaction, resolveAnthropicEphemeralCacheControl, resolveAnthropicMessagesUrl, resolveAnthropicPayloadPolicy, resolveAnthropicServerCompactionPlan, resolveCodeModeResponsesVisibleToolNames, resolveMaxTokensParam, resolveModelPayloadDebugMode, resolveModelSseDebugMode, resolveOpenAICompletionsCompat, resolveOpenAIReasoningEffortMap, resolveOpenAIResponsesCompactEndpointPlan, resolveOpenAIResponsesPayloadPolicy, resolveOpenAIResponsesServerCompactionPlan, resolveOpenAIStrictToolFlagWithDiagnostics, resolvePromptCacheKey, resolveReplayableResponsesMessageId, resolveTransportAwareSimpleApi, sanitizeNonEmptyTransportPayloadText, sanitizeResponsesImagePayload, sanitizeTransportPayloadText, sortPromptCacheToolsByName as sortTransportToolsByName, stripCompactionReplayCheckpoint, stripCompactionReplayCheckpointInPlace, stripCompletionMessagesToRoleContent, throwIfModelStreamAborted, transportAbortError, usesNativeOpenAICodexResponsesBackend, withProviderAcceptanceObserver, withProviderResponseHook };
+export { type OpenAICompletionsOptions, type OpenAIResponsesCompactionRejection, ProviderAcceptance, ResolvedOpenAICompletionsCompat, WritableTransportStream, applyAnthropicCacheControlToMessages, applyAnthropicEphemeralCacheControlMarkers, applyAnthropicPayloadPolicyToParams, applyOpenAIResponsesPayloadPolicy, assignTransportErrorDetails, coerceTransportToolCallArguments, copyProviderAcceptanceObserver, createEmptyTransportUsage, createWritableTransportEventStream, detectOpenAICompletionsCompat, failTransportStream, finalizeTerminalToolCallArguments, finalizeTransportStream, mergeTransportHeaders, mergeTransportMetadata, notifyProviderHttpMetadata, notifyProviderHttpResponse, notifyProviderStreamOpened, parseTerminalToolCallArguments, resolveAnthropicEphemeralCacheControl, resolveAnthropicPayloadPolicy, resolveAnthropicServerCompactionPlan, resolveOpenAICompletionsCompat, resolveOpenAIResponsesCompactEndpointPlan, resolveOpenAIResponsesPayloadPolicy, resolveOpenAIResponsesServerCompactionPlan, sanitizeNonEmptyTransportPayloadText, sanitizeTransportPayloadText, sortPromptCacheToolsByName as sortTransportToolsByName, transportAbortError, withProviderAcceptanceObserver, withProviderResponseHook };