@absolutejs/ai 0.0.49 → 0.0.50

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

@@ -0,0 +1,147 @@
+export type OpenRouterClientConfig = {
+    allowedModels?: readonly string[];
+    apiKey?: string;
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    tokenSource?: () => Promise<string> | string;
+};
+export type OpenRouterModel = {
+    id: string;
+    name?: string;
+    description?: string;
+    context_length?: number;
+    architecture?: Record<string, unknown>;
+    pricing?: Record<string, string>;
+    supported_parameters?: string[] | Record<string, unknown>;
+    [field: string]: unknown;
+};
+export type OpenRouterModelList = {
+    data: OpenRouterModel[];
+};
+export type OpenRouterEmbeddingRequest = {
+    model: string;
+    input: string | string[] | number[] | number[][];
+    dimensions?: number;
+    encoding_format?: "float" | "base64";
+    provider?: Record<string, unknown>;
+    user?: string;
+};
+export type OpenRouterEmbeddingResponse = {
+    data: Array<{
+        embedding: number[] | string;
+        index: number;
+        object: string;
+    }>;
+    model: string;
+    object: string;
+    usage?: {
+        prompt_tokens: number;
+        total_tokens: number;
+        cost?: number;
+    };
+};
+export type OpenRouterRerankRequest = {
+    model: string;
+    query: string;
+    documents: Array<string | {
+        text: string;
+    }>;
+    top_n?: number;
+    return_documents?: boolean;
+};
+export type OpenRouterRerankResponse = {
+    id?: string;
+    model?: string;
+    results: Array<{
+        document?: {
+            text: string;
+        };
+        index: number;
+        relevance_score: number;
+    }>;
+    usage?: Record<string, number>;
+};
+export type OpenRouterImageRequest = {
+    model: string;
+    prompt: string;
+    n?: number;
+    resolution?: string;
+    aspect_ratio?: string;
+    size?: string;
+    quality?: "auto" | "low" | "medium" | "high";
+    output_format?: "png" | "jpeg" | "webp" | "svg";
+    background?: "auto" | "transparent" | "opaque";
+    output_compression?: number;
+    seed?: number;
+    input_references?: Array<Record<string, unknown>>;
+    provider?: Record<string, unknown>;
+};
+export type OpenRouterImageResponse = {
+    created: number;
+    data: Array<{
+        b64_json: string;
+        media_type?: string;
+    }>;
+    usage?: Record<string, number>;
+};
+export type OpenRouterResponsesRequest = Record<string, unknown> & {
+    input: unknown;
+    model: string;
+    stream?: boolean;
+};
+export type OpenRouterSpeechRequest = Record<string, unknown> & {
+    input: string;
+    model: string;
+    voice: string;
+};
+export type OpenRouterTranscriptionRequest = Record<string, unknown> & {
+    model: string;
+};
+export type OpenRouterVideoRequest = Record<string, unknown> & {
+    model: string;
+    prompt: string;
+};
+export type OpenRouterHttpRequestOptions = Omit<RequestInit, "body" | "headers"> & {
+    body?: unknown;
+    headers?: HeadersInit;
+    query?: Record<string, boolean | number | string | undefined>;
+};
+export type OpenRouterClient = ReturnType<typeof createOpenRouterClient>;
+export declare const openRouterModelMatchesRule: (model: string, rule: string) => 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>>;
+    getBatch: (id: string) => Promise<Record<string, unknown>>;
+    getCredits: () => Promise<{
+        data: Record<string, number>;
+    }>;
+    getCurrentKey: () => Promise<{
+        data: Record<string, unknown>;
+    }>;
+    getGeneration: (id: string) => Promise<{
+        data: Record<string, unknown>;
+    }>;
+    getModelEndpoints: (model: string) => Promise<Record<string, unknown>>;
+    getVideo: (id: string) => Promise<Record<string, unknown>>;
+    listImageModels: () => Promise<OpenRouterModelList>;
+    listModels: (query?: OpenRouterHttpRequestOptions["query"]) => Promise<OpenRouterModelList>;
+    listPresets: (offset?: number, limit?: number) => Promise<{
+        data: Record<string, unknown>[];
+        total_count: number;
+    }>;
+    listProviders: () => Promise<{
+        data: Record<string, unknown>[];
+    }>;
+    listRerankModels: () => Promise<OpenRouterModelList>;
+    listVideoModels: () => Promise<OpenRouterModelList>;
+    request: <T>(path: string, options?: OpenRouterHttpRequestOptions) => Promise<T>;
+    requestRaw: (path: string, options?: OpenRouterHttpRequestOptions) => Promise<Response>;
+    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>>;
+};

package/dist/types/ai.d.ts

