@langchain/openrouter 0.1.0

package/dist/chat_models/types.d.cts

@@ -0,0 +1,97 @@
+import { OpenRouter } from "../api-types.cjs";
+import { BaseChatModelCallOptions, BaseChatModelParams, BindToolsInput } from "@langchain/core/language_models/chat_models";
+
+//#region src/chat_models/types.d.ts
+type OpenRouterResponseFormat = OpenRouter.ChatGenerationParams["response_format"];
+/**
+ * Plugin configuration for OpenRouter plugins (e.g. web search).
+ */
+interface OpenRouterPlugin {
+  id: string;
+  [key: string]: any;
+}
+/**
+ * Shared fields that can be set at construction time or overridden per-call.
+ */
+interface ChatOpenRouterFields {
+  /** Sampling temperature (0–2). */
+  temperature?: number;
+  /** Maximum number of tokens to generate. */
+  maxTokens?: number;
+  /** Nucleus sampling cutoff probability. */
+  topP?: number;
+  /** Top-K sampling: only consider the K most likely tokens. */
+  topK?: number;
+  /** Additive penalty based on how often a token has appeared so far (−2 to 2). */
+  frequencyPenalty?: number;
+  /** Additive penalty based on whether a token has appeared at all (−2 to 2). */
+  presencePenalty?: number;
+  /** Multiplicative penalty applied to repeated token logits (0 to 2). */
+  repetitionPenalty?: number;
+  /** Minimum probability threshold for token sampling. */
+  minP?: number;
+  /** Top-A sampling threshold. */
+  topA?: number;
+  /** Random seed for deterministic generation. */
+  seed?: number;
+  /** Stop sequences that halt generation. */
+  stop?: string[];
+  /** Token-level biases to apply during sampling. */
+  logitBias?: Record<string, number>;
+  /** Number of most-likely log-probabilities to return per token. */
+  topLogprobs?: number;
+  /** OpenRouter-specific transformations to apply to the request. */
+  transforms?: string[];
+  /** OpenRouter-specific list of models for routing. */
+  models?: string[];
+  /** OpenRouter-specific routing strategy. */
+  route?: "fallback";
+  /** OpenRouter-specific provider preferences and ordering. */
+  provider?: OpenRouter.ProviderPreferences;
+  /** OpenRouter plugins to enable (e.g. web search). */
+  plugins?: OpenRouterPlugin[];
+}
+/**
+ * Constructor parameters for `ChatOpenRouter`.
+ */
+interface ChatOpenRouterParams extends BaseChatModelParams, ChatOpenRouterFields {
+  /** Model identifier, e.g. "anthropic/claude-4-sonnet". */
+  model?: string;
+  /** OpenRouter API key. Falls back to `OPENROUTER_API_KEY` env var. */
+  apiKey?: string;
+  /** Base URL for the API. Defaults to "https://openrouter.ai/api/v1". */
+  baseURL?: string;
+  /** Your site URL — used for OpenRouter rankings / rate limits. */
+  siteUrl?: string;
+  /** Your site name — shown on the OpenRouter leaderboard. */
+  siteName?: string;
+  /** Stable identifier for end-users, used for abuse detection. */
+  user?: string;
+  /** Extra params passed through to the API body. */
+  modelKwargs?: Record<string, unknown>;
+  /** Whether to include usage in streaming chunks. Defaults to true. */
+  streamUsage?: boolean;
+}
+/**
+ * Per-call options for `ChatOpenRouter`.
+ */
+interface ChatOpenRouterCallOptions extends BaseChatModelCallOptions, ChatOpenRouterFields {
+  /** Tool definitions to bind for this call. */
+  tools?: BindToolsInput[];
+  /** Response format constraint (text, JSON object, or JSON schema). */
+  response_format?: OpenRouterResponseFormat;
+  /** Whether tool schemas should use strict mode. */
+  strict?: boolean;
+  /** Predicted output content for latency optimization. */
+  prediction?: {
+    type: "content";
+    content: string;
+  };
+  /** Stable identifier for end-users, used for abuse detection. */
+  user?: string;
+  /** Abort signal to cancel the request. */
+  signal?: AbortSignal;
+}
+//#endregion
+export { ChatOpenRouterCallOptions, ChatOpenRouterFields, ChatOpenRouterParams, OpenRouterPlugin, OpenRouterResponseFormat };
+//# sourceMappingURL=types.d.cts.map

package/dist/chat_models/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/chat_models/types.ts"],"mappings":";;;;KAOY,wBAAA,GACV,UAAA,CAAW,oBAAA;AADb;;;AAAA,UAMiB,gBAAA;EACf,EAAA;EAAA,CAEC,GAAA;AAAA;;;;UAMc,oBAAA;EAAoB;EAEnC,WAAA;EAsBY;EApBZ,SAAA;EAgCU;EA9BV,IAAA;EA8B0B;EA5B1B,IAAA;EAJA;EAMA,gBAAA;EAFA;EAIA,eAAA;EAAA;EAEA,iBAAA;EAEA;EAAA,IAAA;EAIA;EAFA,IAAA;EAMA;EAJA,IAAA;EAMA;EAJA,IAAA;EAQA;EANA,SAAA,GAAY,MAAA;EAUZ;EARA,WAAA;EAQsB;EANtB,UAAA;EAQU;EANV,MAAA;EAM0B;EAJ1B,KAAA;EAWA;EATA,QAAA,GAAW,UAAA,CAAW,mBAAA;EAwBR;EAtBd,OAAA,GAAU,gBAAA;AAAA;;;;UAMK,oBAAA,SACP,mBAAA,EACN,oBAAA;EAEF;EAAA,KAAA;EAIA;EAFA,MAAA;EAMA;EAJA,OAAA;EAQA;EANA,OAAA;EAQA;EANA,QAAA;EAMW;EAJX,IAAA;EAWA;EATA,WAAA,GAAc,MAAA;EAYN;EAVR,WAAA;AAAA;;;;UAMe,yBAAA,SACP,wBAAA,EACN,oBAAA;EADM;EAGR,KAAA,GAAQ,cAAA;EAAR;EAEA,eAAA,GAAkB,wBAAA;EAAlB;EAEA,MAAA;EAAA;EAEA,UAAA;IAAe,IAAA;IAAiB,OAAA;EAAA;EAIhC;EAFA,IAAA;EAEoB;EAApB,MAAA,GAAS,WAAA;AAAA"}

