sudocode 1.1.20 → 1.1.22

package/node_modules/@sudocode-ai/local-server/dist/execution/executors/acp-executor-wrapper.d.ts

@@ -1,331 +0,0 @@
-/**
- * AcpExecutorWrapper - Unified executor using Agent Client Protocol (ACP)
- *
- * Uses acp-factory for agent lifecycle management and streams SessionUpdate
- * events directly to the frontend. Supports all ACP-native agents (claude-code,
- * codex, gemini, opencode) with a unified interface.
- *
- * @module execution/executors/acp-executor-wrapper
- */
-import { type Session, type ExtendedSessionUpdate, type McpServer, type PermissionMode } from "acp-factory";
-import type { SessionMode, SessionEndModeConfig } from "@sudocode-ai/types";
-import type Database from "better-sqlite3";
-import type { ExecutionLifecycleService } from "../../services/execution-lifecycle.js";
-import type { ExecutionLogsStore } from "../../services/execution-logs-store.js";
-/**
- * Sudocode's MCP server configuration format
- * Used by ExecutionService.buildExecutionConfig()
- */
-export interface SudocodeMcpServerConfig {
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-}
-/**
- * MCP servers config as produced by ExecutionService
- * Key is the server name, value is the config
- */
-export type SudocodeMcpServersConfig = Record<string, SudocodeMcpServerConfig>;
-/**
- * Convert sudocode's MCP config format to acp-factory's McpServer[] format
- *
- * sudocode format: { "server-name": { command, args?, env?: Record } }
- * acp-factory format: [{ name, command, args: [], env: [{name, value}] }]
- */
-export declare function convertMcpServers(config: SudocodeMcpServersConfig | McpServer[] | undefined): McpServer[];
-/**
- * Configuration for ACP-based execution
- */
-export interface AcpExecutionConfig {
-    /** Agent type (must be ACP-registered) */
-    agentType: string;
-    /**
-     * MCP servers to connect to the agent session
-     * Accepts both sudocode format (Record<string, config>) and acp-factory format (McpServer[])
-     */
-    mcpServers?: SudocodeMcpServersConfig | McpServer[];
-    /** Permission handling mode at ACP protocol level */
-    permissionMode?: PermissionMode;
-    /**
-     * Agent-specific permission mode to set on the session.
-     * Used by agents that support setMode() for internal permission handling.
-     * Common values: "default", "plan", "bypassPermissions", "acceptEdits"
-     */
-    agentPermissionMode?: string;
-    /** Environment variables to pass to the agent */
-    env?: Record<string, string>;
-    /** Session mode to set (e.g., "code", "plan") */
-    mode?: string;
-    /** Compaction configuration for automatic context management */
-    compaction?: {
-        enabled: boolean;
-        contextTokenThreshold?: number;
-        customInstructions?: string;
-    };
-}
-/**
- * Task definition for ACP execution
- */
-export interface AcpExecutionTask {
-    /** Unique task identifier */
-    id: string;
-    /** The prompt to send to the agent */
-    prompt: string;
-    /** Optional metadata */
-    metadata?: {
-        /**
-         * MCP servers specific to this task
-         * Accepts both sudocode format (Record<string, config>) and acp-factory format (McpServer[])
-         */
-        mcpServers?: SudocodeMcpServersConfig | McpServer[];
-        /** Additional system prompt to append */
-        appendSystemPrompt?: string;
-        /** Whether to skip permission prompts */
-        dangerouslySkipPermissions?: boolean;
-    };
-}
-/**
- * Options for execution lifecycle
- */
-export interface ExecutionLifecycleOptions {
-    /** Session persistence mode (default: "discrete") */
-    sessionMode?: SessionMode;
-    /** How the persistent session ends (only when sessionMode: "persistent") */
-    sessionEndMode?: SessionEndModeConfig;
-}
-/**
- * Configuration for AcpExecutorWrapper
- */
-export interface AcpExecutorWrapperConfig {
-    /** Agent type (claude-code, codex, gemini, opencode) */
-    agentType: string;
-    /** ACP execution configuration */
-    acpConfig: AcpExecutionConfig;
-    /** Lifecycle service for status updates */
-    lifecycleService: ExecutionLifecycleService;
-    /** Logs store for persisting execution events */
-    logsStore: ExecutionLogsStore;
-    /** Project ID for broadcasts */
-    projectId: string;
-    /** Database connection */
-    db: Database.Database;
-}
-/**
- * AcpExecutorWrapper
- *
- * Unified executor wrapper that uses acp-factory for agent lifecycle management.
- * Streams SessionUpdate events directly to the frontend and coalesces them for storage.
- *
- * @example
- * ```typescript
- * const wrapper = new AcpExecutorWrapper({
- *   agentType: "claude-code",
- *   acpConfig: {
- *     agentType: "claude-code",
- *     mcpServers: [{ name: "context", uri: "..." }],
- *     permissionMode: "auto-approve",
- *   },
- *   lifecycleService,
- *   logsStore,
- *   projectId: "my-project",
- *   db,
- * });
- *
- * await wrapper.executeWithLifecycle(executionId, task, workDir);
- * ```
- */
-export declare class AcpExecutorWrapper {
-    private readonly agentType;
-    private readonly acpConfig;
-    private readonly logsStore;
-    private readonly projectId;
-    private readonly db;
-    /** Active agent handles by execution ID */
-    private activeAgents;
-    /** Active sessions by execution ID */
-    private activeSessions;
-    /** Permission managers by execution ID (for interactive mode) */
-    private permissionManagers;
-    /** File handlers by execution ID */
-    private fileHandlers;
-    /** Persistent session state by execution ID */
-    private persistentSessions;
-    constructor(config: AcpExecutorWrapperConfig);
-    /**
-     * Execute a task with full lifecycle management
-     *
-     * @param executionId - Unique execution identifier
-     * @param task - Task to execute
-     * @param workDir - Working directory for execution
-     * @param options - Execution lifecycle options (sessionMode, sessionEndMode)
-     */
-    executeWithLifecycle(executionId: string, task: AcpExecutionTask, workDir: string, options?: ExecutionLifecycleOptions): Promise<void>;
-    /**
-     * Resume a task from a previous session
-     *
-     * @param executionId - Unique execution identifier
-     * @param sessionId - Session ID to resume from
-     * @param task - Task to resume
-     * @param workDir - Working directory for execution
-     * @param options - Execution lifecycle options (sessionMode, sessionEndMode)
-     */
-    resumeWithLifecycle(executionId: string, sessionId: string, task: AcpExecutionTask, workDir: string, options?: ExecutionLifecycleOptions): Promise<void>;
-    /**
-     * Cancel a running execution
-     *
-     * @param executionId - Execution ID to cancel
-     */
-    cancel(executionId: string): Promise<void>;
-    /**
-     * Respond to a permission request
-     *
-     * @param executionId - Execution ID
-     * @param requestId - Permission request ID
-     * @param optionId - Selected option ID (e.g., 'allow_once', 'reject_always')
-     * @returns true if the permission was found and responded to
-     */
-    respondToPermission(executionId: string, requestId: string, optionId: string): boolean;
-    /**
-     * Check if an execution has pending permissions
-     *
-     * @param executionId - Execution ID
-     * @returns true if there are pending permission requests
-     */
-    hasPendingPermissions(executionId: string): boolean;
-    /**
-     * Get pending permission request IDs for an execution
-     *
-     * @param executionId - Execution ID
-     * @returns Array of pending request IDs
-     */
-    getPendingPermissionIds(executionId: string): string[];
-    /**
-     * Set the session mode for an active execution
-     *
-     * @param executionId - Execution ID
-     * @param mode - The mode to set (e.g., "code", "plan", "architect")
-     * @returns true if mode was set successfully, false otherwise
-     */
-    setMode(executionId: string, mode: string): boolean;
-    /**
-     * Fork an active session into a new session
-     *
-     * Creates a new session that inherits the conversation history from the parent.
-     * The new session can be run independently while preserving context.
-     *
-     * @param executionId - Source execution ID to fork from
-     * @param newExecutionId - ID for the new forked execution
-     * @returns The forked Session, or null if forking failed
-     * @experimental This relies on the unstable session/fork ACP capability
-     */
-    forkSession(executionId: string, newExecutionId: string): Promise<Session | null>;
-    /**
-     * Cancel the current prompt for an active session
-     *
-     * Stops the agent's current work without providing new instructions.
-     * The session remains valid and can receive new prompts via follow-up.
-     *
-     * @param executionId - Execution ID to cancel
-     * @returns true if the cancel was initiated, false if no active session
-     */
-    cancelSession(executionId: string): Promise<boolean>;
-    /**
-     * Interrupt the current prompt and continue with new content
-     *
-     * Cancels the agent's current work and immediately starts processing
-     * the new prompt. Returns an async iterator of session updates.
-     *
-     * @param executionId - Execution ID to interrupt
-     * @param newPrompt - New prompt to continue with
-     * @returns Async iterator of ExtendedSessionUpdate events, or null if no active session
-     * @experimental This relies on the interruptWith ACP capability
-     */
-    interruptWithNewPrompt(executionId: string, newPrompt: string): AsyncGenerator<ExtendedSessionUpdate, void, unknown>;
-    /**
-     * Send an additional prompt to a persistent session
-     *
-     * Only works for executions started with sessionMode: "persistent" that are
-     * currently in the "pending" or "paused" state. Sending a prompt to a paused
-     * session will resume it.
-     *
-     * @param executionId - Execution ID with active persistent session
-     * @param prompt - The prompt to send
-     * @throws Error if no persistent session exists or session is not pending/paused
-     */
-    sendPrompt(executionId: string, prompt: string): Promise<void>;
-    /**
-     * Explicitly end a persistent session
-     *
-     * Closes the agent, cleans up resources, and marks the execution as completed.
-     *
-     * @param executionId - Execution ID with active persistent session
-     * @param reason - Reason for ending the session (default: "explicit")
-     */
-    endSession(executionId: string, reason?: "explicit" | "timeout" | "disconnect"): Promise<void>;
-    /**
-     * Get the current state of a persistent session
-     *
-     * @param executionId - Execution ID to check
-     * @returns Session state info or null if not a persistent session
-     */
-    getSessionState(executionId: string): {
-        mode: "persistent";
-        state: "running" | "pending" | "paused" | "ended";
-        promptCount: number;
-        idleTimeMs?: number;
-    } | null;
-    /**
-     * Check if an execution has an active persistent session
-     *
-     * @param executionId - Execution ID to check
-     * @returns true if execution has a persistent session that's not ended
-     */
-    isPersistentSession(executionId: string): boolean;
-    /**
-     * Check if an agent type is supported via ACP
-     *
-     * @param agentType - Agent type to check
-     * @returns true if the agent is registered in AgentFactory
-     */
-    static isAcpSupported(agentType: string): boolean;
-    /**
-     * List all ACP-supported agent types
-     *
-     * @returns Array of agent type names
-     */
-    static listAcpAgents(): string[];
-    /**
-     * Broadcast SessionUpdate to frontend via WebSocket
-     *
-     * Sends the raw SessionUpdate event to clients subscribed to this execution.
-     * This enables real-time streaming of agent output.
-     */
-    private broadcastSessionUpdate;
-    /**
-     * Transition a persistent session to pending or paused state
-     *
-     * Updates the session state, increments prompt count, starts idle timeout if configured,
-     * and broadcasts the state change to clients. If pauseOnCompletion is enabled, the session
-     * transitions to "paused" instead of "pending".
-     */
-    private transitionToWaiting;
-    /**
-     * Clear the idle timeout for a persistent session
-     */
-    private clearIdleTimeout;
-    /**
-     * Register a disconnect handler for endOnDisconnect mode
-     *
-     * Returns an unregister function to be called during cleanup.
-     */
-    private registerDisconnectHandler;
-    /**
-     * Handle successful execution
-     */
-    private handleSuccess;
-    /**
-     * Handle execution error
-     */
-    private handleError;
-}
-//# sourceMappingURL=acp-executor-wrapper.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/executors/acp-executor-wrapper.d.ts.map

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