@google/adk 1.6.0 → 2.0.0

package/dist/esm/a2a/event_processor_utils.js

@@ -1,10 +1,16 @@
 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
  */
+import {
+  getPendingUserInputRequests,
+  getUserInputRequests
+} from "../agents/user_input_request.js";
 import { createEventActions } from "../events/event_actions.js";
 import {
   createInputMissingErrorEvent,
@@ -58,6 +64,7 @@ function getFinalTaskStatusUpdate(adkEvents, context) {
     }
   });
 }
+__name(getFinalTaskStatusUpdate, "getFinalTaskStatusUpdate");
 function scanForInputRequiredEvents(adkEvents, context) {
   var _a, _b;
   const inputRequiredParts = [];
@@ -95,6 +102,7 @@ function scanForInputRequiredEvents(adkEvents, context) {
   }
   return void 0;
 }
+__name(scanForInputRequiredEvents, "scanForInputRequiredEvents");
 function getLongRunnningFunctionCallId(genAIPart, longRunningToolIds = [], inputRequiredParts = []) {
   var _a, _b, _c;
   const functionCallId = (_a = genAIPart.functionCall) == null ? void 0 : _a.id;
@@ -115,47 +123,79 @@ function getLongRunnningFunctionCallId(genAIPart, longRunningToolIds = [], input
   }
   return;
 }
