@cleanslate/sdk 0.1.0

package/dist/agent/cleanSlateStreamingToolExecutor.js

@@ -0,0 +1,214 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { AsyncQueue } from './cleanSlateAgentTypes.js';
+/**
+ * Orders streamed tool parts while allowing explicitly safe tools to execute in parallel.
+ * Phase policy and tool validation remain the caller's responsibility.
+ */
+export class CleanSlateStreamingToolExecutor {
+    constructor(options) {
+        this.options = options;
+        this.tools = [];
+        this.wakeQueue = new AsyncQueue();
+    }
+    addTool(toolCall, index) {
+        this.tools.push({
+            toolCall,
+            index,
+            status: 'queued',
+            isConcurrencySafe: this.options.isConcurrencySafe(toolCall),
+            parts: [],
+            yieldedPartCount: 0,
+            result: undefined
+        });
+        void this.processQueue();
+    }
+    *getReadyPartBatches() {
+        for (const tool of this.tools) {
+            if (tool.status === 'yielded' || tool.yieldedPartCount >= tool.parts.length) {
+                continue;
+            }
+            const parts = tool.parts.slice(tool.yieldedPartCount);
+            tool.yieldedPartCount = tool.parts.length;
+            yield { toolCall: tool.toolCall, index: tool.index, parts };
+            if (tool.status === 'executing' && !tool.isConcurrencySafe) {
+                break;
+            }
+        }
+    }
+    *getCompletedResults() {
+        for (const tool of this.tools) {
+            if (tool.status === 'yielded') {
+                continue;
+            }
+            if (tool.status === 'completed') {
+                tool.status = 'yielded';
+                yield this.toExecution(tool);
+                continue;
+            }
+            if (tool.status === 'executing' && !tool.isConcurrencySafe) {
+                break;
+            }
+        }
+    }
+    hasUnfinishedWork() {
+        return this.hasUnfinishedTools();
+    }
+    async nextEvent() {
+        while (this.hasUnfinishedTools() && !this.options.signal?.aborted) {
+            await this.processQueue();
+            for (const batch of this.getReadyPartBatches()) {
+                return { type: 'parts', batch };
+            }
+            for (const execution of this.getCompletedResults()) {
+                return { type: 'execution', execution };
+            }
+            if (this.hasExecutingTools()) {
+                await this.wakeQueue.next();
+            }
+            else {
+                break;
+            }
+        }
+        for (const batch of this.getReadyPartBatches()) {
+            return { type: 'parts', batch };
+        }
+        for (const execution of this.getCompletedResults()) {
+            return { type: 'execution', execution };
+        }
+        return undefined;
+    }
+    async *getRemainingEvents() {
+        while (this.hasUnfinishedTools() && !this.options.signal?.aborted) {
+            await this.processQueue();
+            let yielded = false;
+            for (const batch of this.getReadyPartBatches()) {
+                yielded = true;
+                yield { type: 'parts', batch };
+            }
+            for (const execution of this.getCompletedResults()) {
+                yielded = true;
+                yield { type: 'execution', execution };
+            }
+            if (!yielded && this.hasExecutingTools()) {
+                await this.wakeQueue.next();
+            }
+            else if (!yielded) {
+                break;
+            }
+        }
+        for (const batch of this.getReadyPartBatches()) {
+            yield { type: 'parts', batch };
+        }
+        for (const execution of this.getCompletedResults()) {
+            yield { type: 'execution', execution };
+        }
+    }
+    async *getRemainingResults() {
+        while (this.hasUnfinishedTools() && !this.options.signal?.aborted) {
+            await this.processQueue();
+            let yielded = false;
+            for (const execution of this.getCompletedResults()) {
+                yielded = true;
+                yield execution;
+            }
+            if (!yielded && this.hasExecutingTools()) {
+                await this.wakeQueue.next();
+            }
+            else if (!yielded) {
+                break;
+            }
+        }
+        if (this.options.signal?.aborted && this.options.emitAbortedResults) {
+            for (const tool of this.tools) {
+                if (tool.status === 'yielded') {
+                    continue;
+                }
+                if (!tool.result) {
+                    tool.result = {
+                        success: false,
+                        code: 'tool_execution_aborted',
+                        message: 'Tool execution was aborted before a result was produced.'
+                    };
+                    tool.parts.push({ type: 'tool_result', toolName: tool.toolCall.toolName, result: tool.result });
+                }
+                tool.status = 'yielded';
+                yield this.toExecution(tool);
+            }
+            return;
+        }
+        for (const execution of this.getCompletedResults()) {
+            yield execution;
+        }
+    }
+    async processQueue() {
+        for (const tool of this.tools) {
+            if (this.options.signal?.aborted) {
+                return;
+            }
+            if (tool.status !== 'queued') {
+                continue;
+            }
+            if (!this.canExecuteTool(tool.isConcurrencySafe)) {
+                if (!tool.isConcurrencySafe) {
+                    break;
+                }
+                continue;
+            }
+            this.startTool(tool);
+        }
+    }
+    startTool(tool) {
+        tool.status = 'executing';
+        this.collectToolParts(tool)
+            .catch(error => {
+            const result = { success: false, error: error instanceof Error ? error.message : String(error) };
+            tool.parts.push({ type: 'tool_result', toolName: tool.toolCall.toolName, result });
+            tool.result = result;
+        })
+            .finally(() => {
+            if (tool.status !== 'yielded') {
+                tool.status = 'completed';
+            }
+            this.wakeQueue.push(undefined);
+            void this.processQueue();
+        });
+    }
+    async collectToolParts(tool) {
+        for await (const part of this.options.executeTool(tool.toolCall, this.options.signal)) {
+            if (this.options.signal?.aborted) {
+                break;
+            }
+            tool.parts.push(part);
+            if (part.type === 'tool_result') {
+                tool.result = part.result;
+            }
+            this.wakeQueue.push(undefined);
+        }
+    }
+    /**
+     * 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.
+     */
+    canExecuteTool(isConcurrencySafe) {
+        if (!isConcurrencySafe) {
+            return !this.hasExecutingTools();
+        }
+        return this.tools.every(tool => tool.status !== 'executing' || tool.isConcurrencySafe);
+    }
+    hasExecutingTools() {
+        return this.tools.some(tool => tool.status === 'executing');
+    }
+    hasUnfinishedTools() {
+        return this.tools.some(tool => tool.status !== 'yielded');
+    }
+    toExecution(tool) {
+        const parts = tool.parts.slice(tool.yieldedPartCount);
+        tool.yieldedPartCount = tool.parts.length;
+        return { toolCall: tool.toolCall, index: tool.index, parts, result: tool.result };
+    }
+}
+//# sourceMappingURL=cleanSlateStreamingToolExecutor.js.map

package/dist/agent/cleanSlateStreamingToolExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateStreamingToolExecutor.js","sourceRoot":"","sources":["../../src/agent/cleanSlateStreamingToolExecutor.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,UAAU,EAAwC,MAAM,2BAA2B,CAAC;AAsC7F;;;GAGG;AACH,MAAM,OAAO,+BAA+B;IAI3C,YAA6B,OAAgD;QAAhD,YAAO,GAAP,OAAO,CAAyC;QAH5D,UAAK,GAA4B,EAAE,CAAC;QACpC,cAAS,GAAG,IAAI,UAAU,EAAQ,CAAC;IAE6B,CAAC;IAE3E,OAAO,CAAC,QAAwB,EAAE,KAAa;QACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACf,QAAQ;YACR,KAAK;YACL,MAAM,EAAE,QAAQ;YAChB,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YAC3D,KAAK,EAAE,EAAE;YACT,gBAAgB,EAAE,CAAC;YACnB,MAAM,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;IAC1B,CAAC;IAEM,CAAE,mBAAmB;QAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7E,SAAS;YACV,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACtD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1C,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;YAE5D,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5D,MAAM;YACP,CAAC;QACF,CAAC;IACF,CAAC;IAEM,CAAE,mBAAmB;QAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,SAAS;YACV,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACjC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBACxB,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC7B,SAAS;YACV,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5D,MAAM;YACP,CAAC;QACF,CAAC;IACF,CAAC;IAEM,iBAAiB;QACvB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,SAAS;QACrB,OAAO,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACnE,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACjC,CAAC;YACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;YACzC,CAAC;YACD,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;gBAC9B,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACP,MAAM;YACP,CAAC;QACF,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACzC,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,CAAE,kBAAkB;QAChC,OAAO,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACnE,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBAChD,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAChC,CAAC;YACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBACpD,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;YACxC,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;gBAC1C,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7B,CAAC;iBAAM,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM;YACP,CAAC;QACF,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAChD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAChC,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YACpD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACxC,CAAC;IACF,CAAC;IAEM,KAAK,CAAC,CAAE,mBAAmB;QACjC,OAAO,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACnE,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBACpD,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,SAAS,CAAC;YACjB,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;gBAC1C,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC7B,CAAC;iBAAM,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM;YACP,CAAC;QACF,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;YACrE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/B,SAAS;gBACV,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBAClB,IAAI,CAAC,MAAM,GAAG;wBACb,OAAO,EAAE,KAAK;wBACd,IAAI,EAAE,wBAAwB;wBAC9B,OAAO,EAAE,0DAA0D;qBACnE,CAAC;oBACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjG,CAAC;gBACD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBACxB,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO;QACR,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YACpD,MAAM,SAAS,CAAC;QACjB,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,YAAY;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAClC,OAAO;YACR,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC9B,SAAS;YACV,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBAC7B,MAAM;gBACP,CAAC;gBACD,SAAS;YACV,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IAEO,SAAS,CAAC,IAA2B;QAC5C,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;aACzB,KAAK,CAAC,KAAK,CAAC,EAAE;YACd,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACjG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACtB,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACb,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;YAC3B,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,IAA2B;QACzD,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACvF,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBAClC,MAAM;YACP,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,iBAA0B;QAChD,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxF,CAAC;IAEO,iBAAiB;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IAC7D,CAAC;IAEO,kBAAkB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAC3D,CAAC;IAEO,WAAW,CAAC,IAA2B;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACtD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC1C,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACnF,CAAC;CACD"}

