@langchain/google 0.2.11 → 0.2.13

package/dist/converters/interactions/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","names":[],"sources":["../../../src/converters/interactions/tools.ts"],"sourcesContent":["import { isLangChainTool } from \"@langchain/core/utils/function_calling\";\nimport { isOpenAITool } from \"@langchain/core/language_models/base\";\nimport { Converter } from \"@langchain/core/utils/format\";\nimport type {\n  BindToolsInput,\n  ToolChoice,\n} from \"@langchain/core/language_models/chat_models\";\nimport type { Gemini } from \"../../chat_models/types.js\";\nimport { InvalidToolError } from \"../../utils/errors.js\";\nimport { schemaToGeminiParameters } from \"../generate_content/tools.js\";\n\nconst INTERACTIONS_TOOL_TYPES = new Set([\n  \"function\",\n  \"google_search\",\n  \"code_execution\",\n  \"url_context\",\n  \"computer_use\",\n  \"file_search\",\n  \"google_maps\",\n  \"mcp_server\",\n  \"retrieval\",\n]);\n\n/**\n * Type guard to check if a tool is already in Interactions API format.\n * Note: OpenAI tools also have `type: \"function\"`, so we exclude objects\n * that have an OpenAI-style nested `function` object.\n */\nfunction isInteractionsTool(\n  tool: BindToolsInput\n): tool is Gemini.Interactions.Tool {\n  if (typeof tool !== \"object\" || tool === null) {\n    return false;\n  }\n  if (isOpenAITool(tool)) {\n    return false;\n  }\n  if (!(\"type\" in tool) || typeof tool.type !== \"string\") {\n    return false;\n  }\n  return INTERACTIONS_TOOL_TYPES.has(tool.type);\n}\n\n/**\n * Type guard to check if a tool is in GenerateContent `Gemini.Tool` format.\n */\nfunction isGenerateContentTool(tool: BindToolsInput): tool is Gemini.Tool {\n  if (typeof tool !== \"object\" || tool === null) {\n    return false;\n  }\n\n  const geminiToolAttributes = [\n    \"functionDeclarations\",\n    \"codeExecution\",\n    \"googleSearch\",\n    \"googleSearchRetrieval\",\n    \"urlContext\",\n    \"googleMaps\",\n    \"fileSearch\",\n    \"computerUse\",\n    \"mcpServers\",\n    \"retrieval\",\n  ];\n\n  return geminiToolAttributes.some((attr) => attr in tool);\n}\n\n/**\n * Converts a GenerateContent-formatted `Gemini.Tool` object into one or more\n * flat Interactions API `Gemini.Interactions.Tool` objects, translating\n * camelCase properties to snake_case where appropriate.\n */\nfunction convertGenerateContentToolToInteractionsTools(\n  tool: Gemini.Tool & Record<string, unknown>\n): Gemini.Interactions.Tool[] {\n  const results: Gemini.Interactions.Tool[] = [];\n\n  if (\n    \"functionDeclarations\" in tool &&\n    Array.isArray(tool.functionDeclarations)\n  ) {\n    for (const decl of tool.functionDeclarations) {\n      const parameters = (decl.parameters ?? decl.parametersJsonSchema) as\n        | Record<string, unknown>\n        | undefined;\n      results.push({\n        type: \"function\",\n        name: decl.name ?? \"\",\n        description: decl.description ?? \"A function available to call.\",\n        ...(parameters ? { parameters } : {}),\n      });\n    }\n  }\n\n  if (\"googleSearch\" in tool && tool.googleSearch) {\n    const gs = tool.googleSearch as Gemini.Tools.GoogleSearch &\n      Record<string, unknown>;\n    const searchTypes: Array<\n      \"web_search\" | \"image_search\" | \"enterprise_web_search\"\n    > = [];\n    if (gs.searchTypes?.webSearch) {\n      searchTypes.push(\"web_search\");\n    }\n    if (gs.searchTypes?.imageSearch) {\n      searchTypes.push(\"image_search\");\n    }\n    const timeRangeFilter =\n      (gs.time_range_filter as Gemini.Interactions.GoogleSearch[\"time_range_filter\"]) ??\n      (gs.timeRangeFilter\n        ? {\n            start_time: gs.timeRangeFilter.startTime,\n            end_time: gs.timeRangeFilter.endTime,\n          }\n        : undefined);\n\n    results.push({\n      type: \"google_search\",\n      ...(searchTypes.length > 0 ? { search_types: searchTypes } : {}),\n      ...(timeRangeFilter ? { time_range_filter: timeRangeFilter } : {}),\n    });\n  } else if (\"googleSearchRetrieval\" in tool) {\n    results.push({\n      type: \"google_search\",\n    });\n  }\n\n  if (\"codeExecution\" in tool && tool.codeExecution) {\n    results.push({\n      type: \"code_execution\",\n    });\n  }\n\n  if (\"urlContext\" in tool && tool.urlContext) {\n    results.push({\n      type: \"url_context\",\n    });\n  }\n\n  if (\"googleMaps\" in tool && tool.googleMaps) {\n    const gm = tool.googleMaps as Gemini.Tools.GoogleMaps &\n      Record<string, unknown>;\n    const enableWidget =\n      (gm.enable_widget as boolean | undefined) ?? gm.enableWidget;\n    results.push({\n      type: \"google_maps\",\n      ...(typeof enableWidget === \"boolean\"\n        ? { enable_widget: enableWidget }\n        : {}),\n      ...(typeof gm.latitude === \"number\" ? { latitude: gm.latitude } : {}),\n      ...(typeof gm.longitude === \"number\" ? { longitude: gm.longitude } : {}),\n    });\n  }\n\n  if (\"fileSearch\" in tool && tool.fileSearch) {\n    const fs = tool.fileSearch as Gemini.Tools.FileSearch &\n      Record<string, unknown>;\n    const storeNames =\n      (fs.file_search_store_names as string[] | undefined) ??\n      fs.fileSearchStoreNames;\n    const topK = (fs.top_k as number | undefined) ?? fs.topK;\n    const metadataFilter =\n      (fs.metadata_filter as string | undefined) ?? fs.metadataFilter;\n    results.push({\n      type: \"file_search\",\n      ...(storeNames ? { file_search_store_names: storeNames } : {}),\n      ...(typeof topK === \"number\" ? { top_k: topK } : {}),\n      ...(metadataFilter ? { metadata_filter: metadataFilter } : {}),\n    });\n  }\n\n  if (\"computerUse\" in tool && tool.computerUse) {\n    const cu = tool.computerUse as Gemini.Tools.ComputerUse &\n      Record<string, unknown>;\n    const rawEnv = cu.environment;\n    const environment =\n      rawEnv === \"ENVIRONMENT_BROWSER\" || rawEnv === \"browser\"\n        ? (\"browser\" as const)\n        : undefined;\n    const excludedPredefinedFunctions =\n      (cu.excluded_predefined_functions as string[] | undefined) ??\n      cu.excludedPredefinedFunctions;\n    results.push({\n      type: \"computer_use\",\n      ...(environment ? { environment } : {}),\n      ...(excludedPredefinedFunctions\n        ? { excluded_predefined_functions: excludedPredefinedFunctions }\n        : {}),\n    });\n  }\n\n  if (\"mcpServers\" in tool && Array.isArray(tool.mcpServers)) {\n    for (const server of tool.mcpServers as Array<Record<string, unknown>>) {\n      const transport = server.streamableHttpTransport as\n        | Record<string, unknown>\n        | undefined;\n      const url = (server.url ?? transport?.url) as string | undefined;\n      const headers = (server.headers ?? transport?.headers) as\n        | Record<string, string>\n        | undefined;\n      const allowedTools = (server.allowed_tools ?? server.allowedTools) as\n        | Gemini.Interactions.AllowedTools[]\n        | undefined;\n      results.push({\n        type: \"mcp_server\",\n        ...(typeof server.name === \"string\" ? { name: server.name } : {}),\n        ...(url ? { url } : {}),\n        ...(headers ? { headers } : {}),\n        ...(allowedTools ? { allowed_tools: allowedTools } : {}),\n      });\n    }\n  }\n\n  if (\"retrieval\" in tool && tool.retrieval) {\n    const ret = tool.retrieval as Record<string, unknown>;\n    const vas = (ret.vertex_ai_search_config ?? ret.vertexAiSearch) as\n      | Record<string, unknown>\n      | undefined;\n    const datastores = Array.isArray(vas?.datastores)\n      ? (vas.datastores as string[])\n      : typeof vas?.datastore === \"string\"\n        ? [vas.datastore]\n        : undefined;\n    results.push({\n      type: \"retrieval\",\n      ...(vas\n        ? {\n            retrieval_types: [\"vertex_ai_search\"],\n            vertex_ai_search_config: {\n              ...(datastores ? { datastores } : {}),\n              ...(typeof vas.engine === \"string\" ? { engine: vas.engine } : {}),\n            },\n          }\n        : {}),\n    });\n  }\n\n  return results;\n}\n\n/**\n * Converts an array of tools in any supported format (LangChain `StructuredTool`,\n * OpenAI tool, GenerateContent `Gemini.Tool`, raw `FunctionDeclaration`, or native\n * Interactions `Tool`) into flat `Gemini.Interactions.Tool[]` items.\n */\nexport const convertToolsToInteractionsTools: Converter<\n  BindToolsInput[],\n  Gemini.Interactions.Tool[]\n> = (tools) => {\n  if (tools.length === 0) {\n    return [];\n  }\n\n  const interactionsTools: Gemini.Interactions.Tool[] = [];\n\n  for (const tool of tools) {\n    if (isInteractionsTool(tool)) {\n      interactionsTools.push(tool);\n      continue;\n    }\n\n    if (isGenerateContentTool(tool)) {\n      interactionsTools.push(\n        ...convertGenerateContentToolToInteractionsTools(\n          tool as Gemini.Tool & Record<string, unknown>\n        )\n      );\n      continue;\n    }\n\n    if (isLangChainTool(tool)) {\n      const jsonSchema = schemaToGeminiParameters(tool.schema);\n      interactionsTools.push({\n        type: \"function\",\n        name: tool.name,\n        description: tool.description ?? \"A function available to call.\",\n        parameters: jsonSchema as unknown as Record<string, unknown>,\n      });\n      continue;\n    }\n\n    if (isOpenAITool(tool)) {\n      interactionsTools.push({\n        type: \"function\",\n        name: tool.function.name,\n        description:\n          tool.function.description ?? \"A function available to call.\",\n        parameters: tool.function.parameters\n          ? (schemaToGeminiParameters(\n              tool.function.parameters\n            ) as unknown as Record<string, unknown>)\n          : undefined,\n      });\n      continue;\n    }\n\n    if (\n      typeof tool === \"object\" &&\n      tool !== null &&\n      \"name\" in tool &&\n      typeof tool.name === \"string\"\n    ) {\n      const funcDecl = tool as Partial<Gemini.Tools.FunctionDeclaration>;\n      interactionsTools.push({\n        type: \"function\",\n        name: funcDecl.name!,\n        description: funcDecl.description ?? \"A function available to call.\",\n        ...(funcDecl.parameters\n          ? {\n              parameters: funcDecl.parameters as unknown as Record<\n                string,\n                unknown\n              >,\n            }\n          : {}),\n      });\n      continue;\n    }\n\n    throw new InvalidToolError(tool);\n  }\n\n  return interactionsTools;\n};\n\n/**\n * Converts LangChain's `tool_choice` option into the Interactions API\n * `generation_config.tool_choice` format (`ToolChoiceType | ToolChoiceConfig`).\n */\nexport function convertToolChoiceToInteractionsConfig(\n  toolChoice: ToolChoice | undefined,\n  hasTools: boolean\n): Gemini.Interactions.ToolChoice | undefined {\n  if (!hasTools || toolChoice === undefined) {\n    return undefined;\n  }\n\n  if (typeof toolChoice === \"object\" && toolChoice !== null) {\n    if (\"allowed_tools\" in toolChoice) {\n      return toolChoice as Gemini.Interactions.ToolChoiceConfig;\n    }\n  }\n\n  let mode: Gemini.Interactions.ToolChoiceType | undefined;\n  let allowedFunctionNames: string[] | undefined;\n\n  let toolChoiceMode: string | undefined;\n  let toolChoiceFunction: string | string[] | undefined;\n\n  if (typeof toolChoice === \"object\" && toolChoice !== null) {\n    const obj = toolChoice as {\n      mode?: string;\n      function?: { name?: string };\n      allowedFunctionNames?: string[];\n    };\n    toolChoiceMode = obj.mode;\n    toolChoiceFunction = obj.function?.name ?? obj.allowedFunctionNames;\n  } else if (typeof toolChoice === \"string\") {\n    toolChoiceMode = toolChoice;\n  }\n\n  const normalizedMode = toolChoiceMode?.toLowerCase();\n  if (normalizedMode === \"auto\") {\n    mode = \"auto\";\n  } else if (normalizedMode === \"any\" || normalizedMode === \"required\") {\n    mode = \"any\";\n  } else if (normalizedMode === \"none\") {\n    mode = \"none\";\n  } else if (normalizedMode === \"validated\") {\n    mode = \"validated\";\n  } else if (typeof toolChoiceMode === \"string\" && toolChoiceMode.length > 0) {\n    mode = \"any\";\n    toolChoiceFunction = toolChoiceMode;\n  }\n\n  if (toolChoiceFunction) {\n    allowedFunctionNames = Array.isArray(toolChoiceFunction)\n      ? toolChoiceFunction\n      : [toolChoiceFunction];\n  }\n\n  if (allowedFunctionNames && allowedFunctionNames.length > 0) {\n    return {\n      allowed_tools: {\n        mode: mode ?? \"any\",\n        tools: allowedFunctionNames,\n      },\n    };\n  }\n\n  return mode;\n}\n"],"mappings":"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"}

