@agents-ensemble/core 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 otolab
+
+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/acp/acp-bridge.d.ts

@@ -0,0 +1,42 @@
+import { AcpClient, type AcpClientOptions, type SessionUpdateHandler } from './acp-client.js';
+import { type SpawnAcpProcessOptions } from './acp-process.js';
+import type { PermissionHandler, PromptResult } from './types.js';
+export interface AcpBridgeConnectOptions extends SpawnAcpProcessOptions {
+}
+export interface AcpBridgeRunSessionOptions {
+    cwd: string;
+    prompt: string;
+    /** 指定時は `session/load` で復元してから prompt する。失敗時は新規 session。 */
+    resumeSessionId?: string;
+    onUpdate?: SessionUpdateHandler;
+    /** 注入 bridge 利用時も worker ごとの handler を渡せる。 */
+    permissionHandler?: PermissionHandler;
+}
+export interface AcpBridgeRunSessionResult {
+    sessionId: string;
+    promptResult: PromptResult;
+}
+/**
+ * Facade for dispatch: holds a connected ACP client over a child process.
+ */
+export declare class AcpBridge {
+    private readonly client;
+    private constructor();
+    static connect(options?: AcpBridgeConnectOptions): Promise<AcpBridge>;
+    /** 接続済みクライアントから生成（integration / in-process Fake 用）。 */
+    static fromClient(client: AcpClient): AcpBridge;
+    newSession(cwd: string): Promise<string>;
+    loadSession(sessionId: string, cwd: string, permissionHandler?: PermissionHandler): Promise<void>;
+    prompt(sessionId: string, prompt: string, onUpdate?: SessionUpdateHandler): Promise<PromptResult>;
+    promptSession(sessionId: string, prompt: string, options?: {
+        permissionHandler?: PermissionHandler;
+        onUpdate?: SessionUpdateHandler;
+    }): Promise<PromptResult>;
+    /** 進行中の prompt ターンを中止する。 */
+    cancelSession(sessionId: string): void;
+    /** Create session and run a single prompt (typical worker dispatch). */
+    runSession(options: AcpBridgeRunSessionOptions): Promise<AcpBridgeRunSessionResult>;
+    close(): Promise<void>;
+}
+export { AcpClient, type AcpClientOptions };
+//# sourceMappingURL=acp-bridge.d.ts.map

package/dist/acp/acp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-bridge.d.ts","sourceRoot":"","sources":["../../src/acp/acp-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;CAAG;AAE1E,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,SAAS;IACA,OAAO,CAAC,QAAQ,CAAC,MAAM;IAA3C,OAAO;WAEM,OAAO,CAClB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,SAAS,CAAC;IAMrB,uDAAuD;IACvD,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS;IAIzC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxC,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,IAAI,CAAC;IASV,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,YAAY,CAAC;IAIlB,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;QACtC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;KACjC,GACA,OAAO,CAAC,YAAY,CAAC;IAQxB,4BAA4B;IAC5B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,wEAAwE;IAClE,UAAU,CACd,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC;IAiC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/acp/acp-bridge.js

