agents 0.13.3 → 0.14.0

package/dist/experimental/memory/session/index.d.ts

@@ -1,29 +1,30 @@
 import {
-  A as SessionMessage,
-  C as AgentSessionProvider,
-  D as StoredCompaction,
-  E as SessionProvider,
-  M as SessionOptions,
-  N as SessionTokenCounter,
-  O as CompactAfterOptions,
-  P as SessionTokenCounterInput,
-  S as isSearchProvider,
-  T as SearchResult,
-  _ as R2SkillProvider,
-  b as AgentSearchProvider,
-  f as ContextBlock,
-  g as isWritableProvider,
-  h as WritableContextProvider,
-  j as SessionMessagePart,
-  k as CompactionErrorHandler,
-  m as ContextProvider,
-  p as ContextConfig,
+  A as CompactContext,
+  C as isSearchProvider,
+  D as SessionProvider,
+  E as SearchResult,
+  F as SessionTokenCounter,
+  I as SessionTokenCounterInput,
+  M as SessionMessage,
+  N as SessionMessagePart,
+  O as StoredCompaction,
+  P as SessionOptions,
+  S as SearchProvider,
+  T as SqlProvider,
+  _ as isWritableProvider,
+  b as isSkillProvider,
+  g as WritableContextProvider,
+  h as ContextProvider,
+  j as CompactionErrorHandler,
+  k as CompactAfterOptions,
+  m as ContextConfig,
+  p as ContextBlock,
   r as CompactResult,
-  v as SkillProvider,
-  w as SqlProvider,
-  x as SearchProvider,
-  y as isSkillProvider
-} from "../../../compaction-helpers-B-pG5J22.js";
+  v as R2SkillProvider,
+  w as AgentSessionProvider,
+  x as AgentSearchProvider,
+  y as SkillProvider
+} from "../../../compaction-helpers-DpP_XP9J.js";
 import { ToolSet } from "ai";
 
 //#region src/experimental/memory/session/session.d.ts
@@ -59,6 +60,7 @@ declare class Session {
   private _pending?;
   private _cachedPrompt?;
   private _compactionFn?;
+  private _warnedCompactionNoOp;
   private _tokenThreshold?;
   private _tokenCounter?;
   private _compactionErrorHandler?;
@@ -105,7 +107,10 @@ declare class Session {
    * message history into a summary overlay.
    */
   onCompaction(
-    fn: (messages: SessionMessage[]) => Promise<CompactResult | null>
+    fn: (
+      messages: SessionMessage[],
+      context?: CompactContext
+    ) => Promise<CompactResult | null>
   ): this;
   /**
    * Auto-compact when estimated token count exceeds the threshold.

package/dist/experimental/memory/session/index.js

@@ -1,5 +1,5 @@
 import "../../../types.js";
-import { m as estimateStringTokens, p as estimateMessageTokens, t as COMPACTION_PREFIX } from "../../../compaction-helpers-fJyf8j4m.js";
+import { m as estimateStringTokens, p as estimateMessageTokens, t as COMPACTION_PREFIX } from "../../../compaction-helpers-BjT2NKRZ.js";
 import { z } from "zod";
 //#region src/experimental/memory/session/search.ts
 /**
@@ -1021,6 +1021,7 @@ function isSqlProvider(arg) {
 }
 var Session = class Session {
 	constructor(storage, options) {
+		this._warnedCompactionNoOp = false;
 		this._ready = false;
 		this.storage = storage;
 		this.context = new ContextBlocks(options?.context ?? [], options?.promptStore);
@@ -1327,6 +1328,10 @@ var Session = class Session {
 		let compacted = false;
 		if (this._tokenThreshold != null && this._compactionFn && tokenEstimate > this._tokenThreshold) try {
 			compacted = Boolean(await this.compact());
+			if (!compacted && !this._warnedCompactionNoOp) {
+				this._warnedCompactionNoOp = true;
+				console.warn(`[Session] Auto-compaction fired (~${tokenEstimate} tokens > ${this._tokenThreshold}) but the compaction function returned null, so history was not shortened. ` + (this._tokenCounter ? `A tokenCounter is configured and now flows to the boundary logic, but it is invoked per-message there — a whole-prompt/usage counter (e.g. returning a fixed usage.inputTokens regardless of which messages are passed) degrades the tail budget to minTailMessages and can still no-op. Pass a per-message CompactOptions.tokenCounter for precise tail budgeting.` : `If your history is tool-heavy, configure a tokenCounter on compactAfter() — it flows to createCompactFunction's boundary logic automatically.`));
+			} else if (compacted) this._warnedCompactionNoOp = false;
 		} catch (err) {
 			await this._handleAutoCompactionError(err);
 		}
@@ -1381,7 +1386,7 @@ var Session = class Session {
 		const tokensBefore = await this._emitStatus("compacting");
 		let result;
 		try {
-			result = await this._compactionFn(await this.getHistory());
+			result = await this._compactionFn(await this.getHistory(), { tokenCounter: this._tokenCounter });
 		} catch (err) {
 			this._emitError(err instanceof Error ? err.message : String(err));
 			return null;