@tuanhung303/opencode-acp 2.1.0

package/dist/lib/strategies/placeholder-compression.js

@@ -0,0 +1,148 @@
+import { isMessageCompacted } from "../shared-utils";
+import { countTokens } from "./utils";
+/**
+ * Placeholder Compression Strategy
+ *
+ * Replaces verbose tool outputs with actionable placeholder hints while preserving
+ * the tool call structure (name + input) as breadcrumbs for the agent.
+ *
+ * This allows the agent to see what actions were taken and re-execute if needed,
+ * while dramatically reducing context size.
+ *
+ * Based on: https://www.hadijaveed.me/2025/11/26/escaping-context-amnesia-ai-agents/
+ */
+// Tool-specific placeholder templates
+const PLACEHOLDER_TEMPLATES = {
+    read: (input) => `[File read previously. Read again if needed: ${input?.filePath || input?.path || 'unknown'}]`,
+    glob: (input) => `[Glob search completed for pattern: ${input?.pattern || 'unknown'}. Search again if needed]`,
+    grep: (input) => `[Content search completed for: ${input?.pattern || 'unknown'}. Search again if needed]`,
+    bash: (input) => `[Command executed: ${truncate(input?.command || input?.description || 'unknown', 80)}. Re-run if needed]`,
+    webfetch: (input) => `[URL fetched: ${truncate(input?.url || 'unknown', 60)}. Fetch again if needed]`,
+    "ddg-search_search": (input) => `[Search completed for: ${input?.query || 'unknown'}. Search again for current results]`,
+    "ddg-search_fetch_content": (input) => `[Content fetched from: ${truncate(input?.url || 'unknown', 60)}]`,
+    "google_search": (input) => `[Google search completed for: ${input?.query || 'unknown'}. Search again if needed]`,
+    "context7_query-docs": (input) => `[Docs queried for: ${input?.query || 'unknown'}. Query again if needed]`,
+    "context7_resolve-library-id": (input) => `[Library resolved: ${input?.libraryName || 'unknown'}. Resolve again if needed]`,
+    "excel_read_data_from_excel": (input) => `[Excel data read from: ${input?.filepath || 'unknown'}. Read again if needed]`,
+    "pdf-reader_read_pdf": () => `[PDF content read. Read again if needed]`,
+    "url-context-mcp_analyze_urls": (input) => `[URLs analyzed. Analyze again if needed: ${truncate(JSON.stringify(input?.urls || []), 60)}]`,
+    "url-context-mcp_google_search": (input) => `[Search completed for: ${input?.query || 'unknown'}. Search again if needed]`,
+    list: (input) => `[Directory listed: ${input?.path || 'current'}. List again if needed]`,
+    codesearch: (input) => `[Code search completed for: ${input?.query || 'unknown'}. Search again if needed]`,
+    websearch: (input) => `[Web search completed for: ${input?.query || 'unknown'}. Search again if needed]`,
+};
+// Default placeholder for tools not in the template list
+const DEFAULT_PLACEHOLDER = (toolName, input) => {
+    const inputHint = input ? ` with: ${truncate(JSON.stringify(input), 80)}` : '';
+    return `[${toolName} executed${inputHint}. Re-run if needed]`;
+};
+// Tools that should NEVER be compressed (their output is critical)
+const PROTECTED_TOOLS = new Set([
+    'write',
+    'edit',
+    'todowrite',
+    'todoread',
+    'discard',
+    'extract',
+    'task',
+    'question',
+    'batch',
+    'plan_enter',
+    'plan_exit',
+    'skill',
+]);
+// Tools whose output should be preserved for schema/structure understanding
+const SCHEMA_TOOLS = new Set([
+    'excel_get_workbook_metadata',
+    'excel_get_data_validation_info',
+    'word-document-server_get_document_outline',
+    'word-document-server_get_document_info',
+]);
+function truncate(str, maxLen) {
+    if (!str)
+        return 'unknown';
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + '...';
+}
+export const placeholderCompression = (state, logger, config, messages) => {
+    const compressionConfig = config.strategies.placeholderCompression;
+    if (!compressionConfig?.enabled) {
+        return;
+    }
+    const delayTurns = compressionConfig.delayTurns ?? 2;
+    const minOutputTokens = compressionConfig.minOutputTokens ?? 100;
+    const additionalProtected = new Set(compressionConfig.protectedTools ?? []);
+    let compressedCount = 0;
+    let tokensSaved = 0;
+    // Calculate current turn from messages
+    const totalMessages = messages.length;
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        // Skip compacted messages
+        if (isMessageCompacted(state, msg)) {
+            continue;
+        }
+        // Calculate turn age (0 = most recent)
+        const turnAge = totalMessages - 1 - i;
+        // Skip recent turns to preserve cache and allow agent to reference
+        if (turnAge < delayTurns) {
+            continue;
+        }
+        // Process tool parts
+        const parts = Array.isArray(msg.parts) ? msg.parts : [];
+        for (const part of parts) {
+            // Only process tool parts with completed status
+            if (part.type !== "tool") {
+                continue;
+            }
+            const toolName = part.tool;
+            const toolState = part.state;
+            if (!toolName || !toolState)
+                continue;
+            // Skip if not completed (errors handled by purgeErrors)
+            if (toolState.status !== "completed") {
+                continue;
+            }
+            // Skip protected tools
+            if (PROTECTED_TOOLS.has(toolName) || additionalProtected.has(toolName)) {
+                continue;
+            }
+            // Skip schema tools
+            if (SCHEMA_TOOLS.has(toolName)) {
+                continue;
+            }
+            // Get the output
+            const output = toolState.output;
+            if (output === undefined || output === null) {
+                continue;
+            }
+            // Calculate output size
+            const outputStr = typeof output === 'string' ? output : JSON.stringify(output);
+            const outputTokens = countTokens(outputStr);
+            // Only compress if output is large enough
+            if (outputTokens < minOutputTokens) {
+                continue;
+            }
+            // Generate placeholder
+            const template = PLACEHOLDER_TEMPLATES[toolName];
+            const placeholder = template
+                ? template(toolState.input)
+                : DEFAULT_PLACEHOLDER(toolName, toolState.input);
+            // Calculate savings
+            const placeholderTokens = countTokens(placeholder);
+            const saved = outputTokens - placeholderTokens;
+            if (saved > 0) {
+                // Replace output with placeholder
+                toolState.output = placeholder;
+                tokensSaved += saved;
+                compressedCount++;
+            }
+        }
+    }
+    if (compressedCount > 0) {
+        state.stats.totalPruneTokens += tokensSaved;
+        logger.debug(`Placeholder compression: compressed ${compressedCount} tool outputs (estimated ${tokensSaved} tokens saved)`);
+    }
+};
+//# sourceMappingURL=placeholder-compression.js.map

