@cleanslate/sdk 0.1.0

package/dist/agent/cleanSlateAgentExecutionSupport.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 { MarkerSeverity } from '../host/diagnostics.js';
+export class CleanSlateAgentExecutionSupport {
+    constructor(workspaceContextService, markerService, cleanSlateContextService) {
+        this.workspaceContextService = workspaceContextService;
+        this.markerService = markerService;
+        this.cleanSlateContextService = cleanSlateContextService;
+    }
+    didToolSucceed(toolResult) {
+        if (toolResult?.success === false) {
+            return false;
+        }
+        if (typeof toolResult?.exitCode === 'number') {
+            return toolResult.exitCode === 0;
+        }
+        return true;
+    }
+    createMarkerBaseline(failOnWarnings) {
+        const severities = failOnWarnings ? (MarkerSeverity.Error | MarkerSeverity.Warning) : MarkerSeverity.Error;
+        const baseline = new Map();
+        for (const marker of this.markerService.read({ severities })) {
+            const signature = this.markerSignature(marker);
+            baseline.set(signature, (baseline.get(signature) || 0) + 1);
+        }
+        return baseline;
+    }
+    isArtifactWritePath(pathCandidate) {
+        if (typeof pathCandidate !== 'string') {
+            return false;
+        }
+        const normalized = pathCandidate.replace(/\\/g, '/').toLowerCase();
+        const basename = normalized.split('/').pop() || normalized;
+        return basename === 'implementation_plan.md'
+            || basename === 'walkthrough.md'
+            || basename === 'analysis.md';
+    }
+    isConfirmedMutationResult(toolName, toolInput, toolResult) {
+        if (!this.didToolSucceed(toolResult)) {
+            return false;
+        }
+        switch (toolName) {
+            case 'apply_edit':
+                return typeof toolResult?.appliedBlocks === 'number' && toolResult.appliedBlocks > 0;
+            case 'multi_file_replace':
+                return Array.isArray(toolResult?.results) && toolResult.results.length > 0;
+            case 'create_multiple_files':
+                return Array.isArray(toolResult?.created) && toolResult.created.length > 0;
+            case 'write_file':
+            case 'create_and_write_file':
+                if (this.isArtifactWritePath(toolInput?.file_path ?? toolInput?.path)) {
+                    return true;
+                }
+                return toolResult?.persisted === true || toolResult?.created === true;
+            default:
+                return false;
+        }
+    }
+    trackTouchedPaths(toolName, toolInput, toolResult, touchedPaths) {
+        const collected = [];
+        const collectPath = (candidate) => {
+            if (typeof candidate !== 'string') {
+                return;
+            }
+            const absolute = this.coercePathToAbsolute(candidate);
+            if (absolute) {
+                collected.push(absolute);
+            }
+        };
+        collectPath(toolInput?.file_path ?? toolInput?.path);
+        collectPath(toolResult?.path);
+        if (Array.isArray(toolResult?.created)) {
+            for (const path of toolResult.created) {
+                collectPath(path);
+            }
+        }
+        if (Array.isArray(toolResult?.affectedFiles)) {
+            for (const path of toolResult.affectedFiles) {
+                collectPath(path);
+            }
+        }
+        if (Array.isArray(toolInput?.files)) {
+            for (const file of toolInput.files) {
+                collectPath(file?.path);
+            }
+        }
+        const isArtifactOnlyWrite = (toolName === 'write_file' || toolName === 'create_and_write_file')
+            && this.isArtifactWritePath(toolInput?.file_path ?? toolInput?.path);
+        if (isArtifactOnlyWrite) {
+            return;
+        }
+        for (const path of collected) {
+            touchedPaths.add(path);
+        }
+    }
+    async collectNewMarkerIssues(baseline, touchedPaths, failOnWarnings, limit = 40) {
+        const severities = failOnWarnings ? (MarkerSeverity.Error | MarkerSeverity.Warning) : MarkerSeverity.Error;
+        const scopePaths = await this.collectScopePaths(touchedPaths);
+        const baselineRemaining = new Map(baseline);
+        const markers = this.markerService
+            .read({ severities })
+            .filter(marker => this.markerBelongsToScope(marker, scopePaths))
+            .sort((a, b) => b.severity - a.severity);
+        const newIssues = [];
+        for (const marker of markers) {
+            const signature = this.markerSignature(marker);
+            const remaining = baselineRemaining.get(signature) || 0;
+            if (remaining > 0) {
+                baselineRemaining.set(signature, remaining - 1);
+                continue;
+            }
+            newIssues.push(this.formatMarkerIssue(marker));
+            if (newIssues.length >= limit) {
+                break;
+            }
+        }
+        return newIssues;
+    }
+    normalizePath(path) {
+        return path.replace(/\\/g, '/').toLowerCase();
+    }
+    coercePathToAbsolute(pathCandidate) {
+        const raw = pathCandidate.trim();
+        if (!raw) {
+            return undefined;
+        }
+        try {
+            if (raw.includes('://')) {
+                const parsed = URI.parse(raw);
+                if (parsed.scheme === 'file' && parsed.fsPath) {
+                    return parsed.fsPath;
+                }
+            }
+        }
+        catch {
+            // Fall through to regular path resolution.
+        }
+        if (raw.startsWith('/') || /^[a-zA-Z]:[\\/]/.test(raw)) {
+            return raw;
+        }
+        const workspaceFolders = this.workspaceContextService.getWorkspace().folders;
+        if (workspaceFolders.length > 0) {
+            return workspaceFolders[0].toResource(raw).fsPath;
+        }
+        return raw;
+    }
+    markerSignature(marker) {
+        const resource = marker.resource?.fsPath || marker.resource?.toString() || 'unknown';
+        return `${resource}:${marker.startLineNumber}:${marker.startColumn}:${marker.severity}:${marker.message}`;
+    }
+    async collectScopePaths(touchedPaths) {
+        const scopePaths = new Set();
+        const addPath = (pathCandidate) => {
+            if (!pathCandidate) {
+                return;
+            }
+            scopePaths.add(this.normalizePath(pathCandidate));
+        };
+        if (touchedPaths.size > 0) {
+            for (const path of touchedPaths) {
+                addPath(path);
+            }
+            return scopePaths;
+        }
+        try {
+            const context = await this.cleanSlateContextService.getContext();
+            addPath(context.activeFile?.uri?.fsPath);
+            for (const file of context.openFiles) {
+                addPath(file.uri.fsPath);
+            }
+        }
+        catch {
+            // If context lookup fails, return empty scope.
+        }
+        return scopePaths;
+    }
+    markerBelongsToScope(marker, scopePaths) {
+        if (scopePaths.size === 0) {
+            return true;
+        }
+        const markerPath = marker.resource?.fsPath || marker.resource?.toString();
+        if (!markerPath) {
+            return false;
+        }
+        const normalized = this.normalizePath(markerPath);
+        if (scopePaths.has(normalized)) {
+            return true;
+        }
+        for (const scopedPath of scopePaths) {
+            if (normalized.endsWith(scopedPath) || scopedPath.endsWith(normalized)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    formatMarkerIssue(marker) {
+        const resource = marker.resource?.fsPath || marker.resource?.toString() || 'unknown';
+        const severity = marker.severity === MarkerSeverity.Error ? 'Error' : 'Warning';
+        return `${resource}:${marker.startLineNumber}:${marker.startColumn} [${severity}] ${marker.message}`;
+    }
+}
+//# sourceMappingURL=cleanSlateAgentExecutionSupport.js.map

package/dist/agent/cleanSlateAgentExecutionSupport.js.map

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

package/dist/agent/cleanSlateAgentParsing.d.ts

@@ -0,0 +1,21 @@
+import { ICleanSlateConfigurationService } from '../protocol/cleanSlateAI.js';
+import { AgentPhase } from './cleanSlatePrompts.js';
+import { IExecutionLoopSettings, ParsedToolCall } from './cleanSlateAgentTypes.js';
+export declare class CleanSlateAgentParsingSupport {
+    private readonly configService;
+    private static readonly CHARS_PER_TOKEN_ESTIMATE;
+    /**
+     * A fixed reserve is kept below the model's usable input window before
+     * compaction starts.  The resolved model profile normally gives
+     * us an exact reserve; this is only the safe fallback for unknown models.
+     */
+    private static readonly DEFAULT_AUTO_COMPACT_RESERVE_TOKENS;
+    private static readonly MINIMUM_AUTO_COMPACT_RESERVE_TOKENS;
+    constructor(configService: ICleanSlateConfigurationService);
+    getExecutionLoopSettings(): IExecutionLoopSettings;
+    getExecutionContextBudgetChars(): number;
+    getExecutionAutoCompactThresholdChars(): number;
+    truncateForPrompt(text: string, maxChars?: number): string;
+    buildLoopAssistantMemory(rawResponse: string, phase: AgentPhase, toDoList: string[], toolCalls: ParsedToolCall[]): string;
+}
+//# sourceMappingURL=cleanSlateAgentParsing.d.ts.map

package/dist/agent/cleanSlateAgentParsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateAgentParsing.d.ts","sourceRoot":"","sources":["../../src/agent/cleanSlateAgentParsing.ts"],"names":[],"mappings":"AAKA,OAAO,EAA6C,+BAA+B,EAAqC,MAAM,6BAA6B,CAAC;AAC5J,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEnF,qBAAa,6BAA6B;IAWlC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAVlC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAK;IACrD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mCAAmC,CAAU;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mCAAmC,CAAS;gBAG/C,aAAa,EAAE,+BAA+B;IAG5D,wBAAwB,IAAI,sBAAsB;IAyDlD,8BAA8B,IAAI,MAAM;IAWxC,qCAAqC,IAAI,MAAM;IAmB/C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,GAAG,MAAM;IAOnE,wBAAwB,CAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,cAAc,EAAE,GACzB,MAAM;CAcT"}

package/dist/agent/cleanSlateAgentParsing.js

@@ -0,0 +1,106 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) CleanSlate. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { CLEANSLATE_FALLBACK_CONTEXT_WINDOW_TOKENS, normalizeCleanSlateExecutionState } from '../protocol/cleanSlateAI.js';
+export class CleanSlateAgentParsingSupport {
+    static { this.CHARS_PER_TOKEN_ESTIMATE = 4; }
+    /**
+     * A fixed reserve is kept below the model's usable input window before
+     * compaction starts.  The resolved model profile normally gives
+     * us an exact reserve; this is only the safe fallback for unknown models.
+     */
+    static { this.DEFAULT_AUTO_COMPACT_RESERVE_TOKENS = 13_000; }
+    static { this.MINIMUM_AUTO_COMPACT_RESERVE_TOKENS = 4_000; }
+    constructor(configService) {
+        this.configService = configService;
+    }
+    getExecutionLoopSettings() {
+        const config = this.configService.getConfiguration();
+        const executionState = normalizeCleanSlateExecutionState({
+            planMode: config.planMode,
+            reasoningLevel: config.reasoningLevel
+        });
+        const executionFlow = executionState.planMode ? 'planning' : 'normal';
+        const flowDefaults = {
+            normal: {
+                maxNoToolTurns: 2,
+                maxVerificationRetries: 1,
+                failOnWarnings: false,
+                usePlanningPhase: false,
+                turnDelayMs: 0
+            },
+            planning: {
+                maxNoToolTurns: 3,
+                maxVerificationRetries: 2,
+                failOnWarnings: false,
+                usePlanningPhase: true,
+                turnDelayMs: 0
+            }
+        };
+        const defaults = flowDefaults[executionFlow];
+        const maxTurns = Number.isFinite(config.maxTurns) && config.maxTurns > 0
+            ? Math.floor(config.maxTurns)
+            : undefined;
+        const maxNoToolTurns = Number.isFinite(config.maxNoToolTurns) ? Math.max(1, Math.floor(config.maxNoToolTurns)) : defaults.maxNoToolTurns;
+        const maxVerificationRetries = Number.isFinite(config.maxVerificationRetries) ? Math.max(0, Math.floor(config.maxVerificationRetries)) : defaults.maxVerificationRetries;
+        const verificationCommands = Array.isArray(config.verificationCommands)
+            ? config.verificationCommands.filter((command) => typeof command === 'string' && command.trim().length > 0)
+            : [];
+        const failOnWarnings = config.failOnWarnings !== undefined ? !!config.failOnWarnings : defaults.failOnWarnings;
+        return {
+            executionFlow,
+            planMode: executionState.planMode,
+            reasoningLevel: executionState.reasoningLevel,
+            maxTurns,
+            maxNoToolTurns,
+            maxVerificationRetries,
+            verificationCommands,
+            failOnWarnings,
+            usePlanningPhase: defaults.usePlanningPhase,
+            turnDelayMs: defaults.turnDelayMs
+        };
+    }
+    getExecutionContextBudgetChars() {
+        const config = this.configService.getConfiguration();
+        const contextWindowTokens = Number.isFinite(config.contextWindow)
+            ? Math.max(1024, Math.floor(config.contextWindow))
+            : CLEANSLATE_FALLBACK_CONTEXT_WINDOW_TOKENS;
+        // globalContextBudget is a retrieval / working-context budget. It must
+        // never decide when the conversation itself is compacted: doing that
+        // made a 252k-token model compact after only a few normal turns.
+        return Math.max(12_000, contextWindowTokens * CleanSlateAgentParsingSupport.CHARS_PER_TOKEN_ESTIMATE);
+    }
+    getExecutionAutoCompactThresholdChars() {
+        const config = this.configService.getConfiguration();
+        const contextWindowTokens = Number.isFinite(config.contextWindow)
+            ? Math.max(1024, Math.floor(config.contextWindow))
+            : CLEANSLATE_FALLBACK_CONTEXT_WINDOW_TOKENS;
+        const fallbackReserveTokens = Math.min(CleanSlateAgentParsingSupport.DEFAULT_AUTO_COMPACT_RESERVE_TOKENS, Math.max(CleanSlateAgentParsingSupport.MINIMUM_AUTO_COMPACT_RESERVE_TOKENS, Math.floor(contextWindowTokens * 0.10)));
+        const reserveTokens = Number.isFinite(config.autoCompactReserveTokens)
+            ? Math.max(0, Math.floor(config.autoCompactReserveTokens))
+            : fallbackReserveTokens;
+        const thresholdTokens = Math.max(1024, contextWindowTokens - reserveTokens);
+        return Math.max(12_000, thresholdTokens * CleanSlateAgentParsingSupport.CHARS_PER_TOKEN_ESTIMATE);
+    }
+    truncateForPrompt(text, maxChars = 1600) {
+        if (!text || text.length <= maxChars) {
+            return text;
+        }
+        return `${text.slice(0, maxChars)}\n... [truncated]`;
+    }
+    buildLoopAssistantMemory(rawResponse, phase, toDoList, toolCalls) {
+        const memoryLines = [];
+        const trimmedResponse = rawResponse.trim();
+        if (trimmedResponse.length > 0) {
+            memoryLines.push(trimmedResponse);
+        }
+        if (toDoList.length > 0) {
+            memoryLines.push(['Current todo:', ...toDoList.map(item => `- ${item}`)].join('\n'));
+        }
+        void phase;
+        void toolCalls;
+        return memoryLines.join('\n\n');
+    }
+}
+//# sourceMappingURL=cleanSlateAgentParsing.js.map

package/dist/agent/cleanSlateAgentParsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateAgentParsing.js","sourceRoot":"","sources":["../../src/agent/cleanSlateAgentParsing.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,yCAAyC,EAAmC,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAI5J,MAAM,OAAO,6BAA6B;aACd,6BAAwB,GAAG,CAAC,CAAC;IACrD;;;;OAIG;aACqB,wCAAmC,GAAG,MAAM,CAAC;aAC7C,wCAAmC,GAAG,KAAK,CAAC;IAEpE,YACqB,aAA8C;QAA9C,kBAAa,GAAb,aAAa,CAAiC;IAC/D,CAAC;IAEE,wBAAwB;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC;QACrD,MAAM,cAAc,GAAG,iCAAiC,CAAC;YACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,cAAc,EAAE,MAAM,CAAC,cAAc;SACxC,CAAC,CAAC;QAEH,MAAM,aAAa,GAAyB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE5F,MAAM,YAAY,GAMb;YACD,MAAM,EAAE;gBACJ,cAAc,EAAE,CAAC;gBACjB,sBAAsB,EAAE,CAAC;gBACzB,cAAc,EAAE,KAAK;gBACrB,gBAAgB,EAAE,KAAK;gBACvB,WAAW,EAAE,CAAC;aACjB;YACD,QAAQ,EAAE;gBACN,cAAc,EAAE,CAAC;gBACjB,sBAAsB,EAAE,CAAC;gBACzB,cAAc,EAAE,KAAK;gBACrB,gBAAgB,EAAE,IAAI;gBACtB,WAAW,EAAE,CAAC;aACjB;SACJ,CAAC;QAEF,MAAM,QAAQ,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAS,GAAG,CAAC;YACrE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAS,CAAC;YAC9B,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAe,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC1I,MAAM,sBAAsB,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAC1K,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC;YACnE,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YACnH,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QAE/G,OAAO;YACH,aAAa;YACb,QAAQ,EAAE,cAAc,CAAC,QAAQ;YACjC,cAAc,EAAE,cAAc,CAAC,cAAc;YAC7C,QAAQ;YACR,cAAc;YACd,sBAAsB;YACtB,oBAAoB;YACpB,cAAc;YACd,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;YAC3C,WAAW,EAAE,QAAQ,CAAC,WAAW;SACpC,CAAC;IACN,CAAC;IAEM,8BAA8B;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC;QACrD,MAAM,mBAAmB,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC;YAC7D,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAc,CAAC,CAAC;YACnD,CAAC,CAAC,yCAAyC,CAAC;QAChD,uEAAuE;QACvE,qEAAqE;QACrE,iEAAiE;QACjE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,GAAG,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;IAC1G,CAAC;IAEM,qCAAqC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC;QACrD,MAAM,mBAAmB,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC;YAC7D,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAc,CAAC,CAAC;YACnD,CAAC,CAAC,yCAAyC,CAAC;QAChD,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAClC,6BAA6B,CAAC,mCAAmC,EACjE,IAAI,CAAC,GAAG,CACJ,6BAA6B,CAAC,mCAAmC,EACjE,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,CACzC,CACJ,CAAC;QACF,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,wBAAwB,CAAC;YAClE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,wBAAyB,CAAC,CAAC;YAC3D,CAAC,CAAC,qBAAqB,CAAC;QAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,6BAA6B,CAAC,wBAAwB,CAAC,CAAC;IACtG,CAAC;IAEM,iBAAiB,CAAC,IAAY,EAAE,WAAmB,IAAI;QAC1D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC;IACzD,CAAC;IAEG,wBAAwB,CAC9B,WAAmB,EACnB,KAAiB,EACjB,QAAkB,EAClB,SAA2B;QAE3B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,KAAK,KAAK,CAAC;QACX,KAAK,SAAS,CAAC;QACf,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC"}

package/dist/agent/cleanSlateAgentSession.d.ts

@@ -0,0 +1,44 @@
+import { IChatMessage, ICleanSlateAgentRuntimeSnapshot, ICleanSlatePendingAgentInteraction, IToolCall } from '../protocol/cleanSlateAI.js';
+export interface ICleanSlateAgentSessionMetadata {
+    readonly objective?: string;
+    readonly mode?: string;
+    readonly phase?: string;
+}
+/**
+ * Owns the native model/tool transcript for one GUI session.
+ *
+ * The visible thread is a projection for rendering. This transcript is the
+ * protocol source of truth and therefore survives plan handoffs, interactive
+ * questions, and application reloads.
+ */
+export declare class CleanSlateAgentSession {
+    private messages;
+    private objective;
+    private mode;
+    private phase;
+    private pendingInteraction;
+    start(messages: readonly IChatMessage[], metadata?: ICleanSlateAgentSessionMetadata): IChatMessage[];
+    continueWithLatestUserMessage(seedMessages: readonly IChatMessage[], metadata?: ICleanSlateAgentSessionMetadata): IChatMessage[];
+    /** Appends trailing mode/context reminders plus the new user turn. */
+    continueWithTurn(seedMessages: readonly IChatMessage[], metadata?: ICleanSlateAgentSessionMetadata): IChatMessage[];
+    appendMessage(message: IChatMessage): void;
+    getMutableMessages(): IChatMessage[];
+    hasMessages(): boolean;
+    pauseForQuestion(toolCall: IToolCall, question: unknown): void;
+    hasPendingQuestion(): boolean;
+    resumePendingQuestion(answer: string): ICleanSlatePendingAgentInteraction | undefined;
+    getSnapshot(): ICleanSlateAgentRuntimeSnapshot | undefined;
+    restore(snapshot: ICleanSlateAgentRuntimeSnapshot | undefined): void;
+    clear(): void;
+    private updateMetadata;
+    private findLatestUserMessage;
+    private isDuplicateTail;
+    private requireToolCallId;
+    private getQuestionText;
+    private normalizePendingInteraction;
+    private isChatMessage;
+    private cloneMessage;
+    private cloneValue;
+    private normalizeOptionalString;
+}
+//# sourceMappingURL=cleanSlateAgentSession.d.ts.map

package/dist/agent/cleanSlateAgentSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateAgentSession.d.ts","sourceRoot":"","sources":["../../src/agent/cleanSlateAgentSession.ts"],"names":[],"mappings":"AAKA,OAAO,EACN,YAAY,EACZ,+BAA+B,EAC/B,kCAAkC,EAClC,SAAS,EACT,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,sBAAsB;IAClC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,kBAAkB,CAAiD;IAEpE,KAAK,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,GAAE,+BAAoC,GAAG,YAAY,EAAE;IAOxG,6BAA6B,CACnC,YAAY,EAAE,SAAS,YAAY,EAAE,EACrC,QAAQ,GAAE,+BAAoC,GAC5C,YAAY,EAAE;IAajB,sEAAsE;IAC/D,gBAAgB,CACtB,YAAY,EAAE,SAAS,YAAY,EAAE,EACrC,QAAQ,GAAE,+BAAoC,GAC5C,YAAY,EAAE;IAkBV,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAM1C,kBAAkB,IAAI,YAAY,EAAE;IAIpC,WAAW,IAAI,OAAO;IAItB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAY9D,kBAAkB,IAAI,OAAO;IAI7B,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,kCAAkC,GAAG,SAAS;IAsBrF,WAAW,IAAI,+BAA+B,GAAG,SAAS;IAc1D,OAAO,CAAC,QAAQ,EAAE,+BAA+B,GAAG,SAAS,GAAG,IAAI;IAcpE,KAAK,IAAI,IAAI;IAQpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,uBAAuB;CAG/B"}

package/dist/agent/cleanSlateAgentSession.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.
+ *--------------------------------------------------------------------------------------------*/
+/**
+ * Owns the native model/tool transcript for one GUI session.
+ *
+ * The visible thread is a projection for rendering. This transcript is the
+ * protocol source of truth and therefore survives plan handoffs, interactive
+ * questions, and application reloads.
+ */
+export class CleanSlateAgentSession {
+    constructor() {
+        this.messages = [];
+    }
+    start(messages, metadata = {}) {
+        this.messages = messages.map(message => this.cloneMessage(message));
+        this.updateMetadata(metadata);
+        this.pendingInteraction = undefined;
+        return this.messages;
+    }
+    continueWithLatestUserMessage(seedMessages, metadata = {}) {
+        if (this.messages.length === 0) {
+            return this.start(seedMessages, metadata);
+        }
+        const latestUserMessage = this.findLatestUserMessage(seedMessages);
+        if (latestUserMessage && !this.isDuplicateTail(latestUserMessage)) {
+            this.messages.push(this.cloneMessage(latestUserMessage));
+        }
+        this.updateMetadata(metadata);
+        return this.messages;
+    }
+    /** Appends trailing mode/context reminders plus the new user turn. */
+    continueWithTurn(seedMessages, metadata = {}) {
+        if (this.messages.length === 0) {
+            return this.start(seedMessages, metadata);
+        }
+        for (const message of seedMessages) {
+            if (message.role === 'system') {
+                this.appendMessage(message);
+            }
+        }
+        const latestUserMessage = this.findLatestUserMessage(seedMessages);
+        if (latestUserMessage) {
+            this.appendMessage(latestUserMessage);
+        }
+        this.updateMetadata(metadata);
+        return this.messages;
+    }
+    appendMessage(message) {
+        if (!this.isDuplicateTail(message)) {
+            this.messages.push(this.cloneMessage(message));
+        }
+    }
+    getMutableMessages() {
+        return this.messages;
+    }
+    hasMessages() {
+        return this.messages.length > 0;
+    }
+    pauseForQuestion(toolCall, question) {
+        this.pendingInteraction = {
+            kind: 'question',
+            toolCallId: this.requireToolCallId(toolCall),
+            toolName: 'ask_question',
+            question: this.cloneValue(question),
+            objective: this.objective,
+            mode: this.mode,
+            phase: this.phase
+        };
+    }
+    hasPendingQuestion() {
+        return this.pendingInteraction?.kind === 'question';
+    }
+    resumePendingQuestion(answer) {
+        const pending = this.pendingInteraction;
+        if (!pending || pending.kind !== 'question') {
+            return undefined;
+        }
+        const normalizedAnswer = answer.trim();
+        const questionText = this.getQuestionText(pending.question);
+        this.messages.push({
+            role: 'tool',
+            toolCallId: pending.toolCallId,
+            toolName: pending.toolName,
+            content: JSON.stringify({
+                success: true,
+                answer: normalizedAnswer,
+                answers: questionText ? { [questionText]: normalizedAnswer } : { answer: normalizedAnswer }
+            })
+        });
+        this.pendingInteraction = undefined;
+        return pending;
+    }
+    getSnapshot() {
+        if (this.messages.length === 0 && !this.pendingInteraction) {
+            return undefined;
+        }
+        return {
+            version: 1,
+            messages: this.messages.map(message => this.cloneMessage(message)),
+            objective: this.objective,
+            mode: this.mode,
+            phase: this.phase,
+            pendingInteraction: this.pendingInteraction ? this.cloneValue(this.pendingInteraction) : undefined
+        };
+    }
+    restore(snapshot) {
+        if (!snapshot || snapshot.version !== 1 || !Array.isArray(snapshot.messages)) {
+            this.clear();
+            return;
+        }
+        this.messages = snapshot.messages
+            .filter(message => this.isChatMessage(message))
+            .map(message => this.cloneMessage(message));
+        this.objective = this.normalizeOptionalString(snapshot.objective);
+        this.mode = this.normalizeOptionalString(snapshot.mode);
+        this.phase = this.normalizeOptionalString(snapshot.phase);
+        this.pendingInteraction = this.normalizePendingInteraction(snapshot.pendingInteraction);
+    }
+    clear() {
+        this.messages = [];
+        this.objective = undefined;
+        this.mode = undefined;
+        this.phase = undefined;
+        this.pendingInteraction = undefined;
+    }
+    updateMetadata(metadata) {
+        this.objective = this.normalizeOptionalString(metadata.objective) ?? this.objective;
+        this.mode = this.normalizeOptionalString(metadata.mode) ?? this.mode;
+        this.phase = this.normalizeOptionalString(metadata.phase) ?? this.phase;
+    }
+    findLatestUserMessage(messages) {
+        for (let index = messages.length - 1; index >= 0; index--) {
+            if (messages[index].role === 'user') {
+                return messages[index];
+            }
+        }
+        return undefined;
+    }
+    isDuplicateTail(message) {
+        const tail = this.messages[this.messages.length - 1];
+        return !!tail
+            && tail.role === message.role
+            && JSON.stringify(tail.content) === JSON.stringify(message.content);
+    }
+    requireToolCallId(toolCall) {
+        const id = typeof toolCall.id === 'string' ? toolCall.id.trim() : '';
+        if (!id) {
+            throw new Error('ask_question must have a stable native tool call id before it can pause.');
+        }
+        return id;
+    }
+    getQuestionText(value) {
+        if (!value || typeof value !== 'object') {
+            return undefined;
+        }
+        const result = value;
+        return this.normalizeOptionalString(result.planning_question?.question);
+    }
+    normalizePendingInteraction(value) {
+        if (!value || typeof value !== 'object') {
+            return undefined;
+        }
+        const candidate = value;
+        if (candidate.kind !== 'question'
+            || candidate.toolName !== 'ask_question'
+            || typeof candidate.toolCallId !== 'string'
+            || candidate.toolCallId.trim().length === 0) {
+            return undefined;
+        }
+        return {
+            kind: 'question',
+            toolCallId: candidate.toolCallId,
+            toolName: 'ask_question',
+            question: this.cloneValue(candidate.question),
+            objective: this.normalizeOptionalString(candidate.objective),
+            mode: this.normalizeOptionalString(candidate.mode),
+            phase: this.normalizeOptionalString(candidate.phase)
+        };
+    }
+    isChatMessage(value) {
+        if (!value || typeof value !== 'object') {
+            return false;
+        }
+        const candidate = value;
+        return (candidate.role === 'user' || candidate.role === 'assistant' || candidate.role === 'system' || candidate.role === 'tool')
+            && (typeof candidate.content === 'string' || Array.isArray(candidate.content));
+    }
+    cloneMessage(message) {
+        return this.cloneValue(message);
+    }
+    cloneValue(value) {
+        try {
+            return JSON.parse(JSON.stringify(value));
+        }
+        catch {
+            return value;
+        }
+    }
+    normalizeOptionalString(value) {
+        return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+    }
+}
+//# sourceMappingURL=cleanSlateAgentSession.js.map

package/dist/agent/cleanSlateAgentSession.js.map

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