@google/adk 1.2.0 → 1.4.0

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

@@ -12,7 +12,15 @@ import { BaseLlmRequestProcessor } from './base_llm_processor.js';
  * 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/apps/app.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseAgent } from '../agents/base_agent.js';
+import { BasePlugin } from '../plugins/base_plugin.js';
+import { ResumabilityConfig } from './resumability_config.js';
+/**
+ * Ensures the provided application name is safe and intuitive.
+ */
+export declare function validateAppName(name: string): void;
+/**
+ * A unique symbol to identify ADK App classes.
+ * Defined once and shared by all App instances.
+ */
+declare const APP_SIGNATURE_SYMBOL: unique symbol;
+/**
+ * Type guard to check if an object is an instance of App.
+ * @param obj The object to check.
+ * @returns True if the object is an instance of App, false otherwise.
+ */
+export declare function isApp(obj: unknown): obj is App;
+/**
+ * Options for initializing an App.
+ */
+export interface AppOptions {
+    name: string;
+    rootAgent: BaseAgent;
+    plugins?: BasePlugin[];
+    resumabilityConfig?: ResumabilityConfig;
+}
+/**
+ * Represents an LLM-backed agentic application.
+ *
+ * An `App` is the top-level container for an agentic system powered by LLMs.
+ * It manages a root agent (`rootAgent`), which serves as the entry point for execution.
+ *
+ * Exactly one `rootAgent` must be provided.
+ *
+ * The `plugins` are application-wide components that provide shared capabilities
+ * and services to the entire system.
+ */
+export declare class App {
+    readonly [APP_SIGNATURE_SYMBOL] = true;
+    readonly name: string;
+    readonly rootAgent: BaseAgent | any;
+    readonly plugins: BasePlugin[];
+    readonly resumabilityConfig?: ResumabilityConfig;
+    constructor(options: AppOptions);
+}
+export {};

package/dist/types/apps/resumability_config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * The configuration of resumability for an application or runner.
+ *
+ * The "resumability" in ADK refers to the ability to:
+ * 1. pause an invocation upon a long-running function call.
+ * 2. resume an invocation from the last event, if it's paused or failed midway
+ * through.
+ */
+export interface ResumabilityConfig {
+    /**
+     * Whether the app/runner supports agent resumption.
+     * If enabled, resumption routing based on matching function responses will be active.
+     */
+    isResumable: boolean;
+}
+/**
+ * Creates a {@link ResumabilityConfig} with default values.
+ *
+ * @param params Optional partial {@link ResumabilityConfig} overriding defaults.
+ * @returns A merged {@link ResumabilityConfig} object.
+ */
+export declare function createResumabilityConfig(params?: Partial<ResumabilityConfig>): ResumabilityConfig;

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,11 +30,15 @@ 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';
+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';
@@ -52,12 +57,15 @@ 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 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';
@@ -93,13 +101,13 @@ 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';
@@ -107,6 +115,7 @@ 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 { 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';
@@ -121,19 +130,41 @@ 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 } from './utils/model_name.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';
+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 * 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';

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/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/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/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/event.d.ts

@@ -82,6 +82,14 @@ export declare function hasTrailingCodeExecutionResult(event: Event): boolean;
  * @returns A single string with the combined text.
  */
 export declare function stringifyContent(event: Event): string;
+/**
+ * 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/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.
  */
@@ -89,4 +89,3 @@ export declare function createEventActions(state?: Partial<EventActions>): Event
  * @returns A new {@link EventActions} containing the merged result.
  */
 export declare function mergeEventActions(sources: Array<Partial<EventActions>>, target?: EventActions): EventActions;
-export {};

package/dist/types/integrations/agent_registry/agent_registry_mcp_toolset.d.ts

