@wrongstack/acp 0.284.1 → 0.285.0

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

@@ -0,0 +1,349 @@
+/**
+ * ACPSession — v1-correct ACP client.
+ *
+ * Owns one child process running an ACP-supporting agent (Claude Code,
+ * Gemini CLI, Codex CLI, etc.) and translates the wire protocol into
+ * a `SubagentRunner`-shaped surface for the rest of WrongStack.
+ *
+ * Spec: https://agentclientprotocol.com/protocol/v1/overview
+ * Design: see ./acp-session.design.md in this directory.
+ */
+import { type ACPClientTransport } from '../agent/stdio-transport.js';
+import { type WebSocketClientTransportOptions } from './websocket-transport.js';
+import { type AgentCapabilities, type AnySessionUpdate, type AuthMethod, type ContentBlock, type McpServer, type PlanEntry, type SessionId, type SessionInfo, type StopReason, type ToolCallStatus, type ToolKind, type UsageCost } from '../types/acp-v1.js';
+import { type PermissionPolicy } from './permission.js';
+export interface ACPSessionOptions {
+    command: string;
+    args?: readonly string[] | undefined;
+    env?: Record<string, string> | undefined;
+    cwd?: string | undefined;
+    role?: string | undefined;
+    /** Sandbox root for fs/* and terminal/* methods. */
+    projectRoot: string;
+    /** Hard timeout for one prompt turn. Default 5 minutes. */
+    timeoutMs?: number | undefined;
+    /** Override the permission policy. */
+    permissionPolicy?: PermissionPolicy | undefined;
+    /** Per-fs-call timeout, default 30s. */
+    fsTimeoutMs?: number | undefined;
+    /** Per-terminal command timeout, default 5 minutes. */
+    terminalTimeoutMs?: number | undefined;
+    /** Per-terminal output byte cap, default 1 MiB. */
+    terminalOutputByteLimit?: number | undefined;
+    /**
+     * MCP server configs to include in session/new, session/load, and
+     * session/resume. The agent will connect to these servers to provide
+     * additional tools.
+     *
+     * Stdio servers are always sent. HTTP/SSE servers are only sent if
+     * the agent advertises the corresponding mcpCapabilities.
+     */
+    mcpServers?: McpServer[] | undefined;
+}
+/**
+ * A captured file diff emitted by the agent during a turn (via a tool
+ * call's `diff` content). `oldText: null` means the file was created.
+ */
+export interface ACPCapturedDiff {
+    path: string;
+    oldText: string | null;
+    newText: string;
+}
+/**
+ * A captured tool call the agent ran during a turn. We collapse the
+ * `tool_call` + subsequent `tool_call_update` notifications for the same
+ * `toolCallId` into one record carrying its latest status.
+ */
+export interface ACPCapturedToolCall {
+    toolCallId: string;
+    title: string;
+    kind?: ToolKind | undefined;
+    status: ToolCallStatus;
+    /** Terminal/command output or text content surfaced by the tool, if any. */
+    rawOutput?: Record<string, unknown> | undefined;
+    rawInput?: Record<string, unknown> | undefined;
+}
+export interface ACPSessionRunResult {
+    text: string;
+    stopReason: StopReason;
+    hasText: boolean;
+    usage?: {
+        used: number;
+        size: number;
+        cost?: UsageCost | undefined;
+    } | undefined;
+    plan?: PlanEntry[] | undefined;
+    /** Tool calls the agent ran this turn (deduped by toolCallId). */
+    toolCalls: ACPCapturedToolCall[];
+    /** File diffs the agent produced this turn. */
+    diffs: ACPCapturedDiff[];
+    /** Agent "thinking" text emitted via thought_chunk, concatenated. */
+    thoughts: string;
+}
+/**
+ * Live progress callback. Invoked for every `session/update` notification
+ * the agent streams during a `prompt()` turn, in arrival order, BEFORE the
+ * turn resolves. Lets the host render tool activity / text deltas / diffs
+ * as they happen instead of waiting for the buffered final result.
+ *
+ * The raw `update` (the discriminated `session/update` payload) is passed
+ * through verbatim so callers can switch on `update.sessionUpdate`.
+ */
+export type ACPProgressHandler = (event: ACPProgressEvent) => void;
+export type ACPProgressEvent = {
+    type: 'message';
+    text: string;
+} | {
+    type: 'thought';
+    text: string;
+} | {
+    type: 'tool_call';
+    toolCall: ACPCapturedToolCall;
+} | {
+    type: 'tool_call_update';
+    toolCall: ACPCapturedToolCall;
+} | {
+    type: 'diff';
+    diff: ACPCapturedDiff;
+} | {
+    type: 'plan';
+    entries: PlanEntry[];
+} | {
+    type: 'usage';
+    usage: {
+        used: number;
+        size: number;
+        cost?: UsageCost | undefined;
+    };
+} | {
+    type: 'raw';
+    update: AnySessionUpdate;
+};
+export type ACPSessionErrorKind = 'spawn_failed' | 'init_failed' | 'protocol_error' | 'session_create_failed' | 'prompt_failed' | 'auth_failed' | 'logout_failed' | 'aborted' | 'closed' | 'agent_died' | 'unsupported_capability';
+export declare class ACPSessionError extends Error {
+    readonly kind: ACPSessionErrorKind;
+    readonly cause: unknown;
+    constructor(kind: ACPSessionErrorKind, message: string, cause?: unknown);
+}
+export declare class ACPSession {
+    private readonly transport;
+    private readonly fileServer;
+    private readonly terminalServer;
+    private readonly permissionPolicy;
+    private readonly timeoutMs;
+    private readonly opts;
+    private state;
+    private sessionId;
+    /** Pending outbound requests (initialize, session/new, session/prompt, etc). */
+    private readonly pending;
+    private nextId;
+    /** True after close() has been called. */
+    private closed;
+    private agentCapabilities;
+    private agentInfo;
+    private authMethods;
+    /** Protocol version negotiated with the agent during initialize. */
+    private negotiatedVersion;
+    private constructor();
+    /** Agent capabilities advertised during initialize. */
+    getCapabilities(): AgentCapabilities;
+    /** Authentication methods advertised by the agent. */
+    getAuthMethods(): AuthMethod[];
+    /** Agent info (name, title, version) from initialize. */
+    getAgentInfo(): {
+        name: string;
+        title?: string | undefined;
+        version: string;
+    } | null;
+    /** Whether the agent requires authentication (has auth methods). */
+    requiresAuth(): boolean;
+    /** Current session id, if one exists. */
+    getSessionId(): SessionId | null;
+    /** Protocol version negotiated during initialize. */
+    getNegotiatedVersion(): number;
+    /**
+     * Spawn the child, run the initialize handshake, install the
+     * message dispatch, and return a ready session.
+     */
+    static start(opts: ACPSessionOptions): Promise<ACPSession>;
+    /**
+     * Connect to a REMOTE ACP agent over a WebSocket instead of spawning a
+     * local subprocess. `opts.command` is ignored for the wire (a label is
+     * still useful for `role`); everything else (projectRoot sandbox for
+     * fs/terminal, timeouts, permission policy, MCP servers) applies the same.
+     */
+    static connectWebSocket(wsOpts: WebSocketClientTransportOptions, opts: ACPSessionOptions): Promise<ACPSession>;
+    /**
+     * Connect using a caller-supplied transport. Lets advanced callers plug
+     * in their own wire (SDK streams, in-process pipes, test doubles).
+     */
+    static connect(transport: ACPClientTransport, opts: ACPSessionOptions): Promise<ACPSession>;
+    /** Shared connect path: start the transport, install dispatch, handshake. */
+    private static attach;
+    private initialize;
+    /**
+     * Authenticate with the agent using one of the advertised auth methods.
+     * Call this AFTER start() and BEFORE any session/new call.
+     *
+     * Throws ACPSessionError('auth_failed') if the agent rejects the
+     * authentication or if the methodId is not in the advertised list.
+     */
+    authenticate(methodId: string): Promise<void>;
+    /**
+     * Log out from the current authenticated session.
+     * Only callable if the agent advertises `auth.logout` capability.
+     */
+    logout(): Promise<void>;
+    /**
+     * Load an existing session. The agent replays the conversation history
+     * via session/update notifications before responding.
+     *
+     * Only works if the agent advertises `loadSession` capability.
+     *
+     * @param sessionId - The session to load
+     * @param mcpServers - Optional MCP servers (defaults to options.mcpServers)
+     * @param cwd - Optional working directory (defaults to options.cwd or projectRoot)
+     */
+    loadSession(sessionId: SessionId, mcpServers?: McpServer[], cwd?: string): Promise<void>;
+    /**
+     * Resume an existing session without replaying history.
+     *
+     * Only works if the agent advertises `sessionCapabilities.resume`.
+     *
+     * @param sessionId - The session to resume
+     * @param mcpServers - Optional MCP servers (defaults to options.mcpServers)
+     * @param cwd - Optional working directory (defaults to options.cwd or projectRoot)
+     */
+    resumeSession(sessionId: SessionId, mcpServers?: McpServer[], cwd?: string): Promise<void>;
+    /**
+     * List existing sessions known to the agent.
+     *
+     * Only works if the agent advertises `sessionCapabilities.list`.
+     */
+    listSessions(cursor?: string, cwd?: string): Promise<{
+        sessions: SessionInfo[];
+        nextCursor?: string | undefined;
+    }>;
+    /**
+     * Delete a session from the agent's session list.
+     *
+     * Only works if the agent advertises `sessionCapabilities.delete`.
+     */
+    deleteSession(sessionId: SessionId): Promise<void>;
+    /**
+     * Fork a session — create a new session from an existing one.
+     */
+    forkSession(sourceSessionId: SessionId, cwd?: string, mcpServers?: McpServer[]): Promise<SessionId>;
+    /**
+     * Set the active mode for a session.
+     */
+    setMode(sessionId: SessionId, modeId: string): Promise<void>;
+    /**
+     * Set a configuration option for a session.
+     */
+    setConfigOption(sessionId: SessionId, configId: string, value: string): Promise<void>;
+    /**
+     * List available providers and the current provider.
+     */
+    listProviders(): Promise<{
+        providers: unknown[];
+        currentProviderId: string | null;
+    }>;
+    /**
+     * Send an MCP message to the agent for routing.
+     */
+    mcpMessage(connectionId: string, message: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Set the active provider for the agent.
+     */
+    setProvider(providerId: string, config?: Record<string, unknown>): Promise<void>;
+    /**
+     * Disable the current provider.
+     */
+    disableProvider(): Promise<void>;
+    /**
+     * Run one prompt turn. Creates a session if needed, sends the
+     * prompt, streams session/update notifications, and resolves with
+     * the agent's response.
+     *
+     * @param blocks - Content blocks to send. Use `textContent()` for plain
+     *   text, or include ImageContent/AudioContent if the agent's
+     *   `promptCapabilities` allow it.
+     * @param signal - AbortSignal for cancellation.
+     *
+     * Cancellation: if `signal` aborts mid-prompt, we send
+     * `session/cancel` (a notification per spec) and keep accepting
+     * updates until the agent returns with `stopReason: 'cancelled'`.
+     * The result is the same shape as a normal turn, with
+     * `stopReason === 'cancelled'`.
+     */
+    prompt(blocks: ContentBlock[], signal: AbortSignal, onProgress?: ACPProgressHandler): Promise<ACPSessionRunResult>;
+    private createSession;
+    /**
+     * Close the current session gracefully (if the agent supports it).
+     *
+     * Sends `session/close` JSON-RPC request, then clears the local
+     * session id. Best-effort — errors are swallowed so the caller can
+     * always proceed to transport teardown.
+     */
+    private closeSession;
+    /** Tear down the session and kill the child process. */
+    close(): Promise<void>;
+    /**
+     * Filter MCP servers according to agent capabilities.
+     * - Stdio servers are always included.
+     * - HTTP servers are only included if agent supports mcpCapabilities.http.
+     * - SSE servers are only included if agent supports mcpCapabilities.sse.
+     */
+    private filterMcpServers;
+    private allocId;
+    private sendRequest;
+    /**
+     * Send a JSON-RPC 2.0 success response to an agent-initiated request.
+     *
+     * Per JSON-RPC 2.0 (and the official ACP SDK's message router) a Response
+     * object MUST carry `jsonrpc: "2.0"` and MUST NOT carry a `method` field —
+     * the SDK classifies any object with a `method` key as a Request and drops
+     * it as a response, so an agent's `fs/*`, `terminal/*`, or
+     * `session/request_permission` callback would hang forever. The legacy
+     * `ACPMessage` type predates v1 (requires `method`, lacks `jsonrpc`), so we
+     * build the correct wire object and cast at the boundary.
+     */
+    private sendResult;
+    /** Send a JSON-RPC 2.0 error response (no `method` field, per spec). */
+    private sendErrorResponse;
+    private handleMessage;
+    private handleUpdate;
+    /**
+     * Fold a `tool_call` / `tool_call_update` notification into the scratch
+     * tool-call map (deduped by toolCallId), extract any `diff` content into
+     * the diffs list, and emit live progress.
+     */
+    private captureToolCall;
+    private emitProgress;
+    /** Live progress handler installed for the duration of a `prompt()` turn. */
+    private progressHandler;
+    private scratch;
+    private resetScratch;
+    private handlePermissionRequest;
+    private handleFsRequest;
+    private handleTerminalRequest;
+}
+/**
+ * Create a text ContentBlock. Convenience helper for callers of
+ * `session.prompt()`.
+ */
+export declare function textContent(text: string): ContentBlock;
+/**
+ * Create an image ContentBlock. Only send this if the agent's
+ * `promptCapabilities.image` is `true` (check via
+ * `session.getCapabilities().promptCapabilities?.image`).
+ */
+export declare function imageContent(mimeType: string, data: string): ContentBlock;
+/**
+ * Create an audio ContentBlock. Only send this if the agent's
+ * `promptCapabilities.audio` is `true` (check via
+ * `session.getCapabilities().promptCapabilities?.audio`).
+ */
+export declare function audioContent(mimeType: string, data: string): ContentBlock;
+//# sourceMappingURL=acp-session.d.ts.map

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

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

package/dist/client/file-server.d.ts

@@ -0,0 +1,44 @@
+export interface FileServerOptions {
+    /** Absolute path; only files under this root are accessible. */
+    projectRoot: string;
+    /** Per-call timeout, default 30s. */
+    timeoutMs?: number;
+}
+export interface ReadFileParams {
+    sessionId: string;
+    path: string;
+}
+export interface WriteFileParams {
+    sessionId: string;
+    path: string;
+    content: string;
+}
+export type FsErrorCode = 'ENOENT' | 'EACCES' | 'OUTSIDE_ROOT' | 'TIMEOUT' | 'INVALID_PATH';
+/**
+ * Thrown for protocol-level rejections (path outside root, etc.).
+ * The session converts these into JSON-RPC error responses.
+ */
+export declare class FsError extends Error {
+    readonly code: FsErrorCode;
+    readonly path: string;
+    constructor(code: FsErrorCode, path: string, message: string);
+}
+export declare class FileServer {
+    private readonly root;
+    private readonly timeoutMs;
+    constructor(opts: FileServerOptions);
+    /** Read a text file. Returns the content as a string. */
+    readTextFile(params: ReadFileParams): Promise<{
+        content: string;
+    }>;
+    /** Write a text file. Atomic via write-then-rename. */
+    writeTextFile(params: WriteFileParams): Promise<void>;
+    /**
+     * Resolve a path; throw `FsError('OUTSIDE_ROOT')` if the result is
+     * not under the project root. Symlinks are not followed here — we
+     * operate on the textual path. A future hardening pass can
+     * `fs.realpath` each access to catch symlink escapes.
+     */
+    private resolveInside;
+}
+//# sourceMappingURL=file-server.d.ts.map

package/dist/client/file-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-server.d.ts","sourceRoot":"","sources":["../../src/client/file-server.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,cAAc,CAAC;AAE5F;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAK3D;CACF;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,IAAI,EAAE,iBAAiB,EAGlC;IAED,yDAAyD;IACnD,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAkBvE;IAED,uDAAuD;IACjD,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1D;IAED;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAetB"}

package/dist/client/index.d.ts

@@ -0,0 +1,12 @@
+export { ClientTransport } from '../agent/stdio-transport.js';
+export type { ClientTransportOptions, ACPChildProcess, ACPClientTransport } from '../agent/stdio-transport.js';
+export { WebSocketClientTransport } from './websocket-transport.js';
+export type { WebSocketClientTransportOptions } from './websocket-transport.js';
+export { ToolTranslator } from './tool-translator.js';
+export { ACPSession, ACPSessionError, textContent, imageContent, audioContent, } from './acp-session.js';
+export type { ACPSessionOptions, ACPSessionRunResult, ACPSessionErrorKind, ACPProgressEvent, ACPProgressHandler, ACPCapturedToolCall, ACPCapturedDiff, } from './acp-session.js';
+export { defaultPermissionPolicy, readOnlyPermissionPolicy, makePermissionPolicy, } from './permission.js';
+export type { PermissionPolicy, PermissionRequest } from './permission.js';
+export { makeACPSubagentRunner } from '../integration/acp-subagent-runner.js';
+export type { ACPSubagentRunnerOptions } from '../integration/acp-subagent-runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC/G,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,YAAY,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/client/permission.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Permission policy for ACP v1 client sessions.
+ *
+ * ACP agents can call `session/request_permission` to ask the user
+ * before executing a tool call. The client is expected to surface
+ * the question, get a decision, and respond. This module is the seam
+ * where WrongStack-specific permission UI can plug in; for v1 we ship
+ * a minimal default that auto-approves the first `allow_once` option
+ * (or `allow_always` if present) and rejects on abort.
+ */
+import type { PermissionOption, RequestPermissionOutcome, ToolCallUpdateNotification } from '../types/acp-v1.js';
+/** A single permission decision request. */
+export interface PermissionRequest {
+    toolCall: ToolCallUpdateNotification;
+    options: readonly PermissionOption[];
+    signal: AbortSignal;
+}
+/** A permission policy decides how to respond to a request. */
+export type PermissionPolicy = (req: PermissionRequest) => Promise<RequestPermissionOutcome>;
+/**
+ * Default policy: auto-approve the least-standing allow option.
+ *
+ * ⚠️ This auto-approves EVERY tool call, including file writes and shell
+ * commands. It exists so non-interactive contexts (CLI `acp spawn`,
+ * the Director fan-out) work without a human in the loop. Interactive
+ * surfaces (TUI/WebUI) MUST inject a policy that surfaces the request to
+ * the user — pass `permissionPolicy` to `ACPSession` / the subagent runner.
+ * For untrusted agents prefer {@link readOnlyPermissionPolicy}.
+ */
+export declare const defaultPermissionPolicy: PermissionPolicy;
+/**
+ * Safe-by-default policy: auto-approve only side-effect-free tool calls
+ * (read/search/fetch/think); reject anything that would write files or
+ * run commands. Use this when driving an untrusted external agent and no
+ * interactive surface is available to ask the user.
+ */
+export declare const readOnlyPermissionPolicy: PermissionPolicy;
+/**
+ * Build a policy from a yes/no decision function. The decider receives the
+ * tool call (title + kind + rawInput) and returns whether to allow it.
+ * This is the seam an interactive host (TUI/WebUI confirm prompt, trust
+ * store, exec-allowlist) plugs into.
+ */
+export declare function makePermissionPolicy(decide: (req: PermissionRequest) => boolean | Promise<boolean>): PermissionPolicy;
+//# sourceMappingURL=permission.d.ts.map

package/dist/client/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../src/client/permission.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAC;AAE5B,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,iBAAiB,KACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAgDvC;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAGrC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,gBAOtC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC7D,gBAAgB,CAMlB"}

package/dist/client/terminal-server.d.ts

@@ -0,0 +1,54 @@
+export interface TerminalServerOptions {
+    projectRoot: string;
+    /** Hard cap on per-command wall-clock. Default 5 minutes. */
+    commandTimeoutMs?: number;
+    /** Bytes of output to retain per terminal. Default 1 MiB. */
+    outputByteLimit?: number;
+    /** Optional abort signal that kills ALL active terminals. */
+    signal?: AbortSignal;
+}
+export declare class TerminalServer {
+    private readonly terminals;
+    private readonly projectRoot;
+    private readonly commandTimeoutMs;
+    private readonly outputByteLimit;
+    private nextId;
+    constructor(opts: TerminalServerOptions);
+    /** Spawn a new terminal. Returns the agent-facing id. */
+    create(params: {
+        sessionId: string;
+        command: string;
+        args?: string[];
+        env?: {
+            name: string;
+            value: string;
+        }[];
+        cwd?: string;
+        outputByteLimit?: number;
+    }): {
+        terminalId: string;
+    };
+    /** Return captured output and (if available) the exit status. */
+    output(terminalId: string): {
+        output: string;
+        truncated: boolean;
+        exitStatus?: {
+            exitCode: number | null;
+            signal: string | null;
+        };
+    };
+    /** Block until the process exits. Resolves with the exit status. */
+    waitForExit(terminalId: string): Promise<{
+        exitCode: number | null;
+        signal: string | null;
+    }>;
+    /** Kill the process but keep the terminal record (agent can still read output). */
+    kill(terminalId: string): void;
+    /** Kill the process if alive and remove the record. */
+    release(terminalId: string): void;
+    /** Kill all active terminals. Used on session close. */
+    releaseAll(): void;
+    private resolveCwd;
+    private buildEnv;
+}
+//# sourceMappingURL=terminal-server.d.ts.map

package/dist/client/terminal-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-server.d.ts","sourceRoot":"","sources":["../../src/client/terminal-server.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAoBD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,MAAM,CAAK;IAEnB,YAAY,IAAI,EAAE,qBAAqB,EAOtC;IAED,yDAAyD;IACzD,MAAM,CAAC,MAAM,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACxC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAgGzB;IAED,iEAAiE;IACjE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,CAQlI;IAED,oEAAoE;IAC9D,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAIjG;IAED,mFAAmF;IACnF,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAQ7B;IAED,uDAAuD;IACvD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAahC;IAED,wDAAwD;IACxD,UAAU,IAAI,IAAI,CAIjB;IAED,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,QAAQ;CAuBjB"}

package/dist/{index-DEEYyEpu.d.ts → client/tool-translator.d.ts}

@@ -1,6 +1,3 @@
-import { b as ACPMessage, H as ACPToolCallResponse } from './acp-v1-BxskPsdo.js';
-import './acp-subagent-runner-BAlo23L-.js';
-
 /**
  * ToolTranslator — bidirectional translation between WrongStack tools and
  * ACP tool representations.
@@ -17,8 +14,9 @@ import './acp-subagent-runner-BAlo23L-.js';
  * a tool is running, then send a final result. The translator handles this
  * by polling for the final [result] notification on the transport.
  */
-
-interface ToolTranslatorOptions {
+import type { ACPMessage, ACPToolDefinition, ACPToolCallResponse, ContentBlock } from '../types/acp-messages.js';
+import type { TaskSpec, TaskResult } from '@wrongstack/core';
+export interface ToolTranslatorOptions {
     /**
      * If true (default), wrap tool calls in an async poll loop that waits
      * for progress notifications until a final result arrives.
@@ -27,8 +25,20 @@ interface ToolTranslatorOptions {
     pollIntervalMs?: number | undefined;
     totalTimeoutMs?: number | undefined;
 }
+/** Convert an ACP ACPToolDefinition → a JSON schema object recognisable by WrongStack */
+export declare function acpToolToSchema(def: ACPToolDefinition): Record<string, unknown>;
+/** Extract tool result text from ACP ContentBlock[] */
+export declare function extractTextFromContent(blocks: ContentBlock[]): string;
+/** Build a TaskSpec from an ACP task payload */
+export declare function buildTaskSpec(payload: {
+    taskId: string;
+    task: string;
+    subagentId?: string | undefined;
+}): TaskSpec;
+/** Parse an ACP tools/call response → TaskResult */
+export declare function parseToolResponse(taskId: string, subagentId: string, response: ACPToolCallResponse): TaskResult;
 /** ToolTranslator for DIR-1 — wraps ACP client transport, adds task semantics */
-declare class ToolTranslator {
+export declare class ToolTranslator {
     private readonly opts;
     private readonly pending;
     constructor(opts?: ToolTranslatorOptions);
@@ -50,5 +60,4 @@ declare class ToolTranslator {
     }, name: string, args: Record<string, unknown>, callId?: string | number): Promise<ACPToolCallResponse>;
     cancelAll(): void;
 }
-
-export { ToolTranslator as T, type ToolTranslatorOptions as a };
+//# sourceMappingURL=tool-translator.d.ts.map

package/dist/client/tool-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-translator.d.ts","sourceRoot":"","sources":["../../src/client/tool-translator.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAC,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAC/G,OAAO,KAAK,EAAC,QAAQ,EAAE,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAC3D,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAQD,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG/E;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAWrE;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,GAAG,QAAQ,CAMX;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,mBAAmB,GAC5B,UAAU,CAkBZ;AAED,iFAAiF;AACjF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAInB;IAEL,YAAY,IAAI,GAAE,qBAA0B,EAE3C;IAED;;;OAGG;IACH,iBAAiB,CACf,SAAS,EAAE;QAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC,GAC7G,IAAI,CAqBN;IAED;;;;OAIG;IACG,QAAQ,CACZ,SAAS,EAAE;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC,EACrD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,GAAE,MAAM,GAAG,MAA4B,GAC5C,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;IAED,SAAS,IAAI,IAAI,CAKhB;CACF"}

package/dist/client/websocket-transport.d.ts

@@ -0,0 +1,40 @@
+/**
+ * WebSocketClientTransport — remote ACP transport for `ACPSession`.
+ *
+ * Connects to a remote ACP agent over a WebSocket (cloud-hosted agents,
+ * separate-process agents reachable over the network). Each WebSocket
+ * message carries exactly one JSON-RPC 2.0 object — message boundaries
+ * are preserved by the WS framing, so (unlike stdio) no newline delimiter
+ * is needed.
+ *
+ * Uses the Node ≥ 22 built-in global `WebSocket` (undici), so there is no
+ * runtime dependency. Per-connection auth headers are not supported by the
+ * WHATWG WebSocket client; authenticate over the protocol instead
+ * (`ACPSession.authenticate`) or embed a token in the URL query string.
+ *
+ * Spec: https://agentclientprotocol.com/protocol/v1/overview (remote transport)
+ */
+import type { ACPClientTransport } from '../agent/stdio-transport.js';
+import type { ACPMessage } from '../types/acp-messages.js';
+export interface WebSocketClientTransportOptions {
+    /** ws:// or wss:// URL of the remote ACP agent. */
+    url: string;
+    /** Optional WebSocket subprotocols. */
+    protocols?: string | string[] | undefined;
+    /** How long to wait for the socket to open. Default 30s. */
+    handshakeTimeoutMs?: number | undefined;
+}
+export declare class WebSocketClientTransport implements ACPClientTransport {
+    private ws;
+    private readonly handlers;
+    private closed;
+    private readonly opts;
+    constructor(opts: WebSocketClientTransportOptions);
+    start(): Promise<void>;
+    send(msg: ACPMessage): Promise<void>;
+    onMessage(handler: (msg: ACPMessage) => void): () => void;
+    stop(): void;
+    private onData;
+    private dispatch;
+}
+//# sourceMappingURL=websocket-transport.d.ts.map

package/dist/client/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../../src/client/websocket-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,+BAA+B;IAC9C,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAcD,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAEvD,YAAY,IAAI,EAAE,+BAA+B,EAEhD;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAoDrB;IAED,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAUnC;IAED,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAGxD;IAED,IAAI,IAAI,IAAI,CAUX;IAED,OAAO,CAAC,MAAM;IA6Bd,OAAO,CAAC,QAAQ;CASjB"}

package/dist/client.d.ts

@@ -1,5 +1 @@
-export { p as ACPChildProcess, A as ACPClientTransport, J as ClientTransport, K as ClientTransportOptions } from './acp-v1-BxskPsdo.js';
-export { A as ACPCapturedDiff, a as ACPCapturedToolCall, b as ACPProgressEvent, c as ACPProgressHandler, d as ACPSession, e as ACPSessionError, f as ACPSessionErrorKind, g as ACPSessionOptions, h as ACPSessionRunResult, i as ACPSubagentRunnerOptions, P as PermissionPolicy, m as PermissionRequest, W as WebSocketClientTransport, o as WebSocketClientTransportOptions, p as audioContent, q as defaultPermissionPolicy, r as imageContent, s as makeACPSubagentRunner, u as makePermissionPolicy, w as readOnlyPermissionPolicy, z as textContent } from './acp-subagent-runner-BAlo23L-.js';
-export { T as ToolTranslator } from './index-DEEYyEpu.js';
-import 'node:events';
-import '@wrongstack/core';
+export * from './client/index.js';