@ap3x/ai 0.1.0

package/dist/providers/mistral.d.ts

@@ -0,0 +1,67 @@
+import type { Context, Message, Model, SimpleStreamOptions, StreamFunction, StreamOptions } from "../types";
+type MistralReasoningEffort = "none" | "high";
+export interface MistralOptions extends StreamOptions {
+    toolChoice?: "auto" | "none" | "any" | "required" | {
+        type: "function";
+        function: {
+            name: string;
+        };
+    };
+    promptMode?: "reasoning";
+    reasoningEffort?: MistralReasoningEffort;
+}
+type MistralContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image_url";
+    image_url: string;
+} | {
+    type: "thinking";
+    thinking: {
+        type: "text";
+        text: string;
+    }[];
+};
+interface MistralMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content?: string | MistralContentPart[];
+    tool_calls?: {
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }[];
+    tool_call_id?: string;
+    name?: string;
+}
+interface MistralRequestBody {
+    model: string;
+    stream: true;
+    messages: MistralMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    tools?: {
+        type: "function";
+        function: {
+            name: string;
+            description: string;
+            parameters: unknown;
+            strict: boolean;
+        };
+    }[];
+    tool_choice?: unknown;
+    prompt_mode?: "reasoning";
+    reasoning_effort?: MistralReasoningEffort;
+}
+export declare function buildParams(model: Model<"mistral-conversations">, context: Context, messages: Message[], options: MistralOptions | undefined): MistralRequestBody;
+/**
+ * Mistral adapter via its OpenAI-compatible streaming chat endpoint (native
+ * fetch + SSE). Tool-call ids are normalized to Mistral's exactly-9-char form.
+ */
+export declare const streamMistral: StreamFunction<"mistral-conversations", MistralOptions>;
+export declare const streamSimpleMistral: StreamFunction<"mistral-conversations", SimpleStreamOptions>;
+export {};
+//# sourceMappingURL=mistral.d.ts.map

package/dist/providers/mistral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mistral.d.ts","sourceRoot":"","sources":["../../src/providers/mistral.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,OAAO,EACP,OAAO,EACP,KAAK,EACL,mBAAmB,EAEnB,cAAc,EACd,aAAa,EAId,MAAM,UAAU,CAAC;AAUlB,KAAK,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,UAAU,CAAC,EACP,MAAM,GACN,MAAM,GACN,KAAK,GACL,UAAU,GACV;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACrD,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AAED,KAAK,kBAAkB,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC;AAErE,UAAU,cAAc;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,CAAC;IAC/F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,OAAO,CAAA;SAAE,CAAC;KACvF,EAAE,CAAC;IACJ,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAuHD,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,CAAC,uBAAuB,CAAC,EACrC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,cAAc,GAAG,SAAS,GAClC,kBAAkB,CA6BpB;AAsCD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,uBAAuB,EAAE,cAAc,CA2M9E,CAAC;AAqBL,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,uBAAuB,EAAE,mBAAmB,CAiB5F,CAAC"}

package/dist/providers/openai-codex-responses.d.ts

@@ -0,0 +1,17 @@
+import type { SimpleStreamOptions, StreamFunction, StreamOptions } from "../types";
+export interface OpenAICodexResponsesOptions extends StreamOptions {
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    reasoningSummary?: "auto" | "concise" | "detailed" | "off" | "on" | null;
+    serviceTier?: string | null;
+    textVerbosity?: "low" | "medium" | "high";
+}
+/**
+ * OpenAI Codex Responses adapter (ChatGPT backend). Implements the SSE +
+ * bearer-token path: hand-rolled request body (`store:false`, `instructions`
+ * carries the system prompt, `include: ["reasoning.encrypted_content"]`),
+ * reusing the shared Responses stream processor. AP3X originator/User-Agent.
+ * OAuth + WebSocket transport are deferred.
+ */
+export declare const streamOpenAICodexResponses: StreamFunction<"openai-codex-responses", OpenAICodexResponsesOptions>;
+export declare const streamSimpleOpenAICodexResponses: StreamFunction<"openai-codex-responses", SimpleStreamOptions>;
+//# sourceMappingURL=openai-codex-responses.d.ts.map

