@cleanslate/sdk 1.0.8 → 1.0.10

package/dist/node/externalAgents/externalFileSnapshots.js

@@ -0,0 +1,105 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) CleanSlate. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { readdir, readFile, realpath, lstat } from 'node:fs/promises';
+import { join, resolve, relative, isAbsolute, sep } from 'node:path';
+/** Turn-local file evidence. Never changes the workspace or the user's Git index. */
+export class ExternalFileSnapshots {
+    constructor(root, requestedRoot) {
+        this.root = root;
+        this.requestedRoot = requestedRoot;
+        this.files = new Map();
+        this.directories = new Set();
+        this.excludedDirectories = new Set();
+        this.bytes = 0;
+    }
+    static async capture(cwd) {
+        const snapshot = new ExternalFileSnapshots(await realpath(cwd), resolve(cwd));
+        await snapshot.scan(snapshot.root);
+        return snapshot;
+    }
+    async text(path) {
+        const stat = await lstat(path);
+        if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 2 * 1024 * 1024) {
+            return undefined;
+        }
+        const content = await readFile(path);
+        if (content.includes(0)) {
+            return undefined;
+        }
+        return new TextDecoder('utf-8', { fatal: true }).decode(content);
+    }
+    async scan(directory) {
+        const entries = await readdir(directory, { withFileTypes: true });
+        this.directories.add(directory);
+        for (const entry of entries) {
+            const path = join(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (['.git', 'node_modules', '.build', 'dist', 'out', '.next', '.venv', 'venv'].includes(entry.name)) {
+                    this.excludedDirectories.add(path);
+                }
+                else {
+                    await this.scan(path).catch(() => { this.excludedDirectories.add(path); });
+                }
+            }
+            else if (entry.isFile()) {
+                this.files.set(path, undefined);
+                if (this.bytes < 64 * 1024 * 1024) {
+                    const content = await this.text(path).catch(() => undefined);
+                    if (content !== undefined) {
+                        this.files.set(path, content);
+                        this.bytes += Buffer.byteLength(content);
+                    }
+                }
+            }
+            else {
+                this.files.set(path, undefined);
+                this.excludedDirectories.add(path);
+            }
+        }
+    }
+    async changes(event) {
+        const changes = [];
+        for (const location of new Set(event.locations ?? [])) {
+            const requested = resolve(this.requestedRoot, location);
+            const requestedRelative = relative(this.requestedRoot, requested);
+            const canonicalRelative = relative(this.root, requested);
+            const alreadyCanonical = canonicalRelative !== '..' && !canonicalRelative.startsWith(`..${sep}`) && !isAbsolute(canonicalRelative);
+            const path = alreadyCanonical ? requested : resolve(this.root, requestedRelative);
+            const local = relative(this.root, path);
+            if (!local || local === '..' || local.startsWith(`..${sep}`) || isAbsolute(local)) {
+                continue;
+            }
+            const actual = await realpath(path).catch(() => undefined);
+            if (actual !== path) {
+                continue;
+            }
+            const before = this.files.get(path);
+            if (this.files.has(path) && before === undefined) {
+                continue;
+            }
+            // Absence is evidence only in a directory inspected before execution.
+            let parent = resolve(path, '..');
+            let excluded = false;
+            while (!this.directories.has(parent)) {
+                if (this.excludedDirectories.has(parent) || parent === this.root) {
+                    excluded = true;
+                    break;
+                }
+                parent = resolve(parent, '..');
+            }
+            if (excluded) {
+                continue;
+            }
+            const after = await this.text(path).catch(() => undefined);
+            if (after === undefined || after === before) {
+                continue;
+            }
+            changes.push({ path, beforeContent: before ?? '', afterContent: after, created: !this.files.has(path) });
+            this.files.set(path, after);
+        }
+        return changes.length ? changes : undefined;
+    }
+}
+//# sourceMappingURL=externalFileSnapshots.js.map

package/dist/node/externalAgents/externalFileSnapshots.js.map

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

package/dist/node/externalAgents/hostToolsBridge.d.ts

