@animalabs/context-manager 0.2.0 → 0.4.0

package/dist/src/context-manager.d.ts

@@ -1,6 +1,7 @@
 import { JsStore } from '@animalabs/chronicle';
 import type { Membrane, ContentBlock } from '@animalabs/membrane';
-import type { MessageId, Sequence, MessageMetadata, StoredMessage, TokenBudget, PendingWork, BranchInfo, ContextStrategy, MessageQuery, MessageQueryResult, ContextInjection, CompileResult } from './types/index.js';
+import type { MessageId, Sequence, MessageMetadata, StoredMessage, TokenBudget, PendingWork, BranchInfo, ContextStrategy, MessageQuery, MessageQueryResult, ContextInjection, CompileResult, ProtectedRange, SearchQuery, SearchResult, SummaryEntry } from './types/index.js';
+import type { RenderStats } from './types/index.js';
 /**
  * Base configuration for ContextManager.
  */
@@ -69,6 +70,8 @@ export declare class ContextManager {
     /** Whether we own the store (created it) vs app owns it (passed in) */
     private ownsStore;
     private debugLogContext;
+    /** Namespace passed to strategies for scoping their persistent state slots. */
+    private strategyNamespace;
     private constructor();
     /**
      * Open or create a context manager.
@@ -140,12 +143,36 @@ export declare class ContextManager {
     /**
      * Create a branch from a specific message.
      * The new branch will have state as of that message's sequence (time-travel branching).
+     *
+     * Returns the new branch *name*, which is what `switchBranch` and `forkAt`
+     * expect. (Chronicle's branch APIs are name-keyed; the numeric `id` field
+     * on JsBranch is an internal identifier and isn't accepted by switchBranch.)
      */
     branchAt(messageId: MessageId, name?: string): string;
     /**
      * Switch to a different branch.
+     *
+     * Re-initializes the strategy after switching so any branch-scoped state
+     * stored on Chronicle is reloaded. Strategies that hold derived in-memory
+     * caches (e.g. AutobiographicalStrategy.summaries) need this to avoid
+     * showing the previous branch's state on the new branch.
      */
-    switchBranch(branchId: string): void;
+    switchBranch(branchId: string): Promise<void>;
+    /**
+     * Fork from the current head: create a new branch at the current sequence
+     * and switch to it. The new branch starts with all current state (messages,
+     * context log, and strategy state) and diverges from there.
+     *
+     * Use this when an agent wants to explore an alternate timeline from
+     * "now" — e.g. trying a different response without committing.
+     *
+     * For time-travel branching at a specific historical message, use
+     * `branchAt(messageId, name?)` instead, then `switchBranch(name)`.
+     *
+     * Returns the new branch's name. The strategy is re-initialized on the
+     * new branch so it picks up the forked state.
+     */
+    fork(name?: string): Promise<string>;
     /**
      * Get current branch.
      */
@@ -187,6 +214,46 @@ export declare class ContextManager {
      * Get the current strategy.
      */
     getStrategy(): ContextStrategy;
+    /**
+     * Pin a range of messages so they aren't compressed and render raw at
+     * their original chronological position. Returns the new pin id.
+     *
+     * Throws if the active strategy doesn't support pins.
+     */
+    pinRange(firstMessageId: MessageId, lastMessageId: MessageId, opts?: {
+        name?: string;
+    }): string;
+    /**
+     * Mark a single message as a "document" (semantically a body of
+     * information to retain in full). Same effect as a single-message pin
+     * with `kind: 'document'`. Returns the new pin id.
+     */
+    markDocument(messageId: MessageId, opts?: {
+        name?: string;
+    }): string;
+    /** Remove a pin or document mark. Returns true if removed. */
+    unpin(pinId: string): boolean;
+    /** List all current pins. Returns empty array if strategy is not pinnable. */
+    listPins(): ReadonlyArray<ProtectedRange>;
+    /**
+     * Search the strategy's summary archive (substring or regex over content).
+     * Returns empty array if the strategy doesn't support search.
+     *
+     * Suitable for building memory-search agent tools at the framework layer
+     * — see e.g. agent-framework's MCPL host integration.
+     */
+    searchSummaries(query: SearchQuery): SearchResult[];
+    /** Look up a single summary by id. Returns null if not found / unsupported. */
+    getSummary(id: string): SummaryEntry | null;
+    /**
+     * Per-render stats from the active strategy: head/tail message + token
+     * counts, plus per-level summary counts and total tokens. Returns null
+     * if the strategy doesn't implement `getRenderStats`.
+     *
+     * Designed for TUIs / dashboards that want to display "how much of the
+     * agent's context is folded vs raw" at a glance.
+     */
+    getRenderStats(): RenderStats | null;
     /**
      * Reset the head window to start from a new position.
      * Old head window messages become compressible.

package/dist/src/context-manager.d.ts.map

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

package/dist/src/context-manager.js

@@ -1,5 +1,5 @@
 import { JsStore } from '@animalabs/chronicle';
-import { isResettableStrategy } from './types/index.js';
+import { isResettableStrategy, isPinnableStrategy, isSearchableStrategy, isRenderStatsCapable } from './types/index.js';
 import { MessageStore } from './message-store.js';
 import { ContextLog } from './context-log.js';
 import { PassthroughStrategy } from './strategies/passthrough.js';
@@ -19,12 +19,15 @@ export class ContextManager {
     /** Whether we own the store (created it) vs app owns it (passed in) */
     ownsStore;
     debugLogContext;
-    constructor(store, messageStore, contextLog, strategy, ownsStore, membrane, debugLogContext = false) {
+    /** Namespace passed to strategies for scoping their persistent state slots. */
+    strategyNamespace;
+    constructor(store, messageStore, contextLog, strategy, ownsStore, strategyNamespace, membrane, debugLogContext = false) {
         this.store = store;
         this.messageStore = messageStore;
         this.contextLog = contextLog;
         this.strategy = strategy;
         this.ownsStore = ownsStore;
+        this.strategyNamespace = strategyNamespace;
         this.membrane = membrane;
         this.debugLogContext = debugLogContext;
         // Set up edit propagation
@@ -86,7 +89,11 @@ export class ContextManager {
             namespace: config.namespace,
         });
         const strategy = config.strategy ?? new PassthroughStrategy();
-        const manager = new ContextManager(store, messageStore, contextLog, strategy, ownsStore, config.membrane, config.debugLogContext ?? false);
+        // Namespace passed to strategies. Falls back to a stable per-store value
+        // so strategies always have something to scope state IDs by, even when
+        // the caller didn't supply a namespace.
+        const strategyNamespace = config.namespace ?? 'default';
+        const manager = new ContextManager(store, messageStore, contextLog, strategy, ownsStore, strategyNamespace, config.membrane, config.debugLogContext ?? false);
         // Initialize strategy
         await manager.initializeStrategy();
         manager.initialized = true;
@@ -180,6 +187,10 @@ export class ContextManager {
     /**
      * Create a branch from a specific message.
      * The new branch will have state as of that message's sequence (time-travel branching).
+     *
+     * Returns the new branch *name*, which is what `switchBranch` and `forkAt`
+     * expect. (Chronicle's branch APIs are name-keyed; the numeric `id` field
+     * on JsBranch is an internal identifier and isn't accepted by switchBranch.)
      */
     branchAt(messageId, name) {
         const message = this.messageStore.get(messageId);
@@ -192,13 +203,41 @@ export class ContextManager {
         const currentBranch = this.store.currentBranch();
         // Use createBranchAt to branch at the message's sequence (time-travel)
         const branch = this.store.createBranchAt(branchName, currentBranch.name, message.sequence);
-        return branch.id;
+        return branch.name;
     }
     /**
      * Switch to a different branch.
+     *
+     * Re-initializes the strategy after switching so any branch-scoped state
+     * stored on Chronicle is reloaded. Strategies that hold derived in-memory
+     * caches (e.g. AutobiographicalStrategy.summaries) need this to avoid
+     * showing the previous branch's state on the new branch.
      */
-    switchBranch(branchId) {
+    async switchBranch(branchId) {
         this.store.switchBranch(branchId);
+        await this.initializeStrategy();
+    }
+    /**
+     * Fork from the current head: create a new branch at the current sequence
+     * and switch to it. The new branch starts with all current state (messages,
+     * context log, and strategy state) and diverges from there.
+     *
+     * Use this when an agent wants to explore an alternate timeline from
+     * "now" — e.g. trying a different response without committing.
+     *
+     * For time-travel branching at a specific historical message, use
+     * `branchAt(messageId, name?)` instead, then `switchBranch(name)`.
+     *
+     * Returns the new branch's name. The strategy is re-initialized on the
+     * new branch so it picks up the forked state.
+     */
+    async fork(name) {
+        const branchName = name ?? `fork-${Date.now()}`;
+        const currentBranch = this.store.currentBranch();
+        const currentSeq = this.store.currentSequence();
+        const branch = this.store.createBranchAt(branchName, currentBranch.name, currentSeq);
+        await this.switchBranch(branch.name);
+        return branch.name;
     }
     /**
      * Get current branch.
@@ -261,11 +300,15 @@ export class ContextManager {
      * May block if strategy has pending work.
      */
     async compile(budget, injections) {
-        // Check readiness and wait if needed
-        const readiness = this.strategy.checkReadiness();
-        if (!readiness.ready && readiness.pendingWork) {
-            await readiness.pendingWork;
-        }
+        // Don't block the agent's turn on speculative compression — let it
+        // run in the background. The strategy renders whatever's available
+        // now; the next compile picks up the freshly-formed L1.
+        //
+        // Old behavior (await pendingWork to fold the latest chunk before
+        // the agent responds) added 30+ seconds of latency per turn whenever
+        // a chunk was forming, which is unacceptable UX for an agent that
+        // streams its responses. We accept "this turn doesn't have the very
+        // latest L1" in exchange for non-blocking compile.
         // Default budget
         const effectiveBudget = budget ?? {
             maxTokens: 100000,
@@ -379,6 +422,79 @@ export class ContextManager {
     getStrategy() {
         return this.strategy;
     }
+    // ==========================================================================
+    // Pins / documents (passthrough to the active strategy)
+    // ==========================================================================
+    /**
+     * Pin a range of messages so they aren't compressed and render raw at
+     * their original chronological position. Returns the new pin id.
+     *
+     * Throws if the active strategy doesn't support pins.
+     */
+    pinRange(firstMessageId, lastMessageId, opts) {
+        if (!isPinnableStrategy(this.strategy)) {
+            throw new Error('Active strategy does not support pins');
+        }
+        return this.strategy.pinRange(firstMessageId, lastMessageId, opts);
+    }
+    /**
+     * Mark a single message as a "document" (semantically a body of
+     * information to retain in full). Same effect as a single-message pin
+     * with `kind: 'document'`. Returns the new pin id.
+     */
+    markDocument(messageId, opts) {
+        if (!isPinnableStrategy(this.strategy)) {
+            throw new Error('Active strategy does not support documents');
+        }
+        return this.strategy.markDocument(messageId, opts);
+    }
+    /** Remove a pin or document mark. Returns true if removed. */
+    unpin(pinId) {
+        if (!isPinnableStrategy(this.strategy)) {
+            throw new Error('Active strategy does not support pins');
+        }
+        return this.strategy.unpin(pinId);
+    }
+    /** List all current pins. Returns empty array if strategy is not pinnable. */
+    listPins() {
+        if (!isPinnableStrategy(this.strategy))
+            return [];
+        return this.strategy.listPins();
+    }
+    // ==========================================================================
+    // Search (passthrough to the active strategy)
+    // ==========================================================================
+    /**
+     * Search the strategy's summary archive (substring or regex over content).
+     * Returns empty array if the strategy doesn't support search.
+     *
+     * Suitable for building memory-search agent tools at the framework layer
+     * — see e.g. agent-framework's MCPL host integration.
+     */
+    searchSummaries(query) {
+        if (!isSearchableStrategy(this.strategy))
+            return [];
+        return this.strategy.searchSummaries(query);
+    }
+    /** Look up a single summary by id. Returns null if not found / unsupported. */
+    getSummary(id) {
+        if (!isSearchableStrategy(this.strategy))
+            return null;
+        return this.strategy.getSummary(id);
+    }
+    /**
+     * Per-render stats from the active strategy: head/tail message + token
+     * counts, plus per-level summary counts and total tokens. Returns null
+     * if the strategy doesn't implement `getRenderStats`.
+     *
+     * Designed for TUIs / dashboards that want to display "how much of the
+     * agent's context is folded vs raw" at a glance.
+     */
+    getRenderStats() {
+        if (!isRenderStatsCapable(this.strategy))
+            return null;
+        return this.strategy.getRenderStats(this.messageStore.createView());
+    }
     /**
      * Reset the head window to start from a new position.
      * Old head window messages become compressible.
@@ -426,6 +542,8 @@ export class ContextManager {
             contextLog: this.contextLog.createView(),
             membrane: this.membrane,
             currentSequence: this.store.currentSequence(),
+            store: this.store,
+            namespace: this.strategyNamespace,
         };
     }
     /**

package/dist/src/context-manager.js.map

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

package/dist/src/strategies/autobiographical.d.ts

@@ -1,6 +1,7 @@
+import type { JsStore } from '@animalabs/chronicle';
 import type { ContentBlock } from '@animalabs/membrane';
 import { NativeFormatter } from '@animalabs/membrane';
-import type { ResettableStrategy, StrategyContext, ReadinessState, MessageStoreView, ContextLogView, TokenBudget, ContextEntry, StoredMessage, AutobiographicalConfig, SummaryLevel, SummaryEntry } from '../types/index.js';
+import type { ResettableStrategy, StrategyContext, ReadinessState, MessageStoreView, ContextLogView, TokenBudget, ContextEntry, StoredMessage, AutobiographicalConfig, SummaryLevel, SummaryEntry, ProtectedRange, SearchQuery, SearchResult } from '../types/index.js';
 /**
  * Chunk of messages to be compressed.
  */
@@ -54,10 +55,133 @@ export declare class AutobiographicalStrategy implements ResettableStrategy {
     protected headWindowStartId: string | null;
     /** Cached result of getHeadWindowStartIndex to avoid repeated linear scans. */
     private _cachedHeadStartIndex;
+    /** Chronicle store for persistent state. Set in `initialize()`. */
+    protected store: JsStore | null;
+    /** Namespace for state-id scoping. Set in `initialize()`. */
+    protected ns: string;
+    protected get summariesStateId(): string;
+    protected get counterStateId(): string;
+    protected get mergeQueueStateId(): string;
+    protected get pinsStateId(): string;
+    /** Protected ranges (pins + documents). Loaded from chronicle in initialize. */
+    protected pins: ProtectedRange[];
+    /** Monotonically increasing counter for pin ids. Persisted as part of the pins snapshot. */
+    protected pinIdCounter: number;
     constructor(config?: Partial<AutobiographicalConfig>);
     initialize(ctx: StrategyContext): Promise<void>;
+    /**
+     * Register the three Chronicle state slots this strategy uses.
+     * Idempotent — chronicle throws if a state is already registered, which we
+     * swallow (the existing slot is what we want).
+     */
+    protected registerStates(): void;
+    /**
+     * Load summaries, counter, and pending merges from chronicle into the
+     * in-memory mirrors. Called on every (re)initialize so branch switches
+     * pick up the new branch's state.
+     */
+    protected loadPersistedState(): void;
+    /** Persist the current pins + counter as a single snapshot. */
+    protected persistPins(): void;
+    /**
+     * Pin a range of messages so they aren't compressed and render raw at
+     * their original position. Returns the pin id.
+     */
+    pinRange(firstMessageId: string, lastMessageId: string, opts?: {
+        name?: string;
+    }): string;
+    /**
+     * Mark a single message as a "document" — semantically a body of
+     * information the agent wants to retain in full. Functionally a
+     * single-message pin with `kind: 'document'`.
+     */
+    markDocument(messageId: string, opts?: {
+        name?: string;
+    }): string;
+    /** Remove a pin or document mark by id. Returns true if removed. */
+    unpin(pinId: string): boolean;
+    /** Read-only list of all current pins. */
+    listPins(): ReadonlyArray<ProtectedRange>;
+    /**
+     * Look up a single summary by id. Returns null if not found.
+     */
+    getSummary(id: string): SummaryEntry | null;
+    /**
+     * Search summaries by substring or regex over their content.
+     *
+     * Result ordering: matches by descending hit count, then by descending
+     * `created` timestamp (newest first within the same hit count).
+     *
+     * Default behavior: only "live" (unmerged) summaries are searched. Set
+     * `includeMerged: true` to also include summaries that have been folded
+     * into a higher level.
+     */
+    searchSummaries(query: SearchQuery): SearchResult[];
+    /**
+     * Whether a given message position is inside any protected range.
+     * Uses a position map (computed by caller) so callers can avoid
+     * repeated per-message lookups in tight loops.
+     */
+    protected isPositionPinned(position: number, pinPositions: Set<number>): boolean;
+    /**
+     * Build a set of message-store positions covered by any pin. O(N pins · K range).
+     * Returns positions for which the message exists; orphan pins (deleted
+     * messages) are silently skipped.
+     */
+    protected pinnedPositions(messages: StoredMessage[]): Set<number>;
+    /**
+     * Append a summary to the in-memory list and to the chronicle AppendLog.
+     * Single point so subclasses inherit persistence.
+     */
+    protected pushSummary(entry: SummaryEntry): void;
+    /**
+     * Mark a summary as merged into a higher-level summary, updating the
+     * chronicle copy at the same index. Index is the position in `this.summaries`.
+     */
+    protected setMergedInto(entry: SummaryEntry, mergedIntoId: string): void;
+    /**
+     * Allocate the next summary-id counter value and persist the new counter.
+     */
+    protected nextSummaryIdCounter(): number;
+    /**
+     * Push to the merge queue and persist the new queue snapshot.
+     */
+    protected enqueueMerge(merge: {
+        level: SummaryLevel;
+        sourceIds: string[];
+    }): void;
+    /**
+     * Pop from the merge queue and persist the new queue snapshot.
+     */
+    protected dequeueMerge(): {
+        level: SummaryLevel;
+        sourceIds: string[];
+    } | undefined;
     checkReadiness(): ReadinessState;
     onNewMessage(message: StoredMessage, ctx: StrategyContext): Promise<void>;
+    /**
+     * Background-drain loop: keeps calling tick() while there's queued work,
+     * subject to the speculation cap and preflight hook. Recurses via
+     * `queueMicrotask` so one chunk's compression doesn't block the
+     * scheduling of the next.
+     *
+     * Stops if a tick fails to make progress (queue size unchanged) — guards
+     * against runaway recursion when tick is a no-op (e.g. no membrane
+     * configured, or a subclass override that doesn't process the queue).
+     */
+    protected driveSpeculativeDrain(ctx: StrategyContext): void;
+    /**
+     * Whether the strategy's pending+queued L1 budget has reached the cap
+     * configured by `maxSpeculativeL1s`. If no cap is set, always false.
+     */
+    protected isAtSpeculativeCap(): boolean;
+    /**
+     * Preflight hook for whether speculative compression should fire on
+     * `onNewMessage`. Returns true by default (current eager behavior).
+     * Subclasses can override for predictive scheduling — e.g. only fire
+     * when the live tail token count is approaching some threshold.
+     */
+    protected shouldCompressPreflight(): boolean;
     tick(ctx: StrategyContext): Promise<void>;
     select(store: MessageStoreView, log: ContextLogView, budget: TokenBudget): ContextEntry[];
     /**
@@ -72,7 +196,56 @@ export declare class AutobiographicalStrategy implements ResettableStrategy {
         l3: number;
         pendingMerges: number;
     };
+    /**
+     * Richer per-render stats: requires a message store view to compute the
+     * head + tail (recent window) sizes. Returns counts AND token sums per
+     * summary level, so observers can see "how much of the agent's context
+     * is in raw tail vs folded into L1/L2/L3."
+     *
+     * Useful for TUI / dashboards. The token sums use the strategy's own
+     * token estimates (which match what `select()` uses for budget math).
+     */
+    getRenderStats(store: MessageStoreView): {
+        head: {
+            messages: number;
+            tokens: number;
+        };
+        tail: {
+            messages: number;
+            tokens: number;
+        };
+        summaries: {
+            l1: {
+                count: number;
+                tokens: number;
+            };
+            l2: {
+                count: number;
+                tokens: number;
+            };
+            l3: {
+                count: number;
+                tokens: number;
+            };
+        };
+        pending: {
+            chunks: number;
+            merges: number;
+        };
+    };
     protected selectLegacy(store: MessageStoreView, _log: ContextLogView, budget: TokenBudget): ContextEntry[];
+    /**
+     * Emit recent-window messages, evicting OLDEST-first when the budget is tight.
+     *
+     * The previous loop iterated `recentStart → messages.length` forward and broke
+     * on `totalTokens + tokens > maxTokens`. When the head/summary section eats most
+     * of the budget, the loop emits the oldest messages of the window and aborts
+     * before reaching the newest — exactly the messages an agent needs to act on.
+     * This helper picks newest-first within the budget, then emits the kept set in
+     * chronological order, dropping a leading orphan tool_result if its tool_use
+     * fell into the evicted older portion.
+     */
+    protected emitRecentNewestFirst(entries: ContextEntry[], store: MessageStoreView, messages: StoredMessage[], recentStart: number, msgCap: number, maxTokens: number, totalTokensBefore: number): void;
     protected compressChunkLegacy(chunk: Chunk, ctx: StrategyContext): Promise<void>;
     protected buildPriorContextLegacy(chunk: Chunk, ctx: StrategyContext): Array<{
         participant: string;
@@ -97,6 +270,11 @@ export declare class AutobiographicalStrategy implements ResettableStrategy {
     /**
      * Check if unmerged summary counts exceed the merge threshold.
      * Enqueues merge operations if so.
+     *
+     * Skips L1s/L2s that are already in a pending merge — without this guard,
+     * each new summary above threshold re-enqueues a merge for the same
+     * already-eligible siblings, producing N near-identical higher-level
+     * summaries when the queue eventually drains.
      */
     protected checkMergeThreshold(): void;
     /**
@@ -127,6 +305,26 @@ export declare class AutobiographicalStrategy implements ResettableStrategy {
         selected: SummaryEntry[];
         tokensUsed: number;
     };
+    /**
+     * True if `projectedTotal` exceeds `max` AND the strategy is configured
+     * to enforce budget. When `enforceBudget: false`, always returns false
+     * — the rendering pipeline emits the full ideal context regardless of
+     * budget overage. Caller's API will reject if it exceeds the model's
+     * context window; the philosophy is "surface overage, don't hide it."
+     */
+    protected isOverBudget(projectedTotal: number, max: number): boolean;
+    /**
+     * Sort selected summaries by source-range start position, so per-pair
+     * recall emission appears in chronological order. Falls back to the
+     * created timestamp for summaries whose source-range first message is
+     * no longer in the store.
+     */
+    protected sortSummariesChronologically(summaries: SummaryEntry[], messages: StoredMessage[]): SummaryEntry[];
+    /**
+     * Render the per-pair recall header from the configured template.
+     * Substitutions: {id} {level} {first} {last}.
+     */
+    protected buildRecallHeader(summary: SummaryEntry): string;
     /**
      * Reset the head window to start from a new message ID.
      * Old head window messages become compressible on the next chunk rebuild.
@@ -146,8 +344,10 @@ export declare class AutobiographicalStrategy implements ResettableStrategy {
      */
     protected extractText(content: ContentBlock[]): string;
     /**
-     * Get messages in the compressible zone: outside both head window and recent window.
-     * Returns messages from [0, headStart) ∪ [headEnd, recentStart).
+     * Get messages in the compressible zone: outside both head window and
+     * recent window AND not inside any pinned range. Returns messages from
+     * [0, headStart) ∪ [headEnd, recentStart) minus any positions covered
+     * by a pin or document mark.
      */
     protected getCompressibleMessages(store: MessageStoreView): StoredMessage[];
     /**
@@ -176,6 +376,20 @@ export declare class AutobiographicalStrategy implements ResettableStrategy {
      * a tool_use message and its tool_result response.
      */
     private trimOrphanedToolUse;
+    /**
+     * Prune tool_use / tool_result blocks in-place:
+     *  1. Truncate `tool_use.input` blocks whose serialized JSON exceeds
+     *     `toolUseInputMaxTokens`.
+     *  2. For each tool name, keep only the last N `tool_result` blocks
+     *     per `toolResultMaxLastN`; older ones get their `content` replaced
+     *     with a brief marker referencing the tool name and how many newer
+     *     results exist below.
+     *
+     * Both passes are no-ops when the corresponding config is unset/0.
+     * Pruning runs AFTER selection and orphan-trimming, so it doesn't
+     * affect chunk formation or the recall/pin layout.
+     */
+    protected pruneToolEntries(entries: ContextEntry[]): void;
     protected isChunkOldEnough(chunk: Chunk): boolean;
     protected formatChunkForCompression(chunk: Chunk): string;
     /**