package/dist/chat_models/types.d.ts

@@ -0,0 +1,97 @@
+import { OpenRouter } from "../api-types.js";
+import { BaseChatModelCallOptions, BaseChatModelParams, BindToolsInput } from "@langchain/core/language_models/chat_models";
+
+//#region src/chat_models/types.d.ts
+type OpenRouterResponseFormat = OpenRouter.ChatGenerationParams["response_format"];
+/**
+ * Plugin configuration for OpenRouter plugins (e.g. web search).
+ */
+interface OpenRouterPlugin {
+  id: string;
+  [key: string]: any;
+}
+/**
+ * Shared fields that can be set at construction time or overridden per-call.
+ */
+interface ChatOpenRouterFields {
+  /** Sampling temperature (0–2). */
+  temperature?: number;
+  /** Maximum number of tokens to generate. */
+  maxTokens?: number;
+  /** Nucleus sampling cutoff probability. */
+  topP?: number;
+  /** Top-K sampling: only consider the K most likely tokens. */
+  topK?: number;
+  /** Additive penalty based on how often a token has appeared so far (−2 to 2). */
+  frequencyPenalty?: number;
+  /** Additive penalty based on whether a token has appeared at all (−2 to 2). */
+  presencePenalty?: number;
+  /** Multiplicative penalty applied to repeated token logits (0 to 2). */
+  repetitionPenalty?: number;
+  /** Minimum probability threshold for token sampling. */
+  minP?: number;
+  /** Top-A sampling threshold. */
+  topA?: number;
+  /** Random seed for deterministic generation. */
+  seed?: number;
+  /** Stop sequences that halt generation. */
+  stop?: string[];
+  /** Token-level biases to apply during sampling. */
+  logitBias?: Record<string, number>;
+  /** Number of most-likely log-probabilities to return per token. */
+  topLogprobs?: number;
+  /** OpenRouter-specific transformations to apply to the request. */
+  transforms?: string[];
+  /** OpenRouter-specific list of models for routing. */
+  models?: string[];
+  /** OpenRouter-specific routing strategy. */
+  route?: "fallback";
+  /** OpenRouter-specific provider preferences and ordering. */
+  provider?: OpenRouter.ProviderPreferences;
+  /** OpenRouter plugins to enable (e.g. web search). */
+  plugins?: OpenRouterPlugin[];
+}
+/**
+ * Constructor parameters for `ChatOpenRouter`.
+ */
+interface ChatOpenRouterParams extends BaseChatModelParams, ChatOpenRouterFields {
+  /** Model identifier, e.g. "anthropic/claude-4-sonnet". */
+  model?: string;
+  /** OpenRouter API key. Falls back to `OPENROUTER_API_KEY` env var. */
+  apiKey?: string;
+  /** Base URL for the API. Defaults to "https://openrouter.ai/api/v1". */
+  baseURL?: string;
+  /** Your site URL — used for OpenRouter rankings / rate limits. */
+  siteUrl?: string;
+  /** Your site name — shown on the OpenRouter leaderboard. */
+  siteName?: string;
+  /** Stable identifier for end-users, used for abuse detection. */
+  user?: string;
+  /** Extra params passed through to the API body. */
+  modelKwargs?: Record<string, unknown>;
+  /** Whether to include usage in streaming chunks. Defaults to true. */
+  streamUsage?: boolean;
+}
+/**
+ * Per-call options for `ChatOpenRouter`.
+ */
+interface ChatOpenRouterCallOptions extends BaseChatModelCallOptions, ChatOpenRouterFields {
+  /** Tool definitions to bind for this call. */
+  tools?: BindToolsInput[];
+  /** Response format constraint (text, JSON object, or JSON schema). */
+  response_format?: OpenRouterResponseFormat;
+  /** Whether tool schemas should use strict mode. */
+  strict?: boolean;
+  /** Predicted output content for latency optimization. */
+  prediction?: {
+    type: "content";
+    content: string;
+  };
+  /** Stable identifier for end-users, used for abuse detection. */
+  user?: string;
+  /** Abort signal to cancel the request. */
+  signal?: AbortSignal;
+}
+//#endregion
+export { ChatOpenRouterCallOptions, ChatOpenRouterFields, ChatOpenRouterParams, OpenRouterPlugin, OpenRouterResponseFormat };
+//# sourceMappingURL=types.d.ts.map

