acp-factory 0.0.1

package/dist/session.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Session - High-level interface for interacting with an agent session
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { PromptContent, ExtendedSessionUpdate } from "./types.js";
+import type { ACPClientHandler } from "./client-handler.js";
+/**
+ * Represents an active session with an agent
+ */
+export declare class Session {
+    readonly id: string;
+    readonly modes: string[];
+    readonly models: string[];
+    private readonly connection;
+    private readonly clientHandler;
+    constructor(id: string, connection: acp.ClientSideConnection, clientHandler: ACPClientHandler, modes?: string[], models?: string[]);
+    /**
+     * Send a prompt and stream responses
+     *
+     * In interactive permission mode, this may yield PermissionRequestUpdate objects
+     * that require a response via respondToPermission() before the prompt can continue.
+     */
+    prompt(content: PromptContent): AsyncIterable<ExtendedSessionUpdate>;
+    /**
+     * Cancel the current prompt
+     */
+    cancel(): Promise<void>;
+    /**
+     * Interrupt the current prompt and start a new one with additional context.
+     *
+     * This cancels any in-progress prompt and immediately starts a new prompt.
+     * The agent will restart its work but retains the conversation history.
+     *
+     * Use this when you need to redirect or add context to the agent's work.
+     *
+     * @param content - The new prompt content (can reference or build upon previous context)
+     * @returns AsyncIterable of session updates for the new prompt
+     *
+     * @example
+     * ```typescript
+     * // Original prompt running
+     * for await (const update of session.prompt("Analyze the codebase")) {
+     *   handleUpdate(update);
+     *   if (userWantsToRedirect) {
+     *     // Interrupt and redirect
+     *     for await (const update of session.interruptWith("Focus only on the /src directory")) {
+     *       handleUpdate(update);
+     *     }
+     *     break;
+     *   }
+     * }
+     * ```
+     */
+    interruptWith(content: PromptContent): AsyncIterable<ExtendedSessionUpdate>;
+    /**
+     * Add context to the agent while it's working (without interrupting).
+     *
+     * NOTE: This feature requires agent support for mid-execution messaging.
+     * Currently, claude-code-acp does not support this. When called, this method
+     * will throw an error. Use `interruptWith()` as an alternative.
+     *
+     * In the future, when agent adapters support the `_session/addContext` extension,
+     * this method will push context to the agent without cancelling current work.
+     *
+     * @param content - Additional context to send to the agent
+     * @throws Error - Always throws until agent support is available
+     *
+     * @example
+     * ```typescript
+     * // Future usage (not yet supported):
+     * for await (const update of session.prompt("Analyze the codebase")) {
+     *   handleUpdate(update);
+     *   if (userHasAdditionalContext) {
+     *     // Add context without interrupting (future)
+     *     await session.addContext("Also check the test coverage");
+     *   }
+     * }
+     * ```
+     */
+    addContext(_content: PromptContent): Promise<void>;
+    /**
+     * Set the session mode
+     */
+    setMode(mode: string): Promise<void>;
+    /**
+     * Fork this session to create a new independent session
+     *
+     * The forked session inherits the conversation history, allowing
+     * operations like generating summaries without affecting this session.
+     *
+     * Note: This creates a new Session object - the original session
+     * remains active and can continue independently.
+     *
+     * @experimental This relies on the unstable session/fork ACP capability
+     */
+    fork(): Promise<Session>;
+    /**
+     * Respond to a permission request (for interactive permission mode)
+     *
+     * When using permissionMode: "interactive", permission requests are emitted
+     * as session updates with sessionUpdate: "permission_request". Call this method
+     * with the requestId and your chosen optionId to allow the prompt to continue.
+     *
+     * @param requestId - The requestId from the PermissionRequestUpdate
+     * @param optionId - The optionId of the selected permission option
+     */
+    respondToPermission(requestId: string, optionId: string): void;
+    /**
+     * Cancel a permission request (for interactive permission mode)
+     *
+     * This will cancel the permission request, which typically aborts the tool call.
+     *
+     * @param requestId - The requestId from the PermissionRequestUpdate
+     */
+    cancelPermission(requestId: string): void;
+    /**
+     * Check if there are any pending permission requests for this session
+     */
+    hasPendingPermissions(): boolean;
+    /**
+     * Get all pending permission request IDs for this session
+     */
+    getPendingPermissionIds(): string[];
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;gBAG/C,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,GAAG,CAAC,oBAAoB,EACpC,aAAa,EAAE,gBAAgB,EAC/B,KAAK,GAAE,MAAM,EAAO,EACpB,MAAM,GAAE,MAAM,EAAO;IASvB;;;;;OAKG;IACI,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAAC,qBAAqB,CAAC;IAqD3E;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACI,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAAC,qBAAqB,CAAC;IAWlF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1C;;;;;;;;;;OAUG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB9B;;;;;;;;;OASG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9D;;;;;;OAMG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE;CAGpC"}

package/dist/session.js

@@ -0,0 +1,221 @@
+/**
+ * Session - High-level interface for interacting with an agent session
+ */
+/**
+ * Represents an active session with an agent
+ */
+export class Session {
+    id;
+    modes;
+    models;
+    connection;
+    clientHandler;
+    constructor(id, connection, clientHandler, modes = [], models = []) {
+        this.id = id;
+        this.connection = connection;
+        this.clientHandler = clientHandler;
+        this.modes = modes;
+        this.models = models;
+    }
+    /**
+     * Send a prompt and stream responses
+     *
+     * In interactive permission mode, this may yield PermissionRequestUpdate objects
+     * that require a response via respondToPermission() before the prompt can continue.
+     */
+    async *prompt(content) {
+        // Convert string to ContentBlock array
+        const promptBlocks = typeof content === "string"
+            ? [{ type: "text", text: content }]
+            : content;
+        // Get the session stream for updates
+        const stream = this.clientHandler.getSessionStream(this.id);
+        // Start the prompt (non-blocking, returns when complete)
+        const promptPromise = this.connection.prompt({
+            sessionId: this.id,
+            prompt: promptBlocks,
+        });
+        // Yield updates as they arrive
+        // We need to race between getting updates and the prompt completing
+        const updateIterator = stream[Symbol.asyncIterator]();
+        try {
+            while (true) {
+                // Check if prompt has completed
+                const raceResult = await Promise.race([
+                    promptPromise.then((result) => ({ type: "done", result })),
+                    updateIterator.next().then((update) => ({ type: "update", update })),
+                ]);
+                if (raceResult.type === "done") {
+                    // Prompt completed, drain remaining updates
+                    this.clientHandler.endSessionStream(this.id);
+                    // Yield any remaining queued updates
+                    let remaining = await updateIterator.next();
+                    while (!remaining.done) {
+                        yield remaining.value;
+                        remaining = await updateIterator.next();
+                    }
+                    break;
+                }
+                else {
+                    // Got an update
+                    if (raceResult.update.done) {
+                        break;
+                    }
+                    yield raceResult.update.value;
+                }
+            }
+        }
+        finally {
+            // Ensure stream is ended
+            this.clientHandler.endSessionStream(this.id);
+        }
+    }
+    /**
+     * Cancel the current prompt
+     */
+    async cancel() {
+        await this.connection.cancel({
+            sessionId: this.id,
+        });
+    }
+    /**
+     * Interrupt the current prompt and start a new one with additional context.
+     *
+     * This cancels any in-progress prompt and immediately starts a new prompt.
+     * The agent will restart its work but retains the conversation history.
+     *
+     * Use this when you need to redirect or add context to the agent's work.
+     *
+     * @param content - The new prompt content (can reference or build upon previous context)
+     * @returns AsyncIterable of session updates for the new prompt
+     *
+     * @example
+     * ```typescript
+     * // Original prompt running
+     * for await (const update of session.prompt("Analyze the codebase")) {
+     *   handleUpdate(update);
+     *   if (userWantsToRedirect) {
+     *     // Interrupt and redirect
+     *     for await (const update of session.interruptWith("Focus only on the /src directory")) {
+     *       handleUpdate(update);
+     *     }
+     *     break;
+     *   }
+     * }
+     * ```
+     */
+    async *interruptWith(content) {
+        // Cancel any in-progress prompt
+        await this.cancel();
+        // Small delay to allow cancellation to propagate
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        // Start new prompt and yield its updates
+        yield* this.prompt(content);
+    }
+    /**
+     * Add context to the agent while it's working (without interrupting).
+     *
+     * NOTE: This feature requires agent support for mid-execution messaging.
+     * Currently, claude-code-acp does not support this. When called, this method
+     * will throw an error. Use `interruptWith()` as an alternative.
+     *
+     * In the future, when agent adapters support the `_session/addContext` extension,
+     * this method will push context to the agent without cancelling current work.
+     *
+     * @param content - Additional context to send to the agent
+     * @throws Error - Always throws until agent support is available
+     *
+     * @example
+     * ```typescript
+     * // Future usage (not yet supported):
+     * for await (const update of session.prompt("Analyze the codebase")) {
+     *   handleUpdate(update);
+     *   if (userHasAdditionalContext) {
+     *     // Add context without interrupting (future)
+     *     await session.addContext("Also check the test coverage");
+     *   }
+     * }
+     * ```
+     */
+    async addContext(_content) {
+        // TODO: When claude-code-acp supports _session/addContext extension,
+        // implement this using:
+        // await this.connection.extMethod("session/addContext", {
+        //   sessionId: this.id,
+        //   content: typeof _content === "string"
+        //     ? [{ type: "text", text: _content }]
+        //     : _content,
+        // });
+        throw new Error("addContext() is not yet supported. The agent adapter must implement the " +
+            "'_session/addContext' extension method. Use interruptWith() as an alternative, " +
+            "which cancels the current prompt and starts a new one.");
+    }
+    /**
+     * Set the session mode
+     */
+    async setMode(mode) {
+        if (!this.connection.setSessionMode) {
+            throw new Error("Agent does not support setting session mode");
+        }
+        await this.connection.setSessionMode({
+            sessionId: this.id,
+            modeId: mode,
+        });
+    }
+    /**
+     * Fork this session to create a new independent session
+     *
+     * The forked session inherits the conversation history, allowing
+     * operations like generating summaries without affecting this session.
+     *
+     * Note: This creates a new Session object - the original session
+     * remains active and can continue independently.
+     *
+     * @experimental This relies on the unstable session/fork ACP capability
+     */
+    async fork() {
+        if (!this.connection.forkSession) {
+            throw new Error("Agent does not support forking sessions");
+        }
+        const result = await this.connection.forkSession({
+            sessionId: this.id,
+        });
+        return new Session(result.sessionId, this.connection, this.clientHandler, result.modes?.availableModes?.map((m) => m.id) ?? [], result.models?.availableModels?.map((m) => m.modelId) ?? []);
+    }
+    /**
+     * Respond to a permission request (for interactive permission mode)
+     *
+     * When using permissionMode: "interactive", permission requests are emitted
+     * as session updates with sessionUpdate: "permission_request". Call this method
+     * with the requestId and your chosen optionId to allow the prompt to continue.
+     *
+     * @param requestId - The requestId from the PermissionRequestUpdate
+     * @param optionId - The optionId of the selected permission option
+     */
+    respondToPermission(requestId, optionId) {
+        this.clientHandler.respondToPermission(requestId, optionId);
+    }
+    /**
+     * Cancel a permission request (for interactive permission mode)
+     *
+     * This will cancel the permission request, which typically aborts the tool call.
+     *
+     * @param requestId - The requestId from the PermissionRequestUpdate
+     */
+    cancelPermission(requestId) {
+        this.clientHandler.cancelPermission(requestId);
+    }
+    /**
+     * Check if there are any pending permission requests for this session
+     */
+    hasPendingPermissions() {
+        return this.clientHandler.getPendingPermissionIds(this.id).length > 0;
+    }
+    /**
+     * Get all pending permission request IDs for this session
+     */
+    getPendingPermissionIds() {
+        return this.clientHandler.getPendingPermissionIds(this.id);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Type definitions for acp-factory
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+export type { 
+/** Updates streamed during prompt processing */
+SessionUpdate, 
+/** Content blocks in prompts and responses */
+ContentBlock, 
+/** Text content block */
+TextContent, 
+/** Image content block */
+ImageContent, 
+/** Resource link content block */
+ResourceLink, 
+/** Agent capabilities advertised during initialization */
+AgentCapabilities, 
+/** Reason why prompt processing stopped */
+StopReason, } from "@agentclientprotocol/sdk";
+export type { 
+/** A tool call initiated by the agent */
+ToolCall, 
+/** Update to a tool call's status or content */
+ToolCallUpdate, 
+/** Status of a tool call */
+ToolCallStatus, 
+/** Content returned by a tool */
+ToolCallContent, 
+/** Location affected by a tool call */
+ToolCallLocation, } from "@agentclientprotocol/sdk";
+export type { 
+/** Request for user permission */
+RequestPermissionRequest, 
+/** Response to permission request */
+RequestPermissionResponse, 
+/** A permission option presented to the user */
+PermissionOption, } from "@agentclientprotocol/sdk";
+export type { 
+/** Request to create a terminal */
+CreateTerminalRequest, 
+/** Response with terminal ID */
+CreateTerminalResponse, 
+/** Request for terminal output */
+TerminalOutputRequest, 
+/** Response with terminal output */
+TerminalOutputResponse, } from "@agentclientprotocol/sdk";
+export type { 
+/** MCP server configuration (stdio, HTTP, or SSE) */
+McpServer, 
+/** MCP server over stdio */
+McpServerStdio, 
+/** MCP server over HTTP */
+McpServerHttp, 
+/** MCP server over SSE */
+McpServerSse, } from "@agentclientprotocol/sdk";
+export type { 
+/** Response when creating a new session */
+NewSessionResponse, 
+/** Response after prompt processing completes */
+PromptResponse, 
+/** Request to initialize the connection */
+InitializeRequest, 
+/** Response to initialization */
+InitializeResponse, 
+/** Request to fork an existing session (UNSTABLE) */
+ForkSessionRequest, 
+/** Response from forking a session (UNSTABLE) */
+ForkSessionResponse, } from "@agentclientprotocol/sdk";
+/**
+ * Configuration for spawning an agent
+ */
+export interface AgentConfig {
+    /** Command to execute (e.g., "npx") */
+    command: string;
+    /** Arguments for the command (e.g., ["claude-code-acp"]) */
+    args: string[];
+    /** Environment variables to set */
+    env?: Record<string, string>;
+}
+/**
+ * Permission handling mode
+ * - "auto-approve": Automatically approve all permission requests
+ * - "auto-deny": Automatically deny all permission requests
+ * - "callback": Use the onPermissionRequest callback handler
+ * - "interactive": Emit permission requests as session updates for UI handling
+ */
+export type PermissionMode = "auto-approve" | "auto-deny" | "callback" | "interactive";
+/**
+ * A permission request emitted as a session update (for interactive mode)
+ */
+export interface PermissionRequestUpdate {
+    sessionUpdate: "permission_request";
+    /** Unique ID for this permission request (use to respond) */
+    requestId: string;
+    /** Session this request belongs to */
+    sessionId: string;
+    /** The tool call that triggered this permission request */
+    toolCall: {
+        toolCallId: string;
+        title: string;
+        status: string;
+        rawInput?: unknown;
+    };
+    /** Available options for the user to choose from */
+    options: acp.PermissionOption[];
+}
+/**
+ * Extended session update type that includes permission requests
+ */
+export type ExtendedSessionUpdate = acp.SessionUpdate | PermissionRequestUpdate;
+/**
+ * Handlers for client-side operations
+ */
+export interface ClientHandlers {
+    /** Handle permission requests from the agent */
+    onPermissionRequest?: (request: acp.RequestPermissionRequest) => Promise<acp.RequestPermissionResponse>;
+    /** Handle file read requests */
+    onFileRead?: (path: string) => Promise<string>;
+    /** Handle file write requests */
+    onFileWrite?: (path: string, content: string) => Promise<void>;
+    /** Handle terminal creation requests */
+    onTerminalCreate?: (params: acp.CreateTerminalRequest) => Promise<acp.CreateTerminalResponse>;
+    /** Handle terminal output requests */
+    onTerminalOutput?: (terminalId: string) => Promise<string>;
+    /** Handle terminal kill requests */
+    onTerminalKill?: (terminalId: string) => Promise<void>;
+    /** Handle terminal release requests */
+    onTerminalRelease?: (terminalId: string) => Promise<void>;
+    /** Handle terminal wait for exit requests */
+    onTerminalWaitForExit?: (terminalId: string) => Promise<number>;
+}
+/**
+ * Options for spawning an agent
+ */
+export interface SpawnOptions extends ClientHandlers {
+    /** Environment variables to merge with agent config */
+    env?: Record<string, string>;
+    /** Permission handling mode (default: "auto-approve") */
+    permissionMode?: PermissionMode;
+}
+/**
+ * Options for creating a session
+ */
+export interface SessionOptions {
+    /** MCP servers to connect */
+    mcpServers?: acp.McpServer[];
+    /** Initial mode for the session */
+    mode?: string;
+}
+/**
+ * Content that can be sent as a prompt
+ */
+export type PromptContent = string | acp.ContentBlock[];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for acp-factory
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "acp-factory",
+  "version": "0.0.1",
+  "description": "A library for spawning and managing agents through the Agent Client Protocol (ACP)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "pretest:run": "npm run build",
+    "prepublishOnly": "npm run test:run && npm run build",
+    "version": "npm run build",
+    "postversion": "git push && git push --tags",
+    "release:patch": "npm version patch",
+    "release:minor": "npm version minor",
+    "release:major": "npm version major",
+    "publish:dry": "npm publish --dry-run",
+    "publish:npm": "npm publish --access public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sudocode-ai/acp-factory.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sudocode-ai/acp-factory/issues"
+  },
+  "homepage": "https://github.com/sudocode-ai/acp-factory#readme",
+  "keywords": [
+    "acp",
+    "agent",
+    "agent-client-protocol",
+    "claude",
+    "claude-code",
+    "ai",
+    "llm",
+    "typescript",
+    "sdk"
+  ],
+  "author": "Sudocode AI",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.10.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  }
+}