@google/adk 2.2.1 → 2.4.0

package/dist/cjs/index.js

@@ -25,59 +25,104 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
+  APIHubClient: () => import_apihub_client.APIHubClient,
+  APIHubToolset: () => import_apihub_toolset.APIHubToolset,
   AgentEngineSandboxCodeExecutor: () => import_agent_engine_sandbox_code_executor.AgentEngineSandboxCodeExecutor,
+  ApplicationIntegrationToolset: () => import_application_integration_toolset.ApplicationIntegrationToolset,
   AuthCredentialMissingError: () => import_base_auth_credential_exchanger.AuthCredentialMissingError,
   AutoAuthCredentialExchanger: () => import_auto_auth_credential_exchanger.AutoAuthCredentialExchanger,
   BaseAuthCredentialExchanger: () => import_base_auth_credential_exchanger.BaseAuthCredentialExchanger,
+  CONNECTOR_BASE_SPEC: () => import_connections_client.CONNECTOR_BASE_SPEC,
   CodeExecutionLanguage: () => import_code_execution_utils.CodeExecutionLanguage,
+  ConnectionsClient: () => import_connections_client.ConnectionsClient,
   ContainerCodeExecutor: () => import_container_code_executor.ContainerCodeExecutor,
+  DEFAULT_CRITERIA: () => import_cli_eval.DEFAULT_CRITERIA,
   DatabaseSessionService: () => import_database_session_service.DatabaseSessionService,
+  DebugLoggingPlugin: () => import_debug_logging_plugin.DebugLoggingPlugin,
+  EVAL_SESSION_ID_PREFIX: () => import_cli_eval.EVAL_SESSION_ID_PREFIX,
+  EvalStatus: () => import_cli_eval.EvalStatus,
   FileArtifactService: () => import_file_artifact_service.FileArtifactService,
   FilesRetrieval: () => import_files_retrieval.FilesRetrieval,
   GCPSkillRegistry: () => import_gcp_skill_registry.GCPSkillRegistry,
   GcsArtifactService: () => import_gcs_artifact_service.GcsArtifactService,
   INTERNAL_AUTH_PREFIX: () => import_auth_helpers.INTERNAL_AUTH_PREFIX,
+  IntegrationClient: () => import_integration_client.IntegrationClient,
+  IntegrationConnectorTool: () => import_integration_connector_tool.IntegrationConnectorTool,
   InvocationContext: () => import_invocation_context.InvocationContext,
   LOAD_WEB_PAGE: () => import_load_web_page.LOAD_WEB_PAGE,
+  LOGGING_FORMAT: () => import_logs.LOGGING_FORMAT,
   LoadSkillResourceTool: () => import_load_skill_resource_tool.LoadSkillResourceTool,
   LocalEnvironment: () => import_local_environment.LocalEnvironment,
+  MISSING_EVAL_DEPENDENCIES_MESSAGE: () => import_cli_eval.MISSING_EVAL_DEPENDENCIES_MESSAGE,
   OAuth2BearerExchanger: () => import_oauth2_exchanger.OAuth2BearerExchanger,
   OpenAPIToolset: () => import_openapi_toolset.OpenAPIToolset,
   OpenApiSpecParser: () => import_openapi_spec_parser.OpenApiSpecParser,
   OperationParser: () => import_operation_parser.OperationParser,
+  RESPONSE_EVALUATION_SCORE_KEY: () => import_cli_eval.RESPONSE_EVALUATION_SCORE_KEY,
+  RESPONSE_MATCH_SCORE_KEY: () => import_cli_eval.RESPONSE_MATCH_SCORE_KEY,
   RestApiTool: () => import_rest_api_tool.RestApiTool,
   RunSkillInlineScriptErrorCode: () => import_run_skill_inline_script_tool.RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool: () => import_run_skill_inline_script_tool.RunSkillInlineScriptTool,
   RunSkillScriptTool: () => import_run_skill_script_tool.RunSkillScriptTool,
