@langchain/google 0.2.12 → 0.2.14

package/dist/chat_models/base.cjs

@@ -1,9 +1,10 @@
-const require_errors = require("../utils/errors.cjs");
 const require_profiles = require("./profiles.cjs");
+const require_errors = require("../utils/errors.cjs");
 const require_metadata = require("../utils/metadata.cjs");
-const require_params = require("../converters/shared/params.cjs");
-const require_generate_content = require("./handlers/generate_content.cjs");
 require("./handlers/index.cjs");
+const require_generate_content = require("./handlers/generate_content.cjs");
+const require_interactions = require("./handlers/interactions.cjs");
+const require_params = require("../converters/shared/params.cjs");
 let _langchain_core_utils_env = require("@langchain/core/utils/env");
 let _langchain_core_language_models_chat_models = require("@langchain/core/language_models/chat_models");
 let _langchain_core_messages = require("@langchain/core/messages");
@@ -11,7 +12,7 @@ let _langchain_core_utils_stream = require("@langchain/core/utils/stream");
 let _langchain_core_runnables = require("@langchain/core/runnables");
 let _langchain_core_language_models_structured_output = require("@langchain/core/language_models/structured_output");
 let _langchain_core_utils_gateway = require("@langchain/core/utils/gateway");
-//#region src/chat_models/base.ts
+// src/chat_models/base.ts
 function hasVertexCredentials(params) {
 	return typeof params.credentials !== "undefined" || typeof params.googleAuthOptions !== "undefined" || typeof (0, _langchain_core_utils_env.getEnvironmentVariable)("GOOGLE_CLOUD_CREDENTIALS") !== "undefined";
 }