package/dist/lib/strategies/placeholder-compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-compression.js","sourceRoot":"","sources":["../../../lib/strategies/placeholder-compression.ts"],"names":[],"mappings":"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"}

package/dist/lib/strategies/prune-thinking.d.ts

@@ -0,0 +1,15 @@
+import { PluginConfig } from "../config";
+import { Logger } from "../logger";
+import type { SessionState, WithParts } from "../state";
+/**
+ * Prune Thinking strategy - removes extended thinking tokens from assistant messages
+ * after they are older than a configurable number of turns.
+ *
+ * Thinking tokens (Claude's <thinking> blocks, OpenAI's reasoning field) consume
+ * significant context but provide no utility after the response is generated.
+ *
+ * This strategy strips thinking content from older messages to save context space.
+ * Recent turns are preserved to maintain cache efficiency.
+ */
+export declare const pruneThinking: (state: SessionState, logger: Logger, config: PluginConfig, messages: WithParts[]) => void;
+//# sourceMappingURL=prune-thinking.d.ts.map

package/dist/lib/strategies/prune-thinking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-thinking.d.ts","sourceRoot":"","sources":["../../../lib/strategies/prune-thinking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEvD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACtB,OAAO,YAAY,EACnB,QAAQ,MAAM,EACd,QAAQ,YAAY,EACpB,UAAU,SAAS,EAAE,KACtB,IA2EF,CAAA"}