package/dist/providers/openai-codex-responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-codex-responses.d.ts","sourceRoot":"","sources":["../../src/providers/openai-codex-responses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAYnG,MAAM,WAAW,2BAA4B,SAAQ,aAAa;IAChE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3E,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC3C;AA8ID;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,cAAc,CACrD,wBAAwB,EACxB,2BAA2B,CAyCzB,CAAC;AAEL,eAAO,MAAM,gCAAgC,EAAE,cAAc,CAC3D,wBAAwB,EACxB,mBAAmB,CASpB,CAAC"}

package/dist/providers/openai-completions.d.ts

@@ -0,0 +1,69 @@
+import type { AssistantMessage, CacheRetention, Context, Model, OpenAICompletionsCompat, SimpleStreamOptions, StreamFunction, StreamOptions } from "../types";
+export interface OpenAICompletionsOptions extends StreamOptions {
+    toolChoice?: "auto" | "none" | "required" | {
+        type: "function";
+        function: {
+            name: string;
+        };
+    };
+    reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+}
+type ResolvedCompat = Omit<Required<OpenAICompletionsCompat>, "cacheControlFormat"> & {
+    cacheControlFormat?: OpenAICompletionsCompat["cacheControlFormat"];
+};
+interface OpenAICacheControl {
+    type: "ephemeral";
+    ttl?: string;
+}
+interface OpenAIChatMessage {
+    role: "system" | "developer" | "user" | "assistant" | "tool";
+    content?: string | OpenAIContentPart[] | null;
+    tool_calls?: {
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }[];
+    tool_call_id?: string;
+    name?: string;
+    reasoning_content?: string;
+    reasoning_details?: OpenAIReasoningDetail[];
+}
+/**
+ * OpenRouter streams reasoning as structured `reasoning_details` entries. The
+ * encrypted variant carries an opaque `data` blob that must be echoed back
+ * verbatim on the next request, or reasoning + tool-call continuity breaks. We
+ * carry it through the unified model as a redacted thinking block whose
+ * `thinkingSignature` is the JSON-encoded encrypted detail(s).
+ */
+interface OpenAIReasoningDetail {
+    type?: string;
+    id?: string;
+    format?: string;
+    index?: number;
+    data?: string;
+}
+type OpenAIContentPart = {
+    type: "text";
+    text: string;
+    cache_control?: OpenAICacheControl;
+} | {
+    type: "image_url";
+    image_url: {
+        url: string;
+    };
+};
+/** Exported for tests/handoff: build the chat message array for a context. */
+export declare function convertMessages(model: Model<"openai-completions">, context: Context, compat: ResolvedCompat): OpenAIChatMessage[];
+/** Exported for tests: build the streaming request body for a context. */
+export declare function buildParams(model: Model<"openai-completions">, context: Context, options: OpenAICompletionsOptions | undefined, compat?: ResolvedCompat, cacheRetention?: CacheRetention): Record<string, unknown>;
+/**
+ * OpenAI Chat Completions adapter (and OpenAI-compatible providers). Native
+ * fetch + SSE; correlates streamed tool-call deltas by both stream index and id.
+ */
+export declare const streamOpenAICompletions: StreamFunction<"openai-completions", OpenAICompletionsOptions>;
+export declare const streamSimpleOpenAICompletions: StreamFunction<"openai-completions", SimpleStreamOptions>;
+export type { AssistantMessage };
+//# sourceMappingURL=openai-completions.d.ts.map

package/dist/providers/openai-completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-completions.d.ts","sourceRoot":"","sources":["../../src/providers/openai-completions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,cAAc,EACd,OAAO,EAEP,KAAK,EACL,uBAAuB,EACvB,mBAAmB,EAEnB,cAAc,EACd,aAAa,EAMd,MAAM,UAAU,CAAC;AAalB,MAAM,WAAW,wBAAyB,SAAQ,aAAa;IAC7D,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC7F,eAAe,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACnE;AAED,KAAK,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,oBAAoB,CAAC,GAAG;IACpF,kBAAkB,CAAC,EAAE,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;CACpE,CAAC;AAEF,UAAU,kBAAkB;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAiJD,UAAU,iBAAiB;IACzB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAC9C,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,CAAC;IAC/F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,UAAU,qBAAqB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA6BD,KAAK,iBAAiB,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAQtD,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,CAAC,oBAAoB,CAAC,EAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,cAAc,GACrB,iBAAiB,EAAE,CAsKrB;AAsHD,0EAA0E;AAC1E,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,CAAC,oBAAoB,CAAC,EAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,wBAAwB,GAAG,SAAS,EAC7C,MAAM,GAAE,cAAiC,EACzC,cAAc,GAAE,cAA+D,GAC9E,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8CzB;AA6GD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAClD,oBAAoB,EACpB,wBAAwB,CAsPtB,CAAC;AAEL,eAAO,MAAM,6BAA6B,EAAE,cAAc,CACxD,oBAAoB,EACpB,mBAAmB,CAOpB,CAAC;AAmBF,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/providers/openai-images.d.ts

