@cleanslate/sdk 0.1.0

package/dist/agent/cleanSlateNativeToolTranscript.js

@@ -0,0 +1,77 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) CleanSlate. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { serializeToolResultForPrompt } from './cleanSlateToolResultPromptSerializer.js';
+export class CleanSlateNativeToolTranscript {
+    constructor(idPrefix) {
+        this.idPrefix = idPrefix;
+        this.nextSyntheticToolCallId = 1;
+    }
+    parseToolCall(call) {
+        const toolName = this.normalizeToolName(typeof call?.toolName === 'string' ? call.toolName : '');
+        return toolName
+            ? { id: this.normalizeToolCallId(call?.id, toolName), toolName, input: call?.input ?? {}, providerMetadata: call?.providerMetadata }
+            : undefined;
+    }
+    buildAssistantToolCallMessage(content, toolCalls) {
+        return {
+            role: 'assistant',
+            content,
+            toolCalls: toolCalls.map(toolCall => ({
+                id: toolCall.id,
+                toolName: toolCall.toolName,
+                input: toolCall.input ?? {},
+                providerMetadata: toolCall.providerMetadata
+            }))
+        };
+    }
+    buildToolResultMessage(toolCall, result, maxChars) {
+        return {
+            role: 'tool',
+            toolCallId: toolCall.id,
+            toolName: toolCall.toolName,
+            content: serializeToolResultForPrompt(toolCall.toolName, result, maxChars)
+        };
+    }
+    attachToolCallId(part, toolCallId) {
+        if ((part.type === 'tool_start' || part.type === 'tool_progress' || part.type === 'tool_result') && toolCallId) {
+            return { ...part, toolCallId };
+        }
+        return part;
+    }
+    getToolCallKey(toolCall) {
+        return toolCall.id || this.getToolCallSemanticKey(toolCall);
+    }
+    getToolCallSemanticKey(toolCall) {
+        try {
+            return `${toolCall.toolName}:${JSON.stringify(toolCall.input ?? {})}`;
+        }
+        catch {
+            return `${toolCall.toolName}:${String(toolCall.input)}`;
+        }
+    }
+    normalizeToolName(toolName) {
+        const trimmed = toolName.trim();
+        return trimmed.startsWith('functions.')
+            ? trimmed.slice('functions.'.length)
+            : trimmed;
+    }
+    normalizeToolCallId(id, toolName) {
+        return typeof id === 'string' && id.trim().length > 0
+            ? id.trim()
+            : `call_${this.sanitizeIdPart(this.idPrefix)}_${this.sanitizeIdPart(toolName)}_${this.nextSyntheticToolCallId++}`;
+    }
+    sanitizeIdPart(value) {
+        return Array.from(value).map(char => {
+            const code = char.charCodeAt(0);
+            const isDigit = code >= 48 && code <= 57;
+            const isUpper = code >= 65 && code <= 90;
+            const isLower = code >= 97 && code <= 122;
+            return isDigit || isUpper || isLower || char === '_' || char === '-'
+                ? char
+                : '_';
+        }).join('');
+    }
+}
+//# sourceMappingURL=cleanSlateNativeToolTranscript.js.map

package/dist/agent/cleanSlateNativeToolTranscript.js.map

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

package/dist/agent/cleanSlatePrompts.d.ts

@@ -0,0 +1,30 @@
+import { IChatMessagePart } from '../protocol/cleanSlateAI.js';
+import { AgentDefinition } from '../composer/registry/agentSchema.js';
+import { PLANNING_MODE_INSTRUCTION } from '../composer/modes/planning.mode.js';
+import { EXECUTION_MODE_INSTRUCTION } from '../composer/modes/execution.mode.js';
+export { PLANNING_MODE_INSTRUCTION, EXECUTION_MODE_INSTRUCTION };
+export declare enum AgentPhase {
+    PLANNING = "PLANNING",
+    EXECUTION = "EXECUTION",
+    VERIFICATION = "VERIFICATION"
+}
+/**
+ * Slash command definitions (Re-exported for backward compatibility)
+ */
+export declare const SLASH_COMMANDS: Record<string, {
+    instruction: string;
+    defaultMessage: string;
+}>;
+/**
+ * Build system prompt with optional command-specific instruction and mode
+ */
+export declare function buildSystemPrompt(userMessage?: string, mode?: string, agentDef?: AgentDefinition, languageId?: string, command?: string, discoveredContext?: any): IChatMessagePart[];
+/**
+ * Parse user message for slash commands
+ */
+export declare function parseSlashCommand(text: string, mode?: string, agentDef?: AgentDefinition, languageId?: string, discoveredContext?: any): {
+    command: string | null;
+    systemInstruction: IChatMessagePart[];
+    userMessage: string;
+};
+//# sourceMappingURL=cleanSlatePrompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlatePrompts.d.ts","sourceRoot":"","sources":["../../src/agent/cleanSlatePrompts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAEtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,CAAC;AAEjE,oBAAY,UAAU;IACpB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;EAAmB,CAAC;AAE/C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAe,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,GAAG,GAAG,gBAAgB,EAAE,CAc7L;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAe,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,GAAG,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA2BvO"}