package/dist/converters/{params.cjs → shared/params.cjs}

@@ -1,5 +1,4 @@
-const require_types = require("../chat_models/types.cjs");
-//#region src/converters/params.ts
+// src/converters/shared/params.ts
 /**
 * Converts a reasoning "effort" level value (e.g., "minimal", "low", "medium", "high")
 * to a corresponding reasoning token budget, depending on the target Gemini model.
@@ -72,7 +71,7 @@ function convertReasoningEffortToReasoningTokens(modelName, effort) {
 *   The Gemini model name (e.g., "gemini-3-pro"). Used for model-specific special cases.
 * @param {number | undefined} reasoningTokens
 *   The token budget to convert. If undefined, the function returns undefined.
-* @returns {Lowercase<Gemini.ThinkingLevel> | undefined}
+* @returns {Lowercase<Gemini.Shared.ThinkingLevel> | undefined}
 *   The reasoning "effort" level ("minimal", "low", "medium", "high") or undefined if input is not valid.
 *
 * @example
@@ -143,101 +142,16 @@ function getModelSpecialty(model) {
 	else if (model.includes("tts")) return "tts";
 	else return "";
 }
-const MINIMAL_THINKING_LEVEL_MODELS = [
-	"gemini-3-flash",
-	"gemini-3.1-flash-lite",
-	"gemini-3.5-flash",
-	"gemini-3.6-flash"
-];
-function supportsMinimalThinkingLevel(model) {
-	return MINIMAL_THINKING_LEVEL_MODELS.some((prefix) => model.startsWith(prefix));
+function getGoogleChatModelParams(modelOrParams, paramsArg) {
+	return {
+		model: typeof modelOrParams === "string" ? modelOrParams : modelOrParams.model,
+		...typeof modelOrParams === "string" ? paramsArg : modelOrParams
+	};
 }
-/**
-* Builds the `thinkingConfig` object for the Gemini `generationConfig`,
-* translating user-facing reasoning fields into the wire format.
-*
-* @param model  The full Gemini model name (e.g. "gemini-2.5-flash").
-* @param fields The combined user/call-option fields.
-* @returns A populated {@link Gemini.ThinkingConfig}, or `{}`
-*          when thinking should not be explicitly configured.
-*/
-function convertFieldsToThinkingConfig(model, fields) {
-	let includeThoughts = true;
-	let thinkingBudget = fields?.maxReasoningTokens ?? fields?.thinkingBudget ?? convertReasoningEffortToReasoningTokens(model, fields?.reasoningEffort ?? fields?.thinkingLevel);
-	if (thinkingBudget === 0 || model.includes("pro") && thinkingBudget === 128) includeThoughts = false;
-	if (model.startsWith("gemini-2.5-pro") && typeof thinkingBudget !== "undefined") {
-		if (thinkingBudget >= 0 && thinkingBudget < 128) thinkingBudget = 128;
-	}
-	let thinkingLevel = (fields?.reasoningEffort ?? fields?.thinkingLevel ?? convertReasoningTokensToReasoningEffort(model, fields?.maxReasoningTokens ?? fields?.thinkingBudget))?.toUpperCase();
-	if (thinkingLevel === "MINIMAL") includeThoughts = false;
-	if (thinkingLevel === "MINIMAL" && getModelFamily(model) === "gemini" && Number(getModelVersion(model)) >= 3 && !supportsMinimalThinkingLevel(model)) thinkingLevel = "LOW";
-	if (model.startsWith("gemini-3-pro") && thinkingLevel === "MEDIUM") thinkingLevel = "HIGH";
-	const modelVersion = getModelVersion(model);
-	const modelSpecialty = getModelSpecialty(model);
-	if (modelVersion === "2.5" && modelSpecialty === "image" || typeof thinkingBudget === "undefined" || typeof thinkingLevel === "undefined") return;
-	const thinkingConfig = { includeThoughts };
-	if (modelSpecialty === "") {
-		if (model.startsWith("gemini-2.5")) thinkingConfig.thinkingBudget = thinkingBudget;
-		else thinkingConfig.thinkingLevel = thinkingLevel;
-	}
-	return thinkingConfig;
-}
-/**
-* Builds the `speechConfig` object for the Gemini `generationConfig`,
-* normalising the user-friendly simplified forms into the wire format.
-*
-* @param fields The combined user/call-option fields.
-* @returns A populated {@link Gemini.SpeechConfig}, or `{}`
-*          when no speech config was provided.
-*/
-function convertFieldsToSpeechConfig(fields) {
-	const config = fields.speechConfig;
-	if (typeof config === "undefined") return;
-	function isSpeechConfig(config) {
-		return typeof config === "object" && (Object.hasOwn(config, "voiceConfig") || Object.hasOwn(config, "multiSpeakerVoiceConfig"));
-	}
-	function hasLanguage(config) {
-		return typeof config === "object" && Object.hasOwn(config, "languageCode");
-	}
-	function hasVoice(config) {
-		return Object.hasOwn(config, "voice");
-	}
-	if (isSpeechConfig(config)) return config;
-	let languageCode;
-	let voice;
-	if (hasLanguage(config)) {
-		languageCode = config.languageCode;
-		voice = hasVoice(config) ? config.voice : config.voices;
-	} else {
-		languageCode = void 0;
-		voice = config;
-	}
-	let ret;
-	if (typeof voice === "string") ret = { voiceConfig: { prebuiltVoiceConfig: { voiceName: voice } } };
-	else ret = { multiSpeakerVoiceConfig: { speakerVoiceConfigs: (Array.isArray(voice) ? voice : [voice]).map((v) => ({
-		speaker: v.speaker,
-		voiceConfig: { prebuiltVoiceConfig: { voiceName: v.name } }
-	})) } };
-	if (languageCode) ret.languageCode = languageCode;
-	return ret;
-}
-/**
-* Builds an object that can be included as part of the request
-* which will add a `speechConfig` attribute if appropriate.
-*/
-function convertFieldsToServiceTier(platform, fields) {
-	if (platform === "gcp") return {};
-	const serviceTier = fields.serviceTier;
-	if (!serviceTier || !require_types.settableServiceTier.includes(serviceTier)) return {};
-	return { serviceTier };
-}
-//#endregion
-exports.convertFieldsToServiceTier = convertFieldsToServiceTier;
-exports.convertFieldsToSpeechConfig = convertFieldsToSpeechConfig;
-exports.convertFieldsToThinkingConfig = convertFieldsToThinkingConfig;
 exports.convertParamsToPlatformType = convertParamsToPlatformType;
 exports.convertReasoningEffortToReasoningTokens = convertReasoningEffortToReasoningTokens;
 exports.convertReasoningTokensToReasoningEffort = convertReasoningTokensToReasoningEffort;
