@google/adk 2.3.0 → 2.4.0

package/dist/types/code_executors/container_code_executor.d.ts

@@ -56,6 +56,17 @@ export interface ContainerCodeExecutorOptions {
  * can be re-enabled via `networkEnabled: true` when the executed code is
  * trusted.
  *
+ * A separate container is started per session (keyed on `appName`, `userId`,
+ * and `session.id` from `ExecuteCodeParams.invocationContext`) rather than
+ * one container shared across every call: `codeExecutor` is a single
+ * property set once on an `LlmAgent` instance, and that instance is the
+ * long-lived object serving every session the agent handles, so a single
+ * shared container would let one session's files, environment, and
+ * background processes persist into a later, unrelated session's execution.
+ * A container is still reused across multiple calls *within* the same
+ * session, so the per-call container-startup cost is paid once per session,
+ * not once per call.
+ *
  * Limitations: this executor runs a code string only. `inputFiles` and `args`
  * on the request are not copied into the container, and output files are not
  * collected (`outputFiles` is always empty), so tools that stage resource
@@ -67,8 +78,8 @@ export declare class ContainerCodeExecutor extends BaseCodeExecutor {
     private readonly dockerPath?;
     private readonly containerOptions;
     private readonly timeoutSeconds;
-    private container?;
-    private initPromise?;
+    private readonly containers;
+    private readonly initPromises;
     constructor(options?: ContainerCodeExecutorOptions);
     executeCode(params: ExecuteCodeParams): Promise<CodeExecutionResult>;
     /**
@@ -79,11 +90,12 @@ export declare class ContainerCodeExecutor extends BaseCodeExecutor {
      */
     private describeExit;
     /**
-     * Stops and removes the container. Safe to call when no container has been
-     * started; provided for deterministic teardown in tests and app shutdown.
+     * Stops and removes every session's container. Safe to call when none has
+     * been started; provided for deterministic teardown in tests and app
+     * shutdown.
      */
     close(): Promise<void>;
-    /** Lazily builds/starts the container exactly once. */
+    /** Lazily builds/starts the given session's container exactly once. */
     private ensureContainer;
     private initContainer;
 }

package/dist/types/common.d.ts

@@ -27,8 +27,6 @@ export { CONTENT_REQUEST_PROCESSOR, ContentRequestProcessor, } from './agents/pr
 export { ContextCompactorRequestProcessor } from './agents/processors/context_compactor_request_processor.js';
 export { INTERACTIONS_REQUEST_PROCESSOR, InteractionsRequestProcessor, } from './agents/processors/interactions_request_processor.js';
 export { ReadonlyContext } from './agents/readonly_context.js';
-export { RemoteAgent, isRemoteAgent } from './agents/remote_agent.js';
-export type { RemoteAgentConfig, RemoteAgentFetch, } from './agents/remote_agent.js';
 export { RoutedAgent, isRoutedAgent } from './agents/routed_agent.js';
 export type { AgentRouter, RoutedAgentConfig } from './agents/routed_agent.js';
 export { StreamingMode, createRunConfig } from './agents/run_config.js';
@@ -192,7 +190,8 @@ export type { Logger } from './utils/logger.js';
 export { isGemini2OrAbove, isGemini35LiveTranslate, isGemini3xFlashLive, isGemini3xLive, } from './utils/model_name.js';
 export { toJsonSchema } from './utils/schema.js';
 export type { SchemaLike } from './utils/schema.js';
-export { zodObjectToSchema } from './utils/simple_zod_to_json.js';
+export { isZodObject, isZodSchema, zodObjectToSchema, } from './utils/simple_zod_to_json.js';
+export type { ZodSchema } from './utils/simple_zod_to_json.js';
 export { Task } from './utils/task.js';
 export type { TaskExecutable } from './utils/task.js';
 export { GoogleLLMVariant } from './utils/variant_utils.js';
@@ -218,12 +217,9 @@ export * from './sessions/base_session_service.js';
 export * from './tools/base_tool.js';
 export { convertSessionToEvalFormat, createEmptyState, } from './cli/utils/evals.js';
 export type { EvaluationItem, IntermediateAgentResponseItem, ToolUseItem, } from './cli/utils/evals.js';
-export { CrewaiTool, isCrewaiTool } from './tools/crewai_tool.js';
-export type { CrewaiSchemaLike, CrewaiToolConfig, CrewaiToolLike, } from './tools/crewai_tool.js';
 export { buildFunctionDeclarationForLangchain, buildFunctionDeclarationForParamsForCrewai, buildFunctionDeclarationUtil, } from './tools/function_tool.js';
 export type { CallLiveToolRequest } from './tools/function_tool.js';
-export { LangchainTool, isLangchainTool } from './tools/langchain_tool.js';
-export type { LangchainSchemaLike, LangchainToolConfig, LangchainToolLike, } from './tools/langchain_tool.js';
+export type { LoadMemoryResponse, LoadMemoryToolOptions, } from './tools/load_memory_tool.js';
 export { isBaseRetrievalTool } from './tools/retrieval/base_retrieval_tool.js';
-export { ToolboxTool, isToolboxTool } from './tools/toolbox_tool.js';
-export type { ToolboxClientLike, ToolboxToolOptions, } from './tools/toolbox_tool.js';
+export { ToolboxToolset, isToolboxToolset } from './tools/toolbox_toolset.js';
+export type { ToolboxLoadOptions, ToolboxToolLike, ToolboxToolsetClientLike, ToolboxToolsetOptions, } from './tools/toolbox_toolset.js';

package/dist/types/errors/input_validation_error.d.ts

@@ -9,6 +9,7 @@
 export declare class InputValidationError extends Error {
     /**
      * @param message A message describing why the input is invalid.
+     * @param options Standard error options, e.g. `{cause}`.
      */
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }

package/dist/types/index.d.ts

@@ -21,7 +21,8 @@ export type { VertexAiMemoryBankServiceOptions } from './memory/vertex_ai_memory
 export { VertexAiRagMemoryService } from './memory/vertex_ai_rag_memory_service.js';
 export type { VertexAiRagMemoryServiceOptions } from './memory/vertex_ai_rag_memory_service.js';
 export { DebugLoggingPlugin, isDebugLoggingPlugin, } from './plugins/debug_logging_plugin.js';
-export { DatabaseSessionService } from './sessions/database_session_service.js';
+export { DatabaseSessionService, isStaleSessionError, StaleSessionError, } from './sessions/database_session_service.js';
+export type { DatabaseSessionServiceOptions } from './sessions/database_session_service.js';
 export { getSessionServiceFromUri } from './sessions/registry.js';
 export { VertexAiSessionService } from './sessions/vertex_ai_session_service.js';
 export type { VertexAiCreateSessionRequest, VertexAiSessionServiceOptions, } from './sessions/vertex_ai_session_service.js';
@@ -34,6 +35,7 @@ export { SecretManagerClient, type SecretManagerClientOptions, } from './tools/a
 export { ApplicationIntegrationToolset, type ApplicationIntegrationToolsetOptions, } from './tools/application_integration_tool/application_integration_toolset.js';
 export { actionRequest, actionResponse, ConnectionsClient, CONNECTOR_BASE_SPEC, connectorPayload, createOperation, createOperationRequest, deleteOperation, deleteOperationRequest, executeCustomQueryRequest, getActionOperation, getOperation, getOperationRequest, listOperation, listOperationRequest, updateOperation, updateOperationRequest, type ActionSchema, type ConnectionDetails, type ConnectionsClientOptions, type ConnectorSpec, type EntityOperationOptions, type EntitySchemaAndOperations, type EntitySchemaOperationOptions, type GetActionOperationOptions, } from './tools/application_integration_tool/clients/connections_client.js';
 export { IntegrationClient, type IntegrationClientOptions, } from './tools/application_integration_tool/clients/integration_client.js';
+export { IntegrationConnectorTool, type IntegrationConnectorToolOptions, } from './tools/application_integration_tool/integration_connector_tool.js';
 export { LOAD_WEB_PAGE, loadWebPage } from './tools/load_web_page.js';
 export type { LoadWebPageOptions } from './tools/load_web_page.js';
 export { credentialToParam, dictToAuthScheme, INTERNAL_AUTH_PREFIX, openidDictToSchemeCredential, openidUrlToSchemeCredential, serviceAccountDictToSchemeCredential, serviceAccountSchemeCredential, tokenToSchemeCredential, } from './tools/openapi_tool/auth/auth_helpers.js';
@@ -68,6 +70,6 @@ export * from './tools/google_api_tool/index.js';
 export { DEFAULT_CRITERIA, EVAL_SESSION_ID_PREFIX, EvalStatus, getEvaluationCriteriaOrDefault, getRootAgent, MISSING_EVAL_DEPENDENCIES_MESSAGE, parseAndGetEvalsToRun, RESPONSE_EVALUATION_SCORE_KEY, RESPONSE_MATCH_SCORE_KEY, runEvals, TOOL_TRAJECTORY_SCORE_KEY, tryGetResetFunc, } from './cli/cli_eval.js';
 export type { AddSessionToEvalSetRequest, EvalEntry, EvalInitialSession, EvalMetric, EvalMetricResult, EvalResult, EvalSetItem, InvocationEvalMetricResult, RunEvalRequest, RunEvalResult, RunEvalsOptions, } from './cli/cli_eval.js';
 export { loadDotenvForAgent, walkToRootUntilFound } from './cli/utils/envs.js';
-export { LOGGING_FORMAT, logToStderr, logToTmpFolder } from './cli/utils/logs.js';
+export { LOGGING_FORMAT, logToTmpFolder, setupAdkLogger, } from './cli/utils/logs.js';
 export type { LogToTmpFolderOptions } from './cli/utils/logs.js';
 export * from './tools/mcp/index.js';

package/dist/types/plugins/base_plugin.d.ts

@@ -375,16 +375,6 @@ export declare abstract class BasePlugin {
         toolContext: Context;
         result: Record<string, unknown>;
     }): Promise<Record<string, unknown> | undefined>;
