@absolutejs/ai 0.0.51 → 0.0.53

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

@@ -1,10 +1,96 @@
 export type OpenRouterClientConfig = {
     allowedModels?: readonly string[];
     apiKey?: string;
+    batchBaseUrl?: string;
     baseUrl?: string;
     fetch?: typeof globalThis.fetch;
     headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
     tokenSource?: () => Promise<string> | string;
+    /** Default workspace for APIs that accept explicit workspace selection. */
+    workspaceId?: string;
+};
+export type OpenRouterPKCE = {
+    codeChallenge: string;
+    codeChallengeMethod: "S256";
+    codeVerifier: string;
+};
+export type OpenRouterAuthorizationUrlOptions = {
+    baseUrl?: string;
+    callbackUrl?: string;
+    codeChallenge?: string;
+    codeChallengeMethod?: "S256" | "plain";
+    keyLabel?: string;
+};
+export type OpenRouterAuthCodeExchangeRequest = {
+    code: string;
+    code_challenge_method?: "S256" | "plain";
+    code_verifier?: string;
+};
+export type OpenRouterAuthCodeExchangeResponse = {
+    key: string;
+    user_id: string | null;
+};
+export type OpenRouterCreateAuthCodeRequest = {
+    callback_url: string;
+    code_challenge?: string;
+    code_challenge_method?: "S256" | "plain";
+    expires_at?: string;
+    key_label?: string;
+    limit?: number;
+    usage_limit_type?: string;
+    workspace_id?: string;
+};
+export type OpenRouterCreateAuthCodeResponse = {
+    data: {
+        app_id: number;
+        created_at: string;
+        id: string;
+    };
+};
+export type OpenRouterBatchEndpoint = "/v1/chat/completions" | "/v1/responses" | "/v1/messages" | "/v1/embeddings";
+export type OpenRouterBatchStatus = "validating" | "in_progress" | "finalizing" | "completed" | "failed" | "expired" | "cancelling" | "cancelled";
+export type OpenRouterBatchRequest = {
+    custom_id: string;
+    body: Record<string, unknown>;
+};
+export type OpenRouterBatchResult = {
+    custom_id: string;
+    id: string;
+    response?: {
+        body: Record<string, unknown>;
+        request_id: string;
+        status_code: number;
+    };
+    error?: Record<string, unknown>;
+};
+export type OpenRouterBatch = {
+    id: string;
+    endpoint: OpenRouterBatchEndpoint;
+    model: string;
+    status: OpenRouterBatchStatus;
+    completion_window?: "24h";
+    created_at?: string;
+    completed_at?: string | null;
+    request_counts?: {
+        completed: number;
+        failed: number;
+        total: number;
+    };
+    results?: OpenRouterBatchResult[];
+    usage?: {
+        completion_tokens: number;
+        cost: number;
+        is_byok: boolean;
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+    [field: string]: unknown;
+};
+export type OpenRouterCreateBatchRequest = {
+    endpoint: OpenRouterBatchEndpoint;
+    model: string;
+    requests: [OpenRouterBatchRequest, ...OpenRouterBatchRequest[]];
+    completion_window?: "24h";
 };
 export type OpenRouterModel = {
     id: string;
@@ -12,10 +98,20 @@ export type OpenRouterModel = {
     description?: string;
     context_length?: number;
     architecture?: Record<string, unknown>;
-    pricing?: Record<string, string>;
+    pricing?: OpenRouterPricing;
     supported_parameters?: string[] | Record<string, unknown>;
     [field: string]: unknown;
 };
+export type OpenRouterPricingKey = "prompt" | "completion" | "request" | "image" | "web_search" | "internal_reasoning" | "input_cache_read" | "input_cache_write";
+export type OpenRouterPricing = Partial<Record<OpenRouterPricingKey, string>> & Record<string, string | undefined>;
+export type OpenRouterCostUnits = Partial<Record<OpenRouterPricingKey, number>>;
+export type OpenRouterCostEstimate = {
+    components: Partial<Record<OpenRouterPricingKey, number>>;
+    total: number;
+};
+/** Estimate USD cost using OpenRouter's per-unit model pricing fields. */
+export declare const estimateOpenRouterCost: (pricing: OpenRouterPricing, units: OpenRouterCostUnits) => OpenRouterCostEstimate;
+export declare const estimateOpenRouterModelCost: (model: Pick<OpenRouterModel, "pricing">, units: OpenRouterCostUnits) => OpenRouterCostEstimate;
 export type OpenRouterModelList = {
     data: OpenRouterModel[];
 };
@@ -43,6 +139,17 @@ export type OpenRouterEmbeddingRequest = {
     provider?: Record<string, unknown>;
     user?: string;
 };
+export type OpenRouterChatRequest = Record<string, unknown> & {
+    messages: readonly unknown[];
+    model: string;
+    stream?: false;
+};
+export type OpenRouterChatResponse = Record<string, unknown> & {
+    choices: Array<Record<string, unknown>>;
+    id: string;
+    model: string;
+    usage?: Record<string, unknown>;
+};
 export type OpenRouterEmbeddingResponse = {
     data: Array<{
         embedding: number[] | string;
@@ -131,7 +238,24 @@ export type OpenRouterSpeechRequest = Record<string, unknown> & {
     voice: string;
 };
 export type OpenRouterTranscriptionRequest = Record<string, unknown> & {
+    input_audio: {
+        data: string;
+        format: string;
+    };
+    language?: string;
     model: string;
+    provider?: Record<string, unknown>;
+    temperature?: number;
+};
+export type OpenRouterTranscriptionResponse = {
+    text: string;
+    usage: {
+        cost: number;
+        input_tokens: number;
+        output_tokens: number;
+        seconds: number;
+        total_tokens: number;
+    };
 };
 export type OpenRouterVideoRequest = Record<string, unknown> & {
     model: string;
@@ -189,6 +313,188 @@ export type OpenRouterZdrEndpoint = Record<string, unknown> & {
     supported_parameters: string[];
     tag: string;
 };
+export type OpenRouterPresetVersion = {
+    config: Record<string, unknown>;
+    created_at: string;
+    creator_id: string;
+    id: string;
+    preset_id: string;
+    system_prompt: string | null;
+    updated_at: string | null;
+    version: number;
+};
+export type OpenRouterPreset = {
+    created_at: string;
+    creator_user_id: string;
+    designated_version: OpenRouterPresetVersion;
+    designated_version_id: string;
+    description: string | null;
+    id: string;
+    name: string;
+    slug: string;
+    status: string;
+    status_updated_at: string | null;
+    updated_at: string | null;
+    workspace_id: string;
+};
+export type OpenRouterPresetResponse = {
+    data: OpenRouterPreset;
+};
+export type OpenRouterPresetVersionResponse = {
+    data: OpenRouterPresetVersion;
+};
+export type OpenRouterPresetInferenceRequest = Record<string, unknown> & {
+    model?: string;
+    models?: string[];
+};
+export type OpenRouterActivityQuery = {
+    api_key_hash?: string;
+    date?: string;
+    user_id?: string;
+    workspace_id?: string;
+};
+export type OpenRouterActivityItem = {
+    byok_usage_inference: number;
+    completion_tokens: number;
+    date: string;
+    endpoint_id: string;
+    model: string;
+    model_permaslug: string;
+    prompt_tokens: number;
+    provider_name: string;
+    reasoning_tokens: number;
+    requests: number;
+    usage: number;
+    workspace_id?: string;
+};
+export type OpenRouterAnalyticsQuery = {
+    metrics: [string, ...string[]];
+    dimensions?: string[];
+    filters?: Array<{
+        field: string;
+        operator: string;
+        value: unknown;
+    }>;
+    granularity?: string;
+    group_limit?: number;
+    limit?: number;
+    order_by?: {
+        direction: "asc" | "desc";
+        field: string;
+    };
+    time_range?: {
+        end: string;
+        start: string;
+    };
+};
+export type OpenRouterAnalyticsResponse = {
+    data: {
+        data: Record<string, unknown>[];
+        metadata: {
+            query_time_ms: number;
+            row_count: number;
+            truncated: boolean;
+        };
+    };
+};
+export type OpenRouterAnalyticsMeta = {
+    data: {
+        dimensions: Array<{
+            display_label: string;
+            name: string;
+        }>;
+        granularities: Array<{
+            display_label: string;
+            name: string;
+        }>;
+        metrics: Array<{
+            display_format: string;
+            display_label: string;
+            is_rate: boolean;
+            name: string;
+        }>;
+        operators: Array<{
+            name: string;
+            value_type: string;
+        }>;
+    };
+};
+export type OpenRouterTaskClassifications = {
+    data: {
+        as_of: string;
+        classifications: Array<{
+            category_token_share: number;
+            category_usage_share: number;
+            display_name: string;
+            macro_category: string;
+            models: Array<{
+                id: string;
+                tag_token_share: number;
+                tag_usage_share: number;
+            }>;
+            tag: string;
+            token_share: number;
+            usage_share: number;
+        }>;
+        macro_categories: Array<{
+            key: string;
+            label: string;
+            token_share: number;
+            usage_share: number;
+        }>;
+        window_days: 7;
+    };
+};
+export type OpenRouterWorkspace = {
+    created_at: string;
+    created_by: string;
+    default_image_model: string | null;
+    default_provider_sort: "price" | "throughput" | "latency" | "exacto" | null;
+    default_text_model: string | null;
+    description: string | null;
+    id: string;
+    io_logging_api_key_ids: number[] | null;
+    io_logging_sampling_rate: number;
+    is_data_discount_logging_enabled: boolean;
+    is_observability_broadcast_enabled: boolean;
+    is_observability_io_logging_enabled: boolean;
+    name: string;
+    slug: string;
+    updated_at: string | null;
+};
+export type OpenRouterWorkspaceOptions = {
+    default_image_model?: string | null;
+    default_provider_sort?: OpenRouterWorkspace["default_provider_sort"];
+    default_text_model?: string | null;
+    description?: string | null;
+    io_logging_api_key_ids?: number[] | null;
+    io_logging_sampling_rate?: number;
+    is_data_discount_logging_enabled?: boolean;
+    is_observability_broadcast_enabled?: boolean;
+    is_observability_io_logging_enabled?: boolean;
+    name?: string;
+    slug?: string;
+};
+export type OpenRouterCreateWorkspaceRequest = OpenRouterWorkspaceOptions & {
+    name: string;
+    slug: string;
+};
+export type OpenRouterWorkspaceBudgetInterval = "daily" | "weekly" | "monthly" | "lifetime";
+export type OpenRouterWorkspaceBudget = {
+    created_at: string;
+    id: string;
+    limit_usd: number;
+    reset_interval: OpenRouterWorkspaceBudgetInterval;
+    updated_at: string | null;
+    workspace_id: string;
+};
+export type OpenRouterWorkspaceMember = {
+    created_at: string;
+    id: string;
+    role: string;
+    user_id: string;
+    workspace_id: string;
+};
 export type OpenRouterHttpRequestOptions = Omit<RequestInit, "body" | "headers"> & {
     body?: unknown;
     headers?: HeadersInit;
@@ -196,6 +502,18 @@ export type OpenRouterHttpRequestOptions = Omit<RequestInit, "body" | "headers">
 };
 export type OpenRouterClient = ReturnType<typeof createOpenRouterClient>;
 export declare const openRouterModelMatchesRule: (model: string, rule: string) => boolean;
+export declare const generateOpenRouterPKCE: () => Promise<OpenRouterPKCE>;
+export declare const createOpenRouterAuthorizationUrl: (options?: OpenRouterAuthorizationUrlOptions) => string;
+/** Exchange a single-use OAuth code. This endpoint intentionally has no API-key authentication. */
+export declare const exchangeOpenRouterAuthCode: (body: OpenRouterAuthCodeExchangeRequest, options?: {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+}) => Promise<OpenRouterAuthCodeExchangeResponse>;
+export declare const createOpenRouterKeyLinks: (key: string, siteUrl?: string) => Promise<{
+    hash: string;
+    logsUrl: string;
+    settingsUrl: string;
+}>;
 /** Verify `X-OpenRouter-Signature` against the exact raw webhook bytes. */
 export declare const verifyOpenRouterWebhookSignature: (options: {
     body: string | Uint8Array;
@@ -205,35 +523,64 @@ export declare const verifyOpenRouterWebhookSignature: (options: {
     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>>;
+    addWorkspaceMembers: (id: string, userIds: readonly string[]) => Promise<{
+        added_count: number;
+        data: OpenRouterWorkspaceMember[];
+    }>;
+    createAuthCode: (body: OpenRouterCreateAuthCodeRequest) => Promise<OpenRouterCreateAuthCodeResponse>;
+    chat: (body: OpenRouterChatRequest) => Promise<OpenRouterChatResponse>;
+    createPresetFromChatCompletions: (slug: string, body: OpenRouterPresetInferenceRequest) => Promise<OpenRouterPresetResponse>;
+    createPresetFromMessages: (slug: string, body: OpenRouterPresetInferenceRequest) => Promise<OpenRouterPresetResponse>;
+    createPresetFromResponses: (slug: string, body: OpenRouterPresetInferenceRequest) => Promise<OpenRouterPresetResponse>;
+    createWorkspace: (body: OpenRouterCreateWorkspaceRequest) => Promise<{
+        data: OpenRouterWorkspace;
+    }>;
+    createBatch: (body: OpenRouterCreateBatchRequest) => Promise<OpenRouterBatch>;
     createEmbedding: (body: OpenRouterEmbeddingRequest) => Promise<OpenRouterEmbeddingResponse>;
     generateImage: (body: OpenRouterImageRequest) => Promise<OpenRouterImageResponse>;
-    deleteFile: (id: string, workspaceId?: string) => Promise<{
+    deleteFile: (id: string, workspaceId?: string | undefined) => Promise<{
         id: string;
         type: "file_deleted";
     }>;
-    downloadFile: (id: string, workspaceId?: string) => Promise<Response>;
+    deleteWorkspace: (id: string) => Promise<{
+        deleted: true;
+    }>;
+    deleteWorkspaceBudget: (id: string, interval: OpenRouterWorkspaceBudgetInterval) => Promise<{
+        deleted: true;
+    }>;
+    downloadFile: (id: string, workspaceId?: string | undefined) => Promise<Response>;
     downloadVideo: (id: string, index?: number) => Promise<Response>;
     generateVideo: (body: OpenRouterVideoRequest) => Promise<OpenRouterVideoJob>;
-    getBatch: (id: string) => Promise<Record<string, unknown>>;
+    getBatch: (id: string) => Promise<OpenRouterBatch>;
+    getActivity: (query?: OpenRouterActivityQuery) => Promise<{
+        data: OpenRouterActivityItem[];
+    }>;
+    getAnalyticsMeta: () => Promise<OpenRouterAnalyticsMeta>;
     getCredits: () => Promise<{
         data: Record<string, number>;
     }>;
     getCurrentKey: () => Promise<{
         data: Record<string, unknown>;
     }>;
-    getFile: (id: string, workspaceId?: string) => Promise<OpenRouterFile>;
+    getFile: (id: string, workspaceId?: string | undefined) => Promise<OpenRouterFile>;
     getGeneration: (id: string) => Promise<{
         data: Record<string, unknown>;
     }>;
+    getGenerationContent: (id: string) => Promise<Record<string, unknown>>;
     getModelEndpoints: (model: string) => Promise<Record<string, unknown>>;
     getModel: (model: string) => Promise<{
         data: OpenRouterModel;
     }>;
     getImageModelEndpoints: (model: string) => Promise<OpenRouterImageModelEndpoints>;
+    getPreset: (slug: string) => Promise<OpenRouterPresetResponse>;
+    getPresetVersion: (slug: string, version: number | string) => Promise<OpenRouterPresetVersionResponse>;
+    getTaskClassifications: (window?: "7d") => Promise<OpenRouterTaskClassifications>;
     getVideo: (id: string) => Promise<OpenRouterVideoJob>;
+    getWorkspace: (id: string) => Promise<{
+        data: OpenRouterWorkspace;
+    }>;
     listImageModels: () => Promise<OpenRouterModelList>;
+    listEmbeddingModels: () => Promise<OpenRouterModelList>;
     listFiles: (query?: {
         cursor?: string;
         limit?: number;
@@ -250,11 +597,11 @@ export declare const createOpenRouterClient: (config: OpenRouterClientConfig) =>
         };
     }>;
     listPresets: (offset?: number, limit?: number) => Promise<{
-        data: Record<string, unknown>[];
+        data: OpenRouterPreset[];
         total_count: number;
     }>;
     listPresetVersions: (slug: string, offset?: number, limit?: number) => Promise<{
-        data: Record<string, unknown>[];
+        data: OpenRouterPresetVersion[];
         total_count: number;
     }>;
     listProviders: () => Promise<{
@@ -262,15 +609,38 @@ export declare const createOpenRouterClient: (config: OpenRouterClientConfig) =>
     }>;
     listRerankModels: () => Promise<OpenRouterModelList>;
     listVideoModels: () => Promise<OpenRouterModelList>;
+    listWorkspaceBudgets: (id: string) => Promise<{
+        data: OpenRouterWorkspaceBudget[];
+    }>;
+    listWorkspaces: (offset?: number, limit?: number) => Promise<{
+        data: OpenRouterWorkspace[];
+        total_count: number;
+    }>;
+    queryAnalytics: (body: OpenRouterAnalyticsQuery) => Promise<OpenRouterAnalyticsResponse>;
+    removeWorkspaceMembers: (id: string, userIds: readonly string[]) => Promise<{
+        data: OpenRouterWorkspaceMember[];
+        removed_count: number;
+    }>;
     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>>;
+    transcribe: (body: OpenRouterTranscriptionRequest | FormData) => Promise<OpenRouterTranscriptionResponse>;
     uploadFile: (file: Blob, options?: {
         filename?: string;
         workspaceId?: string;
     }) => Promise<OpenRouterFile>;
+    updateWorkspace: (id: string, body: OpenRouterWorkspaceOptions) => Promise<{
+        data: OpenRouterWorkspace;
+    }>;
+    upsertWorkspaceBudget: (id: string, interval: OpenRouterWorkspaceBudgetInterval, limitUsd: number) => Promise<{
+        data: OpenRouterWorkspaceBudget;
+    }>;
+    waitForBatch: (id: string, options?: {
+        intervalMs?: number;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }) => Promise<OpenRouterBatch>;
 };

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

@@ -0,0 +1,21 @@
+import { OpenRouter as OfficialOpenRouterSDK, type SDKOptions } from "@openrouter/sdk";
+export type OpenRouterSDKConfig = Omit<SDKOptions, "apiKey" | "appCategories" | "appTitle" | "httpReferer" | "serverURL"> & {
+    apiKey?: string;
+    /** Comma-separated marketplace categories are produced from this list. */
+    appCategories?: readonly string[];
+    appName?: string;
+    appUrl?: string;
+    baseUrl?: string;
+    tokenSource?: () => Promise<string> | string;
+};
+/**
+ * Create OpenRouter's generated SDK with AbsoluteJS-style configuration.
+ *
+ * Use this for the complete REST surface: API keys, BYOK, guardrails,
+ * observability, organizations, SCIM, datasets, benchmarks, and future
+ * OpenAPI-generated additions. Use `openrouter()` for policy-aware inference.
+ */
+export declare const createOpenRouterSDK: (config?: OpenRouterSDKConfig) => OfficialOpenRouterSDK;
+export { OfficialOpenRouterSDK as OpenRouterSDK };
+export type { SDKOptions as OfficialOpenRouterSDKOptions } from "@openrouter/sdk";
+export type { RequestOptions as OpenRouterSDKRequestOptions } from "@openrouter/sdk/lib/sdks.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/ai",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "homepage": "https://github.com/absolutejs/ai",
   "bugs": {
     "url": "https://github.com/absolutejs/ai/issues"
@@ -63,6 +63,10 @@
       "import": "./dist/ai/providers/openrouter.js",
       "types": "./dist/src/ai/providers/openrouter.d.ts"
     },
+    "./openrouter/sdk": {
+      "import": "./dist/ai/providers/openrouterSDK.js",
+      "types": "./dist/src/ai/providers/openrouterSDK.d.ts"
+    },
     "./openai-responses": {
       "import": "./dist/ai/providers/openaiResponses.js",
       "types": "./dist/src/ai/providers/openaiResponses.d.ts"
@@ -85,7 +89,8 @@
     }
   },
   "dependencies": {
-    "@absolutejs/linked-providers": "0.0.2"
+    "@absolutejs/linked-providers": "0.0.2",
+    "@openrouter/sdk": "^1.2.47"
   },
   "peerDependencies": {
     "@absolutejs/isolated-jsc": ">= 0.4.0",
@@ -182,6 +187,9 @@
       "openrouter": [
         "dist/src/ai/providers/openrouter.d.ts"
       ],
+      "openrouter/sdk": [
+        "dist/src/ai/providers/openrouterSDK.d.ts"
+      ],
       "openai-responses": [
         "dist/src/ai/providers/openaiResponses.d.ts"
       ],