@googleapis/discoveryengine 30.0.0 → 31.0.0

package/build/v1beta.d.ts

@@ -690,6 +690,283 @@ export declare namespace discoveryengine_v1beta {
             [key: string]: string;
         } | null;
     }
+    /**
+     * Evaluation insights for a program.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsights {
+        /**
+         * Optional. List of evaluation insights.
+         */
+        insights?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsightsAlphaEvolveEvaluationInsight[];
+    }
+    /**
+     * A single evaluation insight.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsightsAlphaEvolveEvaluationInsight {
+        /**
+         * Optional. Label of the insight.
+         */
+        label?: string | null;
+        /**
+         * Optional. Text of the insight.
+         */
+        text?: string | null;
+    }
+    /**
+     * Contains the evaluation scores for the target metrics to optimize.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScores {
+        /**
+         * Required. List of evaluation scores.
+         */
+        scores?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScoresAlphaEvolveEvaluationScore[];
+    }
+    /**
+     * Score for a single metric.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScoresAlphaEvolveEvaluationScore {
+        /**
+         * Required. Name of the metric.
+         */
+        metric?: string | null;
+        /**
+         * Required. Score of a program for this metric.
+         */
+        score?: number | null;
+    }
+    /**
+     * An experiment is a single run of the AlphaEvolve agent, an evolutionary coding agent powered by LLM for algorithm discovery and optimization.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperiment {
+        /**
+         * Required. Experiment configuration.
+         */
+        config?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfig;
+        /**
+         * Output only. Time when the experiment was created.
+         */
+        createTime?: string | null;
+        /**
+         * Output only. Specifies the name of the seed program used to start the experiment.
+         */
+        initialAlphaEvolveProgram?: string | null;
+        /**
+         * Identifier. The full resource name of the experiment. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}`
+         */
+        name?: string | null;
+        /**
+         * Output only. The state of the experiment.
+         */
+        state?: string | null;
+        /**
+         * Output only. Experiment stats.
+         */
+        stats?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentStats;
+    }
+    /**
+     * Configuration of an experiment.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfig {
+        /**
+         * Optional. Evolution settings for the experiment.
+         */
+        evolutionSettings?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettings;
+        /**
+         * Optional. Generation settings for the experiment, controlling how new program candidates are generated, including things LLM parameters and user-provided context and prompts.
+         */
+        generationSettings?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettings;
+        /**
+         * Required. Description of the problem to be solved by the experiment.
+         */
+        problemDescription?: string | null;
+        /**
+         * Required. Primary programming language of the code being optimized.
+         */
+        programLanguage?: string | null;
+        /**
+         * Required. Run settings for the experiment, controlling the overall behavior of the experiment run.
+         */
+        runSettings?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigRunSettings;
+        /**
+         * Required. Title of the experiment.
+         */
+        title?: string | null;
+    }
+    /**
+     * Evolution settings for the experiment.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettings {
+        /**
+         * Optional. Parent sampling configuration.
+         */
+        parentSamplingConfig?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfig;
+    }
+    /**
+     * Configuration for parent sampling.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfig {
+        /**
+         * Optional. Pareto sampling configuration.
+         */
+        paretoSamplingConfig?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfigParetoSamplingConfig;
+    }
+    /**
+     * Configuration for Pareto sampling.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigEvolutionSettingsParentSamplingConfigParetoSamplingConfig {
+        /**
+         * Optional. Probability [0.0, 1.0] of sampling parent programs from the Pareto frontier instead of normal fitness-based sampling during candidate generation. Useful when optimizing multiple metrics simultaneously. Default 0.0 (disabled). Only effective when evaluation returns multiple metrics in scores_to_optimize.
+         */
+        paretoSamplingProbability?: number | null;
+    }
+    /**
+     * Generation settings for the experiment.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettings {
+        /**
+         * Optional. Additional user-provided context to be used during generation.
+         */
+        context?: string | null;
+        /**
+         * Optional. When true, the LLM prompt includes the full program text (both mutable EVOLVE-BLOCK regions and immutable boilerplate). When false (default), only the mutable EVOLVE-BLOCK regions are shown, saving context window.
+         */
+        includeFullProgramInPrompt?: boolean | null;
+        /**
+         * Optional. Per-model configuration. See `ModelConfig` for details. If left unset, the server selects a default model.
+         */
+        models?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettingsModelConfig[];
+    }
+    /**
+     * Per-model configuration. Mutually exclusive with `model_mixture` and `model`: when `models` is set, both `model_mixture` and `model` must be left unset. The same allowed-model list and at-most-2-models rule as for `model_mixture` apply. In addition, each entry may specify a per-model `temperature` for LLM sampling. Unlike `model_mixture`, weights here are *relative*: only their ratios matter (the server normalizes them), so callers may use any positive numbers without having to ensure they sum to 1.0.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigGenerationSettingsModelConfig {
+        /**
+         * Required. Model name (e.g. `gemini-2.5-flash`, `gemini-3.1-pro-preview`). See `model_mixture` for the list of allowed models.
+         */
+        name?: string | null;
+        /**
+         * Optional. Relative weight for this model in the mixture. Must be a finite, strictly positive value. Weights across all entries are normalized server-side, so they need not sum to 1.0. Defaults to 1.0 when unset, which is convenient when configuring a single model or an even mixture. Some Pro-tier models are capped at most 50% of the total weight; requests violating that cap are rejected with INVALID_ARGUMENT.
+         */
+        weight?: number | null;
+    }
+    /**
+     * Run settings for the experiment.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentConfigRunSettings {
+        /**
+         * Required. Maximum number of programs that can be generated in parallel. Must be positive.
+         */
+        concurrency?: number | null;
+        /**
+         * Optional. Maximum duration of the experiment. If unset, defaults to 24 hours.
+         */
+        maxDuration?: string | null;
+        /**
+         * Required. Maximum number of programs to generate during the experiment run. The initial program counts towards this limit. Must be greater than 1.
+         */
+        maxPrograms?: number | null;
+    }
+    /**
+     * Stats about the experiment.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveExperimentStats {
+        /**
+         * Output only. Number of candidates generated.
+         */
+        candidatesCount?: number | null;
+        /**
+         * Output only. Number of candidates evaluated.
+         */
+        evaluatedCandidatesCount?: number | null;
+        /**
+         * Output only. Number of billed input tokens consumed by the experiment.
+         */
+        inputTokenCount?: string | null;
+        /**
+         * Output only. Number of billed output tokens consumed by the experiment.
+         */
+        outputTokenCount?: string | null;
+    }
+    /**
+     * Represents a single program to be used within the context of an AlphaEvolve experiment.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgram {
+        /**
+         * Optional. Content of the program.
+         */
+        content?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramContent;
+        /**
+         * Output only. Time when the program was created.
+         */
+        createTime?: string | null;
+        /**
+         * Optional. Evaluation results for the program.
+         */
+        evaluation?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramEvaluation;
+        /**
+         * Optional. Lock token for the program.
+         */
+        lockToken?: string | null;
+        /**
+         * Identifier. Unique identifier for the program. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}/alphaEvolvePrograms/{alpha_evolve_program\}`
+         */
+        name?: string | null;
+        /**
+         * Output only. Optionally specifies which parent programs this program was evolved from. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}/alphaEvolvePrograms/{alpha_evolve_program\}`
+         */
+        parentPrograms?: string[] | null;
+        /**
+         * Output only. State of the program.
+         */
+        state?: string | null;
+    }
+    /**
+     * A self-contained message containing the content of a program. Can represent a collection of files.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramContent {
+        /**
+         * Optional. Description of the program.
+         */
+        description?: string | null;
+        /**
+         * Required. A list of source files that make up the overall program.
+         */
+        files?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveSourceFile[];
+    }
+    /**
+     * Evaluation results for a program candidate.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveProgramEvaluation {
+        /**
+         * Optional. Represents various insights about the candidate, which are not directly used as optimization target, but that can be used to improve subsequent generations, and as such can be used to construct the evolution prompt.
+         */
+        insights?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationInsights;
+        /**
+         * Optional. Contains the evaluation scores for the target metrics to optimize.
+         */
+        scores?: Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveEvaluationScores;
+    }
+    /**
+     * A single source file with its path, content and metadata.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaAlphaEvolveSourceFile {
+        /**
+         * Required. The raw content of the file. This is a string and not bytes, because it should be ultimately processed by the LLM as text.
+         */
+        content?: string | null;
+        /**
+         * Optional. Additional description of the file.
+         */
+        description?: string | null;
+        /**
+         * Required. The relative path of the file, including the filename. e.g., "src/main.py", "utils/helpers.js", "README.md"
+         */
+        path?: string | null;
+        /**
+         * Optional. The programming language of the file.
+         */
+        programLanguage?: string | null;
+    }
     /**
      * Defines an answer.
      */
