@google/adk 1.6.0 → 2.1.0

package/dist/types/common.d.ts

@@ -8,9 +8,9 @@ export type { ActiveStreamingToolParams } from './agents/active_streaming_tool.j
 export { BaseAgent, isBaseAgent } from './agents/base_agent.js';
 export type { AfterAgentCallback, BaseAgentConfig, BeforeAgentCallback, SingleAgentCallback, } from './agents/base_agent.js';
 export { Context } from './agents/context.js';
-export { findEventByFunctionCallId, findMatchingFunctionCall, functionsExportedForTestingOnly, } from './agents/functions.js';
-export { InvocationContext } from './agents/invocation_context.js';
-export type { InvocationContextParams } from './agents/invocation_context.js';
+export { REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, REQUEST_CREDENTIAL_FUNCTION_CALL_NAME, REQUEST_INPUT_FUNCTION_CALL_NAME, findEventByFunctionCallId, findMatchingFunctionCall, functionsExportedForTestingOnly, isToolNotFound, } from './agents/functions.js';
+export { InvocationContext, requireAgent } from './agents/invocation_context.js';
+export type { InvocationContextParams, WorkflowInstructionScope, } from './agents/invocation_context.js';
 export { LiveRequestQueue } from './agents/live_request_queue.js';
 export type { LiveRequest } from './agents/live_request_queue.js';
 export { LlmAgent as Agent, LlmAgent, isLlmAgent } from './agents/llm_agent.js';
@@ -30,10 +30,14 @@ export { StreamingMode } from './agents/run_config.js';
 export type { RunConfig } from './agents/run_config.js';
 export { SequentialAgent, isSequentialAgent } from './agents/sequential_agent.js';
 export type { TranscriptionEntry } from './agents/transcription_entry.js';
+export { getPendingUserInputRequests, getUserInputRequests, requiresUserInput, } from './agents/user_input_request.js';
+export type { UserInputKind, UserInputRequest, } from './agents/user_input_request.js';
 export { createResumabilityConfig } from './apps/resumability_config.js';
 export type { ResumabilityConfig } from './apps/resumability_config.js';
 export type { BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest, } from './artifacts/base_artifact_service.js';
 export { InMemoryArtifactService } from './artifacts/in_memory_artifact_service.js';
+export { ScopedArtifactService } from './artifacts/scoped_artifact_service.js';
+export { isSessionArtifactService } from './artifacts/session_artifact_service.js';
 export type { SessionArtifactService, SessionLoadArtifactRequest, SessionSaveArtifactRequest, } from './artifacts/session_artifact_service.js';
 export { AuthCredentialTypes } from './auth/auth_credential.js';
 export type { AuthCredential, HttpAuth, HttpCredentials, OAuth2Auth, ServiceAccount, ServiceAccountCredential, } from './auth/auth_credential.js';
@@ -70,10 +74,17 @@ export { TrajectoryThoughtPruningCompactor } from './context/trajectory_thought_
 export type { TrajectoryThoughtPruningCompactorOptions } from './context/trajectory_thought_pruning_compactor.js';
 export { TruncatingContextCompactor } from './context/truncating_context_compactor.js';
 export type { TruncatingContextCompactorOptions } from './context/truncating_context_compactor.js';
+export { BaseEnvironment } from './environment/base_environment.js';
+export type { ExecutionResult } from './environment/base_environment.js';
+export { AlreadyExistsError } from './errors/already_exists_error.js';
+export { InputValidationError } from './errors/input_validation_error.js';
+export { NotFoundError } from './errors/not_found_error.js';
+export { SessionNotFoundError } from './errors/session_not_found_error.js';
+export { ToolErrorType, ToolExecutionError, } from './errors/tool_execution_error.js';
 export { isCompactedEvent, isScratchpadEvent } from './events/compacted_event.js';
 export type { CompactedEvent } from './events/compacted_event.js';
 export { createEvent, generateClientFunctionCallId, getFunctionCalls, getFunctionResponses, hasThoughts, hasTrailingCodeExecutionResult, isFinalResponse, populateClientFunctionCallId, pruneThoughts, stringifyContent, } from './events/event.js';
