@google/adk 2.3.0 → 2.4.0

package/dist/esm/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js

@@ -29,15 +29,27 @@ const VALID_SCHEMA_TYPES = /* @__PURE__ */ new Set([
   "string"
 ]);
 let OpenApiSpecParser = class {
+  /**
+   * @param options.preservePropertyNames Keeps the original parameter and
+   *     function names instead of converting them to snake_case.
+   * @param options.unconstrainedObjectBodyAsParameter Emits a whole-body
+   *     parameter named `body` when an object request body schema has no
+   *     properties. Defaults to `false`.
+   *     @deprecated Retained for backwards compatibility; empty object schemas
+   *     produce no parameters by default. This option will be removed in a
+   *     future release.
+   */
   constructor(options = {}) {
-    var _a;
+    var _a, _b;
     this.preservePropertyNames = (_a = options.preservePropertyNames) != null ? _a : false;
+    this.unconstrainedObjectBodyAsParameter = (_b = options.unconstrainedObjectBodyAsParameter) != null ? _b : false;
   }
   parse(openapiSpec) {
     const resolvedSpec = resolveReferences(openapiSpec);
     const sanitizedSpec = sanitizeSchemaTypes(resolvedSpec);
     return collectOperations(sanitizedSpec, {
-      preservePropertyNames: this.preservePropertyNames
+      preservePropertyNames: this.preservePropertyNames,
+      unconstrainedObjectBodyAsParameter: this.unconstrainedObjectBodyAsParameter
     });
   }
 };
@@ -172,17 +184,18 @@ function resolveServerUrl(server) {
 }
 __name(resolveServerUrl, "resolveServerUrl");
 function collectOperations(spec, options = {}) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const preservePropertyNames = (_a = options.preservePropertyNames) != null ? _a : false;
+  const unconstrainedObjectBodyAsParameter = (_b = options.unconstrainedObjectBodyAsParameter) != null ? _b : false;
   const operations = [];
-  const server = (_b = spec.servers) == null ? void 0 : _b[0];
+  const server = (_c = spec.servers) == null ? void 0 : _c[0];
   const baseUrl = server ? resolveServerUrl(server) : "";
   const globalSecurity = spec.security || [];
   let globalSchemeName;
   if (globalSecurity.length > 0) {
     globalSchemeName = Object.keys(globalSecurity[0])[0];
   }
