@tarquinen/opencode-dcp 0.2.8 → 0.3.1

package/dist/lib/deduplicator.js

@@ -0,0 +1,181 @@
+/**
+ * Deduplicator Module
+ *
+ * Handles automatic detection and removal of duplicate tool calls based on
+ * tool name + parameter signature matching.
+ */
+/**
+ * Detects duplicate tool calls based on tool name + parameter signature
+ * Keeps only the most recent occurrence of each duplicate set
+ * Respects protected tools - they are never deduplicated
+ */
+export function detectDuplicates(toolMetadata, unprunedToolCallIds, // In chronological order
+protectedTools) {
+    const signatureMap = new Map();
+    // Filter out protected tools before processing
+    const deduplicatableIds = unprunedToolCallIds.filter(id => {
+        const metadata = toolMetadata.get(id);
+        return !metadata || !protectedTools.includes(metadata.tool);
+    });
+    // Build map of signature -> [ids in chronological order]
+    for (const id of deduplicatableIds) {
+        const metadata = toolMetadata.get(id);
+        if (!metadata)
+            continue;
+        const signature = createToolSignature(metadata.tool, metadata.parameters);
+        if (!signatureMap.has(signature)) {
+            signatureMap.set(signature, []);
+        }
+        signatureMap.get(signature).push(id);
+    }
+    // Identify duplicates (keep only last occurrence)
+    const duplicateIds = [];
+    const deduplicationDetails = new Map();
+    for (const [signature, ids] of signatureMap.entries()) {
+        if (ids.length > 1) {
+            const metadata = toolMetadata.get(ids[0]);
+            const idsToRemove = ids.slice(0, -1); // All except last
+            duplicateIds.push(...idsToRemove);
+            deduplicationDetails.set(signature, {
+                toolName: metadata.tool,
+                parameterKey: extractParameterKey(metadata),
+                duplicateCount: ids.length,
+                prunedIds: idsToRemove,
+                keptId: ids[ids.length - 1]
+            });
+        }
+    }
+    return { duplicateIds, deduplicationDetails };
+}
+/**
+ * Creates a deterministic signature for a tool call
+ * Format: "toolName::JSON(sortedParameters)"
+ */
+function createToolSignature(tool, parameters) {
+    if (!parameters)
+        return tool;
+    // Normalize parameters for consistent comparison
+    const normalized = normalizeParameters(parameters);
+    const sorted = sortObjectKeys(normalized);
+    return `${tool}::${JSON.stringify(sorted)}`;
+}
+/**
+ * Normalize parameters to handle edge cases:
+ * - Remove undefined/null values
+ * - Resolve relative paths to absolute (future enhancement)
+ * - Sort arrays if order doesn't matter (future enhancement)
+ */
+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;
+}
+/**
+ * Recursively sort object keys for deterministic comparison
+ */
+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;
+}
+/**
+ * Extract human-readable parameter key for notifications
+ * Supports all ACTIVE OpenCode tools with appropriate parameter extraction
+ *
+ * ACTIVE Tools (always available):
+ * - File: read, write, edit
+ * - Search: list, glob, grep
+ * - Execution: bash
+ * - Agent: task
+ * - Web: webfetch
+ * - Todo: todowrite, todoread
+ *
+ * CONDITIONAL Tools (may be disabled):
+ * - batch (experimental.batch_tool flag)
+ * - websearch, codesearch (OPENCODE_EXPERIMENTAL_EXA flag)
+ *
+ * INACTIVE Tools (exist but not registered, skip):
+ * - multiedit, patch, lsp_diagnostics, lsp_hover
+ */
+export function extractParameterKey(metadata) {
+    if (!metadata.parameters)
+        return '';
+    const { tool, parameters } = metadata;
+    // ===== File Operation Tools =====
+    if (tool === "read" && parameters.filePath) {
+        return parameters.filePath;
+    }
+    if (tool === "write" && parameters.filePath) {
+        return parameters.filePath;
+    }
+    if (tool === "edit" && parameters.filePath) {
+        return parameters.filePath;
+    }
+    // ===== Directory/Search Tools =====
+    if (tool === "list" && parameters.path) {
+        return parameters.path;
+    }
+    if (tool === "glob" && parameters.pattern) {
+        const pathInfo = parameters.path ? ` in ${parameters.path}` : "";
+        return `"${parameters.pattern}"${pathInfo}`;
+    }
+    if (tool === "grep" && parameters.pattern) {
+        const pathInfo = parameters.path ? ` in ${parameters.path}` : "";
+        return `"${parameters.pattern}"${pathInfo}`;
+    }
+    // ===== Execution Tools =====
+    if (tool === "bash") {
+        if (parameters.description)
+            return parameters.description;
+        if (parameters.command) {
+            return parameters.command.length > 50
+                ? parameters.command.substring(0, 50) + "..."
+                : parameters.command;
+        }
+    }
+    // ===== Web Tools =====
+    if (tool === "webfetch" && parameters.url) {
+        return parameters.url;
+    }
+    if (tool === "websearch" && parameters.query) {
+        return `"${parameters.query}"`;
+    }
+    if (tool === "codesearch" && parameters.query) {
+        return `"${parameters.query}"`;
+    }
+    // ===== Todo Tools =====
+    // Note: Todo tools are stateful and in protectedTools by default
+    if (tool === "todowrite") {
+        return `${parameters.todos?.length || 0} todos`;
+    }
+    if (tool === "todoread") {
+        return "read todo list";
+    }
+    // ===== Agent/Task Tools =====
+    // Note: task is in protectedTools by default
+    if (tool === "task" && parameters.description) {
+        return parameters.description;
+    }
+    // Note: batch is experimental and needs special handling
+    if (tool === "batch") {
+        return `${parameters.tool_calls?.length || 0} parallel tools`;
+    }
+    // ===== Fallback =====
+    // For unknown tools, custom tools, or tools without extractable keys
+    return JSON.stringify(parameters).substring(0, 50);
+}
+//# sourceMappingURL=deduplicator.js.map