-    /**
-     * Callback executed when a tool call encounters an error.
-      tool: BaseTool;
-      toolArgs: Record<string, unknown>;
-      toolContext: Context;
-      result: Record<string, unknown>;
-    }): Promise<Record<string, unknown> | undefined> {
-      return;
-    }
-  
     /**
      * Callback executed when a tool call encounters an error.
      *

package/dist/types/sessions/base_session_service.d.ts

@@ -139,6 +139,11 @@ export declare abstract class BaseSessionService {
      */
     private updateSessionState;
 }
+/**
+ * Places `event` into `session.events`, replacing the entry with the same id
+ * if one is already there and appending it otherwise.
+ */
+export declare function upsertSessionEvent(session: Session, event: Event): void;
 /**
  * Removes temporary state delta keys from the event.
  */

package/dist/types/sessions/database_session_service.d.ts

@@ -7,6 +7,21 @@ import type { MikroORMOptions as MikroDBOptions } from './db/operations.js';
 import { Event } from '../events/event.js';
 import { AppendEventRequest, BaseSessionService, CreateSessionRequest, DeleteSessionRequest, GetSessionRequest, ListSessionsRequest, ListSessionsResponse } from './base_session_service.js';
 import { Session } from './session.js';
+export { isStaleSessionError, StaleSessionError } from './stale_session_error.js';
+/**
+ * Options for configuring {@link DatabaseSessionService}.
+ */
+export interface DatabaseSessionServiceOptions extends MikroDBOptions {
+    /**
+     * How to handle stale sessions in {@link DatabaseSessionService.appendEvent}.
+     *
+     * - `'reject'` (default): throws a {@link StaleSessionError} without persisting changes.
+     * - `'reload'`: reloads stored events and state into the session object after writing.
+     *
+     * @deprecated 'reload' is deprecated and will be removed in a future release. Use 'reject' (the default) and re-read the session with `getSession` to retry.
+     */
+    staleSession?: 'reject' | 'reload';
+}
 /**
  * Checks if a URI is a database connection URI.
  *
@@ -22,7 +37,8 @@ export declare class DatabaseSessionService extends BaseSessionService {
     private initialized;
     private options?;
     private connectionString?;
-    constructor(connectionStringOrOptions: MikroDBOptions | string);
+    private readonly staleSession;
+    constructor(connectionStringOrOptions: DatabaseSessionServiceOptions | string, options?: DatabaseSessionServiceOptions);
     init(): Promise<void>;
     createSession({ appName, userId, state, sessionId, }: CreateSessionRequest): Promise<Session>;
     getSession({ appName, userId, sessionId, config, }: GetSessionRequest): Promise<Session | undefined>;

package/dist/types/sessions/stale_session_error.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+declare const STALE_SESSION_ERROR_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Error thrown when a session write loses an optimistic concurrency race.
+ */
+export declare class StaleSessionError extends Error {
+    readonly [STALE_SESSION_ERROR_SIGNATURE_SYMBOL] = true;
+    constructor(message: string);
+}
+/**
+ * Type guard for {@link StaleSessionError}.
+ *
+ * @param obj The value to check.
+ * @returns True if obj is a {@link StaleSessionError}.
+ */
+export declare function isStaleSessionError(obj: unknown): obj is StaleSessionError;
+export {};