package/dist/agent/cleanSlatePrompts.js

@@ -0,0 +1,65 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) CleanSlate. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { composePrompt } from '../composer/promptComposer.js';
+import { SLASH_COMMANDS as COMMAND_REGISTRY } from '../composer/commands/slashCommands.js';
+import { PLANNING_MODE_INSTRUCTION } from '../composer/modes/planning.mode.js';
+import { EXECUTION_MODE_INSTRUCTION } from '../composer/modes/execution.mode.js';
+export { PLANNING_MODE_INSTRUCTION, EXECUTION_MODE_INSTRUCTION };
+export var AgentPhase;
+(function (AgentPhase) {
+    AgentPhase["PLANNING"] = "PLANNING";
+    AgentPhase["EXECUTION"] = "EXECUTION";
+    AgentPhase["VERIFICATION"] = "VERIFICATION";
+})(AgentPhase || (AgentPhase = {}));
+/**
+ * Slash command definitions (Re-exported for backward compatibility)
+ */
+export const SLASH_COMMANDS = COMMAND_REGISTRY;
+/**
+ * Build system prompt with optional command-specific instruction and mode
+ */
+export function buildSystemPrompt(userMessage, mode = 'Plan', agentDef, languageId, command, discoveredContext) {
+    // Map old mode strings to composer valid modes if necessary
+    const composerMode = (mode === 'Plan' || mode === 'Planning' || mode === 'Execution' || mode === 'Verification')
+        ? mode
+        : 'Plan';
+    return composePrompt({
+        command,
+        mode: composerMode,
+        agentDefinition: agentDef, // Pass persona to composer
+        languageId,
+        userMessage,
+        discoveredContext
+    });
+}
+/**
+ * Parse user message for slash commands
+ */
+export function parseSlashCommand(text, mode = 'Plan', agentDef, languageId, discoveredContext) {
+    if (!text.startsWith('/')) {
+        return {
+            command: null,
+            systemInstruction: buildSystemPrompt(text, mode, agentDef, languageId, undefined, discoveredContext),
+            userMessage: text
+        };
+    }
+    const commandText = text.split(' ')[0];
+    const rest = text.substring(commandText.length).trim();
+    if (SLASH_COMMANDS[commandText]) {
+        const defaultUserMessage = SLASH_COMMANDS[commandText].defaultMessage;
+        const finalUserMessage = rest || defaultUserMessage;
+        return {
+            command: commandText,
+            systemInstruction: buildSystemPrompt(finalUserMessage, mode, agentDef, languageId, commandText, discoveredContext),
+            userMessage: finalUserMessage
+        };
+    }
+    return {
+        command: null,
+        systemInstruction: buildSystemPrompt(text, mode, agentDef, languageId, undefined, discoveredContext),
+        userMessage: text
+    };
+}
+//# sourceMappingURL=cleanSlatePrompts.js.map

package/dist/agent/cleanSlatePrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlatePrompts.js","sourceRoot":"","sources":["../../src/agent/cleanSlatePrompts.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAGhG,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,cAAc,IAAI,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,CAAC;AAEjE,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,mCAAqB,CAAA;IACrB,qCAAuB,CAAA;IACvB,2CAA6B,CAAA;AAC/B,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAoB,EAAE,OAAe,MAAM,EAAE,QAA0B,EAAE,UAAmB,EAAE,OAAgB,EAAE,iBAAuB;IACvK,4DAA4D;IAC5D,MAAM,YAAY,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,CAAC;QAC9G,CAAC,CAAC,IAAW;QACb,CAAC,CAAC,MAAM,CAAC;IAEX,OAAO,aAAa,CAAC;QACnB,OAAO;QACP,IAAI,EAAE,YAAY;QAClB,eAAe,EAAE,QAAQ,EAAE,2BAA2B;QACtD,UAAU;QACV,WAAW;QACX,iBAAiB;KAClB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe,MAAM,EAAE,QAA0B,EAAE,UAAmB,EAAE,iBAAuB;IAC7I,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,CAAC;YACpG,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvD,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,kBAAkB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,cAAc,CAAC;QACtE,MAAM,gBAAgB,GAAG,IAAI,IAAI,kBAAkB,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,iBAAiB,EAAE,iBAAiB,CAAC,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,CAAC;YAClH,WAAW,EAAE,gBAAgB;SAC9B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,CAAC;QACpG,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}

