@google/adk 1.3.0 → 1.4.0

package/dist/cjs/artifacts/gcs_artifact_service.js

@@ -35,12 +35,16 @@ var import_logger = require("../utils/logger.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+const GCS_FILE_URI_METADATA_KEY = "adkFileUri";
+const GCS_FILE_MIME_TYPE_METADATA_KEY = "adkFileMimeType";
+const GCS_DISPLAY_NAME_METADATA_KEY = "adkDisplayName";
+const GCS_IS_TEXT_METADATA_KEY = "adkIsText";
 class GcsArtifactService {
-  constructor(bucket) {
-    this.bucket = new import_storage.Storage().bucket(bucket);
+  constructor(bucket, options) {
+    this.bucket = new import_storage.Storage(options).bucket(bucket);
   }
   async saveArtifact(request) {
-    if (!request.artifact.inlineData && !request.artifact.text) {
+    if (!request.artifact.inlineData && !request.artifact.text && !request.artifact.fileData) {
       throw new Error("Artifact must have either inlineData or text content.");
     }
     const versions = await this.listVersions(request);
@@ -51,24 +55,48 @@ class GcsArtifactService {
         version
       })
     );
-    const metadata = request.customMetadata || {};
+    const customMetadata = {
+      ...request.customMetadata
+    };
     if (request.artifact.inlineData) {
+      if (request.artifact.inlineData.displayName) {
+        customMetadata[GCS_DISPLAY_NAME_METADATA_KEY] = request.artifact.inlineData.displayName;
+      }
       await file.save(
         Buffer.from(request.artifact.inlineData.data || "", "base64"),
         {
           contentType: request.artifact.inlineData.mimeType,
-          metadata
+          metadata: { metadata: customMetadata }
         }
       );
       return version;
+    } else if (request.artifact.text !== void 0) {
+      await file.save(request.artifact.text, {
+        contentType: "text/plain",
+        metadata: {
+          metadata: { ...customMetadata, [GCS_IS_TEXT_METADATA_KEY]: "true" }
+        }
+      });
+      return version;
+    } else {
+      const fileData = request.artifact.fileData;
+      const fileUri = fileData == null ? void 0 : fileData.fileUri;
+      if (!fileUri) {
+        throw new Error("Artifact fileData must have a fileUri.");
+      }
+      customMetadata[GCS_FILE_URI_METADATA_KEY] = fileUri;
+      if (fileData.mimeType) {
+        customMetadata[GCS_FILE_MIME_TYPE_METADATA_KEY] = fileData.mimeType;
+      }
+      await file.save("", {
+        contentType: fileData.mimeType || void 0,
+        metadata: { metadata: customMetadata }
+      });
+      return version;
     }
-    await file.save(request.artifact.text, {
-      contentType: "text/plain",
-      metadata
-    });
-    return version;
   }
   async loadArtifact(request) {
+    var _a, _b, _c;
     try {
       let version = request.version;
       if (version === void 0) {
@@ -84,11 +112,25 @@ class GcsArtifactService {
           version
         })
       );
-      const [[metadata], [rawDataBuffer]] = await Promise.all([
-        file.getMetadata(),
-        file.download()
-      ]);
-      if (metadata.contentType === "text/plain") {
+      const [metadata] = await file.getMetadata();
+      const customMeta = (_a = metadata.metadata) != null ? _a : {};
+      const fileUri = customMeta[GCS_FILE_URI_METADATA_KEY];
+      if (fileUri) {
+        const mimeType = (_c = (_b = customMeta[GCS_FILE_MIME_TYPE_METADATA_KEY]) != null ? _b : metadata.contentType) != null ? _c : void 0;
+        return { fileData: { fileUri, mimeType } };
+      }
+      const [rawDataBuffer] = await file.download();
+      const displayName = customMeta[GCS_DISPLAY_NAME_METADATA_KEY];
+      if (displayName) {
+        return {
+          inlineData: {
+            data: rawDataBuffer.toString("base64"),
+            mimeType: metadata.contentType,
+            displayName
+          }
+        };
+      }
+      if (customMeta[GCS_IS_TEXT_METADATA_KEY] === "true" || metadata.contentType === "text/plain") {
         return (0, import_genai.createPartFromText)(rawDataBuffer.toString("utf-8"));
       }
       return (0, import_genai.createPartFromBase64)(

package/dist/cjs/artifacts/in_memory_artifact_service.js

@@ -48,7 +48,7 @@ class InMemoryArtifactService {
     artifact,
     customMetadata
   }) {
-    if (!artifact.inlineData && !artifact.text) {
+    if (!artifact.inlineData && !artifact.text && !artifact.fileData) {
       return Promise.reject(
         new Error("Artifact must have either inlineData or text content.")
       );
@@ -62,6 +62,10 @@ class InMemoryArtifactService {
       version,
       customMetadata
     };
+    if (!artifact.inlineData && artifact.text === void 0) {
+      const fileData = artifact.fileData;
+      metadata.mimeType = fileData.mimeType;
+    }
     this.artifacts[path].push({ part: artifact, metadata });
     return Promise.resolve(version);
   }

package/dist/cjs/artifacts/scoped_artifact_service.js

@@ -0,0 +1,101 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var scoped_artifact_service_exports = {};
+__export(scoped_artifact_service_exports, {
+  ScopedArtifactService: () => ScopedArtifactService
+});
+module.exports = __toCommonJS(scoped_artifact_service_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ScopedArtifactService {
+  constructor(delegate, appName, userId, sessionId) {
+    this.delegate = delegate;
+    this.appName = appName;
+    this.userId = userId;
+    this.sessionId = sessionId;
+  }
+  async saveArtifact(request) {
+    return this.delegate.saveArtifact({
+      appName: this.appName,
+      userId: this.userId,
+      sessionId: this.sessionId,
+      ...request
+    });
+  }
+  async loadArtifact(request) {
+    return this.delegate.loadArtifact({
+      appName: this.appName,
+      userId: this.userId,
+      sessionId: this.sessionId,
+      ...request
+    });
+  }
+  async listArtifactKeys() {
+    return this.delegate.listArtifactKeys({
+      appName: this.appName,
+      userId: this.userId,
+      sessionId: this.sessionId
+    });
+  }
+  async deleteArtifact(filename) {
+    return this.delegate.deleteArtifact({
+      appName: this.appName,
+      userId: this.userId,
+      sessionId: this.sessionId,
+      filename
+    });
+  }
+  async listVersions(filename) {
+    return this.delegate.listVersions({
+      appName: this.appName,
+      userId: this.userId,
+      sessionId: this.sessionId,
+      filename
+    });
+  }
+  async listArtifactVersions(filename) {
+    return this.delegate.listArtifactVersions({
+      appName: this.appName,
+      userId: this.userId,
+      sessionId: this.sessionId,
+      filename
+    });
+  }
+  async getArtifactVersion(request) {
+    return this.delegate.getArtifactVersion({
+      appName: this.appName,
+      userId: this.userId,
+      sessionId: this.sessionId,
+      ...request
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ScopedArtifactService
+});

package/dist/cjs/artifacts/session_artifact_service.js

@@ -0,0 +1,27 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_artifact_service_exports = {};
+module.exports = __toCommonJS(session_artifact_service_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/cjs/auth/oauth2/oauth2_discovery.js

@@ -26,7 +26,9 @@ var oauth2_discovery_exports = {};
 __export(oauth2_discovery_exports, {
   AuthorizationServerMetadataSchema: () => AuthorizationServerMetadataSchema,
   OAuth2DiscoveryManager: () => OAuth2DiscoveryManager,
-  ProtectedResourceMetadataSchema: () => ProtectedResourceMetadataSchema
+  ProtectedResourceMetadataSchema: () => ProtectedResourceMetadataSchema,
+  normaliseHostname: () => normaliseHostname,
+  validateDiscoveryUrl: () => validateDiscoveryUrl
 });
 module.exports = __toCommonJS(oauth2_discovery_exports);
 var import_zod = require("zod");
@@ -84,7 +86,11 @@ class OAuth2DiscoveryManager {
           method: "GET",
           headers: {
             Accept: "application/json"
-          }
+          },
+          // Never follow redirects: validateDiscoveryUrl only checks the
+          // initial URL, so following a 3xx would let a validated host
+          // redirect discovery to a private/cloud-metadata address (CWE-918).
+          redirect: "error"
         });
         if (!response.ok) {
           continue;
@@ -132,7 +138,11 @@ class OAuth2DiscoveryManager {
         method: "GET",
         headers: {
           Accept: "application/json"
-        }
+        },
+        // Never follow redirects: validateDiscoveryUrl only checks the
+        // initial URL, so following a 3xx would let a validated host
+        // redirect discovery to a private/cloud-metadata address (CWE-918).
+        redirect: "error"
       });
       if (!response.ok) {
         return void 0;
@@ -172,7 +182,7 @@ function validateDiscoveryUrl(urlStr) {
       return false;
     }
     const host = normaliseHostname(url.hostname.toLowerCase());
-    if (host === "localhost" || host === "metadata.google.internal" || host === "metadata.goog" || host.startsWith("127.") || host === "[::1]" || host === "0.0.0.0" || host.startsWith("10.") || host.startsWith("192.168.") || host.startsWith("169.254.")) {
+    if (host === "localhost" || host === "metadata.google.internal" || host === "metadata.goog" || host.startsWith("127.") || host === "[::1]" || host === "[::]" || host === "0.0.0.0" || host.startsWith("10.") || host.startsWith("192.168.") || host.startsWith("169.254.")) {
       import_logger.logger.warn(`Unsafe host for discovery URL: ${host}`);
       return false;
     }
@@ -206,5 +216,7 @@ function validateDiscoveryUrl(urlStr) {
 0 && (module.exports = {
   AuthorizationServerMetadataSchema,
   OAuth2DiscoveryManager,
-  ProtectedResourceMetadataSchema
+  ProtectedResourceMetadataSchema,
+  normaliseHostname,
+  validateDiscoveryUrl
 });

package/dist/cjs/auth/oauth2/oauth2_utils.js

@@ -32,6 +32,7 @@ __export(oauth2_utils_exports, {
 });
 module.exports = __toCommonJS(oauth2_utils_exports);
 var import_logger = require("../../utils/logger.js");
+var import_oauth2_discovery = require("./oauth2_discovery.js");
 /**
  * @license
  * Copyright 2026 Google LLC
@@ -51,13 +52,23 @@ function getTokenEndpoint(authScheme) {
   return void 0;
 }
 async function fetchOAuth2Tokens(endpoint, body) {
+  if (!(0, import_oauth2_discovery.validateDiscoveryUrl)(endpoint)) {
+    throw new Error(
+      `SSRF protection: OAuth2 token endpoint '${endpoint}' is not allowed. Must use HTTPS and must not target private/loopback/cloud-metadata addresses.`
+    );
+  }
   try {
     const response = await fetch(endpoint, {
       method: "POST",
       headers: {
         "Content-Type": "application/x-www-form-urlencoded"
       },
-      body: body.toString()
+      body: body.toString(),
+      // Never follow redirects: the SSRF blocklist only validates `endpoint`,
+      // so a validated host that responds with a 3xx could otherwise redirect
+      // this credential-bearing POST (client_secret/refresh_token) to a
+      // private/cloud-metadata address (CWE-918).
+      redirect: "error"
     });
     if (!response.ok) {
       throw new Error(`Token request failed with status ${response.status}`);

package/dist/cjs/common.js

@@ -28,6 +28,7 @@ __export(common_exports, {
   AUTH_PREPROCESSOR: () => import_auth_preprocessor.AUTH_PREPROCESSOR,
   ActiveStreamingTool: () => import_active_streaming_tool.ActiveStreamingTool,
   Agent: () => import_llm_agent.LlmAgent,
+  AgentControlledContextCompactor: () => import_agent_controlled_context_compactor.AgentControlledContextCompactor,
   AgentTool: () => import_agent_tool.AgentTool,
   AgentTransferLlmRequestProcessor: () => import_agent_transfer_llm_request_processor.AgentTransferLlmRequestProcessor,
   ApigeeLlm: () => import_apigee_llm.ApigeeLlm,
@@ -48,6 +49,7 @@ __export(common_exports, {
   BuiltInCodeExecutor: () => import_built_in_code_executor.BuiltInCodeExecutor,
   CONTENT_REQUEST_PROCESSOR: () => import_content_request_processor.CONTENT_REQUEST_PROCESSOR,
   CodeExecutionLanguage: () => import_code_execution_utils.CodeExecutionLanguage,
+  ConsolidateContextTool: () => import_consolidate_context_tool.ConsolidateContextTool,
   ContentRequestProcessor: () => import_content_request_processor.ContentRequestProcessor,
   Context: () => import_context.Context,
   ContextCompactionTrigger: () => import_base_plugin.ContextCompactionTrigger,
@@ -66,12 +68,14 @@ __export(common_exports, {
   GoogleLLMVariant: () => import_variant_utils.GoogleLLMVariant,
   GoogleMapsGroundingTool: () => import_google_maps_grounding_tool.GoogleMapsGroundingTool,
   GoogleSearchTool: () => import_google_search_tool.GoogleSearchTool,
+  INTERACTIONS_REQUEST_PROCESSOR: () => import_interactions_request_processor.INTERACTIONS_REQUEST_PROCESSOR,
   InMemoryArtifactService: () => import_in_memory_artifact_service.InMemoryArtifactService,
   InMemoryCredentialService: () => import_in_memory_credential_service.InMemoryCredentialService,
   InMemoryMemoryService: () => import_in_memory_memory_service.InMemoryMemoryService,
   InMemoryPolicyEngine: () => import_security_plugin.InMemoryPolicyEngine,
   InMemoryRunner: () => import_in_memory_runner.InMemoryRunner,
   InMemorySessionService: () => import_in_memory_session_service.InMemorySessionService,
+  InteractionsRequestProcessor: () => import_interactions_request_processor.InteractionsRequestProcessor,
   InvocationContext: () => import_invocation_context.InvocationContext,
   LLMRegistry: () => import_registry.LLMRegistry,
   LOAD_ARTIFACTS: () => import_load_artifacts_tool.LOAD_ARTIFACTS,
@@ -112,9 +116,11 @@ __export(common_exports, {
   SkillToolset: () => import_skill_toolset.SkillToolset,
   State: () => import_state.State,
   StreamingMode: () => import_run_config.StreamingMode,
+  Task: () => import_task.Task,
   TokenBasedContextCompactor: () => import_token_based_context_compactor.TokenBasedContextCompactor,
   ToolAuthHandler: () => import_tool_auth_handler.ToolAuthHandler,
   ToolConfirmation: () => import_tool_confirmation.ToolConfirmation,
+  TrajectoryThoughtPruningCompactor: () => import_trajectory_thought_pruning_compactor.TrajectoryThoughtPruningCompactor,
   TruncatingContextCompactor: () => import_truncating_context_compactor.TruncatingContextCompactor,
   URL_CONTEXT: () => import_url_context_tool.URL_CONTEXT,
   UrlContextTool: () => import_url_context_tool.UrlContextTool,
@@ -124,10 +130,16 @@ __export(common_exports, {
   createEvent: () => import_event.createEvent,
   createEventActions: () => import_event_actions.createEventActions,
   createRestApiTool: () => import_rest_api_tool.createRestApiTool,
+  createResumabilityConfig: () => import_resumability_config.createResumabilityConfig,
   createSession: () => import_session.createSession,
+  determineAgentForResumption: () => import_runner.determineAgentForResumption,
+  findEventByFunctionCallId: () => import_functions.findEventByFunctionCallId,
+  findEventByLastFunctionResponseId: () => import_runner.findEventByLastFunctionResponseId,
+  findMatchingFunctionCall: () => import_functions.findMatchingFunctionCall,
   functionsExportedForTestingOnly: () => import_functions.functionsExportedForTestingOnly,
   geminiInitParams: () => import_google_llm.geminiInitParams,
   getAskUserConfirmationFunctionCalls: () => import_security_plugin.getAskUserConfirmationFunctionCalls,
+  getClientLabels: () => import_client_labels.getClientLabels,
   getFunctionCalls: () => import_event.getFunctionCalls,
   getFunctionResponses: () => import_event.getFunctionResponses,
   getLogger: () => import_logger.getLogger,
@@ -146,12 +158,14 @@ __export(common_exports, {
   isLlmAgent: () => import_llm_agent.isLlmAgent,
   isLoopAgent: () => import_loop_agent.isLoopAgent,
   isParallelAgent: () => import_parallel_agent.isParallelAgent,
+  isRoutableLlmAgent: () => import_runner.isRoutableLlmAgent,
   isRoutedAgent: () => import_routed_agent.isRoutedAgent,
   isRunner: () => import_runner.isRunner,
   isSequentialAgent: () => import_sequential_agent.isSequentialAgent,
   loadAllSkillsInDir: () => import_loader.loadAllSkillsInDir,
   loadSkillFromDir: () => import_loader.loadSkillFromDir,
   loadSkillFromZipBuffer: () => import_loader.loadSkillFromZipBuffer,
+  runWithClientLabel: () => import_client_labels.runWithClientLabel,
   setLogLevel: () => import_logger.setLogLevel,
   setLogger: () => import_logger.setLogger,
   stringifyContent: () => import_event.stringifyContent,
@@ -174,10 +188,12 @@ var import_agent_transfer_llm_request_processor = require("./agents/processors/a
 var import_base_llm_processor = require("./agents/processors/base_llm_processor.js");
 var import_content_request_processor = require("./agents/processors/content_request_processor.js");
 var import_context_compactor_request_processor = require("./agents/processors/context_compactor_request_processor.js");
+var import_interactions_request_processor = require("./agents/processors/interactions_request_processor.js");
 var import_readonly_context = require("./agents/readonly_context.js");
 var import_routed_agent = require("./agents/routed_agent.js");
 var import_run_config = require("./agents/run_config.js");
 var import_sequential_agent = require("./agents/sequential_agent.js");
+var import_resumability_config = require("./apps/resumability_config.js");
 var import_in_memory_artifact_service = require("./artifacts/in_memory_artifact_service.js");
 var import_auth_credential = require("./auth/auth_credential.js");
 var import_auth_handler = require("./auth/auth_handler.js");
@@ -193,8 +209,10 @@ var import_credential_refresher_registry = require("./auth/refresher/credential_
 var import_base_code_executor = require("./code_executors/base_code_executor.js");
 var import_built_in_code_executor = require("./code_executors/built_in_code_executor.js");
 var import_code_execution_utils = require("./code_executors/code_execution_utils.js");
+var import_agent_controlled_context_compactor = require("./context/agent_controlled_context_compactor.js");
 var import_llm_summarizer = require("./context/summarizers/llm_summarizer.js");
 var import_token_based_context_compactor = require("./context/token_based_context_compactor.js");
+var import_trajectory_thought_pruning_compactor = require("./context/trajectory_thought_pruning_compactor.js");
 var import_truncating_context_compactor = require("./context/truncating_context_compactor.js");
 var import_compacted_event = require("./events/compacted_event.js");
 var import_event = require("./events/event.js");
@@ -221,6 +239,7 @@ var import_state = require("./sessions/state.js");
 var import_agent_tool = require("./tools/agent_tool.js");
 var import_base_tool = require("./tools/base_tool.js");
 var import_base_toolset = require("./tools/base_toolset.js");
+var import_consolidate_context_tool = require("./tools/consolidate_context_tool.js");
 var import_exit_loop_tool = require("./tools/exit_loop_tool.js");
 var import_function_tool = require("./tools/function_tool.js");
 var import_google_maps_grounding_tool = require("./tools/google_maps_grounding_tool.js");
@@ -233,9 +252,11 @@ var import_tool_confirmation = require("./tools/tool_confirmation.js");
 var import_url_context_tool = require("./tools/url_context_tool.js");
 var import_vertex_ai_search_tool = require("./tools/vertex_ai_search_tool.js");
 var import_vertex_rag_retrieval_tool = require("./tools/vertex_rag_retrieval_tool.js");
+var import_client_labels = require("./utils/client_labels.js");
 var import_logger = require("./utils/logger.js");
 var import_model_name = require("./utils/model_name.js");
 var import_simple_zod_to_json = require("./utils/simple_zod_to_json.js");
+var import_task = require("./utils/task.js");
 var import_variant_utils = require("./utils/variant_utils.js");
 var import_version = require("./version.js");
 var import_gcp_skill_registry = require("./skills/gcp_skill_registry.js");
@@ -245,11 +266,17 @@ var import_load_skill_resource_tool = require("./tools/skill/load_skill_resource
 var import_load_skill_tool = require("./tools/skill/load_skill_tool.js");
 var import_search_skills_tool = require("./tools/skill/search_skills_tool.js");
 var import_skill_toolset = require("./tools/skill/skill_toolset.js");
+__reExport(common_exports, require("./artifacts/base_artifact_service.js"), module.exports);
+__reExport(common_exports, require("./features/feature_registry.js"), module.exports);
+__reExport(common_exports, require("./memory/base_memory_service.js"), module.exports);
+__reExport(common_exports, require("./sessions/base_session_service.js"), module.exports);
+__reExport(common_exports, require("./tools/base_tool.js"), module.exports);
 var import_openapi_spec_parser = require("./tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js");
 var import_operation_parser = require("./tools/openapi_tool/openapi_spec_parser/operation_parser.js");
 var import_tool_auth_handler = require("./tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js");
 var import_openapi_toolset = require("./tools/openapi_tool/openapi_toolset.js");
 var import_rest_api_tool = require("./tools/openapi_tool/rest_api_tool.js");
+__reExport(common_exports, require("./apps/app.js"), module.exports);
 __reExport(common_exports, require("./artifacts/base_artifact_service.js"), module.exports);
 __reExport(common_exports, require("./features/feature_registry.js"), module.exports);
 __reExport(common_exports, require("./memory/base_memory_service.js"), module.exports);
@@ -265,6 +292,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   AUTH_PREPROCESSOR,
   ActiveStreamingTool,
   Agent,
+  AgentControlledContextCompactor,
   AgentTool,
   AgentTransferLlmRequestProcessor,
   ApigeeLlm,
@@ -285,6 +313,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   BuiltInCodeExecutor,
   CONTENT_REQUEST_PROCESSOR,
   CodeExecutionLanguage,
+  ConsolidateContextTool,
   ContentRequestProcessor,
   Context,
   ContextCompactionTrigger,
@@ -303,12 +332,14 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   GoogleLLMVariant,
   GoogleMapsGroundingTool,
   GoogleSearchTool,
+  INTERACTIONS_REQUEST_PROCESSOR,
   InMemoryArtifactService,
   InMemoryCredentialService,
   InMemoryMemoryService,
   InMemoryPolicyEngine,
   InMemoryRunner,
   InMemorySessionService,
+  InteractionsRequestProcessor,
   InvocationContext,
   LLMRegistry,
   LOAD_ARTIFACTS,
@@ -349,9 +380,11 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   SkillToolset,
   State,
   StreamingMode,
+  Task,
   TokenBasedContextCompactor,
   ToolAuthHandler,
   ToolConfirmation,
+  TrajectoryThoughtPruningCompactor,
   TruncatingContextCompactor,
   URL_CONTEXT,
   UrlContextTool,
@@ -361,10 +394,16 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   createEvent,
   createEventActions,
   createRestApiTool,
+  createResumabilityConfig,
   createSession,
+  determineAgentForResumption,
+  findEventByFunctionCallId,
+  findEventByLastFunctionResponseId,
+  findMatchingFunctionCall,
   functionsExportedForTestingOnly,
   geminiInitParams,
   getAskUserConfirmationFunctionCalls,
+  getClientLabels,
   getFunctionCalls,
   getFunctionResponses,
   getLogger,
@@ -383,12 +422,14 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isLlmAgent,
   isLoopAgent,
   isParallelAgent,
+  isRoutableLlmAgent,
   isRoutedAgent,
   isRunner,
   isSequentialAgent,
   loadAllSkillsInDir,
   loadSkillFromDir,
   loadSkillFromZipBuffer,
+  runWithClientLabel,
   setLogLevel,
   setLogger,
   stringifyContent,
@@ -400,5 +441,11 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   ...require("./features/feature_registry.js"),
   ...require("./memory/base_memory_service.js"),
   ...require("./sessions/base_session_service.js"),
+  ...require("./tools/base_tool.js"),
+  ...require("./apps/app.js"),
+  ...require("./artifacts/base_artifact_service.js"),
+  ...require("./features/feature_registry.js"),
+  ...require("./memory/base_memory_service.js"),
+  ...require("./sessions/base_session_service.js"),
   ...require("./tools/base_tool.js")
 });

package/dist/cjs/context/agent_controlled_context_compactor.js

@@ -0,0 +1,109 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var agent_controlled_context_compactor_exports = {};
+__export(agent_controlled_context_compactor_exports, {
+  AgentControlledContextCompactor: () => AgentControlledContextCompactor
+});
+module.exports = __toCommonJS(agent_controlled_context_compactor_exports);
+var import_compacted_event = require("../events/compacted_event.js");
+var import_event = require("../events/event.js");
+var import_base_plugin = require("../plugins/base_plugin.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class AgentControlledContextCompactor {
+  constructor(options) {
+    this.trigger = import_base_plugin.ContextCompactionTrigger.AgentControlled;
+    this.summarizer = options.summarizer;
+  }
+  shouldCompact(invocationContext) {
+    return invocationContext.session.state["temp:consolidate_context"] === true;
+  }
+  async compact(invocationContext) {
+    const events = invocationContext.session.events;
+    const activeEvents = this.getActiveEvents(events);
+    const consolidateToolCallIndex = activeEvents.reduce(
+      (acc, e, idx) => {
+        var _a, _b;
+        return ((_b = (_a = e.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.some(
+          (p) => {
+            var _a2;
+            return ((_a2 = p.functionCall) == null ? void 0 : _a2.name) === "consolidate_context";
+          }
+        )) ? idx : acc;
+      },
+      -1
+    );
+    if (consolidateToolCallIndex <= 0) {
+      this.clearFlags(invocationContext);
+      return;
+    }
+    const eventsToCompact = activeEvents.slice(0, consolidateToolCallIndex);
+    const detail = invocationContext.session.state["temp:consolidate_context_detail"];
+    if (detail) {
+      eventsToCompact.push(
+        (0, import_event.createEvent)({
+          author: "system",
+          timestamp: eventsToCompact[eventsToCompact.length - 1].timestamp,
+          content: {
+            role: "user",
+            parts: [
+              {
+                text: `CRITICAL INSTRUCTION FOR SUMMARY: Please summarize the history. Focus especially on: ${detail}`
+              }
+            ]
+          }
+        })
+      );
+    }
+    try {
+      const compactedEvent = await this.summarizer.summarize(eventsToCompact);
+      invocationContext.session.events.push(compactedEvent);
+    } catch (error) {
+      console.error("Compaction failed:", error);
+    } finally {
+      this.clearFlags(invocationContext);
+    }
+  }
+  clearFlags(invocationContext) {
+    delete invocationContext.session.state["temp:consolidate_context"];
+    delete invocationContext.session.state["temp:consolidate_context_detail"];
+  }
+  getActiveEvents(events) {
+    const latest = events.filter(import_compacted_event.isCompactedEvent).pop();
+    return latest ? [
+      latest,
+      ...events.filter(
+        (e) => !(0, import_compacted_event.isCompactedEvent)(e) && e.timestamp > latest.endTime
+      )
+    ] : events;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentControlledContextCompactor
+});