@google/adk 1.3.0 → 1.5.0

package/dist/types/artifacts/base_artifact_service.d.ts

@@ -4,16 +4,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Part } from '@google/genai';
+import { CompositeSessionKey } from '../sessions/session.js';
 /**
  * The parameters for `saveArtifact`.
  */
-export interface SaveArtifactRequest {
-    /** The app name. */
-    appName: string;
-    /** The user ID. */
-    userId: string;
-    /** The session ID. */
-    sessionId: string;
+export interface SaveArtifactRequest extends CompositeSessionKey {
     /** The filename of the artifact. */
     filename: string;
     /** The artifact to save. */
@@ -26,13 +21,7 @@ export interface SaveArtifactRequest {
 /**
  * The parameters for `loadArtifact`.
  */
-export interface LoadArtifactRequest {
-    /** The app name. */
-    appName: string;
-    /** The user ID. */
-    userId: string;
-    /** The session ID. */
-    sessionId: string;
+export interface LoadArtifactRequest extends CompositeSessionKey {
     /** The filename of the artifact. */
     filename: string;
     /**
@@ -44,37 +33,18 @@ export interface LoadArtifactRequest {
 /**
  * The parameters for `listArtifactKeys`.
  */
-export interface ListArtifactKeysRequest {
-    /** The app name. */
-    appName: string;
-    /** The user ID. */
-    userId: string;
-    /** The session ID. */
-    sessionId: string;
-}
+export type ListArtifactKeysRequest = CompositeSessionKey;
 /**
  * The parameters for `deleteArtifact`.
  */
-export interface DeleteArtifactRequest {
-    /** The app name. */
-    appName: string;
-    /** The user ID. */
-    userId: string;
-    /** The session ID. */
-    sessionId: string;
+export interface DeleteArtifactRequest extends CompositeSessionKey {
     /** The filename of the artifact. */
     filename: string;
 }
 /**
  * The parameters for `listVersions`.
  */
-export interface ListVersionsRequest {
-    /** The app name. */
-    appName: string;
-    /** The user ID. */
-    userId: string;
-    /** The session ID. */
-    sessionId: string;
+export interface ListVersionsRequest extends CompositeSessionKey {
     /** The filename of the artifact. */
     filename: string;
 }

package/dist/types/artifacts/gcs_artifact_service.d.ts

@@ -3,11 +3,12 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { StorageOptions } from '@google-cloud/storage';
 import { Part } from '@google/genai';
 import { ArtifactVersion, BaseArtifactService, DeleteArtifactRequest, ListArtifactKeysRequest, ListVersionsRequest, LoadArtifactRequest, SaveArtifactRequest } from './base_artifact_service.js';
 export declare class GcsArtifactService implements BaseArtifactService {
     private readonly bucket;
-    constructor(bucket: string);
+    constructor(bucket: string, options?: StorageOptions);
     saveArtifact(request: SaveArtifactRequest): Promise<number>;
     loadArtifact(request: LoadArtifactRequest): Promise<Part | undefined>;
     listArtifactKeys(request: ListArtifactKeysRequest): Promise<string[]>;

package/dist/types/artifacts/scoped_artifact_service.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Part } from '@google/genai';
+import { ArtifactVersion, BaseArtifactService } from './base_artifact_service.js';
+import { SessionArtifactService, SessionLoadArtifactRequest, SessionSaveArtifactRequest } from './session_artifact_service.js';
+/**
+ * A wrapper that scopes a BaseArtifactService to a specific session.
+ */
+export declare class ScopedArtifactService implements SessionArtifactService {
+    private readonly delegate;
+    private readonly appName;
+    private readonly userId;
+    private readonly sessionId;
+    constructor(delegate: BaseArtifactService, appName: string, userId: string, sessionId: string);
+    saveArtifact(request: SessionSaveArtifactRequest): Promise<number>;
+    loadArtifact(request: SessionLoadArtifactRequest): Promise<Part | undefined>;
+    listArtifactKeys(): Promise<string[]>;
+    deleteArtifact(filename: string): Promise<void>;
+    listVersions(filename: string): Promise<number[]>;
+    listArtifactVersions(filename: string): Promise<ArtifactVersion[]>;
+    getArtifactVersion(request: SessionLoadArtifactRequest): Promise<ArtifactVersion | undefined>;
+}

package/dist/types/artifacts/session_artifact_service.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Part } from '@google/genai';
+import { ArtifactVersion } from './base_artifact_service.js';
+export interface SessionSaveArtifactRequest {
+    filename: string;
+    artifact: Part;
+    customMetadata?: Record<string, unknown>;
+}
+export interface SessionLoadArtifactRequest {
+    filename: string;
+    version?: number;
+}
+export interface SessionArtifactService {
+    saveArtifact(request: SessionSaveArtifactRequest): Promise<number>;
+    loadArtifact(request: SessionLoadArtifactRequest): Promise<Part | undefined>;
+    listArtifactKeys(): Promise<string[]>;
+    deleteArtifact(filename: string): Promise<void>;
+    listVersions(filename: string): Promise<number[]>;
+    listArtifactVersions(filename: string): Promise<ArtifactVersion[]>;
+    getArtifactVersion(request: SessionLoadArtifactRequest): Promise<ArtifactVersion | undefined>;
+}

package/dist/types/auth/oauth2/oauth2_discovery.d.ts

@@ -36,3 +36,14 @@ export declare class OAuth2DiscoveryManager {
      */
     discoverResourceMetadata(resourceUrl: string): Promise<ProtectedResourceMetadata | undefined>;
 }
+/**
+ * Normalises the hostname returned by the WHATWG URL parser so that
+ * IPv4-mapped IPv6 addresses (e.g. [::ffff:7f00:1]) are converted to
+ * their canonical dotted-decimal IPv4 form (127.0.0.1) before any
+ * blocklist checks are applied.
+ *
+ * Without this step an attacker can bypass every IPv4 block by encoding
+ * the address as its IPv4-mapped IPv6 equivalent (CWE-918).
+ */
+export declare function normaliseHostname(raw: string): string;
+export declare function validateDiscoveryUrl(urlStr: string): boolean;

package/dist/types/common.d.ts

@@ -8,7 +8,7 @@ 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 { functionsExportedForTestingOnly } from './agents/functions.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 { LiveRequestQueue } from './agents/live_request_queue.js';
@@ -22,6 +22,7 @@ export { AgentTransferLlmRequestProcessor } from './agents/processors/agent_tran
 export { BaseLlmRequestProcessor, BaseLlmResponseProcessor, } from './agents/processors/base_llm_processor.js';
 export { CONTENT_REQUEST_PROCESSOR, ContentRequestProcessor, } from './agents/processors/content_request_processor.js';
 export { ContextCompactorRequestProcessor } from './agents/processors/context_compactor_request_processor.js';
+export { INTERACTIONS_REQUEST_PROCESSOR, InteractionsRequestProcessor, } from './agents/processors/interactions_request_processor.js';
 export { ReadonlyContext } from './agents/readonly_context.js';
 export { RoutedAgent, isRoutedAgent } from './agents/routed_agent.js';
 export type { AgentRouter, RoutedAgentConfig } from './agents/routed_agent.js';
@@ -29,8 +30,11 @@ 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 { 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 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';
 export { AuthHandler } from './auth/auth_handler.js';
@@ -53,17 +57,22 @@ export { BaseCodeExecutor } from './code_executors/base_code_executor.js';
 export type { ExecuteCodeParams } from './code_executors/base_code_executor.js';
 export { BuiltInCodeExecutor } from './code_executors/built_in_code_executor.js';
 export { CodeExecutionLanguage, FileContentEncoding, type CodeExecutionInput, type CodeExecutionResult, type File, } from './code_executors/code_execution_utils.js';
+export { AgentControlledContextCompactor } from './context/agent_controlled_context_compactor.js';
+export { AnchoredContextCompactor } from './context/anchored_context_compactor.js';
+export type { AnchoredContextCompactorOptions } from './context/anchored_context_compactor.js';
 export type { BaseContextCompactor } from './context/base_context_compactor.js';
 export type { BaseSummarizer } from './context/summarizers/base_summarizer.js';
 export { LlmSummarizer } from './context/summarizers/llm_summarizer.js';
 export type { LlmSummarizerOptions } from './context/summarizers/llm_summarizer.js';
 export { TokenBasedContextCompactor } from './context/token_based_context_compactor.js';
 export type { TokenBasedContextCompactorOptions } from './context/token_based_context_compactor.js';
+export { TrajectoryThoughtPruningCompactor } from './context/trajectory_thought_pruning_compactor.js';
+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 { isCompactedEvent } from './events/compacted_event.js';
+export { isCompactedEvent, isScratchpadEvent } from './events/compacted_event.js';
 export type { CompactedEvent } from './events/compacted_event.js';
-export { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse, stringifyContent, } from './events/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 { createEventActions } from './events/event_actions.js';
 export type { EventActions } from './events/event_actions.js';
@@ -89,18 +98,19 @@ export type { BaseLlmType } from './models/registry.js';
 export { RoutedLlm } from './models/routed_llm.js';
 export type { LlmRouter } from './models/routed_llm.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 type { BasePolicyEngine, PolicyCheckResult, ToolCallPolicyContext, } from './plugins/security_plugin.js';
 export { InMemoryRunner } from './runner/in_memory_runner.js';
-export { Runner, isRunner } from './runner/runner.js';
+export { Runner, determineAgentForResumption, findEventByLastFunctionResponseId, isRoutableLlmAgent, isRunner, } from './runner/runner.js';
 export type { RunnerConfig } from './runner/runner.js';
 export { BaseSessionService } from './sessions/base_session_service.js';
 export type { AppendEventRequest, CreateSessionRequest, DeleteSessionRequest, GetSessionConfig, GetSessionRequest, ListSessionsRequest, ListSessionsResponse, } from './sessions/base_session_service.js';
 export { InMemorySessionService } from './sessions/in_memory_session_service.js';
 export { createSession } from './sessions/session.js';
-export type { Session } from './sessions/session.js';
+export type { CompositeSessionKey, Session } from './sessions/session.js';
 export { State } from './sessions/state.js';
 export { AgentTool, isAgentTool } from './tools/agent_tool.js';
 export type { AgentToolConfig } from './tools/agent_tool.js';
@@ -108,6 +118,9 @@ 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 { 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 { FunctionTool, isFunctionTool } from './tools/function_tool.js';
 export type { ToolExecuteArgument, ToolExecuteFunction, ToolInputParameters, ToolOptions, } from './tools/function_tool.js';
@@ -115,6 +128,8 @@ export { GOOGLE_MAPS_GROUNDING, GoogleMapsGroundingTool, } from './tools/google_
 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 { ToolConfirmation } from './tools/tool_confirmation.js';
@@ -122,10 +137,13 @@ 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 { getClientLabels, runWithClientLabel } from './utils/client_labels.js';
 export { LogLevel, getLogger, setLogLevel, setLogger } from './utils/logger.js';
 export type { Logger } from './utils/logger.js';
 export { isGemini2OrAbove, isGemini3xFlashLive } from './utils/model_name.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';
@@ -138,6 +156,11 @@ 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';
@@ -146,6 +169,7 @@ export { ToolAuthHandler } from './tools/openapi_tool/openapi_spec_parser/tool_a
 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 * from './artifacts/base_artifact_service.js';
 export * from './features/feature_registry.js';
 export * from './memory/base_memory_service.js';

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

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InvocationContext } from '../agents/invocation_context.js';
+import { ContextCompactionTrigger } from '../plugins/base_plugin.js';
+import { BaseContextCompactor } from './base_context_compactor.js';
+import { BaseSummarizer } from './summarizers/base_summarizer.js';
+/**
+ * A context compactor that triggers compaction when the agent explicitly
+ * requests it via the `ConsolidateContextTool`.
+ */
+export declare class AgentControlledContextCompactor implements BaseContextCompactor {
+    readonly trigger = ContextCompactionTrigger.AgentControlled;
+    private readonly summarizer;
+    constructor(options: {
+        summarizer: BaseSummarizer;
+    });
+    shouldCompact(invocationContext: InvocationContext): boolean;
+    compact(invocationContext: InvocationContext): Promise<void>;
+    private clearFlags;
+    private getActiveEvents;
+}

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

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InvocationContext } from '../agents/invocation_context.js';
+import { BaseContextCompactor } from './base_context_compactor.js';
+import { BaseSummarizer } from './summarizers/base_summarizer.js';
+export interface AnchoredContextCompactorOptions {
+    /** The maximum number of tokens to retain in the session history before compaction. */
+    tokenThreshold: number;
+    /**
+     * The minimum number of raw events to keep at the end of the session.
+     * Compaction will not affect these tail events (unless needed for tool splits).
+     */
+    eventRetentionSize: number;
+    /** The summarizer used to create the compacted event content. */
+    summarizer: BaseSummarizer;
+}
+/**
+ * A context compactor that maintains a single persistent 'Scratchpad' or
+ * 'State Tracker' event at the top of the context history.
+ *
+ * When compaction is triggered, it merges new raw events into the existing
+ * Scratchpad event and discards them from the active history view.
+ */
+export declare class AnchoredContextCompactor implements BaseContextCompactor {
+    private readonly tokenThreshold;
+    private readonly eventRetentionSize;
+    private readonly summarizer;
+    constructor(options: AnchoredContextCompactorOptions);
+    private getActiveEvents;
+    shouldCompact(invocationContext: InvocationContext): boolean | Promise<boolean>;
+    compact(invocationContext: InvocationContext): Promise<void>;
+}

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

@@ -4,10 +4,13 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { InvocationContext } from '../agents/invocation_context.js';
+import { ContextCompactionTrigger } from '../plugins/base_plugin.js';
 /**
  * Interface for compacting the context history in an agent session.
  */
 export interface BaseContextCompactor {
+    /** The trigger associated with this compactor. */
+    readonly trigger?: ContextCompactionTrigger;
     /**
      * Determines whether the context should be compacted.
      *

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

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Event } from '../events/event.js';
+/**
+ * Determines the baseline index to retain from active raw events,
+ * ensuring we don't split between a function call and its response.
+ *
+ * @param rawEvents The active raw events to consider for compaction.
+ * @param eventRetentionSize The minimum number of raw events to keep at the end of the session.
+ * @returns The index in `rawEvents` at which to split. Events before this index will be compacted.
+ */
+export declare function calculateRetainStartIndex(rawEvents: Event[], eventRetentionSize: number): number;

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

@@ -7,7 +7,12 @@ import { InvocationContext } from '../agents/invocation_context.js';
 import { BaseContextCompactor } from './base_context_compactor.js';
 import { BaseSummarizer } from './summarizers/base_summarizer.js';
 export interface TokenBasedContextCompactorOptions {
-    /** The maximum number of tokens to retain in the session history before compaction. */
+    /**
+     * Prompt-size threshold (in tokens) that triggers compaction. Compared
+     * against the most recently observed LLM request size
+     * (`usageMetadata.promptTokenCount`), falling back to a character-based
+     * estimate of the effective contents when no usage metadata is available.
+     */
     tokenThreshold: number;
     /**
      * The minimum number of raw events to keep at the end of the session.

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

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InvocationContext } from '../agents/invocation_context.js';
+import { BaseContextCompactor } from './base_context_compactor.js';
+/**
+ * Options for TrajectoryThoughtPruningCompactor.
+ */
+export interface TrajectoryThoughtPruningCompactorOptions {
+    /**
+     * The minimum number of raw events to keep at the end of the session.
+     * Compaction will not affect these tail events.
+     */
+    eventRetentionSize: number;
+}
+/**
+ * A context compactor that prunes thought parts from older events in the session history.
+ * Preserves the causal history (actions and observations) while reducing token usage.
+ */
+export declare class TrajectoryThoughtPruningCompactor implements BaseContextCompactor {
+    private readonly eventRetentionSize;
+    constructor(options: TrajectoryThoughtPruningCompactorOptions);
+    shouldCompact(invocationContext: InvocationContext): boolean | Promise<boolean>;
+    compact(invocationContext: InvocationContext): void | Promise<void>;
+}

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

@@ -25,9 +25,19 @@ export interface CompactedEvent extends Event {
      * The summarized content of the compacted events.
      */
     compactedContent: string;
+    /**
+     * Identifies this compacted event as the persistent context scratchpad.
+     */
+    isScratchpad?: boolean;
 }
 /**
  * Type guard to check if an event is a CompactedEvent.
  */
 export declare function isCompactedEvent(event: Event): event is CompactedEvent;
+/**
+ * Type guard to check if an event is a scratchpad CompactedEvent.
+ */
+export declare function isScratchpadEvent(event: Event): event is CompactedEvent & {
+    isScratchpad: true;
+};
 export declare function createCompactedEvent(params?: Partial<CompactedEvent>): CompactedEvent;

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

@@ -67,6 +67,15 @@ export declare function isFinalResponse(event: Event): boolean;
  * Returns the function calls in the event.
  */
 export declare function getFunctionCalls(event: Event): FunctionCall[];
+export declare const AF_FUNCTION_CALL_ID_PREFIX = "adk-";
+export declare function generateClientFunctionCallId(): string;
+/**
+ * Populates client-side function call IDs.
+ *
+ * It iterates through all function calls in the event and assigns a
+ * unique client-side ID to each one that doesn't already have an ID.
+ */
+export declare function populateClientFunctionCallId(modelResponseEvent: Event): void;
 /**
  * Returns the function responses in the event.
  */
@@ -82,6 +91,18 @@ export declare function hasTrailingCodeExecutionResult(event: Event): boolean;
  * @returns A single string with the combined text.
  */
 export declare function stringifyContent(event: Event): string;
+/**
+ * Estimates the number of tokens in the event based on usage metadata or characters.
+ */
+export declare function getEventTokens(event: Event): number;
+/**
+ * Returns whether the event contains any thought parts.
+ */
+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;
 /**
  * Generates a new unique ID for the event.
  */

package/dist/types/index.d.ts

@@ -9,7 +9,7 @@ export { getA2AAgentCard } from './a2a/agent_card.js';
 export { A2AAgentExecutor } from './a2a/agent_executor.js';
 export type { AfterEventCallback, AfterExecuteCallback, AgentExecutorConfig, BeforeExecuteCallback, RunnerOrRunnerConfig, } from './a2a/agent_executor.js';
 export { toA2a } from './a2a/agent_to_a2a.js';
-export type { ToA2aOptions } from './a2a/agent_to_a2a.js';
+export type { A2aUserBuilder, 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';
@@ -24,11 +24,12 @@ 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 { RunSkillInlineScriptErrorCode, 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/load_mcp_resource_tool.js';
 export * from './tools/mcp/mcp_session_manager.js';
 export * from './tools/mcp/mcp_tool.js';
 export * from './tools/mcp/mcp_toolset.js';

package/dist/types/models/google_llm.d.ts

@@ -39,20 +39,33 @@ export interface GeminiParams {
      * Headers to merge with internally crafted headers.
      */
     headers?: Record<string, string>;
+    /**
+     * Whether to use the Interactions API for stateful conversations.
+     */
+    useInteractionsApi?: boolean;
 }
+declare const GEMINI_MODEL_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of Gemini.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of Gemini, false otherwise.
+ */
+export declare function isGemini(obj: unknown): obj is Gemini;
 /**
  * Integration for Gemini models.
  */
 export declare class Gemini extends BaseLlm {
+    readonly [GEMINI_MODEL_SYMBOL] = true;
     private readonly apiKey?;
     protected readonly vertexai: boolean;
     private readonly project?;
     private readonly location?;
     private readonly headers?;
+    readonly useInteractionsApi: boolean;
     /**
      * @param params The parameters for creating a Gemini instance.
      */
-    constructor({ model, apiKey, vertexai, project, location, headers, }: GeminiParams);
+    constructor({ model, apiKey, vertexai, project, location, headers, useInteractionsApi, }: GeminiParams);
     /**
      * A list of model name patterns that are supported by this LLM.
      *
@@ -88,3 +101,4 @@ export declare class Gemini extends BaseLlm {
     private preprocessRequest;
 }
 export declare function geminiInitParams({ model, vertexai, project, location, apiKey, }: GeminiParams): GeminiParams;
+export {};

package/dist/types/models/interactions_utils.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Content, GenerateContentConfig, GoogleGenAI, Interactions, Part } from '@google/genai';
+import { LlmRequest } from './llm_request.js';
+import { LlmResponse } from './llm_response.js';
+export interface ExtendedInteraction extends Interactions.Interaction {
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface ExtendedInteractionStatusUpdate extends Omit<Interactions.InteractionStatusUpdate, 'error'> {
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface ExtendedFunctionCallStep extends Interactions.FunctionCallStep {
+    signature?: string;
+}
+export interface ExtendedInteractionSSEEvent extends Omit<Interactions.InteractionSSEEvent, 'error' | 'interaction_id' | 'status' | 'event_type'> {
+    event_type?: string;
+    eventType?: string;
+    delta?: {
+        type: string;
+        text?: string;
+        name?: string;
+        id?: string;
+        arguments?: Record<string, unknown>;
+        thought_signature?: string;
+        signature?: string;
+        data?: string;
+        uri?: string;
+        mime_type: string;
+    };
+    status?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+    code?: string;
+    message?: string;
+    interaction_id?: string;
+    interactionId?: string;
+    interaction?: {
+        id: string;
+    };
+    id?: string;
+}
+/**
+ * Extracts the latest turn contents for interactions API.
+ */
+export declare function getLatestUserContents(contents: Content[]): Content[];
+/**
+ * Convert a Content to a list of Steps.
+ */
+export declare function convertContentToSteps(content: Content): Interactions.Step[];
+/**
+ * Convert a Step to a list of Parts.
+ */
+export declare function convertStepToParts(step: Interactions.Step): Part[];
+/**
+ * Convert tools config to interactions format.
+ */
+export declare function convertToolsConfigToInteractionsFormat(config: GenerateContentConfig): Interactions.Tool[];
+/**
+ * Extract the latest model generated parts from a list of steps.
+ */
+export declare function getLatestModelParts(steps: Interactions.Step[]): Part[];
+/**
+ * Convert Interaction response to an LlmResponse.
+ */
+export declare function convertInteractionToLlmResponse(interaction: ExtendedInteraction): LlmResponse;
+/**
+ * Convert InteractionSSEEvent to LlmResponse.
+ */
+export declare function convertInteractionEventToLlmResponse(event: ExtendedInteractionSSEEvent, aggregatedParts: Part[], interactionId?: string): LlmResponse | null;
+/**
+ * Build generation config.
+ */
+export declare function buildGenerationConfig(config: GenerateContentConfig): Record<string, unknown>;
+/**
+ * Extract system instruction.
+ */
+export declare function extractSystemInstruction(config: GenerateContentConfig): string | undefined;
+/**
+ * Generate content using the interactions API.
+ */
+export declare function generateContentViaInteractions(apiClient: GoogleGenAI, llmRequest: LlmRequest, stream: boolean): AsyncGenerator<LlmResponse, void, void>;

package/dist/types/models/llm_request.d.ts

@@ -34,6 +34,10 @@ export interface LlmRequest {
      * The set of allowed tools, populated by request processors.
      */
     allowedTools?: string[];
+    /**
+     * The interaction ID from the previous turn, if any.
+     */
+    previousInteractionId?: string;
 }
 /**
  * Appends instructions to the system instruction.