@@ -0,0 +1,73 @@
+import { AcpClient } from './acp-client.js';
+import { spawnAcpProcess } from './acp-process.js';
+/**
+ * Facade for dispatch: holds a connected ACP client over a child process.
+ */
+export class AcpBridge {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    static async connect(options = {}) {
+        const client = await spawnAcpProcess(options);
+        await client.connect();
+        return new AcpBridge(client);
+    }
+    /** 接続済みクライアントから生成（integration / in-process Fake 用）。 */
+    static fromClient(client) {
+        return new AcpBridge(client);
+    }
+    async newSession(cwd) {
+        return this.client.newSession(cwd);
+    }
+    async loadSession(sessionId, cwd, permissionHandler) {
+        if (permissionHandler) {
+            return this.client.withPermissionHandler(permissionHandler, () => this.client.loadSession(sessionId, cwd));
+        }
+        return this.client.loadSession(sessionId, cwd);
+    }
+    async prompt(sessionId, prompt, onUpdate) {
+        return this.promptSession(sessionId, prompt, { onUpdate });
+    }
+    async promptSession(sessionId, prompt, options) {
+        const run = () => this.client.prompt(sessionId, prompt, options?.onUpdate);
+        if (options?.permissionHandler) {
+            return this.client.withPermissionHandler(options.permissionHandler, run);
+        }
+        return run();
+    }
+    /** 進行中の prompt ターンを中止する。 */
+    cancelSession(sessionId) {
+        this.client.cancelSession(sessionId);
+    }
+    /** Create session and run a single prompt (typical worker dispatch). */
+    async runSession(options) {
+        const runPrompt = async (sessionId) => this.prompt(sessionId, options.prompt, options.onUpdate);
+        let sessionId = options.resumeSessionId;
+        if (sessionId) {
+            try {
+                if (options.permissionHandler) {
+                    await this.client.withPermissionHandler(options.permissionHandler, () => this.loadSession(sessionId, options.cwd));
+                }
+                else {
+                    await this.loadSession(sessionId, options.cwd);
+                }
+            }
+            catch {
+                sessionId = undefined;
+            }
+        }
+        if (!sessionId) {
+            sessionId = await this.newSession(options.cwd);
+        }
+        const promptResult = options.permissionHandler
+            ? await this.client.withPermissionHandler(options.permissionHandler, () => runPrompt(sessionId))
+            : await runPrompt(sessionId);
+        return { sessionId, promptResult };
+    }
+    async close() {
+        await this.client.close();
+    }
+}
+export { AcpClient };
+//# sourceMappingURL=acp-bridge.js.map

package/dist/acp/acp-bridge.js.map

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

package/dist/acp/acp-client.d.ts

@@ -0,0 +1,45 @@
+import type { ChildProcess } from 'node:child_process';
+import type { Readable, Writable } from 'node:stream';
+import { JsonRpcPeer } from './json-rpc-peer.js';
+import type { JsonRpcNotification, JsonRpcRequest } from './json-rpc.js';
+import { type AcpPromptBlock, type PermissionHandler, type PromptResult, type SessionUpdateNotification } from './types.js';
+export interface AcpClientOptions {
+    permissionHandler?: PermissionHandler;
+    clientName?: string;
+    clientVersion?: string;
+    /** Set when backed by a child process (for cleanup). */
+    childProcess?: ChildProcess;
+    /** 子プロセス stderr capture の drain（close 時に呼ぶ）。 */
+    drainChildStderr?: () => Promise<void>;
+}
+export type SessionUpdateHandler = (update: SessionUpdateNotification) => void;
+export interface AcpClientStreams {
+    readable: Readable;
+    writable: Writable;
+}
+/**
+ * High-level ACP client: initialize → authenticate → session/* .
+ */
+export declare class AcpClient {
+    private readonly options;
+    readonly peer: JsonRpcPeer;
+    private promptUpdateHandler?;
+    private permissionHandlerOverride?;
+    private constructor();
+    static create(streams: AcpClientStreams, options?: AcpClientOptions): AcpClient;
+    get childProcess(): ChildProcess | undefined;
+    initialize(): Promise<void>;
+    authenticate(methodId?: string): Promise<void>;
+    connect(): Promise<void>;
+    newSession(cwd: string, mcpServers?: unknown[]): Promise<string>;
+    loadSession(sessionId: string, cwd: string, mcpServers?: unknown[]): Promise<void>;
+    /** 進行中の `session/prompt` を中止する（ACP `session/cancel` notification）。 */
+    cancelSession(sessionId: string): void;
+    prompt(sessionId: string, prompt: string | AcpPromptBlock[], onUpdate?: SessionUpdateHandler): Promise<PromptResult>;
+    close(): Promise<void>;
+    withPermissionHandler<T>(handler: PermissionHandler, fn: () => Promise<T>): Promise<T>;
+    handleNotification(notification: JsonRpcNotification): void;
+    handleRequest(request: JsonRpcRequest): Promise<void>;
+}
+export declare function terminateChildProcess(child: ChildProcess): Promise<void>;
+//# sourceMappingURL=acp-client.d.ts.map

