@langchain/google-common 2.0.3 → 2.0.4

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @langchain/google-common
 
+## 2.0.4
+
+### Patch Changes
+
+- Updated dependencies [[`0bade90`](https://github.com/langchain-ai/langchainjs/commit/0bade90ed47c7988ed86f1e695a28273c7b3df50), [`6c40d00`](https://github.com/langchain-ai/langchainjs/commit/6c40d00e926f377d249c2919549381522eac8ed1)]:
+  - @langchain/core@1.1.4
+
 ## 2.0.3
 
 ### Patch Changes

package/dist/chat_models.d.cts

@@ -30,11 +30,13 @@ interface ChatGoogleBaseInput<AuthOptions> extends BaseChatModelParams, GoogleCo
  * Integration with a Google chat model.
  */
 declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleAIBaseLanguageModelCallOptions, AIMessageChunk> implements ChatGoogleBaseInput<AuthOptions> {
+  // Used for tracing, replace with the same name as your class
   static lc_name(): string;
   get lc_secrets(): {
     [key: string]: string;
   } | undefined;
   lc_serializable: boolean;
+  // Set based on modelName
   model: string;
   modelName: string;
   temperature: number;
@@ -50,6 +52,7 @@ declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleA
   topLogprobs: number;
   safetySettings: GoogleAISafetySetting[];
   responseModalities?: GoogleAIModelModality[];
+  // May intentionally be undefined, meaning to compute this.
   convertSystemMessageToHumanContent: boolean | undefined;
   safetyHandler: GoogleAISafetyHandler;
   speechConfig: GoogleSpeechConfig;
@@ -67,6 +70,7 @@ declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleA
   buildConnection(fields: GoogleBaseLLMInput<AuthOptions>, client: GoogleAbstractedClient): void;
   get platform(): GooglePlatformType;
   bindTools(tools: GoogleAIToolType[], kwargs?: Partial<GoogleAIBaseLanguageModelCallOptions>): Runnable<BaseLanguageModelInput, AIMessageChunk, GoogleAIBaseLanguageModelCallOptions>;
+  // Replace
   _llmType(): string;
   /**
    * Get the parameters used to invoke the model
@@ -86,8 +90,16 @@ declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleA
    * @returns {ModelProfile} An object describing the model's capabilities and constraints
    */
   get profile(): ModelProfile;
-  withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<false>): Runnable<BaseLanguageModelInput, RunOutput>;
-  withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<true>): Runnable<BaseLanguageModelInput, {
+  withStructuredOutput<
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput>
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | Record<string, any>, config?: StructuredOutputMethodOptions<false>): Runnable<BaseLanguageModelInput, RunOutput>;
+  withStructuredOutput<
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput>
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | Record<string, any>, config?: StructuredOutputMethodOptions<true>): Runnable<BaseLanguageModelInput, {
     raw: BaseMessage;
     parsed: RunOutput;
   }>;

package/dist/chat_models.d.ts

@@ -30,11 +30,13 @@ interface ChatGoogleBaseInput<AuthOptions> extends BaseChatModelParams, GoogleCo
  * Integration with a Google chat model.
  */
 declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleAIBaseLanguageModelCallOptions, AIMessageChunk> implements ChatGoogleBaseInput<AuthOptions> {
+  // Used for tracing, replace with the same name as your class
   static lc_name(): string;
   get lc_secrets(): {
     [key: string]: string;
   } | undefined;
   lc_serializable: boolean;
+  // Set based on modelName
   model: string;
   modelName: string;
   temperature: number;
@@ -50,6 +52,7 @@ declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleA
   topLogprobs: number;
   safetySettings: GoogleAISafetySetting[];
   responseModalities?: GoogleAIModelModality[];
+  // May intentionally be undefined, meaning to compute this.
   convertSystemMessageToHumanContent: boolean | undefined;
   safetyHandler: GoogleAISafetyHandler;
   speechConfig: GoogleSpeechConfig;
@@ -67,6 +70,7 @@ declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleA
   buildConnection(fields: GoogleBaseLLMInput<AuthOptions>, client: GoogleAbstractedClient): void;
   get platform(): GooglePlatformType;
   bindTools(tools: GoogleAIToolType[], kwargs?: Partial<GoogleAIBaseLanguageModelCallOptions>): Runnable<BaseLanguageModelInput, AIMessageChunk, GoogleAIBaseLanguageModelCallOptions>;
+  // Replace
   _llmType(): string;
   /**
    * Get the parameters used to invoke the model
@@ -86,8 +90,16 @@ declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<GoogleA
    * @returns {ModelProfile} An object describing the model's capabilities and constraints
    */
   get profile(): ModelProfile;
-  withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<false>): Runnable<BaseLanguageModelInput, RunOutput>;
-  withStructuredOutput<RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput> | Record<string, any>, config?: StructuredOutputMethodOptions<true>): Runnable<BaseLanguageModelInput, {
+  withStructuredOutput<
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput>
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | Record<string, any>, config?: StructuredOutputMethodOptions<false>): Runnable<BaseLanguageModelInput, RunOutput>;
+  withStructuredOutput<
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  RunOutput extends Record<string, any> = Record<string, any>>(outputSchema: InteropZodType<RunOutput>
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | Record<string, any>, config?: StructuredOutputMethodOptions<true>): Runnable<BaseLanguageModelInput, {
     raw: BaseMessage;
     parsed: RunOutput;
   }>;