-export type { Event } from './events/event.js';
+export type { CreateEventParams, Event, NodeInfo, Route, RouteKey, } from './events/event.js';
 export { createEventActions } from './events/event_actions.js';
 export type { EventActions } from './events/event_actions.js';
 export { EventType, toStructuredEvents } from './events/structured_events.js';
@@ -83,12 +94,12 @@ export type { Example } from './examples/example.js';
 export type { BaseMemoryService, SearchMemoryRequest, SearchMemoryResponse, } from './memory/base_memory_service.js';
 export { InMemoryMemoryService } from './memory/in_memory_memory_service.js';
 export type { MemoryEntry } from './memory/memory_entry.js';
-export { VertexAiMemoryBankService } from './memory/vertex_ai_memory_bank_service.js';
-export type { VertexAiMemoryBankServiceOptions } from './memory/vertex_ai_memory_bank_service.js';
 export { ApigeeLlm } from './models/apigee_llm.js';
 export type { ApigeeLlmParams } from './models/apigee_llm.js';
 export { BaseLlm, isBaseLlm } from './models/base_llm.js';
 export type { BaseLlmConnection } from './models/base_llm_connection.js';
+export { ChromeBuiltInLlm, ChromeModelUnavailableError, stripAdkIdentityPreamble, } from './models/chrome_prompt_llm.js';
+export type { ChromeBuiltInDiagnostic, ChromeBuiltInLlmParams, ChromeCreateCoreOptions, ChromeCreateMonitor, ChromeCreateOptions, ChromeExpectedModality, ChromeLanguageModelFactory, ChromeLanguageModelSession, ChromeMessage, ChromeMessageContent, ChromeModelAvailability, ChromePromptOptions, } from './models/chrome_prompt_llm.js';
 export { Gemini, geminiInitParams } from './models/google_llm.js';
 export type { GeminiParams } from './models/google_llm.js';
 export type { LlmRequest } from './models/llm_request.js';
@@ -97,11 +108,14 @@ export { LLMRegistry } from './models/registry.js';
 export type { BaseLlmType } from './models/registry.js';
 export { RoutedLlm } from './models/routed_llm.js';
 export type { LlmRouter } from './models/routed_llm.js';
+export { GLOBAL_SCOPE_KEY, REFLECT_AND_RETRY_RESPONSE_TYPE, ScopedFailureTracker, TrackingScope, resolveScopeKey, type PerItemFailuresCounter, type ToolFailureResponse, } from './plugins/_reflect_retry_utils.js';
 export { BasePlugin, ContextCompactionTrigger } from './plugins/base_plugin.js';
 export { GlobalInstructionPlugin } from './plugins/global_instruction_plugin.js';
 export { LoggingPlugin } from './plugins/logging_plugin.js';
 export { PluginManager } from './plugins/plugin_manager.js';
-export { InMemoryPolicyEngine, PolicyOutcome, REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, SecurityPlugin, getAskUserConfirmationFunctionCalls, } from './plugins/security_plugin.js';
+export { ADK_HANDLE_MODEL_ERROR_TOOL_NAME, RESERVED_TOOL_CALL_ERROR_TYPE, ReflectAndRetryModelPlugin, type ReflectAndRetryModelPluginOptions, } from './plugins/reflect_retry_model_plugin.js';
+export { ReflectAndRetryToolPlugin, type ReflectAndRetryToolPluginOptions, } from './plugins/reflect_retry_tool_plugin.js';
+export { InMemoryPolicyEngine, PolicyOutcome, SecurityPlugin, getAskUserConfirmationFunctionCalls, } from './plugins/security_plugin.js';
 export type { BasePolicyEngine, PolicyCheckResult, ToolCallPolicyContext, } from './plugins/security_plugin.js';
 export { InMemoryRunner } from './runner/in_memory_runner.js';
 export { Runner, determineAgentForResumption, findEventByLastFunctionResponseId, isRoutableLlmAgent, isRunner, } from './runner/runner.js';