package/dist/acp/acp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-client.d.ts","sourceRoot":"","sources":["../../src/acp/acp-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,yBAAyB,KAC9B,IAAI,CAAC;AAEV,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,SAAS;IAOlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,mBAAmB,CAAC,CAAuB;IACnD,OAAO,CAAC,yBAAyB,CAAC,CAAoB;IAEtD,OAAO;IAOP,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,gBAAqB,GAC7B,SAAS;IAcZ,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAE3C;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,YAAY,CAAC,QAAQ,SAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAQpE,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,OAAO,EAAO,GACzB,OAAO,CAAC,IAAI,CAAC;IAQhB,sEAAsE;IACtE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIhC,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,EACjC,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,YAAY,CAAC;IA8BlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,qBAAqB,CAAC,CAAC,EACrB,OAAO,EAAE,iBAAiB,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAQb,kBAAkB,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI;IAOrD,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAS5D;AAcD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9E"}

package/dist/acp/acp-client.js

@@ -0,0 +1,171 @@
+import { JsonRpcPeer } from './json-rpc-peer.js';
+import { DEFAULT_PERMISSION_DECISION, } from './types.js';
+/**
+ * High-level ACP client: initialize → authenticate → session/* .
+ */
+export class AcpClient {
+    options;
+    peer;
+    promptUpdateHandler;
+    permissionHandlerOverride;
+    constructor(peer, options) {
+        this.options = options;
+        this.peer = peer;
+    }
+    static create(streams, options = {}) {
+        const holder = {};
+        const peer = new JsonRpcPeer({
+            readable: streams.readable,
+            writable: streams.writable,
+            onNotification: (notification) => holder.client?.handleNotification(notification),
+            onRequest: (request) => holder.client?.handleRequest(request),
+        });
+        const client = new AcpClient(peer, options);
+        holder.client = client;
+        return client;
+    }
+    get childProcess() {
+        return this.options.childProcess;
+    }
+    async initialize() {
+        await this.peer.request('initialize', {
+            protocolVersion: 1,
+            clientCapabilities: {
+                fs: { readTextFile: false, writeTextFile: false },
+                terminal: false,
+            },
+            clientInfo: {
+                name: optionsClientName(this.options),
+                version: optionsClientVersion(this.options),
+            },
+        });
+    }
+    async authenticate(methodId = 'cursor_login') {
+        await this.peer.request('authenticate', { methodId });
+    }
+    async connect() {
+        await this.initialize();
+        await this.authenticate();
+    }
+    async newSession(cwd, mcpServers = []) {
+        const result = (await this.peer.request('session/new', {
+            cwd,
+            mcpServers,
+        }));
+        return result.sessionId;
+    }
+    async loadSession(sessionId, cwd, mcpServers = []) {
+        await this.peer.request('session/load', {
+            sessionId,
+            cwd,
+            mcpServers,
+        });
+    }
+    /** 進行中の `session/prompt` を中止する（ACP `session/cancel` notification）。 */
+    cancelSession(sessionId) {
+        this.peer.notify('session/cancel', { sessionId });
+    }
+    async prompt(sessionId, prompt, onUpdate) {
+        const responseChunks = [];
+        const wrappedOnUpdate = (update) => {
+            const text = update.update?.content?.text;
+            if (typeof text === 'string' && text.length > 0) {
+                responseChunks.push(text);
+            }
+            onUpdate?.(update);
+        };
+        this.promptUpdateHandler = wrappedOnUpdate;
+        try {
+            const blocks = typeof prompt === 'string'
+                ? [{ type: 'text', text: prompt }]
+                : prompt;
+            const result = (await this.peer.request('session/prompt', {
+                sessionId,
+                prompt: blocks,
+            }));
+            const responseText = responseChunks.join('');
+            return {
+                ...result,
+                responseText: responseText || undefined,
+                usage: result.usage,
+            };
+        }
+        finally {
+            this.promptUpdateHandler = undefined;
+        }
+    }
+    async close() {
+        this.peer.close();
+        this.options.childProcess?.stdin?.end();
+        if (this.options.drainChildStderr) {
+            await this.options.drainChildStderr();
+        }
+        if (this.options.childProcess) {
+            await terminateChildProcess(this.options.childProcess);
+        }
+    }
+    withPermissionHandler(handler, fn) {
+        const previous = this.permissionHandlerOverride;
+        this.permissionHandlerOverride = handler;
+        return fn().finally(() => {
+            this.permissionHandlerOverride = previous;
+        });
+    }
+    handleNotification(notification) {
+        if (notification.method !== 'session/update')
+            return;
+        this.promptUpdateHandler?.(notification.params);
+    }
+    async handleRequest(request) {
+        if (request.method !== 'session/request_permission')
+            return;
+        const handler = this.permissionHandlerOverride ??
+            this.options.permissionHandler ??
+            defaultPermissionHandler;
+        const decision = await handler(request.params);
+        this.peer.respond(request.id, decision);
+    }
+}
+function optionsClientName(options) {
+    return options.clientName ?? 'agents-ensemble';
+}
+function optionsClientVersion(options) {
+    return options.clientVersion ?? '0.0.0';
+}
+function defaultPermissionHandler() {
+    return DEFAULT_PERMISSION_DECISION;
+}
+export async function terminateChildProcess(child) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    child.stdin?.end();
+    if (!child.killed) {
+        child.kill('SIGTERM');
+    }
+    const exited = await waitForChildExit(child, 5_000);
+    if (!exited && !child.killed) {
+        child.kill('SIGKILL');
+        await waitForChildExit(child, 2_000);
+    }
+}
+function waitForChildExit(child, timeoutMs) {
+    if (child.exitCode !== null || child.signalCode !== null) {
+        return Promise.resolve(true);
+    }
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve(false);
+        }, timeoutMs);
+        const onExit = () => {
+            cleanup();
+            resolve(true);
+        };
+        const cleanup = () => {
+            clearTimeout(timer);
+            child.off('exit', onExit);
+        };
+        child.once('exit', onExit);
+    });
+}
+//# sourceMappingURL=acp-client.js.map

