@openrouter/sdk 0.12.25 → 0.12.27

package/esm/funcs/sttCreateTranscription.d.ts

@@ -13,7 +13,7 @@ import { Result } from "../types/fp.js";
  * Create transcription
  *
  * @remarks
- * Transcribes audio into text
+ * Transcribes audio into text. Accepts base64-encoded audio input and returns the transcribed text.
  */
 export declare function sttCreateTranscription(client: OpenRouterCore, request: operations.CreateAudioTranscriptionsRequest, options?: RequestOptions): APIPromise<Result<models.STTResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=sttCreateTranscription.d.ts.map

package/esm/funcs/sttCreateTranscription.js

@@ -16,7 +16,7 @@ import { APIPromise } from "../types/async.js";
  * Create transcription
  *
  * @remarks
- * Transcribes audio into text
+ * Transcribes audio into text. Accepts base64-encoded audio input and returns the transcribed text.
  */
 export function sttCreateTranscription(client, request, options) {
     return new APIPromise($do(client, request, options));

package/esm/funcs/ttsCreateSpeech.d.ts

@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
  * Create speech
  *
  * @remarks
- * Synthesizes audio from the input text
+ * Synthesizes audio from the input text. Returns a raw audio bytestream in the requested format (e.g. mp3, pcm, wav).
  */
 export declare function ttsCreateSpeech(client: OpenRouterCore, request: operations.CreateAudioSpeechRequest, options?: RequestOptions): APIPromise<Result<ReadableStream<Uint8Array>, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=ttsCreateSpeech.d.ts.map

package/esm/funcs/ttsCreateSpeech.js

@@ -16,7 +16,7 @@ import { APIPromise } from "../types/async.js";
  * Create speech
  *
  * @remarks
- * Synthesizes audio from the input text
+ * Synthesizes audio from the input text. Returns a raw audio bytestream in the requested format (e.g. mp3, pcm, wav).
  */
 export function ttsCreateSpeech(client, request, options) {
     return new APIPromise($do(client, request, options));

package/esm/lib/config.d.ts

@@ -49,8 +49,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "0.12.25";
+    readonly sdkVersion: "0.12.27";
     readonly genVersion: "2.879.1";
-    readonly userAgent: "speakeasy-sdk/typescript 0.12.25 2.879.1 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.12.27 2.879.1 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -26,8 +26,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "0.12.25",
+    sdkVersion: "0.12.27",
     genVersion: "2.879.1",
-    userAgent: "speakeasy-sdk/typescript 0.12.25 2.879.1 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 0.12.27 2.879.1 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/chatwebsearchshorthand.d.ts

@@ -16,7 +16,7 @@ export type ChatWebSearchShorthandType = OpenEnum<typeof ChatWebSearchShorthandT
  */
 export type ChatWebSearchShorthand = {
     /**
-     * Limit search results to these domains. Supported by Exa, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Firecrawl or Perplexity.
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains.
      */
     allowedDomains?: Array<string> | undefined;
     /**
@@ -24,7 +24,7 @@ export type ChatWebSearchShorthand = {
      */
     engine?: WebSearchEngineEnum | undefined;
     /**
-     * Exclude search results from these domains. Supported by Exa, Parallel, Anthropic, and xAI. Not supported with Firecrawl, OpenAI (silently ignored), or Perplexity.
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains.
      */
     excludedDomains?: Array<string> | undefined;
     /**

package/esm/models/index.d.ts

@@ -290,6 +290,7 @@ export * from "./websearchengine.js";
 export * from "./websearchengineenum.js";
 export * from "./websearchplugin.js";
 export * from "./websearchservertool.js";
+export * from "./websearchservertoolconfig.js";
 export * from "./websearchservertoolopenrouter.js";
 export * from "./websearchsource.js";
 export * from "./websearchstatus.js";

package/esm/models/index.js

@@ -294,6 +294,7 @@ export * from "./websearchengine.js";
 export * from "./websearchengineenum.js";
 export * from "./websearchplugin.js";
 export * from "./websearchservertool.js";
+export * from "./websearchservertoolconfig.js";
 export * from "./websearchservertoolopenrouter.js";
 export * from "./websearchsource.js";
 export * from "./websearchstatus.js";

package/esm/models/model.d.ts

@@ -72,6 +72,10 @@ export type Model = {
      * List of supported parameters for this model
      */
     supportedParameters: Array<Parameter>;
+    /**
+     * List of supported voice identifiers for TTS models. Null for non-TTS models.
+     */
+    supportedVoices: Array<string> | null;
     /**
      * Information about the top provider for this model
      */

package/esm/models/model.js

@@ -29,6 +29,7 @@ export const Model$inboundSchema = z.object({
     per_request_limits: z.nullable(PerRequestLimits$inboundSchema),
     pricing: PublicPricing$inboundSchema,
     supported_parameters: z.array(Parameter$inboundSchema),
+    supported_voices: z.nullable(z.array(z.string())),
     top_provider: TopProviderInfo$inboundSchema,
 }).transform((v) => {
     return remap$(v, {
@@ -40,6 +41,7 @@ export const Model$inboundSchema = z.object({
         "knowledge_cutoff": "knowledgeCutoff",
         "per_request_limits": "perRequestLimits",
         "supported_parameters": "supportedParameters",
+        "supported_voices": "supportedVoices",
         "top_provider": "topProvider",
     });
 });

package/esm/models/websearchconfig.d.ts

@@ -4,7 +4,7 @@ import { WebSearchEngineEnum } from "./websearchengineenum.js";
 import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
 export type WebSearchConfig = {
     /**
-     * Limit search results to these domains. Supported by Exa, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Firecrawl or Perplexity.
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains.
      */
     allowedDomains?: Array<string> | undefined;
     /**
@@ -12,7 +12,7 @@ export type WebSearchConfig = {
      */
     engine?: WebSearchEngineEnum | undefined;
     /**
-     * Exclude search results from these domains. Supported by Exa, Parallel, Anthropic, and xAI. Not supported with Firecrawl, OpenAI (silently ignored), or Perplexity.
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains.
      */
     excludedDomains?: Array<string> | undefined;
     /**

package/esm/models/websearchservertoolconfig.d.ts

@@ -0,0 +1,51 @@
+import * as z from "zod/v4";
+import { SearchQualityLevel } from "./searchqualitylevel.js";
+import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
+/**
+ * Configuration for the openrouter:web_search server tool
+ */
+export type WebSearchServerToolConfig = {
+    /**
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains.
+     */
+    allowedDomains?: Array<string> | undefined;
+    /**
+     * Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires BYOK). "parallel" uses the Parallel search API.
+     */
+    engine?: WebSearchEngineEnum | undefined;
+    /**
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains.
+     */
+    excludedDomains?: Array<string> | undefined;
+    /**
+     * Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and Parallel engines; ignored with native provider search.
+     */
+    maxResults?: number | undefined;
+    /**
+     * Maximum total number of search results across all search calls in a single request. Once this limit is reached, the tool will stop returning new results. Useful for controlling cost and context size in agentic loops.
+     */
+    maxTotalResults?: number | undefined;
+    /**
+     * How much context to retrieve per result. Defaults to medium (15000 chars). Applies to Exa and Parallel engines; ignored with native provider search and Firecrawl.
+     */
+    searchContextSize?: SearchQualityLevel | undefined;
+    /**
+     * Approximate user location for location-biased results.
+     */
+    userLocation?: WebSearchUserLocationServerTool | undefined;
+};
+/** @internal */
+export type WebSearchServerToolConfig$Outbound = {
+    allowed_domains?: Array<string> | undefined;
+    engine?: string | undefined;
+    excluded_domains?: Array<string> | undefined;
+    max_results?: number | undefined;
+    max_total_results?: number | undefined;
+    search_context_size?: string | undefined;
+    user_location?: WebSearchUserLocationServerTool$Outbound | undefined;
+};
+/** @internal */
+export declare const WebSearchServerToolConfig$outboundSchema: z.ZodType<WebSearchServerToolConfig$Outbound, WebSearchServerToolConfig>;
+export declare function webSearchServerToolConfigToJSON(webSearchServerToolConfig: WebSearchServerToolConfig): string;
+//# sourceMappingURL=websearchservertoolconfig.d.ts.map

package/esm/models/websearchservertoolconfig.js

@@ -0,0 +1,32 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 900e829383d7
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { SearchQualityLevel$outboundSchema, } from "./searchqualitylevel.js";
+import { WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchUserLocationServerTool$outboundSchema, } from "./websearchuserlocationservertool.js";
+/** @internal */
+export const WebSearchServerToolConfig$outboundSchema = z.object({
+    allowedDomains: z.array(z.string()).optional(),
+    engine: WebSearchEngineEnum$outboundSchema.optional(),
+    excludedDomains: z.array(z.string()).optional(),
+    maxResults: z.int().optional(),
+    maxTotalResults: z.int().optional(),
+    searchContextSize: SearchQualityLevel$outboundSchema.optional(),
+    userLocation: WebSearchUserLocationServerTool$outboundSchema.optional(),
+}).transform((v) => {
+    return remap$(v, {
+        allowedDomains: "allowed_domains",
+        excludedDomains: "excluded_domains",
+        maxResults: "max_results",
+        maxTotalResults: "max_total_results",
+        searchContextSize: "search_context_size",
+        userLocation: "user_location",
+    });
+});
+export function webSearchServerToolConfigToJSON(webSearchServerToolConfig) {
+    return JSON.stringify(WebSearchServerToolConfig$outboundSchema.parse(webSearchServerToolConfig));
+}
+//# sourceMappingURL=websearchservertoolconfig.js.map

package/esm/models/websearchservertoolopenrouter.d.ts

@@ -1,32 +1,18 @@
 import * as z from "zod/v4";
-export type ParametersT = {
-    /**
-     * Maximum number of search results to return per search call. Defaults to 5.
-     */
-    maxResults?: number | undefined;
-    /**
-     * Maximum total number of search results across all search calls in a single request. Once this limit is reached, the tool will stop returning new results.
-     */
-    maxTotalResults?: number | undefined;
-};
+import { WebSearchServerToolConfig, WebSearchServerToolConfig$Outbound } from "./websearchservertoolconfig.js";
 /**
  * OpenRouter built-in server tool: searches the web for current information
  */
 export type WebSearchServerToolOpenRouter = {
-    parameters?: ParametersT | undefined;
+    /**
+     * Configuration for the openrouter:web_search server tool
+     */
+    parameters?: WebSearchServerToolConfig | undefined;
     type: "openrouter:web_search";
 };
 /** @internal */
-export type ParametersT$Outbound = {
-    max_results?: number | undefined;
-    max_total_results?: number | undefined;
-};
-/** @internal */
-export declare const ParametersT$outboundSchema: z.ZodType<ParametersT$Outbound, ParametersT>;
-export declare function parametersToJSON(parametersT: ParametersT): string;
-/** @internal */
 export type WebSearchServerToolOpenRouter$Outbound = {
-    parameters?: ParametersT$Outbound | undefined;
+    parameters?: WebSearchServerToolConfig$Outbound | undefined;
     type: "openrouter:web_search";
 };
 /** @internal */

package/esm/models/websearchservertoolopenrouter.js

@@ -3,23 +3,10 @@
  * @generated-id: 99dffefc1c11
  */
 import * as z from "zod/v4";
-import { remap as remap$ } from "../lib/primitives.js";
-/** @internal */
-export const ParametersT$outboundSchema = z.object({
-    maxResults: z.int().optional(),
-    maxTotalResults: z.int().optional(),
-}).transform((v) => {
-    return remap$(v, {
-        maxResults: "max_results",
-        maxTotalResults: "max_total_results",
-    });
-});
-export function parametersToJSON(parametersT) {
-    return JSON.stringify(ParametersT$outboundSchema.parse(parametersT));
-}
+import { WebSearchServerToolConfig$outboundSchema, } from "./websearchservertoolconfig.js";
 /** @internal */
 export const WebSearchServerToolOpenRouter$outboundSchema = z.object({
-    parameters: z.lazy(() => ParametersT$outboundSchema).optional(),
+    parameters: WebSearchServerToolConfig$outboundSchema.optional(),
     type: z.literal("openrouter:web_search"),
 });
 export function webSearchServerToolOpenRouterToJSON(webSearchServerToolOpenRouter) {

package/esm/sdk/stt.d.ts

@@ -6,7 +6,7 @@ export declare class Stt extends ClientSDK {
      * Create transcription
      *
      * @remarks
-     * Transcribes audio into text
+     * Transcribes audio into text. Accepts base64-encoded audio input and returns the transcribed text.
      */
     createTranscription(request: operations.CreateAudioTranscriptionsRequest, options?: RequestOptions): Promise<models.STTResponse>;
 }

package/esm/sdk/stt.js

@@ -10,7 +10,7 @@ export class Stt extends ClientSDK {
      * Create transcription
      *
      * @remarks
-     * Transcribes audio into text
+     * Transcribes audio into text. Accepts base64-encoded audio input and returns the transcribed text.
      */
     async createTranscription(request, options) {
         return unwrapAsync(sttCreateTranscription(this, request, options));

package/esm/sdk/tts.d.ts

@@ -5,7 +5,7 @@ export declare class Tts extends ClientSDK {
      * Create speech
      *
      * @remarks
-     * Synthesizes audio from the input text
+     * Synthesizes audio from the input text. Returns a raw audio bytestream in the requested format (e.g. mp3, pcm, wav).
      */
     createSpeech(request: operations.CreateAudioSpeechRequest, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
 }

package/esm/sdk/tts.js

@@ -10,7 +10,7 @@ export class Tts extends ClientSDK {
      * Create speech
      *
      * @remarks
-     * Synthesizes audio from the input text
+     * Synthesizes audio from the input text. Returns a raw audio bytestream in the requested format (e.g. mp3, pcm, wav).
      */
     async createSpeech(request, options) {
         return unwrapAsync(ttsCreateSpeech(this, request, options));

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.25",
+  "version": "0.12.27",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.25",
+  "version": "0.12.27",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.",
   "keywords": [
@@ -69,13 +69,13 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test": "vitest --run --project unit",
-    "test:watch": "vitest --watch --project unit",
     "compile": "tsc",
-    "postinstall": "node scripts/check-types.js || true",
     "prepare": "npm run build",
+    "test": "vitest --run --project unit",
     "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
+    "postinstall": "node scripts/check-types.js || true",
+    "test:watch": "vitest --watch --project unit",
     "typecheck": "tsc --noEmit",
     "typecheck:transit": "exit 0"
   },