@sudocode-ai/local-server 0.1.7 → 0.1.8

package/dist/execution/adapters/cursor-adapter.js

@@ -0,0 +1,121 @@
+/**
+ * Cursor Agent Adapter
+ *
+ * Implements the IAgentAdapter interface for Cursor CLI (cursor-agent).
+ * Provides agent-specific configuration building and metadata.
+ *
+ * Based on agent-execution-engine implementation.
+ */
+import { AgentConfigUtils } from "./shared/index.js";
+/**
+ * Cursor agent metadata
+ */
+const CURSOR_METADATA = {
+    name: "cursor",
+    displayName: "Cursor",
+    version: ">=1.0.0",
+    supportedModes: ["structured"], // Uses JSONL stream protocol
+    supportsStreaming: true,
+    supportsStructuredOutput: true, // stream-json format
+};
+/**
+ * Cursor Agent Adapter
+ *
+ * Provides Cursor-specific configuration building and capabilities.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new CursorAdapter();
+ * const config = adapter.buildProcessConfig({
+ *   workDir: '/path/to/project',
+ *   force: true,
+ *   model: 'sonnet-4.5',
+ * });
+ *
+ * const processManager = createProcessManager(config);
+ * ```
+ */
+export class CursorAdapter {
+    metadata = CURSOR_METADATA;
+    /**
+     * Build ProcessConfig from Cursor-specific configuration
+     *
+     * @param config - Cursor configuration
+     * @returns Generic ProcessConfig
+     */
+    buildProcessConfig(config) {
+        const args = this.buildCursorArgs(config);
+        return AgentConfigUtils.buildBaseProcessConfig(config.cursorPath || "cursor-agent", args, config);
+    }
+    /**
+     * Build Cursor-specific command-line arguments
+     *
+     * @param config - Cursor configuration
+     * @returns Array of command-line arguments
+     */
+    buildCursorArgs(config) {
+        const args = [];
+        // Always use -p (print/non-interactive mode) and stream-json output
+        args.push("-p");
+        args.push("--output-format=stream-json");
+        // Add conditional flags
+        args.push(...AgentConfigUtils.buildConditionalArgs([
+            { flag: "--force", condition: !!config.force },
+            { flag: "--model", value: config.model, condition: !!config.model },
+        ]));
+        return args;
+    }
+    /**
+     * Validate Cursor configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors (empty if valid)
+     */
+    validateConfig(config) {
+        const errors = [
+            ...AgentConfigUtils.validateBaseConfig(config),
+            ...this.validateCursorSpecific(config),
+        ];
+        return errors;
+    }
+    /**
+     * Validate Cursor-specific configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors
+     */
+    validateCursorSpecific(config) {
+        const errors = [];
+        // Validate model if specified
+        const validModels = [
+            "auto",
+            "sonnet-4.5",
+            "sonnet-4.5-thinking",
+            "gpt-5",
+            "opus-4.1",
+            "grok",
+        ];
+        if (config.model && !validModels.includes(config.model)) {
+            // Allow custom model strings, just warn
+            console.warn(`Unknown model specified: ${config.model}. Known models: ${validModels.join(", ")}`);
+        }
+        // Validate timeouts
+        errors.push(...AgentConfigUtils.validateTimeouts(config.timeout, config.idleTimeout));
+        // Validate retry config
+        errors.push(...AgentConfigUtils.validateRetryConfig(config.retry));
+        return errors;
+    }
+    /**
+     * Get default Cursor configuration
+     *
+     * @returns Default configuration values
+     */
+    getDefaultConfig() {
+        return {
+            cursorPath: "cursor-agent",
+            force: true, // Auto-approve for automation
+            model: "auto", // Let Cursor choose best model
+        };
+    }
+}
+//# sourceMappingURL=cursor-adapter.js.map

