@wrongstack/acp 0.306.4 → 0.307.1

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

@@ -0,0 +1,33 @@
+import type { AgentCapabilities, McpServer, SessionId, SessionInfo } from '../types/acp-v1.js';
+import type { ACPSessionOptions } from './acp-session-types.js';
+export declare function filterMcpServers(agentCapabilities: AgentCapabilities, servers?: McpServer[]): McpServer[];
+export interface ACPSessionOpContext {
+    closed: boolean;
+    sessionId: SessionId | null;
+    agentCapabilities: AgentCapabilities;
+    opts: ACPSessionOptions;
+    allocId: () => number;
+    sendRequest: (id: number, method: string, params: unknown, timeoutMs?: number) => Promise<unknown>;
+    setSessionId: (id: SessionId | null) => void;
+    resetScratch: () => void;
+    closeSession: () => Promise<void>;
+}
+export declare function executeLoadSession(ctx: ACPSessionOpContext, sessionId: SessionId, mcpServers?: McpServer[], cwd?: string): Promise<void>;
+export declare function executeResumeSession(ctx: ACPSessionOpContext, sessionId: SessionId, mcpServers?: McpServer[], cwd?: string): Promise<void>;
+export declare function executeListSessions(ctx: ACPSessionOpContext, cursor?: string, cwd?: string): Promise<{
+    sessions: SessionInfo[];
+    nextCursor?: string | undefined;
+}>;
+export declare function executeDeleteSession(ctx: ACPSessionOpContext, sessionId: SessionId): Promise<void>;
+export declare function executeForkSession(ctx: ACPSessionOpContext, sourceSessionId: SessionId, cwd?: string, mcpServers?: McpServer[]): Promise<SessionId>;
+export declare function executeSetMode(ctx: ACPSessionOpContext, sessionId: SessionId, modeId: string): Promise<void>;
+export declare function executeSetConfigOption(ctx: ACPSessionOpContext, sessionId: SessionId, configId: string, value: string): Promise<void>;
+export declare function executeListProviders(ctx: ACPSessionOpContext): Promise<{
+    providers: unknown[];
+    currentProviderId: string | null;
+}>;
+export declare function executeSetProvider(ctx: ACPSessionOpContext, providerId: string, config?: Record<string, unknown>): Promise<void>;
+export declare function executeDisableProvider(ctx: ACPSessionOpContext): Promise<void>;
+export declare function executeMcpMessage(ctx: ACPSessionOpContext, connectionId: string, message: Record<string, unknown>): Promise<unknown>;
+export declare function executeCreateSession(ctx: ACPSessionOpContext): Promise<SessionId>;
+//# sourceMappingURL=acp-session-ops.d.ts.map

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

@@ -77,9 +77,6 @@ export declare class ACPSession {
     /**
      * 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>;
     /**
@@ -87,129 +84,35 @@ export declare class ACPSession {
      * 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)
-     */
+    private opContext;
     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 responseSender;
     private callbackOptions;
     private handleMessage;
     private emitProgress;
-    /** Live progress handler installed for the duration of a `prompt()` turn. */
     private progressHandler;
     private scratch;
     private resetScratch;