package/dist/chat_models/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/chat_models/types.ts"],"mappings":";;;;KAOY,wBAAA,GACV,UAAA,CAAW,oBAAA;AADb;;;AAAA,UAMiB,gBAAA;EACf,EAAA;EAAA,CAEC,GAAA;AAAA;;;;UAMc,oBAAA;EAAoB;EAEnC,WAAA;EAsBY;EApBZ,SAAA;EAgCU;EA9BV,IAAA;EA8B0B;EA5B1B,IAAA;EAJA;EAMA,gBAAA;EAFA;EAIA,eAAA;EAAA;EAEA,iBAAA;EAEA;EAAA,IAAA;EAIA;EAFA,IAAA;EAMA;EAJA,IAAA;EAMA;EAJA,IAAA;EAQA;EANA,SAAA,GAAY,MAAA;EAUZ;EARA,WAAA;EAQsB;EANtB,UAAA;EAQU;EANV,MAAA;EAM0B;EAJ1B,KAAA;EAWA;EATA,QAAA,GAAW,UAAA,CAAW,mBAAA;EAwBR;EAtBd,OAAA,GAAU,gBAAA;AAAA;;;;UAMK,oBAAA,SACP,mBAAA,EACN,oBAAA;EAEF;EAAA,KAAA;EAIA;EAFA,MAAA;EAMA;EAJA,OAAA;EAQA;EANA,OAAA;EAQA;EANA,QAAA;EAMW;EAJX,IAAA;EAWA;EATA,WAAA,GAAc,MAAA;EAYN;EAVR,WAAA;AAAA;;;;UAMe,yBAAA,SACP,wBAAA,EACN,oBAAA;EADM;EAGR,KAAA,GAAQ,cAAA;EAAR;EAEA,eAAA,GAAkB,wBAAA;EAAlB;EAEA,MAAA;EAAA;EAEA,UAAA;IAAe,IAAA;IAAiB,OAAA;EAAA;EAIhC;EAFA,IAAA;EAEoB;EAApB,MAAA,GAAS,WAAA;AAAA"}

package/dist/converters/messages.cjs

@@ -0,0 +1,90 @@
+let _langchain_openai = require("@langchain/openai");
+
+//#region src/converters/messages.ts
+/**
+* Convert an array of LangChain messages to the OpenRouter request format.
+*
+* Delegates to the OpenAI completions converter since OpenRouter's chat
+* API is wire-compatible with OpenAI's. This gives us full support for
+* standard content blocks, reasoning-model developer role mapping,
+* multi-modal inputs, and all edge cases handled upstream.
+*/
+function convertMessagesToOpenRouterParams(messages, model) {
+	return (0, _langchain_openai.convertMessagesToCompletionsMessageParams)({
+		messages,
+		model
+	});
+}
+/**
+* Convert a non-streaming OpenRouter response choice into a BaseMessage.
+*
+* Delegates to the OpenAI completions converter for tool call parsing,
+* multi-modal output handling, and audio support, then patches
+* response_metadata to reflect the OpenRouter provider.
+*/
+function convertOpenRouterResponseToBaseMessage(choice, rawResponse) {
+	const message = (0, _langchain_openai.convertCompletionsMessageToBaseMessage)({
+		message: choice.message,
+		rawResponse
+	});
+	message.response_metadata = {
+		...message.response_metadata,
+		model: rawResponse.model,
+		model_provider: "openrouter",
+		model_name: rawResponse.model,
+		finish_reason: choice.finish_reason
+	};
+	return message;
+}
+/**
+* Convert a streaming delta into a BaseMessageChunk.
+*
+* Delegates to the OpenAI completions converter for tool call chunk
+* parsing, audio handling, and role-specific message types, then
+* patches response_metadata to reflect the OpenRouter provider.
+*/
+function convertOpenRouterDeltaToBaseMessageChunk(delta, rawChunk, defaultRole) {
+	const chunk = (0, _langchain_openai.convertCompletionsDeltaToBaseMessageChunk)({
+		delta,
+		rawResponse: rawChunk,
+		defaultRole: defaultRole ?? "assistant"
+	});
+	chunk.response_metadata = {
+		...chunk.response_metadata,
+		model_provider: "openrouter"
+	};
+	return chunk;
+}
+/**
+* Convert OpenRouter usage info to LangChain's `UsageMetadata`,
+* including prompt/completion token detail breakdowns when available.
+*/
+function convertUsageMetadata(usage) {
+	if (!usage) return void 0;
+	const result = {
+		input_tokens: usage.prompt_tokens,
+		output_tokens: usage.completion_tokens,
+		total_tokens: usage.total_tokens
+	};
+	const promptDetails = usage.prompt_tokens_details;
+	if (promptDetails) {
+		const input_token_details = {};
+		if (promptDetails.cached_tokens != null) input_token_details.cache_read = promptDetails.cached_tokens;
+		if (promptDetails.audio_tokens != null) input_token_details.audio = promptDetails.audio_tokens;
+		if (Object.keys(input_token_details).length > 0) result.input_token_details = input_token_details;
+	}
+	const completionDetails = usage.completion_tokens_details;
+	if (completionDetails) {
+		const output_token_details = {};
+		if (completionDetails.reasoning_tokens != null) output_token_details.reasoning = completionDetails.reasoning_tokens;
+		if (Object.keys(output_token_details).length > 0) result.output_token_details = output_token_details;
+	}
+	return result;
+}
+
+//#endregion
+exports.convertMessagesToOpenRouterParams = convertMessagesToOpenRouterParams;
+exports.convertOpenRouterDeltaToBaseMessageChunk = convertOpenRouterDeltaToBaseMessageChunk;
+exports.convertOpenRouterResponseToBaseMessage = convertOpenRouterResponseToBaseMessage;
+exports.convertUsageMetadata = convertUsageMetadata;
+//# sourceMappingURL=messages.cjs.map

