@absolutejs/ai 0.0.50 → 0.0.52

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 { createOpenRouterAuthorizationUrl, createOpenRouterClient, createOpenRouterKeyLinks, estimateOpenRouterCost, estimateOpenRouterModelCost, exchangeOpenRouterAuthCode, generateOpenRouterPKCE, openrouter, openrouterMessages, openrouterResponses, openRouterModelMatchesRule, verifyOpenRouterWebhookSignature, } from "./providers/openrouter";
+export type { OpenRouterActivityItem, OpenRouterActivityQuery, OpenRouterAnalyticsMeta, OpenRouterAnalyticsQuery, OpenRouterAnalyticsResponse, OpenRouterAuthCodeExchangeRequest, OpenRouterAuthCodeExchangeResponse, OpenRouterAutoRouterCostTier, OpenRouterAutoRouterPlugin, OpenRouterAuthorizationUrlOptions, OpenRouterBatch, OpenRouterBatchEndpoint, OpenRouterBatchRequest, OpenRouterBatchResult, OpenRouterBatchStatus, OpenRouterClient, OpenRouterClientConfig, OpenRouterConfig, OpenRouterCostEstimate, OpenRouterCostUnits, OpenRouterCreateAuthCodeRequest, OpenRouterCreateAuthCodeResponse, OpenRouterCreateBatchRequest, OpenRouterCreateWorkspaceRequest, OpenRouterDataCollection, OpenRouterEmbeddingRequest, OpenRouterEmbeddingResponse, OpenRouterFile, OpenRouterFileList, OpenRouterHttpRequestOptions, OpenRouterImageModelEndpoint, OpenRouterImageModelEndpoints, OpenRouterImageRequest, OpenRouterImageResponse, OpenRouterImageStreamEvent, OpenRouterMaxPrice, OpenRouterModel, OpenRouterModelList, OpenRouterModelQuery, OpenRouterPerformancePreference, OpenRouterPlugin, OpenRouterPKCE, OpenRouterPreset, OpenRouterPresetInferenceRequest, OpenRouterPresetResponse, OpenRouterPresetVersion, OpenRouterPresetVersionResponse, OpenRouterPricing, OpenRouterPricingKey, OpenRouterProviderRouting, OpenRouterQuantization, OpenRouterRequestOptions, OpenRouterRerankRequest, OpenRouterRerankResponse, OpenRouterResponseCache, OpenRouterResponsesRequest, OpenRouterServerTool, OpenRouterServiceTier, OpenRouterSpeechRequest, OpenRouterSort, OpenRouterSortStrategy, OpenRouterTrace, OpenRouterTaskClassifications, OpenRouterTranscriptionRequest, OpenRouterTranscriptionResponse, OpenRouterVideoJob, OpenRouterVideoRequest, OpenRouterVideoWebhookEvent, OpenRouterWorkspace, OpenRouterWorkspaceBudget, OpenRouterWorkspaceBudgetInterval, OpenRouterWorkspaceMember, OpenRouterWorkspaceOptions, 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,7 +44,44 @@ export type OpenRouterResponseCache = {
     /** OpenRouter response-cache TTL in seconds (1-86400). */
     ttlSeconds?: number;
 };
-export type OpenRouterPlugin = {
+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 OpenRouterAutoRouterCostTier = "low" | "medium" | "high" | "xhigh" | "max";
+export type OpenRouterAutoRouterPlugin = {
+    id: "auto-router";
+    /** Restrict Auto Router candidates; omitted means the full catalog. */
+    allowed_models?: readonly string[];
+    cost_tier?: OpenRouterAutoRouterCostTier;
+    /** Legacy numeric control. When present, OpenRouter prioritizes it over cost_tier. */
+    cost_quality_tradeoff?: number;
+};
+export type OpenRouterPlugin = OpenRouterAutoRouterPlugin | {
     id: string;
     [option: string]: unknown;
 };
@@ -53,20 +90,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 +160,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 { createOpenRouterAuthorizationUrl, createOpenRouterClient, createOpenRouterKeyLinks, estimateOpenRouterCost, estimateOpenRouterModelCost, exchangeOpenRouterAuthCode, generateOpenRouterPKCE, openRouterModelMatchesRule, verifyOpenRouterWebhookSignature, } from "./openrouterClient";
+export type { OpenRouterActivityItem, OpenRouterActivityQuery, OpenRouterAnalyticsMeta, OpenRouterAnalyticsQuery, OpenRouterAnalyticsResponse, OpenRouterAuthCodeExchangeRequest, OpenRouterAuthCodeExchangeResponse, OpenRouterAuthorizationUrlOptions, OpenRouterBatch, OpenRouterBatchEndpoint, OpenRouterBatchRequest, OpenRouterBatchResult, OpenRouterBatchStatus, OpenRouterClient, OpenRouterClientConfig, OpenRouterCostEstimate, OpenRouterCostUnits, OpenRouterCreateAuthCodeRequest, OpenRouterCreateAuthCodeResponse, OpenRouterCreateBatchRequest, OpenRouterCreateWorkspaceRequest, OpenRouterEmbeddingRequest, OpenRouterEmbeddingResponse, OpenRouterFile, OpenRouterFileList, OpenRouterHttpRequestOptions, OpenRouterImageModelEndpoint, OpenRouterImageModelEndpoints, OpenRouterImageRequest, OpenRouterImageResponse, OpenRouterImageStreamEvent, OpenRouterModel, OpenRouterModelList, OpenRouterModelQuery, OpenRouterPreset, OpenRouterPresetInferenceRequest, OpenRouterPresetResponse, OpenRouterPresetVersion, OpenRouterPresetVersionResponse, OpenRouterPricing, OpenRouterPricingKey, OpenRouterPKCE, OpenRouterRerankRequest, OpenRouterRerankResponse, OpenRouterResponsesRequest, OpenRouterSpeechRequest, OpenRouterTranscriptionRequest, OpenRouterTranscriptionResponse, OpenRouterTaskClassifications, OpenRouterVideoJob, OpenRouterVideoRequest, OpenRouterVideoWebhookEvent, OpenRouterWorkspace, OpenRouterWorkspaceBudget, OpenRouterWorkspaceBudgetInterval, OpenRouterWorkspaceMember, OpenRouterWorkspaceOptions, OpenRouterZdrEndpoint, } from "./openrouterClient";