@sudocode-ai/local-server 0.1.7 → 0.1.9

package/dist/execution/adapters/shared/config-utils.js

@@ -0,0 +1,163 @@
+/**
+ * Shared Agent Configuration Utilities
+ *
+ * Common utilities for building and validating agent configurations.
+ * Reduces duplication across different agent adapters.
+ *
+ * @module execution/adapters/shared
+ */
+/**
+ * Utility class for common agent configuration operations
+ */
+export class AgentConfigUtils {
+    /**
+     * Validate base configuration fields required by all agents
+     *
+     * @param config - Base agent configuration
+     * @returns Array of validation error messages (empty if valid)
+     */
+    static validateBaseConfig(config) {
+        const errors = [];
+        if (!config.workDir) {
+            errors.push('workDir is required');
+        }
+        if (config.timeout !== undefined && config.timeout < 0) {
+            errors.push('timeout must be a positive number');
+        }
+        return errors;
+    }
+    /**
+     * Merge configuration with defaults
+     *
+     * @param config - User-provided configuration
+     * @param defaults - Default configuration values
+     * @returns Merged configuration with defaults applied
+     */
+    static withDefaults(config, defaults) {
+        return { ...defaults, ...config };
+    }
+    /**
+     * Build ProcessConfig from common fields
+     *
+     * @param executable - Path to executable or command name
+     * @param args - Command-line arguments
+     * @param config - Agent configuration
+     * @returns ProcessConfig for process spawning
+     */
+    static buildBaseProcessConfig(executable, args, config) {
+        return {
+            executablePath: executable,
+            args,
+            workDir: config.workDir,
+            env: config.env,
+            timeout: config.timeout,
+            // TypeScript doesn't know about these optional fields,
+            // but they're in the extended configs
+            idleTimeout: config.idleTimeout,
+            retry: config.retry,
+        };
+    }
+    /**
+     * Validate timeout configuration
+     *
+     * @param timeout - Timeout value in milliseconds
+     * @param idleTimeout - Idle timeout value in milliseconds
+     * @returns Array of validation errors
+     */
+    static validateTimeouts(timeout, idleTimeout) {
+        const errors = [];
+        if (timeout !== undefined && timeout < 0) {
+            errors.push('timeout must be a positive number');
+        }
+        if (idleTimeout !== undefined && idleTimeout < 0) {
+            errors.push('idleTimeout must be a positive number');
+        }
+        if (timeout !== undefined &&
+            idleTimeout !== undefined &&
+            idleTimeout > timeout) {
+            errors.push('idleTimeout cannot be greater than timeout');
+        }
+        return errors;
+    }
+    /**
+     * Validate retry configuration
+     *
+     * @param retry - Retry configuration object
+     * @returns Array of validation errors
+     */
+    static validateRetryConfig(retry) {
+        const errors = [];
+        if (!retry) {
+            return errors;
+        }
+        if (retry.maxAttempts < 0) {
+            errors.push('retry.maxAttempts must be non-negative');
+        }
+        if (retry.backoffMs < 0) {
+            errors.push('retry.backoffMs must be non-negative');
+        }
+        return errors;
+    }
+    /**
+     * Validate array of paths (for addDir, image, etc.)
+     *
+     * @param paths - Array of file/directory paths
+     * @param fieldName - Name of the field for error messages
+     * @returns Array of validation errors
+     */
+    static validatePaths(paths, fieldName) {
+        const errors = [];
+        if (!paths || paths.length === 0) {
+            return errors;
+        }
+        for (const path of paths) {
+            if (!path || path.trim() === '') {
+                errors.push(`${fieldName} contains empty path`);
+            }
+        }
+        return errors;
+    }
+    /**
+     * Validate enum value
+     *
+     * @param value - Value to validate
+     * @param validValues - Array of valid enum values
+     * @param fieldName - Name of the field for error messages
+     * @returns Array of validation errors
+     */
+    static validateEnum(value, validValues, fieldName) {
+        const errors = [];
+        if (value !== undefined && !validValues.includes(value)) {
+            errors.push(`${fieldName} must be one of: ${validValues.join(', ')}`);
+        }
+        return errors;
+    }
+    /**
+     * Build arguments for conditional flags
+     *
+     * @param flags - Array of flag configurations
+     * @returns Array of command-line arguments
+     *
+     * @example
+     * ```typescript
+     * const args = AgentConfigUtils.buildConditionalArgs([
+     *   { flag: '--force', condition: config.force },
+     *   { flag: '--model', value: config.model, condition: !!config.model },
+     *   { flag: '--verbose', condition: true }, // always add
+     * ]);
+     * ```
+     */
+    static buildConditionalArgs(flags) {
+        const args = [];
+        for (const { flag, value, condition } of flags) {
+            if (condition) {
+                args.push(flag);
+                if (value !== undefined) {
+                    args.push(value);
+                }
+            }
+        }
+        return args;
+    }
+}
+//# sourceMappingURL=config-utils.js.map