package/dist/converters/messages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.cjs","names":[],"sources":["../../src/converters/messages.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  UsageMetadata,\n} from \"@langchain/core/messages\";\nimport {\n  convertMessagesToCompletionsMessageParams,\n  convertCompletionsMessageToBaseMessage,\n  convertCompletionsDeltaToBaseMessageChunk,\n} from \"@langchain/openai\";\nimport type { OpenAI as OpenAIClient } from \"openai\";\nimport type { OpenRouter } from \"../api-types.js\";\n\n/**\n * The inner data shape of a streaming SSE chunk. Each parsed SSE event\n * contains this object directly (without the `data` wrapper that the\n * OpenAPI spec describes on `ChatStreamingResponseChunk`).\n */\nexport type StreamingChunkData = OpenRouter.ChatStreamingResponseChunk[\"data\"];\n\n// LangChain → OpenRouter\n/**\n * Convert an array of LangChain messages to the OpenRouter request format.\n *\n * Delegates to the OpenAI completions converter since OpenRouter's chat\n * API is wire-compatible with OpenAI's. This gives us full support for\n * standard content blocks, reasoning-model developer role mapping,\n * multi-modal inputs, and all edge cases handled upstream.\n */\nexport function convertMessagesToOpenRouterParams(\n  messages: BaseMessage[],\n  model?: string\n): OpenAIClient.Chat.Completions.ChatCompletionMessageParam[] {\n  return convertMessagesToCompletionsMessageParams({\n    messages,\n    model,\n  });\n}\n\n// OpenRouter → LangChain (non-streaming)\n/**\n * Convert a non-streaming OpenRouter response choice into a BaseMessage.\n *\n * Delegates to the OpenAI completions converter for tool call parsing,\n * multi-modal output handling, and audio support, then patches\n * response_metadata to reflect the OpenRouter provider.\n */\nexport function convertOpenRouterResponseToBaseMessage(\n  choice: OpenRouter.ChatResponseChoice,\n  rawResponse: OpenRouter.ChatResponse\n): BaseMessage {\n  const message = convertCompletionsMessageToBaseMessage({\n    message:\n      choice.message as unknown as OpenAIClient.Chat.Completions.ChatCompletionMessage,\n    rawResponse:\n      rawResponse as unknown as OpenAIClient.Chat.Completions.ChatCompletion,\n  });\n\n  message.response_metadata = {\n    ...message.response_metadata,\n    model: rawResponse.model,\n    model_provider: \"openrouter\",\n    model_name: rawResponse.model,\n    finish_reason: choice.finish_reason,\n  };\n\n  return message;\n}\n\n// OpenRouter → LangChain (streaming)\n/**\n * Convert a streaming delta into a BaseMessageChunk.\n *\n * Delegates to the OpenAI completions converter for tool call chunk\n * parsing, audio handling, and role-specific message types, then\n * patches response_metadata to reflect the OpenRouter provider.\n */\nexport function convertOpenRouterDeltaToBaseMessageChunk(\n  delta: OpenRouter.ChatStreamingMessageChunk,\n  rawChunk: StreamingChunkData,\n  defaultRole?: string\n): BaseMessageChunk {\n  const chunk = convertCompletionsDeltaToBaseMessageChunk({\n    delta: delta as Record<string, unknown>,\n    rawResponse:\n      rawChunk as unknown as OpenAIClient.Chat.Completions.ChatCompletionChunk,\n    defaultRole: (defaultRole ??\n      \"assistant\") as OpenAIClient.Chat.ChatCompletionRole,\n  });\n\n  chunk.response_metadata = {\n    ...chunk.response_metadata,\n    model_provider: \"openrouter\",\n  };\n\n  return chunk;\n}\n\n// Usage metadata\n\n/**\n * Convert OpenRouter usage info to LangChain's `UsageMetadata`,\n * including prompt/completion token detail breakdowns when available.\n */\nexport function convertUsageMetadata(\n  usage?: OpenRouter.ChatGenerationTokenUsage\n): UsageMetadata | undefined {\n  if (!usage) return undefined;\n\n  const result: UsageMetadata = {\n    input_tokens: usage.prompt_tokens,\n    output_tokens: usage.completion_tokens,\n    total_tokens: usage.total_tokens,\n  };\n\n  const promptDetails = usage.prompt_tokens_details;\n  if (promptDetails) {\n    const input_token_details: Record<string, number> = {};\n    if (promptDetails.cached_tokens != null)\n      input_token_details.cache_read = promptDetails.cached_tokens;\n    if (promptDetails.audio_tokens != null)\n      input_token_details.audio = promptDetails.audio_tokens;\n    if (Object.keys(input_token_details).length > 0)\n      result.input_token_details = input_token_details;\n  }\n\n  const completionDetails = usage.completion_tokens_details;\n  if (completionDetails) {\n    const output_token_details: Record<string, number> = {};\n    if (completionDetails.reasoning_tokens != null)\n      output_token_details.reasoning = completionDetails.reasoning_tokens;\n    if (Object.keys(output_token_details).length > 0)\n      result.output_token_details = output_token_details;\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;AA6BA,SAAgB,kCACd,UACA,OAC4D;AAC5D,yEAAiD;EAC/C;EACA;EACD,CAAC;;;;;;;;;AAWJ,SAAgB,uCACd,QACA,aACa;CACb,MAAM,wEAAiD;EACrD,SACE,OAAO;EAEP;EACH,CAAC;AAEF,SAAQ,oBAAoB;EAC1B,GAAG,QAAQ;EACX,OAAO,YAAY;EACnB,gBAAgB;EAChB,YAAY,YAAY;EACxB,eAAe,OAAO;EACvB;AAED,QAAO;;;;;;;;;AAWT,SAAgB,yCACd,OACA,UACA,aACkB;CAClB,MAAM,yEAAkD;EAC/C;EACP,aACE;EACF,aAAc,eACZ;EACH,CAAC;AAEF,OAAM,oBAAoB;EACxB,GAAG,MAAM;EACT,gBAAgB;EACjB;AAED,QAAO;;;;;;AAST,SAAgB,qBACd,OAC2B;AAC3B,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,SAAwB;EAC5B,cAAc,MAAM;EACpB,eAAe,MAAM;EACrB,cAAc,MAAM;EACrB;CAED,MAAM,gBAAgB,MAAM;AAC5B,KAAI,eAAe;EACjB,MAAM,sBAA8C,EAAE;AACtD,MAAI,cAAc,iBAAiB,KACjC,qBAAoB,aAAa,cAAc;AACjD,MAAI,cAAc,gBAAgB,KAChC,qBAAoB,QAAQ,cAAc;AAC5C,MAAI,OAAO,KAAK,oBAAoB,CAAC,SAAS,EAC5C,QAAO,sBAAsB;;CAGjC,MAAM,oBAAoB,MAAM;AAChC,KAAI,mBAAmB;EACrB,MAAM,uBAA+C,EAAE;AACvD,MAAI,kBAAkB,oBAAoB,KACxC,sBAAqB,YAAY,kBAAkB;AACrD,MAAI,OAAO,KAAK,qBAAqB,CAAC,SAAS,EAC7C,QAAO,uBAAuB;;AAGlC,QAAO"}

