@cuylabs/agent-core 4.10.0 → 5.0.1

package/dist/agent/turn-context/compaction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC"}

package/dist/agent/turn-context/compaction/memory.d.ts

@@ -2,16 +2,17 @@ import type { Logger } from "../../../logger/types.js";
 import type { AgentMemoryProvider } from "../../../memory/index.js";
 import type { AgentContextCompactionPhase } from "../../../types/events.js";
 import type { Message } from "../../../types/messages.js";
-export declare function prepareMemoryForCompaction(options: {
+export declare function captureMemoryBeforeCompactionCommit(options: {
     provider?: AgentMemoryProvider;
     sessionId?: string;
     turnId?: string;
     cwd?: string;
     abort?: AbortSignal;
     phase?: AgentContextCompactionPhase;
-    removedMessages: Message[];
-    keptMessages: Message[];
-    summary?: string;
+    removedMessages: readonly Message[];
+    recentKeptMessages: readonly Message[];
+    previousSummary?: string;
+    nextSummary?: string;
     logger: Logger;
 }): Promise<void>;
 //# sourceMappingURL=memory.d.ts.map

package/dist/agent/turn-context/compaction/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,wBAAsB,mCAAmC,CAAC,OAAO,EAAE;IACjE,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,eAAe,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,kBAAkB,EAAE,SAAS,OAAO,EAAE,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB"}

package/dist/agent/turn-context/compaction/results.d.ts

@@ -1,10 +1,13 @@
+import { type ContextTokenEstimator } from "../../../context/window/index.js";
 import type { ContextCompactionDecision } from "../../../context/window/decision.js";
-import type { CompactionCutReason } from "../../../types/compaction.js";
+import type { CompactionCutReason, CompactionReason, CompactionTrigger } from "../../../types/compaction.js";
 import type { Message } from "../../../types/messages.js";
 import type { AgentMessageCompactionResult } from "./types.js";
 export declare function createUnchangedCompactionResult(options: {
     messages: Message[];
     decision: ContextCompactionDecision;
+    trigger?: CompactionTrigger;
+    reason?: CompactionReason;
     tokensBefore: number;
     limit: number;
     cutIndex?: number;
@@ -13,7 +16,10 @@ export declare function createUnchangedCompactionResult(options: {
 export declare function createToolContextCompactionResult(options: {
     messages: Message[];
     decision: ContextCompactionDecision;
+    trigger?: CompactionTrigger;
+    reason?: CompactionReason;
     tokensBefore: number;
     limit: number;
+    tokenEstimator?: ContextTokenEstimator;
 }): AgentMessageCompactionResult;
 //# sourceMappingURL=results.d.ts.map

package/dist/agent/turn-context/compaction/results.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/results.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D,wBAAgB,+BAA+B,CAAC,OAAO,EAAE;IACvD,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC,GAAG,4BAA4B,CAsB/B;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IACzD,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,4BAA4B,CAsB/B"}
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/results.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE/D,wBAAgB,+BAA+B,CAAC,OAAO,EAAE;IACvD,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC,GAAG,4BAA4B,CAwB/B;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IACzD,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,GAAG,4BAA4B,CA2B/B"}

package/dist/agent/turn-context/compaction/types.d.ts

@@ -1,13 +1,17 @@
 import type { ContextCompactionDecision } from "../../../context/window/decision.js";
-import type { CompactionCutReason, CompactionEffectiveness } from "../../../types/compaction.js";
+import type { CompactionCutReason, CompactionEffectiveness, CompactionReason, CompactionTrigger } from "../../../types/compaction.js";
 import type { Message } from "../../../types/messages.js";
 export interface AgentContextCompactionResult {
+    trigger?: CompactionTrigger;
+    reason?: CompactionReason;
     decision: ContextCompactionDecision;
     effectiveness: CompactionEffectiveness;
     removedCount: number;
     tokensRemoved: number;
     summarized: boolean;
     summary?: string;
+    previousSummary?: string;
+    nextSummary?: string;
     cutIndex?: number;
     cutReason?: CompactionCutReason;
 }
@@ -15,6 +19,8 @@ export interface AgentMessageCompactionResult extends AgentContextCompactionResu
     compacted: boolean;
     messages: Message[];
     persistedMessages: Message[];
+    removedMessages?: readonly Message[];
+    keptMessages?: readonly Message[];
     displaySummary: boolean;
     storageSummary: string;
     tokensBefore: number;

package/dist/agent/turn-context/compaction/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,uBAAuB,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,4BAA6B,SAAQ,4BAA4B;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,iBAAiB,EAAE,OAAO,EAAE,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/agent/turn-context/compaction/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,WAAW,4BAA4B;IAC3C,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,EAAE,uBAAuB,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,WAAW,4BAA6B,SAAQ,4BAA4B;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,iBAAiB,EAAE,OAAO,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/agent/turn-context/fit-model-context.d.ts

@@ -4,7 +4,7 @@ import type { ContextWindowManager } from "../../context/window/index.js";
 import type { Logger } from "../../logger/types.js";
 import type { AgentMemoryProvider } from "../../memory/index.js";
 import type { MiddlewareRunner } from "../../middleware/runner.js";
-import type { SessionManager } from "../../storage/index.js";
+import type { SessionManager } from "../../sessions/index.js";
 import type { AgentEvent } from "../../types/events.js";
 export declare function assembleChatModelContextToFit(params: {
     sessionId: string;

package/dist/agent/turn-context/fit-model-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fit-model-context.d.ts","sourceRoot":"","sources":["../../../src/agent/turn-context/fit-model-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAkBxD,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,oBAAoB,CAAC;IACrC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC,CA0DD"}
+{"version":3,"file":"fit-model-context.d.ts","sourceRoot":"","sources":["../../../src/agent/turn-context/fit-model-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAkBxD,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,oBAAoB,CAAC;IACrC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC,CA2DD"}

package/dist/agent/turn-context/index.d.ts

@@ -1,4 +1,4 @@
-export { compactAgentContext, compactAgentMessages, } from "./compaction/index.js";
+export { commitAgentContextCompaction, compactAgentContext, compactAgentMessages, } from "./compaction/index.js";
 export type { AgentContextCompactionResult, AgentMessageCompactionResult, } from "./compaction/index.js";
 export { assembleChatModelContextToFit } from "./fit-model-context.js";
 export { buildAgentSystemPrompts } from "./system-prompts.js";

package/dist/agent/turn-context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/turn-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/turn-context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/agent/types/config.d.ts

@@ -17,6 +17,7 @@ import type { AgentContextConfig } from "../../context/config.js";
 import type { DoomLoopHandler } from "../../types/doom-loop.js";
 import type { AgentTurnToolProvider } from "../../tool/turn-tools.js";
 import type { AgentMemoryInput } from "../../memory/index.js";
+import type { SessionStore } from "../../sessions/index.js";
 import type { TracingConfig } from "./tracing.js";
 import type { AgentDefaultsProvider } from "../defaults.js";
 /**
@@ -96,6 +97,12 @@ export interface AgentConfig {
      * tool design; agent-core owns lifecycle hooks and model-visible contextFragments.
      */
     memory?: AgentMemoryInput;
+    /**
+     * Pluggable session history store. When omitted, sessions use the default
+     * in-memory store. Pass `sessionManager` to provide a fully configured
+     * manager instead.
+     */
+    sessionStore?: SessionStore;
     /**
      * Middleware for the agent lifecycle.
      */

package/dist/agent/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/agent/types/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/agent/types/config.ts"],"names":[],"mappings":"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"}

package/dist/{chunk-LX4AHGI3.js → chunk-346FIYKT.js}

@@ -5,7 +5,7 @@ import {
 import {
   DEFAULT_CONTEXT_LIMITS,
   getUsableTokenLimit
-} from "./chunk-NMJNN6LS.js";
+} from "./chunk-DYZGHHDB.js";
 import {
   Inference,
   buildModelCallContext

package/dist/{chunk-EBVSPHXA.js → chunk-556CPZ3J.js}

@@ -1,7 +1,7 @@
 import {
   buildEntryPath,
   deserializeMessage
-} from "./chunk-VMGZKIFT.js";
+} from "./chunk-EDKZOPUV.js";
 import {
   Tool
 } from "./chunk-MJML3A2F.js";

package/dist/{chunk-V4YQ6MBK.js → chunk-BKHWKKSG.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-TPZ37IWI.js";
 import {
   createLocalDispatchRuntime
-} from "./chunk-EBVSPHXA.js";
+} from "./chunk-556CPZ3J.js";
 import {
   Tool
 } from "./chunk-MJML3A2F.js";

package/dist/{chunk-AAGKWUXR.js → chunk-CGP6UNCQ.js}

@@ -249,8 +249,13 @@ function parseRenderedAgentContextFragment(content) {
 }
 
 // src/context/window/estimation.ts
-function estimateTokens(text) {
-  return Math.ceil(text.length / 4);
+function normalizeTokenEstimate(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+  const normalized = Math.ceil(value);
+  return normalized >= 0 ? normalized : void 0;
+}
+function estimateTokens(text, estimator) {
+  return normalizeTokenEstimate(estimator?.estimateTextTokens?.(text)) ?? Math.ceil(text.length / 4);
 }
 function stringifyStructuredValue(value) {
   if (typeof value === "string") return value;
@@ -261,26 +266,30 @@ function stringifyStructuredValue(value) {
     return String(value);
   }
 }
-function estimateInternalToolCalls(message) {
+function estimateInternalToolCalls(message, estimator) {
   if (message.role !== "assistant" || !("toolCalls" in message) || !Array.isArray(message.toolCalls)) {
     return 0;
   }
   return message.toolCalls.reduce((total, toolCall) => {
-    return total + estimateTokens(toolCall.toolName) + estimateTokens(toolCall.toolCallId) + estimateTokens(stringifyStructuredValue(toolCall.args));
+    return total + estimateTokens(toolCall.toolName, estimator) + estimateTokens(toolCall.toolCallId, estimator) + estimateTokens(stringifyStructuredValue(toolCall.args), estimator);
   }, 0);
 }
-function estimateMessageTokens(message) {
-  const toolCallTokens = estimateInternalToolCalls(message);
+function estimateMessageTokens(message, estimator) {
+  const customEstimate = normalizeTokenEstimate(
+    estimator?.estimateMessageTokens?.(message)
+  );
+  if (customEstimate !== void 0) return customEstimate;
+  const toolCallTokens = estimateInternalToolCalls(message, estimator);
   if (typeof message.content === "string") {
-    return estimateTokens(message.content) + toolCallTokens;
+    return estimateTokens(message.content, estimator) + toolCallTokens;
   }
   if (Array.isArray(message.content)) {
     let total = 0;
     for (const part of message.content) {
       if (typeof part === "string") {
-        total += estimateTokens(part);
+        total += estimateTokens(part, estimator);
       } else if ("text" in part && typeof part.text === "string") {
-        total += estimateTokens(part.text);
+        total += estimateTokens(part.text, estimator);
       } else if ("type" in part && part.type === "image") {
         total += 765;
       }
@@ -289,10 +298,10 @@ function estimateMessageTokens(message) {
   }
   return toolCallTokens;
 }
-function estimateMessageWithOverhead(message) {
-  return estimateMessageTokens(message) + 4;
+function estimateMessageWithOverhead(message, estimator) {
+  return estimateMessageTokens(message, estimator) + 4;
 }
-function estimateFromRecentUsage(messages) {
+function estimateFromRecentUsage(messages, estimator) {
   for (let i = messages.length - 1; i >= 0; i--) {
     const message = messages[i];
     if (message.role !== "assistant" || !("tokens" in message) || !message.tokens) {
@@ -307,17 +316,20 @@ function estimateFromRecentUsage(messages) {
       message.tokens.totalTokens ?? 0
     );
     const trailingTokens = messages.slice(i + 1).reduce((total, trailingMessage) => {
-      return total + estimateMessageWithOverhead(trailingMessage);
+      return total + estimateMessageWithOverhead(trailingMessage, estimator);
     }, 0);
     return usageTokens + trailingTokens;
   }
   return void 0;
 }
-function estimateConversationTokens(messages) {
-  const heuristic = messages.reduce((total, message) => {
-    return total + estimateMessageWithOverhead(message);
+function estimateConversationTokens(messages, estimator) {
+  const customEstimate = normalizeTokenEstimate(
+    estimator?.estimateConversationTokens?.(messages)
+  );
+  const heuristic = customEstimate ?? messages.reduce((total, message) => {
+    return total + estimateMessageWithOverhead(message, estimator);
   }, 0);
-  const usageEstimate = estimateFromRecentUsage(messages);
+  const usageEstimate = estimateFromRecentUsage(messages, estimator);
   return Math.max(heuristic, usageEstimate ?? 0);
 }
 
@@ -455,7 +467,10 @@ function applyAgentContextFragmentsWithReport(messages, contextFragments = [], o
       inputIndex,
       message,
       budgetBehavior: contextFragmentBudgetBehavior(message),
-      estimatedTokenCount: estimateConversationTokens([message])
+      estimatedTokenCount: estimateConversationTokens(
+        [message],
+        options.tokenEstimator
+      )
     });
   }
   const budgeted = applyContextFragmentBudget(

package/dist/{chunk-EEAGM5MS.js → chunk-DD7S7ZG4.js}

@@ -16,18 +16,20 @@ function resolveAgentMemoryConfig(input) {
       maxRecords: recall.maxRecords ?? recall.limit ?? 5,
       maxRecordChars: recall.maxRecordChars ?? 700
     },
-    turns: resolveAgentMemoryTurnConfig(config.turns),
+    capture: resolveAgentMemoryCaptureConfig(config.capture),
     tools: {
       enabled: tools.enabled ?? true,
       deferred: tools.deferred ?? false
     }
   };
 }
-function resolveAgentMemoryTurnConfig(input) {
-  const turns = input && typeof input === "object" ? input : { enabled: input !== false };
+function resolveAgentMemoryCaptureConfig(input) {
+  const capture = input && typeof input === "object" ? input : { enabled: input !== false };
   return {
-    enabled: turns.enabled ?? true,
-    contextMessageLimit: resolveContextMessageLimit(turns.contextMessageLimit)
+    enabled: capture.enabled ?? true,
+    contextMessageLimit: resolveContextMessageLimit(
+      capture.contextMessageLimit
+    )
   };
 }
 function resolveContextMessageLimit(value) {
@@ -114,7 +116,7 @@ function collectTurnContextMessages(options) {
   );
   return withoutCurrentTurn.slice(-options.limit);
 }
-async function notifyTurnStart(options) {
+async function notifyCaptureStart(options) {
   if (!options.provider.onTurnStart) return;
   await options.provider.onTurnStart({
     sessionId: options.sessionId,
@@ -124,7 +126,7 @@ async function notifyTurnStart(options) {
     messages: options.messages
   });
 }
-async function notifyTurnEnd(options) {
+async function notifyCaptureEnd(options) {
   if (!options.provider.onTurnEnd) return;
   const input = {
     sessionId: options.sessionId,
@@ -141,7 +143,7 @@ async function notifyTurnEnd(options) {
 function createMemoryMiddleware(options) {
   const activeInputs = /* @__PURE__ */ new Map();
   const recallCache = /* @__PURE__ */ new Map();
-  const turns = resolveAgentMemoryTurnConfig(options.turns);
+  const capture = resolveAgentMemoryCaptureConfig(options.capture);
   const recallFrequency = options.recall.frequency ?? "per-turn";
   return {
     name: `memory:${options.provider.id}`,
@@ -199,10 +201,25 @@ function createMemoryMiddleware(options) {
         }
       };
     },
+    async beforeContextCompactionCommit(ctx) {
+      if (!options.provider.captureBeforeCompactionCommit) return;
+      if (ctx.removedMessages.length === 0) return;
+      await options.provider.captureBeforeCompactionCommit({
+        sessionId: ctx.sessionId,
+        ...ctx.turnId ? { turnId: ctx.turnId } : {},
+        cwd: ctx.cwd,
+        ...ctx.phase ? { phase: ctx.phase } : {},
+        removedMessages: ctx.removedMessages,
+        recentKeptMessages: ctx.keptMessages.slice(-20),
+        ...ctx.previousSummary !== void 0 ? { previousSummary: ctx.previousSummary } : {},
+        ...ctx.nextSummary !== void 0 ? { nextSummary: ctx.nextSummary } : {},
+        ...ctx.abort ? { abort: ctx.abort } : {}
+      });
+    },
     async onChatStart(sessionId, message, ctx) {
       activeInputs.set(turnKey(sessionId, ctx?.turnId), message);
-      if (!turns.enabled) return;
-      await notifyTurnStart({
+      if (!capture.enabled) return;
+      await notifyCaptureStart({
         provider: options.provider,
         sessionId,
         ...ctx?.turnId ? { turnId: ctx.turnId } : {},
@@ -210,7 +227,7 @@ function createMemoryMiddleware(options) {
         input: message,
         messages: collectTurnContextMessages({
           history: ctx?.history,
-          limit: turns.contextMessageLimit,
+          limit: capture.contextMessageLimit,
           input: message
         })
       });
@@ -227,8 +244,8 @@ function createMemoryMiddleware(options) {
           query: input
         })
       );
-      if (!turns.enabled) return;
-      await notifyTurnEnd({
+      if (!capture.enabled) return;
+      await notifyCaptureEnd({
         provider: options.provider,
         sessionId,
         ...ctx?.turnId ? { turnId: ctx.turnId } : {},
@@ -239,7 +256,7 @@ function createMemoryMiddleware(options) {
         ...result.usage ? { usage: result.usage } : {},
         messages: collectTurnContextMessages({
           history: ctx?.history,
-          limit: turns.contextMessageLimit,
+          limit: capture.contextMessageLimit,
           input,
           ...result.output !== void 0 ? { output: result.output } : {}
         })
@@ -250,7 +267,7 @@ function createMemoryMiddleware(options) {
 
 export {
   resolveAgentMemoryConfig,
-  resolveAgentMemoryTurnConfig,
+  resolveAgentMemoryCaptureConfig,
   normalizeMemoryRecords,
   formatMemoryContextFragment,
   createMemoryMiddleware