-  const authSchemes = ((_c = spec.components) == null ? void 0 : _c.securitySchemes) || {};
+  const authSchemes = ((_d = spec.components) == null ? void 0 : _d.securitySchemes) || {};
   for (const [path, pathItem] of Object.entries(spec.paths || {})) {
     if (!pathItem) continue;
     const methods = [
@@ -205,7 +218,8 @@ function collectOperations(spec, options = {}) {
         operation.operationId = toSnakeCaseName(`${path}_${method}`);
       }
       const parser = new OperationParser(operation, {
-        preservePropertyNames
+        preservePropertyNames,
+        unconstrainedObjectBodyAsParameter
       });
       let authSchemeName;
       if (operation.security && operation.security.length > 0) {

package/dist/esm/tools/openapi_tool/openapi_spec_parser/operation_parser.js

@@ -34,13 +34,20 @@ let OperationParser = class {
    *     function names instead of converting them to snake_case.
    * @param options.shouldParse Whether to parse the operation during
    *     construction. Defaults to `true`.
+   * @param options.unconstrainedObjectBodyAsParameter Emits a whole-body
+   *     parameter named `body` when an object request body schema has no
+   *     properties. Defaults to `false`.
+   *     @deprecated Retained for backwards compatibility; empty object schemas
+   *     produce no parameters by default. This option will be removed in a
+   *     future release.
    */
   constructor(operation, options = {}) {
     this.params = [];
-    var _a, _b;
+    var _a, _b, _c;
     this.operation = typeof operation === "string" ? JSON.parse(operation) : operation;
     this.preservePropertyNames = (_a = options.preservePropertyNames) != null ? _a : false;
-    if ((_b = options.shouldParse) != null ? _b : true) {
+    this.unconstrainedObjectBodyAsParameter = (_b = options.unconstrainedObjectBodyAsParameter) != null ? _b : false;
+    if ((_c = options.shouldParse) != null ? _c : true) {
       this.processOperationParameters();
       this.processRequestBody();
       this.returnValue = this.processReturnValue();
@@ -60,6 +67,7 @@ let OperationParser = class {
     return renameReservedKeywords(toSnakeCaseName(originalName));
   }
   processOperationParameters() {
+    var _a;
     const parameters = this.operation.parameters || [];
     for (const param of parameters) {
       if ("name" in param) {
@@ -70,9 +78,12 @@ let OperationParser = class {
         this.params.push({
           originalName,
           paramLocation: location,
-          paramSchema: schema,
+          paramSchema: {
+            ...schema,
+            description: schema.description || description || void 0
+          },
           description,
-          required: param.required || false,
+          required: (_a = param.required) != null ? _a : false,
           name: this.getParamName(originalName)
         });
       }
@@ -108,7 +119,7 @@ let OperationParser = class {
               });
             }
           }
-        } else {
+        } else if (this.unconstrainedObjectBodyAsParameter) {
           this.params.push({
             originalName: "",
             paramLocation: "body",
@@ -129,7 +140,7 @@ let OperationParser = class {
         });
       } else {
         this.params.push({
-          originalName: "body",
+          originalName: "",
           paramLocation: "body",
           paramSchema: schema,
           description,

package/dist/esm/tools/openapi_tool/openapi_toolset.js

@@ -16,7 +16,7 @@ var __decorateClass = (decorators, target, key, kind) => {
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import yaml from "js-yaml";
+import * as yaml from "js-yaml";
 import { experimental } from "../../utils/experimental.js";
 import { logger } from "../../utils/logger.js";
 import { BaseToolset } from "../base_toolset.js";
@@ -40,7 +40,8 @@ let OpenAPIToolset = class extends BaseToolset {
       throw new Error("Either specDict or specStr must be provided.");
     }
     const parser = new OpenApiSpecParser({
-      preservePropertyNames: options.preservePropertyNames
+      preservePropertyNames: options.preservePropertyNames,
+      unconstrainedObjectBodyAsParameter: options.unconstrainedObjectBodyAsParameter
     });
     const parsedOperations = parser.parse(spec);
     for (const op of parsedOperations) {
@@ -61,7 +62,8 @@ let OpenAPIToolset = class extends BaseToolset {
         {
           preservePropertyNames: options.preservePropertyNames,
           headerProvider: options.headerProvider,
-          credentialKey: options.credentialKey
+          credentialKey: options.credentialKey,
+          unconstrainedObjectBodyAsParameter: options.unconstrainedObjectBodyAsParameter
         }
       );
       this.tools.push(tool);
@@ -76,15 +78,7 @@ let OpenAPIToolset = class extends BaseToolset {
     }
   }
   async getTools(context) {
-    return this.tools.filter((tool) => {
-      if (Array.isArray(this.toolFilter) && this.toolFilter.length > 0) {
-        return this.toolFilter.includes(tool.name);
-      }
-      if (context) {
-        return this.isToolSelected(tool, context);
-      }
-      return true;
-    });
+    return this.tools.filter((tool) => this.isToolSelected(tool, context));
   }
   getTool(toolName) {
     return this.tools.find((tool) => tool.name === toolName);

package/dist/esm/tools/openapi_tool/rest_api_tool.js

@@ -176,6 +176,22 @@ function encodePathParamValue(name, value) {
   return encodeURIComponent(value);
 }
 __name(encodePathParamValue, "encodePathParamValue");
+function serializeQueryValue(value) {
+  return typeof value === "object" && value !== null ? JSON.stringify(value) : String(value);
+}
+__name(serializeQueryValue, "serializeQueryValue");
+function appendQueryParam(queryParams, name, value) {
+  if (!Array.isArray(value)) {
+    queryParams.append(name, serializeQueryValue(value));
+    return;
+  }
+  for (const item of value) {
+    if (item !== void 0 && item !== null) {
+      queryParams.append(name, serializeQueryValue(item));
+    }
+  }
+}
+__name(appendQueryParam, "appendQueryParam");
 function prepareRequestParams(endpoint, parameters, args) {
   const headers = {};
   const queryParams = new URLSearchParams();
@@ -196,7 +212,7 @@ function prepareRequestParams(endpoint, parameters, args) {
       );
     } else if (location === "query") {
       if (argValue !== void 0 && argValue !== null && argValue !== "") {
-        queryParams.append(originalName, String(argValue));
+        appendQueryParam(queryParams, originalName, argValue);
       }
     } else if (location === "header") {
       headers[originalName] = String(argValue);

package/dist/esm/tools/toolbox_toolset.js

@@ -0,0 +1,148 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var _a, _b;
+import { isBaseTool } from "./base_tool.js";
+import { BaseToolset } from "./base_toolset.js";
+import {
+  FunctionTool
+} from "./function_tool.js";
+const TOOLBOX_TOOLSET_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
+  "google.adk.toolboxToolset"
+);
+function isToolboxToolset(obj) {
+  return typeof obj === "object" && obj !== null && TOOLBOX_TOOLSET_SIGNATURE_SYMBOL in obj && obj[TOOLBOX_TOOLSET_SIGNATURE_SYMBOL] === true;
+}
+__name(isToolboxToolset, "isToolboxToolset");
+function createUnconfiguredToolboxToolsetClient(serverUrl) {
+  const throwMissingClient = /* @__PURE__ */ __name(() => {
+    throw new Error(
+      `ToolboxToolset requires a ToolboxToolsetClientLike instance (for endpoint "${serverUrl}"). Pass {serverUrl, client} to the ToolboxToolset constructor.`
+    );
+  }, "throwMissingClient");
+  return {
+    loadTool: throwMissingClient,
+    loadToolset: throwMissingClient,
+    close: /* @__PURE__ */ __name(() => {
+    }, "close")
+  };
+}
+__name(createUnconfiguredToolboxToolsetClient, "createUnconfiguredToolboxToolsetClient");
+function isToolOptionsObject(value) {
+  return typeof value === "object" && value !== null && "execute" in value && typeof value.execute === "function";
+}
+__name(isToolOptionsObject, "isToolOptionsObject");
+function wrapLoadedTool(rawTool, prefix) {
+  var _a2;
+  if (isBaseTool(rawTool)) {
+    if (!prefix) {
+      return rawTool;
+    }
+    return Object.assign(
+      Object.create(Object.getPrototypeOf(rawTool)),
+      rawTool,
+      { name: `${prefix}_${rawTool.name}` }
+    );
+  }
+  if (typeof rawTool === "function") {
+    const fn = rawTool;
+    const baseName = fn.name || "toolbox_tool";
+    const name = prefix ? `${prefix}_${baseName}` : baseName;
+    const description = (_a2 = fn.description) != null ? _a2 : "";
+    return new FunctionTool({
+      name,
+      description,
+      execute: fn
+    });
+  }
+  if (isToolOptionsObject(rawTool)) {
+    const baseTool = new FunctionTool(rawTool);
+    if (!prefix) {
+      return baseTool;
+    }
+    return new FunctionTool({
+      ...rawTool,
+      name: `${prefix}_${baseTool.name}`
+    });
+  }
+  throw new TypeError(
+    "Unsupported Toolbox tool shape: expected a BaseTool, ToolOptions object, or function."
+  );
+}
+__name(wrapLoadedTool, "wrapLoadedTool");
+const _ToolboxToolset = class _ToolboxToolset extends (_b = BaseToolset, _a = TOOLBOX_TOOLSET_SIGNATURE_SYMBOL, _b) {
+  constructor(serverUrlOrOptions, extraOptions) {
+    var _a2, _b2, _c, _d;
+    const options = typeof serverUrlOrOptions === "string" ? { serverUrl: serverUrlOrOptions, ...extraOptions } : serverUrlOrOptions;
+    if ((!options.toolNames || options.toolNames.length === 0) && !options.toolsetName) {
+      throw new Error("toolNames and toolsetName cannot both be undefined.");
+    }
+    super((_a2 = options.toolFilter) != null ? _a2 : [], options.prefix);
+    /** A unique symbol to identify ADK ToolboxToolset class. */
+    this[_a] = true;
+    this.serverUrl = options.serverUrl;
+    this.toolsetName = options.toolsetName;
+    this.toolNames = options.toolNames;
+    this.authTokenGetters = (_b2 = options.authTokenGetters) != null ? _b2 : {};
+    this.boundParams = (_c = options.boundParams) != null ? _c : {};
+    this.toolboxClient = (_d = options.client) != null ? _d : createUnconfiguredToolboxToolsetClient(this.serverUrl);
+  }
+  /**
+   * Loads the configured toolset and/or individual tools from the Toolbox
+   * client and returns the selected {@link BaseTool} instances.
+   */
+  async getTools(context) {
+    var _a2, _b2, _c, _d, _e, _f;
+    const loadOptions = {
+      authTokenGetters: this.authTokenGetters,
+      boundParams: this.boundParams
+    };
+    const tools = [];
+    if (this.toolsetName) {
+      const loader = (_c = (_a2 = this.toolboxClient.loadToolset) == null ? void 0 : _a2.bind(this.toolboxClient)) != null ? _c : (_b2 = this.toolboxClient.load_toolset) == null ? void 0 : _b2.bind(this.toolboxClient);
+      if (!loader) {
+        throw new Error(
+          "ToolboxClient does not implement loadToolset or load_toolset."
+        );
+      }
+      const loadedToolset = await loader(this.toolsetName, loadOptions);
+      for (const rawTool of loadedToolset) {
+        tools.push(wrapLoadedTool(rawTool, this.prefix));
+      }
+    }
+    if (this.toolNames && this.toolNames.length > 0) {
+      const loader = (_f = (_d = this.toolboxClient.loadTool) == null ? void 0 : _d.bind(this.toolboxClient)) != null ? _f : (_e = this.toolboxClient.load_tool) == null ? void 0 : _e.bind(this.toolboxClient);
+      if (!loader) {
+        throw new Error(
+          "ToolboxClient does not implement loadTool or load_tool."
+        );
+      }
+      const loadedSingleTools = await Promise.all(
+        this.toolNames.map((toolName) => loader(toolName, loadOptions))
+      );
+      for (const rawTool of loadedSingleTools) {
+        tools.push(wrapLoadedTool(rawTool, this.prefix));
+      }
+    }
+    return tools.filter((tool) => this.isToolSelected(tool, context));
+  }
+  /**
+   * Closes the underlying Toolbox client.
+   */
+  async close() {
+    var _a2, _b2;
+    await ((_b2 = (_a2 = this.toolboxClient).close) == null ? void 0 : _b2.call(_a2));
+  }
+};
+__name(_ToolboxToolset, "ToolboxToolset");
+let ToolboxToolset = _ToolboxToolset;
+export {
+  ToolboxToolset,
+  isToolboxToolset
+};

package/dist/esm/tools/webmcp/webmcp_toolset.js

@@ -41,20 +41,7 @@ const _WebMCPToolset = class _WebMCPToolset extends BaseToolset {
         document: this.doc
       })
     );
-    const filter = this.toolFilter;
-    if (!filter || Array.isArray(filter) && filter.length === 0) {
-      return tools;
-    }
-    if (Array.isArray(filter)) {
-      return tools.filter((tool) => filter.includes(tool.name));
-    }
-    if (context) {
-      return tools.filter((tool) => filter(tool, context));
-    }
-    logger.warn(
-      "WebMCPToolset: a ToolPredicate toolFilter was provided but getTools() was called without a ReadonlyContext. The filter will not be applied."
-    );
-    return tools;
+    return tools.filter((tool) => this.isToolSelected(tool, context));
   }
   /**
    * Subscribes to the WebMCP `toolchange` event, which fires when the page

package/dist/esm/utils/client_labels.js

@@ -99,7 +99,8 @@ function headerEntries(headers) {
 __name(headerEntries, "headerEntries");
 function mergeTrackingHeaders(headers) {
   var _a, _b;
-  const merged = {};
+  const otherHeaders = new Headers();
+  const originalNames = /* @__PURE__ */ new Map();
   const callerValues = /* @__PURE__ */ new Map();
   for (const [name, value] of headerEntries(headers)) {
     const lowerName = name.toLowerCase();
@@ -109,9 +110,25 @@ function mergeTrackingHeaders(headers) {
         value
       ]);
     } else {
-      merged[name] = value;
+      if (!originalNames.has(lowerName)) {
+        originalNames.set(lowerName, name);
+      }
+      otherHeaders.append(name, value);
     }
   }
+  const normalizedEntries = [];
+  otherHeaders.forEach((value, name) => {
+    normalizedEntries.push([name, value]);
+  });
+  const merged = Object.fromEntries(
+    normalizedEntries.map(([name, value]) => {
+      var _a2;
+      return [
+        (_a2 = originalNames.get(name)) != null ? _a2 : name,
+        value
+      ];
+    })
+  );
   for (const [name, trackingValue] of Object.entries(getTrackingHeaders())) {
     const tokens = trackingValue.split(" ");
     for (const value of (_b = callerValues.get(name)) != null ? _b : []) {

package/dist/esm/utils/failover_utils.js

@@ -21,9 +21,9 @@ async function* runWithRouting(items, context, router, runFn) {
   }
   const triedKeys = /* @__PURE__ */ new Set([selectedKey]);
   while (true) {
-    const generatorOrPromise = runFn(selectedItem);
     let firstYielded = false;
     try {
+      const generatorOrPromise = runFn(selectedItem);
       if (isAsyncGenerator(generatorOrPromise)) {
         for await (const result2 of generatorOrPromise) {
           yield result2;

package/dist/esm/utils/gemini_schema_util.js

@@ -177,7 +177,6 @@ const GEMINI_REJECTED_SCHEMA_FIELDS = /* @__PURE__ */ new Set([
   "default",
   "format"
 ]);
-const EMPTY_OBJECT_PLACEHOLDER = "dummy_DO_NOT_GENERATE";
 function toGeminiSchemaField(key) {
   return toSnakeCaseName(key).replace(
     /_([a-z0-9])/g,
@@ -189,6 +188,23 @@ function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 __name(isPlainObject, "isPlainObject");
+function normalizeJsonSchemaType(jsonSchemaType) {
+  if (typeof jsonSchemaType === "string") {
+    if (jsonSchemaType === "null") {
+      return [void 0, true];
+    }
+    return [jsonSchemaType, false];
+  }
+  if (Array.isArray(jsonSchemaType)) {
+    const nullable = jsonSchemaType.includes("null");
+    const nonNullTypes = jsonSchemaType.filter(
+      (t) => typeof t === "string" && t !== "null"
+    );
+    return [nonNullTypes[0], nullable];
+  }
+  return [void 0, false];
+}
+__name(normalizeJsonSchemaType, "normalizeJsonSchemaType");
 function convertSchemaField(field, value) {
   if (field === "type") {
     return toGeminiType(typeof value === "string" ? value : void 0);
@@ -218,14 +234,14 @@ function openApiSchemaToGeminiSchema(openApiSchema) {
     throw new TypeError("openapi_schema must be a dictionary");
   }
   const source = { ...openApiSchema };
+  const [schemaType, nullable] = normalizeJsonSchemaType(source["type"]);
+  source["type"] = schemaType;
+  if (nullable) {
+    source["nullable"] = true;
+  }
   if (!source["type"]) {
     source["type"] = "object";
   }
-  const properties = source["properties"];
-  const hasProperties = isPlainObject(properties) && Object.keys(properties).length > 0;
-  if (source["type"] === "object" && !hasProperties) {
-    source["properties"] = { [EMPTY_OBJECT_PLACEHOLDER]: { type: "string" } };
-  }
   const converted = {};
   for (const [key, value] of Object.entries(source)) {
     const field = toGeminiSchemaField(key);
@@ -238,6 +254,7 @@ function openApiSchemaToGeminiSchema(openApiSchema) {
 }
 __name(openApiSchemaToGeminiSchema, "openApiSchemaToGeminiSchema");
 export {
+  normalizeJsonSchemaType,
   openApiSchemaToGeminiSchema,
   toGeminiSchema
 };

package/dist/esm/utils/logger_node.js

@@ -25,6 +25,10 @@ const _WinstonLogger = class _WinstonLogger {
         "warn": LogLevel.WARN,
         "error": LogLevel.ERROR
       },
+      // `levels` above inverts winston's npm ordering, so `error` (3) is the
+      // most permissive and leaves winston pass-through. Every method already
+      // gates on `this.logLevel`; a lower value here would double-gate and
+      // drop records.
       level: "error",
       format: winston.format.combine(
         winston.format.label({ label: "ADK" }),

package/dist/esm/utils/output_schema_utils.js

@@ -7,10 +7,13 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { isGemini } from "../models/google_llm.js";
 import { isGemini2OrAbove } from "./model_name.js";
 import { getGoogleLlmVariant, GoogleLLMVariant } from "./variant_utils.js";
-function canUseOutputSchemaWithTools(modelString) {
-  return getGoogleLlmVariant() === GoogleLLMVariant.VERTEX_AI && isGemini2OrAbove(modelString);
+function canUseOutputSchemaWithTools(model) {
+  const modelString = typeof model === "string" ? model : model.model;
+  const variant = isGemini(model) ? model.apiBackend : getGoogleLlmVariant();
+  return variant === GoogleLLMVariant.VERTEX_AI && isGemini2OrAbove(modelString);
 }
 __name(canUseOutputSchemaWithTools, "canUseOutputSchemaWithTools");
 export {

package/dist/esm/utils/task.js

@@ -16,7 +16,7 @@ const _Task = class _Task {
       this.isDone = true;
     }, "markDone");
     this.promise = executable(this.abortController.signal);
-    this.promise.then(markDone).catch(markDone);
+    this.promise.then(markDone, markDone);
   }
   /**
    * Cancels the task execution.

package/dist/esm/version.js

@@ -5,7 +5,7 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const version = "2.3.0";
+const version = "2.4.0";
 export {
   version
 };

package/dist/types/agents/agent_engine_client.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface AgentEngineConfig {
+    project: string;
+    location: string;
+    reasoningEngineId: string;
+}
+export interface SessionConfig {
+    userId?: string;
+    sessionId?: string;
+}
+export interface QueryConfig extends SessionConfig {
+    message: unknown;
+    [key: string]: unknown;
+}
+export declare class AgentExecutionError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class AgentEngineClient {
+    private client;
+    private reasoningEnginePath;
+    constructor(config: AgentEngineConfig);
+    /**
+     * Creates a remote session.
+     *
+     * @returns The `create_session` payload returned by the Agent Engine. When
+     *     `config.sessionId` is omitted the engine generates one, and this is the
+     *     only place the caller can read it back from.
+     */
+    createSession(config: SessionConfig): Promise<unknown>;
+    query(config: QueryConfig): Promise<unknown>;
+    streamQuery(config: QueryConfig): AsyncGenerator<unknown, void, unknown>;
+}

package/dist/types/agents/base_agent.d.ts

@@ -224,6 +224,18 @@ export declare abstract class BaseAgent<TConfig extends BaseAgentConfig = BaseAg
      * @return The invocation context for this agent.
      */
     protected createInvocationContext(parentContext: InvocationContext): InvocationContext;
+    /**
+     * The resolved beforeAgentCallback field as a list of SingleAgentCallback.
+     *
+     * This method is only for use by Agent Development Kit.
+     */
+    get canonicalBeforeAgentCallbacks(): SingleAgentCallback[];
+    /**
+     * The resolved afterAgentCallback field as a list of SingleAgentCallback.
+     *
+     * This method is only for use by Agent Development Kit.
+     */
+    get canonicalAfterAgentCallbacks(): SingleAgentCallback[];
     /**
      * Runs the before agent callback if it exists.
      *

package/dist/types/agents/llm_agent.d.ts

@@ -226,7 +226,11 @@ export interface LlmAgentConfig extends BaseAgentConfig {
      */
     contextCompactors?: BaseContextCompactor[];
     /**
-     * Instructs the agent to make a plan and execute it step by step.
+     * Allows the agent to execute code blocks from model responses using the
+     * provided `BaseCodeExecutor`.
+     *
+     * NOTE: to use the model's built-in code executor, use the
+     * `BuiltInCodeExecutor`.
      */
     codeExecutor?: BaseCodeExecutor;
     /**

package/dist/types/agents/processors/content_processor_utils.d.ts

@@ -20,10 +20,12 @@ export declare function removeClientFunctionCallId(content: Content): void;
  * @param agentName: The name of the agent.
  * @param currentBranch: The current branch of the agent.
  * @param currentIsolationScope: The isolation scope of the current node, if any.
+ * @param preserveFunctionCallIds: Whether to preserve client-generated
+ *     `adk-*` function call and response IDs instead of stripping them.
  *
  * @returns A list of processed contents.
  */
-export declare function getContents(events: Event[], agentName: string, currentBranch?: string, currentIsolationScope?: string): Content[];
+export declare function getContents(events: Event[], agentName: string, currentBranch?: string, currentIsolationScope?: string, preserveFunctionCallIds?: boolean): Content[];
 /**
  * Get contents for the current turn only (no conversation history).
  *
@@ -42,7 +44,7 @@ export declare function getContents(events: Event[], agentName: string, currentB
  * @returns A list of contents for the current turn only, preserving context
  *     needed for proper tool execution while excluding conversation history.
  */
-export declare function getCurrentTurnContents(events: Event[], agentName: string, currentBranch?: string, currentIsolationScope?: string): Content[];
+export declare function getCurrentTurnContents(events: Event[], agentName: string, currentBranch?: string, currentIsolationScope?: string, preserveFunctionCallIds?: boolean): Content[];
 /**
  * Merges a list of function_response events into one event.
  *

package/dist/types/agents/processors/nl_planning_processor.d.ts

@@ -19,7 +19,8 @@ export declare class NlPlanningRequestProcessor extends BaseLlmRequestProcessor
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
 }
 /**
- * Replaces the LLM response parts with the planner's processed parts.
+ * Replaces the LLM response parts with the planner's processed parts and emits
+ * a state-update event when the planner modifies session state.
  *
  * Partial responses are processed too.
  */

package/dist/types/cli/utils/logs.d.ts

@@ -26,7 +26,7 @@ export interface LogToTmpFolderOptions {
  *
  * @param level The minimum `LogLevel` to emit. Defaults to `LogLevel.INFO`.
  */
-export declare function logToStderr(level?: LogLevel): void;
+export declare function setupAdkLogger(level?: LogLevel): void;
 /**
  * Configures the global ADK logger to write formatted log records to a timestamped
  * file in the system temporary directory and updates the `<prefix>.latest.log`