@cleanslate/sdk 0.1.0

package/dist/services/cleanSlateVerificationTargetTracker.js

@@ -0,0 +1,214 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+/** Derives and refreshes browser verification obligations from changed UI paths and evidence. */
+export class CleanSlateVerificationTargetTracker {
+    register(existingTargets, paths, objective) {
+        const derivedTargets = this.derive(paths, objective);
+        if (derivedTargets.length === 0) {
+            return { targets: existingTargets, changed: false };
+        }
+        const targets = [...existingTargets];
+        let changed = false;
+        for (const target of derivedTargets) {
+            const existingIndex = targets.findIndex(existing => existing.id === target.id);
+            if (existingIndex === -1) {
+                targets.push(target);
+                changed = true;
+                continue;
+            }
+            const existing = targets[existingIndex];
+            const nextTarget = {
+                ...existing,
+                description: target.description,
+                sourcePaths: this.mergeUniqueStrings(existing.sourcePaths, target.sourcePaths),
+                routeHints: this.mergeUniqueStrings(existing.routeHints, target.routeHints),
+                requiresRootTraversal: existing.requiresRootTraversal || target.requiresRootTraversal,
+                status: existing.status === 'verified' ? 'stale' : 'pending',
+                updatedAt: Date.now()
+            };
+            if (!this.areEqual(existing, nextTarget)) {
+                targets[existingIndex] = nextTarget;
+                changed = true;
+            }
+        }
+        return { targets, changed };
+    }
+    recordBrowserEvidence(existingTargets, entry) {
+        if (existingTargets.length === 0 || !['browser_snapshot', 'browser_screenshot'].includes(entry.toolName ?? '')) {
+            return { targets: existingTargets, changed: false };
+        }
+        const observedUrls = this.collectObservedBrowserUrls(entry);
+        if (observedUrls.length === 0) {
+            return { targets: existingTargets, changed: false };
+        }
+        const observedRoutePaths = new Set(observedUrls.map(url => this.normalizeUrlPath(url)).filter((path) => !!path));
+        const visitedRoot = observedRoutePaths.has('/');
+        const multiPageSweep = (entry.browserPageCount ?? 0) > 1 && observedRoutePaths.size > 1;
+        let changed = false;
+        const targets = existingTargets.map(target => {
+            if (target.status === 'verified') {
+                return target;
+            }
+            const matched = target.requiresRootTraversal
+                ? visitedRoot && multiPageSweep
+                : target.routeHints.some(route => observedRoutePaths.has(this.normalizeRouteHint(route) || route));
+            if (!matched) {
+                return target;
+            }
+            changed = true;
+            return { ...target, status: 'verified', lastVerifiedAt: Date.now(), lastVerifiedUrl: observedUrls[0] };
+        });
+        return { targets, changed };
+    }
+    normalize(value) {
+        if (!Array.isArray(value)) {
+            return [];
+        }
+        return value.flatMap(target => {
+            if (!target || typeof target !== 'object') {
+                return [];
+            }
+            const candidate = target;
+            const id = typeof candidate.id === 'string' ? candidate.id.trim() : '';
+            const description = typeof candidate.description === 'string' ? candidate.description.trim() : '';
+            const scope = candidate.scope === 'shared-ui' || candidate.scope === 'route' ? candidate.scope : undefined;
+            if (!id || !description || candidate.kind !== 'browser' || !scope) {
+                return [];
+            }
+            const status = candidate.status === 'verified' ? 'verified' : candidate.status === 'stale' ? 'stale' : 'pending';
+            return [{
+                    id,
+                    kind: 'browser',
+                    scope,
+                    description,
+                    sourcePaths: this.normalizePaths(candidate.sourcePaths),
+                    routeHints: Array.isArray(candidate.routeHints) ? candidate.routeHints.map(route => this.normalizeRouteHint(typeof route === 'string' ? route : '')).filter((route) => !!route) : [],
+                    requiresRootTraversal: candidate.requiresRootTraversal !== false,
+                    status,
+                    updatedAt: typeof candidate.updatedAt === 'number' && Number.isFinite(candidate.updatedAt) ? candidate.updatedAt : Date.now(),
+                    lastVerifiedAt: typeof candidate.lastVerifiedAt === 'number' && Number.isFinite(candidate.lastVerifiedAt) ? candidate.lastVerifiedAt : undefined,
+                    lastVerifiedUrl: typeof candidate.lastVerifiedUrl === 'string' && candidate.lastVerifiedUrl.trim() ? candidate.lastVerifiedUrl.trim() : undefined
+                }];
+        });
+    }
+    derive(paths, objective) {
+        const uiPaths = this.normalizePaths(paths).filter(path => this.isLikelyUiPath(path));
+        if (uiPaths.length === 0) {
+            return [];
+        }
+        const sharedPaths = [];
+        const routeTargets = new Map();
+        for (const path of uiPaths) {
+            const routeHint = !this.isSharedUiPath(path) ? this.deriveRouteHintForPath(path) : undefined;
+            if (!routeHint) {
+                sharedPaths.push(path);
+                continue;
+            }
+            routeTargets.set(routeHint, [...(routeTargets.get(routeHint) ?? []), path]);
+        }
+        const objectiveText = typeof objective === 'string' && objective.trim() ? objective.trim() : 'the current UI change';
+        const targets = [];
+        if (sharedPaths.length > 0) {
+            targets.push({ id: 'browser:shared-ui', kind: 'browser', scope: 'shared-ui', description: `Re-open the app entrypoint and verify all affected shared surfaces for ${objectiveText}.`, sourcePaths: this.mergeUniqueStrings([], sharedPaths), routeHints: ['/'], requiresRootTraversal: true, status: 'pending', updatedAt: Date.now() });
+        }
+        for (const [routeHint, sourcePaths] of routeTargets) {
+            targets.push({ id: `browser:route:${routeHint}`, kind: 'browser', scope: 'route', description: `Verify the route ${routeHint} after the latest UI edits.`, sourcePaths: this.mergeUniqueStrings([], sourcePaths), routeHints: [routeHint], requiresRootTraversal: false, status: 'pending', updatedAt: Date.now() });
+        }
+        return targets;
+    }
+    collectObservedBrowserUrls(entry) {
+        const urls = [];
+        const add = (value) => { if (typeof value === 'string' && value.trim() && !urls.includes(value.trim())) {
+            urls.push(value.trim());
+        } };
+        add(entry.url);
+        if (entry.result && typeof entry.result === 'object') {
+            const record = entry.result;
+            add(record.url);
+            if (Array.isArray(record.pages)) {
+                for (const page of record.pages) {
+                    if (page && typeof page === 'object') {
+                        add(page.url);
+                    }
+                }
+            }
+        }
+        return urls;
+    }
+    normalizePaths(paths) {
+        if (!Array.isArray(paths)) {
+            return [];
+        }
+        return this.mergeUniqueStrings([], paths.flatMap(path => typeof path === 'string' && path.trim() ? [path.trim().replace(/\\/g, '/')] : []));
+    }
+    isLikelyUiPath(path) {
+        const normalized = path.toLowerCase();
+        return ['.css', '.scss', '.sass', '.less', '.styl', '.pcss', '.html', '.tsx', '.jsx', '.vue', '.svelte'].some(extension => normalized.endsWith(extension))
+            || ['/components/', '/app/', '/pages/', '/ui/'].some(segment => normalized.includes(segment));
+    }
+    isSharedUiPath(path) {
+        const normalized = path.toLowerCase();
+        const basename = normalized.split('/').pop() || normalized;
+        return ['globals.css', 'global.css', 'layout.tsx', 'layout.jsx', 'layout.ts', 'layout.js'].includes(basename)
+            || ['header.', 'footer.', 'nav.', 'navbar.', 'menu.', 'theme.'].some(prefix => basename.startsWith(prefix))
+            || ['/components/header.', '/components/footer.', '/components/nav', '/components/menu.'].some(segment => normalized.includes(segment));
+    }
+    deriveRouteHintForPath(path) {
+        const lower = path.toLowerCase();
+        const appIndex = lower.indexOf('/app/');
+        if (appIndex !== -1) {
+            const parts = path.slice(appIndex + 5).split('/').filter(Boolean);
+            const pageIndex = parts.findIndex(part => /^page\.(tsx|jsx|ts|js|mdx)$/i.test(part));
+            if (pageIndex !== -1) {
+                return this.normalizeRouteHint(`/${parts.slice(0, pageIndex).filter(segment => !segment.startsWith('(') && !segment.startsWith('@')).join('/')}`);
+            }
+        }
+        const pagesIndex = lower.indexOf('/pages/');
+        if (pagesIndex === -1) {
+            return undefined;
+        }
+        const parts = path.slice(pagesIndex + 7).split('/').filter(Boolean);
+        if (parts.length === 0) {
+            return undefined;
+        }
+        const stem = parts.pop().split('.')[0];
+        if (stem.toLowerCase() !== 'index') {
+            parts.push(stem);
+        }
+        return this.normalizeRouteHint(`/${parts.join('/')}`);
+    }
+    normalizeRouteHint(route) {
+        const normalized = route.trim().replace(/\\/g, '/');
+        if (!normalized) {
+            return undefined;
+        }
+        if (normalized === '/') {
+            return '/';
+        }
+        const trimmed = normalized.replace(/\/+/g, '/').replace(/\/$/, '');
+        return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    }
+    normalizeUrlPath(url) {
+        try {
+            return this.normalizeRouteHint(new URL(url).pathname || '/');
+        }
+        catch {
+            return this.normalizeRouteHint(url);
+        }
+    }
+    mergeUniqueStrings(existing, incoming) {
+        const seen = new Set();
+        return [...existing, ...incoming].filter(value => { const key = value.trim().toLowerCase(); if (!key || seen.has(key)) {
+            return false;
+        } seen.add(key); return true; }).map(value => value.trim());
+    }
+    areEqual(left, right) {
+        return left.id === right.id && left.kind === right.kind && left.scope === right.scope && left.description === right.description
+            && left.requiresRootTraversal === right.requiresRootTraversal && left.status === right.status && left.lastVerifiedAt === right.lastVerifiedAt
+            && left.lastVerifiedUrl === right.lastVerifiedUrl && this.arraysEqual(left.sourcePaths, right.sourcePaths) && this.arraysEqual(left.routeHints, right.routeHints);
+    }
+    arraysEqual(left, right) { return left.length === right.length && left.every((value, index) => value === right[index]); }
+}
+//# sourceMappingURL=cleanSlateVerificationTargetTracker.js.map