@@ -1406,6 +1683,25 @@ export declare namespace discoveryengine_v1beta {
          * Required. The supported connector modes for the associated BAP connection.
          */
         supportedConnectorModes?: string[] | null;
+        /**
+         * Optional. Custom toolspec overrides for this connection. For Enterprise BAP connectors that support admin-curated tool definitions, this holds the (simplified) per-tool overrides. On Get, populated by the server by merging persisted overrides with live runtime tool definitions and trimming the result for UI consumption. On Update, the supplied value replaces the persisted overrides after server-side validation and merging: the `base_version` field MUST match the server's current base toolspec version (otherwise the request is rejected with a user-facing error directing the admin to re-download the latest tools first).
+         */
+        toolspecOverride?: Schema$GoogleCloudDiscoveryengineV1alphaBAPConfigToolspecOverride;
+    }
+    /**
+     * Customer-facing view of the admin-curated toolspec for a BAP connection. Holds the (simplified) per-tool definitions surfaced to and editable by the admin in the Discovery Engine UI. Mirrors the shape of the backend `google.cloud.connectorexecution.v1.ToolspecOverride` message, but is intentionally kept as a separate public type so the Discovery Engine API surface can evolve independently of the fed-API surface (AIP-215). Handlers convert between the two via helpers in //cloud/ml/discoveryengine/external_service/v1main/data_connector_service/lib:bap_custom_tool_util.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaBAPConfigToolspecOverride {
+        /**
+         * Required. Base toolspec version against which `tools` were authored. On Update, MUST match the server's current stable toolspec version for the connection; mismatch is rejected with a user-facing error directing the admin to re-download the latest tools first.
+         */
+        baseVersion?: string | null;
+        /**
+         * Required. Tool definitions (one Struct per tool) that the admin has customised on top of the base toolspec returned by the fed API. REQUIRED because it is the only user-editable field in the modify API; the request must carry at least one tool.
+         */
+        tools?: Array<{
+            [key: string]: any;
+        }> | null;
     }
     /**
      * Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.
@@ -2036,7 +2332,7 @@ export declare namespace discoveryengine_v1beta {
          */
         dataProtectionPolicy?: Schema$GoogleCloudDiscoveryengineV1alphaDataProtectionPolicy;
         /**
-         * Required. The identifier for the data source. This is a partial list of supported connectors. Please refer to the [documentation](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/introduction-to-connectors-and-data-stores) for the full list of connectors. Supported first-party connectors include: * `gcs` * `bigquery` * `gcp_fhir` * `google_mail` * `google_drive` * `google_calendar` * `google_chat` Supported third-party connectors include: Generally available (GA) connectors: * `onedrive` * `outlook` * `confluence` * `jira` * `servicenow` * `sharepoint` Preview connectors: * `asana` * `azure_active_directory` * `box` * `canva` * `confluence_server` * `custom_connector` * `docusign` * `dropbox` * `dynamics365` * `github` * `gitlab` * `hubspot` * `jira_server` * `linear` * `native_cloud_identity` * `notion` * `okta` * `pagerduty` * `peoplesoft` * `salesforce` * `shopify` * `slack` * `snowflake` * `teams` * `trello` * `workday` * `zendesk`
+         * Required. The identifier for the data source. For the full, up-to-date list of supported connectors and their values, see [Connect a third-party data source](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/connect-third-party-data-source#sources-by-launch-stage).
          */
         dataSource?: string | null;
         /**
@@ -2103,6 +2399,10 @@ export declare namespace discoveryengine_v1beta {
          * Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered.
          */
         latestPauseTime?: string | null;
+        /**
+         * Optional. User-facing metadata for the connector. Populated from the connector's generated metadata / registry `ConnectorSource`.
+         */
+        metadata?: Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata;
         /**
          * Identifier. The full resource name of the Data Connector. Format: `projects/x/locations/x/collections/x/dataConnector`.
          */
@@ -2111,6 +2411,10 @@ export declare namespace discoveryengine_v1beta {
          * Defines the scheduled time for the next data synchronization. This field requires hour , minute, and time_zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). This is utilized when the data connector has a refresh interval greater than 1 day. When the hours or minutes are not specified, we will assume a sync time of 0:00. The user must provide a time zone to avoid ambiguity.
          */
         nextSyncTime?: Schema$GoogleTypeDateTime;
+        /**
+         * Output only. The static IP addresses used by this connector for OAuth APIs (e.g. end user authentication). These are surfaced separately from `static_ip_addresses` so that customers can apply granular firewall settings for OAuth endpoints. Only populated for connectors that have static IP enabled and are used for actions and/or federated search.
+         */
+        oauthStaticIpAddresses?: string[] | null;
         /**
          * Required data connector parameters in structured json format.
          */
@@ -2153,6 +2457,10 @@ export declare namespace discoveryengine_v1beta {
          * The data synchronization mode supported by the data connector.
          */
         syncMode?: string | null;
+        /**
+         * Optional. Immutable. User-facing, version-independent label for this connector. May be shared by multiple connectors under the same (project, location, collection, data_source); tag-based lookup returns the one with the greatest create_time. Optional at Create time. Agent Designer resolves connectors via (data_source, tag) when set, falling back to the legacy resource-name lookup when unset, so connectors created before the tag-write launch continue to work without a backfill.
+         */
+        tag?: string | null;
         /**
          * Output only. Timestamp the DataConnector was last updated.
          */
@@ -2162,6 +2470,35 @@ export declare namespace discoveryengine_v1beta {
          */
         vpcscEnabled?: boolean | null;
     }
+    /**
+     * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaDataConnectorConnectorMetadata {
+        /**
+         * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.
+         */
+        authenticatedAccount?: string | null;
+        /**
+         * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).
+         */
+        author?: string | null;
+        /**
+         * Optional. Human-readable description of the connector, shown on the connector detail page. One connector has a single description.
+         */
+        description?: string | null;
+        /**
+         * Optional. Free-form, multi-line note about the connector's capabilities or a custom note that can be set for the connector.
+         */
+        note?: string | null;
+        /**
+         * Optional. Short, subtitle-length description of the connector (e.g. shown beneath the connector name in list and detail views).
+         */
+        shortDescription?: string | null;
+        /**
+         * Optional. Display title of the connector.
+         */
+        title?: string | null;
+    }
     /**
      * Any params and credentials used specifically for EUA connectors.
      */
