@google/adk 1.1.0 → 1.3.0

package/dist/types/agents/invocation_context.d.ts

@@ -12,7 +12,6 @@ import { BaseSessionService } from '../sessions/base_session_service.js';
 import { Session } from '../sessions/session.js';
 import { ActiveStreamingTool } from './active_streaming_tool.js';
 import { BaseAgent } from './base_agent.js';
-import { LiveRequestQueue } from './live_request_queue.js';
 import { RunConfig } from './run_config.js';
 import { TranscriptionEntry } from './transcription_entry.js';
 /**
@@ -31,7 +30,6 @@ export interface InvocationContextParams {
     endInvocation?: boolean;
     transcriptionCache?: TranscriptionEntry[];
     runConfig?: RunConfig;
-    liveRequestQueue?: LiveRequestQueue;
     activeStreamingTools?: Record<string, ActiveStreamingTool>;
     pluginManager: PluginManager;
     abortSignal?: AbortSignal;
@@ -124,10 +122,6 @@ export declare class InvocationContext {
      * this invocation.
      */
     private readonly invocationCostManager;
-    /**
-     * The queue to receive live requests.
-     */
-    liveRequestQueue?: LiveRequestQueue;
     /**
      * The running streaming tools of this invocation.
      */
@@ -136,9 +130,6 @@ export declare class InvocationContext {
      * The manager for keeping track of plugins in this invocation.
      */
     pluginManager: PluginManager;
-    /**
-     * The abort signal for the invocation.
-     */
     readonly abortSignal?: AbortSignal;
     /**
      * @param params The parameters for creating an invocation context.

package/dist/types/agents/llm_agent.d.ts

@@ -327,6 +327,20 @@ export declare class LlmAgent extends BaseAgent {
     private maybeSaveOutputToState;
     protected runAsyncImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
     protected runLiveImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
+    /**
+     * Runs the bidirectional (live) flow for this agent.
+     *
+     * Establishes a live connection to the model, drains the invocation's
+     * `liveRequestQueue` into the connection on a parallel task, and yields
+     * events derived from server messages until the queue closes, the model
+     * finishes, or an agent transfer occurs.
+     *
+     * If the live connection drops (network failure, server `goAway`) and a
+     * session resumption handle has been observed, the flow transparently
+     * reconnects using that handle up to {@link MAX_LIVE_RECONNECT_ATTEMPTS}
+     * times. Subsequent reconnects skip `sendHistory` because the server
+     * already holds the conversation state associated with the handle.
+     */
     private runLiveFlow;
     private runOneStepAsync;
     private postprocess;

package/dist/types/agents/processors/agent_transfer_llm_request_processor.d.ts

@@ -7,9 +7,23 @@ import { Event } from '../../events/event.js';
 import { LlmRequest } from '../../models/llm_request.js';
 import { InvocationContext } from '../invocation_context.js';
 import { BaseLlmRequestProcessor } from './base_llm_processor.js';
+/**
+ * Augments the {@link LlmRequest} to support agent transfer. When the current
+ * agent has reachable transfer targets (sub-agents, peer agents, or a parent
+ * agent), this processor registers a `transfer_to_agent` function tool and
+ * appends instructions describing each candidate so the model can choose to
+ * hand off control.
+ */
 export declare class AgentTransferLlmRequestProcessor extends BaseLlmRequestProcessor {
     private readonly toolName;
     private readonly tool;
+    /**
+     * Appends transfer instructions and registers the `transfer_to_agent` tool
+     * when the agent has reachable transfer targets.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request to augment with transfer instructions and the transfer tool.
+     */
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
     private buildTargetAgentsInfo;
     private buildTargetAgentsInstructions;

package/dist/types/agents/processors/base_llm_processor.d.ts

@@ -8,20 +8,28 @@ import { LlmRequest } from '../../models/llm_request.js';
 import { LlmResponse } from '../../models/llm_response.js';
 import { InvocationContext } from '../invocation_context.js';
 /**
- * Base class for LLM request processor.
+ * Base class for LLM request processors. Implementations mutate or augment
+ * the {@link LlmRequest} before it is sent to the model.
  */
 export declare abstract class BaseLlmRequestProcessor {
     /**
-     * Runs the processor.
+     * Runs the processor, optionally yielding intermediate {@link Event}s.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request object to populate or mutate in place.
      */
     abstract runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
 }
 /**
- * Base class for LLM response processor.
+ * Base class for LLM response processors. Implementations inspect or
+ * transform the {@link LlmResponse} after it is received from the model.
  */
 export declare abstract class BaseLlmResponseProcessor {
     /**
-     * Processes the LLM response.
+     * Runs the processor, optionally yielding intermediate {@link Event}s.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmResponse - The response received from the model.
      */
     abstract runAsync(invocationContext: InvocationContext, llmResponse: LlmResponse): AsyncGenerator<Event, void, void>;
 }

package/dist/types/agents/processors/basic_llm_request_processor.d.ts

@@ -7,7 +7,19 @@ import { Event } from '../../events/event.js';
 import { LlmRequest } from '../../models/llm_request.js';
 import { InvocationContext } from '../invocation_context.js';
 import { BaseLlmRequestProcessor } from './base_llm_processor.js';
+/**
+ * Populates the {@link LlmRequest} with model configuration derived from the
+ * agent, including the model name, generation config, output schema, and live
+ * connect settings.
+ */
 export declare class BasicLlmRequestProcessor extends BaseLlmRequestProcessor {
+    /**
+     * Populates model name, generation config, output schema, and live connect
+     * settings on the request from the agent and run config.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request object to populate in place.
+     */
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
 }
 export declare const BASIC_LLM_REQUEST_PROCESSOR: BasicLlmRequestProcessor;

package/dist/types/agents/processors/content_processor_utils.d.ts

@@ -34,3 +34,29 @@ export declare function getContents(events: Event[], agentName: string, currentB
  *     needed for proper tool execution while excluding conversation history.
  */
 export declare function getCurrentTurnContents(events: Event[], agentName: string, currentBranch?: string): Content[];
+/**
+ * Merges a list of function_response events into one event.
+ *
+ * The key goal is to ensure:
+ *  1. function_call and function_response are always of the same number.
+ *  2. The function_call and function_response are consecutively in the content.
+ *
+ * @param events: A list of function_response events.
+ *
+ * NOTE:
+ * function_response_events must fulfill these requirements:
+ * 1. The list is in increasing order of timestamp;
+ * 2. the first event is the initial function_response event;
+ * 3. all later events should contain at least one function_response part that
+ * related to the function_call event. Caveat: This implementation doesn't
+ * support when a parallel function_call event contains async function_call of
+ * the same name.
+ *
+ * @returns
+ *    A merged event, that is
+ *      1. All later function_response will replace function_response part in
+ *          the initial function_response event.
+ *      2. All non-function_response parts will be appended to the part list of
+ *          the initial function_response event.
+ */
+export declare function mergeFunctionResponseEvents(events: Event[]): Event;

package/dist/types/agents/processors/content_request_processor.d.ts

@@ -7,7 +7,23 @@ import { Event } from '../../events/event.js';
 import { LlmRequest } from '../../models/llm_request.js';
 import { InvocationContext } from '../invocation_context.js';
 import { BaseLlmRequestProcessor } from './base_llm_processor.js';
+/**
+ * Populates {@link LlmRequest.contents} from the session event history.
+ *
+ * When a {@link CompactedEvent} exists in the session, only the most recent
+ * compacted event and the raw events that follow it are included, eliding
+ * earlier history. The extent of context included depends on the agent's
+ * `includeContents` setting: `'default'` sends the full visible history while
+ * any other value sends only the current-turn context.
+ */
 export declare class ContentRequestProcessor implements BaseLlmRequestProcessor {
+    /**
+     * Fills {@link LlmRequest.contents} based on the session event history and
+     * agent configuration.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request whose contents field will be populated.
+     */
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
 }
 export declare const CONTENT_REQUEST_PROCESSOR: ContentRequestProcessor;

package/dist/types/agents/processors/context_compactor_request_processor.d.ts

@@ -17,6 +17,18 @@ import { BaseLlmRequestProcessor } from './base_llm_processor.js';
  */
 export declare class ContextCompactorRequestProcessor implements BaseLlmRequestProcessor {
     private compactors;
+    /**
+     * @param compactors - Ordered list of compactors to evaluate; the first one
+     *   that reports it should compact will perform the compaction.
+     */
     constructor(compactors: BaseContextCompactor[]);
+    /**
+     * Evaluates compactors in priority order. The first compactor that indicates
+     * it should compact will compact the session history, fire plugin hooks, and
+     * yield any newly generated events. Iteration stops after one compaction.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param _llmRequest - Unused; present to satisfy the {@link BaseLlmRequestProcessor} interface.
+     */
     runAsync(invocationContext: InvocationContext, _llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
 }

package/dist/types/agents/processors/identity_llm_request_processor.d.ts

@@ -7,7 +7,18 @@ import { Event } from '../../events/event.js';
 import { LlmRequest } from '../../models/llm_request.js';
 import { InvocationContext } from '../invocation_context.js';
 import { BaseLlmRequestProcessor } from './base_llm_processor.js';
+/**
+ * Appends identity instructions to the {@link LlmRequest} system prompt,
+ * informing the model of the agent's name and description.
+ */
 export declare class IdentityLlmRequestProcessor extends BaseLlmRequestProcessor {
+    /**
+     * Appends agent name and description as identity instructions to the system
+     * prompt of the request.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request object to append instructions to.
+     */
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, undefined>;
 }
 export declare const IDENTITY_LLM_REQUEST_PROCESSOR: IdentityLlmRequestProcessor;

package/dist/types/agents/processors/request_confirmation_llm_request_processor.d.ts

@@ -6,8 +6,21 @@
 import { Event } from '../../events/event.js';
 import { InvocationContext } from '../invocation_context.js';
 import { BaseLlmRequestProcessor } from './base_llm_processor.js';
+/**
+ * Resumes tool calls that were paused for user confirmation. Scans the session
+ * event history for pending confirmation responses and re-invokes the
+ * corresponding tools before the next LLM turn.
+ */
 export declare class RequestConfirmationLlmRequestProcessor extends BaseLlmRequestProcessor {
-    /** Handles tool confirmation information to build the LLM request. */
+    /**
+     * Resumes tool calls that were paused for user confirmation, re-invoking
+     * them with the confirmed or denied decision before the next LLM turn.
+     *
+     * @param invocationContext - The current invocation context, including the
+     *   session event history used to locate pending confirmation responses.
+     * @yields Function response events for tools that have been confirmed and
+     *   are ready to resume.
+     */
     runAsync(invocationContext: InvocationContext): AsyncGenerator<Event, void, void>;
 }
 export declare const REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR: RequestConfirmationLlmRequestProcessor;

package/dist/types/agents/processors/tool_filter_request_processor.d.ts

@@ -7,8 +7,19 @@ import { Event } from '../../events/event.js';
 import { LlmRequest } from '../../models/llm_request.js';
 import { InvocationContext } from '../invocation_context.js';
 import { BaseLlmRequestProcessor } from './base_llm_processor.js';
+/**
+ * Filters the set of tools on the {@link LlmRequest} by delegating to the
+ * active plugin manager's `beforeToolSelection` hook. If no plugin restricts
+ * the tool set, the request is left unchanged.
+ */
 export declare class ToolFilterRequestProcessor extends BaseLlmRequestProcessor {
-    /** Filters the set of tools on the request based on plugins. */
+    /**
+     * Invokes plugin-based tool filtering and updates {@link LlmRequest.allowedTools}
+     * with the reduced tool set if any plugin returns a filtered result.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request whose allowed tools may be restricted.
+     */
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
 }
 export declare const TOOL_FILTER_REQUEST_PROCESSOR: ToolFilterRequestProcessor;

package/dist/types/agents/run_config.d.ts

@@ -78,6 +78,21 @@ export interface RunConfig {
      */
     pauseOnToolCalls?: boolean;
 }
+/**
+ * Creates a {@link RunConfig} with production-safe defaults.
+ *
+ * Default values applied when the corresponding field is absent from `params`:
+ * - `saveInputBlobsAsArtifacts` → `false`
+ * - `supportCfc` → `false`
+ * - `enableAffectiveDialog` → `false`
+ * - `streamingMode` → {@link StreamingMode.NONE}
+ * - `maxLlmCalls` → `500` (validated via `validateMaxLlmCalls`)
+ * - `pauseOnToolCalls` → `false`
+ *
+ * @param params - Optional partial {@link RunConfig} overriding defaults.
+ * @returns A merged {@link RunConfig} object.
+ * @throws {Error} When `params.maxLlmCalls` exceeds `Number.MAX_SAFE_INTEGER`.
+ */
 export declare function createRunConfig(params?: Partial<RunConfig>): {
     speechConfig?: SpeechConfig | undefined;
     responseModalities?: Modality[] | undefined;

package/dist/types/code_executors/agent_engine_sandbox_code_executor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Client } from '@google-cloud/vertexai';
+import { BaseCodeExecutor, ExecuteCodeParams } from './base_code_executor.js';
+import { CodeExecutionResult } from './code_execution_utils.js';
+/**
+ * Options for AgentEngineSandboxCodeExecutor.
+ */
+export interface AgentEngineSandboxCodeExecutorOptions {
+    /**
+     * If set, load the existing resource name of the code execution sandbox.
+     * Format: projects/123/locations/us-central1/reasoningEngines/456/sandboxEnvironments/789
+     */
+    sandboxResourceName?: string;
+    /**
+     * The resource name of the agent engine to use to create the code execution sandbox.
+     * Format: projects/123/locations/us-central1/reasoningEngines/456
+     */
+    agentEngineResourceName?: string;
+    /**
+     * Project ID to use. If not provided, read from GOOGLE_CLOUD_PROJECT env var.
+     */
+    projectId?: string;
+    /**
+     * Location to use. If not provided, read from GOOGLE_CLOUD_LOCATION env var or default to 'us-central1'.
+     */
+    location?: string;
+    /**
+     * Optional client instance to use. If not provided, a new one will be created.
+     * Primarily for testing.
+     */
+    client?: Client;
+}
+/**
+ * A code executor that uses Agent Engine Code Execution Sandbox to execute code.
+ */
+export declare class AgentEngineSandboxCodeExecutor extends BaseCodeExecutor {
+    sandboxResourceName?: string;
+    agentEngineResourceName?: string;
+    private projectId?;
+    private location?;
+    private client;
+    private agentEngineCreationPromise?;
+    constructor(options?: AgentEngineSandboxCodeExecutorOptions);
+    executeCode(params: ExecuteCodeParams): Promise<CodeExecutionResult>;
+    private getOrCreateAgentEngine;
+    private getOrCreateSandbox;
+}

package/dist/types/common.d.ts

@@ -34,6 +34,7 @@ export { InMemoryArtifactService } from './artifacts/in_memory_artifact_service.
 export { AuthCredentialTypes } from './auth/auth_credential.js';
 export type { AuthCredential, HttpAuth, HttpCredentials, OAuth2Auth, ServiceAccount, ServiceAccountCredential, } from './auth/auth_credential.js';
 export { AuthHandler } from './auth/auth_handler.js';
+export { AUTH_PREPROCESSOR, AuthPreprocessor } from './auth/auth_preprocessor.js';
 export { AuthProviderRegistry } from './auth/auth_provider_registry.js';
 export { OAuthGrantType } from './auth/auth_schemes.js';
 export type { AuthScheme, OpenIdConnectWithConfig } from './auth/auth_schemes.js';
@@ -73,6 +74,8 @@ 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';
@@ -108,6 +111,7 @@ export type { ToolPredicate } from './tools/base_toolset.js';
 export { EXIT_LOOP, ExitLoopTool } from './tools/exit_loop_tool.js';
 export { FunctionTool, isFunctionTool } from './tools/function_tool.js';
 export type { ToolExecuteArgument, ToolExecuteFunction, ToolInputParameters, ToolOptions, } from './tools/function_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';
@@ -117,17 +121,31 @@ export { ToolConfirmation } 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 { LogLevel, getLogger, setLogLevel, setLogger } from './utils/logger.js';
 export type { Logger } from './utils/logger.js';
-export { isGemini2OrAbove } from './utils/model_name.js';
+export { isGemini2OrAbove, isGemini3xFlashLive } from './utils/model_name.js';
 export { zodObjectToSchema } from './utils/simple_zod_to_json.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 { 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 './artifacts/base_artifact_service.js';
 export * from './features/feature_registry.js';
 export * from './memory/base_memory_service.js';

package/dist/types/context/summarizers/llm_summarizer.d.ts

@@ -7,8 +7,14 @@ import { CompactedEvent } from '../../events/compacted_event.js';
 import { Event } from '../../events/event.js';
 import { BaseLlm } from '../../models/base_llm.js';
 import { BaseSummarizer } from './base_summarizer.js';
+/** Options for constructing an {@link LlmSummarizer}. */
 export interface LlmSummarizerOptions {
+    /** The LLM instance used to generate the summary. */
     llm: BaseLlm;
+    /**
+     * Optional system prompt prepended to the formatted events. Defaults to a
+     * built-in summarization prompt when omitted.
+     */
     prompt?: string;
 }
 /**
@@ -18,6 +24,17 @@ export interface LlmSummarizerOptions {
 export declare class LlmSummarizer implements BaseSummarizer {
     private readonly llm;
     private readonly prompt;
+    /**
+     * @param options - Configuration specifying the LLM and optional prompt.
+     */
     constructor(options: LlmSummarizerOptions);
+    /**
+     * Summarizes a list of events into a single {@link CompactedEvent} using the
+     * configured LLM.
+     *
+     * @param events - The events to summarize. Must be non-empty.
+     * @returns A promise resolving to the compacted representation.
+     * @throws {Error} If `events` is empty or the LLM returns no content.
+     */
     summarize(events: Event[]): Promise<CompactedEvent>;
 }

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

@@ -3,8 +3,8 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { AuthConfig } from '../auth/auth_tool.js';
 import { ToolConfirmation } from '../tools/tool_confirmation.js';
-type AuthConfig = any;
 /**
  * Represents the actions attached to an event.
  */
@@ -58,17 +58,34 @@ export interface EventActions {
     };
 }
 /**
- * Creates an EventActions object.
+ * Creates an {@link EventActions} object with default empty-dict values for
+ * all dictionary fields.
+ *
+ * @param state - Optional partial {@link EventActions} whose properties
+ *   override the defaults. Dictionary fields (`stateDelta`, `artifactDelta`,
+ *   `requestedAuthConfigs`, `requestedToolConfirmations`) default to `{}`;
+ *   scalar fields (`skipSummarization`, `transferToAgent`, `escalate`) default
+ *   to `undefined`.
+ * @returns A fully populated {@link EventActions} object.
  */
 export declare function createEventActions(state?: Partial<EventActions>): EventActions;
 /**
- * Merges a list of EventActions objects into a single EventActions object.
+ * Merges a list of {@link EventActions} objects into a single
+ * {@link EventActions} object.
  *
- * 1. It merges dictionaries (stateDelta, artifactDelta, requestedAuthConfigs)
- * by adding all the properties from each source.
+ * Merge semantics:
+ * 1. **Dictionary fields** (`stateDelta`, `artifactDelta`,
+ *    `requestedAuthConfigs`, `requestedToolConfirmations`) — all entries from
+ *    every source are combined via `Object.assign`. Later sources win on
+ *    duplicate keys.
+ * 2. **Scalar fields** (`skipSummarization`, `transferToAgent`, `escalate`) —
+ *    last-writer-wins: the value from the last source that sets the field is
+ *    kept.
  *
- * 2. For other properties (skipSummarization,transferToAgent, escalate), the
- * last one wins.
+ * @param sources - Ordered list of partial {@link EventActions} to merge.
+ *   Falsy entries are silently skipped.
+ * @param target - Optional base {@link EventActions} to merge into. When
+ *   provided it is used as the starting state before applying `sources`.
+ * @returns A new {@link EventActions} containing the merged result.
  */
 export declare function mergeEventActions(sources: Array<Partial<EventActions>>, target?: EventActions): EventActions;
-export {};

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

@@ -7,17 +7,30 @@ import { CodeExecutionResult, ExecutableCode, FunctionCall, FunctionResponse } f
 import { Event } from './event.js';
 /**
  * The types of events that can be parsed from a raw Event.
+ *
+ * Each value corresponds to one category of structured output that
+ * {@link toStructuredEvents} may produce from a raw {@link Event}.
  */
 export declare enum EventType {
+    /** A reasoning trace (thought) emitted by the model. */
     THOUGHT = "thought",
+    /** A text delta intended for the end user. */
     CONTENT = "content",
+    /** A request from the model to execute a tool (function call). */
     TOOL_CALL = "tool_call",
+    /** The result returned by a tool execution (function response). */
     TOOL_RESULT = "tool_result",
+    /** A request from the model to execute code. */
     CALL_CODE = "call_code",
+    /** The result of a code execution. */
     CODE_RESULT = "code_result",
+    /** A runtime error signalled via `event.errorCode`. */
     ERROR = "error",
+    /** A generic activity or status update. */
     ACTIVITY = "activity",
+    /** A request for the user to confirm one or more tool calls. */
     TOOL_CONFIRMATION = "tool_confirmation",
+    /** The agent has produced its final response for this turn. */
     FINISHED = "finished"
 }
 /**

package/dist/types/examples/example_util.d.ts

@@ -8,6 +8,31 @@ import { Example } from './example.js';
 /**
  * Converts a list of examples to a string that can be used in a system
  * instruction.
+ *
+ * When `model` is undefined or contains `"gemini-2"`, function calls and
+ * responses are formatted with plain triple-backtick fences. For other model
+ * names the legacy `tool_code` / `tool_outputs` fences are used instead.
+ *
+ * @param examples - The few-shot examples to convert.
+ * @param model - Optional model name used to select the function-call fence
+ *   style. Defaults to the gemini-2 style when omitted.
+ * @returns A formatted string wrapped in `<EXAMPLES>…</EXAMPLES>` tags,
+ *   suitable for inclusion in a system instruction.
  */
 export declare function convertExamplesToText(examples: Example[], model?: string): string;
+/**
+ * Builds the few-shot portion of a system instruction from a list of examples
+ * or a {@link BaseExampleProvider}.
+ *
+ * @param examples - Either an array of {@link Example} objects or a
+ *   {@link BaseExampleProvider} whose `getExamples` method is called with
+ *   `query` to obtain the examples dynamically.
+ * @param query - The user query passed to {@link BaseExampleProvider.getExamples}
+ *   when `examples` is a provider. Ignored when `examples` is an array.
+ * @param model - Optional model name forwarded to
+ *   {@link convertExamplesToText} to select the function-call fence style.
+ * @returns A formatted string ready to be appended to a system instruction.
+ * @throws {Error} When `examples` is neither an array nor a
+ *   {@link BaseExampleProvider}.
+ */
 export declare function buildExampleSi(examples: Example[] | BaseExampleProvider, query: string, model?: string): string;

package/dist/types/index.d.ts

@@ -11,16 +11,22 @@ export type { AfterEventCallback, AfterExecuteCallback, AgentExecutorConfig, Bef
 export { toA2a } from './a2a/agent_to_a2a.js';
 export type { ToA2aOptions } from './a2a/agent_to_a2a.js';
 export type { ExecutorContext } from './a2a/executor_context.js';
+export { InvocationContext } from './agents/invocation_context.js';
 export { FileArtifactService } from './artifacts/file_artifact_service.js';
 export { GcsArtifactService } from './artifacts/gcs_artifact_service.js';
 export { getArtifactServiceFromUri } from './artifacts/registry.js';
+export { AgentEngineSandboxCodeExecutor, type AgentEngineSandboxCodeExecutorOptions, } from './code_executors/agent_engine_sandbox_code_executor.js';
+export { CodeExecutionLanguage } from './code_executors/code_execution_utils.js';
 export { UnsafeLocalCodeExecutor, type UnsafeLocalCodeExecutorOptions, } from './code_executors/unsafe_local_code_executor.js';
 export * from './common.js';
 export { DatabaseSessionService } from './sessions/database_session_service.js';
 export { getSessionServiceFromUri } from './sessions/registry.js';
+export { VertexAiSessionService } from './sessions/vertex_ai_session_service.js';
+export type { VertexAiSessionServiceOptions } from './sessions/vertex_ai_session_service.js';
 export { loadAllSkillsInDir, loadSkillFromDir, validateSkillDir, } from './skills/loader.js';
 export { RunSkillInlineScriptTool } from './tools/skill/run_skill_inline_script_tool.js';
 export { RunSkillScriptTool } from './tools/skill/run_skill_script_tool.js';
+export * from './integrations/agent_registry/agent_registry.js';
 export * from './telemetry/google_cloud.js';
 export * from './telemetry/setup.js';
 export * from './tools/mcp/mcp_session_manager.js';