package/dist/services/cleanSlateVerificationTargetTracker.js.map

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

package/dist/skills/cleanSlateSkillCatalog.d.ts

@@ -0,0 +1,29 @@
+export type CleanSlateCapabilityStatus = 'available' | 'available_when_mcp_configured' | 'partial' | 'requires_provider' | 'requires_runtime' | 'requires_product_runtime';
+export interface CleanSlateMcpToolSummary {
+    name: string;
+    serverName?: string;
+}
+export interface CleanSlateSkillDescriptor {
+    id: string;
+    referenceName: string;
+    title: string;
+    status: CleanSlateCapabilityStatus;
+    productionReady: boolean;
+    description: string;
+    entryPoints: string[];
+    requirements: string[];
+    notes: string[];
+}
+export interface CleanSlateMcpCapabilityDescriptor {
+    id: string;
+    serverName: string;
+    status: 'available' | 'not_configured';
+    productionReady: boolean;
+    expectedToolPrefixes: string[];
+    detectedTools: string[];
+    description: string;
+    requirements: string[];
+}
+export declare function getCleanSlateSkillCatalog(mcpTools?: readonly CleanSlateMcpToolSummary[]): CleanSlateSkillDescriptor[];
+export declare function getCleanSlateMcpCapabilityCatalog(mcpTools?: readonly CleanSlateMcpToolSummary[]): CleanSlateMcpCapabilityDescriptor[];
+//# sourceMappingURL=cleanSlateSkillCatalog.d.ts.map

