@umituz/web-ai 0.0.0-stage → 1.0.0

package/dist/create-ai-DGZFBOA1.d.cts

@@ -0,0 +1,268 @@
+import { c as TextTier } from './index-fXjxTR5W.cjs';
+import { c as ProviderFactory } from './provider.factory-COsnprLH.cjs';
+import { a as TierModelMap } from './index-DjX9ZKuM.cjs';
+import { c as GeminiConfig, F as FalConfig, P as PrunaConfig } from './ProviderConfig-a55tLhWT.cjs';
+
+type AIErrorCode = 'VALIDATION_ERROR' | 'PROVIDER_UNAVAILABLE' | 'PROVIDER_QUOTA_EXHAUSTED' | 'PROVIDER_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'ABORTED' | 'PARSE_ERROR' | 'NO_RESULT' | 'UNKNOWN';
+declare class AIError extends Error {
+    readonly code: AIErrorCode;
+    readonly cause?: unknown;
+    constructor(message: string, code: AIErrorCode, cause?: unknown);
+    static from(error: unknown, fallbackCode?: AIErrorCode): AIError;
+}
+declare class ValidationError extends AIError {
+    constructor(message: string);
+}
+declare class ProviderUnavailableError extends AIError {
+    constructor(providerId: string);
+}
+declare class ProviderQuotaExhaustedError extends AIError {
+    constructor(providerId: string);
+}
+
+declare const ANTHROPIC_MODELS: {
+    readonly OPUS_5_5: "claude-opus-5-5";
+    readonly SONNET_5_5: "claude-sonnet-5-5";
+    readonly HAIKU_5_5: "claude-haiku-5-5";
+};
+/**
+ * Neutral tier → Claude model. fast = Haiku for cheap high-volume turns,
+ * balanced = Sonnet for everyday quality, powerful = Opus for the heavy
+ * lifting. Override per instance via `models` in provider config.
+ */
+declare const ANTHROPIC_TIERS: TierModelMap;
+/**
+ * Single bump point for the wire protocol version. Every request sends this
+ * as the `anthropic-version` header; the shapes in anthropic.entities.ts are
+ * pinned to it.
+ */
+declare const ANTHROPIC_API_VERSION: "2026-10-21";
+/** The Messages API requires max_tokens on every request. */
+declare const ANTHROPIC_DEFAULT_MAX_TOKENS = 16000;
+type AnthropicEffort = "low" | "medium" | "high";
+
+/**
+ * Anthropic Messages API wire types, pinned to anthropic-version 2026-10-21.
+ * Two hard rules live here as types so the builder cannot violate them:
+ *  - `max_tokens` is required on every request.
+ *  - sampling parameters (temperature/top_p) are NOT part of this request
+ *    shape — this API version rejects them with a 400.
+ */
+interface AnthropicProviderConfig {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly timeoutMs?: number;
+    /** Per-tier model overrides; merged over ANTHROPIC_TIERS. */
+    readonly models?: TierModelMap;
+    /** Reasoning effort hint; defaults come from ANTHROPIC_DEFAULT_EFFORT per model. */
+    readonly effort?: AnthropicEffort;
+}
+type AnthropicMessageRole = "user" | "assistant";
+interface AnthropicMessage {
+    readonly role: AnthropicMessageRole;
+    readonly content: string;
+}
+interface AnthropicOutputConfig {
+    /** Reasoning effort: low | medium | high. Omitted when not specified. */
+    readonly effort?: AnthropicEffort;
+}
+interface AnthropicMessagesRequest {
+    readonly model: string;
+    readonly messages: AnthropicMessage[];
+    /** Required — the API rejects requests without it. */
+    readonly max_tokens: number;
+    /** Top-level system prompt slot; preferred over in-band system messages. */
+    readonly system?: string;
+    readonly output_config?: AnthropicOutputConfig;
+    readonly stop_sequences?: string[];
+    readonly stream?: boolean;
+}
+interface AnthropicTextBlock {
+    readonly type: "text";
+    readonly text: string;
+}
+type AnthropicContentBlock = AnthropicTextBlock;
+type AnthropicStopReason = "end_turn" | "max_tokens" | "stop_sequence" | "refusal";
+interface AnthropicUsage {
+    readonly input_tokens: number;
+    readonly output_tokens: number;
+}
+interface AnthropicMessagesResponse {
+    readonly id: string;
+    readonly type: "message";
+    readonly role: "assistant";
+    readonly model: string;
+    readonly content: AnthropicContentBlock[];
+    readonly stop_reason: AnthropicStopReason | null;
+    readonly stop_sequence: string | null;
+    readonly usage: AnthropicUsage;
+}
+interface AnthropicMessageStartEvent {
+    readonly type: "message_start";
+    readonly message: {
+        readonly id: string;
+        readonly model: string;
+        readonly usage?: AnthropicUsage;
+    };
+}
+interface AnthropicContentBlockDeltaEvent {
+    readonly type: "content_block_delta";
+    readonly index: number;
+    /** text_delta events carry text; other delta kinds (thinking etc.) don't. */
+    readonly delta: {
+        readonly type: string;
+        readonly text?: string;
+    };
+}
+interface AnthropicMessageDeltaEvent {
+    readonly type: "message_delta";
+    readonly delta: {
+        readonly stop_reason?: AnthropicStopReason | null;
+    };
+    readonly usage?: AnthropicUsage;
+}
+interface AnthropicMessageStopEvent {
+    readonly type: "message_stop";
+}
+interface AnthropicErrorEvent {
+    readonly type: "error";
+    readonly error: {
+        readonly type: string;
+        readonly message: string;
+    };
+}
+type AnthropicStreamEvent = AnthropicMessageStartEvent | AnthropicContentBlockDeltaEvent | AnthropicMessageDeltaEvent | AnthropicMessageStopEvent | AnthropicErrorEvent;
+
+/**
+ * Groq wire types. The `Groq` prefix is deliberate: these describe Groq's
+ * OpenAI-compatible chat/completions wire format and nothing else. Providers
+ * translate core `TextRequest`s into these; the rest of the package never
+ * sees them.
+ */
+interface GroqProviderConfig {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly timeoutMs?: number;
+    /** Per-tier model overrides; merged over GROQ_TIERS. */
+    readonly models?: TierModelMap;
+}
+type GroqReasoningEffort = "low" | "medium" | "high";
+interface GroqGenerationConfig {
+    readonly temperature?: number;
+    readonly maxTokens?: number;
+    readonly topP?: number;
+    readonly n?: number;
+    readonly stop?: string[];
+    readonly frequencyPenalty?: number;
+    readonly presencePenalty?: number;
+    readonly reasoningEffort?: GroqReasoningEffort;
+}
+type GroqMessageRole = "system" | "user" | "assistant";
+interface GroqMessage {
+    readonly role: GroqMessageRole;
+    readonly content: string;
+}
+interface GroqChatRequest {
+    readonly model: string;
+    readonly messages: GroqMessage[];
+    readonly temperature?: number;
+    readonly max_tokens?: number;
+    readonly top_p?: number;
+    readonly n?: number;
+    readonly stop?: string[];
+    readonly frequency_penalty?: number;
+    readonly presence_penalty?: number;
+    readonly reasoning_effort?: GroqReasoningEffort;
+    readonly response_format?: {
+        readonly type: "json_object";
+    };
+    readonly stream?: boolean;
+}
+type GroqFinishReason = "stop" | "length" | "content_filter";
+interface GroqChoice {
+    readonly index: number;
+    readonly message: {
+        readonly role: "assistant";
+        readonly content: string;
+    };
+    readonly finish_reason: GroqFinishReason;
+    readonly logprobs: null | object;
+}
+interface GroqUsage {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly total_tokens: number;
+    readonly prompt_time?: number;
+    readonly completion_time?: number;
+    readonly total_time?: number;
+}
+interface GroqChatResponse {
+    readonly id: string;
+    readonly object: string;
+    readonly created: number;
+    readonly model: string;
+    readonly choices: GroqChoice[];
+    readonly usage: GroqUsage;
+    readonly system_fingerprint?: string;
+    readonly x_groq?: {
+        readonly id?: string;
+        /** Present on the final chunk of a stream when usage accounting is enabled. */
+        readonly usage?: GroqUsage;
+    };
+}
+interface GroqChunkChoice {
+    readonly index: number;
+    readonly delta: {
+        readonly role?: "assistant";
+        readonly content?: string;
+    };
+    readonly finish_reason: GroqFinishReason | null;
+    readonly logprobs: null | object;
+}
+interface GroqChatChunk {
+    readonly id: string;
+    readonly object: string;
+    readonly created: number;
+    readonly model: string;
+    readonly choices: GroqChunkChoice[];
+    readonly system_fingerprint?: string;
+    readonly x_groq?: {
+        readonly id?: string;
+        readonly usage?: GroqUsage;
+    };
+}
+interface StreamRequestOptions {
+    readonly signal?: AbortSignal;
+}
+
+/**
+ * Composition root for the whole package — replaces the old
+ * `configureProvider()` singleton. A provider block's presence means the
+ * provider is enabled; presence of its apiKey is what actually registers it.
+ * `priority` decides who serves first; the fallback walk handles the rest.
+ *
+ * ```ts
+ * const ai = createAI({
+ *   priority: ['anthropic', 'groq'],
+ *   defaultTier: 'balanced',
+ *   anthropic: { apiKey: env.ANTHROPIC_API_KEY },
+ *   groq: { apiKey: env.GROQ_API_KEY },
+ * });
+ * const { text, usage } = await ai.chat({ messages, systemPrompt });
+ * ```
+ */
+interface AIProviderConfig {
+    /** Provider ids in preference order for every capability. */
+    priority?: ReadonlyArray<string>;
+    fallbackEnabled?: boolean;
+    /** Tier used when a request names neither model nor tier. Default 'balanced'. */
+    defaultTier?: TextTier;
+    anthropic?: AnthropicProviderConfig;
+    groq?: GroqProviderConfig;
+    gemini?: Omit<GeminiConfig, "enabled">;
+    fal?: Omit<FalConfig, "enabled">;
+    pruna?: Omit<PrunaConfig, "enabled">;
+}
+declare function createAI(config?: AIProviderConfig): ProviderFactory;
+
+export { type AIProviderConfig as A, type GroqChatChunk as G, ProviderQuotaExhaustedError as P, type StreamRequestOptions as S, ValidationError as V, ANTHROPIC_API_VERSION as a, ANTHROPIC_DEFAULT_MAX_TOKENS as b, ANTHROPIC_MODELS as c, ANTHROPIC_TIERS as d, type AnthropicEffort as e, type AnthropicMessagesRequest as f, type AnthropicMessagesResponse as g, type AnthropicProviderConfig as h, type AnthropicStopReason as i, type AnthropicStreamEvent as j, type GroqChatRequest as k, type GroqChatResponse as l, type GroqMessage as m, type GroqProviderConfig as n, createAI as o, type AIErrorCode as p, AIError as q, ProviderUnavailableError as r, type AnthropicMessage as s, type GroqGenerationConfig as t };