@google/adk 0.5.0 → 0.6.0

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

@@ -28,8 +28,9 @@ __export(content_request_processor_exports, {
   ContentRequestProcessor: () => ContentRequestProcessor
 });
 module.exports = __toCommonJS(content_request_processor_exports);
-var import_content_processor_utils = require("../content_processor_utils.js");
+var import_compacted_event = require("../../events/compacted_event.js");
 var import_llm_agent = require("../llm_agent.js");
+var import_content_processor_utils = require("./content_processor_utils.js");
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -42,15 +43,35 @@ class ContentRequestProcessor {
     if (!agent || !(0, import_llm_agent.isLlmAgent)(agent)) {
       return;
     }
+    let events = invocationContext.session.events;
+    const compactedEvents = events.filter(import_compacted_event.isCompactedEvent);
+    const latestCompactedEvent = compactedEvents.length > 0 ? compactedEvents.reduce(
+      (latest, current) => current.endTime > latest.endTime ? current : latest
+    ) : void 0;
+    if (latestCompactedEvent) {
+      const remainingEvents = events.filter((event) => {
+        if (event === latestCompactedEvent) {
+          return false;
+        }
+        if ((0, import_compacted_event.isCompactedEvent)(event)) {
+          return false;
+        }
+        if (event.timestamp <= latestCompactedEvent.endTime) {
+          return false;
+        }
+        return true;
+      });
+      events = [latestCompactedEvent, ...remainingEvents];
+    }
     if (agent.includeContents === "default") {
       llmRequest.contents = (0, import_content_processor_utils.getContents)(
-        invocationContext.session.events,
+        events,
         agent.name,
         invocationContext.branch
       );
     } else {
       llmRequest.contents = (0, import_content_processor_utils.getCurrentTurnContents)(
-        invocationContext.session.events,
+        events,
         agent.name,
         invocationContext.branch
       );

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

@@ -0,0 +1,61 @@
+/**
+  * @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 context_compactor_request_processor_exports = {};
+__export(context_compactor_request_processor_exports, {
+  ContextCompactorRequestProcessor: () => ContextCompactorRequestProcessor
+});
+module.exports = __toCommonJS(context_compactor_request_processor_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ContextCompactorRequestProcessor {
+  constructor(compactors) {
+    this.compactors = compactors;
+  }
+  async *runAsync(invocationContext, _llmRequest) {
+    for (const compactor of this.compactors) {
+      const shouldCompact = await Promise.resolve(
+        compactor.shouldCompact(invocationContext)
+      );
+      if (shouldCompact) {
+        const oldEvents = new Set(invocationContext.session.events);
+        await Promise.resolve(compactor.compact(invocationContext));
+        const newEvents = invocationContext.session.events.filter(
+          (e) => !oldEvents.has(e)
+        );
+        for (const e of newEvents) {
+          yield e;
+        }
+        return;
+      }
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContextCompactorRequestProcessor
+});

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

@@ -45,7 +45,7 @@ class InstructionsLlmRequestProcessor extends import_base_llm_processor.BaseLlmR
   // eslint-disable-next-line require-yield
   async *runAsync(invocationContext, llmRequest) {
     const agent = invocationContext.agent;
-    if (!(0, import_llm_agent.isLlmAgent)(agent) || !(0, import_llm_agent.isLlmAgent)(agent.rootAgent)) {
+    if (!(0, import_llm_agent.isLlmAgent)(agent)) {
       return;
     }
     const rootAgent = agent.rootAgent;

package/dist/cjs/artifacts/file_artifact_service.js

@@ -34,7 +34,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var file_artifact_service_exports = {};
 __export(file_artifact_service_exports, {
-  FileArtifactService: () => FileArtifactService
+  FileArtifactService: () => FileArtifactService,
+  assertInsideRoot: () => assertInsideRoot,
+  assertSafeSegment: () => assertSafeSegment,
+  getSessionArtifactsDir: () => getSessionArtifactsDir,
+  getUserRoot: () => getUserRoot
 });
 module.exports = __toCommonJS(file_artifact_service_exports);
 var fs = __toESM(require("fs/promises"), 1);
@@ -346,8 +350,28 @@ class FileArtifactService {
     }
   }
 }
+const SAFE_SEGMENT_RE = /^[a-zA-Z0-9_@-][a-zA-Z0-9_.@-]{0,255}$/;
+function assertSafeSegment(value, label) {
+  if (!value || !SAFE_SEGMENT_RE.test(value)) {
+    throw new Error(
+      `[FileArtifactService] Invalid ${label}: value contains disallowed characters.`
+    );
+  }
+}
+function assertInsideRoot(resolvedPath, rootDir, label) {
+  const root = path.resolve(rootDir);
+  const resolved = path.resolve(resolvedPath);
+  if (!resolved.startsWith(root + path.sep) && resolved !== root) {
+    throw new Error(
+      `[FileArtifactService] ${label} escapes storage root. Resolved: ${resolved}, Root: ${root}`
+    );
+  }
+}
 function getUserRoot(rootDir, userId) {
-  return path.join(rootDir, "users", userId);
+  assertSafeSegment(userId, "userId");
+  const result = path.join(rootDir, "users", userId);
+  assertInsideRoot(result, rootDir, "userRoot");
+  return result;
 }
 function isUserScoped(sessionId, filename) {
   return !sessionId || filename.startsWith(USER_NAMESPACE_PREFIX);
@@ -356,7 +380,10 @@ function getUserArtifactsDir(userRoot) {
   return path.join(userRoot, "artifacts");
 }
 function getSessionArtifactsDir(baseRoot, sessionId) {
-  return path.join(baseRoot, "sessions", sessionId, "artifacts");
+  assertSafeSegment(sessionId, "sessionId");
+  const result = path.join(baseRoot, "sessions", sessionId, "artifacts");
+  assertInsideRoot(result, baseRoot, "sessionArtifactsDir");
+  return result;
 }
 function getVersionsDir(artifactDir) {
   return path.join(artifactDir, "versions");
@@ -487,5 +514,9 @@ function asPosixPath(p) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  FileArtifactService
+  FileArtifactService,
+  assertInsideRoot,
+  assertSafeSegment,
+  getSessionArtifactsDir,
+  getUserRoot
 });

package/dist/cjs/common.js

@@ -40,7 +40,10 @@ __export(common_exports, {
   BaseTool: () => import_base_tool.BaseTool,
   BaseToolset: () => import_base_toolset.BaseToolset,
   BuiltInCodeExecutor: () => import_built_in_code_executor.BuiltInCodeExecutor,
+  CONTENT_REQUEST_PROCESSOR: () => import_content_request_processor.CONTENT_REQUEST_PROCESSOR,
+  ContentRequestProcessor: () => import_content_request_processor.ContentRequestProcessor,
   Context: () => import_context.Context,
+  ContextCompactorRequestProcessor: () => import_context_compactor_request_processor.ContextCompactorRequestProcessor,
   EXIT_LOOP: () => import_exit_loop_tool.EXIT_LOOP,
   EventType: () => import_structured_events.EventType,
   ExitLoopTool: () => import_exit_loop_tool.ExitLoopTool,
@@ -56,15 +59,22 @@ __export(common_exports, {
   InMemorySessionService: () => import_in_memory_session_service.InMemorySessionService,
   InvocationContext: () => import_invocation_context.InvocationContext,
   LLMRegistry: () => import_registry.LLMRegistry,
+  LOAD_ARTIFACTS: () => import_load_artifacts_tool.LOAD_ARTIFACTS,
+  LOAD_MEMORY: () => import_load_memory_tool.LOAD_MEMORY,
   LiveRequestQueue: () => import_live_request_queue.LiveRequestQueue,
   LlmAgent: () => import_llm_agent.LlmAgent,
+  LlmSummarizer: () => import_llm_summarizer.LlmSummarizer,
+  LoadArtifactsTool: () => import_load_artifacts_tool.LoadArtifactsTool,
+  LoadMemoryTool: () => import_load_memory_tool.LoadMemoryTool,
   LogLevel: () => import_logger.LogLevel,
   LoggingPlugin: () => import_logging_plugin.LoggingPlugin,
   LongRunningFunctionTool: () => import_long_running_tool.LongRunningFunctionTool,
   LoopAgent: () => import_loop_agent.LoopAgent,
+  PRELOAD_MEMORY: () => import_preload_memory_tool.PRELOAD_MEMORY,
   ParallelAgent: () => import_parallel_agent.ParallelAgent,
   PluginManager: () => import_plugin_manager.PluginManager,
   PolicyOutcome: () => import_security_plugin.PolicyOutcome,
+  PreloadMemoryTool: () => import_preload_memory_tool.PreloadMemoryTool,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME: () => import_security_plugin.REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
   ReadonlyContext: () => import_readonly_context.ReadonlyContext,
   Runner: () => import_runner.Runner,
@@ -72,7 +82,9 @@ __export(common_exports, {
   SequentialAgent: () => import_sequential_agent.SequentialAgent,
   State: () => import_state.State,
   StreamingMode: () => import_run_config.StreamingMode,
+  TokenBasedContextCompactor: () => import_token_based_context_compactor.TokenBasedContextCompactor,
   ToolConfirmation: () => import_tool_confirmation.ToolConfirmation,
+  TruncatingContextCompactor: () => import_truncating_context_compactor.TruncatingContextCompactor,
   createEvent: () => import_event.createEvent,
   createEventActions: () => import_event_actions.createEventActions,
   createSession: () => import_session.createSession,
@@ -89,12 +101,14 @@ __export(common_exports, {
   isBaseLlm: () => import_base_llm.isBaseLlm,
   isBaseTool: () => import_base_tool.isBaseTool,
   isBaseToolset: () => import_base_toolset.isBaseToolset,
+  isCompactedEvent: () => import_compacted_event.isCompactedEvent,
   isFinalResponse: () => import_event.isFinalResponse,
   isFunctionTool: () => import_function_tool.isFunctionTool,
   isGemini2OrAbove: () => import_model_name.isGemini2OrAbove,
   isLlmAgent: () => import_llm_agent.isLlmAgent,
   isLoopAgent: () => import_loop_agent.isLoopAgent,
   isParallelAgent: () => import_parallel_agent.isParallelAgent,
+  isRunner: () => import_runner.isRunner,
   isSequentialAgent: () => import_sequential_agent.isSequentialAgent,
   setLogLevel: () => import_logger.setLogLevel,
   setLogger: () => import_logger.setLogger,
@@ -114,6 +128,8 @@ var import_llm_agent = require("./agents/llm_agent.js");
 var import_loop_agent = require("./agents/loop_agent.js");
 var import_parallel_agent = require("./agents/parallel_agent.js");
 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_readonly_context = require("./agents/readonly_context.js");
 var import_run_config = require("./agents/run_config.js");
 var import_sequential_agent = require("./agents/sequential_agent.js");
@@ -121,6 +137,10 @@ var import_in_memory_artifact_service = require("./artifacts/in_memory_artifact_
 var import_auth_credential = require("./auth/auth_credential.js");
 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_llm_summarizer = require("./context/summarizers/llm_summarizer.js");
+var import_token_based_context_compactor = require("./context/token_based_context_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");
 var import_event_actions = require("./events/event_actions.js");
 var import_structured_events = require("./events/structured_events.js");
@@ -146,7 +166,10 @@ var import_base_toolset = require("./tools/base_toolset.js");
 var import_exit_loop_tool = require("./tools/exit_loop_tool.js");
 var import_function_tool = require("./tools/function_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_long_running_tool = require("./tools/long_running_tool.js");
+var import_preload_memory_tool = require("./tools/preload_memory_tool.js");
 var import_tool_confirmation = require("./tools/tool_confirmation.js");
 var import_logger = require("./utils/logger.js");
 var import_model_name = require("./utils/model_name.js");
@@ -179,7 +202,10 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   BaseTool,
   BaseToolset,
   BuiltInCodeExecutor,
+  CONTENT_REQUEST_PROCESSOR,
+  ContentRequestProcessor,
   Context,
+  ContextCompactorRequestProcessor,
   EXIT_LOOP,
   EventType,
   ExitLoopTool,
@@ -195,15 +221,22 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   InMemorySessionService,
   InvocationContext,
   LLMRegistry,
+  LOAD_ARTIFACTS,
+  LOAD_MEMORY,
   LiveRequestQueue,
   LlmAgent,
+  LlmSummarizer,
+  LoadArtifactsTool,
+  LoadMemoryTool,
   LogLevel,
   LoggingPlugin,
   LongRunningFunctionTool,
   LoopAgent,
+  PRELOAD_MEMORY,
   ParallelAgent,
   PluginManager,
   PolicyOutcome,
+  PreloadMemoryTool,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
   ReadonlyContext,
   Runner,
@@ -211,7 +244,9 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   SequentialAgent,
   State,
   StreamingMode,
+  TokenBasedContextCompactor,
   ToolConfirmation,
+  TruncatingContextCompactor,
   createEvent,
   createEventActions,
   createSession,
@@ -228,12 +263,14 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isBaseLlm,
   isBaseTool,
   isBaseToolset,
+  isCompactedEvent,
   isFinalResponse,
   isFunctionTool,
   isGemini2OrAbove,
   isLlmAgent,
   isLoopAgent,
   isParallelAgent,
+  isRunner,
   isSequentialAgent,
   setLogLevel,
   setLogger,

package/dist/cjs/context/base_context_compactor.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 base_context_compactor_exports = {};
+module.exports = __toCommonJS(base_context_compactor_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/cjs/context/summarizers/base_summarizer.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 base_summarizer_exports = {};
+module.exports = __toCommonJS(base_summarizer_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */

package/dist/cjs/context/summarizers/llm_summarizer.js

@@ -0,0 +1,93 @@
+/**
+  * @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 llm_summarizer_exports = {};
+__export(llm_summarizer_exports, {
+  LlmSummarizer: () => LlmSummarizer
+});
+module.exports = __toCommonJS(llm_summarizer_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
+ */
+const DEFAULT_PROMPT = "The following is a conversation history between a user and an AI agent. Please summarize the conversation, focusing on key information and decisions made, as well as any unresolved questions or tasks. The summary should be concise and capture the essence of the interaction.";
+class LlmSummarizer {
+  constructor(options) {
+    this.llm = options.llm;
+    this.prompt = options.prompt || DEFAULT_PROMPT;
+  }
+  async summarize(events) {
+    var _a, _b, _c, _d, _e, _f;
+    if (events.length === 0) {
+      throw new Error("Cannot summarize an empty list of events.");
+    }
+    const startTime = events[0].timestamp;
+    const endTime = events[events.length - 1].timestamp;
+    let formattedEvents = "";
+    for (let i = 0; i < events.length; i++) {
+      formattedEvents += `[Event ${i + 1} - Author: ${events[i].author}]
+`;
+      formattedEvents += `${(0, import_event.stringifyContent)(events[i])}
+
+`;
+    }
+    const fullPrompt = `${this.prompt}
+
+${formattedEvents}`;
+    const request = {
+      contents: [{ role: "user", parts: [{ text: fullPrompt }] }],
+      toolsDict: {},
+      liveConnectConfig: {}
+    };
+    const responseGen = this.llm.generateContentAsync(request, false);
+    let compactedContent = "";
+    const firstResponse = await responseGen.next();
+    if (firstResponse.done || !((_c = (_b = (_a = firstResponse.value.content) == null ? void 0 : _a.parts) == null ? void 0 : _b[0]) == null ? void 0 : _c.text)) {
+      throw new Error("LLM failed to return a valid summary.");
+    }
+    compactedContent += firstResponse.value.content.parts[0].text;
+    for await (const chunk of responseGen) {
+      if ((_f = (_e = (_d = chunk.content) == null ? void 0 : _d.parts) == null ? void 0 : _e[0]) == null ? void 0 : _f.text) {
+        compactedContent += chunk.content.parts[0].text;
+      }
+    }
+    return (0, import_compacted_event.createCompactedEvent)({
+      author: "system",
+      content: {
+        role: "model",
+        parts: [{ text: compactedContent }]
+      },
+      startTime,
+      endTime,
+      compactedContent
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LlmSummarizer
+});

package/dist/cjs/context/token_based_context_compactor.js

@@ -0,0 +1,135 @@
+/**
+  * @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 token_based_context_compactor_exports = {};
+__export(token_based_context_compactor_exports, {
+  TokenBasedContextCompactor: () => TokenBasedContextCompactor
+});
+module.exports = __toCommonJS(token_based_context_compactor_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
+ */
+class TokenBasedContextCompactor {
+  constructor(options) {
+    this.tokenThreshold = options.tokenThreshold;
+    this.eventRetentionSize = options.eventRetentionSize;
+    this.summarizer = options.summarizer;
+  }
+  getActiveEvents(events) {
+    let latestCompactedEvent = void 0;
+    for (let i = events.length - 1; i >= 0; i--) {
+      const e = events[i];
+      if ((0, import_compacted_event.isCompactedEvent)(e)) {
+        if (!latestCompactedEvent || e.endTime > latestCompactedEvent.endTime) {
+          latestCompactedEvent = e;
+        }
+      }
+    }
+    if (!latestCompactedEvent) {
+      return events;
+    }
+    const activeRawEvents = events.filter(
+      (e) => !(0, import_compacted_event.isCompactedEvent)(e) && e.timestamp > latestCompactedEvent.endTime
+    );
+    return [latestCompactedEvent, ...activeRawEvents];
+  }
+  shouldCompact(invocationContext) {
+    const events = invocationContext.session.events;
+    const activeEvents = this.getActiveEvents(events);
+    const rawEvents = activeEvents.filter((e) => !(0, import_compacted_event.isCompactedEvent)(e));
+    if (rawEvents.length <= this.eventRetentionSize) {
+      return false;
+    }
+    let totalTokens = 0;
+    for (const event of activeEvents) {
+      totalTokens += getEventTokens(event);
+    }
+    return totalTokens > this.tokenThreshold;
+  }
+  async compact(invocationContext) {
+    const events = invocationContext.session.events;
+    const activeEvents = this.getActiveEvents(events);
+    const rawEvents = activeEvents.filter((e) => !(0, import_compacted_event.isCompactedEvent)(e));
+    if (rawEvents.length <= this.eventRetentionSize) {
+      return;
+    }
+    let retainStartIndex = Math.max(
+      0,
+      rawEvents.length - this.eventRetentionSize
+    );
+    while (retainStartIndex > 0) {
+      const eventToRetain = rawEvents[retainStartIndex];
+      const previousEvent = rawEvents[retainStartIndex - 1];
+      if (hasFunctionResponse(eventToRetain) && hasFunctionCall(previousEvent)) {
+        retainStartIndex--;
+      } else {
+        break;
+      }
+    }
+    if (retainStartIndex === 0) {
+      return;
+    }
+    const rawEventsToCompact = rawEvents.slice(0, retainStartIndex);
+    const compactedEventPresent = activeEvents.find(import_compacted_event.isCompactedEvent);
+    const eventsToCompact = compactedEventPresent ? [compactedEventPresent, ...rawEventsToCompact] : rawEventsToCompact;
+    const compactedEvent = await this.summarizer.summarize(eventsToCompact);
+    if (!compactedEvent.actions) {
+      compactedEvent.actions = {
+        stateDelta: {},
+        artifactDelta: {},
+        requestedAuthConfigs: [],
+        requestedToolConfirmations: {}
+      };
+    }
+    invocationContext.session.events.push(compactedEvent);
+  }
+}
+function getEventTokens(event) {
+  var _a;
+  if (((_a = event.usageMetadata) == null ? void 0 : _a.promptTokenCount) !== void 0) {
+    return event.usageMetadata.promptTokenCount;
+  }
+  const contentStr = (0, import_event.stringifyContent)(event);
+  return Math.ceil(contentStr.length / 4);
+}
+function hasFunctionCall(event) {
+  var _a, _b;
+  return !!((_b = (_a = event.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.some(
+    (part) => part.functionCall !== void 0
+  ));
+}
+function hasFunctionResponse(event) {
+  var _a, _b;
+  return !!((_b = (_a = event.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.some(
+    (part) => part.functionResponse !== void 0
+  ));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TokenBasedContextCompactor
+});

package/dist/cjs/context/truncating_context_compactor.js

@@ -0,0 +1,58 @@
+/**
+  * @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 truncating_context_compactor_exports = {};
+__export(truncating_context_compactor_exports, {
+  TruncatingContextCompactor: () => TruncatingContextCompactor
+});
+module.exports = __toCommonJS(truncating_context_compactor_exports);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class TruncatingContextCompactor {
+  constructor(options) {
+    var _a;
+    this.threshold = options.threshold;
+    this.preserveLeadingEvents = (_a = options.preserveLeadingEvents) != null ? _a : 0;
+  }
+  shouldCompact(invocationContext) {
+    const eventsLength = invocationContext.session.events.length;
+    return eventsLength > this.threshold + Math.max(0, this.preserveLeadingEvents);
+  }
+  compact(invocationContext) {
+    const events = invocationContext.session.events;
+    const excess = events.length - this.threshold - Math.max(0, this.preserveLeadingEvents);
+    if (excess <= 0) {
+      return;
+    }
+    const startIndexToRemove = Math.max(0, this.preserveLeadingEvents);
+    events.splice(startIndexToRemove, excess);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TruncatingContextCompactor
+});