package/dist/agent/cleanSlateQueryRunner.d.ts

@@ -0,0 +1,56 @@
+import { URI } from '../core/uri.js';
+import { CleanSlateExecutionFlow, IChatMessage, ICleanSlateContextService, ICleanSlateService } from '../protocol/cleanSlateAI.js';
+import { CleanSlateThreadService } from '../services/cleanSlateThreadService.js';
+import { CleanSlateTaskSessionService } from '../services/cleanSlateTaskSessionService.js';
+import { CleanSlateTool, CleanSlateToolContext } from '../services/cleanSlateTools.js';
+import { CleanSlateAgentParsingSupport } from './cleanSlateAgentParsing.js';
+import { CleanSlateAgentExecutionSupport } from './cleanSlateAgentExecutionSupport.js';
+import { CleanSlateStreamPart, ParsedToolCall } from './cleanSlateAgentTypes.js';
+import { ICleanSlateExecutionBudget } from './cleanSlateExecutionBudget.js';
+export interface IExecutionRunnerOptions {
+    cleanSlateService: ICleanSlateService;
+    cleanSlateContextService: ICleanSlateContextService;
+    parsingSupport: CleanSlateAgentParsingSupport;
+    executionSupport: CleanSlateAgentExecutionSupport;
+    toolContext: CleanSlateToolContext;
+    recentFocusLines: Map<string, Set<number>>;
+    referenceBuffer: Map<string, any>;
+    getToolCategory: (toolName: string) => string | undefined;
+    getTools?: () => readonly CleanSlateTool[];
+    /** Stable desktop conversation id used for provider prompt-cache affinity. */
+    getSessionId?: () => string | undefined;
+    recordSemanticToolResult?: (toolName: string, input: any, result: any) => void;
+    buildPromptContext: (context: any, signal?: AbortSignal) => Promise<string>;
+    buildPromptContextForMode?: (context: any, mode: string, signal?: AbortSignal) => Promise<string>;
+    checkCrossFileReferences: (uri: URI, touchedPaths: Set<string>, signal?: AbortSignal) => Promise<string[]>;
+    executeTool: (toolName: string, input: any, toolCallId?: string, signal?: AbortSignal) => AsyncIterable<CleanSlateStreamPart>;
+    onQuestionPaused?: (toolCall: ParsedToolCall, result: unknown) => void;
+    getToolDescriptions?: () => string;
+}
+/**
+ * A best-effort, non-blocking context contribution. The value is produced off
+ * the critical path (e.g. a warmed semantic-retrieval prefetch) and consumed at
+ * most once, and only if it has already settled — the loop never awaits it.
+ * Context is injected when ready, otherwise the model retrieves it on demand
+ * via its tools.
+ */
+export interface ICleanSlateDeferredContext {
+    /** Returns the formatted context once if it has settled; '' otherwise. Never blocks; consumes at most once. */
+    tryConsume(): string;
+}
+export interface IExecutionRunOptions {
+    stopOnPhaseTransition?: boolean;
+    executionFlow?: CleanSlateExecutionFlow;
+    executionBudget?: ICleanSlateExecutionBudget;
+    /** Warmed semantic context injected into the first turn's context message when ready; never awaited. */
+    deferredSemanticContext?: ICleanSlateDeferredContext;
+}
+export declare class CleanSlateQueryRunner {
+    private readonly executionQueryEngine;
+    private readonly filesModifiedService;
+    constructor(options: IExecutionRunnerOptions);
+    run(messages: IChatMessage[], originalUserMessage: string, uiMode: string, initialContext: any, mentionedFiles: string, activeThreadService: CleanSlateThreadService, activeTaskSessionService: CleanSlateTaskSessionService, signal?: AbortSignal, runOptions?: IExecutionRunOptions): AsyncIterable<CleanSlateStreamPart>;
+    private enrichCompletion;
+    private recordExecutionFilesChanged;
+}
+//# sourceMappingURL=cleanSlateQueryRunner.d.ts.map

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

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