package/dist/execution/adapters/shared/config-utils.js.map

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

package/dist/execution/adapters/shared/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared adapter utilities
+ *
+ * @module execution/adapters/shared
+ */
+export { AgentConfigUtils } from './config-utils.js';
+export { applyCursorPreset, applyCopilotPreset, applyCodexPreset, applyClaudeCodePreset, getRecommendedTimeouts, getRecommendedRetry, type ConfigProfile, } from './config-presets.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/adapters/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/execution/adapters/shared/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/execution/adapters/shared/index.js

@@ -0,0 +1,8 @@
+/**
+ * Shared adapter utilities
+ *
+ * @module execution/adapters/shared
+ */
+export { AgentConfigUtils } from './config-utils.js';
+export { applyCursorPreset, applyCopilotPreset, applyCodexPreset, applyClaudeCodePreset, getRecommendedTimeouts, getRecommendedRetry, } from './config-presets.js';
+//# sourceMappingURL=index.js.map

package/dist/execution/adapters/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/execution/adapters/shared/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,qBAAqB,CAAC"}

package/dist/execution/executors/agent-executor-wrapper.d.ts

@@ -0,0 +1,153 @@
+/**
+ * AgentExecutorWrapper - Generic wrapper for any agent adapter
+ *
+ * Provides a unified execution interface that works with any IAgentAdapter.
+ * Supports Claude Code, Codex, Cursor, Copilot, and any future agents.
+ *
+ * @module execution/executors/agent-executor-wrapper
+ */
+import type { IAgentAdapter } from "agent-execution-engine/agents";
+import type { AgentType, BaseAgentConfig } from "@sudocode-ai/types/agents";
+import type Database from "better-sqlite3";
+import type { ExecutionTask } from "agent-execution-engine/engine";
+import type { ExecutionLifecycleService } from "../../services/execution-lifecycle.js";
+import type { ExecutionLogsStore } from "../../services/execution-logs-store.js";
+import type { TransportManager } from "../transport/transport-manager.js";
+/**
+ * Configuration for AgentExecutorWrapper
+ */
+export interface AgentExecutorWrapperConfig<TConfig extends BaseAgentConfig> {
+    adapter: IAgentAdapter<TConfig>;
+    agentConfig: TConfig;
+    /** Agent type for executor selection */
+    agentType: AgentType;
+    lifecycleService: ExecutionLifecycleService;
+    logsStore: ExecutionLogsStore;
+    projectId: string;
+    db: Database.Database;
+    transportManager?: TransportManager;
+}
+/**
+ * Generic wrapper for any agent adapter
+ *
+ * Provides basic execution lifecycle management for any agent that implements
+ * IAgentAdapter. This is a simplified version compared to ClaudeExecutorWrapper,
+ * which has specialized logic for Claude Code's protocol peer.
+ *
+ * @example
+ * ```typescript
+ * const wrapper = new AgentExecutorWrapper({
+ *   adapter: codexAdapter,
+ *   agentConfig: {
+ *     workDir: '/path/to/repo',
+ *     apiKey: 'sk-...',
+ *     model: 'code-davinci-002',
+ *   },
+ *   lifecycleService,
+ *   logsStore,
+ *   projectId: 'my-project',
+ *   db,
+ *   transportManager,
+ * });
+ *
+ * await wrapper.executeWithLifecycle(executionId, task, workDir);
+ * ```
+ */
+export declare class AgentExecutorWrapper<TConfig extends BaseAgentConfig> {
+    private adapter;
+    private executor;
+    /** Agent type used for executor selection and logging */
+    private readonly agentType;
+    private _agentConfig;
+    private logsStore;
+    private transportManager?;
+    private projectId;
+    private db;
+    private processConfig;
+    private activeExecutions;
+    /** Track completion state for Claude Code executions (from protocol peer) */
+    private completionState;
+    constructor(config: AgentExecutorWrapperConfig<TConfig>);
+    /**
+     * Create the appropriate executor for the given agent type
+     *
+     * @param agentType - Type of agent
+     * @param agentConfig - Agent configuration
+     * @returns Executor instance
+     */
+    private createExecutor;
+    /**
+     * Execute a task with full lifecycle management
+     *
+     * @param executionId - Unique execution identifier
+     * @param task - Task to execute
+     * @param workDir - Working directory for execution
+     */
+    executeWithLifecycle(executionId: string, task: ExecutionTask, workDir: string): 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
+     */
+    resumeWithLifecycle(executionId: string, sessionId: string, task: ExecutionTask, workDir: string): Promise<void>;
+    /**
+     * Cancel a running execution
+     *
+     * @param executionId - Execution ID to cancel
+     */
+    cancel(executionId: string): Promise<void>;
+    /**
+     * Setup AG-UI system for execution
+     *
+     * @private
+     */
+    private setupAgUiSystem;
+    /**
+     * Process normalized output from agent
+     *
+     * For Claude Code: Also captures session ID from metadata for session resumption
+     *
+     * @private
+     */
+    private processNormalizedOutput;
+    /**
+     * Handle successful execution
+     *
+     * @private
+     */
+    private handleSuccess;
+    /**
+     * Handle execution error
+     *
+     * @private
+     */
+    private handleError;
+    /**
+     * Create output chunk stream from ManagedProcess
+     *
+     * For Claude Code: Uses protocol peer to receive messages
+     * For other agents: Reads directly from stdout/stderr streams
+     *
+     * @private
+     */
+    private createOutputChunks;
+    /**
+     * Convert protocol peer messages to output chunks
+     *
+     * Used for Claude Code which uses a protocol peer that consumes stdout
+     * Updates completion state when result message is received
+     *
+     * @private
+     */
+    private peerMessagesToOutputChunks;
+    /**
+     * Convert a readable stream to output chunks
+     *
+     * @private
+     */
+    private streamToChunks;
+}
+//# sourceMappingURL=agent-executor-wrapper.d.ts.map

package/dist/execution/executors/agent-executor-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor-wrapper.d.ts","sourceRoot":"","sources":["../../../src/execution/executors/agent-executor-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,+BAA+B,CAAC;AAOvC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AA8B1E;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,OAAO,SAAS,eAAe;IACzE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,gBAAgB,EAAE,yBAAyB,CAAC;IAC5C,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,oBAAoB,CAAC,OAAO,SAAS,eAAe;IAC/D,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,QAAQ,CAAiB;IACjC,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,6EAA6E;IAC7E,OAAO,CAAC,eAAe,CAGrB;gBAEU,MAAM,EAAE,0BAA0B,CAAC,OAAO,CAAC;IA2BvD;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IA8BtB;;;;;;OAMG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAwNhB;;;;;;;OAOG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IA2HhB;;;;OAIG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDhD;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;;;OAMG;YACW,uBAAuB;IAmErC;;;;OAIG;YACW,aAAa;IA4E3B;;;;OAIG;YACW,WAAW;IAiDzB;;;;;;;OAOG;YACY,kBAAkB;IAkDjC;;;;;;;OAOG;YACY,0BAA0B;IAsDzC;;;;OAIG;YACY,cAAc;CAgB9B"}