package/dist/lib/strategies/prune-thinking.js

@@ -0,0 +1,79 @@
+/**
+ * Prune Thinking strategy - removes extended thinking tokens from assistant messages
+ * after they are older than a configurable number of turns.
+ *
+ * Thinking tokens (Claude's <thinking> blocks, OpenAI's reasoning field) consume
+ * significant context but provide no utility after the response is generated.
+ *
+ * This strategy strips thinking content from older messages to save context space.
+ * Recent turns are preserved to maintain cache efficiency.
+ */
+export const pruneThinking = (state, logger, config, messages) => {
+    if (!config.strategies.pruneThinking?.enabled) {
+        return;
+    }
+    const delayTurns = config.strategies.pruneThinking.delayTurns ?? 1;
+    let prunedCount = 0;
+    let tokensSaved = 0;
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        // Only process assistant messages
+        if (msg.info.role !== "assistant") {
+            continue;
+        }
+        // Calculate turn age (messages are in chronological order)
+        // Use message index as a proxy for turn age
+        const turnAge = messages.length - 1 - i;
+        // Skip recent turns to preserve cache
+        if (turnAge < delayTurns) {
+            continue;
+        }
+        // Handle array content (parts array)
+        if (Array.isArray(msg.parts)) {
+            const originalLength = msg.parts.length;
+            // Filter out thinking blocks
+            msg.parts = msg.parts.filter((part) => {
+                // Anthropic thinking block format
+                if (part.type === "thinking") {
+                    tokensSaved += estimateTokens(part.thinking || "");
+                    return false;
+                }
+                // Text part that contains thinking tags
+                if (part.type === "text" && typeof part.text === "string") {
+                    const thinkingMatch = part.text.match(/<thinking>[\s\S]*?<\/thinking>/g);
+                    if (thinkingMatch) {
+                        for (const match of thinkingMatch) {
+                            tokensSaved += estimateTokens(match);
+                        }
+                        part.text = part.text.replace(/<thinking>[\s\S]*?<\/thinking>/g, "").trim();
+                        // Remove empty text parts
+                        if (!part.text) {
+                            return false;
+                        }
+                    }
+                }
+                return true;
+            });
+            if (msg.parts.length < originalLength) {
+                prunedCount++;
+            }
+        }
+        // Handle OpenAI reasoning field on the info object
+        if (msg.info.reasoning) {
+            tokensSaved += estimateTokens(msg.info.reasoning);
+            delete msg.info.reasoning;
+            prunedCount++;
+        }
+    }
+    if (prunedCount > 0) {
+        state.stats.totalPruneTokens += tokensSaved;
+        logger.debug(`Pruned thinking tokens from ${prunedCount} messages (estimated ${tokensSaved} tokens saved)`);
+    }
+};
+/**
+ * Rough token estimation (1 token ≈ 4 characters for English text)
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=prune-thinking.js.map

package/dist/lib/strategies/prune-thinking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune-thinking.js","sourceRoot":"","sources":["../../../lib/strategies/prune-thinking.ts"],"names":[],"mappings":"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"}

package/dist/lib/strategies/purge-errors.d.ts

@@ -0,0 +1,13 @@
+import { PluginConfig } from "../config";
+import { Logger } from "../logger";
+import type { SessionState, WithParts } from "../state";
+/**
+ * Purge Errors strategy - prunes tool inputs for tools that errored
+ * after they are older than a configurable number of turns.
+ * The error message is preserved, but the (potentially large) inputs
+ * are removed to save context.
+ *
+ * Modifies the session state in place to add pruned tool call IDs.
+ */
+export declare const purgeErrors: (state: SessionState, logger: Logger, config: PluginConfig, messages: WithParts[]) => void;
+//# sourceMappingURL=purge-errors.d.ts.map

