@wrongstack/acp 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ECOSTACK TECHNOLOGY OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agent/index.d.ts

@@ -0,0 +1,7 @@
+export { StdioTransport } from './stdio-transport.js';
+export { ACPToolsRegistry } from './tools-registry.js';
+export { ACPProtocolHandler } from './protocol-handler.js';
+export { WrongStackACPServer } from './wrongstack-acp-agent.js';
+export type { WrongStackACPServerOptions } from './wrongstack-acp-agent.js';
+export type { AgentServerTransport } from './stdio-transport.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAC,0BAA0B,EAAC,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,5 @@
+export { StdioTransport } from './stdio-transport.js';
+export { ACPToolsRegistry } from './tools-registry.js';
+export { ACPProtocolHandler } from './protocol-handler.js';
+export { WrongStackACPServer } from './wrongstack-acp-agent.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAC,kBAAkB,EAAC,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAC"}

package/dist/agent/protocol-handler.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ACPProtocolHandler — state machine for ACP server-side message handling.
+ *
+ * ACP turn lifecycle:
+ *   idle → [initialize] → await-turn → [tools/call] → executing
+ *   → [tool result sent] → idle
+ *
+ * We implement this as a simple switch on the method name, since the ACP
+ * protocol is request/response based (not streaming) on the wire.
+ *
+ * Concurrency: ACP allows Cancellations and multiple concurrent tool calls
+ * within a turn. We handle each tools/call in its own Promise.all.
+ */
+import type { ACPMessage } from '../types/acp-messages.js';
+import type { AgentServerTransport } from './stdio-transport.js';
+export declare const WRONGSTACK_VERSION = "0.1.0";
+export declare class ACPProtocolHandler {
+    private readonly transport;
+    private readonly registry;
+    private readonly context;
+    private initialized;
+    private sessionId;
+    private readonly signal;
+    private pendingCalls;
+    constructor(transport: AgentServerTransport, registry: import('./tools-registry.js').ACPToolsRegistry, context: unknown);
+    /** Wire an external abort signal from the ACP client */
+    wireAbortController(abortController: AbortController): void;
+    /** Process one inbound message. Returns true if this was a terminal message. */
+    handleMessage(msg: ACPMessage): Promise<boolean>;
+    private handleRequest;
+    private handleNotification;
+    private handleInitialize;
+    private handleToolsList;
+    private handleToolCall;
+    private handleCancel;
+    private handleCancelNotification;
+    private handleSessionList;
+    private sendError;
+}
+//# sourceMappingURL=protocol-handler.d.ts.map

package/dist/agent/protocol-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-handler.d.ts","sourceRoot":"","sources":["../../src/agent/protocol-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,UAAU,EAOX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,sBAAsB,CAAC;AAE/D,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAQ1C,qBAAa,kBAAkB;IAO3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,YAAY,CAAgD;gBAGjD,SAAS,EAAE,oBAAoB,EAC/B,QAAQ,EAAE,OAAO,qBAAqB,EAAE,gBAAgB,EACxD,OAAO,EAAE,OAAO;IAGnC,wDAAwD;IACxD,mBAAmB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI;IAQ3D,gFAAgF;IAC1E,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;YAOxC,aAAa;YAgCb,kBAAkB;YAOlB,gBAAgB;YAmBhB,eAAe;YASf,cAAc;YA4Cd,YAAY;IAM1B,OAAO,CAAC,wBAAwB;YAMlB,iBAAiB;YASjB,SAAS;CAIxB"}

package/dist/agent/protocol-handler.js