-function getTaskInputRequiredEvent(task, genAIContent) {
-  var _a;
-  if (!task || !isInputRequiredTaskStatusUpdateEvent(task) || !task.status.message) {
+__name(getLongRunnningFunctionCallId, "getLongRunnningFunctionCallId");
+function getUnansweredRequestEvent(options) {
+  var _a, _b, _c;
+  const { taskId, contextId, task, sessionEvents, genAIContent } = options;
+  const pending = pendingRequestParts(task, sessionEvents);
+  const answered = new Set(
+    ((_a = genAIContent == null ? void 0 : genAIContent.parts) != null ? _a : []).map((part) => {
+      var _a2;
+      return (_a2 = part.functionResponse) == null ? void 0 : _a2.id;
+    }).filter((id) => !!id)
+  );
+  const missingId = [...pending.keys()].find((id) => !answered.has(id));
+  if (!missingId) {
     return void 0;
   }
-  const statusMsg = task.status.message;
-  const taskParts = toGenAIParts(statusMsg.parts);
-  for (const taskPart of taskParts) {
-    const functionCallId = (_a = taskPart.functionCall) == null ? void 0 : _a.id;
-    if (!functionCallId) {
-      continue;
+  return createInputMissingErrorEvent({
+    taskId: (_b = task == null ? void 0 : task.id) != null ? _b : taskId,
+    contextId: (_c = task == null ? void 0 : task.contextId) != null ? _c : contextId,
+    parts: [
+      ...toA2AParts([...pending.values()]),
+      {
+        kind: "text",
+        text: `No input provided for function call id ${missingId}`,
+        metadata: {
+          validation_error: true
+        }
+      }
+    ]
+  });
+}
+__name(getUnansweredRequestEvent, "getUnansweredRequestEvent");
+function pendingRequestParts(task, sessionEvents) {
+  var _a, _b, _c, _d, _e, _f;
+  const pending = /* @__PURE__ */ new Map();
+  if (task && isInputRequiredTaskStatusUpdateEvent(task) && task.status.message) {
+    for (const part of toGenAIParts(task.status.message.parts)) {
+      if ((_a = part.functionCall) == null ? void 0 : _a.id) {
+        pending.set(part.functionCall.id, part);
+      }
     }
-    const hasMatchingResponse = ((genAIContent == null ? void 0 : genAIContent.parts) || []).some(
-      (p) => {
-        var _a2;
-        return ((_a2 = p.functionResponse) == null ? void 0 : _a2.id) === functionCallId;
+  }
+  const pendingIds = new Set(
+    getPendingUserInputRequests(sessionEvents).map(
+      (request) => request.interruptId
+    )
+  );
+  for (const event of sessionEvents) {
+    for (const part of (_c = (_b = event.content) == null ? void 0 : _b.parts) != null ? _c : []) {
+      const id = interruptIdOfPart(event, part);
+      if (id && pendingIds.has(id)) {
+        pending.set(id, part);
       }
-    );
-    if (!hasMatchingResponse) {
-      return createInputMissingErrorEvent({
-        taskId: task.id,
-        contextId: task.contextId,
-        parts: [
-          ...statusMsg.parts.filter((p) => {
-            var _a2;
-            return !((_a2 = p.metadata) == null ? void 0 : _a2.validation_error);
-          }),
-          {
-            kind: "text",
-            text: `No input provided for function call id ${functionCallId}`,
-            metadata: {
-              validation_error: true
-            }
-          }
-        ]
-      });
     }
   }
-  return void 0;
+  for (const event of sessionEvents) {
+    for (const part of (_e = (_d = event.content) == null ? void 0 : _d.parts) != null ? _e : []) {
+      if ((_f = part.functionResponse) == null ? void 0 : _f.id) {
+        pending.delete(part.functionResponse.id);
+      }
+    }
+  }
+  return pending;
+}
+__name(pendingRequestParts, "pendingRequestParts");
+function interruptIdOfPart(event, part) {
+  if (!part.functionCall) {
+    return void 0;
+  }
+  const [request] = getUserInputRequests({ ...event, content: { parts: [part] } });
+  return request == null ? void 0 : request.interruptId;
 }
+__name(interruptIdOfPart, "interruptIdOfPart");
 export {
   getFinalTaskStatusUpdate,
-  getTaskInputRequiredEvent
+  getUnansweredRequestEvent
 };

package/dist/esm/a2a/executor_context.js

@@ -1,5 +1,7 @@
 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
@@ -20,6 +22,7 @@ function createExecutorContext({
     requestContext
   };
 }
+__name(createExecutorContext, "createExecutorContext");
 export {
   createExecutorContext
 };

package/dist/esm/a2a/index.js

@@ -0,0 +1,20 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AGENT_CARD_PATH, RemoteA2AAgent } from "./a2a_remote_agent.js";
+import { getA2AAgentCard } from "./agent_card.js";
+import { A2AAgentExecutor } from "./agent_executor.js";
+import { toA2a } from "./agent_to_a2a.js";
+import { bearerTokenUserBuilder } from "./auth.js";
+export {
+  A2AAgentExecutor,
+  AGENT_CARD_PATH,
+  RemoteA2AAgent,
+  bearerTokenUserBuilder,
+  getA2AAgentCard,
+  toA2a
+};

package/dist/esm/a2a/metadata_converter_utils.js

@@ -1,5 +1,7 @@
 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
@@ -41,6 +43,7 @@ function getAdkEventMetadata(a2aEvent) {
     [AdkMetadataKeys.CONTEXT_ID]: a2aEvent.contextId
   };
 }
+__name(getAdkEventMetadata, "getAdkEventMetadata");
 function getA2AEventMetadata(adkEvent, {
   appName,
   userId,
@@ -66,6 +69,7 @@ function getA2AEventMetadata(adkEvent, {
     [A2AMetadataKeys.IS_LONG_RUNNING]: (adkEvent.longRunningToolIds || []).length > 0
   };
 }
+__name(getA2AEventMetadata, "getA2AEventMetadata");
 function getA2ASessionMetadata({
   appName,
   userId,
@@ -77,12 +81,14 @@ function getA2ASessionMetadata({
     [A2AMetadataKeys.SESSION_ID]: sessionId
   };
 }
+__name(getA2ASessionMetadata, "getA2ASessionMetadata");
 function getA2AEventMetadataFromActions(actions) {
   return {
     [A2AMetadataKeys.ESCALATE]: actions.escalate,
     [A2AMetadataKeys.TRANSFER_TO_AGENT]: actions.transferToAgent
   };
 }
+__name(getA2AEventMetadataFromActions, "getA2AEventMetadataFromActions");
 export {
   A2AMetadataKeys,
   AdkMetadataKeys,

package/dist/esm/a2a/part_converter_utils.js

@@ -1,5 +1,7 @@
 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
@@ -20,6 +22,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);
@@ -29,6 +32,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) {
@@ -38,6 +42,7 @@ function toA2ATextPart(part) {
   }
   return a2aPart;
 }
+__name(toA2ATextPart, "toA2ATextPart");
 function toA2AFilePart(part) {
   const metadata = {};
   if (part.videoMetadata) {
@@ -65,6 +70,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;
@@ -102,13 +108,16 @@ function toA2ADataPart(part, longRunningToolIDs = []) {
     metadata
   };
 }
+__name(toA2ADataPart, "toA2ADataPart");
 function toGenAIContent(a2aMessage) {
   const parts = toGenAIParts(a2aMessage.parts);
   return a2aMessage.role === "user" ? createUserContent(parts) : 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);
@@ -121,6 +130,7 @@ function toGenAIPart(a2aPart) {
   }
   throw new Error(`Unknown part kind: ${JSON.stringify(a2aPart)}`);
 }
+__name(toGenAIPart, "toGenAIPart");
 function toGenAIPartText(a2aPart) {
   var _a;
   return {
@@ -128,6 +138,7 @@ function toGenAIPartText(a2aPart) {
     thought: !!((_a = a2aPart.metadata) == null ? void 0 : _a[A2AMetadataKeys.THOUGHT])
   };
 }
+__name(toGenAIPartText, "toGenAIPartText");
 function toGenAIPartFile(a2aPart) {
   var _a;
   const part = {};
@@ -150,6 +161,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) {
@@ -173,6 +185,7 @@ function toGenAIPartData(a2aPart) {
     text: JSON.stringify(a2aPart.data)
   };
 }
+__name(toGenAIPartData, "toGenAIPartData");
 export {
   toA2ADataPart,
   toA2AFilePart,

package/dist/esm/agents/active_streaming_tool.js

@@ -1,12 +1,14 @@
 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 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Task } from "../utils/task.js";
-class ActiveStreamingTool {
+const _ActiveStreamingTool = class _ActiveStreamingTool {
   constructor(params = {}) {
     if (params.task instanceof Promise) {
       this.task = new Task(() => params.task);
@@ -15,7 +17,9 @@ class ActiveStreamingTool {
     }
     this.stream = params.stream;
   }
-}
+};
+__name(_ActiveStreamingTool, "ActiveStreamingTool");
+let ActiveStreamingTool = _ActiveStreamingTool;
 export {
   ActiveStreamingTool
 };

package/dist/esm/agents/base_agent.js

@@ -1,11 +1,13 @@
 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 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-var _a;
+var _a, _b;
 import { context, trace } from "@opentelemetry/api";
 import { createEvent } from "../events/event.js";
 import {
@@ -13,22 +15,23 @@ import {
   traceAgentInvocation,
   tracer
 } from "../telemetry/tracing.js";
+import { BaseNode } from "../workflow/base_node.js";
 import { Context } from "./context.js";
 import { InvocationContext } from "./invocation_context.js";
 const BASE_AGENT_SIGNATURE_SYMBOL = 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 = 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(
@@ -37,6 +40,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.
@@ -97,7 +104,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) {
@@ -110,7 +117,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);
@@ -123,6 +130,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.
    *
@@ -138,7 +170,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) {
@@ -150,7 +182,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);
@@ -289,7 +321,9 @@ class BaseAgent {
       subAgent.parentAgent = this;
     }
   }
-}
+};
+__name(_BaseAgent, "BaseAgent");
+let BaseAgent = _BaseAgent;
 function validateAgentName(name) {
   if (!isIdentifier(name)) {
     throw new Error(
@@ -303,21 +337,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");
 export {
   BaseAgent,
   getCannonicalCallback,

package/dist/esm/agents/context.js

@@ -1,5 +1,7 @@
 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 2025 Google LLC
@@ -10,7 +12,7 @@ import { createEventActions } from "../events/event_actions.js";
 import { State } from "../sessions/state.js";
 import { ToolConfirmation } from "../tools/tool_confirmation.js";
 import { ReadonlyContext } from "./readonly_context.js";
-class Context extends ReadonlyContext {
+const _Context = class _Context extends ReadonlyContext {
   /**
    * @param options The configuration options for the Context.
    * @param options.invocationContext The invocation context.
@@ -136,7 +138,9 @@ class Context extends ReadonlyContext {
       payload
     });
   }
-}
+};
+__name(_Context, "Context");
+let Context = _Context;
 export {
   Context
 };

package/dist/esm/agents/framework_function_calls.js

@@ -0,0 +1,34 @@
+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
+ */
+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");
+export {
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  REQUEST_CREDENTIAL_FUNCTION_CALL_NAME,
+  REQUEST_INPUT_FUNCTION_CALL_NAME,
+  reservedFunctionCallName
+};