@cleanslate/sdk 0.1.0

package/dist/tools/FileHistoryRewindTool.js

@@ -0,0 +1,45 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { CleanSlateFileHistory } from '../services/cleanSlateFileHistory.js';
+import { resolvePathToUri } from './utils.js';
+import { URI } from '../core/uri.js';
+export const fileHistoryRewindTool = {
+    name: 'file_history_rewind',
+    description: 'Restore a file from the hidden CleanSlate file history snapshot captured immediately before an agent edit. Input: { path?: string, historyEntryId?: string }.',
+    category: 'edit',
+    parametersSchema: {
+        path: 'string - Optional file path to rewind. If omitted, historyEntryId must be provided.',
+        historyEntryId: 'string - Optional exact CleanSlate file history entry id to restore.'
+    },
+    async run(input, context) {
+        if (!input.path && !input.historyEntryId) {
+            throw new Error('file_history_rewind requires either "path" or "historyEntryId".');
+        }
+        const resource = input.path
+            ? resolvePathToUri(input.path, context, { allowWorkspaceRootRelativeAbsolute: false })
+            : undefined;
+        const workspaceRoot = resource
+            ? context.workspaceContextService.getWorkspaceFolder(resource)?.uri
+            : context.workspaceContextService.getWorkspace().folders[0]?.uri;
+        const workspaceId = context.workspaceContextService.getWorkspace().id;
+        const storageRoot = context.environmentService ? URI.joinPath(context.environmentService.workspaceStorageHome, workspaceId) : undefined;
+        const result = await CleanSlateFileHistory.rewind({
+            workspaceRoot,
+            storageRoot,
+            resource,
+            historyEntryId: input.historyEntryId,
+            fileService: context.fileService,
+            modelService: context.modelService,
+            textFileService: context.textFileService
+        });
+        return {
+            success: result.success,
+            path: resource?.fsPath ?? result.entry?.path,
+            historyEntryId: result.entry?.id,
+            message: result.message
+        };
+    }
+};
+//# sourceMappingURL=FileHistoryRewindTool.js.map

package/dist/tools/FileHistoryRewindTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileHistoryRewindTool.js","sourceRoot":"","sources":["../../src/tools/FileHistoryRewindTool.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACpD,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,+JAA+J;IAC5K,QAAQ,EAAE,MAAM;IAChB,gBAAgB,EAAE;QACjB,IAAI,EAAE,qFAAqF;QAC3F,cAAc,EAAE,sEAAsE;KACtF;IACD,KAAK,CAAC,GAAG,CAAC,KAAiD,EAAE,OAA8B;QAC1F,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI;YAC1B,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,kCAAkC,EAAE,KAAK,EAAE,CAAC;YACtF,CAAC,CAAC,SAAS,CAAC;QACb,MAAM,aAAa,GAAG,QAAQ;YAC7B,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,GAAG;YACnE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QAClE,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;QACtE,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxI,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC;YACjD,aAAa;YACb,WAAW;YACX,QAAQ;YACR,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,eAAe,EAAE,OAAO,CAAC,eAAe;SACxC,CAAC,CAAC;QAEH,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,IAAI;YAC5C,cAAc,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE;YAChC,OAAO,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC;IACH,CAAC;CACD,CAAC"}

package/dist/tools/FindByNameTool.d.ts

@@ -0,0 +1,6 @@
+import { CleanSlateTool } from './types.js';
+/**
+ * Tool: find_by_name
+ */
+export declare const findByNameTool: CleanSlateTool;
+//# sourceMappingURL=FindByNameTool.d.ts.map

package/dist/tools/FindByNameTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindByNameTool.d.ts","sourceRoot":"","sources":["../../src/tools/FindByNameTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAGnE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAuE5B,CAAC"}

package/dist/tools/FindByNameTool.js