+exports.getGoogleChatModelParams = getGoogleChatModelParams;
 exports.getModelFamily = getModelFamily;
 exports.getModelLevel = getModelLevel;
 exports.getModelSpecialty = getModelSpecialty;

package/dist/converters/shared/params.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.cjs","names":[],"sources":["../../../src/converters/shared/params.ts"],"sourcesContent":["import type {\n  BaseChatGoogleParams,\n  GooglePlatformType,\n  Gemini,\n} from \"../../chat_models/types.js\";\n\n/**\n * Converts a reasoning \"effort\" level value (e.g., \"minimal\", \"low\", \"medium\", \"high\")\n * to a corresponding reasoning token budget, depending on the target Gemini model.\n *\n * This mapping is essential when configuring Google Gemini API calls with reasoning\n * effort/level fields (as in the Gemini OpenAI-compatible API) or when translating\n * user-friendly configuration to explicit token budgets.\n *\n * - The mapping is refined to reflect the constraints documented by Google:\n *   - For \"gemini-2.5-flash\" models, token budgets may be set as low as 0 and up to 24k.\n *   - For other Gemini models, minimum is 128, maximum is 32k.\n * - Standard effort levels and their token mappings:\n *   - \"none\" / \"minimal\": lowest allowed (minTokens)\n *   - \"low\": 1k tokens\n *   - \"medium\": 8k tokens\n *   - \"high\": maximum allowed for the model (maxTokens)\n * - See reference:\n *   https://ai.google.dev/gemini-api/docs/thinking#thinking-levels\n *   https://ai.google.dev/gemini-api/docs/openai#thinking\n *\n * @param {string | undefined} modelName\n *   The Gemini model name (e.g., \"gemini-2.5-flash\"). Used to determine token range constraints.\n * @param {string | undefined} effort\n *   The reasoning effort level: one of \"none\", \"minimal\", \"low\", \"medium\", \"high\"\n *   (case-insensitive). If undefined, the function returns undefined.\n * @returns {number | undefined}\n *   The corresponding token count for the given effort and model. Returns undefined if\n *   the effort is not recognized or not provided.\n *\n * @example\n * convertReasoningEffortToReasoningTokens(\"gemini-2.5-flash\", \"medium\") // 8192\n * convertReasoningEffortToReasoningTokens(\"gemini-1.5-pro\", \"high\") // 32768\n * convertReasoningEffortToReasoningTokens(\"gemini-2.5-flash\", \"none\") // 0\n * convertReasoningEffortToReasoningTokens(undefined, \"low\") // 1024\n */\nexport function convertReasoningEffortToReasoningTokens(\n  modelName?: string,\n  effort?: string\n): number | undefined {\n  if (effort === undefined) {\n    return undefined;\n  }\n\n  // gemini-2.5-flash and -flash-lite can be disabled. Others can't.\n  // https://ai.google.dev/gemini-api/docs/thinking#thinking-levels\n  const minTokens: number = modelName?.startsWith(\"gemini-2.5-flash\") ? 0 : 128;\n  const maxTokens: number = modelName?.startsWith(\"gemini-2.5-flash\")\n    ? 24 * 1024\n    : 32 * 1024;\n\n  const normalizedEffort = effort.toLowerCase();\n  switch (normalizedEffort) {\n    case \"none\":\n    case \"minimal\":\n      return minTokens;\n    case \"low\":\n      // Defined as 1k by https://ai.google.dev/gemini-api/docs/openai#thinking\n      return 1024;\n    case \"medium\":\n      // Defined as 8k by https://ai.google.dev/gemini-api/docs/openai#thinking\n      return 8 * 1024;\n    case \"high\":\n      // Defined as 24k or 32k (model-dependent) by https://ai.google.dev/gemini-api/docs/openai#thinking\n      return maxTokens;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Converts a reasoning token budget (e.g., 0, 1024, 8192, 32768) to its corresponding\n * reasoning \"effort\" level, as used in the Google Gemini API (\"minimal\", \"low\", \"medium\", \"high\").\n *\n * This is the inverse of {@link convertReasoningEffortToReasoningTokens}. It is useful for\n * translating explicit numeric settings (often surfaced in raw API responses or configs)\n * into user-facing friendly reasoning levels/labels. The mapping relies on Google's\n * documented reasoning levels for different models:\n *\n * - -1 means default effort (per API documentation: this is \"minimal\" for flash-lite models\n *   and \"high\" (dynamic) for others).\n * - 0 means \"minimal\" unless the model is \"gemini-3-pro\", for which it maps to \"low\".\n * - <= 1024 tokens: \"low\"\n * - <= 8192 tokens: \"medium\" (unless model is \"gemini-3-pro\", for which it reverts to \"low\")\n * - > 8192: \"high\"\n *\n * Reference:\n *   https://ai.google.dev/gemini-api/docs/thinking#thinking-levels\n *   https://ai.google.dev/gemini-api/docs/openai#thinking\n *\n * @param {string | undefined} model\n *   The Gemini model name (e.g., \"gemini-3-pro\"). Used for model-specific special cases.\n * @param {number | undefined} reasoningTokens\n *   The token budget to convert. If undefined, the function returns undefined.\n * @returns {Lowercase<Gemini.Shared.ThinkingLevel> | undefined}\n *   The reasoning \"effort\" level (\"minimal\", \"low\", \"medium\", \"high\") or undefined if input is not valid.\n *\n * @example\n * convertReasoningTokensToReasoningEffort(\"gemini-3-pro\", 0) // \"low\"\n * convertReasoningTokensToReasoningEffort(\"gemini-1.5-pro\", 0) // \"minimal\"\n * convertReasoningTokensToReasoningEffort(undefined, 1024) // \"low\"\n * convertReasoningTokensToReasoningEffort(undefined, -1) // \"high\"\n * convertReasoningTokensToReasoningEffort(undefined, 9000) // \"high\"\n */\nexport function convertReasoningTokensToReasoningEffort(\n  model?: string,\n  reasoningTokens?: number\n): Gemini.Shared.ThinkingLevel | undefined {\n  if (typeof reasoningTokens === \"undefined\") {\n    return undefined;\n  } else if (reasoningTokens === -1) {\n    // -1 means \"minimal\" for flash-lite models and \"high\"/dynamic for others\n    // (\"default\" per https://ai.google.dev/gemini-api/docs/thinking#thinking-levels)\n    if (model && getModelLevel(model) === \"flash-lite\") {\n      return \"minimal\";\n    }\n    return \"high\";\n  } else if (reasoningTokens === 0) {\n    if (model?.startsWith(\"gemini-3-pro\")) {\n      return \"low\";\n    } else {\n      return \"minimal\";\n    }\n  } else if (reasoningTokens <= 1024) {\n    return \"low\";\n  } else if (reasoningTokens <= 8192) {\n    if (model?.startsWith(\"gemini-3-pro\")) {\n      return \"low\";\n    } else {\n      return \"medium\";\n    }\n  } else {\n    return \"high\";\n  }\n}\n\n/**\n * Infers and returns the Google platform type from the provided chat model parameters.\n *\n * This function helps determine which Google platform (e.g., Vertex AI on GCP or the public API)\n * should be used for calling Gemini/PaLM endpoints, based on the options provided in\n * {@link BaseChatGoogleParams} (such as model constructors or call options).\n */\nexport function convertParamsToPlatformType(params: {\n  platformType?: GooglePlatformType;\n  vertexai?: boolean;\n}): GooglePlatformType | undefined {\n  if (typeof params === \"undefined\") {\n    return undefined;\n  }\n  if (typeof params.platformType !== \"undefined\") {\n    return params.platformType;\n  }\n  if (params.vertexai === true) {\n    return \"gcp\";\n  }\n  return undefined;\n}\n\n/**\n * Returns the model family from a Gemini model name.\n * e.g. \"gemini-2.5-flash\" → \"gemini\"\n */\nexport function getModelFamily(model: string): string {\n  return model.split(\"-\")[0];\n}\n\n/**\n * Returns the model version from a Gemini model name.\n * e.g. \"gemini-2.5-flash\" → \"2.5\"\n */\nexport function getModelVersion(model: string): string {\n  return model.split(\"-\")[1];\n}\n\n/**\n * Returns the model level from a Gemini model name.\n * e.g. \"gemini-2.5-flash\" → \"flash\", \"gemini-2.5-flash-lite\" → \"flash-lite\"\n */\nexport function getModelLevel(model: string): string {\n  const parts = model.split(\"-\");\n  let ret = parts[2];\n  if (ret === \"flash\" && parts[3] === \"lite\") {\n    ret = \"flash-lite\";\n  }\n  return ret;\n}\n\n/**\n * Returns the model specialty from a Gemini model name.\n * e.g. \"gemini-2.5-flash-preview-image\" → \"image\",\n *      \"gemini-2.5-flash-preview-tts\" → \"tts\",\n *      \"gemini-2.5-flash\" → \"\"\n */\nexport function getModelSpecialty(model: string): string {\n  if (model.includes(\"image\")) {\n    return \"image\";\n  } else if (model.includes(\"tts\")) {\n    return \"tts\";\n  } else {\n    return \"\";\n  }\n}\n\nexport function getGoogleChatModelParams<TParams extends BaseChatGoogleParams>(\n  modelOrParams: string | TParams,\n  paramsArg?: Omit<TParams, \"model\">\n): TParams {\n  const model =\n    typeof modelOrParams === \"string\" ? modelOrParams : modelOrParams.model;\n  const params = typeof modelOrParams === \"string\" ? paramsArg : modelOrParams;\n  return { model, ...params } as TParams;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,wCACd,WACA,QACoB;CACpB,IAAI,WAAW,KAAA,GACb;CAKF,MAAM,YAAoB,WAAW,WAAW,kBAAkB,IAAI,IAAI;CAC1E,MAAM,YAAoB,WAAW,WAAW,kBAAkB,IAC9D,QACA;CAGJ,QADyB,OAAO,YACT,GAAvB;EACE,KAAK;EACL,KAAK,WACH,OAAO;EACT,KAAK,OAEH,OAAO;EACT,KAAK,UAEH,OAAO;EACT,KAAK,QAEH,OAAO;EACT,SACE;CACJ;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,wCACd,OACA,iBACyC;CACzC,IAAI,OAAO,oBAAoB,aAC7B;MACK,IAAI,oBAAoB,IAAI;EAGjC,IAAI,SAAS,cAAc,KAAK,MAAM,cACpC,OAAO;EAET,OAAO;CACT,OAAO,IAAI,oBAAoB,GAAG;EAChC,IAAI,OAAO,WAAW,cAAc,GAClC,OAAO;OAEP,OAAO;CAEX,OAAO,IAAI,mBAAmB,MAC5B,OAAO;MACF,IAAI,mBAAmB,MAAM;EAClC,IAAI,OAAO,WAAW,cAAc,GAClC,OAAO;OAEP,OAAO;CAEX,OACE,OAAO;AAEX;;;;;;;;AASA,SAAgB,4BAA4B,QAGT;CACjC,IAAI,OAAO,WAAW,aACpB;CAEF,IAAI,OAAO,OAAO,iBAAiB,aACjC,OAAO,OAAO;CAEhB,IAAI,OAAO,aAAa,MACtB,OAAO;AAGX;;;;;AAMA,SAAgB,eAAe,OAAuB;CACpD,OAAO,MAAM,MAAM,GAAG,CAAC,CAAC;AAC1B;;;;;AAMA,SAAgB,gBAAgB,OAAuB;CACrD,OAAO,MAAM,MAAM,GAAG,CAAC,CAAC;AAC1B;;;;;AAMA,SAAgB,cAAc,OAAuB;CACnD,MAAM,QAAQ,MAAM,MAAM,GAAG;CAC7B,IAAI,MAAM,MAAM;CAChB,IAAI,QAAQ,WAAW,MAAM,OAAO,QAClC,MAAM;CAER,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAAkB,OAAuB;CACvD,IAAI,MAAM,SAAS,OAAO,GACxB,OAAO;MACF,IAAI,MAAM,SAAS,KAAK,GAC7B,OAAO;MAEP,OAAO;AAEX;AAEA,SAAgB,yBACd,eACA,WACS;CAIT,OAAO;EAAE,OAFP,OAAO,kBAAkB,WAAW,gBAAgB,cAAc;EAEpD,GADD,OAAO,kBAAkB,WAAW,YAAY;CACrC;AAC5B"}

