@google/adk 1.4.0 → 1.6.0

package/dist/cjs/agents/processors/instructions_llm_request_processor.js

@@ -29,6 +29,7 @@ __export(instructions_llm_request_processor_exports, {
 });
 module.exports = __toCommonJS(instructions_llm_request_processor_exports);
 var import_llm_request = require("../../models/llm_request.js");
+var import_output_schema_utils = require("../../utils/output_schema_utils.js");
 var import_instructions = require("../instructions.js");
 var import_llm_agent = require("../llm_agent.js");
 var import_readonly_context = require("../readonly_context.js");
@@ -44,6 +45,7 @@ class InstructionsLlmRequestProcessor extends import_base_llm_processor.BaseLlmR
    */
   // eslint-disable-next-line require-yield
   async *runAsync(invocationContext, llmRequest) {
+    var _a;
     const agent = invocationContext.agent;
     if (!(0, import_llm_agent.isLlmAgent)(agent)) {
       return;
@@ -75,7 +77,7 @@ class InstructionsLlmRequestProcessor extends import_base_llm_processor.BaseLlmR
       }
       (0, import_llm_request.appendInstructions)(llmRequest, [instructionWithState]);
     }
-    if (agent.outputSchema && agent.tools && agent.tools.length > 0) {
+    if (agent.outputSchema && ((_a = agent.tools) == null ? void 0 : _a.length) && !(0, import_output_schema_utils.canUseOutputSchemaWithTools)(agent.canonicalModel.model)) {
       (0, import_llm_request.appendInstructions)(llmRequest, [
         'To output the final result, you must call the "set_model_response" function with the appropriate values. Do not output anything else.'
       ]);

package/dist/cjs/agents/routed_agent.js

@@ -64,6 +64,29 @@ let RoutedAgent = class extends (_b = import_base_agent.BaseAgent, _a = ROUTED_A
     }
     this.router = config.router;
   }
+  /**
+   * Creates a detached copy of this routed agent.
+   *
+   * The inherited {@link BaseAgent.clone} only deep-clones `subAgents`, but a
+   * `RoutedAgent` derives its routing targets from `config.agents`. Rebuilding
+   * through the base clone alone would re-read the already-parented original
+   * agents and throw "already has a parent agent". This override deep-clones the
+   * routing targets (unless the caller overrides `agents`) so the rebuilt
+   * constructor re-parents fresh, detached copies. The array-vs-record shape
+   * and, for records, the keys are preserved so the router keeps selecting the
+   * same targets.
+   *
+   * @param overrides Config fields to override on the clone. Overriding
+   *     `parentAgent` is rejected by the base implementation.
+   * @returns A new detached `RoutedAgent` of the same concrete class.
+   */
+  clone(overrides) {
+    const nextOverrides = { ...overrides };
+    if (!("agents" in nextOverrides)) {
+      nextOverrides.agents = cloneRoutingTargets(this.config.agents);
+    }
+    return super.clone(nextOverrides);
+  }
   /**
    * Runs the selected agent via text-based conversation.
    */
@@ -90,6 +113,14 @@ let RoutedAgent = class extends (_b = import_base_agent.BaseAgent, _a = ROUTED_A
 RoutedAgent = __decorateClass([
   import_experimental.experimental
 ], RoutedAgent);
+function cloneRoutingTargets(agents) {
+  if (Array.isArray(agents)) {
+    return agents.map((agent) => agent.clone());
+  }
+  return Object.fromEntries(
+    Object.entries(agents).map(([key, agent]) => [key, agent.clone()])
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   RoutedAgent,

package/dist/cjs/agents/run_config.js

@@ -41,14 +41,15 @@ var StreamingMode = /* @__PURE__ */ ((StreamingMode2) => {
   return StreamingMode2;
 })(StreamingMode || {});
 function createRunConfig(params = {}) {
+  var _a;
   return {
     saveInputBlobsAsArtifacts: false,
     supportCfc: false,
     enableAffectiveDialog: false,
     streamingMode: "none" /* NONE */,
-    maxLlmCalls: validateMaxLlmCalls(params.maxLlmCalls || 500),
     pauseOnToolCalls: false,
-    ...params
+    ...params,
+    maxLlmCalls: validateMaxLlmCalls((_a = params.maxLlmCalls) != null ? _a : 500)
   };
 }
 function validateMaxLlmCalls(value) {

package/dist/cjs/artifacts/in_memory_artifact_service.js

@@ -28,6 +28,7 @@ __export(in_memory_artifact_service_exports, {
   isInMemoryConnectionString: () => isInMemoryConnectionString
 });
 module.exports = __toCommonJS(in_memory_artifact_service_exports);
+var import_logger = require("../utils/logger.js");
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -84,6 +85,12 @@ class InMemoryArtifactService {
     if (version === void 0) {
       version = versions.length - 1;
     }
+    if (!versions[version]) {
+      import_logger.logger.warn(
+        `[InMemoryArtifactService] loadArtifact: Artifact ${filename} version ${version} not found`
+      );
+      return Promise.resolve(void 0);
+    }
     return Promise.resolve(versions[version].part);
   }
   listArtifactKeys({
@@ -91,16 +98,14 @@ class InMemoryArtifactService {
     userId,
     sessionId
   }) {
-    const sessionPrefix = `${appName}/${userId}/${sessionId}/`;
-    const usernamespacePrefix = `${appName}/${userId}/user/`;
+    const sessionPrefix = artifactPrefix("session", appName, userId, sessionId);
+    const userPrefix = artifactPrefix("user", appName, userId);
     const filenames = [];
     for (const path in this.artifacts) {
       if (path.startsWith(sessionPrefix)) {
-        const filename = path.replace(sessionPrefix, "");
-        filenames.push(filename);
-      } else if (path.startsWith(usernamespacePrefix)) {
-        const filename = path.replace(usernamespacePrefix, "");
-        filenames.push(filename);
+        filenames.push(decodeURIComponent(path.slice(sessionPrefix.length)));
+      } else if (path.startsWith(userPrefix)) {
+        filenames.push(decodeURIComponent(path.slice(userPrefix.length)));
       }
     }
     return Promise.resolve(filenames.sort());
@@ -171,9 +176,12 @@ class InMemoryArtifactService {
 }
 function artifactPath(appName, userId, sessionId, filename) {
   if (fileHasUserNamespace(filename)) {
-    return `${appName}/${userId}/user/${filename}`;
+    return `${artifactPrefix("user", appName, userId)}${encodeURIComponent(filename)}`;
   }
-  return `${appName}/${userId}/${sessionId}/${filename}`;
+  return `${artifactPrefix("session", appName, userId, sessionId)}${encodeURIComponent(filename)}`;
+}
+function artifactPrefix(scope, ...parts) {
+  return `${[scope, ...parts].map(encodeURIComponent).join("/")}/`;
 }
 function fileHasUserNamespace(filename) {
   return filename.startsWith("user:");

package/dist/cjs/auth/credential_service/in_memory_credential_service.js

@@ -34,7 +34,18 @@ module.exports = __toCommonJS(in_memory_credential_service_exports);
  */
 class InMemoryCredentialService {
   constructor() {
-    this.credentials = {};
+    /**
+     * A map from app name to a map from user ID to a map from credential key to
+     * credential.
+     *
+     * `appName`, `userId` and `credentialKey` are all attacker-influenced, so
+     * every level is created with `Object.create(null)`. On an ordinary `{}`
+     * literal a key of `__proto__` resolves to the inherited `__proto__`
+     * accessor rather than creating an own property, so nested assignment
+     * pollutes every object in the process, and a lookup of an inherited key
+     * such as `toString` returns a function instead of `undefined`.
+     */
+    this.credentials = /* @__PURE__ */ Object.create(null);
   }
   loadCredential(authConfig, toolContext) {
     const credentialBucket = this.getBucketForCurrentContext(toolContext);
@@ -49,10 +60,10 @@ class InMemoryCredentialService {
   getBucketForCurrentContext(toolContext) {
     const { appName, userId } = toolContext.invocationContext.session;
     if (!this.credentials[appName]) {
-      this.credentials[appName] = {};
+      this.credentials[appName] = /* @__PURE__ */ Object.create(null);
     }
     if (!this.credentials[appName][userId]) {
-      this.credentials[appName][userId] = {};
+      this.credentials[appName][userId] = /* @__PURE__ */ Object.create(null);
     }
     return this.credentials[appName][userId];
   }

package/dist/cjs/code_executors/unsafe_local_code_executor.js

@@ -37,7 +37,7 @@ __export(unsafe_local_code_executor_exports, {
   UnsafeLocalCodeExecutor: () => UnsafeLocalCodeExecutor
 });
 module.exports = __toCommonJS(unsafe_local_code_executor_exports);
-var import_child_process = require("child_process");
+var import_node_child_process = require("node:child_process");
 var fs = __toESM(require("node:fs/promises"), 1);
 var os = __toESM(require("node:os"), 1);
 var path = __toESM(require("node:path"), 1);
@@ -52,13 +52,21 @@ var import_code_execution_utils = require("./code_execution_utils.js");
  * SPDX-License-Identifier: Apache-2.0
  */
 const IS_WINDOWS = os.platform() === "win32";
+const POWERSHELL_BASE_ARGS = [
+  "-NoLogo",
+  "-NoProfile",
+  "-ExecutionPolicy",
+  "Bypass",
+  "-File"
+];
+const CMD_BASE_ARGS = ["/D", "/c"];
+function isPowerShellCommand(commandPath) {
+  return /^(powershell|pwsh)(\.exe)?$/i.test(path.win32.basename(commandPath));
+}
 async function createTempScriptFile(code, language, shellCommandPath) {
-  const tempDir = path.join(
-    os.tmpdir(),
-    "adk_js_unsafe_code_executor",
-    Date.now().toString() + "_" + Math.random().toString(36).slice(2)
+  const tempDir = await fs.mkdtemp(
+    path.join(os.tmpdir(), "adk_js_unsafe_code_executor_")
   );
-  await fs.mkdir(tempDir, { recursive: true });
   const ext = getExtensionForLanguage(language, shellCommandPath) || ".js";
   const filePath = path.join(tempDir, `script${ext}`);
   await fs.writeFile(filePath, code);
@@ -78,6 +86,9 @@ function getExtensionForLanguage(language, shellCommandPath) {
     return ".bat";
   }
   if (language === import_code_execution_utils.CodeExecutionLanguage.SHELL) {
+    if (shellCommandPath && isPowerShellCommand(shellCommandPath)) {
+      return ".ps1";
+    }
     if (IS_WINDOWS) {
       if (shellCommandPath && shellCommandPath.toLowerCase().includes("cmd")) {
         return ".bat";
@@ -136,17 +147,17 @@ class UnsafeLocalCodeExecutor extends import_base_code_executor.BaseCodeExecutor
         command = this.pythonCommandPath;
       } else if (language === import_code_execution_utils.CodeExecutionLanguage.SHELL) {
         command = this.shellCommandPath;
-        if (this.shellCommandPath.toLowerCase().includes("powershell")) {
-          args = ["-NoLogo", "-ExecutionPolicy", "Bypass", "-File", filePath];
+        if (isPowerShellCommand(this.shellCommandPath)) {
+          args = [...POWERSHELL_BASE_ARGS, filePath];
         } else if (this.shellCommandPath.toLowerCase().includes("cmd")) {
-          args = ["/c", filePath];
+          args = [...CMD_BASE_ARGS, filePath];
         }
       } else if (language === import_code_execution_utils.CodeExecutionLanguage.POWERSHELL) {
         command = IS_WINDOWS ? "powershell" : "pwsh";
-        args = ["-NoLogo", "-ExecutionPolicy", "Bypass", "-File", filePath];
+        args = [...POWERSHELL_BASE_ARGS, filePath];
       } else if (language === import_code_execution_utils.CodeExecutionLanguage.WINDOWS_CMD) {
         command = "cmd.exe";
-        args = ["/c", filePath];
+        args = [...CMD_BASE_ARGS, filePath];
       }
       if (params.codeExecutionInput.args) {
         if (Array.isArray(params.codeExecutionInput.args)) {
@@ -158,7 +169,7 @@ class UnsafeLocalCodeExecutor extends import_base_code_executor.BaseCodeExecutor
         }
       }
       const executionResult = await new Promise((resolve) => {
-        const child = (0, import_child_process.spawn)(command, args, {
+        const child = (0, import_node_child_process.spawn)(command, args, {
           timeout: this.timeoutSeconds * 1e3,
           killSignal: "SIGKILL",
           cwd: tempDir

package/dist/cjs/common.js

@@ -31,6 +31,7 @@ __export(common_exports, {
   AgentControlledContextCompactor: () => import_agent_controlled_context_compactor.AgentControlledContextCompactor,
   AgentTool: () => import_agent_tool.AgentTool,
   AgentTransferLlmRequestProcessor: () => import_agent_transfer_llm_request_processor.AgentTransferLlmRequestProcessor,
+  AnchoredContextCompactor: () => import_anchored_context_compactor.AnchoredContextCompactor,
   ApigeeLlm: () => import_apigee_llm.ApigeeLlm,
   AuthCredentialTypes: () => import_auth_credential.AuthCredentialTypes,
   AuthHandler: () => import_auth_handler.AuthHandler,
@@ -56,8 +57,11 @@ __export(common_exports, {
   ContextCompactorRequestProcessor: () => import_context_compactor_request_processor.ContextCompactorRequestProcessor,
   CredentialExchangeError: () => import_base_credential_exchanger.CredentialExchangeError,
   CredentialRefresherRegistry: () => import_credential_refresher_registry.CredentialRefresherRegistry,
+  ENTERPRISE_WEB_SEARCH: () => import_enterprise_web_search_tool.ENTERPRISE_WEB_SEARCH,
   EXIT_LOOP: () => import_exit_loop_tool.EXIT_LOOP,
+  EnterpriseWebSearchTool: () => import_enterprise_web_search_tool.EnterpriseWebSearchTool,
   EventType: () => import_structured_events.EventType,
+  ExampleTool: () => import_example_tool.ExampleTool,
   ExitLoopTool: () => import_exit_loop_tool.ExitLoopTool,
   FileContentEncoding: () => import_code_execution_utils.FileContentEncoding,
   FunctionTool: () => import_function_tool.FunctionTool,
@@ -65,6 +69,7 @@ __export(common_exports, {
   GOOGLE_MAPS_GROUNDING: () => import_google_maps_grounding_tool.GOOGLE_MAPS_GROUNDING,
   GOOGLE_SEARCH: () => import_google_search_tool.GOOGLE_SEARCH,
   Gemini: () => import_google_llm.Gemini,
+  GlobalInstructionPlugin: () => import_global_instruction_plugin.GlobalInstructionPlugin,
   GoogleLLMVariant: () => import_variant_utils.GoogleLLMVariant,
   GoogleMapsGroundingTool: () => import_google_maps_grounding_tool.GoogleMapsGroundingTool,
   GoogleSearchTool: () => import_google_search_tool.GoogleSearchTool,
@@ -80,6 +85,7 @@ __export(common_exports, {
   LLMRegistry: () => import_registry.LLMRegistry,
   LOAD_ARTIFACTS: () => import_load_artifacts_tool.LOAD_ARTIFACTS,
   LOAD_MEMORY: () => import_load_memory_tool.LOAD_MEMORY,
+  LOAD_WEB_PAGE: () => import_load_web_page.LOAD_WEB_PAGE,
   ListSkillsTool: () => import_list_skills_tool.ListSkillsTool,
   LiveRequestQueue: () => import_live_request_queue.LiveRequestQueue,
   LlmAgent: () => import_llm_agent.LlmAgent,
@@ -138,11 +144,14 @@ __export(common_exports, {
   findMatchingFunctionCall: () => import_functions.findMatchingFunctionCall,
   functionsExportedForTestingOnly: () => import_functions.functionsExportedForTestingOnly,
   geminiInitParams: () => import_google_llm.geminiInitParams,
+  generateClientFunctionCallId: () => import_event.generateClientFunctionCallId,
   getAskUserConfirmationFunctionCalls: () => import_security_plugin.getAskUserConfirmationFunctionCalls,
   getClientLabels: () => import_client_labels.getClientLabels,
   getFunctionCalls: () => import_event.getFunctionCalls,
   getFunctionResponses: () => import_event.getFunctionResponses,
   getLogger: () => import_logger.getLogger,
+  getUserChoiceTool: () => import_get_user_choice_tool.getUserChoiceTool,
+  hasThoughts: () => import_event.hasThoughts,
   hasTrailingCodeExecutionResult: () => import_event.hasTrailingCodeExecutionResult,
   isAgentTool: () => import_agent_tool.isAgentTool,
   isBaseAgent: () => import_base_agent.isBaseAgent,
@@ -161,10 +170,15 @@ __export(common_exports, {
   isRoutableLlmAgent: () => import_runner.isRoutableLlmAgent,
   isRoutedAgent: () => import_routed_agent.isRoutedAgent,
   isRunner: () => import_runner.isRunner,
+  isScratchpadEvent: () => import_compacted_event.isScratchpadEvent,
   isSequentialAgent: () => import_sequential_agent.isSequentialAgent,
   loadAllSkillsInDir: () => import_loader.loadAllSkillsInDir,
   loadSkillFromDir: () => import_loader.loadSkillFromDir,
   loadSkillFromZipBuffer: () => import_loader.loadSkillFromZipBuffer,
+  loadWebPage: () => import_load_web_page.loadWebPage,
+  populateClientFunctionCallId: () => import_event.populateClientFunctionCallId,
+  pruneThoughts: () => import_event.pruneThoughts,
+  requestInputTool: () => import_request_input_tool.requestInputTool,
   runWithClientLabel: () => import_client_labels.runWithClientLabel,
   setLogLevel: () => import_logger.setLogLevel,
   setLogger: () => import_logger.setLogger,
@@ -210,6 +224,7 @@ 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_anchored_context_compactor = require("./context/anchored_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");
@@ -227,6 +242,7 @@ var import_google_llm = require("./models/google_llm.js");
 var import_registry = require("./models/registry.js");
 var import_routed_llm = require("./models/routed_llm.js");
 var import_base_plugin = require("./plugins/base_plugin.js");
+var import_global_instruction_plugin = require("./plugins/global_instruction_plugin.js");
 var import_logging_plugin = require("./plugins/logging_plugin.js");
 var import_plugin_manager = require("./plugins/plugin_manager.js");
 var import_security_plugin = require("./plugins/security_plugin.js");
@@ -240,14 +256,19 @@ 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_enterprise_web_search_tool = require("./tools/enterprise_web_search_tool.js");
+var import_example_tool = require("./tools/example_tool.js");
 var import_exit_loop_tool = require("./tools/exit_loop_tool.js");
 var import_function_tool = require("./tools/function_tool.js");
+var import_get_user_choice_tool = require("./tools/get_user_choice_tool.js");
 var import_google_maps_grounding_tool = require("./tools/google_maps_grounding_tool.js");
 var import_google_search_tool = require("./tools/google_search_tool.js");
 var import_load_artifacts_tool = require("./tools/load_artifacts_tool.js");
 var import_load_memory_tool = require("./tools/load_memory_tool.js");
+var import_load_web_page = require("./tools/load_web_page.js");
 var import_long_running_tool = require("./tools/long_running_tool.js");
 var import_preload_memory_tool = require("./tools/preload_memory_tool.js");
+var import_request_input_tool = require("./tools/request_input_tool.js");
 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");
@@ -295,6 +316,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   AgentControlledContextCompactor,
   AgentTool,
   AgentTransferLlmRequestProcessor,
+  AnchoredContextCompactor,
   ApigeeLlm,
   AuthCredentialTypes,
   AuthHandler,
@@ -320,8 +342,11 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   ContextCompactorRequestProcessor,
   CredentialExchangeError,
   CredentialRefresherRegistry,
+  ENTERPRISE_WEB_SEARCH,
   EXIT_LOOP,
+  EnterpriseWebSearchTool,
   EventType,
+  ExampleTool,
   ExitLoopTool,
   FileContentEncoding,
   FunctionTool,
@@ -329,6 +354,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   GOOGLE_MAPS_GROUNDING,
   GOOGLE_SEARCH,
   Gemini,
+  GlobalInstructionPlugin,
   GoogleLLMVariant,
   GoogleMapsGroundingTool,
   GoogleSearchTool,
@@ -344,6 +370,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   LLMRegistry,
   LOAD_ARTIFACTS,
   LOAD_MEMORY,
+  LOAD_WEB_PAGE,
   ListSkillsTool,
   LiveRequestQueue,
   LlmAgent,
@@ -402,11 +429,14 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   findMatchingFunctionCall,
   functionsExportedForTestingOnly,
   geminiInitParams,
+  generateClientFunctionCallId,
   getAskUserConfirmationFunctionCalls,
   getClientLabels,
   getFunctionCalls,
   getFunctionResponses,
   getLogger,
+  getUserChoiceTool,
+  hasThoughts,
   hasTrailingCodeExecutionResult,
   isAgentTool,
   isBaseAgent,
@@ -425,10 +455,15 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isRoutableLlmAgent,
   isRoutedAgent,
   isRunner,
+  isScratchpadEvent,
   isSequentialAgent,
   loadAllSkillsInDir,
   loadSkillFromDir,
   loadSkillFromZipBuffer,
+  loadWebPage,
+  populateClientFunctionCallId,
+  pruneThoughts,
+  requestInputTool,
   runWithClientLabel,
   setLogLevel,
   setLogger,

package/dist/cjs/context/agent_controlled_context_compactor.js

@@ -27,9 +27,9 @@ __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");
+var import_compaction_utils = require("./compaction_utils.js");
 /**
  * @license
  * Copyright 2026 Google LLC
@@ -45,7 +45,7 @@ class AgentControlledContextCompactor {
   }
   async compact(invocationContext) {
     const events = invocationContext.session.events;
-    const activeEvents = this.getActiveEvents(events);
+    const activeEvents = (0, import_compaction_utils.getActiveEvents)(events);
     const consolidateToolCallIndex = activeEvents.reduce(
       (acc, e, idx) => {
         var _a, _b;
@@ -93,15 +93,6 @@ class AgentControlledContextCompactor {
     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 = {

package/dist/cjs/context/anchored_context_compactor.js

@@ -0,0 +1,127 @@
+/**
+  * @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 anchored_context_compactor_exports = {};
+__export(anchored_context_compactor_exports, {
+  AnchoredContextCompactor: () => AnchoredContextCompactor
+});
+module.exports = __toCommonJS(anchored_context_compactor_exports);
+var import_compacted_event = require("../events/compacted_event.js");
+var import_event = require("../events/event.js");
+var import_compaction_utils = require("./compaction_utils.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class AnchoredContextCompactor {
+  constructor(options) {
+    this.tokenThreshold = options.tokenThreshold;
+    this.eventRetentionSize = options.eventRetentionSize;
+    this.summarizer = options.summarizer;
+  }
+  getActiveEvents(events) {
+    let latestScratchpad = void 0;
+    for (let i = events.length - 1; i >= 0; i--) {
+      const e = events[i];
+      if ((0, import_compacted_event.isScratchpadEvent)(e)) {
+        latestScratchpad = e;
+        break;
+      }
+    }
+    if (!latestScratchpad) {
+      return events;
+    }
+    const activeRawEvents = events.filter(
+      (e) => e.timestamp > latestScratchpad.endTime && !(0, import_compacted_event.isScratchpadEvent)(e)
+    );
+    return [latestScratchpad, ...activeRawEvents];
+  }
+  shouldCompact(invocationContext) {
+    const events = invocationContext.session.events;
+    const activeEvents = this.getActiveEvents(events);
+    const hasScratchpad = activeEvents.length > 0 && (0, import_compacted_event.isScratchpadEvent)(activeEvents[0]);
+    const rawEvents = hasScratchpad ? activeEvents.slice(1) : activeEvents;
+    if (rawEvents.length <= this.eventRetentionSize) {
+      return false;
+    }
+    const retainStartIndex = (0, import_compaction_utils.calculateRetainStartIndex)(
+      rawEvents,
+      this.eventRetentionSize
+    );
+    if (retainStartIndex === 0) {
+      return false;
+    }
+    const totalTokens = activeEvents.reduce(
+      (sum, event) => sum + (0, import_event.getEventTokens)(event),
+      0
+    );
+    return totalTokens > this.tokenThreshold;
+  }
+  async compact(invocationContext) {
+    const events = invocationContext.session.events;
+    const activeEvents = this.getActiveEvents(events);
+    const hasScratchpad = activeEvents.length > 0 && (0, import_compacted_event.isScratchpadEvent)(activeEvents[0]);
+    const rawEvents = hasScratchpad ? activeEvents.slice(1) : activeEvents;
+    if (rawEvents.length <= this.eventRetentionSize) {
+      return;
+    }
+    const retainStartIndex = (0, import_compaction_utils.calculateRetainStartIndex)(
+      rawEvents,
+      this.eventRetentionSize
+    );
+    if (retainStartIndex === 0) {
+      return;
+    }
+    const rawEventsToCompact = rawEvents.slice(0, retainStartIndex);
+    let scratchpadEvent;
+    if (hasScratchpad) {
+      const existingScratchpad = activeEvents[0];
+      scratchpadEvent = await this.summarizer.summarize([
+        existingScratchpad,
+        ...rawEventsToCompact
+      ]);
+    } else {
+      scratchpadEvent = await this.summarizer.summarize(rawEventsToCompact);
+    }
+    const updatedScratchpad = {
+      ...scratchpadEvent,
+      isScratchpad: true,
+      author: "system"
+    };
+    const inactiveEvents = events.slice(0, events.indexOf(activeEvents[0]));
+    const retainedRawEvents = rawEvents.slice(retainStartIndex);
+    const newEventsList = [
+      ...inactiveEvents,
+      updatedScratchpad,
+      ...retainedRawEvents
+    ];
+    events.length = 0;
+    events.push(...newEventsList);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AnchoredContextCompactor
+});

package/dist/cjs/context/compaction_utils.js

@@ -0,0 +1,64 @@
+/**
+  * @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 compaction_utils_exports = {};
+__export(compaction_utils_exports, {
+  calculateRetainStartIndex: () => calculateRetainStartIndex,
+  getActiveEvents: () => getActiveEvents
+});
+module.exports = __toCommonJS(compaction_utils_exports);
+var import_compacted_event = require("../events/compacted_event.js");
+var import_event = require("../events/event.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function 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;
+}
+function calculateRetainStartIndex(rawEvents, eventRetentionSize) {
+  let retainStartIndex = Math.max(0, rawEvents.length - eventRetentionSize);
+  while (retainStartIndex > 0) {
+    const eventToRetain = rawEvents[retainStartIndex];
+    const previousEvent = rawEvents[retainStartIndex - 1];
+    if ((0, import_event.getFunctionResponses)(eventToRetain).length > 0 && (0, import_event.getFunctionCalls)(previousEvent).length > 0) {
+      retainStartIndex--;
+    } else {
+      break;
+    }
+  }
+  return retainStartIndex;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateRetainStartIndex,
+  getActiveEvents
+});