package/dist/agent/cleanSlateQueryRunner.js

@@ -0,0 +1,69 @@
+import { AgentPhase } from './cleanSlatePrompts.js';
+import { CleanSlateExecutionQueryEngine } from './cleanSlateExecutionQuery.js';
+import { CleanSlateFilesModifiedService } from './cleanSlateFilesModifiedService.js';
+import { CleanSlateExecutionBudget } from './cleanSlateExecutionBudget.js';
+export class CleanSlateQueryRunner {
+    constructor(options) {
+        this.filesModifiedService = new CleanSlateFilesModifiedService();
+        this.executionQueryEngine = new CleanSlateExecutionQueryEngine(options);
+    }
+    async *run(messages, originalUserMessage, uiMode, initialContext, mentionedFiles, activeThreadService, activeTaskSessionService, signal, runOptions = {}) {
+        const settings = this.executionQueryEngine.getExecutionLoopSettings();
+        const executionFlow = runOptions.executionFlow ?? settings.executionFlow;
+        const executionBudget = runOptions.executionBudget ?? new CleanSlateExecutionBudget(settings.maxTurns);
+        const effectiveRunOptions = { ...runOptions, executionFlow, executionBudget };
+        const phase = activeTaskSessionService.getPhase();
+        // One loop for everything (refs-faithful): PLANNING is the execution
+        // engine in plan mode (write tools filtered, submit_artifact as the
+        // ExitPlanMode analog), EXECUTION is the engine proper, and there is no
+        // separate verification phase — verification is pre-stop behavior
+        // inside the loop.
+        {
+            const engineRunOptions = phase === AgentPhase.PLANNING
+                ? { ...effectiveRunOptions, phase: AgentPhase.PLANNING }
+                : effectiveRunOptions;
+            for await (const part of this.executionQueryEngine.run(messages, originalUserMessage, uiMode, initialContext, mentionedFiles, activeThreadService, activeTaskSessionService, signal, engineRunOptions)) {
+                if (part.type === 'task_complete') {
+                    const completionState = part.result?.completionState;
+                    if (completionState) {
+                        const filesChanged = this.filesModifiedService.buildFileChanges(completionState.mutatedPaths, completionState.mutationSummaries);
+                        this.recordExecutionFilesChanged(filesChanged, activeTaskSessionService);
+                        yield this.enrichCompletion(part, completionState, filesChanged);
+                        continue;
+                    }
+                }
+                else if (part.type === 'tool_result') {
+                    this.recordExecutionFilesChanged(this.filesModifiedService.buildMutationFileChanges(part.toolName, part.input, part.result), activeTaskSessionService);
+                }
+                yield part;
+            }
+            return;
+        }
+    }
+    enrichCompletion(part, completionState, filesChanged) {
+        const filesModified = this.filesModifiedService.buildOptionalFilesModifiedPayload(filesChanged);
+        const hasChangeEvidenceGap = filesChanged.length === 0 && completionState.successfulMutationsInPhase > 0;
+        return {
+            ...part,
+            result: {
+                ...part.result,
+                ...(filesChanged.length > 0 ? { filesChanged } : {}),
+                completionSummary: {
+                    status: 'completed',
+                    ...(filesModified ?? {}),
+                    ...(hasChangeEvidenceGap ? { changeEvidenceStatus: 'incomplete' } : {}),
+                    ...(completionState.proofSummaries.length > 0 ? { proofSummaries: completionState.proofSummaries } : {}),
+                    ...(completionState.summary ? { summary: completionState.summary } : {})
+                }
+            }
+        };
+    }
+    recordExecutionFilesChanged(filesChanged, activeTaskSessionService) {
+        if (filesChanged.length === 0) {
+            return;
+        }
+        const merged = this.filesModifiedService.mergeFileChanges(activeTaskSessionService.getExecutionFilesChanged(), filesChanged);
+        activeTaskSessionService.recordExecutionFilesChanged(merged);
+    }
+}
+//# sourceMappingURL=cleanSlateQueryRunner.js.map

package/dist/agent/cleanSlateQueryRunner.js.map

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

package/dist/agent/cleanSlateRuntimePromptBuilder.d.ts

