@ap3x/ai 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-id.d.ts","sourceRoot":"","sources":["../../src/providers/tool-call-id.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,oBAAoB,GACpB,kBAAkB,GAClB,SAAS,GACT,SAAS,GACT,QAAQ,CAAC;AAEb,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAOpE,CAAC;AA2BF,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAazE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,CAUvE;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAoB1E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,UAAQ,GAAG,MAAM,CAiBjG"}

package/dist/providers/transform-messages.d.ts

@@ -0,0 +1,22 @@
+import type { Api, AssistantMessage, Message, Model } from "../types";
+/**
+ * Cross-provider message normalization, run by every adapter before building a
+ * vendor request.
+ *
+ * Pass 1 (per message):
+ * - downgrade images the target model can't accept to text placeholders;
+ * - for assistant turns, decide "same model" (provider + api + id match):
+ *   same-model thinking blocks (incl. redacted and signed-but-empty) are kept
+ *   for replay; cross-model thinking becomes plain text (or is dropped if
+ *   empty); cross-model tool calls drop `thoughtSignature` and have their ids
+ *   rewritten via the optional `normalizeToolCallId` (recording id -> newId so
+ *   later tool results re-point to the new id).
+ *
+ * Pass 2 (across messages):
+ * - synthesize "No result provided" error tool results for orphaned tool calls
+ *   (preserves API pairing rules and thinking signatures);
+ * - drop assistant turns whose `stopReason` is `error`/`aborted` (incomplete
+ *   turns must not be replayed).
+ */
+export declare function transformMessages<TApi extends Api>(messages: Message[], model: Model<TApi>, normalizeToolCallId?: (id: string, model: Model<TApi>, source: AssistantMessage) => string): Message[];
+//# sourceMappingURL=transform-messages.d.ts.map

package/dist/providers/transform-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-messages.d.ts","sourceRoot":"","sources":["../../src/providers/transform-messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,gBAAgB,EAEhB,OAAO,EACP,KAAK,EAIN,MAAM,UAAU,CAAC;AAsDlB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,GAAG,EAChD,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,MAAM,GACzF,OAAO,EAAE,CAwHX"}

package/dist/stream.d.ts

@@ -0,0 +1,18 @@
+import type { Api, AssistantMessage, AssistantMessageEventStream, Context, Model, ProviderStreamOptions, SimpleStreamOptions } from "./types";
+export { getEnvApiKey } from "./env-api-keys";
+/**
+ * Resolve a provider by `model.api`, inject an env API key when none is set,
+ * and delegate to the provider's full entry point. Never throws — a missing
+ * provider is surfaced as an `error` event in the returned stream.
+ */
+export declare function stream<TApi extends Api>(model: Model<TApi>, context: Context, options?: ProviderStreamOptions): AssistantMessageEventStream;
+/** `stream(...).result()` — resolves the final {@link AssistantMessage}. */
+export declare function complete<TApi extends Api>(model: Model<TApi>, context: Context, options?: ProviderStreamOptions): Promise<AssistantMessage>;
+/**
+ * Like {@link stream} but delegates to the provider's simple entry point, using
+ * the provider-agnostic `reasoning` / `thinkingBudgets` surface.
+ */
+export declare function streamSimple<TApi extends Api>(model: Model<TApi>, context: Context, options?: SimpleStreamOptions): AssistantMessageEventStream;
+/** `streamSimple(...).result()`. */
+export declare function completeSimple<TApi extends Api>(model: Model<TApi>, context: Context, options?: SimpleStreamOptions): Promise<AssistantMessage>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,GAAG,EACH,gBAAgB,EAChB,2BAA2B,EAC3B,OAAO,EACP,KAAK,EACL,qBAAqB,EACrB,mBAAmB,EAEpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoD9C;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,SAAS,GAAG,EACrC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,2BAA2B,CAM7B;AAED,4EAA4E;AAC5E,wBAAsB,QAAQ,CAAC,IAAI,SAAS,GAAG,EAC7C,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,GAAG,EAC3C,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,2BAA2B,CAM7B;AAED,oCAAoC;AACpC,wBAAsB,cAAc,CAAC,IAAI,SAAS,GAAG,EACnD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAE3B"}

