@cleanslate/sdk 0.1.0

package/dist/tools/symbolIndex.js

@@ -0,0 +1,235 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { Range } from '../core/range.js';
+import { symbolKindToNodeType } from './symbolContext.js';
+import { fireDocumentSymbolProvider } from './languageFeatureActivation.js';
+import { cancellationTokenFromAbortSignal } from '../services/cleanSlateCancellation.js';
+export async function buildCleanSlateSymbolIndex(model, context) {
+    const lspCandidates = await collectLanguageFeatureCandidates(model, context);
+    const treeSitterCandidates = await collectTreeSitterCandidates(model, context);
+    const entries = deduplicateCandidates([...lspCandidates, ...treeSitterCandidates]);
+    console.info(`[CleanSlateEdit] symbol_index: ${entries.length} symbol(s), ${lspCandidates.length} from LSP, ${treeSitterCandidates.length} from Tree-sitter.`);
+    return {
+        entries,
+        lspEntryCount: lspCandidates.length,
+        treeSitterEntryCount: treeSitterCandidates.length
+    };
+}
+async function collectLanguageFeatureCandidates(model, context) {
+    if (!context.languageFeaturesService && !context.commandService) {
+        return [];
+    }
+    const candidates = [];
+    const token = cancellationTokenFromAbortSignal(context.signal);
+    const firedSymbols = await fireDocumentSymbolProvider(model.uri, context);
+    if (Array.isArray(firedSymbols) && firedSymbols.length > 0) {
+        console.info(`[CleanSlateEdit] symbol_index: LSP command returned ${firedSymbols.length} document symbol(s) for ${model.uri.fsPath}.`);
+        collectSymbolCandidates(firedSymbols, [], candidates);
+    }
+    // Retry loop for symbol providers after explicitly firing the language server.
+    let providers = context.languageFeaturesService?.documentSymbolProvider.ordered(model) ?? [];
+    let retries = 0;
+    while (providers.length === 0 && retries < 4) {
+        console.info(`[CleanSlateEdit] symbol_index: No provider yet for ${model.uri.fsPath} after LSP fire. Waiting 500ms (retry ${retries + 1}/4)...`);
+        await new Promise(resolve => setTimeout(resolve, 500));
+        providers = context.languageFeaturesService?.documentSymbolProvider.ordered(model) ?? [];
+        retries++;
+    }
+    if (providers.length === 0) {
+        return candidates;
+    }
+    for (const provider of providers) {
+        // LSP enrichment is best-effort and must NEVER abort the edit: the
+        // provider round-trips to the extension host, and a freshly resolved
+        // headless model may not have synced there yet — extHostDocuments then
+        // throws "Unable to retrieve document from URI". An uncaught rejection
+        // here used to fail the whole apply_edit; the canonicalizer has a full
+        // range/string fallback pipeline, so a failed provider is only a lost
+        // enhancement.
+        let symbols;
+        try {
+            symbols = await provider.provideDocumentSymbols(model, token);
+            // Optional: second retry level for actual results if the provider exists but is silent
+            if (!symbols || symbols.length === 0) {
+                await new Promise(resolve => setTimeout(resolve, 300));
+                symbols = await provider.provideDocumentSymbols(model, token);
+            }
+        }
+        catch (error) {
+            console.info(`[CleanSlateEdit] symbol_index: provider failed for ${model.uri.fsPath} (continuing without it): ${String(error)}`);
+            continue;
+        }
+        if (symbols) {
+            collectSymbolCandidates(symbols, [], candidates);
+        }
+    }
+    return candidates;
+}
+function collectSymbolCandidates(symbols, parentPath, candidates) {
+    for (const symbol of symbols) {
+        if (!symbol?.range || !symbol?.selectionRange || typeof symbol.name !== 'string') {
+            continue;
+        }
+        const range = Range.lift(symbol.range);
+        const selectionRange = Range.lift(symbol.selectionRange);
+        if (!range || !selectionRange) {
+            continue;
+        }
+        const currentPath = [...parentPath, symbol.name];
+        candidates.push({
+            name: symbol.name,
+            path: currentPath,
+            range,
+            selectionRange,
+            source: 'lsp',
+            nodeType: symbolKindToNodeType(symbol.kind)
+        });
+        if (Array.isArray(symbol.children)) {
+            collectSymbolCandidates(symbol.children, currentPath, candidates);
+        }
+    }
+}
+async function collectTreeSitterCandidates(model, context) {
+    if (!context.treeSitterLibraryService) {
+        return [];
+    }
+    const languageId = model.getLanguageId();
+    if (!languageId) {
+        return [];
+    }
+    let parser;
+    let tree;
+    try {
+        const [ParserCtor, language] = await Promise.all([
+            context.treeSitterLibraryService.getParserClass(),
+            context.treeSitterLibraryService.getLanguagePromise(languageId)
+        ]);
+        if (!language) {
+            return [];
+        }
+        parser = new ParserCtor();
+        parser.setLanguage(language);
+        tree = parser.parse(model.getValue());
+        if (!tree) {
+            return [];
+        }
+        const candidates = [];
+        const stack = [{
+                node: tree.rootNode,
+                ownerPath: []
+            }];
+        while (stack.length > 0) {
+            const { node, ownerPath } = stack.pop();
+            const declarationName = extractDeclarationName(node);
+            const isStructuralDeclaration = declarationName !== undefined && isLikelyStructuralDeclaration(node);
+            const nextOwnerPath = isStructuralDeclaration ? [...ownerPath, declarationName] : ownerPath;
+            if (isStructuralDeclaration) {
+                const nodeRange = toRange(node);
+                candidates.push({
+                    name: declarationName,
+                    path: nextOwnerPath,
+                    range: nodeRange,
+                    selectionRange: toRange(findNameNode(node) ?? node),
+                    source: 'tree_sitter',
+                    nodeType: node.type
+                });
+            }
+            for (let childIndex = node.namedChildren.length - 1; childIndex >= 0; childIndex--) {
+                const child = node.namedChildren[childIndex];
+                if (child) {
+                    stack.push({ node: child, ownerPath: nextOwnerPath });
+                }
+            }
+        }
+        return candidates;
+    }
+    catch {
+        return [];
+    }
+    finally {
+        tree?.delete();
+        parser?.delete();
+    }
+}
+function deduplicateCandidates(candidates) {
+    const deduplicated = new Map();
+    for (const candidate of candidates) {
+        const key = [
+            candidate.name,
+            candidate.path.join('>'),
+            candidate.selectionRange.startLineNumber,
+            candidate.selectionRange.startColumn,
+            candidate.selectionRange.endLineNumber,
+            candidate.selectionRange.endColumn
+        ].join(':');
+        if (!deduplicated.has(key) || candidate.source === 'tree_sitter') {
+            deduplicated.set(key, candidate);
+        }
+    }
+    return Array.from(deduplicated.values());
+}
+function extractDeclarationName(node) {
+    const explicitNameNode = findNameNode(node);
+    const explicitName = normalizeDeclarationName(explicitNameNode?.text);
+    if (explicitName) {
+        return explicitName;
+    }
+    for (const child of node.namedChildren) {
+        if (!child) {
+            continue;
+        }
+        const childType = child.type.toLowerCase();
+        if (childType.includes('identifier') || childType.endsWith('name')) {
+            const childName = normalizeDeclarationName(child.text);
+            if (childName) {
+                return childName;
+            }
+        }
+    }
+    return undefined;
+}
+function findNameNode(node) {
+    const directNameNode = node.childForFieldName('name');
+    if (directNameNode) {
+        return directNameNode;
+    }
+    for (const wrapperField of ['declarator', 'declaration']) {
+        const wrapperNode = node.childForFieldName(wrapperField);
+        if (wrapperNode) {
+            const nestedNameNode = findNameNode(wrapperNode);
+            if (nestedNameNode) {
+                return nestedNameNode;
+            }
+        }
+    }
+    return undefined;
+}
+function normalizeDeclarationName(rawText) {
+    const normalized = rawText?.trim();
+    return normalized && /^[A-Za-z_$][\w$]*$/.test(normalized) ? normalized : undefined;
+}
+function isLikelyStructuralDeclaration(node) {
+    const normalizedType = node.type.toLowerCase();
+    if (normalizedType.includes('class')
+        || normalizedType.includes('function')
+        || normalizedType.includes('method')
+        || normalizedType.includes('constructor')
+        || normalizedType.includes('interface')
+        || normalizedType.includes('enum')
+        || normalizedType.includes('typedef')
+        || normalizedType.includes('alias')
+        || normalizedType.includes('struct')
+        || normalizedType.includes('trait')
+        || normalizedType.includes('component')
+        || normalizedType.includes('declaration')
+        || normalizedType.includes('definition')) {
+        return true;
+    }
+    return node.childForFieldName('body') !== null || node.childForFieldName('parameters') !== null;
+}
+function toRange(node) {
+    return new Range(node.startPosition.row + 1, node.startPosition.column + 1, node.endPosition.row + 1, node.endPosition.column + 1);
+}
+//# sourceMappingURL=symbolIndex.js.map