@@ -0,0 +1,144 @@
+export const WRONGSTACK_VERSION = '0.1.0';
+const WRONGSTACK_CAPABILITIES = [
+    'code-generation',
+    'async-tools',
+    'streaming',
+    'progress',
+];
+export class ACPProtocolHandler {
+    transport;
+    registry;
+    context;
+    initialized = false;
+    sessionId;
+    signal = new AbortController();
+    pendingCalls = new Map();
+    constructor(transport, registry, context) {
+        this.transport = transport;
+        this.registry = registry;
+        this.context = context;
+    }
+    /** Wire an external abort signal from the ACP client */
+    wireAbortController(abortController) {
+        abortController.signal.addEventListener('abort', () => {
+            for (const id of this.pendingCalls.keys()) {
+                this.transport.send({ id, method: 'cancel', result: { ok: true } }).catch(() => { });
+            }
+        });
+    }
+    /** Process one inbound message. Returns true if this was a terminal message. */
+    async handleMessage(msg) {
+        if (msg.id !== undefined) {
+            return this.handleRequest(msg);
+        }
+        return this.handleNotification(msg);
+    }
+    async handleRequest(req) {
+        if (req.method !== 'initialize' && !this.initialized) {
+            await this.sendError(req.id ?? null, -32000, 'Not initialized');
+            return false;
+        }
+        // All requests after initialization check have a guaranteed id
+        const id = req.id;
+        switch (req.method) {
+            case 'initialize':
+                return this.handleInitialize(req, id);
+            case 'ping':
+                await this.transport.send({ id, method: 'ping', result: { pong: true } });
+                return false;
+            case 'tools/call':
+                return this.handleToolCall(req, id);
+            case 'tools/list':
+                return this.handleToolsList(id);
+            case 'cancel':
+                return this.handleCancel(id);
+            case 'session/list':
+                return this.handleSessionList(id);
+            case 'sessionInfoUpdate':
+                await this.transport.send({ id, method: 'sessionInfoUpdate', result: { ok: true } });
+                return false;
+            default:
+                await this.sendError(id, -32601, `Unknown method: ${req.method}`);
+                return false;
+        }
+    }
+    async handleNotification(n) {
+        if (n.method === 'cancel') {
+            this.handleCancelNotification(n);
+        }
+        return false;
+    }
+    async handleInitialize(req, id) {
+        this.sessionId = req.params?.sessionId ?? crypto.randomUUID();
+        this.initialized = true;
+        const result = {
+            capabilities: WRONGSTACK_CAPABILITIES,
+            agentName: 'WrongStack',
+            agentVersion: WRONGSTACK_VERSION,
+            protocolVersion: req.params?.protocolVersion ?? '2024-11',
+            ...this.registry.buildToolList(),
+        };
+        await this.transport.send({ id, method: 'initialize', result });
+        return false;
+    }
+    async handleToolsList(id) {
+        await this.transport.send({
+            id,
+            method: 'tools/list',
+            result: this.registry.buildToolList(),
+        });
+        return false;
+    }
+    async handleToolCall(req, id) {
+        const { name, arguments: args } = req.params;
+        const runPromise = (async () => {
+            if (!this.registry.has(name)) {
+                return {
+                    content: [{ type: 'text', text: `Tool not found: ${name}` }],
+                    isError: true,
+                };
+            }
+            const result = await this.registry.execute(name, args, this.context, this.signal.signal);
+            return result ?? { content: [{ type: 'text', text: 'Tool returned null' }], isError: false };
+        })();
+        this.pendingCalls.set(id, runPromise);
+        try {
+            const toolResult = (await runPromise);
+            this.pendingCalls.delete(id);
+            const response = { method: 'tools/call', id, result: toolResult };
+            await this.transport.send(response);
+        }
+        catch (err) {
+            this.pendingCalls.delete(id);
+            const msg = err instanceof Error ? err.message : String(err);
+            await this.transport.send({
+                id,
+                method: 'tools/call',
+                result: { content: [{ type: 'text', text: msg }], isError: true },
+            });
+        }
+        return false;
+    }
+    async handleCancel(id) {
+        this.pendingCalls.delete(id);
+        await this.transport.send({ id, method: 'cancel', result: { ok: true } });
+        return false;
+    }
+    handleCancelNotification(n) {
+        // Broadcast cancellation to all pending — best-effort
+    }
+    async handleSessionList(id) {
+        await this.transport.send({
+            id,
+            method: 'session/list',
+            result: { sessions: [] },
+        });
+        return false;
+    }
+    async sendError(id, code, message) {
+        if (id === null)
+            return;
+        await this.transport.send({ id, method: '', error: { code, message } });
+    }
+}
+//# sourceMappingURL=protocol-handler.js.map

