@sudocode-ai/local-server 0.1.7 → 0.1.8

package/README.md

@@ -17,3 +17,9 @@ Run the sudocode companion app with `sudocode server`. You can specify a port wi
 
 The server will start on `http://localhost:3000` by default.
 
+### Environment Variables
+
+The server supports the following environment variables (all prefixed with `SUDOCODE_` to avoid conflicts with project environments):
+
+- `SUDOCODE_PORT` - Server port (default: 3000)
+- `SUDOCODE_WATCH` - Enable/disable file watching (default: enabled, set to `false` to disable)

package/dist/errors/agent-errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Custom error classes for agent-specific errors
+ *
+ * These errors provide structured error information for multi-agent execution scenarios,
+ * including error codes and details for frontend consumption.
+ */
+/**
+ * Base class for agent-related errors
+ */
+export declare class AgentError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown>;
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+}
+/**
+ * Error thrown when an agent is not found in the registry
+ * HTTP Status: 400 Bad Request
+ */
+export declare class AgentNotFoundError extends AgentError {
+    constructor(agentType: string, availableAgents: string[]);
+}
+/**
+ * Error thrown when an agent is registered but not yet implemented (stub)
+ * HTTP Status: 501 Not Implemented
+ */
+export declare class AgentNotImplementedError extends AgentError {
+    constructor(agentType: string);
+}
+/**
+ * Error thrown when agent configuration fails validation
+ * HTTP Status: 400 Bad Request
+ */
+export declare class AgentConfigValidationError extends AgentError {
+    constructor(agentType: string, validationErrors: string[]);
+}
+/**
+ * Error thrown when agent execution fails
+ * HTTP Status: 500 Internal Server Error
+ */
+export declare class AgentExecutionError extends AgentError {
+    constructor(agentType: string, message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=agent-errors.d.ts.map

package/dist/errors/agent-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-errors.d.ts","sourceRoot":"","sources":["../../src/errors/agent-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAErC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAOjF;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;CAUzD;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,SAAS,EAAE,MAAM;CAU9B;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,UAAU;gBAC5C,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE;CAU1D;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAUtF"}

package/dist/errors/agent-errors.js

@@ -0,0 +1,69 @@
+/**
+ * Custom error classes for agent-specific errors
+ *
+ * These errors provide structured error information for multi-agent execution scenarios,
+ * including error codes and details for frontend consumption.
+ */
+/**
+ * Base class for agent-related errors
+ */
+export class AgentError extends Error {
+    code;
+    details;
+    constructor(message, code, details = {}) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.details = details;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Error thrown when an agent is not found in the registry
+ * HTTP Status: 400 Bad Request
+ */
+export class AgentNotFoundError extends AgentError {
+    constructor(agentType, availableAgents) {
+        super(`Agent '${agentType}' not found in registry`, 'AGENT_NOT_FOUND', {
+            agentType,
+            availableAgents,
+        });
+    }
+}
+/**
+ * Error thrown when an agent is registered but not yet implemented (stub)
+ * HTTP Status: 501 Not Implemented
+ */
+export class AgentNotImplementedError extends AgentError {
+    constructor(agentType) {
+        super(`Agent '${agentType}' is not yet implemented`, 'AGENT_NOT_IMPLEMENTED', {
+            agentType,
+            message: 'This agent is registered but not yet fully implemented. Check back in a future release.',
+        });
+    }
+}
+/**
+ * Error thrown when agent configuration fails validation
+ * HTTP Status: 400 Bad Request
+ */
+export class AgentConfigValidationError extends AgentError {
+    constructor(agentType, validationErrors) {
+        super('Agent configuration validation failed', 'AGENT_CONFIG_VALIDATION_ERROR', {
+            agentType,
+            errors: validationErrors,
+        });
+    }
+}
+/**
+ * Error thrown when agent execution fails
+ * HTTP Status: 500 Internal Server Error
+ */
+export class AgentExecutionError extends AgentError {
+    constructor(agentType, message, details = {}) {
+        super(message, 'AGENT_EXECUTION_ERROR', {
+            agentType,
+            ...details,
+        });
+    }
+}
+//# sourceMappingURL=agent-errors.js.map

package/dist/errors/agent-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-errors.js","sourceRoot":"","sources":["../../src/errors/agent-errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,IAAI,CAAS;IACb,OAAO,CAA0B;IAEjD,YAAY,OAAe,EAAE,IAAY,EAAE,UAAmC,EAAE;QAC9E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,SAAiB,EAAE,eAAyB;QACtD,KAAK,CACH,UAAU,SAAS,yBAAyB,EAC5C,iBAAiB,EACjB;YACE,SAAS;YACT,eAAe;SAChB,CACF,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACtD,YAAY,SAAiB;QAC3B,KAAK,CACH,UAAU,SAAS,0BAA0B,EAC7C,uBAAuB,EACvB;YACE,SAAS;YACT,OAAO,EAAE,yFAAyF;SACnG,CACF,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,UAAU;IACxD,YAAY,SAAiB,EAAE,gBAA0B;QACvD,KAAK,CACH,uCAAuC,EACvC,+BAA+B,EAC/B;YACE,SAAS;YACT,MAAM,EAAE,gBAAgB;SACzB,CACF,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,SAAiB,EAAE,OAAe,EAAE,UAAmC,EAAE;QACnF,KAAK,CACH,OAAO,EACP,uBAAuB,EACvB;YACE,SAAS;YACT,GAAG,OAAO;SACX,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/execution/adapters/claude-adapter.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Claude Code Agent Adapter
+ *
+ * Implements the IAgentAdapter interface for Claude Code CLI.
+ * Provides agent-specific configuration building and metadata using
+ * the expanded ClaudeCodeConfig from @sudocode-ai/types.
+ *
+ * @module execution/adapters/claude-adapter
+ */
+import type { IAgentAdapter, AgentMetadata } from "agent-execution-engine/agents";
+import type { ProcessConfig } from "agent-execution-engine/process";
+import type { ClaudeCodeConfig } from "@sudocode-ai/types/agents";
+/**
+ * Claude Code Adapter
+ *
+ * Provides configuration building and validation for Claude Code CLI.
+ * Uses the expanded ClaudeCodeConfig which supports model selection,
+ * tool permissions, system prompts, MCP configuration, and more.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new ClaudeCodeAdapter();
+ *
+ * const processConfig = adapter.buildProcessConfig({
+ *   workDir: '/path/to/project',
+ *   print: true,
+ *   outputFormat: 'stream-json',
+ *   model: 'sonnet',
+ *   allowedTools: ['Bash(git:*)', 'Edit', 'Read'],
+ * });
+ * ```
+ */
+export declare class ClaudeCodeAdapter implements IAgentAdapter<ClaudeCodeConfig> {
+    /**
+     * Agent metadata
+     */
+    readonly metadata: AgentMetadata;
+    /**
+     * Build ProcessConfig from Claude Code configuration
+     *
+     * @param config - Claude Code configuration
+     * @returns Generic ProcessConfig for process spawning
+     */
+    buildProcessConfig(config: ClaudeCodeConfig): ProcessConfig;
+    /**
+     * Validate Claude Code configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors (empty if valid)
+     */
+    validateConfig(config: ClaudeCodeConfig): string[];
+    /**
+     * Get default configuration values
+     *
+     * @returns Default Claude Code configuration
+     */
+    getDefaultConfig(): Partial<ClaudeCodeConfig>;
+}
+/**
+ * Singleton instance of Claude Code adapter
+ */
+export declare const claudeCodeAdapter: ClaudeCodeAdapter;
+//# sourceMappingURL=claude-adapter.d.ts.map

package/dist/execution/adapters/claude-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.d.ts","sourceRoot":"","sources":["../../../src/execution/adapters/claude-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAOlE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,iBAAkB,YAAW,aAAa,CAAC,gBAAgB,CAAC;IACvE;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAO9B;IAEF;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa;IAU3D;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAIlD;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAS9C;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * Claude Code Agent Adapter
+ *
+ * Implements the IAgentAdapter interface for Claude Code CLI.
+ * Provides agent-specific configuration building and metadata using
+ * the expanded ClaudeCodeConfig from @sudocode-ai/types.
+ *
+ * @module execution/adapters/claude-adapter
+ */
+import { AgentConfigUtils } from "./shared/index.js";
+import { buildClaudeArgs, validateClaudeConfig, } from "../process/builders/claude.js";
+/**
+ * Claude Code Adapter
+ *
+ * Provides configuration building and validation for Claude Code CLI.
+ * Uses the expanded ClaudeCodeConfig which supports model selection,
+ * tool permissions, system prompts, MCP configuration, and more.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new ClaudeCodeAdapter();
+ *
+ * const processConfig = adapter.buildProcessConfig({
+ *   workDir: '/path/to/project',
+ *   print: true,
+ *   outputFormat: 'stream-json',
+ *   model: 'sonnet',
+ *   allowedTools: ['Bash(git:*)', 'Edit', 'Read'],
+ * });
+ * ```
+ */
+export class ClaudeCodeAdapter {
+    /**
+     * Agent metadata
+     */
+    metadata = {
+        name: "claude-code",
+        displayName: "Claude",
+        version: "1.0.0",
+        supportedModes: ["structured", "interactive", "hybrid"],
+        supportsStreaming: true,
+        supportsStructuredOutput: true,
+    };
+    /**
+     * Build ProcessConfig from Claude Code configuration
+     *
+     * @param config - Claude Code configuration
+     * @returns Generic ProcessConfig for process spawning
+     */
+    buildProcessConfig(config) {
+        const args = buildClaudeArgs(config);
+        return AgentConfigUtils.buildBaseProcessConfig(config.claudePath || "claude", args, config);
+    }
+    /**
+     * Validate Claude Code configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors (empty if valid)
+     */
+    validateConfig(config) {
+        return validateClaudeConfig(config);
+    }
+    /**
+     * Get default configuration values
+     *
+     * @returns Default Claude Code configuration
+     */
+    getDefaultConfig() {
+        return {
+            claudePath: "claude",
+            print: true,
+            outputFormat: "stream-json",
+            verbose: true, // Required for stream-json with print
+            dangerouslySkipPermissions: false,
+        };
+    }
+}
+/**
+ * Singleton instance of Claude Code adapter
+ */
+export const claudeCodeAdapter = new ClaudeCodeAdapter();
+//# sourceMappingURL=claude-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-adapter.js","sourceRoot":"","sources":["../../../src/execution/adapters/claude-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,iBAAiB;IAC5B;;OAEG;IACM,QAAQ,GAAkB;QACjC,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,OAAO;QAChB,cAAc,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC;QACvD,iBAAiB,EAAE,IAAI;QACvB,wBAAwB,EAAE,IAAI;KAC/B,CAAC;IAEF;;;;;OAKG;IACH,kBAAkB,CAAC,MAAwB;QACzC,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAErC,OAAO,gBAAgB,CAAC,sBAAsB,CAC5C,MAAM,CAAC,UAAU,IAAI,QAAQ,EAC7B,IAAI,EACJ,MAAM,CACP,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,MAAwB;QACrC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,OAAO;YACL,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,aAAa;YAC3B,OAAO,EAAE,IAAI,EAAE,sCAAsC;YACrD,0BAA0B,EAAE,KAAK;SAClC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/execution/adapters/codex-adapter.d.ts

@@ -0,0 +1,67 @@
+/**
+ * OpenAI Codex Agent Adapter
+ *
+ * Implements the IAgentAdapter interface for OpenAI Codex CLI.
+ * Provides agent-specific configuration building and metadata.
+ *
+ * Based on agent-execution-engine implementation.
+ */
+import type { IAgentAdapter, AgentMetadata } from "agent-execution-engine/agents";
+import type { ProcessConfig } from "agent-execution-engine/process";
+import type { CodexConfig } from "@sudocode-ai/types/agents";
+/**
+ * OpenAI Codex Agent Adapter
+ *
+ * Provides Codex-specific configuration building and capabilities.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new CodexAdapter();
+ * const config = adapter.buildProcessConfig({
+ *   workDir: '/path/to/project',
+ *   exec: true,
+ *   json: true,
+ *   fullAuto: true,
+ * });
+ *
+ * const processManager = createProcessManager(config);
+ * ```
+ */
+export declare class CodexAdapter implements IAgentAdapter<CodexConfig> {
+    readonly metadata: AgentMetadata;
+    /**
+     * Build ProcessConfig from Codex-specific configuration
+     *
+     * @param config - Codex configuration
+     * @returns Generic ProcessConfig
+     */
+    buildProcessConfig(config: CodexConfig): ProcessConfig;
+    /**
+     * Build Codex-specific command-line arguments
+     *
+     * @param config - Codex configuration
+     * @returns Array of command-line arguments
+     */
+    private buildCodexArgs;
+    /**
+     * Validate Codex configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors (empty if valid)
+     */
+    validateConfig(config: CodexConfig): string[];
+    /**
+     * Validate Codex-specific configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors
+     */
+    private validateCodexSpecific;
+    /**
+     * Get default Codex configuration
+     *
+     * @returns Default configuration values
+     */
+    getDefaultConfig(): Partial<CodexConfig>;
+}
+//# sourceMappingURL=codex-adapter.d.ts.map

package/dist/execution/adapters/codex-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-adapter.d.ts","sourceRoot":"","sources":["../../../src/execution/adapters/codex-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAe7D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,YAAW,aAAa,CAAC,WAAW,CAAC;IAC7D,QAAQ,CAAC,QAAQ,gBAAkB;IAEnC;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa;IAStD;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAuEtB;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE;IAO7C;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAiE7B;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC;CAazC"}

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

@@ -0,0 +1,183 @@
+/**
+ * OpenAI Codex Agent Adapter
+ *
+ * Implements the IAgentAdapter interface for OpenAI Codex CLI.
+ * Provides agent-specific configuration building and metadata.
+ *
+ * Based on agent-execution-engine implementation.
+ */
+import { AgentConfigUtils } from "./shared/index.js";
+/**
+ * OpenAI Codex agent metadata
+ */
+const CODEX_METADATA = {
+    name: "codex",
+    displayName: "Codex",
+    version: ">=1.0.0",
+    supportedModes: ["structured", "interactive"],
+    supportsStreaming: true,
+    supportsStructuredOutput: true,
+};
+/**
+ * OpenAI Codex Agent Adapter
+ *
+ * Provides Codex-specific configuration building and capabilities.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new CodexAdapter();
+ * const config = adapter.buildProcessConfig({
+ *   workDir: '/path/to/project',
+ *   exec: true,
+ *   json: true,
+ *   fullAuto: true,
+ * });
+ *
+ * const processManager = createProcessManager(config);
+ * ```
+ */
+export class CodexAdapter {
+    metadata = CODEX_METADATA;
+    /**
+     * Build ProcessConfig from Codex-specific configuration
+     *
+     * @param config - Codex configuration
+     * @returns Generic ProcessConfig
+     */
+    buildProcessConfig(config) {
+        const args = this.buildCodexArgs(config);
+        return AgentConfigUtils.buildBaseProcessConfig(config.codexPath || "codex", args, config);
+    }
+    /**
+     * Build Codex-specific command-line arguments
+     *
+     * @param config - Codex configuration
+     * @returns Array of command-line arguments
+     */
+    buildCodexArgs(config) {
+        const args = [];
+        // Add 'exec' subcommand for non-interactive mode
+        if (config.exec !== false) {
+            args.push("exec");
+            // Add '-' to explicitly read prompt from stdin
+            // This prevents the "Reading prompt from stdin..." blocking message
+            if (!config.prompt) {
+                args.push("-");
+            }
+        }
+        // Add conditional flags using shared utility
+        args.push(...AgentConfigUtils.buildConditionalArgs([
+            { flag: "--json", condition: !!config.json },
+            { flag: "--experimental-json", condition: !!config.experimentalJson },
+            {
+                flag: "--output-last-message",
+                value: config.outputLastMessage,
+                condition: !!config.outputLastMessage,
+            },
+            { flag: "--model", value: config.model, condition: !!config.model },
+            {
+                flag: "--sandbox",
+                value: config.sandbox,
+                condition: !!config.sandbox,
+            },
+            {
+                flag: "--ask-for-approval",
+                value: config.askForApproval,
+                condition: !!config.askForApproval,
+            },
+            { flag: "--full-auto", condition: !!config.fullAuto },
+            { flag: "--skip-git-repo-check", condition: !!config.skipGitRepoCheck },
+            { flag: "--color", value: config.color, condition: !!config.color },
+            { flag: "--search", condition: !!config.search },
+            {
+                flag: "--profile",
+                value: config.profile,
+                condition: !!config.profile,
+            },
+            {
+                flag: "--dangerously-bypass-approvals-and-sandbox",
+                condition: !!config.yolo,
+            },
+        ]));
+        // Add --image flag(s) for image attachments
+        if (config.image && config.image.length > 0) {
+            args.push("--image", config.image.join(","));
+        }
+        // Add --add-dir flag(s) for additional directories
+        if (config.addDir && config.addDir.length > 0) {
+            config.addDir.forEach((dir) => {
+                args.push("--add-dir", dir);
+            });
+        }
+        // Add prompt as the last argument (if provided)
+        if (config.prompt) {
+            args.push(config.prompt);
+        }
+        return args;
+    }
+    /**
+     * Validate Codex configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors (empty if valid)
+     */
+    validateConfig(config) {
+        return [
+            ...AgentConfigUtils.validateBaseConfig(config),
+            ...this.validateCodexSpecific(config),
+        ];
+    }
+    /**
+     * Validate Codex-specific configuration
+     *
+     * @param config - Configuration to validate
+     * @returns Array of validation errors
+     */
+    validateCodexSpecific(config) {
+        const errors = [];
+        // Validate mutually exclusive JSON flags
+        if (config.json && config.experimentalJson) {
+            errors.push("Cannot use both json and experimentalJson flags");
+        }
+        // Validate fullAuto conflicts
+        if (config.fullAuto && (config.sandbox || config.askForApproval)) {
+            errors.push("fullAuto cannot be used with sandbox or askForApproval flags");
+        }
+        // Validate yolo conflicts
+        if (config.yolo &&
+            (config.sandbox || config.askForApproval || config.fullAuto)) {
+            errors.push("yolo flag cannot be used with sandbox, askForApproval, or fullAuto flags");
+        }
+        // Validate enum values using shared utility
+        errors.push(...AgentConfigUtils.validateEnum(config.sandbox, ["read-only", "workspace-write", "danger-full-access"], "sandbox"));
+        errors.push(...AgentConfigUtils.validateEnum(config.askForApproval, ["untrusted", "on-failure", "on-request", "never"], "askForApproval"));
+        errors.push(...AgentConfigUtils.validateEnum(config.color, ["always", "never", "auto"], "color"));
+        // Validate paths
+        errors.push(...AgentConfigUtils.validatePaths(config.addDir, "addDir"));
+        errors.push(...AgentConfigUtils.validatePaths(config.image, "image"));
+        // Validate timeouts
+        errors.push(...AgentConfigUtils.validateTimeouts(config.timeout, config.idleTimeout));
+        // Validate retry config
+        errors.push(...AgentConfigUtils.validateRetryConfig(config.retry));
+        return errors;
+    }
+    /**
+     * Get default Codex configuration
+     *
+     * @returns Default configuration values
+     */
+    getDefaultConfig() {
+        return {
+            codexPath: "codex",
+            exec: true, // Use non-interactive mode by default for automation
+            json: true, // Enable structured output
+            experimentalJson: false,
+            fullAuto: true, // Auto-approve workspace changes
+            skipGitRepoCheck: false,
+            color: "auto",
+            search: true, // Enable web browsing
+            yolo: false,
+        };
+    }
+}
+//# sourceMappingURL=codex-adapter.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex-config-builder.d.ts","sourceRoot":"","sources":["../../../src/execution/adapters/codex-config-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAoGnE"}