@google/adk 1.6.0 → 2.0.0

package/dist/esm/common.js

@@ -9,11 +9,14 @@ import { ActiveStreamingTool } from "./agents/active_streaming_tool.js";
 import { BaseAgent, isBaseAgent } from "./agents/base_agent.js";
 import { Context } from "./agents/context.js";
 import {
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  REQUEST_CREDENTIAL_FUNCTION_CALL_NAME,
+  REQUEST_INPUT_FUNCTION_CALL_NAME,
   findEventByFunctionCallId,
   findMatchingFunctionCall,
   functionsExportedForTestingOnly
 } from "./agents/functions.js";
-import { InvocationContext } from "./agents/invocation_context.js";
+import { InvocationContext, requireAgent } from "./agents/invocation_context.js";
 import { LiveRequestQueue } from "./agents/live_request_queue.js";
 import { LlmAgent, LlmAgent as LlmAgent2, isLlmAgent } from "./agents/llm_agent.js";
 import { LoopAgent, isLoopAgent } from "./agents/loop_agent.js";
@@ -36,6 +39,11 @@ import { ReadonlyContext } from "./agents/readonly_context.js";
 import { RoutedAgent, isRoutedAgent } from "./agents/routed_agent.js";
 import { StreamingMode } from "./agents/run_config.js";
 import { SequentialAgent, isSequentialAgent } from "./agents/sequential_agent.js";
+import {
+  getPendingUserInputRequests,
+  getUserInputRequests,
+  requiresUserInput
+} from "./agents/user_input_request.js";
 import { createResumabilityConfig } from "./apps/resumability_config.js";
 import { InMemoryArtifactService } from "./artifacts/in_memory_artifact_service.js";
 import { AuthCredentialTypes } from "./auth/auth_credential.js";
@@ -61,6 +69,7 @@ import { LlmSummarizer } from "./context/summarizers/llm_summarizer.js";
 import { TokenBasedContextCompactor } from "./context/token_based_context_compactor.js";
 import { TrajectoryThoughtPruningCompactor } from "./context/trajectory_thought_pruning_compactor.js";
 import { TruncatingContextCompactor } from "./context/truncating_context_compactor.js";