+  SecretManagerClient: () => import_secret_client.SecretManagerClient,
   ServiceAccountCredentialExchanger: () => import_service_account_exchanger.ServiceAccountCredentialExchanger,
   SkillToolset: () => import_skill_toolset.SkillToolset,
+  StaleSessionError: () => import_database_session_service.StaleSessionError,
+  TOOL_TRAJECTORY_SCORE_KEY: () => import_cli_eval.TOOL_TRAJECTORY_SCORE_KEY,
   ToolAuthHandler: () => import_tool_auth_handler.ToolAuthHandler,
   ToolContextCredentialStore: () => import_tool_auth_handler.ToolContextCredentialStore,
   UnsafeLocalCodeExecutor: () => import_unsafe_local_code_executor.UnsafeLocalCodeExecutor,
   VertexAiMemoryBankService: () => import_vertex_ai_memory_bank_service.VertexAiMemoryBankService,
   VertexAiRagMemoryService: () => import_vertex_ai_rag_memory_service.VertexAiRagMemoryService,
   VertexAiSessionService: () => import_vertex_ai_session_service.VertexAiSessionService,
+  actionRequest: () => import_connections_client.actionRequest,
+  actionResponse: () => import_connections_client.actionResponse,
+  connectorPayload: () => import_connections_client.connectorPayload,
   createApiParameter: () => import_common.createApiParameter,
+  createOperation: () => import_connections_client.createOperation,
+  createOperationRequest: () => import_connections_client.createOperationRequest,
   createRestApiTool: () => import_rest_api_tool.createRestApiTool,
   createRestApiToolFromJson: () => import_rest_api_tool.createRestApiToolFromJson,
   credentialToParam: () => import_auth_helpers.credentialToParam,
+  deleteOperation: () => import_connections_client.deleteOperation,
+  deleteOperationRequest: () => import_connections_client.deleteOperationRequest,
   dictToAuthScheme: () => import_auth_helpers.dictToAuthScheme,
   exchangeCredential: () => import_oauth2_exchanger.exchangeCredential,
+  executeCustomQueryRequest: () => import_connections_client.executeCustomQueryRequest,
+  generateAuthToken: () => import_oauth2_exchanger.generateAuthToken,
   generateParamDoc: () => import_common.generateParamDoc,
   generateReturnDoc: () => import_common.generateReturnDoc,
+  getActionOperation: () => import_connections_client.getActionOperation,
   getArtifactServiceFromUri: () => import_registry.getArtifactServiceFromUri,
+  getEvaluationCriteriaOrDefault: () => import_cli_eval.getEvaluationCriteriaOrDefault,
+  getOperation: () => import_connections_client.getOperation,
+  getOperationRequest: () => import_connections_client.getOperationRequest,
+  getRootAgent: () => import_cli_eval.getRootAgent,
   getSessionServiceFromUri: () => import_registry2.getSessionServiceFromUri,
   getTypeHint: () => import_common.getTypeHint,
+  isDebugLoggingPlugin: () => import_debug_logging_plugin.isDebugLoggingPlugin,
+  isStaleSessionError: () => import_database_session_service.isStaleSessionError,
+  listOperation: () => import_connections_client.listOperation,
+  listOperationRequest: () => import_connections_client.listOperationRequest,
   loadAllSkillsInDir: () => import_loader.loadAllSkillsInDir,
+  loadDotenvForAgent: () => import_envs.loadDotenvForAgent,
   loadSkillFromDir: () => import_loader.loadSkillFromDir,
   loadSkillFromZipBuffer: () => import_loader.loadSkillFromZipBuffer,
   loadWebPage: () => import_load_web_page.loadWebPage,
+  logToTmpFolder: () => import_logs.logToTmpFolder,
   openidDictToSchemeCredential: () => import_auth_helpers.openidDictToSchemeCredential,
   openidUrlToSchemeCredential: () => import_auth_helpers.openidUrlToSchemeCredential,