package/dist/types.d.ts

@@ -0,0 +1,448 @@
+import type { TSchema } from "@sinclair/typebox";
+import type { AssistantMessageEventStream } from "./event-stream";
+export type { AssistantMessageEventStream } from "./event-stream";
+/**
+ * The known wire-protocol families AP3X ships providers for. The union is left
+ * open (see {@link Api}) so custom providers can register arbitrary api ids.
+ */
+export type KnownApi = "openai-completions" | "mistral-conversations" | "openai-responses" | "azure-openai-responses" | "openai-codex-responses" | "anthropic-messages" | "bedrock-converse-stream" | "google-generative-ai" | "google-vertex";
+/** Open string union: a known api family or any custom registered id. */
+export type Api = KnownApi | (string & {});
+export type KnownImagesApi = "openrouter-images" | "openai-images" | "google-images" | "faux-images";
+export type ImagesApi = KnownImagesApi | (string & {});
+/** Provider slugs AP3X knows about. Open union via {@link Provider}. */
+export type KnownProvider = "amazon-bedrock" | "ant-ling" | "anthropic" | "google" | "google-vertex" | "openai" | "azure-openai-responses" | "openai-codex" | "nvidia" | "deepseek" | "github-copilot" | "xai" | "groq" | "cerebras" | "openrouter" | "vercel-ai-gateway" | "zai" | "zai-coding-cn" | "mistral" | "minimax" | "minimax-cn" | "moonshotai" | "moonshotai-cn" | "huggingface" | "fireworks" | "together" | "opencode" | "opencode-go" | "kimi-coding" | "cloudflare-workers-ai" | "cloudflare-ai-gateway" | "xiaomi" | "xiaomi-token-plan-cn" | "xiaomi-token-plan-ams" | "xiaomi-token-plan-sgp";
+export type Provider = KnownProvider | (string & {});
+export type KnownImagesProvider = "openrouter" | "openai" | "google" | "faux";
+export type ImagesProvider = KnownImagesProvider | (string & {});
+/** Abstract reasoning intensity, provider-agnostic. */
+export type ThinkingLevel = "minimal" | "low" | "medium" | "high" | "xhigh";
+/** A thinking level, or "off" to disable reasoning entirely. */
+export type ModelThinkingLevel = "off" | ThinkingLevel;
+/**
+ * Per-model map from an abstract thinking level to a provider-native value.
+ * A missing key falls back to the provider default; a `null` value marks the
+ * level as unsupported by that model.
+ */
+export type ThinkingLevelMap = Partial<Record<ModelThinkingLevel, string | null>>;
+/** Token budgets per thinking level for token-budget providers. */
+export interface ThinkingBudgets {
+    minimal?: number;
+    low?: number;
+    medium?: number;
+    high?: number;
+}
+/** Prompt-cache retention preference. Providers map this onto native values. */
+export type CacheRetention = "none" | "short" | "long";
+/** Preferred transport for providers that support multiple. */
+export type Transport = "sse" | "websocket" | "websocket-cached" | "auto";
+/** Provider-scoped environment overrides. Values take precedence over `process.env`. */
+export type ProviderEnv = Record<string, string>;
+/**
+ * Caller header overrides merged over provider/API defaults. A string value
+ * sets (or replaces) a header; a `null` value SUPPRESSES a default header of
+ * the same name — distinct from an absent key, which leaves the default intact.
+ */
+export type ProviderHeaders = Record<string, string | null>;
+/** Minimal HTTP response surface exposed to the `onResponse` hook. */
+export interface ProviderResponse {
+    status: number;
+    headers: Record<string, string>;
+}
+/** Base request options shared by every provider's full entry point. */
+export interface StreamOptions {
+    temperature?: number;
+    maxTokens?: number;
+    signal?: AbortSignal;
+    apiKey?: string;
+    /** Preferred transport; ignored by providers that don't support it. */
+    transport?: Transport;
+    /** Prompt-cache retention preference. Default: "short". */
+    cacheRetention?: CacheRetention;
+    /** Session id used by providers for cache affinity / routing. */
+    sessionId?: string;
+    /**
+     * Inspect or replace the provider payload before it is sent. Return
+     * `undefined` to leave the payload unchanged.
+     */
+    onPayload?: (payload: unknown, model: Model<Api>) => unknown | undefined | Promise<unknown | undefined>;
+    /** Invoked after HTTP response headers arrive, before the body is consumed. */
+    onResponse?: (response: ProviderResponse, model: Model<Api>) => void | Promise<void>;
+    /**
+     * Extra HTTP headers merged over provider defaults (caller wins). A `null`
+     * value suppresses a provider/API default header with the same name.
+     */
+    headers?: ProviderHeaders;
+    /** HTTP request timeout in ms for SDKs that support it. */
+    timeoutMs?: number;
+    /** WebSocket connect-handshake timeout in ms. */
+    websocketConnectTimeoutMs?: number;
+    /** Maximum client-side retry attempts. */
+    maxRetries?: number;
+    /**
+     * Cap (ms) on a server-requested retry delay. If the server asks for longer,
+     * fail fast and surface the requested delay. Default 60000; 0 disables.
+     */
+    maxRetryDelayMs?: number;
+    /** Free-form metadata; providers read the fields they understand. */
+    metadata?: Record<string, unknown>;
+    /**
+     * Provider-scoped environment overrides. When present, values take precedence
+     * over `process.env` for provider configuration (endpoints, regional
+     * settings). Absent → resolution falls back to `process.env` unchanged.
+     */
+    env?: ProviderEnv;
+}
+/** {@link StreamOptions} plus arbitrary provider-specific extras. */
+export type ProviderStreamOptions = StreamOptions & Record<string, unknown>;
+/** Request options for one-shot image generation. */
+export interface ImagesOptions {
+    signal?: AbortSignal;
+    apiKey?: string;
+    onPayload?: (payload: unknown, model: ImagesModel<ImagesApi>) => unknown | undefined | Promise<unknown | undefined>;
+    onResponse?: (response: ProviderResponse, model: ImagesModel<ImagesApi>) => void | Promise<void>;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    maxRetries?: number;
+    maxRetryDelayMs?: number;
+    metadata?: Record<string, unknown>;
+}
+export type ProviderImagesOptions = ImagesOptions & Record<string, unknown>;
+/**
+ * Provider-agnostic options for `streamSimple`/`completeSimple`. The single
+ * `reasoning` knob is mapped onto each provider's native reasoning surface.
+ */
+export interface SimpleStreamOptions extends StreamOptions {
+    reasoning?: ThinkingLevel;
+    thinkingBudgets?: ThinkingBudgets;
+}
+/**
+ * The function shape every text provider implements.
+ *
+ * Contract: returns a stream synchronously. After invocation, request, model
+ * and runtime failures are encoded as an `error` event in the stream — never
+ * thrown. An error termination yields an {@link AssistantMessage} with
+ * `stopReason` of `"error"` or `"aborted"` and an `errorMessage`.
+ */
+export type StreamFunction<TApi extends Api = Api, TOptions extends StreamOptions = StreamOptions> = (model: Model<TApi>, context: Context, options?: TOptions) => AssistantMessageEventStream;
+export type ImagesFunction<TApi extends ImagesApi = ImagesApi, TOptions extends ImagesOptions = ImagesOptions> = (model: ImagesModel<TApi>, context: ImagesContext, options?: TOptions) => Promise<AssistantImages>;
+/** Structured text-block signature for providers that round-trip message ids. */
+export interface TextSignatureV1 {
+    v: 1;
+    id: string;
+    phase?: "commentary" | "final_answer";
+}
+export interface TextContent {
+    type: "text";
+    text: string;
+    /** Opaque per-block signature (legacy id string or {@link TextSignatureV1} JSON). */
+    textSignature?: string;
+}
+export interface ThinkingContent {
+    type: "thinking";
+    thinking: string;
+    /** Opaque reasoning signature; for redacted blocks holds the encrypted payload. */
+    thinkingSignature?: string;
+    /** When true the thinking was redacted by safety filters. */
+    redacted?: boolean;
+}
+export interface ImageContent {
+    type: "image";
+    /** base64-encoded image bytes. */
+    data: string;
+    /** e.g. "image/png", "image/jpeg". */
+    mimeType: string;
+}
+export interface ToolCall {
+    type: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, any>;
+    /** Google-specific: opaque signature for reusing thought context. */
+    thoughtSignature?: string;
+}
+export interface Usage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    /**
+     * Subset of `cacheWrite` written with 1h retention. Only providers that split
+     * cache-write retention (Anthropic) report this. Priced at 2× base input by
+     * {@link calculateCost}. Left undefined when the provider does not report it.
+     */
+    cacheWrite1h?: number;
+    /**
+     * Reasoning/thinking tokens when the provider reports a breakdown. A subset of
+     * `output` (which already includes these). Set by providers that expose it;
+     * left undefined by providers that don't.
+     */
+    reasoning?: number;
+    totalTokens: number;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        total: number;
+    };
+}
+export type StopReason = "stop" | "length" | "toolUse" | "error" | "aborted";
+export interface UserMessage {
+    role: "user";
+    content: string | (TextContent | ImageContent)[];
+    timestamp: number;
+}
+export interface AssistantMessage {
+    role: "assistant";
+    content: (TextContent | ThinkingContent | ToolCall)[];
+    api: Api;
+    provider: Provider;
+    model: string;
+    /** Concrete response model when it differs from the requested model. */
+    responseModel?: string;
+    /** Provider-issued response/message identifier when available. */
+    responseId?: string;
+    /** Redacted runtime diagnostics for failures and recoveries. */
+    diagnostics?: AssistantMessageDiagnostic[];
+    usage: Usage;
+    stopReason: StopReason;
+    errorMessage?: string;
+    timestamp: number;
+}
+export interface ToolResultMessage<TDetails = any> {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    content: (TextContent | ImageContent)[];
+    details?: TDetails;
+    isError: boolean;
+    timestamp: number;
+}
+export type Message = UserMessage | AssistantMessage | ToolResultMessage;
+export type ImagesInputContent = TextContent | ImageContent;
+export type ImagesOutputContent = TextContent | ImageContent;
+export interface ImagesContext {
+    input: ImagesInputContent[];
+}
+export type ImagesStopReason = "stop" | "error" | "aborted";
+export interface AssistantImages {
+    api: ImagesApi;
+    provider: ImagesProvider;
+    model: string;
+    output: ImagesOutputContent[];
+    responseId?: string;
+    usage?: Usage;
+    stopReason: ImagesStopReason;
+    errorMessage?: string;
+    timestamp: number;
+}
+/** A callable tool: a name, a description and a TypeBox/JSON-Schema for its args. */
+export interface Tool<TParameters extends TSchema = TSchema> {
+    name: string;
+    description: string;
+    parameters: TParameters;
+}
+export interface Context {
+    systemPrompt?: string;
+    messages: Message[];
+    tools?: Tool[];
+}
+/** Structured diagnostic captured alongside a failed/recovered message. */
+export interface DiagnosticErrorInfo {
+    name?: string;
+    message: string;
+    stack?: string;
+    code?: string | number;
+}
+export interface AssistantMessageDiagnostic {
+    type: string;
+    timestamp: number;
+    error?: DiagnosticErrorInfo;
+    details?: Record<string, unknown>;
+}
+/**
+ * The streaming protocol. A well-formed stream emits `start`, then per content
+ * block a `*_start` / zero-or-more `*_delta` / `*_end` (or `toolcall_end`)
+ * sequence, terminating with exactly one `done` or `error`.
+ */
+export type AssistantMessageEvent = {
+    type: "start";
+    partial: AssistantMessage;
+} | {
+    type: "text_start";
+    contentIndex: number;
+    partial: AssistantMessage;
+} | {
+    type: "text_delta";
+    contentIndex: number;
+    delta: string;
+    partial: AssistantMessage;
+} | {
+    type: "text_end";
+    contentIndex: number;
+    content: string;
+    partial: AssistantMessage;
+} | {
+    type: "thinking_start";
+    contentIndex: number;
+    partial: AssistantMessage;
+} | {
+    type: "thinking_delta";
+    contentIndex: number;
+    delta: string;
+    partial: AssistantMessage;
+} | {
+    type: "thinking_end";
+    contentIndex: number;
+    content: string;
+    partial: AssistantMessage;
+} | {
+    type: "toolcall_start";
+    contentIndex: number;
+    partial: AssistantMessage;
+} | {
+    type: "toolcall_delta";
+    contentIndex: number;
+    delta: string;
+    partial: AssistantMessage;
+} | {
+    type: "toolcall_end";
+    contentIndex: number;
+    toolCall: ToolCall;
+    partial: AssistantMessage;
+} | {
+    type: "done";
+    reason: Extract<StopReason, "stop" | "length" | "toolUse">;
+    message: AssistantMessage;
+} | {
+    type: "error";
+    reason: Extract<StopReason, "aborted" | "error">;
+    error: AssistantMessage;
+};
+/** Override URL-based auto-detection for OpenAI-completions-compatible providers. */
+export interface OpenAICompletionsCompat {
+    supportsStore?: boolean;
+    supportsDeveloperRole?: boolean;
+    supportsReasoningEffort?: boolean;
+    /** Default: true. */
+    supportsUsageInStreaming?: boolean;
+    maxTokensField?: "max_completion_tokens" | "max_tokens";
+    requiresToolResultName?: boolean;
+    requiresAssistantAfterToolResult?: boolean;
+    requiresThinkingAsText?: boolean;
+    requiresReasoningContentOnAssistantMessages?: boolean;
+    /** Default: "openai". */
+    thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template" | "string-thinking" | "ant-ling";
+    openRouterRouting?: OpenRouterRouting;
+    vercelGatewayRouting?: VercelGatewayRouting;
+    zaiToolStream?: boolean;
+    /** Default: true. */
+    supportsStrictMode?: boolean;
+    cacheControlFormat?: "anthropic";
+    sendSessionAffinityHeaders?: boolean;
+    /** Default: true. */
+    supportsLongCacheRetention?: boolean;
+}
+/** Override auto-detection for OpenAI-Responses-compatible providers. */
+export interface OpenAIResponsesCompat {
+    /** Default: true. */
+    supportsDeveloperRole?: boolean;
+    /** Default: true. */
+    sendSessionIdHeader?: boolean;
+    /** Default: true. */
+    supportsLongCacheRetention?: boolean;
+}
+/** Override auto-detection for Anthropic-Messages-compatible providers. */
+export interface AnthropicMessagesCompat {
+    /** Default: true. */
+    supportsEagerToolInputStreaming?: boolean;
+    /** Default: true. */
+    supportsLongCacheRetention?: boolean;
+    /** Default: false. */
+    sendSessionAffinityHeaders?: boolean;
+    /** Default: true. */
+    supportsCacheControlOnTools?: boolean;
+    /** Default: true. */
+    supportsTemperature?: boolean;
+    /** Default: false. */
+    forceAdaptiveThinking?: boolean;
+    /** Default: false. */
+    allowEmptySignature?: boolean;
+}
+/** OpenRouter provider-routing preferences (sent as the `provider` field). */
+export interface OpenRouterRouting {
+    allow_fallbacks?: boolean;
+    require_parameters?: boolean;
+    data_collection?: "deny" | "allow";
+    zdr?: boolean;
+    enforce_distillable_text?: boolean;
+    order?: string[];
+    only?: string[];
+    ignore?: string[];
+    quantizations?: string[];
+    sort?: string | {
+        by?: string;
+        partition?: string | null;
+    };
+    max_price?: {
+        prompt?: number | string;
+        completion?: number | string;
+        image?: number | string;
+        audio?: number | string;
+        request?: number | string;
+    };
+    preferred_min_throughput?: number | {
+        p50?: number;
+        p75?: number;
+        p90?: number;
+        p99?: number;
+    };
+    preferred_max_latency?: number | {
+        p50?: number;
+        p75?: number;
+        p90?: number;
+        p99?: number;
+    };
+}
+/** Vercel AI Gateway routing preferences. */
+export interface VercelGatewayRouting {
+    only?: string[];
+    order?: string[];
+}
+/** Static metadata describing a single model. */
+export interface Model<TApi extends Api> {
+    id: string;
+    name: string;
+    api: TApi;
+    provider: Provider;
+    baseUrl: string;
+    reasoning: boolean;
+    /** Maps abstract thinking levels to provider-native values; null = unsupported. */
+    thinkingLevelMap?: ThinkingLevelMap;
+    input: ("text" | "image")[];
+    /** Per-bucket rate in USD per million tokens. */
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    contextWindow: number;
+    maxTokens: number;
+    headers?: Record<string, string>;
+    /** Compatibility overrides; the applicable shape depends on `api`. */
+    compat?: TApi extends "openai-completions" ? OpenAICompletionsCompat : TApi extends "openai-responses" ? OpenAIResponsesCompat : TApi extends "anthropic-messages" ? AnthropicMessagesCompat : never;
+}
+export interface ImagesModel<TApi extends ImagesApi> extends Omit<Model<Api>, "api" | "provider" | "reasoning" | "contextWindow" | "maxTokens" | "compat"> {
+    api: TApi;
+    provider: ImagesProvider;
+    output: ("text" | "image")[];
+}
+/** The interface a text provider implements: a full and a simple entry point. */
+export interface ApiProvider<TApi extends Api = Api, TOptions extends StreamOptions = StreamOptions> {
+    api: TApi;
+    stream: StreamFunction<TApi, TOptions>;
+    streamSimple: StreamFunction<TApi, SimpleStreamOptions>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/utils/abort-signals.d.ts

@@ -0,0 +1,16 @@
+export interface CombinedAbortSignal {
+    /** The combined signal, or `undefined` when there are no source signals. */
+    signal?: AbortSignal;
+    /** Remove the listeners attached to the source signals. */
+    cleanup: () => void;
+}
+/**
+ * Collapse zero, one, or many abort signals into a single signal.
+ *
+ * - No signals → `{ cleanup }` only.
+ * - One signal → that signal, with a no-op cleanup.
+ * - Many signals → a fresh controller that aborts (propagating `reason`) as
+ *   soon as any source aborts. `cleanup` detaches the listeners.
+ */
+export declare function combineAbortSignals(signals: readonly (AbortSignal | undefined)[]): CombinedAbortSignal;
+//# sourceMappingURL=abort-signals.d.ts.map

package/dist/utils/abort-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signals.d.ts","sourceRoot":"","sources":["../../src/utils/abort-signals.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,GAC5C,mBAAmB,CAqCrB"}

package/dist/utils/estimate.d.ts

@@ -0,0 +1,35 @@
+import type { Context, ImageContent, Message, TextContent, Usage } from "../types";
+/**
+ * A breakdown of a context's estimated token footprint. When the most recent
+ * successful assistant turn carries provider-reported usage, that figure anchors
+ * the estimate and only the messages after it are approximated.
+ */
+export interface ContextUsageEstimate {
+    /** Estimated total context tokens. */
+    tokens: number;
+    /** Tokens reported by the anchoring assistant usage block (0 when none). */
+    usageTokens: number;
+    /** Estimated tokens for everything after the anchoring usage block. */
+    trailingTokens: number;
+    /** Index of the anchoring assistant message, or null when none was found. */
+    lastUsageIndex: number | null;
+}
+/** Best available token total from a usage record. */
+export declare function calculateContextTokens(usage: Usage): number;
+/** Estimate the token cost of a raw string. */
+export declare function estimateTextTokens(text: string): number;
+/** Estimate tokens for user/tool-result content (text plus flat-rated images). */
+export declare function estimateTextAndImageContentTokens(content: string | Array<TextContent | ImageContent>): number;
+/** Estimate the token cost of a single message across all roles. */
+export declare function estimateMessageTokens(message: Message): number;
+/**
+ * Estimate the total token footprint of a conversation context.
+ *
+ * When the transcript already contains a successful assistant turn with
+ * provider-reported usage, that usage anchors the estimate (it already accounts
+ * for the system prompt and tools) and only the trailing messages are
+ * approximated. Otherwise a character-based estimate covers every message plus
+ * the system prompt and tool schemas.
+ */
+export declare function estimateContextTokens(context: Context | readonly Message[]): ContextUsageEstimate;
+//# sourceMappingURL=estimate.d.ts.map

package/dist/utils/estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/utils/estimate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,OAAO,EACP,YAAY,EACZ,OAAO,EACP,WAAW,EACX,KAAK,EACN,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAOD,sDAAsD;AACtD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE3D;AAmBD,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,kFAAkF;AAClF,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,GAClD,MAAM,CAER;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAW9D;AAyCD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,GAAG,oBAAoB,CAiBjG"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A small, fast, deterministic non-cryptographic string hash (xmur3/MurmurHash
+ * inspired). Returns a base-36 string. Used to derive bounded, stable ids when
+ * a vendor id would otherwise be too long or contain disallowed characters.
+ */
+export declare function shortHash(str: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW7C"}

package/dist/utils/json-parse.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Repair malformed JSON by escaping raw control characters inside string
+ * literals and doubling backslashes that precede an invalid escape character.
+ * Valid `\uXXXX` sequences are preserved. Never throws.
+ */
+export declare function repairJson(json: string): string;
+/** `JSON.parse`, retrying once with {@link repairJson} on failure. */
+export declare function parseJsonWithRepair<T>(json: string): T;
+/**
+ * Tolerantly parse possibly-incomplete streaming JSON. Always returns an
+ * object: empty input → `{}`; otherwise tries strict-with-repair, then
+ * partial-json, then partial-json on the repaired text, falling back to `{}`.
+ * Never throws.
+ */
+export declare function parseStreamingJson<T = Record<string, unknown>>(partialJson: string | undefined): T;
+//# sourceMappingURL=json-parse.d.ts.map

package/dist/utils/json-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parse.d.ts","sourceRoot":"","sources":["../../src/utils/json-parse.ts"],"names":[],"mappings":"AA0BA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8C/C;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAUtD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,CAAC,CAiBH"}

package/dist/utils/node-http-proxy.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Proxy resolution for outbound provider HTTP(S) requests.
+ *
+ * Reads the conventional `*_proxy` / `no_proxy` environment variables (both the
+ * lowercase and uppercase spellings) and decides, for a given target URL, which
+ * HTTP/HTTPS proxy — if any — should carry the request. The environment is an
+ * injected parameter (defaulting to {@link process.env}) so the resolver is a
+ * pure function that unit tests can drive without mutating the real environment.
+ *
+ * Semantics mirror the de-facto behavior of common proxy-aware HTTP clients:
+ *
+ * - the proxy is chosen by the target's protocol (`https_proxy` for `https:`,
+ *   `http_proxy` for `http:`, …), falling back to `all_proxy`;
+ * - `no_proxy` bypass rules are honored (`*` disables all proxying, exact host,
+ *   leading-dot / `*.` domain-suffix matches, and an optional `:port` qualifier);
+ * - a proxy value without a scheme inherits the target's protocol;
+ * - only `http:` and `https:` proxy URLs are supported — SOCKS and PAC proxies
+ *   are rejected because native `fetch` cannot dispatch through them.
+ */
+/** An environment lookup table: variable name to value (as {@link process.env}). */
+export type ProxyEnv = Record<string, string | undefined>;
+/** Human-readable rejection for non-HTTP proxy schemes (SOCKS / PAC). */
+export declare const UNSUPPORTED_PROXY_PROTOCOL_MESSAGE = "Unsupported proxy protocol: only http: and https: proxy URLs are supported (SOCKS and PAC proxies are not).";
+/**
+ * Resolve the HTTP/HTTPS proxy URL that should carry a request to `targetUrl`,
+ * or `undefined` when the request must go direct.
+ *
+ * @param targetUrl the outbound request URL (string or {@link URL})
+ * @param env environment lookup table (defaults to {@link process.env})
+ * @throws when a proxy is configured but its URL is malformed, or uses an
+ *   unsupported (non-HTTP/HTTPS) scheme such as SOCKS or PAC.
+ */
+export declare function resolveHttpProxyUrlForTarget(targetUrl: string | URL, env?: ProxyEnv): URL | undefined;
+//# sourceMappingURL=node-http-proxy.d.ts.map