@@ -2353,6 +2690,10 @@ export declare namespace discoveryengine_v1beta {
          * Optional. Configuration for `HEALTHCARE_FHIR` vertical.
          */
         healthcareFhirConfig?: Schema$GoogleCloudDiscoveryengineV1alphaHealthcareFhirConfig;
+        /**
+         * Output only. Provides the icon URI of the data store's connector source, if this is a connector-backed data store. Empty for data stores without an associated connector source. In DataStoreService.ListDataStores and DataStoreService.GetDataStore, this is only populated when DataStoreView.DATA_STORE_VIEW_FULL is requested via ListDataStoresRequest.view or GetDataStoreRequest.view respectively.
+         */
+        iconUri?: string | null;
         /**
          * Immutable. The fully qualified resource name of the associated IdentityMappingStore. This field can only be set for acl_enabled DataStores with `THIRD_PARTY` or `GSUITE` IdP. Format: `projects/{project\}/locations/{location\}/identityMappingStores/{identity_mapping_store\}`.
          */
@@ -2702,6 +3043,10 @@ export declare namespace discoveryengine_v1beta {
          * The number of end users under the user store that were successfully deleted.
          */
         successCount?: string | null;
+        /**
+         * Operation last update time. If the operation is done, this is also the finish time.
+         */
+        updateTime?: string | null;
     }
     /**
      * Defines target endpoints used to connect to third-party sources.
@@ -2925,6 +3270,10 @@ export declare namespace discoveryengine_v1beta {
          * Optional. Immutable. This the application type which this engine resource represents. NOTE: this is a new concept independ of existing industry vertical or solution type.
          */
         appType?: string | null;
+        /**
+         * Output only. The Agent registry containing the agents, MCP servers and tools associated with this engine. Derived server-side from the linked Agent Gateway's registry.
+         */
+        associatedAgentRegistry?: string | null;
         /**
          * Configurations for the Chat Engine. Only applicable if solution_type is SOLUTION_TYPE_CHAT.
          */
@@ -2968,7 +3317,7 @@ export declare namespace discoveryengine_v1beta {
          */
         displayName?: string | null;
         /**
-         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `disable-mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `disable-canvas-workspace` * `disable-skills` * `enable-end-user-sharing-with-groups`
+         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
          */
         features?: {
             [key: string]: string;
@@ -3229,7 +3578,7 @@ export declare namespace discoveryengine_v1beta {
      */
     export interface Schema$GoogleCloudDiscoveryengineV1alphaEngineSearchEngineConfig {
         /**
-         * Optional. The required subscription tier of this engine. They cannot be modified after engine creation. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine.
+         * Optional. The required subscription tier of this engine. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine. Web grounding feature is only available on the app if it is set as SubscriptionTier.SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT.
          */
         requiredSubscriptionTier?: string | null;
         /**
@@ -3771,6 +4120,10 @@ export declare namespace discoveryengine_v1beta {
          * Output only. Whether the license config is for Gemini bundle.
          */
         geminiBundle?: boolean | null;
+        /**
+         * Optional. Timestamp of the most recent user-initiated update (seat count change or subscription term change). Unlike `update_time`, this field is only stamped when a customer explicitly updates the license (e.g. via the UI), and is not touched by system-driven writes (subscription pipeline, BALC propagation, etc.).
+         */
+        lastUserUpdateTime?: string | null;
         /**
          * Required. Number of licenses purchased.
          */
@@ -3946,6 +4299,10 @@ export declare namespace discoveryengine_v1beta {
      * Represents the currently effective configurable billing parameters. These values are derived from the customer's subscription history stored internally and reflect the thresholds actively being used for billing purposes at the time of the GetProject call. This includes the start_time of the subscription and may differ from the values in `customer_provided_config` due to billing rules (e.g., scale-downs taking effect only at the start of a new month). We also include the update type to indicate the type of update performed on the configurable billing configuration in the UpdateProject operation.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1alphaProjectConfigurableBillingStatus {
+        /**
+         * Output only. Per-model Agent Search TPM subscription status.
+         */
+        agentSearchTokenSubscriptionStatuses?: Schema$GoogleCloudDiscoveryengineV1alphaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus[];
         /**
          * Optional. The currently effective Indexing Core threshold. This is the threshold against which Indexing Core usage is compared for overage calculations.
          */
@@ -3975,6 +4332,35 @@ export declare namespace discoveryengine_v1beta {
          */
         updateType?: string | null;
     }
+    /**
+     * Per-model Agent Search TPM subscription status. One entry per active `core_subscription.agent_search_token_subscriptions[*]` entry in the customer-provided config; populated by UpdateProject and GetProject. The lifecycle scalars on this message (`start_time`, `terminate_time`, `update_type`, `tpm_threshold_next_update_time`) are per (project, model_version) — siblings of the whole-relationship `start_time` / `terminate_time` / `update_type` on the enclosing ConfigurableBillingStatus, but scoped to this specific Agent Search TPM subscription instead of to the overall customer-configurable- pricing relationship. This per-instance granularity is intentional: the underlying SubV3 storage is per-(project, model_version), so each model has its own activation, termination, and deferred-update clock; surfacing that on the response gives customers the granularity they need to manage per-model commitments independently. QPM / IndexingCore differ — their storage is one row per (project, location), so their lifecycle is represented only by the whole- relationship scalars on ConfigurableBillingStatus.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus {
+        /**
+         * Output only. The currently effective TPM threshold. Reflects scale-up immediately and scale-down at the next billing cycle, matching `effective_search_qpm_threshold` semantics.
+         */
+        effectiveTpmThreshold?: string | null;
+        /**
+         * Output only. The Gemini model version this status corresponds to. Matches CoreSubscription.AgentSearchTokenSubscription.model_version (a stable Gemini model version from the Gemini Enterprise Agent Platform model-versions registry; see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
+         */
+        modelVersion?: string | null;
+        /**
+         * Output only. When this (project, model_version) Agent Search TPM subscription was first activated. Set once on first activation of this model version and never moved by subsequent threshold updates; on termination + re-activation a new value is recorded. Does NOT move the whole-relationship `start_time` on the enclosing ConfigurableBillingStatus, which continues to represent the first activation of the overall customer-configurable-pricing relationship.
+         */
+        startTime?: string | null;
+        /**
+         * Output only. If set, the scheduled effective time at which this (project, model_version) Agent Search TPM subscription will terminate. Populated when the customer removes this entry from `core_subscription.agent_search_token_subscriptions[*]`. Does NOT move the whole-relationship `terminate_time` on the enclosing ConfigurableBillingStatus, which is populated only when the entire customer-configurable-pricing relationship is being torn down.
+         */
+        terminateTime?: string | null;
+        /**
+         * Output only. The earliest next update time for the TPM subscription threshold for this (project, model_version). Populated only after a successful update.
+         */
+        tpmThresholdNextUpdateTime?: string | null;
+        /**
+         * Output only. The type of the most recent update to this (project, model_version) subscription, as performed by the most recent UpdateProject call. `UPDATE_TYPE_UNSPECIFIED` indicates this model_version was not touched by the most recent UpdateProject (its `effective_tpm_threshold` reflects an earlier update). The whole-relationship `update_type` on the enclosing ConfigurableBillingStatus continues to summarize the direction of the most recent update across all surfaces in the project (QPM, IndexingCore, and Agent Search TPM together).
+         */
+        updateType?: string | null;
+    }
     /**
      * Customer provided configurations.
      */
@@ -4080,7 +4466,7 @@ export declare namespace discoveryengine_v1beta {
         updateTime?: string | null;
     }
     /**
-     * Response message for CompletionService.PurgeCompletionSuggestions method.
+     * Response message for CompletionService.PurgeCompletionSuggestions method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1alphaPurgeCompletionSuggestionsResponse {
         /**
@@ -4517,6 +4903,19 @@ export declare namespace discoveryengine_v1beta {
          */
         filterGroups?: string[] | null;
     }
+    /**
+     * Metadata for AlphaEvolveService.ResumeExperiment long running operation.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaResumeExperimentMetadata {
+        /**
+         * Output only. The time the operation was created.
+         */
+        createTime?: string | null;
+        /**
+         * Output only. The time the operation was last updated.
+         */
+        updateTime?: string | null;
+    }
     /**
      * Safety rating corresponding to the generated content.
      */
@@ -5434,6 +5833,28 @@ export declare namespace discoveryengine_v1beta {
          */
         verifyTime?: string | null;
     }
+    /**
+     * Metadata for AlphaEvolveService.StartExperiment long running operation.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaStartExperimentMetadata {
+        /**
+         * Output only. The time the operation was created.
+         */
+        createTime?: string | null;
+        /**
+         * Output only. The time the operation was last updated.
+         */
+        updateTime?: string | null;
+    }
+    /**
+     * Request message for AlphaEvolveService.StartExperiment.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1alphaStartExperimentRequest {
+        /**
+         * Required. Experiment to start. Format: `projects/{project\}/locations/{location\}/collections/{collection\}/engines/{engine\}/sessions/{session\}/alphaEvolveExperiments/{alpha_evolve_experiment\}`
+         */
+        name?: string | null;
+    }
     /**
      * A target site for the SiteSearchEngine.
      */
@@ -5655,11 +6076,11 @@ export declare namespace discoveryengine_v1beta {
         userId?: string | null;
     }
     /**
-     * Precise location info with multiple representation options. Currently only latitude and longitude point is supported.
+     * Precise location info with multiple representation options.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1alphaUserInfoPreciseLocation {
         /**
-         * Optional. Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
+         * Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
          */
         address?: string | null;
         /**
@@ -5925,6 +6346,25 @@ export declare namespace discoveryengine_v1beta {
          * Required. The supported connector modes for the associated BAP connection.
          */
         supportedConnectorModes?: string[] | null;
+        /**
+         * Optional. Custom toolspec overrides for this connection. For Enterprise BAP connectors that support admin-curated tool definitions, this holds the (simplified) per-tool overrides. On Get, populated by the server by merging persisted overrides with live runtime tool definitions and trimming the result for UI consumption. On Update, the supplied value replaces the persisted overrides after server-side validation and merging: the `base_version` field MUST match the server's current base toolspec version (otherwise the request is rejected with a user-facing error directing the admin to re-download the latest tools first).
+         */
+        toolspecOverride?: Schema$GoogleCloudDiscoveryengineV1BAPConfigToolspecOverride;
+    }
+    /**
+     * Customer-facing view of the admin-curated toolspec for a BAP connection. Holds the (simplified) per-tool definitions surfaced to and editable by the admin in the Discovery Engine UI. Mirrors the shape of the backend `google.cloud.connectorexecution.v1.ToolspecOverride` message, but is intentionally kept as a separate public type so the Discovery Engine API surface can evolve independently of the fed-API surface (AIP-215). Handlers convert between the two via helpers in //cloud/ml/discoveryengine/external_service/v1main/data_connector_service/lib:bap_custom_tool_util.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1BAPConfigToolspecOverride {
+        /**
+         * Required. Base toolspec version against which `tools` were authored. On Update, MUST match the server's current stable toolspec version for the connection; mismatch is rejected with a user-facing error directing the admin to re-download the latest tools first.
+         */
+        baseVersion?: string | null;
+        /**
+         * Required. Tool definitions (one Struct per tool) that the admin has customised on top of the base toolspec returned by the fed API. REQUIRED because it is the only user-editable field in the modify API; the request must carry at least one tool.
+         */
+        tools?: Array<{
+            [key: string]: any;
+        }> | null;
     }
     /**
      * Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.
@@ -9409,6 +9849,10 @@ export declare namespace discoveryengine_v1beta {
          * Optional. Immutable. This the application type which this engine resource represents. NOTE: this is a new concept independ of existing industry vertical or solution type.
          */
         appType?: string | null;