package/dist/execution/adapters/cursor-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-adapter.js","sourceRoot":"","sources":["../../../src/execution/adapters/cursor-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,eAAe,GAAkB;IACrC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,CAAC,YAAY,CAAC,EAAE,6BAA6B;IAC7D,iBAAiB,EAAE,IAAI;IACvB,wBAAwB,EAAE,IAAI,EAAE,qBAAqB;CACtD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,aAAa;IACf,QAAQ,GAAG,eAAe,CAAC;IAEpC;;;;;OAKG;IACH,kBAAkB,CAAC,MAAoB;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,gBAAgB,CAAC,sBAAsB,CAC5C,MAAM,CAAC,UAAU,IAAI,cAAc,EACnC,IAAI,EACJ,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,eAAe,CAAC,MAAoB;QAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,oEAAoE;QACpE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAEzC,wBAAwB;QACxB,IAAI,CAAC,IAAI,CACP,GAAG,gBAAgB,CAAC,oBAAoB,CAAC;YACvC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE;YAC9C,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE;SACpE,CAAC,CACH,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,MAAoB;QACjC,MAAM,MAAM,GAAG;YACb,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC;YAC9C,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC;SACvC,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACK,sBAAsB,CAAC,MAAoB;QACjD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,8BAA8B;QAC9B,MAAM,WAAW,GAAG;YAClB,MAAM;YACN,YAAY;YACZ,qBAAqB;YACrB,OAAO;YACP,UAAU;YACV,MAAM;SACE,CAAC;QAEX,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAY,CAAC,EAAE,CAAC;YAC/D,wCAAwC;YACxC,OAAO,CAAC,IAAI,CACV,4BAA4B,MAAM,CAAC,KAAK,mBAAmB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpF,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,MAAM,CAAC,IAAI,CACT,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,CACzE,CAAC;QAEF,wBAAwB;QACxB,MAAM,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,OAAO;YACL,UAAU,EAAE,cAAc;YAC1B,KAAK,EAAE,IAAI,EAAE,8BAA8B;YAC3C,KAAK,EAAE,MAAM,EAAE,+BAA+B;SAC/C,CAAC;IACJ,CAAC;CACF"}

package/dist/execution/adapters/cursor-config-builder.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cursor Configuration Builder
+ *
+ * Utility for building ProcessConfig specific to Cursor CLI (cursor-agent).
+ * Provides type-safe configuration for Cursor's flags and options.
+ *
+ * Based on agent-execution-engine cursor executor implementation.
+ */
+import type { ProcessConfig } from "agent-execution-engine/process";
+import type { CursorConfig } from "@sudocode-ai/types/agents";
+/**
+ * Build a generic ProcessConfig from Cursor specific configuration
+ *
+ * @param config - Cursor specific configuration
+ * @returns Generic ProcessConfig that can be used with any ProcessManager
+ *
+ * @example
+ * ```typescript
+ * const config = buildCursorConfig({
+ *   workDir: '/path/to/project',
+ *   force: true,
+ *   model: 'sonnet-4.5',
+ * });
+ *
+ * const process = await manager.acquireProcess(config);
+ * ```
+ */
+export declare function buildCursorConfig(config: CursorConfig): ProcessConfig;
+//# sourceMappingURL=cursor-config-builder.d.ts.map

package/dist/execution/adapters/cursor-config-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-config-builder.d.ts","sourceRoot":"","sources":["../../../src/execution/adapters/cursor-config-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CA0BrE"}

package/dist/execution/adapters/cursor-config-builder.js

@@ -0,0 +1,49 @@
+/**
+ * Cursor Configuration Builder
+ *
+ * Utility for building ProcessConfig specific to Cursor CLI (cursor-agent).
+ * Provides type-safe configuration for Cursor's flags and options.
+ *
+ * Based on agent-execution-engine cursor executor implementation.
+ */
+/**
+ * Build a generic ProcessConfig from Cursor specific configuration
+ *
+ * @param config - Cursor specific configuration
+ * @returns Generic ProcessConfig that can be used with any ProcessManager
+ *
+ * @example
+ * ```typescript
+ * const config = buildCursorConfig({
+ *   workDir: '/path/to/project',
+ *   force: true,
+ *   model: 'sonnet-4.5',
+ * });
+ *
+ * const process = await manager.acquireProcess(config);
+ * ```
+ */
+export function buildCursorConfig(config) {
+    const args = [];
+    // Always use -p (print/non-interactive mode) and stream-json output
+    args.push("-p");
+    args.push("--output-format=stream-json");
+    // Add --force flag for auto-approval
+    if (config.force) {
+        args.push("--force");
+    }
+    // Add --model flag if specified
+    if (config.model) {
+        args.push("--model", config.model);
+    }
+    return {
+        executablePath: config.cursorPath || "cursor-agent",
+        args,
+        workDir: config.workDir,
+        env: config.env,
+        timeout: config.timeout,
+        idleTimeout: config.idleTimeout,
+        retry: config.retry,
+    };
+}
+//# sourceMappingURL=cursor-config-builder.js.map