@@ -111,67 +125,65 @@ export type { AppendEventRequest, CreateSessionRequest, DeleteSessionRequest, Ge
 export { InMemorySessionService } from './sessions/in_memory_session_service.js';
 export { createSession } from './sessions/session.js';
 export type { CompositeSessionKey, Session } from './sessions/session.js';
-export { State } from './sessions/state.js';
+export { State, StateSchemaError, isStateSchemaError } from './sessions/state.js';
 export { AgentTool, isAgentTool } from './tools/agent_tool.js';
 export type { AgentToolConfig } from './tools/agent_tool.js';
 export { BaseTool, isBaseTool } from './tools/base_tool.js';
 export type { BaseToolParams, RunAsyncToolRequest, ToolProcessLlmRequest, } from './tools/base_tool.js';
 export { BaseToolset, isBaseToolset } from './tools/base_toolset.js';
 export type { ToolPredicate } from './tools/base_toolset.js';
+export { BuiltInTool } from './tools/built_in_tool.js';
 export { ConsolidateContextTool } from './tools/consolidate_context_tool.js';
 export { ENTERPRISE_WEB_SEARCH, EnterpriseWebSearchTool, } from './tools/enterprise_web_search_tool.js';
 export { ExampleTool } from './tools/example_tool.js';
 export { EXIT_LOOP, ExitLoopTool } from './tools/exit_loop_tool.js';
+export { FINISH_TASK_SUCCESS_RESULT, FINISH_TASK_TOOL_NAME, FinishTaskTool, } from './tools/finish_task_tool.js';
+export { ForwardingArtifactService } from './tools/forwarding_artifact_service.js';
 export { FunctionTool, isFunctionTool } from './tools/function_tool.js';
-export type { ToolExecuteArgument, ToolExecuteFunction, ToolInputParameters, ToolOptions, } from './tools/function_tool.js';
+export type { RequireConfirmation, ToolExecuteArgument, ToolExecuteFunction, ToolInputParameters, ToolOptions, } from './tools/function_tool.js';
 export { getUserChoiceTool } from './tools/get_user_choice_tool.js';
 export { GOOGLE_MAPS_GROUNDING, GoogleMapsGroundingTool, } from './tools/google_maps_grounding_tool.js';
 export { GOOGLE_SEARCH, GoogleSearchTool } from './tools/google_search_tool.js';
 export { LOAD_ARTIFACTS, LoadArtifactsTool, } from './tools/load_artifacts_tool.js';
 export { LOAD_MEMORY, LoadMemoryTool } from './tools/load_memory_tool.js';
-export { LOAD_WEB_PAGE, loadWebPage } from './tools/load_web_page.js';
-export type { LoadWebPageOptions } from './tools/load_web_page.js';
 export { LongRunningFunctionTool } from './tools/long_running_tool.js';
 export { PRELOAD_MEMORY, PreloadMemoryTool, } from './tools/preload_memory_tool.js';
 export { requestInputTool } from './tools/request_input_tool.js';
-export { ToolConfirmation } from './tools/tool_confirmation.js';
+export type { ResumeInputs } from './tools/resume_inputs.js';
+export { BaseRetrievalTool } from './tools/retrieval/base_retrieval_tool.js';
+export { LlamaIndexRetrieval } from './tools/retrieval/llama_index_retrieval.js';
+export type { LlamaIndexNode, LlamaIndexNodeWithScore, LlamaIndexRetrievalParams, LlamaIndexRetriever, } from './tools/retrieval/llama_index_retrieval.js';
+export { IntentMismatchError, ToolConfirmation, isIntentMismatchError, } from './tools/tool_confirmation.js';
+export type { IntentMismatchReason } from './tools/tool_confirmation.js';
 export { URL_CONTEXT, UrlContextTool } from './tools/url_context_tool.js';
 export { VertexAiSearchTool } from './tools/vertex_ai_search_tool.js';
 export type { DataStoreParams, SearchEngineParams, VertexAISearchConfig, VertexAISearchDataStoreSpec, VertexAiSearchToolParams, } from './tools/vertex_ai_search_tool.js';
 export { VertexRagRetrievalTool } from './tools/vertex_rag_retrieval_tool.js';
+export { AsyncQueue } from './utils/async_queue.js';
 export { getClientLabels, runWithClientLabel } from './utils/client_labels.js';
-export { LogLevel, getLogger, setLogLevel, setLogger } from './utils/logger.js';
+export { LogLevel, getLogger, resetLogger, setLogLevel, setLogger, } from './utils/logger.js';
 export type { Logger } from './utils/logger.js';
 export { isGemini2OrAbove, isGemini3xFlashLive } from './utils/model_name.js';
+export type { SchemaLike } from './utils/schema.js';
 export { zodObjectToSchema } from './utils/simple_zod_to_json.js';
 export { Task } from './utils/task.js';
 export type { TaskExecutable } from './utils/task.js';
 export { GoogleLLMVariant } from './utils/variant_utils.js';
 export { version } from './version.js';
-export { GCPSkillRegistry } from './skills/gcp_skill_registry.js';
-export type { GCPSkillRegistryOptions } from './skills/gcp_skill_registry.js';
-export { loadAllSkillsInDir, loadSkillFromDir, loadSkillFromZipBuffer, validateSkillDir, } from './skills/loader.js';
 export type { Frontmatter, Resources, Script, Skill } from './skills/skill.js';
 export type { SkillRegistry } from './skills/skill_registry.js';
 export { ListSkillsTool } from './tools/skill/list_skills_tool.js';
-export { LoadSkillResourceTool } from './tools/skill/load_skill_resource_tool.js';
 export { LoadSkillTool } from './tools/skill/load_skill_tool.js';
 export { SearchSkillsTool } from './tools/skill/search_skills_tool.js';
-export { SkillToolset } from './tools/skill/skill_toolset.js';
 export * from './artifacts/base_artifact_service.js';
 export * from './features/feature_registry.js';
 export * from './memory/base_memory_service.js';
 export * from './sessions/base_session_service.js';
 export * from './tools/base_tool.js';
-export { OpenApiSpecParser } from './tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js';
-export type { OperationEndpoint, ParsedOperation, } from './tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js';
-export { OperationParser } from './tools/openapi_tool/openapi_spec_parser/operation_parser.js';
-export type { ApiParameter } from './tools/openapi_tool/openapi_spec_parser/operation_parser.js';
-export { ToolAuthHandler } from './tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js';
-export type { AuthPreparationResult } from './tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js';
-export { OpenAPIToolset } from './tools/openapi_tool/openapi_toolset.js';
-export { RestApiTool, createRestApiTool, } from './tools/openapi_tool/rest_api_tool.js';
-export * from './apps/app.js';
+export { 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 type { BaseNodeConfig, BuildNodeOptions, ChainElement, CreateNodeErrorEventParams, DynamicEntry, EdgeItem, ErrorClass, FunctionNodeConfig, FunctionNodeHandler, FunctionNodeResult, NodeContextOptions, NodeErrorEvent, NodeLike, NodeOptions, NodeResult, NodeState, ParallelWorkerConfig, PreparedRetryConfig, RequestInputParams, RetryConfig, RouteValue, RoutingMap, RunNodeOptions, RunnableNode, RunnableRoot, ScheduleDynamicNode, ScheduleDynamicNodeOptions, ToolNodeConfig, WorkflowConfig, } from './workflow/index.js';
+export { App, isApp, validateAppName } from './apps/app.js';
+export type { AppOptions } from './apps/app.js';
 export * from './artifacts/base_artifact_service.js';
 export * from './features/feature_registry.js';
 export * from './memory/base_memory_service.js';

package/dist/types/context/compaction_utils.d.ts

@@ -9,9 +9,17 @@ import { Event } from '../events/event.js';
  * If no compaction has occurred, returns all events.
  *
  * @param events The full history of events.
+ * @param currentIsolationScope The scope of the caller. Events tagged with a
+ *   different scope are withheld.
  * @returns The active events, starting with the latest CompactedEvent if present.
  */
-export declare function getActiveEvents(events: Event[]): Event[];
+export declare function getActiveEvents(events: Event[], currentIsolationScope?: string): Event[];
+/**
+ * Whether an event is visible to a caller's isolation scope.
+ * Untagged events are shared history; tagged events are visible only to their
+ * own scope. An unscoped caller therefore sees only shared history.
+ */
+export declare function isEventVisibleInIsolationScope(event: Event, currentIsolationScope?: string): boolean;
 /**
  * Determines the baseline index to retain from active raw events,
  * ensuring we don't split between a function call and its response.

package/dist/types/environment/base_environment.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Result of a shell command executed in a {@link BaseEnvironment}.
+ *
+ * This is distinct from `CodeExecutionResult`, which is produced by the code
+ * executors: a code executor runs a code *snippet* and reports the files it
+ * produced, whereas an environment runs a *shell command* inside a working
+ * directory and reports its process exit status.
+ *
+ * A command that succeeds with no output yields
+ * `{exitCode: 0, stdout: '', stderr: '', timedOut: false}`.
+ */
+export interface ExecutionResult {
+    /** The exit code of the process. `0` on success. */
+    exitCode: number;
+    /** Standard output captured from the process. `''` when nothing was written. */
+    stdout: string;
+    /** Standard error captured from the process. `''` when nothing was written. */
+    stderr: string;
+    /** Whether the execution exceeded the timeout. `false` when it completed. */
+    timedOut: boolean;
+}
+/**
+ * Abstract base class for code execution environments.
+ *
+ * An environment provides the ability to execute shell commands, read files,
+ * and write files within a working directory. Concrete implementations include
+ * local subprocess execution, sandboxed execution, container environments, and
+ * cloud-hosted environments.
+ *
+ * Lifecycle:
+ * 1. Construct the environment.
+ * 2. Call {@link initialize} before first use.
+ * 3. Use {@link execute}, {@link readFile}, {@link writeFile}.
+ * 4. Call {@link close} when done.
+ */
+export declare abstract class BaseEnvironment {
+    /**
+     * Backing flag for {@link isInitialized}.
+     *
+     * Subclasses own this flag: set it in {@link initialize} and clear it in
+     * {@link close}.
+     */
+    protected initialized: boolean;
+    /** Whether the environment has been initialized. */
+    get isInitialized(): boolean;
+    /**
+     * 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}.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Releases resources held by the environment.
+     *
+     * The default implementation is a no-op. Subclasses must be idempotent and
+     * must clear {@link initialized}.
+     */
+    close(): Promise<void>;
+    /** The absolute path to the environment's working directory. */
+    abstract get workingDir(): string;
+    /**
+     * Executes a shell command in the working directory.
+     *
+     * @param command The shell command string to execute.
+     * @param timeoutSeconds Maximum execution time in seconds. `undefined` means
+     *   no limit.
+     * @returns The exit code, stdout, stderr, and timeout status. A non-zero exit
+     *   code is reported in the result, not thrown.
+     */
+    abstract execute(command: string, timeoutSeconds?: number): Promise<ExecutionResult>;
+    /**
+     * Reads a file from the environment's filesystem.
+     *
+     * @param filePath Absolute or working-dir-relative path to the file.
+     * @returns The raw file contents.
+     */
+    abstract readFile(filePath: string): Promise<Uint8Array>;
+    /**
+     * Writes content to a file in the environment's filesystem.
+     *
+     * Parent directories are created automatically if they do not exist.
+     *
+     * @param filePath Absolute or working-dir-relative path to the file.
+     * @param content The string or raw bytes to write.
+     */
+    abstract writeFile(filePath: string, content: string | Uint8Array): Promise<void>;
+    /**
+     * Throws if {@link initialize} has not been called.
+     *
+     * Implementations should call this at the start of every operation that needs
+     * a live working directory.
+     */
+    protected assertInitialized(): void;
+}

package/dist/types/environment/local_environment.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseEnvironment, ExecutionResult } from './base_environment.js';
+/** Options for {@link LocalEnvironment}. */
+export interface LocalEnvironmentOptions {
+    /**
+     * Absolute path to the workspace directory. Created by
+     * {@link LocalEnvironment.initialize} if it does not exist, and never deleted
+     * by {@link LocalEnvironment.close}. If omitted, a temporary directory is
+     * created on `initialize()` and removed on `close()`.
+     */
+    workingDir?: string;
+    /** Extra variables merged over `process.env` for every executed command. */
+    envVars?: Record<string, string>;
+}
+/**
+ * Executes commands via local child processes, scoped to a working directory.
+ *
+ * When `workingDir` is not specified, a temporary directory is created on
+ * {@link initialize} and removed on {@link close}.
+ *
+ * WARNING: this class runs arbitrary shell strings on the host with **no
+ * sandboxing** and no sanitisation — the caller is responsible for trusting the
+ * command. It is a building block; tools built on top of it are responsible for
+ * gating execution behind an explicit user confirmation.
+ *
+ * Further limitations, all shared with the adk-python reference implementation:
+ * - stdout and stderr are buffered fully in memory with no cap, so a command
+ *   producing unbounded output will grow the heap until it fails.
+ * - The child inherits the whole of `process.env`, so any secret in the parent
+ *   environment is visible to the command.
+ * - A timeout sends `SIGKILL` to the spawned shell; processes it forked itself
+ *   may survive, and anything they write after the kill is not captured. On
+ *   Windows such a survivor also keeps the working directory locked, so a
+ *   {@link close} following a timeout can fail to remove a temporary workspace.
+ * - File paths are confined to the working directory by a lexical check only
+ *   (see {@link readFile} and {@link writeFile}).
+ */
+export declare class LocalEnvironment extends BaseEnvironment {
+    private currentWorkingDir?;
+    private readonly envVars?;
+    private autoCreated;
+    constructor(options?: LocalEnvironmentOptions);
+    get workingDir(): string;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    execute(command: string, timeoutSeconds?: number): Promise<ExecutionResult>;
+    /**
+     * Reads a file from the working directory.
+     *
+     * `filePath` is confined to the working directory by a lexical check on the
+     * resolved path, which is not a sandbox.
+     *
+     * @throws If the environment is not initialized, if the path escapes the
+     *   working directory, or — as `ENOENT` — if the file does not exist.
+     */
+    readFile(filePath: string): Promise<Uint8Array>;
+    /**
+     * Writes a file in the working directory, creating parent directories.
+     *
+     * `filePath` is confined to the working directory by a lexical check on the
+     * resolved path, which is not a sandbox. No newline translation is applied,
+     * so explicit CRLF sequences are preserved.
+     *
+     * @throws If the environment is not initialized or the path escapes the
+     *   working directory.
+     */
+    writeFile(filePath: string, content: string | Uint8Array): Promise<void>;
+}

package/dist/types/errors/already_exists_error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Represents an error that occurs when an entity already exists.
+ */
+export declare class AlreadyExistsError extends Error {
+    /**
+     * @param message An optional custom message to describe the error.
+     */
+    constructor(message?: string);
+}

package/dist/types/errors/input_validation_error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Represents an error raised when user input fails validation.
+ */
+export declare class InputValidationError extends Error {
+    /**
+     * @param message A message describing why the input is invalid.
+     */
+    constructor(message?: string);
+}

package/dist/types/errors/not_found_error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Represents an error that occurs when an entity is not found.
+ */
+export declare class NotFoundError extends Error {
+    /**
+     * @param message An optional custom message to describe the error.
+     */
+    constructor(message?: string);
+}

package/dist/types/errors/session_not_found_error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Raised when a session cannot be found.
+ */
+export declare class SessionNotFoundError extends Error {
+    /**
+     * @param message An optional custom message to describe the error.
+     */
+    constructor(message?: string);
+}

package/dist/types/errors/tool_execution_error.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * HTTP error types conforming to OpenTelemetry semantics.
+ *
+ * The string values populate the `error.type` span attribute, so they are
+ * observable outside the process and must stay identical to the adk-python
+ * `ToolErrorType` members.
+ */
+export declare enum ToolErrorType {
+    BAD_REQUEST = "BAD_REQUEST",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    NOT_FOUND = "NOT_FOUND",
+    REQUEST_TIMEOUT = "REQUEST_TIMEOUT",
+    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+    BAD_GATEWAY = "BAD_GATEWAY",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    GATEWAY_TIMEOUT = "GATEWAY_TIMEOUT"
+}
+/**
+ * Represents an error that occurs during the execution of a tool.
+ */
+export declare class ToolExecutionError extends Error {
+    readonly errorType?: (ToolErrorType | string) | undefined;
+    /**
+     * @param message A message describing the error.
+     * @param errorType The semantic error type (e.g.
+     *   {@link ToolErrorType.REQUEST_TIMEOUT} or `'500'`). Used to populate the
+     *   `error.type` span attribute in OpenTelemetry traces.
+     */
+    constructor(message: string, errorType?: (ToolErrorType | string) | undefined);
+}

package/dist/types/events/event.d.ts

@@ -6,6 +6,53 @@
 import { FunctionCall, FunctionResponse } from '@google/genai';
 import { LlmResponse } from '../models/llm_response.js';
 import { EventActions } from './event_actions.js';
+/**
+ * A unique symbol identifying ADK Event objects.
+ *
+ * Events are plain objects produced by {@link createEvent} rather than class
+ * instances, so they carry this signature as a brand and `isEvent` checks for
+ * it — mirroring the `Symbol.for('google.adk.*')` guards used across ADK (e.g.
+ * `isBaseTool`, `isBaseAgent`).
+ */
+declare const EVENT_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * A single route key emitted by a routing node and matched against graph edge
+ * routes. Mirrors the graph's `RouteValue`.
+ */
+export type RouteKey = string | number | boolean;
+/**
+ * The route(s) a routing node emits: a single key fires one branch; an array
+ * fires every branch whose route matches any listed key (multi-route dispatch).
+ */
+export type Route = RouteKey | RouteKey[];
+/**
+ * Workflow-node provenance attached to an event.
+ *
+ * Mirrors `google/adk-python` `Event.node_info`. Present only on events emitted
+ * from within a workflow node.
+ */
+export interface NodeInfo {
+    /** The workflow node path that produced this event (e.g. `wf.child.0`). */
+    path?: string;
+    /**
+     * The node paths this event's output serves as the output for: the emitting
+     * node first, then any ancestor that delegated its own output to it.
+     *
+     * A node that runs a child with `useAsOutput` takes the child's output as its
+     * own, so one event is the result for several nodes at once. Recording that
+     * on the event is what lets a resumed run tell which nodes already produced a
+     * result, instead of re-running an ancestor whose output only ever existed on
+     * a descendant's event.
+     *
+     * Mirrors adk-python's `node_info.output_for`, which is likewise a list.
+     */
+    outputFor?: string[];
+    /**
+     * Whether the event's textual content should be promoted to the node's
+     * structured output.
+     */
+    messageAsOutput?: boolean;
+}
 /**
  * Represents an event in a conversation between agents and users.
 
@@ -13,6 +60,14 @@ import { EventActions } from './event_actions.js';
   taken by the agents like function calls, etc.
  */
 export interface Event extends LlmResponse {
+    /**
+     * Signature brand identifying this object as an ADK {@link Event}.
+     *
+     * Set by {@link createEvent} and checked by `isEvent`. Optional because
+     * events are also reconstructed from storage/session payloads, where the
+     * (non-serializable) brand is absent.
+     */
+    readonly [EVENT_SIGNATURE_SYMBOL]?: true;
     /**
      * The unique identifier of the event.
      * Do not assign the ID. It will be assigned by the session.
@@ -51,6 +106,36 @@ export interface Event extends LlmResponse {
      * The timestamp of the event.
      */
     timestamp: number;
+    /**
+     * Workflow: the structured output produced by the emitting node, if any.
+     *
+     * First-class field mirroring `google/adk-python` `Event.output`. Used by the
+     * workflow engine to carry a node's return value alongside its content.
+     */
+    output?: unknown;
+    /**
+     * Workflow: the route key(s) emitted by a routing node, used by the graph to
+     * select the matching outgoing edge(s). A single value fires one branch; an
+     * array fires every branch whose route matches any listed value (multi-route
+     * dispatch). Mirrors Python `Event.route`.
+     */
+    route?: Route;
+    /**
+     * Workflow: provenance of the emitting node. Mirrors Python `Event.node_info`.
+     */
+    nodeInfo?: NodeInfo;
+    /**
+     * Workflow: scope tag used to isolate multi-agent conversations so peer
+     * scopes don't see each other's events. Mirrors Python
+     * `Event.isolation_scope`.
+     */
+    isolationScope?: string;
+}
+/**
+ * Parameters for creating an event with partial fields.
+ */
+export interface CreateEventParams extends Omit<Partial<Event>, 'actions'> {
+    actions?: Partial<EventActions>;
 }
 /**
  * Creates an event from a partial event.
@@ -58,7 +143,7 @@ export interface Event extends LlmResponse {
  * @param params The partial event to create the event from.
  * @returns The event.
  */
-export declare function createEvent(params?: Partial<Event>): Event;
+export declare function createEvent(params?: CreateEventParams): Event;
 /**
  * Returns whether the event is the final response of the agent.
  */
@@ -103,6 +188,13 @@ export declare function hasThoughts(event: Event): boolean;
  * Returns a copy of the event with all thought parts removed.
  */
 export declare function pruneThoughts(event: Event): Event;
+/**
+ * Type guard to check if an object is an instance of Event.
+ *
+ * @param obj The object to check.
+ * @returns True if the object matches the Event structure.
+ */
+export declare function isEvent(obj: unknown): obj is Event;
 /**
  * Generates a new unique ID for the event.
  */
@@ -121,3 +213,4 @@ export declare function transformToCamelCaseEvent(event: Record<string, unknown>
  * @returns The snake_cased Event object.
  */
 export declare function transformToSnakeCaseEvent(event: Event): Record<string, unknown>;
+export {};

package/dist/types/events/event_actions.d.ts

@@ -56,6 +56,16 @@ export interface EventActions {
     requestedToolConfirmations: {
         [key: string]: ToolConfirmation;
     };
+    /**
+     * Workflow: a serialized node/agent state snapshot used for resumable
+     * checkpointing. Mirrors Python `EventActions.agent_state`.
+     */
+    agentState?: Record<string, unknown>;
+    /**
+     * Workflow: marks that the emitting agent/workflow has reached the end of its
+     * execution for this invocation. Mirrors Python `EventActions.end_of_agent`.
+     */
+    endOfAgent?: boolean;
 }
 /**
  * Creates an {@link EventActions} object with default empty-dict values for
@@ -69,6 +79,19 @@ export interface EventActions {
  * @returns A fully populated {@link EventActions} object.
  */
 export declare function createEventActions(state?: Partial<EventActions>): EventActions;
+/**
+ * Returns whether the given {@link EventActions} still holds only its default
+ * values, i.e. the event carries no state, artifact, auth, confirmation,
+ * transfer, escalation or summarization signal.
+ *
+ * An actions object is considered non-default when any dictionary field has at
+ * least one entry, or when any scalar field has been explicitly set (including
+ * being set to `false`).
+ *
+ * @param actions - The actions to inspect.
+ * @returns `true` when every field is at its default value.
+ */
+export declare function isDefaultEventActions(actions: EventActions): boolean;
 /**
  * Merges a list of {@link EventActions} objects into a single
  * {@link EventActions} object.