package/dist/lib/strategies/purge-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge-errors.d.ts","sourceRoot":"","sources":["../../../lib/strategies/purge-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAKvD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GACpB,OAAO,YAAY,EACnB,QAAQ,MAAM,EACd,QAAQ,YAAY,EACpB,UAAU,SAAS,EAAE,KACtB,IA2DF,CAAA"}

package/dist/lib/strategies/purge-errors.js

@@ -0,0 +1,59 @@
+import { buildToolIdList } from "../messages/utils";
+import { getFilePathFromParameters, isProtectedFilePath } from "../protected-file-patterns";
+import { calculateTokensSaved } from "./utils";
+/**
+ * Purge Errors strategy - prunes tool inputs for tools that errored
+ * after they are older than a configurable number of turns.
+ * The error message is preserved, but the (potentially large) inputs
+ * are removed to save context.
+ *
+ * Modifies the session state in place to add pruned tool call IDs.
+ */
+export const purgeErrors = (state, logger, config, messages) => {
+    if (!config.strategies.purgeErrors.enabled) {
+        return;
+    }
+    // Build list of all tool call IDs from messages (chronological order)
+    const allToolIds = buildToolIdList(state, messages, logger);
+    if (allToolIds.length === 0) {
+        return;
+    }
+    // Filter out IDs already pruned
+    const alreadyPruned = new Set(state.prune.toolIds);
+    const unprunedIds = allToolIds.filter((id) => !alreadyPruned.has(id));
+    if (unprunedIds.length === 0) {
+        return;
+    }
+    const protectedTools = config.strategies.purgeErrors.protectedTools;
+    const turnThreshold = config.strategies.purgeErrors.turns;
+    const newPruneIds = [];
+    for (const id of unprunedIds) {
+        const metadata = state.toolParameters.get(id);
+        if (!metadata) {
+            continue;
+        }
+        // Skip protected tools
+        if (protectedTools.includes(metadata.tool)) {
+            continue;
+        }
+        const filePath = getFilePathFromParameters(metadata.parameters);
+        if (isProtectedFilePath(filePath, config.protectedFilePatterns)) {
+            continue;
+        }
+        // Only process error tools
+        if (metadata.status !== "error") {
+            continue;
+        }
+        // Check if the tool is old enough to prune
+        const turnAge = state.currentTurn - metadata.turn;
+        if (turnAge >= turnThreshold) {
+            newPruneIds.push(id);
+        }
+    }
+    if (newPruneIds.length > 0) {
+        state.stats.totalPruneTokens += calculateTokensSaved(state, messages, newPruneIds);
+        state.prune.toolIds.push(...newPruneIds);
+        logger.debug(`Marked ${newPruneIds.length} error tool calls for pruning (older than ${turnThreshold} turns)`);
+    }
+};
+//# sourceMappingURL=purge-errors.js.map

package/dist/lib/strategies/purge-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge-errors.js","sourceRoot":"","sources":["../../../lib/strategies/purge-errors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACvB,KAAmB,EACnB,MAAc,EACd,MAAoB,EACpB,QAAqB,EACjB,EAAE;IACN,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzC,OAAM;IACV,CAAC;IAED,sEAAsE;IACtE,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC3D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAM;IACV,CAAC;IAED,gCAAgC;IAChC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAClD,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IAErE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAM;IACV,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,cAAc,CAAA;IACnE,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAA;IAEzD,MAAM,WAAW,GAAa,EAAE,CAAA;IAEhC,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,SAAQ;QACZ,CAAC;QAED,uBAAuB;QACvB,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,SAAQ;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,yBAAyB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QAC/D,IAAI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC9D,SAAQ;QACZ,CAAC;QAED,2BAA2B;QAC3B,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,SAAQ;QACZ,CAAC;QAED,2CAA2C;QAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAA;QACjD,IAAI,OAAO,IAAI,aAAa,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACxB,CAAC;IACL,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,gBAAgB,IAAI,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;QAClF,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAA;QACxC,MAAM,CAAC,KAAK,CACR,UAAU,WAAW,CAAC,MAAM,6CAA6C,aAAa,SAAS,CAClG,CAAA;IACL,CAAC;AACL,CAAC,CAAA"}