package/dist/execution/adapters/cursor-config-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-config-builder.js","sourceRoot":"","sources":["../../../src/execution/adapters/cursor-config-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,oEAAoE;IACpE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAEzC,qCAAqC;IACrC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,gCAAgC;IAChC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,UAAU,IAAI,cAAc;QACnD,IAAI;QACJ,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/execution/adapters/shared/config-presets.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Agent Configuration Presets
+ *
+ * Predefined configuration profiles for common use cases.
+ * Makes it easier to configure agents for specific scenarios.
+ *
+ * @module execution/adapters/shared
+ */
+import type { CodexConfig, CopilotConfig, CursorConfig, ClaudeCodeConfig } from '@sudocode-ai/types/agents';
+/**
+ * Configuration profile types
+ */
+export type ConfigProfile = 'safe' | 'automation' | 'development' | 'production';
+/**
+ * Safe preset - Maximum safety, minimal permissions
+ * Use for untrusted code or when you want maximum control
+ */
+export declare const SAFE_PRESET: {
+    readonly autoApprove: false;
+    readonly skipPermissions: false;
+    readonly fullAuto: false;
+};
+/**
+ * Automation preset - Auto-approve everything for CI/CD
+ * Use for automated workflows where human approval isn't feasible
+ */
+export declare const AUTOMATION_PRESET: {
+    readonly autoApprove: true;
+    readonly skipPermissions: true;
+    readonly fullAuto: true;
+};
+/**
+ * Development preset - Balanced for local development
+ * Auto-approve with workspace-level permissions
+ */
+export declare const DEVELOPMENT_PRESET: {
+    readonly autoApprove: true;
+    readonly skipPermissions: false;
+    readonly fullAuto: true;
+};
+/**
+ * Production preset - Conservative for production environments
+ * Similar to safe but with some automation
+ */
+export declare const PRODUCTION_PRESET: {
+    readonly autoApprove: false;
+    readonly skipPermissions: false;
+    readonly fullAuto: false;
+};
+/**
+ * Apply a configuration profile to Cursor config
+ *
+ * @param config - Base Cursor configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export declare function applyCursorPreset(config: CursorConfig, profile: ConfigProfile): CursorConfig;
+/**
+ * Apply a configuration profile to Copilot config
+ *
+ * @param config - Base Copilot configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export declare function applyCopilotPreset(config: CopilotConfig, profile: ConfigProfile): CopilotConfig;
+/**
+ * Apply a configuration profile to Codex config
+ *
+ * @param config - Base Codex configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export declare function applyCodexPreset(config: CodexConfig, profile: ConfigProfile): CodexConfig;
+/**
+ * Apply a configuration profile to Claude Code config
+ *
+ * @param config - Base Claude Code configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export declare function applyClaudeCodePreset(config: ClaudeCodeConfig, profile: ConfigProfile): ClaudeCodeConfig;
+/**
+ * Get recommended timeout values based on profile
+ *
+ * @param profile - Configuration profile
+ * @returns Timeout configuration
+ */
+export declare function getRecommendedTimeouts(profile: ConfigProfile): {
+    timeout: number;
+    idleTimeout: number;
+};
+/**
+ * Get recommended retry configuration based on profile
+ *
+ * @param profile - Configuration profile
+ * @returns Retry configuration
+ */
+export declare function getRecommendedRetry(profile: ConfigProfile): {
+    maxAttempts: number;
+    backoffMs: number;
+};
+//# sourceMappingURL=config-presets.d.ts.map

package/dist/execution/adapters/shared/config-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-presets.d.ts","sourceRoot":"","sources":["../../../../src/execution/adapters/shared/config-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,GACrB,YAAY,CASd;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,aAAa,GACrB,aAAa,CASf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,GACrB,WAAW,CA6Bb;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,aAAa,GACrB,gBAAgB,CA+BlB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAqBA"}

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

