@tuanhung303/opencode-acp 0.0.1

package/dist/lib/strategies/deduplication.js

@@ -0,0 +1,178 @@
+import { buildToolIdList } from "../messages/utils";
+import { getFilePathFromParameters, isProtectedFilePath } from "../protected-file-patterns";
+import { calculateTokensSaved } from "./utils";
+/**
+ * Deduplication strategy - prunes older tool calls that have identical
+ * tool name and parameters, keeping only the most recent occurrence.
+ * Also handles fuzzy deduplication for overlapping file reads.
+ * Modifies the session state in place to add pruned tool call IDs.
+ */
+export const deduplicate = (state, logger, config, messages) => {
+    if (!config.strategies.deduplication.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.deduplication.protectedTools;
+    // Group by signature (tool name + normalized parameters)
+    const signatureMap = new Map();
+    for (const id of unprunedIds) {
+        const metadata = state.toolParameters.get(id);
+        if (!metadata) {
+            // logger.warn(`Missing metadata for tool call ID: ${id}`)
+            continue;
+        }
+        // Skip protected tools
+        if (protectedTools.includes(metadata.tool)) {
+            continue;
+        }
+        const filePath = getFilePathFromParameters(metadata.parameters);
+        if (isProtectedFilePath(filePath, config.protectedFilePatterns)) {
+            continue;
+        }
+        const signature = createToolSignature(metadata.tool, metadata.parameters);
+        if (!signatureMap.has(signature)) {
+            signatureMap.set(signature, []);
+        }
+        signatureMap.get(signature).push(id);
+    }
+    // Find duplicates - keep only the most recent (last) in each group
+    const newPruneIds = [];
+    for (const [, ids] of signatureMap.entries()) {
+        if (ids.length > 1) {
+            // All except last (most recent) should be pruned
+            const idsToRemove = ids.slice(0, -1);
+            newPruneIds.push(...idsToRemove);
+        }
+    }
+    state.stats.totalPruneTokens += calculateTokensSaved(state, messages, newPruneIds);
+    const allDeduplicatedIds = [...newPruneIds];
+    // Phase 2: Fuzzy deduplication for overlapping file reads
+    const overlappingReads = findOverlappingReads(state, unprunedIds, protectedTools, config);
+    if (overlappingReads.length > 0) {
+        allDeduplicatedIds.push(...overlappingReads);
+        logger.debug(`Marked ${overlappingReads.length} overlapping file reads for pruning`);
+    }
+    if (allDeduplicatedIds.length > 0) {
+        state.prune.toolIds.push(...allDeduplicatedIds);
+        const tokensSaved = calculateTokensSaved(state, messages, allDeduplicatedIds);
+        state.stats.totalPruneTokens += tokensSaved;
+        state.stats.strategyStats.deduplication.count += allDeduplicatedIds.length;
+        state.stats.strategyStats.deduplication.tokens += tokensSaved;
+        logger.debug(`Marked ${allDeduplicatedIds.length} duplicate tool calls for pruning`);
+    }
+};
+/**
+ * Find overlapping file reads that can be safely pruned.
+ * If a file is read with overlapping ranges, older reads that are
+ * fully contained within newer reads can be pruned.
+ */
+function findOverlappingReads(state, toolIds, protectedTools, config) {
+    const fileReads = new Map();
+    // Collect all read operations with file paths
+    for (const id of toolIds) {
+        const metadata = state.toolParameters.get(id);
+        if (!metadata || metadata.tool !== "read")
+            continue;
+        if (protectedTools.includes(metadata.tool))
+            continue;
+        const filePath = getFilePathFromParameters(metadata.parameters);
+        if (!filePath || isProtectedFilePath(filePath, config.protectedFilePatterns))
+            continue;
+        const params = metadata.parameters || {};
+        const offset = typeof params.offset === "number" ? params.offset : 0;
+        const limit = typeof params.limit === "number" ? params.limit : undefined;
+        if (!fileReads.has(filePath)) {
+            fileReads.set(filePath, []);
+        }
+        fileReads.get(filePath).push({ id, filePath, offset, limit });
+    }
+    const toPrune = [];
+    // For each file, check for overlapping ranges
+    for (const [, reads] of fileReads.entries()) {
+        if (reads.length < 2)
+            continue;
+        // Sort by offset (ascending), then by limit (descending for same offset)
+        reads.sort((a, b) => {
+            if (a.offset !== b.offset)
+                return a.offset - b.offset;
+            // If same offset, prefer the one with larger limit (or undefined = unlimited)
+            if (a.limit === undefined)
+                return 1;
+            if (b.limit === undefined)
+                return -1;
+            return b.limit - a.limit;
+        });
+        // Check each read against later reads (which are more recent due to chronological order)
+        for (let i = 0; i < reads.length - 1; i++) {
+            const older = reads[i];
+            const newer = reads[reads.length - 1]; // Most recent read of this file
+            if (older.id === newer.id)
+                continue;
+            // Check if older read is fully contained within newer read
+            if (isRangeContained(older, newer)) {
+                toPrune.push(older.id);
+            }
+        }
+    }
+    return toPrune;
+}
+/**
+ * Check if range A is fully contained within range B.
+ */
+function isRangeContained(a, b) {
+    // If b has no limit (read entire file), it contains everything
+    if (b.limit === undefined) {
+        return a.offset >= b.offset;
+    }
+    // If a has no limit but b does, a might be larger
+    if (a.limit === undefined) {
+        return false;
+    }
+    const aEnd = a.offset + a.limit;
+    const bEnd = b.offset + b.limit;
+    // A is contained in B if A starts at or after B and ends at or before B
+    return a.offset >= b.offset && aEnd <= bEnd;
+}
+function createToolSignature(tool, parameters) {
+    if (!parameters) {
+        return tool;
+    }
+    const normalized = normalizeParameters(parameters);
+    const sorted = sortObjectKeys(normalized);
+    return `${tool}::${JSON.stringify(sorted)}`;
+}
+function normalizeParameters(params) {
+    if (typeof params !== "object" || params === null)
+        return params;
+    if (Array.isArray(params))
+        return params;
+    const normalized = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== null) {
+            normalized[key] = value;
+        }
+    }
+    return normalized;
+}
+function sortObjectKeys(obj) {
+    if (typeof obj !== "object" || obj === null)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(sortObjectKeys);
+    const sorted = {};
+    for (const key of Object.keys(obj).sort()) {
+        sorted[key] = sortObjectKeys(obj[key]);
+    }
+    return sorted;
+}
+//# sourceMappingURL=deduplication.js.map