package/dist/agent/protocol-handler.js.map

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

package/dist/agent/stdio-transport.d.ts

@@ -0,0 +1,74 @@
+/**
+ * StdioTransport — bidirectional stdin/stdout communication for ACP.
+ *
+ * ACP uses newline-delimited JSON-RPC 2.0 messages over stdio:
+ *   client → agent:  JSON-RPC request/notification on stdin
+ *   agent  → client: JSON-RPC response/notification on stdout
+ *
+ * Start message: clients look for the `[wstack-acp]` marker on stdout before
+ * treating subsequent lines as protocol messages.
+ */
+import { ACPMessage } from '../types/acp-messages.js';
+export interface AgentServerTransport {
+    send(msg: ACPMessage): Promise<void>;
+    sendRaw(chunk: string): void;
+    read(): Promise<ACPMessage | null>;
+    close(): void;
+    onMessage(handler: (msg: ACPMessage) => void): () => void;
+}
+export declare class StdioTransport implements AgentServerTransport {
+    private readonly stdin;
+    private readonly stdout;
+    private readonly stderr;
+    private buffer;
+    private readonly handlers;
+    private closed;
+    private resolveRead;
+    private messageQueue;
+    constructor();
+    sendStartupMarker(): void;
+    send(msg: ACPMessage): Promise<void>;
+    sendRaw(chunk: string): void;
+    read(): Promise<ACPMessage | null>;
+    onMessage(handler: (msg: ACPMessage) => void): () => void;
+    close(): void;
+    private onData;
+    private dispatch;
+    private handleClose;
+    private failAll;
+}
+import { EventEmitter } from 'node:events';
+export interface ClientTransportOptions {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    handshakeTimeoutMs?: number;
+}
+export interface ACPChildProcess extends EventEmitter {
+    stdout: NodeJS.ReadableStream;
+    stdin: NodeJS.WritableStream;
+    stderr: NodeJS.ReadableStream;
+    pid: number | undefined;
+    kill(): void;
+}
+export declare class ClientTransport {
+    private child;
+    private buffer;
+    private readonly handlers;
+    private closed;
+    private resolveRead;
+    private messageQueue;
+    private readonly opts;
+    constructor(options: ClientTransportOptions);
+    start(): Promise<void>;
+    send(msg: ACPMessage): Promise<void>;
+    read(): Promise<ACPMessage | null>;
+    onMessage(handler: (msg: ACPMessage) => void): () => void;
+    stop(): void;
+    private onChildData;
+    private onChildError;
+    private onChildClose;
+    private dispatch;
+}
+//# sourceMappingURL=stdio-transport.d.ts.map

package/dist/agent/stdio-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-transport.d.ts","sourceRoot":"","sources":["../../src/agent/stdio-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;IACd,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3D;AAED,qBAAa,cAAe,YAAW,oBAAoB;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAmD;IACtE,OAAO,CAAC,YAAY,CAAoB;;IAUxC,iBAAiB,IAAI,IAAI;IAIzB,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQlC,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAKzD,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,OAAO;CAIhB;AAOD,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAmD;IACtE,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CACI;gBAEb,OAAO,EAAE,sBAAsB;IAOrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD5B,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpC,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQlC,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAKzD,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,QAAQ;CAgBjB"}

package/dist/agent/stdio-transport.js