package/dist/tools/symbolIndex.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,108 @@
+import { IModelHost } from '../host/textModel.js';
+import { ITextFileHost } from '../host/textModel.js';
+import { IFileHost } from '../host/files.js';
+import { ICleanSlateIndexService, ICleanSlateConfigurationService, ICleanSlateContextService, ICleanSlateArtifactService, IMCPClientService, ICleanSlateMainService } from '../protocol/cleanSlateAI.js';
+import { ICleanSlateCommandExecutionService } from '../services/cleanSlateCommandExecutionService.js';
+import { IWorkspaceHost } from '../host/workspace.js';
+import { IMarkerHost } from '../host/diagnostics.js';
+import { ICleanSlateBulkEditHost, ICleanSlateEditorDecorationHost, ICleanSlateEditorRevealHost } from './cleanSlateHostTypes.js';
+import { IArtifactPresentationHost, IInstantiationHost } from '../host/services.js';
+import { IEditorOpenHost } from '../host/workspace.js';
+import { ISearchHost } from '../host/workspace.js';
+import { ILanguageFeaturesHost } from '../host/services.js';
+import { IUndoRedoHost } from '../host/workspace.js';
+import { ITreeSitterHost } from '../host/services.js';
+import { IEnvironmentHost } from '../host/workspace.js';
+import { ICommandHost } from '../host/workspace.js';
+import { ICleanSlateBrowserAutomationService } from '../host/browserAutomation.js';
+export type CleanSlateToolSurface = 'ide' | 'agentManager';
+export interface CleanSlateFileReadBudgetContext {
+    /** Resolved usable input window for the active provider/model. */
+    contextWindowTokens: number;
+    /** Estimated input tokens still available before adding the next tool result. */
+    availableInputTokens: number;
+}
+export interface CleanSlateToolContext {
+    surface: CleanSlateToolSurface;
+    sessionId?: string;
+    signal?: AbortSignal;
+    modelService: IModelHost;
+    codeEditorService: ICleanSlateEditorRevealHost;
+    textFileService: ITextFileHost;
+    fileService: IFileHost;
+    contextService: ICleanSlateContextService;
+    indexService: ICleanSlateIndexService;
+    workspaceContextService: IWorkspaceHost;
+    /**
+     * The IDE's currently-open workspace (distinct from `workspaceContextService`, which for an
+     * Agent Manager session is scoped to that session's own project). Used to decide whether a
+     * file/artifact belongs to the same project the IDE has open before revealing it in the editor.
+     * Defaults to `workspaceContextService` for the IDE surface, where the two are equivalent.
+     */
+    ideWorkspaceContextService?: IWorkspaceHost;
+    configService: ICleanSlateConfigurationService;
+    markerService: IMarkerHost;
+    artifactService: ICleanSlateArtifactService;
+    mcpClientService?: IMCPClientService;
+    cleanSlateMainService?: ICleanSlateMainService;
+    instantiationService: IInstantiationHost;
+    /** Shows a generated artifact. Absent on hosts with nowhere to show it. */
+    artifactPresentationHost?: IArtifactPresentationHost;
+    editorService: IEditorOpenHost;
+    commandExecutionService: ICleanSlateCommandExecutionService;
+    browserAutomationService: ICleanSlateBrowserAutomationService;
+    bulkEditService?: ICleanSlateBulkEditHost;
+    /** Inline diff decorations. Absent when nothing is on screen to decorate. */
+    editorDecorationHost?: ICleanSlateEditorDecorationHost;
+    searchService?: ISearchHost;
+    languageFeaturesService?: ILanguageFeaturesHost;
+    undoRedoService?: IUndoRedoHost;
+    treeSitterLibraryService?: ITreeSitterHost;
+    environmentService?: IEnvironmentHost;
+    commandService?: ICommandHost;
+    recentFocusLines?: Map<string, Set<number>>;
+    readFileState?: Map<string, CleanSlateReadFileState>;
+    fileReadBudget?: CleanSlateFileReadBudgetContext;
+    requestCommandApproval: (request: {
+        command: string;
+        cwd?: string;
+        reason?: string;
+        toolName?: string;
+        toolCallId?: string;
+    }) => Promise<boolean>;
+    onProgress?: (event: {
+        type: string;
+        [key: string]: any;
+    }) => void;
+}
+export interface CleanSlateReadFileState {
+    path: string;
+    uri: string;
+    content?: string;
+    currentVersionId?: number;
+    mtime?: number;
+    totalLines?: number;
+    isPartialView: boolean;
+    readAt: number;
+    ranges?: CleanSlateReadRangeEvidence[];
+}
+export interface CleanSlateReadRangeEvidence {
+    startLine: number;
+    endLine: number;
+    content: string;
+    currentVersionId?: number;
+    mtime?: number;
+    readAt: number;
+}
+/**
+ * Core tool interface for CleanSlate agent capabilities
+ */
+export interface CleanSlateTool {
+    name: string;
+    description: string;
+    parametersSchema?: Record<string, any>;
+    planningHint?: string;
+    category?: string;
+    run(input: any, context: CleanSlateToolContext): Promise<any>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/types.js

@@ -0,0 +1,6 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;gGAGgG"}

package/dist/tools/utils.d.ts

@@ -0,0 +1,56 @@
+import { URI } from '../core/uri.js';
+import { ISlateTextModel } from '../host/textModel.js';
+import { CleanSlateToolContext } from './types.js';
+export interface ResolvePathToUriOptions {
+    /**
+     * Legacy compatibility mode for model-provided root-like paths.
+     * When true, unresolved POSIX absolute paths are treated as workspace-relative to the first folder.
+     * Mutation tools should set this to false to avoid editing the wrong file silently.
+     */
+    allowWorkspaceRootRelativeAbsolute?: boolean;
+}
+export declare function getVirtualArtifactType(path: string): 'implementation_plan' | 'walkthrough' | 'analysis' | 'task' | undefined;
+export declare function isVirtualArtifactPath(path: string): boolean;
+/**
+ * Strip ANSI escape codes from a string
+ */
+export declare function stripAnsi(str: unknown): string;
+/**
+ * Resolves cwd for command execution: use workspace root when missing, validate model-provided paths,
+ * and fall back to the first workspace folder when the path is missing or not a directory (e.g. hallucinated `/workspace`).
+ */
+export declare function resolveCommandCwd(requested: string | undefined, context: CleanSlateToolContext): Promise<string | undefined>;
+/**
+ * Helper to resolve paths reliably across workspace folders
+ */
+export declare function resolvePathToUri(path: string, context: CleanSlateToolContext, options?: ResolvePathToUriOptions): URI;
+/**
+ * True when `uri` lives inside the workspace the IDE currently has open (i.e. same project as the
+ * editor), so revealing it in the IDE editor is appropriate. Used to gate editor reveals for real
+ * files created/edited by a tool. When no workspace context is available (e.g. in tests) it defaults
+ * to `true` to preserve the legacy always-reveal behavior.
+ */
+export declare function isUriInIdeWorkspace(context: CleanSlateToolContext, uri: URI): boolean;
+/**
+ * True when the session's project is the same project the IDE currently has open. Used for artifacts,
+ * whose virtual `cleanslate-artifact:` URIs are not part of any workspace folder and so can't be
+ * checked with `isUriInIdeWorkspace`. When no workspace context is available (e.g. in tests) it
+ * defaults to `true` to preserve the legacy always-open behavior.
+ */
+export declare function isSessionWorkspaceOpenInIde(context: CleanSlateToolContext): boolean;
+/**
+ * Materializes the text model for `uri` without opening a visible editor. Replaces `openEditor` calls
+ * that existed only to load a model as a side effect of revealing the file.
+ */
+export declare function resolveTextModelHeadless(uri: URI, context: CleanSlateToolContext): Promise<ISlateTextModel | null>;
+/**
+ * Finds the actual string in fileContent using a whitespace-agnostic regex.
+ * This is the ultimate fallback for when exact and quote-normalized matches fail.
+ */
+export declare function regexFindActualString(fileContent: string, searchString: string): string | null;
+/**
+ * Helper to identify documentation files that should skip interactive preview
+ */
+export declare function isDocumentationFile(path: string): boolean;
+export declare function shellEscapeSingleQuotes(value: string): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACpC;;;;OAIG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;CAChD;AAQD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAiB5H;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAM9C;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoBlI;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,GAAE,uBAA4B,GAAG,GAAG,CAqDzH;AAWD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAMrF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAgBnF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAGxH;AAUD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuB9F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/tools/utils.js

@@ -0,0 +1,205 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { URI } from '../core/uri.js';
+import { isEqualOrParent } from '../core/resources.js';
+import { CLEANSLATE_ARTIFACT_SCHEME } from '../protocol/cleanSlateAI.js';
+function artifactBasename(path) {
+    const normalized = path.replace(/\\/g, '/').toLowerCase();
+    const parts = normalized.split('/');
+    return parts[parts.length - 1] || normalized;
+}
+export function getVirtualArtifactType(path) {
+    const basename = artifactBasename(path);
+    if (basename === 'implementation_plan.md') {
+        return 'implementation_plan';
+    }
+    if (basename === 'walkthrough.md') {
+        return 'walkthrough';
+    }
+    if (basename === 'analysis.md') {
+        return 'analysis';
+    }
+    if (basename === 'task.md') {
+        return 'task';
+    }
+    return undefined;
+}
+export function isVirtualArtifactPath(path) {
+    return getVirtualArtifactType(path) !== undefined;
+}
+/**
+ * Strip ANSI escape codes from a string
+ */
+export function stripAnsi(str) {
+    if (typeof str !== 'string') {
+        return '';
+    }
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|(?:\u001b\u009b]|\u001b\]).*?(?:\u0007|\u001b\\)/g, '');
+}
+/**
+ * Resolves cwd for command execution: use workspace root when missing, validate model-provided paths,
+ * and fall back to the first workspace folder when the path is missing or not a directory (e.g. hallucinated `/workspace`).
+ */
+export async function resolveCommandCwd(requested, context) {
+    const folders = context.workspaceContextService.getWorkspace().folders;
+    const defaultRoot = folders[0]?.uri.fsPath;
+    const trimmed = requested?.trim();
+    if (!trimmed) {
+        return defaultRoot;
+    }
+    try {
+        const uri = URI.file(trimmed);
+        const stat = await context.fileService.stat(uri);
+        if (stat.isDirectory && context.workspaceContextService.getWorkspaceFolder(uri)) {
+            return trimmed;
+        }
+    }
+    catch {
+        // Path missing or inaccessible — use workspace root when available.
+    }
+    return defaultRoot;
+}
+/**
+ * Helper to resolve paths reliably across workspace folders
+ */
+export function resolvePathToUri(path, context, options = {}) {
+    if (typeof path !== 'string' || !path.trim()) {
+        throw new Error('Path must be a non-empty string.');
+    }
+    const requestedPath = path.trim();
+    const allowWorkspaceRootRelativeAbsolute = options.allowWorkspaceRootRelativeAbsolute ?? true;
+    // 1. Special check for virtual artifacts (must be first to avoid URI.file errors)
+    if (isVirtualArtifactPath(requestedPath)) {
+        const normalizedArtifactPath = requestedPath.replace(/^\/+/, '');
+        return URI.from({
+            scheme: CLEANSLATE_ARTIFACT_SCHEME,
+            path: `/${normalizedArtifactPath}`
+        });
+    }
+    const workspaceFolders = context.workspaceContextService.getWorkspace().folders;
+    const potentialUri = URI.file(requestedPath);
+    const matchingFolder = context.workspaceContextService.getWorkspaceFolder(potentialUri);
+    if (matchingFolder) {
+        return potentialUri;
+    }
+    if (workspaceFolders.length === 0) {
+        // No workspace: refuse to access arbitrary filesystem paths.
+        throw new Error('No workspace folders available; refusing to access filesystem paths');
+    }
+    const firstFolder = workspaceFolders[0];
+    const isWindowsAbsolutePath = /^[a-zA-Z]:[\\/]/.test(requestedPath);
+    const isPosixAbsolutePath = requestedPath.startsWith('/');
+    // Relative path - resolve against first workspace folder
+    if (!isPosixAbsolutePath && !isWindowsAbsolutePath) {
+        const resolved = firstFolder.toResource(requestedPath);
+        const resolvedFolder = context.workspaceContextService.getWorkspaceFolder(resolved);
+        if (!resolvedFolder) {
+            throw new Error(`Resolved path is outside the workspace: ${requestedPath}`);
+        }
+        return resolved;
+    }
+    // POSIX absolute path outside workspace.
+    // In compatibility mode, allow `/foo/bar` to map into the first workspace as `foo/bar`.
+    if (isPosixAbsolutePath && allowWorkspaceRootRelativeAbsolute) {
+        const relativePath = requestedPath.replace(/^\/+/, '');
+        const resolved = firstFolder.toResource(relativePath);
+        return resolved;
+    }
+    throw new Error(`Path is outside the workspace and cannot be resolved safely: ${requestedPath}`);
+}
+/**
+ * The IDE's currently-open workspace context. For an Agent Manager session, `workspaceContextService`
+ * is scoped to that session's own project, so `ideWorkspaceContextService` is the real IDE workspace.
+ * Falls back to the session context when unset so existing (reveal) behavior is preserved.
+ */
+function getIdeWorkspaceContextService(context) {
+    return context.ideWorkspaceContextService ?? context.workspaceContextService;
+}
+/**
+ * True when `uri` lives inside the workspace the IDE currently has open (i.e. same project as the
+ * editor), so revealing it in the IDE editor is appropriate. Used to gate editor reveals for real
+ * files created/edited by a tool. When no workspace context is available (e.g. in tests) it defaults
+ * to `true` to preserve the legacy always-reveal behavior.
+ */
+export function isUriInIdeWorkspace(context, uri) {
+    const ide = getIdeWorkspaceContextService(context);
+    if (!ide) {
+        return true;
+    }
+    return !!ide.getWorkspaceFolder(uri);
+}
+/**
+ * True when the session's project is the same project the IDE currently has open. Used for artifacts,
+ * whose virtual `cleanslate-artifact:` URIs are not part of any workspace folder and so can't be
+ * checked with `isUriInIdeWorkspace`. When no workspace context is available (e.g. in tests) it
+ * defaults to `true` to preserve the legacy always-open behavior.
+ */
+export function isSessionWorkspaceOpenInIde(context) {
+    const ide = getIdeWorkspaceContextService(context);
+    const session = context.workspaceContextService;
+    if (!ide || !session) {
+        return true;
+    }
+    const ideWorkspace = ide.getWorkspace();
+    const sessionWorkspace = session.getWorkspace();
+    const ideFolders = ideWorkspace.folders;
+    const sessionFolders = sessionWorkspace.folders;
+    if (sessionFolders.length === 0 || ideFolders.length === 0) {
+        return sessionWorkspace.id === ideWorkspace.id;
+    }
+    return sessionFolders.some(sessionFolder => ideFolders.some(ideFolder => isEqualOrParent(sessionFolder.uri, ideFolder.uri) || isEqualOrParent(ideFolder.uri, sessionFolder.uri)));
+}
+/**
+ * Materializes the text model for `uri` without opening a visible editor. Replaces `openEditor` calls
+ * that existed only to load a model as a side effect of revealing the file.
+ */
+export async function resolveTextModelHeadless(uri, context) {
+    await context.textFileService.files.resolve(uri);
+    return context.modelService.getModel(uri);
+}
+/**
+ * Escapes characters for use in a regular expression
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Finds the actual string in fileContent using a whitespace-agnostic regex.
+ * This is the ultimate fallback for when exact and quote-normalized matches fail.
+ */
+export function regexFindActualString(fileContent, searchString) {
+    // 1. Prepare search pattern
+    // Trim to avoid matching leading/trailing whitespace at start/end of block
+    const trimmedSearch = searchString.trim();
+    if (!trimmedSearch)
+        return null;
+    let pattern = escapeRegex(trimmedSearch);
+    // 2. Replace any whitespace sequence in the search string with a whitespace-agnostic regex segment
+    // This handles tabs, spaces, and variety of newlines
+    pattern = pattern.replace(/\s+/g, '[\\s\\r\\n]+');
+    try {
+        const regex = new RegExp(pattern, 'm');
+        const match = fileContent.match(regex);
+        if (match && match[0]) {
+            return match[0];
+        }
+    }
+    catch {
+        // Fallback for extremely large or complex regexes
+    }
+    return null;
+}
+/**
+ * Helper to identify documentation files that should skip interactive preview
+ */
+export function isDocumentationFile(path) {
+    return isVirtualArtifactPath(path);
+}
+export function shellEscapeSingleQuotes(value) {
+    // Wrap in single quotes and escape embedded single quotes: abc'def -> 'abc'"'"'def'
+    return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/tools/utils.js.map

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