@google/genai 0.6.0 → 0.6.1

package/dist/genai.d.ts

@@ -725,6 +725,24 @@ export declare interface DeleteCachedContentParameters {
 export declare class DeleteCachedContentResponse {
 }
 
+/** Used to override the default configuration. */
+export declare interface DeleteFileConfig {
+    /** Used to override HTTP request options. */
+    httpOptions?: HttpOptions;
+}
+
+/** Generates the parameters for the get method. */
+export declare interface DeleteFileParameters {
+    /** The name identifier for the file to be deleted. */
+    name: string;
+    /** Used to override the default configuration. */
+    config?: DeleteFileConfig;
+}
+
+/** Response for the delete file method. */
+export declare class DeleteFileResponse {
+}
+
 /** Used to override the default configuration. */
 export declare interface DownloadFileConfig {
     /** Used to override HTTP request options. */
@@ -933,6 +951,20 @@ declare class Files extends BaseModule {
      * ```
      */
     get(params: types.GetFileParameters): Promise<types.File>;
+    /**
+     * Deletes a remotely stored file.
+     *
+     * @param params - The parameters for the delete request.
+     * @return The DeleteFileResponse, the response for the delete method.
+     *
+     * @example
+     * The following code deletes an example file named "files/mehozpxf877d".
+     *
+     * ```ts
+     * await ai.files.delete({name: file.name});
+     * ```
+     */
+    delete(params: types.DeleteFileParameters): Promise<types.DeleteFileResponse>;
 }
 
 export declare enum FileSource {
@@ -1386,7 +1418,8 @@ export declare interface GenerateImagesConfig {
     /** Allows generation of people by the model.
      */
     personGeneration?: PersonGeneration;
-    /** Whether to report the safety scores of each image in the response.
+    /** Whether to report the safety scores of each generated image and
+     the positive prompt in the response.
      */
     includeSafetyAttributes?: boolean;
     /** Whether to include the Responsible AI filter reason if the image
@@ -1429,6 +1462,10 @@ export declare class GenerateImagesResponse {
     /** List of generated images.
      */
     generatedImages?: GeneratedImage[];
+    /** Safety attributes of the positive prompt. Only populated if
+     ``include_safety_attributes`` is set to True.
+     */
+    positivePromptSafetyAttributes?: SafetyAttributes;
 }
 
 /** Generation config. */
@@ -2315,6 +2352,28 @@ export declare class Models extends BaseModule {
      * ```
      */
     generateContentStream: (params: types.GenerateContentParameters) => Promise<AsyncGenerator<types.GenerateContentResponse>>;
+    /**
+     * Generates an image based on a text description and configuration.
+     *
+     * @param model - The model to use.
+     * @param prompt - A text description of the image to generate.
+     * @param [config] - The config for image generation.
+     * @return The response from the API.
+     *
+     * @example
+     * ```ts
+     * const response = await client.models.generateImages({
+     *  model: 'imagen-3.0-generate-002',
+     *  prompt: 'Robot holding a red skateboard',
+     *  config: {
+     *    numberOfImages: 1,
+     *    includeRaiReason: true,
+     *  },
+     * });
+     * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
+     * ```
+     */
+    generateImages: (params: types.GenerateImagesParameters) => Promise<types.GenerateImagesResponse>;
     private generateContentInternal;
     private generateContentStreamInternal;
     /**
@@ -2358,7 +2417,7 @@ export declare class Models extends BaseModule {
      * console.log(response?.generatedImages?.[0]?.image?.imageBytes);
      * ```
      */
-    generateImages(params: types.GenerateImagesParameters): Promise<types.GenerateImagesResponse>;
+    private generateImagesInternal;
     /**
      * Counts the number of tokens in the given contents. Multimodal input is
      * supported for Gemini models.
@@ -2647,6 +2706,9 @@ export declare interface SafetyAttributes {
     /** List of scores of each categories.
      */
     scores?: number[];
+    /** Internal use only.
+     */
+    contentType?: string;
 }
 
 export declare enum SafetyFilterLevel {
@@ -2696,8 +2758,6 @@ export declare interface Schema {
     default?: unknown;
     /** Optional. Maximum length of the Type.STRING */
     maxLength?: string;
-    /** Optional. The title of the Schema. */
-    title?: string;
     /** Optional. SCHEMA FIELDS FOR TYPE STRING Minimum length of the Type.STRING */
     minLength?: string;
     /** Optional. Minimum number of the properties for Type.OBJECT. */
@@ -2730,6 +2790,8 @@ export declare interface Schema {
     propertyOrdering?: string[];
     /** Optional. Required properties of Type.OBJECT. */
     required?: string[];
+    /** Optional. The title of the Schema. */
+    title?: string;
     /** Optional. The type of the data. */
     type?: Type;
 }
@@ -2995,6 +3057,8 @@ export declare interface TestTableItem {
     hasUnion?: boolean;
     /** When set to a reason string, this test will be skipped in the API mode. Use this flag for tests that can not be reproduced with the real API. E.g. a test that deletes a resource. */
     skipInApiMode?: string;
+    /** Keys to ignore when comparing the request and response. This is useful for tests that are not deterministic. */
+    ignoreKeys?: string[];
 }
 
 /** The thinking features configuration. */
@@ -3188,6 +3252,9 @@ declare namespace types {
         CreateFileResponse,
         GetFileConfig,
         GetFileParameters,
+        DeleteFileConfig,
+        DeleteFileParameters,
+        DeleteFileResponse,
         TestTableItem,
         TestTableFile,
         ReplayRequest,
@@ -3327,10 +3394,12 @@ export declare interface UpscaleImageParameters {
     config?: UpscaleImageConfig;
 }
 
-/** Retrieve from Vertex AI Search datastore for grounding. See https://cloud.google.com/products/agent-builder */
+/** Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder */
 export declare interface VertexAISearch {
-    /** Required. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` */
+    /** Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` */
     datastore?: string;
+    /** Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` */
+    engine?: string;
 }
 
 /** Retrieve from Vertex RAG Store for grounding. */