@google/genai 1.5.1 → 1.6.0

package/dist/genai.d.ts

@@ -1,3 +1,4 @@
+// @ts-ignore
 import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { GoogleAuthOptions } from 'google-auth-library';
 
@@ -191,6 +192,30 @@ declare interface ApiClientInitOptions {
     userAgentExtra?: string;
 }
 
+/**
+ * API errors raised by the GenAI API.
+ */
+export declare class ApiError extends Error {
+    /** HTTP status code */
+    status: number;
+    constructor(options: ApiErrorInfo);
+}
+
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Details for errors from calling the API.
+ */
+export declare interface ApiErrorInfo {
+    /** The error message. */
+    message: string;
+    /** The HTTP status code. */
+    status: number;
+}
+
 /** Config for authentication with API key. */
 export declare interface ApiKeyConfig {
     /** The API key to be used in the request directly. */
@@ -1913,8 +1938,12 @@ export declare interface FunctionDeclaration {
     name?: string;
     /** Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema Value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1 */
     parameters?: Schema;
+    /** Optional. Describes the parameters to the function in JSON Schema format. The schema must describe an object where the properties are the parameters to the function. For example: ``` { "type": "object", "properties": { "name": { "type": "string" }, "age": { "type": "integer" } }, "additionalProperties": false, "required": ["name", "age"], "propertyOrdering": ["name", "age"] } ``` This field is mutually exclusive with `parameters`. */
+    parametersJsonSchema?: unknown;
     /** Optional. Describes the output from this function in JSON Schema format. Reflects the Open API 3.03 Response Object. The Schema defines the type used for the response value of the function. */
     response?: Schema;
+    /** Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. */
+    responseJsonSchema?: unknown;
 }
 
 /** A function response. */
@@ -2501,6 +2530,8 @@ export declare interface GenerationConfig {
     responseModalities?: Modality[];
     /** Optional. The `Schema` object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema). If set, a compatible response_mime_type must also be set. Compatible mimetypes: `application/json`: Schema for JSON response. */
     responseSchema?: Schema;
+    /** Optional. Output schema of the generated response. This is an alternative to `response_schema` that accepts [JSON Schema](https://json-schema.org/). If set, `response_schema` must be omitted, but `response_mime_type` is required. While the full JSON Schema may be sent, not all features are supported. Specifically, only the following properties are supported: - `$id` - `$defs` - `$ref` - `$anchor` - `type` - `format` - `title` - `description` - `enum` (for strings and numbers) - `items` - `prefixItems` - `minItems` - `maxItems` - `minimum` - `maximum` - `anyOf` - `oneOf` (interpreted the same as `anyOf`) - `properties` - `additionalProperties` - `required` The non-standard `propertyOrdering` property may also be set. Cyclic references are unrolled to a limited degree and, as such, may only be used within non-required properties. (Nullable properties are not sufficient.) If `$ref` is set on a sub-schema, no other properties, except for than those starting as a `$`, may be set. */
+    responseJsonSchema?: unknown;
     /** Optional. Routing configuration. */
     routingConfig?: GenerationConfigRoutingConfig;
     /** Optional. Seed. */
@@ -2986,6 +3017,8 @@ export declare interface HttpOptions {
     headers?: Record<string, string>;
     /** Timeout for the request in milliseconds. */
     timeout?: number;
+    /** Extra parameters to add to the request body. */
+    extraBody?: Record<string, unknown>;
 }
 
 /**
@@ -5550,7 +5583,7 @@ export declare interface ThinkingConfig {
     /** Indicates whether to include thoughts in the response. If true, thoughts are returned only if the model supports thought and thoughts are available.
      */
     includeThoughts?: boolean;
-    /** Indicates the thinking budget in tokens.
+    /** Indicates the thinking budget in tokens. 0 is DISABLED. -1 is AUTOMATIC. The default values and allowed ranges are model dependent.
      */
     thinkingBudget?: number;
 }
@@ -6023,6 +6056,8 @@ declare namespace types {
         GenerationConfigRoutingConfig,
         GenerateContentConfig,
         GenerateContentParameters,
+        HttpResponse,
+        LiveCallbacks,
         GoogleTypeDate,
         Citation,
         CitationMetadata,
@@ -6147,8 +6182,6 @@ declare namespace types {
         ListFilesResponse,
         CreateFileConfig,
         CreateFileParameters,
-        HttpResponse,
-        LiveCallbacks,
         CreateFileResponse,
         GetFileConfig,
         GetFileParameters,