@cleanslate/sdk 0.1.0

package/dist/tools/cleanSlateHostTypes.d.ts

@@ -0,0 +1,100 @@
+import { URI } from '../core/uri.js';
+/**
+ * Three capabilities the tools need from whatever is hosting them: apply a set
+ * of edits, run a terminal, and bring a file into view.
+ *
+ * They are declared here, structurally, rather than imported from the editor —
+ * those imports are `browser`-layer and would pin the tools to VS Code. The
+ * real services satisfy these shapes as they are, so the editor host needs no
+ * adapter; a headless host implements them over the filesystem and a child
+ * process, and leaves the reveal a no-op.
+ */
+/** A text model as the tools use it: somewhere a URI points. */
+export interface ICleanSlateHostTextModel {
+    uri: URI;
+}
+/** An open editor, reduced to the one question the tools ask of it. */
+export interface ICleanSlateHostCodeEditor {
+    getModel(): ICleanSlateHostTextModel | null;
+}
+/**
+ * Bringing a file into view. Purely presentational — a headless host
+ * implements this as a no-op and nothing downstream changes.
+ */
+export interface ICleanSlateEditorRevealHost {
+    getActiveCodeEditor(): ICleanSlateHostCodeEditor | null;
+    openCodeEditor(input: {
+        resource: URI;
+        options?: any;
+    }, source: ICleanSlateHostCodeEditor | null, sideBySide?: boolean): Promise<ICleanSlateHostCodeEditor | null>;
+}
+/** One edit as the decoration host renders it, before it was applied. */
+export interface ICleanSlateOriginalEditForDisplay {
+    range: {
+        startLineNumber: number;
+        startColumn: number;
+        endLineNumber: number;
+        endColumn: number;
+    };
+    text: string;
+    originalStartLine: number;
+}
+/**
+ * Inline accept/reject decorations over an applied edit. Entirely
+ * presentational: a headless host omits it and the edit still lands, which is
+ * why every member is safe to skip.
+ */
+export interface ICleanSlateEditorDecorationHost {
+    /**
+     * Show the post-apply diff for a file that is currently on screen. Does
+     * nothing when the file is not open.
+     */
+    showPostApply(uri: URI, edits: readonly any[], originalEdits: readonly ICleanSlateOriginalEditForDisplay[], beforeContent: string): void;
+    /** Track an applied edit so it can be reviewed or undone later. */
+    registerPostApplySession(uri: URI, edits: readonly any[], originalEdits: readonly ICleanSlateOriginalEditForDisplay[], beforeContent: string, initialInstruction?: string): void;
+    /** Reverse the last tracked edit. Returns false when there is nothing to undo. */
+    undoLastTrackedEdit(uri: URI): boolean;
+}
+/** Result of applying a batch of edits. */
+export interface ICleanSlateBulkEditResult {
+    isApplied: boolean;
+}
+/** A range as the edit descriptors carry it. */
+export interface ICleanSlateEditRange {
+    startLineNumber: number;
+    startColumn: number;
+    endLineNumber: number;
+    endColumn: number;
+}
+/**
+ * One text replacement, described rather than constructed.
+ *
+ * This is deliberately plain data. The editor's bulk-edit service dispatches on
+ * `instanceof ResourceTextEdit` (see `editor/browser/services/bulkEditService`
+ * and `contrib/bulkEdit/browser/bulkEditService`), so a copy of that class
+ * built outside the editor would be a *different* class: every `instanceof`
+ * would return false and the edits would be dropped with no error and no failed
+ * result. Constructing it is therefore the host's job, not the tool's.
+ */
+export interface ICleanSlateResourceTextEditDescriptor {
+    resource: URI;
+    range: ICleanSlateEditRange;
+    text: string;
+    /** Guards against applying to a model that moved on. */
+    versionId?: number;
+}
+/** Options a caller may pass alongside a batch. */
+export interface ICleanSlateBulkEditOptions {
+    label?: string;
+    respectAutoSaveConfig?: boolean;
+}
+/**
+ * Applying edits across files as one unit.
+ *
+ * Takes descriptors, not editor objects: the editor host turns them into real
+ * `ResourceTextEdit`s, and a headless host writes them straight to the models.
+ */
+export interface ICleanSlateBulkEditHost {
+    applyTextEdits(edits: readonly ICleanSlateResourceTextEditDescriptor[], options?: ICleanSlateBulkEditOptions): Promise<ICleanSlateBulkEditResult>;
+}
+//# sourceMappingURL=cleanSlateHostTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateHostTypes.d.ts","sourceRoot":"","sources":["../../src/tools/cleanSlateHostTypes.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC;;;;;;;;;GASG;AAEH,gEAAgE;AAChE,MAAM,WAAW,wBAAwB;IACxC,GAAG,EAAE,GAAG,CAAC;CACT;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACzC,QAAQ,IAAI,wBAAwB,GAAG,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC3C,mBAAmB,IAAI,yBAAyB,GAAG,IAAI,CAAC;IACxD,cAAc,CACb,KAAK,EAAE;QAAE,QAAQ,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,EACvC,MAAM,EAAE,yBAAyB,GAAG,IAAI,EACxC,UAAU,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;CAC7C;AAED,yEAAyE;AACzE,MAAM,WAAW,iCAAiC;IACjD,KAAK,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC/C;;;OAGG;IACH,aAAa,CACZ,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,SAAS,GAAG,EAAE,EACrB,aAAa,EAAE,SAAS,iCAAiC,EAAE,EAC3D,aAAa,EAAE,MAAM,GACnB,IAAI,CAAC;IAER,mEAAmE;IACnE,wBAAwB,CACvB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,SAAS,GAAG,EAAE,EACrB,aAAa,EAAE,SAAS,iCAAiC,EAAE,EAC3D,aAAa,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,GACzB,IAAI,CAAC;IAER,kFAAkF;IAClF,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;CACvC;AAED,2CAA2C;AAC3C,MAAM,WAAW,yBAAyB;IACzC,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qCAAqC;IACrD,QAAQ,EAAE,GAAG,CAAC;IACd,KAAK,EAAE,oBAAoB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,0BAA0B;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACvC,cAAc,CACb,KAAK,EAAE,SAAS,qCAAqC,EAAE,EACvD,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACtC"}