package/dist/lib/strategies/deduplication.js.map

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

package/dist/lib/strategies/index.d.ts

@@ -0,0 +1,5 @@
+export { deduplicate } from "./deduplication";
+export { createDiscardTool, createExtractTool, createRestoreTool } from "./tools";
+export { supersedeWrites } from "./supersede-writes";
+export { purgeErrors } from "./purge-errors";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/lib/strategies/index.js

@@ -0,0 +1,5 @@
+export { deduplicate } from "./deduplication";
+export { createDiscardTool, createExtractTool, createRestoreTool } from "./tools";
+export { supersedeWrites } from "./supersede-writes";
+export { purgeErrors } from "./purge-errors";
+//# sourceMappingURL=index.js.map

package/dist/lib/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/strategies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA"}

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,IA8DF,CAAA"}

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

@@ -0,0 +1,62 @@
+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) {
+        const tokensSaved = calculateTokensSaved(state, messages, newPruneIds);
+        state.stats.totalPruneTokens += tokensSaved;
+        state.stats.strategyStats.purgeErrors.count += newPruneIds.length;
+        state.stats.strategyStats.purgeErrors.tokens += tokensSaved;
+        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,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;QACtE,KAAK,CAAC,KAAK,CAAC,gBAAgB,IAAI,WAAW,CAAA;QAC3C,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM,CAAA;QACjE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,MAAM,IAAI,WAAW,CAAA;QAC3D,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/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,IA0FF,CAAA"}

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

@@ -0,0 +1,90 @@
+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];
+        if (!id) {
+            continue;
+        }
+        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) {
+        const tokensSaved = calculateTokensSaved(state, messages, newPruneIds);
+        state.stats.totalPruneTokens += tokensSaved;
+        state.stats.strategyStats.supersedeWrites.count += newPruneIds.length;
+        state.stats.strategyStats.supersedeWrites.tokens += tokensSaved;
+        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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"}

package/dist/lib/strategies/tools.d.ts

@@ -0,0 +1,15 @@
+import { tool } from "@opencode-ai/plugin";
+import type { SessionState } from "../state";
+import type { PluginConfig } from "../config";
+import type { Logger } from "../logger";
+export interface PruneToolContext {
+    client: any;
+    state: SessionState;
+    logger: Logger;
+    config: PluginConfig;
+    workingDirectory: string;
+}
+export declare function createDiscardTool(ctx: PruneToolContext): ReturnType<typeof tool>;
+export declare function createExtractTool(ctx: PruneToolContext): ReturnType<typeof tool>;
+export declare function createRestoreTool(ctx: PruneToolContext): ReturnType<typeof tool>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/lib/strategies/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../lib/strategies/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,UAAU,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAK7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AASvC,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAoJD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAqFhF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CA4EhF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CA0EhF"}