@langchain/google 0.1.0

package/dist/utils/errors.js

@@ -0,0 +1,535 @@
+import { iife } from "./misc.js";
+
+//#region src/utils/errors.ts
+function GoogleError(marker) {
+	const symbol = Symbol.for(`langchain.google.error.${marker}`);
+	return class extends Error {
+		[symbol] = true;
+		constructor(message) {
+			super(message);
+			if (Error.captureStackTrace) Error.captureStackTrace(this, this.constructor);
+		}
+		isInstance(obj) {
+			return typeof obj === "object" && obj !== null && symbol in obj && obj[symbol] === true;
+		}
+	};
+}
+/**
+* Error thrown when there is a configuration issue with the Google provider.
+*
+* This error is thrown when the Google provider encounters invalid configuration
+* parameters or settings that prevent it from functioning correctly.
+*
+* @example
+* ```typescript
+* try {
+*   const model = new ChatGoogle({ invalidOption: true });
+* } catch (error) {
+*   if (ConfigurationError.isInstance(error)) {
+*     console.log(`Configuration error: ${error.message}`);
+*   }
+* }
+* ```
+*/
+var ConfigurationError = class extends GoogleError("configuration") {
+	name = "ConfigurationError";
+};
+/**
+* Error thrown when a prompt is blocked by Google's safety filters.
+*
+* This error is thrown when the Gemini API blocks a prompt due to safety concerns.
+* It contains information about why the prompt was blocked and the safety ratings
+* that triggered the block.
+*
+* @example
+* ```typescript
+* try {
+*   await model.invoke("some potentially unsafe prompt");
+* } catch (error) {
+*   if (PromptBlockedError.isInstance(error)) {
+*     console.log(`Blocked due to: ${error.blockReason}`);
+*     console.log(`Safety ratings:`, error.safetyRatings);
+*   }
+* }
+* ```
+*/
+var PromptBlockedError = class PromptBlockedError extends GoogleError("prompt-blocked") {
+	/**
+	* The name of the error class.
+	* @readonly
+	*/
+	name = "PromptBlockedError";
+	/**
+	* The reason why the prompt was blocked.
+	*
+	* Common values include:
+	* - "SAFETY" - Blocked due to safety concerns
+	* - "OTHER" - Blocked for other reasons
+	* - "UNKNOWN" - Reason is unknown
+	*
+	* @readonly
+	*/
+	blockReason;
+	/**
+	* Optional array of safety ratings that contributed to the block decision.
+	*
+	* Each rating contains information about different safety categories
+	* (e.g., hate speech, sexually explicit content, dangerous content)
+	* and their probability levels.
+	*
+	* @readonly
+	*/
+	safetyRatings;
+	constructor(params) {
+		const message = params.message ?? `Prompt was blocked: ${params.blockReason}.${params.safetyRatings && params.safetyRatings.length > 0 ? ` Safety ratings: ${JSON.stringify(params.safetyRatings)}` : ""}`;
+		super(message);
+		this.blockReason = params.blockReason;
+		this.safetyRatings = params.safetyRatings;
+	}
+	/**
+	* Creates a PromptBlockedError from a Gemini API prompt feedback object.
+	*
+	* This is a convenience factory method for creating errors from the API response
+	* when a prompt is blocked. It extracts the relevant information from the
+	* promptFeedback object returned by the Gemini API.
+	*
+	* @param promptFeedback - The prompt feedback object from the Gemini API response
+	* @returns A new PromptBlockedError instance with information from the feedback
+	*
+	* @example
+	* ```typescript
+	* const response = await geminiApi.generateContent(request);
+	* if (response.promptFeedback?.blockReason) {
+	*   throw PromptBlockedError.fromPromptFeedback(response.promptFeedback);
+	* }
+	* ```
+	*/
+	static fromPromptFeedback(promptFeedback) {
+		return new PromptBlockedError({
+			blockReason: promptFeedback.blockReason ?? "UNKNOWN",
+			safetyRatings: promptFeedback.safetyRatings
+		});
+	}
+};
+/**
+* Error class for authentication failures when communicating with Google APIs.
+*
+* This error is thrown when authentication with a Google API fails, typically
+* during the OAuth token exchange process or when using service account credentials.
+* It captures detailed information about the failed authentication attempt including
+* the status code, headers, and response body to aid in debugging and error handling.
+*
+* Common authentication failure scenarios include:
+* - Invalid or expired credentials
+* - Incorrect service account configuration
+* - Missing or invalid API keys
+* - Insufficient permissions or scopes
+* - Token exchange failures
+*
+* @example
+* ```typescript
+* try {
+*   const token = await getAccessToken(credentials);
+* } catch (error) {
+*   if (AuthError.isInstance(error)) {
+*     console.error(`Auth failed with status ${error.statusCode}: ${error.message}`);
+*     console.error('Response data:', error.data);
+*   }
+* }
+* ```
+*/
+var AuthError = class AuthError extends GoogleError("auth") {
+	name = "AuthError";
+	/**
+	* The HTTP status code of the failed response.
+	* Common values include 400 (Bad Request), 401 (Unauthorized),
+	* 403 (Forbidden), 404 (Not Found), 429 (Too Many Requests),
+	* 500 (Internal Server Error), etc.
+	*/
+	statusCode;
+	/**
+	* The HTTP status text of the failed response.
+	* This is the human-readable status message that accompanies the status code
+	* (e.g., "Bad Request", "Internal Server Error").
+	*/
+	statusText;
+	/**
+	* The HTTP response headers from the failed request.
+	* Stored as a key-value record for easy access to header information.
+	*/
+	headers;
+	/**
+	* The response body data from the failed request.
+	* This may be a parsed JSON object, a text string, or null if the body
+	* could not be read. Often contains additional error details from the API.
+	*/
+	data;
+	constructor(params) {
+		super(params.message);
+		this.statusCode = params.statusCode;
+		this.statusText = params.statusText;
+		this.headers = params.headers;
+		this.data = params.data;
+	}
+	/**
+	* Creates an AuthError from a failed HTTP response.
+	*
+	* This is a convenience factory method for creating authentication errors from
+	* HTTP responses. It automatically extracts the error message, status code,
+	* headers, and response body from the Response object.
+	*
+	* The method attempts to parse the response body as JSON to extract an
+	* `error_description` field if available. If JSON parsing fails or the
+	* content type is not JSON, it falls back to reading the response as text.
+	* If both fail, the error body will be null.
+	*
+	* @param response - The failed HTTP Response object from the authentication request
+	* @returns A Promise that resolves to a new AuthError instance with information from the response
+	*
+	* @example
+	* ```typescript
+	* const response = await fetch(tokenUrl, {
+	*   method: 'POST',
+	*   body: authRequestBody
+	* });
+	*
+	* if (!response.ok) {
+	*   throw await AuthError.fromResponse(response);
+	* }
+	* ```
+	*/
+	static async fromResponse(response) {
+		const errorBody = await iife(async () => {
+			try {
+				const contentType = response.headers.get("content-type") ?? "";
+				if (contentType.includes("application/json")) return await response.json();
+				return await response.text();
+			} catch {
+				return null;
+			}
+		});
+		const message = errorBody?.error_description ?? `Authentication failed with status code ${response.status}`;
+		const headers = iife(() => {
+			const object = {};
+			response.headers.forEach((value, name) => {
+				object[name] = value;
+			});
+			return object;
+		});
+		return new AuthError({
+			message,
+			statusCode: response.status,
+			statusText: response.statusText,
+			headers,
+			data: errorBody
+		});
+	}
+};
+const RETRYABLE_STATUS_CODES = [
+	408,
+	429,
+	500,
+	502,
+	503,
+	504
+];
+/**
+* Error class for HTTP request failures when communicating with Google APIs.
+*
+* This error is thrown when an HTTP request to a Google API endpoint fails.
+* It captures detailed information about the failed request including the URL,
+* status code, headers, and response body to aid in debugging and error handling.
+*
+* The error includes a `isRetryable()` method to determine if the request should
+* be retried based on the HTTP status code (e.g., 429 Too Many Requests, 503 Service Unavailable).
+*
+* @example
+* ```typescript
+* try {
+*   const response = await apiClient.fetch(request);
+*   if (!response.ok) {
+*     throw await RequestError.fromResponse(response);
+*   }
+* } catch (error) {
+*   if (RequestError.isInstance(error) && error.isRetryable()) {
+*     // Retry the request
+*   }
+* }
+* ```
+*/
+var RequestError = class RequestError extends GoogleError("request") {
+	name = "RequestError";
+	/**
+	* The URL of the failed request.
+	* This is the full URL that was being accessed when the error occurred.
+	*/
+	url;
+	/**
+	* The HTTP status code of the failed response.
+	* Common values include 400 (Bad Request), 401 (Unauthorized),
+	* 403 (Forbidden), 404 (Not Found), 429 (Too Many Requests),
+	* 500 (Internal Server Error), etc.
+	*/
+	statusCode;
+	/**
+	* The HTTP status text of the failed response.
+	* This is the human-readable status message that accompanies the status code
+	* (e.g., "Bad Request", "Internal Server Error").
+	*/
+	statusText;
+	/**
+	* The HTTP response headers from the failed request.
+	* Stored as a key-value record for easy access to header information.
+	*/
+	headers;
+	/**
+	* The response body data from the failed request.
+	* This may be a parsed JSON object, a text string, or null if the body
+	* could not be read. Often contains additional error details from the API.
+	*/
+	data;
+	constructor(params) {
+		super(params.message);
+		this.url = params.url;
+		this.statusCode = params.statusCode;
+		this.statusText = params.statusText;
+		this.headers = params.headers;
+		this.data = params.data;
+	}
+	/**
+	* Determines if this error represents a retryable request failure.
+	*
+	* A request is considered retryable if it failed with a status code that
+	* indicates a temporary issue that might succeed on retry. This includes:
+	* - 408 (Request Timeout)
+	* - 429 (Too Many Requests / Rate Limiting)
+	* - 500 (Internal Server Error)
+	* - 502 (Bad Gateway)
+	* - 503 (Service Unavailable)
+	* - 504 (Gateway Timeout)
+	*
+	* @returns `true` if the request should be retried, `false` otherwise
+	*
+	* @example
+	* ```typescript
+	* if (RequestError.isInstance(error) && error.isRetryable()) {
+	*   await sleep(1000);
+	*   return retry(request);
+	* }
+	* ```
+	*/
+	isRetryable() {
+		if (!this.statusCode) return false;
+		return RETRYABLE_STATUS_CODES.includes(this.statusCode);
+	}
+	/**
+	* Creates a RequestError from a failed HTTP Response object.
+	*
+	* This is a factory method that extracts all relevant information from a
+	* Response object and constructs a RequestError with appropriate details.
+	* It attempts to parse the response body as JSON first, falling back to
+	* text if that fails, and finally to null if the body cannot be read.
+	*
+	* The error message is extracted from the response body if available
+	* (looking for `message` or `error` fields), otherwise a generic message
+	* is constructed using the status code.
+	*
+	* @param response - The failed HTTP Response object to convert into an error
+	* @returns A Promise that resolves to a new RequestError instance
+	*
+	* @example
+	* ```typescript
+	* const response = await fetch(url);
+	* if (!response.ok) {
+	*   throw await RequestError.fromResponse(response);
+	* }
+	* ```
+	*/
+	static async fromResponse(response) {
+		const errorBody = await iife(async () => {
+			try {
+				const contentType = response.headers.get("content-type") ?? "";
+				if (contentType.includes("application/json")) return await response.json();
+				return await response.text();
+			} catch {
+				return null;
+			}
+		});
+		const message = errorBody?.error?.message ?? errorBody?.message ?? errorBody?.error ?? `Request failed with status code ${response.status}`;
+		const headers = iife(() => {
+			const object = {};
+			response.headers.forEach((value, name) => {
+				object[name] = value;
+			});
+			return object;
+		});
+		return new RequestError({
+			message,
+			url: response.url,
+			statusCode: response.status,
+			statusText: response.statusText,
+			headers,
+			data: errorBody
+		});
+	}
+};
+/**
+* Error thrown when the Gemini API returns no candidates in the response.
+*
+* This error is thrown when the API successfully processes a request but returns
+* an empty candidates array. This can occur when:
+* - The prompt was blocked by safety filters (but no explicit block reason was provided)
+* - An internal error occurred during generation
+* - The model was unable to generate a valid response
+*
+* @example
+* ```typescript
+* try {
+*   await model.invoke("some prompt");
+* } catch (error) {
+*   if (NoCandidatesError.isInstance(error)) {
+*     console.log("No response candidates were generated");
+*   }
+* }
+* ```
+*/
+var NoCandidatesError = class extends GoogleError("no-candidates") {
+	name = "NoCandidatesError";
+	constructor() {
+		super("No candidates returned from API. This may indicate the prompt was blocked or an error occurred.");
+	}
+};
+/**
+* Error thrown when an invalid tool is provided to the tool converter.
+*
+* This error is thrown when a tool cannot be converted to Gemini's function
+* declaration format. Tools must be one of:
+* - LangChain structured tools (with Zod schemas)
+* - OpenAI format tools (with JSON Schema)
+* - Gemini-native function declarations
+* - Gemini-native tools (codeExecution, googleSearchRetrieval)
+*
+* @example
+* ```typescript
+* try {
+*   convertToolsToGeminiFunctionDeclarations([invalidTool]);
+* } catch (error) {
+*   if (InvalidToolError.isInstance(error)) {
+*     console.log(`Invalid tool: ${error.tool}`);
+*     console.log(`Expected formats: LangChain tools, OpenAI tools, or Gemini function declarations`);
+*   }
+* }
+* ```
+*/
+var InvalidToolError = class extends GoogleError("invalid-tool") {
+	name = "InvalidToolError";
+	/**
+	* The invalid tool that was provided.
+	*/
+	tool;
+	constructor(tool, message) {
+		const defaultMessage = `Received invalid tool: ${JSON.stringify(tool)}. Tools must be LangChain tools, OpenAI tools, or Gemini function declarations.`;
+		super(message ?? defaultMessage);
+		this.tool = tool;
+	}
+};
+/**
+* Error thrown when a ToolMessage references a tool call that cannot be found.
+*
+* This error is thrown when a ToolMessage is passed to ChatGoogle but there is no
+* corresponding AIMessage with a matching toolCallId in the conversation history.
+* This typically indicates that:
+* - The tool call ID in the ToolMessage doesn't match any previous tool calls
+* - The AIMessage containing the tool call was not included in the message history
+* - The tool call ID was incorrectly set or modified
+*
+* @example
+* ```typescript
+* try {
+*   await model.invoke([
+*     new ToolMessage({ content: "result", tool_call_id: "nonexistent-id" })
+*   ]);
+* } catch (error) {
+*   if (ToolCallNotFoundError.isInstance(error)) {
+*     console.log(`Tool call not found: ${error.toolCallId}`);
+*   }
+* }
+* ```
+*/
+var ToolCallNotFoundError = class extends GoogleError("tool-call-not-found") {
+	name = "ToolCallNotFoundError";
+	/**
+	* The tool call ID that could not be found in the conversation history.
+	*/
+	toolCallId;
+	constructor(toolCallId, message) {
+		const defaultMessage = `Tool call with ID "${toolCallId}" not found in conversation history. Ensure the corresponding AIMessage with this tool call ID is included in the input.`;
+		super(message ?? defaultMessage);
+		this.toolCallId = toolCallId;
+	}
+};
+/**
+* Error thrown when output parsing fails in structured output methods.
+*
+* This error is thrown when the model's response cannot be parsed according to
+* the expected schema or format. Common causes include:
+* - Invalid message type (not an AIMessage or AIMessageChunk)
+* - Missing or empty content in the response
+* - Malformed JSON that cannot be parsed
+* - Schema validation failures
+*
+* @example
+* ```typescript
+* try {
+*   const result = await model.withStructuredOutput(schema).invoke("extract data");
+* } catch (error) {
+*   if (MalformedOutputError.isInstance(error)) {
+*     console.log(`Failed to parse output: ${error.message}`);
+*     if (error.cause) {
+*       console.log(`Cause:`, error.cause);
+*     }
+*   }
+* }
+* ```
+*/
+var MalformedOutputError = class extends GoogleError("malformed-output") {
+	name = "MalformedOutputError";
+	/**
+	* Optional cause of the parsing error.
+	* This may be the original error that occurred during parsing,
+	* or additional context about what went wrong.
+	*/
+	cause;
+	constructor(params) {
+		super(params.message);
+		this.cause = params.cause;
+	}
+};
+/**
+* Error thrown when input provided to the Google provider is invalid.
+*
+* This error is thrown when the user provides input that cannot be
+* processed by Gemini, such as:
+* - Union types in tool/function schemas
+* - Null-only types in schemas
+* - Unsupported content block source types
+* - Missing required fields in content blocks
+*
+* @example
+* ```typescript
+* try {
+*   const result = schemaToGeminiParameters(unionTypeSchema);
+* } catch (error) {
+*   if (InvalidInputError.isInstance(error)) {
+*     console.log(`Invalid input: ${error.message}`);
+*   }
+* }
+* ```
+*/
+var InvalidInputError = class extends GoogleError("invalid-input") {
+	name = "InvalidInputError";
+};
+
+//#endregion
+export { AuthError, ConfigurationError, InvalidInputError, InvalidToolError, MalformedOutputError, NoCandidatesError, PromptBlockedError, RequestError, ToolCallNotFoundError };
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":["marker: TMarker","symbol: symbol","message: string","obj: unknown","params: PromptBlockedErrorParams","promptFeedback: Gemini.PromptFeedback","params: AuthErrorParams","response: Response","object: Record<string, string>","params: RequestErrorParams","tool: unknown","message?: string","toolCallId: string","params: MalformedOutputErrorParams"],"sources":["../../src/utils/errors.ts"],"sourcesContent":["import type { Gemini } from \"../chat_models/types.js\";\nimport { iife } from \"./misc.js\";\n\nfunction GoogleError<TMarker extends string>(marker: TMarker) {\n  const symbol: symbol = Symbol.for(`langchain.google.error.${marker}`);\n\n  return class extends Error {\n    readonly [symbol] = true as const;\n\n    constructor(message: string) {\n      super(message);\n      if (Error.captureStackTrace) {\n        Error.captureStackTrace(this, this.constructor);\n      }\n    }\n\n    isInstance(obj: unknown): obj is this {\n      return (\n        typeof obj === \"object\" &&\n        obj !== null &&\n        symbol in obj &&\n        obj[symbol as keyof typeof obj] === true\n      );\n    }\n  };\n}\n\n/**\n * Error thrown when there is a configuration issue with the Google provider.\n *\n * This error is thrown when the Google provider encounters invalid configuration\n * parameters or settings that prevent it from functioning correctly.\n *\n * @example\n * ```typescript\n * try {\n *   const model = new ChatGoogle({ invalidOption: true });\n * } catch (error) {\n *   if (ConfigurationError.isInstance(error)) {\n *     console.log(`Configuration error: ${error.message}`);\n *   }\n * }\n * ```\n */\nexport class ConfigurationError extends GoogleError(\"configuration\") {\n  readonly name = \"ConfigurationError\" as const;\n}\n\n/**\n * Parameters for constructing a PromptBlockedError\n */\ntype PromptBlockedErrorParams = {\n  /**\n   * The reason why the prompt was blocked (e.g., \"SAFETY\", \"OTHER\", \"UNKNOWN\")\n   */\n  blockReason: string;\n  /**\n   * Optional array of safety ratings that contributed to the block decision\n   */\n  safetyRatings?: Gemini.SafetyRating[];\n  /**\n   * Optional custom error message. If not provided, a default message will be generated\n   */\n  message?: string;\n};\n\n/**\n * Error thrown when a prompt is blocked by Google's safety filters.\n *\n * This error is thrown when the Gemini API blocks a prompt due to safety concerns.\n * It contains information about why the prompt was blocked and the safety ratings\n * that triggered the block.\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(\"some potentially unsafe prompt\");\n * } catch (error) {\n *   if (PromptBlockedError.isInstance(error)) {\n *     console.log(`Blocked due to: ${error.blockReason}`);\n *     console.log(`Safety ratings:`, error.safetyRatings);\n *   }\n * }\n * ```\n */\nexport class PromptBlockedError extends GoogleError(\"prompt-blocked\") {\n  /**\n   * The name of the error class.\n   * @readonly\n   */\n  readonly name = \"PromptBlockedError\" as const;\n\n  /**\n   * The reason why the prompt was blocked.\n   *\n   * Common values include:\n   * - \"SAFETY\" - Blocked due to safety concerns\n   * - \"OTHER\" - Blocked for other reasons\n   * - \"UNKNOWN\" - Reason is unknown\n   *\n   * @readonly\n   */\n  readonly blockReason: string;\n\n  /**\n   * Optional array of safety ratings that contributed to the block decision.\n   *\n   * Each rating contains information about different safety categories\n   * (e.g., hate speech, sexually explicit content, dangerous content)\n   * and their probability levels.\n   *\n   * @readonly\n   */\n  readonly safetyRatings?: Gemini.SafetyRating[];\n\n  constructor(params: PromptBlockedErrorParams) {\n    const message =\n      params.message ??\n      `Prompt was blocked: ${params.blockReason}.${\n        params.safetyRatings && params.safetyRatings.length > 0\n          ? ` Safety ratings: ${JSON.stringify(params.safetyRatings)}`\n          : \"\"\n      }`;\n\n    super(message);\n    this.blockReason = params.blockReason;\n    this.safetyRatings = params.safetyRatings;\n  }\n\n  /**\n   * Creates a PromptBlockedError from a Gemini API prompt feedback object.\n   *\n   * This is a convenience factory method for creating errors from the API response\n   * when a prompt is blocked. It extracts the relevant information from the\n   * promptFeedback object returned by the Gemini API.\n   *\n   * @param promptFeedback - The prompt feedback object from the Gemini API response\n   * @returns A new PromptBlockedError instance with information from the feedback\n   *\n   * @example\n   * ```typescript\n   * const response = await geminiApi.generateContent(request);\n   * if (response.promptFeedback?.blockReason) {\n   *   throw PromptBlockedError.fromPromptFeedback(response.promptFeedback);\n   * }\n   * ```\n   */\n  static fromPromptFeedback(\n    promptFeedback: Gemini.PromptFeedback\n  ): PromptBlockedError {\n    return new PromptBlockedError({\n      blockReason: promptFeedback.blockReason ?? \"UNKNOWN\",\n      safetyRatings: promptFeedback.safetyRatings,\n    });\n  }\n}\n\n/**\n * Parameters for constructing an AuthError\n */\ntype AuthErrorParams = {\n  /**\n   * The error message describing what went wrong\n   */\n  message: string;\n\n  /**\n   * The HTTP status code of the failed response.\n   * Common values include 400 (Bad Request), 401 (Unauthorized),\n   * 403 (Forbidden), 404 (Not Found), 429 (Too Many Requests),\n   * 500 (Internal Server Error), etc.\n   */\n  statusCode?: number;\n\n  /**\n   * The HTTP status text of the failed response.\n   * This is the human-readable status message that accompanies the status code\n   * (e.g., \"Bad Request\", \"Internal Server Error\").\n   */\n  statusText?: string;\n\n  /**\n   * The HTTP response headers from the failed request.\n   * Stored as a key-value record for easy access to header information.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * The response body data from the failed request.\n   * This may be a parsed JSON object, a text string, or null if the body\n   * could not be read. Often contains additional error details from the API.\n   */\n  data?: unknown;\n};\n\n/**\n * Error class for authentication failures when communicating with Google APIs.\n *\n * This error is thrown when authentication with a Google API fails, typically\n * during the OAuth token exchange process or when using service account credentials.\n * It captures detailed information about the failed authentication attempt including\n * the status code, headers, and response body to aid in debugging and error handling.\n *\n * Common authentication failure scenarios include:\n * - Invalid or expired credentials\n * - Incorrect service account configuration\n * - Missing or invalid API keys\n * - Insufficient permissions or scopes\n * - Token exchange failures\n *\n * @example\n * ```typescript\n * try {\n *   const token = await getAccessToken(credentials);\n * } catch (error) {\n *   if (AuthError.isInstance(error)) {\n *     console.error(`Auth failed with status ${error.statusCode}: ${error.message}`);\n *     console.error('Response data:', error.data);\n *   }\n * }\n * ```\n */\nexport class AuthError extends GoogleError(\"auth\") {\n  readonly name = \"AuthError\" as const;\n\n  /**\n   * The HTTP status code of the failed response.\n   * Common values include 400 (Bad Request), 401 (Unauthorized),\n   * 403 (Forbidden), 404 (Not Found), 429 (Too Many Requests),\n   * 500 (Internal Server Error), etc.\n   */\n  readonly statusCode?: number;\n\n  /**\n   * The HTTP status text of the failed response.\n   * This is the human-readable status message that accompanies the status code\n   * (e.g., \"Bad Request\", \"Internal Server Error\").\n   */\n  readonly statusText?: string;\n\n  /**\n   * The HTTP response headers from the failed request.\n   * Stored as a key-value record for easy access to header information.\n   */\n  readonly headers?: Record<string, string>;\n\n  /**\n   * The response body data from the failed request.\n   * This may be a parsed JSON object, a text string, or null if the body\n   * could not be read. Often contains additional error details from the API.\n   */\n  readonly data?: unknown;\n\n  constructor(params: AuthErrorParams) {\n    super(params.message);\n\n    this.statusCode = params.statusCode;\n    this.statusText = params.statusText;\n    this.headers = params.headers;\n    this.data = params.data;\n  }\n\n  /**\n   * Creates an AuthError from a failed HTTP response.\n   *\n   * This is a convenience factory method for creating authentication errors from\n   * HTTP responses. It automatically extracts the error message, status code,\n   * headers, and response body from the Response object.\n   *\n   * The method attempts to parse the response body as JSON to extract an\n   * `error_description` field if available. If JSON parsing fails or the\n   * content type is not JSON, it falls back to reading the response as text.\n   * If both fail, the error body will be null.\n   *\n   * @param response - The failed HTTP Response object from the authentication request\n   * @returns A Promise that resolves to a new AuthError instance with information from the response\n   *\n   * @example\n   * ```typescript\n   * const response = await fetch(tokenUrl, {\n   *   method: 'POST',\n   *   body: authRequestBody\n   * });\n   *\n   * if (!response.ok) {\n   *   throw await AuthError.fromResponse(response);\n   * }\n   * ```\n   */\n  static async fromResponse(response: Response): Promise<AuthError> {\n    const errorBody = await iife(async () => {\n      try {\n        const contentType = response.headers.get(\"content-type\") ?? \"\";\n        if (contentType.includes(\"application/json\")) {\n          return await response.json();\n        }\n        return await response.text();\n      } catch {\n        return null;\n      }\n    });\n\n    const message =\n      errorBody?.error_description ??\n      `Authentication failed with status code ${response.status}`;\n\n    const headers = iife(() => {\n      const object: Record<string, string> = {};\n      response.headers.forEach((value, name) => {\n        object[name] = value;\n      });\n      return object;\n    });\n\n    return new AuthError({\n      message,\n      statusCode: response.status,\n      statusText: response.statusText,\n      headers,\n      data: errorBody,\n    });\n  }\n}\n\nconst RETRYABLE_STATUS_CODES = [\n  408, // Request Timeout\n  429, // Too Many Requests\n  500, // Internal Server Error\n  502, // Bad Gateway\n  503, // Service Unavailable\n  504, // Gateway Timeout\n];\n\n/**\n * Parameters for constructing a RequestError\n */\ntype RequestErrorParams = {\n  /**\n   * The error message describing what went wrong\n   */\n  message: string;\n\n  /**\n   * The URL of the failed request.\n   * This is the full URL that was being accessed when the error occurred.\n   */\n  url: string;\n\n  /**\n   * The HTTP status code of the failed response.\n   * Common values include 400 (Bad Request), 401 (Unauthorized),\n   * 403 (Forbidden), 404 (Not Found), 429 (Too Many Requests),\n   * 500 (Internal Server Error), etc.\n   */\n  statusCode?: number;\n\n  /**\n   * The HTTP status text of the failed response.\n   * This is the human-readable status message that accompanies the status code\n   * (e.g., \"Bad Request\", \"Internal Server Error\").\n   */\n  statusText?: string;\n\n  /**\n   * The HTTP response headers from the failed request.\n   * Stored as a key-value record for easy access to header information.\n   */\n  headers?: Record<string, string>;\n\n  /**\n   * The response body data from the failed request.\n   * This may be a parsed JSON object, a text string, or null if the body\n   * could not be read. Often contains additional error details from the API.\n   */\n  data?: unknown;\n};\n\n/**\n * Error class for HTTP request failures when communicating with Google APIs.\n *\n * This error is thrown when an HTTP request to a Google API endpoint fails.\n * It captures detailed information about the failed request including the URL,\n * status code, headers, and response body to aid in debugging and error handling.\n *\n * The error includes a `isRetryable()` method to determine if the request should\n * be retried based on the HTTP status code (e.g., 429 Too Many Requests, 503 Service Unavailable).\n *\n * @example\n * ```typescript\n * try {\n *   const response = await apiClient.fetch(request);\n *   if (!response.ok) {\n *     throw await RequestError.fromResponse(response);\n *   }\n * } catch (error) {\n *   if (RequestError.isInstance(error) && error.isRetryable()) {\n *     // Retry the request\n *   }\n * }\n * ```\n */\nexport class RequestError extends GoogleError(\"request\") {\n  readonly name = \"RequestError\" as const;\n\n  /**\n   * The URL of the failed request.\n   * This is the full URL that was being accessed when the error occurred.\n   */\n  readonly url: string;\n\n  /**\n   * The HTTP status code of the failed response.\n   * Common values include 400 (Bad Request), 401 (Unauthorized),\n   * 403 (Forbidden), 404 (Not Found), 429 (Too Many Requests),\n   * 500 (Internal Server Error), etc.\n   */\n  readonly statusCode?: number;\n\n  /**\n   * The HTTP status text of the failed response.\n   * This is the human-readable status message that accompanies the status code\n   * (e.g., \"Bad Request\", \"Internal Server Error\").\n   */\n  readonly statusText?: string;\n\n  /**\n   * The HTTP response headers from the failed request.\n   * Stored as a key-value record for easy access to header information.\n   */\n  readonly headers?: Record<string, string>;\n\n  /**\n   * The response body data from the failed request.\n   * This may be a parsed JSON object, a text string, or null if the body\n   * could not be read. Often contains additional error details from the API.\n   */\n  readonly data?: unknown;\n\n  constructor(params: RequestErrorParams) {\n    super(params.message);\n\n    this.url = params.url;\n    this.statusCode = params.statusCode;\n    this.statusText = params.statusText;\n    this.headers = params.headers;\n    this.data = params.data;\n  }\n\n  /**\n   * Determines if this error represents a retryable request failure.\n   *\n   * A request is considered retryable if it failed with a status code that\n   * indicates a temporary issue that might succeed on retry. This includes:\n   * - 408 (Request Timeout)\n   * - 429 (Too Many Requests / Rate Limiting)\n   * - 500 (Internal Server Error)\n   * - 502 (Bad Gateway)\n   * - 503 (Service Unavailable)\n   * - 504 (Gateway Timeout)\n   *\n   * @returns `true` if the request should be retried, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (RequestError.isInstance(error) && error.isRetryable()) {\n   *   await sleep(1000);\n   *   return retry(request);\n   * }\n   * ```\n   */\n  isRetryable(): boolean {\n    if (!this.statusCode) return false;\n    return RETRYABLE_STATUS_CODES.includes(this.statusCode);\n  }\n\n  /**\n   * Creates a RequestError from a failed HTTP Response object.\n   *\n   * This is a factory method that extracts all relevant information from a\n   * Response object and constructs a RequestError with appropriate details.\n   * It attempts to parse the response body as JSON first, falling back to\n   * text if that fails, and finally to null if the body cannot be read.\n   *\n   * The error message is extracted from the response body if available\n   * (looking for `message` or `error` fields), otherwise a generic message\n   * is constructed using the status code.\n   *\n   * @param response - The failed HTTP Response object to convert into an error\n   * @returns A Promise that resolves to a new RequestError instance\n   *\n   * @example\n   * ```typescript\n   * const response = await fetch(url);\n   * if (!response.ok) {\n   *   throw await RequestError.fromResponse(response);\n   * }\n   * ```\n   */\n  static async fromResponse(response: Response): Promise<RequestError> {\n    const errorBody = await iife(async () => {\n      try {\n        const contentType = response.headers.get(\"content-type\") ?? \"\";\n        if (contentType.includes(\"application/json\")) {\n          return await response.json();\n        }\n        return await response.text();\n      } catch {\n        return null;\n      }\n    });\n\n    const message =\n      errorBody?.error?.message ??\n      errorBody?.message ??\n      errorBody?.error ??\n      `Request failed with status code ${response.status}`;\n\n    const headers = iife(() => {\n      const object: Record<string, string> = {};\n      response.headers.forEach((value, name) => {\n        object[name] = value;\n      });\n      return object;\n    });\n\n    return new RequestError({\n      message,\n      url: response.url,\n      statusCode: response.status,\n      statusText: response.statusText,\n      headers,\n      data: errorBody,\n    });\n  }\n}\n\n/**\n * Error thrown when the Gemini API returns no candidates in the response.\n *\n * This error is thrown when the API successfully processes a request but returns\n * an empty candidates array. This can occur when:\n * - The prompt was blocked by safety filters (but no explicit block reason was provided)\n * - An internal error occurred during generation\n * - The model was unable to generate a valid response\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke(\"some prompt\");\n * } catch (error) {\n *   if (NoCandidatesError.isInstance(error)) {\n *     console.log(\"No response candidates were generated\");\n *   }\n * }\n * ```\n */\nexport class NoCandidatesError extends GoogleError(\"no-candidates\") {\n  readonly name = \"NoCandidatesError\" as const;\n\n  constructor() {\n    super(\n      \"No candidates returned from API. This may indicate the prompt was blocked or an error occurred.\"\n    );\n  }\n}\n\n/**\n * Error thrown when an invalid tool is provided to the tool converter.\n *\n * This error is thrown when a tool cannot be converted to Gemini's function\n * declaration format. Tools must be one of:\n * - LangChain structured tools (with Zod schemas)\n * - OpenAI format tools (with JSON Schema)\n * - Gemini-native function declarations\n * - Gemini-native tools (codeExecution, googleSearchRetrieval)\n *\n * @example\n * ```typescript\n * try {\n *   convertToolsToGeminiFunctionDeclarations([invalidTool]);\n * } catch (error) {\n *   if (InvalidToolError.isInstance(error)) {\n *     console.log(`Invalid tool: ${error.tool}`);\n *     console.log(`Expected formats: LangChain tools, OpenAI tools, or Gemini function declarations`);\n *   }\n * }\n * ```\n */\nexport class InvalidToolError extends GoogleError(\"invalid-tool\") {\n  readonly name = \"InvalidToolError\" as const;\n\n  /**\n   * The invalid tool that was provided.\n   */\n  readonly tool: unknown;\n\n  constructor(tool: unknown, message?: string) {\n    const defaultMessage = `Received invalid tool: ${JSON.stringify(\n      tool\n    )}. Tools must be LangChain tools, OpenAI tools, or Gemini function declarations.`;\n\n    super(message ?? defaultMessage);\n    this.tool = tool;\n  }\n}\n\n/**\n * Error thrown when a ToolMessage references a tool call that cannot be found.\n *\n * This error is thrown when a ToolMessage is passed to ChatGoogle but there is no\n * corresponding AIMessage with a matching toolCallId in the conversation history.\n * This typically indicates that:\n * - The tool call ID in the ToolMessage doesn't match any previous tool calls\n * - The AIMessage containing the tool call was not included in the message history\n * - The tool call ID was incorrectly set or modified\n *\n * @example\n * ```typescript\n * try {\n *   await model.invoke([\n *     new ToolMessage({ content: \"result\", tool_call_id: \"nonexistent-id\" })\n *   ]);\n * } catch (error) {\n *   if (ToolCallNotFoundError.isInstance(error)) {\n *     console.log(`Tool call not found: ${error.toolCallId}`);\n *   }\n * }\n * ```\n */\nexport class ToolCallNotFoundError extends GoogleError(\"tool-call-not-found\") {\n  readonly name = \"ToolCallNotFoundError\" as const;\n\n  /**\n   * The tool call ID that could not be found in the conversation history.\n   */\n  readonly toolCallId: string;\n\n  constructor(toolCallId: string, message?: string) {\n    const defaultMessage = `Tool call with ID \"${toolCallId}\" not found in conversation history. Ensure the corresponding AIMessage with this tool call ID is included in the input.`;\n\n    super(message ?? defaultMessage);\n    this.toolCallId = toolCallId;\n  }\n}\n\n/**\n * Parameters for constructing a MalformedOutputError\n */\ntype MalformedOutputErrorParams = {\n  /**\n   * The error message describing what went wrong during parsing\n   */\n  message: string;\n  /**\n   * Optional cause of the parsing error (e.g., the original error that occurred)\n   */\n  cause?: unknown;\n};\n\n/**\n * Error thrown when output parsing fails in structured output methods.\n *\n * This error is thrown when the model's response cannot be parsed according to\n * the expected schema or format. Common causes include:\n * - Invalid message type (not an AIMessage or AIMessageChunk)\n * - Missing or empty content in the response\n * - Malformed JSON that cannot be parsed\n * - Schema validation failures\n *\n * @example\n * ```typescript\n * try {\n *   const result = await model.withStructuredOutput(schema).invoke(\"extract data\");\n * } catch (error) {\n *   if (MalformedOutputError.isInstance(error)) {\n *     console.log(`Failed to parse output: ${error.message}`);\n *     if (error.cause) {\n *       console.log(`Cause:`, error.cause);\n *     }\n *   }\n * }\n * ```\n */\nexport class MalformedOutputError extends GoogleError(\"malformed-output\") {\n  readonly name = \"MalformedOutputError\" as const;\n\n  /**\n   * Optional cause of the parsing error.\n   * This may be the original error that occurred during parsing,\n   * or additional context about what went wrong.\n   */\n  readonly cause?: unknown;\n\n  constructor(params: MalformedOutputErrorParams) {\n    super(params.message);\n    this.cause = params.cause;\n  }\n}\n\n/**\n * Error thrown when input provided to the Google provider is invalid.\n *\n * This error is thrown when the user provides input that cannot be\n * processed by Gemini, such as:\n * - Union types in tool/function schemas\n * - Null-only types in schemas\n * - Unsupported content block source types\n * - Missing required fields in content blocks\n *\n * @example\n * ```typescript\n * try {\n *   const result = schemaToGeminiParameters(unionTypeSchema);\n * } catch (error) {\n *   if (InvalidInputError.isInstance(error)) {\n *     console.log(`Invalid input: ${error.message}`);\n *   }\n * }\n * ```\n */\nexport class InvalidInputError extends GoogleError(\"invalid-input\") {\n  readonly name = \"InvalidInputError\" as const;\n}\n"],"mappings":"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"}