@@ -0,0 +1,30 @@
+import { AgentPhase } from './cleanSlatePrompts.js';
+import { ICleanSlatePendingRecoveryState, ICleanSlateRunCheckpoint, ICleanSlateVerificationTarget } from '../services/cleanSlateTaskSessionService.js';
+interface IPhaseObjectivePromptOptions {
+    phase: AgentPhase;
+    latestPlan?: string;
+    userMessage?: string;
+    rootObjective?: string;
+    priorPhaseSummary?: string;
+    continuationContext?: string;
+}
+export declare function buildPhaseObjectivePrompt(options: IPhaseObjectivePromptOptions): string;
+export declare function buildWorkspaceMemoryPrompt(discoveredPaths?: string[], semanticHighlights?: string[]): string;
+export declare function getWebResearchFinalAnswerPrompt(): string;
+interface IContinuationContextPromptOptions {
+    phase: AgentPhase;
+    objective?: string;
+    currentWorkItem?: string;
+    toDo?: string[];
+    discoveredPaths?: string[];
+    semanticHighlights?: string[];
+    lastSummary?: string;
+    lastError?: string;
+    lastToolName?: string;
+    checkpoints?: ICleanSlateRunCheckpoint[];
+    pendingRecovery?: ICleanSlatePendingRecoveryState;
+    verificationTargets?: ICleanSlateVerificationTarget[];
+}
+export declare function buildContinuationContextPrompt(options: IContinuationContextPromptOptions): string;
+export {};
+//# sourceMappingURL=cleanSlateRuntimePromptBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateRuntimePromptBuilder.d.ts","sourceRoot":"","sources":["../../src/agent/cleanSlateRuntimePromptBuilder.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAevJ,UAAU,4BAA4B;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CA6BvF;AAED,wBAAgB,0BAA0B,CACtC,eAAe,GAAE,MAAM,EAAO,EAC9B,kBAAkB,GAAE,MAAM,EAAO,GAClC,MAAM,CAsBR;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED,UAAU,iCAAiC;IACvC,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACzC,eAAe,CAAC,EAAE,+BAA+B,CAAC;IAClD,mBAAmB,CAAC,EAAE,6BAA6B,EAAE,CAAC;CACzD;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,iCAAiC,GAAG,MAAM,CAoDjG"}

package/dist/agent/cleanSlateRuntimePromptBuilder.js