package/dist/skills/cleanSlateSkillCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateSkillCatalog.d.ts","sourceRoot":"","sources":["../../src/skills/cleanSlateSkillCatalog.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,0BAA0B,GACnC,WAAW,GACX,+BAA+B,GAC/B,SAAS,GACT,mBAAmB,GACnB,kBAAkB,GAClB,0BAA0B,CAAC;AAE9B,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,0BAA0B,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,iCAAiC;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAKD,wBAAgB,yBAAyB,CAAC,QAAQ,GAAE,SAAS,wBAAwB,EAAO,GAAG,yBAAyB,EAAE,CAqLzH;AAED,wBAAgB,iCAAiC,CAAC,QAAQ,GAAE,SAAS,wBAAwB,EAAO,GAAG,iCAAiC,EAAE,CAiBzI"}

package/dist/skills/cleanSlateSkillCatalog.js

@@ -0,0 +1,225 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+const NODE_REPL_TOOL_PREFIXES = ['mcp__node_repl__'];
+const COMPUTER_USE_TOOL_PREFIXES = ['mcp__computer_use__', 'mcp__computer-use__'];
+export function getCleanSlateSkillCatalog(mcpTools = []) {
+    const computerUseAvailable = hasAnyMcpToolWithPrefix(mcpTools, COMPUTER_USE_TOOL_PREFIXES);
+    return [
+        {
+            id: 'imagegen',
+            referenceName: 'imagegen',
+            title: 'Image Generation',
+            status: 'requires_provider',
+            productionReady: false,
+            description: 'Generate or edit raster images, mockups, textures, sprites, and transparent cutouts.',
+            entryPoints: [],
+            requirements: [
+                'A CleanSlate image-generation provider/tool contract',
+                'API key and safety handling for image creation/editing',
+                'Artifact storage and preview UI for generated bitmap outputs'
+            ],
+            notes: ['Not MCP by itself; this needs a provider-backed image tool.']
+        },
+        {
+            id: 'official-docs',
+            referenceName: 'official-docs',
+            title: 'Official Docs Research',
+            status: 'partial',
+            productionReady: true,
+            description: 'Answer product, API, SDK, framework, or platform questions using current official documentation.',
+            entryPoints: ['web_search', 'web_fetch'],
+            requirements: [
+                'Restrict searches/fetches to the official domains for the technology being discussed',
+                'Cite fetched documentation when answering current or version-sensitive questions'
+            ],
+            notes: ['CleanSlate has web retrieval; dedicated documentation MCP connectors can be added later for richer doc search.']
+        },
+        {
+            id: 'plugin-creator',
+            referenceName: 'plugin-creator',
+            title: 'Plugin Creator',
+            status: 'requires_product_runtime',
+            productionReady: false,
+            description: 'Create CleanSlate plugin directories, manifests, and marketplace metadata.',
+            entryPoints: [],
+            requirements: [
+                'A CleanSlate plugin manifest schema',
+                'Plugin install/cache directories',
+                'Marketplace or local-plugin registration UI'
+            ],
+            notes: ['CleanSlate does not yet have its own plugin marketplace/runtime equivalent.']
+        },
+        {
+            id: 'skill-creator',
+            referenceName: 'skill-creator',
+            title: 'Skill Creator',
+            status: 'requires_product_runtime',
+            productionReady: false,
+            description: 'Create and maintain local SKILL.md instruction packs.',
+            entryPoints: [],
+            requirements: [
+                'A CleanSlate skill file location',
+                'Skill discovery/loading rules',
+                'Prompt injection and trust controls for skill instructions'
+            ],
+            notes: ['This catalog is the first stable product surface for that runtime.']
+        },
+        {
+            id: 'skill-installer',
+            referenceName: 'skill-installer',
+            title: 'Skill Installer',
+            status: 'requires_product_runtime',
+            productionReady: false,
+            description: 'Install curated or repository-hosted skills into the local skill directory.',
+            entryPoints: [],
+            requirements: [
+                'A trusted skill source policy',
+                'Install/update/remove workflows',
+                'Manifest validation before a skill is loaded into prompts'
+            ],
+            notes: ['Installer work should come after the CleanSlate skill runtime is defined.']
+        },
+        {
+            id: 'browser',
+            referenceName: 'browser:browser',
+            title: 'Browser Automation',
+            status: 'available',
+            productionReady: true,
+            description: 'Operate and verify the live integrated browser with semantic locators, tabs, diagnostics, screenshots, uploads, and native input.',
+            entryPoints: [
+                'browser_open',
+                'browser_snapshot',
+                'browser_click',
+                'browser_hover',
+                'browser_fill',
+                'browser_check',
+                'browser_select',
+                'browser_upload',
+                'browser_type',
+                'browser_key',
+                'browser_scroll',
+                'browser_screenshot',
+                'browser_diagnostics',
+                'browser_dialog',
+                'browser_clipboard',
+                'browser_tabs',
+                'browser_new_tab',
+                'browser_select_tab',
+                'browser_close_tab'
+            ],
+            requirements: [],
+            notes: ['Already wired as native CleanSlate browser tools.']
+        },
+        {
+            id: 'computer-use',
+            referenceName: 'computer-use:computer-use',
+            title: 'Computer Use',
+            status: computerUseAvailable ? 'available' : 'available_when_mcp_configured',
+            productionReady: computerUseAvailable,
+            description: 'Control local desktop apps through MCP-backed computer-use actions.',
+            entryPoints: computerUseAvailable ? detectedToolNames(mcpTools, COMPUTER_USE_TOOL_PREFIXES) : [],
+            requirements: computerUseAvailable ? [] : ['Bundle or configure a CleanSlate-owned computer-use MCP server.'],
+            notes: ['When available, desktop-control actions are callable internally by the agent.']
+        },
+        {
+            id: 'documents',
+            referenceName: 'documents:documents',
+            title: 'Documents',
+            status: 'requires_runtime',
+            productionReady: false,
+            description: 'Create, edit, redline, render, and verify DOCX/Google Docs-targeted documents.',
+            entryPoints: [],
+            requirements: [
+                'A bundled document runtime',
+                'DOCX rendering/visual verification',
+                'Document artifact export and preview UI'
+            ],
+            notes: ['Not solved by MCP alone; this is a document artifact runtime.']
+        },
+        {
+            id: 'pdf',
+            referenceName: 'pdf',
+            title: 'PDF',
+            status: 'requires_runtime',
+            productionReady: false,
+            description: 'Read, create, render, and visually verify PDF artifacts.',
+            entryPoints: [],
+            requirements: [
+                'A bundled PDF generation/extraction runtime',
+                'Page rendering for visual QA',
+                'PDF artifact export and preview UI'
+            ],
+            notes: ['Generic file tools are not enough for production PDF handling.']
+        },
+        {
+            id: 'presentations',
+            referenceName: 'presentations:Presentations',
+            title: 'Presentations',
+            status: 'requires_runtime',
+            productionReady: false,
+            description: 'Build, render, verify, and export PowerPoint/Google Slides-targeted decks.',
+            entryPoints: [],
+            requirements: [
+                'A bundled presentation runtime',
+                'Slide rendering/visual verification',
+                'PPTX artifact export and preview UI'
+            ],
+            notes: ['Native Google Slides also needs a Google Drive/Slides connector after local deck creation.']
+        },
+        {
+            id: 'spreadsheets',
+            referenceName: 'spreadsheets:Spreadsheets',
+            title: 'Spreadsheets',
+            status: 'requires_runtime',
+            productionReady: false,
+            description: 'Create, edit, analyze, render, verify, and export XLSX/CSV/Google Sheets-targeted workbooks.',
+            entryPoints: [],
+            requirements: [
+                'A bundled spreadsheet runtime',
+                'Formula recalculation and rendered workbook verification',
+                'Google Drive/Sheets MCP for native Google Sheets import/edit workflows'
+            ],
+            notes: ['For a real Google Sheet link, CleanSlate still needs the Google Drive/Sheets connector.']
+        }
+    ];
+}
+export function getCleanSlateMcpCapabilityCatalog(mcpTools = []) {
+    return [
+        createMcpCapability({
+            id: 'node_repl',
+            serverName: 'node_repl',
+            expectedToolPrefixes: NODE_REPL_TOOL_PREFIXES,
+            description: 'Run JavaScript through a configured Node REPL MCP server.',
+            requirements: ['Configure the node_repl MCP server in CleanSlate native MCP, CleanSlate settings, or a CleanSlate plugin root.']
+        }, mcpTools),
+        createMcpCapability({
+            id: 'computer_use',
+            serverName: 'computer-use',
+            expectedToolPrefixes: COMPUTER_USE_TOOL_PREFIXES,
+            description: 'Control local Mac apps through configured desktop-control MCP actions.',
+            requirements: ['Bundle or configure the computer-use MCP server under CleanSlate native MCP, CleanSlate settings, or a CleanSlate plugin root.']
+        }, mcpTools)
+    ];
+}
+function createMcpCapability(descriptor, mcpTools) {
+    const detectedTools = detectedToolNames(mcpTools, descriptor.expectedToolPrefixes);
+    const productionReady = detectedTools.length > 0;
+    return {
+        ...descriptor,
+        status: productionReady ? 'available' : 'not_configured',
+        productionReady,
+        detectedTools
+    };
+}
+function hasAnyMcpToolWithPrefix(mcpTools, prefixes) {
+    return detectedToolNames(mcpTools, prefixes).length > 0;
+}
+function detectedToolNames(mcpTools, prefixes) {
+    return mcpTools
+        .map(tool => tool.name)
+        .filter(toolName => prefixes.some(prefix => toolName.startsWith(prefix)))
+        .sort();
+}
+//# sourceMappingURL=cleanSlateSkillCatalog.js.map

