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

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 { $ as Usage, B as StreamFn, E as Model, F as ProviderReplayState, O as OpenAICompletionsCompat, a as AssistantMessageEvent, i as AssistantMessage, n as Api, u as Context } from "./types-BHNrPS1l.mjs";
+import { t as AssistantMessageEventStream } from "./event-stream-BP6AWT8j.mjs";
+import { n as ApiRegistry } from "./api-registry-k3zTz0cV.mjs";
+import { a as OpenAICompletionsOptions, c as OpenAIToolProjection, i as BaseOpenAIStreamOptions, o as OpenAIResponsesCompactionRejection } from "./provider-options-B96RdNpH.mjs";
+import { a as resolveAnthropicPayloadPolicy, i as resolveAnthropicEphemeralCacheControl, n as applyAnthropicEphemeralCacheControlMarkers, o as resolveAnthropicServerCompactionPlan, r as applyAnthropicPayloadPolicyToParams, t as applyAnthropicCacheControlToMessages } from "./anthropic-payload-policy-CiEuQS72.mjs";
+import { a as ReplayableResponseCompactionItem, i as OpenAIResponsesRequestParams, n as OpenAIResponsesOptions, o as ResponsesPromptObservation, r as OpenAIResponsesReasoningReplayMetadata } from "./openai-responses-contracts-XpZJxrRG.mjs";
+import { i as resolveOpenAIResponsesServerCompactionPlan, n as resolveOpenAIResponsesCompactEndpointPlan, r as resolveOpenAIResponsesPayloadPolicy, t as applyOpenAIResponsesPayloadPolicy } from "./openai-responses-payload-policy-BSs371VM.mjs";
+import { n as detectOpenAICompletionsCompat, r as resolveOpenAICompletionsCompat, t as ResolvedOpenAICompletionsCompat } from "./openai-completions-compat-Dt3dcawL.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;
@@ -177,107 +146,26 @@ 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;
 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 +177,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 +193,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, replayIndex: number | undefined, 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 +229,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 +242,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 +281,77 @@ 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>): void;
+declare function resolveCodeModeResponsesVisibleToolNames(context: Pick<Context, "tools">): ReadonlySet<string>;
+declare function enforceCodeModeResponsesToolSurface(payload: unknown, visibleToolNames: ReadonlySet<string>, allowedHostedToolTypes?: ReadonlySet<string>): 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;
+  };
+  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 +371,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 +383,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;
@@ -493,12 +445,8 @@ type WritableTransportStream = {
   push(event: unknown): void;
   end(): void;
 };
-type TransportOutputShape = {
+type TransportOutputShape = Partial<Omit<ProviderErrorProjection, "stopReason">> & {
   stopReason: string;
-  errorMessage?: string;
-  errorCode?: string;
-  errorType?: string;
-  errorBody?: string;
 };
 declare function sanitizeTransportPayloadText(text: string): string;
 declare function sanitizeNonEmptyTransportPayloadText(text: string, fallback?: string): string;
@@ -521,11 +469,20 @@ declare function createWritableTransportEventStream(): {
  * already emits rather than churning it.
  */
 declare function transportAbortError(signal?: AbortSignal): Error;
+/** 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;
   signal?: AbortSignal;
 }): void;
+/** @deprecated Use projectProviderError. v2026.7.2-beta.5 compatibility; remove after 2026.10. */
 declare function assignTransportErrorDetails(output: TransportOutputShape, error: unknown, signal?: AbortSignal): void;
 declare function failTransportStream(params: {
   stream: WritableTransportStream;
@@ -538,4 +495,4 @@ declare function failTransportStream(params: {
 //#region packages/ai/src/transports/transport-utils.d.ts
 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, MutableAssistantOutput, OpenAICompletionsContentDelta, type OpenAICompletionsOptions, OpenAIModeModel, type OpenAIResponsesCompactionRejection, ResolvedOpenAICompletionsCompat, WritableTransportStream, applyAnthropicCacheControlToMessages, applyAnthropicEphemeralCacheControlMarkers, applyAnthropicPayloadPolicyToParams, applyOpenAIResponsesPayloadPolicy, assertCodeModeResponsesToolSurface, assignTransportErrorDetails, buildOpenAIClientHeaders, buildOpenAICompletionsParams, buildOpenAISdkClientOptions, buildOpenAISdkRequestOptions, buildTransportAwareSimpleStreamFn, canonicalizeMaxTokensParam, captureOpenAIResponsesCompaction, coerceTransportToolCallArguments, createAnthropicMessagesTransportStreamFn, createAzureOpenAIResponsesTransportStreamFn, createBoundaryAwareStreamFnForModel, createDeepSeekTextFilter, createEmptyTransportUsage, createModelStreamCooperativeScheduler, createOpenAICompletionsTransportStreamFn, createOpenAIResponseHook, createOpenAIResponsesTransportStreamFn, createOpenClawTransportStreamFnForModel, createTransportAwareStreamFnForModel, createWritableTransportEventStream, detectOpenAICompletionsCompat, emitModelTransportDebug, enforceCodeModeResponsesToolSurface, failTransportStream, filterCodeModePayloadTools, finalizeTransportStream, flattenCompletionMessagesToStringContent, formatModelTransportDebugBaseUrl, formatModelTransportDebugUrl, getCompat, googleFlashSupportsMinimalThinking, hasOpenAICompatibleConversationTurn, isCodeModeModelVisibleToolName, isCompactionReplayCheckpoint, isOpenAICodexResponsesModel, isOpenAICompletionsThinkingEnabled, log, measureUtf8AppendBytes, mergeTransportHeaders, mergeTransportMetadata, normalizeCodexResponsesBaseUrlForOpenAISdk, parseJsonObjectPreservingUnsafeIntegers, parseJsonPreservingUnsafeIntegers, parseOpenAICompletionsUsage, prepareModelForSimpleCompletion, prepareTransportAwareSimpleModel, quoteUnsafeIntegerLiterals, readCodeModePayloadToolName, readOpenAICompletionsContentDeltas, 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, withProviderResponseHook };