@@ -0,0 +1,239 @@
+export class StdioTransport {
+    stdin = process.stdin;
+    stdout = process.stdout;
+    stderr = process.stderr;
+    buffer = '';
+    handlers = new Set();
+    closed = false;
+    resolveRead = null;
+    messageQueue = [];
+    constructor() {
+        this.stdin.resume();
+        this.stdin.setEncoding('utf8');
+        this.stdin.on('data', (chunk) => this.onData(chunk));
+        this.stdin.on('end', () => this.handleClose());
+        this.stdin.on('error', (err) => this.failAll(err));
+    }
+    sendStartupMarker() {
+        this.stdout.write('[wstack-acp]\n', 'utf8');
+    }
+    send(msg) {
+        if (this.closed)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const line = JSON.stringify(msg) + '\n';
+            this.stdout.write(line, 'utf8', () => resolve());
+        });
+    }
+    sendRaw(chunk) {
+        this.stdout.write(chunk, 'utf8');
+    }
+    read() {
+        if (this.messageQueue.length > 0)
+            return Promise.resolve(this.messageQueue.shift());
+        if (this.closed)
+            return Promise.resolve(null);
+        return new Promise((resolve) => {
+            this.resolveRead = resolve;
+        });
+    }
+    onMessage(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    close() {
+        this.closed = true;
+        this.stdin.pause();
+        this.resolveRead?.(null);
+        this.resolveRead = null;
+    }
+    onData(chunk) {
+        this.buffer += chunk;
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        for (const raw of lines) {
+            if (!raw.trim())
+                continue;
+            try {
+                this.dispatch(JSON.parse(raw));
+            }
+            catch (err) {
+                this.stderr.write(`[wstack-acp parse error] ${err}\n`, 'utf8');
+            }
+        }
+    }
+    dispatch(msg) {
+        if (this.resolveRead) {
+            const resolve = this.resolveRead;
+            this.resolveRead = null;
+            resolve(msg);
+        }
+        else {
+            this.messageQueue.push(msg);
+        }
+        for (const handler of this.handlers) {
+            try {
+                handler(msg);
+            }
+            catch (err) {
+                this.stderr.write(`[wstack-acp handler error] ${err}\n`, 'utf8');
+            }
+        }
+    }
+    handleClose() {
+        this.closed = true;
+        this.resolveRead?.(null);
+        this.resolveRead = null;
+    }
+    failAll(err) {
+        this.stderr.write(`[wstack-acp stdin error] ${err.message}\n`, 'utf8');
+        this.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// ClientTransport — spawns a child ACP agent process (DIR-1)
+// ---------------------------------------------------------------------------
+import { spawn } from 'node:child_process';
+export class ClientTransport {
+    child = null;
+    buffer = '';
+    handlers = new Set();
+    closed = false;
+    resolveRead = null;
+    messageQueue = [];
+    opts;
+    constructor(options) {
+        this.opts = {
+            handshakeTimeoutMs: 30_000,
+            ...options,
+        };
+    }
+    async start() {
+        if (this.child)
+            return;
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error(`ACP child process failed to start within ${this.opts.handshakeTimeoutMs}ms`));
+            }, this.opts.handshakeTimeoutMs);
+            try {
+                this.child = spawn(this.opts.command, this.opts.args ?? [], {
+                    env: { ...process.env, ...this.opts.env },
+                    cwd: this.opts.cwd,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+            }
+            catch (err) {
+                clearTimeout(timeout);
+                reject(err);
+                return;
+            }
+            const child = this.child;
+            child.stdout.setEncoding('utf8');
+            const waitForMarker = (chunk) => {
+                this.buffer += chunk;
+                const idx = this.buffer.indexOf('[wstack-acp]\n');
+                if (idx !== -1) {
+                    this.buffer = this.buffer.slice(idx + '[wstack-acp]\n'.length);
+                    child.stdout.removeListener('data', waitForMarker);
+                    child.stdout.on('data', (c) => this.onChildData(c));
+                    child.stderr.on('data', (c) => this.onChildError(c));
+                    child.on('close', (code) => this.onChildClose(code));
+                    clearTimeout(timeout);
+                    resolve();
+                }
+            };
+            child.stdout.on('data', waitForMarker);
+            child.stdout.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+            child.on('error', (err) => {
+                clearTimeout(timeout);
+                reject(err);
+            });
+        });
+    }
+    send(msg) {
+        if (!this.child)
+            return Promise.reject(new Error('ClientTransport not started'));
+        return new Promise((resolve, reject) => {
+            const line = JSON.stringify(msg) + '\n';
+            this.child.stdin.write(line, 'utf8', (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    read() {
+        if (this.messageQueue.length > 0)
+            return Promise.resolve(this.messageQueue.shift());
+        if (this.closed)
+            return Promise.resolve(null);
+        return new Promise((resolve) => {
+            this.resolveRead = resolve;
+        });
+    }
+    onMessage(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    stop() {
+        if (!this.child)
+            return;
+        this.closed = true;
+        try {
+            this.child.kill();
+        }
+        catch {
+            // already dead
+        }
+        this.child = null;
+    }
+    onChildData(chunk) {
+        this.buffer += chunk;
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        for (const raw of lines) {
+            if (!raw.trim())
+                continue;
+            try {
+                this.dispatch(JSON.parse(raw));
+            }
+            catch {
+                // skip malformed
+            }
+        }
+    }
+    onChildError(chunk) {
+        process.stderr.write(`[acp-child stderr] ${chunk}`, 'utf8');
+    }
+    onChildClose(code) {
+        this.closed = true;
+        this.resolveRead?.(null);
+        this.resolveRead = null;
+        if (code !== 0 && code !== null) {
+            process.stderr.write(`[acp-child exited with code ${code}]\n`, 'utf8');
+        }
+    }
+    dispatch(msg) {
+        if (this.resolveRead) {
+            const resolve = this.resolveRead;
+            this.resolveRead = null;
+            resolve(msg);
+        }
+        else {
+            this.messageQueue.push(msg);
+        }
+        for (const handler of this.handlers) {
+            try {
+                handler(msg);
+            }
+            catch {
+                // non-fatal
+            }
+        }
+    }
+}
+//# sourceMappingURL=stdio-transport.js.map

package/dist/agent/stdio-transport.js.map

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

package/dist/agent/tools-registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tools registry for ACP agent-side.
+ *
+ * Translates WrongStack Tool definitions → ACP ACPToolDefinition format.
+ * Provides tool lookup and result assembly for the ACP protocol handler.
+ */
+import type { Tool } from '@wrongstack/core';
+import type { ACPToolList, ACPToolResult } from '../types/acp-messages.js';
+export declare class ACPToolsRegistry {
+    private tools;
+    private readonly owner;
+    constructor(owner?: string);
+    /**
+     * Register one or more tools.
+     * Throws on duplicate name unless force=true.
+     */
+    register(tools: Tool[]): void;
+    /**
+     * Replace the current tool set.
+     */
+    setTools(tools: Tool[]): void;
+    get(name: string): Tool | undefined;
+    has(name: string): boolean;
+    list(): Tool[];
+    /** Build the ACP tools/list payload from registered tools. */
+    buildToolList(): ACPToolList;
+    /**
+     * Execute a tool by name and return ACP-formatted result.
+     * Returns null if the tool is not found.
+     */
+    execute(name: string, args: Record<string, unknown>, ctx: unknown, signal: AbortSignal): Promise<ACPToolResult | null>;
+}
+//# sourceMappingURL=tools-registry.d.ts.map

package/dist/agent/tools-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-registry.d.ts","sourceRoot":"","sources":["../../src/agent/tools-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAEV,WAAW,EAEX,aAAa,EAEd,MAAM,0BAA0B,CAAC;AASlC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,SAAe;IAIhC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAM7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAK7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,IAAI,EAAE;IAId,8DAA8D;IAC9D,aAAa,IAAI,WAAW;IAQ5B;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAcjC"}