package/dist/converters/messages.js

@@ -0,0 +1,87 @@
+import { convertCompletionsDeltaToBaseMessageChunk, convertCompletionsMessageToBaseMessage, convertMessagesToCompletionsMessageParams } from "@langchain/openai";
+
+//#region src/converters/messages.ts
+/**
+* Convert an array of LangChain messages to the OpenRouter request format.
+*
+* Delegates to the OpenAI completions converter since OpenRouter's chat
+* API is wire-compatible with OpenAI's. This gives us full support for
+* standard content blocks, reasoning-model developer role mapping,
+* multi-modal inputs, and all edge cases handled upstream.
+*/
+function convertMessagesToOpenRouterParams(messages, model) {
+	return convertMessagesToCompletionsMessageParams({
+		messages,
+		model
+	});
+}
+/**
+* Convert a non-streaming OpenRouter response choice into a BaseMessage.
+*
+* Delegates to the OpenAI completions converter for tool call parsing,
+* multi-modal output handling, and audio support, then patches
+* response_metadata to reflect the OpenRouter provider.
+*/
+function convertOpenRouterResponseToBaseMessage(choice, rawResponse) {
+	const message = convertCompletionsMessageToBaseMessage({
+		message: choice.message,
+		rawResponse
+	});
+	message.response_metadata = {
+		...message.response_metadata,
+		model: rawResponse.model,
+		model_provider: "openrouter",
+		model_name: rawResponse.model,
+		finish_reason: choice.finish_reason
+	};
+	return message;
+}
+/**
+* Convert a streaming delta into a BaseMessageChunk.
+*
+* Delegates to the OpenAI completions converter for tool call chunk
+* parsing, audio handling, and role-specific message types, then
+* patches response_metadata to reflect the OpenRouter provider.
+*/
+function convertOpenRouterDeltaToBaseMessageChunk(delta, rawChunk, defaultRole) {
+	const chunk = convertCompletionsDeltaToBaseMessageChunk({
+		delta,
+		rawResponse: rawChunk,
+		defaultRole: defaultRole ?? "assistant"
+	});
+	chunk.response_metadata = {
+		...chunk.response_metadata,
+		model_provider: "openrouter"
+	};
+	return chunk;
+}
+/**
+* Convert OpenRouter usage info to LangChain's `UsageMetadata`,
+* including prompt/completion token detail breakdowns when available.
+*/
+function convertUsageMetadata(usage) {
+	if (!usage) return void 0;
+	const result = {
+		input_tokens: usage.prompt_tokens,
+		output_tokens: usage.completion_tokens,
+		total_tokens: usage.total_tokens
+	};
+	const promptDetails = usage.prompt_tokens_details;
+	if (promptDetails) {
+		const input_token_details = {};
+		if (promptDetails.cached_tokens != null) input_token_details.cache_read = promptDetails.cached_tokens;
+		if (promptDetails.audio_tokens != null) input_token_details.audio = promptDetails.audio_tokens;
+		if (Object.keys(input_token_details).length > 0) result.input_token_details = input_token_details;
+	}
+	const completionDetails = usage.completion_tokens_details;
+	if (completionDetails) {
+		const output_token_details = {};
+		if (completionDetails.reasoning_tokens != null) output_token_details.reasoning = completionDetails.reasoning_tokens;
+		if (Object.keys(output_token_details).length > 0) result.output_token_details = output_token_details;
+	}
+	return result;
+}
+
+//#endregion
+export { convertMessagesToOpenRouterParams, convertOpenRouterDeltaToBaseMessageChunk, convertOpenRouterResponseToBaseMessage, convertUsageMetadata };
+//# sourceMappingURL=messages.js.map