+        /**
+         * Output only. The Agent registry containing the agents, MCP servers and tools associated with this engine. Derived server-side from the linked Agent Gateway's registry.
+         */
+        associatedAgentRegistry?: string | null;
         /**
          * Configurations for the Chat Engine. Only applicable if solution_type is SOLUTION_TYPE_CHAT.
          */
@@ -9452,7 +9896,7 @@ export declare namespace discoveryengine_v1beta {
          */
         displayName?: string | null;
         /**
-         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `disable-mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `disable-canvas-workspace` * `disable-skills` * `enable-end-user-sharing-with-groups`
+         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
          */
         features?: {
             [key: string]: string;
@@ -9680,7 +10124,7 @@ export declare namespace discoveryengine_v1beta {
      */
     export interface Schema$GoogleCloudDiscoveryengineV1betaEngineSearchEngineConfig {
         /**
-         * Optional. The required subscription tier of this engine. They cannot be modified after engine creation. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine.
+         * Optional. The required subscription tier of this engine. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine. Web grounding feature is only available on the app if it is set as SubscriptionTier.SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT.
          */
         requiredSubscriptionTier?: string | null;
         /**
@@ -9786,6 +10230,68 @@ export declare namespace discoveryengine_v1beta {
          */
         uri?: string | null;
     }
+    /**
+     * Information about the user feedback. This information will be used for logging and metrics purpose.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1betaFeedback {
+        /**
+         * Optional. The additional user comment of the feedback if user gives a thumb down.
+         */
+        comment?: string | null;
+        /**
+         * Optional. The version of the component that this report is being sent from.
+         */
+        componentVersion?: string | null;
+        /**
+         * The related conversation information when user gives feedback.
+         */
+        conversationInfo?: Schema$GoogleCloudDiscoveryengineV1betaFeedbackConversationInfo;
+        /**
+         * Optional. Whether the customer accepted data use terms.
+         */
+        dataTermsAccepted?: boolean | null;
+        /**
+         * Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
+         */
+        feedbackSource?: string | null;
+        /**
+         * Required. Indicate whether the user gives a positive or negative feedback. If the user gives a negative feedback, there might be more feedback details.
+         */
+        feedbackType?: string | null;
+        /**
+         * The version of the LLM model that was used to generate the response.
+         */
+        llmModelVersion?: string | null;
+        /**
+         * Optional. The reason if user gives a thumb down.
+         */
+        reasons?: string[] | null;
+    }
+    /**
+     * The conversation information such as the question index and session name.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1betaFeedbackConversationInfo {
+        /**
+         * Optional. The token which could be used to fetch the answer log.
+         */
+        answerQueryToken?: string | null;
+        /**
+         * Optional. The token which could be used to fetch the assistant log.
+         */
+        assistToken?: string | null;
+        /**
+         * Required. The user's search query.
+         */
+        query?: Schema$GoogleCloudDiscoveryengineV1betaQuery;
+        /**
+         * The index of the user input within the conversation messages.
+         */
+        questionIndex?: number | null;
+        /**
+         * Name of the newly generated or continued session.
+         */
+        session?: string | null;
+    }
     /**
      * Response message for SiteSearchEngineService.FetchDomainVerificationStatus method.
      */
@@ -10459,6 +10965,10 @@ export declare namespace discoveryengine_v1beta {
          * Output only. Whether the license config is for Gemini bundle.
          */
         geminiBundle?: boolean | null;
+        /**
+         * Optional. Timestamp of the most recent user-initiated update (seat count change or subscription term change). Unlike `update_time`, this field is only stamped when a customer explicitly updates the license (e.g. via the UI), and is not touched by system-driven writes (subscription pipeline, BALC propagation, etc.).
+         */
+        lastUserUpdateTime?: string | null;
         /**
          * Required. Number of licenses purchased.
          */
@@ -10956,6 +11466,10 @@ export declare namespace discoveryengine_v1beta {
      * Represents the currently effective configurable billing parameters. These values are derived from the customer's subscription history stored internally and reflect the thresholds actively being used for billing purposes at the time of the GetProject call. This includes the start_time of the subscription and may differ from the values in `customer_provided_config` due to billing rules (e.g., scale-downs taking effect only at the start of a new month). We also include the update type to indicate the type of update performed on the configurable billing configuration in the UpdateProject operation.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1betaProjectConfigurableBillingStatus {
+        /**
+         * Output only. Per-model Agent Search TPM subscription status.
+         */
+        agentSearchTokenSubscriptionStatuses?: Schema$GoogleCloudDiscoveryengineV1betaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus[];
         /**
          * Optional. The currently effective Indexing Core threshold. This is the threshold against which Indexing Core usage is compared for overage calculations.
          */
@@ -10985,6 +11499,35 @@ export declare namespace discoveryengine_v1beta {
          */
         updateType?: string | null;
     }
+    /**
+     * Per-model Agent Search TPM subscription status. One entry per active `core_subscription.agent_search_token_subscriptions[*]` entry in the customer-provided config; populated by UpdateProject and GetProject. The lifecycle scalars on this message (`start_time`, `terminate_time`, `update_type`, `tpm_threshold_next_update_time`) are per (project, model_version) — siblings of the whole-relationship `start_time` / `terminate_time` / `update_type` on the enclosing ConfigurableBillingStatus, but scoped to this specific Agent Search TPM subscription instead of to the overall customer-configurable- pricing relationship. This per-instance granularity is intentional: the underlying SubV3 storage is per-(project, model_version), so each model has its own activation, termination, and deferred-update clock; surfacing that on the response gives customers the granularity they need to manage per-model commitments independently. QPM / IndexingCore differ — their storage is one row per (project, location), so their lifecycle is represented only by the whole- relationship scalars on ConfigurableBillingStatus.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1betaProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus {
+        /**
+         * Output only. The currently effective TPM threshold. Reflects scale-up immediately and scale-down at the next billing cycle, matching `effective_search_qpm_threshold` semantics.
+         */
+        effectiveTpmThreshold?: string | null;
+        /**
+         * Output only. The Gemini model version this status corresponds to. Matches CoreSubscription.AgentSearchTokenSubscription.model_version (a stable Gemini model version from the Gemini Enterprise Agent Platform model-versions registry; see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
+         */
+        modelVersion?: string | null;
+        /**
+         * Output only. When this (project, model_version) Agent Search TPM subscription was first activated. Set once on first activation of this model version and never moved by subsequent threshold updates; on termination + re-activation a new value is recorded. Does NOT move the whole-relationship `start_time` on the enclosing ConfigurableBillingStatus, which continues to represent the first activation of the overall customer-configurable-pricing relationship.
+         */
+        startTime?: string | null;
+        /**
+         * Output only. If set, the scheduled effective time at which this (project, model_version) Agent Search TPM subscription will terminate. Populated when the customer removes this entry from `core_subscription.agent_search_token_subscriptions[*]`. Does NOT move the whole-relationship `terminate_time` on the enclosing ConfigurableBillingStatus, which is populated only when the entire customer-configurable-pricing relationship is being torn down.
+         */
+        terminateTime?: string | null;
+        /**
+         * Output only. The earliest next update time for the TPM subscription threshold for this (project, model_version). Populated only after a successful update.
+         */
+        tpmThresholdNextUpdateTime?: string | null;
+        /**
+         * Output only. The type of the most recent update to this (project, model_version) subscription, as performed by the most recent UpdateProject call. `UPDATE_TYPE_UNSPECIFIED` indicates this model_version was not touched by the most recent UpdateProject (its `effective_tpm_threshold` reflects an earlier update). The whole-relationship `update_type` on the enclosing ConfigurableBillingStatus continues to summarize the direction of the most recent update across all surfaces in the project (QPM, IndexingCore, and Agent Search TPM together).
+         */
+        updateType?: string | null;
+    }
     /**
      * Customer provided configurations.
      */
@@ -13407,6 +13950,10 @@ export declare namespace discoveryengine_v1beta {
          * A global unique ID that identifies the current pair of request and stream of responses. Used for feedback and support.
          */
         assistToken?: string | null;
+        /**
+         * Per-connector authentication errors encountered during the request. Present when one or more connectors failed authentication but the request proceeded with the remaining connectors.
+         */
+        connectorAuthErrors?: Schema$GoogleCloudDiscoveryengineV1betaStreamAssistResponseConnectorAuthError[];
         /**
          * The tool names of the tools that were invoked.
          */
@@ -13420,6 +13967,19 @@ export declare namespace discoveryengine_v1beta {
          */
         sessionInfo?: Schema$GoogleCloudDiscoveryengineV1betaStreamAssistResponseSessionInfo;
     }
+    /**
+     * Describes an authentication error for a specific data connector.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1betaStreamAssistResponseConnectorAuthError {
+        /**
+         * Resource name of the data connector that failed authentication.
+         */
+        dataConnector?: string | null;
+        /**
+         * Human-readable error message describing the auth failure.
+         */
+        errorMessage?: string | null;
+    }
     /**
      * Represents a skill used during the assist call.
      */
@@ -13737,6 +14297,10 @@ export declare namespace discoveryengine_v1beta {
          * Required. User event type. Allowed values are: Generic values: * `search`: Search for Documents. * `view-item`: Detailed page view of a Document. * `view-item-list`: View of a panel or ordered list of Documents. * `view-home-page`: View of the home page. * `view-category-page`: View of a category page, e.g. Home \> Men \> Jeans Retail-related values: * `add-to-cart`: Add an item(s) to cart, e.g. in Retail online shopping * `purchase`: Purchase an item(s) Media-related values: * `media-play`: Start/resume watching a video, playing a song, etc. * `media-complete`: Finished or stopped midway through a video, song, etc. Custom conversion value: * `conversion`: Customer defined conversion event.
          */
         eventType?: string | null;
+        /**
+         * Optional. This field is optional except for the `add-feedback` event types.
+         */
+        feedback?: Schema$GoogleCloudDiscoveryengineV1betaFeedback;
         /**
          * Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. One example is for `search` events, the associated SearchRequest may contain a filter expression in SearchRequest.filter conforming to https://google.aip.dev/160#filtering. Similarly, for `view-item-list` events that are generated from a RecommendRequest, this field may be populated directly from RecommendRequest.filter conforming to https://google.aip.dev/160#filtering. The value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
          */
@@ -13808,11 +14372,11 @@ export declare namespace discoveryengine_v1beta {
         userId?: string | null;
     }
     /**
-     * Precise location info with multiple representation options. Currently only latitude and longitude point is supported.
+     * Precise location info with multiple representation options.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1betaUserInfoPreciseLocation {
         /**
-         * Optional. Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
+         * Location represented by a natural language address. Will later be geocoded and converted to either a point or a polygon.
          */
         address?: string | null;
         /**
@@ -14279,7 +14843,7 @@ export declare namespace discoveryengine_v1beta {
          */
         createTime?: string | null;
         /**
-         * Required. The identifier for the data source. This is a partial list of supported connectors. Please refer to the [documentation](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/introduction-to-connectors-and-data-stores) for the full list of connectors. Supported first-party connectors include: * `gcs` * `bigquery` * `gcp_fhir` * `google_mail` * `google_drive` * `google_calendar` * `google_chat` Supported third-party connectors include: Generally available (GA) connectors: * `onedrive` * `outlook` * `confluence` * `jira` * `servicenow` * `sharepoint` Preview connectors: * `asana` * `azure_active_directory` * `box` * `canva` * `confluence_server` * `custom_connector` * `docusign` * `dropbox` * `dynamics365` * `github` * `gitlab` * `hubspot` * `jira_server` * `linear` * `native_cloud_identity` * `notion` * `okta` * `pagerduty` * `peoplesoft` * `salesforce` * `shopify` * `slack` * `snowflake` * `teams` * `trello` * `workday` * `zendesk`
+         * Required. The identifier for the data source. For the full, up-to-date list of supported connectors and their values, see [Connect a third-party data source](https://docs.cloud.google.com/gemini/enterprise/docs/connectors/connect-third-party-data-source#sources-by-launch-stage).
          */
         dataSource?: string | null;
         /**
@@ -14346,6 +14910,10 @@ export declare namespace discoveryengine_v1beta {
          * Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered.
          */
         latestPauseTime?: string | null;
+        /**
+         * Optional. User-facing metadata for the connector. Populated from the connector's generated metadata / registry `ConnectorSource`.
+         */
+        metadata?: Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata;
         /**
          * Identifier. The full resource name of the Data Connector. Format: `projects/x/locations/x/collections/x/dataConnector`.
          */
@@ -14354,6 +14922,10 @@ export declare namespace discoveryengine_v1beta {
          * Defines the scheduled time for the next data synchronization. This field requires hour , minute, and time_zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). This is utilized when the data connector has a refresh interval greater than 1 day. When the hours or minutes are not specified, we will assume a sync time of 0:00. The user must provide a time zone to avoid ambiguity.
          */
         nextSyncTime?: Schema$GoogleTypeDateTime;
+        /**
+         * Output only. The static IP addresses used by this connector for OAuth APIs (e.g. end user authentication). These are surfaced separately from `static_ip_addresses` so that customers can apply granular firewall settings for OAuth endpoints. Only populated for connectors that have static IP enabled and are used for actions and/or federated search.
+         */
+        oauthStaticIpAddresses?: string[] | null;
         /**
          * Required data connector parameters in structured json format.
          */
@@ -14396,6 +14968,10 @@ export declare namespace discoveryengine_v1beta {
          * The data synchronization mode supported by the data connector.
          */
         syncMode?: string | null;
+        /**
+         * Optional. Immutable. User-facing, version-independent label for this connector. May be shared by multiple connectors under the same (project, location, collection, data_source); tag-based lookup returns the one with the greatest create_time. Optional at Create time. Agent Designer resolves connectors via (data_source, tag) when set, falling back to the legacy resource-name lookup when unset, so connectors created before the tag-write launch continue to work without a backfill.
+         */
+        tag?: string | null;
         /**
          * Output only. Timestamp the DataConnector was last updated.
          */
@@ -14405,6 +14981,35 @@ export declare namespace discoveryengine_v1beta {
          */
         vpcscEnabled?: boolean | null;
     }
+    /**
+     * User-facing metadata for the connector, shown on the connector detail page (title, description, short_description, author, authenticated_account, note).
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1DataConnectorConnectorMetadata {
+        /**
+         * Optional. The end user's account as authenticated to the connector, so the end user can see which account is connected. May be an email, a username, or any identifier the connector/third party provides.
+         */
+        authenticatedAccount?: string | null;
+        /**
+         * Optional. The party that authored the connector, e.g. "Google" or a third-party provider name. Lets end users see who authored a connector (future: third-party-authored connectors).
+         */
+        author?: string | null;
+        /**
+         * Optional. Human-readable description of the connector, shown on the connector detail page. One connector has a single description.
+         */
+        description?: string | null;
+        /**
+         * Optional. Free-form, multi-line note about the connector's capabilities or a custom note that can be set for the connector.
+         */
+        note?: string | null;
+        /**
+         * Optional. Short, subtitle-length description of the connector (e.g. shown beneath the connector name in list and detail views).
+         */
+        shortDescription?: string | null;
+        /**
+         * Optional. Display title of the connector.
+         */
+        title?: string | null;
+    }
     /**
      * Any params and credentials used specifically for EUA connectors.
      */
@@ -15073,6 +15678,10 @@ export declare namespace discoveryengine_v1beta {
          * Optional. Immutable. This the application type which this engine resource represents. NOTE: this is a new concept independ of existing industry vertical or solution type.
          */
         appType?: string | null;
+        /**
+         * Output only. The Agent registry containing the agents, MCP servers and tools associated with this engine. Derived server-side from the linked Agent Gateway's registry.
+         */
+        associatedAgentRegistry?: string | null;
         /**
          * Configurations for the Chat Engine. Only applicable if solution_type is SOLUTION_TYPE_CHAT.
          */
@@ -15116,7 +15725,7 @@ export declare namespace discoveryengine_v1beta {
          */
         displayName?: string | null;
         /**
-         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `disable-mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `disable-canvas-workspace` * `disable-skills` * `enable-end-user-sharing-with-groups`
+         * Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `disable-skills` * `disable-projects` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence`
          */
         features?: {
             [key: string]: string;
@@ -15344,7 +15953,7 @@ export declare namespace discoveryengine_v1beta {
      */
     export interface Schema$GoogleCloudDiscoveryengineV1EngineSearchEngineConfig {
         /**
-         * Optional. The required subscription tier of this engine. They cannot be modified after engine creation. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine.
+         * Optional. The required subscription tier of this engine. If the required subscription tier is search, user with higher license tier like assist can still access the standalone app associated with this engine. Web grounding feature is only available on the app if it is set as SubscriptionTier.SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT.
          */
         requiredSubscriptionTier?: string | null;
         /**
@@ -15615,6 +16224,10 @@ export declare namespace discoveryengine_v1beta {
          * Output only. Whether the license config is for Gemini bundle.
          */
         geminiBundle?: boolean | null;
+        /**
+         * Optional. Timestamp of the most recent user-initiated update (seat count change or subscription term change). Unlike `update_time`, this field is only stamped when a customer explicitly updates the license (e.g. via the UI), and is not touched by system-driven writes (subscription pipeline, BALC propagation, etc.).
+         */
+        lastUserUpdateTime?: string | null;
         /**
          * Required. Number of licenses purchased.
          */
@@ -15697,6 +16310,10 @@ export declare namespace discoveryengine_v1beta {
      * Represents the currently effective configurable billing parameters. These values are derived from the customer's subscription history stored internally and reflect the thresholds actively being used for billing purposes at the time of the GetProject call. This includes the start_time of the subscription and may differ from the values in `customer_provided_config` due to billing rules (e.g., scale-downs taking effect only at the start of a new month). We also include the update type to indicate the type of update performed on the configurable billing configuration in the UpdateProject operation.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1ProjectConfigurableBillingStatus {
+        /**
+         * Output only. Per-model Agent Search TPM subscription status.
+         */
+        agentSearchTokenSubscriptionStatuses?: Schema$GoogleCloudDiscoveryengineV1ProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus[];
         /**
          * Optional. The currently effective Indexing Core threshold. This is the threshold against which Indexing Core usage is compared for overage calculations.
          */
@@ -15726,6 +16343,35 @@ export declare namespace discoveryengine_v1beta {
          */
         updateType?: string | null;
     }
+    /**
+     * Per-model Agent Search TPM subscription status. One entry per active `core_subscription.agent_search_token_subscriptions[*]` entry in the customer-provided config; populated by UpdateProject and GetProject. The lifecycle scalars on this message (`start_time`, `terminate_time`, `update_type`, `tpm_threshold_next_update_time`) are per (project, model_version) — siblings of the whole-relationship `start_time` / `terminate_time` / `update_type` on the enclosing ConfigurableBillingStatus, but scoped to this specific Agent Search TPM subscription instead of to the overall customer-configurable- pricing relationship. This per-instance granularity is intentional: the underlying SubV3 storage is per-(project, model_version), so each model has its own activation, termination, and deferred-update clock; surfacing that on the response gives customers the granularity they need to manage per-model commitments independently. QPM / IndexingCore differ — their storage is one row per (project, location), so their lifecycle is represented only by the whole- relationship scalars on ConfigurableBillingStatus.
+     */
+    export interface Schema$GoogleCloudDiscoveryengineV1ProjectConfigurableBillingStatusAgentSearchTokenSubscriptionStatus {
+        /**
+         * Output only. The currently effective TPM threshold. Reflects scale-up immediately and scale-down at the next billing cycle, matching `effective_search_qpm_threshold` semantics.
+         */
+        effectiveTpmThreshold?: string | null;
+        /**
+         * Output only. The Gemini model version this status corresponds to. Matches CoreSubscription.AgentSearchTokenSubscription.model_version (a stable Gemini model version from the Gemini Enterprise Agent Platform model-versions registry; see https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions#gemini-models).
+         */
+        modelVersion?: string | null;
+        /**
+         * Output only. When this (project, model_version) Agent Search TPM subscription was first activated. Set once on first activation of this model version and never moved by subsequent threshold updates; on termination + re-activation a new value is recorded. Does NOT move the whole-relationship `start_time` on the enclosing ConfigurableBillingStatus, which continues to represent the first activation of the overall customer-configurable-pricing relationship.
+         */
+        startTime?: string | null;
+        /**
+         * Output only. If set, the scheduled effective time at which this (project, model_version) Agent Search TPM subscription will terminate. Populated when the customer removes this entry from `core_subscription.agent_search_token_subscriptions[*]`. Does NOT move the whole-relationship `terminate_time` on the enclosing ConfigurableBillingStatus, which is populated only when the entire customer-configurable-pricing relationship is being torn down.
+         */
+        terminateTime?: string | null;
+        /**
+         * Output only. The earliest next update time for the TPM subscription threshold for this (project, model_version). Populated only after a successful update.
+         */
+        tpmThresholdNextUpdateTime?: string | null;
+        /**
+         * Output only. The type of the most recent update to this (project, model_version) subscription, as performed by the most recent UpdateProject call. `UPDATE_TYPE_UNSPECIFIED` indicates this model_version was not touched by the most recent UpdateProject (its `effective_tpm_threshold` reflects an earlier update). The whole-relationship `update_type` on the enclosing ConfigurableBillingStatus continues to summarize the direction of the most recent update across all surfaces in the project (QPM, IndexingCore, and Agent Search TPM together).
+         */
+        updateType?: string | null;
+    }
     /**
      * Customer provided configurations.
      */
@@ -15831,7 +16477,7 @@ export declare namespace discoveryengine_v1beta {
         updateTime?: string | null;
     }
     /**
-     * Response message for CompletionService.PurgeCompletionSuggestions method.
+     * Response message for CompletionService.PurgeCompletionSuggestions method. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.
      */
     export interface Schema$GoogleCloudDiscoveryengineV1PurgeCompletionSuggestionsResponse {
         /**
@@ -26208,6 +26854,7 @@ export declare namespace discoveryengine_v1beta {
          *           //   "entity": "my_entity",
          *           //   "eventTime": "my_eventTime",
          *           //   "eventType": "my_eventType",
+         *           //   "feedback": {},
          *           //   "filter": "my_filter",
          *           //   "mediaInfo": {},
          *           //   "pageInfo": {},
@@ -26239,6 +26886,7 @@ export declare namespace discoveryengine_v1beta {
          *   //   "entity": "my_entity",
          *   //   "eventTime": "my_eventTime",
          *   //   "eventType": "my_eventType",
+         *   //   "feedback": {},
          *   //   "filter": "my_filter",
          *   //   "mediaInfo": {},
          *   //   "pageInfo": {},
@@ -26383,6 +27031,7 @@ export declare namespace discoveryengine_v1beta {
          *         // {
          *         //   "agentGatewaySetting": {},
          *         //   "appType": "my_appType",
+         *         //   "associatedAgentRegistry": "my_associatedAgentRegistry",
          *         //   "chatEngineConfig": {},
          *         //   "chatEngineMetadata": {},
          *         //   "cmekConfig": {},
@@ -26551,6 +27200,7 @@ export declare namespace discoveryengine_v1beta {
          *   // {
          *   //   "agentGatewaySetting": {},
          *   //   "appType": "my_appType",
+         *   //   "associatedAgentRegistry": "my_associatedAgentRegistry",
          *   //   "chatEngineConfig": {},
          *   //   "chatEngineMetadata": {},
          *   //   "cmekConfig": {},
@@ -26785,6 +27435,7 @@ export declare namespace discoveryengine_v1beta {
          *         // {
          *         //   "agentGatewaySetting": {},
          *         //   "appType": "my_appType",
+         *         //   "associatedAgentRegistry": "my_associatedAgentRegistry",
          *         //   "chatEngineConfig": {},
          *         //   "chatEngineMetadata": {},
          *         //   "cmekConfig": {},
@@ -26816,6 +27467,7 @@ export declare namespace discoveryengine_v1beta {
          *   // {
          *   //   "agentGatewaySetting": {},
          *   //   "appType": "my_appType",
+         *   //   "associatedAgentRegistry": "my_associatedAgentRegistry",
          *   //   "chatEngineConfig": {},
          *   //   "chatEngineMetadata": {},
          *   //   "cmekConfig": {},
@@ -26910,6 +27562,7 @@ export declare namespace discoveryengine_v1beta {
          *   // {
          *   //   "agentGatewaySetting": {},
          *   //   "appType": "my_appType",
+         *   //   "associatedAgentRegistry": "my_associatedAgentRegistry",
          *   //   "chatEngineConfig": {},
          *   //   "chatEngineMetadata": {},
          *   //   "cmekConfig": {},
@@ -27004,6 +27657,7 @@ export declare namespace discoveryengine_v1beta {
          *   // {
          *   //   "agentGatewaySetting": {},
          *   //   "appType": "my_appType",
+         *   //   "associatedAgentRegistry": "my_associatedAgentRegistry",
          *   //   "chatEngineConfig": {},
          *   //   "chatEngineMetadata": {},
          *   //   "cmekConfig": {},
@@ -27782,6 +28436,7 @@ export declare namespace discoveryengine_v1beta {
          *   // {
          *   //   "answer": {},
          *   //   "assistToken": "my_assistToken",
+         *   //   "connectorAuthErrors": [],
          *   //   "invocationTools": [],
          *   //   "invokedSkills": [],
          *   //   "sessionInfo": {}
@@ -38211,6 +38866,7 @@ export declare namespace discoveryengine_v1beta {
          *         //   "entity": "my_entity",
          *         //   "eventTime": "my_eventTime",
          *         //   "eventType": "my_eventType",
+         *         //   "feedback": {},
          *         //   "filter": "my_filter",
          *         //   "mediaInfo": {},
          *         //   "pageInfo": {},
@@ -38241,6 +38897,7 @@ export declare namespace discoveryengine_v1beta {
          *   //   "entity": "my_entity",
          *   //   "eventTime": "my_eventTime",
          *   //   "eventType": "my_eventType",
+         *   //   "feedback": {},
          *   //   "filter": "my_filter",
          *   //   "mediaInfo": {},
          *   //   "pageInfo": {},
@@ -39686,6 +40343,7 @@ export declare namespace discoveryengine_v1beta {
          *       //   "endDate": {},
          *       //   "freeTrial": false,
          *       //   "geminiBundle": false,
+         *       //   "lastUserUpdateTime": "my_lastUserUpdateTime",
          *       //   "licenseCount": "my_licenseCount",
          *       //   "name": "my_name",
          *       //   "startDate": {},
@@ -39705,6 +40363,7 @@ export declare namespace discoveryengine_v1beta {
          *   //   "endDate": {},
          *   //   "freeTrial": false,
          *   //   "geminiBundle": false,
+         *   //   "lastUserUpdateTime": "my_lastUserUpdateTime",
          *   //   "licenseCount": "my_licenseCount",
          *   //   "name": "my_name",
          *   //   "startDate": {},
@@ -39780,6 +40439,7 @@ export declare namespace discoveryengine_v1beta {
          *   //   "endDate": {},
          *   //   "freeTrial": false,
          *   //   "geminiBundle": false,
+         *   //   "lastUserUpdateTime": "my_lastUserUpdateTime",
          *   //   "licenseCount": "my_licenseCount",
          *   //   "name": "my_name",
          *   //   "startDate": {},
@@ -39928,6 +40588,7 @@ export declare namespace discoveryengine_v1beta {
          *       //   "endDate": {},
          *       //   "freeTrial": false,
          *       //   "geminiBundle": false,
+         *       //   "lastUserUpdateTime": "my_lastUserUpdateTime",
          *       //   "licenseCount": "my_licenseCount",
          *       //   "name": "my_name",
          *       //   "startDate": {},
@@ -39947,6 +40608,7 @@ export declare namespace discoveryengine_v1beta {
          *   //   "endDate": {},
          *   //   "freeTrial": false,
          *   //   "geminiBundle": false,
+         *   //   "lastUserUpdateTime": "my_lastUserUpdateTime",
          *   //   "licenseCount": "my_licenseCount",
          *   //   "name": "my_name",
          *   //   "startDate": {},
@@ -41604,6 +42266,7 @@ export declare namespace discoveryengine_v1beta {
          *       //   "entity": "my_entity",
          *       //   "eventTime": "my_eventTime",
          *       //   "eventType": "my_eventType",
+         *       //   "feedback": {},
          *       //   "filter": "my_filter",
          *       //   "mediaInfo": {},
          *       //   "pageInfo": {},
@@ -41634,6 +42297,7 @@ export declare namespace discoveryengine_v1beta {
          *   //   "entity": "my_entity",
          *   //   "eventTime": "my_eventTime",
          *   //   "eventType": "my_eventType",
+         *   //   "feedback": {},
          *   //   "filter": "my_filter",
          *   //   "mediaInfo": {},
          *   //   "pageInfo": {},
@@ -42098,7 +42762,7 @@ export declare namespace discoveryengine_v1beta {
          *       filter: 'placeholder-value',
          *       // Optional. The order in which the UserLicenses are listed. The value must be a comma-separated list of fields. Default sorting order is ascending. To specify descending order for a field, append a " desc" suffix. Redundant space characters in the syntax are insignificant. Supported fields (only `user_principal` is supported for now): * `user_principal` If not set, the default ordering is by `user_principal`. Examples: * `user_principal` to order by `user_principal` in ascending order. * `user_principal desc` to order by `user_principal` in descending order.
          *       orderBy: 'placeholder-value',
-         *       // Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 10. The maximum value is 50; values above 50 will be coerced to 50. If this field is negative, an INVALID_ARGUMENT error is returned.
+         *       // Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 100. The maximum value is 1000; values above 1000 will be coerced to 1000. If this field is negative, an INVALID_ARGUMENT error is returned.
          *       pageSize: 'placeholder-value',
          *       // Optional. A page token, received from a previous `ListUserLicenses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLicenses` must match the call that provided the page token.
          *       pageToken: 'placeholder-value',
@@ -42144,7 +42808,7 @@ export declare namespace discoveryengine_v1beta {
          */
         orderBy?: string;
         /**
-         * Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 10. The maximum value is 50; values above 50 will be coerced to 50. If this field is negative, an INVALID_ARGUMENT error is returned.
+         * Optional. Requested page size. Server may return fewer items than requested. If unspecified, defaults to 100. The maximum value is 1000; values above 1000 will be coerced to 1000. If this field is negative, an INVALID_ARGUMENT error is returned.
          */
         pageSize?: number;
         /**