@@ -0,0 +1,17 @@
+import type { ImagesFunction, ImagesOptions } from "../types";
+export interface OpenAIImagesOptions extends ImagesOptions {
+    /** Number of images to generate (1–10). */
+    n?: number;
+    /** Output dimensions, e.g. "1024x1024". */
+    size?: string;
+    /** Provider quality hint. */
+    quality?: string;
+    /** Provider style hint. */
+    style?: string;
+}
+/**
+ * OpenAI Images adapter (`/v1/images/generations`). Hand-rolled fetch returning
+ * base64 image content. API-key (bearer) auth; analytics off; no telemetry.
+ */
+export declare const generateOpenAIImages: ImagesFunction<"openai-images", OpenAIImagesOptions>;
+//# sourceMappingURL=openai-images.d.ts.map

package/dist/providers/openai-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-images.d.ts","sourceRoot":"","sources":["../../src/providers/openai-images.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,cAAc,EAEd,aAAa,EAEd,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,2CAA2C;IAC3C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,eAAe,EAAE,mBAAmB,CA4ErF,CAAC"}

package/dist/providers/openai-prompt-cache.d.ts

@@ -0,0 +1,8 @@
+/** OpenAI clamps the prompt-cache key by code points, not UTF-16 units. */
+export declare const OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH = 64;
+/**
+ * Clamp a prompt-cache key to {@link OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH} code
+ * points (not UTF-16 units, so astral-plane characters are not split).
+ */
+export declare function clampOpenAIPromptCacheKey(key: string | undefined): string | undefined;
+//# sourceMappingURL=openai-prompt-cache.d.ts.map

package/dist/providers/openai-prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-prompt-cache.d.ts","sourceRoot":"","sources":["../../src/providers/openai-prompt-cache.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKrF"}

package/dist/providers/openai-responses-shared.d.ts