package/dist/converters/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","names":[],"sources":["../../src/converters/messages.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageChunk,\n  UsageMetadata,\n} from \"@langchain/core/messages\";\nimport {\n  convertMessagesToCompletionsMessageParams,\n  convertCompletionsMessageToBaseMessage,\n  convertCompletionsDeltaToBaseMessageChunk,\n} from \"@langchain/openai\";\nimport type { OpenAI as OpenAIClient } from \"openai\";\nimport type { OpenRouter } from \"../api-types.js\";\n\n/**\n * The inner data shape of a streaming SSE chunk. Each parsed SSE event\n * contains this object directly (without the `data` wrapper that the\n * OpenAPI spec describes on `ChatStreamingResponseChunk`).\n */\nexport type StreamingChunkData = OpenRouter.ChatStreamingResponseChunk[\"data\"];\n\n// LangChain → OpenRouter\n/**\n * Convert an array of LangChain messages to the OpenRouter request format.\n *\n * Delegates to the OpenAI completions converter since OpenRouter's chat\n * API is wire-compatible with OpenAI's. This gives us full support for\n * standard content blocks, reasoning-model developer role mapping,\n * multi-modal inputs, and all edge cases handled upstream.\n */\nexport function convertMessagesToOpenRouterParams(\n  messages: BaseMessage[],\n  model?: string\n): OpenAIClient.Chat.Completions.ChatCompletionMessageParam[] {\n  return convertMessagesToCompletionsMessageParams({\n    messages,\n    model,\n  });\n}\n\n// OpenRouter → LangChain (non-streaming)\n/**\n * Convert a non-streaming OpenRouter response choice into a BaseMessage.\n *\n * Delegates to the OpenAI completions converter for tool call parsing,\n * multi-modal output handling, and audio support, then patches\n * response_metadata to reflect the OpenRouter provider.\n */\nexport function convertOpenRouterResponseToBaseMessage(\n  choice: OpenRouter.ChatResponseChoice,\n  rawResponse: OpenRouter.ChatResponse\n): BaseMessage {\n  const message = convertCompletionsMessageToBaseMessage({\n    message:\n      choice.message as unknown as OpenAIClient.Chat.Completions.ChatCompletionMessage,\n    rawResponse:\n      rawResponse as unknown as OpenAIClient.Chat.Completions.ChatCompletion,\n  });\n\n  message.response_metadata = {\n    ...message.response_metadata,\n    model: rawResponse.model,\n    model_provider: \"openrouter\",\n    model_name: rawResponse.model,\n    finish_reason: choice.finish_reason,\n  };\n\n  return message;\n}\n\n// OpenRouter → LangChain (streaming)\n/**\n * Convert a streaming delta into a BaseMessageChunk.\n *\n * Delegates to the OpenAI completions converter for tool call chunk\n * parsing, audio handling, and role-specific message types, then\n * patches response_metadata to reflect the OpenRouter provider.\n */\nexport function convertOpenRouterDeltaToBaseMessageChunk(\n  delta: OpenRouter.ChatStreamingMessageChunk,\n  rawChunk: StreamingChunkData,\n  defaultRole?: string\n): BaseMessageChunk {\n  const chunk = convertCompletionsDeltaToBaseMessageChunk({\n    delta: delta as Record<string, unknown>,\n    rawResponse:\n      rawChunk as unknown as OpenAIClient.Chat.Completions.ChatCompletionChunk,\n    defaultRole: (defaultRole ??\n      \"assistant\") as OpenAIClient.Chat.ChatCompletionRole,\n  });\n\n  chunk.response_metadata = {\n    ...chunk.response_metadata,\n    model_provider: \"openrouter\",\n  };\n\n  return chunk;\n}\n\n// Usage metadata\n\n/**\n * Convert OpenRouter usage info to LangChain's `UsageMetadata`,\n * including prompt/completion token detail breakdowns when available.\n */\nexport function convertUsageMetadata(\n  usage?: OpenRouter.ChatGenerationTokenUsage\n): UsageMetadata | undefined {\n  if (!usage) return undefined;\n\n  const result: UsageMetadata = {\n    input_tokens: usage.prompt_tokens,\n    output_tokens: usage.completion_tokens,\n    total_tokens: usage.total_tokens,\n  };\n\n  const promptDetails = usage.prompt_tokens_details;\n  if (promptDetails) {\n    const input_token_details: Record<string, number> = {};\n    if (promptDetails.cached_tokens != null)\n      input_token_details.cache_read = promptDetails.cached_tokens;\n    if (promptDetails.audio_tokens != null)\n      input_token_details.audio = promptDetails.audio_tokens;\n    if (Object.keys(input_token_details).length > 0)\n      result.input_token_details = input_token_details;\n  }\n\n  const completionDetails = usage.completion_tokens_details;\n  if (completionDetails) {\n    const output_token_details: Record<string, number> = {};\n    if (completionDetails.reasoning_tokens != null)\n      output_token_details.reasoning = completionDetails.reasoning_tokens;\n    if (Object.keys(output_token_details).length > 0)\n      result.output_token_details = output_token_details;\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;AA6BA,SAAgB,kCACd,UACA,OAC4D;AAC5D,QAAO,0CAA0C;EAC/C;EACA;EACD,CAAC;;;;;;;;;AAWJ,SAAgB,uCACd,QACA,aACa;CACb,MAAM,UAAU,uCAAuC;EACrD,SACE,OAAO;EAEP;EACH,CAAC;AAEF,SAAQ,oBAAoB;EAC1B,GAAG,QAAQ;EACX,OAAO,YAAY;EACnB,gBAAgB;EAChB,YAAY,YAAY;EACxB,eAAe,OAAO;EACvB;AAED,QAAO;;;;;;;;;AAWT,SAAgB,yCACd,OACA,UACA,aACkB;CAClB,MAAM,QAAQ,0CAA0C;EAC/C;EACP,aACE;EACF,aAAc,eACZ;EACH,CAAC;AAEF,OAAM,oBAAoB;EACxB,GAAG,MAAM;EACT,gBAAgB;EACjB;AAED,QAAO;;;;;;AAST,SAAgB,qBACd,OAC2B;AAC3B,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,SAAwB;EAC5B,cAAc,MAAM;EACpB,eAAe,MAAM;EACrB,cAAc,MAAM;EACrB;CAED,MAAM,gBAAgB,MAAM;AAC5B,KAAI,eAAe;EACjB,MAAM,sBAA8C,EAAE;AACtD,MAAI,cAAc,iBAAiB,KACjC,qBAAoB,aAAa,cAAc;AACjD,MAAI,cAAc,gBAAgB,KAChC,qBAAoB,QAAQ,cAAc;AAC5C,MAAI,OAAO,KAAK,oBAAoB,CAAC,SAAS,EAC5C,QAAO,sBAAsB;;CAGjC,MAAM,oBAAoB,MAAM;AAChC,KAAI,mBAAmB;EACrB,MAAM,uBAA+C,EAAE;AACvD,MAAI,kBAAkB,oBAAoB,KACxC,sBAAqB,YAAY,kBAAkB;AACrD,MAAI,OAAO,KAAK,qBAAqB,CAAC,SAAS,EAC7C,QAAO,uBAAuB;;AAGlC,QAAO"}