@@ -0,0 +1,80 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { resolvePathToUri } from './utils.js';
+/**
+ * Tool: find_by_name
+ */
+export const findByNameTool = {
+    name: 'find_by_name',
+    description: 'Finds files by matching their name against a pattern (simple includes). Input: { pattern: string, path?: string }. Also accepts alias { name } for compatibility. Returns: Array<string>',
+    category: "discovery",
+    parametersSchema: {
+        pattern: "string",
+        path: "string - Optional workspace-relative or absolute in-workspace directory/file scope",
+        name: "string - Alias for pattern"
+    },
+    async run(input, context) {
+        const pattern = input.pattern ?? input.name;
+        if (!pattern)
+            throw new Error('find_by_name requires a "pattern" parameter');
+        // Simple implementation: search workspace for matches
+        // We will scan the workspace folders and return files that include the pattern in their name.
+        const results = [];
+        const folders = context.workspaceContextService.getWorkspace().folders;
+        // Max depth is configurable via config (defaults to 10 — covers deep monorepo structures)
+        const maxDepth = Number.isFinite(context.configService.getConfiguration().findMaxDepth)
+            ? Math.max(1, Math.floor(context.configService.getConfiguration().findMaxDepth))
+            : 10;
+        // Helper to crawl directory
+        const crawl = async (uri, depth) => {
+            if (depth > maxDepth)
+                return; // Configurable depth limit
+            try {
+                const stat = await context.fileService.resolve(uri);
+                if (stat.children) {
+                    for (const child of stat.children) {
+                        if (child.isDirectory) {
+                            await crawl(child.resource, depth + 1);
+                        }
+                        else {
+                            // Support for wildcards
+                            const regexPattern = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&') // escape regex chars
+                                .replace(/\*/g, '.*'); // convert * to .*
+                            const regex = new RegExp(`^${regexPattern}$`, 'i');
+                            if (regex.test(child.name) || child.name.toLowerCase().includes(pattern.replace(/\*/g, '').toLowerCase())) {
+                                results.push(child.resource.fsPath);
+                            }
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                // Ignore access errors
+            }
+        };
+        const scopedPath = input.path?.trim();
+        if (scopedPath) {
+            try {
+                const scopedUri = resolvePathToUri(scopedPath, context);
+                const stat = await context.fileService.resolve(scopedUri);
+                if (stat.isDirectory) {
+                    await crawl(scopedUri, 0);
+                }
+                else if (stat.name && (stat.name.toLowerCase().includes(pattern.replace(/\*/g, '').toLowerCase()) || new RegExp(`^${pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*')}$`, 'i').test(stat.name))) {
+                    results.push(scopedUri.fsPath);
+                }
+                return results;
+            }
+            catch {
+                // Fall back to full workspace search if the scoped path could not be resolved.
+            }
+        }
+        for (const folder of folders) {
+            await crawl(folder.uri, 0);
+        }
+        return results;
+    }
+};
+//# sourceMappingURL=FindByNameTool.js.map

package/dist/tools/FindByNameTool.js.map

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

package/dist/tools/FindReferencesTool.d.ts

@@ -0,0 +1,3 @@
+import { CleanSlateTool } from './types.js';
+export declare const findReferencesTool: CleanSlateTool;
+//# sourceMappingURL=FindReferencesTool.d.ts.map

package/dist/tools/FindReferencesTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindReferencesTool.d.ts","sourceRoot":"","sources":["../../src/tools/FindReferencesTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAKnE,eAAO,MAAM,kBAAkB,EAAE,cAuGhC,CAAC"}

package/dist/tools/FindReferencesTool.js

@@ -0,0 +1,128 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { Position } from '../core/position.js';
+import { resolvePathToUri } from './utils.js';
+import { fireReferenceProvider, resolveBackgroundLanguageFeatureModel } from './languageFeatureActivation.js';
+import { cancellationTokenFromAbortSignal } from '../services/cleanSlateCancellation.js';
+export const findReferencesTool = {
+    name: 'find_references',
+    description: 'Find all references for the symbol at a given path/line/column. Use this to map blast radius before edits.',
+    parametersSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Path to the file relative to the workspace root.' },
+            line: { type: 'number', description: 'Line number (1-indexed).' },
+            column: { type: 'number', description: 'Column number (1-indexed).' },
+            includeDeclaration: { type: 'boolean', description: 'Whether to include the symbol declaration in results. Defaults to false.' }
+        },
+        required: ['path', 'line', 'column']
+    },
+    category: 'discovery',
+    async run(input, context) {
+        if (!input.path || typeof input.path !== 'string') {
+            return {
+                success: false,
+                code: 'invalid_input',
+                message: 'The "path" argument is required and must be a non-empty string.',
+                recoveryHint: 'Specify the relative path to the file you want to find references in.'
+            };
+        }
+        if (!context.languageFeaturesService && !context.commandService) {
+            return { success: false, message: 'Language features command and provider services are not available.' };
+        }
+        const line = Number.isFinite(input.line) ? Math.max(1, Math.floor(input.line)) : Math.max(1, Math.floor(Number(input.line) || 1));
+        const column = Number.isFinite(input.column) ? Math.max(1, Math.floor(input.column)) : Math.max(1, Math.floor(Number(input.column) || 1));
+        const includeDeclaration = input.includeDeclaration === true;
+        const position = new Position(line, column);
+        const uri = resolvePathToUri(input.path, context);
+        const firedReferences = await fireReferenceProvider(uri, position, context);
+        const model = await resolveBackgroundLanguageFeatureModel(uri, context);
+        if (!model) {
+            const references = dedupeLocations(firedReferences);
+            return {
+                success: true,
+                path: input.path,
+                line,
+                column,
+                includeDeclaration,
+                count: references.length,
+                references,
+                message: references.length > 0
+                    ? 'References returned from the background language-feature command without opening a visible editor model.'
+                    : 'No model was loaded after background LSP activation.'
+            };
+        }
+        // 2. Wait for providers to register
+        let providers = context.languageFeaturesService?.referenceProvider.ordered(model) ?? [];
+        if (providers.length === 0) {
+            for (let i = 0; i < 10; i++) {
+                await new Promise(resolve => setTimeout(resolve, 200));
+                providers = context.languageFeaturesService?.referenceProvider.ordered(model) ?? [];
+                if (providers.length > 0)
+                    break;
+            }
+        }
+        if (providers.length === 0) {
+            const references = dedupeLocations(firedReferences);
+            return {
+                success: true,
+                path: input.path,
+                line,
+                column,
+                includeDeclaration,
+                count: references.length,
+                references,
+                message: references.length > 0
+                    ? 'References returned from the background language-feature command.'
+                    : 'No reference providers found for this file type.'
+            };
+        }
+        const allReferences = Array.isArray(firedReferences) ? [...firedReferences] : [];
+        const token = cancellationTokenFromAbortSignal(context.signal);
+        for (const provider of providers) {
+            const result = await provider.provideReferences(model, position, { includeDeclaration }, token);
+            if (Array.isArray(result) && result.length > 0) {
+                allReferences.push(...result);
+            }
+        }
+        const references = dedupeLocations(allReferences);
+        return {
+            success: true,
+            path: input.path,
+            line,
+            column,
+            includeDeclaration,
+            count: references.length,
+            references
+        };
+    }
+};
+function dedupeLocations(locations) {
+    if (!Array.isArray(locations)) {
+        return [];
+    }
+    const deduped = new Map();
+    for (const reference of locations) {
+        const refUri = reference?.uri?.toString?.() ?? reference?.targetUri?.toString?.();
+        const range = reference?.range ?? reference?.targetRange;
+        if (!refUri || !range) {
+            continue;
+        }
+        const key = `${refUri}:${range.startLineNumber}:${range.startColumn}:${range.endLineNumber}:${range.endColumn}`;
+        if (!deduped.has(key)) {
+            deduped.set(key, {
+                uri: refUri,
+                range: {
+                    startLine: range.startLineNumber,
+                    startColumn: range.startColumn,
+                    endLine: range.endLineNumber,
+                    endColumn: range.endColumn
+                }
+            });
+        }
+    }
+    return Array.from(deduped.values());
+}
+//# sourceMappingURL=FindReferencesTool.js.map

package/dist/tools/FindReferencesTool.js.map

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

package/dist/tools/GetDefinitionsTool.d.ts

@@ -0,0 +1,3 @@
+import { CleanSlateTool } from './types.js';
+export declare const getDefinitionsTool: CleanSlateTool;
+//# sourceMappingURL=GetDefinitionsTool.d.ts.map

package/dist/tools/GetDefinitionsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetDefinitionsTool.d.ts","sourceRoot":"","sources":["../../src/tools/GetDefinitionsTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAOnE,eAAO,MAAM,kBAAkB,EAAE,cA2GhC,CAAC"}

package/dist/tools/GetDefinitionsTool.js

@@ -0,0 +1,136 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { resolvePathToUri } from './utils.js';
+import { Position } from '../core/position.js';
+import { buildSymbolContext, getOwnerHierarchyForLine } from './symbolContext.js';
+import { fireDefinitionProvider, resolveBackgroundLanguageFeatureModel } from './languageFeatureActivation.js';
+import { cancellationTokenFromAbortSignal } from '../services/cleanSlateCancellation.js';
+export const getDefinitionsTool = {
+    name: 'get_definitions',
+    description: 'Find the definition(s) of a symbol at a specific line and column. Essential for understanding types and cross-file signatures.',
+    parametersSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Path to the file relative to the workspace root.' },
+            line: { type: 'number', description: 'Line number (1-indexed).' },
+            column: { type: 'number', description: 'Column number (1-indexed).' }
+        },
+        required: ['path', 'line', 'column']
+    },
+    async run(input, context) {
+        if (!input.path || typeof input.path !== 'string') {
+            return {
+                success: false,
+                code: 'invalid_input',
+                message: 'The "path" argument is required and must be a non-empty string.',
+                recoveryHint: 'Specify the relative path to the file you want to get definitions for.'
+            };
+        }
+        if (!context.languageFeaturesService && !context.commandService) {
+            return { success: false, message: 'Language features command and provider services are not available.' };
+        }
+        const uri = resolvePathToUri(input.path, context);
+        const line = Number.isFinite(input.line) ? Math.max(1, Math.floor(input.line)) : Math.max(1, Math.floor(Number(input.line) || 1));
+        const column = Number.isFinite(input.column) ? Math.max(1, Math.floor(input.column)) : Math.max(1, Math.floor(Number(input.column) || 1));
+        const position = new Position(line, column);
+        // 1. Fire the language server in the background before checking providers.
+        const firedDefinitions = await fireDefinitionProvider(uri, position, context);
+        const model = await resolveBackgroundLanguageFeatureModel(uri, context);
+        if (!model) {
+            return {
+                success: true,
+                path: input.path,
+                line,
+                column,
+                ownerHierarchy: [],
+                definitions: formatLocations(firedDefinitions),
+                message: 'Definitions returned from the background language-feature command without opening a visible editor model.'
+            };
+        }
+        // 2. Wait for providers to register
+        let providers = context.languageFeaturesService?.definitionProvider.ordered(model) ?? [];
+        if (providers.length === 0) {
+            for (let i = 0; i < 10; i++) {
+                await new Promise(resolve => setTimeout(resolve, 200));
+                providers = context.languageFeaturesService?.definitionProvider.ordered(model) ?? [];
+                if (providers.length > 0)
+                    break;
+            }
+        }
+        if (providers.length === 0) {
+            const commandDefinitions = formatLocations(firedDefinitions);
+            return {
+                success: true,
+                path: input.path,
+                line,
+                column,
+                ownerHierarchy: [],
+                definitions: commandDefinitions,
+                message: commandDefinitions.length > 0
+                    ? 'Definitions returned from the background language-feature command.'
+                    : 'No definition providers found for this file type.'
+            };
+        }
+        const allDefinitions = Array.isArray(firedDefinitions) ? [...firedDefinitions] : [];
+        const token = cancellationTokenFromAbortSignal(context.signal);
+        for (const provider of providers) {
+            const result = await provider.provideDefinition(model, position, token);
+            if (result) {
+                if (Array.isArray(result)) {
+                    allDefinitions.push(...result);
+                }
+                else {
+                    allDefinitions.push(result);
+                }
+            }
+        }
+        const documentSymbols = [];
+        for (const provider of context.languageFeaturesService?.documentSymbolProvider.ordered(model) ?? []) {
+            const symbols = await provider.provideDocumentSymbols(model, token);
+            if (symbols) {
+                documentSymbols.push(...symbols);
+            }
+        }
+        const symbolContext = buildSymbolContext(documentSymbols, model.getLineCount());
+        const ownerHierarchy = getOwnerHierarchyForLine(line, symbolContext.symbols).map(owner => ({
+            name: owner.name,
+            kind: owner.kindLabel,
+            symbolPath: owner.path,
+            range: owner.range
+        }));
+        return {
+            success: true,
+            path: input.path,
+            line,
+            column,
+            ownerHierarchy,
+            definitions: formatLocations(allDefinitions)
+        };
+    }
+};
+function formatLocations(locations) {
+    if (!Array.isArray(locations)) {
+        return [];
+    }
+    return locations
+        .map((location) => {
+        const uri = location?.uri?.toString?.() ?? location?.targetUri?.toString?.();
+        const range = location?.range ?? location?.targetRange;
+        if (!uri || !range) {
+            return undefined;
+        }
+        return {
+            uri,
+            range: {
+                startLine: range.startLineNumber,
+                startColumn: range.startColumn,
+                endLine: range.endLineNumber,
+                endColumn: range.endColumn
+            }
+        };
+    })
+        .filter((location) => !!location);
+}
+//# sourceMappingURL=GetDefinitionsTool.js.map