@@ -0,0 +1,9 @@
+import { type CallToolResult, type Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { IExternalAgentHostTools } from './externalAgentSession.js';
+export interface IExternalAgentHostTool {
+    readonly definition: Tool;
+    call(args: Record<string, unknown>): Promise<CallToolResult>;
+}
+/** A private endpoint shared only with one agent process through its MCP environment. */
+export declare function createHostToolsBridge(tools: readonly IExternalAgentHostTool[], release: () => Promise<void>): Promise<IExternalAgentHostTools>;
+//# sourceMappingURL=hostToolsBridge.d.ts.map

package/dist/node/externalAgents/hostToolsBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostToolsBridge.d.ts","sourceRoot":"","sources":["../../../src/node/externalAgents/hostToolsBridge.ts"],"names":[],"mappings":"AAUA,OAAO,EAAiD,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,oCAAoC,CAAC;AACnI,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGzE,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7D;AAED,yFAAyF;AACzF,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA2DpJ"}

package/dist/node/externalAgents/hostToolsBridge.js

@@ -0,0 +1,94 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { createServer } from 'node:http';
+import { randomBytes } from 'node:crypto';
+import { fileURLToPath } from 'node:url';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { CLEANSLATE_SDK_VERSION } from './externalAgentVersion.js';
+/** A private endpoint shared only with one agent process through its MCP environment. */
+export async function createHostToolsBridge(tools, release) {
+    const token = randomBytes(32).toString('hex');
+    let disposed = false;
+    let operations = Promise.resolve();
+    const server = createServer(async (request, response) => {
+        if (disposed || request.url !== '/mcp' || request.headers.origin || request.headers.authorization !== `Bearer ${token}`) {
+            response.writeHead(403).end();
+            return;
+        }
+        if (request.method !== 'POST') {
+            response.writeHead(405).end();
+            return;
+        }
+        const protocol = new Server({ name: 'CleanSlate IDE', version: CLEANSLATE_SDK_VERSION }, {
+            capabilities: { tools: {} },
+            instructions: 'These tools belong to the current CleanSlate chat and workspace. Use the advertised tools for IDE operations. Browser tools control the visible browser in this chat; use them by default instead of a separate agent browser unless the user explicitly chooses another destination. Capabilities not present in this catalog are unavailable through this connection.'
+        });
+        protocol.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: tools.map(tool => tool.definition) }));
+        protocol.setRequestHandler(CallToolRequestSchema, async ({ params }) => {
+            const tool = tools.find(candidate => candidate.definition.name === params.name);
+            if (!tool) {
+                throw new Error('Unknown IDE tool.');
+            }
+            const operation = operations.then(async () => {
+                if (disposed) {
+                    throw new Error('This agent session has closed.');
+                }
+                return tool.call(params.arguments ?? {});
+            });
+            operations = operation.catch(() => undefined);
+            return operation;
+        });
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
+        response.on('close', () => { void protocol.close(); });
+        try {
+            let size = 0;
+            const chunks = [];
+            for await (const chunk of request) {
+                size += chunk.length;
+                if (size > 65536) {
+                    response.writeHead(413).end();
+                    return;
+                }
+                chunks.push(Buffer.from(chunk));
+            }
+            const body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+            await protocol.connect(transport);
+            await transport.handleRequest(request, response, body);
+        }
+        catch {
+            if (!response.headersSent) {
+                response.writeHead(400).end();
+            }
+            else {
+                response.end();
+            }
+        }
+    });
+    server.requestTimeout = 15000;
+    await new Promise((resolve, reject) => { server.once('error', reject); server.listen(0, '127.0.0.1', resolve); });
+    const address = server.address();
+    if (!address || typeof address === 'string') {
+        server.close();
+        throw new Error('Could not create the IDE tool connection.');
+    }
+    return {
+        servers: [{ name: 'cleanslate-ide', command: process.execPath,
+                args: [fileURLToPath(new URL('./hostToolsProxy.js', import.meta.url))],
+                env: [{ name: 'ELECTRON_RUN_AS_NODE', value: '1' }, { name: 'CLEANSLATE_HOST_TOOL_URL', value: `http://127.0.0.1:${address.port}/mcp` }, { name: 'CLEANSLATE_HOST_TOOL_TOKEN', value: token }] }],
+        async dispose() {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            server.closeAllConnections();
+            await new Promise(resolve => server.close(() => resolve()));
+            await operations;
+            await release();
+        }
+    };
+}
+//# sourceMappingURL=hostToolsBridge.js.map

