sudocode 1.1.16 → 1.1.18-dev.0

package/node_modules/@sudocode-ai/local-server/dist/services/execution-service.d.ts

@@ -0,0 +1,280 @@
+/**
+ * Execution Service
+ *
+ * High-level service for managing issue-to-execution transformations.
+ * Coordinates between template rendering, worktree management, and workflow execution.
+ *
+ * @module services/execution-service
+ */
+import type Database from "better-sqlite3";
+import type { Execution, ExecutionStatus } from "@sudocode-ai/types";
+import { ExecutionLifecycleService } from "./execution-lifecycle.js";
+import type { TransportManager } from "../execution/transport/transport-manager.js";
+import { ExecutionLogsStore } from "./execution-logs-store.js";
+import { ExecutionWorkerPool } from "./execution-worker-pool.js";
+import type { AgentType } from "@sudocode-ai/types/agents";
+/**
+ * MCP server configuration
+ */
+export interface McpServerConfig {
+    type?: string;
+    command: string;
+    tools?: string[];
+    args?: string[];
+    env?: Record<string, string>;
+}
+/**
+ * Configuration for creating an execution
+ */
+export interface ExecutionConfig {
+    mode?: "worktree" | "local";
+    model?: string;
+    timeout?: number;
+    baseBranch?: string;
+    createBaseBranch?: boolean;
+    branchName?: string;
+    reuseWorktreePath?: string;
+    checkpointInterval?: number;
+    continueOnStepFailure?: boolean;
+    captureFileChanges?: boolean;
+    captureToolCalls?: boolean;
+    /** MCP servers to connect to the agent */
+    mcpServers?: Record<string, McpServerConfig>;
+    /** System prompt to append to agent's default prompt */
+    appendSystemPrompt?: string;
+    /** Skip permission prompts (for automated/orchestrator executions) */
+    dangerouslySkipPermissions?: boolean;
+    /** Resume a previous Claude Code session by session ID */
+    resume?: string;
+    /** Parent execution ID to link resumed/follow-up executions */
+    parentExecutionId?: string;
+}
+/**
+ * Workflow context for executions spawned by workflows
+ */
+export interface WorkflowContext {
+    /** The workflow ID that spawned this execution */
+    workflowId: string;
+    /** The workflow step ID this execution implements */
+    stepId: string;
+}
+/**
+ * ExecutionService
+ *
+ * Manages the full lifecycle of issue-based executions:
+ * - Creating and starting executions with worktree isolation
+ * - Creating follow-up executions that reuse worktrees
+ * - Canceling and cleaning up executions
+ */
+export declare class ExecutionService {
+    private db;
+    private projectId;
+    private lifecycleService;
+    private repoPath;
+    private transportManager?;
+    private logsStore;
+    private workerPool?;
+    /**
+     * Create a new ExecutionService
+     *
+     * @param db - Database instance
+     * @param projectId - Project ID for WebSocket broadcasts
+     * @param repoPath - Path to the git repository
+     * @param lifecycleService - Optional execution lifecycle service (creates one if not provided)
+     * @param transportManager - Optional transport manager for SSE streaming
+     * @param logsStore - Optional execution logs store (creates one if not provided)
+     * @param workerPool - Optional worker pool for isolated execution processes
+     */
+    constructor(db: Database.Database, projectId: string, repoPath: string, lifecycleService?: ExecutionLifecycleService, transportManager?: TransportManager, logsStore?: ExecutionLogsStore, workerPool?: ExecutionWorkerPool);
+    /**
+     * Create and start execution
+     *
+     * Creates an execution record, sets up worktree (if needed), and starts
+     * workflow execution. Returns the execution record immediately while
+     * workflow runs in the background.
+     *
+     * @param issueId - ID of issue to execute, or null for orchestrator executions
+     * @param config - Execution configuration
+     * @param prompt - Rendered prompt to execute
+     * @param agentType - Type of agent to use (defaults to 'claude-code')
+     * @param workflowContext - Optional workflow context for workflow-spawned executions
+     * @returns Created execution record
+     */
+    createExecution(issueId: string | null, config: ExecutionConfig, prompt: string, agentType?: AgentType, workflowContext?: WorkflowContext): Promise<Execution>;
+    /**
+     * Create follow-up execution
+     *
+     * For worktree-based executions: reuses the worktree and resumes the session.
+     * For local/non-worktree executions: creates a new execution with feedback context.
+     *
+     * @param executionId - ID of previous execution to follow up on
+     * @param feedback - Additional feedback/context to append to prompt
+     * @param options - Optional configuration
+     * @param options.includeOriginalPrompt - Whether to prepend the original issue content (default: false, assumes session resumption with full history)
+     * @returns Created follow-up execution record
+     */
+    createFollowUp(executionId: string, feedback: string, options?: {
+        includeOriginalPrompt?: boolean;
+    }): Promise<Execution>;
+    /**
+     * Cancel a running execution
+     *
+     * Stops the workflow execution and marks the execution as cancelled.
+     * Optionally cleans up the worktree based on config.
+     *
+     * @param executionId - ID of execution to cancel
+     */
+    cancelExecution(executionId: string): Promise<void>;
+    /**
+     * Clean up execution resources
+     *
+     * Removes the worktree and associated files. This is called automatically
+     * on workflow completion, or can be called manually.
+     *
+     * @param executionId - ID of execution to clean up
+     */
+    cleanupExecution(executionId: string): Promise<void>;
+    /**
+     * Check if worktree exists in filesystem for an execution
+     *
+     * @param executionId - ID of execution to check
+     * @returns true if worktree exists, false otherwise
+     */
+    worktreeExists(executionId: string): Promise<boolean>;
+    /**
+     * Delete worktree for an execution
+     *
+     * Manually deletes the worktree for a specific execution, regardless of
+     * cleanupMode configuration. This allows users to manually cleanup worktrees
+     * when they're configured for manual cleanup.
+     *
+     * @param executionId - ID of execution whose worktree to delete
+     * @param deleteBranch - Whether to also delete the execution's branch (default: false)
+     * @throws Error if execution not found, has no worktree, or worktree doesn't exist
+     */
+    deleteWorktree(executionId: string, deleteBranch?: boolean): Promise<void>;
+    /**
+     * Delete an execution and its entire chain
+     *
+     * Deletes the execution and all its follow-ups (descendants).
+     * Optionally deletes the worktree and/or branch.
+     *
+     * @param executionId - ID of execution to delete (can be root or any execution in chain)
+     * @param deleteBranch - Whether to also delete the execution's branch (default: false)
+     * @param deleteWorktree - Whether to also delete the execution's worktree (default: false)
+     * @throws Error if execution not found
+     */
+    deleteExecution(executionId: string, deleteBranch?: boolean, deleteWorktree?: boolean): Promise<void>;
+    /**
+     * Shutdown execution service - cancel all active executions
+     *
+     * This is called during server shutdown to gracefully terminate
+     * all running executions before the server exits.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * List all executions for an issue
+     *
+     * Returns all executions associated with a specific issue,
+     * ordered by creation time (most recent first).
+     *
+     * @param issueId - ID of issue to list executions for
+     * @returns Array of executions for the issue
+     */
+    listExecutions(issueId: string): Execution[];
+    /**
+     * Get a single execution by ID
+     *
+     * @param executionId - ID of execution to retrieve
+     * @returns Execution or null if not found
+     */
+    getExecution(executionId: string): Execution | null;
+    /**
+     * List all executions with filtering and pagination
+     *
+     * Returns executions across all issues with support for filtering
+     * by status, issueId, and pagination.
+     *
+     * @param options - Filtering and pagination options
+     * @param options.limit - Maximum number of executions to return (default: 50)
+     * @param options.offset - Number of executions to skip (default: 0)
+     * @param options.status - Filter by execution status (single or array)
+     * @param options.issueId - Filter by issue ID
+     * @param options.sortBy - Field to sort by (default: 'created_at')
+     * @param options.order - Sort order (default: 'desc')
+     * @param options.since - Only return executions created after this ISO date
+     * @param options.includeRunning - When used with 'since', also include running executions regardless of age
+     * @returns Object containing executions array, total count, and hasMore flag
+     */
+    listAll(options?: {
+        limit?: number;
+        offset?: number;
+        status?: ExecutionStatus | ExecutionStatus[];
+        issueId?: string;
+        sortBy?: "created_at" | "updated_at";
+        order?: "asc" | "desc";
+        since?: string;
+        includeRunning?: boolean;
+    }): {
+        executions: Execution[];
+        total: number;
+        hasMore: boolean;
+    };
+    /**
+     * Check if there are any active executions
+     *
+     * @returns true if there are active worker pool executions
+     */
+    hasActiveExecutions(): boolean;
+    /**
+     * Collect entity IDs that were already expanded in parent executions
+     *
+     * Walks the execution chain backwards and resolves each prompt to extract
+     * which entities were referenced (and thus expanded) in previous executions.
+     * This prevents redundant expansion of the same entities in follow-ups.
+     *
+     * @param executionId - ID of the current execution
+     * @returns Set of entity IDs that were already expanded
+     */
+    private collectExpandedEntitiesFromChain;
+    /**
+     * Build execution config with auto-injected MCP servers
+     *
+     * This method handles the auto-injection of sudocode-mcp into the execution config
+     * when it's not already configured. It:
+     * 1. Checks if sudocode-mcp package is installed (throws error if not)
+     * 2. Checks if the agent already has sudocode-mcp configured
+     * 3. Auto-injects sudocode-mcp to mcpServers if needed
+     * 4. Preserves all user-provided MCP servers
+     *
+     * @param agentType - The type of agent to execute
+     * @param userConfig - User-provided execution configuration
+     * @returns Merged execution configuration with auto-injected MCP servers
+     * @throws Error if sudocode-mcp package is not installed
+     */
+    private buildExecutionConfig;
+    /**
+     * Detect if sudocode-mcp command is available in PATH
+     *
+     * This checks if the sudocode-mcp package is installed on the system by
+     * attempting to locate the command using `which` (Unix) or `where` (Windows).
+     *
+     * @returns true if sudocode-mcp is available, false otherwise
+     * @internal Used by buildExecutionConfig
+     */
+    private detectSudocodeMcp;
+    /**
+     * Detect if sudocode-mcp is configured for the given agent
+     *
+     * For claude-code: Checks if the sudocode plugin is enabled in ~/.claude/settings.json
+     * For cursor: Checks .cursor/mcp.json in project root for sudocode-mcp command
+     * For codex: Checks ~/.codex/config.toml for sudocode-mcp in mcp_servers
+     * For copilot: Checks ~/.copilot/mcp-config.json for sudocode-mcp command
+     *
+     * @param agentType - The type of agent to check
+     * @returns true if configured, false otherwise
+     * @internal Used by buildExecutionConfig
+     */
+    private detectAgentMcp;
+}
+//# sourceMappingURL=execution-service.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/services/execution-service.d.ts.map

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