package/dist/agent/cleanSlateToolCallLedger.d.ts

@@ -0,0 +1,32 @@
+import { ParsedToolCall } from './cleanSlateAgentTypes.js';
+export interface ICleanSlateToolCallLedgerOptions {
+    availableToolNames: Iterable<string>;
+    validateToolCall?: (toolCall: ParsedToolCall) => string | undefined;
+    loopThreshold?: number;
+}
+export interface ICleanSlateToolCallDecision {
+    toolCall: ParsedToolCall;
+    accepted: boolean;
+    result?: any;
+}
+export declare class CleanSlateToolCallLedger {
+    private readonly options;
+    private static readonly DEFAULT_LOOP_THRESHOLD;
+    private static readonly TOOL_ALIASES;
+    private readonly availableToolNames;
+    private readonly availableToolNamesByLower;
+    private readonly currentTurnKeys;
+    private readonly recentExecutionKeys;
+    private readonly loopThreshold;
+    constructor(options: ICleanSlateToolCallLedgerOptions);
+    beginTurn(): void;
+    normalizeToolCall(toolCall: ParsedToolCall): ParsedToolCall;
+    getTurnKey(toolCall: ParsedToolCall): string;
+    shouldAcceptInCurrentTurn(toolCall: ParsedToolCall): boolean;
+    prepareForExecution(toolCall: ParsedToolCall): ICleanSlateToolCallDecision;
+    recordResult(toolCall: ParsedToolCall, result: any): void;
+    private repairToolName;
+    private getSemanticKey;
+    private buildMalformedRecoveryHint;
+}
+//# sourceMappingURL=cleanSlateToolCallLedger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateToolCallLedger.d.ts","sourceRoot":"","sources":["../../src/agent/cleanSlateToolCallLedger.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,WAAW,gCAAgC;IAChD,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;CACb;AAED,qBAAa,wBAAwB;IAqBxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IApBpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAK;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAWlC;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA6B;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAEV,OAAO,EAAE,gCAAgC;IAQ/D,SAAS,IAAI,IAAI;IAIjB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;IAqB3D,UAAU,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM;IAI5C,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAS5D,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,2BAA2B;IAyD1E,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAKhE,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,0BAA0B;CAuBlC"}