package/dist/converters/{params.js → shared/params.js}

@@ -1,5 +1,4 @@
-import { settableServiceTier } from "../chat_models/types.js";
-//#region src/converters/params.ts
+// src/converters/shared/params.ts
 /**
 * Converts a reasoning "effort" level value (e.g., "minimal", "low", "medium", "high")
 * to a corresponding reasoning token budget, depending on the target Gemini model.
@@ -72,7 +71,7 @@ function convertReasoningEffortToReasoningTokens(modelName, effort) {
 *   The Gemini model name (e.g., "gemini-3-pro"). Used for model-specific special cases.
 * @param {number | undefined} reasoningTokens
 *   The token budget to convert. If undefined, the function returns undefined.
-* @returns {Lowercase<Gemini.ThinkingLevel> | undefined}
+* @returns {Lowercase<Gemini.Shared.ThinkingLevel> | undefined}
 *   The reasoning "effort" level ("minimal", "low", "medium", "high") or undefined if input is not valid.
 *
 * @example
@@ -143,95 +142,12 @@ function getModelSpecialty(model) {
 	else if (model.includes("tts")) return "tts";
 	else return "";
 }
-const MINIMAL_THINKING_LEVEL_MODELS = [
-	"gemini-3-flash",
-	"gemini-3.1-flash-lite",
-	"gemini-3.5-flash",
-	"gemini-3.6-flash"
-];
-function supportsMinimalThinkingLevel(model) {
-	return MINIMAL_THINKING_LEVEL_MODELS.some((prefix) => model.startsWith(prefix));
+function getGoogleChatModelParams(modelOrParams, paramsArg) {
+	return {
+		model: typeof modelOrParams === "string" ? modelOrParams : modelOrParams.model,
+		...typeof modelOrParams === "string" ? paramsArg : modelOrParams
+	};
 }
-/**
-* Builds the `thinkingConfig` object for the Gemini `generationConfig`,
-* translating user-facing reasoning fields into the wire format.
-*
-* @param model  The full Gemini model name (e.g. "gemini-2.5-flash").
-* @param fields The combined user/call-option fields.
-* @returns A populated {@link Gemini.ThinkingConfig}, or `{}`
-*          when thinking should not be explicitly configured.
-*/
-function convertFieldsToThinkingConfig(model, fields) {
-	let includeThoughts = true;
-	let thinkingBudget = fields?.maxReasoningTokens ?? fields?.thinkingBudget ?? convertReasoningEffortToReasoningTokens(model, fields?.reasoningEffort ?? fields?.thinkingLevel);
-	if (thinkingBudget === 0 || model.includes("pro") && thinkingBudget === 128) includeThoughts = false;
-	if (model.startsWith("gemini-2.5-pro") && typeof thinkingBudget !== "undefined") {
-		if (thinkingBudget >= 0 && thinkingBudget < 128) thinkingBudget = 128;
-	}
-	let thinkingLevel = (fields?.reasoningEffort ?? fields?.thinkingLevel ?? convertReasoningTokensToReasoningEffort(model, fields?.maxReasoningTokens ?? fields?.thinkingBudget))?.toUpperCase();
-	if (thinkingLevel === "MINIMAL") includeThoughts = false;
-	if (thinkingLevel === "MINIMAL" && getModelFamily(model) === "gemini" && Number(getModelVersion(model)) >= 3 && !supportsMinimalThinkingLevel(model)) thinkingLevel = "LOW";
-	if (model.startsWith("gemini-3-pro") && thinkingLevel === "MEDIUM") thinkingLevel = "HIGH";
-	const modelVersion = getModelVersion(model);
-	const modelSpecialty = getModelSpecialty(model);
-	if (modelVersion === "2.5" && modelSpecialty === "image" || typeof thinkingBudget === "undefined" || typeof thinkingLevel === "undefined") return;
-	const thinkingConfig = { includeThoughts };
-	if (modelSpecialty === "") {
-		if (model.startsWith("gemini-2.5")) thinkingConfig.thinkingBudget = thinkingBudget;
-		else thinkingConfig.thinkingLevel = thinkingLevel;
-	}
-	return thinkingConfig;
-}
-/**
-* Builds the `speechConfig` object for the Gemini `generationConfig`,
-* normalising the user-friendly simplified forms into the wire format.
-*
-* @param fields The combined user/call-option fields.
-* @returns A populated {@link Gemini.SpeechConfig}, or `{}`
-*          when no speech config was provided.
-*/
-function convertFieldsToSpeechConfig(fields) {
-	const config = fields.speechConfig;
-	if (typeof config === "undefined") return;
-	function isSpeechConfig(config) {
-		return typeof config === "object" && (Object.hasOwn(config, "voiceConfig") || Object.hasOwn(config, "multiSpeakerVoiceConfig"));
-	}
-	function hasLanguage(config) {
-		return typeof config === "object" && Object.hasOwn(config, "languageCode");
-	}
-	function hasVoice(config) {
-		return Object.hasOwn(config, "voice");
-	}
-	if (isSpeechConfig(config)) return config;
-	let languageCode;
-	let voice;
-	if (hasLanguage(config)) {
-		languageCode = config.languageCode;
-		voice = hasVoice(config) ? config.voice : config.voices;
-	} else {
-		languageCode = void 0;
-		voice = config;
-	}
-	let ret;
-	if (typeof voice === "string") ret = { voiceConfig: { prebuiltVoiceConfig: { voiceName: voice } } };
-	else ret = { multiSpeakerVoiceConfig: { speakerVoiceConfigs: (Array.isArray(voice) ? voice : [voice]).map((v) => ({
-		speaker: v.speaker,
-		voiceConfig: { prebuiltVoiceConfig: { voiceName: v.name } }
-	})) } };
-	if (languageCode) ret.languageCode = languageCode;
-	return ret;
-}
-/**
-* Builds an object that can be included as part of the request
-* which will add a `speechConfig` attribute if appropriate.
-*/
-function convertFieldsToServiceTier(platform, fields) {
-	if (platform === "gcp") return {};
-	const serviceTier = fields.serviceTier;
-	if (!serviceTier || !settableServiceTier.includes(serviceTier)) return {};
-	return { serviceTier };
-}
-//#endregion
-export { convertFieldsToServiceTier, convertFieldsToSpeechConfig, convertFieldsToThinkingConfig, convertParamsToPlatformType, convertReasoningEffortToReasoningTokens, convertReasoningTokensToReasoningEffort, getModelFamily, getModelLevel, getModelSpecialty, getModelVersion };
+export { convertParamsToPlatformType, convertReasoningEffortToReasoningTokens, convertReasoningTokensToReasoningEffort, getGoogleChatModelParams, getModelFamily, getModelLevel, getModelSpecialty, getModelVersion };
 
 //# sourceMappingURL=params.js.map