@@ -25,6 +25,19 @@ export declare class AgentRegistrySingleMCPToolset extends BaseToolset {
     readonly headerProvider?: (context?: ReadonlyContext) => Promise<Record<string, string>> | Record<string, string>;
     readonly authScheme?: AuthScheme;
     readonly authCredential?: AuthCredential;
+    /**
+     * @param options - Configuration for the MCP toolset.
+     * @param options.destinationResourceId - Telemetry identifier injected as
+     *   `gcp.mcp.server.destination.id` into each resolved tool's custom metadata.
+     * @param options.connectionParams - HTTP connection parameters for the MCP server.
+     * @param options.toolFilter - Optional predicate or list of tool names to include.
+     *   When omitted, all tools from the server are returned.
+     * @param options.prefix - Optional prefix prepended to each tool name (e.g. `myServer_toolName`).
+     * @param options.headerProvider - Optional async function called immediately before each
+     *   {@link getTools} invocation to supply or refresh request headers (e.g. GCP auth tokens).
+     * @param options.authScheme - Optional auth scheme forwarded to each resolved tool.
+     * @param options.authCredential - Optional credential forwarded to each resolved tool.
+     */
     constructor(options: {
         destinationResourceId?: string;
         connectionParams: StreamableHTTPConnectionParams;
@@ -35,8 +48,14 @@ export declare class AgentRegistrySingleMCPToolset extends BaseToolset {
         authCredential?: AuthCredential;
     });
     /**
-     * Connects to the underlying MCP server, retrieves tool definitions, prefixes tool names,
-     * and injects destination telemetry metadata.
+     * Connects to the underlying MCP server, retrieves tool definitions, prefixes
+     * tool names, and injects destination telemetry metadata into each tool.
+     *
+     * The `headerProvider`, if configured, is invoked immediately before the
+     * connection is established so that tokens are always fresh.
+     *
+     * @param context - Optional readonly agent context passed to the header provider.
+     * @returns The resolved and optionally filtered list of {@link MCPTool} instances.
      */
     getTools(context?: ReadonlyContext): Promise<BaseTool[]>;
     close(): Promise<void>;

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

@@ -38,6 +38,16 @@ export interface BaseLlmConnection {
      * @param blob The blob to send to the model.
      */
     sendRealtime(blob: Blob): Promise<void>;
+    /**
+     * Optionally signals the start of user activity (e.g. user begins speaking)
+     * for models that support manual activity boundaries.
+     */
+    sendActivityStart?(): Promise<void>;
+    /**
+     * Optionally signals the end of user activity (e.g. user finishes speaking)
+     * for models that support manual activity boundaries.
+     */
+    sendActivityEnd?(): Promise<void>;
     /**
      * Receives the model response using the llm server connection.
      *

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

@@ -1,15 +1,17 @@
 /**
  * @license
- * Copyright 2025 Google LLC
+ * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Blob, Content, Session } from '@google/genai';
+import { Blob, Content, LiveServerMessage, Session } from '@google/genai';
 import { BaseLlmConnection } from './base_llm_connection.js';
 import { LlmResponse } from './llm_response.js';
 /** The Gemini model connection. */
 export declare class GeminiLlmConnection implements BaseLlmConnection {
     private readonly geminiSession;
-    constructor(geminiSession: Session);
+    private readonly modelVersion?;
+    private readonly messageQueue?;
+    constructor(geminiSession: Session, modelVersion?: string | undefined, messageQueue?: AsyncIterable<LiveServerMessage> | undefined);
     /**
      * Sends the conversation history to the gemini model.
      *
@@ -36,6 +38,14 @@ export declare class GeminiLlmConnection implements BaseLlmConnection {
      * @param blob The blob to send to the model.
      */
     sendRealtime(blob: Blob): Promise<void>;
+    /**
+     * Sends an activity start signal to the model.
+     */
+    sendActivityStart(): Promise<void>;
+    /**
+     * Sends an activity end signal to the model.
+     */
+    sendActivityEnd(): Promise<void>;
     /**
      * Builds a full text response.
      *
@@ -43,9 +53,10 @@ export declare class GeminiLlmConnection implements BaseLlmConnection {
      * partial.
      *
      * @param text The text to be included in the response.
+     * @param isThought Whether the text is a thought.
+     * @param groundingMetadata The grounding metadata to include.
      * @returns An LlmResponse containing the full text.
      */
-    private buildFullTextResponse;
     receive(): AsyncGenerator<LlmResponse, void, void>;
     /**
      * Closes the llm server connection.