@google/adk 1.6.0 → 2.1.0

package/dist/cjs/a2a/part_converter_utils.js

@@ -9,6 +9,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -54,6 +55,7 @@ var DataPartType = /* @__PURE__ */ ((DataPartType2) => {
 function toA2AParts(parts = [], longRunningToolIDs = []) {
   return parts.map((part) => toA2APart(part, longRunningToolIDs));
 }
+__name(toA2AParts, "toA2AParts");
 function toA2APart(part, longRunningToolIDs) {
   if (part.text !== void 0 && part.text !== null) {
     return toA2ATextPart(part);
@@ -63,6 +65,7 @@ function toA2APart(part, longRunningToolIDs) {
   }
   return toA2ADataPart(part, longRunningToolIDs);
 }
+__name(toA2APart, "toA2APart");
 function toA2ATextPart(part) {
   const a2aPart = { kind: "text", text: part.text || "" };
   if (part.thought) {
@@ -72,6 +75,7 @@ function toA2ATextPart(part) {
   }
   return a2aPart;
 }
+__name(toA2ATextPart, "toA2ATextPart");
 function toA2AFilePart(part) {
   const metadata = {};
   if (part.videoMetadata) {
@@ -99,6 +103,7 @@ function toA2AFilePart(part) {
   }
   throw new Error(`Not a file part: ${JSON.stringify(part)}`);
 }
+__name(toA2AFilePart, "toA2AFilePart");
 function toA2ADataPart(part, longRunningToolIDs = []) {
   let dataPartType;
   let data;
@@ -136,13 +141,16 @@ function toA2ADataPart(part, longRunningToolIDs = []) {
     metadata
   };
 }
+__name(toA2ADataPart, "toA2ADataPart");
 function toGenAIContent(a2aMessage) {
   const parts = toGenAIParts(a2aMessage.parts);
   return a2aMessage.role === "user" ? (0, import_genai.createUserContent)(parts) : (0, import_genai.createModelContent)(parts);
 }
+__name(toGenAIContent, "toGenAIContent");
 function toGenAIParts(a2aParts) {
   return a2aParts.map((a2aPart) => toGenAIPart(a2aPart));
 }
+__name(toGenAIParts, "toGenAIParts");
 function toGenAIPart(a2aPart) {
   if (a2aPart.kind === "text") {
     return toGenAIPartText(a2aPart);
@@ -155,6 +163,7 @@ function toGenAIPart(a2aPart) {
   }
   throw new Error(`Unknown part kind: ${JSON.stringify(a2aPart)}`);
 }
+__name(toGenAIPart, "toGenAIPart");
 function toGenAIPartText(a2aPart) {
   var _a;
   return {
@@ -162,6 +171,7 @@ function toGenAIPartText(a2aPart) {
     thought: !!((_a = a2aPart.metadata) == null ? void 0 : _a[import_metadata_converter_utils.A2AMetadataKeys.THOUGHT])
   };
 }
+__name(toGenAIPartText, "toGenAIPartText");
 function toGenAIPartFile(a2aPart) {
   var _a;
   const part = {};
@@ -184,6 +194,7 @@ function toGenAIPartFile(a2aPart) {
   }
   throw new Error(`Not a file part: ${JSON.stringify(a2aPart)}`);
 }
+__name(toGenAIPartFile, "toGenAIPartFile");
 function toGenAIPartData(a2aPart) {
   var _a;
   if (!a2aPart.data) {
@@ -207,6 +218,7 @@ function toGenAIPartData(a2aPart) {
     text: JSON.stringify(a2aPart.data)
   };
 }
+__name(toGenAIPartData, "toGenAIPartData");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   toA2ADataPart,

package/dist/cjs/a2a/request_metadata.js

@@ -0,0 +1,94 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var request_metadata_exports = {};
+__export(request_metadata_exports, {
+  AdkDefaultRequestHandler: () => AdkDefaultRequestHandler,
+  getA2aRequestMetadata: () => getA2aRequestMetadata
+});
+module.exports = __toCommonJS(request_metadata_exports);
+var import_server = require("@a2a-js/sdk/server");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const requestMetadataStore = /* @__PURE__ */ new Map();
+function getA2aRequestMetadata(ctx) {
+  var _a, _b;
+  const reqContext = ctx;
+  if ((_a = reqContext.request) == null ? void 0 : _a.metadata) {
+    return reqContext.request.metadata;
+  }
+  const messageId = (_b = ctx.userMessage) == null ? void 0 : _b.messageId;
+  if (messageId && requestMetadataStore.has(messageId)) {
+    return requestMetadataStore.get(messageId);
+  }
+  return void 0;
+}
+__name(getA2aRequestMetadata, "getA2aRequestMetadata");
+const _AdkDefaultRequestHandler = class _AdkDefaultRequestHandler extends import_server.DefaultRequestHandler {
+  async sendMessage(params, context) {
+    var _a;
+    const messageId = (_a = params.message) == null ? void 0 : _a.messageId;
+    if (messageId && params.metadata) {
+      requestMetadataStore.set(
+        messageId,
+        params.metadata
+      );
+    }
+    try {
+      return await super.sendMessage(params, context);
+    } finally {
+      if (messageId) {
+        requestMetadataStore.delete(messageId);
+      }
+    }
+  }
+  async *sendMessageStream(params, context) {
+    var _a;
+    const messageId = (_a = params.message) == null ? void 0 : _a.messageId;
+    if (messageId && params.metadata) {
+      requestMetadataStore.set(
+        messageId,
+        params.metadata
+      );
+    }
+    try {
+      yield* super.sendMessageStream(params, context);
+    } finally {
+      if (messageId) {
+        requestMetadataStore.delete(messageId);
+      }
+    }
+  }
+};
+__name(_AdkDefaultRequestHandler, "AdkDefaultRequestHandler");
+let AdkDefaultRequestHandler = _AdkDefaultRequestHandler;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AdkDefaultRequestHandler,
+  getA2aRequestMetadata
+});

package/dist/cjs/agents/active_streaming_tool.js

@@ -9,6 +9,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -33,7 +34,7 @@ var import_task = require("../utils/task.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class ActiveStreamingTool {
+const _ActiveStreamingTool = class _ActiveStreamingTool {
   constructor(params = {}) {
     if (params.task instanceof Promise) {
       this.task = new import_task.Task(() => params.task);
@@ -42,7 +43,9 @@ class ActiveStreamingTool {
     }
     this.stream = params.stream;
   }
-}
+};
+__name(_ActiveStreamingTool, "ActiveStreamingTool");
+let ActiveStreamingTool = _ActiveStreamingTool;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActiveStreamingTool

package/dist/cjs/agents/base_agent.js

@@ -9,6 +9,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -32,6 +33,7 @@ module.exports = __toCommonJS(base_agent_exports);
 var import_api = require("@opentelemetry/api");
 var import_event = require("../events/event.js");
 var import_tracing = require("../telemetry/tracing.js");
+var import_base_node = require("../workflow/base_node.js");
 var import_context = require("./context.js");
 var import_invocation_context = require("./invocation_context.js");
 /**
@@ -39,21 +41,21 @@ var import_invocation_context = require("./invocation_context.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-var _a;
-const BASE_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.baseAgent");
+var _a, _b;
+const BASE_AGENT_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.baseAgent");
 function isBaseAgent(obj) {
   return typeof obj === "object" && obj !== null && BASE_AGENT_SIGNATURE_SYMBOL in obj && obj[BASE_AGENT_SIGNATURE_SYMBOL] === true;
 }
-_a = BASE_AGENT_SIGNATURE_SYMBOL;
-class BaseAgent {
+__name(isBaseAgent, "isBaseAgent");
+const _BaseAgent = class _BaseAgent extends (_b = import_base_node.BaseNode, _a = BASE_AGENT_SIGNATURE_SYMBOL, _b) {
   constructor(config) {
+    super({ ...config, name: validateAgentName(config.name) });
     /**
      * A unique symbol to identify ADK agent classes.
      */
     this[_a] = true;
     this.config = { ...config };
     this.name = validateAgentName(config.name);
-    this.description = config.description;
     this.parentAgent = config.parentAgent;
     this.subAgents = config.subAgents || [];
     this.beforeAgentCallback = getCannonicalCallback(
@@ -62,6 +64,10 @@ class BaseAgent {
     this.afterAgentCallback = getCannonicalCallback(config.afterAgentCallback);
     this.setParentAgentForSubAgents();
   }
+  // `description` is inherited from BaseNode, which declares it `string` and
+  // defaults it to ''. It used to be `string | undefined` here; every consumer
+  // already coalesced (`agent.description || ''`), so the default is
+  // equivalent for them.
   /**
    * Root agent of this agent.
    * Computed dynamically by traversing up the parent chain.
@@ -72,15 +78,16 @@ class BaseAgent {
   /**
    * Creates a copy of this agent with the given config fields overridden.
    *
-   * Mirrors adk-python's `BaseAgent.clone(update=...)`. The clone is a detached
-   * root: its `parentAgent` is always `undefined`. Sub-agents are recursively
-   * cloned (and re-parented to the clone) unless `subAgents` is overridden.
-   * Rebuilding via the concrete constructor re-derives all state, so a cloned
-   * `LlmAgent` gets a fresh `requestProcessors` array rather than sharing the
-   * original's. See google/adk-js#534.
+   * The clone is a detached root: its `parentAgent` is always `undefined`.
+   * Sub-agents are recursively cloned (and re-parented to the clone) unless
+   * `subAgents` is overridden. Rebuilding via the concrete constructor
+   * re-derives all state, so a cloned `LlmAgent` gets a fresh
+   * `requestProcessors` array rather than sharing the original's.
+   * See google/adk-js#534.
    *
    * @param overrides Config fields to override on the clone. Overriding
-   *     `parentAgent` is rejected, matching adk-python.
+   *     `parentAgent` is rejected: parentage is assigned only when a parent
+   *     agent is constructed with its sub-agents.
    * @returns A new detached agent instance of the same concrete class.
    */
   clone(overrides) {
@@ -122,7 +129,7 @@ class BaseAgent {
         ctx,
         this,
         async function* () {
-          var _a2, _b;
+          var _a2, _b2;
           const context2 = this.createInvocationContext(parentContext);
           const beforeAgentCallbackEvent = await this.handleBeforeAgentCallback(context2);
           if (beforeAgentCallbackEvent) {
@@ -135,7 +142,7 @@ class BaseAgent {
           for await (const event of this.runAsyncImpl(context2)) {
             yield event;
           }
-          if (context2.endInvocation || ((_b = parentContext.abortSignal) == null ? void 0 : _b.aborted)) {
+          if (context2.endInvocation || ((_b2 = parentContext.abortSignal) == null ? void 0 : _b2.aborted)) {
             return;
           }
           const afterAgentCallbackEvent = await this.handleAfterAgentCallback(context2);
@@ -148,6 +155,31 @@ class BaseAgent {
       span.end();
     }
   }
+  /**
+   * Runs this agent as a workflow node.
+   *
+   * The node runner calls this; it delegates to {@link runAsync}, so an agent
+   * behaves identically whether it is run directly or as a node. Mirrors
+   * adk-python `BaseAgent._run_impl`.
+   *
+   * The invocation context comes from {@link NodeContext.getInvocationContext}
+   * rather than the raw field, so the agent runs against whatever view of the
+   * session the workflow wants it to see.
+   *
+   * Unlike adk-python's `_run_impl`, nothing is stamped onto the events here.
+   * Python has to fix up the author and the node path because it authors
+   * in-workflow events as the workflow itself; the TypeScript node runner
+   * already owns both (`enrichEvent` keeps an author the node set, and always
+   * stamps the true node path), so repeating it would be dead code.
+   *
+   * `nodeInput` is intentionally unused: an agent's input is its conversation,
+   * which the workflow supplies through the session. A node that needs to read
+   * its input — an `LlmAgent` injecting it into the prompt, say — does so in
+   * its own wrapper.
+   */
+  async *runImpl(ctx, _nodeInput) {
+    yield* this.runAsync(ctx.getInvocationContext());
+  }
   /**
    * Entry method to run an agent via video/audio-based conversation.
    *
@@ -163,7 +195,7 @@ class BaseAgent {
         ctx,
         this,
         async function* () {
-          var _a2, _b;
+          var _a2, _b2;
           const context2 = this.createInvocationContext(parentContext);
           const beforeAgentCallbackEvent = await this.handleBeforeAgentCallback(context2);
           if (beforeAgentCallbackEvent) {
@@ -175,7 +207,7 @@ class BaseAgent {
           for await (const event of this.runLiveImpl(context2)) {
             yield event;
           }
-          if (context2.endInvocation || ((_b = parentContext.abortSignal) == null ? void 0 : _b.aborted)) {
+          if (context2.endInvocation || ((_b2 = parentContext.abortSignal) == null ? void 0 : _b2.aborted)) {
             return;
           }
           const afterAgentCallbackEvent = await this.handleAfterAgentCallback(context2);
@@ -314,7 +346,9 @@ class BaseAgent {
       subAgent.parentAgent = this;
     }
   }
-}
+};
+__name(_BaseAgent, "BaseAgent");
+let BaseAgent = _BaseAgent;
 function validateAgentName(name) {
   if (!isIdentifier(name)) {
     throw new Error(
@@ -328,21 +362,25 @@ function validateAgentName(name) {
   }
   return name;
 }
+__name(validateAgentName, "validateAgentName");
 function isIdentifier(str) {
   return /^[\p{ID_Start}$_][\p{ID_Continue}$_-]*$/u.test(str);
 }
+__name(isIdentifier, "isIdentifier");
 function getRootAgent(rootAgent) {
   while (rootAgent.parentAgent) {
     rootAgent = rootAgent.parentAgent;
   }
   return rootAgent;
 }
+__name(getRootAgent, "getRootAgent");
 function getCannonicalCallback(callbacks) {
   if (!callbacks) {
     return [];
   }
   return Array.isArray(callbacks) ? callbacks : [callbacks];
 }
+__name(getCannonicalCallback, "getCannonicalCallback");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BaseAgent,

package/dist/cjs/agents/context.js

@@ -9,6 +9,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -37,7 +38,7 @@ var import_readonly_context = require("./readonly_context.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class Context extends import_readonly_context.ReadonlyContext {
+const _Context = class _Context extends import_readonly_context.ReadonlyContext {
   /**
    * @param options The configuration options for the Context.
    * @param options.invocationContext The invocation context.
@@ -49,8 +50,14 @@ class Context extends import_readonly_context.ReadonlyContext {
    *     call.
    * @param options.toolConfirmation The tool confirmation of the current tool
    *     call.
+   * @param options.resumeInputs The inputs the current tool call is being
+   *     resumed with, if it paused to ask for them, keyed by interrupt id.
+   *     Defaults to empty rather than absent, matching adk-python's
+   *     `Context.resume_inputs`. Carries no approval; see
+   *     {@link ResumeInputs}.
    */
   constructor(options) {
+    var _a;
     super(options.invocationContext);
     this.eventActions = options.eventActions || (0, import_event_actions.createEventActions)();
     this._state = new import_state.State(
@@ -59,6 +66,7 @@ class Context extends import_readonly_context.ReadonlyContext {
     );
     this.functionCallId = options.functionCallId;
     this.toolConfirmation = options.toolConfirmation;
+    this.resumeInputs = (_a = options.resumeInputs) != null ? _a : {};
     this.abortSignal = options.invocationContext.abortSignal;
   }
   /**
@@ -163,7 +171,9 @@ class Context extends import_readonly_context.ReadonlyContext {
       payload
     });
   }
-}
+};
+__name(_Context, "Context");
+let Context = _Context;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Context

package/dist/cjs/agents/framework_function_calls.js

@@ -0,0 +1,64 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var framework_function_calls_exports = {};
+__export(framework_function_calls_exports, {
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME: () => REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  REQUEST_CREDENTIAL_FUNCTION_CALL_NAME: () => REQUEST_CREDENTIAL_FUNCTION_CALL_NAME,
+  REQUEST_INPUT_FUNCTION_CALL_NAME: () => REQUEST_INPUT_FUNCTION_CALL_NAME,
+  reservedFunctionCallName: () => reservedFunctionCallName
+});
+module.exports = __toCommonJS(framework_function_calls_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const REQUEST_CONFIRMATION_FUNCTION_CALL_NAME = "adk_request_confirmation";
+const REQUEST_CREDENTIAL_FUNCTION_CALL_NAME = "adk_request_credential";
+const REQUEST_INPUT_FUNCTION_CALL_NAME = "adk_request_input";
+const RESERVED_FUNCTION_CALL_NAMES = /* @__PURE__ */ new Set([
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  REQUEST_CREDENTIAL_FUNCTION_CALL_NAME,
+  REQUEST_INPUT_FUNCTION_CALL_NAME
+]);
+function reservedFunctionCallName(content) {
+  var _a, _b;
+  for (const part of (_a = content == null ? void 0 : content.parts) != null ? _a : []) {
+    const name = (_b = part.functionCall) == null ? void 0 : _b.name;
+    if (name && RESERVED_FUNCTION_CALL_NAMES.has(name)) {
+      return name;
+    }
+  }
+  return void 0;
+}
+__name(reservedFunctionCallName, "reservedFunctionCallName");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  REQUEST_CREDENTIAL_FUNCTION_CALL_NAME,
+  REQUEST_INPUT_FUNCTION_CALL_NAME,
+  reservedFunctionCallName
+});