package/dist/lib/strategies/read-consolidation.d.ts

@@ -0,0 +1,21 @@
+import { PluginConfig } from "../config";
+import { Logger } from "../logger";
+import type { SessionState, WithParts } from "../state";
+/**
+ * Read Consolidation Strategy
+ *
+ * When the same tool+parameter is called multiple times, older outputs
+ * are replaced with pointers to the newer output (which has current state).
+ *
+ * This is different from deduplication:
+ * - Deduplication removes exact duplicate calls entirely
+ * - Consolidation keeps both calls visible as breadcrumbs, but only the
+ *   newest one has the full output
+ *
+ * Rationale:
+ * - When same file is read multiple times, older reads become stale
+ * - Newer read has current file state (may have been modified)
+ * - Keep full output on newer read, pointer on older read
+ */
+export declare function readConsolidation(state: SessionState, logger: Logger, config: PluginConfig, messages: WithParts[]): void;
+//# sourceMappingURL=read-consolidation.d.ts.map

package/dist/lib/strategies/read-consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-consolidation.d.ts","sourceRoot":"","sources":["../../../lib/strategies/read-consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAA;AAe3E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,SAAS,EAAE,GACtB,IAAI,CAgKN"}

package/dist/lib/strategies/read-consolidation.js

@@ -0,0 +1,155 @@
+import { isMessageCompacted } from "../shared-utils";
+import { countTokens } from "./utils";
+/**
+ * Primary parameter to use as key for each trackable tool
+ */
+const PRIMARY_PARAMS = {
+    read: "filePath",
+    glob: "pattern",
+    grep: "pattern",
+    webfetch: "url",
+    bash: "command",
+};
+/**
+ * Read Consolidation Strategy
+ *
+ * When the same tool+parameter is called multiple times, older outputs
+ * are replaced with pointers to the newer output (which has current state).
+ *
+ * This is different from deduplication:
+ * - Deduplication removes exact duplicate calls entirely
+ * - Consolidation keeps both calls visible as breadcrumbs, but only the
+ *   newest one has the full output
+ *
+ * Rationale:
+ * - When same file is read multiple times, older reads become stale
+ * - Newer read has current file state (may have been modified)
+ * - Keep full output on newer read, pointer on older read
+ */
+export function readConsolidation(state, logger, config, messages) {
+    const strategyConfig = config.strategies.readConsolidation;
+    if (!strategyConfig?.enabled) {
+        return;
+    }
+    const trackableTools = new Set(strategyConfig.tools ?? ["read", "glob", "grep", "webfetch", "bash"]);
+    // Initialize consolidation tracker if not present
+    if (!state.consolidationTracker) {
+        state.consolidationTracker = new Map();
+    }
+    // Track: key -> { messageIndex, callId } for the NEWEST occurrence
+    const newestOccurrences = new Map();
+    // First pass: Find all tool calls and track the newest occurrence per key
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        // Skip compacted messages
+        if (isMessageCompacted(state, msg)) {
+            continue;
+        }
+        const parts = Array.isArray(msg.parts) ? msg.parts : [];
+        for (const part of parts) {
+            if (part.type !== "tool") {
+                continue;
+            }
+            const toolName = part.tool;
+            const toolState = part.state;
+            if (!toolName || !toolState)
+                continue;
+            // Only track configured tools
+            if (!trackableTools.has(toolName)) {
+                continue;
+            }
+            // Skip if not completed
+            if (toolState.status !== "completed") {
+                continue;
+            }
+            // Get the primary parameter for this tool
+            const primaryParam = PRIMARY_PARAMS[toolName];
+            if (!primaryParam)
+                continue;
+            const input = toolState.input;
+            if (!input || typeof input !== "object")
+                continue;
+            const paramValue = input[primaryParam];
+            if (!paramValue)
+                continue;
+            // Create tracker key
+            const trackerKey = `${toolName}:${paramValue}`;
+            // Always update to the latest (higher index = newer)
+            newestOccurrences.set(trackerKey, {
+                messageIndex: i,
+                callId: part.callID || part.id,
+                toolName,
+            });
+        }
+    }
+    // Second pass: Replace older occurrences with pointers
+    let totalTokensSaved = 0;
+    let consolidatedCount = 0;
+    for (let i = 0; i < messages.length; i++) {
+        const msg = messages[i];
+        // Skip compacted messages
+        if (isMessageCompacted(state, msg)) {
+            continue;
+        }
+        const parts = Array.isArray(msg.parts) ? msg.parts : [];
+        for (const part of parts) {
+            if (part.type !== "tool") {
+                continue;
+            }
+            const toolName = part.tool;
+            const toolState = part.state;
+            if (!toolName || !toolState)
+                continue;
+            // Only track configured tools
+            if (!trackableTools.has(toolName)) {
+                continue;
+            }
+            // Skip if not completed
+            if (toolState.status !== "completed") {
+                continue;
+            }
+            // Get the primary parameter for this tool
+            const primaryParam = PRIMARY_PARAMS[toolName];
+            if (!primaryParam)
+                continue;
+            const input = toolState.input;
+            if (!input || typeof input !== "object")
+                continue;
+            const paramValue = input[primaryParam];
+            if (!paramValue)
+                continue;
+            // Create tracker key
+            const trackerKey = `${toolName}:${paramValue}`;
+            const newest = newestOccurrences.get(trackerKey);
+            if (!newest)
+                continue;
+            // If this is NOT the newest occurrence, replace with pointer
+            const currentCallId = part.callID || part.id;
+            if (newest.messageIndex !== i || newest.callId !== currentCallId) {
+                // This is an older occurrence
+                const output = toolState.output;
+                if (output === undefined || output === null)
+                    continue;
+                const outputStr = typeof output === "string" ? output : JSON.stringify(output);
+                // Skip if already consolidated
+                if (outputStr.includes("[📍 See later")) {
+                    continue;
+                }
+                const outputTokens = countTokens(outputStr);
+                // Create pointer to newer occurrence
+                const pointer = `[📍 See later ${toolName} at message #${newest.messageIndex + 1}. This output is stale.]`;
+                toolState.output = pointer;
+                const saved = outputTokens - countTokens(pointer);
+                if (saved > 0) {
+                    totalTokensSaved += saved;
+                    consolidatedCount++;
+                }
+            }
+        }
+    }
+    if (consolidatedCount > 0) {
+        state.stats.totalPruneTokens += totalTokensSaved;
+        logger.debug(`Read consolidation: consolidated ${consolidatedCount} older tool outputs (estimated ${totalTokensSaved} tokens saved)`);
+    }
+}
+//# sourceMappingURL=read-consolidation.js.map