+import { BaseEnvironment } from "./environment/base_environment.js";
 import { isCompactedEvent, isScratchpadEvent } from "./events/compacted_event.js";
 import {
   createEvent,
@@ -94,7 +103,6 @@ import { PluginManager } from "./plugins/plugin_manager.js";
 import {
   InMemoryPolicyEngine,
   PolicyOutcome,
-  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
   SecurityPlugin,
   getAskUserConfirmationFunctionCalls
 } from "./plugins/security_plugin.js";
@@ -109,7 +117,7 @@ import {
 import { BaseSessionService } from "./sessions/base_session_service.js";
 import { InMemorySessionService } from "./sessions/in_memory_session_service.js";
 import { createSession } from "./sessions/session.js";
-import { State } from "./sessions/state.js";
+import { State, StateSchemaError, isStateSchemaError } from "./sessions/state.js";
 import { AgentTool, isAgentTool } from "./tools/agent_tool.js";
 import { BaseTool, isBaseTool } from "./tools/base_tool.js";
 import { BaseToolset, isBaseToolset } from "./tools/base_toolset.js";
@@ -120,6 +128,11 @@ import {
 } from "./tools/enterprise_web_search_tool.js";
 import { ExampleTool } from "./tools/example_tool.js";
 import { EXIT_LOOP, ExitLoopTool } from "./tools/exit_loop_tool.js";
+import {
+  FINISH_TASK_SUCCESS_RESULT,
+  FINISH_TASK_TOOL_NAME,
+  FinishTaskTool
+} from "./tools/finish_task_tool.js";
 import { FunctionTool, isFunctionTool } from "./tools/function_tool.js";
 import { getUserChoiceTool } from "./tools/get_user_choice_tool.js";
 import {
@@ -139,10 +152,15 @@ import {
   PreloadMemoryTool
 } from "./tools/preload_memory_tool.js";
 import { requestInputTool } from "./tools/request_input_tool.js";
-import { ToolConfirmation } from "./tools/tool_confirmation.js";
+import {
+  IntentMismatchError,
+  ToolConfirmation,
+  isIntentMismatchError
+} from "./tools/tool_confirmation.js";
 import { URL_CONTEXT, UrlContextTool } from "./tools/url_context_tool.js";
 import { VertexAiSearchTool } from "./tools/vertex_ai_search_tool.js";
 import { VertexRagRetrievalTool } from "./tools/vertex_rag_retrieval_tool.js";
+import { AsyncQueue } from "./utils/async_queue.js";
 import { getClientLabels, runWithClientLabel } from "./utils/client_labels.js";
 import { LogLevel, getLogger, setLogLevel, setLogger } from "./utils/logger.js";
 import { isGemini2OrAbove, isGemini3xFlashLive } from "./utils/model_name.js";
@@ -175,6 +193,43 @@ import {
   RestApiTool,
   createRestApiTool
 } from "./tools/openapi_tool/rest_api_tool.js";
+import {
+  BaseNode,
+  BranchPath,
+  DEFAULT_ROUTE,
+  Edge,
+  FunctionNode,
+  Graph,
+  JoinNode,
+  NodeContext,
+  NodeReportedError,
+  NodeSchemaValidationError,
+  NodeStatus,
+  NodeTimeoutError,
+  NodeTool,
+  ParallelWorker,
+  RequestInput,
+  START,
+  ToolNode,
+  Workflow,
+  WorkflowNode,
+  asRunnableRoot,
+  commonPrefixOf,
+  createNodeErrorEvent,
+  createNodeState,
+  createSubBranch,
+  isNodeErrorEvent,
+  isNodeReportedError,
+  isNodeSchemaValidationError,
+  isNodeState,
+  isNodeTimeoutError,
+  isRequestInput,
+  isRunnableRoot,
+  isWorkflow,
+  node,
+  normalizeRetryExceptions,
+  prepareRetryConfig
+} from "./workflow/index.js";
 export * from "./apps/app.js";
 export * from "./artifacts/base_artifact_service.js";
 export * from "./features/feature_registry.js";
@@ -190,20 +245,24 @@ export {
   AgentTransferLlmRequestProcessor,
   AnchoredContextCompactor,
   ApigeeLlm,
+  AsyncQueue,
   AuthCredentialTypes,
   AuthHandler,
   AuthPreprocessor,
   AuthProviderRegistry,
   BaseAgent,
   BaseCodeExecutor,
+  BaseEnvironment,
   BaseExampleProvider,
   BaseLlm,
   BaseLlmRequestProcessor,
   BaseLlmResponseProcessor,
+  BaseNode,
   BasePlugin,
   BaseSessionService,
   BaseTool,
   BaseToolset,
+  BranchPath,
   BuiltInCodeExecutor,
   CONTENT_REQUEST_PROCESSOR,
   CodeExecutionLanguage,
@@ -214,13 +273,19 @@ export {
   ContextCompactorRequestProcessor,
   CredentialExchangeError,
   CredentialRefresherRegistry,
+  DEFAULT_ROUTE,
   ENTERPRISE_WEB_SEARCH,
   EXIT_LOOP,
+  Edge,
   EnterpriseWebSearchTool,
   EventType,
   ExampleTool,
   ExitLoopTool,
+  FINISH_TASK_SUCCESS_RESULT,
+  FINISH_TASK_TOOL_NAME,
   FileContentEncoding,
+  FinishTaskTool,
+  FunctionNode,
   FunctionTool,
   GCPSkillRegistry,
   GOOGLE_MAPS_GROUNDING,
@@ -230,6 +295,7 @@ export {
   GoogleLLMVariant,
   GoogleMapsGroundingTool,
   GoogleSearchTool,
+  Graph,
   INTERACTIONS_REQUEST_PROCESSOR,
   InMemoryArtifactService,
   InMemoryCredentialService,
@@ -237,8 +303,10 @@ export {
   InMemoryPolicyEngine,
   InMemoryRunner,
   InMemorySessionService,
+  IntentMismatchError,
   InteractionsRequestProcessor,
   InvocationContext,
+  JoinNode,
   LLMRegistry,
   LOAD_ARTIFACTS,
   LOAD_MEMORY,
@@ -255,6 +323,12 @@ export {
   LoggingPlugin,
   LongRunningFunctionTool,
   LoopAgent,
+  NodeContext,
+  NodeReportedError,
+  NodeSchemaValidationError,
+  NodeStatus,
+  NodeTimeoutError,
+  NodeTool,
   OAuth2CredentialExchanger,
   OAuth2DiscoveryManager,
   OAuthGrantType,
@@ -263,26 +337,33 @@ export {
   OperationParser,
   PRELOAD_MEMORY,
   ParallelAgent,
+  ParallelWorker,
   PluginManager,
   PolicyOutcome,
   PreloadMemoryTool,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  REQUEST_CREDENTIAL_FUNCTION_CALL_NAME,
+  REQUEST_INPUT_FUNCTION_CALL_NAME,
   ReadonlyContext,
+  RequestInput,
   RestApiTool,
   RoutedAgent,
   RoutedLlm,
   Runner,
+  START,
   SearchSkillsTool,
   SecurityPlugin,
   SequentialAgent,
   SessionStateCredentialService,
   SkillToolset,
   State,
+  StateSchemaError,
   StreamingMode,
   Task,
   TokenBasedContextCompactor,
   ToolAuthHandler,
   ToolConfirmation,
+  ToolNode,
   TrajectoryThoughtPruningCompactor,
   TruncatingContextCompactor,
   URL_CONTEXT,
@@ -290,11 +371,18 @@ export {
   VertexAiMemoryBankService,
   VertexAiSearchTool,
   VertexRagRetrievalTool,
+  Workflow,
+  WorkflowNode,
+  asRunnableRoot,
+  commonPrefixOf,
   createEvent,
   createEventActions,
+  createNodeErrorEvent,
+  createNodeState,
   createRestApiTool,
   createResumabilityConfig,
   createSession,
+  createSubBranch,
   determineAgentForResumption,
   findEventByFunctionCallId,
   findEventByLastFunctionResponseId,
@@ -307,7 +395,9 @@ export {
   getFunctionCalls,
   getFunctionResponses,
   getLogger,
+  getPendingUserInputRequests,
   getUserChoiceTool,
+  getUserInputRequests,
   hasThoughts,
   hasTrailingCodeExecutionResult,
   isAgentTool,
@@ -321,21 +411,36 @@ export {
   isFunctionTool,
   isGemini2OrAbove,
   isGemini3xFlashLive,
+  isIntentMismatchError,
   isLlmAgent,
   isLoopAgent,
+  isNodeErrorEvent,
+  isNodeReportedError,
+  isNodeSchemaValidationError,
+  isNodeState,
+  isNodeTimeoutError,
   isParallelAgent,
+  isRequestInput,
   isRoutableLlmAgent,
   isRoutedAgent,
+  isRunnableRoot,
   isRunner,
   isScratchpadEvent,
   isSequentialAgent,
+  isStateSchemaError,
+  isWorkflow,
   loadAllSkillsInDir,
   loadSkillFromDir,
   loadSkillFromZipBuffer,
   loadWebPage,
+  node,
+  normalizeRetryExceptions,
   populateClientFunctionCallId,
+  prepareRetryConfig,
   pruneThoughts,
   requestInputTool,
+  requireAgent,
+  requiresUserInput,
   runWithClientLabel,
   setLogLevel,
   setLogger,

package/dist/esm/context/agent_controlled_context_compactor.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
@@ -8,7 +10,7 @@ const require = topLevelCreateRequire(import.meta.url);
 import { createEvent } from "../events/event.js";
 import { ContextCompactionTrigger } from "../plugins/base_plugin.js";
 import { getActiveEvents } from "./compaction_utils.js";
-class AgentControlledContextCompactor {
+const _AgentControlledContextCompactor = class _AgentControlledContextCompactor {
   constructor(options) {
     this.trigger = ContextCompactionTrigger.AgentControlled;
     this.summarizer = options.summarizer;
@@ -66,7 +68,9 @@ class AgentControlledContextCompactor {
     delete invocationContext.session.state["temp:consolidate_context"];
     delete invocationContext.session.state["temp:consolidate_context_detail"];
   }
-}
+};
+__name(_AgentControlledContextCompactor, "AgentControlledContextCompactor");
+let AgentControlledContextCompactor = _AgentControlledContextCompactor;
 export {
   AgentControlledContextCompactor
 };

package/dist/esm/context/anchored_context_compactor.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
@@ -8,7 +10,7 @@ const require = topLevelCreateRequire(import.meta.url);
 import { isScratchpadEvent } from "../events/compacted_event.js";
 import { getEventTokens } from "../events/event.js";
 import { calculateRetainStartIndex } from "./compaction_utils.js";
-class AnchoredContextCompactor {
+const _AnchoredContextCompactor = class _AnchoredContextCompactor {
   constructor(options) {
     this.tokenThreshold = options.tokenThreshold;
     this.eventRetentionSize = options.eventRetentionSize;
@@ -93,7 +95,9 @@ class AnchoredContextCompactor {
     events.length = 0;
     events.push(...newEventsList);
   }
-}
+};
+__name(_AnchoredContextCompactor, "AnchoredContextCompactor");
+let AnchoredContextCompactor = _AnchoredContextCompactor;
 export {
   AnchoredContextCompactor
 };

package/dist/esm/context/compaction_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
@@ -19,6 +21,7 @@ function getActiveEvents(events) {
     )
   ] : events;
 }
+__name(getActiveEvents, "getActiveEvents");
 function calculateRetainStartIndex(rawEvents, eventRetentionSize) {
   let retainStartIndex = Math.max(0, rawEvents.length - eventRetentionSize);
   while (retainStartIndex > 0) {
@@ -32,6 +35,7 @@ function calculateRetainStartIndex(rawEvents, eventRetentionSize) {
   }
   return retainStartIndex;
 }
+__name(calculateRetainStartIndex, "calculateRetainStartIndex");
 export {
   calculateRetainStartIndex,
   getActiveEvents

package/dist/esm/context/summarizers/llm_summarizer.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 {
 } from "../../events/compacted_event.js";
 import { stringifyContent } from "../../events/event.js";
 const DEFAULT_PROMPT = "The following is a conversation history between a user and an AI agent. Please summarize the conversation, focusing on key information and decisions made, as well as any unresolved questions or tasks. The summary should be concise and capture the essence of the interaction.";
-class LlmSummarizer {
+const _LlmSummarizer = class _LlmSummarizer {
   /**
    * @param options - Configuration specifying the LLM and optional prompt.
    */
@@ -72,7 +74,9 @@ ${formattedEvents}`;
       compactedContent
     });
   }
-}
+};
+__name(_LlmSummarizer, "LlmSummarizer");
+let LlmSummarizer = _LlmSummarizer;
 export {
   LlmSummarizer
 };

package/dist/esm/context/token_based_context_compactor.js

@@ -1,10 +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 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { requireAgent } from "../agents/invocation_context.js";
 import { getContents } from "../agents/processors/content_processor_utils.js";
 import { isCompactedEvent } from "../events/compacted_event.js";
 import {
@@ -12,7 +15,7 @@ import {
   getActiveEvents
 } from "./compaction_utils.js";
 const CHARS_PER_TOKEN = 4;
-class TokenBasedContextCompactor {
+const _TokenBasedContextCompactor = class _TokenBasedContextCompactor {
   constructor(options) {
     this.tokenThreshold = options.tokenThreshold;
     this.eventRetentionSize = options.eventRetentionSize;
@@ -69,7 +72,9 @@ class TokenBasedContextCompactor {
     }
     invocationContext.session.events.push(compactedEvent);
   }
-}
+};
+__name(_TokenBasedContextCompactor, "TokenBasedContextCompactor");
+let TokenBasedContextCompactor = _TokenBasedContextCompactor;
 function latestPromptTokenCount(activeEvents, invocationContext) {
   var _a;
   for (let i = activeEvents.length - 1; i >= 0; i--) {
@@ -80,11 +85,12 @@ function latestPromptTokenCount(activeEvents, invocationContext) {
   }
   return estimatePromptTokenCount(activeEvents, invocationContext);
 }
+__name(latestPromptTokenCount, "latestPromptTokenCount");
 function estimatePromptTokenCount(activeEvents, invocationContext) {
   var _a;
   const contents = getContents(
     activeEvents,
-    invocationContext.agent.name,
+    requireAgent(invocationContext).name,
     invocationContext.branch
   );
   let totalChars = 0;
@@ -106,6 +112,7 @@ function estimatePromptTokenCount(activeEvents, invocationContext) {
   }
   return Math.ceil(totalChars / CHARS_PER_TOKEN);
 }
+__name(estimatePromptTokenCount, "estimatePromptTokenCount");
 export {
   TokenBasedContextCompactor
 };

package/dist/esm/context/trajectory_thought_pruning_compactor.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 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
 import { hasThoughts, pruneThoughts } from "../events/event.js";
-class TrajectoryThoughtPruningCompactor {
+const _TrajectoryThoughtPruningCompactor = class _TrajectoryThoughtPruningCompactor {
   constructor(options) {
     if (options.eventRetentionSize < 0) {
       throw new Error("eventRetentionSize must be a non-negative integer.");
@@ -37,7 +39,9 @@ class TrajectoryThoughtPruningCompactor {
       }
     }
   }
-}
+};
+__name(_TrajectoryThoughtPruningCompactor, "TrajectoryThoughtPruningCompactor");
+let TrajectoryThoughtPruningCompactor = _TrajectoryThoughtPruningCompactor;
 export {
   TrajectoryThoughtPruningCompactor
 };

package/dist/esm/context/truncating_context_compactor.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 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class TruncatingContextCompactor {
+const _TruncatingContextCompactor = class _TruncatingContextCompactor {
   constructor(options) {
     var _a;
     this.threshold = options.threshold;
@@ -24,7 +26,9 @@ class TruncatingContextCompactor {
     const startIndexToRemove = Math.max(0, this.preserveLeadingEvents);
     events.splice(startIndexToRemove, excess);
   }
-}
+};
+__name(_TruncatingContextCompactor, "TruncatingContextCompactor");
+let TruncatingContextCompactor = _TruncatingContextCompactor;
 export {
   TruncatingContextCompactor
 };

package/dist/esm/environment/base_environment.js

@@ -0,0 +1,71 @@
+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 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { experimental } from "../utils/experimental.js";
+let BaseEnvironment = class {
+  constructor() {
+    /**
+     * Backing flag for {@link isInitialized}.
+     *
+     * Subclasses own this flag: set it in {@link initialize} and clear it in
+     * {@link close}.
+     */
+    this.initialized = false;
+  }
+  /** Whether the environment has been initialized. */
+  get isInitialized() {
+    return this.initialized;
+  }
+  /**
+   * Initializes the environment (e.g. creates the working directory).
+   *
+   * Called before first use. The default implementation is a no-op and leaves
+   * {@link isInitialized} `false`. Subclasses must be idempotent and must set
+   * {@link initialized}.
+   */
+  async initialize() {
+  }
+  /**
+   * Releases resources held by the environment.
+   *
+   * The default implementation is a no-op. Subclasses must be idempotent and
+   * must clear {@link initialized}.
+   */
+  async close() {
+  }
+  /**
+   * Throws if {@link initialize} has not been called.
+   *
+   * Implementations should call this at the start of every operation that needs
+   * a live working directory.
+   */
+  assertInitialized() {
+    if (!this.initialized) {
+      throw new Error(
+        "Environment is not initialized. Call initialize() first."
+      );
+    }
+  }
+};
+__name(BaseEnvironment, "BaseEnvironment");
+BaseEnvironment = __decorateClass([
+  experimental
+], BaseEnvironment);
+export {
+  BaseEnvironment
+};