+  parseAndGetEvalsToRun: () => import_cli_eval.parseAndGetEvalsToRun,
+  runEvals: () => import_cli_eval.runEvals,
   serviceAccountDictToSchemeCredential: () => import_auth_helpers.serviceAccountDictToSchemeCredential,
   serviceAccountSchemeCredential: () => import_auth_helpers.serviceAccountSchemeCredential,
+  setupAdkLogger: () => import_logs.setupAdkLogger,
   tokenToSchemeCredential: () => import_auth_helpers.tokenToSchemeCredential,
-  validateSkillDir: () => import_loader.validateSkillDir
+  tryGetResetFunc: () => import_cli_eval.tryGetResetFunc,
+  updateOperation: () => import_connections_client.updateOperation,
+  updateOperationRequest: () => import_connections_client.updateOperationRequest,
+  validateSkillDir: () => import_loader.validateSkillDir,
+  walkToRootUntilFound: () => import_envs.walkToRootUntilFound
 });
 module.exports = __toCommonJS(index_exports);
 var import_logger_node = require("./utils/logger_node.js");
@@ -94,11 +139,19 @@ __reExport(index_exports, require("./common.js"), module.exports);
 var import_local_environment = require("./environment/local_environment.js");
 var import_vertex_ai_memory_bank_service = require("./memory/vertex_ai_memory_bank_service.js");
 var import_vertex_ai_rag_memory_service = require("./memory/vertex_ai_rag_memory_service.js");
+var import_debug_logging_plugin = require("./plugins/debug_logging_plugin.js");
 var import_database_session_service = require("./sessions/database_session_service.js");
 var import_registry2 = require("./sessions/registry.js");
 var import_vertex_ai_session_service = require("./sessions/vertex_ai_session_service.js");
 var import_gcp_skill_registry = require("./skills/gcp_skill_registry.js");
 var import_loader = require("./skills/loader.js");
+var import_apihub_toolset = require("./tools/apihub_tool/apihub_toolset.js");
+var import_apihub_client = require("./tools/apihub_tool/clients/apihub_client.js");
+var import_secret_client = require("./tools/apihub_tool/clients/secret_client.js");
+var import_application_integration_toolset = require("./tools/application_integration_tool/application_integration_toolset.js");
+var import_connections_client = require("./tools/application_integration_tool/clients/connections_client.js");
+var import_integration_client = require("./tools/application_integration_tool/clients/integration_client.js");
+var import_integration_connector_tool = require("./tools/application_integration_tool/integration_connector_tool.js");
 var import_load_web_page = require("./tools/load_web_page.js");
 var import_auth_helpers = require("./tools/openapi_tool/auth/auth_helpers.js");
 var import_auto_auth_credential_exchanger = require("./tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js");
@@ -119,6 +172,10 @@ var import_skill_toolset = require("./tools/skill/skill_toolset.js");
 __reExport(index_exports, require("./integrations/agent_registry/agent_registry.js"), module.exports);
 __reExport(index_exports, require("./telemetry/google_cloud.js"), module.exports);
 __reExport(index_exports, require("./telemetry/setup.js"), module.exports);