package/dist/acp/acp-client.js.map

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

package/dist/acp/acp-process.d.ts

@@ -0,0 +1,33 @@
+import { type ChildProcess } from 'node:child_process';
+import { AcpClient, type AcpClientOptions } from './acp-client.js';
+import { type WorkerProcessStdioLine, type WorkerProcessStdioLineHandler } from './process-stream-capture.js';
+import type { PermissionHandler, PromptResult } from './types.js';
+import type { SessionUpdateHandler } from './acp-client.js';
+export interface SpawnAcpProcessOptions extends AcpClientOptions {
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    /** worker attach 時に設定。子プロセス stdio capture のラベル用。 */
+    workerName?: string;
+    /** stderr 行を harness へ渡す（SessionLogger 等）。 */
+    onProcessStdioLine?: WorkerProcessStdioLineHandler;
+}
+export type { WorkerProcessStdioLine, WorkerProcessStdioLineHandler };
+export interface RunAcpSessionOptions {
+    cwd: string;
+    prompt: string;
+    onUpdate?: SessionUpdateHandler;
+    permissionHandler?: PermissionHandler;
+    spawn?: SpawnAcpProcessOptions;
+}
+/**
+ * Spawn `agent acp` and return a connected client.
+ */
+export declare function spawnAcpProcess(options?: SpawnAcpProcessOptions): Promise<AcpClient>;
+/**
+ * One-shot: spawn → connect → session/new → session/prompt → cleanup.
+ */
+export declare function runAcpSession(options: RunAcpSessionOptions): Promise<PromptResult>;
+export type { ChildProcess };
+//# sourceMappingURL=acp-process.d.ts.map

package/dist/acp/acp-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-process.d.ts","sourceRoot":"","sources":["../../src/acp/acp-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,6BAA6B,CAAC;CACpD;AAED,YAAY,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,SAAS,CAAC,CAkCpB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CASvB;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/acp/acp-process.js