@@ -0,0 +1,99 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) CleanSlate. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { AgentPhase } from './cleanSlatePrompts.js';
+import { EXECUTION_MODIFY_PHASE_OBJECTIVE_PROMPT, EXECUTION_PHASE_OBJECTIVE_RULES, WEB_RESEARCH_PHASE_OBJECTIVE_RULES, WEB_RESEARCH_FINAL_ANSWER_RULES, APPROVED_IMPLEMENTATION_PLAN_LABEL, ORIGINAL_OBJECTIVE_LABEL, EXECUTION_SUMMARY_LABEL, CONTINUATION_CONTEXT_LABEL, KNOWN_DISCOVERED_PATHS_LABEL, KNOWN_SEMANTIC_HIGHLIGHTS_LABEL } from '../composer/instructions/runtimeInstructions.js';
+export function buildPhaseObjectivePrompt(options) {
+    const { phase, latestPlan = '', userMessage = '', rootObjective = '', priorPhaseSummary = '', continuationContext = '' } = options;
+    switch (phase) {
+        case AgentPhase.EXECUTION:
+        case AgentPhase.VERIFICATION:
+            return [
+                EXECUTION_MODIFY_PHASE_OBJECTIVE_PROMPT,
+                ...EXECUTION_PHASE_OBJECTIVE_RULES,
+                ...WEB_RESEARCH_PHASE_OBJECTIVE_RULES,
+                ...WEB_RESEARCH_FINAL_ANSWER_RULES,
+                latestPlan ? `${APPROVED_IMPLEMENTATION_PLAN_LABEL}\n${latestPlan}` : '',
+                rootObjective && rootObjective !== userMessage ? `${ORIGINAL_OBJECTIVE_LABEL}\n${rootObjective}` : '',
+                priorPhaseSummary ? `${EXECUTION_SUMMARY_LABEL}\n${priorPhaseSummary}` : '',
+                continuationContext ? `${CONTINUATION_CONTEXT_LABEL}\n${continuationContext}` : '',
+                userMessage ? `User Instruction:\n${userMessage}` : ''
+            ].filter(Boolean).join('\n\n');
+        case AgentPhase.PLANNING:
+        default:
+            return [
+                'Inspect enough real workspace context to make the plan reliable; choose list, search, read, or symbol tools according to what is actually unknown.',
+                'Keep discovery proportional to the change. Submit the plan once the affected files, integration points, and meaningful risks are grounded.',
+                ...WEB_RESEARCH_PHASE_OBJECTIVE_RULES,
+                ...WEB_RESEARCH_FINAL_ANSWER_RULES,
+                rootObjective && rootObjective !== userMessage ? `${ORIGINAL_OBJECTIVE_LABEL}\n${rootObjective}` : '',
+                continuationContext ? `${CONTINUATION_CONTEXT_LABEL}\n${continuationContext}` : '',
+                userMessage ? `User Instruction:\n${userMessage}` : ''
+            ].filter(Boolean).join('\n\n');
+    }
+}
+export function buildWorkspaceMemoryPrompt(discoveredPaths = [], semanticHighlights = []) {
+    const normalizedDiscoveredPaths = discoveredPaths
+        .map(path => path.trim())
+        .filter(path => path.length > 0)
+        .slice(-12)
+        .map(path => `- ${path}`);
+    const normalizedSemanticHighlights = semanticHighlights
+        .map(item => item.trim())
+        .filter(item => item.length > 0)
+        .slice(-8)
+        .map(item => `- ${item}`);
+    if (normalizedDiscoveredPaths.length === 0 && normalizedSemanticHighlights.length === 0) {
+        return '';
+    }
+    return [
+        '[WORKSPACE CONTEXT]',
+        'Reuse relevant native conversation context while it remains current.',
+        normalizedDiscoveredPaths.length > 0 ? `${KNOWN_DISCOVERED_PATHS_LABEL}:\n${normalizedDiscoveredPaths.join('\n')}` : '',
+        normalizedSemanticHighlights.length > 0 ? `${KNOWN_SEMANTIC_HIGHLIGHTS_LABEL}:\n${normalizedSemanticHighlights.join('\n')}` : ''
+    ].filter(Boolean).join('\n');
+}
+export function getWebResearchFinalAnswerPrompt() {
+    return WEB_RESEARCH_FINAL_ANSWER_RULES.join('\n');
+}
+export function buildContinuationContextPrompt(options) {
+    const { phase, objective, currentWorkItem, toDo = [], discoveredPaths = [], semanticHighlights = [], lastSummary, lastError, lastToolName, checkpoints = [], pendingRecovery, verificationTargets = [] } = options;
+    const recentCheckpoints = checkpoints
+        .filter(checkpoint => typeof checkpoint.summary === 'string' && checkpoint.summary.trim().length > 0)
+        .slice(-5)
+        .map(checkpoint => `- [${checkpoint.kind}] ${checkpoint.summary}`);
+    const normalizedToDo = toDo
+        .map(item => item.trim())
+        .filter(item => item.length > 0)
+        .map(item => `- ${item}`);
+    const normalizedDiscoveredPaths = discoveredPaths
+        .map(path => path.trim())
+        .filter(path => path.length > 0)
+        .slice(-15)
+        .map(path => `- ${path}`);
+    const normalizedSemanticHighlights = semanticHighlights
+        .map(item => item.trim())
+        .filter(item => item.length > 0)
+        .slice(-10)
+        .map(item => `- ${item}`);
+    return [
+        'Resume the active task from the latest saved checkpoint. Do not restart from scratch.',
+        `Current Phase: ${phase}`,
+        objective ? `Task Objective: ${objective}` : '',
+        currentWorkItem ? `Current Work Item: ${currentWorkItem}` : '',
+        lastSummary ? `Latest Summary: ${lastSummary}` : '',
+        lastError ? `Latest Error: ${lastError}` : '',
+        lastToolName ? `Last Tool: ${lastToolName}` : '',
+        pendingRecovery ? `Unresolved Recovery: ${pendingRecovery.prompt}` : '',
+        verificationTargets.filter(target => target.status !== 'verified').length > 0
+            ? `Pending Verification Targets:\n${verificationTargets.filter(target => target.status !== 'verified').map(target => `- ${target.description}`).join('\n')}`
+            : '',
+        normalizedToDo.length > 0 ? `Current To Do:\n${normalizedToDo.join('\n')}` : '',
+        normalizedDiscoveredPaths.length > 0 ? `Discovered Path Memory:\n${normalizedDiscoveredPaths.join('\n')}` : '',
+        normalizedSemanticHighlights.length > 0 ? `Semantic Hotspots:\n${normalizedSemanticHighlights.join('\n')}` : '',
+        recentCheckpoints.length > 0 ? `Recent Checkpoints:\n${recentCheckpoints.join('\n')}` : '',
+        'Continue from the saved state and preserve already completed work.'
+    ].filter(Boolean).join('\n\n');
+}
+//# sourceMappingURL=cleanSlateRuntimePromptBuilder.js.map