package/dist/converters/tools.cjs

@@ -0,0 +1,30 @@
+let _langchain_core_utils_function_calling = require("@langchain/core/utils/function_calling");
+
+//#region src/converters/tools.ts
+/**
+* Convert LangChain tool inputs to the OpenRouter (OpenAI-compatible) format.
+*/
+function convertToolsToOpenRouter(tools, options) {
+	return tools.map((tool) => {
+		return (0, _langchain_core_utils_function_calling.convertToOpenAITool)(tool, { strict: options?.strict });
+	});
+}
+/**
+* Convert a LangChain `ToolChoice` value to the OpenRouter wire format.
+*/
+function formatToolChoice(toolChoice) {
+	if (toolChoice === void 0 || toolChoice === null) return void 0;
+	if (toolChoice === "auto") return "auto";
+	if (toolChoice === "none") return "none";
+	if (toolChoice === "any" || toolChoice === "required") return "required";
+	if (typeof toolChoice === "string") return {
+		type: "function",
+		function: { name: toolChoice }
+	};
+	return toolChoice;
+}
+
+//#endregion
+exports.convertToolsToOpenRouter = convertToolsToOpenRouter;
+exports.formatToolChoice = formatToolChoice;
+//# sourceMappingURL=tools.cjs.map

package/dist/converters/tools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.cjs","names":[],"sources":["../../src/converters/tools.ts"],"sourcesContent":["import { convertToOpenAITool } from \"@langchain/core/utils/function_calling\";\nimport type { BindToolsInput } from \"@langchain/core/language_models/chat_models\";\nimport type { ToolDefinition } from \"@langchain/core/language_models/base\";\nimport type { OpenRouter } from \"../api-types.js\";\n\n/**\n * Convert LangChain tool inputs to the OpenRouter (OpenAI-compatible) format.\n */\nexport function convertToolsToOpenRouter(\n  tools: BindToolsInput[],\n  options?: { strict?: boolean }\n): OpenRouter.ToolDefinitionJson[] {\n  return tools.map((tool) => {\n    const converted: ToolDefinition = convertToOpenAITool(tool, {\n      strict: options?.strict,\n    });\n    return converted as unknown as OpenRouter.ToolDefinitionJson;\n  });\n}\n\n/**\n * Convert a LangChain `ToolChoice` value to the OpenRouter wire format.\n */\nexport function formatToolChoice(\n  toolChoice?: string | Record<string, unknown>\n): OpenRouter.ToolChoiceOption | undefined {\n  if (toolChoice === undefined || toolChoice === null) return undefined;\n  if (toolChoice === \"auto\") return \"auto\";\n  if (toolChoice === \"none\") return \"none\";\n  if (toolChoice === \"any\" || toolChoice === \"required\") return \"required\";\n  if (typeof toolChoice === \"string\") {\n    return { type: \"function\", function: { name: toolChoice } };\n  }\n  return toolChoice as unknown as OpenRouter.ToolChoiceOption;\n}\n"],"mappings":";;;;;;AAQA,SAAgB,yBACd,OACA,SACiC;AACjC,QAAO,MAAM,KAAK,SAAS;AAIzB,yEAHsD,MAAM,EAC1D,QAAQ,SAAS,QAClB,CAAC;GAEF;;;;;AAMJ,SAAgB,iBACd,YACyC;AACzC,KAAI,eAAe,UAAa,eAAe,KAAM,QAAO;AAC5D,KAAI,eAAe,OAAQ,QAAO;AAClC,KAAI,eAAe,OAAQ,QAAO;AAClC,KAAI,eAAe,SAAS,eAAe,WAAY,QAAO;AAC9D,KAAI,OAAO,eAAe,SACxB,QAAO;EAAE,MAAM;EAAY,UAAU,EAAE,MAAM,YAAY;EAAE;AAE7D,QAAO"}

package/dist/converters/tools.js

@@ -0,0 +1,29 @@
+import { convertToOpenAITool } from "@langchain/core/utils/function_calling";
+
+//#region src/converters/tools.ts
+/**
+* Convert LangChain tool inputs to the OpenRouter (OpenAI-compatible) format.
+*/
+function convertToolsToOpenRouter(tools, options) {
+	return tools.map((tool) => {
+		return convertToOpenAITool(tool, { strict: options?.strict });
+	});
+}
+/**
+* Convert a LangChain `ToolChoice` value to the OpenRouter wire format.
+*/
+function formatToolChoice(toolChoice) {
+	if (toolChoice === void 0 || toolChoice === null) return void 0;
+	if (toolChoice === "auto") return "auto";
+	if (toolChoice === "none") return "none";
+	if (toolChoice === "any" || toolChoice === "required") return "required";
+	if (typeof toolChoice === "string") return {
+		type: "function",
+		function: { name: toolChoice }
+	};
+	return toolChoice;
+}
+
+//#endregion
+export { convertToolsToOpenRouter, formatToolChoice };
+//# sourceMappingURL=tools.js.map