@@ -0,0 +1,49 @@
+import { spawn } from 'node:child_process';
+import { once } from 'node:events';
+import { AcpClient } from './acp-client.js';
+import { attachChildProcessStderrCapture, } from './process-stream-capture.js';
+/**
+ * Spawn `agent acp` and return a connected client.
+ */
+export async function spawnAcpProcess(options = {}) {
+    const command = options.command ?? 'agent';
+    const args = options.args ?? ['acp'];
+    const child = spawn(command, args, {
+        cwd: options.cwd ?? process.cwd(),
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env: options.env ?? process.env,
+    });
+    if (!child.stdin || !child.stdout || !child.stderr) {
+        child.kill();
+        throw new Error(`Failed to open stdio for ${command} ${args.join(' ')}`);
+    }
+    const { drainStderr } = attachChildProcessStderrCapture(child.stderr, {
+        workerName: options.workerName,
+        onLine: options.onProcessStdioLine,
+    });
+    const drainChildStderr = async () => {
+        if (!child.stderr.readableEnded) {
+            await Promise.race([
+                once(child.stderr, 'end'),
+                once(child, 'exit'),
+            ]);
+        }
+        await drainStderr();
+    };
+    return AcpClient.create({ readable: child.stdout, writable: child.stdin }, { ...options, childProcess: child, drainChildStderr });
+}
+/**
+ * One-shot: spawn → connect → session/new → session/prompt → cleanup.
+ */
+export async function runAcpSession(options) {
+    const client = await spawnAcpProcess(options.spawn);
+    try {
+        await client.connect();
+        const sessionId = await client.newSession(options.cwd);
+        return await client.prompt(sessionId, options.prompt, options.onUpdate);
+    }
+    finally {
+        await client.close();
+    }
+}
+//# sourceMappingURL=acp-process.js.map

package/dist/acp/acp-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-process.js","sourceRoot":"","sources":["../../src/acp/acp-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,SAAS,EAAyB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,+BAA+B,GAGhC,MAAM,6BAA6B,CAAC;AAyBrC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkC,EAAE;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QACjC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACjC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;KAChC,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,GAAG,+BAA+B,CAAC,KAAK,CAAC,MAAM,EAAE;QACpE,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,kBAAkB;KACnC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,KAAK,IAAmB,EAAE;QACjD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAChC,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;gBACzB,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;aACpB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC,MAAM,CACrB,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,EACjD,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,CACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvD,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/acp/json-rpc-peer.d.ts

@@ -0,0 +1,31 @@
+import type { Readable, Writable } from 'node:stream';
+import type { JsonRpcNotification, JsonRpcRequest } from './json-rpc.js';
+export type NotificationHandler = (notification: JsonRpcNotification) => void;
+export type RequestHandler = (request: JsonRpcRequest) => void | Promise<void>;
+export interface JsonRpcPeerOptions {
+    readable: Readable;
+    writable: Writable;
+    onNotification?: NotificationHandler;
+    /** Agent-initiated requests (e.g. session/request_permission). */
+    onRequest?: RequestHandler;
+}
+/**
+ * Client-side JSON-RPC peer over newline-delimited stdio.
+ * Matches the transport used by `agent acp` (see Cursor ACP docs).
+ */
+export declare class JsonRpcPeer {
+    private readonly options;
+    private readonly pending;
+    private readonly lineBuffer;
+    private nextId;
+    private closed;
+    constructor(options: JsonRpcPeerOptions);
+    request(method: string, params?: unknown): Promise<unknown>;
+    respond(id: number | string, result: unknown): void;
+    notify(method: string, params?: unknown): void;
+    close(): void;
+    private handleChunk;
+    private handleLine;
+    private rejectAll;
+}
+//# sourceMappingURL=json-rpc-peer.d.ts.map

