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

package/dist/transports.d.mts

@@ -1,47 +1,18 @@
-import { E as Model, L as StreamFn, O as OpenAICompletionsCompat, X as Usage, a as AssistantMessageEvent, i as AssistantMessage, n as Api, u as Context } from "./types-CH7ReIcU.mjs";
-import { t as AssistantMessageEventStream } from "./event-stream-DRmDMRHH.mjs";
-import { n as ApiRegistry } from "./api-registry-EpJoVwM1.mjs";
-import { a as OpenAICompletionsOptions, i as BaseOpenAIStreamOptions, s as OpenAIToolProjection } from "./provider-options-C5kYML7i.mjs";
-import { a as ReplayableResponseReasoningItem, c as ResolvedOpenAICompletionsCompat, i as OpenAIResponsesRequestParams, l as detectOpenAICompletionsCompat, n as OpenAIResponsesReasoningReplayMetadata, o as ResponsesPromptObservation, r as OpenAIResponsesReplayContext, t as OpenAIResponsesOptions, u as resolveOpenAICompletionsCompat } from "./openai-responses-contracts-BBKBfAqR.mjs";
+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 { 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 { ChatCompletionChunk } from "openai/resources/chat/completions.js";
 
-//#region packages/ai/src/transports/anthropic-payload-policy.d.ts
-/** @deprecated Anthropic-family provider payload helper; do not use from third-party plugins. */
-type AnthropicServiceTier = "auto" | "standard_only";
-/** @deprecated Anthropic-family provider payload helper; do not use from third-party plugins. */
-type AnthropicEphemeralCacheControl = {
-  type: "ephemeral";
-  ttl?: "1h" | "5m";
-};
-type AnthropicPayloadPolicyInput = {
-  api?: string;
-  baseUrl?: string;
-  cacheRetention?: "short" | "long" | "none";
-  enableCacheControl?: boolean;
-  provider?: string;
-  serviceTier?: AnthropicServiceTier;
-};
-/** @deprecated Anthropic-family provider payload helper; do not use from third-party plugins. */
-type AnthropicPayloadPolicy = {
-  allowsServiceTier: boolean;
-  cacheControl: AnthropicEphemeralCacheControl | undefined;
-  serviceTier: AnthropicServiceTier | undefined;
-};
-/** Resolve Anthropic cache-control marker retention for a request endpoint. */
-declare function resolveAnthropicEphemeralCacheControl(baseUrl: string | undefined, cacheRetention: AnthropicPayloadPolicyInput["cacheRetention"]): AnthropicEphemeralCacheControl | undefined;
-/** Apply one shared deepest-stable-message cache breakpoint policy. */
-declare function applyAnthropicCacheControlToMessages(messages: unknown, cacheControl: AnthropicEphemeralCacheControl, markerLimit: number, cacheBreakpointOptOutMessageIndexes: ReadonlySet<number>): void;
-/** @deprecated Anthropic-family provider payload helper; do not use from third-party plugins. */
-declare function resolveAnthropicPayloadPolicy(input: AnthropicPayloadPolicyInput): AnthropicPayloadPolicy;
-/** @deprecated Anthropic-family provider payload helper; do not use from third-party plugins. */
-declare function applyAnthropicPayloadPolicyToParams(payloadObj: Record<string, unknown>, policy: AnthropicPayloadPolicy, cacheBreakpointOptOutMessageIndexes: ReadonlySet<number>): void;
-/** @deprecated Anthropic-family provider payload helper; do not use from third-party plugins. */
-declare function applyAnthropicEphemeralCacheControlMarkers(payloadObj: Record<string, unknown>, cacheControl?: AnthropicEphemeralCacheControl | null): void;
-//#endregion
 //#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;
@@ -58,6 +29,10 @@ interface DeepSeekTextFilter {
 /** Create an incremental text filter that strips DeepSeek DSML tool blocks. */
 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;
+//#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;
@@ -79,12 +54,6 @@ declare function canonicalizeMaxTokensParam(params: {
 }): void;
 //#endregion
 //#region packages/ai/src/transports/model-transport-debug.d.ts
-/**
- * Environment-driven debug controls for model transport logging.
- *
- * Model adapters share these helpers so payload, SSE, and transport diagnostics
- * interpret OpenClaw debug environment variables consistently.
- */
 type SubsystemLogger = {
   info(message: string): void;
   debug(message: string): void;
@@ -128,6 +97,7 @@ declare const log: {
   info(message: string, data?: Record<string, unknown>): void;
   warn(message: string, data?: Record<string, unknown>): void;
 };
+type OpenAICompletionsTextSource = "reasoning_detail" | "refusal";
 type OpenAICompletionsContentDelta = {
   kind: "thinking";
   signature?: string;
@@ -135,8 +105,15 @@ type OpenAICompletionsContentDelta = {
 } | {
   kind: "text";
   text: string;
-  source?: "refusal";
+  source?: OpenAICompletionsTextSource;
 };
+type OpenAICompletionsReasoningBatch = {
+  readonly deltas: readonly OpenAICompletionsContentDelta[];
+  readonly mirroredThinking: readonly string[];
+  readonly hasThinking: boolean;
+  readonly hasVisibleText: boolean;
+};
+declare function readOpenAICompletionsReasoningBatch(delta: Record<string, unknown>, visibleReasoningDetailTypes: ReadonlySet<string>): OpenAICompletionsReasoningBatch;
 type OpenAIModeCompatInput = Omit<OpenAICompletionsCompat, "thinkingFormat"> & {
   thinkingFormat?: string;
   requiresStringContent?: boolean;
@@ -148,28 +125,14 @@ type OpenAIModeCompatInput = Omit<OpenAICompletionsCompat, "thinkingFormat"> & {
 type OpenAIModeModel = Omit<Model, "compat"> & {
   compat?: OpenAIModeCompatInput | null;
 };
-type MutableAssistantOutput = {
-  role: "assistant";
-  content: Array<Record<string, unknown>>;
-  api: Api;
-  provider: string;
-  model: string;
-  usage: {
-    input: number;
-    output: number;
-    cacheRead: number;
-    cacheWrite: number;
+type MutableToolCall = ToolCall & {
+  partialArgs?: string;
+};
+type MutableAssistantOutput = Omit<AssistantMessage, "content" | "usage"> & {
+  content: Array<TextContent | ThinkingContent | MutableToolCall>;
+  usage: Usage & {
     reasoningTokens?: number;
-    totalTokens: number;
-    cost: Usage["cost"];
   };
-  stopReason: string;
-  timestamp: number;
-  responseId?: string;
-  errorMessage?: string;
-  errorCode?: string;
-  errorType?: string;
-  errorBody?: string;
 };
 declare function parseOpenAICompletionsUsage(rawUsage: NonNullable<ChatCompletionChunk["usage"]> & {
   cost?: unknown;
@@ -177,107 +140,27 @@ declare function parseOpenAICompletionsUsage(rawUsage: NonNullable<ChatCompletio
 }, 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>;
 type ModelStreamCooperativeScheduler = {
   afterEvent: () => Promise<void>;
 };
 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): {
+  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[];
 //#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>): void;
-declare function resolveCodeModeResponsesVisibleToolNames(context: Pick<Context, "tools">): ReadonlySet<string>;
-declare function enforceCodeModeResponsesToolSurface(payload: unknown, visibleToolNames: ReadonlySet<string>): void;
-declare function assertCodeModeResponsesToolSurface(payload: unknown, visibleToolNames: ReadonlySet<string>): void;
-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): {
-  timeout?: number;
-};
-declare function buildOpenAISdkRequestOptions(model: Model, signal?: AbortSignal, options?: {
-  stream?: boolean;
-  timeoutMs?: number;
-  maxRetries?: number;
-}): {
-  signal?: AbortSignal;
-  timeout?: number;
-  maxRetries?: number;
-  headers?: Record<string, string>;
-} | undefined;
-declare function getCompat(model: OpenAIModeModel): {
-  cacheControlFormat: "anthropic" | undefined;
-  reasoningEffortMap: Record<string, string>;
-  openRouterRouting: Record<string, unknown>;
-  vercelGatewayRouting: Record<string, unknown>;
-  requiresStringContent: boolean;
-  strictMessageKeys: boolean;
-  supportsStore: boolean;
-  supportsDeveloperRole: boolean;
-  supportsReasoningEffort: boolean;
-  supportsUsageInStreaming: boolean;
-  maxTokensField: "max_completion_tokens" | "max_tokens";
-  requiresToolResultName: boolean;
-  requiresAssistantAfterToolResult: boolean;
-  requiresThinkingAsText: boolean;
-  requiresReasoningContentOnAssistantMessages: boolean;
-  thinkingFormat: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
-  zaiToolStream: boolean;
-  supportsStrictMode: boolean;
-  supportsJsonSchemaResponseFormat: boolean;
-  supportsPromptCacheKey: boolean;
-  supportsLongCacheRetention: boolean;
-  sessionAffinity: "openai" | "openrouter" | "none";
-  visibleReasoningDetailTypes: string[];
-  requiresNonEmptyUserOrAssistantMessage: boolean;
-};
+//#region packages/ai/src/transports/openai-completions-params.d.ts
+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 createSseDoneDetector(): {
-  observe(chunk: Uint8Array): void;
-  finish(): void;
-  sawDone: () => boolean;
-};
-declare function createOpenAICompletionsClient(model: Model, context: Context, apiKey: string, optionHeaders?: Record<string, string>, opts?: {
-  fetch?: typeof globalThis.fetch;
-}): OpenAI;
-declare function buildOpenAICompletionsClientConfig(model: Model, context: Context, optionHeaders?: Record<string, string>): {
-  baseURL: string;
-  defaultHeaders: Record<string, string>;
-  defaultQuery?: Record<string, string>;
-};
 declare function createOpenAICompletionsTransportStreamFn(): StreamFn;
-declare function processOpenAICompletionsStream(responseStream: AsyncIterable<ChatCompletionChunk>, output: MutableAssistantOutput, model: Model, stream: {
-  push(event: unknown): void;
-}, options?: {
-  signal?: AbortSignal;
-  emitReasoning?: boolean;
-  firstEventTimeoutMs?: number;
-  abortFirstEventStream?: (reason: Error) => void;
-  onFirstEventTimeout?: (reason: Error) => void;
-  sawStreamDONE?: () => boolean;
-}): Promise<void>;
-declare function shouldEmitOpenAICompletionsReasoningForModel(model: OpenAIModeModel, options: OpenAICompletionsOptions | undefined): boolean;
-declare function buildOpenAICompletionsParams(model: OpenAIModeModel, context: Context, options: OpenAICompletionsOptions | undefined): Record<string, unknown>;
-declare const completionsTesting: {
-  getCompat: typeof getCompat;
-  createSseDoneDetector: typeof createSseDoneDetector;
-  createOpenAICompletionsClient: typeof createOpenAICompletionsClient;
-  buildOpenAICompletionsClientConfig: typeof buildOpenAICompletionsClientConfig;
-  parseTransportChunkUsage: typeof parseOpenAICompletionsUsage;
-  processOpenAICompletionsStream: typeof processOpenAICompletionsStream;
-  shouldEmitOpenAICompletionsReasoningForModel: typeof shouldEmitOpenAICompletionsReasoningForModel;
-};
-declare global {
-  var openclawOpenAICompletionsTransportTestApi: typeof completionsTesting | undefined;
-}
 //#endregion
 //#region packages/ai/src/transports/openai-reasoning-compat.d.ts
 /** Minimal model fields needed to resolve OpenAI reasoning effort compatibility. */
@@ -289,36 +172,6 @@ type OpenAIReasoningCompatModel = {
 /** Resolves the reasoning effort remap for an OpenAI-compatible model. */
 declare function resolveOpenAIReasoningEffortMap(model: OpenAIReasoningCompatModel, fallbackMap?: Record<string, string>): Record<string, string>;
 //#endregion
-//#region packages/ai/src/transports/openai-responses-payload-policy.d.ts
-type OpenAIResponsesPayloadModel = {
-  api?: unknown;
-  baseUrl?: unknown;
-  id?: unknown;
-  provider?: unknown;
-  contextWindow?: unknown;
-  compat?: unknown;
-};
-type OpenAIResponsesPayloadPolicyOptions = {
-  extraParams?: Record<string, unknown>;
-  storeMode?: "provider-policy" | "disable" | "preserve";
-  enablePromptCacheStripping?: boolean;
-  enableServerCompaction?: boolean;
-};
-type OpenAIResponsesPayloadPolicy = {
-  allowsServiceTier: boolean;
-  compactThreshold: number;
-  explicitStore: boolean | undefined;
-  shouldStripDisabledReasoningPayload: boolean;
-  shouldStripInputStatus: boolean;
-  shouldStripPromptCache: boolean;
-  shouldStripStore: boolean;
-  useServerCompaction: boolean;
-};
-/** Resolve payload mutation policy for one OpenAI Responses-style model endpoint. */
-declare function resolveOpenAIResponsesPayloadPolicy(model: OpenAIResponsesPayloadModel, options?: OpenAIResponsesPayloadPolicyOptions): OpenAIResponsesPayloadPolicy;
-/** Mutate a Responses request payload according to the resolved endpoint policy. */
-declare function applyOpenAIResponsesPayloadPolicy(payloadObj: Record<string, unknown>, policy: OpenAIResponsesPayloadPolicy): void;
-//#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: {
@@ -335,6 +188,11 @@ 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;
 //#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;
+type OpenAIResponsesReplayMode = "checkpoint" | "full-history";
+declare function buildOpenAIResponsesReasoningReplayMetadata(model: Model, options?: Pick<BaseOpenAIStreamOptions, "authProfileId" | "sessionId">): OpenAIResponsesReasoningReplayMetadata;
+//#endregion
 //#region packages/ai/src/transports/openai-responses-debug.d.ts
 declare function summarizeResponsesTools(tools: unknown): string;
 declare function stringifyRedactedPayload(value: unknown): string;
@@ -366,7 +224,7 @@ declare function summarizeResponsesPayload(params: unknown): string;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-params-internal.d.ts
 declare function sanitizeOpenAICodexResponsesParams<T extends Record<string, unknown>>(model: Model, params: T): T;
-declare function buildOpenAIResponsesParams(model: Model, context: Context, options: OpenAIResponsesOptions | undefined, metadata?: Record<string, string>): OpenAIResponsesRequestParams;
+declare function buildOpenAIResponsesParams(model: Model, context: Context, options: OpenAIResponsesOptions | undefined, metadata?: Record<string, string>, replayMode?: OpenAIResponsesReplayMode): OpenAIResponsesRequestParams;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-prompt-observer-internal.d.ts
 type ResponsesPromptRequest = {
@@ -379,19 +237,29 @@ declare function createResponsesPromptEgressObserver(options: object | undefined
 //#region packages/ai/src/transports/openai-responses-replay-internal.d.ts
 type ResponsesClientLike = ReturnType<typeof createOpenAIResponsesClient>;
 declare function isInvalidEncryptedContentError(error: unknown): boolean;
-declare function stripResponsesRequestEncryptedContent(params: OpenAIResponsesRequestParams): OpenAIResponsesRequestParams;
-declare function buildOpenAIResponsesReasoningReplayMetadata(model: Model, options?: Pick<BaseOpenAIStreamOptions, "authProfileId" | "sessionId">): OpenAIResponsesReasoningReplayMetadata;
-declare function tagOpenAIResponsesReasoningReplayItem(item: Record<string, unknown>, model: Model, options?: Pick<BaseOpenAIStreamOptions, "authProfileId" | "sessionId">): Record<string, unknown>;
-declare function prepareOpenAIResponsesReasoningItemForReplay(item: ReplayableResponseReasoningItem, context: OpenAIResponsesReplayContext, blockMetadata?: OpenAIResponsesReasoningReplayMetadata): ReplayableResponseReasoningItem;
+type ResponsesEncryptedContentRequest = {
+  input?: ResponseInput;
+};
+type ResponsesEncryptedContentAttemptKind = "initial" | "reasoning-stripped" | "compaction-stripped" | "continuation-rejected";
+type ResponsesEncryptedContentAttempt<TRequest extends ResponsesEncryptedContentRequest> = {
+  kind: ResponsesEncryptedContentAttemptKind;
+  request: TRequest;
+  rejectedCompaction?: OpenAIResponsesCompactionRejection;
+};
 declare function createResponsesStreamWithEncryptedContentRetry(params: {
   client: ResponsesClientLike;
   request: OpenAIResponsesRequestParams;
   requestOptions: unknown;
   model: Model;
   observePrompt?: NonNullable<ReturnType<typeof createResponsesPromptEgressObserver>>;
+  initialAttemptKind?: ResponsesEncryptedContentAttemptKind;
+  initialRejectedCompaction?: OpenAIResponsesCompactionRejection;
+  onCompactionRejected?: (checkpoint: OpenAIResponsesCompactionRejection) => void;
+  buildFullHistoryRequest?: () => OpenAIResponsesRequestParams | Promise<OpenAIResponsesRequestParams>;
 }): Promise<{
   stream: AsyncIterable<unknown>;
   response: Response;
+  attempt: ResponsesEncryptedContentAttempt<OpenAIResponsesRequestParams>;
 }>;
 declare function resolveAzureOpenAIApiVersion(env?: NodeJS.ProcessEnv): string;
 //#endregion
@@ -408,7 +276,78 @@ type ResponsesStreamOptions = FirstStreamEventInternalOptions & {
   signal?: AbortSignal;
   reasoningReplayMetadata?: OpenAIResponsesReasoningReplayMetadata;
 };
-declare function processResponsesStream<TApi extends Api>(openaiStream: AsyncIterable<unknown>, output: AssistantMessage, stream: ResponsesEventSink, model: Model<TApi>, options?: ResponsesStreamOptions): Promise<void>;
+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: {
+  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): {
+  timeout?: number;
+};
+declare function buildOpenAISdkRequestOptions(model: Model, signal?: AbortSignal, options?: {
+  stream?: boolean;
+  timeoutMs?: number;
+  maxRetries?: number;
+}): {
+  signal?: AbortSignal;
+  timeout?: number;
+  maxRetries?: number;
+  headers?: Record<string, string>;
+} | undefined;
+declare function getCompat(model: OpenAIModeModel): {
+  cacheControlFormat: "anthropic" | undefined;
+  reasoningEffortMap: Record<string, string>;
+  openRouterRouting: Record<string, unknown>;
+  vercelGatewayRouting: Record<string, unknown>;
+  requiresStringContent: boolean;
+  strictMessageKeys: boolean;
+  supportsStore: boolean;
+  supportsDeveloperRole: boolean;
+  supportsReasoningEffort: boolean;
+  supportsUsageInStreaming: boolean;
+  maxTokensField: "max_completion_tokens" | "max_tokens";
+  requiresToolResultName: boolean;
+  requiresAssistantAfterToolResult: boolean;
+  requiresThinkingAsText: boolean;
+  requiresReasoningContentOnAssistantMessages: boolean;
+  thinkingFormat: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
+  zaiToolStream: boolean;
+  supportsStrictMode: boolean;
+  supportsJsonSchemaResponseFormat: boolean;
+  supportsPromptCacheKey: boolean;
+  supportsLongCacheRetention: boolean;
+  sessionAffinity: "openai" | "openrouter" | "none";
+  visibleReasoningDetailTypes: string[];
+  requiresNonEmptyUserOrAssistantMessage: boolean;
+};
+//#endregion
+//#region packages/ai/src/transports/openai-responses-compact-request.d.ts
+type OpenAIResponsesCompactEndpointResult = {
+  item: {
+    type: "compaction";
+    id?: string;
+    encrypted_content: string;
+  };
+  historyMode: "compacted-prefix" | "retained-users";
+  usage: Record<string, unknown> & {
+    input_tokens: number;
+    output_tokens: number;
+  };
+  model: Model;
+  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>;
 //#endregion
 //#region packages/ai/src/transports/openai-responses-transport.d.ts
 declare const responsesTesting: {
@@ -428,11 +367,8 @@ declare const responsesTesting: {
   buildOpenAIResponsesReasoningReplayMetadata: typeof buildOpenAIResponsesReasoningReplayMetadata;
   isInvalidEncryptedContentError: typeof isInvalidEncryptedContentError;
   normalizeResponsesFailedEvent: typeof normalizeResponsesFailedEvent;
-  prepareOpenAIResponsesReasoningItemForReplay: typeof prepareOpenAIResponsesReasoningItemForReplay;
   createResponsesStreamWithEncryptedContentRetry: typeof createResponsesStreamWithEncryptedContentRetry;
   resolveAzureOpenAIApiVersion: typeof resolveAzureOpenAIApiVersion;
-  stripResponsesRequestEncryptedContent: typeof stripResponsesRequestEncryptedContent;
-  tagOpenAIResponsesReasoningReplayItem: typeof tagOpenAIResponsesReasoningReplayItem;
   summarizeResponsesFailedNoDetailsObservation: typeof summarizeResponsesFailedNoDetailsObservation;
   summarizeResponsesPayload: typeof summarizeResponsesPayload;
   summarizeResponsesTools: typeof summarizeResponsesTools;
@@ -443,6 +379,18 @@ declare global {
   var openclawOpenAIResponsesTransportTestApi: typeof responsesTesting | undefined;
 }
 //#endregion
+//#region packages/ai/src/transports/provider-compaction-replay.d.ts
+/** Whether provider replay state is a prefix-bound server compaction checkpoint. */
+declare function isCompactionReplayCheckpoint(replay: unknown): replay is ProviderReplayState;
+/** Strip prefix-bound checkpoints after local history rewrites. */
+declare function stripCompactionReplayCheckpoint(message: AssistantMessage): AssistantMessage;
+/** Strip prefix-bound checkpoint state from an in-place message rewrite. */
+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;
+//#endregion
 //#region packages/ai/src/transports/provider-transport-stream.d.ts
 type ProviderTransportStreamContext = {
   cfg?: unknown;
@@ -489,26 +437,22 @@ type TransportUsage = {
     total: number;
   };
 };
-type WritableTransportStream = {
-  push(event: unknown): void;
-  end(): void;
-};
-type TransportOutputShape = {
-  stopReason: string;
-  errorMessage?: string;
-  errorCode?: string;
-  errorType?: string;
-  errorBody?: string;
-};
+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: WritableTransportStream;
+  stream: AssistantMessageEventStream;
 };
 /**
  * Abort error to surface for an aborted `signal`.
@@ -521,21 +465,67 @@ declare function createWritableTransportEventStream(): {
  * 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: TransportOutputShape;
+  output: AssistantMessage;
   signal?: AbortSignal;
 }): void;
-declare function assignTransportErrorDetails(output: TransportOutputShape, error: unknown, 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: TransportOutputShape;
+  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;
 //#endregion
-export { GEMINI_THOUGHT_SIGNATURE_VALIDATOR_SKIP, MutableAssistantOutput, OpenAICompletionsContentDelta, type OpenAICompletionsOptions, OpenAIModeModel, ResolvedOpenAICompletionsCompat, WritableTransportStream, applyAnthropicCacheControlToMessages, applyAnthropicEphemeralCacheControlMarkers, applyAnthropicPayloadPolicyToParams, applyOpenAIResponsesPayloadPolicy, assertCodeModeResponsesToolSurface, assignTransportErrorDetails, buildOpenAIClientHeaders, buildOpenAICompletionsParams, buildOpenAISdkClientOptions, buildOpenAISdkRequestOptions, buildTransportAwareSimpleStreamFn, canonicalizeMaxTokensParam, coerceTransportToolCallArguments, createAnthropicMessagesTransportStreamFn, createAzureOpenAIResponsesTransportStreamFn, createBoundaryAwareStreamFnForModel, createDeepSeekTextFilter, createEmptyTransportUsage, createModelStreamCooperativeScheduler, createOpenAICompletionsTransportStreamFn, createOpenAIResponsesTransportStreamFn, createOpenClawTransportStreamFnForModel, createTransportAwareStreamFnForModel, createWritableTransportEventStream, detectOpenAICompletionsCompat, emitModelTransportDebug, enforceCodeModeResponsesToolSurface, failTransportStream, filterCodeModePayloadTools, finalizeTransportStream, flattenCompletionMessagesToStringContent, formatModelTransportDebugBaseUrl, formatModelTransportDebugUrl, getCompat, hasOpenAICompatibleConversationTurn, isCodeModeModelVisibleToolName, isOpenAICodexResponsesModel, isOpenAICompletionsThinkingEnabled, log, mergeTransportHeaders, mergeTransportMetadata, normalizeCodexResponsesBaseUrlForOpenAISdk, parseJsonObjectPreservingUnsafeIntegers, parseJsonPreservingUnsafeIntegers, parseOpenAICompletionsUsage, prepareModelForSimpleCompletion, prepareTransportAwareSimpleModel, quoteUnsafeIntegerLiterals, readCodeModePayloadToolName, readOpenAICompletionsContentDeltas, resolveAnthropicEphemeralCacheControl, resolveAnthropicMessagesUrl, resolveAnthropicPayloadPolicy, resolveCodeModeResponsesVisibleToolNames, resolveMaxTokensParam, resolveModelPayloadDebugMode, resolveModelSseDebugMode, resolveOpenAICompletionsCompat, resolveOpenAIReasoningEffortMap, resolveOpenAIResponsesPayloadPolicy, resolveOpenAIStrictToolFlagWithDiagnostics, resolvePromptCacheKey, resolveReplayableResponsesMessageId, resolveTransportAwareSimpleApi, sanitizeNonEmptyTransportPayloadText, sanitizeResponsesImagePayload, sanitizeTransportPayloadText, sortPromptCacheToolsByName as sortTransportToolsByName, stripCompletionMessagesToRoleContent, throwIfModelStreamAborted, transportAbortError, usesNativeOpenAICodexResponsesBackend };
+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 };