@openrouter/sdk 0.9.11 → 0.11.2

package/FUNCTIONS.md

@@ -26,13 +26,14 @@ import { betaResponsesSend } from "@openrouter/sdk/funcs/betaResponsesSend.js";
 // You can create one instance of it to use across an application.
 const openRouter = new OpenRouterCore({
   httpReferer: "<value>",
-  xTitle: "<value>",
+  appTitle: "<value>",
+  appCategories: "<value>",
   apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
   const res = await betaResponsesSend(openRouter, {
-    openResponsesRequest: {},
+    responsesRequest: {},
   });
   if (res.ok) {
     const { value: result } = res;

package/_speakeasy/.github/action-inputs-config.json

@@ -49,5 +49,9 @@
   {
     "name": "publish_terraform",
     "language": "terraform"
+  },
+  {
+    "name": "publish_cli",
+    "language": "cli"
   }
 ]

package/esm/funcs/analyticsGetUserActivity.js

@@ -34,7 +34,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload?.["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload?.["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload?.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload?.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/apiKeysCreate.js

@@ -32,7 +32,8 @@ async function $do(client, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/apiKeysDelete.js

@@ -37,7 +37,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/apiKeysGet.js

@@ -37,7 +37,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/apiKeysGetCurrentKeyMetadata.js

@@ -31,7 +31,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload?.["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload?.["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload?.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload?.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/apiKeysList.js

@@ -35,7 +35,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload?.["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload?.["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload?.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload?.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/apiKeysUpdate.js

@@ -38,7 +38,8 @@ async function $do(client, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/betaResponsesSend.d.ts

@@ -17,14 +17,14 @@ import { Result } from "../types/fp.js";
  * Creates a streaming or non-streaming response using OpenResponses API format
  */
 export declare function betaResponsesSend(client: OpenRouterCore, request: operations.CreateResponsesRequest & {
-    openResponsesRequest: {
+    responsesRequest: {
         stream?: false;
     };
-}, options?: RequestOptions): APIPromise<Result<models.OpenResponsesNonStreamingResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+}, options?: RequestOptions): APIPromise<Result<models.OpenResponsesResult, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 export declare function betaResponsesSend(client: OpenRouterCore, request: operations.CreateResponsesRequest & {
-    openResponsesRequest: {
+    responsesRequest: {
         stream: true;
     };
-}, options?: RequestOptions): APIPromise<Result<EventStream<models.OpenResponsesStreamEvent>, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+}, options?: RequestOptions): APIPromise<Result<EventStream<models.StreamEvents>, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 export declare function betaResponsesSend(client: OpenRouterCore, request: operations.CreateResponsesRequest, options?: RequestOptions): APIPromise<Result<operations.CreateResponsesResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=betaResponsesSend.d.ts.map

package/esm/funcs/betaResponsesSend.js

@@ -20,17 +20,16 @@ async function $do(client, request, options) {
         return [parsed, { status: "invalid" }];
     }
     const payload = parsed.value;
-    const body = encodeJSON("body", payload.OpenResponsesRequest, {
-        explode: true,
-    });
+    const body = encodeJSON("body", payload.ResponsesRequest, { explode: true });
     const path = pathToFunc("/responses")();
     const headers = new Headers(compactMap({
         "Content-Type": "application/json",
-        Accept: request?.openResponsesRequest?.stream
+        Accept: request?.responsesRequest?.stream
             ? "text/event-stream"
             : "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/call-model.d.ts

@@ -1,3 +1,4 @@
+import type { $ZodObject, $ZodShape, infer as zodInfer } from 'zod/v4/core';
 import type { OpenRouterCore } from '../core.js';
 import type { CallModelInput } from '../lib/async-params.js';
 import type { RequestOptions } from '../lib/sdks.js';
@@ -18,66 +19,35 @@ export type { CallModelInput } from '../lib/async-params.js';
  * - `for await (const event of response.getToolStream())` - Stream tool events (incl. preliminary results)
  * - `for await (const toolCall of response.getToolCallsStream())` - Stream structured tool calls
  * - `await response.getToolCalls()` - Get all tool calls from completed response
- * - `for await (const msg of response.getNewMessagesStream())` - Stream incremental message updates
+ * - `for await (const msg of response.getNewMessagesStream())` - Stream cumulative message snapshots
  * - `for await (const event of response.getFullResponsesStream())` - Stream all events (incl. tool preliminary)
  *
  * All consumption patterns can be used concurrently on the same response.
  *
- * For message format conversion, use the helper functions:
- * - `fromChatMessages()` / `toChatMessage()` for OpenAI chat format
- * - `fromClaudeMessages()` / `toClaudeMessage()` for Anthropic Claude format
+ * **Context:**
  *
- * **Async Function Support:**
- *
- * Any field in CallModelInput can be a function that computes the value dynamically
- * based on the conversation context. You can mix static values and functions in the
- * same request. Functions are resolved before EVERY turn, allowing parameters to
- * adapt as the conversation progresses.
- *
- * @example
- * ```typescript
- * // Mix static and dynamic values
- * const result = callModel(client, {
- *   model: 'gpt-4',  // static
- *   temperature: (ctx) => Math.min(ctx.numberOfTurns * 0.2, 1.0),  // dynamic
- *   input: [{ type: 'text', text: 'Hello' }],  // static
- * });
- * ```
- *
- * @example
- * ```typescript
- * // Switch models based on conversation length
- * const result = callModel(client, {
- *   model: (ctx) => ctx.numberOfTurns > 3 ? 'gpt-4' : 'gpt-3.5-turbo',
- *   input: [{ type: 'text', text: 'Complex question' }],
- * });
- * ```
+ * Tools can declare a `contextSchema` to receive typed context data.
+ * The `context` parameter on callModel is typed as the intersection of all tool schemas:
  *
  * @example
  * ```typescript
- * // Use async functions to fetch dynamic values
  * const result = callModel(client, {
  *   model: 'gpt-4',
- *   instructions: async (ctx) => {
- *     const userPrefs = await fetchUserPreferences();
- *     return `You are a helpful assistant. User preferences: ${userPrefs}`;
+ *   input: 'Hello',
+ *   tools: [weatherTool, dbTool] as const,
+ *   context: {
+ *     get_weather: { apiKey: 'sk-...' },
+ *     db_query: { dbUrl: 'postgres://...' },
  *   },
- *   input: [{ type: 'text', text: 'Help me' }],
  * });
  * ```
  *
- * Async functions receive `TurnContext` with:
- * - `numberOfTurns`: Current turn number (0-indexed, 0 = initial request)
- * - `messageHistory`: Current conversation messages
- * - `model`: Current model selection (if set)
- * - `models`: Current models array (if set)
- *
- * **Execution Order:**
- * Functions are resolved at the START of each turn in this order:
- * 1. Async functions (parallel resolution)
- * 2. Tool execution (if tools called by model)
- * 3. nextTurnParams functions (if defined on tools)
- * 4. API request with resolved values
+ * Context can also be a function or async function:
+ * ```typescript
+ * context: (turn) => ({
+ *   get_weather: { apiKey: turn.numberOfTurns > 1 ? refreshedKey : initialKey },
+ * })
+ * ```
  *
  * **Stop Conditions:**
  *
@@ -85,34 +55,13 @@ export type { CallModelInput } from '../lib/async-params.js';
  *
  * @example
  * ```typescript
- * // Stop after 3 steps
  * stopWhen: stepCountIs(3)
- *
- * // Stop when a specific tool is called
- * stopWhen: hasToolCall('finalizeResults')
- *
- * // Multiple conditions (OR logic - stops if ANY is true)
- * stopWhen: [
- *   stepCountIs(10),        // Safety: max 10 steps
- *   maxCost(0.50),          // Budget: max $0.50
- *   hasToolCall('finalize') // Logic: stop when finalize called
- * ]
- *
- * // Custom condition with full step history
- * stopWhen: ({ steps }) => {
- *   const totalCalls = steps.reduce((sum, s) => sum + s.toolCalls.length, 0);
- *   return totalCalls >= 20; // Stop after 20 total tool calls
- * }
+ * stopWhen: [stepCountIs(10), maxCost(0.50), hasToolCall('finalize')]
  * ```
  *
- * Available helper functions:
- * - `stepCountIs(n)` - Stop after n steps
- * - `hasToolCall(name)` - Stop when tool is called
- * - `maxTokensUsed(n)` - Stop when token usage exceeds n
- * - `maxCost(n)` - Stop when cost exceeds n dollars
- * - `finishReasonIs(reason)` - Stop on specific finish reason
- *
  * Default: `stepCountIs(5)` if not specified
  */
-export declare function callModel<TTools extends readonly Tool[]>(client: OpenRouterCore, request: CallModelInput<TTools>, options?: RequestOptions): ModelResult<TTools>;
+export declare function callModel<TTools extends readonly Tool[], TSharedSchema extends $ZodObject<$ZodShape> | undefined = undefined, TShared extends Record<string, unknown> = TSharedSchema extends $ZodObject<$ZodShape> ? zodInfer<TSharedSchema> : Record<string, never>>(client: OpenRouterCore, request: CallModelInput<TTools, TShared> & {
+    sharedContextSchema?: TSharedSchema;
+}, options?: RequestOptions): ModelResult<TTools, TShared>;
 //# sourceMappingURL=call-model.d.ts.map

package/esm/funcs/call-model.js

@@ -14,66 +14,35 @@ import { convertToolsToAPIFormat } from '../lib/tool-executor.js';
  * - `for await (const event of response.getToolStream())` - Stream tool events (incl. preliminary results)
  * - `for await (const toolCall of response.getToolCallsStream())` - Stream structured tool calls
  * - `await response.getToolCalls()` - Get all tool calls from completed response
- * - `for await (const msg of response.getNewMessagesStream())` - Stream incremental message updates
+ * - `for await (const msg of response.getNewMessagesStream())` - Stream cumulative message snapshots
  * - `for await (const event of response.getFullResponsesStream())` - Stream all events (incl. tool preliminary)
  *
  * All consumption patterns can be used concurrently on the same response.
  *
- * For message format conversion, use the helper functions:
- * - `fromChatMessages()` / `toChatMessage()` for OpenAI chat format
- * - `fromClaudeMessages()` / `toClaudeMessage()` for Anthropic Claude format
+ * **Context:**
  *
- * **Async Function Support:**
- *
- * Any field in CallModelInput can be a function that computes the value dynamically
- * based on the conversation context. You can mix static values and functions in the
- * same request. Functions are resolved before EVERY turn, allowing parameters to
- * adapt as the conversation progresses.
+ * Tools can declare a `contextSchema` to receive typed context data.
+ * The `context` parameter on callModel is typed as the intersection of all tool schemas:
  *
  * @example
  * ```typescript
- * // Mix static and dynamic values
- * const result = callModel(client, {
- *   model: 'gpt-4',  // static
- *   temperature: (ctx) => Math.min(ctx.numberOfTurns * 0.2, 1.0),  // dynamic
- *   input: [{ type: 'text', text: 'Hello' }],  // static
- * });
- * ```
- *
- * @example
- * ```typescript
- * // Switch models based on conversation length
- * const result = callModel(client, {
- *   model: (ctx) => ctx.numberOfTurns > 3 ? 'gpt-4' : 'gpt-3.5-turbo',
- *   input: [{ type: 'text', text: 'Complex question' }],
- * });
- * ```
- *
- * @example
- * ```typescript
- * // Use async functions to fetch dynamic values
  * const result = callModel(client, {
  *   model: 'gpt-4',
- *   instructions: async (ctx) => {
- *     const userPrefs = await fetchUserPreferences();
- *     return `You are a helpful assistant. User preferences: ${userPrefs}`;
+ *   input: 'Hello',
+ *   tools: [weatherTool, dbTool] as const,
+ *   context: {
+ *     get_weather: { apiKey: 'sk-...' },
+ *     db_query: { dbUrl: 'postgres://...' },
  *   },
- *   input: [{ type: 'text', text: 'Help me' }],
  * });
  * ```
  *
- * Async functions receive `TurnContext` with:
- * - `numberOfTurns`: Current turn number (0-indexed, 0 = initial request)
- * - `messageHistory`: Current conversation messages
- * - `model`: Current model selection (if set)
- * - `models`: Current models array (if set)
- *
- * **Execution Order:**
- * Functions are resolved at the START of each turn in this order:
- * 1. Async functions (parallel resolution)
- * 2. Tool execution (if tools called by model)
- * 3. nextTurnParams functions (if defined on tools)
- * 4. API request with resolved values
+ * Context can also be a function or async function:
+ * ```typescript
+ * context: (turn) => ({
+ *   get_weather: { apiKey: turn.numberOfTurns > 1 ? refreshedKey : initialKey },
+ * })
+ * ```
  *
  * **Stop Conditions:**
  *
@@ -81,38 +50,15 @@ import { convertToolsToAPIFormat } from '../lib/tool-executor.js';
  *
  * @example
  * ```typescript
- * // Stop after 3 steps
  * stopWhen: stepCountIs(3)
- *
- * // Stop when a specific tool is called
- * stopWhen: hasToolCall('finalizeResults')
- *
- * // Multiple conditions (OR logic - stops if ANY is true)
- * stopWhen: [
- *   stepCountIs(10),        // Safety: max 10 steps
- *   maxCost(0.50),          // Budget: max $0.50
- *   hasToolCall('finalize') // Logic: stop when finalize called
- * ]
- *
- * // Custom condition with full step history
- * stopWhen: ({ steps }) => {
- *   const totalCalls = steps.reduce((sum, s) => sum + s.toolCalls.length, 0);
- *   return totalCalls >= 20; // Stop after 20 total tool calls
- * }
+ * stopWhen: [stepCountIs(10), maxCost(0.50), hasToolCall('finalize')]
  * ```
  *
- * Available helper functions:
- * - `stepCountIs(n)` - Stop after n steps
- * - `hasToolCall(name)` - Stop when tool is called
- * - `maxTokensUsed(n)` - Stop when token usage exceeds n
- * - `maxCost(n)` - Stop when cost exceeds n dollars
- * - `finishReasonIs(reason)` - Stop on specific finish reason
- *
  * Default: `stepCountIs(5)` if not specified
  */
 export function callModel(client, request, options) {
     // Destructure state management options along with tools and stopWhen
-    const { tools, stopWhen, state, requireApproval, approveToolCalls, rejectToolCalls, ...apiRequest } = request;
+    const { tools, stopWhen, state, requireApproval, approveToolCalls, rejectToolCalls, context, sharedContextSchema, onTurnStart, onTurnEnd, ...apiRequest } = request;
     // Convert tools to API format - no cast needed now that convertToolsToAPIFormat accepts readonly
     const apiTools = tools ? convertToolsToAPIFormat(tools) : undefined;
     // Build the request with converted tools
@@ -124,10 +70,18 @@ export function callModel(client, request, options) {
     if (apiTools !== undefined) {
         finalRequest['tools'] = apiTools;
     }
+    // Inject x-openrouter-callmodel header into every callModel request
+    const callModelOptions = {
+        ...options,
+        headers: {
+            ...Object.fromEntries(new Headers(options?.headers ?? options?.fetchOptions?.headers ?? undefined)),
+            'x-openrouter-callmodel': 'true',
+        },
+    };
     return new ModelResult({
         client,
         request: finalRequest,
-        options: options ?? {},
+        options: callModelOptions,
         tools,
         ...(stopWhen !== undefined && { stopWhen }),
         // Pass state management options
@@ -135,6 +89,10 @@ export function callModel(client, request, options) {
         ...(requireApproval !== undefined && { requireApproval }),
         ...(approveToolCalls !== undefined && { approveToolCalls }),
         ...(rejectToolCalls !== undefined && { rejectToolCalls }),
+        ...(context !== undefined && { context }),
+        ...(sharedContextSchema !== undefined && { sharedContextSchema }),
+        ...(onTurnStart !== undefined && { onTurnStart }),
+        ...(onTurnEnd !== undefined && { onTurnEnd }),
     });
 }
 //# sourceMappingURL=call-model.js.map

package/esm/funcs/chatSend.d.ts

@@ -17,14 +17,14 @@ import { Result } from "../types/fp.js";
  * Sends a request for a model response for the given chat conversation. Supports both streaming and non-streaming modes.
  */
 export declare function chatSend(client: OpenRouterCore, request: operations.SendChatCompletionRequestRequest & {
-    chatGenerationParams: {
+    chatRequest: {
         stream?: false;
     };
-}, options?: RequestOptions): APIPromise<Result<models.ChatResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+}, options?: RequestOptions): APIPromise<Result<models.ChatResult, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 export declare function chatSend(client: OpenRouterCore, request: operations.SendChatCompletionRequestRequest & {
-    chatGenerationParams: {
+    chatRequest: {
         stream: true;
     };
-}, options?: RequestOptions): APIPromise<Result<EventStream<models.ChatStreamingResponseChunk>, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+}, options?: RequestOptions): APIPromise<Result<EventStream<models.ChatStreamChunk>, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 export declare function chatSend(client: OpenRouterCore, request: operations.SendChatCompletionRequestRequest, options?: RequestOptions): APIPromise<Result<operations.SendChatCompletionRequestResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.UnprocessableEntityResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=chatSend.d.ts.map

package/esm/funcs/chatSend.js

@@ -20,17 +20,16 @@ async function $do(client, request, options) {
         return [parsed, { status: "invalid" }];
     }
     const payload = parsed.value;
-    const body = encodeJSON("body", payload.ChatGenerationParams, {
-        explode: true,
-    });
+    const body = encodeJSON("body", payload.ChatRequest, { explode: true });
     const path = pathToFunc("/chat/completions")();
     const headers = new Headers(compactMap({
         "Content-Type": "application/json",
-        Accept: request?.chatGenerationParams?.stream
+        Accept: request?.chatRequest?.stream
             ? "text/event-stream"
             : "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/creditsCreateCoinbaseCharge.js

@@ -34,7 +34,8 @@ async function $do(client, security, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const requestSecurity = resolveSecurity([
         {

package/esm/funcs/creditsGetCredits.js

@@ -31,7 +31,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload?.["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload?.["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload?.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload?.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/embeddingsGenerate.js

@@ -32,7 +32,8 @@ async function $do(client, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json;q=1, text/event-stream;q=0",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/embeddingsListModels.js

@@ -32,7 +32,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload?.["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload?.["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload?.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload?.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/endpointsList.js

@@ -38,7 +38,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/endpointsListZdrEndpoints.js

@@ -28,7 +28,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload?.["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload?.["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload?.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload?.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/generationsGetGeneration.js

@@ -31,7 +31,8 @@ async function $do(client, request, options) {
     const headers = new Headers(compactMap({
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/guardrailsBulkAssignKeys.js

@@ -38,7 +38,8 @@ async function $do(client, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/guardrailsBulkAssignMembers.js

@@ -38,7 +38,8 @@ async function $do(client, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/guardrailsBulkUnassignKeys.js

@@ -38,7 +38,8 @@ async function $do(client, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };

package/esm/funcs/guardrailsBulkUnassignMembers.js

@@ -38,7 +38,8 @@ async function $do(client, request, options) {
         "Content-Type": "application/json",
         Accept: "application/json",
         "HTTP-Referer": encodeSimple("HTTP-Referer", payload["HTTP-Referer"] ?? client._options.httpReferer, { explode: false, charEncoding: "none" }),
-        "X-Title": encodeSimple("X-Title", payload["X-Title"] ?? client._options.xTitle, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Categories": encodeSimple("X-OpenRouter-Categories", payload.appCategories ?? client._options.appCategories, { explode: false, charEncoding: "none" }),
+        "X-OpenRouter-Title": encodeSimple("X-OpenRouter-Title", payload.appTitle ?? client._options.appTitle, { explode: false, charEncoding: "none" }),
     }));
     const secConfig = await extractSecurity(client._options.apiKey);
     const securityInput = secConfig == null ? {} : { apiKey: secConfig };