@@ -0,0 +1,128 @@
+import type { Api, AssistantMessage, AssistantMessageEventStream, Context, Model, StopReason, TextSignatureV1, Tool, Usage } from "../types";
+import { buildForeignResponsesItemId } from "./tool-call-id";
+declare function encodeTextSignatureV1(id: string, phase?: TextSignatureV1["phase"]): string;
+export interface OpenAIResponsesStreamOptions {
+    serviceTier?: string | null;
+    resolveServiceTier?: (responseServiceTier: string | null | undefined, requestServiceTier: string | null | undefined) => string | null | undefined;
+    applyServiceTierPricing?: (usage: Usage, serviceTier: string | null | undefined) => void;
+}
+export interface ConvertResponsesMessagesOptions {
+    includeSystemPrompt?: boolean;
+}
+export interface ConvertResponsesToolsOptions {
+    strict?: boolean | null;
+}
+/** Items in the Responses `input` array. */
+export type ResponseInputItem = {
+    role: "developer" | "system" | "user" | "assistant";
+    content: string | ResponseInputContent[];
+} | {
+    type: "message";
+    role: "assistant";
+    content: {
+        type: "output_text";
+        text: string;
+        annotations: [];
+    }[];
+    status: "completed";
+    id: string;
+    phase?: "commentary" | "final_answer";
+} | {
+    type: "reasoning";
+    [key: string]: unknown;
+} | {
+    type: "function_call";
+    id?: string;
+    call_id: string;
+    name: string;
+    arguments: string;
+} | {
+    type: "function_call_output";
+    call_id: string;
+    output: string | ResponseInputContent[];
+};
+export type ResponseInputContent = {
+    type: "input_text";
+    text: string;
+} | {
+    type: "input_image";
+    detail: "auto";
+    image_url: string;
+};
+export interface ResponsesTool {
+    type: "function";
+    name: string;
+    description: string;
+    parameters: unknown;
+    strict: boolean | null;
+}
+/**
+ * Convert a unified context into the Responses `input` array. `allowedToolCallProviders`
+ * gates the `call_id|item_id` id-encoding (only providers that round-trip both parts).
+ */
+export declare function convertResponsesMessages<TApi extends Api>(model: Model<TApi>, context: Context, allowedToolCallProviders: ReadonlySet<string>, options?: ConvertResponsesMessagesOptions): ResponseInputItem[];
+export declare function convertResponsesTools(tools: Tool[], options?: ConvertResponsesToolsOptions): ResponsesTool[];
+declare function mapStopReason(status: string | undefined): StopReason;
+export interface ResponseStreamEvent {
+    type: string;
+    response?: {
+        id?: string;
+        status?: string;
+        service_tier?: string | null;
+        error?: {
+            code?: string;
+            type?: string;
+            message?: string;
+        } | null;
+        incomplete_details?: {
+            reason?: string;
+        } | null;
+        usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            total_tokens?: number;
+            input_tokens_details?: {
+                cached_tokens?: number;
+            };
+            output_tokens_details?: {
+                reasoning_tokens?: number;
+            };
+        };
+    };
+    item?: {
+        type?: string;
+        id?: string;
+        call_id?: string;
+        name?: string;
+        arguments?: string;
+        summary?: {
+            text: string;
+        }[];
+        content?: {
+            type: string;
+            text?: string;
+            refusal?: string;
+        }[];
+        phase?: "commentary" | "final_answer" | null;
+    };
+    part?: {
+        type?: string;
+        text?: string;
+    };
+    delta?: string;
+    arguments?: string;
+    code?: string;
+    message?: string;
+    error?: {
+        code?: string;
+        type?: string;
+        message?: string;
+    } | null;
+}
+/**
+ * Drive the Responses stream into the unified event protocol. Used directly by
+ * the Responses adapter and reused (by feeding it events) by Azure and Codex.
+ */
+export declare function processResponsesStream<TApi extends Api>(events: AsyncIterable<ResponseStreamEvent>, output: AssistantMessage, stream: AssistantMessageEventStream, model: Model<TApi>, options?: OpenAIResponsesStreamOptions): Promise<void>;
+export { buildForeignResponsesItemId, encodeTextSignatureV1, mapStopReason };
+//# sourceMappingURL=openai-responses-shared.d.ts.map

package/dist/providers/openai-responses-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses-shared.d.ts","sourceRoot":"","sources":["../../src/providers/openai-responses-shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,GAAG,EACH,gBAAgB,EAChB,2BAA2B,EAC3B,OAAO,EAEP,KAAK,EACL,UAAU,EAEV,eAAe,EAEf,IAAI,EAEJ,KAAK,EACN,MAAM,UAAU,CAAC;AAIlB,OAAO,EAAE,2BAA2B,EAAwB,MAAM,gBAAgB,CAAC;AAMnF,iBAAS,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,CAInF;AAsBD,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,CAAC,EAAE,CACnB,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9C,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAC1C,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/B,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;CAC1F;AAED,MAAM,WAAW,+BAA+B;IAC9C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAED,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACpD,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;CAC1C,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,EAAE,CAAA;KAAE,EAAE,CAAC;IAClE,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;CACvC,GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxF;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;CACzC,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,SAAS,GAAG,EACvD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,wBAAwB,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7C,OAAO,CAAC,EAAE,+BAA+B,GACxC,iBAAiB,EAAE,CAsIrB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,CAAC,EAAE,4BAA4B,GACrC,aAAa,EAAE,CASjB;AAED,iBAAS,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAgB7D;AAGD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,KAAK,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAClE,kBAAkB,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QAChD,KAAK,CAAC,EAAE;YACN,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,oBAAoB,CAAC,EAAE;gBAAE,aAAa,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAClD,qBAAqB,CAAC,EAAE;gBAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;SACvD,CAAC;KACH,CAAC;IACF,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC7B,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC9D,KAAK,CAAC,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CAAC;KAC9C,CAAC;IACF,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnE;AAoBD;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,SAAS,GAAG,EAC3D,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAC1C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,2BAA2B,EACnC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,IAAI,CAAC,CA6Mf;AAED,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,aAAa,EAAE,CAAC"}

package/dist/providers/openai-responses.d.ts