@@ -19,11 +20,11 @@ function hasVertexCredentials(params) {
 * Resolves LangSmith gateway routing for Google chat model params.
 *
 * The LangSmith gateway exposes direct paths for the Gemini Developer API and
-* Vertex AI. An explicit `endpoint` suppresses gateway routing.
+* Vertex AI. An explicit `endpoint` or explicit credentials (`apiKey`,
+* `credentials`, `googleAuthOptions`) suppress gateway routing.
 *
 * When `LANGSMITH_GATEWAY` is set, this rewrites `endpoint` to the gateway
-* host and lets the gateway key take precedence over the provider key (which
-* then rides as the `x-goog-api-key` header via the ApiClient). The default
+* host and uses the gateway key as the API key. The default
 * `https` gateway host is written scheme-less (the URL builders prepend
 * `https://`); a non-`https` custom gateway keeps its scheme so it is not
 * forced to TLS.
@@ -36,7 +37,7 @@ function hasVertexCredentials(params) {
 */
 function applyGeminiGatewayParams(params) {
 	const p = params;
-	if (typeof p.endpoint !== "undefined") return { ...params };
+	if (typeof p.endpoint !== "undefined" || typeof p.apiKey !== "undefined" || typeof p.credentials !== "undefined" || typeof p.googleAuthOptions !== "undefined") return { ...params };
 	const platform = require_params.convertParamsToPlatformType(p) ?? (hasVertexCredentials(p) ? "gcp" : "gai");
 	const gatewayConfig = (0, _langchain_core_utils_gateway.resolveLangSmithGatewayConfig)({ providerPath: platform === "gcp" ? "vertex" : "gemini" });
 	if (typeof gatewayConfig.baseURL === "undefined") return { ...params };
@@ -45,7 +46,7 @@ function applyGeminiGatewayParams(params) {
 	const endpoint = gatewayUrl.protocol === "https:" ? `${gatewayUrl.host}${path}` : `${gatewayUrl.protocol}//${gatewayUrl.host}${path}`;
 	return {
 		...params,
-		apiKey: p.apiKey ?? gatewayConfig.apiKey,
+		apiKey: gatewayConfig.apiKey,
 		endpoint,
 		platformType: platform
 	};
@@ -70,7 +71,7 @@ var BaseChatGoogle = class extends _langchain_core_language_models_chat_models.B
 	constructor(params) {
 		super(params);
 		this.params = params;
-		this._addVersion("@langchain/google", "0.2.12");
+		this._addVersion("@langchain/google", "0.2.14");
 		if (!params.apiClient) throw new require_errors.ConfigurationError("BaseChatGoogle requires an apiClient. This should be provided automatically by ChatGoogle constructors. If you're extending BaseChatGoogle directly, please provide an apiClient instance.");
 		this.apiClient = params.apiClient;
 		this.model = params.model;
@@ -145,6 +146,7 @@ var BaseChatGoogle = class extends _langchain_core_language_models_chat_models.B
 			const handlerConfig = this.params.apiHandler ?? "generateContent";
 			if (typeof handlerConfig === "function") this._apiHandler = handlerConfig(handlerParams);
 			else if (handlerConfig === "generateContent") this._apiHandler = new require_generate_content.GenerateContentApiHandler(handlerParams);
+			else if (handlerConfig === "interactions") this._apiHandler = new require_interactions.InteractionsApiHandler(handlerParams);
 			else throw new require_errors.ConfigurationError(`Unknown apiHandler: ${handlerConfig}`);
 		}
 		return this._apiHandler;
@@ -258,7 +260,6 @@ var BaseChatGoogle = class extends _langchain_core_language_models_chat_models.B
 		return (0, _langchain_core_language_models_structured_output.assembleStructuredOutputPipeline)(llm, outputParser, includeRaw, includeRaw ? "ChatGoogleStructuredOutputRunnable" : "ChatGoogleStructuredOutput");
 	}
 };
-//#endregion
 exports.BaseChatGoogle = BaseChatGoogle;
 exports.applyGeminiGatewayParams = applyGeminiGatewayParams;
 exports.getPlatformType = getPlatformType;

package/dist/chat_models/base.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"base.cjs","names":["getEnvironmentVariable","convertParamsToPlatformType","resolveLangSmithGatewayConfig","BaseChatModel","ConfigurationError","GenerateContentApiHandler","PROFILES","concat","usageMetadataToTokenUsage","RunnableLambda","AIMessage","AIMessageChunk","MalformedOutputError","createContentParser","createFunctionCallingParser","assembleStructuredOutputPipeline"],"sources":["../../src/chat_models/base.ts"],"sourcesContent":["import {\n  BaseChatModel,\n  type LangSmithParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n} from \"@langchain/core/messages\";\nimport { CallbackManagerForLLMRun } from \"@langchain/core/callbacks/manager\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\nimport { concat } from \"@langchain/core/utils/stream\";\nimport { ChatGenerationChunk, type ChatResult } from \"@langchain/core/outputs\";\nimport type { BindToolsInput } from \"@langchain/core/language_models/chat_models\";\nimport type { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport PROFILES from \"./profiles.js\";\nimport type {\n  BaseLanguageModelInput,\n  StructuredOutputMethodOptions,\n} from \"@langchain/core/language_models/base\";\nimport { Runnable, RunnableLambda } from \"@langchain/core/runnables\";\nimport type { InteropZodType } from \"@langchain/core/utils/types\";\nimport { ApiClient } from \"../clients/index.js\";\nimport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n  GenerateContentApiHandlerParams,\n} from \"./types.js\";\nimport { ConfigurationError, MalformedOutputError } from \"../utils/errors.js\";\nimport { usageMetadataToTokenUsage } from \"../utils/metadata.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport {\n  assembleStructuredOutputPipeline,\n  createContentParser,\n  createFunctionCallingParser,\n} from \"@langchain/core/language_models/structured_output\";\nimport { resolveLangSmithGatewayConfig } from \"@langchain/core/utils/gateway\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  GoogleChatApiHandler,\n  GenerateContentApiHandler,\n} from \"./handlers/index.js\";\nimport { convertParamsToPlatformType } from \"../converters/shared/params.js\";\n\nexport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n} from \"./types.js\";\n\nfunction hasVertexCredentials(params: {\n  credentials?: unknown;\n  googleAuthOptions?: unknown;\n}): boolean {\n  return (\n    typeof params.credentials !== \"undefined\" ||\n    typeof params.googleAuthOptions !== \"undefined\" ||\n    typeof getEnvironmentVariable(\"GOOGLE_CLOUD_CREDENTIALS\") !== \"undefined\"\n  );\n}\n\n/**\n * Resolves LangSmith gateway routing for Google chat model params.\n *\n * The LangSmith gateway exposes direct paths for the Gemini Developer API and\n * Vertex AI. An explicit `endpoint` suppresses gateway routing.\n *\n * When `LANGSMITH_GATEWAY` is set, this rewrites `endpoint` to the gateway\n * host and lets the gateway key take precedence over the provider key (which\n * then rides as the `x-goog-api-key` header via the ApiClient). The default\n * `https` gateway host is written scheme-less (the URL builders prepend\n * `https://`); a non-`https` custom gateway keeps its scheme so it is not\n * forced to TLS.\n *\n * This function is pure: it never mutates `params`. It returns a new object\n * with the gateway overrides applied when routing is active, or an unchanged\n * shallow copy otherwise.\n *\n * @returns a new params object with gateway routing applied when applicable.\n */\nexport function applyGeminiGatewayParams<TParams extends object>(\n  params: TParams\n): TParams & {\n  apiKey?: string;\n  endpoint?: string;\n  platformType?: GooglePlatformType;\n} {\n  const p = params as {\n    apiKey?: string;\n    endpoint?: string;\n    platformType?: GooglePlatformType;\n    vertexai?: boolean;\n    credentials?: unknown;\n    googleAuthOptions?: unknown;\n  };\n  if (typeof p.endpoint !== \"undefined\") {\n    return { ...params };\n  }\n  const platform =\n    convertParamsToPlatformType(p) ?? (hasVertexCredentials(p) ? \"gcp\" : \"gai\");\n  const gatewayConfig = resolveLangSmithGatewayConfig({\n    providerPath: platform === \"gcp\" ? \"vertex\" : \"gemini\",\n  });\n  if (typeof gatewayConfig.baseURL === \"undefined\") {\n    return { ...params };\n  }\n\n  // A provider key still wins over the gateway key.\n  const gatewayUrl = new URL(gatewayConfig.baseURL);\n  const path = gatewayUrl.pathname.replace(/\\/+$/, \"\");\n  // The URL builders compose `https://${endpoint}/${apiVersion}/...`. For the\n  // default `https` gateway, keep the endpoint scheme-less (host + path) so the\n  // builder's `https://` prefix produces the right URL. For a non-`https`\n  // custom gateway (e.g. `http://localhost:8080`), keep the full scheme so the\n  // builder does not force TLS; `buildUrlGemini` skips its prefix when the\n  // endpoint already includes a scheme.\n  const endpoint =\n    gatewayUrl.protocol === \"https:\"\n      ? `${gatewayUrl.host}${path}`\n      : `${gatewayUrl.protocol}//${gatewayUrl.host}${path}`;\n  return {\n    ...params,\n    apiKey: p.apiKey ?? gatewayConfig.apiKey,\n    endpoint,\n    platformType: platform,\n  };\n}\n\nexport function getPlatformType(\n  platform: GooglePlatformType | undefined,\n  hasApiKey: boolean\n): GooglePlatformType {\n  if (typeof platform !== \"undefined\") {\n    return platform;\n  } else if (hasApiKey) {\n    return \"gai\";\n  } else {\n    return \"gcp\";\n  }\n}\n\nexport abstract class BaseChatGoogle<\n  CallOptions extends BaseChatGoogleCallOptions = BaseChatGoogleCallOptions,\n> extends BaseChatModel<CallOptions, AIMessageChunk> {\n  model: string;\n\n  streaming: boolean;\n\n  disableStreaming: boolean;\n\n  streamUsage: boolean = true;\n\n  protected _platform?: GooglePlatformType;\n\n  protected _endpoint?: string;\n\n  protected _customHeaders?: Record<string, string>;\n\n  protected _location?: string;\n\n  protected _apiVersion?: string;\n\n  protected apiClient: ApiClient;\n\n  constructor(\n    protected params: BaseChatGoogleParams & {\n      credentials?: unknown;\n      googleAuthOptions?: unknown;\n    }\n  ) {\n    super(params);\n    this._addVersion(\"@langchain/google\", __PKG_VERSION__);\n\n    if (!params.apiClient) {\n      throw new ConfigurationError(\n        \"BaseChatGoogle requires an apiClient. This should be provided automatically by ChatGoogle constructors. If you're extending BaseChatGoogle directly, please provide an apiClient instance.\"\n      );\n    }\n    this.apiClient = params.apiClient;\n\n    this.model = params.model;\n    this._platform = convertParamsToPlatformType(params);\n    this._endpoint = params.endpoint;\n    this._customHeaders = params.customHeaders;\n    this._location = params.location;\n    this._apiVersion = params.apiVersion;\n\n    this.disableStreaming = params?.disableStreaming === true;\n    this.streaming = params?.streaming === true;\n    if (this.disableStreaming) this.streaming = false;\n    // disable streaming in BaseChatModel if explicitly disabled\n    if (params?.streaming === false) this.disableStreaming = true;\n\n    this.streamUsage = params?.streamUsage ?? this.streamUsage;\n    if (this.disableStreaming) this.streamUsage = false;\n  }\n\n  _llmType(): string {\n    return \"google\";\n  }\n\n  protected get platformType(): GooglePlatformType | undefined {\n    return this._platform;\n  }\n\n  protected get platform(): GooglePlatformType {\n    return getPlatformType(this._platform, this.apiClient.hasApiKey());\n  }\n\n  protected get isVertexExpress(): boolean {\n    return (\n      this.platform === \"gcp\" &&\n      this.apiClient.hasApiKey() &&\n      !hasVertexCredentials(this.params)\n    );\n  }\n\n  protected get apiVersion(): string {\n    if (typeof this._apiVersion !== \"undefined\") {\n      return this._apiVersion;\n    } else if (this.platform === \"gai\") {\n      return \"v1beta\";\n    } else {\n      return \"v1\";\n    }\n  }\n\n  protected get location(): string {\n    return this._location || \"global\";\n  }\n\n  protected get endpoint(): string {\n    if (typeof this._endpoint !== \"undefined\") {\n      return this._endpoint;\n    } else if (this.platform === \"gai\") {\n      return \"generativelanguage.googleapis.com\";\n    } else if (this.isVertexExpress) {\n      return \"aiplatform.googleapis.com\";\n    } else if (this.location === \"global\") {\n      // See https://docs.cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#use_the_global_endpoint\n      return \"aiplatform.googleapis.com\";\n    } else if (!this.location.includes(\"-\")) {\n      return `aiplatform.${this.location}.rep.googleapis.com`;\n    } else {\n      return `${this.location}-aiplatform.googleapis.com`;\n    }\n  }\n\n  protected get publisher(): string {\n    return \"google\";\n  }\n\n  protected _apiHandler?: GoogleChatApiHandler;\n\n  protected _handlerParams?: GenerateContentApiHandlerParams;\n\n  protected syncHandlerParams(): GenerateContentApiHandlerParams {\n    const nextParams: GenerateContentApiHandlerParams = {\n      ...this.params,\n      model: this.model,\n      platform: this.platform,\n      endpoint: this.endpoint,\n      location: this.location,\n      apiVersion: this.apiVersion,\n      isVertexExpress: this.isVertexExpress,\n      publisher: this.publisher,\n      streaming: this.streaming,\n      streamUsage: this.streamUsage,\n      customHeaders: this._customHeaders,\n      apiClient: this.apiClient,\n      caller: this.caller,\n    };\n    if (this._handlerParams) {\n      return Object.assign(this._handlerParams, nextParams);\n    }\n    this._handlerParams = nextParams;\n    return this._handlerParams;\n  }\n\n  protected get apiHandler(): GoogleChatApiHandler {\n    const handlerParams = this.syncHandlerParams();\n    if (!this._apiHandler) {\n      const handlerConfig = this.params.apiHandler ?? \"generateContent\";\n\n      if (typeof handlerConfig === \"function\") {\n        this._apiHandler = handlerConfig(handlerParams);\n      } else if (handlerConfig === \"generateContent\") {\n        this._apiHandler = new GenerateContentApiHandler(handlerParams);\n      } else {\n        throw new ConfigurationError(`Unknown apiHandler: ${handlerConfig}`);\n      }\n    }\n    return this._apiHandler;\n  }\n\n  /**\n   * Returns the model profile for this instance's model, describing its\n   * capabilities and constraints (e.g. max tokens, input/output modalities,\n   * tool calling support).\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatGoogle({ model: \"gemini-2.5-pro\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 1048576\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n\n  async buildUrl(urlMethod?: string): Promise<string> {\n    return this.apiHandler.buildUrl(urlMethod);\n  }\n\n  override invocationParams(\n    options: this[\"ParsedCallOptions\"]\n  ): Record<string, unknown> {\n    return this.apiHandler.invocationParams(options) as Record<string, unknown>;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    return {\n      ls_provider: this.platform === \"gcp\" ? \"google_vertexai\" : \"google_genai\",\n      ls_model_name: this.model,\n      ls_model_type: \"chat\",\n      ls_temperature: options?.temperature ?? this.params.temperature,\n      ls_max_tokens: options?.maxOutputTokens ?? this.params.maxOutputTokens,\n      ls_stop:\n        options?.stopSequences ?? options?.stop ?? this.params.stopSequences,\n    };\n  }\n\n  getHeaders(options?: this[\"ParsedCallOptions\"]): HeadersInit {\n    return this.apiHandler.getHeaders(options);\n  }\n\n  async _generate(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): Promise<ChatResult> {\n    if (this.streaming) {\n      const stream = await this._streamResponseChunks(\n        messages,\n        options,\n        runManager\n      );\n      let finalChunk: ChatGenerationChunk | null = null;\n      for await (const chunk of stream) {\n        finalChunk = !finalChunk ? chunk : concat(finalChunk, chunk);\n      }\n      if (\n        typeof finalChunk?.message?.content === \"string\" &&\n        typeof (\n          finalChunk?.message?.additional_kwargs\n            ?.originalTextContentBlock as Record<string, unknown>\n        )?.text === \"string\"\n      ) {\n        (\n          finalChunk.message.additional_kwargs\n            .originalTextContentBlock as Record<string, unknown>\n        ).text = finalChunk.message.content;\n      }\n      const usageMetadata = (finalChunk?.message as AIMessageChunk | undefined)\n        ?.usage_metadata;\n      return {\n        generations: finalChunk ? [finalChunk] : [],\n        ...(usageMetadata\n          ? {\n              llmOutput: {\n                tokenUsage: usageMetadataToTokenUsage(usageMetadata),\n                usageMetadata,\n              },\n            }\n          : {}),\n      };\n    }\n\n    return this.apiHandler.generate(messages, options, runManager);\n  }\n\n  override async *_streamChatModelEvents(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatModelStreamEvent> {\n    yield* this.apiHandler.streamChatModelEvents(messages, options, runManager);\n  }\n\n  async *_streamResponseChunks(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatGenerationChunk> {\n    yield* this.apiHandler.streamResponseChunks(messages, options, runManager);\n  }\n\n  /**\n   * Bind tool-like objects to this chat model.\n   *\n   * @param tools A list of tool definitions to bind to this chat model.\n   * Can be a structured tool, an OpenAI formatted tool, or a Gemini function declaration.\n   * @param kwargs Any additional parameters to bind.\n   */\n  bindTools(\n    tools: BindToolsInput[],\n    kwargs?: Partial<CallOptions>\n  ): Runnable<BaseMessage[], AIMessageChunk, CallOptions> {\n    return this.withConfig({\n      ...kwargs,\n      tools,\n    } as Partial<CallOptions>);\n  }\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<false>\n  ): Runnable<BaseLanguageModelInput, RunOutput>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<true>\n  ): Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  /**\n   * Get structured output from the model based on a schema.\n   *\n   * This method supports two modes:\n   * - `jsonMode`: Uses `responseSchema` to get JSON responses directly (preferred for structured outputs)\n   * - `functionCalling`: Uses function calling with tools (default, for compatibility)\n   *\n   * @param outputSchema - The schema to use for structured output (Zod schema or JSON Schema)\n   * @param config - Configuration options including method and whether to include raw response\n   * @returns A Runnable that returns the parsed structured output\n   */\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<\n        BaseLanguageModelInput,\n        { raw: BaseMessage; parsed: RunOutput }\n      > {\n    let llm: Runnable<BaseMessage[], AIMessageChunk, CallOptions>;\n    let outputParser: Runnable<BaseMessage, RunOutput>;\n\n    const { schema, name, includeRaw } = {\n      ...config,\n      schema: outputSchema,\n    };\n    let method = config?.method ?? \"functionCalling\";\n\n    if (method === \"jsonMode\") {\n      console.warn(\n        `\"jsonMode\" is not supported for Google models. Falling back to \"jsonSchema\".`\n      );\n      method = \"jsonSchema\";\n    }\n\n    if (method === \"jsonSchema\") {\n      // Use JSON mode with responseSchema\n      llm = this.withConfig({\n        responseSchema: schema,\n      } as Partial<CallOptions>);\n\n      outputParser = RunnableLambda.from<BaseMessage, RunOutput>(\n        async (input: BaseMessage): Promise<RunOutput> => {\n          if (\n            !AIMessage.isInstance(input) &&\n            !AIMessageChunk.isInstance(input)\n          ) {\n            throw new MalformedOutputError({\n              message: \"Input is not an AIMessage or AIMessageChunk.\",\n            });\n          }\n\n          if (!input.text) {\n            throw new MalformedOutputError({\n              message:\n                \"No content found in response. Cannot parse structured output.\",\n            });\n          }\n\n          // Parse JSON and validate with schema\n          const parser = createContentParser(schema);\n          return await parser.parse(input.text);\n        }\n      );\n    } else if (method === \"functionCalling\") {\n      const { tools, toolChoice, functionName } =\n        this.apiHandler.formatStructuredOutputTool(schema, { name });\n\n      llm = this.bindTools(tools).withConfig({\n        tool_choice: toolChoice,\n      } as Partial<CallOptions>);\n\n      outputParser = createFunctionCallingParser(schema, functionName);\n    } else {\n      throw new ConfigurationError(\n        `Unrecognized structured output method '${method}'. Expected 'functionCalling' or 'jsonSchema'`\n      );\n    }\n\n    return assembleStructuredOutputPipeline(\n      llm,\n      outputParser,\n      includeRaw,\n      includeRaw\n        ? \"ChatGoogleStructuredOutputRunnable\"\n        : \"ChatGoogleStructuredOutput\"\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAmDA,SAAS,qBAAqB,QAGlB;CACV,OACE,OAAO,OAAO,gBAAgB,eAC9B,OAAO,OAAO,sBAAsB,eACpC,QAAA,GAAOA,0BAAAA,uBAAAA,CAAuB,0BAA0B,MAAM;AAElE;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,yBACd,QAKA;CACA,MAAM,IAAI;CAQV,IAAI,OAAO,EAAE,aAAa,aACxB,OAAO,EAAE,GAAG,OAAO;CAErB,MAAM,WACJC,eAAAA,4BAA4B,CAAC,MAAM,qBAAqB,CAAC,IAAI,QAAQ;CACvE,MAAM,iBAAA,GAAgBC,8BAAAA,8BAAAA,CAA8B,EAClD,cAAc,aAAa,QAAQ,WAAW,SAChD,CAAC;CACD,IAAI,OAAO,cAAc,YAAY,aACnC,OAAO,EAAE,GAAG,OAAO;CAIrB,MAAM,aAAa,IAAI,IAAI,cAAc,OAAO;CAChD,MAAM,OAAO,WAAW,SAAS,QAAQ,QAAQ,EAAE;CAOnD,MAAM,WACJ,WAAW,aAAa,WACpB,GAAG,WAAW,OAAO,SACrB,GAAG,WAAW,SAAS,IAAI,WAAW,OAAO;CACnD,OAAO;EACL,GAAG;EACH,QAAQ,EAAE,UAAU,cAAc;EAClC;EACA,cAAc;CAChB;AACF;AAEA,SAAgB,gBACd,UACA,WACoB;CACpB,IAAI,OAAO,aAAa,aACtB,OAAO;MACF,IAAI,WACT,OAAO;MAEP,OAAO;AAEX;AAEA,IAAsB,iBAAtB,cAEUC,4CAAAA,cAA2C;CAsBvC;CArBZ;CAEA;CAEA;CAEA,cAAuB;CAEvB;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA,YACE,QAIA;EACA,MAAM,MAAM;EALF,KAAA,SAAA;EAMV,KAAK,YAAY,qBAAA,QAAoC;EAErD,IAAI,CAAC,OAAO,WACV,MAAM,IAAIC,eAAAA,mBACR,4LACF;EAEF,KAAK,YAAY,OAAO;EAExB,KAAK,QAAQ,OAAO;EACpB,KAAK,YAAYH,eAAAA,4BAA4B,MAAM;EACnD,KAAK,YAAY,OAAO;EACxB,KAAK,iBAAiB,OAAO;EAC7B,KAAK,YAAY,OAAO;EACxB,KAAK,cAAc,OAAO;EAE1B,KAAK,mBAAmB,QAAQ,qBAAqB;EACrD,KAAK,YAAY,QAAQ,cAAc;EACvC,IAAI,KAAK,kBAAkB,KAAK,YAAY;EAE5C,IAAI,QAAQ,cAAc,OAAO,KAAK,mBAAmB;EAEzD,KAAK,cAAc,QAAQ,eAAe,KAAK;EAC/C,IAAI,KAAK,kBAAkB,KAAK,cAAc;CAChD;CAEA,WAAmB;EACjB,OAAO;CACT;CAEA,IAAc,eAA+C;EAC3D,OAAO,KAAK;CACd;CAEA,IAAc,WAA+B;EAC3C,OAAO,gBAAgB,KAAK,WAAW,KAAK,UAAU,UAAU,CAAC;CACnE;CAEA,IAAc,kBAA2B;EACvC,OACE,KAAK,aAAa,SAClB,KAAK,UAAU,UAAU,KACzB,CAAC,qBAAqB,KAAK,MAAM;CAErC;CAEA,IAAc,aAAqB;EACjC,IAAI,OAAO,KAAK,gBAAgB,aAC9B,OAAO,KAAK;OACP,IAAI,KAAK,aAAa,OAC3B,OAAO;OAEP,OAAO;CAEX;CAEA,IAAc,WAAmB;EAC/B,OAAO,KAAK,aAAa;CAC3B;CAEA,IAAc,WAAmB;EAC/B,IAAI,OAAO,KAAK,cAAc,aAC5B,OAAO,KAAK;OACP,IAAI,KAAK,aAAa,OAC3B,OAAO;OACF,IAAI,KAAK,iBACd,OAAO;OACF,IAAI,KAAK,aAAa,UAE3B,OAAO;OACF,IAAI,CAAC,KAAK,SAAS,SAAS,GAAG,GACpC,OAAO,cAAc,KAAK,SAAS;OAEnC,OAAO,GAAG,KAAK,SAAS;CAE5B;CAEA,IAAc,YAAoB;EAChC,OAAO;CACT;CAEA;CAEA;CAEA,oBAA+D;EAC7D,MAAM,aAA8C;GAClD,GAAG,KAAK;GACR,OAAO,KAAK;GACZ,UAAU,KAAK;GACf,UAAU,KAAK;GACf,UAAU,KAAK;GACf,YAAY,KAAK;GACjB,iBAAiB,KAAK;GACtB,WAAW,KAAK;GAChB,WAAW,KAAK;GAChB,aAAa,KAAK;GAClB,eAAe,KAAK;GACpB,WAAW,KAAK;GAChB,QAAQ,KAAK;EACf;EACA,IAAI,KAAK,gBACP,OAAO,OAAO,OAAO,KAAK,gBAAgB,UAAU;EAEtD,KAAK,iBAAiB;EACtB,OAAO,KAAK;CACd;CAEA,IAAc,aAAmC;EAC/C,MAAM,gBAAgB,KAAK,kBAAkB;EAC7C,IAAI,CAAC,KAAK,aAAa;GACrB,MAAM,gBAAgB,KAAK,OAAO,cAAc;GAEhD,IAAI,OAAO,kBAAkB,YAC3B,KAAK,cAAc,cAAc,aAAa;QACzC,IAAI,kBAAkB,mBAC3B,KAAK,cAAc,IAAII,yBAAAA,0BAA0B,aAAa;QAE9D,MAAM,IAAID,eAAAA,mBAAmB,uBAAuB,eAAe;EAEvE;EACA,OAAO,KAAK;CACd;;;;;;;;;;;;;;CAeA,IAAI,UAAwB;EAC1B,OAAOE,iBAAAA,QAAS,KAAK,UAAU,CAAC;CAClC;CAEA,MAAM,SAAS,WAAqC;EAClD,OAAO,KAAK,WAAW,SAAS,SAAS;CAC3C;CAEA,iBACE,SACyB;EACzB,OAAO,KAAK,WAAW,iBAAiB,OAAO;CACjD;CAEA,YAAY,SAAqD;EAC/D,OAAO;GACL,aAAa,KAAK,aAAa,QAAQ,oBAAoB;GAC3D,eAAe,KAAK;GACpB,eAAe;GACf,gBAAgB,SAAS,eAAe,KAAK,OAAO;GACpD,eAAe,SAAS,mBAAmB,KAAK,OAAO;GACvD,SACE,SAAS,iBAAiB,SAAS,QAAQ,KAAK,OAAO;EAC3D;CACF;CAEA,WAAW,SAAkD;EAC3D,OAAO,KAAK,WAAW,WAAW,OAAO;CAC3C;CAEA,MAAM,UACJ,UACA,SACA,YACqB;EACrB,IAAI,KAAK,WAAW;GAClB,MAAM,SAAS,MAAM,KAAK,sBACxB,UACA,SACA,UACF;GACA,IAAI,aAAyC;GAC7C,WAAW,MAAM,SAAS,QACxB,aAAa,CAAC,aAAa,SAAA,GAAQC,6BAAAA,OAAAA,CAAO,YAAY,KAAK;GAE7D,IACE,OAAO,YAAY,SAAS,YAAY,YACxC,QACE,YAAY,SAAS,mBACjB,yBAAA,EACH,SAAS,UAEZ,WACa,QAAQ,kBAChB,yBACH,OAAO,WAAW,QAAQ;GAE9B,MAAM,iBAAiB,YAAY,QAAA,EAC/B;GACJ,OAAO;IACL,aAAa,aAAa,CAAC,UAAU,IAAI,CAAC;IAC1C,GAAI,gBACA,EACE,WAAW;KACT,YAAYC,iBAAAA,0BAA0B,aAAa;KACnD;IACF,EACF,IACA,CAAC;GACP;EACF;EAEA,OAAO,KAAK,WAAW,SAAS,UAAU,SAAS,UAAU;CAC/D;CAEA,OAAgB,uBACd,UACA,SACA,YACsC;EACtC,OAAO,KAAK,WAAW,sBAAsB,UAAU,SAAS,UAAU;CAC5E;CAEA,OAAO,sBACL,UACA,SACA,YACqC;EACrC,OAAO,KAAK,WAAW,qBAAqB,UAAU,SAAS,UAAU;CAC3E;;;;;;;;CASA,UACE,OACA,QACsD;EACtD,OAAO,KAAK,WAAW;GACrB,GAAG;GACH;EACF,CAAyB;CAC3B;;;;;;;;;;;;CAmDA,qBAIE,cAKA,QAMI;EACJ,IAAI;EACJ,IAAI;EAEJ,MAAM,EAAE,QAAQ,MAAM,eAAe;GACnC,GAAG;GACH,QAAQ;EACV;EACA,IAAI,SAAS,QAAQ,UAAU;EAE/B,IAAI,WAAW,YAAY;GACzB,QAAQ,KACN,8EACF;GACA,SAAS;EACX;EAEA,IAAI,WAAW,cAAc;GAE3B,MAAM,KAAK,WAAW,EACpB,gBAAgB,OAClB,CAAyB;GAEzB,eAAeC,0BAAAA,eAAe,KAC5B,OAAO,UAA2C;IAChD,IACE,CAACC,yBAAAA,UAAU,WAAW,KAAK,KAC3B,CAACC,yBAAAA,eAAe,WAAW,KAAK,GAEhC,MAAM,IAAIC,eAAAA,qBAAqB,EAC7B,SAAS,+CACX,CAAC;IAGH,IAAI,CAAC,MAAM,MACT,MAAM,IAAIA,eAAAA,qBAAqB,EAC7B,SACE,gEACJ,CAAC;IAKH,OAAO,OAAA,GADQC,kDAAAA,oBAAAA,CAAoB,MACjB,CAAC,CAAC,MAAM,MAAM,IAAI;GACtC,CACF;EACF,OAAO,IAAI,WAAW,mBAAmB;GACvC,MAAM,EAAE,OAAO,YAAY,iBACzB,KAAK,WAAW,2BAA2B,QAAQ,EAAE,KAAK,CAAC;GAE7D,MAAM,KAAK,UAAU,KAAK,CAAC,CAAC,WAAW,EACrC,aAAa,WACf,CAAyB;GAEzB,gBAAA,GAAeC,kDAAAA,4BAAAA,CAA4B,QAAQ,YAAY;EACjE,OACE,MAAM,IAAIV,eAAAA,mBACR,0CAA0C,OAAO,8CACnD;EAGF,QAAA,GAAOW,kDAAAA,iCAAAA,CACL,KACA,cACA,YACA,aACI,uCACA,4BACN;CACF;AACF"}
+{"version":3,"file":"base.cjs","names":["getEnvironmentVariable","convertParamsToPlatformType","resolveLangSmithGatewayConfig","BaseChatModel","ConfigurationError","GenerateContentApiHandler","InteractionsApiHandler","PROFILES","concat","usageMetadataToTokenUsage","RunnableLambda","AIMessage","AIMessageChunk","MalformedOutputError","createContentParser","createFunctionCallingParser","assembleStructuredOutputPipeline"],"sources":["../../src/chat_models/base.ts"],"sourcesContent":["import {\n  BaseChatModel,\n  type LangSmithParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n} from \"@langchain/core/messages\";\nimport { CallbackManagerForLLMRun } from \"@langchain/core/callbacks/manager\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\nimport { concat } from \"@langchain/core/utils/stream\";\nimport { ChatGenerationChunk, type ChatResult } from \"@langchain/core/outputs\";\nimport type { BindToolsInput } from \"@langchain/core/language_models/chat_models\";\nimport type { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport PROFILES from \"./profiles.js\";\nimport type {\n  BaseLanguageModelInput,\n  StructuredOutputMethodOptions,\n} from \"@langchain/core/language_models/base\";\nimport { Runnable, RunnableLambda } from \"@langchain/core/runnables\";\nimport type { InteropZodType } from \"@langchain/core/utils/types\";\nimport { ApiClient } from \"../clients/index.js\";\nimport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n  GenerateContentApiHandlerParams,\n  InteractionsApiHandlerParams,\n} from \"./types.js\";\nimport { ConfigurationError, MalformedOutputError } from \"../utils/errors.js\";\nimport { usageMetadataToTokenUsage } from \"../utils/metadata.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport {\n  assembleStructuredOutputPipeline,\n  createContentParser,\n  createFunctionCallingParser,\n} from \"@langchain/core/language_models/structured_output\";\nimport { resolveLangSmithGatewayConfig } from \"@langchain/core/utils/gateway\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  GoogleChatApiHandler,\n  GenerateContentApiHandler,\n  InteractionsApiHandler,\n} from \"./handlers/index.js\";\nimport { convertParamsToPlatformType } from \"../converters/shared/params.js\";\n\nexport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n} from \"./types.js\";\n\nfunction hasVertexCredentials(params: {\n  credentials?: unknown;\n  googleAuthOptions?: unknown;\n}): boolean {\n  return (\n    typeof params.credentials !== \"undefined\" ||\n    typeof params.googleAuthOptions !== \"undefined\" ||\n    typeof getEnvironmentVariable(\"GOOGLE_CLOUD_CREDENTIALS\") !== \"undefined\"\n  );\n}\n\n/**\n * Resolves LangSmith gateway routing for Google chat model params.\n *\n * The LangSmith gateway exposes direct paths for the Gemini Developer API and\n * Vertex AI. An explicit `endpoint` or explicit credentials (`apiKey`,\n * `credentials`, `googleAuthOptions`) suppress gateway routing.\n *\n * When `LANGSMITH_GATEWAY` is set, this rewrites `endpoint` to the gateway\n * host and uses the gateway key as the API key. The default\n * `https` gateway host is written scheme-less (the URL builders prepend\n * `https://`); a non-`https` custom gateway keeps its scheme so it is not\n * forced to TLS.\n *\n * This function is pure: it never mutates `params`. It returns a new object\n * with the gateway overrides applied when routing is active, or an unchanged\n * shallow copy otherwise.\n *\n * @returns a new params object with gateway routing applied when applicable.\n */\nexport function applyGeminiGatewayParams<TParams extends object>(\n  params: TParams\n): TParams & {\n  apiKey?: string;\n  endpoint?: string;\n  platformType?: GooglePlatformType;\n} {\n  const p = params as {\n    apiKey?: string;\n    endpoint?: string;\n    platformType?: GooglePlatformType;\n    vertexai?: boolean;\n    credentials?: unknown;\n    googleAuthOptions?: unknown;\n  };\n  if (\n    typeof p.endpoint !== \"undefined\" ||\n    typeof p.apiKey !== \"undefined\" ||\n    typeof p.credentials !== \"undefined\" ||\n    typeof p.googleAuthOptions !== \"undefined\"\n  ) {\n    return { ...params };\n  }\n  const platform =\n    convertParamsToPlatformType(p) ?? (hasVertexCredentials(p) ? \"gcp\" : \"gai\");\n  const gatewayConfig = resolveLangSmithGatewayConfig({\n    providerPath: platform === \"gcp\" ? \"vertex\" : \"gemini\",\n  });\n  if (typeof gatewayConfig.baseURL === \"undefined\") {\n    return { ...params };\n  }\n\n  const gatewayUrl = new URL(gatewayConfig.baseURL);\n  const path = gatewayUrl.pathname.replace(/\\/+$/, \"\");\n  // The URL builders compose `https://${endpoint}/${apiVersion}/...`. For the\n  // default `https` gateway, keep the endpoint scheme-less (host + path) so the\n  // builder's `https://` prefix produces the right URL. For a non-`https`\n  // custom gateway (e.g. `http://localhost:8080`), keep the full scheme so the\n  // builder does not force TLS; `buildUrlGemini` skips its prefix when the\n  // endpoint already includes a scheme.\n  const endpoint =\n    gatewayUrl.protocol === \"https:\"\n      ? `${gatewayUrl.host}${path}`\n      : `${gatewayUrl.protocol}//${gatewayUrl.host}${path}`;\n  return {\n    ...params,\n    apiKey: gatewayConfig.apiKey,\n    endpoint,\n    platformType: platform,\n  };\n}\n\nexport function getPlatformType(\n  platform: GooglePlatformType | undefined,\n  hasApiKey: boolean\n): GooglePlatformType {\n  if (typeof platform !== \"undefined\") {\n    return platform;\n  } else if (hasApiKey) {\n    return \"gai\";\n  } else {\n    return \"gcp\";\n  }\n}\n\nexport abstract class BaseChatGoogle<\n  CallOptions extends BaseChatGoogleCallOptions = BaseChatGoogleCallOptions,\n> extends BaseChatModel<CallOptions, AIMessageChunk> {\n  model: string;\n\n  streaming: boolean;\n\n  disableStreaming: boolean;\n\n  streamUsage: boolean = true;\n\n  protected _platform?: GooglePlatformType;\n\n  protected _endpoint?: string;\n\n  protected _customHeaders?: Record<string, string>;\n\n  protected _location?: string;\n\n  protected _apiVersion?: string;\n\n  protected apiClient: ApiClient;\n\n  constructor(\n    protected params: BaseChatGoogleParams & {\n      credentials?: unknown;\n      googleAuthOptions?: unknown;\n    }\n  ) {\n    super(params);\n    this._addVersion(\"@langchain/google\", __PKG_VERSION__);\n\n    if (!params.apiClient) {\n      throw new ConfigurationError(\n        \"BaseChatGoogle requires an apiClient. This should be provided automatically by ChatGoogle constructors. If you're extending BaseChatGoogle directly, please provide an apiClient instance.\"\n      );\n    }\n    this.apiClient = params.apiClient;\n\n    this.model = params.model;\n    this._platform = convertParamsToPlatformType(params);\n    this._endpoint = params.endpoint;\n    this._customHeaders = params.customHeaders;\n    this._location = params.location;\n    this._apiVersion = params.apiVersion;\n\n    this.disableStreaming = params?.disableStreaming === true;\n    this.streaming = params?.streaming === true;\n    if (this.disableStreaming) this.streaming = false;\n    // disable streaming in BaseChatModel if explicitly disabled\n    if (params?.streaming === false) this.disableStreaming = true;\n\n    this.streamUsage = params?.streamUsage ?? this.streamUsage;\n    if (this.disableStreaming) this.streamUsage = false;\n  }\n\n  _llmType(): string {\n    return \"google\";\n  }\n\n  protected get platformType(): GooglePlatformType | undefined {\n    return this._platform;\n  }\n\n  protected get platform(): GooglePlatformType {\n    return getPlatformType(this._platform, this.apiClient.hasApiKey());\n  }\n\n  protected get isVertexExpress(): boolean {\n    return (\n      this.platform === \"gcp\" &&\n      this.apiClient.hasApiKey() &&\n      !hasVertexCredentials(this.params)\n    );\n  }\n\n  protected get apiVersion(): string {\n    if (typeof this._apiVersion !== \"undefined\") {\n      return this._apiVersion;\n    } else if (this.platform === \"gai\") {\n      return \"v1beta\";\n    } else {\n      return \"v1\";\n    }\n  }\n\n  protected get location(): string {\n    return this._location || \"global\";\n  }\n\n  protected get endpoint(): string {\n    if (typeof this._endpoint !== \"undefined\") {\n      return this._endpoint;\n    } else if (this.platform === \"gai\") {\n      return \"generativelanguage.googleapis.com\";\n    } else if (this.isVertexExpress) {\n      return \"aiplatform.googleapis.com\";\n    } else if (this.location === \"global\") {\n      // See https://docs.cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#use_the_global_endpoint\n      return \"aiplatform.googleapis.com\";\n    } else if (!this.location.includes(\"-\")) {\n      return `aiplatform.${this.location}.rep.googleapis.com`;\n    } else {\n      return `${this.location}-aiplatform.googleapis.com`;\n    }\n  }\n\n  protected get publisher(): string {\n    return \"google\";\n  }\n\n  protected _apiHandler?: GoogleChatApiHandler;\n\n  protected _handlerParams?: GenerateContentApiHandlerParams &\n    InteractionsApiHandlerParams;\n\n  protected syncHandlerParams(): GenerateContentApiHandlerParams &\n    InteractionsApiHandlerParams {\n    const nextParams: GenerateContentApiHandlerParams &\n      InteractionsApiHandlerParams = {\n      ...this.params,\n      model: this.model,\n      platform: this.platform,\n      endpoint: this.endpoint,\n      location: this.location,\n      apiVersion: this.apiVersion,\n      isVertexExpress: this.isVertexExpress,\n      publisher: this.publisher,\n      streaming: this.streaming,\n      streamUsage: this.streamUsage,\n      customHeaders: this._customHeaders,\n      apiClient: this.apiClient,\n      caller: this.caller,\n    };\n    if (this._handlerParams) {\n      return Object.assign(this._handlerParams, nextParams);\n    }\n    this._handlerParams = nextParams;\n    return this._handlerParams;\n  }\n\n  protected get apiHandler(): GoogleChatApiHandler {\n    const handlerParams = this.syncHandlerParams();\n    if (!this._apiHandler) {\n      const handlerConfig = this.params.apiHandler ?? \"generateContent\";\n\n      if (typeof handlerConfig === \"function\") {\n        this._apiHandler = handlerConfig(handlerParams);\n      } else if (handlerConfig === \"generateContent\") {\n        this._apiHandler = new GenerateContentApiHandler(handlerParams);\n      } else if (handlerConfig === \"interactions\") {\n        this._apiHandler = new InteractionsApiHandler(handlerParams);\n      } else {\n        throw new ConfigurationError(`Unknown apiHandler: ${handlerConfig}`);\n      }\n    }\n    return this._apiHandler;\n  }\n\n  /**\n   * Returns the model profile for this instance's model, describing its\n   * capabilities and constraints (e.g. max tokens, input/output modalities,\n   * tool calling support).\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatGoogle({ model: \"gemini-2.5-pro\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 1048576\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n\n  async buildUrl(urlMethod?: string): Promise<string> {\n    return this.apiHandler.buildUrl(urlMethod);\n  }\n\n  override invocationParams(\n    options: this[\"ParsedCallOptions\"]\n  ): Record<string, unknown> {\n    return this.apiHandler.invocationParams(options) as Record<string, unknown>;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    return {\n      ls_provider: this.platform === \"gcp\" ? \"google_vertexai\" : \"google_genai\",\n      ls_model_name: this.model,\n      ls_model_type: \"chat\",\n      ls_temperature: options?.temperature ?? this.params.temperature,\n      ls_max_tokens: options?.maxOutputTokens ?? this.params.maxOutputTokens,\n      ls_stop:\n        options?.stopSequences ?? options?.stop ?? this.params.stopSequences,\n    };\n  }\n\n  getHeaders(options?: this[\"ParsedCallOptions\"]): HeadersInit {\n    return this.apiHandler.getHeaders(options);\n  }\n\n  async _generate(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): Promise<ChatResult> {\n    if (this.streaming) {\n      const stream = await this._streamResponseChunks(\n        messages,\n        options,\n        runManager\n      );\n      let finalChunk: ChatGenerationChunk | null = null;\n      for await (const chunk of stream) {\n        finalChunk = !finalChunk ? chunk : concat(finalChunk, chunk);\n      }\n      if (\n        typeof finalChunk?.message?.content === \"string\" &&\n        typeof (\n          finalChunk?.message?.additional_kwargs\n            ?.originalTextContentBlock as Record<string, unknown>\n        )?.text === \"string\"\n      ) {\n        (\n          finalChunk.message.additional_kwargs\n            .originalTextContentBlock as Record<string, unknown>\n        ).text = finalChunk.message.content;\n      }\n      const usageMetadata = (finalChunk?.message as AIMessageChunk | undefined)\n        ?.usage_metadata;\n      return {\n        generations: finalChunk ? [finalChunk] : [],\n        ...(usageMetadata\n          ? {\n              llmOutput: {\n                tokenUsage: usageMetadataToTokenUsage(usageMetadata),\n                usageMetadata,\n              },\n            }\n          : {}),\n      };\n    }\n\n    return this.apiHandler.generate(messages, options, runManager);\n  }\n\n  override async *_streamChatModelEvents(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatModelStreamEvent> {\n    yield* this.apiHandler.streamChatModelEvents(messages, options, runManager);\n  }\n\n  async *_streamResponseChunks(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatGenerationChunk> {\n    yield* this.apiHandler.streamResponseChunks(messages, options, runManager);\n  }\n\n  /**\n   * Bind tool-like objects to this chat model.\n   *\n   * @param tools A list of tool definitions to bind to this chat model.\n   * Can be a structured tool, an OpenAI formatted tool, or a Gemini function declaration.\n   * @param kwargs Any additional parameters to bind.\n   */\n  bindTools(\n    tools: BindToolsInput[],\n    kwargs?: Partial<CallOptions>\n  ): Runnable<BaseMessage[], AIMessageChunk, CallOptions> {\n    return this.withConfig({\n      ...kwargs,\n      tools,\n    } as Partial<CallOptions>);\n  }\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<false>\n  ): Runnable<BaseLanguageModelInput, RunOutput>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<true>\n  ): Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  /**\n   * Get structured output from the model based on a schema.\n   *\n   * This method supports two modes:\n   * - `jsonMode`: Uses `responseSchema` to get JSON responses directly (preferred for structured outputs)\n   * - `functionCalling`: Uses function calling with tools (default, for compatibility)\n   *\n   * @param outputSchema - The schema to use for structured output (Zod schema or JSON Schema)\n   * @param config - Configuration options including method and whether to include raw response\n   * @returns A Runnable that returns the parsed structured output\n   */\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<\n        BaseLanguageModelInput,\n        { raw: BaseMessage; parsed: RunOutput }\n      > {\n    let llm: Runnable<BaseMessage[], AIMessageChunk, CallOptions>;\n    let outputParser: Runnable<BaseMessage, RunOutput>;\n\n    const { schema, name, includeRaw } = {\n      ...config,\n      schema: outputSchema,\n    };\n    let method = config?.method ?? \"functionCalling\";\n\n    if (method === \"jsonMode\") {\n      console.warn(\n        `\"jsonMode\" is not supported for Google models. Falling back to \"jsonSchema\".`\n      );\n      method = \"jsonSchema\";\n    }\n\n    if (method === \"jsonSchema\") {\n      // Use JSON mode with responseSchema\n      llm = this.withConfig({\n        responseSchema: schema,\n      } as Partial<CallOptions>);\n\n      outputParser = RunnableLambda.from<BaseMessage, RunOutput>(\n        async (input: BaseMessage): Promise<RunOutput> => {\n          if (\n            !AIMessage.isInstance(input) &&\n            !AIMessageChunk.isInstance(input)\n          ) {\n            throw new MalformedOutputError({\n              message: \"Input is not an AIMessage or AIMessageChunk.\",\n            });\n          }\n\n          if (!input.text) {\n            throw new MalformedOutputError({\n              message:\n                \"No content found in response. Cannot parse structured output.\",\n            });\n          }\n\n          // Parse JSON and validate with schema\n          const parser = createContentParser(schema);\n          return await parser.parse(input.text);\n        }\n      );\n    } else if (method === \"functionCalling\") {\n      const { tools, toolChoice, functionName } =\n        this.apiHandler.formatStructuredOutputTool(schema, { name });\n\n      llm = this.bindTools(tools).withConfig({\n        tool_choice: toolChoice,\n      } as Partial<CallOptions>);\n\n      outputParser = createFunctionCallingParser(schema, functionName);\n    } else {\n      throw new ConfigurationError(\n        `Unrecognized structured output method '${method}'. Expected 'functionCalling' or 'jsonSchema'`\n      );\n    }\n\n    return assembleStructuredOutputPipeline(\n      llm,\n      outputParser,\n      includeRaw,\n      includeRaw\n        ? \"ChatGoogleStructuredOutputRunnable\"\n        : \"ChatGoogleStructuredOutput\"\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/chat_models/base.d.cts

@@ -1,6 +1,6 @@
 import { ApiClient } from "../clients/index.cjs";
 import { GoogleChatApiHandler } from "./handlers/base.cjs";
-import { BaseChatGoogleCallOptions, BaseChatGoogleParams, GenerateContentApiHandlerParams, GooglePlatformType } from "./types.cjs";
+import { BaseChatGoogleCallOptions, BaseChatGoogleParams, GenerateContentApiHandlerParams, GooglePlatformType, InteractionsApiHandlerParams } from "./types.cjs";
 import "./handlers/index.cjs";
 import { BaseChatModel, BindToolsInput, LangSmithParams } from "@langchain/core/language_models/chat_models";
 import { AIMessageChunk, BaseMessage } from "@langchain/core/messages";
@@ -12,7 +12,6 @@ import { BaseLanguageModelInput, StructuredOutputMethodOptions } from "@langchai
 import { Runnable } from "@langchain/core/runnables";
 import { InteropZodType } from "@langchain/core/utils/types";
 import { SerializableSchema } from "@langchain/core/utils/standard_schema";
-//#region src/chat_models/base.d.ts
 export declare abstract class BaseChatGoogle<CallOptions extends BaseChatGoogleCallOptions = BaseChatGoogleCallOptions> extends BaseChatModel<CallOptions, AIMessageChunk> {
   protected params: BaseChatGoogleParams & {
     credentials?: unknown;
@@ -41,8 +40,8 @@ export declare abstract class BaseChatGoogle<CallOptions extends BaseChatGoogleC
   protected get endpoint(): string;
   protected get publisher(): string;
   protected _apiHandler?: GoogleChatApiHandler;
-  protected _handlerParams?: GenerateContentApiHandlerParams;
-  protected syncHandlerParams(): GenerateContentApiHandlerParams;
+  protected _handlerParams?: GenerateContentApiHandlerParams & InteractionsApiHandlerParams;
+  protected syncHandlerParams(): GenerateContentApiHandlerParams & InteractionsApiHandlerParams;
   protected get apiHandler(): GoogleChatApiHandler;
   /**
    * Returns the model profile for this instance's model, describing its
@@ -83,6 +82,5 @@ export declare abstract class BaseChatGoogle<CallOptions extends BaseChatGoogleC
     parsed: RunOutput;
   }>;
 }
-//#endregion
 export type { BaseChatGoogleCallOptions, BaseChatGoogleParams };
 //# sourceMappingURL=base.d.cts.map

package/dist/chat_models/base.d.ts

@@ -1,6 +1,6 @@
 import { ApiClient } from "../clients/index.js";
 import { GoogleChatApiHandler } from "./handlers/base.js";
-import { BaseChatGoogleCallOptions, BaseChatGoogleParams, GenerateContentApiHandlerParams, GooglePlatformType } from "./types.js";
+import { BaseChatGoogleCallOptions, BaseChatGoogleParams, GenerateContentApiHandlerParams, GooglePlatformType, InteractionsApiHandlerParams } from "./types.js";
 import "./handlers/index.js";
 import { BaseChatModel, BindToolsInput, LangSmithParams } from "@langchain/core/language_models/chat_models";
 import { AIMessageChunk, BaseMessage } from "@langchain/core/messages";
@@ -12,7 +12,6 @@ import { BaseLanguageModelInput, StructuredOutputMethodOptions } from "@langchai
 import { CallbackManagerForLLMRun } from "@langchain/core/callbacks/manager";
 import { ChatModelStreamEvent } from "@langchain/core/language_models/event";
 import { ModelProfile } from "@langchain/core/language_models/profile";
-//#region src/chat_models/base.d.ts
 export declare abstract class BaseChatGoogle<CallOptions extends BaseChatGoogleCallOptions = BaseChatGoogleCallOptions> extends BaseChatModel<CallOptions, AIMessageChunk> {
   protected params: BaseChatGoogleParams & {
     credentials?: unknown;
@@ -41,8 +40,8 @@ export declare abstract class BaseChatGoogle<CallOptions extends BaseChatGoogleC
   protected get endpoint(): string;
   protected get publisher(): string;
   protected _apiHandler?: GoogleChatApiHandler;
-  protected _handlerParams?: GenerateContentApiHandlerParams;
-  protected syncHandlerParams(): GenerateContentApiHandlerParams;
+  protected _handlerParams?: GenerateContentApiHandlerParams & InteractionsApiHandlerParams;
+  protected syncHandlerParams(): GenerateContentApiHandlerParams & InteractionsApiHandlerParams;
   protected get apiHandler(): GoogleChatApiHandler;
   /**
    * Returns the model profile for this instance's model, describing its
@@ -83,6 +82,5 @@ export declare abstract class BaseChatGoogle<CallOptions extends BaseChatGoogleC
     parsed: RunOutput;
   }>;
 }
-//#endregion
 export type { BaseChatGoogleCallOptions, BaseChatGoogleParams };
 //# sourceMappingURL=base.d.ts.map

package/dist/chat_models/base.js

@@ -1,9 +1,10 @@
-import { ConfigurationError, MalformedOutputError } from "../utils/errors.js";
 import PROFILES from "./profiles.js";
+import { ConfigurationError, MalformedOutputError } from "../utils/errors.js";
 import { usageMetadataToTokenUsage } from "../utils/metadata.js";
-import { convertParamsToPlatformType } from "../converters/shared/params.js";
-import { GenerateContentApiHandler } from "./handlers/generate_content.js";
 import "./handlers/index.js";
+import { GenerateContentApiHandler } from "./handlers/generate_content.js";
+import { InteractionsApiHandler } from "./handlers/interactions.js";
+import { convertParamsToPlatformType } from "../converters/shared/params.js";
 import { getEnvironmentVariable } from "@langchain/core/utils/env";
 import { BaseChatModel } from "@langchain/core/language_models/chat_models";
 import { AIMessage, AIMessageChunk } from "@langchain/core/messages";
@@ -11,7 +12,7 @@ import { concat } from "@langchain/core/utils/stream";
 import { RunnableLambda } from "@langchain/core/runnables";
 import { assembleStructuredOutputPipeline, createContentParser, createFunctionCallingParser } from "@langchain/core/language_models/structured_output";
 import { resolveLangSmithGatewayConfig } from "@langchain/core/utils/gateway";
-//#region src/chat_models/base.ts
+// src/chat_models/base.ts
 function hasVertexCredentials(params) {
 	return typeof params.credentials !== "undefined" || typeof params.googleAuthOptions !== "undefined" || typeof getEnvironmentVariable("GOOGLE_CLOUD_CREDENTIALS") !== "undefined";
 }
@@ -19,11 +20,11 @@ function hasVertexCredentials(params) {
 * Resolves LangSmith gateway routing for Google chat model params.
 *
 * The LangSmith gateway exposes direct paths for the Gemini Developer API and
-* Vertex AI. An explicit `endpoint` suppresses gateway routing.
+* Vertex AI. An explicit `endpoint` or explicit credentials (`apiKey`,
+* `credentials`, `googleAuthOptions`) suppress gateway routing.
 *
 * When `LANGSMITH_GATEWAY` is set, this rewrites `endpoint` to the gateway
-* host and lets the gateway key take precedence over the provider key (which
-* then rides as the `x-goog-api-key` header via the ApiClient). The default
+* host and uses the gateway key as the API key. The default
 * `https` gateway host is written scheme-less (the URL builders prepend
 * `https://`); a non-`https` custom gateway keeps its scheme so it is not
 * forced to TLS.
@@ -36,7 +37,7 @@ function hasVertexCredentials(params) {
 */
 function applyGeminiGatewayParams(params) {
 	const p = params;
-	if (typeof p.endpoint !== "undefined") return { ...params };
+	if (typeof p.endpoint !== "undefined" || typeof p.apiKey !== "undefined" || typeof p.credentials !== "undefined" || typeof p.googleAuthOptions !== "undefined") return { ...params };
 	const platform = convertParamsToPlatformType(p) ?? (hasVertexCredentials(p) ? "gcp" : "gai");
 	const gatewayConfig = resolveLangSmithGatewayConfig({ providerPath: platform === "gcp" ? "vertex" : "gemini" });
 	if (typeof gatewayConfig.baseURL === "undefined") return { ...params };
@@ -45,7 +46,7 @@ function applyGeminiGatewayParams(params) {
 	const endpoint = gatewayUrl.protocol === "https:" ? `${gatewayUrl.host}${path}` : `${gatewayUrl.protocol}//${gatewayUrl.host}${path}`;
 	return {
 		...params,
-		apiKey: p.apiKey ?? gatewayConfig.apiKey,
+		apiKey: gatewayConfig.apiKey,
 		endpoint,
 		platformType: platform
 	};
@@ -70,7 +71,7 @@ var BaseChatGoogle = class extends BaseChatModel {
 	constructor(params) {
 		super(params);
 		this.params = params;
-		this._addVersion("@langchain/google", "0.2.12");
+		this._addVersion("@langchain/google", "0.2.14");
 		if (!params.apiClient) throw new ConfigurationError("BaseChatGoogle requires an apiClient. This should be provided automatically by ChatGoogle constructors. If you're extending BaseChatGoogle directly, please provide an apiClient instance.");
 		this.apiClient = params.apiClient;
 		this.model = params.model;
@@ -145,6 +146,7 @@ var BaseChatGoogle = class extends BaseChatModel {
 			const handlerConfig = this.params.apiHandler ?? "generateContent";
 			if (typeof handlerConfig === "function") this._apiHandler = handlerConfig(handlerParams);
 			else if (handlerConfig === "generateContent") this._apiHandler = new GenerateContentApiHandler(handlerParams);
+			else if (handlerConfig === "interactions") this._apiHandler = new InteractionsApiHandler(handlerParams);
 			else throw new ConfigurationError(`Unknown apiHandler: ${handlerConfig}`);
 		}
 		return this._apiHandler;
@@ -258,7 +260,6 @@ var BaseChatGoogle = class extends BaseChatModel {
 		return assembleStructuredOutputPipeline(llm, outputParser, includeRaw, includeRaw ? "ChatGoogleStructuredOutputRunnable" : "ChatGoogleStructuredOutput");
 	}
 };
-//#endregion
 export { BaseChatGoogle, applyGeminiGatewayParams, getPlatformType };
 
 //# sourceMappingURL=base.js.map

package/dist/chat_models/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","names":[],"sources":["../../src/chat_models/base.ts"],"sourcesContent":["import {\n  BaseChatModel,\n  type LangSmithParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n} from \"@langchain/core/messages\";\nimport { CallbackManagerForLLMRun } from \"@langchain/core/callbacks/manager\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\nimport { concat } from \"@langchain/core/utils/stream\";\nimport { ChatGenerationChunk, type ChatResult } from \"@langchain/core/outputs\";\nimport type { BindToolsInput } from \"@langchain/core/language_models/chat_models\";\nimport type { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport PROFILES from \"./profiles.js\";\nimport type {\n  BaseLanguageModelInput,\n  StructuredOutputMethodOptions,\n} from \"@langchain/core/language_models/base\";\nimport { Runnable, RunnableLambda } from \"@langchain/core/runnables\";\nimport type { InteropZodType } from \"@langchain/core/utils/types\";\nimport { ApiClient } from \"../clients/index.js\";\nimport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n  GenerateContentApiHandlerParams,\n} from \"./types.js\";\nimport { ConfigurationError, MalformedOutputError } from \"../utils/errors.js\";\nimport { usageMetadataToTokenUsage } from \"../utils/metadata.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport {\n  assembleStructuredOutputPipeline,\n  createContentParser,\n  createFunctionCallingParser,\n} from \"@langchain/core/language_models/structured_output\";\nimport { resolveLangSmithGatewayConfig } from \"@langchain/core/utils/gateway\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  GoogleChatApiHandler,\n  GenerateContentApiHandler,\n} from \"./handlers/index.js\";\nimport { convertParamsToPlatformType } from \"../converters/shared/params.js\";\n\nexport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n} from \"./types.js\";\n\nfunction hasVertexCredentials(params: {\n  credentials?: unknown;\n  googleAuthOptions?: unknown;\n}): boolean {\n  return (\n    typeof params.credentials !== \"undefined\" ||\n    typeof params.googleAuthOptions !== \"undefined\" ||\n    typeof getEnvironmentVariable(\"GOOGLE_CLOUD_CREDENTIALS\") !== \"undefined\"\n  );\n}\n\n/**\n * Resolves LangSmith gateway routing for Google chat model params.\n *\n * The LangSmith gateway exposes direct paths for the Gemini Developer API and\n * Vertex AI. An explicit `endpoint` suppresses gateway routing.\n *\n * When `LANGSMITH_GATEWAY` is set, this rewrites `endpoint` to the gateway\n * host and lets the gateway key take precedence over the provider key (which\n * then rides as the `x-goog-api-key` header via the ApiClient). The default\n * `https` gateway host is written scheme-less (the URL builders prepend\n * `https://`); a non-`https` custom gateway keeps its scheme so it is not\n * forced to TLS.\n *\n * This function is pure: it never mutates `params`. It returns a new object\n * with the gateway overrides applied when routing is active, or an unchanged\n * shallow copy otherwise.\n *\n * @returns a new params object with gateway routing applied when applicable.\n */\nexport function applyGeminiGatewayParams<TParams extends object>(\n  params: TParams\n): TParams & {\n  apiKey?: string;\n  endpoint?: string;\n  platformType?: GooglePlatformType;\n} {\n  const p = params as {\n    apiKey?: string;\n    endpoint?: string;\n    platformType?: GooglePlatformType;\n    vertexai?: boolean;\n    credentials?: unknown;\n    googleAuthOptions?: unknown;\n  };\n  if (typeof p.endpoint !== \"undefined\") {\n    return { ...params };\n  }\n  const platform =\n    convertParamsToPlatformType(p) ?? (hasVertexCredentials(p) ? \"gcp\" : \"gai\");\n  const gatewayConfig = resolveLangSmithGatewayConfig({\n    providerPath: platform === \"gcp\" ? \"vertex\" : \"gemini\",\n  });\n  if (typeof gatewayConfig.baseURL === \"undefined\") {\n    return { ...params };\n  }\n\n  // A provider key still wins over the gateway key.\n  const gatewayUrl = new URL(gatewayConfig.baseURL);\n  const path = gatewayUrl.pathname.replace(/\\/+$/, \"\");\n  // The URL builders compose `https://${endpoint}/${apiVersion}/...`. For the\n  // default `https` gateway, keep the endpoint scheme-less (host + path) so the\n  // builder's `https://` prefix produces the right URL. For a non-`https`\n  // custom gateway (e.g. `http://localhost:8080`), keep the full scheme so the\n  // builder does not force TLS; `buildUrlGemini` skips its prefix when the\n  // endpoint already includes a scheme.\n  const endpoint =\n    gatewayUrl.protocol === \"https:\"\n      ? `${gatewayUrl.host}${path}`\n      : `${gatewayUrl.protocol}//${gatewayUrl.host}${path}`;\n  return {\n    ...params,\n    apiKey: p.apiKey ?? gatewayConfig.apiKey,\n    endpoint,\n    platformType: platform,\n  };\n}\n\nexport function getPlatformType(\n  platform: GooglePlatformType | undefined,\n  hasApiKey: boolean\n): GooglePlatformType {\n  if (typeof platform !== \"undefined\") {\n    return platform;\n  } else if (hasApiKey) {\n    return \"gai\";\n  } else {\n    return \"gcp\";\n  }\n}\n\nexport abstract class BaseChatGoogle<\n  CallOptions extends BaseChatGoogleCallOptions = BaseChatGoogleCallOptions,\n> extends BaseChatModel<CallOptions, AIMessageChunk> {\n  model: string;\n\n  streaming: boolean;\n\n  disableStreaming: boolean;\n\n  streamUsage: boolean = true;\n\n  protected _platform?: GooglePlatformType;\n\n  protected _endpoint?: string;\n\n  protected _customHeaders?: Record<string, string>;\n\n  protected _location?: string;\n\n  protected _apiVersion?: string;\n\n  protected apiClient: ApiClient;\n\n  constructor(\n    protected params: BaseChatGoogleParams & {\n      credentials?: unknown;\n      googleAuthOptions?: unknown;\n    }\n  ) {\n    super(params);\n    this._addVersion(\"@langchain/google\", __PKG_VERSION__);\n\n    if (!params.apiClient) {\n      throw new ConfigurationError(\n        \"BaseChatGoogle requires an apiClient. This should be provided automatically by ChatGoogle constructors. If you're extending BaseChatGoogle directly, please provide an apiClient instance.\"\n      );\n    }\n    this.apiClient = params.apiClient;\n\n    this.model = params.model;\n    this._platform = convertParamsToPlatformType(params);\n    this._endpoint = params.endpoint;\n    this._customHeaders = params.customHeaders;\n    this._location = params.location;\n    this._apiVersion = params.apiVersion;\n\n    this.disableStreaming = params?.disableStreaming === true;\n    this.streaming = params?.streaming === true;\n    if (this.disableStreaming) this.streaming = false;\n    // disable streaming in BaseChatModel if explicitly disabled\n    if (params?.streaming === false) this.disableStreaming = true;\n\n    this.streamUsage = params?.streamUsage ?? this.streamUsage;\n    if (this.disableStreaming) this.streamUsage = false;\n  }\n\n  _llmType(): string {\n    return \"google\";\n  }\n\n  protected get platformType(): GooglePlatformType | undefined {\n    return this._platform;\n  }\n\n  protected get platform(): GooglePlatformType {\n    return getPlatformType(this._platform, this.apiClient.hasApiKey());\n  }\n\n  protected get isVertexExpress(): boolean {\n    return (\n      this.platform === \"gcp\" &&\n      this.apiClient.hasApiKey() &&\n      !hasVertexCredentials(this.params)\n    );\n  }\n\n  protected get apiVersion(): string {\n    if (typeof this._apiVersion !== \"undefined\") {\n      return this._apiVersion;\n    } else if (this.platform === \"gai\") {\n      return \"v1beta\";\n    } else {\n      return \"v1\";\n    }\n  }\n\n  protected get location(): string {\n    return this._location || \"global\";\n  }\n\n  protected get endpoint(): string {\n    if (typeof this._endpoint !== \"undefined\") {\n      return this._endpoint;\n    } else if (this.platform === \"gai\") {\n      return \"generativelanguage.googleapis.com\";\n    } else if (this.isVertexExpress) {\n      return \"aiplatform.googleapis.com\";\n    } else if (this.location === \"global\") {\n      // See https://docs.cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#use_the_global_endpoint\n      return \"aiplatform.googleapis.com\";\n    } else if (!this.location.includes(\"-\")) {\n      return `aiplatform.${this.location}.rep.googleapis.com`;\n    } else {\n      return `${this.location}-aiplatform.googleapis.com`;\n    }\n  }\n\n  protected get publisher(): string {\n    return \"google\";\n  }\n\n  protected _apiHandler?: GoogleChatApiHandler;\n\n  protected _handlerParams?: GenerateContentApiHandlerParams;\n\n  protected syncHandlerParams(): GenerateContentApiHandlerParams {\n    const nextParams: GenerateContentApiHandlerParams = {\n      ...this.params,\n      model: this.model,\n      platform: this.platform,\n      endpoint: this.endpoint,\n      location: this.location,\n      apiVersion: this.apiVersion,\n      isVertexExpress: this.isVertexExpress,\n      publisher: this.publisher,\n      streaming: this.streaming,\n      streamUsage: this.streamUsage,\n      customHeaders: this._customHeaders,\n      apiClient: this.apiClient,\n      caller: this.caller,\n    };\n    if (this._handlerParams) {\n      return Object.assign(this._handlerParams, nextParams);\n    }\n    this._handlerParams = nextParams;\n    return this._handlerParams;\n  }\n\n  protected get apiHandler(): GoogleChatApiHandler {\n    const handlerParams = this.syncHandlerParams();\n    if (!this._apiHandler) {\n      const handlerConfig = this.params.apiHandler ?? \"generateContent\";\n\n      if (typeof handlerConfig === \"function\") {\n        this._apiHandler = handlerConfig(handlerParams);\n      } else if (handlerConfig === \"generateContent\") {\n        this._apiHandler = new GenerateContentApiHandler(handlerParams);\n      } else {\n        throw new ConfigurationError(`Unknown apiHandler: ${handlerConfig}`);\n      }\n    }\n    return this._apiHandler;\n  }\n\n  /**\n   * Returns the model profile for this instance's model, describing its\n   * capabilities and constraints (e.g. max tokens, input/output modalities,\n   * tool calling support).\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatGoogle({ model: \"gemini-2.5-pro\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 1048576\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n\n  async buildUrl(urlMethod?: string): Promise<string> {\n    return this.apiHandler.buildUrl(urlMethod);\n  }\n\n  override invocationParams(\n    options: this[\"ParsedCallOptions\"]\n  ): Record<string, unknown> {\n    return this.apiHandler.invocationParams(options) as Record<string, unknown>;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    return {\n      ls_provider: this.platform === \"gcp\" ? \"google_vertexai\" : \"google_genai\",\n      ls_model_name: this.model,\n      ls_model_type: \"chat\",\n      ls_temperature: options?.temperature ?? this.params.temperature,\n      ls_max_tokens: options?.maxOutputTokens ?? this.params.maxOutputTokens,\n      ls_stop:\n        options?.stopSequences ?? options?.stop ?? this.params.stopSequences,\n    };\n  }\n\n  getHeaders(options?: this[\"ParsedCallOptions\"]): HeadersInit {\n    return this.apiHandler.getHeaders(options);\n  }\n\n  async _generate(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): Promise<ChatResult> {\n    if (this.streaming) {\n      const stream = await this._streamResponseChunks(\n        messages,\n        options,\n        runManager\n      );\n      let finalChunk: ChatGenerationChunk | null = null;\n      for await (const chunk of stream) {\n        finalChunk = !finalChunk ? chunk : concat(finalChunk, chunk);\n      }\n      if (\n        typeof finalChunk?.message?.content === \"string\" &&\n        typeof (\n          finalChunk?.message?.additional_kwargs\n            ?.originalTextContentBlock as Record<string, unknown>\n        )?.text === \"string\"\n      ) {\n        (\n          finalChunk.message.additional_kwargs\n            .originalTextContentBlock as Record<string, unknown>\n        ).text = finalChunk.message.content;\n      }\n      const usageMetadata = (finalChunk?.message as AIMessageChunk | undefined)\n        ?.usage_metadata;\n      return {\n        generations: finalChunk ? [finalChunk] : [],\n        ...(usageMetadata\n          ? {\n              llmOutput: {\n                tokenUsage: usageMetadataToTokenUsage(usageMetadata),\n                usageMetadata,\n              },\n            }\n          : {}),\n      };\n    }\n\n    return this.apiHandler.generate(messages, options, runManager);\n  }\n\n  override async *_streamChatModelEvents(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatModelStreamEvent> {\n    yield* this.apiHandler.streamChatModelEvents(messages, options, runManager);\n  }\n\n  async *_streamResponseChunks(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatGenerationChunk> {\n    yield* this.apiHandler.streamResponseChunks(messages, options, runManager);\n  }\n\n  /**\n   * Bind tool-like objects to this chat model.\n   *\n   * @param tools A list of tool definitions to bind to this chat model.\n   * Can be a structured tool, an OpenAI formatted tool, or a Gemini function declaration.\n   * @param kwargs Any additional parameters to bind.\n   */\n  bindTools(\n    tools: BindToolsInput[],\n    kwargs?: Partial<CallOptions>\n  ): Runnable<BaseMessage[], AIMessageChunk, CallOptions> {\n    return this.withConfig({\n      ...kwargs,\n      tools,\n    } as Partial<CallOptions>);\n  }\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<false>\n  ): Runnable<BaseLanguageModelInput, RunOutput>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<true>\n  ): Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  /**\n   * Get structured output from the model based on a schema.\n   *\n   * This method supports two modes:\n   * - `jsonMode`: Uses `responseSchema` to get JSON responses directly (preferred for structured outputs)\n   * - `functionCalling`: Uses function calling with tools (default, for compatibility)\n   *\n   * @param outputSchema - The schema to use for structured output (Zod schema or JSON Schema)\n   * @param config - Configuration options including method and whether to include raw response\n   * @returns A Runnable that returns the parsed structured output\n   */\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<\n        BaseLanguageModelInput,\n        { raw: BaseMessage; parsed: RunOutput }\n      > {\n    let llm: Runnable<BaseMessage[], AIMessageChunk, CallOptions>;\n    let outputParser: Runnable<BaseMessage, RunOutput>;\n\n    const { schema, name, includeRaw } = {\n      ...config,\n      schema: outputSchema,\n    };\n    let method = config?.method ?? \"functionCalling\";\n\n    if (method === \"jsonMode\") {\n      console.warn(\n        `\"jsonMode\" is not supported for Google models. Falling back to \"jsonSchema\".`\n      );\n      method = \"jsonSchema\";\n    }\n\n    if (method === \"jsonSchema\") {\n      // Use JSON mode with responseSchema\n      llm = this.withConfig({\n        responseSchema: schema,\n      } as Partial<CallOptions>);\n\n      outputParser = RunnableLambda.from<BaseMessage, RunOutput>(\n        async (input: BaseMessage): Promise<RunOutput> => {\n          if (\n            !AIMessage.isInstance(input) &&\n            !AIMessageChunk.isInstance(input)\n          ) {\n            throw new MalformedOutputError({\n              message: \"Input is not an AIMessage or AIMessageChunk.\",\n            });\n          }\n\n          if (!input.text) {\n            throw new MalformedOutputError({\n              message:\n                \"No content found in response. Cannot parse structured output.\",\n            });\n          }\n\n          // Parse JSON and validate with schema\n          const parser = createContentParser(schema);\n          return await parser.parse(input.text);\n        }\n      );\n    } else if (method === \"functionCalling\") {\n      const { tools, toolChoice, functionName } =\n        this.apiHandler.formatStructuredOutputTool(schema, { name });\n\n      llm = this.bindTools(tools).withConfig({\n        tool_choice: toolChoice,\n      } as Partial<CallOptions>);\n\n      outputParser = createFunctionCallingParser(schema, functionName);\n    } else {\n      throw new ConfigurationError(\n        `Unrecognized structured output method '${method}'. Expected 'functionCalling' or 'jsonSchema'`\n      );\n    }\n\n    return assembleStructuredOutputPipeline(\n      llm,\n      outputParser,\n      includeRaw,\n      includeRaw\n        ? \"ChatGoogleStructuredOutputRunnable\"\n        : \"ChatGoogleStructuredOutput\"\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"base.js","names":[],"sources":["../../src/chat_models/base.ts"],"sourcesContent":["import {\n  BaseChatModel,\n  type LangSmithParams,\n} from \"@langchain/core/language_models/chat_models\";\nimport {\n  AIMessage,\n  AIMessageChunk,\n  BaseMessage,\n} from \"@langchain/core/messages\";\nimport { CallbackManagerForLLMRun } from \"@langchain/core/callbacks/manager\";\nimport type { ChatModelStreamEvent } from \"@langchain/core/language_models/event\";\nimport { concat } from \"@langchain/core/utils/stream\";\nimport { ChatGenerationChunk, type ChatResult } from \"@langchain/core/outputs\";\nimport type { BindToolsInput } from \"@langchain/core/language_models/chat_models\";\nimport type { ModelProfile } from \"@langchain/core/language_models/profile\";\nimport PROFILES from \"./profiles.js\";\nimport type {\n  BaseLanguageModelInput,\n  StructuredOutputMethodOptions,\n} from \"@langchain/core/language_models/base\";\nimport { Runnable, RunnableLambda } from \"@langchain/core/runnables\";\nimport type { InteropZodType } from \"@langchain/core/utils/types\";\nimport { ApiClient } from \"../clients/index.js\";\nimport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n  GenerateContentApiHandlerParams,\n  InteractionsApiHandlerParams,\n} from \"./types.js\";\nimport { ConfigurationError, MalformedOutputError } from \"../utils/errors.js\";\nimport { usageMetadataToTokenUsage } from \"../utils/metadata.js\";\nimport type { SerializableSchema } from \"@langchain/core/utils/standard_schema\";\nimport {\n  assembleStructuredOutputPipeline,\n  createContentParser,\n  createFunctionCallingParser,\n} from \"@langchain/core/language_models/structured_output\";\nimport { resolveLangSmithGatewayConfig } from \"@langchain/core/utils/gateway\";\nimport { getEnvironmentVariable } from \"@langchain/core/utils/env\";\nimport {\n  GoogleChatApiHandler,\n  GenerateContentApiHandler,\n  InteractionsApiHandler,\n} from \"./handlers/index.js\";\nimport { convertParamsToPlatformType } from \"../converters/shared/params.js\";\n\nexport type {\n  BaseChatGoogleParams,\n  BaseChatGoogleCallOptions,\n  GooglePlatformType,\n} from \"./types.js\";\n\nfunction hasVertexCredentials(params: {\n  credentials?: unknown;\n  googleAuthOptions?: unknown;\n}): boolean {\n  return (\n    typeof params.credentials !== \"undefined\" ||\n    typeof params.googleAuthOptions !== \"undefined\" ||\n    typeof getEnvironmentVariable(\"GOOGLE_CLOUD_CREDENTIALS\") !== \"undefined\"\n  );\n}\n\n/**\n * Resolves LangSmith gateway routing for Google chat model params.\n *\n * The LangSmith gateway exposes direct paths for the Gemini Developer API and\n * Vertex AI. An explicit `endpoint` or explicit credentials (`apiKey`,\n * `credentials`, `googleAuthOptions`) suppress gateway routing.\n *\n * When `LANGSMITH_GATEWAY` is set, this rewrites `endpoint` to the gateway\n * host and uses the gateway key as the API key. The default\n * `https` gateway host is written scheme-less (the URL builders prepend\n * `https://`); a non-`https` custom gateway keeps its scheme so it is not\n * forced to TLS.\n *\n * This function is pure: it never mutates `params`. It returns a new object\n * with the gateway overrides applied when routing is active, or an unchanged\n * shallow copy otherwise.\n *\n * @returns a new params object with gateway routing applied when applicable.\n */\nexport function applyGeminiGatewayParams<TParams extends object>(\n  params: TParams\n): TParams & {\n  apiKey?: string;\n  endpoint?: string;\n  platformType?: GooglePlatformType;\n} {\n  const p = params as {\n    apiKey?: string;\n    endpoint?: string;\n    platformType?: GooglePlatformType;\n    vertexai?: boolean;\n    credentials?: unknown;\n    googleAuthOptions?: unknown;\n  };\n  if (\n    typeof p.endpoint !== \"undefined\" ||\n    typeof p.apiKey !== \"undefined\" ||\n    typeof p.credentials !== \"undefined\" ||\n    typeof p.googleAuthOptions !== \"undefined\"\n  ) {\n    return { ...params };\n  }\n  const platform =\n    convertParamsToPlatformType(p) ?? (hasVertexCredentials(p) ? \"gcp\" : \"gai\");\n  const gatewayConfig = resolveLangSmithGatewayConfig({\n    providerPath: platform === \"gcp\" ? \"vertex\" : \"gemini\",\n  });\n  if (typeof gatewayConfig.baseURL === \"undefined\") {\n    return { ...params };\n  }\n\n  const gatewayUrl = new URL(gatewayConfig.baseURL);\n  const path = gatewayUrl.pathname.replace(/\\/+$/, \"\");\n  // The URL builders compose `https://${endpoint}/${apiVersion}/...`. For the\n  // default `https` gateway, keep the endpoint scheme-less (host + path) so the\n  // builder's `https://` prefix produces the right URL. For a non-`https`\n  // custom gateway (e.g. `http://localhost:8080`), keep the full scheme so the\n  // builder does not force TLS; `buildUrlGemini` skips its prefix when the\n  // endpoint already includes a scheme.\n  const endpoint =\n    gatewayUrl.protocol === \"https:\"\n      ? `${gatewayUrl.host}${path}`\n      : `${gatewayUrl.protocol}//${gatewayUrl.host}${path}`;\n  return {\n    ...params,\n    apiKey: gatewayConfig.apiKey,\n    endpoint,\n    platformType: platform,\n  };\n}\n\nexport function getPlatformType(\n  platform: GooglePlatformType | undefined,\n  hasApiKey: boolean\n): GooglePlatformType {\n  if (typeof platform !== \"undefined\") {\n    return platform;\n  } else if (hasApiKey) {\n    return \"gai\";\n  } else {\n    return \"gcp\";\n  }\n}\n\nexport abstract class BaseChatGoogle<\n  CallOptions extends BaseChatGoogleCallOptions = BaseChatGoogleCallOptions,\n> extends BaseChatModel<CallOptions, AIMessageChunk> {\n  model: string;\n\n  streaming: boolean;\n\n  disableStreaming: boolean;\n\n  streamUsage: boolean = true;\n\n  protected _platform?: GooglePlatformType;\n\n  protected _endpoint?: string;\n\n  protected _customHeaders?: Record<string, string>;\n\n  protected _location?: string;\n\n  protected _apiVersion?: string;\n\n  protected apiClient: ApiClient;\n\n  constructor(\n    protected params: BaseChatGoogleParams & {\n      credentials?: unknown;\n      googleAuthOptions?: unknown;\n    }\n  ) {\n    super(params);\n    this._addVersion(\"@langchain/google\", __PKG_VERSION__);\n\n    if (!params.apiClient) {\n      throw new ConfigurationError(\n        \"BaseChatGoogle requires an apiClient. This should be provided automatically by ChatGoogle constructors. If you're extending BaseChatGoogle directly, please provide an apiClient instance.\"\n      );\n    }\n    this.apiClient = params.apiClient;\n\n    this.model = params.model;\n    this._platform = convertParamsToPlatformType(params);\n    this._endpoint = params.endpoint;\n    this._customHeaders = params.customHeaders;\n    this._location = params.location;\n    this._apiVersion = params.apiVersion;\n\n    this.disableStreaming = params?.disableStreaming === true;\n    this.streaming = params?.streaming === true;\n    if (this.disableStreaming) this.streaming = false;\n    // disable streaming in BaseChatModel if explicitly disabled\n    if (params?.streaming === false) this.disableStreaming = true;\n\n    this.streamUsage = params?.streamUsage ?? this.streamUsage;\n    if (this.disableStreaming) this.streamUsage = false;\n  }\n\n  _llmType(): string {\n    return \"google\";\n  }\n\n  protected get platformType(): GooglePlatformType | undefined {\n    return this._platform;\n  }\n\n  protected get platform(): GooglePlatformType {\n    return getPlatformType(this._platform, this.apiClient.hasApiKey());\n  }\n\n  protected get isVertexExpress(): boolean {\n    return (\n      this.platform === \"gcp\" &&\n      this.apiClient.hasApiKey() &&\n      !hasVertexCredentials(this.params)\n    );\n  }\n\n  protected get apiVersion(): string {\n    if (typeof this._apiVersion !== \"undefined\") {\n      return this._apiVersion;\n    } else if (this.platform === \"gai\") {\n      return \"v1beta\";\n    } else {\n      return \"v1\";\n    }\n  }\n\n  protected get location(): string {\n    return this._location || \"global\";\n  }\n\n  protected get endpoint(): string {\n    if (typeof this._endpoint !== \"undefined\") {\n      return this._endpoint;\n    } else if (this.platform === \"gai\") {\n      return \"generativelanguage.googleapis.com\";\n    } else if (this.isVertexExpress) {\n      return \"aiplatform.googleapis.com\";\n    } else if (this.location === \"global\") {\n      // See https://docs.cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#use_the_global_endpoint\n      return \"aiplatform.googleapis.com\";\n    } else if (!this.location.includes(\"-\")) {\n      return `aiplatform.${this.location}.rep.googleapis.com`;\n    } else {\n      return `${this.location}-aiplatform.googleapis.com`;\n    }\n  }\n\n  protected get publisher(): string {\n    return \"google\";\n  }\n\n  protected _apiHandler?: GoogleChatApiHandler;\n\n  protected _handlerParams?: GenerateContentApiHandlerParams &\n    InteractionsApiHandlerParams;\n\n  protected syncHandlerParams(): GenerateContentApiHandlerParams &\n    InteractionsApiHandlerParams {\n    const nextParams: GenerateContentApiHandlerParams &\n      InteractionsApiHandlerParams = {\n      ...this.params,\n      model: this.model,\n      platform: this.platform,\n      endpoint: this.endpoint,\n      location: this.location,\n      apiVersion: this.apiVersion,\n      isVertexExpress: this.isVertexExpress,\n      publisher: this.publisher,\n      streaming: this.streaming,\n      streamUsage: this.streamUsage,\n      customHeaders: this._customHeaders,\n      apiClient: this.apiClient,\n      caller: this.caller,\n    };\n    if (this._handlerParams) {\n      return Object.assign(this._handlerParams, nextParams);\n    }\n    this._handlerParams = nextParams;\n    return this._handlerParams;\n  }\n\n  protected get apiHandler(): GoogleChatApiHandler {\n    const handlerParams = this.syncHandlerParams();\n    if (!this._apiHandler) {\n      const handlerConfig = this.params.apiHandler ?? \"generateContent\";\n\n      if (typeof handlerConfig === \"function\") {\n        this._apiHandler = handlerConfig(handlerParams);\n      } else if (handlerConfig === \"generateContent\") {\n        this._apiHandler = new GenerateContentApiHandler(handlerParams);\n      } else if (handlerConfig === \"interactions\") {\n        this._apiHandler = new InteractionsApiHandler(handlerParams);\n      } else {\n        throw new ConfigurationError(`Unknown apiHandler: ${handlerConfig}`);\n      }\n    }\n    return this._apiHandler;\n  }\n\n  /**\n   * Returns the model profile for this instance's model, describing its\n   * capabilities and constraints (e.g. max tokens, input/output modalities,\n   * tool calling support).\n   *\n   * @example\n   * ```typescript\n   * const model = new ChatGoogle({ model: \"gemini-2.5-pro\" });\n   * const profile = model.profile;\n   * console.log(profile.maxInputTokens); // 1048576\n   * console.log(profile.imageInputs); // true\n   * ```\n   */\n  get profile(): ModelProfile {\n    return PROFILES[this.model] ?? {};\n  }\n\n  async buildUrl(urlMethod?: string): Promise<string> {\n    return this.apiHandler.buildUrl(urlMethod);\n  }\n\n  override invocationParams(\n    options: this[\"ParsedCallOptions\"]\n  ): Record<string, unknown> {\n    return this.apiHandler.invocationParams(options) as Record<string, unknown>;\n  }\n\n  getLsParams(options: this[\"ParsedCallOptions\"]): LangSmithParams {\n    return {\n      ls_provider: this.platform === \"gcp\" ? \"google_vertexai\" : \"google_genai\",\n      ls_model_name: this.model,\n      ls_model_type: \"chat\",\n      ls_temperature: options?.temperature ?? this.params.temperature,\n      ls_max_tokens: options?.maxOutputTokens ?? this.params.maxOutputTokens,\n      ls_stop:\n        options?.stopSequences ?? options?.stop ?? this.params.stopSequences,\n    };\n  }\n\n  getHeaders(options?: this[\"ParsedCallOptions\"]): HeadersInit {\n    return this.apiHandler.getHeaders(options);\n  }\n\n  async _generate(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): Promise<ChatResult> {\n    if (this.streaming) {\n      const stream = await this._streamResponseChunks(\n        messages,\n        options,\n        runManager\n      );\n      let finalChunk: ChatGenerationChunk | null = null;\n      for await (const chunk of stream) {\n        finalChunk = !finalChunk ? chunk : concat(finalChunk, chunk);\n      }\n      if (\n        typeof finalChunk?.message?.content === \"string\" &&\n        typeof (\n          finalChunk?.message?.additional_kwargs\n            ?.originalTextContentBlock as Record<string, unknown>\n        )?.text === \"string\"\n      ) {\n        (\n          finalChunk.message.additional_kwargs\n            .originalTextContentBlock as Record<string, unknown>\n        ).text = finalChunk.message.content;\n      }\n      const usageMetadata = (finalChunk?.message as AIMessageChunk | undefined)\n        ?.usage_metadata;\n      return {\n        generations: finalChunk ? [finalChunk] : [],\n        ...(usageMetadata\n          ? {\n              llmOutput: {\n                tokenUsage: usageMetadataToTokenUsage(usageMetadata),\n                usageMetadata,\n              },\n            }\n          : {}),\n      };\n    }\n\n    return this.apiHandler.generate(messages, options, runManager);\n  }\n\n  override async *_streamChatModelEvents(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatModelStreamEvent> {\n    yield* this.apiHandler.streamChatModelEvents(messages, options, runManager);\n  }\n\n  async *_streamResponseChunks(\n    messages: BaseMessage[],\n    options: this[\"ParsedCallOptions\"],\n    runManager?: CallbackManagerForLLMRun\n  ): AsyncGenerator<ChatGenerationChunk> {\n    yield* this.apiHandler.streamResponseChunks(messages, options, runManager);\n  }\n\n  /**\n   * Bind tool-like objects to this chat model.\n   *\n   * @param tools A list of tool definitions to bind to this chat model.\n   * Can be a structured tool, an OpenAI formatted tool, or a Gemini function declaration.\n   * @param kwargs Any additional parameters to bind.\n   */\n  bindTools(\n    tools: BindToolsInput[],\n    kwargs?: Partial<CallOptions>\n  ): Runnable<BaseMessage[], AIMessageChunk, CallOptions> {\n    return this.withConfig({\n      ...kwargs,\n      tools,\n    } as Partial<CallOptions>);\n  }\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<false>\n  ): Runnable<BaseLanguageModelInput, RunOutput>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<true>\n  ): Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<BaseLanguageModelInput, { raw: BaseMessage; parsed: RunOutput }>;\n\n  /**\n   * Get structured output from the model based on a schema.\n   *\n   * This method supports two modes:\n   * - `jsonMode`: Uses `responseSchema` to get JSON responses directly (preferred for structured outputs)\n   * - `functionCalling`: Uses function calling with tools (default, for compatibility)\n   *\n   * @param outputSchema - The schema to use for structured output (Zod schema or JSON Schema)\n   * @param config - Configuration options including method and whether to include raw response\n   * @returns A Runnable that returns the parsed structured output\n   */\n  withStructuredOutput<\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    RunOutput extends Record<string, any> = Record<string, any>,\n  >(\n    outputSchema:\n      | InteropZodType<RunOutput>\n      | SerializableSchema<RunOutput>\n      // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n      | Record<string, any>,\n    config?: StructuredOutputMethodOptions<boolean>\n  ):\n    | Runnable<BaseLanguageModelInput, RunOutput>\n    | Runnable<\n        BaseLanguageModelInput,\n        { raw: BaseMessage; parsed: RunOutput }\n      > {\n    let llm: Runnable<BaseMessage[], AIMessageChunk, CallOptions>;\n    let outputParser: Runnable<BaseMessage, RunOutput>;\n\n    const { schema, name, includeRaw } = {\n      ...config,\n      schema: outputSchema,\n    };\n    let method = config?.method ?? \"functionCalling\";\n\n    if (method === \"jsonMode\") {\n      console.warn(\n        `\"jsonMode\" is not supported for Google models. Falling back to \"jsonSchema\".`\n      );\n      method = \"jsonSchema\";\n    }\n\n    if (method === \"jsonSchema\") {\n      // Use JSON mode with responseSchema\n      llm = this.withConfig({\n        responseSchema: schema,\n      } as Partial<CallOptions>);\n\n      outputParser = RunnableLambda.from<BaseMessage, RunOutput>(\n        async (input: BaseMessage): Promise<RunOutput> => {\n          if (\n            !AIMessage.isInstance(input) &&\n            !AIMessageChunk.isInstance(input)\n          ) {\n            throw new MalformedOutputError({\n              message: \"Input is not an AIMessage or AIMessageChunk.\",\n            });\n          }\n\n          if (!input.text) {\n            throw new MalformedOutputError({\n              message:\n                \"No content found in response. Cannot parse structured output.\",\n            });\n          }\n\n          // Parse JSON and validate with schema\n          const parser = createContentParser(schema);\n          return await parser.parse(input.text);\n        }\n      );\n    } else if (method === \"functionCalling\") {\n      const { tools, toolChoice, functionName } =\n        this.apiHandler.formatStructuredOutputTool(schema, { name });\n\n      llm = this.bindTools(tools).withConfig({\n        tool_choice: toolChoice,\n      } as Partial<CallOptions>);\n\n      outputParser = createFunctionCallingParser(schema, functionName);\n    } else {\n      throw new ConfigurationError(\n        `Unrecognized structured output method '${method}'. Expected 'functionCalling' or 'jsonSchema'`\n      );\n    }\n\n    return assembleStructuredOutputPipeline(\n      llm,\n      outputParser,\n      includeRaw,\n      includeRaw\n        ? \"ChatGoogleStructuredOutputRunnable\"\n        : \"ChatGoogleStructuredOutput\"\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/chat_models/handlers/base.cjs

@@ -1,4 +1,4 @@
-//#region src/chat_models/handlers/base.ts
+// src/chat_models/handlers/base.ts
 /**
 * Base abstract handler for Google Chat wire protocols.
 *
@@ -57,7 +57,6 @@ var GoogleChatApiHandler = class {
 		};
 	}
 };
-//#endregion
 exports.GoogleChatApiHandler = GoogleChatApiHandler;
 
 //# sourceMappingURL=base.cjs.map

package/dist/chat_models/handlers/base.d.cts

@@ -6,7 +6,6 @@ import { ChatModelStreamEvent } from "@langchain/core/language_models/event";
 import { ChatGenerationChunk, ChatResult } from "@langchain/core/outputs";
 import { InteropZodType } from "@langchain/core/utils/types";
 import { SerializableSchema } from "@langchain/core/utils/standard_schema";
-//#region src/chat_models/handlers/base.d.ts
 /**
  * Base abstract handler for Google Chat wire protocols.
  *
@@ -44,5 +43,4 @@ export declare abstract class GoogleChatApiHandler<TInvocationParams extends obj
   };
   abstract streamChatModelEvents(messages: BaseMessage[], options?: BaseChatGoogleCallOptions, runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatModelStreamEvent>;
 }
-//#endregion
 //# sourceMappingURL=base.d.cts.map

package/dist/chat_models/handlers/base.d.ts

@@ -6,7 +6,6 @@ import { InteropZodType } from "@langchain/core/utils/types";
 import { SerializableSchema } from "@langchain/core/utils/standard_schema";
 import { CallbackManagerForLLMRun } from "@langchain/core/callbacks/manager";
 import { ChatModelStreamEvent } from "@langchain/core/language_models/event";
-//#region src/chat_models/handlers/base.d.ts
 /**
  * Base abstract handler for Google Chat wire protocols.
  *
@@ -44,5 +43,4 @@ export declare abstract class GoogleChatApiHandler<TInvocationParams extends obj
   };
   abstract streamChatModelEvents(messages: BaseMessage[], options?: BaseChatGoogleCallOptions, runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatModelStreamEvent>;
 }
-//#endregion
 //# sourceMappingURL=base.d.ts.map

package/dist/chat_models/handlers/base.js

@@ -1,4 +1,4 @@
-//#region src/chat_models/handlers/base.ts
+// src/chat_models/handlers/base.ts
 /**
 * Base abstract handler for Google Chat wire protocols.
 *
@@ -57,7 +57,6 @@ var GoogleChatApiHandler = class {
 		};
 	}
 };
-//#endregion
 export { GoogleChatApiHandler };
 
 //# sourceMappingURL=base.js.map

package/dist/chat_models/handlers/generate_content.cjs

@@ -1,20 +1,20 @@
-const require_misc = require("../../utils/misc.cjs");
-const require_errors = require("../../utils/errors.cjs");
-const require_metadata = require("../../utils/metadata.cjs");
 const require_base = require("./base.cjs");
 const require_stream = require("../../utils/stream.cjs");
+const require_metadata = require("../../utils/metadata.cjs");
+const require_misc = require("../../utils/misc.cjs");
+const require_errors = require("../../utils/errors.cjs");
 const require_messages = require("../../converters/generate_content/messages.cjs");
 const require_tools = require("../../converters/generate_content/tools.cjs");
-const require_types = require("../types.cjs");
 const require_params = require("../../converters/generate_content/params.cjs");
 const require_stream_events = require("../../converters/generate_content/stream_events.cjs");
+const require_types = require("../types.cjs");
 let _langchain_core_messages = require("@langchain/core/messages");
 let _langchain_core_outputs = require("@langchain/core/outputs");
 let _langchain_core_utils_types = require("@langchain/core/utils/types");
 let _langchain_core_utils_standard_schema = require("@langchain/core/utils/standard_schema");
 let _langchain_core_utils_json_schema = require("@langchain/core/utils/json_schema");
 let eventsource_parser_stream = require("eventsource-parser/stream");
-//#region src/chat_models/handlers/generate_content.ts
+// src/chat_models/handlers/generate_content.ts
 /**
 * Concrete wire protocol handler for Google's Generate Content API
 * (`/v1beta/models/{model}:generateContent` and `:streamGenerateContent`).
@@ -78,7 +78,7 @@ var GenerateContentApiHandler = class extends require_base.GoogleChatApiHandler
 			status: response.status,
 			statusText: response.statusText
 		});
-		if (data.promptFeedback?.blockReason) throw require_errors.PromptBlockedError.fromPromptFeedback(data.promptFeedback);
+		if (data.promptFeedback?.blockReason) throw require_errors.promptBlockedError(data.promptFeedback);
 		if (!data.candidates || data.candidates.length === 0) throw new require_errors.NoCandidatesError();
 		const candidate = data.candidates[0];
 		const message = require_messages.convertGeminiCandidateToAIMessage(candidate);
@@ -164,6 +164,7 @@ var GenerateContentApiHandler = class extends require_base.GoogleChatApiHandler
 					}));
 					return;
 				}
+				if (chunk.promptFeedback?.blockReason) throw require_errors.promptBlockedError(chunk.promptFeedback);
 				const candidate = chunk.candidates?.[0];
 				if (!candidate) {
 					if (chunk.usageMetadata && streamUsage) {
@@ -339,7 +340,6 @@ var GenerateContentApiHandler = class extends require_base.GoogleChatApiHandler
 		};
 	}
 };
-//#endregion
 exports.GenerateContentApiHandler = GenerateContentApiHandler;
 
 //# sourceMappingURL=generate_content.cjs.map