package/dist/types/skills/loader.d.ts

@@ -9,7 +9,7 @@ import { Frontmatter, Skill } from './skill.js';
  *
  * @param content - The raw content of the SKILL.md file.
  * @returns An object containing the parsed frontmatter and the remaining markdown body.
- * @throws {Error} If the content is not properly formatted with YAML frontmatter.
+ * @throws {InputValidationError} If the content is not properly formatted with YAML frontmatter.
  */
 export declare function parseSkillMdContent(content: string): {
     frontmatter: Frontmatter;
@@ -44,7 +44,8 @@ export declare function loadAllSkillsInDir(skillsBasePath: string): Promise<Reco
  *
  * @param zipBuffer - The raw Buffer of the zip file containing the skill.
  * @returns A Skill object with all components loaded.
- * @throws {Error} If a member name is a traversal path, if SKILL.md is missing,
+ * @throws {NotFoundError} If the archive has no SKILL.md.
+ * @throws {InputValidationError} If a member name is a traversal path,
  * or if the skill name is missing or is not a bare path segment.
  */
 export declare function loadSkillFromZipBuffer(zipBuffer: Buffer): Skill;

package/dist/types/telemetry/tracing.d.ts

@@ -14,7 +14,7 @@
  *    constructs of the framework that are not observable by the SDK.
  */
 import { Content } from '@google/genai';
-import { Context } from '@opentelemetry/api';
+import { Context, Span } from '@opentelemetry/api';
 import { BaseAgent } from '../agents/base_agent.js';
 import { InvocationContext } from '../agents/invocation_context.js';
 import { Event } from '../events/event.js';
@@ -62,15 +62,29 @@ export declare function traceNodeExecution({ nodePath, runId, attempt, status, i
 export interface TraceToolCallParams {
     tool: BaseTool;
     args: Record<string, unknown>;
-    functionResponseEvent: Event;
+    functionResponseEvent?: Event;
+    /** The exception raised while executing the tool, if any. */
+    error?: unknown;
+    /** An error type reported by a tool response instead of a thrown error. */
+    errorType?: string;
+    /** The tool execution span. Defaults to the active span when omitted. */
+    span?: Span;
     invocationContext: InvocationContext;
 }
+/**
+ * Resolves a stable error classification suitable for the OpenTelemetry
+ * `error.type` attribute without using the potentially sensitive error message.
+ *
+ * @param error The thrown value.
+ * @returns The explicit ADK error type, GenAI API status, or error class name.
+ */
+export declare function resolveErrorType(error: unknown): string;
 /**
  * Traces tool call.
  *
  * @param params The parameters object containing tool, args, and function response event.
  */
-export declare function traceToolCall({ tool, args, functionResponseEvent, invocationContext, }: TraceToolCallParams): void;
+export declare function traceToolCall(params: TraceToolCallParams): void;
 export interface TraceMergedToolCallsParams {
     responseEventId: string;
     functionResponseEvent: Event;

package/dist/types/tools/apihub_tool/apihub_toolset.d.ts

@@ -7,8 +7,7 @@ import { OpenAPIV3 } from 'openapi-types';
 import { ReadonlyContext } from '../../agents/readonly_context.js';
 import { AuthCredential } from '../../auth/auth_credential.js';
 import { BaseTool } from '../base_tool.js';
-import { BaseToolset } from '../base_toolset.js';
-import { RestApiTool } from '../openapi_tool/rest_api_tool.js';
+import { BaseToolset, ToolPredicate } from '../base_toolset.js';
 import { BaseAPIHubClient } from './clients/apihub_client.js';
 /** Options for {@link APIHubToolset}. */
 export interface APIHubToolsetOptions {
@@ -44,8 +43,8 @@ export interface APIHubToolsetOptions {
      */
     description?: string;
     /**
-     * When true, the spec is fetched on the first call to `getTools` or
-     * `getTool` instead of when the toolset is constructed.
+     * When true, the spec is fetched on the first call to `getTools`
+     * instead of when the toolset is constructed.
      */
     lazyLoadSpec?: boolean;
     /** Auth scheme applied to every tool the spec produces. */
@@ -57,13 +56,18 @@ export interface APIHubToolsetOptions {
      * built from `accessToken` and `serviceAccountJson`.
      */
     apihubClient?: BaseAPIHubClient;
+    /**
+     * Filter selecting which tools from the spec are exposed by `getTools`.
+     * Accepts a list of tool names or a {@link ToolPredicate} function.
+     */
+    toolFilter?: ToolPredicate | string[];
 }
 /**
  * Builds one tool per operation of an API registered in API Hub.
  *
  * The toolset fetches an OpenAPI spec from API Hub, parses it as YAML or JSON,
  * and hands it to an {@link OpenAPIToolset}, which produces a
- * {@link RestApiTool} for each operation.
+ * `RestApiTool` for each operation.
  *
  * ```ts
  * const toolset = new APIHubToolset({
@@ -79,11 +83,11 @@ export interface APIHubToolsetOptions {
  *
  * By default the spec is fetched when the toolset is constructed. A
  * constructor cannot wait for the request, so a failure is reported by the
- * first call to `getTools` or `getTool`, and every later call reports the same
+ * first call to `getTools`, and every later call reports the same
  * failure.
  *
- * With `lazyLoadSpec`, the spec is fetched on the first call to `getTools` or
- * `getTool`. A successful result is kept, including a spec that produced no
+ * With `lazyLoadSpec`, the spec is fetched on the first call to `getTools`.
+ * A successful result is kept, including a spec that produced no
  * tools. A failed fetch is not kept, so the next call fetches again.
  */
 export declare class APIHubToolset extends BaseToolset {
@@ -91,8 +95,8 @@ export declare class APIHubToolset extends BaseToolset {
     name: string;
     /** The toolset description, filled in from the spec when empty. */
     description: string;
-    readonly apihubResourceName: string;
-    readonly lazyLoadSpec: boolean;
+    private readonly apihubResourceName;
+    private readonly lazyLoadSpec;
     private readonly apihubClient;
     private readonly authScheme?;
     private readonly authCredential?;
@@ -105,17 +109,6 @@ export declare class APIHubToolset extends BaseToolset {
      * @throws When the spec cannot be fetched or is not valid YAML or JSON.
      */
     getTools(context?: ReadonlyContext): Promise<BaseTool[]>;
-    /**
-     * Returns the tool with the given name, or `undefined` when the spec
-     * produced no such tool.
-     *
-     * Unlike `OpenAPIToolset.getTool`, the result is a Promise, because the spec
-     * may still be loading.
-     *
-     * @param name The tool name, which is the operation ID in snake_case.
-     * @throws When the spec cannot be fetched or is not valid YAML or JSON.
-     */
-    getTool(name: string): Promise<RestApiTool | undefined>;
     close(): Promise<void>;
     private loadToolset;
     private prepareTools;

package/dist/types/tools/application_integration_tool/application_integration_toolset.d.ts

@@ -3,18 +3,26 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ReadonlyContext } from '../../agents/readonly_context.js';
+import { AuthCredential } from '../../auth/auth_credential.js';
+import { AuthScheme } from '../../auth/auth_schemes.js';
 import { BaseTool } from '../base_tool.js';
-import { BaseToolset } from '../base_toolset.js';
+import { BaseToolset, ToolPredicate } from '../base_toolset.js';
+import { IntegrationConnectorTool, type IntegrationConnectorToolOptions } from './integration_connector_tool.js';
+export { IntegrationConnectorTool, type IntegrationConnectorToolOptions };
 /** Options of {@link ApplicationIntegrationToolset}. */
 export interface ApplicationIntegrationToolsetOptions {
     /** The Google Cloud project ID. */
     project: string;
     /** The Google Cloud location, such as `us-central1`. */
     location: string;
-    /** The integration name. Set it together with `trigger`. */
+    /** The integration name. Set it together with `triggers` or alone for all triggers. */
     integration?: string;
-    /** The API trigger ID of the integration, such as `api_trigger/my_trigger`. */
-    trigger?: string;
+    /**
+     * The API trigger IDs of the integration, such as
+     * `['api_trigger/my_trigger']`.
+     */
+    triggers?: string[];
     /**
      * The Integration Connectors connection name. Set it together with
      * `entityOperations`, `actions`, or both.
@@ -29,7 +37,7 @@ export interface ApplicationIntegrationToolsetOptions {
     /** Connection actions to expose, such as `['ExecuteCustomQuery']`. */
     actions?: string[];
     /** Prefix of every generated tool name. Defaults to `''`. */
-    toolName?: string;
+    toolNamePrefix?: string;
     /** Text appended to every generated tool description. Defaults to `''`. */
     toolInstructions?: string;
     /**
@@ -38,6 +46,20 @@ export interface ApplicationIntegrationToolsetOptions {
      * Default Credentials.
      */
     serviceAccountJson?: string;
+    /**
+     * Authentication scheme for dynamic end-user credentials on connection tools,
+     * when `authOverrideEnabled` is enabled on the connection.
+     */
+    authScheme?: AuthScheme;
+    /**
+     * Authentication credential for dynamic end-user credentials on connection
+     * tools, when `authOverrideEnabled` is enabled on the connection.
+     */
+    authCredential?: AuthCredential;
+    /**
+     * Filter used to select which generated tools are exposed by `getTools`.
+     */
+    toolFilter?: ToolPredicate | string[];
 }
 /**
  * A toolset generated from a Google Cloud Application Integration API trigger,
@@ -53,7 +75,7 @@ export interface ApplicationIntegrationToolsetOptions {
  *   project: 'my-project',
  *   location: 'us-central1',
  *   integration: 'my-integration',
- *   trigger: 'api_trigger/my_trigger',
+ *   triggers: ['api_trigger/my_trigger'],
  * });
  *
  * @example
@@ -69,9 +91,10 @@ export interface ApplicationIntegrationToolsetOptions {
 export declare class ApplicationIntegrationToolset extends BaseToolset {
     private readonly options;
     private toolsPromise?;
+    private openApiToolsets;
     /**
-     * @throws Error Unless the options name either an integration and a trigger,
-     *   or a connection with at least one entity operation or action.
+     * @throws Error Unless the options name either an integration, or a
+     *   connection with at least one entity operation or action.
      */
     constructor(options: ApplicationIntegrationToolsetOptions);
     /**
@@ -80,7 +103,7 @@ export declare class ApplicationIntegrationToolset extends BaseToolset {
      * The first call fetches the spec and builds the tools. Concurrent calls
      * share that load. When it fails, the next call tries again.
      */
-    getTools(): Promise<BaseTool[]>;
+    getTools(context?: ReadonlyContext): Promise<BaseTool[]>;
     close(): Promise<void>;
     private loadTools;
 }

package/dist/types/tools/application_integration_tool/clients/connections_client.d.ts

@@ -21,6 +21,8 @@ export interface ConnectionsClientOptions {
 }
 /** Service details of an Integration Connectors connection. */
 export interface ConnectionDetails {
+    /** The resource name of the connection, or `''` when not reported. */
+    name?: string;
     /**
      * The Service Directory name of the connection. For a connection with a
      * `host`, the TLS Service Directory name.
@@ -159,17 +161,29 @@ export declare function updateOperation(options: EntityOperationOptions): JsonOb
  */
 export declare function deleteOperation(options: EntityOperationOptions): JsonObject;
 /** Builds the request schema of the create operation of an entity. */
-export declare function createOperationRequest(entity: string): JsonObject;
+export declare function createOperationRequest(entity: string, options?: {
+    includeDynamicAuthConfig?: boolean;
+}): JsonObject;
 /** Builds the request schema of the update operation of an entity. */
-export declare function updateOperationRequest(entity: string): JsonObject;
+export declare function updateOperationRequest(entity: string, options?: {
+    includeDynamicAuthConfig?: boolean;
+}): JsonObject;
 /** Builds the request schema of the get operation. */
-export declare function getOperationRequest(): JsonObject;
+export declare function getOperationRequest(options?: {
+    includeDynamicAuthConfig?: boolean;
+}): JsonObject;
 /** Builds the request schema of the delete operation. */
-export declare function deleteOperationRequest(): JsonObject;
+export declare function deleteOperationRequest(options?: {
+    includeDynamicAuthConfig?: boolean;
+}): JsonObject;
 /** Builds the request schema of the list operation. */
-export declare function listOperationRequest(): JsonObject;
+export declare function listOperationRequest(options?: {
+    includeDynamicAuthConfig?: boolean;
+}): JsonObject;
 /** Builds the request schema of an action. */
-export declare function actionRequest(action: string): JsonObject;
+export declare function actionRequest(action: string, options?: {
+    includeDynamicAuthConfig?: boolean;
+}): JsonObject;
 /** Builds the response schema of an action. */
 export declare function actionResponse(action: string): JsonObject;
 /** Builds the request schema of the `ExecuteCustomQuery` action. */
@@ -186,8 +200,8 @@ export declare class ConnectionsClient {
     private readonly tokenSource;
     constructor(options: ConnectionsClientOptions);
     /**
-     * Reads the service name and host of the connection, and whether it allows
-     * an authentication override.
+     * Reads the resource name, service name and host of the connection, and
+     * whether it allows an authentication override.
      */
     getConnectionDetails(): Promise<ConnectionDetails>;
     /**

package/dist/types/tools/application_integration_tool/clients/integration_client.d.ts

@@ -13,8 +13,8 @@ export interface IntegrationClientOptions {
     location: string;
     /** The integration name. */
     integration?: string;
-    /** The API trigger ID of the integration. */
-    trigger?: string;
+    /** The API trigger IDs of the integration. */
+    triggers?: string[];
     /** The connection name. */
     connection?: string;
     /**
@@ -41,7 +41,7 @@ export declare class IntegrationClient {
     private readonly project;
     private readonly location;
     private readonly integration?;
-    private readonly trigger?;
+    private readonly triggers?;
     private readonly connection?;
     private readonly entityOperations;
     private readonly actions;

package/dist/types/tools/application_integration_tool/integration_connector_tool.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FunctionDeclaration } from '@google/genai';
+import { AuthCredential } from '../../auth/auth_credential.js';
+import { AuthScheme } from '../../auth/auth_schemes.js';
+import { BaseTool, BaseToolParams, RunAsyncToolRequest } from '../base_tool.js';
+import { RestApiTool } from '../openapi_tool/rest_api_tool.js';
+/** Options for {@link IntegrationConnectorTool}. */
+export interface IntegrationConnectorToolOptions extends BaseToolParams {
+    /** The Integration Connectors connection resource name. */
+    connectionName: string;
+    /** The host of the connection, or `''` when it has none. */
+    connectionHost: string;
+    /** The Service Directory name of the connection. */
+    connectionServiceName: string;
+    /** The Integration Connectors entity targeted by the tool, if any. */
+    entity?: string;
+    /** The connector operation executed by the tool, if any. */
+    operation?: string;
+    /** The connector action executed by the tool, if any. */
+    action?: string;
+    /** The underlying {@link RestApiTool} that executes the HTTP request. */
+    restApiTool: RestApiTool;
+    /** The authentication scheme for dynamic end-user credentials, if any. */
+    authScheme?: AuthScheme;
+    /** The authentication credential for dynamic end-user credentials, if any. */
+    authCredential?: AuthCredential;
+}
+/**
+ * Wraps a {@link RestApiTool} for an Integration Connectors operation, hiding
+ * connection and routing fields from the model declaration and injecting them
+ * when the tool runs.
+ */
+export declare class IntegrationConnectorTool extends BaseTool {
+    /**
+     * Request fields that {@link IntegrationConnectorTool} injects at runtime and
+     * excludes from the function declaration shown to the model.
+     */
+    static readonly EXCLUDE_FIELDS: readonly string[];
+    /**
+     * Request fields that {@link IntegrationConnectorTool} removes from the
+     * `required` list in the function declaration shown to the model.
+     */
+    static readonly OPTIONAL_FIELDS: readonly string[];
+    readonly connectionName: string;
+    readonly connectionHost: string;
+    readonly connectionServiceName: string;
+    readonly entity: string;
+    readonly operation: string;
+    readonly action: string;
+    readonly restApiTool: RestApiTool;
+    readonly authScheme?: AuthScheme;
+    readonly authCredential?: AuthCredential;
+    constructor(options: IntegrationConnectorToolOptions);
+    /**
+     * Returns the Gemini `FunctionDeclaration` with connection routing fields
+     * removed from `parameters.properties` and optional and excluded fields
+     * removed from `parameters.required`.
+     */
+    _getDeclaration(): FunctionDeclaration;
+    /**
+     * Injects the connection details and the configured entity, operation, and
+     * action into a copy of `request.args` and delegates execution to the wrapped
+     * {@link RestApiTool}.
+     */
+    runAsync(request: RunAsyncToolRequest): Promise<unknown>;
+}

package/dist/types/tools/base_toolset.d.ts

@@ -8,11 +8,12 @@ import { LlmRequest } from '../models/llm_request.js';
 import { Context } from '../agents/context.js';
 import { BaseTool } from './base_tool.js';
 /**
- * Function to decide whether a tool should be exposed to LLM. Toolset
- * implementer could consider whether to accept such instance in the toolset's
- * constructor and apply the predicate in getTools method.
+ * Decides whether a tool should be exposed to the LLM based on the tool and
+ * optional context.
  */
-export type ToolPredicate = (tool: BaseTool, readonlyContext: ReadonlyContext) => boolean;
+export type ToolPredicate = {
+    bivariance(tool: BaseTool, readonlyContext?: ReadonlyContext): boolean;
+}['bivariance'];
 /**
  * A unique symbol to identify ADK agent classes.
  * Defined once and shared by all BaseTool instances.
@@ -55,7 +56,7 @@ export declare abstract class BaseToolset {
      * @param context Context used to filter tools available to the agent.
      * @return Whether the tool should be exposed to LLM.
      */
-    protected isToolSelected(tool: BaseTool, context: ReadonlyContext): boolean;
+    protected isToolSelected(tool: BaseTool, context?: ReadonlyContext): boolean;
     /**
      * Processes the outgoing LLM request for this toolset. This method will be
      * called before each tool processes the llm request.

package/dist/types/tools/google_api_tool/google_api_tool.d.ts

@@ -7,6 +7,13 @@ import { FunctionDeclaration } from '@google/genai';
 import { BaseTool, RunAsyncToolRequest } from '../base_tool.js';
 import { RestApiTool } from '../openapi_tool/rest_api_tool.js';
 declare const GOOGLE_API_TOOL_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Options for constructing a {@link GoogleApiTool}.
+ */
+export interface GoogleApiToolOptions {
+    clientId?: string;
+    clientSecret?: string;
+}
 /**
  * Type guard to check if an object is an instance of {@link GoogleApiTool}.
  */
@@ -17,14 +24,14 @@ export declare function isGoogleApiTool(obj: unknown): obj is GoogleApiTool;
  */
 export declare class GoogleApiTool extends BaseTool {
     readonly [GOOGLE_API_TOOL_SIGNATURE_SYMBOL] = true;
-    readonly restApiTool: RestApiTool;
-    constructor(restApiTool: RestApiTool);
+    private readonly restApiTool;
+    constructor(restApiTool: RestApiTool, options?: GoogleApiToolOptions);
     _getDeclaration(): FunctionDeclaration;
     runAsync(request: RunAsyncToolRequest): Promise<unknown>;
     /**
      * Configures OpenID Connect OAuth2 client credentials on the underlying
      * {@link RestApiTool}.
      */
-    configureAuth(clientId: string, clientSecret: string): void;
+    configureAuth(clientId?: string, clientSecret?: string): void;
 }
 export {};