package/dist/tools/cleanSlateHostTypes.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=cleanSlateHostTypes.js.map

package/dist/tools/cleanSlateHostTypes.js.map

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

package/dist/tools/cleanSlatePlanArtifactPolicy.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Structural validation for submitted implementation plans.
+ *
+ * Planning is the discovery phase; execution implements. A plan whose entries
+ * defer discovery ("[MODIFY] screens subtree — identify the primary screens,
+ * then improve") pushes research into execution, which is exactly the failure
+ * the planning prompt forbids. The prompt alone proved insufficient — models
+ * submit vague plans when nothing checks them — so submit_artifact enforces
+ * the plan template structurally:
+ *
+ *  - hard failures (plan rejected, corrective message returned): no
+ *    [MODIFY]/[NEW] file entries at all, entries without a concrete file link,
+ *    or [MODIFY] targets that are directories or do not exist.
+ *  - soft warnings (plan accepted, warnings returned for self-correction):
+ *    deferred-discovery phrasing, [NEW] targets that already exist.
+ */
+export type CleanSlatePlanEntryKind = 'modify' | 'new';
+export interface ICleanSlatePlanFileEntry {
+    readonly kind: CleanSlatePlanEntryKind;
+    readonly label: string;
+    /** Link target as written (file:/// URI or plain path); undefined when the entry has no link. */
+    readonly target: string | undefined;
+    /** Body lines under the entry heading, used for phrasing checks. */
+    readonly body: string;
+}
+export interface ICleanSlatePlanValidationIssue {
+    readonly code: 'plan_missing_file_entries' | 'plan_entry_missing_file_link' | 'plan_modify_target_missing' | 'plan_modify_target_directory' | 'plan_deferred_discovery' | 'plan_new_target_exists';
+    readonly message: string;
+}
+export interface ICleanSlatePlanValidationResult {
+    readonly errors: ICleanSlatePlanValidationIssue[];
+    readonly warnings: ICleanSlatePlanValidationIssue[];
+}
+export declare function extractPlanFileEntries(content: string): ICleanSlatePlanFileEntry[];
+/** Converts a plan link target to a filesystem-ish path (decodes file:/// URIs). */
+export declare function planEntryTargetToPath(target: string): string;
+export interface ICleanSlatePlanTargetStat {
+    readonly exists: boolean;
+    readonly isDirectory: boolean;
+}
+/**
+ * Validates plan structure. `statTarget` resolves a link target to existence
+ * metadata; targets that cannot be resolved at all are treated as missing.
+ */
+export declare function validateImplementationPlanStructure(content: string, statTarget: (path: string) => Promise<ICleanSlatePlanTargetStat | undefined>): Promise<ICleanSlatePlanValidationResult>;
+export declare function formatPlanValidationRejection(result: ICleanSlatePlanValidationResult): string;
+//# sourceMappingURL=cleanSlatePlanArtifactPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlatePlanArtifactPolicy.d.ts","sourceRoot":"","sources":["../../src/tools/cleanSlatePlanArtifactPolicy.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,IAAI,EACX,2BAA2B,GAC3B,8BAA8B,GAC9B,4BAA4B,GAC5B,8BAA8B,GAC9B,yBAAyB,GACzB,wBAAwB,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,MAAM,EAAE,8BAA8B,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,EAAE,CAAC;CACpD;AAUD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,EAAE,CAiClF;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,mCAAmC,CACxD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,GAC1E,OAAO,CAAC,+BAA+B,CAAC,CA6D1C;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,+BAA+B,GAAG,MAAM,CAU7F"}

package/dist/tools/cleanSlatePlanArtifactPolicy.js

@@ -0,0 +1,126 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+const PLAN_ENTRY_WITH_LINK = /\[(MODIFY|NEW)\]\s*\[([^\]]*)\]\(([^)\s]+)\)/;
+const PLAN_ENTRY_ANY = /\[(MODIFY|NEW)\]/;
+const PLAN_HEADING = /^#{2,6}\s/;
+// Matches the observed failure mode: entry bodies that schedule discovery for
+// execution instead of naming the outcome of discovery already performed.
+const DEFERRED_DISCOVERY_PATTERN = /\b(?:identify|determine|locate|figure out|audit|investigate|explore)\b[^.\n]{0,60}\b(?:which|the\s+(?:relevant|primary|appropriate|right|correct)|files?|screens?|components?|modules?|targets?)\b/i;
+export function extractPlanFileEntries(content) {
+    const lines = content.split(/\r?\n/);
+    const entries = [];
+    let current;
+    for (const line of lines) {
+        const anyMatch = PLAN_ENTRY_ANY.exec(line);
+        if (anyMatch) {
+            const linked = PLAN_ENTRY_WITH_LINK.exec(line);
+            current = {
+                kind: (linked?.[1] ?? anyMatch[1]).toLowerCase() === 'new' ? 'new' : 'modify',
+                label: linked?.[2]?.trim() || line.replace(PLAN_ENTRY_ANY, '').trim().slice(0, 120),
+                target: linked?.[3],
+                bodyLines: []
+            };
+            entries.push(current);
+            continue;
+        }
+        if (current) {
+            if (PLAN_HEADING.test(line) && !PLAN_ENTRY_ANY.test(line)) {
+                current = undefined;
+                continue;
+            }
+            current.bodyLines.push(line);
+        }
+    }
+    return entries.map(entry => ({
+        kind: entry.kind,
+        label: entry.label,
+        target: entry.target,
+        body: entry.bodyLines.join('\n')
+    }));
+}
+/** Converts a plan link target to a filesystem-ish path (decodes file:/// URIs). */
+export function planEntryTargetToPath(target) {
+    if (/^file:\/\//i.test(target)) {
+        try {
+            return decodeURIComponent(target.replace(/^file:\/\/(?:localhost)?/i, ''));
+        }
+        catch {
+            return target.replace(/^file:\/\/(?:localhost)?/i, '');
+        }
+    }
+    return target;
+}
+/**
+ * Validates plan structure. `statTarget` resolves a link target to existence
+ * metadata; targets that cannot be resolved at all are treated as missing.
+ */
+export async function validateImplementationPlanStructure(content, statTarget) {
+    const errors = [];
+    const warnings = [];
+    const entries = extractPlanFileEntries(content);
+    if (entries.length === 0) {
+        errors.push({
+            code: 'plan_missing_file_entries',
+            message: 'The plan names no concrete files. Every proposed change needs a "#### [MODIFY] [basename](file:///absolute/path)" or "#### [NEW] ..." entry for an exact file.'
+        });
+        return { errors, warnings };
+    }
+    const MAX_STATTED_ENTRIES = 20;
+    let statted = 0;
+    for (const entry of entries) {
+        const entryName = entry.label || entry.target || '(unnamed entry)';
+        if (!entry.target) {
+            errors.push({
+                code: 'plan_entry_missing_file_link',
+                message: `Entry "${entryName}" has no file link. Use "[${entry.kind.toUpperCase()}] [basename](file:///absolute/path/to/file)" with the exact file discovered during planning.`
+            });
+            continue;
+        }
+        if (DEFERRED_DISCOVERY_PATTERN.test(entry.body)) {
+            warnings.push({
+                code: 'plan_deferred_discovery',
+                message: `Entry "${entryName}" defers discovery to execution ("identify/determine/locate..."). Do that discovery now, during planning, and state the concrete outcome instead.`
+            });
+        }
+        if (statted >= MAX_STATTED_ENTRIES) {
+            continue;
+        }
+        statted++;
+        const stat = await statTarget(planEntryTargetToPath(entry.target));
+        if (entry.kind === 'modify') {
+            if (!stat?.exists) {
+                errors.push({
+                    code: 'plan_modify_target_missing',
+                    message: `[MODIFY] target "${entryName}" does not exist in the workspace. Verify the path with discovery tools and link the real file, or use [NEW] if it is being created.`
+                });
+            }
+            else if (stat.isDirectory) {
+                errors.push({
+                    code: 'plan_modify_target_directory',
+                    message: `[MODIFY] target "${entryName}" is a directory, not a file. Plans must name the exact files to change — one entry per file, discovered during planning.`
+                });
+            }
+        }
+        else if (stat?.exists && !stat.isDirectory) {
+            warnings.push({
+                code: 'plan_new_target_exists',
+                message: `[NEW] target "${entryName}" already exists. Use [MODIFY] for existing files.`
+            });
+        }
+    }
+    return { errors, warnings };
+}
+export function formatPlanValidationRejection(result) {
+    const lines = [
+        'The implementation plan is not implementation-ready:',
+        ...result.errors.slice(0, 6).map(issue => `- ${issue.message}`)
+    ];
+    if (result.warnings.length > 0) {
+        lines.push(...result.warnings.slice(0, 4).map(issue => `- (warning) ${issue.message}`));
+    }
+    lines.push('Planning is the discovery phase: name exact existing files (verified with reads/searches) and the specific change per file, then resubmit.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=cleanSlatePlanArtifactPolicy.js.map

package/dist/tools/cleanSlatePlanArtifactPolicy.js.map

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

package/dist/tools/cleanSlateStaleDiagnosticPolicy.d.ts

@@ -0,0 +1,3 @@
+export declare function isStaleGeneratedDiagnosticPath(pathCandidate: string | undefined): boolean;
+export declare const STALE_GENERATED_DIAGNOSTIC_WARNING = "This file looks like a stale generated compiler log, not live workspace truth. Prefer read_lints or a fresh scoped compile command before editing code to satisfy errors listed here.";
+//# sourceMappingURL=cleanSlateStaleDiagnosticPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateStaleDiagnosticPolicy.d.ts","sourceRoot":"","sources":["../../src/tools/cleanSlateStaleDiagnosticPolicy.ts"],"names":[],"mappings":"AAOA,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKzF;AAED,eAAO,MAAM,kCAAkC,0LACyI,CAAC"}

package/dist/tools/cleanSlateStaleDiagnosticPolicy.js

@@ -0,0 +1,13 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+const STALE_DIAGNOSTIC_FILE_PATTERN = /(?:^|\/)ts_errors(?:_v\d+)?\.txt$/i;
+export function isStaleGeneratedDiagnosticPath(pathCandidate) {
+    if (!pathCandidate) {
+        return false;
+    }
+    return STALE_DIAGNOSTIC_FILE_PATTERN.test(pathCandidate.replace(/\\/g, '/'));
+}
+export const STALE_GENERATED_DIAGNOSTIC_WARNING = 'This file looks like a stale generated compiler log, not live workspace truth. Prefer read_lints or a fresh scoped compile command before editing code to satisfy errors listed here.';
+//# sourceMappingURL=cleanSlateStaleDiagnosticPolicy.js.map

package/dist/tools/cleanSlateStaleDiagnosticPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateStaleDiagnosticPolicy.js","sourceRoot":"","sources":["../../src/tools/cleanSlateStaleDiagnosticPolicy.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,MAAM,6BAA6B,GAAG,oCAAoC,CAAC;AAE3E,MAAM,UAAU,8BAA8B,CAAC,aAAiC;IAC/E,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,6BAA6B,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,MAAM,kCAAkC,GAC9C,uLAAuL,CAAC"}

package/dist/tools/languageFeatureActivation.d.ts

@@ -0,0 +1,13 @@
+import { URI } from '../core/uri.js';
+import { Position } from '../core/position.js';
+import { ISlateTextModel } from '../host/textModel.js';
+import { CleanSlateToolContext } from './types.js';
+export declare function resolveBackgroundLanguageFeatureModel(uri: URI, context: CleanSlateToolContext): Promise<ISlateTextModel | undefined>;
+export declare function fireLanguageServerForUri(uri: URI, context: CleanSlateToolContext, command?: {
+    id: string;
+    args: unknown[];
+}): Promise<unknown[] | undefined>;
+export declare function fireDocumentSymbolProvider(uri: URI, context: CleanSlateToolContext): Promise<unknown[] | undefined>;
+export declare function fireDefinitionProvider(uri: URI, position: Position, context: CleanSlateToolContext): Promise<unknown[] | undefined>;
+export declare function fireReferenceProvider(uri: URI, position: Position, context: CleanSlateToolContext): Promise<unknown[] | undefined>;
+//# sourceMappingURL=languageFeatureActivation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"languageFeatureActivation.d.ts","sourceRoot":"","sources":["../../src/tools/languageFeatureActivation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,wBAAsB,qCAAqC,CACvD,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,qBAAqB,GAC/B,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CA0CtC;AAED,wBAAsB,wBAAwB,CAC1C,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,GAC1C,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAsBhC;AAED,wBAAsB,0BAA0B,CAC5C,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,qBAAqB,GAC/B,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAKhC;AAED,wBAAsB,sBAAsB,CACxC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,qBAAqB,GAC/B,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAKhC;AAED,wBAAsB,qBAAqB,CACvC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,qBAAqB,GAC/B,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAKhC"}

package/dist/tools/languageFeatureActivation.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 { isUriInIdeWorkspace } from './utils.js';
+export async function resolveBackgroundLanguageFeatureModel(uri, context) {
+    let model = context.modelService.getModel(uri);
+    if (model) {
+        return model;
+    }
+    try {
+        await context.textFileService.files.resolve(uri);
+    }
+    catch (error) {
+        console.info(`[CleanSlateEdit] lsp_fire: file resolve failed for ${uri.fsPath}: ${String(error)}`);
+    }
+    model = context.modelService.getModel(uri);
+    if (model) {
+        return model;
+    }
+    // Only fall back to opening a real editor when the file belongs to the
+    // workspace the IDE currently has open. `editorService`/`codeEditorService`
+    // are the global workbench singletons, so for a cross-project Agent Manager
+    // session an openEditor here would surface the session's file as a tab in a
+    // DIFFERENT project's window (the file "leak"). Keep LSP warm-up headless in
+    // that case; the file resolve above already loaded the model if it could.
+    if (!isUriInIdeWorkspace(context, uri)) {
+        return context.modelService.getModel(uri) ?? undefined;
+    }
+    try {
+        await context.editorService.openEditor({
+            resource: uri,
+            options: {
+                preserveFocus: true,
+                pinned: false,
+                inactive: true,
+                revealIfVisible: false,
+                revealIfOpened: false
+            }
+        });
+    }
+    catch (error) {
+        console.info(`[CleanSlateEdit] lsp_fire: background open failed for ${uri.fsPath}: ${String(error)}`);
+    }
+    return context.modelService.getModel(uri) ?? undefined;
+}
+export async function fireLanguageServerForUri(uri, context, command) {
+    const model = await resolveBackgroundLanguageFeatureModel(uri, context);
+    if (!context.commandService || !command) {
+        return undefined;
+    }
+    // ── Synchronization Buffer for Large Files ────────────────────────────────
+    // In large files (> 500 lines), the Language Server (LSP) re-indexes in the background
+    // after a mutation. If we fire a command immediately, we get stale coordinates.
+    if (model && model.getLineCount() > 500) {
+        console.info(`[CleanSlateSync] Large file detected (${model.getLineCount()} lines). Waiting for LSP to stabilize...`);
+        await new Promise(resolve => setTimeout(resolve, 500));
+    }
+    try {
+        const result = await context.commandService.executeCommand(command.id, ...command.args);
+        return normalizeLanguageFeatureCommandResult(result);
+    }
+    catch (error) {
+        console.info(`[CleanSlateEdit] lsp_fire: ${command.id} failed for ${uri.fsPath}: ${String(error)}`);
+        return undefined;
+    }
+}
+export async function fireDocumentSymbolProvider(uri, context) {
+    return fireLanguageServerForUri(uri, context, {
+        id: '_executeDocumentSymbolProvider',
+        args: [uri]
+    });
+}
+export async function fireDefinitionProvider(uri, position, context) {
+    return fireLanguageServerForUri(uri, context, {
+        id: '_executeDefinitionProvider',
+        args: [uri, position]
+    });
+}
+export async function fireReferenceProvider(uri, position, context) {
+    return fireLanguageServerForUri(uri, context, {
+        id: '_executeReferenceProvider',
+        args: [uri, position]
+    });
+}
+function normalizeLanguageFeatureCommandResult(result) {
+    if (Array.isArray(result)) {
+        return result;
+    }
+    if (result) {
+        return [result];
+    }
+    return undefined;
+}
+//# sourceMappingURL=languageFeatureActivation.js.map

package/dist/tools/languageFeatureActivation.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,5 @@
+import { CleanSlateTool, CleanSlateToolContext } from './types.js';
+export declare const ALL_TOOLS: CleanSlateTool[];
+export declare function getToolByName(name: string): CleanSlateTool | undefined;
+export declare function executeTool(toolName: string, input: any, context: CleanSlateToolContext): Promise<any>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA0DnE,eAAO,MAAM,SAAS,EAAE,cAAc,EA4DrC,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEtE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,CAI5G"}

package/dist/tools/registry.js

@@ -0,0 +1,104 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { readFileTool } from './ReadFileTool.js';
+import { readFileRangeTool } from './ReadFileRangeTool.js';
+import { semanticSearchTool } from './SemanticSearchTool.js';
+import { searchCodebaseTool } from './SearchCodebaseTool.js';
+import { findByNameTool } from './FindByNameTool.js';
+import { grepSearchTool } from './GrepSearchTool.js';
+import { searchWorkspaceTool } from './SearchWorkspaceTool.js';
+import { executeCommandTool, readBackgroundCommandTool, startBackgroundCommandTool, stopBackgroundCommandTool } from './ExecuteCommandTool.js';
+import { applyEditTool } from './ApplyEditTool.js';
+import { listDirTool } from './ListDirTool.js';
+import { getOpenFilesTool } from './GetOpenFilesTool.js';
+import { writeFileTool } from './WriteFileTool.js';
+import { createMultipleFilesTool } from './CreateMultipleFilesTool.js';
+import { multiFileReplaceTool } from './MultiFileReplaceTool.js';
+import { updateTodoTool } from './UpdateTodoTool.js';
+import { submitArtifactTool } from './SubmitArtifactTool.js';
+import { askQuestionTool } from './AskQuestionTool.js';
+import { spawnWorkerTool } from './SpawnWorkerTool.js';
+import { readReferenceTool } from './ReadReferenceTool.js';
+import { readLintsTool } from './ReadLintsTool.js';
+import { readSymbolsTool } from './ReadSymbolsTool.js';
+import { getDefinitionsTool } from './GetDefinitionsTool.js';
+import { findReferencesTool } from './FindReferencesTool.js';
+import { undoEditTool } from './UndoEditTool.js';
+import { fileHistoryRewindTool } from './FileHistoryRewindTool.js';
+import { mcpCallTool, mcpListToolsTool } from './MCPTools.js';
+import { listSkillsTool } from './SkillTools.js';
+import { webFetchTool, webSearchTool } from './WebRetrievalTools.js';
+import { browserClickTool, browserCheckTool, browserClipboardTool, browserCloseTabTool, browserClearAnnotationsTool, browserDeleteAnnotationTool, browserDiagnosticsTool, browserDialogTool, browserFillTool, browserGetUrlTool, browserHoverTool, browserKeyTool, browserListAnnotationsTool, browserNewTabTool, browserOpenTool, browserScreenshotTool, browserScrollTool, browserSelectTool, browserSelectTabTool, browserSnapshotTool, browserStartAnnotationTool, browserStopAnnotationTool, browserTabsTool, browserTypeTool, browserUploadTool, browserWaitTool } from './BrowserAutomationTools.js';
+export const ALL_TOOLS = [
+    readFileTool,
+    readFileRangeTool,
+    semanticSearchTool,
+    searchWorkspaceTool,
+    searchCodebaseTool,
+    applyEditTool,
+    multiFileReplaceTool,
+    getOpenFilesTool,
+    writeFileTool,
+    createMultipleFilesTool,
+    findByNameTool,
+    grepSearchTool,
+    executeCommandTool,
+    startBackgroundCommandTool,
+    readBackgroundCommandTool,
+    stopBackgroundCommandTool,
+    webSearchTool,
+    webFetchTool,
+    browserOpenTool,
+    browserGetUrlTool,
+    browserTabsTool,
+    browserNewTabTool,
+    browserSelectTabTool,
+    browserCloseTabTool,
+    browserWaitTool,
+    browserSnapshotTool,
+    browserClickTool,
+    browserClipboardTool,
+    browserHoverTool,
+    browserFillTool,
+    browserCheckTool,
+    browserSelectTool,
+    browserUploadTool,
+    browserTypeTool,
+    browserKeyTool,
+    browserScrollTool,
+    browserScreenshotTool,
+    browserDiagnosticsTool,
+    browserDialogTool,
+    browserStartAnnotationTool,
+    browserStopAnnotationTool,
+    browserListAnnotationsTool,
+    browserDeleteAnnotationTool,
+    browserClearAnnotationsTool,
+    listDirTool,
+    spawnWorkerTool,
+    listSkillsTool,
+    mcpListToolsTool,
+    mcpCallTool,
+    readReferenceTool,
+    updateTodoTool,
+    askQuestionTool,
+    submitArtifactTool,
+    readLintsTool,
+    readSymbolsTool,
+    getDefinitionsTool,
+    findReferencesTool,
+    undoEditTool,
+    fileHistoryRewindTool
+];
+export function getToolByName(name) {
+    return ALL_TOOLS.find(tool => tool.name === name);
+}
+export async function executeTool(toolName, input, context) {
+    const tool = getToolByName(toolName);
+    if (!tool)
+        throw new Error(`Tool "${toolName}" not found.`);
+    return await tool.run(input, context);
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/structuredEditCanonicalizer.d.ts

@@ -0,0 +1,11 @@
+import { ISlateTextModel } from '../host/textModel.js';
+import { CleanSlateStructuredEdit } from '../services/cleanSlateEditService.js';
+import { CleanSlateToolContext } from './types.js';
+export declare function canonicalizeStructuredEdits(path: string, model: ISlateTextModel, edits: CleanSlateStructuredEdit[], context: CleanSlateToolContext): Promise<{
+    ok: true;
+    edits: CleanSlateStructuredEdit[];
+} | {
+    ok: false;
+    failure: any;
+}>;
+//# sourceMappingURL=structuredEditCanonicalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structuredEditCanonicalizer.d.ts","sourceRoot":"","sources":["../../src/tools/structuredEditCanonicalizer.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,wBAAsB,2BAA2B,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,wBAAwB,EAAE,EACjC,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,wBAAwB,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAaxF"}

package/dist/tools/structuredEditCanonicalizer.js

@@ -0,0 +1,44 @@
+/*---------------------------------------------------------------------------------------------
+ * 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 { resolveSymbolStructuredEdits } from './symbolEditResolver.js';
+export async function canonicalizeStructuredEdits(path, model, edits, context) {
+    console.info('[CleanSlateEdit] exact-string edit contract; structured symbol/range inputs are legacy compatibility only.');
+    const symbolResolution = await resolveSymbolStructuredEdits(path, model, edits, context);
+    if (!symbolResolution.ok) {
+        return symbolResolution;
+    }
+    const normalizedRangeEdits = await normalizeRangeEditsWithStructure(model, symbolResolution.edits, context);
+    console.info(`[CleanSlateEdit] canonicalized ${edits.length} edit(s) into ${normalizedRangeEdits.length} deterministic edit request(s).`);
+    return {
+        ok: true,
+        edits: normalizedRangeEdits
+    };
+}
+async function normalizeRangeEditsWithStructure(model, edits, context) {
+    void context;
+    return edits.map(edit => {
+        if (edit.mode !== 'replace_range' || edit.startLine === undefined || edit.endLine === undefined) {
+            return edit;
+        }
+        const normalizedEdit = {
+            ...edit,
+            startColumn: edit.startColumn ?? 1,
+            endColumn: edit.endColumn ?? model.getLineMaxColumn(edit.endLine)
+        };
+        const normalizedRange = new Range(normalizedEdit.startLine, normalizedEdit.startColumn, normalizedEdit.endLine, normalizedEdit.endColumn);
+        if (shouldAutoAttachOriginalText(model, normalizedRange) && typeof normalizedEdit.originalText !== 'string') {
+            normalizedEdit.originalText = model.getValueInRange(normalizedRange);
+        }
+        return normalizedEdit;
+    });
+}
+function shouldAutoAttachOriginalText(model, range) {
+    if (model.getLineCount() >= 500) {
+        return true;
+    }
+    return range.endLineNumber > range.startLineNumber;
+}
+//# sourceMappingURL=structuredEditCanonicalizer.js.map