+__reExport(index_exports, require("./tools/google_api_tool/index.js"), module.exports);
+var import_cli_eval = require("./cli/cli_eval.js");
+var import_envs = require("./cli/utils/envs.js");
+var import_logs = require("./cli/utils/logs.js");
 __reExport(index_exports, require("./tools/mcp/index.js"), module.exports);
 /**
  * @license
@@ -128,63 +185,109 @@ __reExport(index_exports, require("./tools/mcp/index.js"), module.exports);
 (0, import_logger_node.installNodeLogger)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  APIHubClient,
+  APIHubToolset,
   AgentEngineSandboxCodeExecutor,
+  ApplicationIntegrationToolset,
   AuthCredentialMissingError,
   AutoAuthCredentialExchanger,
   BaseAuthCredentialExchanger,
+  CONNECTOR_BASE_SPEC,
   CodeExecutionLanguage,
+  ConnectionsClient,
   ContainerCodeExecutor,
+  DEFAULT_CRITERIA,
   DatabaseSessionService,
+  DebugLoggingPlugin,
+  EVAL_SESSION_ID_PREFIX,
+  EvalStatus,
   FileArtifactService,
   FilesRetrieval,
   GCPSkillRegistry,
   GcsArtifactService,
   INTERNAL_AUTH_PREFIX,
+  IntegrationClient,
+  IntegrationConnectorTool,
   InvocationContext,
   LOAD_WEB_PAGE,
+  LOGGING_FORMAT,
   LoadSkillResourceTool,
   LocalEnvironment,
+  MISSING_EVAL_DEPENDENCIES_MESSAGE,
   OAuth2BearerExchanger,
   OpenAPIToolset,
   OpenApiSpecParser,
   OperationParser,
+  RESPONSE_EVALUATION_SCORE_KEY,
+  RESPONSE_MATCH_SCORE_KEY,
   RestApiTool,
   RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool,
   RunSkillScriptTool,
+  SecretManagerClient,
   ServiceAccountCredentialExchanger,
   SkillToolset,
+  StaleSessionError,
+  TOOL_TRAJECTORY_SCORE_KEY,
   ToolAuthHandler,
   ToolContextCredentialStore,
   UnsafeLocalCodeExecutor,
   VertexAiMemoryBankService,
   VertexAiRagMemoryService,
   VertexAiSessionService,
+  actionRequest,
+  actionResponse,
+  connectorPayload,
   createApiParameter,
+  createOperation,
+  createOperationRequest,
   createRestApiTool,
   createRestApiToolFromJson,
   credentialToParam,
+  deleteOperation,
+  deleteOperationRequest,
   dictToAuthScheme,
   exchangeCredential,
+  executeCustomQueryRequest,
+  generateAuthToken,
   generateParamDoc,
   generateReturnDoc,
+  getActionOperation,
   getArtifactServiceFromUri,
+  getEvaluationCriteriaOrDefault,
+  getOperation,
+  getOperationRequest,
+  getRootAgent,
   getSessionServiceFromUri,
   getTypeHint,
+  isDebugLoggingPlugin,
+  isStaleSessionError,
+  listOperation,
+  listOperationRequest,
   loadAllSkillsInDir,
+  loadDotenvForAgent,
   loadSkillFromDir,
   loadSkillFromZipBuffer,
   loadWebPage,
+  logToTmpFolder,
   openidDictToSchemeCredential,
   openidUrlToSchemeCredential,
+  parseAndGetEvalsToRun,
+  runEvals,
   serviceAccountDictToSchemeCredential,
   serviceAccountSchemeCredential,
+  setupAdkLogger,
   tokenToSchemeCredential,
+  tryGetResetFunc,
+  updateOperation,
+  updateOperationRequest,
   validateSkillDir,
+  walkToRootUntilFound,
   ...require("./a2a/index.js"),
   ...require("./common.js"),
   ...require("./integrations/agent_registry/agent_registry.js"),
   ...require("./telemetry/google_cloud.js"),
   ...require("./telemetry/setup.js"),
+  ...require("./tools/google_api_tool/index.js"),
   ...require("./tools/mcp/index.js")
 });

package/dist/cjs/integrations/agent_registry/helpers.js

@@ -37,7 +37,7 @@ module.exports = __toCommonJS(helpers_exports);
 function isGoogleApi(url) {
   try {
     const parsed = new URL(url);
-    return parsed.hostname === "googleapis.com" || parsed.hostname.endsWith(".googleapis.com");
+    return parsed.protocol === "https:" && (parsed.hostname === "googleapis.com" || parsed.hostname.endsWith(".googleapis.com"));
   } catch {
     return false;
   }

package/dist/cjs/models/gemini_llm_connection.js

@@ -140,26 +140,34 @@ const _GeminiLlmConnection = class _GeminiLlmConnection {
     this.geminiSession.sendRealtimeInput({ activityEnd: {} });
   }
   /**
-   * Builds a full text response.
+   * Receives the model responses for one model turn.
    *
-   * The text should not be partial and the returned LlmResponse is not be
-   * partial.
+   * The generator ends after the message that completes the turn has been
+   * processed, or when the server closes the connection. Call `receive()`
+   * again to read the next turn; it continues from the next server message.
    *
-   * @param text The text to be included in the response.
-   * @param isThought Whether the text is a thought.
-   * @param groundingMetadata The grounding metadata to include.
-   * @returns An LlmResponse containing the full text.
+   * @returns A generator of the LlmResponses of one model turn.
    */
   async *receive() {
+    var _a, _b;
     if (!this.messageQueue) {
       throw new Error("Message queue is not initialized.");
     }
+    (_a = this.messageIterator) != null ? _a : this.messageIterator = this.messageQueue[Symbol.asyncIterator]();
     const aggregator = new import_live_connection_utils.LiveResponseAggregator(this.modelVersion);
-    for await (const message of this.messageQueue) {
+    while (true) {
+      const next = await this.messageIterator.next();
+      if (next.done) {
+        break;
+      }
+      const message = next.value;
       import_logger.logger.debug("Got LLM Live message:", message);
       for (const response of aggregator.processMessage(message)) {
         yield response;
       }
+      if ((_b = message.serverContent) == null ? void 0 : _b.turnComplete) {
+        return;
+      }
     }
     for (const response of aggregator.close()) {
       yield response;

package/dist/cjs/models/google_llm.js

@@ -101,7 +101,7 @@ const _Gemini = class _Gemini extends (_b = import_base_llm.BaseLlm, _a = GEMINI
    *     metadata and no `content`; only a stream with neither ends silently.
    */
   async *generateContentAsync(llmRequest, stream = false, abortSignal) {
-    var _a2, _b2, _c;
+    var _a2, _b2;
     if (this.useInteractionsApi) {
       yield* (0, import_interactions_utils.generateContentViaInteractions)(this.apiClient, llmRequest, stream);
       return;
@@ -123,28 +123,23 @@ const _Gemini = class _Gemini extends (_b = import_base_llm.BaseLlm, _a = GEMINI
     if (abortSignal) {
       llmRequest.config.abortSignal = abortSignal;
     }
+    const params = {
+      model: (_b2 = llmRequest.model) != null ? _b2 : this.model,
+      contents: llmRequest.contents,
+      config: llmRequest.config
+    };
     if (stream) {
-      const streamResult = await this.apiClient.models.generateContentStream({
-        model: (_b2 = llmRequest.model) != null ? _b2 : this.model,
-        contents: llmRequest.contents,
-        config: llmRequest.config
-      });
-      const aggregator = new import_streaming_utils.StreamingResponseAggregator();
+      const streamResult = await this.apiClient.models.generateContentStream(params);
+      const aggregator = new import_streaming_utils.GeminiStreamingResponseAggregator();
       for await (const response of streamResult) {
-        for await (const llmResponse of aggregator.processResponse(response)) {
-          yield llmResponse;
-        }
+        yield* aggregator.processResponse(response);
       }
       const finalResponse = aggregator.close();
       if (finalResponse) {
         yield finalResponse;
       }
     } else {
-      const response = await this.apiClient.models.generateContent({
-        model: (_c = llmRequest.model) != null ? _c : this.model,
-        contents: llmRequest.contents,
-        config: llmRequest.config
-      });
+      const response = await this.apiClient.models.generateContent(params);
       yield (0, import_llm_response.createLlmResponse)(response);
     }
   }
@@ -164,6 +159,7 @@ const _Gemini = class _Gemini extends (_b = import_base_llm.BaseLlm, _a = GEMINI
       });
     } else {
       this._apiClient = new import_genai.GoogleGenAI({
+        vertexai: false,
         apiKey: this.apiKey,
         httpOptions: this.getHttpOptions()
       });
@@ -199,6 +195,7 @@ const _Gemini = class _Gemini extends (_b = import_base_llm.BaseLlm, _a = GEMINI
         });
       } else {
         this._liveApiClient = new import_genai.GoogleGenAI({
+          vertexai: false,
           apiKey: this.apiKey,
           httpOptions: this.getLiveHttpOptions()
         });
@@ -305,7 +302,7 @@ function geminiInitParams({
 }) {
   const params = { model, vertexai, project, location, apiKey };
   params.vertexai = !!vertexai;
-  if (!params.vertexai && !(0, import_env_aware_utils.isBrowser)()) {
+  if (vertexai === void 0 && !(0, import_env_aware_utils.isBrowser)()) {
     params.vertexai = (0, import_env_aware_utils.isEnterpriseModeEnabled)();
   }
   if (params.vertexai) {

package/dist/cjs/models/llm_response.js

@@ -33,9 +33,17 @@ module.exports = __toCommonJS(llm_response_exports);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+function withOwnInitialPromptTokenCount(usage) {
+  const initialPromptTokenCount = usage == null ? void 0 : usage.initialPromptTokenCount;
+  if (!usage || initialPromptTokenCount === void 0 || initialPromptTokenCount === usage.promptTokenCount || Object.prototype.propertyIsEnumerable.call(usage, "initialPromptTokenCount")) {
+    return usage;
+  }
+  return { ...usage, initialPromptTokenCount };
+}
+__name(withOwnInitialPromptTokenCount, "withOwnInitialPromptTokenCount");
 function createLlmResponse(response) {
   var _a;
-  const usageMetadata = response.usageMetadata;
+  const usageMetadata = withOwnInitialPromptTokenCount(response.usageMetadata);
   if (response.candidates && response.candidates.length > 0) {
     const candidate = response.candidates[0];
     if (((_a = candidate.content) == null ? void 0 : _a.parts) && candidate.content.parts.length > 0) {

package/dist/cjs/models/registry.js

@@ -101,7 +101,7 @@ const _LLMRegistry = class _LLMRegistry {
     }
     for (const [regex, llmClass] of _LLMRegistry.llmRegistryDict.entries()) {
       const pattern = new RegExp(
-        `^${regex instanceof RegExp ? regex.source : regex}$`,
+        `^(?:${regex instanceof RegExp ? regex.source : regex})$`,
         regex instanceof RegExp ? regex.flags : void 0
       );
       if (pattern.test(model)) {

package/dist/cjs/models/routed_llm.js

@@ -54,14 +54,12 @@ const _RoutedLlm = class _RoutedLlm extends import_base_llm.BaseLlm {
   /**
    * Generates content by delegating to the selected model.
    */
-  async *generateContentAsync(llmRequest, stream) {
+  async *generateContentAsync(llmRequest, stream, abortSignal) {
     import_logger.logger.info(`Routing request via ${this.model}`);
-    yield* (0, import_failover_utils.runWithRouting)(
-      this.models,
-      llmRequest,
-      this.router,
-      (model) => model.generateContentAsync(llmRequest, stream)
-    );
+    yield* (0, import_failover_utils.runWithRouting)(this.models, llmRequest, this.router, (model) => {
+      llmRequest.model = model.model;
+      return model.generateContentAsync(llmRequest, stream, abortSignal);
+    });
   }
   /**
    * Creates a live connection to the LLM by delegating to the selected model.
@@ -73,7 +71,10 @@ const _RoutedLlm = class _RoutedLlm extends import_base_llm.BaseLlm {
       this.models,
       llmRequest,
       this.router,
-      (model) => model.connect(llmRequest)
+      (model) => {
+        llmRequest.model = model.model;
+        return model.connect(llmRequest);
+      }
     );
     const result = await generator.next();
     if (result.done || result.value === void 0) {

package/dist/cjs/planners/plan_re_act_planner.js

@@ -67,7 +67,7 @@ const _PlanReActPlanner = class _PlanReActPlanner extends import_base_planner.Ba
       }
       handleNonFunctionCallPart(part, preservedParts);
     }
-    if (firstFcPartIndex > 0) {
+    if (firstFcPartIndex >= 0) {
       for (let j = firstFcPartIndex + 1; j < responseParts.length; j++) {
         if (!responseParts[j].functionCall) {
           break;

package/dist/cjs/plugins/base_plugin.js

@@ -272,29 +272,19 @@ const _BasePlugin = class _BasePlugin {
     return;
   }
   /**
-     * 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.
-     *
-     * This callback provides an opportunity to handle tool errors gracefully,
-     * potentially providing alternative responses or recovery mechanisms.
-     *
-     * @param _params.tool The tool instance that encountered an error.
-     * @param _params.toolArgs The arguments that were passed to the tool.
-     * @param _params.toolContext The context specific to the tool execution.
-     * @param _params.error The exception that was raised during tool execution.
-     * @returns An optional dictionary. If a dictionary is returned, it will be
-     *     used as the tool response instead of propagating the error. Returning
-     *     `undefined` allows the original error to be raised.
-     */
+   * Callback executed when a tool call encounters an error.
+   *
+   * This callback provides an opportunity to handle tool errors gracefully,
+   * potentially providing alternative responses or recovery mechanisms.
+   *
+   * @param _params.tool The tool instance that encountered an error.
+   * @param _params.toolArgs The arguments that were passed to the tool.
+   * @param _params.toolContext The context specific to the tool execution.
+   * @param _params.error The exception that was raised during tool execution.
+   * @returns An optional dictionary. If a dictionary is returned, it will be
+   *     used as the tool response instead of propagating the error. Returning
+   *     `undefined` allows the original error to be raised.
+   */
   async onToolErrorCallback(_params) {
     return;
   }

package/dist/cjs/runner/in_memory_runner.js

@@ -44,28 +44,23 @@ const _InMemoryRunner = class _InMemoryRunner extends import_runner.Runner {
    * @param params The configuration for the runner.
    * @param params.app An optional application instance to run.
    * @param params.agent The root agent to run.
-   * @param params.appName The application name. Defaults to `'InMemoryRunner'`.
+   * @param params.appName The application name. Defaults to `app.name` when
+   *     `app` is provided, or `'InMemoryRunner'` otherwise.
    * @param params.plugins An optional list of plugins.
    * @param params.resumabilityConfig An optional resumability configuration.
    */
   constructor(params) {
-    var _a;
-    const {
-      agent,
-      appName = "InMemoryRunner",
-      plugins = [],
-      app,
-      resumabilityConfig
-    } = params;
+    var _a, _b;
+    const { agent, appName, plugins = [], app, resumabilityConfig } = params;
     super({
       app,
-      appName,
+      appName: (_a = appName != null ? appName : app == null ? void 0 : app.name) != null ? _a : "InMemoryRunner",
       agent,
       plugins,
       artifactService: new import_in_memory_artifact_service.InMemoryArtifactService(),
       sessionService: new import_in_memory_session_service.InMemorySessionService(),
       memoryService: new import_in_memory_memory_service.InMemoryMemoryService(),
-      resumabilityConfig: (_a = app == null ? void 0 : app.resumabilityConfig) != null ? _a : resumabilityConfig
+      resumabilityConfig: (_b = app == null ? void 0 : app.resumabilityConfig) != null ? _b : resumabilityConfig
     });
   }
 };