@google/adk 1.6.0 → 2.0.0

package/dist/esm/agents/processors/tool_filter_request_processor.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
@@ -9,7 +11,7 @@ import { Context } from "../context.js";
 import { isLlmAgent } from "../llm_agent.js";
 import { ReadonlyContext } from "../readonly_context.js";
 import { BaseLlmRequestProcessor } from "./base_llm_processor.js";
-class ToolFilterRequestProcessor extends BaseLlmRequestProcessor {
+const _ToolFilterRequestProcessor = class _ToolFilterRequestProcessor extends BaseLlmRequestProcessor {
   /**
    * Invokes plugin-based tool filtering and updates {@link LlmRequest.allowedTools}
    * with the reduced tool set if any plugin returns a filtered result.
@@ -42,7 +44,9 @@ class ToolFilterRequestProcessor extends BaseLlmRequestProcessor {
       llmRequest.allowedTools = Object.keys(filteredTools);
     }
   }
-}
+};
+__name(_ToolFilterRequestProcessor, "ToolFilterRequestProcessor");
+let ToolFilterRequestProcessor = _ToolFilterRequestProcessor;
 const TOOL_FILTER_REQUEST_PROCESSOR = new ToolFilterRequestProcessor();
 export {
   TOOL_FILTER_REQUEST_PROCESSOR,

package/dist/esm/agents/readonly_context.js

@@ -1,12 +1,15 @@
 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 { State } from "../sessions/state.js";
-class ReadonlyContext {
+import { requireAgent } from "./invocation_context.js";
+const _ReadonlyContext = class _ReadonlyContext {
   constructor(invocationContext) {
     this.invocationContext = invocationContext;
   }
@@ -38,7 +41,7 @@ class ReadonlyContext {
    * The current agent name.
    */
   get agentName() {
-    return this.invocationContext.agent.name;
+    return requireAgent(this.invocationContext).name;
   }
   /**
    * The state of the current session.
@@ -49,7 +52,9 @@ class ReadonlyContext {
       {}
     );
   }
-}
+};
+__name(_ReadonlyContext, "ReadonlyContext");
+let ReadonlyContext = _ReadonlyContext;
 export {
   ReadonlyContext
 };

package/dist/esm/agents/routed_agent.js

@@ -1,15 +1,7 @@
 import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
 var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result) __defProp(target, key, result);
-  return result;
-};
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 /**
  * @license
  * Copyright 2026 Google LLC
@@ -17,13 +9,13 @@ var __decorateClass = (decorators, target, key, kind) => {
  */
 var _a, _b;
 import { BaseAgent } from "./base_agent.js";
-import { experimental } from "../utils/experimental.js";
 import { runWithRouting } from "../utils/failover_utils.js";
 const ROUTED_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.routedAgent");
 function isRoutedAgent(obj) {
   return typeof obj === "object" && obj !== null && ROUTED_AGENT_SIGNATURE_SYMBOL in obj && obj[ROUTED_AGENT_SIGNATURE_SYMBOL] === true;
 }
-let RoutedAgent = class extends (_b = BaseAgent, _a = ROUTED_AGENT_SIGNATURE_SYMBOL, _b) {
+__name(isRoutedAgent, "isRoutedAgent");
+const _RoutedAgent = class _RoutedAgent extends (_b = BaseAgent, _a = ROUTED_AGENT_SIGNATURE_SYMBOL, _b) {
   constructor(config) {
     const agentsArray = Array.isArray(config.agents) ? config.agents : Object.values(config.agents);
     super({
@@ -84,9 +76,8 @@ let RoutedAgent = class extends (_b = BaseAgent, _a = ROUTED_AGENT_SIGNATURE_SYM
     );
   }
 };
-RoutedAgent = __decorateClass([
-  experimental
-], RoutedAgent);
+__name(_RoutedAgent, "RoutedAgent");
+let RoutedAgent = _RoutedAgent;
 function cloneRoutingTargets(agents) {
   if (Array.isArray(agents)) {
     return agents.map((agent) => agent.clone());
@@ -95,6 +86,7 @@ function cloneRoutingTargets(agents) {
     Object.entries(agents).map(([key, agent]) => [key, agent.clone()])
   );
 }
+__name(cloneRoutingTargets, "cloneRoutingTargets");
 export {
   RoutedAgent,
   isRoutedAgent

package/dist/esm/agents/run_config.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
@@ -14,6 +16,7 @@ var StreamingMode = /* @__PURE__ */ ((StreamingMode2) => {
 })(StreamingMode || {});
 function createRunConfig(params = {}) {
   var _a;
+  validateStreamingMode(params.streamingMode);
   return {
     saveInputBlobsAsArtifacts: false,
     supportCfc: false,
@@ -24,6 +27,15 @@ function createRunConfig(params = {}) {
     maxLlmCalls: validateMaxLlmCalls((_a = params.maxLlmCalls) != null ? _a : 500)
   };
 }
+__name(createRunConfig, "createRunConfig");
+function validateStreamingMode(streamingMode) {
+  if (streamingMode === "bidi" /* BIDI */) {
+    throw new Error(
+      "StreamingMode.BIDI is not supported; use StreamingMode.SSE."
+    );
+  }
+}
+__name(validateStreamingMode, "validateStreamingMode");
 function validateMaxLlmCalls(value) {
   if (value > Number.MAX_SAFE_INTEGER) {
     throw new Error(
@@ -37,6 +49,7 @@ function validateMaxLlmCalls(value) {
   }
   return value;
 }
+__name(validateMaxLlmCalls, "validateMaxLlmCalls");
 export {
   StreamingMode,
   createRunConfig

package/dist/esm/agents/sequential_agent.js

@@ -1,5 +1,16 @@
 import {createRequire as topLevelCreateRequire} from 'module';
 const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -7,6 +18,7 @@ const require = topLevelCreateRequire(import.meta.url);
  */
 var _a, _b;
 import { FunctionTool } from "../tools/function_tool.js";
+import { deprecated } from "../utils/deprecated.js";
 import { BaseAgent } from "./base_agent.js";
 import { isLlmAgent } from "./llm_agent.js";
 import { ReadonlyContext } from "./readonly_context.js";
@@ -17,7 +29,8 @@ const SEQUENTIAL_AGENT_SIGNATURE_SYMBOL = Symbol.for(
 function isSequentialAgent(obj) {
   return typeof obj === "object" && obj !== null && SEQUENTIAL_AGENT_SIGNATURE_SYMBOL in obj && obj[SEQUENTIAL_AGENT_SIGNATURE_SYMBOL] === true;
 }
-class SequentialAgent extends (_b = BaseAgent, _a = SEQUENTIAL_AGENT_SIGNATURE_SYMBOL, _b) {
+__name(isSequentialAgent, "isSequentialAgent");
+let SequentialAgent = class extends (_b = BaseAgent, _a = SEQUENTIAL_AGENT_SIGNATURE_SYMBOL, _b) {
   constructor() {
     super(...arguments);
     /**
@@ -57,7 +70,7 @@ class SequentialAgent extends (_b = BaseAgent, _a = SEQUENTIAL_AGENT_SIGNATURE_S
             new FunctionTool({
               name: TASK_COMPLETED_TOOL_NAME,
               description: `Signals that the model has successfully completed the user's question or task.`,
-              execute: () => "Task completion signaled."
+              execute: /* @__PURE__ */ __name(() => "Task completion signaled.", "execute")
             })
           );
           subAgent.instruction += `If you finished the user's request according to its description, call the ${TASK_COMPLETED_TOOL_NAME} function to exit so the next agents can take over. When calling this function, do not generate any text other than the function call.`;
@@ -70,7 +83,13 @@ class SequentialAgent extends (_b = BaseAgent, _a = SEQUENTIAL_AGENT_SIGNATURE_S
       }
     }
   }
-}
+};
+__name(SequentialAgent, "SequentialAgent");
+SequentialAgent = __decorateClass([
+  deprecated(
+    "SequentialAgent is deprecated in favor of Workflow and will be removed in a future version. Workflow cannot yet be used as an LlmAgent sub-agent."
+  )
+], SequentialAgent);
 export {
   SequentialAgent,
   isSequentialAgent

package/dist/esm/agents/user_input_request.js

@@ -0,0 +1,120 @@
+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 { camelCaseKeys } from "../utils/case_utils.js";
+import {
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  REQUEST_CREDENTIAL_FUNCTION_CALL_NAME,
+  REQUEST_INPUT_FUNCTION_CALL_NAME
+} from "./functions.js";
+function getUserInputRequests(event) {
+  var _a, _b, _c, _d, _e, _f, _g, _h;
+  const requests = [];
+  for (const part of (_b = (_a = event.content) == null ? void 0 : _a.parts) != null ? _b : []) {
+    const functionCall = part.functionCall;
+    if (!(functionCall == null ? void 0 : functionCall.name)) {
+      continue;
+    }
+    const args = normalizeArgs(functionCall.name, functionCall.args);
+    const interruptId = (_d = (_c = functionCall.id) != null ? _c : asString(args["interruptId"])) != null ? _d : asString(args["functionCallId"]);
+    if (!interruptId) {
+      continue;
+    }
+    const base = {
+      interruptId,
+      functionCallName: functionCall.name,
+      author: event.author
+    };
+    switch (functionCall.name) {
+      case REQUEST_INPUT_FUNCTION_CALL_NAME:
+        requests.push({
+          ...base,
+          kind: "input",
+          message: asString(args["message"]),
+          payload: (_e = args["payload"]) != null ? _e : void 0,
+          responseSchema: (_f = args["response_schema"]) != null ? _f : void 0
+        });
+        break;
+      case REQUEST_CREDENTIAL_FUNCTION_CALL_NAME:
+        requests.push({
+          ...base,
+          kind: "credential",
+          message: asString(args["message"]),
+          authConfig: (_g = args["authConfig"]) != null ? _g : void 0
+        });
+        break;
+      case REQUEST_CONFIRMATION_FUNCTION_CALL_NAME: {
+        const confirmation = args["toolConfirmation"];
+        const originalCall = args["originalFunctionCall"];
+        requests.push({
+          ...base,
+          kind: "confirmation",
+          // Surfaced as `message` so callers can render any kind uniformly.
+          message: asNonEmptyString(confirmation == null ? void 0 : confirmation.hint),
+          payload: (_h = confirmation == null ? void 0 : confirmation.payload) != null ? _h : void 0,
+          toolName: asString(originalCall == null ? void 0 : originalCall.name)
+        });
+        break;
+      }
+      default:
+        break;
+    }
+  }
+  return requests;
+}
+__name(getUserInputRequests, "getUserInputRequests");
+function requiresUserInput(event) {
+  return getUserInputRequests(event).length > 0;
+}
+__name(requiresUserInput, "requiresUserInput");
+function getPendingUserInputRequests(events) {
+  var _a, _b, _c;
+  const answeredIds = /* @__PURE__ */ new Set();
+  for (const event of events) {
+    for (const part of (_b = (_a = event.content) == null ? void 0 : _a.parts) != null ? _b : []) {
+      const id = (_c = part.functionResponse) == null ? void 0 : _c.id;
+      if (id) {
+        answeredIds.add(id);
+      }
+    }
+  }
+  const pending = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const event of events) {
+    for (const request of getUserInputRequests(event)) {
+      if (answeredIds.has(request.interruptId) || seenIds.has(request.interruptId)) {
+        continue;
+      }
+      seenIds.add(request.interruptId);
+      pending.push(request);
+    }
+  }
+  return pending;
+}
+__name(getPendingUserInputRequests, "getPendingUserInputRequests");
+function normalizeArgs(functionCallName, args) {
+  if (!args) {
+    return {};
+  }
+  return functionCallName === REQUEST_CREDENTIAL_FUNCTION_CALL_NAME ? camelCaseKeys(args) : args;
+}
+__name(normalizeArgs, "normalizeArgs");
+function asString(value) {
+  return typeof value === "string" ? value : void 0;
+}
+__name(asString, "asString");
+function asNonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value : void 0;
+}
+__name(asNonEmptyString, "asNonEmptyString");
+export {
+  getPendingUserInputRequests,
+  getUserInputRequests,
+  requiresUserInput
+};

package/dist/esm/apps/app.js

@@ -1,12 +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
  */
 var _a;
-import { isBaseAgent } from "../agents/base_agent.js";
+import {
+  asRunnableRoot
+} from "../workflow/run_node_as_invocation.js";
 const VALID_APP_NAME_RE = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
 function validateAppName(name) {
   if (!VALID_APP_NAME_RE.test(name)) {
@@ -18,30 +22,29 @@ function validateAppName(name) {
     throw new Error("App name cannot be 'user'; reserved for end-user input.");
   }
 }
+__name(validateAppName, "validateAppName");
 const APP_SIGNATURE_SYMBOL = Symbol.for("google.adk.app");
 function isApp(obj) {
   return typeof obj === "object" && obj !== null && APP_SIGNATURE_SYMBOL in obj && obj[APP_SIGNATURE_SYMBOL] === true;
 }
+__name(isApp, "isApp");
 _a = APP_SIGNATURE_SYMBOL;
-class App {
+const _App = class _App {
   constructor(options) {
     this[_a] = true;
-    var _a2, _b, _c, _d;
+    var _a2;
     validateAppName(options.name);
     if (options.rootAgent === void 0 || options.rootAgent === null) {
       throw new Error("rootAgent must be provided.");
     }
-    if (!isBaseAgent(options.rootAgent)) {
-      throw new TypeError(
-        `rootAgent must be a BaseAgent instance, got ${(_c = (_b = (_a2 = options.rootAgent) == null ? void 0 : _a2.constructor) == null ? void 0 : _b.name) != null ? _c : typeof options.rootAgent}`
-      );
-    }
     this.name = options.name;
-    this.rootAgent = options.rootAgent;
-    this.plugins = (_d = options.plugins) != null ? _d : [];
+    this.rootAgent = asRunnableRoot(options.rootAgent);
+    this.plugins = (_a2 = options.plugins) != null ? _a2 : [];
     this.resumabilityConfig = options.resumabilityConfig;
   }
-}
+};
+__name(_App, "App");
+let App = _App;
 export {
   App,
   isApp,

package/dist/esm/apps/resumability_config.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
@@ -11,6 +13,7 @@ function createResumabilityConfig(params = {}) {
     ...params
   };
 }
+__name(createResumabilityConfig, "createResumabilityConfig");
 export {
   createResumabilityConfig
 };

package/dist/esm/artifacts/file_artifact_service.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
@@ -10,7 +12,7 @@ import * as path from "path";
 import { fileURLToPath, pathToFileURL } from "url";
 import { logger } from "../utils/logger.js";
 const USER_NAMESPACE_PREFIX = "user:";
-class FileArtifactService {
+const _FileArtifactService = class _FileArtifactService {
   constructor(rootDirOrUri) {
     try {
       const rootDir = rootDirOrUri.startsWith("file://") ? fileURLToPath(rootDirOrUri) : rootDirOrUri;
@@ -321,7 +323,9 @@ class FileArtifactService {
       return void 0;
     }
   }
-}
+};
+__name(_FileArtifactService, "FileArtifactService");
+let FileArtifactService = _FileArtifactService;
 const SAFE_SEGMENT_RE = /^[a-zA-Z0-9_@-][a-zA-Z0-9_.@-]{0,255}$/;
 function assertSafeSegment(value, label) {
   if (!value || !SAFE_SEGMENT_RE.test(value)) {
@@ -330,6 +334,7 @@ function assertSafeSegment(value, label) {
     );
   }
 }
+__name(assertSafeSegment, "assertSafeSegment");
 function assertInsideRoot(resolvedPath, rootDir, label) {
   const root = path.resolve(rootDir);
   const resolved = path.resolve(resolvedPath);
@@ -339,27 +344,33 @@ function assertInsideRoot(resolvedPath, rootDir, label) {
     );
   }
 }
+__name(assertInsideRoot, "assertInsideRoot");
 function getUserRoot(rootDir, userId) {
   assertSafeSegment(userId, "userId");
   const result = path.join(rootDir, "users", userId);
   assertInsideRoot(result, rootDir, "userRoot");
   return result;
 }
+__name(getUserRoot, "getUserRoot");
 function isUserScoped(sessionId, filename) {
   return !sessionId || filename.startsWith(USER_NAMESPACE_PREFIX);
 }
+__name(isUserScoped, "isUserScoped");
 function getUserArtifactsDir(userRoot) {
   return path.join(userRoot, "artifacts");
 }
+__name(getUserArtifactsDir, "getUserArtifactsDir");
 function getSessionArtifactsDir(baseRoot, sessionId) {
   assertSafeSegment(sessionId, "sessionId");
   const result = path.join(baseRoot, "sessions", sessionId, "artifacts");
   assertInsideRoot(result, baseRoot, "sessionArtifactsDir");
   return result;
 }
+__name(getSessionArtifactsDir, "getSessionArtifactsDir");
 function getVersionsDir(artifactDir) {
   return path.join(artifactDir, "versions");
 }
+__name(getVersionsDir, "getVersionsDir");
 function getArtifactDir(rootDir, userId, sessionId, filename) {
   const userRoot = getUserRoot(rootDir, userId);
   let scopeRoot;
@@ -391,6 +402,7 @@ function getArtifactDir(rootDir, userId, sessionId, filename) {
   }
   return artifactDir;
 }
+__name(getArtifactDir, "getArtifactDir");
 async function getArtifactVersionsFromDir(artifactDir) {
   const versionsDir = getVersionsDir(artifactDir);
   try {
@@ -405,6 +417,7 @@ async function getArtifactVersionsFromDir(artifactDir) {
     return [];
   }
 }
+__name(getArtifactVersionsFromDir, "getArtifactVersionsFromDir");
 async function getCanonicalUri(rootDir, userId, sessionId, filename, version) {
   const artifactDir = await getArtifactDir(
     rootDir,
@@ -421,13 +434,16 @@ async function getCanonicalUri(rootDir, userId, sessionId, filename, version) {
   );
   return pathToFileURL(payloadPath).toString();
 }
+__name(getCanonicalUri, "getCanonicalUri");
 async function writeMetadata(metadataPath, metadata) {
   await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2), "utf-8");
 }
+__name(writeMetadata, "writeMetadata");
 async function readMetadata(metadataPath) {
   const content = await fs.readFile(metadataPath, "utf-8");
   return JSON.parse(content);
 }
+__name(readMetadata, "readMetadata");
 async function getLatestMetadata(artifactDir) {
   const versions = await getArtifactVersionsFromDir(artifactDir);
   if (versions.length === 0) {
@@ -449,6 +465,7 @@ async function getLatestMetadata(artifactDir) {
     return void 0;
   }
 }
+__name(getLatestMetadata, "getLatestMetadata");
 async function* iterateArtifactDirs(dir) {
   try {
     const entries = await fs.readdir(dir, { withFileTypes: true });
@@ -470,6 +487,7 @@ async function* iterateArtifactDirs(dir) {
   } catch (_e) {
   }
 }
+__name(iterateArtifactDirs, "iterateArtifactDirs");
 function fileUriToPath(uri) {
   try {
     return fileURLToPath(uri);
@@ -481,9 +499,11 @@ function fileUriToPath(uri) {
     return void 0;
   }
 }
+__name(fileUriToPath, "fileUriToPath");
 function asPosixPath(p) {
   return p.split(path.sep).join("/");
 }
+__name(asPosixPath, "asPosixPath");
 export {
   FileArtifactService,
   assertInsideRoot,