package/dist/converters/shared/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","names":[],"sources":["../../../src/converters/shared/params.ts"],"sourcesContent":["import type {\n  BaseChatGoogleParams,\n  GooglePlatformType,\n  Gemini,\n} from \"../../chat_models/types.js\";\n\n/**\n * Converts a reasoning \"effort\" level value (e.g., \"minimal\", \"low\", \"medium\", \"high\")\n * to a corresponding reasoning token budget, depending on the target Gemini model.\n *\n * This mapping is essential when configuring Google Gemini API calls with reasoning\n * effort/level fields (as in the Gemini OpenAI-compatible API) or when translating\n * user-friendly configuration to explicit token budgets.\n *\n * - The mapping is refined to reflect the constraints documented by Google:\n *   - For \"gemini-2.5-flash\" models, token budgets may be set as low as 0 and up to 24k.\n *   - For other Gemini models, minimum is 128, maximum is 32k.\n * - Standard effort levels and their token mappings:\n *   - \"none\" / \"minimal\": lowest allowed (minTokens)\n *   - \"low\": 1k tokens\n *   - \"medium\": 8k tokens\n *   - \"high\": maximum allowed for the model (maxTokens)\n * - See reference:\n *   https://ai.google.dev/gemini-api/docs/thinking#thinking-levels\n *   https://ai.google.dev/gemini-api/docs/openai#thinking\n *\n * @param {string | undefined} modelName\n *   The Gemini model name (e.g., \"gemini-2.5-flash\"). Used to determine token range constraints.\n * @param {string | undefined} effort\n *   The reasoning effort level: one of \"none\", \"minimal\", \"low\", \"medium\", \"high\"\n *   (case-insensitive). If undefined, the function returns undefined.\n * @returns {number | undefined}\n *   The corresponding token count for the given effort and model. Returns undefined if\n *   the effort is not recognized or not provided.\n *\n * @example\n * convertReasoningEffortToReasoningTokens(\"gemini-2.5-flash\", \"medium\") // 8192\n * convertReasoningEffortToReasoningTokens(\"gemini-1.5-pro\", \"high\") // 32768\n * convertReasoningEffortToReasoningTokens(\"gemini-2.5-flash\", \"none\") // 0\n * convertReasoningEffortToReasoningTokens(undefined, \"low\") // 1024\n */\nexport function convertReasoningEffortToReasoningTokens(\n  modelName?: string,\n  effort?: string\n): number | undefined {\n  if (effort === undefined) {\n    return undefined;\n  }\n\n  // gemini-2.5-flash and -flash-lite can be disabled. Others can't.\n  // https://ai.google.dev/gemini-api/docs/thinking#thinking-levels\n  const minTokens: number = modelName?.startsWith(\"gemini-2.5-flash\") ? 0 : 128;\n  const maxTokens: number = modelName?.startsWith(\"gemini-2.5-flash\")\n    ? 24 * 1024\n    : 32 * 1024;\n\n  const normalizedEffort = effort.toLowerCase();\n  switch (normalizedEffort) {\n    case \"none\":\n    case \"minimal\":\n      return minTokens;\n    case \"low\":\n      // Defined as 1k by https://ai.google.dev/gemini-api/docs/openai#thinking\n      return 1024;\n    case \"medium\":\n      // Defined as 8k by https://ai.google.dev/gemini-api/docs/openai#thinking\n      return 8 * 1024;\n    case \"high\":\n      // Defined as 24k or 32k (model-dependent) by https://ai.google.dev/gemini-api/docs/openai#thinking\n      return maxTokens;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Converts a reasoning token budget (e.g., 0, 1024, 8192, 32768) to its corresponding\n * reasoning \"effort\" level, as used in the Google Gemini API (\"minimal\", \"low\", \"medium\", \"high\").\n *\n * This is the inverse of {@link convertReasoningEffortToReasoningTokens}. It is useful for\n * translating explicit numeric settings (often surfaced in raw API responses or configs)\n * into user-facing friendly reasoning levels/labels. The mapping relies on Google's\n * documented reasoning levels for different models:\n *\n * - -1 means default effort (per API documentation: this is \"minimal\" for flash-lite models\n *   and \"high\" (dynamic) for others).\n * - 0 means \"minimal\" unless the model is \"gemini-3-pro\", for which it maps to \"low\".\n * - <= 1024 tokens: \"low\"\n * - <= 8192 tokens: \"medium\" (unless model is \"gemini-3-pro\", for which it reverts to \"low\")\n * - > 8192: \"high\"\n *\n * Reference:\n *   https://ai.google.dev/gemini-api/docs/thinking#thinking-levels\n *   https://ai.google.dev/gemini-api/docs/openai#thinking\n *\n * @param {string | undefined} model\n *   The Gemini model name (e.g., \"gemini-3-pro\"). Used for model-specific special cases.\n * @param {number | undefined} reasoningTokens\n *   The token budget to convert. If undefined, the function returns undefined.\n * @returns {Lowercase<Gemini.Shared.ThinkingLevel> | undefined}\n *   The reasoning \"effort\" level (\"minimal\", \"low\", \"medium\", \"high\") or undefined if input is not valid.\n *\n * @example\n * convertReasoningTokensToReasoningEffort(\"gemini-3-pro\", 0) // \"low\"\n * convertReasoningTokensToReasoningEffort(\"gemini-1.5-pro\", 0) // \"minimal\"\n * convertReasoningTokensToReasoningEffort(undefined, 1024) // \"low\"\n * convertReasoningTokensToReasoningEffort(undefined, -1) // \"high\"\n * convertReasoningTokensToReasoningEffort(undefined, 9000) // \"high\"\n */\nexport function convertReasoningTokensToReasoningEffort(\n  model?: string,\n  reasoningTokens?: number\n): Gemini.Shared.ThinkingLevel | undefined {\n  if (typeof reasoningTokens === \"undefined\") {\n    return undefined;\n  } else if (reasoningTokens === -1) {\n    // -1 means \"minimal\" for flash-lite models and \"high\"/dynamic for others\n    // (\"default\" per https://ai.google.dev/gemini-api/docs/thinking#thinking-levels)\n    if (model && getModelLevel(model) === \"flash-lite\") {\n      return \"minimal\";\n    }\n    return \"high\";\n  } else if (reasoningTokens === 0) {\n    if (model?.startsWith(\"gemini-3-pro\")) {\n      return \"low\";\n    } else {\n      return \"minimal\";\n    }\n  } else if (reasoningTokens <= 1024) {\n    return \"low\";\n  } else if (reasoningTokens <= 8192) {\n    if (model?.startsWith(\"gemini-3-pro\")) {\n      return \"low\";\n    } else {\n      return \"medium\";\n    }\n  } else {\n    return \"high\";\n  }\n}\n\n/**\n * Infers and returns the Google platform type from the provided chat model parameters.\n *\n * This function helps determine which Google platform (e.g., Vertex AI on GCP or the public API)\n * should be used for calling Gemini/PaLM endpoints, based on the options provided in\n * {@link BaseChatGoogleParams} (such as model constructors or call options).\n */\nexport function convertParamsToPlatformType(params: {\n  platformType?: GooglePlatformType;\n  vertexai?: boolean;\n}): GooglePlatformType | undefined {\n  if (typeof params === \"undefined\") {\n    return undefined;\n  }\n  if (typeof params.platformType !== \"undefined\") {\n    return params.platformType;\n  }\n  if (params.vertexai === true) {\n    return \"gcp\";\n  }\n  return undefined;\n}\n\n/**\n * Returns the model family from a Gemini model name.\n * e.g. \"gemini-2.5-flash\" → \"gemini\"\n */\nexport function getModelFamily(model: string): string {\n  return model.split(\"-\")[0];\n}\n\n/**\n * Returns the model version from a Gemini model name.\n * e.g. \"gemini-2.5-flash\" → \"2.5\"\n */\nexport function getModelVersion(model: string): string {\n  return model.split(\"-\")[1];\n}\n\n/**\n * Returns the model level from a Gemini model name.\n * e.g. \"gemini-2.5-flash\" → \"flash\", \"gemini-2.5-flash-lite\" → \"flash-lite\"\n */\nexport function getModelLevel(model: string): string {\n  const parts = model.split(\"-\");\n  let ret = parts[2];\n  if (ret === \"flash\" && parts[3] === \"lite\") {\n    ret = \"flash-lite\";\n  }\n  return ret;\n}\n\n/**\n * Returns the model specialty from a Gemini model name.\n * e.g. \"gemini-2.5-flash-preview-image\" → \"image\",\n *      \"gemini-2.5-flash-preview-tts\" → \"tts\",\n *      \"gemini-2.5-flash\" → \"\"\n */\nexport function getModelSpecialty(model: string): string {\n  if (model.includes(\"image\")) {\n    return \"image\";\n  } else if (model.includes(\"tts\")) {\n    return \"tts\";\n  } else {\n    return \"\";\n  }\n}\n\nexport function getGoogleChatModelParams<TParams extends BaseChatGoogleParams>(\n  modelOrParams: string | TParams,\n  paramsArg?: Omit<TParams, \"model\">\n): TParams {\n  const model =\n    typeof modelOrParams === \"string\" ? modelOrParams : modelOrParams.model;\n  const params = typeof modelOrParams === \"string\" ? paramsArg : modelOrParams;\n  return { model, ...params } as TParams;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,wCACd,WACA,QACoB;CACpB,IAAI,WAAW,KAAA,GACb;CAKF,MAAM,YAAoB,WAAW,WAAW,kBAAkB,IAAI,IAAI;CAC1E,MAAM,YAAoB,WAAW,WAAW,kBAAkB,IAC9D,QACA;CAGJ,QADyB,OAAO,YACT,GAAvB;EACE,KAAK;EACL,KAAK,WACH,OAAO;EACT,KAAK,OAEH,OAAO;EACT,KAAK,UAEH,OAAO;EACT,KAAK,QAEH,OAAO;EACT,SACE;CACJ;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,wCACd,OACA,iBACyC;CACzC,IAAI,OAAO,oBAAoB,aAC7B;MACK,IAAI,oBAAoB,IAAI;EAGjC,IAAI,SAAS,cAAc,KAAK,MAAM,cACpC,OAAO;EAET,OAAO;CACT,OAAO,IAAI,oBAAoB,GAAG;EAChC,IAAI,OAAO,WAAW,cAAc,GAClC,OAAO;OAEP,OAAO;CAEX,OAAO,IAAI,mBAAmB,MAC5B,OAAO;MACF,IAAI,mBAAmB,MAAM;EAClC,IAAI,OAAO,WAAW,cAAc,GAClC,OAAO;OAEP,OAAO;CAEX,OACE,OAAO;AAEX;;;;;;;;AASA,SAAgB,4BAA4B,QAGT;CACjC,IAAI,OAAO,WAAW,aACpB;CAEF,IAAI,OAAO,OAAO,iBAAiB,aACjC,OAAO,OAAO;CAEhB,IAAI,OAAO,aAAa,MACtB,OAAO;AAGX;;;;;AAMA,SAAgB,eAAe,OAAuB;CACpD,OAAO,MAAM,MAAM,GAAG,CAAC,CAAC;AAC1B;;;;;AAMA,SAAgB,gBAAgB,OAAuB;CACrD,OAAO,MAAM,MAAM,GAAG,CAAC,CAAC;AAC1B;;;;;AAMA,SAAgB,cAAc,OAAuB;CACnD,MAAM,QAAQ,MAAM,MAAM,GAAG;CAC7B,IAAI,MAAM,MAAM;CAChB,IAAI,QAAQ,WAAW,MAAM,OAAO,QAClC,MAAM;CAER,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAAkB,OAAuB;CACvD,IAAI,MAAM,SAAS,OAAO,GACxB,OAAO;MACF,IAAI,MAAM,SAAS,KAAK,GAC7B,OAAO;MAEP,OAAO;AAEX;AAEA,SAAgB,yBACd,eACA,WACS;CAIT,OAAO;EAAE,OAFP,OAAO,kBAAkB,WAAW,gBAAgB,cAAc;EAEpD,GADD,OAAO,kBAAkB,WAAW,YAAY;CACrC;AAC5B"}