@@ -0,0 +1,205 @@
+/**
+ * Agent Configuration Presets
+ *
+ * Predefined configuration profiles for common use cases.
+ * Makes it easier to configure agents for specific scenarios.
+ *
+ * @module execution/adapters/shared
+ */
+/**
+ * Safe preset - Maximum safety, minimal permissions
+ * Use for untrusted code or when you want maximum control
+ */
+export const SAFE_PRESET = {
+    autoApprove: false,
+    skipPermissions: false,
+    fullAuto: false,
+};
+/**
+ * Automation preset - Auto-approve everything for CI/CD
+ * Use for automated workflows where human approval isn't feasible
+ */
+export const AUTOMATION_PRESET = {
+    autoApprove: true,
+    skipPermissions: true,
+    fullAuto: true,
+};
+/**
+ * Development preset - Balanced for local development
+ * Auto-approve with workspace-level permissions
+ */
+export const DEVELOPMENT_PRESET = {
+    autoApprove: true,
+    skipPermissions: false,
+    fullAuto: true,
+};
+/**
+ * Production preset - Conservative for production environments
+ * Similar to safe but with some automation
+ */
+export const PRODUCTION_PRESET = {
+    autoApprove: false,
+    skipPermissions: false,
+    fullAuto: false,
+};
+/**
+ * Apply a configuration profile to Cursor config
+ *
+ * @param config - Base Cursor configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export function applyCursorPreset(config, profile) {
+    const presets = {
+        safe: { force: false },
+        automation: { force: true },
+        development: { force: true },
+        production: { force: false },
+    };
+    return { ...config, ...presets[profile] };
+}
+/**
+ * Apply a configuration profile to Copilot config
+ *
+ * @param config - Base Copilot configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export function applyCopilotPreset(config, profile) {
+    const presets = {
+        safe: { allowAllTools: false },
+        automation: { allowAllTools: true },
+        development: { allowAllTools: true },
+        production: { allowAllTools: false },
+    };
+    return { ...config, ...presets[profile] };
+}
+/**
+ * Apply a configuration profile to Codex config
+ *
+ * @param config - Base Codex configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export function applyCodexPreset(config, profile) {
+    const presets = {
+        safe: {
+            sandbox: 'read-only',
+            askForApproval: 'untrusted',
+            fullAuto: false,
+            yolo: false,
+        },
+        automation: {
+            sandbox: 'workspace-write',
+            askForApproval: 'never',
+            fullAuto: true,
+            yolo: false,
+        },
+        development: {
+            sandbox: 'workspace-write',
+            askForApproval: 'on-failure',
+            fullAuto: true,
+            yolo: false,
+        },
+        production: {
+            sandbox: 'workspace-write',
+            askForApproval: 'untrusted',
+            fullAuto: false,
+            yolo: false,
+        },
+    };
+    return { ...config, ...presets[profile] };
+}
+/**
+ * Apply a configuration profile to Claude Code config
+ *
+ * @param config - Base Claude Code configuration
+ * @param profile - Profile to apply
+ * @returns Configuration with profile applied
+ */
+export function applyClaudeCodePreset(config, profile) {
+    const presets = {
+        safe: {
+            dangerouslySkipPermissions: false,
+            allowDangerouslySkipPermissions: false,
+            permissionMode: 'default',
+            // No tool restrictions for safe - let Claude ask for permissions
+        },
+        automation: {
+            dangerouslySkipPermissions: true,
+            permissionMode: 'bypassPermissions',
+            // For automation, enable all tools by default
+            tools: ['default'],
+        },
+        development: {
+            dangerouslySkipPermissions: true,
+            permissionMode: 'acceptEdits',
+            // Allow common development tools
+            allowedTools: ['Bash', 'Edit', 'Read', 'Write', 'Glob', 'Grep'],
+        },
+        production: {
+            dangerouslySkipPermissions: false,
+            allowDangerouslySkipPermissions: true, // Allow but don't enable by default
+            permissionMode: 'default',
+            // Restrict to read-only tools in production
+            allowedTools: ['Read', 'Glob', 'Grep'],
+            disallowedTools: ['Bash', 'Write'],
+        },
+    };
+    return { ...config, ...presets[profile] };
+}
+/**
+ * Get recommended timeout values based on profile
+ *
+ * @param profile - Configuration profile
+ * @returns Timeout configuration
+ */
+export function getRecommendedTimeouts(profile) {
+    const timeouts = {
+        safe: {
+            timeout: 5 * 60 * 1000, // 5 minutes
+            idleTimeout: 2 * 60 * 1000, // 2 minutes
+        },
+        automation: {
+            timeout: 30 * 60 * 1000, // 30 minutes
+            idleTimeout: 10 * 60 * 1000, // 10 minutes
+        },
+        development: {
+            timeout: 15 * 60 * 1000, // 15 minutes
+            idleTimeout: 5 * 60 * 1000, // 5 minutes
+        },
+        production: {
+            timeout: 10 * 60 * 1000, // 10 minutes
+            idleTimeout: 3 * 60 * 1000, // 3 minutes
+        },
+    };
+    return timeouts[profile];
+}
+/**
+ * Get recommended retry configuration based on profile
+ *
+ * @param profile - Configuration profile
+ * @returns Retry configuration
+ */
+export function getRecommendedRetry(profile) {
+    const retryConfigs = {
+        safe: {
+            maxAttempts: 1, // No retries for safety
+            backoffMs: 0,
+        },
+        automation: {
+            maxAttempts: 3, // More retries for automation
+            backoffMs: 1000,
+        },
+        development: {
+            maxAttempts: 2,
+            backoffMs: 500,
+        },
+        production: {
+            maxAttempts: 2,
+            backoffMs: 1000,
+        },
+    };
+    return retryConfigs[profile];
+}
+//# sourceMappingURL=config-presets.js.map

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

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