package/dist/tools/GetDefinitionsTool.js.map

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

package/dist/tools/GetOpenFilesTool.d.ts

@@ -0,0 +1,6 @@
+import { CleanSlateTool } from './types.js';
+/**
+ * Tool: get_open_files
+ */
+export declare const getOpenFilesTool: CleanSlateTool;
+//# sourceMappingURL=GetOpenFilesTool.d.ts.map

package/dist/tools/GetOpenFilesTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetOpenFilesTool.d.ts","sourceRoot":"","sources":["../../src/tools/GetOpenFilesTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAY9B,CAAC"}

package/dist/tools/GetOpenFilesTool.js

@@ -0,0 +1,21 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+/**
+ * Tool: get_open_files
+ */
+export const getOpenFilesTool = {
+    name: 'get_open_files',
+    description: 'Returns list of open files. No input required.',
+    category: "context",
+    parametersSchema: {},
+    async run(_input, context) {
+        const ctx = await context.contextService.getContext();
+        const openFilePaths = ctx.openFiles.map(file => file.uri.fsPath);
+        return {
+            files: [ctx.activeFile?.uri.fsPath, ...openFilePaths].filter((path) => typeof path === 'string' && path.length > 0)
+        };
+    }
+};
+//# sourceMappingURL=GetOpenFilesTool.js.map