package/dist/lib/strategies/read-consolidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-consolidation.js","sourceRoot":"","sources":["../../../lib/strategies/read-consolidation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErC;;GAEG;AACH,MAAM,cAAc,GAA2B;IAC3C,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,SAAS;CAClB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC7B,KAAmB,EACnB,MAAc,EACd,MAAoB,EACpB,QAAqB;IAErB,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAA;IAC1D,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC;QAC3B,OAAM;IACV,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,CAC1B,cAAc,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CACvE,CAAA;IAED,kDAAkD;IAClD,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC9B,KAAK,CAAC,oBAAoB,GAAG,IAAI,GAAG,EAA8B,CAAA;IACtE,CAAC;IAED,mEAAmE;IACnE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAG9B,CAAA;IAEH,0EAA0E;IAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAEvB,0BAA0B;QAC1B,IAAI,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACjC,SAAQ;QACZ,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QAEvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACvB,SAAQ;YACZ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAA;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAA;YAE5B,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;gBAAE,SAAQ;YAErC,8BAA8B;YAC9B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,SAAQ;YACZ,CAAC;YAED,wBAAwB;YACxB,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACnC,SAAQ;YACZ,CAAC;YAED,0CAA0C;YAC1C,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;YAC7C,IAAI,CAAC,YAAY;gBAAE,SAAQ;YAE3B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;YAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAQ;YAEjD,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,CAAA;YACtC,IAAI,CAAC,UAAU;gBAAE,SAAQ;YAEzB,qBAAqB;YACrB,MAAM,UAAU,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAA;YAE9C,qDAAqD;YACrD,iBAAiB,CAAC,GAAG,CAAC,UAAU,EAAE;gBAC9B,YAAY,EAAE,CAAC;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE;gBAC9B,QAAQ;aACX,CAAC,CAAA;QACN,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,IAAI,gBAAgB,GAAG,CAAC,CAAA;IACxB,IAAI,iBAAiB,GAAG,CAAC,CAAA;IAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QAEvB,0BAA0B;QAC1B,IAAI,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACjC,SAAQ;QACZ,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QAEvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACvB,SAAQ;YACZ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAA;YAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAA;YAE5B,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;gBAAE,SAAQ;YAErC,8BAA8B;YAC9B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,SAAQ;YACZ,CAAC;YAED,wBAAwB;YACxB,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACnC,SAAQ;YACZ,CAAC;YAED,0CAA0C;YAC1C,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;YAC7C,IAAI,CAAC,YAAY;gBAAE,SAAQ;YAE3B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;YAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAQ;YAEjD,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,CAAA;YACtC,IAAI,CAAC,UAAU;gBAAE,SAAQ;YAEzB,qBAAqB;YACrB,MAAM,UAAU,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAA;YAE9C,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YAChD,IAAI,CAAC,MAAM;gBAAE,SAAQ;YAErB,6DAA6D;YAC7D,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAA;YAC5C,IAAI,MAAM,CAAC,YAAY,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBAC/D,8BAA8B;gBAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;gBAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;oBAAE,SAAQ;gBAErD,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;gBAE9E,+BAA+B;gBAC/B,IAAI,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;oBACtC,SAAQ;gBACZ,CAAC;gBAED,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;gBAE3C,qCAAqC;gBACrC,MAAM,OAAO,GAAG,iBAAiB,QAAQ,gBAAgB,MAAM,CAAC,YAAY,GAAG,CAAC,0BAA0B,CAAA;gBAE1G,SAAS,CAAC,MAAM,GAAG,OAAO,CAAA;gBAE1B,MAAM,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;gBACjD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACZ,gBAAgB,IAAI,KAAK,CAAA;oBACzB,iBAAiB,EAAE,CAAA;gBACvB,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,KAAK,CAAC,gBAAgB,IAAI,gBAAgB,CAAA;QAChD,MAAM,CAAC,KAAK,CACR,oCAAoC,iBAAiB,kCAAkC,gBAAgB,gBAAgB,CAC1H,CAAA;IACL,CAAC;AACL,CAAC"}

