@openclaw/ai 2026.7.2-beta.3 → 2026.7.2-beta.5

package/dist/number-coercion-DvG7SNMg.mjs

@@ -0,0 +1,129 @@
+import { a as requiresClaudeMandatoryAdaptiveThinking, l as resolveClaudeNativeThinkingLevelMap } from "./src-QkygScBs.mjs";
+//#region packages/ai/src/model-utils.ts
+/** Calculates and stores model cost fields from token usage and per-million pricing. */
+function calculateCost(model, usage) {
+	const cacheWrite1h = Math.min(usage.cacheWrite, Math.max(0, usage.cacheWrite1h ?? 0));
+	const cacheWrite5m = usage.cacheWrite - cacheWrite1h;
+	usage.cost.input = model.cost.input / 1e6 * usage.input;
+	usage.cost.output = model.cost.output / 1e6 * usage.output;
+	usage.cost.cacheRead = model.cost.cacheRead / 1e6 * usage.cacheRead;
+	usage.cost.cacheWrite = (model.cost.cacheWrite * cacheWrite5m + model.cost.input * 2 * cacheWrite1h) / 1e6;
+	usage.cost.total = usage.cost.input + usage.cost.output + usage.cost.cacheRead + usage.cost.cacheWrite;
+	return usage.cost;
+}
+/** Replaces the catalog estimate when the provider reports an authoritative billed total. */
+function applyProviderReportedUsageCost(usage, reportedCost) {
+	if (typeof reportedCost !== "number" || !Number.isFinite(reportedCost) || reportedCost < 0) return;
+	usage.cost.total = reportedCost;
+	usage.cost.totalOrigin = "provider-billed";
+}
+const EXTENDED_THINKING_LEVELS = [
+	"off",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+function resolveThinkingLevelMap(model) {
+	return model.api === "anthropic-messages" ? resolveClaudeNativeThinkingLevelMap(model) ?? model.thinkingLevelMap : model.thinkingLevelMap;
+}
+/** Returns thinking levels exposed by a reasoning-capable model. */
+function getSupportedThinkingLevels(model) {
+	const mandatoryAdaptiveContract = model.api === "anthropic-messages" && requiresClaudeMandatoryAdaptiveThinking(model);
+	if (!model.reasoning && !mandatoryAdaptiveContract) return ["off"];
+	const thinkingLevelMap = resolveThinkingLevelMap(model);
+	return EXTENDED_THINKING_LEVELS.filter((level) => {
+		const mapped = thinkingLevelMap?.[level];
+		if (mapped === null) return false;
+		if (level === "xhigh" || level === "max") return mapped !== void 0;
+		return true;
+	});
+}
+/** Clamps a requested thinking level to the closest supported level for a model. */
+function clampThinkingLevel(model, level) {
+	const availableLevels = getSupportedThinkingLevels(model);
+	if (availableLevels.includes(level)) return level;
+	const requestedIndex = EXTENDED_THINKING_LEVELS.indexOf(level);
+	if (requestedIndex === -1) return availableLevels[0] ?? "off";
+	const thinkingLevelMap = resolveThinkingLevelMap(model);
+	if ((level === "xhigh" || level === "max") && thinkingLevelMap?.[level] === null) {
+		for (const candidate of EXTENDED_THINKING_LEVELS.slice(0, requestedIndex).toReversed()) if (availableLevels.includes(candidate)) return candidate;
+	}
+	for (const candidate of EXTENDED_THINKING_LEVELS.slice(requestedIndex)) if (availableLevels.includes(candidate)) return candidate;
+	for (const candidate of EXTENDED_THINKING_LEVELS.slice(0, requestedIndex).toReversed()) if (availableLevels.includes(candidate)) return candidate;
+	return availableLevels[0] ?? "off";
+}
+/** Compares model identity by provider and id. */
+function modelsAreEqual(a, b) {
+	if (!a || !b) return false;
+	return a.id === b.id && a.provider === b.provider;
+}
+//#endregion
+//#region packages/normalization-core/src/number-coercion.ts
+/** Returns a number only when the input is already finite. */
+function asFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/** Returns a finite number only when it satisfies the supplied inclusive/exclusive bounds. */
+function asFiniteNumberInRange(value, range) {
+	const number = asFiniteNumber(value);
+	if (number === void 0) return;
+	if (range.min !== void 0) {
+		if (range.minExclusive ? number <= range.min : number < range.min) return;
+	}
+	if (range.max !== void 0) {
+		if (range.maxExclusive ? number >= range.max : number > range.max) return;
+	}
+	return number;
+}
+function normalizeNumericString(value) {
+	const trimmed = value.trim();
+	return trimmed ? trimmed : void 0;
+}
+/** Parses only safe integer numbers or base-10 integer strings. */
+function parseStrictInteger(value) {
+	if (typeof value === "number") return Number.isSafeInteger(value) ? value : void 0;
+	if (typeof value !== "string") return;
+	const normalized = normalizeNumericString(value);
+	if (!normalized || !/^[+-]?\d+$/.test(normalized)) return;
+	const parsed = Number(normalized);
+	return Number.isSafeInteger(parsed) ? parsed : void 0;
+}
+/** Parses only finite decimal/scientific string tokens, rejecting partial numbers. */
+function parseStrictFiniteNumber(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+	if (typeof value !== "string") return;
+	const normalized = normalizeNumericString(value);
+	if (!normalized || !/^[+-]?(?:(?:\d+\.?\d*)|(?:\.\d+))(?:e[+-]?\d+)?$/i.test(normalized)) return;
+	const parsed = Number(normalized);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+/** Conservative upper bound for Node timer delays. */
+const MAX_TIMER_TIMEOUT_MS = 2147e6;
+/** Clamps finite millisecond values into the Node-safe timer range. */
+function clampTimerTimeoutMs(valueMs, minMs = 1) {
+	const value = asFiniteNumber(valueMs);
+	if (value === void 0) return;
+	return Math.min(Math.max(Math.floor(value), Math.max(1, Math.floor(minMs))), MAX_TIMER_TIMEOUT_MS);
+}
+/** Resolves arbitrary timeout input with fallback and minimum timer bounds. */
+function resolveTimerTimeoutMs(valueMs, fallbackMs, minMs = 1) {
+	const value = asFiniteNumber(valueMs) ?? asFiniteNumber(fallbackMs);
+	const min = Math.max(0, Math.floor(minMs));
+	if (value === void 0) return min;
+	return Math.min(Math.max(Math.floor(value), min), MAX_TIMER_TIMEOUT_MS);
+}
+/** Parses strict positive integer values from numbers or strings. */
+function parseStrictPositiveInteger(value) {
+	const parsed = parseStrictInteger(value);
+	return parsed !== void 0 && parsed > 0 ? parsed : void 0;
+}
+/** Parses strict non-negative integer values from numbers or strings. */
+function parseStrictNonNegativeInteger(value) {
+	const parsed = parseStrictInteger(value);
+	return parsed !== void 0 && parsed >= 0 ? parsed : void 0;
+}
+//#endregion
+export { parseStrictPositiveInteger as a, calculateCost as c, modelsAreEqual as d, parseStrictNonNegativeInteger as i, clampThinkingLevel as l, clampTimerTimeoutMs as n, resolveTimerTimeoutMs as o, parseStrictFiniteNumber as r, applyProviderReportedUsageCost as s, asFiniteNumberInRange as t, getSupportedThinkingLevels as u };

package/dist/openai-BPor_3WI.d.mts

@@ -0,0 +1,358 @@
+import { E as Model, F as SimpleStreamOptions, I as StopReason, O as OpenAICompletionsCompat, R as StreamFunction, X as Usage, u as Context, z as StreamOptions } from "./types-bzp5k29J.mjs";
+import { a as AiProviderRequestPolicyInput, i as AiProviderRequestCapabilities } from "./host-B9GUmcra.mjs";
+import OpenAI from "openai";
+import { TSchema } from "typebox";
+import { ChatCompletionMessageParam } from "openai/resources/chat/completions.js";
+import { ResponseCreateParamsStreaming } from "openai/resources/responses/responses.js";
+
+//#region packages/ai/src/providers/agent-tools-parameter-schema.d.ts
+/**
+ * Narrow structural view of the host's model compat config. packages/ai must stay
+ * config-agnostic, so only tool-schema-relevant fields are modeled here; the host's
+ * ModelCompatConfig remains structurally assignable.
+ */
+type ToolSchemaModelCompat = {
+  toolSchemaProfile?: string;
+  unsupportedToolSchemaKeywords?: string[];
+  omitEmptyArrayItems?: boolean;
+};
+/** Extracts the compat record whether callers pass a model (`{ compat }`) or the compat itself. */
+declare function extractToolSchemaModelCompat(modelOrCompat: {
+  compat?: unknown;
+} | ToolSchemaModelCompat | undefined): ToolSchemaModelCompat | undefined;
+/** JSON Schema keywords this model/provider rejects in tool schemas. */
+declare function resolveUnsupportedToolSchemaKeywords(modelOrCompat: {
+  compat?: unknown;
+} | ToolSchemaModelCompat | undefined): ReadonlySet<string>;
+/** Whether empty `items: {}` on array schemas must be omitted for this model/provider. */
+declare function shouldOmitEmptyArrayItems(modelOrCompat: {
+  compat?: unknown;
+} | ToolSchemaModelCompat | undefined): boolean;
+type ToolParameterSchemaOptions = {
+  modelProvider?: string;
+  modelId?: string;
+  modelCompat?: ToolSchemaModelCompat;
+};
+/** Return a provider-compatible JSON schema for a model-facing tool. */
+declare function normalizeToolParameterSchema(schema: unknown, options?: ToolParameterSchemaOptions): TSchema;
+//#endregion
+//#region packages/ai/src/providers/azure-deployment-map.d.ts
+/** Parses AZURE_OPENAI_DEPLOYMENT_MAP-style model=deployment entries. */
+declare function parseAzureDeploymentNameMap(value: string | undefined): Map<string, string>;
+/**
+ * Resolves the Azure deployment name for a model id, falling back to the model id.
+ *
+ * An exact-case match always wins, so configs that intentionally distinguish keys by
+ * case keep their exact mappings; a case-insensitive match is only used as a fallback
+ * (e.g. `GPT-4o` against a `gpt-4o=...` map) to avoid 404s from casing differences.
+ */
+declare function resolveAzureDeploymentNameFromMap(params: {
+  modelId: string;
+  deploymentMap?: string;
+}): string;
+//#endregion
+//#region packages/ai/src/providers/azure-openai-responses-client-compat.d.ts
+declare function isTraditionalAzureOpenAIHost(hostname: string): boolean;
+declare function isOpenAICompatibleAzureResponsesBaseUrl(baseUrl: string): boolean;
+//#endregion
+//#region packages/ai/src/providers/clean-for-gemini.d.ts
+declare const GEMINI_UNSUPPORTED_SCHEMA_KEYWORDS: Set<string>;
+declare function cleanSchemaForGemini(schema: unknown): TSchema;
+//#endregion
+//#region packages/ai/src/transports/openai-completions-compat.d.ts
+type ProviderRequestCapabilities = AiProviderRequestCapabilities;
+type OpenAICompletionsSessionAffinity = "none" | "openai" | "openrouter";
+type OpenAICompletionsCompatDefaults = {
+  supportsStore: boolean;
+  supportsDeveloperRole: boolean;
+  supportsReasoningEffort: boolean;
+  supportsUsageInStreaming: boolean;
+  maxTokensField: "max_completion_tokens" | "max_tokens";
+  thinkingFormat: "openai" | "openrouter" | "deepseek" | "together" | "zai";
+  visibleReasoningDetailTypes: string[];
+  supportsStrictMode: boolean;
+  supportsJsonSchemaResponseFormat: boolean;
+  requiresReasoningContentOnAssistantMessages: boolean;
+  requiresNonEmptyUserOrAssistantMessage: boolean;
+  cacheControlFormat?: OpenAICompletionsCompat["cacheControlFormat"];
+  sessionAffinityFormat: Exclude<OpenAICompletionsSessionAffinity, "none">;
+  supportsLongCacheRetention: boolean;
+};
+type DetectedOpenAICompletionsCompat = {
+  capabilities: ProviderRequestCapabilities;
+  defaults: OpenAICompletionsCompatDefaults;
+};
+type ResolvedOpenAICompletionsCompat = Omit<Required<OpenAICompletionsCompat>, "cacheControlFormat" | "openRouterRouting" | "sendSessionAffinityHeaders"> & {
+  cacheControlFormat?: OpenAICompletionsCompat["cacheControlFormat"];
+  openRouterRouting?: OpenAICompletionsCompat["openRouterRouting"];
+  sessionAffinity: OpenAICompletionsSessionAffinity;
+  visibleReasoningDetailTypes: string[];
+  requiresNonEmptyUserOrAssistantMessage: boolean;
+};
+/** Detects endpoint capabilities and defaults for an OpenAI-completions model. */
+declare function detectOpenAICompletionsCompat(model: Pick<Model<"openai-completions">, "provider" | "baseUrl" | "id"> & {
+  compat?: {
+    supportsStore?: boolean;
+  } | null;
+}, resolveCapabilities?: (input: AiProviderRequestPolicyInput) => ProviderRequestCapabilities): DetectedOpenAICompletionsCompat;
+/** Applies explicit model overrides once on top of the canonical transport defaults. */
+declare function resolveOpenAICompletionsCompat(model: Model<"openai-completions">, resolveCapabilities?: (input: AiProviderRequestPolicyInput) => ProviderRequestCapabilities): ResolvedOpenAICompletionsCompat;
+//#endregion
+//#region packages/ai/src/providers/openai-tool-projection.d.ts
+type OpenAIToolDescriptor = {
+  readonly name?: unknown;
+  readonly description?: unknown;
+  readonly parameters: unknown;
+};
+type OpenAIProjectedTool = {
+  readonly toolIndex: number;
+  readonly name: string;
+  readonly description?: string;
+  readonly parameters: Record<string, unknown>;
+};
+type OpenAIToolProjectionDiagnostic = {
+  readonly toolIndex: number;
+  readonly toolName?: string;
+  readonly violations: readonly string[];
+};
+type OpenAIToolProjection = {
+  readonly inputToolCount: number;
+  readonly tools: readonly OpenAIProjectedTool[];
+  readonly diagnostics: readonly OpenAIToolProjectionDiagnostic[];
+};
+type OpenAIResponsesToolChoice = ResponseCreateParamsStreaming["tool_choice"];
+type OpenAICompletionsSdkToolChoice = OpenAI.Chat.Completions.ChatCompletionCreateParamsStreaming["tool_choice"];
+type OpenAICompletionsToolChoice = Exclude<OpenAICompletionsSdkToolChoice, {
+  type: "custom";
+}>;
+/** Snapshots direct/custom tool descriptors before OpenAI payload construction. */
+declare function projectOpenAITools(tools: readonly OpenAIToolDescriptor[]): OpenAIToolProjection;
+/** Keeps Responses tool choices aligned with surviving function schemas. */
+declare function reconcileOpenAIResponsesToolChoice(choice: OpenAIResponsesToolChoice, projection: OpenAIToolProjection): OpenAIResponsesToolChoice | undefined;
+/** Keeps Chat Completions tool choices aligned with surviving function schemas. */
+declare function reconcileOpenAICompletionsToolChoice(choice: OpenAICompletionsSdkToolChoice, projection: OpenAIToolProjection): OpenAICompletionsSdkToolChoice | undefined;
+//#endregion
+//#region packages/ai/src/providers/openai-completions.d.ts
+interface OpenAICompletionsOptions extends StreamOptions {
+  toolChoice?: OpenAICompletionsToolChoice;
+  reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+}
+declare const streamOpenAICompletions: StreamFunction<"openai-completions", OpenAICompletionsOptions>;
+declare const streamSimpleOpenAICompletions: StreamFunction<"openai-completions", SimpleStreamOptions>;
+declare function convertMessages(model: Model<"openai-completions">, context: Context, compat: ResolvedOpenAICompletionsCompat, options?: {
+  cacheOptOutIndexes?: Set<number>;
+  preserveSystemPromptCacheBoundary?: boolean;
+}): ChatCompletionMessageParam[];
+//#endregion
+//#region packages/ai/src/providers/openai-reasoning-effort.d.ts
+type OpenAIReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+type OpenAIApiReasoningEffort = OpenAIReasoningEffort | (string & {});
+type OpenAIReasoningModel = {
+  provider?: unknown;
+  id?: unknown;
+  name?: unknown;
+  api?: unknown;
+  baseUrl?: unknown;
+  compat?: unknown;
+};
+/** Return whether a model is the GPT-5.4 mini family. */
+declare function isOpenAIGpt54MiniModel(model: OpenAIReasoningModel): boolean;
+/** Return whether a model is the GPT-5.5 family. */
+declare function isOpenAIGpt55Model(model: OpenAIReasoningModel): boolean;
+/** Return whether a model is the GPT-5.6 family. */
+declare function isOpenAIGpt56Model(model: OpenAIReasoningModel): boolean;
+/** Normalize user-facing reasoning effort names to API effort names. */
+declare function normalizeOpenAIReasoningEffort(effort: string): string;
+/** Resolve the reasoning efforts accepted by a specific OpenAI-compatible model. */
+declare function resolveOpenAISupportedReasoningEfforts(model: OpenAIReasoningModel): readonly OpenAIApiReasoningEffort[];
+/**
+ * Return whether a model accepts the temperature parameter. The GPT-5.6
+ * family rejects it with a 400; catalog compat can override per model.
+ */
+declare function supportsOpenAITemperature(model: OpenAIReasoningModel): boolean;
+/** Return whether a model accepts a requested reasoning effort. */
+declare function supportsOpenAIReasoningEffort(model: OpenAIReasoningModel, effort: string): boolean;
+/** Resolve a requested reasoning effort to the closest value supported by the model. */
+declare function resolveOpenAIReasoningEffortForModel(params: {
+  model: OpenAIReasoningModel;
+  effort: string;
+  fallbackMap?: Record<string, string>;
+}): OpenAIApiReasoningEffort | undefined;
+//#endregion
+//#region packages/ai/src/providers/openai-responses.d.ts
+interface OpenAIResponsesOptions extends StreamOptions {
+  reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+  reasoningSummary?: "auto" | "detailed" | "concise" | null;
+  replayResponsesItemIds?: boolean;
+  serviceTier?: ResponseCreateParamsStreaming["service_tier"];
+}
+/**
+ * Generate function for OpenAI Responses API
+ */
+declare const streamOpenAIResponses: StreamFunction<"openai-responses", OpenAIResponsesOptions>;
+declare const streamSimpleOpenAIResponses: StreamFunction<"openai-responses", SimpleStreamOptions>;
+//#endregion
+//#region packages/ai/src/providers/openai-responses-stream-compat.d.ts
+declare const OPENAI_RESPONSES_OUTPUT_TEXT_CONTENT_PART_TYPE = "output_text";
+declare const AZURE_RESPONSES_TEXT_CONTENT_PART_TYPE = "text";
+declare const OPENAI_RESPONSES_OUTPUT_TEXT_DELTA_EVENT_TYPE = "response.output_text.delta";
+declare const AZURE_RESPONSES_TEXT_DELTA_EVENT_TYPE = "response.text.delta";
+type ResponsesTextContentPartType = typeof OPENAI_RESPONSES_OUTPUT_TEXT_CONTENT_PART_TYPE | typeof AZURE_RESPONSES_TEXT_CONTENT_PART_TYPE;
+type ResponsesTextDeltaEventType = typeof OPENAI_RESPONSES_OUTPUT_TEXT_DELTA_EVENT_TYPE | typeof AZURE_RESPONSES_TEXT_DELTA_EVENT_TYPE;
+type AzureResponsesTextContentPart = {
+  type: typeof AZURE_RESPONSES_TEXT_CONTENT_PART_TYPE;
+  text: string;
+};
+type AzureResponsesTextDeltaEvent = {
+  type: typeof AZURE_RESPONSES_TEXT_DELTA_EVENT_TYPE;
+  delta: string;
+};
+declare function isResponsesTextContentPartType(type: unknown): type is ResponsesTextContentPartType;
+declare function isResponsesTextDeltaEventType(type: unknown): type is ResponsesTextDeltaEventType;
+declare function isAzureResponsesTextDeltaEventType(type: unknown): type is typeof AZURE_RESPONSES_TEXT_DELTA_EVENT_TYPE;
+declare function isAzureResponsesTextDeltaEvent(event: {
+  type?: unknown;
+  delta?: unknown;
+}): event is AzureResponsesTextDeltaEvent;
+type ResponsesMessageSnapshotCollapse = {
+  kind: "extend";
+  text: string;
+} | {
+  kind: "keep";
+};
+declare function resolveResponsesMessageSnapshotCollapse(params: {
+  prior: {
+    text: string;
+    phase: string | undefined;
+  } | null;
+  nextText: string;
+  nextPhase: string | undefined;
+}): ResponsesMessageSnapshotCollapse;
+//#endregion
+//#region packages/ai/src/providers/openai-responses-terminal-usage.d.ts
+/** Terminal usage payload, modeled structurally so untyped callers can pass raw records. */
+type ResponsesTerminalUsagePayload = {
+  input_tokens?: number | null;
+  output_tokens?: number | null;
+  total_tokens?: number | null;
+  input_tokens_details?: {
+    cached_tokens?: number | null;
+    cache_write_tokens?: number | null;
+  } | null;
+  output_tokens_details?: {
+    reasoning_tokens?: number | null;
+  } | null;
+};
+/**
+ * Split a terminal usage payload into the priced buckets.
+ *
+ * OpenAI includes cache reads and writes in `input_tokens`, so both are subtracted out of the
+ * billable input bucket. `total_tokens` comes from the payload, but never below the sum of the
+ * split buckets: proxies routinely omit it (reporting 0 would understate the turn), and a payload
+ * whose `cached_tokens` exceeds `input_tokens` clamps the input bucket, leaving the reported total
+ * short of what the buckets actually price.
+ */
+declare function mapResponsesTerminalUsage(usage: ResponsesTerminalUsagePayload | undefined | null): Pick<Usage, "input" | "output" | "cacheRead" | "cacheWrite" | "totalTokens"> | undefined;
+/** Reasoning tokens are reported by the agent path only; the package path does not track them. */
+declare function readResponsesReasoningTokens(usage: ResponsesTerminalUsagePayload | undefined | null): number | undefined;
+/**
+ * Resolve the terminal stop reason, including the two overrides every Responses path shares: a
+ * content-filtered turn is a provider error rather than a truncated answer, and a turn that
+ * produced tool calls reports `toolUse` instead of a plain stop.
+ */
+declare function resolveResponsesTerminalStopReason(params: {
+  status: OpenAI.Responses.ResponseStatus | undefined;
+  incompleteReason?: string;
+  hasToolCall: boolean;
+}): {
+  stopReason: StopReason;
+  errorMessage?: string;
+};
+//#endregion
+//#region packages/ai/src/providers/openai-responses-tool-call-tracker.d.ts
+type ResponsesToolCallIdentity = {
+  itemId?: string;
+  callId?: string;
+};
+type ResponsesToolCallState = ResponsesToolCallIdentity & {
+  argumentStreamReliable: boolean;
+};
+type ResponsesToolCallEvent = {
+  output_index?: unknown;
+  item_id?: unknown;
+};
+declare function readResponsesToolCallItemIdentity(item: {
+  id?: unknown;
+  call_id?: unknown;
+}): ResponsesToolCallIdentity;
+declare function createResponsesToolCallTracker<TState extends ResponsesToolCallState>(): {
+  register(event: ResponsesToolCallEvent, state: TState): void;
+  resolve(event: ResponsesToolCallEvent, identity?: ResponsesToolCallIdentity): TState | undefined;
+  forget(toolCall: TState): void;
+  markArgumentsUnreliable(): void;
+  hasActive(): boolean;
+};
+//#endregion
+//#region packages/ai/src/providers/openai-stop-reason.d.ts
+type OpenAIStopReasonResult = {
+  stopReason: StopReason;
+  errorMessage?: string;
+};
+declare function mapOpenAIStopReason(reason: string | null, options?: {
+  allowSingularToolCall?: boolean;
+}): OpenAIStopReasonResult;
+//#endregion
+//#region packages/ai/src/providers/openai-tool-schema-compat.d.ts
+/** Repairs recoverable OpenAI tool-schema shapes before canonical normalization. */
+declare function normalizeOpenAIStrictCompatSchema(schema: unknown): TSchema;
+/** Finds schema paths that violate OpenAI strict tool-schema requirements. */
+declare function findOpenAIStrictSchemaViolations(schema: unknown, path: string, options?: {
+  requireObjectRoot?: boolean;
+}): string[];
+//#endregion
+//#region packages/ai/src/providers/openai-tool-schema.d.ts
+/**
+ * OpenAI strict-tool-schema normalization and diagnostics.
+ *
+ * Strict schemas need all object properties required and `additionalProperties: false`; model
+ * compatibility settings can also remove unsupported schema constructs before strict checks run.
+ */
+type ToolSchemaCompatInput = {
+  unsupportedToolSchemaKeywords?: unknown;
+  omitEmptyArrayItems?: unknown;
+};
+declare function clearOpenAIToolSchemaCacheForTest(): void;
+/** Normalizes a tool parameter schema into the OpenAI strict JSON-schema subset. */
+declare function normalizeStrictOpenAIJsonSchema(schema: unknown, modelCompat?: ToolSchemaCompatInput | null): unknown;
+/** Normalizes tool parameters using strict OpenAI rules only when strict mode is active. */
+declare function normalizeOpenAIStrictToolParameters<T>(schema: T, strict: boolean, modelCompat?: ToolSchemaCompatInput | null): T;
+/** Returns whether a schema already satisfies OpenAI strict tool-schema constraints. */
+declare function isStrictOpenAIJsonSchemaCompatible(schema: unknown): boolean;
+type OpenAIStrictToolSchemaDiagnostic = {
+  toolIndex: number;
+  toolName?: string;
+  violations: string[];
+};
+/** Returns strict-schema diagnostics for an already materialized OpenAI tool projection. */
+declare function findOpenAIStrictToolProjectionDiagnostics(projection: OpenAIToolProjection): OpenAIStrictToolSchemaDiagnostic[];
+/** Resolves strict mode for the projected tools that will be emitted in the request payload. */
+declare function resolveOpenAIProjectedToolsStrictToolFlag(projection: OpenAIToolProjection, strict: boolean | null | undefined): boolean | undefined;
+//#endregion
+//#region packages/ai/src/providers/schema-keyword-strip.d.ts
+/** Recursively remove schema keywords unsupported by a target provider/tool surface. */
+declare function stripUnsupportedSchemaKeywords(schema: unknown, unsupportedKeywords: ReadonlySet<string>): unknown;
+//#endregion
+//#region packages/ai/src/providers/tool-schema-json-projection.d.ts
+/** JSON-safe schema value used when projecting runtime tool parameters. */
+type RuntimeToolInputSchemaJson = null | boolean | number | string | RuntimeToolInputSchemaJson[] | {
+  [key: string]: RuntimeToolInputSchemaJson;
+};
+/** Projected runtime tool schema plus validation violations. */
+type RuntimeToolInputSchemaProjection = {
+  readonly schema: RuntimeToolInputSchemaJson;
+  readonly violations: readonly string[];
+};
+/** Projects one runtime tool input schema to JSON and reports runtime incompatibilities. */
+declare function projectRuntimeToolInputSchema(schema: unknown, path?: string): RuntimeToolInputSchemaProjection;
+//#endregion
+export { streamSimpleOpenAICompletions as $, ResponsesTextContentPartType as A, OpenAIApiReasoningEffort as B, AZURE_RESPONSES_TEXT_CONTENT_PART_TYPE as C, OPENAI_RESPONSES_OUTPUT_TEXT_CONTENT_PART_TYPE as D, AzureResponsesTextDeltaEvent as E, isResponsesTextDeltaEventType as F, normalizeOpenAIReasoningEffort as G, isOpenAIGpt54MiniModel as H, resolveResponsesMessageSnapshotCollapse as I, supportsOpenAIReasoningEffort as J, resolveOpenAIReasoningEffortForModel as K, OpenAIResponsesOptions as L, isAzureResponsesTextDeltaEvent as M, isAzureResponsesTextDeltaEventType as N, OPENAI_RESPONSES_OUTPUT_TEXT_DELTA_EVENT_TYPE as O, isResponsesTextContentPartType as P, streamOpenAICompletions as Q, streamOpenAIResponses as R, resolveResponsesTerminalStopReason as S, AzureResponsesTextContentPart as T, isOpenAIGpt55Model as U, OpenAIReasoningEffort as V, isOpenAIGpt56Model as W, OpenAICompletionsOptions as X, supportsOpenAITemperature as Y, convertMessages as Z, createResponsesToolCallTracker as _, normalizeToolParameterSchema as _t, clearOpenAIToolSchemaCacheForTest as a, ResolvedOpenAICompletionsCompat as at, mapResponsesTerminalUsage as b, normalizeOpenAIStrictToolParameters as c, GEMINI_UNSUPPORTED_SCHEMA_KEYWORDS as ct, findOpenAIStrictSchemaViolations as d, isTraditionalAzureOpenAIHost as dt, OpenAICompletionsToolChoice as et, normalizeOpenAIStrictCompatSchema as f, parseAzureDeploymentNameMap as ft, ResponsesToolCallState as g, extractToolSchemaModelCompat as gt, ResponsesToolCallIdentity as h, ToolSchemaModelCompat as ht, stripUnsupportedSchemaKeywords as i, reconcileOpenAIResponsesToolChoice as it, ResponsesTextDeltaEventType as j, ResponsesMessageSnapshotCollapse as k, normalizeStrictOpenAIJsonSchema as l, cleanSchemaForGemini as lt, mapOpenAIStopReason as m, ToolParameterSchemaOptions as mt, RuntimeToolInputSchemaProjection as n, projectOpenAITools as nt, findOpenAIStrictToolProjectionDiagnostics as o, detectOpenAICompletionsCompat as ot, OpenAIStopReasonResult as p, resolveAzureDeploymentNameFromMap as pt, resolveOpenAISupportedReasoningEfforts as q, projectRuntimeToolInputSchema as r, reconcileOpenAICompletionsToolChoice as rt, isStrictOpenAIJsonSchemaCompatible as s, resolveOpenAICompletionsCompat as st, RuntimeToolInputSchemaJson as t, OpenAIToolProjection as tt, resolveOpenAIProjectedToolsStrictToolFlag as u, isOpenAICompatibleAzureResponsesBaseUrl as ut, readResponsesToolCallItemIdentity as v, resolveUnsupportedToolSchemaKeywords as vt, AZURE_RESPONSES_TEXT_DELTA_EVENT_TYPE as w, readResponsesReasoningTokens as x, ResponsesTerminalUsagePayload as y, shouldOmitEmptyArrayItems as yt, streamSimpleOpenAIResponses as z };