@openrouter/ai-sdk-provider 1.4.1 → 1.5.0

package/dist/index.d.mts

@@ -2,6 +2,8 @@ import { LanguageModelV2, LanguageModelV2CallOptions, LanguageModelV2Content, La
 export { LanguageModelV2, LanguageModelV2Prompt } from '@ai-sdk/provider';
 import * as models from '@openrouter/sdk/models';
 import { z } from 'zod/v4';
+import { EncodeOptions, DecodeOptions, JsonValue } from '@toon-format/toon';
+export { DecodeOptions, EncodeOptions, JsonValue } from '@toon-format/toon';
 
 type OpenRouterChatModelId = string;
 type OpenRouterChatSettings = {
@@ -549,4 +551,84 @@ declare class OpenRouter {
     embedding(modelId: OpenRouterEmbeddingModelId, settings?: OpenRouterEmbeddingSettings): OpenRouterEmbeddingModel;
 }
 
-export { OpenRouter, type OpenRouterCompletionSettings, type OpenRouterEmbeddingModelId, type OpenRouterEmbeddingSettings, type OpenRouterProvider, type OpenRouterProviderOptions, type OpenRouterProviderSettings, type OpenRouterSharedSettings, type OpenRouterUsageAccounting, createOpenRouter, openrouter };
+/**
+ * TOON (Token-Oriented Object Notation) helper utilities for token-efficient
+ * data encoding in LLM prompts.
+ *
+ * TOON achieves ~40% token reduction vs JSON for tabular data while maintaining
+ * high LLM comprehension accuracy.
+ *
+ * @see https://toonformat.dev
+ * @see https://github.com/toon-format/toon
+ *
+ * @example
+ * ```ts
+ * import { encodeToon, decodeToon } from '@openrouter/ai-sdk-provider';
+ *
+ * // Encode data to TOON format
+ * const toon = await encodeToon([
+ *   { id: 1, name: 'Alice', score: 95 },
+ *   { id: 2, name: 'Bob', score: 87 },
+ * ]);
+ * // Result: [2]{id,name,score}: 1,Alice,95 2,Bob,87
+ *
+ * // Decode TOON back to JSON
+ * const data = await decodeToon(toon);
+ * ```
+ */
+
+type ToonEncodeOptions = EncodeOptions;
+type ToonDecodeOptions = DecodeOptions;
+/**
+ * Encodes a JavaScript value into TOON format string.
+ *
+ * TOON is particularly efficient for uniform arrays of objects (tabular data),
+ * achieving CSV-like compactness while preserving explicit structure.
+ *
+ * @param value - Any JavaScript value (objects, arrays, primitives)
+ * @param options - Optional encoding configuration
+ * @returns Promise resolving to TOON formatted string
+ *
+ * @example
+ * ```ts
+ * // Simple object
+ * await encodeToon({ name: 'Alice', age: 30 });
+ * // name: Alice
+ * // age: 30
+ *
+ * // Tabular array (most efficient)
+ * await encodeToon([
+ *   { id: 1, name: 'Alice' },
+ *   { id: 2, name: 'Bob' },
+ * ]);
+ * // [2]{id,name}: 1,Alice 2,Bob
+ *
+ * // With options
+ * await encodeToon(data, { indent: 4, keyFolding: 'safe' });
+ * ```
+ */
+declare function encodeToon(value: unknown, options?: ToonEncodeOptions): Promise<string>;
+/**
+ * Decodes a TOON format string into a JavaScript value.
+ *
+ * @param input - TOON formatted string
+ * @param options - Optional decoding configuration
+ * @returns Promise resolving to parsed JavaScript value
+ *
+ * @example
+ * ```ts
+ * // Decode simple object
+ * await decodeToon('name: Alice\nage: 30');
+ * // { name: 'Alice', age: 30 }
+ *
+ * // Decode tabular array
+ * await decodeToon('[2]{id,name}: 1,Alice 2,Bob');
+ * // [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
+ *
+ * // With options
+ * await decodeToon(toonString, { strict: false, expandPaths: 'safe' });
+ * ```
+ */
+declare function decodeToon(input: string, options?: ToonDecodeOptions): Promise<JsonValue>;
+
+export { OpenRouter, type OpenRouterChatSettings, type OpenRouterCompletionSettings, type OpenRouterEmbeddingModelId, type OpenRouterEmbeddingSettings, type OpenRouterProvider, type OpenRouterProviderOptions, type OpenRouterProviderSettings, type OpenRouterSharedSettings, type OpenRouterUsageAccounting, type ToonDecodeOptions, type ToonEncodeOptions, createOpenRouter, decodeToon, encodeToon, openrouter };

package/dist/index.d.ts

@@ -2,6 +2,8 @@ import { LanguageModelV2, LanguageModelV2CallOptions, LanguageModelV2Content, La
 export { LanguageModelV2, LanguageModelV2Prompt } from '@ai-sdk/provider';
 import * as models from '@openrouter/sdk/models';
 import { z } from 'zod/v4';
+import { EncodeOptions, DecodeOptions, JsonValue } from '@toon-format/toon';
+export { DecodeOptions, EncodeOptions, JsonValue } from '@toon-format/toon';
 
 type OpenRouterChatModelId = string;
 type OpenRouterChatSettings = {
@@ -549,4 +551,84 @@ declare class OpenRouter {
     embedding(modelId: OpenRouterEmbeddingModelId, settings?: OpenRouterEmbeddingSettings): OpenRouterEmbeddingModel;
 }
 
-export { OpenRouter, type OpenRouterCompletionSettings, type OpenRouterEmbeddingModelId, type OpenRouterEmbeddingSettings, type OpenRouterProvider, type OpenRouterProviderOptions, type OpenRouterProviderSettings, type OpenRouterSharedSettings, type OpenRouterUsageAccounting, createOpenRouter, openrouter };
+/**
+ * TOON (Token-Oriented Object Notation) helper utilities for token-efficient
+ * data encoding in LLM prompts.
+ *
+ * TOON achieves ~40% token reduction vs JSON for tabular data while maintaining
+ * high LLM comprehension accuracy.
+ *
+ * @see https://toonformat.dev
+ * @see https://github.com/toon-format/toon
+ *
+ * @example
+ * ```ts
+ * import { encodeToon, decodeToon } from '@openrouter/ai-sdk-provider';
+ *
+ * // Encode data to TOON format
+ * const toon = await encodeToon([
+ *   { id: 1, name: 'Alice', score: 95 },
+ *   { id: 2, name: 'Bob', score: 87 },
+ * ]);
+ * // Result: [2]{id,name,score}: 1,Alice,95 2,Bob,87
+ *
+ * // Decode TOON back to JSON
+ * const data = await decodeToon(toon);
+ * ```
+ */
+
+type ToonEncodeOptions = EncodeOptions;
+type ToonDecodeOptions = DecodeOptions;
+/**
+ * Encodes a JavaScript value into TOON format string.
+ *
+ * TOON is particularly efficient for uniform arrays of objects (tabular data),
+ * achieving CSV-like compactness while preserving explicit structure.
+ *
+ * @param value - Any JavaScript value (objects, arrays, primitives)
+ * @param options - Optional encoding configuration
+ * @returns Promise resolving to TOON formatted string
+ *
+ * @example
+ * ```ts
+ * // Simple object
+ * await encodeToon({ name: 'Alice', age: 30 });
+ * // name: Alice
+ * // age: 30
+ *
+ * // Tabular array (most efficient)
+ * await encodeToon([
+ *   { id: 1, name: 'Alice' },
+ *   { id: 2, name: 'Bob' },
+ * ]);
+ * // [2]{id,name}: 1,Alice 2,Bob
+ *
+ * // With options
+ * await encodeToon(data, { indent: 4, keyFolding: 'safe' });
+ * ```
+ */
+declare function encodeToon(value: unknown, options?: ToonEncodeOptions): Promise<string>;
+/**
+ * Decodes a TOON format string into a JavaScript value.
+ *
+ * @param input - TOON formatted string
+ * @param options - Optional decoding configuration
+ * @returns Promise resolving to parsed JavaScript value
+ *
+ * @example
+ * ```ts
+ * // Decode simple object
+ * await decodeToon('name: Alice\nage: 30');
+ * // { name: 'Alice', age: 30 }
+ *
+ * // Decode tabular array
+ * await decodeToon('[2]{id,name}: 1,Alice 2,Bob');
+ * // [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
+ *
+ * // With options
+ * await decodeToon(toonString, { strict: false, expandPaths: 'safe' });
+ * ```
+ */
+declare function decodeToon(input: string, options?: ToonDecodeOptions): Promise<JsonValue>;
+
+export { OpenRouter, type OpenRouterChatSettings, type OpenRouterCompletionSettings, type OpenRouterEmbeddingModelId, type OpenRouterEmbeddingSettings, type OpenRouterProvider, type OpenRouterProviderOptions, type OpenRouterProviderSettings, type OpenRouterSharedSettings, type OpenRouterUsageAccounting, type ToonDecodeOptions, type ToonEncodeOptions, createOpenRouter, decodeToon, encodeToon, openrouter };

package/dist/index.js

@@ -49,6 +49,8 @@ var index_exports = {};
 __export(index_exports, {
   OpenRouter: () => OpenRouter,
   createOpenRouter: () => createOpenRouter,
+  decodeToon: () => decodeToon,
+  encodeToon: () => encodeToon,
   openrouter: () => openrouter
 });
 module.exports = __toCommonJS(index_exports);
@@ -1071,6 +1073,19 @@ function mapOpenRouterFinishReason(finishReason) {
   }
 }
 
+// src/types/openrouter-chat-completions-input.ts
+var OPENROUTER_AUDIO_FORMATS = [
+  "wav",
+  "mp3",
+  "aiff",
+  "aac",
+  "ogg",
+  "flac",
+  "m4a",
+  "pcm16",
+  "pcm24"
+];
+
 // src/chat/is-url.ts
 function isUrl({
   url,
@@ -1112,6 +1127,34 @@ function getBase64FromDataUrl(dataUrl) {
   const match = dataUrl.match(/^data:[^;]*;base64,(.+)$/);
   return match ? match[1] : dataUrl;
 }
+var MIME_TO_FORMAT = {
+  // MP3 variants
+  mpeg: "mp3",
+  mp3: "mp3",
+  // WAV variants
+  "x-wav": "wav",
+  wave: "wav",
+  wav: "wav",
+  // OGG variants
+  ogg: "ogg",
+  vorbis: "ogg",
+  // AAC variants
+  aac: "aac",
+  "x-aac": "aac",
+  // M4A variants
+  m4a: "m4a",
+  "x-m4a": "m4a",
+  mp4: "m4a",
+  // AIFF variants
+  aiff: "aiff",
+  "x-aiff": "aiff",
+  // FLAC
+  flac: "flac",
+  "x-flac": "flac",
+  // PCM variants
+  pcm16: "pcm16",
+  pcm24: "pcm24"
+};
 function getInputAudioData(part) {
   const fileData = getFileUrl({
     part,
@@ -1136,19 +1179,14 @@ Learn more: https://openrouter.ai/docs/features/multimodal/audio`
   }
   const data = getBase64FromDataUrl(fileData);
   const mediaType = part.mediaType || "audio/mpeg";
-  let format = mediaType.replace("audio/", "");
-  if (format === "mpeg" || format === "mp3") {
-    format = "mp3";
-  } else if (format === "x-wav" || format === "wave" || format === "wav") {
-    format = "wav";
-  }
-  if (format !== "mp3" && format !== "wav") {
+  const rawFormat = mediaType.replace("audio/", "");
+  const format = MIME_TO_FORMAT[rawFormat];
+  if (format === void 0) {
+    const supportedList = OPENROUTER_AUDIO_FORMATS.join(", ");
     throw new Error(
       `Unsupported audio format: "${mediaType}"
 
-OpenRouter only supports MP3 and WAV audio formats.
-\u2022 For MP3: use "audio/mpeg" or "audio/mp3"
-\u2022 For WAV: use "audio/wav" or "audio/x-wav"
+OpenRouter supports the following audio formats: ${supportedList}
 
 Learn more: https://openrouter.ai/docs/features/multimodal/audio`
     );
@@ -2819,7 +2857,7 @@ function withUserAgentSuffix(headers, ...userAgentSuffixParts) {
 }
 
 // src/version.ts
-var VERSION = false ? "0.0.0-test" : "1.4.1";
+var VERSION = false ? "0.0.0-test" : "1.5.0";
 
 // src/provider.ts
 function createOpenRouter(options = {}) {
@@ -2887,10 +2925,31 @@ var openrouter = createOpenRouter({
   compatibility: "strict"
   // strict for OpenRouter API
 });
+
+// src/toon/index.ts
+async function getToonModule() {
+  try {
+    return await import("@toon-format/toon");
+  } catch (e) {
+    throw new Error(
+      "The @toon-format/toon package is required for TOON encoding/decoding. Install it with: npm install @toon-format/toon"
+    );
+  }
+}
+async function encodeToon(value, options) {
+  const toon = await getToonModule();
+  return toon.encode(value, options);
+}
+async function decodeToon(input, options) {
+  const toon = await getToonModule();
+  return toon.decode(input, options);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   OpenRouter,
   createOpenRouter,
+  decodeToon,
+  encodeToon,
   openrouter
 });
 //# sourceMappingURL=index.js.map