package/dist/lib/strategies/supersede-writes.d.ts

@@ -0,0 +1,13 @@
+import { PluginConfig } from "../config";
+import { Logger } from "../logger";
+import type { SessionState, WithParts } from "../state";
+/**
+ * Supersede Writes strategy - prunes write tool inputs for files that have
+ * subsequently been read. When a file is written and later read, the original
+ * write content becomes redundant since the current file state is captured
+ * in the read result.
+ *
+ * Modifies the session state in place to add pruned tool call IDs.
+ */
+export declare const supersedeWrites: (state: SessionState, logger: Logger, config: PluginConfig, messages: WithParts[]) => void;
+//# sourceMappingURL=supersede-writes.d.ts.map

package/dist/lib/strategies/supersede-writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede-writes.d.ts","sourceRoot":"","sources":["../../../lib/strategies/supersede-writes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAKvD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GACxB,OAAO,YAAY,EACnB,QAAQ,MAAM,EACd,QAAQ,YAAY,EACpB,UAAU,SAAS,EAAE,KACtB,IAoFF,CAAA"}

package/dist/lib/strategies/supersede-writes.js

@@ -0,0 +1,84 @@
+import { buildToolIdList } from "../messages/utils";
+import { getFilePathFromParameters, isProtectedFilePath } from "../protected-file-patterns";
+import { calculateTokensSaved } from "./utils";
+/**
+ * Supersede Writes strategy - prunes write tool inputs for files that have
+ * subsequently been read. When a file is written and later read, the original
+ * write content becomes redundant since the current file state is captured
+ * in the read result.
+ *
+ * Modifies the session state in place to add pruned tool call IDs.
+ */
+export const supersedeWrites = (state, logger, config, messages) => {
+    if (!config.strategies.supersedeWrites.enabled) {
+        return;
+    }
+    // Build list of all tool call IDs from messages (chronological order)
+    const allToolIds = buildToolIdList(state, messages, logger);
+    if (allToolIds.length === 0) {
+        return;
+    }
+    // Filter out IDs already pruned
+    const alreadyPruned = new Set(state.prune.toolIds);
+    const unprunedIds = allToolIds.filter((id) => !alreadyPruned.has(id));
+    if (unprunedIds.length === 0) {
+        return;
+    }
+    // Track write tools by file path: filePath -> [{ id, index }]
+    // We track index to determine chronological order
+    const writesByFile = new Map();
+    // Track read file paths with their index
+    const readsByFile = new Map();
+    for (let i = 0; i < allToolIds.length; i++) {
+        const id = allToolIds[i];
+        const metadata = state.toolParameters.get(id);
+        if (!metadata) {
+            continue;
+        }
+        const filePath = getFilePathFromParameters(metadata.parameters);
+        if (!filePath) {
+            continue;
+        }
+        if (isProtectedFilePath(filePath, config.protectedFilePatterns)) {
+            continue;
+        }
+        if (metadata.tool === "write") {
+            if (!writesByFile.has(filePath)) {
+                writesByFile.set(filePath, []);
+            }
+            writesByFile.get(filePath).push({ id, index: i });
+        }
+        else if (metadata.tool === "read") {
+            if (!readsByFile.has(filePath)) {
+                readsByFile.set(filePath, []);
+            }
+            readsByFile.get(filePath).push(i);
+        }
+    }
+    // Find writes that are superseded by subsequent reads
+    const newPruneIds = [];
+    for (const [filePath, writes] of writesByFile.entries()) {
+        const reads = readsByFile.get(filePath);
+        if (!reads || reads.length === 0) {
+            continue;
+        }
+        // For each write, check if there's a read that comes after it
+        for (const write of writes) {
+            // Skip if already pruned
+            if (alreadyPruned.has(write.id)) {
+                continue;
+            }
+            // Check if any read comes after this write
+            const hasSubsequentRead = reads.some((readIndex) => readIndex > write.index);
+            if (hasSubsequentRead) {
+                newPruneIds.push(write.id);
+            }
+        }
+    }
+    if (newPruneIds.length > 0) {
+        state.stats.totalPruneTokens += calculateTokensSaved(state, messages, newPruneIds);
+        state.prune.toolIds.push(...newPruneIds);
+        logger.debug(`Marked ${newPruneIds.length} superseded write tool calls for pruning`);
+    }
+};
+//# sourceMappingURL=supersede-writes.js.map

package/dist/lib/strategies/supersede-writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede-writes.js","sourceRoot":"","sources":["../../../lib/strategies/supersede-writes.ts"],"names":[],"mappings":"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"}