mcacp 0.1.0

package/dist/acp/lifecycle.js

@@ -0,0 +1,127 @@
+import { AcpTransport } from './transport.js';
+import { getAgentConfig } from '../config/index.js';
+export class LifecycleManager {
+    config;
+    agents = new Map();
+    installedAgents;
+    constructor(config, installedAgents) {
+        this.config = config;
+        this.installedAgents = installedAgents;
+    }
+    async initialize(agentId, protocolVersion, clientInfo, clientCapabilities) {
+        if (this.agents.has(agentId)) {
+            throw new Error(`Agent "${agentId}" is already running`);
+        }
+        const installed = this.installedAgents.get(agentId);
+        const agentConfig = getAgentConfig(this.config, agentId);
+        const command = agentConfig.command ?? installed?.command;
+        const args = agentConfig.args ?? installed?.args ?? [];
+        const env = agentConfig.env ?? installed?.env;
+        if (!command) {
+            throw new Error(`Agent "${agentId}" not installed and no command configured`);
+        }
+        const transport = new AcpTransport({ command, args, env, requestTimeoutMs: 60_000 });
+        transport.start();
+        transport.on('framingError', (line, err) => {
+            process.stderr.write(`[mcacp:${agentId}] Framing error: ${err instanceof Error ? err.message : err}\n`);
+            process.stderr.write(`[mcacp:${agentId}]   raw: ${line.slice(0, 200)}\n`);
+        });
+        transport.on('invalidMessage', (msg) => {
+            process.stderr.write(`[mcacp:${agentId}] Invalid JSON-RPC message: ${JSON.stringify(msg).slice(0, 200)}\n`);
+        });
+        transport.on('stderr', (data) => {
+            process.stderr.write(`[mcacp:${agentId}] ${data}`);
+        });
+        try {
+            const params = {
+                protocolVersion: protocolVersion ?? 1,
+                clientCapabilities: clientCapabilities ?? {
+                    fs: { readTextFile: true, writeTextFile: true },
+                    terminal: true,
+                },
+                clientInfo: clientInfo ?? {
+                    name: this.config.clientInfo.name,
+                    version: this.config.clientInfo.version,
+                    title: this.config.clientInfo.title,
+                },
+            };
+            const result = await transport.request('initialize', params);
+            const handle = {
+                agentId,
+                transport,
+                capabilities: result.agentCapabilities,
+                agentInfo: result.agentInfo,
+                protocolVersion: result.protocolVersion,
+                activeSessions: new Set(),
+                startedAt: Date.now(),
+                lastActivityAt: Date.now(),
+                reapTimer: null,
+                status: { text: 'initialized', updatedAt: Date.now() },
+            };
+            const reapMs = agentConfig.autoReapMs;
+            if (reapMs > 0) {
+                this.resetReapTimer(handle, reapMs);
+            }
+            transport.on('exit', () => {
+                this.agents.delete(agentId);
+            });
+            this.agents.set(agentId, handle);
+            return {
+                protocolVersion: result.protocolVersion,
+                agentInfo: result.agentInfo,
+                agentCapabilities: result.agentCapabilities,
+            };
+        }
+        catch (err) {
+            await transport.close();
+            throw err;
+        }
+    }
+    async shutdown(agentId) {
+        const handle = this.agents.get(agentId);
+        if (!handle)
+            return; // Already shut down (e.g. by reap timer racing with manual shutdown)
+        if (handle.reapTimer) {
+            clearTimeout(handle.reapTimer);
+            handle.reapTimer = null;
+        }
+        this.agents.delete(agentId);
+        handle.activeSessions.clear();
+        await handle.transport.close();
+    }
+    getAgent(agentId) {
+        const handle = this.agents.get(agentId);
+        if (!handle)
+            throw new Error(`Agent "${agentId}" is not running. Call initialize first.`);
+        return handle;
+    }
+    isRunning(agentId) {
+        return this.agents.has(agentId);
+    }
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    touchActivity(agentId) {
+        const handle = this.agents.get(agentId);
+        if (!handle)
+            return;
+        handle.lastActivityAt = Date.now();
+        const reapMs = getAgentConfig(this.config, agentId).autoReapMs;
+        if (reapMs > 0)
+            this.resetReapTimer(handle, reapMs);
+    }
+    updateInstalledAgents(installed) {
+        this.installedAgents = installed;
+    }
+    resetReapTimer(handle, reapMs) {
+        if (handle.reapTimer)
+            clearTimeout(handle.reapTimer);
+        handle.reapTimer = setTimeout(async () => {
+            handle.status = { text: 'auto-reaped (inactivity)', updatedAt: Date.now() };
+            await this.shutdown(handle.agentId).catch(() => { });
+        }, reapMs);
+        if (handle.reapTimer.unref)
+            handle.reapTimer.unref();
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/acp/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/acp/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA8BpD,MAAM,OAAO,gBAAgB;IAKjB;IAJF,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IACxC,eAAe,CAA8B;IAErD,YACU,MAAmB,EAC3B,eAA4C;QADpC,WAAM,GAAN,MAAM,CAAa;QAG3B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAAe,EACf,eAAwB,EACxB,UAA2B,EAC3B,kBAA2D;QAE3D,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,sBAAsB,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,IAAI,SAAS,EAAE,OAAO,CAAC;QAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,IAAI,SAAS,EAAE,GAAG,CAAC;QAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,2CAA2C,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;QACrF,SAAS,CAAC,KAAK,EAAE,CAAC;QAElB,SAAS,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAY,EAAE,GAAY,EAAE,EAAE;YAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACxG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,GAAY,EAAE,EAAE;YAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,+BAA+B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9G,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,GAAqB;gBAC/B,eAAe,EAAE,eAAe,IAAI,CAAC;gBACrC,kBAAkB,EAAE,kBAAkB,IAAI;oBACxC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;oBAC/C,QAAQ,EAAE,IAAI;iBACf;gBACD,UAAU,EAAE,UAAU,IAAI;oBACxB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI;oBACjC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO;oBACvC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK;iBACpC;aACF,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAqB,CAAC;YAEjF,MAAM,MAAM,GAAgB;gBAC1B,OAAO;gBACP,SAAS;gBACT,YAAY,EAAE,MAAM,CAAC,iBAAiB;gBACtC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,cAAc,EAAE,IAAI,GAAG,EAAE;gBACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;gBAC1B,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;aACvD,CAAC;YAEF,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC;YACtC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;YAED,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAEjC,OAAO;gBACL,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;aAC5C,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,qEAAqE;QAC1F,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,OAAe;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,0CAA0C,CAAC,CAAC;QAC1F,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,CAAC,OAAe;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,aAAa,CAAC,OAAe;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC;QAC/D,IAAI,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAED,qBAAqB,CAAC,SAAsC;QAC1D,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACnC,CAAC;IAEO,cAAc,CAAC,MAAmB,EAAE,MAAc;QACxD,IAAI,MAAM,CAAC,SAAS;YAAE,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YACvC,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,0BAA0B,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAC5E,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtD,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK;YAAE,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;CACF"}

package/dist/acp/status.d.ts

@@ -0,0 +1,31 @@
+import type { AgentHandle } from './lifecycle.js';
+import type { McacpConfig } from '../types/config.js';
+export interface AgentStatusSnapshot {
+    agentId: string;
+    status: string;
+    statusUpdatedAt: number;
+    alive: boolean;
+    startedAt: number;
+    lastActivityAt: number;
+    lastMessageAt: number;
+    activeSessions: string[];
+    uptime: number;
+}
+export interface DetailedAgentStatus extends AgentStatusSnapshot {
+    protocolVersion: number;
+    capabilities: Record<string, unknown>;
+    agentInfo?: {
+        name: string;
+        version: string;
+        title?: string;
+    };
+}
+export declare class StatusTracker {
+    private config;
+    constructor(config: McacpConfig);
+    getAll(agents: AgentHandle[]): AgentStatusSnapshot[];
+    getDetailed(handle: AgentHandle): DetailedAgentStatus;
+    isAlive(handle: AgentHandle): boolean;
+    setStatus(handle: AgentHandle, text: string): void;
+    updateFromSessionUpdate(handle: AgentHandle, update: Record<string, unknown>): void;
+}

package/dist/acp/status.js

@@ -0,0 +1,72 @@
+export class StatusTracker {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    getAll(agents) {
+        const now = Date.now();
+        return agents.map(h => ({
+            agentId: h.agentId,
+            status: h.status.text,
+            statusUpdatedAt: h.status.updatedAt,
+            alive: this.isAlive(h),
+            startedAt: h.startedAt,
+            lastActivityAt: h.lastActivityAt,
+            lastMessageAt: h.transport.lastMessageAt,
+            activeSessions: Array.from(h.activeSessions),
+            uptime: now - h.startedAt,
+        }));
+    }
+    getDetailed(handle) {
+        const now = Date.now();
+        return {
+            agentId: handle.agentId,
+            status: handle.status.text,
+            statusUpdatedAt: handle.status.updatedAt,
+            alive: this.isAlive(handle),
+            startedAt: handle.startedAt,
+            lastActivityAt: handle.lastActivityAt,
+            lastMessageAt: handle.transport.lastMessageAt,
+            activeSessions: Array.from(handle.activeSessions),
+            uptime: now - handle.startedAt,
+            protocolVersion: handle.protocolVersion,
+            capabilities: handle.capabilities,
+            agentInfo: handle.agentInfo,
+        };
+    }
+    isAlive(handle) {
+        if (handle.transport.closed)
+            return false;
+        return Date.now() - handle.transport.lastMessageAt < this.config.heartbeatTimeoutMs;
+    }
+    setStatus(handle, text) {
+        handle.status = { text, updatedAt: Date.now() };
+    }
+    updateFromSessionUpdate(handle, update) {
+        const type = update.sessionUpdate;
+        switch (type) {
+            case 'tool_call':
+                handle.status = { text: `Tool: ${update.title}`, updatedAt: Date.now() };
+                break;
+            case 'tool_call_update':
+                if (update.status === 'completed') {
+                    handle.status = { text: 'Processing...', updatedAt: Date.now() };
+                }
+                break;
+            case 'agent_message_chunk':
+                handle.status = { text: 'Responding...', updatedAt: Date.now() };
+                break;
+            case 'agent_thought_chunk':
+                handle.status = { text: 'Thinking...', updatedAt: Date.now() };
+                break;
+            case 'plan': {
+                const entries = update.entries;
+                const active = entries?.find(e => e.status === 'in_progress');
+                if (active)
+                    handle.status = { text: `Plan: ${active.content}`, updatedAt: Date.now() };
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/acp/status.js.map

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

package/dist/acp/transport.d.ts

@@ -0,0 +1,34 @@
+import { EventEmitter } from 'node:events';
+import type { RequestId } from '../types/acp.js';
+export interface TransportOptions {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    requestTimeoutMs?: number;
+}
+type IncomingRequestHandler = (method: string, params: unknown, id: RequestId) => Promise<unknown>;
+type NotificationHandler = (method: string, params: unknown) => void;
+export declare class AcpTransport extends EventEmitter {
+    private options;
+    private process;
+    private pendingRequests;
+    private nextId;
+    private requestTimeoutMs;
+    private onIncomingRequest;
+    private onNotification;
+    private _closed;
+    constructor(options: TransportOptions);
+    get closed(): boolean;
+    lastMessageAt: number;
+    start(): void;
+    setRequestHandler(handler: IncomingRequestHandler): void;
+    setNotificationHandler(handler: NotificationHandler): void;
+    request(method: string, params?: unknown): Promise<unknown>;
+    notify(method: string, params?: unknown): void;
+    close(killTimeoutMs?: number): Promise<void>;
+    private send;
+    private handleMessage;
+    private rejectAllPending;
+}
+export {};

package/dist/acp/transport.js

@@ -0,0 +1,175 @@
+import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import { createInterface } from 'node:readline';
+export class AcpTransport extends EventEmitter {
+    options;
+    process = null;
+    pendingRequests = new Map();
+    nextId = 1;
+    requestTimeoutMs;
+    onIncomingRequest = null;
+    onNotification = null;
+    _closed = false;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 300_000;
+    }
+    get closed() {
+        return this._closed;
+    }
+    lastMessageAt = Date.now();
+    start() {
+        const env = { ...process.env, ...this.options.env };
+        this.process = spawn(this.options.command, this.options.args ?? [], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env,
+            cwd: this.options.cwd,
+            shell: process.platform === 'win32',
+        });
+        this.process.on('exit', (code, signal) => {
+            this._closed = true;
+            this.rejectAllPending(new Error(`Agent process exited (code=${code}, signal=${signal})`));
+            this.emit('exit', code, signal);
+        });
+        this.process.on('error', (err) => {
+            this._closed = true;
+            this.rejectAllPending(err);
+            this.emit('error', err);
+        });
+        if (this.process.stderr) {
+            this.process.stderr.on('data', (chunk) => {
+                this.emit('stderr', chunk.toString());
+            });
+        }
+        if (this.process.stdout) {
+            const rl = createInterface({ input: this.process.stdout });
+            rl.on('line', (line) => {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    return;
+                let msg;
+                try {
+                    msg = JSON.parse(trimmed);
+                }
+                catch (err) {
+                    this.emit('framingError', trimmed, err);
+                    return;
+                }
+                this.lastMessageAt = Date.now();
+                if (!this.handleMessage(msg)) {
+                    this.emit('invalidMessage', msg);
+                }
+            });
+            rl.on('close', () => {
+                this._closed = true;
+            });
+        }
+    }
+    setRequestHandler(handler) {
+        this.onIncomingRequest = handler;
+    }
+    setNotificationHandler(handler) {
+        this.onNotification = handler;
+    }
+    async request(method, params) {
+        if (this._closed)
+            throw new Error('Transport is closed');
+        const id = this.nextId++;
+        const msg = { jsonrpc: '2.0', id, method, params };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(id);
+                reject(new Error(`Request timed out: ${method} (id=${id})`));
+            }, this.requestTimeoutMs);
+            this.pendingRequests.set(id, { resolve, reject, timer });
+            this.send(msg);
+        });
+    }
+    notify(method, params) {
+        if (this._closed)
+            throw new Error('Transport is closed');
+        const msg = { jsonrpc: '2.0', method, params };
+        this.send(msg);
+    }
+    async close(killTimeoutMs = 5000) {
+        if (this._closed)
+            return;
+        this._closed = true;
+        this.rejectAllPending(new Error('Transport closing'));
+        if (this.process && !this.process.killed) {
+            this.process.stdin?.end();
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    this.process?.kill('SIGKILL');
+                    resolve();
+                }, killTimeoutMs);
+                this.process.once('exit', () => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+        }
+    }
+    send(msg) {
+        if (!this.process?.stdin?.writable) {
+            throw new Error('Cannot write to agent process');
+        }
+        this.process.stdin.write(JSON.stringify(msg) + '\n');
+    }
+    handleMessage(msg) {
+        if ('id' in msg && msg.id !== undefined && msg.id !== null && ('result' in msg || 'error' in msg)) {
+            const resp = msg;
+            const idKey = typeof resp.id === 'number' ? resp.id : String(resp.id);
+            const pending = this.pendingRequests.get(idKey);
+            if (pending) {
+                this.pendingRequests.delete(idKey);
+                clearTimeout(pending.timer);
+                if (resp.error) {
+                    const err = new Error(resp.error.message);
+                    err.code = resp.error.code;
+                    err.data = resp.error.data;
+                    pending.reject(err);
+                }
+                else {
+                    pending.resolve(resp.result);
+                }
+            }
+            return true;
+        }
+        if ('id' in msg && 'method' in msg && !('result' in msg) && !('error' in msg)) {
+            const req = msg;
+            if (this.onIncomingRequest) {
+                this.onIncomingRequest(req.method, req.params, req.id)
+                    .then((result) => {
+                    this.send({ jsonrpc: '2.0', id: req.id, result });
+                })
+                    .catch((err) => {
+                    const error = {
+                        code: err.code ?? -32603,
+                        message: err instanceof Error ? err.message : String(err),
+                    };
+                    this.send({ jsonrpc: '2.0', id: req.id, error });
+                });
+            }
+            return true;
+        }
+        if ('method' in msg && !('id' in msg)) {
+            const notif = msg;
+            if (this.onNotification) {
+                this.onNotification(notif.method, notif.params);
+            }
+            this.emit('notification', notif.method, notif.params);
+            return true;
+        }
+        return false;
+    }
+    rejectAllPending(error) {
+        for (const [, pending] of this.pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pendingRequests.clear();
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/acp/transport.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,27 @@
+import { type McacpConfig } from '../types/config.js';
+/** Discovered agent from an editor config. */
+export interface DiscoveredAgent {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    source: string;
+    configPath: string;
+}
+/**
+ * Load config from multiple scopes: host < user < project < explicit.
+ * agent_servers entries merge across scopes (project wins on conflict).
+ */
+export declare function loadConfig(explicitPath?: string): McacpConfig;
+/** Resolve agent config by merging agent_servers entry with top-level defaults. */
+export declare function getAgentConfig(config: McacpConfig, agentId: string): {
+    autoReapMs: number;
+    permissionPolicy: "elicit" | "allow_all" | "deny_all" | "operator";
+    installPath: string | undefined;
+    command: string | undefined;
+    args: string[] | undefined;
+    env: Record<string, string> | undefined;
+};
+/** Scan editor configs for agent_servers entries. */
+export declare function discoverEditorAgents(): DiscoveredAgent[];
+export type { McacpConfig, AgentServer } from '../types/config.js';

package/dist/config/index.js

@@ -0,0 +1,162 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { McacpConfigSchema } from '../types/config.js';
+const CONFIG_FILENAMES = ['mcacp.json', '.mcacprc.json'];
+// ---- Config search paths per scope ----
+function projectPaths() {
+    return [process.cwd()];
+}
+function userPaths() {
+    const home = homedir();
+    const paths = [];
+    if (platform() === 'win32') {
+        const appData = process.env.APPDATA || join(home, 'AppData', 'Roaming');
+        paths.push(join(appData, 'mcacp'));
+    }
+    else {
+        paths.push(join(home, '.config', 'mcacp'));
+    }
+    paths.push(home); // legacy: ~/mcacp.json
+    return paths;
+}
+function hostPaths() {
+    if (platform() === 'win32') {
+        const programData = process.env.PROGRAMDATA || 'C:\\ProgramData';
+        return [join(programData, 'mcacp')];
+    }
+    return ['/etc/mcacp'];
+}
+// ---- Config loading ----
+function findConfigFile(dirs) {
+    for (const dir of dirs) {
+        for (const filename of CONFIG_FILENAMES) {
+            const filepath = resolve(dir, filename);
+            if (existsSync(filepath))
+                return filepath;
+        }
+        // Also accept config.json in dedicated config dirs
+        const configJson = resolve(dir, 'config.json');
+        if (existsSync(configJson))
+            return configJson;
+    }
+    return null;
+}
+function loadRawConfig(filepath) {
+    try {
+        return JSON.parse(readFileSync(filepath, 'utf-8'));
+    }
+    catch (err) {
+        throw new Error(`Failed to parse config "${filepath}": ${err instanceof Error ? err.message : err}`);
+    }
+}
+/** Deep-merge config objects. Later values win. agent_servers entries merge per-key. */
+function mergeConfigs(...configs) {
+    const merged = {};
+    for (const config of configs) {
+        for (const [key, value] of Object.entries(config)) {
+            if (key === 'agent_servers' && typeof value === 'object' && value !== null) {
+                merged[key] = { ...(merged[key] ?? {}), ...value };
+            }
+            else {
+                merged[key] = value;
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Load config from multiple scopes: host < user < project < explicit.
+ * agent_servers entries merge across scopes (project wins on conflict).
+ */
+export function loadConfig(explicitPath) {
+    const layers = [];
+    // Host scope (lowest priority)
+    const hostFile = findConfigFile(hostPaths());
+    if (hostFile)
+        layers.push(loadRawConfig(hostFile));
+    // Project scope
+    const projectFile = findConfigFile(projectPaths());
+    if (projectFile)
+        layers.push(loadRawConfig(projectFile));
+    // User scope
+    const userFile = findConfigFile(userPaths());
+    if (userFile)
+        layers.push(loadRawConfig(userFile));
+    // Explicit path (highest priority)
+    if (explicitPath) {
+        layers.push(loadRawConfig(explicitPath));
+    }
+    const merged = layers.length > 0 ? mergeConfigs(...layers) : {};
+    try {
+        return McacpConfigSchema.parse(merged);
+    }
+    catch (err) {
+        const sources = [hostFile, userFile, projectFile, explicitPath].filter(Boolean).join(', ');
+        throw new Error(`Invalid config (sources: ${sources || 'defaults'}): ${err instanceof Error ? err.message : err}`);
+    }
+}
+/** Resolve agent config by merging agent_servers entry with top-level defaults. */
+export function getAgentConfig(config, agentId) {
+    const entry = config.agent_servers[agentId];
+    return {
+        autoReapMs: entry?.autoReapMs ?? config.defaultAutoReapMs,
+        permissionPolicy: entry?.permissionPolicy ?? config.defaultPermissionPolicy,
+        installPath: entry?.installPath,
+        command: entry?.command,
+        args: entry?.args,
+        env: entry?.env,
+    };
+}
+// ---- Editor config discovery ----
+/** Known editor config locations. */
+function editorConfigPaths() {
+    const home = homedir();
+    const results = [];
+    // Zed
+    if (platform() === 'win32') {
+        const appData = process.env.APPDATA || join(home, 'AppData', 'Roaming');
+        results.push({ editor: 'zed', path: join(appData, 'Zed', 'settings.json') });
+    }
+    else if (platform() === 'darwin') {
+        results.push({ editor: 'zed', path: join(home, '.config', 'zed', 'settings.json') });
+    }
+    else {
+        results.push({ editor: 'zed', path: join(home, '.config', 'zed', 'settings.json') });
+    }
+    // JetBrains
+    results.push({ editor: 'jetbrains', path: join(home, '.jetbrains', 'acp.json') });
+    return results;
+}
+/** Scan editor configs for agent_servers entries. */
+export function discoverEditorAgents() {
+    const discovered = [];
+    for (const { editor, path: configPath } of editorConfigPaths()) {
+        if (!existsSync(configPath))
+            continue;
+        try {
+            const raw = JSON.parse(readFileSync(configPath, 'utf-8'));
+            const servers = raw?.agent_servers;
+            if (!servers || typeof servers !== 'object')
+                continue;
+            for (const [name, entry] of Object.entries(servers)) {
+                const e = entry;
+                if (!e.command || typeof e.command !== 'string')
+                    continue;
+                discovered.push({
+                    name,
+                    command: e.command,
+                    args: Array.isArray(e.args) ? e.args.filter((a) => typeof a === 'string') : undefined,
+                    env: e.env && typeof e.env === 'object' ? e.env : undefined,
+                    source: editor,
+                    configPath,
+                });
+            }
+        }
+        catch {
+            // Skip unparseable configs
+        }
+    }
+    return discovered;
+}
+//# sourceMappingURL=index.js.map