@google/adk 1.5.0 → 2.0.0

package/dist/esm/a2a/event_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
@@ -43,34 +45,38 @@ function toA2AMessage(event, {
     metadata: getA2AEventMetadata(event, { appName, userId, sessionId })
   };
 }
-function toAdkEvent(event, invocationId, agentName) {
+__name(toA2AMessage, "toA2AMessage");
+function toAdkEvent(event, invocationId, agentName, branch) {
   if (isMessage(event)) {
-    return messageToAdkEvent(event, invocationId, agentName);
+    return messageToAdkEvent(event, invocationId, agentName, branch);
   }
   if (isTask(event)) {
-    return taskToAdkEvent(event, invocationId, agentName);
+    return taskToAdkEvent(event, invocationId, agentName, branch);
   }
   if (isTaskArtifactUpdateEvent(event)) {
-    return artifactUpdateToAdkEvent(event, invocationId, agentName);
+    return artifactUpdateToAdkEvent(event, invocationId, agentName, branch);
   }
   if (isTaskStatusUpdateEvent(event)) {
-    return event.final ? finalTaskStatusUpdateToAdkEvent(event, invocationId, agentName) : taskStatusUpdateToAdkEvent(event, invocationId, agentName);
+    return event.final ? finalTaskStatusUpdateToAdkEvent(event, invocationId, agentName, branch) : taskStatusUpdateToAdkEvent(event, invocationId, agentName, branch);
   }
   return void 0;
 }
-function messageToAdkEvent(msg, invocationId, agentName) {
+__name(toAdkEvent, "toAdkEvent");
+function messageToAdkEvent(msg, invocationId, agentName, branch) {
   const parts = toGenAIParts(msg.parts);
   const content = parts.length === 0 ? void 0 : msg.role === MessageRole.USER ? createUserContent(parts) : createModelContent(parts);
   return {
     ...createAdkEventFromMetadata(msg),
     invocationId,
     author: msg.role === MessageRole.USER ? MessageRole.USER : agentName,
+    branch,
     content,
     turnComplete: true,
     partial: false
   };
 }
-function artifactUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
+__name(messageToAdkEvent, "messageToAdkEvent");
+function artifactUpdateToAdkEvent(a2aEvent, invocationId, agentName, branch) {
   var _a;
   const partsToConvert = ((_a = a2aEvent.artifact) == null ? void 0 : _a.parts) || [];
   if (partsToConvert.length === 0) {
@@ -81,12 +87,14 @@ function artifactUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
     ...createAdkEventFromMetadata(a2aEvent),
     invocationId,
     author: agentName,
+    branch,
     content: createModelContent(toGenAIParts(partsToConvert)),
     longRunningToolIds: getLongRunningToolIDs(partsToConvert),
     partial
   };
 }
-function finalTaskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
+__name(artifactUpdateToAdkEvent, "artifactUpdateToAdkEvent");
+function finalTaskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName, branch) {
   var _a;
   const partsToConvert = ((_a = a2aEvent.status.message) == null ? void 0 : _a.parts) || [];
   if (partsToConvert.length === 0) {
@@ -99,13 +107,15 @@ function finalTaskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
     ...createAdkEventFromMetadata(a2aEvent),
     invocationId,
     author: agentName,
+    branch,
     errorMessage: isFailedTask ? getFailedTaskStatusUpdateEventError(a2aEvent) : void 0,
     content: hasContent ? createModelContent(parts) : void 0,
     longRunningToolIds: getLongRunningToolIDs(partsToConvert),
     turnComplete: true
   };
 }
-function taskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
+__name(finalTaskStatusUpdateToAdkEvent, "finalTaskStatusUpdateToAdkEvent");
+function taskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName, branch) {
   const msg = a2aEvent.status.message;
   if (!msg) {
     return void 0;
@@ -118,12 +128,14 @@ function taskStatusUpdateToAdkEvent(a2aEvent, invocationId, agentName) {
     ...createAdkEventFromMetadata(a2aEvent),
     invocationId,
     author: agentName,
+    branch,
     content: createModelContent(parts),
     turnComplete: false,
     partial: true
   };
 }
-function taskToAdkEvent(a2aTask, invocationId, agentName) {
+__name(taskStatusUpdateToAdkEvent, "taskStatusUpdateToAdkEvent");
+function taskToAdkEvent(a2aTask, invocationId, agentName, branch) {
   var _a, _b;
   const parts = [];
   const longRunningToolIds = [];
@@ -151,16 +163,27 @@ function taskToAdkEvent(a2aTask, invocationId, agentName) {
     ...createAdkEventFromMetadata(a2aTask),
     invocationId,
     author: agentName,
+    branch,
     content: isFailed ? void 0 : createModelContent(parts),
     errorMessage: isFailed ? getFailedTaskStatusUpdateEventError(a2aTask) : void 0,
     longRunningToolIds,
     turnComplete: isTerminal
   };
 }
+__name(taskToAdkEvent, "taskToAdkEvent");
+const PEER_SETTABLE_ACTION_FIELDS = /* @__PURE__ */ new Set(["escalate"]);
 function createAdkEventFromMetadata(a2aEvent) {
   const metadata = a2aEvent.metadata || {};
   return createEvent({
-    branch: metadata[A2AMetadataKeys.BRANCH],
+    // `branch` is intentionally NOT restored from peer metadata here (unlike
+    // the other fields below): it is the mechanism getContents() (see
+    // content_processor_utils.ts) uses to keep sibling sub-agent branches'
+    // conversation contexts isolated from each other. A remote A2A peer that
+    // controls its own outgoing metadata could otherwise forge `adk_branch`
+    // (set it to a shared ancestor branch, or omit it) to leak its content
+    // into an unrelated sibling agent's LLM context. Every caller of the
+    // `*ToAdkEvent` functions in this file force-sets `branch` from its own
+    // local `InvocationContext` instead, the same way `author` is handled.
     author: metadata[A2AMetadataKeys.AUTHOR],
     partial: metadata[A2AMetadataKeys.PARTIAL],
     errorCode: metadata[A2AMetadataKeys.ERROR_CODE],
@@ -169,12 +192,24 @@ function createAdkEventFromMetadata(a2aEvent) {
     groundingMetadata: metadata[A2AMetadataKeys.GROUNDING_METADATA],
     usageMetadata: metadata[A2AMetadataKeys.USAGE_METADATA],
     customMetadata: metadata[A2AMetadataKeys.CUSTOM_METADATA],
-    actions: createEventActions({
-      escalate: !!metadata[A2AMetadataKeys.ESCALATE],
-      transferToAgent: metadata[A2AMetadataKeys.TRANSFER_TO_AGENT]
-    })
+    // Only fields in PEER_SETTABLE_ACTION_FIELDS may be restored from
+    // metadata a remote A2A peer controls. Every other action field either
+    // mutates the caller's own session or drives the caller's own control
+    // flow (e.g. `transferToAgent`, see llm_agent.ts), so it must never be
+    // rebuilt from peer-supplied data. Filtering through an allowlist here
+    // (rather than just omitting the unsafe field) means a future action
+    // field is unsafe-by-default: adding it to `candidateActions` alone
+    // does nothing until it's also added to the allowlist.
+    actions: createEventActions(
+      Object.fromEntries(
+        Object.entries({
+          escalate: !!metadata[A2AMetadataKeys.ESCALATE]
+        }).filter(([key]) => PEER_SETTABLE_ACTION_FIELDS.has(key))
+      )
+    )
   });
 }
+__name(createAdkEventFromMetadata, "createAdkEventFromMetadata");
 function getLongRunningToolIDs(parts) {
   const ids = [];
   for (const a2aPart of parts) {
@@ -187,6 +222,7 @@ function getLongRunningToolIDs(parts) {
   }
   return ids;
 }
+__name(getLongRunningToolIDs, "getLongRunningToolIDs");
 export {
   toA2AMessage,
   toAdkEvent

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
 };