package/dist/index.cjs

@@ -1,7 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_base = require("./chat_models/handlers/base.cjs");
+const require_generate_content = require("./chat_models/handlers/generate_content.cjs");
+const require_interactions = require("./chat_models/handlers/interactions.cjs");
+const require_base$1 = require("./chat_models/base.cjs");
 const require_index = require("./chat_models/index.cjs");
 const require_handler = require("./utils/handler.cjs");
+exports.BaseChatGoogle = require_base$1.BaseChatGoogle;
 exports.ChatGoogle = require_index.ChatGoogle;
+exports.GenerateContentApiHandler = require_generate_content.GenerateContentApiHandler;
+exports.GoogleChatApiHandler = require_base.GoogleChatApiHandler;
 exports.GoogleRequestCallbackHandler = require_handler.GoogleRequestCallbackHandler;
 exports.GoogleRequestLogger = require_handler.GoogleRequestLogger;
 exports.GoogleRequestRecorder = require_handler.GoogleRequestRecorder;
+exports.InteractionsApiHandler = require_interactions.InteractionsApiHandler;

package/dist/index.d.cts

@@ -1,3 +1,8 @@
+import { GoogleChatApiHandler } from "./chat_models/handlers/base.cjs";
+import { BaseChatGoogleCallOptions, BaseChatGoogleFields, BaseChatGoogleParams, ChatGoogleFields, GenerateContentApiHandlerParams, GenerateContentFields, GenerateContentInvocationParams, GenerateContentSpecificFields, GoogleChatApiHandlerConfig, GoogleChatApiHandlerFactory, GoogleChatApiHandlerParams, InteractionsApiHandlerParams, InteractionsFields, InteractionsInvocationParams, InteractionsSpecificFields } from "./chat_models/types.cjs";
+import { GenerateContentApiHandler } from "./chat_models/handlers/generate_content.cjs";
+import { InteractionsApiHandler } from "./chat_models/handlers/interactions.cjs";
+import { BaseChatGoogle } from "./chat_models/base.cjs";
 import { ChatGoogle, ChatGoogleCallOptions, ChatGoogleParams } from "./chat_models/index.cjs";
 import { GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.cjs";
-export { ChatGoogle, ChatGoogleCallOptions, ChatGoogleParams, GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder };
+export { BaseChatGoogle, type BaseChatGoogleCallOptions, type BaseChatGoogleFields, type BaseChatGoogleParams, ChatGoogle, ChatGoogleCallOptions, type ChatGoogleFields, ChatGoogleParams, GenerateContentApiHandler, type GenerateContentApiHandlerParams, type GenerateContentFields, type GenerateContentInvocationParams, type GenerateContentSpecificFields, GoogleChatApiHandler, type GoogleChatApiHandlerConfig, type GoogleChatApiHandlerFactory, type GoogleChatApiHandlerParams, GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder, InteractionsApiHandler, type InteractionsApiHandlerParams, type InteractionsFields, type InteractionsInvocationParams, type InteractionsSpecificFields };

package/dist/index.d.ts

@@ -1,3 +1,8 @@
+import { GoogleChatApiHandler } from "./chat_models/handlers/base.js";
+import { BaseChatGoogleCallOptions, BaseChatGoogleFields, BaseChatGoogleParams, ChatGoogleFields, GenerateContentApiHandlerParams, GenerateContentFields, GenerateContentInvocationParams, GenerateContentSpecificFields, GoogleChatApiHandlerConfig, GoogleChatApiHandlerFactory, GoogleChatApiHandlerParams, InteractionsApiHandlerParams, InteractionsFields, InteractionsInvocationParams, InteractionsSpecificFields } from "./chat_models/types.js";
+import { GenerateContentApiHandler } from "./chat_models/handlers/generate_content.js";
+import { InteractionsApiHandler } from "./chat_models/handlers/interactions.js";
+import { BaseChatGoogle } from "./chat_models/base.js";
 import { ChatGoogle, ChatGoogleCallOptions, ChatGoogleParams } from "./chat_models/index.js";
 import { GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.js";
-export { ChatGoogle, ChatGoogleCallOptions, ChatGoogleParams, GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder };
+export { BaseChatGoogle, type BaseChatGoogleCallOptions, type BaseChatGoogleFields, type BaseChatGoogleParams, ChatGoogle, ChatGoogleCallOptions, type ChatGoogleFields, ChatGoogleParams, GenerateContentApiHandler, type GenerateContentApiHandlerParams, type GenerateContentFields, type GenerateContentInvocationParams, type GenerateContentSpecificFields, GoogleChatApiHandler, type GoogleChatApiHandlerConfig, type GoogleChatApiHandlerFactory, type GoogleChatApiHandlerParams, GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder, InteractionsApiHandler, type InteractionsApiHandlerParams, type InteractionsFields, type InteractionsInvocationParams, type InteractionsSpecificFields };

package/dist/index.js

@@ -1,3 +1,7 @@
+import { GoogleChatApiHandler } from "./chat_models/handlers/base.js";
+import { GenerateContentApiHandler } from "./chat_models/handlers/generate_content.js";
+import { InteractionsApiHandler } from "./chat_models/handlers/interactions.js";
+import { BaseChatGoogle } from "./chat_models/base.js";
 import { ChatGoogle } from "./chat_models/index.js";
 import { GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.js";
-export { ChatGoogle, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder };
+export { BaseChatGoogle, ChatGoogle, GenerateContentApiHandler, GoogleChatApiHandler, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder, InteractionsApiHandler };

package/dist/node.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_handler = require("./utils/handler.cjs");
 const require_node = require("./chat_models/node.cjs");
+const require_handler = require("./utils/handler.cjs");
 exports.ChatGoogle = require_node.ChatGoogle;
 exports.GoogleRequestCallbackHandler = require_handler.GoogleRequestCallbackHandler;
 exports.GoogleRequestLogger = require_handler.GoogleRequestLogger;

package/dist/node.d.cts

@@ -1,3 +1,3 @@
-import { GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.cjs";
 import { ChatGoogle as ChatGoogleNode, ChatGoogleParams as ChatGoogleNodeParams } from "./chat_models/node.cjs";
+import { GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.cjs";
 export { ChatGoogleNode as ChatGoogle, type ChatGoogleNodeParams as ChatGoogleParams, GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder };

package/dist/node.d.ts

@@ -1,3 +1,3 @@
-import { GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.js";
 import { ChatGoogle as ChatGoogleNode, ChatGoogleParams as ChatGoogleNodeParams } from "./chat_models/node.js";
+import { GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.js";
 export { ChatGoogleNode as ChatGoogle, type ChatGoogleNodeParams as ChatGoogleParams, GoogleCustomEventInfo, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder };

package/dist/node.js

@@ -1,3 +1,3 @@
-import { GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.js";
 import { ChatGoogle as ChatGoogleNode } from "./chat_models/node.js";
+import { GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder } from "./utils/handler.js";
 export { ChatGoogleNode as ChatGoogle, GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder };

package/dist/utils/errors.cjs

@@ -1,6 +1,6 @@
 const require_misc = require("./misc.cjs");
 let _langchain_core_errors = require("@langchain/core/errors");
-//#region src/utils/errors.ts
+// src/utils/errors.ts
 const ns = _langchain_core_errors.ns.sub("google");
 const RETRYABLE_STATUS_CODES = [
 	408,
@@ -549,7 +549,6 @@ var InvalidInputError = class extends ns.brand(GoogleError, "invalid-input") {
 		(0, _langchain_core_errors.stampRetryable)(this, false);
 	}
 };
-//#endregion
 exports.AuthError = AuthError;
 exports.ConfigurationError = ConfigurationError;
 exports.GoogleError = GoogleError;

package/dist/utils/errors.js

@@ -1,6 +1,6 @@
 import { iife } from "./misc.js";
 import { LangChainError, ns, stampRetryable } from "@langchain/core/errors";
-//#region src/utils/errors.ts
+// src/utils/errors.ts
 const ns$1 = ns.sub("google");
 const RETRYABLE_STATUS_CODES = [
 	408,
@@ -549,7 +549,6 @@ var InvalidInputError = class extends ns$1.brand(GoogleError, "invalid-input") {
 		stampRetryable(this, false);
 	}
 };
-//#endregion
 export { AuthError, ConfigurationError, GoogleError, InvalidInputError, InvalidToolError, MalformedOutputError, NoCandidatesError, PromptBlockedError, RequestError, ToolCallNotFoundError };
 
 //# sourceMappingURL=errors.js.map

package/dist/utils/gcp-auth.cjs

@@ -1,7 +1,7 @@
-const require_const = require("../const.cjs");
-const require_misc = require("./misc.cjs");
 const require_errors = require("./errors.cjs");
-//#region src/utils/gcp-auth.ts
+const require_misc = require("./misc.cjs");
+const require_const = require("../const.cjs");
+// src/utils/gcp-auth.ts
 /**
 * GCP authentication utilities.
 *
@@ -204,7 +204,6 @@ async function getGCPCredentialsAccessToken(credentials, scopes = require_const.
 	});
 	return await promise.then((data) => data.token);
 }
-//#endregion
 exports.getGCPCredentialsAccessToken = getGCPCredentialsAccessToken;
 exports.getGCPCustomToken = getGCPCustomToken;
 exports.getGCPPrivateKey = getGCPPrivateKey;

package/dist/utils/gcp-auth.d.cts

@@ -1,4 +1,3 @@
-//#region src/utils/gcp-auth.d.ts
 /**
  * GCP authentication utilities.
  *
@@ -38,5 +37,4 @@ export interface GCPCredentials {
   /** The URL for this service account's x509 certificate */
   client_x509_cert_url: string;
 }
-//#endregion
 //# sourceMappingURL=gcp-auth.d.cts.map

package/dist/utils/gcp-auth.d.ts

@@ -1,4 +1,3 @@
-//#region src/utils/gcp-auth.d.ts
 /**
  * GCP authentication utilities.
  *
@@ -38,5 +37,4 @@ export interface GCPCredentials {
   /** The URL for this service account's x509 certificate */
   client_x509_cert_url: string;
 }
-//#endregion
 //# sourceMappingURL=gcp-auth.d.ts.map

package/dist/utils/gcp-auth.js

@@ -1,7 +1,7 @@
-import { VERTEX_AI_AUTH_SCOPES } from "../const.js";
-import { iife } from "./misc.js";
 import { AuthError } from "./errors.js";
-//#region src/utils/gcp-auth.ts
+import { iife } from "./misc.js";
+import { VERTEX_AI_AUTH_SCOPES } from "../const.js";
+// src/utils/gcp-auth.ts
 /**
 * GCP authentication utilities.
 *
@@ -204,7 +204,6 @@ async function getGCPCredentialsAccessToken(credentials, scopes = VERTEX_AI_AUTH
 	});
 	return await promise.then((data) => data.token);
 }
-//#endregion
 export { getGCPCredentialsAccessToken, getGCPCustomToken, getGCPPrivateKey, normalizeGCPCredentials };
 
 //# sourceMappingURL=gcp-auth.js.map

package/dist/utils/handler.cjs

@@ -1,5 +1,5 @@
 let _langchain_core_callbacks_base = require("@langchain/core/callbacks/base");
-//#region src/utils/handler.ts
+// src/utils/handler.ts
 var GoogleRequestCallbackHandler = class extends _langchain_core_callbacks_base.BaseCallbackHandler {
 	customEventInfo(eventName) {
 		const names = eventName.split("-");
@@ -57,7 +57,6 @@ var GoogleRequestRecorder = class extends GoogleRequestCallbackHandler {
 		this.chunk.push(data);
 	}
 };
-//#endregion
 exports.GoogleRequestCallbackHandler = GoogleRequestCallbackHandler;
 exports.GoogleRequestLogger = GoogleRequestLogger;
 exports.GoogleRequestRecorder = GoogleRequestRecorder;

package/dist/utils/handler.d.cts

@@ -1,5 +1,4 @@
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
-//#region src/utils/handler.d.ts
 export interface GoogleCustomEventInfo {
   subEvent: string;
   module: string;
@@ -28,5 +27,4 @@ export declare class GoogleRequestRecorder extends GoogleRequestCallbackHandler
   handleCustomResponseEvent(_eventName: string, _eventInfo: GoogleCustomEventInfo, data: any, _runId: string, _tags?: string[], _metadata?: Record<string, any>): any;
   handleCustomChunkEvent(_eventName: string, _eventInfo: GoogleCustomEventInfo, data: any, _runId: string, _tags?: string[], _metadata?: Record<string, any>): any;
 }
-//#endregion
 //# sourceMappingURL=handler.d.cts.map

package/dist/utils/handler.d.ts

@@ -1,5 +1,4 @@
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
-//#region src/utils/handler.d.ts
 export interface GoogleCustomEventInfo {
   subEvent: string;
   module: string;
@@ -28,5 +27,4 @@ export declare class GoogleRequestRecorder extends GoogleRequestCallbackHandler
   handleCustomResponseEvent(_eventName: string, _eventInfo: GoogleCustomEventInfo, data: any, _runId: string, _tags?: string[], _metadata?: Record<string, any>): any;
   handleCustomChunkEvent(_eventName: string, _eventInfo: GoogleCustomEventInfo, data: any, _runId: string, _tags?: string[], _metadata?: Record<string, any>): any;
 }
-//#endregion
 //# sourceMappingURL=handler.d.ts.map

package/dist/utils/handler.js

@@ -1,5 +1,5 @@
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
-//#region src/utils/handler.ts
+// src/utils/handler.ts
 var GoogleRequestCallbackHandler = class extends BaseCallbackHandler {
 	customEventInfo(eventName) {
 		const names = eventName.split("-");
@@ -57,7 +57,6 @@ var GoogleRequestRecorder = class extends GoogleRequestCallbackHandler {
 		this.chunk.push(data);
 	}
 };
-//#endregion
 export { GoogleRequestCallbackHandler, GoogleRequestLogger, GoogleRequestRecorder };
 
 //# sourceMappingURL=handler.js.map

package/dist/utils/metadata.cjs

@@ -1,4 +1,4 @@
-//#region src/utils/metadata.ts
+// src/utils/metadata.ts
 /**
 * Computes the delta between two token detail objects by subtracting
 * each field in `previous` from the corresponding field in `current`.
@@ -50,7 +50,14 @@ function subtractUsageMetadata(current, previous) {
 		output_token_details: subtractTokenDetails(current.output_token_details, previous.output_token_details)
 	};
 }
-//#endregion
+function usageMetadataToTokenUsage(usageMetadata) {
+	return {
+		promptTokens: usageMetadata.input_tokens,
+		completionTokens: usageMetadata.output_tokens,
+		totalTokens: usageMetadata.total_tokens
+	};
+}
 exports.subtractUsageMetadata = subtractUsageMetadata;
+exports.usageMetadataToTokenUsage = usageMetadataToTokenUsage;
 
 //# sourceMappingURL=metadata.cjs.map

package/dist/utils/metadata.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.cjs","names":[],"sources":["../../src/utils/metadata.ts"],"sourcesContent":["import type {\n  UsageMetadata,\n  InputTokenDetails,\n  OutputTokenDetails,\n} from \"@langchain/core/messages\";\n\n/**\n * Computes the delta between two token detail objects by subtracting\n * each field in `previous` from the corresponding field in `current`.\n *\n * This is used to convert cumulative token detail counts (as reported\n * by the Gemini streaming API) into per-chunk deltas that can be\n * correctly summed by {@link mergeUsageMetadata} during chunk\n * concatenation.\n *\n * @param current - The cumulative token details from the current chunk.\n * @param previous - The cumulative token details from the previous chunk.\n * @returns The per-chunk delta, or `undefined` if `current` is undefined.\n */\nfunction subtractTokenDetails<T extends InputTokenDetails | OutputTokenDetails>(\n  current?: T,\n  previous?: T\n): T | undefined {\n  if (!current) return undefined;\n  if (!previous) return current;\n  const result = {} as Record<string, number>;\n  for (const key of Object.keys(current) as (keyof T)[]) {\n    const cur = current[key] as number | undefined;\n    const prev = previous[key] as number | undefined;\n    if (cur !== undefined) {\n      result[key as string] = cur - (prev ?? 0);\n    }\n  }\n  return result as T;\n}\n\n/**\n * Computes the delta between two {@link UsageMetadata} objects by\n * subtracting each field in `previous` from the corresponding field in\n * `current`.\n *\n * The Gemini streaming API reports **cumulative** token counts on every\n * SSE chunk, but `@langchain/core`'s `mergeUsageMetadata` combines\n * values via addition. Emitting raw cumulative values on each\n * `AIMessageChunk` would therefore inflate the totals when chunks are\n * concatenated. This function converts cumulative values into per-chunk\n * deltas so that additive merging produces the correct final totals.\n *\n * @param current - The cumulative usage metadata from the current chunk.\n * @param previous - The cumulative usage metadata from the previous\n *   chunk, or `undefined` for the first chunk in the stream.\n * @returns The per-chunk delta usage metadata.\n */\nexport function subtractUsageMetadata(\n  current: UsageMetadata,\n  previous?: UsageMetadata\n): UsageMetadata {\n  if (!previous) return current;\n  return {\n    input_tokens: current.input_tokens - previous.input_tokens,\n    output_tokens: current.output_tokens - previous.output_tokens,\n    total_tokens: current.total_tokens - previous.total_tokens,\n    input_token_details: subtractTokenDetails(\n      current.input_token_details,\n      previous.input_token_details\n    ),\n    output_token_details: subtractTokenDetails(\n      current.output_token_details,\n      previous.output_token_details\n    ),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,SAAS,qBACP,SACA,UACe;CACf,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,CAAC,UAAU,OAAO;CACtB,MAAM,SAAS,CAAC;CAChB,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GAAkB;EACrD,MAAM,MAAM,QAAQ;EACpB,MAAM,OAAO,SAAS;EACtB,IAAI,QAAQ,KAAA,GACV,OAAO,OAAiB,OAAO,QAAQ;CAE3C;CACA,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,sBACd,SACA,UACe;CACf,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO;EACL,cAAc,QAAQ,eAAe,SAAS;EAC9C,eAAe,QAAQ,gBAAgB,SAAS;EAChD,cAAc,QAAQ,eAAe,SAAS;EAC9C,qBAAqB,qBACnB,QAAQ,qBACR,SAAS,mBACX;EACA,sBAAsB,qBACpB,QAAQ,sBACR,SAAS,oBACX;CACF;AACF"}
+{"version":3,"file":"metadata.cjs","names":[],"sources":["../../src/utils/metadata.ts"],"sourcesContent":["import type {\n  UsageMetadata,\n  InputTokenDetails,\n  OutputTokenDetails,\n} from \"@langchain/core/messages\";\n\n/**\n * Computes the delta between two token detail objects by subtracting\n * each field in `previous` from the corresponding field in `current`.\n *\n * This is used to convert cumulative token detail counts (as reported\n * by the Gemini streaming API) into per-chunk deltas that can be\n * correctly summed by {@link mergeUsageMetadata} during chunk\n * concatenation.\n *\n * @param current - The cumulative token details from the current chunk.\n * @param previous - The cumulative token details from the previous chunk.\n * @returns The per-chunk delta, or `undefined` if `current` is undefined.\n */\nfunction subtractTokenDetails<T extends InputTokenDetails | OutputTokenDetails>(\n  current?: T,\n  previous?: T\n): T | undefined {\n  if (!current) return undefined;\n  if (!previous) return current;\n  const result = {} as Record<string, number>;\n  for (const key of Object.keys(current) as (keyof T)[]) {\n    const cur = current[key] as number | undefined;\n    const prev = previous[key] as number | undefined;\n    if (cur !== undefined) {\n      result[key as string] = cur - (prev ?? 0);\n    }\n  }\n  return result as T;\n}\n\n/**\n * Computes the delta between two {@link UsageMetadata} objects by\n * subtracting each field in `previous` from the corresponding field in\n * `current`.\n *\n * The Gemini streaming API reports **cumulative** token counts on every\n * SSE chunk, but `@langchain/core`'s `mergeUsageMetadata` combines\n * values via addition. Emitting raw cumulative values on each\n * `AIMessageChunk` would therefore inflate the totals when chunks are\n * concatenated. This function converts cumulative values into per-chunk\n * deltas so that additive merging produces the correct final totals.\n *\n * @param current - The cumulative usage metadata from the current chunk.\n * @param previous - The cumulative usage metadata from the previous\n *   chunk, or `undefined` for the first chunk in the stream.\n * @returns The per-chunk delta usage metadata.\n */\nexport function subtractUsageMetadata(\n  current: UsageMetadata,\n  previous?: UsageMetadata\n): UsageMetadata {\n  if (!previous) return current;\n  return {\n    input_tokens: current.input_tokens - previous.input_tokens,\n    output_tokens: current.output_tokens - previous.output_tokens,\n    total_tokens: current.total_tokens - previous.total_tokens,\n    input_token_details: subtractTokenDetails(\n      current.input_token_details,\n      previous.input_token_details\n    ),\n    output_token_details: subtractTokenDetails(\n      current.output_token_details,\n      previous.output_token_details\n    ),\n  };\n}\n\nexport function usageMetadataToTokenUsage(usageMetadata: UsageMetadata) {\n  return {\n    promptTokens: usageMetadata.input_tokens,\n    completionTokens: usageMetadata.output_tokens,\n    totalTokens: usageMetadata.total_tokens,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,SAAS,qBACP,SACA,UACe;CACf,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,CAAC,UAAU,OAAO;CACtB,MAAM,SAAS,CAAC;CAChB,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GAAkB;EACrD,MAAM,MAAM,QAAQ;EACpB,MAAM,OAAO,SAAS;EACtB,IAAI,QAAQ,KAAA,GACV,OAAO,OAAiB,OAAO,QAAQ;CAE3C;CACA,OAAO;AACT;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,sBACd,SACA,UACe;CACf,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO;EACL,cAAc,QAAQ,eAAe,SAAS;EAC9C,eAAe,QAAQ,gBAAgB,SAAS;EAChD,cAAc,QAAQ,eAAe,SAAS;EAC9C,qBAAqB,qBACnB,QAAQ,qBACR,SAAS,mBACX;EACA,sBAAsB,qBACpB,QAAQ,sBACR,SAAS,oBACX;CACF;AACF;AAEA,SAAgB,0BAA0B,eAA8B;CACtE,OAAO;EACL,cAAc,cAAc;EAC5B,kBAAkB,cAAc;EAChC,aAAa,cAAc;CAC7B;AACF"}