package/dist/node/externalAgents/hostToolsBridge.js.map

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

package/dist/node/externalAgents/hostToolsProxy.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hostToolsProxy.d.ts.map

package/dist/node/externalAgents/hostToolsProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostToolsProxy.d.ts","sourceRoot":"","sources":["../../../src/node/externalAgents/hostToolsProxy.ts"],"names":[],"mappings":""}

package/dist/node/externalAgents/hostToolsProxy.js

@@ -0,0 +1,25 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { CLEANSLATE_SDK_VERSION } from './externalAgentVersion.js';
+const endpoint = new URL(process.env['CLEANSLATE_HOST_TOOL_URL'] ?? '');
+const token = process.env['CLEANSLATE_HOST_TOOL_TOKEN'];
+if (endpoint.protocol !== 'http:' || endpoint.hostname !== '127.0.0.1' || !token) {
+    throw new Error('Missing IDE tool connection.');
+}
+const client = new Client({ name: 'CleanSlate agent bridge', version: CLEANSLATE_SDK_VERSION });
+await client.connect(new StreamableHTTPClientTransport(endpoint, { requestInit: { headers: { Authorization: `Bearer ${token}` } } }));
+const server = new Server({ name: 'CleanSlate IDE', version: CLEANSLATE_SDK_VERSION }, { capabilities: { tools: {} }, instructions: client.getInstructions() });
+server.setRequestHandler(ListToolsRequestSchema, () => client.listTools());
+// The IDE owns the request deadline (including time spent answering a question).
+// Do not let the proxy's shorter default timeout abandon a still-visible request.
+server.setRequestHandler(CallToolRequestSchema, ({ params }, extra) => client.callTool(params, undefined, { timeout: 125000, signal: extra.signal }));
+process.stdin.once('end', () => { void client.close(); });
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=hostToolsProxy.js.map

package/dist/node/externalAgents/hostToolsProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostToolsProxy.js","sourceRoot":"","sources":["../../../src/node/externalAgents/hostToolsProxy.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC;AACxE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AACxD,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC;IAAC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAAC,CAAC;AACtI,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;AAChG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,6BAA6B,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AACtI,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AAChK,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;AAC3E,iFAAiF;AACjF,kFAAkF;AAClF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACtJ,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/node/externalAgents/index.d.ts

@@ -0,0 +1,4 @@
+export * from '../../externalAgents/index.js';
+export { ExternalAgentService } from './externalAgentService.js';
+export { ExternalAgentRegistry, type IExternalAgentLaunchConfiguration } from './externalAgentRegistry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/externalAgents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/externalAgents/index.ts"],"names":[],"mappings":"AAKA,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,KAAK,iCAAiC,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/node/externalAgents/index.js

@@ -0,0 +1,8 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) CleanSlate. All rights reserved.
+ * Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+export * from '../../externalAgents/index.js';
+export { ExternalAgentService } from './externalAgentService.js';
+export { ExternalAgentRegistry } from './externalAgentRegistry.js';
+//# sourceMappingURL=index.js.map

package/dist/node/externalAgents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/externalAgents/index.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,cAAc,+BAA+B,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAA0C,MAAM,4BAA4B,CAAC"}

package/dist/node/externalAgents/transports/acp/acpClient.d.ts