@@ -1,11 +1,19 @@
 import type { SessionStore } from "./session";
 export type AIUsage = {
-    /** Anthropic prompt-cache reads (billed at 0.10x input). Omitted when unused. */
+    /** Prompt-cache reads reported separately from uncached input. */
     cacheReadInputTokens?: number;
-    /** Anthropic prompt-cache writes (billed at 1.25x input). Omitted when unused. */
+    /** Prompt-cache writes reported separately from uncached input. */
     cacheWriteInputTokens?: number;
+    /** Provider-reported charge in account credits, when returned by the API. */
+    costCredits?: number;
     inputTokens: number;
     outputTokens: number;
+    /** Completion tokens spent on internal reasoning, when reported separately. */
+    reasoningTokens?: number;
+    /** Provider-hosted tool calls, keyed by the provider's usage counter. */
+    serverToolUse?: Record<string, number>;
+    /** Upstream inference charge in provider credits, when exposed by a router. */
+    upstreamInferenceCostCredits?: number;
 };
 export type RAGSource = {
     chunkId: string;
@@ -109,10 +117,27 @@ export type AIToolUseChunk = {
     input: unknown;
 };
 export type AIDoneChunk = {
+    metadata?: AIResponseMetadata;
     type: "done";
     usage?: AIUsage;
     stopReason?: string;
 };
+export type AIResponseMetadata = {
+    generationId?: string;
+    model?: string;
+    provider?: string;
+    serviceTier?: string;
+    /** Provider-native response metadata for routing and diagnostics. */
+    providerMetadata?: Record<string, unknown>;
+};
+export type AICitationChunk = {
+    type: "citation";
+    url: string;
+    title?: string;
+    content?: string;
+    startIndex?: number;
+    endIndex?: number;
+};
 export type AIThinkingChunk = {
     type: "thinking";
     content: string;
@@ -130,7 +155,7 @@ export type AIUsageUpdateChunk = {
     type: "usage_update";
     usage: AIUsage;
 };
-export type AIChunk = AITextChunk | AIThinkingChunk | AIToolUseChunk | AIImageChunk | AIUsageUpdateChunk | AIDoneChunk;
+export type AIChunk = AITextChunk | AIThinkingChunk | AIToolUseChunk | AIImageChunk | AICitationChunk | AIUsageUpdateChunk | AIDoneChunk;
 export type AIProviderToolChoice = "auto" | "none" | "required" | {
     name: string;
 };
@@ -188,6 +213,8 @@ export type AIProviderStreamParams = {
     }) => void;
     parallelToolCalls?: boolean;
     presencePenalty?: number;
+    /** Provider-specific request options, keyed by provider name. */
+    providerOptions?: Record<string, unknown>;
     /**
      * Per-call override for the provider's `promptCaching` default. Leave unset to
      * inherit the provider config. Set `false` to skip ALL cache breakpoints for
@@ -218,15 +245,37 @@ export type AIProviderMessage = {
     content: string | AIProviderContentBlock[];
 };
 export type AIImageSource = {
+    media_type: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+} & ({
     type: "base64";
     data: string;
-    media_type: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
-};
+} | {
+    type: "url";
+    url: string;
+});
 export type AIDocumentSource = {
+    media_type: "application/pdf";
+} & ({
     type: "base64";
     data: string;
-    media_type: "application/pdf";
+} | {
+    type: "url";
+    url: string;
+});
+export type AIAudioSource = {
+    type: "base64";
+    data: string;
+    format: "wav" | "mp3" | "aiff" | "aac" | "ogg" | "flac" | "m4a" | "pcm16" | "pcm24";
 };
+export type AIVideoSource = {
+    media_type: "video/mp4" | "video/mpeg" | "video/quicktime" | "video/webm";
+} & ({
+    type: "base64";
+    data: string;
+} | {
+    type: "url";
+    url: string;
+});
 export type AIProviderContentBlock = {
     type: "text";
     content: string;
@@ -241,6 +290,12 @@ export type AIProviderContentBlock = {
     type: "document";
     source: AIDocumentSource;
     name?: string;
+} | {
+    type: "audio";
+    source: AIAudioSource;
+} | {
+    type: "video";
+    source: AIVideoSource;
 } | {
     type: "tool_use";
     id: string;
@@ -510,6 +565,8 @@ export type StreamAIOptions = {
     cacheSystemPrompt?: boolean;
     /** Per-call override of the provider `promptCaching` default. See AIProviderStreamParams. */
     promptCaching?: boolean;
+    /** Provider-specific options forwarded to every model turn. */
+    providerOptions?: Record<string, unknown>;
     tools?: AIToolMap;
     /** Portable reasoning effort — translated per provider/model. */
     reasoning?: ReasoningConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/ai",
-  "version": "0.0.49",
+  "version": "0.0.50",
   "homepage": "https://github.com/absolutejs/ai",
   "bugs": {
     "url": "https://github.com/absolutejs/ai/issues"
@@ -59,6 +59,10 @@
       "import": "./dist/ai/providers/openaiCompatible.js",
       "types": "./dist/src/ai/providers/openaiCompatible.d.ts"
     },
+    "./openrouter": {
+      "import": "./dist/ai/providers/openrouter.js",
+      "types": "./dist/src/ai/providers/openrouter.d.ts"
+    },
     "./openai-responses": {
       "import": "./dist/ai/providers/openaiResponses.js",
       "types": "./dist/src/ai/providers/openaiResponses.d.ts"
@@ -110,7 +114,7 @@
     }
   },
   "devDependencies": {
-    "@absolutejs/absolute": "^0.19.0-beta.1051",
+    "@absolutejs/absolute": "^0.20.0-beta.0",
     "@absolutejs/isolated-jsc": "0.6.0",
     "@angular/core": "^21.0.0",
     "@eslint/js": "^10.0.1",
@@ -175,6 +179,9 @@
       "openai-compatible": [
         "dist/src/ai/providers/openaiCompatible.d.ts"
       ],
+      "openrouter": [
+        "dist/src/ai/providers/openrouter.d.ts"
+      ],
       "openai-responses": [
         "dist/src/ai/providers/openaiResponses.d.ts"
       ],