@@ -0,0 +1,63 @@
+import type { Api, AssistantMessageEventStream, CacheRetention, Context, Model, SimpleStreamOptions, StreamFunction, StreamOptions, Usage } from "../types";
+import { type OpenAIResponsesStreamOptions, type ResponseInputItem, type ResponseStreamEvent, type ResponsesTool, processResponsesStream } from "./openai-responses-shared";
+export interface OpenAIResponsesOptions extends StreamOptions {
+    reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    reasoningSummary?: "auto" | "detailed" | "concise" | null;
+    serviceTier?: string | null;
+}
+/** Providers whose Responses ids round-trip the full `call_id|item_id` form. */
+export declare const RESPONSES_TOOL_CALL_ID_PROVIDERS: ReadonlySet<string>;
+export interface ResponsesRequestBody {
+    model: string;
+    input: ResponseInputItem[];
+    stream: true;
+    store?: boolean;
+    include?: string[];
+    max_output_tokens?: number;
+    temperature?: number;
+    tools?: ResponsesTool[];
+    tool_choice?: string;
+    parallel_tool_calls?: boolean;
+    reasoning?: {
+        effort?: string;
+        summary?: string | null;
+    };
+    text?: {
+        verbosity?: string;
+    };
+    service_tier?: string | null;
+    prompt_cache_key?: string;
+    prompt_cache_retention?: string;
+}
+/**
+ * Reasoning models reject a tiny output budget (they need room for the reasoning
+ * pass before any visible tokens), so clamp `max_output_tokens` up to this floor.
+ */
+export declare const MIN_OUTPUT_TOKENS = 16;
+/** Exported for tests: build the Responses request body for a context. */
+export declare function buildParams(model: Model<"openai-responses">, context: Context, options: OpenAIResponsesOptions | undefined, cacheRetention?: CacheRetention): ResponsesRequestBody;
+/**
+ * Service-tier cost multiplier for the Responses API. `flex` is half price,
+ * `priority` is a premium; standard/unset is a 1× no-op so cost stays
+ * byte-identical when no tier is negotiated.
+ */
+export declare function getServiceTierCostMultiplier(model: Pick<Model<"openai-responses">, "id">, serviceTier: string | null | undefined): number;
+/**
+ * Scale a computed {@link Usage} cost by the negotiated service tier, mutating
+ * `usage.cost` in place. A standard/unset tier (multiplier 1) is a no-op, so
+ * the cost is byte-identical to plain {@link calculateCost} output.
+ */
+export declare function applyServiceTierPricing(usage: Usage, serviceTier: string | null | undefined, model: Pick<Model<"openai-responses">, "id">): void;
+/**
+ * Parse a Responses SSE byte stream into {@link ResponseStreamEvent}s. The event
+ * type lives in the JSON payload's `type` field (the SSE `event:` line mirrors it).
+ */
+export declare function iterateResponsesEvents(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<ResponseStreamEvent>;
+/**
+ * Generic Responses-API stream driver shared by the OpenAI, Azure and Codex
+ * adapters: issue the HTTP request, decode SSE, and run the shared processor.
+ */
+export declare function streamResponsesRequest<TApi extends Api>(model: Model<TApi>, url: string, headers: Record<string, string>, body: unknown, options: StreamOptions | undefined, output: Parameters<typeof processResponsesStream>[1], stream: AssistantMessageEventStream, formatError?: (status: number, detail: string) => string | undefined, streamProcessorOptions?: OpenAIResponsesStreamOptions): Promise<void>;
+export declare const streamOpenAIResponses: StreamFunction<"openai-responses", OpenAIResponsesOptions>;
+export declare const streamSimpleOpenAIResponses: StreamFunction<"openai-responses", SimpleStreamOptions>;
+//# sourceMappingURL=openai-responses.d.ts.map

package/dist/providers/openai-responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses.d.ts","sourceRoot":"","sources":["../../src/providers/openai-responses.ts"],"names":[],"mappings":"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"}

package/dist/providers/provider-runtime.d.ts

@@ -0,0 +1,34 @@
+import { AssistantMessageEventStream } from "../event-stream";
+import type { Api, AssistantMessage, ImagesContext, Model, ProviderResponse, StreamOptions } from "../types";
+/**
+ * Push the terminal `done` event and end the stream. Callers guarantee (by an
+ * earlier guard that throws on `error`/`aborted`) that `output.stopReason` is a
+ * success reason; this narrows it for the event type.
+ */
+export declare function pushDone(stream: AssistantMessageEventStream, output: AssistantMessage): void;
+/** A fresh assistant message with zeroed usage, ready for an adapter to fill. */
+export declare function freshAssistantMessage<TApi extends Api>(model: Model<TApi>): AssistantMessage;
+/**
+ * Strip transient streaming scratch fields off every content block. The keys
+ * must be removed (not nulled) so replayed messages carry only finalized data —
+ * hence `delete` rather than an `undefined` assignment.
+ */
+export declare function stripScratchFields(message: AssistantMessage): void;
+/**
+ * The unified streaming skeleton shared by every text adapter.
+ *
+ * Returns an {@link AssistantMessageEventStream} synchronously and launches a
+ * fire-and-forget task that runs `body`. `body` mutates the supplied `output`
+ * message and pushes fine-grained events; it is expected to push the terminal
+ * `done` event itself on success. Any thrown error (or an abort) is normalized
+ * into a terminal `error` event with `stopReason` `"aborted"`/`"error"` —
+ * the adapter never throws after invocation.
+ */
+export declare function runStream<TApi extends Api>(model: Model<TApi>, options: StreamOptions | undefined, body: (output: AssistantMessage, stream: AssistantMessageEventStream) => Promise<void>): AssistantMessageEventStream;
+/** Build the {@link ProviderResponse} surface passed to `onResponse`. */
+export declare function toProviderResponse(response: Response): ProviderResponse;
+/** Pull the text prompt out of an images context. */
+export declare function promptFromContext(context: ImagesContext): string;
+/** Read an error response body into a short, safe diagnostic string. */
+export declare function readErrorBody(response: Response): Promise<string>;
+//# sourceMappingURL=provider-runtime.d.ts.map

package/dist/providers/provider-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-runtime.d.ts","sourceRoot":"","sources":["../../src/providers/provider-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EACV,GAAG,EACH,gBAAgB,EAChB,aAAa,EACb,KAAK,EACL,gBAAgB,EAEhB,aAAa,EACd,MAAM,UAAU,CAAC;AAKlB;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAS5F;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,IAAI,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAkB5F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAiBlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,SAAS,GAAG,EACxC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,IAAI,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,2BAA2B,KAAK,OAAO,CAAC,IAAI,CAAC,GACrF,2BAA2B,CAiB7B;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,gBAAgB,CAMvE;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAKhE;AAED,wEAAwE;AACxE,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CASvE"}

package/dist/providers/register-builtins.d.ts

@@ -0,0 +1,11 @@
+import { setBedrockProviderModule } from "./amazon-bedrock";
+export { setBedrockProviderModule } from "./amazon-bedrock";
+/**
+ * Register every implemented built-in provider under its `api` id. Idempotent:
+ * a second call is a no-op until {@link resetApiProviders} clears the latch.
+ */
+export declare function registerBuiltInApiProviders(): void;
+/** Clear the registry and re-register built-ins (resets the latch). */
+export declare function resetApiProviders(): void;
+export declare const _bedrockInjectionHook: typeof setBedrockProviderModule;
+//# sourceMappingURL=register-builtins.d.ts.map

package/dist/providers/register-builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-builtins.d.ts","sourceRoot":"","sources":["../../src/providers/register-builtins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAsC,MAAM,kBAAkB,CAAC;AAgBhG,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI5D;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAiDlD;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAGD,eAAO,MAAM,qBAAqB,iCAA2B,CAAC"}

package/dist/providers/register-images.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Register every built-in image provider under its `api` id. Idempotent: a
+ * second call is a no-op until {@link resetImagesProviders} clears the latch.
+ */
+export declare function registerBuiltInImagesProviders(): void;
+/** Clear the image registry and re-register built-ins (resets the latch). */
+export declare function resetImagesProviders(): void;
+//# sourceMappingURL=register-images.d.ts.map

package/dist/providers/register-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-images.d.ts","sourceRoot":"","sources":["../../src/providers/register-images.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAMrD;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/providers/request-dispatch.d.ts

@@ -0,0 +1,52 @@
+import type { StreamOptions } from "../types";
+/**
+ * A `fetch` dispatcher (an undici `Dispatcher`). Kept opaque here so the
+ * no-proxy path never imports undici and never needs its types.
+ */
+type FetchDispatcher = object;
+/**
+ * Builds the `fetch` dispatcher that routes a request through `proxyUrl`.
+ * Injectable so tests can assert wiring without opening a real proxy
+ * connection, and lazy so undici is imported only when a proxy is actually in
+ * play.
+ */
+export type ProxyDispatcherFactory = (proxyUrl: URL) => FetchDispatcher | Promise<FetchDispatcher>;
+/**
+ * Override the proxy-dispatcher factory (test seam). Pass `undefined` to restore
+ * the default (undici `ProxyAgent`) factory.
+ */
+export declare function setProxyDispatcherFactory(factory: ProxyDispatcherFactory | undefined): void;
+/**
+ * Client-side retry attempts used when `options.maxRetries` is unset. Zero keeps
+ * the default behavior identical to a plain `fetch`: transient errors surface
+ * immediately and callers opt into retries by threading `maxRetries`.
+ */
+export declare const DEFAULT_MAX_RETRIES = 0;
+/** Base delay (ms) for the exponential backoff schedule (`base * 2 ** attempt`). */
+export declare const BASE_RETRY_DELAY_MS = 1000;
+/**
+ * Default cap (ms) on a server-requested (`Retry-After`) delay. When a provider
+ * asks to wait longer than this, the request fails fast surfacing the requested
+ * delay instead of blocking. `0` disables the cap. Mirrors the documented
+ * {@link StreamOptions.maxRetryDelayMs} contract.
+ */
+export declare const DEFAULT_MAX_RETRY_DELAY_MS = 60000;
+/**
+ * Establish a streaming provider request through a single shared policy:
+ *
+ * - **Retries** transient failures (connection errors, `429`, and `5xx`) *before
+ *   the first byte* with exponential backoff + jitter, honoring `Retry-After`.
+ *   Once a stream is flowing it is never retried. Consumes `options.maxRetries`
+ *   (default {@link DEFAULT_MAX_RETRIES}).
+ * - **Per-request timeout** bounds request establishment via `options.timeoutMs`,
+ *   composed with the caller's `options.signal` (an external abort still wins and
+ *   short-circuits retries immediately).
+ * - **Idle timeout** wraps the response body so a stalled stream (no bytes for
+ *   `options.timeoutMs`) aborts instead of hanging forever.
+ *
+ * When neither `timeoutMs` nor `maxRetries` is set, behavior is identical to a
+ * plain `fetch(url, { ...init, signal: options.signal })`.
+ */
+export declare function dispatchStreamRequest(url: string, init: RequestInit, options: StreamOptions | undefined): Promise<Response>;
+export {};
+//# sourceMappingURL=request-dispatch.d.ts.map

package/dist/providers/request-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-dispatch.d.ts","sourceRoot":"","sources":["../../src/providers/request-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C;;;GAGG;AACH,KAAK,eAAe,GAAG,MAAM,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAkBnG;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI,CAE3F;AAcD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oFAAoF;AACpF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AA2JjD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,aAAa,GAAG,SAAS,GACjC,OAAO,CAAC,QAAQ,CAAC,CAqFnB"}

package/dist/providers/simple-options.d.ts

@@ -0,0 +1,42 @@
+import type { Api, Context, Model, ProviderHeaders, SimpleStreamOptions, StreamOptions, ThinkingBudgets, ThinkingLevel } from "../types";
+/**
+ * Merge caller header overrides onto a mutable set of provider/API default
+ * headers. A string value sets (or replaces) the header; a `null` value
+ * SUPPRESSES a default header of the same name (distinct from an absent key,
+ * which leaves the default untouched). No-op when `overrides` is undefined, so
+ * providers stay byte-identical when the caller passes no header overrides.
+ */
+export declare function applyHeaderOverrides(headers: Record<string, string>, overrides: ProviderHeaders | undefined): void;
+/**
+ * Clamp a desired output `maxTokens` to the room left in a model's context
+ * window: `contextWindow − estimatedContextTokens − safety`. This prevents long
+ * conversations from requesting more output than can fit (a provider 400). When
+ * there is ample room the requested value is returned unchanged; the result is
+ * never below {@link MIN_MAX_TOKENS}. Models without a known context window
+ * (`contextWindow <= 0`) are passed through untouched.
+ */
+export declare function clampMaxTokensToContext(model: Model<Api>, context: Context, maxTokens: number): number;
+/**
+ * Project a {@link SimpleStreamOptions} onto the {@link StreamOptions} base
+ * surface, injecting a resolved API key. The provider-agnostic `reasoning`
+ * knob is intentionally dropped here — each `streamSimple*` maps it onto its
+ * own native reasoning surface before delegating to the full entry point.
+ *
+ * The resolved output cap (`options.maxTokens`, falling back to the model cap)
+ * is clamped to the context window so it never requests more than remains.
+ */
+export declare function buildBaseOptions(model: Model<Api>, context: Context, options?: SimpleStreamOptions, apiKey?: string): StreamOptions;
+/** Collapse `xhigh` down to `high`; pass other levels through unchanged. */
+export declare function clampReasoning(effort: ThinkingLevel | undefined): Exclude<ThinkingLevel, "xhigh"> | undefined;
+/**
+ * Fit a thinking budget inside a max-tokens cap for budget-based reasoning.
+ *
+ * Returns the effective `maxTokens` (base cap plus budget, clamped to the
+ * model cap; the model cap alone when no base cap is supplied) and a
+ * `thinkingBudget` that always leaves at least a small output allowance.
+ */
+export declare function adjustMaxTokensForThinking(baseMaxTokens: number | undefined, modelMaxTokens: number, reasoningLevel: ThinkingLevel, customBudgets?: ThinkingBudgets): {
+    maxTokens: number;
+    thinkingBudget: number;
+};
+//# sourceMappingURL=simple-options.d.ts.map

package/dist/providers/simple-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-options.d.ts","sourceRoot":"","sources":["../../src/providers/simple-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,OAAO,EACP,KAAK,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,UAAU,CAAC;AAGlB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,EAAE,eAAe,GAAG,SAAS,GACrC,IAAI,CAMN;AAOD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,CAmBf;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,SAAS,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,aAAa,EAC7B,aAAa,CAAC,EAAE,eAAe,GAC9B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAsB/C"}

package/dist/providers/tool-call-id.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Cross-provider tool-call-id normalization policy.
+ *
+ * Each provider family imposes different constraints on the ids that pair a
+ * tool call with its result. Replaying a conversation produced by one provider
+ * through another therefore requires rewriting ids to satisfy the *target*
+ * provider's rules. Rather than repeating these rules inline in every adapter,
+ * they live in one place, keyed by a target {@link ToolCallIdTarget}.
+ *
+ * Known constraints:
+ * - Anthropic: `^[a-zA-Z0-9_-]+$`, length <= 64.
+ * - OpenAI completions: length <= 40 (and sanitized for the pipe-encoded form).
+ * - OpenAI Responses: ids are `call_id|item_id`; each part <= 64, item id must
+ *   start with `fc_`; foreign item ids are hashed to a bounded `fc_<hash>`.
+ * - Mistral: exactly 9 alphanumeric characters (derived via hash, with a
+ *   collision-retry helper available through {@link createMistralToolCallIdNormalizer}).
+ * - Bedrock / Google: sanitize + length <= 64 (Google only when required).
+ */
+export type ToolCallIdTarget = "anthropic" | "openai-completions" | "openai-responses" | "mistral" | "bedrock" | "google";
+export declare const TOOL_CALL_ID_MAX_LENGTH: Record<ToolCallIdTarget, number>;
+/** Build a bounded `fc_<hash>` item id for a foreign (cross-provider) call. */
+export declare function buildForeignResponsesItemId(itemId: string): string;
+/**
+ * Normalize a `call_id|item_id` Responses id. `foreign` controls whether the
+ * item id is hashed (cross-provider replay) or merely sanitized (same provider).
+ * The item id is always coerced to start with `fc_`.
+ */
+export declare function normalizeResponsesId(id: string, foreign: boolean): string;
+/**
+ * Derive a Mistral-shaped id: exactly 9 alphanumeric chars. If the source is
+ * already 9 alphanumerics it is used verbatim; otherwise a deterministic hash
+ * is taken. `attempt` salts the hash for collision retries.
+ */
+export declare function deriveMistralToolCallId(id: string, attempt?: number): string;
+/**
+ * A stateful normalizer for Mistral that guarantees uniqueness: distinct source
+ * ids never collapse to the same 9-char id (collisions retry with a salt).
+ */
+export declare function createMistralToolCallIdNormalizer(): (id: string) => string;
+/**
+ * Normalize a tool-call id for a given target provider family. For
+ * `openai-responses` the `foreign` flag selects hashing vs sanitizing of the
+ * item id; it is ignored by the other targets.
+ */
+export declare function normalizeToolCallId(id: string, target: ToolCallIdTarget, foreign?: boolean): string;
+//# sourceMappingURL=tool-call-id.d.ts.map