package/dist/agent/cleanSlateRuntimePromptBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateRuntimePromptBuilder.js","sourceRoot":"","sources":["../../src/agent/cleanSlateRuntimePromptBuilder.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EACH,uCAAuC,EACvC,+BAA+B,EAC/B,kCAAkC,EAClC,+BAA+B,EAC/B,kCAAkC,EAClC,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,+BAA+B,EAClC,MAAM,iDAAiD,CAAC;AAWzD,MAAM,UAAU,yBAAyB,CAAC,OAAqC;IAC3E,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,WAAW,GAAG,EAAE,EAAE,aAAa,GAAG,EAAE,EAAE,iBAAiB,GAAG,EAAE,EAAE,mBAAmB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEnI,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,UAAU,CAAC,SAAS,CAAC;QAC1B,KAAK,UAAU,CAAC,YAAY;YACxB,OAAO;gBACH,uCAAuC;gBACvC,GAAG,+BAA+B;gBAClC,GAAG,kCAAkC;gBACrC,GAAG,+BAA+B;gBAClC,UAAU,CAAC,CAAC,CAAC,GAAG,kCAAkC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;gBACxE,aAAa,IAAI,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,wBAAwB,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;gBACrG,iBAAiB,CAAC,CAAC,CAAC,GAAG,uBAAuB,KAAK,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE;gBAC3E,mBAAmB,CAAC,CAAC,CAAC,GAAG,0BAA0B,KAAK,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE;gBAClF,WAAW,CAAC,CAAC,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;aACzD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,UAAU,CAAC,QAAQ,CAAC;QACzB;YACI,OAAO;gBACH,oJAAoJ;gBACpJ,4IAA4I;gBAC5I,GAAG,kCAAkC;gBACrC,GAAG,+BAA+B;gBAClC,aAAa,IAAI,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,wBAAwB,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;gBACrG,mBAAmB,CAAC,CAAC,CAAC,GAAG,0BAA0B,KAAK,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE;gBAClF,WAAW,CAAC,CAAC,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;aACzD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACtC,kBAA4B,EAAE,EAC9B,qBAA+B,EAAE;IAEjC,MAAM,yBAAyB,GAAG,eAAe;SAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,KAAK,CAAC,CAAC,EAAE,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9B,MAAM,4BAA4B,GAAG,kBAAkB;SAClD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,KAAK,CAAC,CAAC,CAAC,CAAC;SACT,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAE9B,IAAI,yBAAyB,CAAC,MAAM,KAAK,CAAC,IAAI,4BAA4B,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,CAAC;IACd,CAAC;IAED,OAAO;QACT,qBAAqB;QACrB,sEAAsE;QAChE,yBAAyB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,4BAA4B,MAAM,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QACvH,4BAA4B,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,+BAA+B,MAAM,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;KACnI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC3C,OAAO,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAiBD,MAAM,UAAU,8BAA8B,CAAC,OAA0C;IACrF,MAAM,EACF,KAAK,EACL,SAAS,EACT,eAAe,EACf,IAAI,GAAG,EAAE,EACT,eAAe,GAAG,EAAE,EACpB,kBAAkB,GAAG,EAAE,EACvB,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,GAAG,EAAE,EAChB,eAAe,EACf,mBAAmB,GAAG,EAAE,EAC3B,GAAG,OAAO,CAAC;IACZ,MAAM,iBAAiB,GAAG,WAAW;SAChC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACpG,KAAK,CAAC,CAAC,CAAC,CAAC;SACT,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE,MAAM,cAAc,GAAG,IAAI;SACtB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9B,MAAM,yBAAyB,GAAG,eAAe;SAC5C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,KAAK,CAAC,CAAC,EAAE,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9B,MAAM,4BAA4B,GAAG,kBAAkB;SAClD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,KAAK,CAAC,CAAC,EAAE,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAE9B,OAAO;QACH,uFAAuF;QACvF,kBAAkB,KAAK,EAAE;QACzB,SAAS,CAAC,CAAC,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;QAC/C,eAAe,CAAC,CAAC,CAAC,sBAAsB,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE;QAC9D,WAAW,CAAC,CAAC,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;QACnD,SAAS,CAAC,CAAC,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7C,YAAY,CAAC,CAAC,CAAC,cAAc,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAChD,eAAe,CAAC,CAAC,CAAC,wBAAwB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;QACvE,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC;YACzE,CAAC,CAAC,kCAAkC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC5J,CAAC,CAAC,EAAE;QACR,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC/E,yBAAyB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,4BAA4B,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC9G,4BAA4B,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC/G,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC1F,oEAAoE;KACvE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/agent/cleanSlateStreamingToolExecutor.d.ts