package/dist/execution/adapters/shared/config-utils.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Shared Agent Configuration Utilities
+ *
+ * Common utilities for building and validating agent configurations.
+ * Reduces duplication across different agent adapters.
+ *
+ * @module execution/adapters/shared
+ */
+import type { ProcessConfig } from 'agent-execution-engine/process';
+import type { BaseAgentConfig } from '@sudocode-ai/types/agents';
+/**
+ * Utility class for common agent configuration operations
+ */
+export declare 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: BaseAgentConfig): string[];
+    /**
+     * Merge configuration with defaults
+     *
+     * @param config - User-provided configuration
+     * @param defaults - Default configuration values
+     * @returns Merged configuration with defaults applied
+     */
+    static withDefaults<T extends BaseAgentConfig>(config: T, defaults: Partial<T>): T;
+    /**
+     * 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: string, args: string[], config: BaseAgentConfig): ProcessConfig;
+    /**
+     * Validate timeout configuration
+     *
+     * @param timeout - Timeout value in milliseconds
+     * @param idleTimeout - Idle timeout value in milliseconds
+     * @returns Array of validation errors
+     */
+    static validateTimeouts(timeout?: number, idleTimeout?: number): string[];
+    /**
+     * Validate retry configuration
+     *
+     * @param retry - Retry configuration object
+     * @returns Array of validation errors
+     */
+    static validateRetryConfig(retry?: {
+        maxAttempts: number;
+        backoffMs: number;
+    }): string[];
+    /**
+     * 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: string[] | undefined, fieldName: string): string[];
+    /**
+     * 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<T extends string>(value: T | undefined, validValues: readonly T[], fieldName: string): string[];
+    /**
+     * 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: Array<{
+        flag: string;
+        value?: string;
+        condition: boolean;
+    }>): string[];
+}
+//# sourceMappingURL=config-utils.d.ts.map

package/dist/execution/adapters/shared/config-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-utils.d.ts","sourceRoot":"","sources":["../../../../src/execution/adapters/shared/config-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE;IAc5D;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,eAAe,EAC3C,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GACnB,CAAC;IAIJ;;;;;;;OAOG;IACH,MAAM,CAAC,sBAAsB,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,eAAe,GACtB,aAAa;IAchB;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CACrB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,EAAE;IAsBX;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE;QACjC,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,MAAM,EAAE;IAkBZ;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAC3B,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE;IAgBX;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,MAAM,EAClC,KAAK,EAAE,CAAC,GAAG,SAAS,EACpB,WAAW,EAAE,SAAS,CAAC,EAAE,EACzB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE;IAYX;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,oBAAoB,CACzB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,GACD,MAAM,EAAE;CAcZ"}