package/dist/agent/cleanSlateToolCallLedger.js

@@ -0,0 +1,164 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+export class CleanSlateToolCallLedger {
+    static { this.DEFAULT_LOOP_THRESHOLD = 3; }
+    static { this.TOOL_ALIASES = {
+        codebase_search: 'semantic_search',
+        rag_search: 'semantic_search',
+        workspace_search: 'search_workspace',
+        search_files: 'search_workspace',
+        grep: 'grep_search',
+        readfile: 'read_file',
+        readfilerange: 'read_file_range',
+        apply_patch: 'apply_edit',
+        edit_file: 'apply_edit',
+        create_and_write_file: 'write_file'
+    }; }
+    constructor(options) {
+        this.options = options;
+        this.availableToolNames = new Set();
+        this.availableToolNamesByLower = new Map();
+        this.currentTurnKeys = new Set();
+        this.recentExecutionKeys = [];
+        for (const toolName of options.availableToolNames) {
+            this.availableToolNames.add(toolName);
+            this.availableToolNamesByLower.set(toolName.toLowerCase(), toolName);
+        }
+        this.loopThreshold = Math.max(2, Math.floor(options.loopThreshold ?? CleanSlateToolCallLedger.DEFAULT_LOOP_THRESHOLD));
+    }
+    beginTurn() {
+        this.currentTurnKeys.clear();
+    }
+    normalizeToolCall(toolCall) {
+        const repairedName = this.repairToolName(toolCall.toolName);
+        const normalizedInput = toolCall.toolName.trim().toLowerCase() === 'create_and_write_file'
+            && repairedName === 'write_file'
+            && typeof toolCall.input?.file_path !== 'string'
+            && typeof toolCall.input?.path === 'string'
+            ? (() => {
+                const { path, ...rest } = toolCall.input;
+                return { ...rest, file_path: path };
+            })()
+            : toolCall.input;
+        if (repairedName === toolCall.toolName && normalizedInput === toolCall.input) {
+            return toolCall;
+        }
+        return {
+            ...toolCall,
+            toolName: repairedName,
+            input: normalizedInput
+        };
+    }
+    getTurnKey(toolCall) {
+        return this.getSemanticKey(this.normalizeToolCall(toolCall));
+    }
+    shouldAcceptInCurrentTurn(toolCall) {
+        const key = this.getTurnKey(toolCall);
+        if (this.currentTurnKeys.has(key)) {
+            return false;
+        }
+        this.currentTurnKeys.add(key);
+        return true;
+    }
+    prepareForExecution(toolCall) {
+        const normalizedToolCall = this.normalizeToolCall(toolCall);
+        const semanticKey = this.getSemanticKey(normalizedToolCall);
+        this.recentExecutionKeys.push(semanticKey);
+        if (this.recentExecutionKeys.length > this.loopThreshold) {
+            this.recentExecutionKeys.shift();
+        }
+        if (this.recentExecutionKeys.length === this.loopThreshold
+            && this.recentExecutionKeys.every(key => key === semanticKey)) {
+            return {
+                toolCall: normalizedToolCall,
+                accepted: false,
+                result: {
+                    success: false,
+                    code: 'tool_call_loop_detected',
+                    message: `The same tool call was repeated ${this.loopThreshold} times.`,
+                    recoveryHint: 'Do not repeat the same arguments. Re-read narrower context, choose a different tool, or change the edit/input before trying again.'
+                }
+            };
+        }
+        if (!this.availableToolNames.has(normalizedToolCall.toolName)) {
+            return {
+                toolCall: normalizedToolCall,
+                accepted: false,
+                result: {
+                    success: false,
+                    code: 'unknown_tool',
+                    requestedTool: toolCall.toolName,
+                    toolName: normalizedToolCall.toolName,
+                    message: `Tool "${toolCall.toolName}" is unavailable in this execution surface.`,
+                    recoveryHint: 'Use one of the currently exposed tools instead of inventing or aliasing a new tool name.'
+                }
+            };
+        }
+        const validationError = this.options.validateToolCall?.(normalizedToolCall);
+        if (validationError) {
+            return {
+                toolCall: normalizedToolCall,
+                accepted: false,
+                result: {
+                    success: false,
+                    code: 'malformed_tool_call',
+                    message: validationError,
+                    recoveryHint: this.buildMalformedRecoveryHint(normalizedToolCall, validationError)
+                }
+            };
+        }
+        return {
+            toolCall: normalizedToolCall,
+            accepted: true
+        };
+    }
+    recordResult(toolCall, result) {
+        void toolCall;
+        void result;
+    }
+    repairToolName(toolName) {
+        const stripped = toolName.trim().startsWith('functions.')
+            ? toolName.trim().slice('functions.'.length)
+            : toolName.trim();
+        const lower = stripped.toLowerCase();
+        const alias = CleanSlateToolCallLedger.TOOL_ALIASES[lower];
+        if (alias && this.availableToolNames.has(alias)) {
+            return alias;
+        }
+        return this.availableToolNamesByLower.get(lower) ?? stripped;
+    }
+    getSemanticKey(toolCall) {
+        try {
+            return `${toolCall.toolName}:${JSON.stringify(toolCall.input ?? {})}`;
+        }
+        catch {
+            return `${toolCall.toolName}:${String(toolCall.input)}`;
+        }
+    }
+    buildMalformedRecoveryHint(toolCall, validationError) {
+        if (toolCall.toolName === 'apply_edit') {
+            const path = typeof toolCall.input?.file_path === 'string' && toolCall.input.file_path.trim().length > 0
+                ? toolCall.input.file_path.trim()
+                : undefined;
+            return [
+                'The model emitted a malformed apply_edit call.',
+                path ? `Target path: ${path}.` : 'No target path was provided.',
+                validationError,
+                path
+                    ? 'Retry apply_edit with file_path, the exact current old_string, and new_string.'
+                    : 'Choose the target file, read it, then retry apply_edit with file_path, old_string, and new_string.'
+            ].join(' ');
+        }
+        if (toolCall.toolName === 'multi_file_replace') {
+            return [
+                'The model emitted a malformed multi_file_replace call.',
+                validationError,
+                'Retry with edits: Array<{ file_path, old_string, new_string, replace_all? }>.'
+            ].join(' ');
+        }
+        return validationError;
+    }
+}
+//# sourceMappingURL=cleanSlateToolCallLedger.js.map