@@ -0,0 +1,49 @@
+import type { RequestPermissionRequest, RequestPermissionResponse } from '@agentclientprotocol/sdk';
+import { IExternalAgentEvent } from '../../../../externalAgents/externalAgentTypes.js';
+import { IExternalAgentLaunchConfiguration } from '../../externalAgentRegistry.js';
+export interface IAcpClientHandlers {
+    readonly onEvent: (event: IExternalAgentEvent) => void;
+    readonly requestPermission: (request: RequestPermissionRequest) => Promise<RequestPermissionResponse>;
+}
+export declare class AcpClient {
+    private readonly cleanSlateSessionId;
+    private readonly connection;
+    private readonly handlers;
+    private readonly cwd;
+    private readonly completedEdits;
+    private cancelRequested;
+    private snapshot;
+    private eventQueue;
+    private enqueueEvent;
+    private constructor();
+    static create(cleanSlateSessionId: string, cwd: string, launch: IExternalAgentLaunchConfiguration & {
+        executable: string;
+    }, handlers: IAcpClientHandlers): Promise<AcpClient>;
+    externalSessionId: string | undefined;
+    get models(): {
+        readonly configId: string;
+        readonly current: string;
+        readonly options: readonly {
+            readonly value: string;
+            readonly name: string;
+        }[];
+    } | undefined;
+    get controls(): readonly {
+        readonly configId: string;
+        readonly name: string;
+        readonly category?: string;
+        readonly current: string;
+        readonly options: readonly {
+            readonly value: string;
+            readonly name: string;
+            readonly description?: string;
+            readonly kind?: import("../../../../externalAgents/externalAgentTypes.js").ExternalApprovalPresentation;
+        }[];
+    }[];
+    selectModel(configId: string, value: string): Promise<void>;
+    start(cwd: string, existingSessionId?: string, servers?: import('@agentclientprotocol/sdk').McpServer[]): Promise<string>;
+    prompt(text: string, images?: readonly string[]): Promise<void>;
+    cancel(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=acpClient.d.ts.map

package/dist/node/externalAgents/transports/acp/acpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acpClient.d.ts","sourceRoot":"","sources":["../../../../../src/node/externalAgents/transports/acp/acpClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAMnF,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACvD,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACtG;AAED,qBAAa,SAAS;IAuBpB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAzBrB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqE;IACpG,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,UAAU,CAAoC;IAEtD,OAAO,CAAC,YAAY;IAgBpB,OAAO;WAOM,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iCAAiC,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAiDnL,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,IAAI,MAAM;;;;;;;kBAA2C;IACrD,IAAI,QAAQ;;;;;;;;gCAjE+B,CAAC;yBAAuB,CAAC;;QAiEjB;IAC7C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,0BAA0B,EAAE,SAAS,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAe7H,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGxB"}

package/dist/node/externalAgents/transports/acp/acpClient.js

@@ -0,0 +1,152 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) CleanSlate. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import { AcpConnection } from './acpConnection.js';
+import { mapAcpEvent } from './acpEventMapper.js';
+import { AcpProcess } from './acpProcess.js';
+import { ExternalFileSnapshots } from '../../externalFileSnapshots.js';
+export class AcpClient {
+    enqueueEvent(event) {
+        this.eventQueue = this.eventQueue.then(async () => {
+            if (event.type === 'tool') {
+                const previous = this.completedEdits.get(event.toolCallId);
+                if (event.kind === 'edit' || previous) {
+                    const edit = { ...previous, ...event, status: event.status ?? previous?.status, fileChanges: event.fileChanges ?? previous?.fileChanges, kind: event.kind ?? previous?.kind, locations: event.locations ?? previous?.locations };
+                    this.completedEdits.set(event.toolCallId, edit);
+                    if (edit.status === 'completed' && previous?.status !== 'completed') {
+                        const fileChanges = await this.snapshot?.changes(edit);
+                        event = { ...edit, fileChanges: edit.fileChanges ?? fileChanges };
+                    }
+                }
+            }
+            this.handlers.onEvent(event);
+        });
+    }
+    constructor(cleanSlateSessionId, connection, handlers, cwd) {
+        this.cleanSlateSessionId = cleanSlateSessionId;
+        this.connection = connection;
+        this.handlers = handlers;
+        this.cwd = cwd;
+        this.completedEdits = new Map();
+        this.cancelRequested = false;
+        this.eventQueue = Promise.resolve();
+    }
+    static async create(cleanSlateSessionId, cwd, launch, handlers) {
+        const agentProcess = new AcpProcess(launch, cwd);
+        let client;
+        let connection;
+        const approvalSnapshots = new Map();
+        try {
+            connection = await AcpConnection.create(agentProcess, {
+                onSessionUpdate: notification => {
+                    if (notification.sessionId !== client?.externalSessionId) {
+                        return;
+                    }
+                    let update = notification.update;
+                    if (update.sessionUpdate === 'tool_call_update' || update.sessionUpdate === 'tool_call') {
+                        const snapshot = approvalSnapshots.get(update.toolCallId);
+                        if (update.status === 'completed' || update.status === 'failed') {
+                            approvalSnapshots.delete(update.toolCallId);
+                        }
+                        if (snapshot && update.status === 'completed') {
+                            update = { ...snapshot, ...update, sessionUpdate: 'tool_call_update', content: [...(snapshot.content ?? []), ...(update.content ?? [])], rawInput: update.rawInput ?? snapshot.rawInput };
+                        }
+                    }
+                    const event = mapAcpEvent(cleanSlateSessionId, update, launch.thoughtPresentation ?? 'reasoning');
+                    if (notification.update.sessionUpdate === 'config_option_update' || notification.update.sessionUpdate === 'current_mode_update') {
+                        handlers.onEvent({ type: 'controls', cleanSlateSessionId, controls: client.controls, models: client.models });
+                    }
+                    if (event) {
+                        client.enqueueEvent(event);
+                    }
+                },
+                requestPermission: request => {
+                    if (request.sessionId !== client?.externalSessionId) {
+                        return Promise.resolve({ outcome: { outcome: 'cancelled' } });
+                    }
+                    // A proposed edit is not a completed edit. Preserve its snapshot
+                    // only for a later successful tool notification.
+                    approvalSnapshots.set(request.toolCall.toolCallId, request.toolCall);
+                    return handlers.requestPermission(request).then(response => {
+                        if (response.outcome.outcome === 'cancelled') {
+                            approvalSnapshots.delete(request.toolCall.toolCallId);
+                        }
+                        return response;
+                    });
+                },
+                onError: error => handlers.onEvent({ type: 'status', cleanSlateSessionId, status: 'failed', detail: error.message })
+            });
+        }
+        catch (error) {
+            await agentProcess.stop();
+            throw error;
+        }
+        client = new AcpClient(cleanSlateSessionId, connection, handlers, cwd);
+        return client;
+    }
+    get models() { return this.connection.modelOptions; }
+    get controls() { return this.connection.controls; }
+    async selectModel(configId, value) {
+        if (!this.externalSessionId) {
+            throw new Error('Agent session is not ready.');
+        }
+        await this.connection.selectModel(this.externalSessionId, configId, value);
+    }
+    async start(cwd, existingSessionId, servers = []) {
+        if (existingSessionId) {
+            try {
+                // Loading may replay notifications before its response arrives.
+                this.externalSessionId = existingSessionId;
+                await this.connection.loadSession(existingSessionId, cwd, servers);
+                await this.eventQueue;
+                return existingSessionId;
+            }
+            catch {
+                this.externalSessionId = undefined;
+            }
+        }
+        const response = await this.connection.newSession(cwd, servers);
+        this.externalSessionId = response.sessionId;
+        return response.sessionId;
+    }
+    async prompt(text, images) {
+        if (!this.externalSessionId) {
+            throw new Error('External agent session has not started.');
+        }
+        this.handlers.onEvent({ type: 'status', cleanSlateSessionId: this.cleanSlateSessionId, status: 'running' });
+        this.cancelRequested = false;
+        try {
+            this.completedEdits.clear();
+            this.snapshot = await ExternalFileSnapshots.capture(this.cwd);
+            if (this.cancelRequested) {
+                this.handlers.onEvent({ type: 'status', cleanSlateSessionId: this.cleanSlateSessionId, status: 'cancelled' });
+                return;
+            }
+            const response = await this.connection.prompt(this.externalSessionId, text, images);
+            await this.eventQueue;
+            const status = response.stopReason === 'cancelled' ? 'cancelled' : 'completed';
+            this.handlers.onEvent({ type: 'status', cleanSlateSessionId: this.cleanSlateSessionId, status });
+        }
+        catch (error) {
+            await this.eventQueue.catch(() => undefined);
+            this.handlers.onEvent({ type: 'status', cleanSlateSessionId: this.cleanSlateSessionId, status: 'failed', detail: error instanceof Error ? error.message : String(error) });
+            throw error;
+        }
+        finally {
+            this.snapshot = undefined;
+            this.completedEdits.clear();
+            this.eventQueue = Promise.resolve();
+        }
+    }
+    async cancel() {
+        this.cancelRequested = true;
+        if (this.externalSessionId) {
+            await this.connection.cancel(this.externalSessionId);
+        }
+    }
+    dispose() {
+        return this.connection.dispose();
+    }
+}
+//# sourceMappingURL=acpClient.js.map

package/dist/node/externalAgents/transports/acp/acpClient.js.map

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

package/dist/node/externalAgents/transports/acp/acpConnection.d.ts

@@ -0,0 +1,31 @@
+import { type RequestPermissionRequest, type RequestPermissionResponse, type SessionNotification, type ContentBlock } from '@agentclientprotocol/sdk';
+import { AcpProcess } from './acpProcess.js';
+export interface IAcpConnectionHandlers {
+    readonly onSessionUpdate: (notification: SessionNotification) => void;
+    readonly requestPermission: (request: RequestPermissionRequest) => Promise<RequestPermissionResponse>;
+    readonly onError: (error: Error) => void;
+}
+export declare function createAcpPromptContent(prompt: string, images?: readonly string[]): ContentBlock[];
+export declare class AcpConnection {
+    private readonly process;
+    controls: NonNullable<import('../../../../externalAgents/externalAgentTypes.js').IExternalAgentSessionInfo['controls']>;
+    modelOptions: import('../../../../externalAgents/externalAgentTypes.js').IExternalAgentSessionInfo['models'];
+    private supportsImages;
+    private readModels;
+    selectModel(sessionId: string, configId: string, value: string): Promise<void>;
+    private readonly connection;
+    private readonly context;
+    private constructor();
+    static create(process: AcpProcess, handlers: IAcpConnectionHandlers): Promise<AcpConnection>;
+    newSession(cwd: string, mcpServers?: import('@agentclientprotocol/sdk').McpServer[]): Promise<{
+        sessionId: string;
+    }>;
+    loadSession(sessionId: string, cwd: string, mcpServers?: import('@agentclientprotocol/sdk').McpServer[]): Promise<void>;
+    private readModes;
+    prompt(sessionId: string, prompt: string, images?: readonly string[]): Promise<{
+        stopReason: string;
+    }>;
+    cancel(sessionId: string): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=acpConnection.d.ts.map

package/dist/node/externalAgents/transports/acp/acpConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acpConnection.d.ts","sourceRoot":"","sources":["../../../../../src/node/externalAgents/transports/acp/acpConnection.ts"],"names":[],"mappings":"AAMA,OAAO,EAON,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,eAAe,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtG,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,EAAE,CAUjG;AAED,qBAAa,aAAa;IAgCL,OAAO,CAAC,QAAQ,CAAC,OAAO;IA/B5C,QAAQ,EAAE,WAAW,CAAC,OAAO,kDAAkD,EAAE,yBAAyB,CAAC,UAAU,CAAC,CAAC,CAAM;IAC7H,YAAY,EAAE,OAAO,kDAAkD,EAAE,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAC7G,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,UAAU;IAcZ,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IAExC,OAAO;WAKM,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IA+B5F,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,OAAO,0BAA0B,EAAE,SAAS,EAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAOxH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,OAAO,0BAA0B,EAAE,SAAS,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjI,OAAO,CAAC,SAAS;IAKjB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAUhG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}