@cuylabs/agent-core 4.10.0 → 5.0.0

package/dist/context/index.js

@@ -1,6 +1,6 @@
 import {
   assembleModelContext
-} from "../chunk-IQA64CAO.js";
+} from "../chunk-TYQWH6XH.js";
 import {
   ContextSummaryModelRequiredError,
   ContextWindowManager,
@@ -8,6 +8,7 @@ import {
   DEFAULT_CONTEXT_LIMITS,
   DEFAULT_SUMMARY_MAX_INPUT_TOKENS,
   DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS,
+  DEFAULT_TOOL_CONTEXT_PRUNE_POLICY,
   canGenerateCompactionSummary,
   createCompactionEffectiveness,
   createCompactionSummaryContent,
@@ -15,6 +16,8 @@ import {
   extractCompactionSummaryText,
   generateSplitTurnSummary,
   generateSummary,
+  getAutoCompactTokenLimit,
+  getEffectiveContextWindow,
   getUsableTokenLimit,
   isContextOverflowing,
   planCompactionCut,
@@ -27,7 +30,7 @@ import {
   serializeMessagesForSummary,
   shouldFallbackOnSummaryFailure,
   shouldPruneContext
-} from "../chunk-NMJNN6LS.js";
+} from "../chunk-DYZGHHDB.js";
 import {
   AGENT_CONTEXT_FRAGMENT_CLOSE,
   AGENT_CONTEXT_FRAGMENT_OPEN,
@@ -44,7 +47,7 @@ import {
   normalizeAgentContextFragment,
   parseRenderedAgentContextFragment,
   renderAgentContextFragment
-} from "../chunk-AAGKWUXR.js";
+} from "../chunk-CGP6UNCQ.js";
 export {
   AGENT_CONTEXT_FRAGMENT_CLOSE,
   AGENT_CONTEXT_FRAGMENT_OPEN,
@@ -55,6 +58,7 @@ export {
   DEFAULT_CONTEXT_LIMITS,
   DEFAULT_SUMMARY_MAX_INPUT_TOKENS,
   DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS,
+  DEFAULT_TOOL_CONTEXT_PRUNE_POLICY,
   applyAgentContextFragments,
   applyAgentContextFragmentsWithReport,
   assembleModelContext,
@@ -70,6 +74,8 @@ export {
   generateSplitTurnSummary,
   generateSummary,
   getAgentContextFragmentMetadata,
+  getAutoCompactTokenLimit,
+  getEffectiveContextWindow,
   getUsableTokenLimit,
   isAgentContextFragmentMessage,
   isContextOverflowing,

package/dist/context/window/budget.d.ts

@@ -14,6 +14,22 @@ import type { CompactionEffectiveness } from "../../types/compaction.js";
 export interface ContextLimits {
     /** Maximum context window size in tokens */
     contextWindow: number;
+    /**
+     * Percentage of the context window considered usable for model input.
+     *
+     * This is a coarse safety margin for provider overhead, system prompts, tool
+     * schemas, and tokenizer-estimation error. It is combined with
+     * `reserveTokens`; the smaller limit wins.
+     */
+    effectiveContextWindowPercent?: number;
+    /**
+     * Token threshold that triggers automatic compaction.
+     *
+     * When unset, automatic compaction triggers at the usable token limit. When
+     * set, it is clamped to the usable limit so a configured threshold cannot
+     * exceed the model-safe input budget.
+     */
+    autoCompactTokenLimit?: number;
     /** Reserve tokens for output generation */
     reserveTokens: number;
     /** Protect this many recent tokens from pruning */
@@ -54,7 +70,18 @@ export declare const DEFAULT_COMPACTION_EFFECTIVE_MIN_SAVINGS_RATIO = 0.02;
  * This is the single formula for the safe input threshold used by overflow
  * detection, auto-compaction event emission, and step-processing limits.
  */
-export declare function getUsableTokenLimit(limits: Pick<ContextLimits, "contextWindow" | "reserveTokens">): number;
+export declare function getUsableTokenLimit(limits: Pick<ContextLimits, "contextWindow" | "reserveTokens" | "effectiveContextWindowPercent">): number;
+/**
+ * Compute the safety-adjusted context window before output-token reservation.
+ */
+export declare function getEffectiveContextWindow(limits: Pick<ContextLimits, "contextWindow" | "effectiveContextWindowPercent">): number;
+/**
+ * Resolve the threshold that starts automatic compaction.
+ *
+ * This is intentionally separate from the usable limit: callers can compact
+ * before the hard input budget is exhausted, but never after it.
+ */
+export declare function getAutoCompactTokenLimit(limits: Pick<ContextLimits, "contextWindow" | "reserveTokens" | "effectiveContextWindowPercent" | "autoCompactTokenLimit">): number;
 /**
  * Check whether the context is overflowing.
  *

package/dist/context/window/budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/context/window/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAMzE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,8CAA8C,OAAO,CAAC;AAMnE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,GAAG,eAAe,CAAC,GAC7D,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,aAAsC,GAC7C,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,aAAsC,GAC7C,OAAO,CAGT;AAWD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,eAAe,GAAE,MAAuD,GACvE,uBAAuB,CAiBzB;AAMD,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAcD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAgBR"}
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/context/window/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAMzE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC;AAmBF;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AAEvD;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,8CAA8C,OAAO,CAAC;AAMnE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CACV,aAAa,EACb,eAAe,GAAG,eAAe,GAAG,+BAA+B,CACpE,GACA,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CACV,aAAa,EACb,eAAe,GAAG,+BAA+B,CAClD,GACA,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CACV,aAAa,EACX,eAAe,GACf,eAAe,GACf,+BAA+B,GAC/B,uBAAuB,CAC1B,GACA,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,aAAsC,GAC7C,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,aAAsC,GAC7C,OAAO,CAGT;AAWD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,eAAe,GAAE,MAAuD,GACvE,uBAAuB,CAiBzB;AAMD,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAQD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAgBR"}

package/dist/context/window/compactor.d.ts

@@ -5,11 +5,11 @@
  * and summary generation into one operation over a message array.
  */
 import type { Message } from "../../types/index.js";
-import type { CompactionCutReason } from "../../types/compaction.js";
+import type { CompactionCutReason, CompactionEffectiveness, CompactionReason, CompactionTrigger, ToolContextPrunePolicy } from "../../types/compaction.js";
+import { type ContextTokenEstimator } from "./estimation.js";
 import { type ContextLimits } from "./budget.js";
 import { type ContextCompactionDecision } from "./decision.js";
 import { type ToolContextPruneReport } from "./tool-pruning.js";
-import type { CompactionEffectiveness } from "../../types/compaction.js";
 import { type ContextSummaryPolicy, type ResolvedContextSummaryPolicy } from "./summary-policy.js";
 /**
  * Options for {@link pruneContext}.
@@ -19,11 +19,24 @@ export interface PruneContextOptions {
     limits?: ContextLimits;
     /** Summary behavior for conversation cuts. */
     summary?: ContextSummaryPolicy | ResolvedContextSummaryPolicy;
+    /** Cheap tool-context pruning controls. */
+    toolPruning?: {
+        /** Set false to skip old tool-output and tool-argument pruning. */
+        enabled?: boolean;
+        /** Policy for deciding how aggressively old tool context is compacted. */
+        policy?: ToolContextPrunePolicy;
+    };
     /**
      * Force a best-effort compaction pass after the provider reports context
      * overflow.
      */
     force?: boolean;
+    /** Lifecycle source that requested this compaction pass. */
+    trigger?: CompactionTrigger;
+    /** Operational reason for the pass. */
+    reason?: CompactionReason;
+    /** Optional model-aware token estimator for context-window planning. */
+    tokenEstimator?: ContextTokenEstimator;
 }
 /**
  * Result of a pruning operation.
@@ -43,6 +56,8 @@ export interface PruneResult {
     summarized: boolean;
     /** The summary content, if generated */
     summary?: string;
+    /** Existing handoff summary incorporated into the generated summary, if any */
+    previousSummary?: string;
     /** Summary policy resolved for this pruning operation */
     summaryPolicy: ResolvedContextSummaryPolicy;
     /** Messages removed by conversation cutting, when applicable */

package/dist/context/window/compactor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../src/context/window/compactor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EAClC,MAAM,qBAAqB,CAAC;AAM7B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,oBAAoB,GAAG,4BAA4B,CAAC;IAC9D;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,sEAAsE;IACtE,QAAQ,EAAE,yBAAyB,CAAC;IACpC,kCAAkC;IAClC,aAAa,EAAE,uBAAuB,CAAC;IACvC,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,aAAa,EAAE,4BAA4B,CAAC;IAC5C,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAyBD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,WAAW,CAAC,CA+KtB"}
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../src/context/window/compactor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,aAAa,EAKnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EAClC,MAAM,qBAAqB,CAAC;AAM7B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,oBAAoB,GAAG,4BAA4B,CAAC;IAC9D,2CAA2C;IAC3C,WAAW,CAAC,EAAE;QACZ,mEAAmE;QACnE,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,0EAA0E;QAC1E,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC,CAAC;IACF;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,uCAAuC;IACvC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,wEAAwE;IACxE,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,sEAAsE;IACtE,QAAQ,EAAE,yBAAyB,CAAC;IACpC,kCAAkC;IAClC,aAAa,EAAE,uBAAuB,CAAC;IACvC,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,aAAa,EAAE,4BAA4B,CAAC;IAC5C,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAyBD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,WAAW,CAAC,CAmMtB"}

package/dist/context/window/cut-planner.d.ts

@@ -7,6 +7,7 @@
  */
 import type { Message } from "../../types/messages.js";
 import type { CompactionCutReason } from "../../types/compaction.js";
+import { type ContextTokenEstimator } from "./estimation.js";
 /**
  * Rich planning result for conversation cutting.
  */
@@ -51,6 +52,8 @@ export interface PlanCompactionCutOptions {
      * planner should try split-turn prefix compaction.
      */
     maxKeptTokens?: number;
+    /** Optional model-aware token estimator for cut planning. */
+    tokenEstimator?: ContextTokenEstimator;
 }
 /**
  * Plan a safe conversation cut.

package/dist/context/window/cut-planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cut-planner.d.ts","sourceRoot":"","sources":["../../../src/context/window/cut-planner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAoB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAYrE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;IAC3C,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,wEAAwE;IACxE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,yEAAyE;IACzE,yBAAyB,EAAE,OAAO,EAAE,CAAC;IACrC,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuPD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,GAAE,MAA+C,EAChE,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAoInB"}
+{"version":3,"file":"cut-planner.d.ts","sourceRoot":"","sources":["../../../src/context/window/cut-planner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAoB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,iBAAiB,CAAC;AAOzB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;IAC3C,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,wEAAwE;IACxE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,yEAAyE;IACzE,yBAAyB,EAAE,OAAO,EAAE,CAAC;IACrC,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AA4PD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,GAAE,MAA+C,EAChE,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CA8JnB"}

package/dist/context/window/decision.d.ts

@@ -6,7 +6,9 @@
  * reserved for the later summary-generation step after a safe cut is selected.
  */
 import type { Message } from "../../types/messages.js";
+import type { CompactionReason, CompactionTrigger } from "../../types/compaction.js";
 import { type ContextLimits } from "./budget.js";
+import { type ContextTokenEstimator } from "./estimation.js";
 export type ContextCompactionDecisionReason = "below-prune-minimum" | "under-limit" | "overflow" | "forced-recovery";
 export type ContextCompactionDecisionStrategy = "none" | "tool-context-first";
 export interface ContextCompactionDecision {
@@ -18,13 +20,17 @@ export interface ContextCompactionDecision {
     strategy: ContextCompactionDecisionStrategy;
     /** Whether the caller forced compaction after provider overflow. */
     forced: boolean;
+    /** Lifecycle source that requested this decision. */
+    trigger?: CompactionTrigger;
+    /** Operational reason for running compaction. */
+    compactionReason?: CompactionReason;
     /** Whether a summary model is available if history must be cut. */
     canSummarize: boolean;
     /** Estimated input tokens before compaction. */
     inputTokens: number;
-    /** Usable input limit: context window minus reserved output tokens. */
+    /** Token threshold that starts compaction for this decision. */
     limit: number;
-    /** Estimated tokens above the usable limit. */
+    /** Estimated tokens above the compaction threshold. */
     overflowTokens: number;
     /** Recent token suffix protected from compaction. */
     protectedTokens: number;
@@ -36,6 +42,9 @@ export interface DecideContextCompactionOptions {
     force?: boolean;
     canSummarize?: boolean;
     inputTokens?: number;
+    trigger?: CompactionTrigger;
+    reason?: CompactionReason;
+    tokenEstimator?: ContextTokenEstimator;
 }
 export declare function decideContextCompaction(messages: readonly Message[], options?: DecideContextCompactionOptions): ContextCompactionDecision;
 //# sourceMappingURL=decision.d.ts.map

package/dist/context/window/decision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../src/context/window/decision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,aAAa,CAAC;AAGrB,MAAM,MAAM,+BAA+B,GACvC,qBAAqB,GACrB,aAAa,GACb,UAAU,GACV,iBAAiB,CAAC;AAEtB,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG,oBAAoB,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,+BAA+B,CAAC;IACxC,iEAAiE;IACjE,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,GAAE,8BAAmC,GAC3C,yBAAyB,CAkE3B"}
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../src/context/window/decision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,+BAA+B,GACvC,qBAAqB,GACrB,aAAa,GACb,UAAU,GACV,iBAAiB,CAAC;AAEtB,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG,oBAAoB,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,+BAA+B,CAAC;IACxC,iEAAiE;IACjE,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AA2CD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,GAAE,8BAAmC,GAC3C,yBAAyB,CAkF3B"}

package/dist/context/window/estimation.d.ts

@@ -10,15 +10,30 @@
  */
 import type { Message } from "../../types/messages.js";
 import type { ModelMessage } from "ai";
+/**
+ * Optional estimator used by context-window planning.
+ *
+ * The contract is intentionally named "estimator" instead of "tokenizer":
+ * callers may provide an exact model tokenizer, but approximations are also
+ * valid. Invalid return values are ignored and the built-in heuristic is used.
+ */
+export interface ContextTokenEstimator {
+    /** Estimate plain text. Used for message content, tool names, and arguments. */
+    estimateTextTokens?(text: string): number | undefined;
+    /** Estimate one model-visible message. Takes precedence over text estimates. */
+    estimateMessageTokens?(message: Message | ModelMessage): number | undefined;
+    /** Estimate the full message list. Takes precedence over message estimates. */
+    estimateConversationTokens?(messages: readonly (Message | ModelMessage)[]): number | undefined;
+}
 /**
  * Estimate token count for a plain string.
  *
  * Uses the widely-accepted `chars / 4` heuristic.
  *
  * @param text - Text to estimate
- * @returns Estimated token count (always ≥ 1 for non-empty input)
+ * @returns Estimated token count
  */
-export declare function estimateTokens(text: string): number;
+export declare function estimateTokens(text: string, estimator?: ContextTokenEstimator): number;
 /**
  * Estimate token count for a single message.
  *
@@ -29,7 +44,7 @@ export declare function estimateTokens(text: string): number;
  * @param message - A `Message` (internal) or `ModelMessage` (AI SDK)
  * @returns Estimated token count
  */
-export declare function estimateMessageTokens(message: Message | ModelMessage): number;
+export declare function estimateMessageTokens(message: Message | ModelMessage, estimator?: ContextTokenEstimator): number;
 /**
  * Estimate total tokens for an entire conversation.
  *
@@ -41,5 +56,5 @@ export declare function estimateMessageTokens(message: Message | ModelMessage):
  * @param messages - Array of messages to estimate
  * @returns Estimated total token count
  */
-export declare function estimateConversationTokens(messages: readonly (Message | ModelMessage)[]): number;
+export declare function estimateConversationTokens(messages: readonly (Message | ModelMessage)[], estimator?: ContextTokenEstimator): number;
 //# sourceMappingURL=estimation.d.ts.map

package/dist/context/window/estimation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"estimation.d.ts","sourceRoot":"","sources":["../../../src/context/window/estimation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAMvC;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAmCD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAwB7E;AA4CD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,GAC5C,MAAM,CAOR"}
+{"version":3,"file":"estimation.d.ts","sourceRoot":"","sources":["../../../src/context/window/estimation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAMvC;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,gFAAgF;IAChF,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtD,gFAAgF;IAChF,qBAAqB,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5E,+EAA+E;IAC/E,0BAA0B,CAAC,CACzB,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,GAC5C,MAAM,GAAG,SAAS,CAAC;CACvB;AAQD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAKR;AAsCD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,GAAG,YAAY,EAC/B,SAAS,CAAC,EAAE,qBAAqB,GAChC,MAAM,CA6BR;AAgDD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,EAC7C,SAAS,CAAC,EAAE,qBAAqB,GAChC,MAAM,CAYR"}

package/dist/context/window/index.d.ts

@@ -5,21 +5,23 @@
  * implementation split into focused files.
  */
 export { estimateTokens, estimateMessageTokens, estimateConversationTokens, } from "./estimation.js";
-export { DEFAULT_CONTEXT_LIMITS, DEFAULT_COMPACTION_EFFECTIVE_MIN_SAVINGS_RATIO, DEFAULT_SUMMARY_MAX_INPUT_TOKENS, DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS, createCompactionEffectiveness, getUsableTokenLimit, isContextOverflowing, resolveSummaryOutputTokens, shouldPruneContext, } from "./budget.js";
+export type { ContextTokenEstimator } from "./estimation.js";
+export { DEFAULT_CONTEXT_LIMITS, DEFAULT_COMPACTION_EFFECTIVE_MIN_SAVINGS_RATIO, DEFAULT_SUMMARY_MAX_INPUT_TOKENS, DEFAULT_SUMMARY_MAX_OUTPUT_TOKENS, createCompactionEffectiveness, getAutoCompactTokenLimit, getEffectiveContextWindow, getUsableTokenLimit, isContextOverflowing, resolveSummaryOutputTokens, shouldPruneContext, } from "./budget.js";
 export type { ContextLimits, SummaryOutputBudgetOptions } from "./budget.js";
 export { planCompactionCut } from "./cut-planner.js";
 export type { CompactionCutPlan, PlanCompactionCutOptions, } from "./cut-planner.js";
 export { decideContextCompaction } from "./decision.js";
 export type { ContextCompactionDecision, ContextCompactionDecisionReason, ContextCompactionDecisionStrategy, DecideContextCompactionOptions, } from "./decision.js";
-export { pruneToolContext, pruneToolContextWithReport, } from "./tool-pruning.js";
+export { DEFAULT_TOOL_CONTEXT_PRUNE_POLICY, pruneToolContext, pruneToolContextWithReport, } from "./tool-pruning.js";
 export type { ToolContextPruneReport, ToolContextPruneResult, } from "./tool-pruning.js";
+export type { ToolContextPrunePolicy } from "../../types/compaction.js";
 export { createCompactionSummaryContent, extractCompactionSummaryText, generateSummary, generateSplitTurnSummary, redactSummaryText, serializeMessagesForSummary, } from "./summary.js";
 export type { SplitTurnSummarizationOptions, SummarizationOptions, } from "./summary.js";
 export type { SummarySerializationOptions } from "./summary.js";
 export { pruneContext } from "./compactor.js";
 export type { PruneContextOptions, PruneResult } from "./compactor.js";
 export { ContextWindowManager } from "./manager.js";
-export type { ContextWindowStats } from "./manager.js";
+export type { ContextWindowStats, ContextWindowToolPruningOptions, } from "./manager.js";
 export { canGenerateCompactionSummary, ContextSummaryModelRequiredError, resolveContextSummaryPolicy, shouldFallbackOnSummaryFailure, } from "./summary-policy.js";
 export type { ContextSummaryPolicy, ResolvedContextSummaryPolicy, } from "./summary-policy.js";
 export type { ContextSummaryMode } from "../../types/compaction.js";

package/dist/context/window/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/window/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,8CAA8C,EAC9C,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,EAC7B,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EACV,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EACV,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,eAAe,EACf,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/window/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EACL,sBAAsB,EACtB,8CAA8C,EAC9C,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,EAC7B,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EACV,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EACV,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iCAAiC,EACjC,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,eAAe,EACf,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,+BAA+B,GAChC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/context/window/manager.d.ts

@@ -7,18 +7,33 @@
  */
 import type { LanguageModel, ModelMessage } from "ai";
 import type { Message } from "../../types/index.js";
+import type { CompactionReason, CompactionTrigger, ToolContextPrunePolicy } from "../../types/compaction.js";
+import { type ContextTokenEstimator } from "./estimation.js";
 import { type ContextLimits } from "./budget.js";
 import { type PruneResult } from "./compactor.js";
 import { type ContextCompactionDecision } from "./decision.js";
 import { type ContextSummaryPolicy, type ResolvedContextSummaryPolicy } from "./summary-policy.js";
 export interface ContextWindowStats {
     tokens: number;
+    /** Threshold that starts automatic compaction. Kept as `limit` for compatibility. */
     limit: number;
+    /** Safety-adjusted context window before reserving output tokens. */
+    effectiveContextWindow: number;
+    /** Hard model-input budget after output-token reservation. */
+    usableLimit: number;
+    /** Threshold used by automatic pruning decisions. */
+    autoCompactLimit: number;
     available: number;
     utilizationPercent: number;
     isOverflowing: boolean;
     shouldPrune: boolean;
 }
+export interface ContextWindowToolPruningOptions {
+    /** Set false to skip deterministic old tool-output and tool-argument pruning. */
+    enabled?: boolean;
+    /** Policy for deciding how aggressively old tool context is compacted. */
+    policy?: ToolContextPrunePolicy;
+}
 /**
  * Per-session context-window manager.
  *
@@ -39,11 +54,16 @@ export declare class ContextWindowManager {
     private limits;
     private activeModel?;
     private summaryPolicy?;
+    private toolPruning?;
+    private tokenEstimator?;
     constructor(options?: {
         limits?: Partial<ContextLimits>;
         /** Active agent model. Used for summaries unless `summary.model` overrides it. */
         model?: LanguageModel;
         summary?: ContextSummaryPolicy;
+        toolPruning?: ContextWindowToolPruningOptions;
+        /** Optional model-aware token estimator for context planning. */
+        tokenEstimator?: ContextTokenEstimator;
     });
     /** Get a copy of the current context limits. */
     getLimits(): ContextLimits;
@@ -53,6 +73,14 @@ export declare class ContextWindowManager {
     setModel(model: LanguageModel): void;
     /** Set the summary policy used when conversation history must be cut. */
     setSummaryPolicy(policy: ContextSummaryPolicy): void;
+    /** Set deterministic tool-context pruning behavior. */
+    setToolPruning(options: ContextWindowToolPruningOptions): void;
+    /** Get deterministic tool-context pruning behavior. */
+    getToolPruning(): ContextWindowToolPruningOptions | undefined;
+    /** Set the token estimator used for context-window planning. */
+    setTokenEstimator(estimator: ContextTokenEstimator | undefined): void;
+    /** Get the token estimator used for context-window planning. */
+    getTokenEstimator(): ContextTokenEstimator | undefined;
     /** Resolve summary policy against the active agent model. */
     getSummaryPolicy(): ResolvedContextSummaryPolicy;
     /** Estimate total tokens for a message array. */
@@ -65,10 +93,15 @@ export declare class ContextWindowManager {
     decide(messages: readonly Message[], options?: {
         force?: boolean;
         inputTokens?: number;
+        trigger?: CompactionTrigger;
+        reason?: CompactionReason;
     }): ContextCompactionDecision;
     /** Prune context to fit within limits. */
     prune(messages: Message[], options?: {
         force?: boolean;
+        trigger?: CompactionTrigger;
+        reason?: CompactionReason;
+        toolPruning?: ContextWindowToolPruningOptions;
     }): Promise<PruneResult>;
     /**
      * Get a snapshot of token statistics.

package/dist/context/window/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/context/window/manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EAClC,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAC,CAAuB;gBAEjC,OAAO,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAChC,kFAAkF;QAClF,KAAK,CAAC,EAAE,aAAa,CAAC;QACtB,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAChC;IAMD,gDAAgD;IAChD,SAAS,IAAI,aAAa;IAI1B,0DAA0D;IAC1D,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAI/C,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIpC,yEAAyE;IACzE,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAIpD,6DAA6D;IAC7D,gBAAgB,IAAI,4BAA4B;IAIhD,iDAAiD;IACjD,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,GAAG,MAAM;IAIrE,gDAAgD;IAChD,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,GAAG,OAAO;IAKrE,iDAAiD;IACjD,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,GAAG,OAAO;IAKnE,qDAAqD;IACrD,MAAM,CACJ,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,yBAAyB;IAU5B,0CAA0C;IACpC,KAAK,CACT,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,OAAO,CAAC,WAAW,CAAC;IAQvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,YAAY,CAAC,EAAE,GAAG,kBAAkB;CAa5E"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/context/window/manager.ts"],"names":[],"mappings":"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"}

package/dist/context/window/summary.d.ts

@@ -32,6 +32,15 @@ export interface SummarySerializationOptions {
     maxInputTokens?: number;
     /** Max estimated tokens per message before middle truncation */
     maxMessageTokens?: number;
+    /**
+     * Fraction of the serialized budget reserved for the newest removed
+     * messages when the transcript is too large to include in full.
+     *
+     * Compaction summaries need both the original goal and the latest removed
+     * work nearest the kept suffix. A tail-biased default avoids spending the
+     * whole summary prompt on stale early context.
+     */
+    recentMessageRatio?: number;
 }
 export declare function createCompactionSummaryContent(summary: string): string;
 export declare function extractCompactionSummaryText(message: Message): string | undefined;

package/dist/context/window/summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/context/window/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AASvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA8B,SAAQ,oBAAoB;IACzE,iEAAiE;IACjE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,wEAAwE;IACxE,yBAAyB,EAAE,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAmCD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,SAAS,CAIpB;AAsBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQtD;AA2CD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,2BAAgC,GACxC,MAAM,CAiCR;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAiCjB"}
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/context/window/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AASvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA8B,SAAQ,oBAAoB;IACzE,iEAAiE;IACjE,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,wEAAwE;IACxE,yBAAyB,EAAE,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAqCD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,SAAS,CAIpB;AAsBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQtD;AAgLD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,2BAAgC,GACxC,MAAM,CA2BR;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/dist/context/window/tool-pruning.d.ts

@@ -7,6 +7,9 @@
  * tool-call/result shape.
  */
 import type { Message } from "../../types/index.js";
+import { type ToolContextPrunePolicy } from "../../types/compaction.js";
+import { type ContextTokenEstimator } from "./estimation.js";
+export declare const DEFAULT_TOOL_CONTEXT_PRUNE_POLICY: Required<ToolContextPrunePolicy>;
 export interface ToolContextPruneReport {
     /** Number of tool result messages compacted. */
     outputCompactedCount: number;
@@ -40,6 +43,10 @@ export interface ToolContextPruneResult {
 export declare function pruneToolContextWithReport(messages: Message[], protectedTokens?: number, options?: {
     /** Additional tools to protect from pruning */
     protectedTools?: string[];
+    /** Policy for deciding how aggressively old tool context is compacted. */
+    policy?: ToolContextPrunePolicy;
+    /** Optional model-aware token estimator for tool context pruning. */
+    tokenEstimator?: ContextTokenEstimator;
 }): ToolContextPruneResult;
 /**
  * Prune old, large tool context from the conversation.
@@ -58,5 +65,9 @@ export declare function pruneToolContextWithReport(messages: Message[], protecte
 export declare function pruneToolContext(messages: Message[], protectedTokens?: number, options?: {
     /** Additional tools to protect from pruning */
     protectedTools?: string[];
+    /** Policy for deciding how aggressively old tool context is compacted. */
+    policy?: ToolContextPrunePolicy;
+    /** Optional model-aware token estimator for tool context pruning. */
+    tokenEstimator?: ContextTokenEstimator;
 }): Message[];
 //# sourceMappingURL=tool-pruning.d.ts.map

package/dist/context/window/tool-pruning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-pruning.d.ts","sourceRoot":"","sources":["../../../src/context/window/tool-pruning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,OAAO,EAER,MAAM,sBAAsB,CAAC;AAkB9B,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AA0ND;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,GAAE,MAA+C,EAChE,OAAO,CAAC,EAAE;IACR,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GACA,sBAAsB,CA+FxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,GAAE,MAA+C,EAChE,OAAO,CAAC,EAAE;IACR,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GACA,OAAO,EAAE,CAGX"}
+{"version":3,"file":"tool-pruning.d.ts","sourceRoot":"","sources":["../../../src/context/window/tool-pruning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,OAAO,EAER,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,iBAAiB,CAAC;AAIzB,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,sBAAsB,CAY5E,CAAC;AAEJ,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAuSD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,GAAE,MAA+C,EAChE,OAAO,CAAC,EAAE;IACR,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,qEAAqE;IACrE,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,GACA,sBAAsB,CAwGxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,GAAE,MAA+C,EAChE,OAAO,CAAC,EAAE;IACR,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,qEAAqE;IACrE,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,GACA,OAAO,EAAE,CAGX"}

package/dist/dispatch/index.js

@@ -15,11 +15,11 @@ import {
   DISPATCH_STATES,
   createDispatchTools,
   createLocalDispatchRuntime
-} from "../chunk-EBVSPHXA.js";
-import "../chunk-VMGZKIFT.js";
+} from "../chunk-556CPZ3J.js";
+import "../chunk-EDKZOPUV.js";
 import "../chunk-SZ2XBPTW.js";
 import "../chunk-MJML3A2F.js";
-import "../chunk-AAGKWUXR.js";
+import "../chunk-CGP6UNCQ.js";
 export {
   DEFAULT_DISPATCH_TOOL_IDS,
   DEFAULT_LOCAL_DISPATCH_CONCURRENCY,

package/dist/execution/index.js

@@ -14,7 +14,7 @@ import {
   processStepStream,
   runModelStep,
   runToolBatch
-} from "../chunk-LX4AHGI3.js";
+} from "../chunk-346FIYKT.js";
 import {
   applyAgentWorkflowCommitResult,
   applyAgentWorkflowContextCompactionResult,
@@ -42,8 +42,8 @@ import {
   getCurrentAgentTurnStepRecord,
   mergeAgentTurnStateProgress
 } from "../chunk-E66PKKDL.js";
-import "../chunk-NMJNN6LS.js";
-import "../chunk-AAGKWUXR.js";
+import "../chunk-DYZGHHDB.js";
+import "../chunk-CGP6UNCQ.js";
 import {
   convertAgentMessagesToModelMessages
 } from "../chunk-K453AFTL.js";

package/dist/execution/turn/index.js

@@ -10,7 +10,7 @@ import {
   processStepStream,
   runModelStep,
   runToolBatch
-} from "../../chunk-LX4AHGI3.js";
+} from "../../chunk-346FIYKT.js";
 import {
   AgentTurnStateConflictError,
   advanceAgentTurnState,
@@ -19,8 +19,8 @@ import {
   getCurrentAgentTurnStepRecord,
   mergeAgentTurnStateProgress
 } from "../../chunk-E66PKKDL.js";
-import "../../chunk-NMJNN6LS.js";
-import "../../chunk-AAGKWUXR.js";
+import "../../chunk-DYZGHHDB.js";
+import "../../chunk-CGP6UNCQ.js";
 import "../../chunk-K453AFTL.js";
 import "../../chunk-STDJYXYK.js";
 import "../../chunk-JUIL2NJC.js";

package/dist/index.d.ts

@@ -18,7 +18,7 @@
  *   @cuylabs/agent-core/reasoning  — level config, provider builders
  *   @cuylabs/agent-core/tool/host  — tool execution host interfaces and local host
  *   @cuylabs/agent-core/sandbox    — managed environment sessions above ToolHost
- *   @cuylabs/agent-core/storage    — sessions, file/memory backends
+ *   @cuylabs/agent-core/sessions   — session history, managers, stores
  *   @cuylabs/agent-core/skill      — discovery, loading, registry
  *   @cuylabs/agent-core/events     — typed signals and channel event bus
  *   @cuylabs/agent-core/execution/scope — ambient execution context
@@ -47,7 +47,7 @@ export * from "./tool/host/index.js";
 export * from "./sandbox/index.js";
 export * from "./execution/scope/index.js";
 export * from "./inference/index.js";
-export * from "./storage/index.js";
+export * from "./sessions/index.js";
 export * from "./tracking/index.js";
 export * from "./context/index.js";
 export * from "./memory/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,yBAAyB,CAAC;AAKxC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,uBAAuB,CAAC;AAKtC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAKpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,sBAAsB,CAAC;AAKrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAKlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,sBAAsB,CAAC;AAKrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAKlC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAIH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,yBAAyB,CAAC;AAKxC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,uBAAuB,CAAC;AAKtC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,qBAAqB,CAAC;AAKpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,sBAAsB,CAAC;AAKrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAKlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,sBAAsB,CAAC;AAKrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAKlC,cAAc,kBAAkB,CAAC"}