package/dist/converters/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":[],"sources":["../../src/converters/tools.ts"],"sourcesContent":["import { convertToOpenAITool } from \"@langchain/core/utils/function_calling\";\nimport type { BindToolsInput } from \"@langchain/core/language_models/chat_models\";\nimport type { ToolDefinition } from \"@langchain/core/language_models/base\";\nimport type { OpenRouter } from \"../api-types.js\";\n\n/**\n * Convert LangChain tool inputs to the OpenRouter (OpenAI-compatible) format.\n */\nexport function convertToolsToOpenRouter(\n  tools: BindToolsInput[],\n  options?: { strict?: boolean }\n): OpenRouter.ToolDefinitionJson[] {\n  return tools.map((tool) => {\n    const converted: ToolDefinition = convertToOpenAITool(tool, {\n      strict: options?.strict,\n    });\n    return converted as unknown as OpenRouter.ToolDefinitionJson;\n  });\n}\n\n/**\n * Convert a LangChain `ToolChoice` value to the OpenRouter wire format.\n */\nexport function formatToolChoice(\n  toolChoice?: string | Record<string, unknown>\n): OpenRouter.ToolChoiceOption | undefined {\n  if (toolChoice === undefined || toolChoice === null) return undefined;\n  if (toolChoice === \"auto\") return \"auto\";\n  if (toolChoice === \"none\") return \"none\";\n  if (toolChoice === \"any\" || toolChoice === \"required\") return \"required\";\n  if (typeof toolChoice === \"string\") {\n    return { type: \"function\", function: { name: toolChoice } };\n  }\n  return toolChoice as unknown as OpenRouter.ToolChoiceOption;\n}\n"],"mappings":";;;;;;AAQA,SAAgB,yBACd,OACA,SACiC;AACjC,QAAO,MAAM,KAAK,SAAS;AAIzB,SAHkC,oBAAoB,MAAM,EAC1D,QAAQ,SAAS,QAClB,CAAC;GAEF;;;;;AAMJ,SAAgB,iBACd,YACyC;AACzC,KAAI,eAAe,UAAa,eAAe,KAAM,QAAO;AAC5D,KAAI,eAAe,OAAQ,QAAO;AAClC,KAAI,eAAe,OAAQ,QAAO;AAClC,KAAI,eAAe,SAAS,eAAe,WAAY,QAAO;AAC9D,KAAI,OAAO,eAAe,SACxB,QAAO;EAAE,MAAM;EAAY,UAAU,EAAE,MAAM,YAAY;EAAE;AAE7D,QAAO"}

package/dist/index.cjs

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_errors = require('./utils/errors.cjs');
+const require_profiles = require('./profiles.cjs');
+const require_index = require('./chat_models/index.cjs');
+
+exports.ChatOpenRouter = require_index.ChatOpenRouter;
+exports.OPENROUTER_MODEL_PROFILES = require_profiles;
+exports.OpenRouterAuthError = require_errors.OpenRouterAuthError;
+exports.OpenRouterError = require_errors.OpenRouterError;
+exports.OpenRouterRateLimitError = require_errors.OpenRouterRateLimitError;

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+import { OpenRouter } from "./api-types.cjs";
+import { ChatOpenRouterCallOptions, ChatOpenRouterFields, ChatOpenRouterParams, OpenRouterPlugin, OpenRouterResponseFormat } from "./chat_models/types.cjs";
+import { ChatOpenRouter } from "./chat_models/index.cjs";
+import { OpenRouterAuthError, OpenRouterError, OpenRouterRateLimitError } from "./utils/errors.cjs";
+import { PROFILES } from "./profiles.cjs";
+export { ChatOpenRouter, type ChatOpenRouterCallOptions, type ChatOpenRouterFields, type ChatOpenRouterParams as ChatOpenRouterInput, PROFILES as OPENROUTER_MODEL_PROFILES, type OpenRouter, OpenRouterAuthError, OpenRouterError, type OpenRouterPlugin, OpenRouterRateLimitError, type OpenRouterResponseFormat };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { OpenRouter } from "./api-types.js";
+import { ChatOpenRouterCallOptions, ChatOpenRouterFields, ChatOpenRouterParams, OpenRouterPlugin, OpenRouterResponseFormat } from "./chat_models/types.js";
+import { ChatOpenRouter } from "./chat_models/index.js";
+import { OpenRouterAuthError, OpenRouterError, OpenRouterRateLimitError } from "./utils/errors.js";
+import { PROFILES } from "./profiles.js";
+export { ChatOpenRouter, type ChatOpenRouterCallOptions, type ChatOpenRouterFields, type ChatOpenRouterParams as ChatOpenRouterInput, PROFILES as OPENROUTER_MODEL_PROFILES, type OpenRouter, OpenRouterAuthError, OpenRouterError, type OpenRouterPlugin, OpenRouterRateLimitError, type OpenRouterResponseFormat };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { OpenRouterAuthError, OpenRouterError, OpenRouterRateLimitError } from "./utils/errors.js";
+import PROFILES from "./profiles.js";
+import { ChatOpenRouter } from "./chat_models/index.js";
+
+export { ChatOpenRouter, PROFILES as OPENROUTER_MODEL_PROFILES, OpenRouterAuthError, OpenRouterError, OpenRouterRateLimitError };