package/dist/skills/cleanSlateSkillCatalog.js.map

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

package/dist/tools/ApplyEditTool.d.ts

@@ -0,0 +1,73 @@
+import { CleanSlateReadFileState, CleanSlateTool, CleanSlateToolContext } from './types.js';
+import { URI } from '../core/uri.js';
+import { ISlateTextModel } from '../host/textModel.js';
+import { CleanSlatePlannedEdit, CleanSlateStructuredEdit } from '../services/cleanSlateEditService.js';
+export interface ApplyEditInput {
+    file_path?: string;
+    old_string?: string;
+    new_string?: string;
+    replace_all?: boolean;
+    /** Internal compatibility shape for sessions created before the edit-contract migration. */
+    path?: string;
+    edits?: CleanSlateStructuredEdit[];
+    expectedVersionId?: number;
+    /** Internal attribution used when another mutation tool delegates to this engine. */
+    historyOperation?: string;
+    historyToolName?: string;
+}
+/**
+ * Tool: apply_edit
+ */
+export declare const applyEditTool: CleanSlateTool;
+export declare function normalizeApplyEditRequest(input: ApplyEditInput, currentContent: string): {
+    ok: true;
+    edits: CleanSlateStructuredEdit[];
+} | {
+    ok: false;
+    result: any;
+};
+export declare function validateReadBeforeEdit(uri: URI, currentVersionId: number, input: ApplyEditInput, context: CleanSlateToolContext, currentContent?: string): Promise<{
+    ok: true;
+    readState: CleanSlateReadFileState;
+} | {
+    ok: false;
+    result: any;
+}>;
+export declare function getFileMtime(uri: URI, context: CleanSlateToolContext): Promise<number | undefined>;
+export declare function validateFreshReplaceRangeAnchors(path: string, currentVersionId: number, currentContent: string, edits: CleanSlateStructuredEdit[], readState: CleanSlateReadFileState): {
+    ok: true;
+} | {
+    ok: false;
+    result: any;
+};
+export declare function resolveSafeExpectedVersionId(model: ISlateTextModel, input: {
+    expectedVersionId?: number;
+}, readState: CleanSlateReadFileState, edits: CleanSlateStructuredEdit[], path: string): {
+    ok: true;
+    expectedVersionId: number;
+    adjustedFrom?: number;
+} | {
+    ok: false;
+    result: any;
+};
+export type CleanSlateRewriteClassification = 'surgical' | 'large_rewrite';
+export interface CleanSlateRewriteAssessment {
+    path: string;
+    classification: CleanSlateRewriteClassification;
+    fileLineCount: number;
+    replacedLines: number;
+    addedLines: number;
+    netLineDelta: number;
+    largestReplacedBlock: number;
+    largestAddedBlock: number;
+    replacesMostOfFile: boolean;
+    message: string;
+}
+export declare function assessRewriteScope(model: ISlateTextModel, edits: CleanSlatePlannedEdit[], path: string): CleanSlateRewriteAssessment;
+export declare function validateSourceCodeRangeEditBudget(model: ISlateTextModel, edits: CleanSlateStructuredEdit[] | undefined, path: string): {
+    ok: true;
+} | {
+    ok: false;
+    result: any;
+};
+//# sourceMappingURL=ApplyEditTool.d.ts.map

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

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