@@ -0,0 +1,55 @@
+import { CleanSlateStreamPart, ParsedToolCall } from './cleanSlateAgentTypes.js';
+export interface ICleanSlateStreamingToolExecution {
+    toolCall: ParsedToolCall;
+    index: number;
+    parts: CleanSlateStreamPart[];
+    result: any;
+}
+export interface ICleanSlateStreamingToolPartBatch {
+    toolCall: ParsedToolCall;
+    index: number;
+    parts: CleanSlateStreamPart[];
+}
+export type CleanSlateStreamingToolEvent = {
+    type: 'parts';
+    batch: ICleanSlateStreamingToolPartBatch;
+} | {
+    type: 'execution';
+    execution: ICleanSlateStreamingToolExecution;
+};
+export interface ICleanSlateStreamingToolExecutorOptions {
+    isConcurrencySafe: (toolCall: ParsedToolCall) => boolean;
+    executeTool: (toolCall: ParsedToolCall, signal?: AbortSignal) => AsyncIterable<CleanSlateStreamPart>;
+    signal?: AbortSignal;
+    emitAbortedResults?: boolean;
+}
+/**
+ * Orders streamed tool parts while allowing explicitly safe tools to execute in parallel.
+ * Phase policy and tool validation remain the caller's responsibility.
+ */
+export declare class CleanSlateStreamingToolExecutor {
+    private readonly options;
+    private readonly tools;
+    private readonly wakeQueue;
+    constructor(options: ICleanSlateStreamingToolExecutorOptions);
+    addTool(toolCall: ParsedToolCall, index: number): void;
+    getReadyPartBatches(): Iterable<ICleanSlateStreamingToolPartBatch>;
+    getCompletedResults(): Iterable<ICleanSlateStreamingToolExecution>;
+    hasUnfinishedWork(): boolean;
+    nextEvent(): Promise<CleanSlateStreamingToolEvent | undefined>;
+    getRemainingEvents(): AsyncIterable<CleanSlateStreamingToolEvent>;
+    getRemainingResults(): AsyncIterable<ICleanSlateStreamingToolExecution>;
+    private processQueue;
+    private startTool;
+    private collectToolParts;
+    /**
+     * A tool may start when nothing is in flight, or when it and everything
+     * already running are all safe to overlap. One unsafe tool anywhere in the
+     * set serializes the whole queue.
+     */
+    private canExecuteTool;
+    private hasExecutingTools;
+    private hasUnfinishedTools;
+    private toExecution;
+}
+//# sourceMappingURL=cleanSlateStreamingToolExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateStreamingToolExecutor.d.ts","sourceRoot":"","sources":["../../src/agent/cleanSlateStreamingToolExecutor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE7F,MAAM,WAAW,iCAAiC;IACjD,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,iCAAiC;IACjD,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,4BAA4B,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,iCAAiC,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,iCAAiC,CAAA;CAAE,CAAC;AAcvE,MAAM,WAAW,uCAAuC;IACvD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC;IACzD,WAAW,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACrG,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,+BAA+B;IAI/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAEvB,OAAO,EAAE,uCAAuC;IAEtE,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAapD,mBAAmB,IAAI,QAAQ,CAAC,iCAAiC,CAAC;IAgBlE,mBAAmB,IAAI,QAAQ,CAAC,iCAAiC,CAAC;IAgBpE,iBAAiB,IAAI,OAAO;IAItB,SAAS,IAAI,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC;IAyB5D,kBAAkB,IAAI,aAAa,CAAC,4BAA4B,CAAC;IA2BjE,mBAAmB,IAAI,aAAa,CAAC,iCAAiC,CAAC;YAuCxE,YAAY;IAkB1B,OAAO,CAAC,SAAS;YAiBH,gBAAgB;IAa9B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,WAAW;CAKnB"}