@strands-agents/sdk 1.12.0 → 1.14.0

package/dist/src/context-manager/strategies/offload/base.js

@@ -0,0 +1,376 @@
+/**
+ * Base offload strategy and shared infrastructure.
+ *
+ * @internal
+ */
+import { logger } from '../../../logging/logger.js';
+import { MessageAddedEvent } from '../../../hooks/events.js';
+import { Message, TextBlock, ToolResultBlock, ToolUseBlock } from '../../../types/messages.js';
+// --- Shared helpers ---
+function finiteOrUndefined(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.max(0, value) : undefined;
+}
+/**
+ * Builds a toolUseId → toolName map from all assistant messages in the conversation.
+ * Called once per apply() to avoid O(messages × toolResults) scanning.
+ */
+export function buildToolNameMap(messages) {
+    const map = new Map();
+    for (const message of messages) {
+        if (message.role !== 'assistant')
+            continue;
+        for (const block of message.content) {
+            if (block instanceof ToolUseBlock) {
+                map.set(block.toolUseId, block.name);
+            }
+        }
+    }
+    return map;
+}
+export function toolMatchesTarget(block, target, toolNameMap, toolIncludeFilter, toolExcludeFilter) {
+    if (target === '*')
+        return true;
+    if (target === 'toolResults')
+        return block.status === 'success';
+    if (target === 'toolResultErrors')
+        return block.status === 'error';
+    const toolName = toolNameMap.get(block.toolUseId);
+    if (!toolName)
+        return false;
+    if (toolExcludeFilter)
+        return !toolExcludeFilter.has(toolName);
+    if (toolIncludeFilter)
+        return toolIncludeFilter.has(toolName);
+    return false;
+}
+export function targetMatchesMessage(target, message) {
+    if (target === undefined || target === '*')
+        return true;
+    if (target === 'assistantText')
+        return message.role === 'assistant' && message.content.some((b) => b instanceof TextBlock);
+    if (target === 'userText')
+        return message.role === 'user' && message.content.some((b) => b instanceof TextBlock);
+    return false;
+}
+export function messageMatchesTarget(message, target, toolNameMap, toolIncludeFilter, toolExcludeFilter) {
+    if (targetMatchesMessage(target, message))
+        return true;
+    if (!target)
+        return false;
+    // Tool result targets — must be a user message with a matching tool result
+    if (message.role !== 'user')
+        return false;
+    for (const block of message.content) {
+        if (block instanceof ToolResultBlock) {
+            if (toolMatchesTarget(block, target, toolNameMap, toolIncludeFilter, toolExcludeFilter))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns target-matching messages excluding the N most recent matches.
+ * First filters to only messages that match the target, then removes the last N from that set.
+ */
+export function getOldestMatches(messages, target, count, toolNameMap, toolIncludeFilter, toolExcludeFilter) {
+    const matching = messages.filter((message) => messageMatchesTarget(message, target, toolNameMap, toolIncludeFilter, toolExcludeFilter));
+    if (count >= matching.length)
+        return [];
+    return matching.slice(0, -count);
+}
+/**
+ * Collects a message and its paired partner (if any) for safe removal.
+ * If removing a message would orphan a tool-use/tool-result pair, includes the partner
+ * so the pair is removed together. Skips messages[0] (head-pin).
+ */
+export function collectRemovableWithPair(messages, index) {
+    const message = messages[index];
+    if (!message)
+        return [];
+    if (index === 0)
+        return [];
+    const result = [message];
+    const hasToolResult = message.content.some((block) => block instanceof ToolResultBlock);
+    if (hasToolResult) {
+        const prev = messages[index - 1];
+        if (prev && prev.content.some((block) => block instanceof ToolUseBlock)) {
+            if (index - 1 > 0)
+                result.push(prev);
+            else
+                return [];
+        }
+    }
+    const hasToolUse = message.content.some((block) => block instanceof ToolUseBlock);
+    if (hasToolUse && index < messages.length - 1) {
+        const next = messages[index + 1];
+        if (next && next.content.some((block) => block instanceof ToolResultBlock)) {
+            result.push(next);
+        }
+    }
+    return result;
+}
+/**
+ * Collects removable messages (with their tool pairs), then splices them from the array.
+ * Returns the number of messages removed and the lowest index that was removed.
+ */
+export function spliceWithPairs(messages, toRemove) {
+    const toSplice = new Set();
+    for (const message of toRemove) {
+        const index = messages.indexOf(message);
+        if (index === -1)
+            continue;
+        for (const removable of collectRemovableWithPair(messages, index)) {
+            toSplice.add(removable);
+        }
+    }
+    let removed = 0;
+    let lowestIndex = messages.length;
+    for (const message of toSplice) {
+        const index = messages.indexOf(message);
+        if (index === -1)
+            continue;
+        if (index < lowestIndex)
+            lowestIndex = index;
+        messages.splice(index, 1);
+        removed++;
+    }
+    return { removed, lowestIndex };
+}
+/**
+ * Merges consecutive same-role messages to restore the user/assistant alternation
+ * that Anthropic/Bedrock APIs require. Called after message-level operations that
+ * may leave gaps. Constructs new Message objects for merges to avoid mutating
+ * objects that may be referenced elsewhere (session storage, event payloads).
+ */
+export function repairAlternation(messages) {
+    let writeIndex = 0;
+    for (let readIndex = 0; readIndex < messages.length; readIndex++) {
+        const current = messages[readIndex];
+        if (writeIndex > 0 && messages[writeIndex - 1].role === current.role) {
+            const prev = messages[writeIndex - 1];
+            messages[writeIndex - 1] = new Message({
+                role: prev.role,
+                content: [...prev.content, ...current.content],
+            });
+        }
+        else {
+            messages[writeIndex] = current;
+            writeIndex++;
+        }
+    }
+    messages.length = writeIndex;
+}
+/**
+ * Parses a string[] target into include/exclude filter sets.
+ * Entries must be prefixed with `tool::` (e.g. `'tool::bash'`).
+ * An additional `!` prefix excludes (e.g. `'!tool::bash'`).
+ */
+export function resolveToolFilter(target) {
+    if (!Array.isArray(target))
+        return {};
+    const TOOL_PREFIX = 'tool::';
+    const includes = [];
+    const excludes = [];
+    for (const entry of target) {
+        if (entry.startsWith('!')) {
+            const name = entry.slice(1);
+            excludes.push(name.startsWith(TOOL_PREFIX) ? name.slice(TOOL_PREFIX.length) : name);
+        }
+        else {
+            includes.push(entry.startsWith(TOOL_PREFIX) ? entry.slice(TOOL_PREFIX.length) : entry);
+        }
+    }
+    if (excludes.length > 0 && includes.length > 0) {
+        logger.warn('tool filter contains both includes and excludes, excludes will be ignored');
+        return { include: new Set(includes) };
+    }
+    if (excludes.length > 0) {
+        return { exclude: new Set(excludes) };
+    }
+    if (includes.length > 0) {
+        return { include: new Set(includes) };
+    }
+    return {};
+}
+// --- Base strategy class ---
+/** Shared offload logic: target routing, eager hooks, preserveRecent. */
+export class BaseOffloadStrategy {
+    _target;
+    _threshold;
+    _utilizationThreshold;
+    _preserveRecent;
+    _removalRatio = 0.3;
+    _includeFilter;
+    _excludeFilter;
+    constructor(target, conditions) {
+        if (Array.isArray(target) && target.length === 0) {
+            throw new Error('Empty array target matches nothing — provide at least one target');
+        }
+        this._target = target;
+        this._threshold = finiteOrUndefined(conditions?.threshold);
+        this._utilizationThreshold = finiteOrUndefined(conditions?.utilization);
+        this._preserveRecent = Math.floor(finiteOrUndefined(conditions?.preserveRecent) ?? 0);
+        const resolved = resolveToolFilter(target);
+        this._includeFilter = resolved.include;
+        this._excludeFilter = resolved.exclude;
+    }
+    /** Whether this strategy operates at message-level (batch) vs per-block. */
+    get _isMessageLevel() {
+        return this._utilizationThreshold !== undefined;
+    }
+    init(agent) {
+        if (this._isMessageLevel)
+            return;
+        if (this._preserveRecent > 0)
+            return;
+        agent.addHook(MessageAddedEvent, async (event) => {
+            const messages = event.agent.messages;
+            const toolNameMap = buildToolNameMap(messages);
+            await this._transformBlocks(event.message, messages, toolNameMap, event.agent);
+        });
+    }
+    async apply(context) {
+        if (this._isMessageLevel) {
+            if (context.utilization < this._utilizationThreshold)
+                return false;
+            return this._applyPerMessage(context);
+        }
+        return this._applyPerBlock(context);
+    }
+    /** Per-block execution: walk each message, transform individual blocks above threshold. */
+    async _applyPerBlock(context) {
+        const { messages, agent } = context;
+        const toolNameMap = buildToolNameMap(messages);
+        const eligible = this._preserveRecent > 0
+            ? getOldestMatches(messages, this._target, this._preserveRecent, toolNameMap, this._includeFilter, this._excludeFilter)
+            : messages;
+        let acted = false;
+        for (const message of eligible) {
+            if (await this._transformBlocks(message, messages, toolNameMap, agent)) {
+                acted = true;
+            }
+        }
+        return acted;
+    }
+    /** Message-level execution: remove oldest 30% of eligible messages with pair safety. */
+    async _applyPerMessage(context) {
+        const { messages } = context;
+        if (messages.length <= 1)
+            return false;
+        const eligible = await this._getEligibleMessages(context);
+        if (eligible.length === 0)
+            return false;
+        const targetRemoval = Math.max(1, Math.floor(eligible.length * this._removalRatio));
+        const toRemove = eligible.slice(0, targetRemoval);
+        const { removed, lowestIndex } = spliceWithPairs(messages, toRemove);
+        if (removed === 0)
+            return false;
+        const marker = this._makeRemovalMarker(removed);
+        if (marker) {
+            const insertIndex = Math.max(1, Math.min(lowestIndex, messages.length));
+            messages.splice(insertIndex, 0, new Message({ role: 'user', content: [new TextBlock(marker)] }));
+        }
+        repairAlternation(messages);
+        return true;
+    }
+    /** Override to insert a marker when messages are removed. Return null for no marker. */
+    _makeRemovalMarker(_count) {
+        return null;
+    }
+    /** Whether a block is eligible for offload given the current target and filters. */
+    _blockMatchesTarget(block, message, toolNameMap) {
+        if (block instanceof TextBlock)
+            return targetMatchesMessage(this._target, message);
+        if (block instanceof ToolResultBlock) {
+            return (this._target === undefined ||
+                toolMatchesTarget(block, this._target, toolNameMap, this._includeFilter, this._excludeFilter));
+        }
+        return false;
+    }
+    /** Process eligible blocks in a message. */
+    async _transformBlocks(message, messages, toolNameMap, agent) {
+        const effectiveThreshold = this._threshold ?? 0;
+        let acted = false;
+        for (let blockIndex = 0; blockIndex < message.content.length; blockIndex++) {
+            const block = message.content[blockIndex];
+            if (!this._blockMatchesTarget(block, message, toolNameMap))
+                continue;
+            const tokens = await agent.model.countTokens([new Message({ role: message.role, content: [block] })]);
+            if (tokens <= effectiveThreshold)
+                continue;
+            const replacement = await this._replaceBlock(block, tokens, message, agent);
+            if (replacement && replacement !== block) {
+                // Intentional in-place mutation: per-block replacement shrinks existing message content
+                // rather than constructing a new Message (unlike message-level removal which uses new objects).
+                ;
+                message.content[blockIndex] = replacement;
+                acted = true;
+            }
+        }
+        return acted;
+    }
+    /** Collect eligible messages for message-level operations, respecting preserveRecent, head-pin, and threshold. */
+    async _getEligibleMessages(context) {
+        const { messages, agent } = context;
+        const toolNameMap = buildToolNameMap(messages);
+        let candidates;
+        if (this._preserveRecent > 0) {
+            candidates = getOldestMatches(messages, this._target, this._preserveRecent, toolNameMap, this._includeFilter, this._excludeFilter).filter((message) => messages.indexOf(message) > 0);
+        }
+        else {
+            candidates = messages.filter((message, index) => index > 0 &&
+                messageMatchesTarget(message, this._target, toolNameMap, this._includeFilter, this._excludeFilter));
+        }
+        if (this._threshold === undefined)
+            return candidates;
+        const eligible = [];
+        for (const message of candidates) {
+            let hasOversize = false;
+            for (const block of message.content) {
+                if (!this._blockMatchesTarget(block, message, toolNameMap))
+                    continue;
+                const tokens = await agent.model.countTokens([new Message({ role: message.role, content: [block] })]);
+                if (tokens > this._threshold) {
+                    hasOversize = true;
+                    break;
+                }
+            }
+            if (hasOversize)
+                eligible.push(message);
+        }
+        return eligible;
+    }
+}
+// --- Emergency truncation strategy ---
+/**
+ * Last-resort strategy that recomputes utilization and drops the oldest 20% of messages
+ * when the context window is still overflowing after all user-configured strategies have run.
+ * Appended internally by ContextManager — not part of the public builder API.
+ *
+ * TODO: add a ContextManagerConfig flag to disable this for users who want full control.
+ *
+ * @internal
+ */
+export class EmergencyTruncateStrategy extends BaseOffloadStrategy {
+    name = 'offload:emergency-truncate';
+    _removalRatio = 0.2;
+    constructor() {
+        super('*');
+    }
+    init() {
+        // No eager hooks — this only fires on overflow
+    }
+    async apply(context) {
+        if (context.messages.length <= 3)
+            return false;
+        const tokens = await context.agent.model.countTokens(context.messages);
+        const utilization = context.agent.model.estimateUtilization(tokens);
+        if (utilization < 1.0)
+            return false;
+        return this._applyPerMessage({ ...context, utilization });
+    }
+    async _replaceBlock() {
+        return null;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/src/context-manager/strategies/offload/base.js.map

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

package/dist/src/context-manager/strategies/offload/drop.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Drop strategy — removes matching content from the context window entirely.
+ *
+ * @internal
+ */
+import { Message, TextBlock, ToolResultBlock } from '../../../types/messages.js';
+import type { ContentBlock } from '../../../types/messages.js';
+import type { LocalAgent } from '../../../types/agent.js';
+import type { ContextStrategy } from '../../types.js';
+import { BaseOffloadStrategy } from './base.js';
+import type { OffloadConditions } from './base.js';
+export declare const DROPPED_MARKER = "[Dropped]";
+export declare class DropStrategy extends BaseOffloadStrategy {
+    readonly name = "offload:drop";
+    when(conditions: OffloadConditions): ContextStrategy;
+    protected _makeRemovalMarker(count: number): string;
+    protected _replaceBlock(block: TextBlock | ToolResultBlock, _tokens: number, message: Message, _agent: LocalAgent): Promise<ContentBlock | null>;
+}
+//# sourceMappingURL=drop.d.ts.map

package/dist/src/context-manager/strategies/offload/drop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../../../../src/context-manager/strategies/offload/drop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAElD,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,QAAQ,CAAC,IAAI,kBAAiB;IAE9B,IAAI,CAAC,UAAU,EAAE,iBAAiB,GAAG,eAAe;cAIjC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;cAI5C,aAAa,CAC3B,KAAK,EAAE,SAAS,GAAG,eAAe,EAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAYhC"}

package/dist/src/context-manager/strategies/offload/drop.js

@@ -0,0 +1,31 @@
+/**
+ * Drop strategy — removes matching content from the context window entirely.
+ *
+ * @internal
+ */
+import { logger } from '../../../logging/logger.js';
+import { Message, TextBlock, ToolResultBlock } from '../../../types/messages.js';
+import { BaseOffloadStrategy } from './base.js';
+export const DROPPED_MARKER = '[Dropped]';
+export class DropStrategy extends BaseOffloadStrategy {
+    name = 'offload:drop';
+    when(conditions) {
+        return new DropStrategy(this._target, conditions);
+    }
+    _makeRemovalMarker(count) {
+        return `[Dropped: ${count} ${count === 1 ? 'message' : 'messages'}]`;
+    }
+    async _replaceBlock(block, _tokens, message, _agent) {
+        if (block instanceof ToolResultBlock) {
+            logger.debug(`toolUseId=<${block.toolUseId}> | dropped tool result from context window`);
+            return new ToolResultBlock({
+                toolUseId: block.toolUseId,
+                status: block.status,
+                content: [new TextBlock(DROPPED_MARKER)],
+            });
+        }
+        logger.debug(`trackingId=<${message.trackingId}> | dropped text block from context window`);
+        return new TextBlock(DROPPED_MARKER);
+    }
+}
+//# sourceMappingURL=drop.js.map

package/dist/src/context-manager/strategies/offload/drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.js","sourceRoot":"","sources":["../../../../../src/context-manager/strategies/offload/drop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAIhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAG/C,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAA;AAEzC,MAAM,OAAO,YAAa,SAAQ,mBAAmB;IAC1C,IAAI,GAAG,cAAc,CAAA;IAE9B,IAAI,CAAC,UAA6B;QAChC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IACnD,CAAC;IAEkB,kBAAkB,CAAC,KAAa;QACjD,OAAO,aAAa,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,CAAA;IACtE,CAAC;IAES,KAAK,CAAC,aAAa,CAC3B,KAAkC,EAClC,OAAe,EACf,OAAgB,EAChB,MAAkB;QAElB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,SAAS,6CAA6C,CAAC,CAAA;YACxF,OAAO,IAAI,eAAe,CAAC;gBACzB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,cAAc,CAAC,CAAC;aACzC,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,UAAU,4CAA4C,CAAC,CAAA;QAC3F,OAAO,IAAI,SAAS,CAAC,cAAc,CAAC,CAAA;IACtC,CAAC;CACF"}

package/dist/src/context-manager/strategies/offload/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Offload strategies — reduce content in the context window.
+ *
+ * @internal
+ */
+import type { TruncateConfig } from '../../methods/truncate.js';
+import type { SummarizeConfig } from '../../methods/summarize.js';
+import type { OffloadStrategyBuilder, OffloadTarget } from './base.js';
+export { EmergencyTruncateStrategy } from './base.js';
+export { DROPPED_MARKER } from './drop.js';
+export type { OffloadTarget, OffloadConditions, OffloadStrategyBuilder } from './base.js';
+/**
+ * Offload strategy builder namespace.
+ *
+ * - `Offload.drop(target)` — drop matching content from context window entirely
+ * - `Offload.truncate(target, config)` — replace with a preview
+ * - `Offload.summarize(target, config)` — replace with LLM-generated summary
+ */
+interface OffloadNamespace {
+    /** Drop matching content from context window entirely. */
+    drop(target: OffloadTarget): OffloadStrategyBuilder;
+    /** Replace oversized content with a preview. */
+    truncate(target: OffloadTarget, config?: TruncateConfig): OffloadStrategyBuilder;
+    /** Replace oversized content with an LLM-generated summary. */
+    summarize(target: OffloadTarget, config?: SummarizeConfig): OffloadStrategyBuilder;
+}
+/**
+ * Builder for offload strategies — reduces content in the context window.
+ *
+ * @example
+ * ```typescript
+ * // Per-block: truncate each result over 2500 tokens, eagerly
+ * Offload.truncate("toolResults", { previewTokens: 750 }).when({ threshold: 1500 })
+ * // Per-block: truncate specific tools
+ * Offload.truncate(["tool::bash", "tool::read_file"]).when({ threshold: 2000 })
+ * // Message-level: summarize oldest messages on overflow
+ * Offload.summarize("*").when({ utilization: 1, preserveRecent: 4 })
+ * // Per-block: drop errors over 500 tokens
+ * Offload.drop("toolResultErrors").when({ threshold: 500 })
+ * ```
+ */
+export declare const Offload: OffloadNamespace;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/context-manager/strategies/offload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/context-manager/strategies/offload/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAKtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAEzF;;;;;;GAMG;AACH,UAAU,gBAAgB;IACxB,0DAA0D;IAC1D,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,sBAAsB,CAAA;IAEnD,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,sBAAsB,CAAA;IAEhF,+DAA+D;IAC/D,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,sBAAsB,CAAA;CACnF;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,OAAO,EAAE,gBAYrB,CAAA"}

package/dist/src/context-manager/strategies/offload/index.js

@@ -0,0 +1,37 @@
+/**
+ * Offload strategies — reduce content in the context window.
+ *
+ * @internal
+ */
+import { DropStrategy } from './drop.js';
+import { TruncateStrategy } from './truncate.js';
+import { SummarizeStrategy } from './summarize.js';
+export { EmergencyTruncateStrategy } from './base.js';
+export { DROPPED_MARKER } from './drop.js';
+/**
+ * Builder for offload strategies — reduces content in the context window.
+ *
+ * @example
+ * ```typescript
+ * // Per-block: truncate each result over 2500 tokens, eagerly
+ * Offload.truncate("toolResults", { previewTokens: 750 }).when({ threshold: 1500 })
+ * // Per-block: truncate specific tools
+ * Offload.truncate(["tool::bash", "tool::read_file"]).when({ threshold: 2000 })
+ * // Message-level: summarize oldest messages on overflow
+ * Offload.summarize("*").when({ utilization: 1, preserveRecent: 4 })
+ * // Per-block: drop errors over 500 tokens
+ * Offload.drop("toolResultErrors").when({ threshold: 500 })
+ * ```
+ */
+export const Offload = {
+    drop(target) {
+        return new DropStrategy(target);
+    },
+    truncate(target, config) {
+        return new TruncateStrategy(target, config);
+    },
+    summarize(target, config) {
+        return new SummarizeStrategy(target, config);
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/context-manager/strategies/offload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/context-manager/strategies/offload/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAqB1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,OAAO,GAAqB;IACvC,IAAI,CAAC,MAAqB;QACxB,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;IAED,QAAQ,CAAC,MAAqB,EAAE,MAAuB;QACrD,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,CAAC;IAED,SAAS,CAAC,MAAqB,EAAE,MAAwB;QACvD,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9C,CAAC;CACF,CAAA"}

package/dist/src/context-manager/strategies/offload/summarize.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Summarize strategy — replaces oversized content with LLM-generated summaries.
+ *
+ * @internal
+ */
+import { Message, TextBlock, ToolResultBlock } from '../../../types/messages.js';
+import type { ContentBlock } from '../../../types/messages.js';
+import type { LocalAgent } from '../../../types/agent.js';
+import type { ContextStrategy, ContextState } from '../../types.js';
+import { type SummarizeConfig } from '../../methods/summarize.js';
+import { BaseOffloadStrategy, type OffloadConditions, type OffloadTarget } from './base.js';
+export declare class SummarizeStrategy extends BaseOffloadStrategy {
+    readonly name = "offload:summarize";
+    private readonly _config;
+    constructor(target?: OffloadTarget, config?: SummarizeConfig, conditions?: OffloadConditions);
+    when(conditions: OffloadConditions): ContextStrategy;
+    apply(context: ContextState): Promise<boolean>;
+    protected _applyPerMessage(context: ContextState): Promise<boolean>;
+    protected _replaceBlock(block: TextBlock | ToolResultBlock, tokens: number, message: Message, agent: LocalAgent): Promise<ContentBlock | null>;
+    private _resolveModel;
+}
+//# sourceMappingURL=summarize.d.ts.map

package/dist/src/context-manager/strategies/offload/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../../../src/context-manager/strategies/offload/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,mBAAmB,EAGnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,WAAW,CAAA;AAElB,qBAAa,iBAAkB,SAAQ,mBAAmB;IACxD,QAAQ,CAAC,IAAI,uBAAsB;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,iBAAiB;IAK5F,IAAI,CAAC,UAAU,EAAE,iBAAiB,GAAG,eAAe;IAIrC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;cAQpC,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;cAwDlE,aAAa,CAC3B,KAAK,EAAE,SAAS,GAAG,eAAe,EAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAuB/B,OAAO,CAAC,aAAa;CAGtB"}