package/dist/tools/GetOpenFilesTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetOpenFilesTool.js","sourceRoot":"","sources":["../../src/tools/GetOpenFilesTool.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAIhG;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC5C,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,gDAAgD;IAC7D,QAAQ,EAAE,SAAS;IACnB,gBAAgB,EAAE,EAAE;IACpB,KAAK,CAAC,GAAG,CAAC,MAAW,EAAE,OAA8B;QACjD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QACtD,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjE,OAAO;YACH,KAAK,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACtI,CAAC;IACN,CAAC;CACJ,CAAC"}

package/dist/tools/GrepSearchTool.d.ts

@@ -0,0 +1,7 @@
+import { CleanSlateTool } from './types.js';
+/**
+ * Tool: grep_search
+ * Real exact/case-sensitive text search powered by the active host's native search adapter.
+ */
+export declare const grepSearchTool: CleanSlateTool;
+//# sourceMappingURL=GrepSearchTool.d.ts.map

package/dist/tools/GrepSearchTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrepSearchTool.d.ts","sourceRoot":"","sources":["../../src/tools/GrepSearchTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAKnE;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,cAuF5B,CAAC"}

package/dist/tools/GrepSearchTool.js

@@ -0,0 +1,95 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { isFileMatch, resultIsMatch } from '../host/workspace.js';
+import { resolvePathToUri } from './utils.js';
+import { isStaleGeneratedDiagnosticPath } from './cleanSlateStaleDiagnosticPolicy.js';
+/**
+ * Tool: grep_search
+ * Real exact/case-sensitive text search powered by the active host's native search adapter.
+ */
+export const grepSearchTool = {
+    name: 'grep_search',
+    description: 'Searches for exact text matches across workspace files. Input: { query: string, path?: string, caseSensitive?: boolean, isRegex?: boolean }. Also accepts alias { pattern, SearchPath }. Returns matches with line numbers.',
+    category: "discovery",
+    parametersSchema: {
+        query: "string",
+        path: "string - Optional workspace-relative or absolute in-workspace file/directory scope",
+        pattern: "string - Alias for query",
+        SearchPath: "string - Alias for path",
+        caseSensitive: "boolean (default: false)",
+        isRegex: "boolean (default: false)"
+    },
+    async run(input, context) {
+        const query = input.query ?? input.pattern;
+        const { caseSensitive = false, isRegex = false } = input;
+        if (!query)
+            throw new Error('grep_search requires a "query" parameter');
+        if (!context.searchService) {
+            return [{ system_warning: 'grep_search failed: searchService unavailable in this runtime.' }];
+        }
+        const workspaceFolders = context.workspaceContextService.getWorkspace().folders;
+        if (workspaceFolders.length === 0) {
+            return []; // No workspace, no search
+        }
+        const normalizedScope = (() => {
+            const requestedScope = input.path?.trim() || input.SearchPath?.trim();
+            if (!requestedScope) {
+                return undefined;
+            }
+            try {
+                return resolvePathToUri(requestedScope, context).fsPath.replace(/\\/g, '/').toLowerCase();
+            }
+            catch {
+                return undefined;
+            }
+        })();
+        const resultsMap = new Map();
+        try {
+            await context.searchService.textSearch({
+                type: 2, // QueryType.Text
+                contentPattern: {
+                    pattern: query,
+                    isCaseSensitive: caseSensitive,
+                    isRegExp: isRegex,
+                    isWordMatch: false
+                },
+                folderQueries: workspaceFolders.map((f) => ({ folder: f.uri })),
+                surroundingContext: 0
+            }, undefined, (progress) => {
+                if (isFileMatch(progress)) {
+                    const resourcePath = progress.resource.fsPath;
+                    const normalizedResourcePath = resourcePath.replace(/\\/g, '/').toLowerCase();
+                    if (normalizedScope && !(normalizedResourcePath === normalizedScope || normalizedResourcePath.startsWith(`${normalizedScope}/`))) {
+                        return;
+                    }
+                    if (!resultsMap.has(resourcePath)) {
+                        resultsMap.set(resourcePath, []);
+                    }
+                    if (progress.results) {
+                        for (const result of progress.results) {
+                            if (resultIsMatch(result)) {
+                                resultsMap.get(resourcePath).push({
+                                    line: result.rangeLocations[0].source.startLineNumber,
+                                    text: result.previewText.trim()
+                                });
+                            }
+                        }
+                    }
+                }
+            });
+            const results = [];
+            for (const [path, matches] of resultsMap.entries()) {
+                if (matches.length > 0 && !isStaleGeneratedDiagnosticPath(path)) {
+                    results.push({ path, matches });
+                }
+            }
+            return results;
+        }
+        catch (e) {
+            return [{ system_warning: `grep_search failed: ${String(e?.message || e)}` }];
+        }
+    }
+};
+//# sourceMappingURL=GrepSearchTool.js.map

package/dist/tools/GrepSearchTool.js.map

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

package/dist/tools/ListDirTool.d.ts

@@ -0,0 +1,6 @@
+import { CleanSlateTool } from './types.js';
+/**
+ * Tool: list_dir
+ */
+export declare const listDirTool: CleanSlateTool;
+//# sourceMappingURL=ListDirTool.d.ts.map

package/dist/tools/ListDirTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListDirTool.d.ts","sourceRoot":"","sources":["../../src/tools/ListDirTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAGnE;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,cA4BzB,CAAC"}