@coralai/sps-cli 0.25.2 → 0.26.1

package/dist/providers/adapters/AcpSdkAdapter.js

@@ -0,0 +1,270 @@
+/**
+ * AcpSdkAdapter — Implements ACPClient using real ACP JSON-RPC over stdio.
+ *
+ * Replaces legacy adapters with
+ * structured protocol communication via @agentclientprotocol/sdk.
+ *
+ * Architecture (aligned with OpenClaw/acpx):
+ *   AcpSdkAdapter → spawn ACP adapter child process → stdio pipe → JSON-RPC
+ *   Claude: npx @agentclientprotocol/claude-agent-acp (Anthropic official SDK)
+ *   Codex:  npx @zed-industries/codex-acp (Rust native binary)
+ */
+import { spawn } from 'node:child_process';
+import { Readable, Writable } from 'node:stream';
+import { ClientSideConnection, ndJsonStream } from '@agentclientprotocol/sdk';
+import { SessionUpdateAccumulator } from './acp-session-accumulator.js';
+import { resolvePermission } from './acp-permissions.js';
+import { FileSystemHandlers } from './acp-fs-handlers.js';
+import { TerminalManager } from './acp-terminal-manager.js';
+const ACP_ADAPTER_REGISTRY = {
+    claude: { command: 'npx', args: ['-y', '@agentclientprotocol/claude-agent-acp'] },
+    codex: { command: 'npx', args: ['-y', '@zed-industries/codex-acp'] },
+};
+function isChildAlive(child) {
+    return child.exitCode == null && child.signalCode == null && !child.killed;
+}
+/** Cross-process PID liveness check (signal 0) */
+function isPidAlive(pid) {
+    if (!pid)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class AcpSdkAdapter {
+    sessions = new Map();
+    defaultPermissionMode;
+    constructor(permissionMode) {
+        this.defaultPermissionMode =
+            permissionMode ?? process.env.ACP_PERMISSION_MODE ?? 'approve-all';
+    }
+    async ensureSession(input) {
+        const existing = this.sessions.get(input.sessionName);
+        if (existing && !input.resetExisting && isChildAlive(existing.child)) {
+            return {
+                sessionId: existing.sessionId,
+                sessionState: existing.activePromise ? 'busy' : 'ready',
+                paneText: existing.accumulator.getRecentText(),
+                lastSeenAt: new Date().toISOString(),
+                pid: existing.child.pid ?? null,
+            };
+        }
+        if (existing) {
+            await this.destroySession(existing);
+            this.sessions.delete(input.sessionName);
+        }
+        // Resolve adapter command
+        const registry = ACP_ADAPTER_REGISTRY[input.tool];
+        if (!registry)
+            throw new Error(`Unknown ACP tool: ${input.tool}`);
+        // Spawn ACP adapter child process
+        const child = spawn(registry.command, registry.args, {
+            cwd: input.cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env },
+        });
+        // Drain stderr (adapter debug output)
+        child.stderr?.on('data', () => { });
+        await new Promise((resolve, reject) => {
+            child.once('spawn', () => resolve());
+            child.once('error', (err) => reject(new Error(`Failed to spawn ${input.tool} ACP adapter: ${err.message}`)));
+        });
+        // Establish JSON-RPC connection over stdio
+        const stream = ndJsonStream(Writable.toWeb(child.stdin), Readable.toWeb(child.stdout));
+        const accumulator = new SessionUpdateAccumulator();
+        const permissionMode = this.defaultPermissionMode;
+        // Set up log file for sps logs compatibility
+        if (input.logsDir) {
+            const logFileName = `${input.sessionName}-acp-${Date.now()}.log`;
+            accumulator.setLogFile(`${input.logsDir}/${logFileName}`);
+        }
+        const fsHandlers = new FileSystemHandlers({ cwd: input.cwd, permissionMode });
+        const terminalMgr = new TerminalManager({ cwd: input.cwd, permissionMode });
+        const conn = new ClientSideConnection(() => ({
+            sessionUpdate: async (params) => {
+                accumulator.handleUpdate(params.update);
+            },
+            requestPermission: async (params) => {
+                accumulator.hasPendingPermission = true;
+                const result = resolvePermission(params, permissionMode);
+                accumulator.hasPendingPermission = false;
+                return result;
+            },
+            readTextFile: async (params) => {
+                return fsHandlers.readTextFile(params);
+            },
+            writeTextFile: async (params) => {
+                return fsHandlers.writeTextFile(params);
+            },
+            createTerminal: async (params) => {
+                return terminalMgr.createTerminal(params);
+            },
+            terminalOutput: async (params) => {
+                return terminalMgr.terminalOutput(params);
+            },
+            waitForTerminalExit: async (params) => {
+                return terminalMgr.waitForTerminalExit(params);
+            },
+            killTerminal: async (params) => {
+                return terminalMgr.killTerminal(params);
+            },
+            releaseTerminal: async (params) => {
+                return terminalMgr.releaseTerminal(params);
+            },
+        }), stream);
+        // Protocol initialization
+        const initResult = await conn.initialize({
+            protocolVersion: 1,
+            clientCapabilities: {
+                fs: { readTextFile: true, writeTextFile: true },
+                terminal: true,
+            },
+        });
+        // Create new session
+        const sessionResult = await conn.newSession({
+            cwd: input.cwd,
+            mcpServers: [],
+        });
+        const session = {
+            tool: input.tool,
+            sessionId: sessionResult.sessionId,
+            sessionName: input.sessionName,
+            cwd: input.cwd,
+            child,
+            conn,
+            accumulator,
+            activePromise: null,
+            permissionMode,
+        };
+        this.sessions.set(input.sessionName, session);
+        return {
+            sessionId: sessionResult.sessionId,
+            sessionState: 'ready',
+            paneText: '',
+            lastSeenAt: new Date().toISOString(),
+            pid: child.pid ?? null,
+        };
+    }
+    async startRun(input) {
+        const session = this.sessions.get(input.sessionName);
+        if (!session)
+            throw new Error(`ACP session not found: ${input.sessionName}`);
+        if (session.activePromise)
+            throw new Error(`Session ${input.sessionName} already has active run`);
+        session.accumulator.reset();
+        // Non-blocking prompt — store promise but don't await
+        session.activePromise = session.conn.prompt({
+            sessionId: session.sessionId,
+            prompt: [{ type: 'text', text: input.prompt }],
+        });
+        session.activePromise
+            .then((result) => {
+            session.accumulator.stopReason = result.stopReason ?? 'end_turn';
+            session.activePromise = null;
+        })
+            .catch(() => {
+            session.accumulator.stopReason = 'failed';
+            session.activePromise = null;
+        });
+        return {
+            runId: `acp-${Date.now()}`,
+            runState: 'running',
+            paneText: '',
+            lastSeenAt: new Date().toISOString(),
+            pid: session.child.pid ?? null,
+        };
+    }
+    async inspectSession(input) {
+        const session = this.sessions.get(input.sessionName);
+        // In-process session: direct check
+        if (session && isChildAlive(session.child)) {
+            return {
+                sessionState: session.activePromise ? 'busy' : 'ready',
+                paneText: session.accumulator.getRecentText(),
+                lastSeenAt: new Date().toISOString(),
+            };
+        }
+        // Cross-process fallback: check persisted PID liveness
+        if (input.pid && isPidAlive(input.pid)) {
+            return {
+                sessionState: 'busy', // PID alive but not our process — assume busy
+                paneText: '',
+                lastSeenAt: new Date().toISOString(),
+            };
+        }
+        return { sessionState: 'offline', paneText: '', lastSeenAt: new Date().toISOString() };
+    }
+    async inspectRun(input) {
+        if (!input.activeRun) {
+            return { runState: null, paneText: '', lastSeenAt: new Date().toISOString() };
+        }
+        const session = this.sessions.get(input.sessionName);
+        // In-process session: detailed status from accumulator
+        if (session && isChildAlive(session.child)) {
+            // (handled below)
+        }
+        else if (input.pid && isPidAlive(input.pid)) {
+            // Cross-process fallback: PID alive = running
+            return { runState: 'running', paneText: '', lastSeenAt: new Date().toISOString() };
+        }
+        else {
+            return { runState: 'lost', paneText: '', lastSeenAt: new Date().toISOString() };
+        }
+        const acc = session.accumulator;
+        let runState;
+        if (!session.activePromise) {
+            // Prompt has returned
+            runState = acc.stopReason === 'end_turn' ? 'completed'
+                : acc.stopReason === 'cancelled' ? 'cancelled'
+                    : 'failed';
+        }
+        else if (acc.hasPendingPermission) {
+            runState = 'needs_confirmation';
+        }
+        else {
+            runState = 'running';
+        }
+        return {
+            runState,
+            paneText: acc.getRecentText(),
+            lastSeenAt: new Date().toISOString(),
+        };
+    }
+    async stopSession(input) {
+        const session = this.sessions.get(input.sessionName);
+        if (!session)
+            return;
+        if (session.activePromise) {
+            try {
+                await session.conn.cancel({ sessionId: session.sessionId });
+            }
+            catch { /* Agent may already be dead */ }
+        }
+        await this.destroySession(session);
+        this.sessions.delete(input.sessionName);
+    }
+    async destroySession(session) {
+        try {
+            session.child.kill('SIGTERM');
+        }
+        catch { /* noop */ }
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                try {
+                    session.child.kill('SIGKILL');
+                }
+                catch { /* noop */ }
+                resolve();
+            }, 3_000);
+            session.child.once('exit', () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=AcpSdkAdapter.js.map

package/dist/providers/adapters/AcpSdkAdapter.js.map

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

package/dist/providers/adapters/acp-fs-handlers.d.ts

@@ -0,0 +1,26 @@
+import type { PermissionMode } from './acp-permissions.js';
+interface ReadTextFileRequest {
+    path: string;
+    line?: number;
+    limit?: number;
+}
+interface WriteTextFileRequest {
+    path: string;
+    content: string;
+}
+export declare class FileSystemHandlers {
+    private readonly rootDir;
+    private readonly permissionMode;
+    constructor(opts: {
+        cwd: string;
+        permissionMode: PermissionMode;
+    });
+    readTextFile(params: ReadTextFileRequest): Promise<{
+        content: string;
+    }>;
+    writeTextFile(params: WriteTextFileRequest): Promise<Record<string, never>>;
+    private resolvePathWithinRoot;
+    private sliceContent;
+}
+export {};
+//# sourceMappingURL=acp-fs-handlers.d.ts.map

package/dist/providers/adapters/acp-fs-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-fs-handlers.d.ts","sourceRoot":"","sources":["../../../src/providers/adapters/acp-fs-handlers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAEpC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,cAAc,CAAA;KAAE;IAK3D,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IASvE,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAUjF,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,YAAY;CAOrB"}

package/dist/providers/adapters/acp-fs-handlers.js

@@ -0,0 +1,52 @@
+/**
+ * ACP File System Handlers — aligned with OpenClaw/acpx FileSystemHandlers
+ *
+ * Handles fs/read_text_file and fs/write_text_file ACP Client callbacks.
+ * Enforces cwd sandbox and supports line-range slicing.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+export class FileSystemHandlers {
+    rootDir;
+    permissionMode;
+    constructor(opts) {
+        this.rootDir = path.resolve(opts.cwd);
+        this.permissionMode = opts.permissionMode;
+    }
+    async readTextFile(params) {
+        if (this.permissionMode === 'deny-all') {
+            throw new Error('Permission denied for fs/read_text_file (deny-all)');
+        }
+        const filePath = this.resolvePathWithinRoot(params.path);
+        const content = await readFile(filePath, 'utf-8');
+        return { content: this.sliceContent(content, params.line, params.limit) };
+    }
+    async writeTextFile(params) {
+        if (this.permissionMode === 'deny-all') {
+            throw new Error('Permission denied for fs/write_text_file (deny-all)');
+        }
+        const filePath = this.resolvePathWithinRoot(params.path);
+        await mkdir(path.dirname(filePath), { recursive: true });
+        await writeFile(filePath, params.content, 'utf-8');
+        return {};
+    }
+    resolvePathWithinRoot(rawPath) {
+        if (!path.isAbsolute(rawPath)) {
+            throw new Error(`Path must be absolute: ${rawPath}`);
+        }
+        const resolved = path.resolve(rawPath);
+        if (resolved !== this.rootDir && !resolved.startsWith(this.rootDir + path.sep)) {
+            throw new Error(`Path outside allowed cwd subtree: ${resolved}`);
+        }
+        return resolved;
+    }
+    sliceContent(content, line, limit) {
+        if (line == null && limit == null)
+            return content;
+        const lines = content.split('\n');
+        const startIndex = Math.max(0, (line ?? 1) - 1);
+        const endIndex = limit == null ? lines.length : Math.min(lines.length, startIndex + limit);
+        return lines.slice(startIndex, endIndex).join('\n');
+    }
+}
+//# sourceMappingURL=acp-fs-handlers.js.map

package/dist/providers/adapters/acp-fs-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-fs-handlers.js","sourceRoot":"","sources":["../../../src/providers/adapters/acp-fs-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAc7B,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAS;IAChB,cAAc,CAAiB;IAEhD,YAAY,IAAqD;QAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAA2B;QAC5C,IAAI,IAAI,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA4B;QAC9C,IAAI,IAAI,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,qBAAqB,CAAC,OAAe;QAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,YAAY,CAAC,OAAe,EAAE,IAAa,EAAE,KAAc;QACjE,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,OAAO,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/providers/adapters/acp-fs-handlers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acp-fs-handlers.test.d.ts.map

package/dist/providers/adapters/acp-fs-handlers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-fs-handlers.test.d.ts","sourceRoot":"","sources":["../../../src/providers/adapters/acp-fs-handlers.test.ts"],"names":[],"mappings":""}

package/dist/providers/adapters/acp-fs-handlers.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, writeFileSync, rmSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { FileSystemHandlers } from './acp-fs-handlers.js';
+const TEST_DIR = '/tmp/sps-acp-fs-test';
+beforeEach(() => {
+    mkdirSync(TEST_DIR, { recursive: true });
+    writeFileSync(join(TEST_DIR, 'hello.txt'), 'line1\nline2\nline3\nline4\nline5\n');
+});
+afterEach(() => {
+    rmSync(TEST_DIR, { recursive: true, force: true });
+});
+describe('FileSystemHandlers', () => {
+    describe('readTextFile', () => {
+        it('reads entire file', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            const result = await fs.readTextFile({ path: join(TEST_DIR, 'hello.txt') });
+            expect(result.content).toBe('line1\nline2\nline3\nline4\nline5\n');
+        });
+        it('slices by line and limit', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            const result = await fs.readTextFile({ path: join(TEST_DIR, 'hello.txt'), line: 2, limit: 2 });
+            expect(result.content).toBe('line2\nline3');
+        });
+        it('slices from line without limit', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            const result = await fs.readTextFile({ path: join(TEST_DIR, 'hello.txt'), line: 4 });
+            expect(result.content).toBe('line4\nline5\n');
+        });
+        it('rejects path outside cwd', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            await expect(fs.readTextFile({ path: '/etc/passwd' })).rejects.toThrow('outside');
+        });
+        it('rejects relative path', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            await expect(fs.readTextFile({ path: 'hello.txt' })).rejects.toThrow('absolute');
+        });
+        it('denies in deny-all mode', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'deny-all' });
+            await expect(fs.readTextFile({ path: join(TEST_DIR, 'hello.txt') })).rejects.toThrow('denied');
+        });
+    });
+    describe('writeTextFile', () => {
+        it('writes file', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            await fs.writeTextFile({ path: join(TEST_DIR, 'out.txt'), content: 'hello' });
+            expect(readFileSync(join(TEST_DIR, 'out.txt'), 'utf-8')).toBe('hello');
+        });
+        it('creates parent directories', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            const nested = join(TEST_DIR, 'sub', 'dir', 'file.txt');
+            await fs.writeTextFile({ path: nested, content: 'nested' });
+            expect(readFileSync(nested, 'utf-8')).toBe('nested');
+        });
+        it('rejects path outside cwd', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'approve-all' });
+            await expect(fs.writeTextFile({ path: '/tmp/outside.txt', content: 'x' })).rejects.toThrow('outside');
+        });
+        it('denies in deny-all mode', async () => {
+            const fs = new FileSystemHandlers({ cwd: TEST_DIR, permissionMode: 'deny-all' });
+            await expect(fs.writeTextFile({ path: join(TEST_DIR, 'x.txt'), content: 'x' })).rejects.toThrow('denied');
+        });
+    });
+});
+//# sourceMappingURL=acp-fs-handlers.test.js.map

package/dist/providers/adapters/acp-fs-handlers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-fs-handlers.test.js","sourceRoot":"","sources":["../../../src/providers/adapters/acp-fs-handlers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,UAAU,CAAC,GAAG,EAAE;IACd,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,qCAAqC,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;YACjC,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;YAC5E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACrF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;YACrC,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;YACvC,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC;YACjF,MAAM,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;YAC3B,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9E,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;YAC1C,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5D,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;YACpF,MAAM,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;YACvC,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC;YACjF,MAAM,MAAM,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5G,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/providers/adapters/acp-permissions.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ACP Permission Resolver — aligned with OpenClaw/acpx permissions.ts
+ *
+ * 3-layer decision chain:
+ *   1. Global policy (approve-all / deny-all)
+ *   2. Kind classification (approve-reads auto-approves read/search)
+ *   3. Unattended fallback (SPS auto-approves everything — no TTY)
+ */
+export type PermissionMode = 'approve-all' | 'approve-reads' | 'deny-all';
+interface PermissionParams {
+    toolCall: {
+        toolCallId?: string;
+        title?: string;
+        kind?: string;
+        status?: string;
+    };
+    options: ReadonlyArray<{
+        optionId: string;
+        kind: string;
+        name?: string;
+    }>;
+}
+interface PermissionResponse {
+    outcome: {
+        outcome: 'selected';
+        optionId: string;
+    } | {
+        outcome: 'cancelled';
+    };
+}
+/** Infer tool kind from toolCall.kind or title keywords (aligned with acpx). */
+export declare function inferToolKind(params: Pick<PermissionParams, 'toolCall'>): string | undefined;
+export declare function resolvePermission(params: PermissionParams, mode: PermissionMode): PermissionResponse;
+export {};
+//# sourceMappingURL=acp-permissions.d.ts.map

package/dist/providers/adapters/acp-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-permissions.d.ts","sourceRoot":"","sources":["../../../src/providers/adapters/acp-permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;AAE1E,UAAU,gBAAgB;IACxB,QAAQ,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,aAAa,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,UAAU,kBAAkB;IAC1B,OAAO,EACH;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACzC;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;CAC9B;AAaD,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG,MAAM,GAAG,SAAS,CAc5F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,GAAG,kBAAkB,CA4BpG"}

package/dist/providers/adapters/acp-permissions.js

@@ -0,0 +1,69 @@
+/**
+ * ACP Permission Resolver — aligned with OpenClaw/acpx permissions.ts
+ *
+ * 3-layer decision chain:
+ *   1. Global policy (approve-all / deny-all)
+ *   2. Kind classification (approve-reads auto-approves read/search)
+ *   3. Unattended fallback (SPS auto-approves everything — no TTY)
+ */
+function pickOption(options, kinds) {
+    for (const kind of kinds) {
+        const match = options.find((o) => o.kind === kind);
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+/** Infer tool kind from toolCall.kind or title keywords (aligned with acpx). */
+export function inferToolKind(params) {
+    if (params.toolCall.kind)
+        return params.toolCall.kind;
+    const title = params.toolCall.title?.trim().toLowerCase() ?? '';
+    const head = title.split(':', 1)[0]?.trim() ?? '';
+    if (!head)
+        return undefined;
+    if (head.includes('read') || head.includes('cat'))
+        return 'read';
+    if (head.includes('search') || head.includes('find') || head.includes('grep'))
+        return 'search';
+    if (head.includes('write') || head.includes('edit') || head.includes('patch'))
+        return 'edit';
+    if (head.includes('delete') || head.includes('remove'))
+        return 'delete';
+    if (head.includes('move') || head.includes('rename'))
+        return 'move';
+    if (head.includes('run') || head.includes('execute') || head.includes('bash'))
+        return 'execute';
+    if (head.includes('fetch') || head.includes('http') || head.includes('url'))
+        return 'fetch';
+    if (head.includes('think'))
+        return 'think';
+    return 'other';
+}
+export function resolvePermission(params, mode) {
+    const { options } = params;
+    if (options.length === 0)
+        return { outcome: { outcome: 'cancelled' } };
+    const allowOption = pickOption(options, ['allow_once', 'allow_always']);
+    const rejectOption = pickOption(options, ['reject_once', 'reject_always']);
+    // Layer 1: global policy
+    if (mode === 'approve-all') {
+        return { outcome: { outcome: 'selected', optionId: allowOption?.optionId ?? options[0].optionId } };
+    }
+    if (mode === 'deny-all') {
+        return rejectOption
+            ? { outcome: { outcome: 'selected', optionId: rejectOption.optionId } }
+            : { outcome: { outcome: 'cancelled' } };
+    }
+    // Layer 2: approve-reads — auto-approve read/search kinds
+    const kind = inferToolKind(params);
+    if ((kind === 'read' || kind === 'search') && allowOption) {
+        return { outcome: { outcome: 'selected', optionId: allowOption.optionId } };
+    }
+    // Layer 3: SPS is unattended — auto-approve (no TTY interaction)
+    if (allowOption) {
+        return { outcome: { outcome: 'selected', optionId: allowOption.optionId } };
+    }
+    return { outcome: { outcome: 'cancelled' } };
+}
+//# sourceMappingURL=acp-permissions.js.map

package/dist/providers/adapters/acp-permissions.js.map

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

package/dist/providers/adapters/acp-permissions.test.d.ts

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

package/dist/providers/adapters/acp-permissions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-permissions.test.d.ts","sourceRoot":"","sources":["../../../src/providers/adapters/acp-permissions.test.ts"],"names":[],"mappings":""}