@stabgan/openrouter-mcp-multimodal 4.6.2 → 4.8.0

package/dist/openrouter-api.d.ts

@@ -1,13 +1,6 @@
 import type { OpenRouterModelRecord } from './model-cache.js';
 declare function parseRetryAfter(headerValue: string | null): number | null;
 declare function backoffWithJitter(attempt: number, retryAfterMs: number | null): number;
-/**
- * fetch() wrapper with retries on 429 / 5xx / network error.
- *
- * A fresh `AbortSignal.timeout(timeoutMs)` is created per attempt so retries
- * each get a full timeout budget. Backoff honors `Retry-After` (seconds or
- * HTTP-date) and applies jitter to avoid thundering-herd synchronization.
- */
 declare function fetchWithRetry(url: string, init: Omit<RequestInit, 'signal'>, { retries, timeoutMs }?: {
     retries?: number;
     timeoutMs?: number;
@@ -17,25 +10,25 @@ export declare class OpenRouterAPIClient {
     constructor(apiKey: string);
     private authHeaders;
     getModels(): Promise<OpenRouterModelRecord[]>;
-    /** Submit a video-generation job. Returns the `{ id, polling_url, status }` envelope. */
+    /** Submit a video-generation job. */
     submitVideoJob(body: Record<string, unknown>): Promise<VideoJobEnvelope>;
-    /** Poll a submitted video-generation job by id. */
+    /** Poll a submitted video-generation job. */
     pollVideoJob(id: string): Promise<VideoJobStatus>;
-    /** Download generated video binary (trusted OpenRouter origin). */
+    /** Download generated video binary. */
     downloadVideoContent(id: string, index?: number, maxBytes?: number): Promise<{
         buffer: Buffer;
         contentType: string | null;
     }>;
-    /** POST /images — dedicated image generation. */
+    /** POST /images. */
     generateImage(body: Record<string, unknown>, headers?: Record<string, string>): Promise<ImageGenerationResponse>;
-    /** POST /audio/speech — text-to-speech. */
+    /** POST /audio/speech. */
     generateSpeech(body: Record<string, unknown>, headers?: Record<string, string>): Promise<{
         buffer: Buffer;
         contentType: string;
     }>;
-    /** POST /audio/transcriptions — speech-to-text. */
+    /** POST /audio/transcriptions. */
     transcribeAudio(body: Record<string, unknown>, headers?: Record<string, string>): Promise<TranscriptionResponse>;
-    /** POST /rerank — re-order documents by relevance to a query. */
+    /** POST /rerank. */
     rerank(params: {
         model: string;
         query: string;
@@ -90,7 +83,7 @@ export interface RerankResponse {
     usage?: Record<string, unknown>;
     [key: string]: unknown;
 }
-export type VideoJobStatusName = 'pending' | 'queued' | 'processing' | 'completed' | 'failed';
+export type VideoJobStatusName = 'pending' | 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'canceled';
 export interface VideoJobStatus {
     id: string;
     status: VideoJobStatusName | string;
@@ -103,9 +96,15 @@ export interface VideoJobStatus {
     progress?: number;
     [key: string]: unknown;
 }
+declare function extractEmbeddedError(data: unknown): string | undefined;
+declare function readTranscriptionResponse(res: Response, responseFormat: unknown, context: string): Promise<TranscriptionResponse>;
+declare function readJsonOrThrow<T>(res: Response, context: string): Promise<T>;
 export declare const _internals: {
     parseRetryAfter: typeof parseRetryAfter;
     backoffWithJitter: typeof backoffWithJitter;
     fetchWithRetry: typeof fetchWithRetry;
+    extractEmbeddedError: typeof extractEmbeddedError;
+    readJsonOrThrow: typeof readJsonOrThrow;
+    readTranscriptionResponse: typeof readTranscriptionResponse;
 };
 export {};

package/dist/openrouter-api.js

@@ -24,13 +24,6 @@ function backoffWithJitter(attempt, retryAfterMs) {
     const jitter = 0.5 + Math.random(); // 0.5x .. 1.5x
     return Math.round(target * jitter);
 }
-/**
- * fetch() wrapper with retries on 429 / 5xx / network error.
- *
- * A fresh `AbortSignal.timeout(timeoutMs)` is created per attempt so retries
- * each get a full timeout budget. Backoff honors `Retry-After` (seconds or
- * HTTP-date) and applies jitter to avoid thundering-herd synchronization.
- */
 async function fetchWithRetry(url, init, { retries = 2, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
     let lastErr;
     for (let attempt = 0; attempt <= retries; attempt++) {
@@ -77,10 +70,10 @@ export class OpenRouterAPIClient {
         const res = await fetchWithRetry(`${BASE_URL}/models`, { headers: this.authHeaders() }, { retries: 2, timeoutMs: DEFAULT_TIMEOUT_MS });
         if (!res.ok)
             throw new Error(`Failed to fetch models: HTTP ${res.status}`);
-        const data = (await res.json());
+        const data = await readJsonOrThrow(res, 'GET /models');
         return data.data ?? [];
     }
-    /** Submit a video-generation job. Returns the `{ id, polling_url, status }` envelope. */
+    /** Submit a video-generation job. */
     async submitVideoJob(body) {
         const res = await fetchWithRetry(`${BASE_URL}/videos`, {
             method: 'POST',
@@ -91,18 +84,18 @@ export class OpenRouterAPIClient {
             const detail = await safeReadText(res);
             throw new Error(`POST /videos failed: HTTP ${res.status}${detail ? ` — ${detail}` : ''}`);
         }
-        return (await res.json());
+        return readJsonOrThrow(res, 'POST /videos');
     }
-    /** Poll a submitted video-generation job by id. */
+    /** Poll a submitted video-generation job. */
     async pollVideoJob(id) {
         const res = await fetchWithRetry(`${BASE_URL}/videos/${encodeURIComponent(id)}`, { headers: this.authHeaders() }, { retries: 2, timeoutMs: DEFAULT_TIMEOUT_MS });
         if (!res.ok) {
             const detail = await safeReadText(res);
             throw new Error(`GET /videos/${id} failed: HTTP ${res.status}${detail ? ` — ${detail}` : ''}`);
         }
-        return (await res.json());
+        return readJsonOrThrow(res, `GET /videos/${id}`);
     }
-    /** Download generated video binary (trusted OpenRouter origin). */
+    /** Download generated video binary. */
     async downloadVideoContent(id, index = 0, maxBytes = 256 * 1024 * 1024) {
         const url = `${BASE_URL}/videos/${encodeURIComponent(id)}/content?index=${index}`;
         const res = await fetchWithRetry(url, { headers: this.authHeaders() }, { retries: 1, timeoutMs: VIDEO_TIMEOUT_MS * 2 });
@@ -144,7 +137,7 @@ export class OpenRouterAPIClient {
         }
         return { buffer: Buffer.concat(chunks), contentType: res.headers.get('content-type') };
     }
-    /** POST /images — dedicated image generation. */
+    /** POST /images. */
     async generateImage(body, headers) {
         const res = await fetchWithRetry(`${BASE_URL}/images`, {
             method: 'POST',
@@ -155,9 +148,9 @@ export class OpenRouterAPIClient {
             const detail = await safeReadText(res);
             throw new Error(`POST /images failed: HTTP ${res.status}${detail ? ` — ${detail}` : ''}`);
         }
-        return (await res.json());
+        return readJsonOrThrow(res, 'POST /images');
     }
-    /** POST /audio/speech — text-to-speech. */
+    /** POST /audio/speech. */
     async generateSpeech(body, headers) {
         const res = await fetchWithRetry(`${BASE_URL}/audio/speech`, {
             method: 'POST',
@@ -172,7 +165,7 @@ export class OpenRouterAPIClient {
         const buf = Buffer.from(await res.arrayBuffer());
         return { buffer: buf, contentType };
     }
-    /** POST /audio/transcriptions — speech-to-text. */
+    /** POST /audio/transcriptions. */
     async transcribeAudio(body, headers) {
         const res = await fetchWithRetry(`${BASE_URL}/audio/transcriptions`, {
             method: 'POST',
@@ -183,9 +176,9 @@ export class OpenRouterAPIClient {
             const detail = await safeReadText(res);
             throw new Error(`POST /audio/transcriptions failed: HTTP ${res.status}${detail ? ` — ${detail}` : ''}`);
         }
-        return (await res.json());
+        return readTranscriptionResponse(res, body.response_format, 'POST /audio/transcriptions');
     }
-    /** POST /rerank — re-order documents by relevance to a query. */
+    /** POST /rerank. */
     async rerank(params) {
         const body = {
             model: params.model,
@@ -203,7 +196,7 @@ export class OpenRouterAPIClient {
             const detail = await safeReadText(res);
             throw new Error(`POST /rerank failed: HTTP ${res.status}${detail ? ` — ${detail}` : ''}`);
         }
-        return (await res.json());
+        return readJsonOrThrow(res, 'POST /rerank');
     }
 }
 async function safeReadText(res) {
@@ -215,5 +208,58 @@ async function safeReadText(res) {
         return '';
     }
 }
-// Exported for tests.
-export const _internals = { parseRetryAfter, backoffWithJitter, fetchWithRetry };
+function extractEmbeddedError(data) {
+    if (!data || typeof data !== 'object')
+        return undefined;
+    const record = data;
+    if (record.type === 'error') {
+        const err = record.error;
+        if (typeof err === 'string')
+            return err;
+        if (err &&
+            typeof err === 'object' &&
+            typeof err.message === 'string') {
+            return err.message;
+        }
+    }
+    if (record.error && typeof record.error === 'object') {
+        const err = record.error;
+        if (typeof err.message === 'string')
+            return err.message;
+    }
+    return undefined;
+}
+async function readTranscriptionResponse(res, responseFormat, context) {
+    const format = typeof responseFormat === 'string' ? responseFormat : 'json';
+    const contentType = res.headers.get('content-type') ?? '';
+    const plainByFormat = format === 'text' || format === 'srt' || format === 'vtt';
+    const plainByContentType = contentType.startsWith('text/') && format !== 'json' && format !== 'verbose_json';
+    if (plainByFormat || plainByContentType) {
+        const text = await res.text();
+        return { text };
+    }
+    return readJsonOrThrow(res, context);
+}
+async function readJsonOrThrow(res, context) {
+    const raw = await res.text();
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        const detail = raw.length > 500 ? raw.slice(0, 500) + '…' : raw;
+        throw new Error(`${context}: non-JSON response${detail ? ` — ${detail}` : ''}`);
+    }
+    const embedded = extractEmbeddedError(data);
+    if (embedded)
+        throw new Error(`${context}: ${embedded}`);
+    return data;
+}
+export const _internals = {
+    parseRetryAfter,
+    backoffWithJitter,
+    fetchWithRetry,
+    extractEmbeddedError,
+    readJsonOrThrow,
+    readTranscriptionResponse,
+};

package/dist/openrouter-openai-client.d.ts

@@ -0,0 +1,9 @@
+import OpenAI from 'openai';
+declare const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+declare const OPENROUTER_ATTRIBUTION_HEADERS: {
+    readonly 'HTTP-Referer': "https://github.com/stabgan/openrouter-mcp-multimodal";
+    readonly 'X-Title': "openrouter-mcp-multimodal";
+};
+/** OpenAI SDK client configured for OpenRouter chat/completions endpoints. */
+export declare function createOpenRouterOpenAIClient(apiKey: string): OpenAI;
+export { OPENROUTER_BASE_URL, OPENROUTER_ATTRIBUTION_HEADERS };

package/dist/openrouter-openai-client.js

@@ -0,0 +1,15 @@
+import OpenAI from 'openai';
+const OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
+const OPENROUTER_ATTRIBUTION_HEADERS = {
+    'HTTP-Referer': 'https://github.com/stabgan/openrouter-mcp-multimodal',
+    'X-Title': 'openrouter-mcp-multimodal',
+};
+/** OpenAI SDK client configured for OpenRouter chat/completions endpoints. */
+export function createOpenRouterOpenAIClient(apiKey) {
+    return new OpenAI({
+        apiKey,
+        baseURL: OPENROUTER_BASE_URL,
+        defaultHeaders: { ...OPENROUTER_ATTRIBUTION_HEADERS },
+    });
+}
+export { OPENROUTER_BASE_URL, OPENROUTER_ATTRIBUTION_HEADERS };

package/dist/tool-definitions.d.ts

@@ -1 +1,25 @@
+/** Aspect ratios accepted by generate_image and generate_image_dedicated handlers. */
+export declare const IMAGE_ASPECT_RATIOS: readonly ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9", "1:4", "4:1", "1:8", "8:1"];
+export declare const IMAGE_SIZES: readonly ["0.5K", "1K", "2K", "4K"];
+export declare const IMAGE_DEDICATED_RESOLUTIONS: readonly ["512", "0.5K", "1K", "2K", "4K"];
+export declare const IMAGE_DEDICATED_QUALITIES: readonly ["auto", "low", "medium", "high"];
+export declare const IMAGE_OUTPUT_FORMATS: readonly ["png", "jpeg", "webp", "svg"];
+/** generate_audio handler VALID_FORMATS */
+export declare const GENERATE_AUDIO_FORMATS: readonly ["wav", "mp3", "flac", "opus", "pcm16"];
+/** text_to_speech handler VALID_FORMATS */
+export declare const TTS_RESPONSE_FORMATS: readonly ["mp3", "opus", "aac", "flac", "wav", "pcm"];
+/** speech_to_text handler VALID_RESPONSE_FORMATS */
+export declare const STT_RESPONSE_FORMATS: readonly ["json", "text", "srt", "verbose_json", "vtt"];
+export declare const CHAT_MESSAGE_ROLES: readonly ["system", "user", "assistant"];
+export declare const PROVIDER_SORT_VALUES: readonly ["price", "throughput", "latency"];
+export declare const PROVIDER_DATA_COLLECTION: readonly ["allow", "deny"];
+/** Tools whose handlers accept save_path (binary artifact output). */
+export declare const TOOLS_WITH_SAVE_PATH: readonly ["generate_image", "generate_image_dedicated", "generate_audio", "text_to_speech", "generate_video", "generate_video_from_image", "get_video_status"];
+/** Shared save_path fragment for binary-output tools. */
+export declare const SAVE_PATH_PROPERTY: {
+    readonly type: "string";
+    readonly description: string;
+};
 export declare const TOOL_DEFINITIONS: Array<Record<string, unknown>>;
+/** Tool names from definitions — must match TOOL_NAMES in tool-descriptions.ts. */
+export declare const TOOL_DEFINITION_NAMES: unknown[];