package/dist/connection.d.cts

@@ -24,6 +24,8 @@ declare abstract class GoogleConnection<CallOptions extends AsyncCallerCallOptio
   _request(data: unknown | undefined, options: CallOptions, requestHeaders?: Record<string, string>): Promise<ResponseType>;
 }
 declare abstract class GoogleHostConnection<CallOptions extends AsyncCallerCallOptions, ResponseType extends GoogleResponse, AuthOptions> extends GoogleConnection<CallOptions, ResponseType> implements GoogleConnectionParams<AuthOptions> {
+  // This does not default to a value intentionally.
+  // Use the "platform" getter if you need this.
   platformType: GooglePlatformType | undefined;
   _endpoint: string | undefined;
   _location: string | undefined;

package/dist/connection.d.ts

@@ -24,6 +24,8 @@ declare abstract class GoogleConnection<CallOptions extends AsyncCallerCallOptio
   _request(data: unknown | undefined, options: CallOptions, requestHeaders?: Record<string, string>): Promise<ResponseType>;
 }
 declare abstract class GoogleHostConnection<CallOptions extends AsyncCallerCallOptions, ResponseType extends GoogleResponse, AuthOptions> extends GoogleConnection<CallOptions, ResponseType> implements GoogleConnectionParams<AuthOptions> {
+  // This does not default to a value intentionally.
+  // Use the "platform" getter if you need this.
   platformType: GooglePlatformType | undefined;
   _endpoint: string | undefined;
   _location: string | undefined;

package/dist/experimental/media.d.cts

@@ -38,6 +38,7 @@ declare abstract class BlobStoreGoogle<ResponseType extends GoogleResponse, Auth
   abstract buildDeleteConnection(key: string): GoogleDownloadConnection<AsyncCallerCallOptions, GoogleResponse, AuthOptions>;
   _del(key: string): Promise<void>;
   mdelete(keys: string[]): Promise<void>;
+  // eslint-disable-next-line require-yield
   yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;
 }
 /**
@@ -108,7 +109,7 @@ declare abstract class BlobStoreGoogleCloudStorageBase<AuthOptions> extends Blob
 type AIStudioFileState = "PROCESSING" | "ACTIVE" | "FAILED" | "STATE_UNSPECIFIED";
 type AIStudioFileVideoMetadata = {
   videoMetadata: {
-    videoDuration: string;
+    videoDuration: string; // Duration in seconds, possibly with fractional, ending in "s"
   };
 };
 type AIStudioFileMetadata = AIStudioFileVideoMetadata;
@@ -116,11 +117,11 @@ interface AIStudioFileObject {
   name?: string;
   displayName?: string;
   mimeType?: string;
-  sizeBytes?: string;
-  createTime?: string;
-  updateTime?: string;
-  expirationTime?: string;
-  sha256Hash?: string;
+  sizeBytes?: string; // int64 format
+  createTime?: string; // timestamp format
+  updateTime?: string; // timestamp format
+  expirationTime?: string; // timestamp format
+  sha256Hash?: string; // base64 encoded
   uri?: string;
   state?: AIStudioFileState;
   error?: {

package/dist/experimental/media.d.ts

@@ -38,6 +38,7 @@ declare abstract class BlobStoreGoogle<ResponseType extends GoogleResponse, Auth
   abstract buildDeleteConnection(key: string): GoogleDownloadConnection<AsyncCallerCallOptions, GoogleResponse, AuthOptions>;
   _del(key: string): Promise<void>;
   mdelete(keys: string[]): Promise<void>;
+  // eslint-disable-next-line require-yield
   yieldKeys(_prefix: string | undefined): AsyncGenerator<string>;
 }
 /**
@@ -108,7 +109,7 @@ declare abstract class BlobStoreGoogleCloudStorageBase<AuthOptions> extends Blob
 type AIStudioFileState = "PROCESSING" | "ACTIVE" | "FAILED" | "STATE_UNSPECIFIED";
 type AIStudioFileVideoMetadata = {
   videoMetadata: {
-    videoDuration: string;
+    videoDuration: string; // Duration in seconds, possibly with fractional, ending in "s"
   };
 };
 type AIStudioFileMetadata = AIStudioFileVideoMetadata;
@@ -116,11 +117,11 @@ interface AIStudioFileObject {
   name?: string;
   displayName?: string;
   mimeType?: string;
-  sizeBytes?: string;
-  createTime?: string;
-  updateTime?: string;
-  expirationTime?: string;
-  sha256Hash?: string;
+  sizeBytes?: string; // int64 format
+  createTime?: string; // timestamp format
+  updateTime?: string; // timestamp format
+  expirationTime?: string; // timestamp format
+  sha256Hash?: string; // base64 encoded
   uri?: string;
   state?: AIStudioFileState;
   error?: {

package/dist/experimental/utils/media_core.d.cts

@@ -3,8 +3,8 @@ import { Serializable } from "@langchain/core/load/serializable";
 
 //#region src/experimental/utils/media_core.d.ts
 type MediaBlobData = {
-  value: string;
-  type: string;
+  value: string; // In Base64 encoding
+  type: string; // The mime type and possibly encoding
 };
 interface MediaBlobParameters {
   data?: MediaBlobData;
@@ -19,6 +19,7 @@ declare class MediaBlob extends Serializable implements MediaBlobParameters {
   lc_serializable: boolean;
   lc_namespace: string[];
   data: MediaBlobData;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   metadata?: Record<string, any>;
   path?: string;
   constructor(params: MediaBlobParameters);
@@ -89,7 +90,7 @@ interface BlobStoreOptions {
  * implemented should be documented and throw an Error if called.
  */
 declare abstract class BlobStore extends BaseStore<string, MediaBlob> {
-  lc_namespace: string[];
+  lc_namespace: string[]; // FIXME - What should this be? And why?
   defaultStoreOptions: BlobStoreStoreOptions;
   defaultFetchOptions: BlobStoreFetchOptions;
   constructor(opts?: BlobStoreOptions);

package/dist/experimental/utils/media_core.d.ts

@@ -3,8 +3,8 @@ import { Serializable } from "@langchain/core/load/serializable";
 
 //#region src/experimental/utils/media_core.d.ts
 type MediaBlobData = {
-  value: string;
-  type: string;
+  value: string; // In Base64 encoding
+  type: string; // The mime type and possibly encoding
 };
 interface MediaBlobParameters {
   data?: MediaBlobData;
@@ -19,6 +19,7 @@ declare class MediaBlob extends Serializable implements MediaBlobParameters {
   lc_serializable: boolean;
   lc_namespace: string[];
   data: MediaBlobData;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   metadata?: Record<string, any>;
   path?: string;
   constructor(params: MediaBlobParameters);
@@ -89,7 +90,7 @@ interface BlobStoreOptions {
  * implemented should be documented and throw an Error if called.
  */
 declare abstract class BlobStore extends BaseStore<string, MediaBlob> {
-  lc_namespace: string[];
+  lc_namespace: string[]; // FIXME - What should this be? And why?
   defaultStoreOptions: BlobStoreStoreOptions;
   defaultFetchOptions: BlobStoreFetchOptions;
   constructor(opts?: BlobStoreOptions);

package/dist/llms.d.cts

@@ -15,6 +15,7 @@ declare class GoogleLLMConnection<AuthOptions> extends AbstractGoogleLLMConnecti
  * Integration with an LLM.
  */
 declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelCallOptions> implements GoogleBaseLLMInput<AuthOptions> {
+  // Used for tracing, replace with the same name as your class
   static lc_name(): string;
   get lc_secrets(): {
     [key: string]: string;
@@ -40,6 +41,7 @@ declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelC
   buildClient(fields?: GoogleAIBaseLLMInput<AuthOptions>): GoogleAbstractedClient;
   buildConnection(fields: GoogleBaseLLMInput<AuthOptions>, client: GoogleAbstractedClient): void;
   get platform(): GooglePlatformType;
+  // Replace
   _llmType(): string;
   formatPrompt(prompt: string): MessageContent;
   /**
@@ -49,6 +51,9 @@ declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelC
    * in order to handle public APi calls to `generate()`.
    */
   _call(prompt: string, options: this["ParsedCallOptions"]): Promise<string>;
+  // Normally, you should not override this method and instead should override
+  // _streamResponseChunks. We are doing so here to allow for multimodal inputs into
+  // the LLM.
   _streamIterator(input: BaseLanguageModelInput, options?: BaseLanguageModelCallOptions): AsyncGenerator<string>;
   predictMessages(messages: BaseMessage[], options?: string[] | BaseLanguageModelCallOptions, _callbacks?: Callbacks): Promise<BaseMessage>;
   /**
@@ -58,6 +63,8 @@ declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelC
    * TODO: Replace with something less hacky.
    */
   protected createProxyChat(): ChatGoogleBase<AuthOptions>;
+  // TODO: Remove the need to override this - we are doing it to
+  // allow the LLM to handle multimodal types of input.
   invoke(input: BaseLanguageModelInput, options?: BaseLanguageModelCallOptions): Promise<string>;
 }
 //#endregion

package/dist/llms.d.ts

@@ -15,6 +15,7 @@ declare class GoogleLLMConnection<AuthOptions> extends AbstractGoogleLLMConnecti
  * Integration with an LLM.
  */
 declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelCallOptions> implements GoogleBaseLLMInput<AuthOptions> {
+  // Used for tracing, replace with the same name as your class
   static lc_name(): string;
   get lc_secrets(): {
     [key: string]: string;
@@ -40,6 +41,7 @@ declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelC
   buildClient(fields?: GoogleAIBaseLLMInput<AuthOptions>): GoogleAbstractedClient;
   buildConnection(fields: GoogleBaseLLMInput<AuthOptions>, client: GoogleAbstractedClient): void;
   get platform(): GooglePlatformType;
+  // Replace
   _llmType(): string;
   formatPrompt(prompt: string): MessageContent;
   /**
@@ -49,6 +51,9 @@ declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelC
    * in order to handle public APi calls to `generate()`.
    */
   _call(prompt: string, options: this["ParsedCallOptions"]): Promise<string>;
+  // Normally, you should not override this method and instead should override
+  // _streamResponseChunks. We are doing so here to allow for multimodal inputs into
+  // the LLM.
   _streamIterator(input: BaseLanguageModelInput, options?: BaseLanguageModelCallOptions): AsyncGenerator<string>;
   predictMessages(messages: BaseMessage[], options?: string[] | BaseLanguageModelCallOptions, _callbacks?: Callbacks): Promise<BaseMessage>;
   /**
@@ -58,6 +63,8 @@ declare abstract class GoogleBaseLLM<AuthOptions> extends LLM<BaseLanguageModelC
    * TODO: Replace with something less hacky.
    */
   protected createProxyChat(): ChatGoogleBase<AuthOptions>;
+  // TODO: Remove the need to override this - we are doing it to
+  // allow the LLM to handle multimodal types of input.
   invoke(input: BaseLanguageModelInput, options?: BaseLanguageModelCallOptions): Promise<string>;
 }
 //#endregion

package/dist/types-anthropic.d.cts

@@ -62,6 +62,7 @@ interface AnthropicMessageContentRedactedThinking extends AnthropicMessageConten
   type: "redacted_thinking";
   data: string;
 }
+// TODO: Define this
 type AnthropicMessageContentToolUseInput = object;
 interface AnthropicMessageContentToolUse extends AnthropicMessageContentBase {
   type: "tool_use";
@@ -98,9 +99,10 @@ interface AnthropicToolChoiceTool extends AnthropicToolChoiceBase {
   name: string;
 }
 type AnthropicToolChoice = AnthropicToolChoiceAuto | AnthropicToolChoiceAny | AnthropicToolChoiceTool;
+// TODO: Define this
 type AnthropicToolInputSchema = object;
 interface AnthropicTool {
-  type?: string;
+  type?: string; // Just available on tools 20241022 and later?
   name: string;
   description?: string;
   cache_control?: AnthropicCacheControl;
@@ -219,6 +221,7 @@ interface AnthropicStreamPingEvent extends AnthropicStreamBaseEvent {
 }
 interface AnthropicStreamErrorEvent extends AnthropicStreamBaseEvent {
   type: "error";
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   error: any;
 }
 //#endregion

package/dist/types-anthropic.d.ts

@@ -62,6 +62,7 @@ interface AnthropicMessageContentRedactedThinking extends AnthropicMessageConten
   type: "redacted_thinking";
   data: string;
 }
+// TODO: Define this
 type AnthropicMessageContentToolUseInput = object;
 interface AnthropicMessageContentToolUse extends AnthropicMessageContentBase {
   type: "tool_use";
@@ -98,9 +99,10 @@ interface AnthropicToolChoiceTool extends AnthropicToolChoiceBase {
   name: string;
 }
 type AnthropicToolChoice = AnthropicToolChoiceAuto | AnthropicToolChoiceAny | AnthropicToolChoiceTool;
+// TODO: Define this
 type AnthropicToolInputSchema = object;
 interface AnthropicTool {
-  type?: string;
+  type?: string; // Just available on tools 20241022 and later?
   name: string;
   description?: string;
   cache_control?: AnthropicCacheControl;
@@ -219,6 +221,7 @@ interface AnthropicStreamPingEvent extends AnthropicStreamBaseEvent {
 }
 interface AnthropicStreamErrorEvent extends AnthropicStreamBaseEvent {
   type: "error";
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   error: any;
 }
 //#endregion

package/dist/types.d.cts

@@ -90,7 +90,7 @@ type GoogleAISafetyMethod = (typeof GoogleAISafetyMethod)[keyof typeof GoogleAIS
 interface GoogleAISafetySetting {
   category: GoogleAISafetyCategory | string;
   threshold: GoogleAISafetyThreshold | string;
-  method?: GoogleAISafetyMethod | string;
+  method?: GoogleAISafetyMethod | string; // Just for Vertex AI?
 }
 type GoogleAIResponseMimeType = "text/plain" | "application/json";
 type GoogleAIModelModality = "TEXT" | "IMAGE" | "AUDIO" | string;
@@ -308,6 +308,7 @@ interface GoogleAIModelRequestParams extends GoogleAIModelParams {
    *
    * The tool configuration's "any" mode ("forced function calling") is supported for Gemini 1.5 Pro models only.
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   tool_choice?: string | "auto" | "any" | "none" | Record<string, any>;
   /**
    * Allowed functions to call when the mode is "any".
@@ -339,17 +340,18 @@ interface GoogleAIBaseLanguageModelCallOptions extends BaseChatModelCallOptions,
  */
 interface GoogleBaseLLMInput<AuthOptions> extends GoogleAIBaseLLMInput<AuthOptions> {}
 interface GoogleResponse {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   data: any;
 }
 interface GoogleRawResponse extends GoogleResponse {
   data: Blob;
 }
 interface GeminiPartBase {
-  thought?: boolean;
+  thought?: boolean; // Output only
   thoughtSignature?: string;
 }
 interface GeminiVideoMetadata {
-  fps?: number;
+  fps?: number; // Double in range (0.0, 24.0]
   startOffset?: string;
   endOffset?: string;
 }
@@ -371,12 +373,14 @@ interface GeminiPartFileData extends GeminiPartBaseFile {
     fileUri: string;
   };
 }
+// AI Studio only?
 interface GeminiPartFunctionCall extends GeminiPartBase {
   functionCall: {
     name: string;
     args?: object;
   };
 }
+// AI Studio Only?
 interface GeminiPartFunctionResponse extends GeminiPartBase {
   functionResponse: {
     name: string;
@@ -404,9 +408,9 @@ interface GeminiCitation {
   publicationDate: GoogleTypeDate;
 }
 interface GoogleTypeDate {
-  year: number;
-  month: number;
-  day: number;
+  year: number; // 1-9999 or 0 to specify a date without a year
+  month: number; // 1-12 or 0 to specify a year without a month and day
+  day: number; // Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant
 }
 interface GeminiGroundingMetadata {
   webSearchQueries?: string[];
@@ -417,7 +421,7 @@ interface GeminiGroundingMetadata {
 }
 interface GeminiSearchEntryPoint {
   renderedContent?: string;
-  sdkBlob?: string;
+  sdkBlob?: string; // Base64 encoded JSON representing array of tuple.
 }
 interface GeminiGroundingChunk {
   web: GeminiGroundingChunkWeb;
@@ -470,18 +474,26 @@ interface GeminiLogprobsResultCandidate {
   tokenId: number;
   logProbability: number;
 }
+// The "system" content appears to only be valid in the systemInstruction
 type GeminiRole = "system" | "user" | "model" | "function";
 interface GeminiContent {
   parts: GeminiPart[];
-  role: GeminiRole;
+  role: GeminiRole; // Vertex AI requires the role
 }
+/*
+ * If additional attributes are added here, they should also be
+ * added to the attributes below
+ */
 interface GeminiTool {
   functionDeclarations?: GeminiFunctionDeclaration[];
-  googleSearchRetrieval?: GoogleSearchRetrieval;
-  googleSearch?: GoogleSearch;
+  googleSearchRetrieval?: GoogleSearchRetrieval; // Gemini-1.5
+  googleSearch?: GoogleSearch; // Gemini-2.0
   urlContext?: UrlContext;
   retrieval?: VertexAIRetrieval;
 }
+/*
+ * The known strings in this type should match those in GeminiSearchToolAttribuets
+ */
 type GoogleSearchToolSetting = boolean | "googleSearchRetrieval" | "googleSearch" | string;
 declare const GeminiSearchToolAttributes: string[];
 declare const GeminiToolAttributes: string[];
@@ -653,6 +665,7 @@ interface GoogleAIAPIParams {
   apiName?: string;
   apiConfig?: GoogleAIAPIConfig;
 }
+// Embeddings
 /**
  * Defines the parameters required to initialize a
  * GoogleEmbeddings instance. It extends EmbeddingsParams and
@@ -697,7 +710,7 @@ interface AIStudioEmbeddingsRequest {
   content: {
     parts: GeminiPartText[];
   };
-  model?: string;
+  model?: string; // Documentation says required, but tests say otherwise
   taskType?: GoogleEmbeddingsTaskType;
   title?: string;
   outputDimensionality?: number;

package/dist/types.d.ts

@@ -90,7 +90,7 @@ type GoogleAISafetyMethod = (typeof GoogleAISafetyMethod)[keyof typeof GoogleAIS
 interface GoogleAISafetySetting {
   category: GoogleAISafetyCategory | string;
   threshold: GoogleAISafetyThreshold | string;
-  method?: GoogleAISafetyMethod | string;
+  method?: GoogleAISafetyMethod | string; // Just for Vertex AI?
 }
 type GoogleAIResponseMimeType = "text/plain" | "application/json";
 type GoogleAIModelModality = "TEXT" | "IMAGE" | "AUDIO" | string;
@@ -308,6 +308,7 @@ interface GoogleAIModelRequestParams extends GoogleAIModelParams {
    *
    * The tool configuration's "any" mode ("forced function calling") is supported for Gemini 1.5 Pro models only.
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   tool_choice?: string | "auto" | "any" | "none" | Record<string, any>;
   /**
    * Allowed functions to call when the mode is "any".
@@ -339,17 +340,18 @@ interface GoogleAIBaseLanguageModelCallOptions extends BaseChatModelCallOptions,
  */
 interface GoogleBaseLLMInput<AuthOptions> extends GoogleAIBaseLLMInput<AuthOptions> {}
 interface GoogleResponse {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   data: any;
 }
 interface GoogleRawResponse extends GoogleResponse {
   data: Blob;
 }
 interface GeminiPartBase {
-  thought?: boolean;
+  thought?: boolean; // Output only
   thoughtSignature?: string;
 }
 interface GeminiVideoMetadata {
-  fps?: number;
+  fps?: number; // Double in range (0.0, 24.0]
   startOffset?: string;
   endOffset?: string;
 }
@@ -371,12 +373,14 @@ interface GeminiPartFileData extends GeminiPartBaseFile {
     fileUri: string;
   };
 }
+// AI Studio only?
 interface GeminiPartFunctionCall extends GeminiPartBase {
   functionCall: {
     name: string;
     args?: object;
   };
 }
+// AI Studio Only?
 interface GeminiPartFunctionResponse extends GeminiPartBase {
   functionResponse: {
     name: string;
@@ -404,9 +408,9 @@ interface GeminiCitation {
   publicationDate: GoogleTypeDate;
 }
 interface GoogleTypeDate {
-  year: number;
-  month: number;
-  day: number;
+  year: number; // 1-9999 or 0 to specify a date without a year
+  month: number; // 1-12 or 0 to specify a year without a month and day
+  day: number; // Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant
 }
 interface GeminiGroundingMetadata {
   webSearchQueries?: string[];
@@ -417,7 +421,7 @@ interface GeminiGroundingMetadata {
 }
 interface GeminiSearchEntryPoint {
   renderedContent?: string;
-  sdkBlob?: string;
+  sdkBlob?: string; // Base64 encoded JSON representing array of tuple.
 }
 interface GeminiGroundingChunk {
   web: GeminiGroundingChunkWeb;
@@ -470,18 +474,26 @@ interface GeminiLogprobsResultCandidate {
   tokenId: number;
   logProbability: number;
 }
+// The "system" content appears to only be valid in the systemInstruction
 type GeminiRole = "system" | "user" | "model" | "function";
 interface GeminiContent {
   parts: GeminiPart[];
-  role: GeminiRole;
+  role: GeminiRole; // Vertex AI requires the role
 }
+/*
+ * If additional attributes are added here, they should also be
+ * added to the attributes below
+ */
 interface GeminiTool {
   functionDeclarations?: GeminiFunctionDeclaration[];
-  googleSearchRetrieval?: GoogleSearchRetrieval;
-  googleSearch?: GoogleSearch;
+  googleSearchRetrieval?: GoogleSearchRetrieval; // Gemini-1.5
+  googleSearch?: GoogleSearch; // Gemini-2.0
   urlContext?: UrlContext;
   retrieval?: VertexAIRetrieval;
 }
+/*
+ * The known strings in this type should match those in GeminiSearchToolAttribuets
+ */
 type GoogleSearchToolSetting = boolean | "googleSearchRetrieval" | "googleSearch" | string;
 declare const GeminiSearchToolAttributes: string[];
 declare const GeminiToolAttributes: string[];
@@ -653,6 +665,7 @@ interface GoogleAIAPIParams {
   apiName?: string;
   apiConfig?: GoogleAIAPIConfig;
 }
+// Embeddings
 /**
  * Defines the parameters required to initialize a
  * GoogleEmbeddings instance. It extends EmbeddingsParams and
@@ -697,7 +710,7 @@ interface AIStudioEmbeddingsRequest {
   content: {
     parts: GeminiPartText[];
   };
-  model?: string;
+  model?: string; // Documentation says required, but tests say otherwise
   taskType?: GoogleEmbeddingsTaskType;
   title?: string;
   outputDimensionality?: number;

package/dist/utils/failed_handler.d.cts

@@ -1,6 +1,7 @@
 import { AsyncCallerParams } from "@langchain/core/utils/async_caller";
 
 //#region src/utils/failed_handler.d.ts
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 declare function failedAttemptHandler(error: any): void;
 declare function ensureParams(params?: AsyncCallerParams): AsyncCallerParams;
 //#endregion

package/dist/utils/failed_handler.d.ts

@@ -1,6 +1,7 @@
 import { AsyncCallerParams } from "@langchain/core/utils/async_caller";
 
 //#region src/utils/failed_handler.d.ts
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 declare function failedAttemptHandler(error: any): void;
 declare function ensureParams(params?: AsyncCallerParams): AsyncCallerParams;
 //#endregion

package/dist/utils/palm.d.cts

@@ -1,5 +1,6 @@
 //#region src/utils/palm.d.ts
 interface GoogleVertexAIBasePrediction {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   safetyAttributes?: any;
 }
 interface GoogleVertexAILLMPredictions<PredictionType extends GoogleVertexAIBasePrediction> {

package/dist/utils/palm.d.ts

@@ -1,5 +1,6 @@
 //#region src/utils/palm.d.ts
 interface GoogleVertexAIBasePrediction {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   safetyAttributes?: any;
 }
 interface GoogleVertexAILLMPredictions<PredictionType extends GoogleVertexAIBasePrediction> {

package/dist/utils/safety.d.cts

@@ -3,6 +3,7 @@ import { GoogleLLMResponse } from "../types.cjs";
 //#region src/utils/safety.d.ts
 declare class GoogleAISafetyError extends Error {
   response: GoogleLLMResponse;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   reply: any;
   constructor(response: GoogleLLMResponse, message?: string);
 }

package/dist/utils/safety.d.ts

@@ -3,6 +3,7 @@ import { GoogleLLMResponse } from "../types.js";
 //#region src/utils/safety.d.ts
 declare class GoogleAISafetyError extends Error {
   response: GoogleLLMResponse;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   reply: any;
   constructor(response: GoogleLLMResponse, message?: string);
 }

package/dist/utils/stream.d.cts

@@ -14,6 +14,7 @@ interface AbstractStream {
    * Get the next chunk that is coming from the stream.
    * This chunk may be null, usually indicating the last chunk in the stream.
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   /**
    * Is the stream done?
@@ -62,8 +63,14 @@ declare class JsonStream implements AbstractStream {
    */
   _getFullObject(): object | null;
   _simplifyObject(obj: unknown): object;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkQueue: any[];
   /**
    * Register that we have another chunk available for consumption.
@@ -71,11 +78,13 @@ declare class JsonStream implements AbstractStream {
    * If not, then add it to the queue.
    * @param chunk
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _handleChunk(chunk: any): void;
   /**
    * Get the next chunk that is coming from the stream.
    * This chunk may be null, usually indicating the last chunk in the stream.
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   /**
    * Is the stream done?
@@ -95,8 +104,12 @@ declare class ReadableAbstractStream implements AbstractStream {
   constructor(baseStream: AbstractStream, body: ReadableStream | null);
   appendBuffer(data: string): void;
   closeBuffer(): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   get streamDone(): boolean;
+  // Should be a ReadableStream, but the Gaxios Readable stream isn't.
+  // But both should support async iterators, so make sure of that.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   run(body: any): Promise<void>;
 }
 declare class ReadableJsonStream extends ReadableAbstractStream {
@@ -121,10 +134,17 @@ declare class SseStream implements AbstractStream {
    * @param event
    */
   _parseEvent(event: string | null): Record<string, string> | null;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkQueue: any[];
   _handleEvent(event: string | null): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   get streamDone(): boolean;
 }
@@ -134,6 +154,7 @@ declare class ReadableSseStream extends ReadableAbstractStream {
 declare class SseJsonStream extends SseStream {
   _jsonAttribute: string;
   constructor(jsonAttribute?: string);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
 }
 declare class ReadableSseJsonStream extends ReadableAbstractStream {

package/dist/utils/stream.d.ts

@@ -14,6 +14,7 @@ interface AbstractStream {
    * Get the next chunk that is coming from the stream.
    * This chunk may be null, usually indicating the last chunk in the stream.
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   /**
    * Is the stream done?
@@ -62,8 +63,14 @@ declare class JsonStream implements AbstractStream {
    */
   _getFullObject(): object | null;
   _simplifyObject(obj: unknown): object;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkQueue: any[];
   /**
    * Register that we have another chunk available for consumption.
@@ -71,11 +78,13 @@ declare class JsonStream implements AbstractStream {
    * If not, then add it to the queue.
    * @param chunk
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _handleChunk(chunk: any): void;
   /**
    * Get the next chunk that is coming from the stream.
    * This chunk may be null, usually indicating the last chunk in the stream.
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   /**
    * Is the stream done?
@@ -95,8 +104,12 @@ declare class ReadableAbstractStream implements AbstractStream {
   constructor(baseStream: AbstractStream, body: ReadableStream | null);
   appendBuffer(data: string): void;
   closeBuffer(): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   get streamDone(): boolean;
+  // Should be a ReadableStream, but the Gaxios Readable stream isn't.
+  // But both should support async iterators, so make sure of that.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   run(body: any): Promise<void>;
 }
 declare class ReadableJsonStream extends ReadableAbstractStream {
@@ -121,10 +134,17 @@ declare class SseStream implements AbstractStream {
    * @param event
    */
   _parseEvent(event: string | null): Record<string, string> | null;
+  // Set up a potential Promise that the handler can resolve.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkResolution: (chunk: any) => void;
+  // If there is no Promise (it is null), the handler must add it to the queue
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkPending: Promise<any> | null;
+  // A queue that will collect chunks while there is no Promise
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   _chunkQueue: any[];
   _handleEvent(event: string | null): void;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
   get streamDone(): boolean;
 }
@@ -134,6 +154,7 @@ declare class ReadableSseStream extends ReadableAbstractStream {
 declare class SseJsonStream extends SseStream {
   _jsonAttribute: string;
   constructor(jsonAttribute?: string);
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   nextChunk(): Promise<any>;
 }
 declare class ReadableSseJsonStream extends ReadableAbstractStream {

package/dist/utils/zod_to_gemini_parameters.d.cts

@@ -3,10 +3,20 @@ import { InteropZodType } from "@langchain/core/utils/types";
 import { JsonSchema7Type } from "@langchain/core/utils/json_schema";
 
 //#region src/utils/zod_to_gemini_parameters.d.ts
-declare function adjustObjectType(obj: Record<string, any>): Record<string, any>;
-declare function removeAdditionalProperties(obj: Record<string, any>): GeminiJsonSchema;
-declare function schemaToGeminiParameters<RunOutput extends Record<string, any> = Record<string, any>>(schema: InteropZodType<RunOutput> | JsonSchema7Type): GeminiFunctionSchema;
-declare function jsonSchemaToGeminiParameters(schema: Record<string, any>): GeminiFunctionSchema;
+declare function adjustObjectType(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+obj: Record<string, any>
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+): Record<string, any>;
+declare function removeAdditionalProperties(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+obj: Record<string, any>): GeminiJsonSchema;
+declare function schemaToGeminiParameters<
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+RunOutput extends Record<string, any> = Record<string, any>>(schema: InteropZodType<RunOutput> | JsonSchema7Type): GeminiFunctionSchema;
+declare function jsonSchemaToGeminiParameters(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema: Record<string, any>): GeminiFunctionSchema;
 //#endregion
 export { adjustObjectType, jsonSchemaToGeminiParameters, removeAdditionalProperties, schemaToGeminiParameters };
 //# sourceMappingURL=zod_to_gemini_parameters.d.cts.map

package/dist/utils/zod_to_gemini_parameters.d.ts

@@ -3,10 +3,20 @@ import { InteropZodType } from "@langchain/core/utils/types";
 import { JsonSchema7Type } from "@langchain/core/utils/json_schema";
 
 //#region src/utils/zod_to_gemini_parameters.d.ts
-declare function adjustObjectType(obj: Record<string, any>): Record<string, any>;
-declare function removeAdditionalProperties(obj: Record<string, any>): GeminiJsonSchema;
-declare function schemaToGeminiParameters<RunOutput extends Record<string, any> = Record<string, any>>(schema: InteropZodType<RunOutput> | JsonSchema7Type): GeminiFunctionSchema;
-declare function jsonSchemaToGeminiParameters(schema: Record<string, any>): GeminiFunctionSchema;
+declare function adjustObjectType(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+obj: Record<string, any>
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+): Record<string, any>;
+declare function removeAdditionalProperties(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+obj: Record<string, any>): GeminiJsonSchema;
+declare function schemaToGeminiParameters<
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+RunOutput extends Record<string, any> = Record<string, any>>(schema: InteropZodType<RunOutput> | JsonSchema7Type): GeminiFunctionSchema;
+declare function jsonSchemaToGeminiParameters(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+schema: Record<string, any>): GeminiFunctionSchema;
 //#endregion
 export { adjustObjectType, jsonSchemaToGeminiParameters, removeAdditionalProperties, schemaToGeminiParameters };
 //# sourceMappingURL=zod_to_gemini_parameters.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/google-common",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Core types and classes for Google services.",
   "type": "module",
   "engines": {
@@ -17,7 +17,7 @@
     "uuid": "^10.0.0"
   },
   "peerDependencies": {
-    "@langchain/core": "1.1.3"
+    "@langchain/core": "1.1.4"
   },
   "devDependencies": {
     "@jest/globals": "^29.5.0",
@@ -35,7 +35,7 @@
     "ts-jest": "^29.1.0",
     "typescript": "~5.8.3",
     "zod": "^3.25.76",
-    "@langchain/core": "1.1.3",
+    "@langchain/core": "1.1.4",
     "@langchain/eslint": "0.1.1"
   },
   "publishConfig": {