@namzu/sdk 3.0.0 → 3.2.0

package/dist/compaction/__tests__/context-reducer.test.js

@@ -0,0 +1,197 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createSlidingWindowReducer } from '../reducer.js';
+/**
+ * `strategy: 'sliding-window'` was accepted by the config schema and then
+ * ignored — the runtime asked only whether the strategy was `'disabled'`, so
+ * a host who chose the cheap non-LLM path silently got the expensive LLM one,
+ * summarization calls and all. These pin the behaviour the name always
+ * claimed, and the three invariants that make a shorter history usable rather
+ * than merely shorter.
+ */
+const sys = (content) => ({ role: 'system', content, timestamp: 1 });
+const user = (content) => ({ role: 'user', content, timestamp: 1 });
+const asst = (content) => ({ role: 'assistant', content, timestamp: 1 });
+const callsTool = (id) => ({
+    role: 'assistant',
+    content: null,
+    timestamp: 1,
+    toolCalls: [{ id, type: 'function', function: { name: 'echo', arguments: '{}' } }],
+});
+const toolResult = (id) => ({
+    role: 'tool',
+    content: 'ok',
+    timestamp: 1,
+    toolCallId: id,
+});
+function reduction(messages, over) {
+    return {
+        messages,
+        reason: 'threshold',
+        estimatedTokens: 1_000,
+        contextWindowTokens: 2_000,
+        model: 'mock-model',
+        keepRecentMessages: 4,
+        ...over,
+    };
+}
+describe('the sliding window keeps recent turns and drops the rest', () => {
+    it('keeps the configured tail', async () => {
+        const reduce = createSlidingWindowReducer();
+        const messages = [sys('prompt'), ...Array.from({ length: 10 }, (_, i) => user(`m${i}`))];
+        const next = await reduce(reduction(messages));
+        expect(next).toBeDefined();
+        expect(next?.length).toBe(5); // the system floor plus keepRecentMessages
+        expect(next?.at(-1)).toBe(messages.at(-1));
+    });
+    it('cuts harder when the provider already rejected the prompt', async () => {
+        const reduce = createSlidingWindowReducer();
+        const messages = [sys('prompt'), ...Array.from({ length: 10 }, (_, i) => user(`m${i}`))];
+        const threshold = await reduce(reduction(messages));
+        const overflow = await reduce(reduction(messages, { reason: 'overflow' }));
+        // An overflow means the ordinary window was ALREADY too big. Cutting to
+        // the same size would shed nothing and the caller would retry an
+        // identical prompt.
+        expect(overflow?.length).toBeLessThan(threshold?.length ?? 0);
+    });
+    it('summarizes nothing — every survivor is the original object', async () => {
+        const reduce = createSlidingWindowReducer();
+        const messages = [sys('prompt'), ...Array.from({ length: 8 }, (_, i) => user(`m${i}`))];
+        const next = await reduce(reduction(messages));
+        for (const message of next ?? [])
+            expect(messages).toContain(message);
+    });
+});
+describe('the three invariants a shorter history has to keep', () => {
+    it('never drops the leading system floor', async () => {
+        const reduce = createSlidingWindowReducer();
+        const messages = [
+            sys('prompt'),
+            sys('working memory'),
+            ...Array.from({ length: 8 }, (_, i) => user(`m${i}`)),
+        ];
+        const next = await reduce(reduction(messages));
+        expect(next?.[0]).toBe(messages[0]);
+        expect(next?.[1]).toBe(messages[1]);
+    });
+    it('does not split a tool_use from its tool_result', async () => {
+        const reduce = createSlidingWindowReducer();
+        // The naive cut at length-3 lands between the assistant call and its
+        // result, which is a provider 400 on the next turn.
+        const messages = [
+            sys('prompt'),
+            user('go'),
+            asst('thinking'),
+            callsTool('c1'),
+            toolResult('c1'),
+            user('again'),
+            asst('done'),
+            user('more'),
+        ];
+        const next = await reduce(reduction(messages, { keepRecentMessages: 5 }));
+        const kept = new Set(next ?? []);
+        // Cutting at 3 would keep the call and its result together; cutting at
+        // 4 would orphan the result. The pair is never split either way.
+        expect(kept.has(messages[4])).toBe(kept.has(messages[3]));
+    });
+    it('takes a cut above the requested window when nothing below is safe', async () => {
+        const reduce = createSlidingWindowReducer();
+        // A multi-step turn: the user is silent while the agent works, so every
+        // boundary inside the recent window opens on an assistant or tool
+        // message. A backwards-only search would decline here — exactly when
+        // the history is longest.
+        const messages = [
+            sys('prompt'),
+            user('go'),
+            callsTool('c1'),
+            toolResult('c1'),
+            asst('working'),
+            callsTool('c2'),
+            toolResult('c2'),
+            // The only user turn after the opening one, and it sits ABOVE the
+            // requested cut — so every candidate below opens on an assistant or
+            // tool message and the backwards search comes back empty.
+            user('next'),
+            callsTool('c3'),
+            toolResult('c3'),
+        ];
+        const next = await reduce(reduction(messages, { keepRecentMessages: 5 }));
+        expect(next).toBeDefined();
+        expect(next?.length).toBeLessThan(messages.length);
+        // It kept LESS than asked rather than declining, and what it kept opens
+        // on a user turn.
+        expect(next?.[1]?.role).toBe('user');
+    });
+    it('keeps a pinned turn from the middle of the conversation', async () => {
+        const reduce = createSlidingWindowReducer();
+        const pinned = { ...user('the account id is X'), retain: true };
+        const messages = [
+            sys('prompt'),
+            user('m0'),
+            pinned,
+            ...Array.from({ length: 8 }, (_, i) => user(`m${i + 1}`)),
+        ];
+        const next = await reduce(reduction(messages));
+        // Recency is not the only thing that matters, which is what `retain`
+        // exists to say.
+        expect(next).toContain(pinned);
+        expect(next).not.toContain(messages[1]);
+    });
+});
+describe('refusing beats a reduction that would break the next turn', () => {
+    it('declines when there is nothing but the system floor to cut', async () => {
+        const reduce = createSlidingWindowReducer();
+        expect(await reduce(reduction([sys('prompt'), user('go')]))).toBeUndefined();
+    });
+    it('declines when every candidate cut splits one assistant fan-out', async () => {
+        const reduce = createSlidingWindowReducer();
+        // Six results answering one call: no cut inside the block is safe, and
+        // the condition clears itself on the next assistant message.
+        const messages = [
+            sys('prompt'),
+            user('go'),
+            {
+                role: 'assistant',
+                content: null,
+                timestamp: 1,
+                toolCalls: Array.from({ length: 6 }, (_, i) => ({
+                    id: `c${i}`,
+                    type: 'function',
+                    function: { name: 'echo', arguments: '{}' },
+                })),
+            },
+            ...Array.from({ length: 6 }, (_, i) => toolResult(`c${i}`)),
+        ];
+        expect(await reduce(reduction(messages, { keepRecentMessages: 2 }))).toBeUndefined();
+    });
+    it('declines rather than reporting a reduction that removed nothing', async () => {
+        const reduce = createSlidingWindowReducer();
+        // Every non-system message is pinned, so the survivor set is the input.
+        const messages = [
+            sys('prompt'),
+            ...Array.from({ length: 8 }, (_, i) => ({ ...user(`m${i}`), retain: true })),
+        ];
+        // Saying "reduced" here would have the overflow path retry an identical
+        // prompt and burn a model call to be told the same thing.
+        expect(await reduce(reduction(messages))).toBeUndefined();
+    });
+});
+describe('the knob a caller reaches for', () => {
+    it('lets an explicit window override the run config', async () => {
+        const reduce = createSlidingWindowReducer({ keepRecentMessages: 2 });
+        const messages = [sys('prompt'), ...Array.from({ length: 10 }, (_, i) => user(`m${i}`))];
+        const next = await reduce(reduction(messages, { keepRecentMessages: 8 }));
+        expect(next?.length).toBe(3);
+    });
+    it('is a plain function, so a host can wrap one', async () => {
+        const inner = createSlidingWindowReducer();
+        const seen = vi.fn();
+        const reduce = async (input) => {
+            seen(input.reason);
+            return inner(input);
+        };
+        const messages = [sys('prompt'), ...Array.from({ length: 8 }, (_, i) => user(`m${i}`))];
+        await reduce(reduction(messages, { reason: 'overflow' }));
+        expect(seen).toHaveBeenCalledWith('overflow');
+    });
+});
+//# sourceMappingURL=context-reducer.test.js.map