package/dist/acp/json-rpc-peer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc-peer.d.ts","sourceRoot":"","sources":["../../src/acp/json-rpc-peer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAkB,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzF,MAAM,MAAM,mBAAmB,GAAG,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAO/E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,kEAAkE;IAClE,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAS;gBAEM,OAAO,EAAE,kBAAkB;IAOlD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAajE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAMnD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAM9C,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,SAAS;CAMlB"}

package/dist/acp/json-rpc-peer.js

@@ -0,0 +1,78 @@
+import { NdJsonLineBuffer, parseMessage, serializeMessage } from './json-rpc.js';
+/**
+ * Client-side JSON-RPC peer over newline-delimited stdio.
+ * Matches the transport used by `agent acp` (see Cursor ACP docs).
+ */
+export class JsonRpcPeer {
+    options;
+    pending = new Map();
+    lineBuffer = new NdJsonLineBuffer();
+    nextId = 1;
+    closed = false;
+    constructor(options) {
+        this.options = options;
+        options.readable.setEncoding('utf8');
+        options.readable.on('data', (chunk) => this.handleChunk(chunk));
+        options.readable.on('end', () => this.rejectAll(new Error('JSON-RPC stream ended')));
+        options.readable.on('error', (error) => this.rejectAll(error));
+    }
+    async request(method, params) {
+        if (this.closed) {
+            throw new Error('JSON-RPC peer is closed');
+        }
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            const message = { jsonrpc: '2.0', id, method, params };
+            this.options.writable.write(serializeMessage(message));
+        });
+    }
+    respond(id, result) {
+        this.options.writable.write(serializeMessage({ jsonrpc: '2.0', id, result }));
+    }
+    notify(method, params) {
+        this.options.writable.write(serializeMessage({ jsonrpc: '2.0', method, params }));
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.rejectAll(new Error('JSON-RPC peer closed'));
+    }
+    handleChunk(chunk) {
+        for (const line of this.lineBuffer.push(chunk)) {
+            this.handleLine(line);
+        }
+    }
+    handleLine(line) {
+        const message = parseMessage(line);
+        if ('id' in message && ('result' in message || 'error' in message)) {
+            const waiter = this.pending.get(message.id);
+            if (!waiter)
+                return;
+            this.pending.delete(message.id);
+            if (message.error) {
+                waiter.reject(new Error(message.error.message));
+            }
+            else {
+                waiter.resolve(message.result);
+            }
+            return;
+        }
+        if ('method' in message && !('id' in message)) {
+            this.options.onNotification?.(message);
+            return;
+        }
+        if ('method' in message && 'id' in message) {
+            void this.options.onRequest?.(message);
+            return;
+        }
+    }
+    rejectAll(error) {
+        for (const waiter of this.pending.values()) {
+            waiter.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=json-rpc-peer.js.map

package/dist/acp/json-rpc-peer.js.map

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

package/dist/acp/json-rpc.d.ts

@@ -0,0 +1,36 @@
+/** JSON-RPC 2.0 message types (newline-delimited over stdio). */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number | string;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+export declare function isJsonRpcResponse(msg: JsonRpcMessage): msg is JsonRpcResponse;
+export declare function isJsonRpcRequest(msg: JsonRpcMessage): msg is JsonRpcRequest;
+export declare function isJsonRpcNotification(msg: JsonRpcMessage): msg is JsonRpcNotification;
+export declare function serializeMessage(message: JsonRpcMessage): string;
+export declare function parseMessage(line: string): JsonRpcMessage;
+/** Incomplete lines from a byte stream. */
+export declare class NdJsonLineBuffer {
+    private buffer;
+    push(chunk: string): string[];
+    flush(): string[];
+}
+//# sourceMappingURL=json-rpc.d.ts.map

package/dist/acp/json-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../../src/acp/json-rpc.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,mBAAmB,GACnB,eAAe,CAAC;AAEpB,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,GAAG,IAAI,eAAe,CAE7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,GAAG,IAAI,cAAc,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,GAAG,IAAI,mBAAmB,CAErF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEhE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAczD;AAED,2CAA2C;AAC3C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAM;IAEpB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAO7B,KAAK,IAAI,MAAM,EAAE;CASlB"}