@absolutejs/ai 0.0.50 → 0.0.51

package/dist/src/ai/client/actions.d.ts

@@ -13,6 +13,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -42,6 +44,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -71,6 +75,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -100,6 +106,39 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     name?: undefined;
     result?: undefined;
     status?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
+    durationMs?: undefined;
+    model?: undefined;
+    sources?: undefined;
+    usage?: undefined;
+    position?: undefined;
+    attachments?: undefined;
+    fromMessageId?: undefined;
+    mode?: undefined;
+    newConversationId?: undefined;
+    oldConversationId?: undefined;
+    retrievalStartedAt?: undefined;
+    retrievalDurationMs?: undefined;
+    retrievedAt?: undefined;
+    trace?: undefined;
+    message?: undefined;
+} | {
+    audioId: string | undefined;
+    conversationId: string;
+    data: string;
+    format: string;
+    messageId: string;
+    transcript: string | undefined;
+    type: "audio";
+    content?: undefined;
+    input?: undefined;
+    name?: undefined;
+    result?: undefined;
+    status?: undefined;
+    imageId?: undefined;
+    isPartial?: undefined;
+    revisedPrompt?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -133,6 +172,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     position?: undefined;
     attachments?: undefined;
     fromMessageId?: undefined;
@@ -159,6 +200,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -187,6 +230,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -221,6 +266,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -246,6 +293,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;
@@ -279,6 +328,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     usage?: undefined;
@@ -304,6 +355,8 @@ export declare const serverMessageToAction: (message: AIServerMessage) => {
     imageId?: undefined;
     isPartial?: undefined;
     revisedPrompt?: undefined;
+    audioId?: undefined;
+    transcript?: undefined;
     durationMs?: undefined;
     model?: undefined;
     sources?: undefined;

package/dist/src/ai/errors/providerError.d.ts

@@ -9,6 +9,8 @@ export type ProviderErrorInit = {
     type?: string | null;
     retryable: boolean;
     cause?: unknown;
+    /** Provider-native structured details, when the response exposes them. */
+    metadata?: Record<string, unknown>;
 };
 export declare class ProviderError extends Error {
     readonly provider: string;
@@ -17,6 +19,7 @@ export declare class ProviderError extends Error {
     readonly type: string | null;
     /** Whether retrying the same request later could plausibly succeed. */
     readonly retryable: boolean;
+    readonly metadata: Record<string, unknown> | undefined;
     /** Provider status page, when known — for surfacing "is it them?" to users. */
     readonly statusPageUrl: string | null;
     constructor(init: ProviderErrorInit);

package/dist/src/ai/index.d.ts

@@ -24,8 +24,8 @@ export { gemini } from "./providers/gemini";
 export { anthropic } from "./providers/anthropic";
 export { ollama } from "./providers/ollama";
 export { openai } from "./providers/openai";
-export { createOpenRouterClient, openrouter, openrouterResponses, openRouterModelMatchesRule, } from "./providers/openrouter";
-export type { OpenRouterClient, OpenRouterClientConfig, OpenRouterConfig, OpenRouterDataCollection, OpenRouterEmbeddingRequest, OpenRouterEmbeddingResponse, OpenRouterHttpRequestOptions, OpenRouterImageRequest, OpenRouterImageResponse, OpenRouterMaxPrice, OpenRouterModel, OpenRouterModelList, OpenRouterPerformancePreference, OpenRouterPlugin, OpenRouterProviderRouting, OpenRouterQuantization, OpenRouterRequestOptions, OpenRouterRerankRequest, OpenRouterRerankResponse, OpenRouterResponseCache, OpenRouterResponsesRequest, OpenRouterServerTool, OpenRouterServiceTier, OpenRouterSpeechRequest, OpenRouterSort, OpenRouterSortStrategy, OpenRouterTranscriptionRequest, OpenRouterVideoRequest, } from "./providers/openrouter";
+export { createOpenRouterClient, openrouter, openrouterMessages, openrouterResponses, openRouterModelMatchesRule, verifyOpenRouterWebhookSignature, } from "./providers/openrouter";
+export type { OpenRouterClient, OpenRouterClientConfig, OpenRouterConfig, OpenRouterDataCollection, OpenRouterEmbeddingRequest, OpenRouterEmbeddingResponse, OpenRouterFile, OpenRouterFileList, OpenRouterHttpRequestOptions, OpenRouterImageModelEndpoint, OpenRouterImageModelEndpoints, OpenRouterImageRequest, OpenRouterImageResponse, OpenRouterImageStreamEvent, OpenRouterMaxPrice, OpenRouterModel, OpenRouterModelList, OpenRouterModelQuery, OpenRouterPerformancePreference, OpenRouterPlugin, OpenRouterProviderRouting, OpenRouterQuantization, OpenRouterRequestOptions, OpenRouterRerankRequest, OpenRouterRerankResponse, OpenRouterResponseCache, OpenRouterResponsesRequest, OpenRouterServerTool, OpenRouterServiceTier, OpenRouterSpeechRequest, OpenRouterSort, OpenRouterSortStrategy, OpenRouterTrace, OpenRouterTranscriptionRequest, OpenRouterVideoJob, OpenRouterVideoRequest, OpenRouterVideoWebhookEvent, OpenRouterZdrEndpoint, } from "./providers/openrouter";
 export { createOAuth2ClientCredentialsTokenSource } from "./providers/oauth2TokenSource";
 export type { OAuth2ClientCredentialsConfig } from "./providers/oauth2TokenSource";
 export { ProviderError, PROVIDER_STATUS_PAGES, providerStatusPage, } from "./errors/providerError";

package/dist/src/ai/providers/openrouter.d.ts

@@ -44,6 +44,34 @@ export type OpenRouterResponseCache = {
     /** OpenRouter response-cache TTL in seconds (1-86400). */
     ttlSeconds?: number;
 };
+export type OpenRouterCacheControl = {
+    type: "ephemeral";
+    ttl?: "5m" | "1h";
+};
+export type OpenRouterPromptCacheOptions = {
+    mode: "explicit";
+    ttl?: string;
+};
+export type OpenRouterReasoning = {
+    context?: "all_turns" | "auto" | "current_turn";
+    effort?: "minimal" | "low" | "medium" | "high" | "max" | "xhigh";
+    enabled?: boolean;
+    exclude?: boolean;
+    maxTokens?: number;
+    mode?: "pro";
+    summary?: "auto" | "concise" | "detailed";
+};
+export type OpenRouterTrace = Record<string, unknown> & {
+    generation_name?: string;
+    parent_span_id?: string;
+    span_name?: string;
+    trace_id?: string;
+    trace_name?: string;
+};
+export type OpenRouterAudioOutput = {
+    format: "wav" | "mp3" | "flac" | "opus" | "pcm16";
+    voice: string;
+};
 export type OpenRouterPlugin = {
     id: string;
     [option: string]: unknown;
@@ -53,20 +81,34 @@ export type OpenRouterServerTool = {
     parameters?: Record<string, unknown>;
 };
 export type OpenRouterRequestOptions = {
+    /** Stream text and synthesized audio from an audio-output chat model. */
+    audioOutput?: OpenRouterAudioOutput;
+    /** Automatic top-level prompt caching, including optional Anthropic TTL. */
+    cacheControl?: OpenRouterCacheControl;
     /** Future OpenRouter fields. Security-sensitive routing fields are rejected. */
     extraBody?: Record<string, unknown>;
     fallbackModels?: readonly string[];
     includeReasoning?: boolean;
     maxToolCalls?: number;
+    /** Native `/messages` server-tool definitions and replayable tool shapes. */
+    messagesTools?: readonly Record<string, unknown>[];
     plugins?: readonly OpenRouterPlugin[];
+    /** Stable cache identity used by compatible OpenAI-family models. */
+    promptCacheKey?: string;
+    /** OpenAI explicit-cache mode and TTL. */
+    promptCacheOptions?: OpenRouterPromptCacheOptions;
     preset?: string;
     responseCache?: OpenRouterResponseCache;
+    /** OpenRouter-native reasoning controls beyond the portable effort knob. */
+    reasoning?: OpenRouterReasoning;
     routerMetadata?: boolean;
     routing?: OpenRouterProviderRouting;
     serverTools?: readonly OpenRouterServerTool[];
     serviceTier?: OpenRouterServiceTier;
     sessionId?: string;
     stopServerToolsWhen?: readonly Record<string, unknown>[];
+    /** Metadata forwarded to configured OpenRouter Broadcast destinations. */
+    trace?: OpenRouterTrace;
     transforms?: readonly string[];
     user?: string;
     verbosity?: "low" | "medium" | "high";
@@ -109,5 +151,7 @@ export type OpenRouterConfig = {
 export declare const openrouter: (config: OpenRouterConfig) => AIProviderConfig;
 /** OpenRouter's stateless OpenAI-compatible Responses API provider skin. */
 export declare const openrouterResponses: (config: OpenRouterConfig) => AIProviderConfig;
-export { createOpenRouterClient, openRouterModelMatchesRule, } from "./openrouterClient";
-export type { OpenRouterClient, OpenRouterClientConfig, OpenRouterEmbeddingRequest, OpenRouterEmbeddingResponse, OpenRouterHttpRequestOptions, OpenRouterImageRequest, OpenRouterImageResponse, OpenRouterModel, OpenRouterModelList, OpenRouterRerankRequest, OpenRouterRerankResponse, OpenRouterResponsesRequest, OpenRouterSpeechRequest, OpenRouterTranscriptionRequest, OpenRouterVideoRequest, } from "./openrouterClient";
+/** OpenRouter provider using the native Anthropic Messages protocol skin. */
+export declare const openrouterMessages: (config: OpenRouterConfig) => AIProviderConfig;
+export { createOpenRouterClient, openRouterModelMatchesRule, verifyOpenRouterWebhookSignature, } from "./openrouterClient";
+export type { OpenRouterClient, OpenRouterClientConfig, OpenRouterEmbeddingRequest, OpenRouterEmbeddingResponse, OpenRouterFile, OpenRouterFileList, OpenRouterHttpRequestOptions, OpenRouterImageModelEndpoint, OpenRouterImageModelEndpoints, OpenRouterImageRequest, OpenRouterImageResponse, OpenRouterImageStreamEvent, OpenRouterModel, OpenRouterModelList, OpenRouterModelQuery, OpenRouterRerankRequest, OpenRouterRerankResponse, OpenRouterResponsesRequest, OpenRouterSpeechRequest, OpenRouterTranscriptionRequest, OpenRouterVideoJob, OpenRouterVideoRequest, OpenRouterVideoWebhookEvent, OpenRouterZdrEndpoint, } from "./openrouterClient";

package/dist/src/ai/providers/openrouterClient.d.ts

@@ -19,6 +19,22 @@ export type OpenRouterModel = {
 export type OpenRouterModelList = {
     data: OpenRouterModel[];
 };
+export type OpenRouterModelQuery = {
+    arch?: string;
+    context?: number;
+    distillable?: "false" | "true";
+    input_modalities?: string;
+    max_price?: number;
+    min_price?: number;
+    model_authors?: string;
+    output_modalities?: string;
+    providers?: string;
+    q?: string;
+    region?: "eu";
+    supported_parameters?: string;
+    sort?: "pricing-low-to-high" | "pricing-high-to-low" | "context-high-to-low" | "throughput-high-to-low" | "latency-low-to-high" | "most-popular" | "top-weekly" | "newest" | "intelligence-high-to-low" | "design-arena-elo-high-to-low";
+    zdr?: "true";
+};
 export type OpenRouterEmbeddingRequest = {
     model: string;
     input: string | string[] | number[] | number[][];
@@ -76,6 +92,7 @@ export type OpenRouterImageRequest = {
     seed?: number;
     input_references?: Array<Record<string, unknown>>;
     provider?: Record<string, unknown>;
+    stream?: boolean;
 };
 export type OpenRouterImageResponse = {
     created: number;
@@ -85,6 +102,24 @@ export type OpenRouterImageResponse = {
     }>;
     usage?: Record<string, number>;
 };
+export type OpenRouterImageModelEndpoint = {
+    allowed_passthrough_parameters: string[];
+    pricing: Array<{
+        billable: string;
+        cost_usd: number;
+        unit: "image" | "megapixel" | "token" | string;
+        variant?: string;
+    }>;
+    provider_name: string;
+    provider_slug: string;
+    provider_tag: string | null;
+    supported_parameters: Record<string, unknown>;
+    supports_streaming: boolean;
+};
+export type OpenRouterImageModelEndpoints = {
+    endpoints: OpenRouterImageModelEndpoint[];
+    id: string;
+};
 export type OpenRouterResponsesRequest = Record<string, unknown> & {
     input: unknown;
     model: string;
@@ -102,6 +137,58 @@ export type OpenRouterVideoRequest = Record<string, unknown> & {
     model: string;
     prompt: string;
 };
+export type OpenRouterImageStreamEvent = Record<string, unknown> & {
+    type: string;
+    b64_json?: string;
+    media_type?: string;
+    partial_image_index?: number;
+    usage?: Record<string, number>;
+};
+export type OpenRouterFile = {
+    created_at: string;
+    downloadable: boolean;
+    filename: string;
+    id: string;
+    mime_type: string;
+    size_bytes: number;
+    type: "file";
+};
+export type OpenRouterFileList = {
+    cursor: string | null;
+    data: OpenRouterFile[];
+    first_id: string | null;
+    has_more: boolean;
+    last_id: string | null;
+};
+export type OpenRouterVideoJob = {
+    error?: string;
+    generation_id?: string | null;
+    id: string;
+    polling_url?: string;
+    status: "pending" | "in_progress" | "completed" | "failed" | "cancelled" | "expired";
+    unsigned_urls?: string[];
+    usage?: {
+        cost?: number;
+        is_byok?: boolean;
+    };
+};
+export type OpenRouterVideoWebhookEvent = {
+    created_at: string;
+    data: OpenRouterVideoJob & {
+        model?: string | null;
+    };
+    type: "video.generation.completed" | "video.generation.failed" | "video.generation.cancelled" | "video.generation.expired";
+};
+export type OpenRouterZdrEndpoint = Record<string, unknown> & {
+    context_length: number;
+    model_id: string;
+    model_name: string;
+    name: string;
+    pricing: Record<string, string>;
+    provider_name: string;
+    supported_parameters: string[];
+    tag: string;
+};
 export type OpenRouterHttpRequestOptions = Omit<RequestInit, "body" | "headers"> & {
     body?: unknown;
     headers?: HeadersInit;
@@ -109,12 +196,26 @@ export type OpenRouterHttpRequestOptions = Omit<RequestInit, "body" | "headers">
 };
 export type OpenRouterClient = ReturnType<typeof createOpenRouterClient>;
 export declare const openRouterModelMatchesRule: (model: string, rule: string) => boolean;
+/** Verify `X-OpenRouter-Signature` against the exact raw webhook bytes. */
+export declare const verifyOpenRouterWebhookSignature: (options: {
+    body: string | Uint8Array;
+    header: string;
+    secret: string;
+    nowSeconds?: number;
+    toleranceSeconds?: number;
+}) => Promise<boolean>;
 export declare const createOpenRouterClient: (config: OpenRouterClientConfig) => {
     cancelBatch: (id: string) => Promise<Record<string, unknown>>;
     createBatch: (body: Record<string, unknown>) => Promise<Record<string, unknown>>;
     createEmbedding: (body: OpenRouterEmbeddingRequest) => Promise<OpenRouterEmbeddingResponse>;
     generateImage: (body: OpenRouterImageRequest) => Promise<OpenRouterImageResponse>;
-    generateVideo: (body: OpenRouterVideoRequest) => Promise<Record<string, unknown>>;
+    deleteFile: (id: string, workspaceId?: string) => Promise<{
+        id: string;
+        type: "file_deleted";
+    }>;
+    downloadFile: (id: string, workspaceId?: string) => Promise<Response>;
+    downloadVideo: (id: string, index?: number) => Promise<Response>;
+    generateVideo: (body: OpenRouterVideoRequest) => Promise<OpenRouterVideoJob>;
     getBatch: (id: string) => Promise<Record<string, unknown>>;
     getCredits: () => Promise<{
         data: Record<string, number>;
@@ -122,17 +223,40 @@ export declare const createOpenRouterClient: (config: OpenRouterClientConfig) =>
     getCurrentKey: () => Promise<{
         data: Record<string, unknown>;
     }>;
+    getFile: (id: string, workspaceId?: string) => Promise<OpenRouterFile>;
     getGeneration: (id: string) => Promise<{
         data: Record<string, unknown>;
     }>;
     getModelEndpoints: (model: string) => Promise<Record<string, unknown>>;
-    getVideo: (id: string) => Promise<Record<string, unknown>>;
+    getModel: (model: string) => Promise<{
+        data: OpenRouterModel;
+    }>;
+    getImageModelEndpoints: (model: string) => Promise<OpenRouterImageModelEndpoints>;
+    getVideo: (id: string) => Promise<OpenRouterVideoJob>;
     listImageModels: () => Promise<OpenRouterModelList>;
-    listModels: (query?: OpenRouterHttpRequestOptions["query"]) => Promise<OpenRouterModelList>;
+    listFiles: (query?: {
+        cursor?: string;
+        limit?: number;
+        workspace_id?: string;
+    }) => Promise<OpenRouterFileList>;
+    listModels: (query?: OpenRouterModelQuery) => Promise<OpenRouterModelList>;
+    listUserModels: () => Promise<OpenRouterModelList>;
+    listZdrEndpoints: () => Promise<{
+        data: OpenRouterZdrEndpoint[];
+    }>;
+    countModels: (outputModalities?: string) => Promise<{
+        data: {
+            count: number;
+        };
+    }>;
     listPresets: (offset?: number, limit?: number) => Promise<{
         data: Record<string, unknown>[];
         total_count: number;
     }>;
+    listPresetVersions: (slug: string, offset?: number, limit?: number) => Promise<{
+        data: Record<string, unknown>[];
+        total_count: number;
+    }>;
     listProviders: () => Promise<{
         data: Record<string, unknown>[];
     }>;
@@ -140,8 +264,13 @@ export declare const createOpenRouterClient: (config: OpenRouterClientConfig) =>
     listVideoModels: () => Promise<OpenRouterModelList>;
     request: <T>(path: string, options?: OpenRouterHttpRequestOptions) => Promise<T>;
     requestRaw: (path: string, options?: OpenRouterHttpRequestOptions) => Promise<Response>;
+    streamImage: (body: Omit<OpenRouterImageRequest, "stream">, options?: Omit<OpenRouterHttpRequestOptions, "body" | "method">) => AsyncGenerator<OpenRouterImageStreamEvent, void, any>;
     respond: (body: OpenRouterResponsesRequest) => Promise<Response> | Promise<Record<string, unknown>>;
     rerank: (body: OpenRouterRerankRequest) => Promise<OpenRouterRerankResponse>;
     speak: (body: OpenRouterSpeechRequest) => Promise<Response>;
     transcribe: (body: OpenRouterTranscriptionRequest | FormData) => Promise<Record<string, unknown>>;
+    uploadFile: (file: Blob, options?: {
+        filename?: string;
+        workspaceId?: string;
+    }) => Promise<OpenRouterFile>;
 };

package/dist/src/ai/streamAIWithTools.d.ts

@@ -23,6 +23,12 @@ export type StreamAIWithToolsEvent = {
 } | {
     type: "text";
     content: string;
+} | {
+    type: "audio";
+    data: string;
+    format: string;
+    transcript?: string;
+    audioId?: string;
 }
 /** A model turn finished streaming — carries that turn's own usage, so
  *  metering can bill per-turn instead of waiting for the summed total. */

package/dist/svelte/ai/index.js

@@ -106,6 +106,16 @@ var serverMessageToAction = (message) => {
         revisedPrompt: message.revisedPrompt,
         type: "image"
       };
+    case "audio":
+      return {
+        audioId: message.audioId,
+        conversationId: message.conversationId,
+        data: message.data,
+        format: message.format,
+        messageId: message.messageId,
+        transcript: message.transcript,
+        type: "audio"
+      };
     case "complete":
       return {
         conversationId: message.conversationId,
@@ -181,6 +191,8 @@ var isValidAIServerMessage = (data) => {
       return "name" in data && "status" in data && "messageId" in data && "conversationId" in data;
     case "image":
       return "data" in data && typeof data.data === "string" && "format" in data && typeof data.format === "string" && "isPartial" in data && typeof data.isPartial === "boolean" && "messageId" in data && "conversationId" in data;
+    case "audio":
+      return "data" in data && typeof data.data === "string" && "format" in data && typeof data.format === "string" && "messageId" in data && "conversationId" in data;
     case "complete":
       return "messageId" in data && "conversationId" in data;
     case "turn_queued":
@@ -543,6 +555,20 @@ var handleImage = (state, action) => {
   });
   conversation.messages = [...conversation.messages];
 };
+var handleAudio = (state, action) => {
+  const conversation = getOrCreate(state, action.conversationId);
+  const message = getOrCreateAssistantMessage(conversation, action.messageId, action.conversationId);
+  message.audio = [
+    ...message.audio ?? [],
+    {
+      audioId: action.audioId,
+      data: action.data,
+      format: action.format,
+      transcript: action.transcript
+    }
+  ];
+  conversation.messages = [...conversation.messages];
+};
 var handleComplete = (state, action) => {
   const conversation = state.conversations.get(action.conversationId);
   if (conversation) {
@@ -613,6 +639,9 @@ var applyAction = (state, action) => {
     case "image":
       handleImage(state, action);
       break;
+    case "audio":
+      handleAudio(state, action);
+      break;
     case "complete":
       handleComplete(state, action);
       break;
@@ -772,5 +801,5 @@ export {
   createAIStream
 };
 
-//# debugId=1D557221A7953C4F64756E2164756E21
+//# debugId=D75F7C4E06A093F864756E2164756E21
 //# sourceMappingURL=index.js.map