package/dist/compaction/__tests__/context-reducer.test.js.map

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

package/dist/compaction/factory.d.ts

@@ -16,5 +16,12 @@ import type { CompactionStrategy } from './types.js';
  * const trimmed = manager.applyManagement(messages)
  * ```
  */
+/**
+ * @deprecated Nothing calls this. Select a strategy with
+ * `compactionConfig.strategy`, or pass a `contextReducer` to `query()`.
+ *
+ * The factory produced managers the runtime had no seam to drive, so its
+ * return value was always dropped on the floor. See {@link ConversationManager}.
+ */
 export declare function createConversationManager(strategy: CompactionStrategy, config: CompactionConfig): ConversationManager;
 //# sourceMappingURL=factory.d.ts.map

package/dist/compaction/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/compaction/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAIzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,gBAAgB,GACtB,mBAAmB,CAerB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/compaction/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAIzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;;;;;;;;;;;;;GAcG;AACH;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,gBAAgB,GACtB,mBAAmB,CAerB"}

package/dist/compaction/factory.js

@@ -16,6 +16,13 @@ import { StructuredCompactionManager } from './managers/structured.js';
  * const trimmed = manager.applyManagement(messages)
  * ```
  */
+/**
+ * @deprecated Nothing calls this. Select a strategy with
+ * `compactionConfig.strategy`, or pass a `contextReducer` to `query()`.
+ *
+ * The factory produced managers the runtime had no seam to drive, so its
+ * return value was always dropped on the floor. See {@link ConversationManager}.
+ */
 export function createConversationManager(strategy, config) {
     switch (strategy) {
         case 'structured':

package/dist/compaction/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/compaction/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AAGtE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CACxC,QAA4B,EAC5B,MAAwB;IAExB,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,YAAY;YAChB,OAAO,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAA;QAC/C,KAAK,gBAAgB;YACpB,OAAO,IAAI,oBAAoB,CAAC;gBAC/B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;aAC7C,CAAC,CAAA;QACH,KAAK,UAAU;YACd,OAAO,IAAI,WAAW,EAAE,CAAA;QACzB,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,QAAQ,CAAA;YACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAA;QAC/D,CAAC;IACF,CAAC;AACF,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/compaction/factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA;AAGtE;;;;;;;;;;;;;;GAcG;AACH;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACxC,QAA4B,EAC5B,MAAwB;IAExB,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,YAAY;YAChB,OAAO,IAAI,2BAA2B,CAAC,MAAM,CAAC,CAAA;QAC/C,KAAK,gBAAgB;YACpB,OAAO,IAAI,oBAAoB,CAAC;gBAC/B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;aAC7C,CAAC,CAAA;QACH,KAAK,UAAU;YACd,OAAO,IAAI,WAAW,EAAE,CAAA;QACzB,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,QAAQ,CAAA;YACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAA;QAC/D,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/compaction/index.d.ts

@@ -1,6 +1,8 @@
 export type { WorkingState, PlanSlot, FileSlot, FileAction, ToolResultSlot, CompactionStrategy, } from './types.js';
 export type { DanglingResult } from './dangling.js';
 export type { ConversationManager } from './interface.js';
+export { createSlidingWindowReducer } from './reducer.js';
+export type { ContextReducer, ContextReduction, ContextReductionReason, SlidingWindowOptions, } from './reducer.js';
 export { WorkingStateManager } from './manager.js';
 export { serializeState } from './serializer.js';
 export { extractFromToolCall, extractFromToolResult, extractFromUserMessage, extractFromAssistantMessage, } from './extractor.js';

package/dist/compaction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compaction/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,GAClB,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAEpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACN,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,gCAAgC,EAChC,0BAA0B,GAC1B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compaction/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,GAClB,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,YAAY,EACX,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,GACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAEpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACN,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAEhE,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,gCAAgC,EAChC,0BAA0B,GAC1B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/compaction/index.js

@@ -1,3 +1,4 @@
+export { createSlidingWindowReducer } from './reducer.js';
 export { WorkingStateManager } from './manager.js';
 export { serializeState } from './serializer.js';
 export { extractFromToolCall, extractFromToolResult, extractFromUserMessage, extractFromAssistantMessage, } from './extractor.js';

package/dist/compaction/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compaction/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAEpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACN,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,gCAAgC,EAChC,0BAA0B,GAC1B,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compaction/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAQzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAEpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACN,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACN,qBAAqB,EACrB,mBAAmB,EACnB,gCAAgC,EAChC,0BAA0B,GAC1B,MAAM,0BAA0B,CAAA"}

package/dist/compaction/interface.d.ts

@@ -6,6 +6,19 @@ import type { Message } from '../types/message/index.js';
  * A manager applies two strategies:
  * 1. **Routine management** (applyManagement): Called after each iteration to proactively optimize context.
  * 2. **Overflow reduction** (reduceContext): Called when the LLM reports context window exceeded.
+ *
+ * @deprecated Use {@link ContextReducer}, which the runtime actually drives.
+ *
+ * This interface cannot be implemented correctly. `reduceContext` is
+ * documented as reducing the history, but it takes `Message[]` and returns
+ * `boolean` — the only way to honour the contract is to mutate the argument
+ * in place, and neither shipped implementation does. Both build a shorter
+ * array locally, discard it, and return `true`. Nothing in the runtime ever
+ * called any of it, which is why an unfulfillable contract survived.
+ *
+ * `ContextReducer` returns the new history, may be async so a reducer can
+ * call a model, and is told whether it was asked speculatively or after the
+ * provider rejected the prompt. Kept exported until the next major.
  */
 export interface ConversationManager {
     /** Unique name for this manager (e.g., 'structured', 'sliding-window', 'disabled') */

package/dist/compaction/interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/compaction/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAExD;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IACnC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;;;;OAOG;IACH,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAA;IAE/C;;;;;;;;OAQG;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAA;CACnE"}
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/compaction/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,mBAAmB;IACnC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;;;;;OAOG;IACH,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAA;IAE/C;;;;;;;;OAQG;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAA;CACnE"}

package/dist/compaction/managers/null.d.ts

@@ -4,6 +4,9 @@ import type { ConversationManager } from '../interface.js';
  * No-op conversation manager implementation.
  * Never modifies messages, useful for testing or when context management is disabled.
  */
+/**
+ * @deprecated Use `strategy: 'disabled'`, which the runtime reads.
+ */
 export declare class NullManager implements ConversationManager {
     readonly name = "null";
     applyManagement(messages: Message[]): Message[];

package/dist/compaction/managers/null.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"null.d.ts","sourceRoot":"","sources":["../../../src/compaction/managers/null.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D;;;GAGG;AACH,qBAAa,WAAY,YAAW,mBAAmB;IACtD,QAAQ,CAAC,IAAI,UAAS;IAEtB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IAI/C,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CAIrE"}
+{"version":3,"file":"null.d.ts","sourceRoot":"","sources":["../../../src/compaction/managers/null.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D;;;GAGG;AACH;;GAEG;AACH,qBAAa,WAAY,YAAW,mBAAmB;IACtD,QAAQ,CAAC,IAAI,UAAS;IAEtB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IAI/C,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CAIrE"}

package/dist/compaction/managers/null.js

@@ -2,6 +2,9 @@
  * No-op conversation manager implementation.
  * Never modifies messages, useful for testing or when context management is disabled.
  */
+/**
+ * @deprecated Use `strategy: 'disabled'`, which the runtime reads.
+ */
 export class NullManager {
     name = 'null';
     applyManagement(messages) {

package/dist/compaction/managers/null.js.map

@@ -1 +1 @@
-{"version":3,"file":"null.js","sourceRoot":"","sources":["../../../src/compaction/managers/null.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,IAAI,GAAG,MAAM,CAAA;IAEtB,eAAe,CAAC,QAAmB;QAClC,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,aAAa,CAAC,SAAoB,EAAE,eAAuB;QAC1D,yCAAyC;QACzC,OAAO,KAAK,CAAA;IACb,CAAC;CACD"}
+{"version":3,"file":"null.js","sourceRoot":"","sources":["../../../src/compaction/managers/null.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,IAAI,GAAG,MAAM,CAAA;IAEtB,eAAe,CAAC,QAAmB;QAClC,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,aAAa,CAAC,SAAoB,EAAE,eAAuB;QAC1D,yCAAyC;QACzC,OAAO,KAAK,CAAA;IACb,CAAC;CACD"}

package/dist/compaction/managers/slidingWindow.d.ts

@@ -17,6 +17,12 @@ export interface SlidingWindowManagerConfig {
  * 2. Use findSafeTrimIndex to ensure tool call/result pairs remain atomic
  * 3. applyManagement runs proactively each iteration; reduceContext on overflow
  */
+/**
+ * @deprecated Use `createSlidingWindowReducer()`, or `strategy: 'sliding-window'`.
+ *
+ * Never reachable through the runtime, and `reduceContext` here computes a
+ * trim index and returns a boolean without trimming anything.
+ */
 export declare class SlidingWindowManager implements ConversationManager {
     readonly name = "sliding-window";
     private readonly keepRecentMessages;

package/dist/compaction/managers/slidingWindow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slidingWindow.d.ts","sourceRoot":"","sources":["../../../src/compaction/managers/slidingWindow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC/D,QAAQ,CAAC,IAAI,oBAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;gBAE/B,MAAM,GAAE,0BAA+B;IAInD,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IAW/C,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CAepE"}
+{"version":3,"file":"slidingWindow.d.ts","sourceRoot":"","sources":["../../../src/compaction/managers/slidingWindow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;GASG;AACH;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC/D,QAAQ,CAAC,IAAI,oBAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;gBAE/B,MAAM,GAAE,0BAA+B;IAInD,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IAW/C,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CAepE"}

package/dist/compaction/managers/slidingWindow.js

@@ -9,6 +9,12 @@ import { findSafeTrimIndex } from '../dangling.js';
  * 2. Use findSafeTrimIndex to ensure tool call/result pairs remain atomic
  * 3. applyManagement runs proactively each iteration; reduceContext on overflow
  */
+/**
+ * @deprecated Use `createSlidingWindowReducer()`, or `strategy: 'sliding-window'`.
+ *
+ * Never reachable through the runtime, and `reduceContext` here computes a
+ * trim index and returns a boolean without trimming anything.
+ */
 export class SlidingWindowManager {
     name = 'sliding-window';
     keepRecentMessages;

package/dist/compaction/managers/slidingWindow.js.map

@@ -1 +1 @@
-{"version":3,"file":"slidingWindow.js","sourceRoot":"","sources":["../../../src/compaction/managers/slidingWindow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAWlD;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IACvB,IAAI,GAAG,gBAAgB,CAAA;IACf,kBAAkB,CAAQ;IAE3C,YAAY,SAAqC,EAAE;QAClD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAA;IACzD,CAAC;IAED,eAAe,CAAC,QAAmB;QAClC,gCAAgC;QAChC,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAChD,OAAO,QAAQ,CAAA;QAChB,CAAC;QAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAA;QAClE,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QACjE,OAAO,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACnC,CAAC;IAED,aAAa,CAAC,QAAmB,EAAE,eAAuB;QACzD,8CAA8C;QAC9C,sDAAsD;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,CAAA;QAC3E,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAA;QACvD,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QAEjE,IAAI,WAAW,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpC,sBAAsB;YACtB,OAAO,KAAK,CAAA;QACb,CAAC;QAED,0DAA0D;QAC1D,OAAO,WAAW,GAAG,CAAC,CAAA;IACvB,CAAC;CACD"}
+{"version":3,"file":"slidingWindow.js","sourceRoot":"","sources":["../../../src/compaction/managers/slidingWindow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAWlD;;;;;;;;;GASG;AACH;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACvB,IAAI,GAAG,gBAAgB,CAAA;IACf,kBAAkB,CAAQ;IAE3C,YAAY,SAAqC,EAAE;QAClD,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAA;IACzD,CAAC;IAED,eAAe,CAAC,QAAmB;QAClC,gCAAgC;QAChC,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAChD,OAAO,QAAQ,CAAA;QAChB,CAAC;QAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAA;QAClE,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QACjE,OAAO,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACnC,CAAC;IAED,aAAa,CAAC,QAAmB,EAAE,eAAuB;QACzD,8CAA8C;QAC9C,sDAAsD;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,CAAA;QAC3E,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAA;QACvD,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QAEjE,IAAI,WAAW,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpC,sBAAsB;YACtB,OAAO,KAAK,CAAA;QACb,CAAC;QAED,0DAA0D;QAC1D,OAAO,WAAW,GAAG,CAAC,CAAA;IACvB,CAAC;CACD"}

package/dist/compaction/managers/structured.d.ts

@@ -13,6 +13,16 @@ import type { ConversationManager } from '../interface.js';
  *
  * Provides maximum context preservation but more computational overhead.
  */
+/**
+ * @deprecated Not the structured strategy. `strategy: 'structured'` runs the
+ * live path in `runtime/query/iteration/phases/compaction.ts`, which this
+ * class predates and does not share code with.
+ *
+ * What is here is a weaker parallel copy: no LLM-verified summary, no stale
+ * tool-result clearing, no retention pins, no events — and a `reduceContext`
+ * that builds a shorter history into a local array and then returns a
+ * boolean, discarding it.
+ */
 export declare class StructuredCompactionManager implements ConversationManager {
     readonly name = "structured";
     private readonly config;

package/dist/compaction/managers/structured.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structured.d.ts","sourceRoot":"","sources":["../../../src/compaction/managers/structured.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAO3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAI1D;;;;;;;;;;;GAWG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACtE,QAAQ,CAAC,IAAI,gBAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,gBAAgB;IAIpC,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IA+E/C,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CA0DpE"}
+{"version":3,"file":"structured.d.ts","sourceRoot":"","sources":["../../../src/compaction/managers/structured.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAO3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAI1D;;;;;;;;;;;GAWG;AACH;;;;;;;;;GASG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACtE,QAAQ,CAAC,IAAI,gBAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,gBAAgB;IAIpC,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IA+E/C,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CA0DpE"}

package/dist/compaction/managers/structured.js

@@ -14,6 +14,16 @@ import { serializeState } from '../serializer.js';
  *
  * Provides maximum context preservation but more computational overhead.
  */
+/**
+ * @deprecated Not the structured strategy. `strategy: 'structured'` runs the
+ * live path in `runtime/query/iteration/phases/compaction.ts`, which this
+ * class predates and does not share code with.
+ *
+ * What is here is a weaker parallel copy: no LLM-verified summary, no stale
+ * tool-result clearing, no retention pins, no events — and a `reduceContext`
+ * that builds a shorter history into a local array and then returns a
+ * boolean, discarding it.
+ */
 export class StructuredCompactionManager {
     name = 'structured';
     config;

package/dist/compaction/managers/structured.js.map

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

package/dist/compaction/reducer.d.ts

@@ -0,0 +1,86 @@
+import type { Message } from '../types/message/index.js';
+/**
+ * Why the runtime is asking for a shorter history.
+ *
+ * The two cases want different behaviour and a reducer that cannot tell
+ * them apart has to guess. `'threshold'` is speculative — the estimate says
+ * the window is filling, nothing has failed, and declining costs only some
+ * headroom. `'overflow'` is the provider having already rejected the
+ * prompt: declining there ends the run.
+ */
+export type ContextReductionReason = 'threshold' | 'overflow';
+/** Everything a reducer needs to decide, and nothing it cannot act on. */
+export interface ContextReduction {
+    /** The live history, oldest first. Treat as read-only and return a new array. */
+    readonly messages: readonly Message[];
+    readonly reason: ContextReductionReason;
+    /** Estimated size of `messages`. Derived from the provider's last prompt count when there is one, else measured. */
+    readonly estimatedTokens: number;
+    /** What it has to fit in. Resolved from the model when the host did not say. */
+    readonly contextWindowTokens: number;
+    /** The model this run is calling, for a reducer that varies by model. */
+    readonly model: string;
+    /** The run's configured recent-window size, as a starting point. */
+    readonly keepRecentMessages: number;
+}
+/**
+ * Replace the run's history with a shorter one.
+ *
+ * Returning `undefined` means "I could not shorten this" and is a first-class
+ * answer, not a failure — on `'threshold'` the run simply continues, and on
+ * `'overflow'` it fails with an irreducible-prompt error instead of retrying
+ * a prompt nothing changed. That is deliberate: a reducer that returned the
+ * input unchanged while reporting success would send the same rejected
+ * prompt again and burn a call to learn the same thing.
+ *
+ * A reducer OWNS reduction for the run it governs. The built-in structured
+ * pass — LLM-verified summarization, stale tool-result clearing, working
+ * state slots — does not also run, because two mechanisms editing the same
+ * history in one pass cannot both be reasoned about.
+ *
+ * Invariants a reducer is expected to keep, all three enforced by the
+ * built-in one and none of them checkable from here:
+ *
+ * 1. The leading system messages stay. They carry the system prompt and the
+ *    working-memory slot; dropping them changes who the agent is.
+ * 2. `tool_use` and its `tool_result` stay together. A split pair is a 400
+ *    from the provider, so a reducer that splits one turns a context problem
+ *    into a dead run. {@link findSafeTrimIndex} is exported for this.
+ * 3. Messages marked `retain` survive. That marker is how a caller says a
+ *    fact in the middle of the conversation outranks recency.
+ */
+export type ContextReducer = (reduction: ContextReduction) => readonly Message[] | undefined | Promise<readonly Message[] | undefined>;
+export interface SlidingWindowOptions {
+    /**
+     * How many trailing messages to keep. Defaults to the run's configured
+     * `keepRecentMessages`, so the same knob governs both strategies.
+     */
+    readonly keepRecentMessages?: number;
+    /**
+     * Fraction of the window to keep when relieving an overflow, applied to
+     * the recent count. Defaults to 0.5.
+     *
+     * An overflow means the ordinary window was already too big, so cutting
+     * to the same size again would shed nothing and the caller would retry
+     * an identical prompt.
+     */
+    readonly overflowFactor?: number;
+}
+/**
+ * Keep the last N turns, drop what precedes them, summarize nothing.
+ *
+ * The honest counterpart to the structured strategy rather than a lesser
+ * version of it. Structured compaction pays a summarization call and
+ * paraphrases the agent's own reasoning to buy context; this pays nothing
+ * and admits the older history is gone. For a long-running agent whose
+ * state lives outside the transcript — a task queue, a file it keeps
+ * editing, a working-memory block the host renders each turn — that is the
+ * better trade, and the paraphrase was only ever cost.
+ *
+ * Until now `strategy: 'sliding-window'` was accepted by the config schema
+ * and then ignored: the runtime asked only whether the strategy was
+ * `'disabled'`, so choosing the cheap non-LLM path silently ran the
+ * expensive LLM one. This is the implementation that name always claimed.
+ */
+export declare function createSlidingWindowReducer(options?: SlidingWindowOptions): ContextReducer;
+//# sourceMappingURL=reducer.d.ts.map

package/dist/compaction/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../src/compaction/reducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAIxD;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,UAAU,CAAA;AAE7D,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAChC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,oHAAoH;IACpH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,gFAAgF;IAChF,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,SAAS,EAAE,gBAAgB,KACvB,SAAS,OAAO,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC,CAAA;AAE7E,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAEpC;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,oBAAyB,GAAG,cAAc,CA2D7F"}

package/dist/compaction/reducer.js

@@ -0,0 +1,77 @@
+import { findSafeTrimIndex } from './dangling.js';
+import { findRetainedIndices } from './retention.js';
+/**
+ * Keep the last N turns, drop what precedes them, summarize nothing.
+ *
+ * The honest counterpart to the structured strategy rather than a lesser
+ * version of it. Structured compaction pays a summarization call and
+ * paraphrases the agent's own reasoning to buy context; this pays nothing
+ * and admits the older history is gone. For a long-running agent whose
+ * state lives outside the transcript — a task queue, a file it keeps
+ * editing, a working-memory block the host renders each turn — that is the
+ * better trade, and the paraphrase was only ever cost.
+ *
+ * Until now `strategy: 'sliding-window'` was accepted by the config schema
+ * and then ignored: the runtime asked only whether the strategy was
+ * `'disabled'`, so choosing the cheap non-LLM path silently ran the
+ * expensive LLM one. This is the implementation that name always claimed.
+ */
+export function createSlidingWindowReducer(options = {}) {
+    const factor = options.overflowFactor ?? 0.5;
+    return ({ messages, reason, keepRecentMessages }) => {
+        const configured = options.keepRecentMessages ?? keepRecentMessages;
+        const keep = reason === 'overflow' ? Math.max(1, Math.floor(configured * factor)) : Math.max(1, configured);
+        let leadingSystem = 0;
+        while (messages[leadingSystem]?.role === 'system')
+            leadingSystem++;
+        const naive = messages.length - keep;
+        if (naive <= leadingSystem)
+            return undefined;
+        // `findSafeTrimIndex` moves a cut forward until the kept tail is a
+        // history a provider will accept — no `tool_result` without its
+        // `tool_use`, and never opening on an assistant turn, because the tail
+        // becomes the start of the wire conversation once the older half is
+        // gone. So a candidate is safe exactly when it is already its own
+        // answer.
+        //
+        // Walk BACKWARDS first: that lands on the safe cut nearest the
+        // requested window, keeping a little more than asked rather than a lot
+        // less.
+        const trimmable = [...messages];
+        let cut = -1;
+        for (let candidate = naive; candidate > leadingSystem; candidate--) {
+            if (findSafeTrimIndex(trimmable, candidate) === candidate) {
+                cut = candidate;
+                break;
+            }
+        }
+        // Nothing safe below the request. Take the answer ABOVE it instead of
+        // refusing: in a multi-step turn — the agent working through tool calls
+        // with the user silent — every boundary in the recent window lands on
+        // an assistant or tool message, so a backwards-only search declines
+        // exactly when the history is longest and shedding matters most. The
+        // forward cut keeps less than asked, which is a smaller history than
+        // the caller wanted but still a correct one.
+        if (cut < 0) {
+            const forward = findSafeTrimIndex(trimmable, naive);
+            // `messages.length` means "keep nothing", which is not a history.
+            if (forward > leadingSystem && forward < messages.length)
+                cut = forward;
+        }
+        if (cut < 0)
+            return undefined;
+        const retained = findRetainedIndices(messages);
+        const survivors = [];
+        for (let i = 0; i < messages.length; i++) {
+            const message = messages[i];
+            if (!message)
+                continue;
+            if (i < leadingSystem || i >= cut || retained.has(i))
+                survivors.push(message);
+        }
+        // Nothing went. Reporting that as a reduction would have the overflow
+        // path retry an identical prompt.
+        return survivors.length === messages.length ? undefined : survivors;
+    };
+}
+//# sourceMappingURL=reducer.js.map