@google/adk 1.3.0 → 1.4.0

package/dist/esm/utils/streaming_utils.js

@@ -330,10 +330,16 @@ class StreamingResponseAggregator {
     const candidate = (_b = (_a = this.response) == null ? void 0 : _a.candidates) == null ? void 0 : _b[0];
     const finishReason = (_c = this.finishReason) != null ? _c : candidate == null ? void 0 : candidate.finishReason;
     return {
-      content: {
-        role: "model",
-        parts: finalParts != null ? finalParts : []
-      },
+      // Only attach a model `content` when there are actual parts to emit. When
+      // the turn accumulated no parts (e.g. a function call that was already
+      // flushed, followed by a trailing STOP chunk that carries only usage
+      // metadata) we still surface that trailing metadata, but MUST NOT emit
+      // `content: { parts: [] }`. An empty-parts model turn corrupts the session
+      // history: on the next request the Vertex AI backend rejects the whole
+      // call with HTTP 400 "Unable to submit request because it must include at
+      // least one parts field", which breaks multi-turn tool-using sessions
+      // right after the first tool call (google/adk-js#21, #22).
+      content: finalParts ? { role: "model", parts: finalParts } : void 0,
       groundingMetadata: this.groundingMetadata,
       citationMetadata: this.citationMetadata,
       errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,

package/dist/esm/utils/task.js

@@ -0,0 +1,34 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class Task {
+  constructor(executable) {
+    this.executable = executable;
+    this.isDone = false;
+    this.abortController = new AbortController();
+    const markDone = () => {
+      this.isDone = true;
+    };
+    this.promise = executable(this.abortController.signal);
+    this.promise.then(markDone).catch(markDone);
+  }
+  /**
+   * Cancels the task execution.
+   */
+  cancel() {
+    this.abortController.abort();
+  }
+  /**
+   * Returns true if the task has completed (either resolved or rejected).
+   */
+  done() {
+    return this.isDone;
+  }
+}
+export {
+  Task
+};

package/dist/esm/version.js

@@ -5,7 +5,7 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const version = "1.3.0";
+const version = "1.4.0";
 export {
   version
 };

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

@@ -3,12 +3,13 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Task } from '../utils/task.js';
 import { LiveRequestQueue } from './live_request_queue.js';
 /**
  * The parameters for creating an ActiveStreamingTool.
  */
 export interface ActiveStreamingToolParams {
-    task?: Promise<void>;
+    task?: Task<void> | Promise<void>;
     stream?: LiveRequestQueue;
 }
 /**
@@ -17,10 +18,8 @@ export interface ActiveStreamingToolParams {
 export declare class ActiveStreamingTool {
     /**
      * The active task of this streaming tool.
-     * TODO: Replace 'Promise<void>' with a proper Task type if available in this
-     * env.
      */
-    task?: Promise<void>;
+    task?: Task<void>;
     /**
      * The active (input) streams of this streaming tool.
      */

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

@@ -3,12 +3,13 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Content, FunctionCall } from '@google/genai';
+import { FunctionCall } from '@google/genai';
 import { InvocationContext } from '../agents/invocation_context.js';
 import { Event } from '../events/event.js';
 import { BaseTool } from '../tools/base_tool.js';
 import { ToolConfirmation } from '../tools/tool_confirmation.js';
 import { SingleAfterToolCallback, SingleBeforeToolCallback } from './llm_agent.js';
+export declare const AF_FUNCTION_CALL_ID_PREFIX = "adk-";
 export declare const REQUEST_EUC_FUNCTION_CALL_NAME = "adk_request_credential";
 export declare const REQUEST_CONFIRMATION_FUNCTION_CALL_NAME = "adk_request_confirmation";
 export declare const functionsExportedForTestingOnly: {
@@ -24,14 +25,6 @@ export declare function generateClientFunctionCallId(): string;
  * unique client-side ID to each one that doesn't already have an ID.
  */
 export declare function populateClientFunctionCallId(modelResponseEvent: Event): void;
-/**
- * Removes the client-generated function call IDs from a given content object.
- *
- * When sending content back to the server, these IDs are
- * specific to the client-side and should not be included in requests to the
- * model.
- */
-export declare function removeClientFunctionCallId(content: Content): void;
 /**
  * Returns a set of function call ids of the long running tools.
  */
@@ -90,3 +83,13 @@ export declare function handleFunctionCallList({ invocationContext, functionCall
  * Merges a list of function response events into a single event.
  */
 export declare function mergeParallelFunctionResponseEvents(functionResponseEvents: Event[]): Event;
+/**
+ * Finds the function call event that matches the function call ID.
+ * Mirrors Python ADK's `find_event_by_function_call_id`.
+ */
+export declare function findEventByFunctionCallId(events: Event[], functionCallId: string, endIndex?: number): Event | undefined;
+/**
+ * Finds the function call event that matches the function response ID of the last event.
+ * Mirrors Python ADK's `find_matching_function_call`.
+ */
+export declare function findMatchingFunctionCall(events: Event[]): Event | undefined;

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

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { Content } from '@google/genai';
-import { BaseArtifactService } from '../artifacts/base_artifact_service.js';
+import { SessionArtifactService } from '../artifacts/session_artifact_service.js';
 import { BaseCredentialService } from '../auth/credential_service/base_credential_service.js';
 import { BaseMemoryService } from '../memory/base_memory_service.js';
 import { PluginManager } from '../plugins/plugin_manager.js';
@@ -18,7 +18,7 @@ import { TranscriptionEntry } from './transcription_entry.js';
  * The parameters for creating an invocation context.
  */
 export interface InvocationContextParams {
-    artifactService?: BaseArtifactService;
+    artifactService?: SessionArtifactService;
     sessionService?: BaseSessionService;
     memoryService?: BaseMemoryService;
     credentialService?: BaseCredentialService;
@@ -74,7 +74,7 @@ export interface InvocationContextParams {
  *  ```
  */
 export declare class InvocationContext {
-    readonly artifactService?: BaseArtifactService;
+    readonly artifactService?: SessionArtifactService;
     readonly sessionService?: BaseSessionService;
     readonly memoryService?: BaseMemoryService;
     readonly credentialService?: BaseCredentialService;
@@ -120,6 +120,10 @@ export declare class InvocationContext {
     /**
      * A container to keep track of different kinds of costs incurred as a part of
      * this invocation.
+     *
+     * This is shared across every agent context of the same invocation (see the
+     * constructor) so run-wide limits such as `maxLlmCalls` are enforced for the
+     * whole invocation rather than resetting for each agent/sub-agent.
      */
     private readonly invocationCostManager;
     /**

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

@@ -5,6 +5,14 @@
  */
 import { Content } from '@google/genai';
 import { Event } from '../../events/event.js';
+/**
+ * Removes the client-generated function call IDs from a given content object.
+ *
+ * When sending content back to the server, these IDs are
+ * specific to the client-side and should not be included in requests to the
+ * model.
+ */
+export declare function removeClientFunctionCallId(content: Content): void;
 /**
  * Get the contents for the LLM request.
  *

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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';
+/**
+ * Request processor for Gemini Interactions API.
+ * Resolves the previous interaction ID from the session history.
+ */
+export declare class InteractionsRequestProcessor implements BaseLlmRequestProcessor {
+    runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
+}
+export declare const INTERACTIONS_REQUEST_PROCESSOR: InteractionsRequestProcessor;

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,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,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';
@@ -94,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';
@@ -108,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';
@@ -122,10 +130,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 +149,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 +162,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/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/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.
  */