package/dist/agent/cleanSlateToolCallLedger.js.map

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

package/dist/agent/cleanSlateToolResultPromptSerializer.d.ts

@@ -0,0 +1,9 @@
+export declare function serializeToolResultForPrompt(toolName: string, result: unknown, maxChars?: number): string;
+export declare function sanitizeToolResultForRuntime(toolName: string, result: unknown): unknown;
+/**
+ * Keeps the runtime result bounded while retaining the small slice of browser
+ * image evidence that the transcript can actually display. Prompt serialization
+ * sanitizes this value again, so raw media never enters model context.
+ */
+export declare function sanitizeToolResultForRenderer(toolName: string, result: unknown): unknown;
+//# sourceMappingURL=cleanSlateToolResultPromptSerializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanSlateToolResultPromptSerializer.d.ts","sourceRoot":"","sources":["../../src/agent/cleanSlateToolResultPromptSerializer.ts"],"names":[],"mappings":"AAaA,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIzG;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAcxF"}

package/dist/agent/cleanSlateToolResultPromptSerializer.js

@@ -0,0 +1,184 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+const DEFAULT_MAX_CHARS = 12000;
+const MAX_STRING_CHARS = 3000;
+const MAX_BODY_TEXT_CHARS = 1200;
+const MAX_ELEMENTS = 30;
+const MAX_ARRAY_ITEMS = 40;
+const MAX_OBJECT_KEYS = 40;
+const MAX_DEPTH = 5;
+export function serializeToolResultForPrompt(toolName, result, maxChars) {
+    const sanitized = sanitizeToolResultForRuntime(toolName, result);
+    const serialized = safeJsonStringify(sanitized);
+    return clampForPrompt(serialized, maxChars ?? (isFileReadTool(toolName) ? Number.POSITIVE_INFINITY : DEFAULT_MAX_CHARS));
+}
+export function sanitizeToolResultForRuntime(toolName, result) {
+    return sanitizeToolResult(result, toolName, 0, new WeakSet());
+}
+/**
+ * Keeps the runtime result bounded while retaining the small slice of browser
+ * image evidence that the transcript can actually display. Prompt serialization
+ * sanitizes this value again, so raw media never enters model context.
+ */
+export function sanitizeToolResultForRenderer(toolName, result) {
+    const sanitized = sanitizeToolResultForRuntime(toolName, result);
+    if (!result || typeof result !== 'object' || !sanitized || typeof sanitized !== 'object') {
+        return sanitized;
+    }
+    if (toolName === 'browser_screenshot') {
+        return restoreBrowserScreenshotPayload(sanitized, result);
+    }
+    return sanitized;
+}
+function restoreBrowserScreenshotPayload(sanitized, source) {
+    return typeof source.base64 === 'string' && source.base64.length > 0
+        ? { ...sanitized, base64: source.base64 }
+        : sanitized;
+}
+function sanitizeToolResult(value, toolName, depth, seen) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return clampString(value, MAX_STRING_CHARS);
+    }
+    if (typeof value !== 'object') {
+        return value;
+    }
+    if (seen.has(value)) {
+        return '[Circular]';
+    }
+    if (depth >= MAX_DEPTH) {
+        return `[Object omitted after depth ${MAX_DEPTH}]`;
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        const items = value.slice(0, MAX_ARRAY_ITEMS).map(item => sanitizeToolResult(item, toolName, depth + 1, seen));
+        if (value.length > MAX_ARRAY_ITEMS) {
+            items.push(`[${value.length - MAX_ARRAY_ITEMS} item(s) omitted]`);
+        }
+        return items;
+    }
+    const source = value;
+    if (isBrowserScreenshotObject(source)) {
+        return {
+            position: source.position,
+            mimeType: source.mimeType,
+            base64: summarizeBase64(source.base64)
+        };
+    }
+    return sanitizePlainObject(source, toolName, depth, seen);
+}
+function sanitizePlainObject(source, toolName, depth, seen, omitKeys = new Set()) {
+    const target = {};
+    let written = 0;
+    for (const [key, rawValue] of Object.entries(source)) {
+        if (omitKeys.has(key)) {
+            continue;
+        }
+        if (key === 'content' && isFileReadTool(toolName) && typeof rawValue === 'string') {
+            // File reads already enforce their own complete-read/range budget. Do
+            // not run successful file content through the generic 3k string clamp:
+            // that created a false partial read and made the model read it again.
+            target[key] = rawValue;
+        }
+        else if (key === 'base64' && typeof rawValue === 'string') {
+            target[key] = summarizeBase64(rawValue);
+        }
+        else if (key === 'bodyText' && typeof rawValue === 'string') {
+            target[key] = clampString(rawValue, MAX_BODY_TEXT_CHARS);
+        }
+        else if (key === 'elements' && Array.isArray(rawValue)) {
+            target[key] = rawValue.slice(0, MAX_ELEMENTS).map(element => sanitizeBrowserElement(element, seen));
+            if (rawValue.length > MAX_ELEMENTS) {
+                target.elementCount = rawValue.length;
+            }
+        }
+        else if (key === 'screenshots' && Array.isArray(rawValue)) {
+            target[key] = rawValue.map(screenshot => sanitizeBrowserScreenshot(screenshot));
+            target.screenshotCount = rawValue.length;
+        }
+        else {
+            target[key] = sanitizeToolResult(rawValue, toolName, depth + 1, seen);
+        }
+        written++;
+        if (written >= MAX_OBJECT_KEYS) {
+            target.__omittedKeys = Math.max(0, Object.keys(source).length - written);
+            break;
+        }
+    }
+    return target;
+}
+function isFileReadTool(toolName) {
+    return toolName === 'read_file' || toolName === 'read_file_range';
+}
+function sanitizeBrowserElement(value, seen) {
+    if (!value || typeof value !== 'object') {
+        return value;
+    }
+    const element = value;
+    return sanitizePlainObject({
+        id: element.id,
+        tagName: element.tagName,
+        role: element.role,
+        name: typeof element.name === 'string' ? clampString(element.name, 300) : element.name,
+        testId: element.testId,
+        text: typeof element.text === 'string' ? clampString(element.text, 500) : element.text,
+        ariaLabel: typeof element.ariaLabel === 'string' ? clampString(element.ariaLabel, 300) : element.ariaLabel,
+        placeholder: typeof element.placeholder === 'string' ? clampString(element.placeholder, 300) : element.placeholder,
+        href: element.href,
+        type: element.type,
+        checked: element.checked,
+        disabled: element.disabled,
+        selector: element.selector,
+        boundingBox: element.boundingBox,
+        visual: element.visual
+    }, 'browser_element', 0, seen);
+}
+function sanitizeBrowserScreenshot(value) {
+    if (!value || typeof value !== 'object') {
+        return value;
+    }
+    const screenshot = value;
+    return {
+        position: screenshot.position,
+        mimeType: screenshot.mimeType,
+        base64: typeof screenshot.base64 === 'string' ? summarizeBase64(screenshot.base64) : screenshot.base64
+    };
+}
+function isBrowserScreenshotObject(value) {
+    return typeof value.base64 === 'string'
+        && (value.mimeType === 'image/jpeg' || value.mimeType === 'image/png' || typeof value.position === 'string');
+}
+function summarizeBase64(value) {
+    return typeof value === 'string'
+        ? `[base64 omitted: ${value.length} chars]`
+        : '[base64 omitted]';
+}
+function safeJsonStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch (error) {
+        return JSON.stringify({
+            success: false,
+            code: 'tool_result_serialization_failed',
+            message: error.message
+        });
+    }
+}
+function clampString(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, maxChars - 80))}\n...[truncated ${value.length - maxChars} chars]`;
+}
+function clampForPrompt(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, maxChars - 100))}\n...[truncated ${value.length - maxChars} chars]`;
+}
+//# sourceMappingURL=cleanSlateToolResultPromptSerializer.js.map

package/dist/agent/cleanSlateToolResultPromptSerializer.js.map

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

package/dist/composer/commands/slashCommands.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Slash command definitions
+ */
+export declare const SLASH_COMMANDS: Record<string, {
+    instruction: string;
+    defaultMessage: string;
+}>;
+//# sourceMappingURL=slashCommands.d.ts.map