package/dist/lib/deduplicator.js.map

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

package/dist/lib/janitor.d.ts

@@ -9,15 +9,44 @@ export declare class Janitor {
     private modelCache;
     private configModel?;
     private showModelErrorToasts;
+    private pruningMode;
     constructor(client: any, stateManager: StateManager, logger: Logger, toolParametersCache: Map<string, any>, protectedTools: string[], modelCache: Map<string, {
         providerID: string;
         modelID: string;
     }>, configModel?: string | undefined, // Format: "provider/model"
-    showModelErrorToasts?: boolean);
+    showModelErrorToasts?: boolean, // Whether to show toast for model errors
+    pruningMode?: "auto" | "smart");
     /**
      * Sends an ignored message to the session UI (user sees it, AI doesn't)
      */
     private sendIgnoredMessage;
     run(sessionID: string): Promise<void>;
+    /**
+     * Helper function to shorten paths for display
+     */
+    private shortenPath;
+    /**
+     * Replace pruned tool outputs with placeholder text to save tokens in janitor context
+     * This applies the same replacement logic as the global fetch wrapper, but for the
+     * janitor's shadow inference to avoid sending already-pruned content to the LLM
+     */
+    private replacePrunedToolOutputs;
+    /**
+     * Helper function to calculate token savings from tool outputs
+     */
+    private calculateTokensSaved;
+    /**
+     * Build a summary of tools by grouping them
+     * Uses shared extractParameterKey logic for consistent parameter extraction
+     */
+    private buildToolsSummary;
+    /**
+     * Auto mode notification - shows only deduplication results
+     */
+    private sendAutoModeNotification;
+    /**
+     * Smart mode notification - shows both deduplication and LLM analysis results
+     */
+    private sendSmartModeNotification;
 }
 //# sourceMappingURL=janitor.d.ts.map

package/dist/lib/janitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"janitor.d.ts","sourceRoot":"","sources":["../../lib/janitor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAK3C,qBAAa,OAAO;IAEZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,oBAAoB;gBAPpB,MAAM,EAAE,GAAG,EACX,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EACrC,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAChE,WAAW,CAAC,EAAE,MAAM,YAAA,EAAE,2BAA2B;IACjD,oBAAoB,GAAE,OAAc;IAGhD;;OAEG;YACW,kBAAkB;IA4B1B,GAAG,CAAC,SAAS,EAAE,MAAM;CAid9B"}
+{"version":3,"file":"janitor.d.ts","sourceRoot":"","sources":["../../lib/janitor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAM3C,qBAAa,OAAO;IAEZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,oBAAoB;IAC5B,OAAO,CAAC,WAAW;gBARX,MAAM,EAAE,GAAG,EACX,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EACrC,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAChE,WAAW,CAAC,EAAE,MAAM,YAAA,EAAE,2BAA2B;IACjD,oBAAoB,GAAE,OAAc,EAAE,yCAAyC;IAC/E,WAAW,GAAE,MAAM,GAAG,OAAiB;IAGnD;;OAEG;YACW,kBAAkB;IA4B1B,GAAG,CAAC,SAAS,EAAE,MAAM;IAoa3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA8BhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;YACW,wBAAwB;IA+CtC;;OAEG;YACW,yBAAyB;CAyE1C"}