@travisennis/acai 0.0.6 → 0.0.8

package/dist/config.js

@@ -1,9 +1,28 @@
-import { mkdirSync } from "node:fs";
+import { existsSync, mkdirSync } from "node:fs";
 import fs from "node:fs/promises";
 import { homedir } from "node:os";
 import path from "node:path";
 import { z } from "zod";
 import { jsonParser } from "./parsing.js";
+export const defaultConfig = {
+    loop: {
+        maxIterations: 200,
+    },
+    tools: {
+        activeTools: undefined,
+        maxTokens: 30000,
+        maxResults: 30,
+        dynamicTools: {
+            enabled: true,
+            maxTools: 10,
+        },
+    },
+    notify: true,
+    readOnlyFiles: [],
+    skills: {
+        enabled: true,
+    },
+};
 // Type definitions
 const ProjectConfigSchema = z.object({
     logs: z
@@ -13,41 +32,40 @@ const ProjectConfigSchema = z.object({
         .optional(),
     loop: z
         .object({
-        maxIterations: z.number().default(90),
-        parallelTools: z.boolean().default(true),
-        maxDurationMs: z.number().default(0),
+        maxIterations: z.number().default(defaultConfig.loop.maxIterations),
     })
         .optional()
-        .default({
-        maxIterations: 90,
-        parallelTools: true,
-        maxDurationMs: 0,
-    }),
+        .default(defaultConfig.loop),
     tools: z
         .object({
-        maxTokens: z.number().default(30000),
-        maxResults: z.number().default(30),
+        activeTools: z.array(z.string()).optional(),
+        maxTokens: z.number().default(defaultConfig.tools.maxTokens),
+        maxResults: z.number().default(defaultConfig.tools.maxResults),
         dynamicTools: z
             .object({
-            enabled: z.boolean().default(true),
-            maxTools: z.number().default(10),
+            enabled: z
+                .boolean()
+                .default(defaultConfig.tools.dynamicTools.enabled),
+            maxTools: z
+                .number()
+                .default(defaultConfig.tools.dynamicTools.maxTools),
         })
             .optional()
-            .default({
-            enabled: true,
-            maxTools: 10,
-        }),
+            .default(defaultConfig.tools.dynamicTools),
     })
         .optional()
-        .default({
-        maxTokens: 30000,
-        maxResults: 30,
-        dynamicTools: {
-            enabled: true,
-            maxTools: 10,
-        },
-    }),
-    notify: z.boolean().optional().default(true),
+        .default(defaultConfig.tools),
+    notify: z.boolean().optional().default(defaultConfig.notify),
+    readOnlyFiles: z
+        .array(z.string())
+        .optional()
+        .default(defaultConfig.readOnlyFiles),
+    skills: z
+        .object({
+        enabled: z.boolean().optional().default(defaultConfig.skills.enabled),
+    })
+        .optional()
+        .default(defaultConfig.skills),
 });
 export class DirectoryProvider {
     baseDir;
@@ -69,6 +87,22 @@ export class DirectoryProvider {
         mkdirSync(dirPath, { recursive: true });
         return dirPath;
     }
+    // Check if directory exists without creating it
+    async exists(subdir) {
+        const dirPath = this.getPath(subdir);
+        try {
+            await fs.access(dirPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Synchronous version of exists check
+    existsSync(subdir) {
+        const dirPath = this.getPath(subdir);
+        return existsSync(dirPath);
+    }
 }
 export class ConfigManager {
     project;
@@ -89,8 +123,8 @@ export class ConfigManager {
             throw error;
         }
     }
-    // Project config helpers
-    async readProjectConfig() {
+    // Get merged configuration (project overrides app)
+    async getConfig() {
         const appConfigPath = path.join(this.app.getPath(), "acai.json");
         const projectConfigPath = path.join(this.project.getPath(), "acai.json");
         const appConfig = await this._readConfig(appConfigPath);
@@ -101,17 +135,55 @@ export class ConfigManager {
         };
         return ProjectConfigSchema.parse(mergedConfig);
     }
-    async readAgentsFile() {
-        const agentsPath = path.join(process.cwd(), "AGENTS.md");
+    // Skills settings helpers
+    async getSkillsEnabled() {
+        const projectConfig = await this.getConfig();
+        return projectConfig.skills?.enabled ?? true;
+    }
+    async setSkillsEnabled(enabled) {
+        const configPath = path.join(this.app.getPath(), "acai.json");
+        let configData = {};
         try {
-            return await fs.readFile(agentsPath, "utf8");
+            const data = await fs.readFile(configPath, "utf8");
+            configData = jsonParser(ProjectConfigSchema.partial()).parse(data);
         }
         catch (error) {
-            if (error.code === "ENOENT") {
-                return "";
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        if (!configData.skills) {
+            configData.skills = { enabled: true };
+        }
+        configData.skills.enabled = enabled;
+        await this.app.ensurePath();
+        await fs.writeFile(configPath, JSON.stringify(configData, null, 2));
+    }
+    async readAgentsFiles() {
+        const files = [];
+        const agentsPaths = [
+            {
+                absolute: path.join(this.app.getPath(), "AGENTS.md"),
+                relative: "~/.acai/AGENTS.md",
+            },
+            {
+                absolute: path.join(process.cwd(), "AGENTS.md"),
+                relative: "./AGENTS.md",
+            },
+        ];
+        for (const { absolute, relative } of agentsPaths) {
+            try {
+                const content = await fs.readFile(absolute, "utf8");
+                files.push({
+                    path: relative,
+                    content,
+                });
+            }
+            catch (_error) {
+                // ignore
             }
-            throw error;
         }
+        return files;
     }
     async writeAgentsFile(rules) {
         const agentsPath = path.join(process.cwd(), "AGENTS.md");
@@ -139,6 +211,10 @@ export class ConfigManager {
         }
     }
     async writeProjectLearnedRulesFile(rules) {
+        // Only write project rules if the project directory exists
+        if (!(await this.project.exists())) {
+            return; // Silently return if project directory doesn't exist
+        }
         const rulesDir = await this.project.ensurePath("rules");
         const rulesPath = path.join(rulesDir, "learned-rules.md");
         try {
@@ -177,50 +253,32 @@ export class ConfigManager {
             throw error;
         }
     }
-    // App config helpers
-    async readAppConfig(configName) {
+    // Private helper for reading app config
+    async _readAppConfig(configName) {
         const configPath = path.join(this.app.getPath(), `${configName}.json`);
         try {
             const data = await fs.readFile(configPath, "utf8");
-            return JSON.parse(data);
+            return ProjectConfigSchema.parse(JSON.parse(data));
         }
         catch (error) {
             if (error.code === "ENOENT") {
-                return {};
+                return ProjectConfigSchema.parse(defaultConfig);
             }
             throw error;
         }
     }
-    async ensureAppConfig(configName) {
+    // Ensure default app configuration exists
+    async ensureDefaultConfig(configName) {
         const configPath = path.join(this.app.getPath(), `${configName}.json`);
         try {
             await fs.access(configPath);
-            return await this.readAppConfig(configName);
+            return await this._readAppConfig(configName);
         }
         catch {
             // Create directory and default config if missing
             await this.app.ensurePath();
-            const defaultConfig = {
-                logs: {
-                    path: path.join(this.app.getPath(), "logs", "current.log"),
-                },
-                loop: {
-                    maxIterations: 90,
-                    parallelTools: true,
-                    maxDurationMs: 0,
-                },
-                tools: {
-                    maxTokens: 30000,
-                    maxResults: 30,
-                    dynamicTools: {
-                        enabled: true,
-                        maxTools: 10,
-                    },
-                },
-                notify: true,
-            };
             await fs.writeFile(configPath, JSON.stringify(defaultConfig, null, 2));
-            return defaultConfig;
+            return ProjectConfigSchema.parse(defaultConfig);
         }
     }
     async writeAppConfig(configName, data) {

package/dist/dedent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dedent.d.ts","sourceRoot":"","sources":["../source/dedent.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;AAI9E,eAAO,MAAM,MAAM,EAAE,MAgDpB,CAAC"}
+{"version":3,"file":"dedent.d.ts","sourceRoot":"","sources":["../source/dedent.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;AAI9E,eAAO,MAAM,MAAM,EAAE,MA+CpB,CAAC"}

package/dist/dedent.js

@@ -3,13 +3,13 @@ export const dedent = (strings, ...values) => {
     // Perform interpolation
     let result = "";
     for (let i = 0; i < strings.raw.length; i++) {
-        const next = strings.raw[i] ??
-            ""
-                // handle escaped newlines, backticks, and interpolation characters
-                .replace(/\\\n[ \t]*/g, "")
-                .replace(/\\`/g, "`")
-                .replace(/\\\$/g, "$")
-                .replace(/\\\{/g, "{");
+        const raw = strings.raw[i] ?? "";
+        // handle escaped newlines, backticks, and interpolation characters
+        const next = raw
+            .replace(/\\\n[ \t]*/g, "")
+            .replace(/\\`/g, "`")
+            .replace(/\\\$/g, "$")
+            .replace(/\\\{/g, "{");
         result += next;
         if (i < values.length) {
             result += values[i];

package/dist/execution/index.d.ts

@@ -37,17 +37,26 @@ interface BackgroundProcessOptions extends ExecutionOptions {
     onExit?: (code: number | null) => void;
 }
 /**
- * Background process handle
+ * Background process handle (public interface)
  */
 interface BackgroundProcess {
     pid: number;
     kill: () => boolean;
     isRunning: boolean;
 }
+/**
+ * Tracked background process with project information
+ */
+interface TrackedBackgroundProcess extends BackgroundProcess {
+    originalCwd: string;
+    startTime: Date;
+    command: string;
+}
 /**
  * Execution environment manager
  */
 interface ExecutionConfig {
+    /** Value for NODE_ENV environment variable (defaults to "production") */
     env?: string;
     execution?: {
         cwd?: string;
@@ -78,6 +87,14 @@ export declare class ExecutionEnvironment {
      * Execute a command in the background
      */
     executeCommandInBackground(command: string, options?: BackgroundProcessOptions): BackgroundProcess;
+    /**
+     * Get background processes for a specific project directory
+     */
+    getBackgroundProcessesForProject(projectRoot: string): TrackedBackgroundProcess[];
+    /**
+     * Kill all background processes for a specific project directory
+     */
+    killBackgroundProcessesForProject(projectRoot: string): void;
     /**
      * Kill all running background processes
      */
@@ -107,6 +124,5 @@ export declare class ExecutionEnvironment {
  * Initialize the execution environment
  */
 export declare function initExecutionEnvironment(config?: ExecutionConfig): Promise<ExecutionEnvironment>;
-export declare function setupProcessCleanup(executionEnv: ExecutionEnvironment): void;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/execution/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/execution/index.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mGAAmG;IACnG,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,wBAAyB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,wBAAyB,SAAQ,iBAAiB;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAwBD;;GAEG;AACH,UAAU,eAAe;IACvB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE;QACV,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;KAC1C,CAAC;CACH;AAwBD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,mBAAmB,CACf;IACZ,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAyB;IAErD;;OAEG;gBACS,MAAM,GAAE,eAAoB;IAyBxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAqK3B;;OAEG;IACH,0BAA0B,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,wBAA6B,GACrC,iBAAiB;IAyJpB;;OAEG;IACH,gCAAgC,CAC9B,WAAW,EAAE,MAAM,GAClB,wBAAwB,EAAE;IAa7B;;OAEG;IACH,iCAAiC,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAgB5D;;OAEG;IACH,0BAA0B,IAAI,IAAI;IAgBlC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAgCtC;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK5C;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzD;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGzD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}

package/dist/execution/index.js

@@ -56,9 +56,10 @@ export class ExecutionEnvironment {
     constructor(config = {}) {
         this.config = config;
         this.workingDirectory = config.execution?.cwd || process.cwd();
-        // Set up environment variables
+        // Set up environment variables - filter out undefined values from process.env
+        const filteredEnv = Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined));
         this.environmentVariables = {
-            ...process.env,
+            ...filteredEnv,
             // biome-ignore lint/style/useNamingConvention: environment variable.
             NODE_ENV: config.env || "production",
             ...(config.execution?.env || {}),
@@ -130,6 +131,23 @@ export class ExecutionEnvironment {
                 });
                 return;
             }
+            let settled = false;
+            let abortHandler;
+            const settle = (result, shouldReject, error) => {
+                if (settled)
+                    return;
+                settled = true;
+                // Clean up abort listener
+                if (abortHandler) {
+                    options.abortSignal?.removeEventListener("abort", abortHandler);
+                }
+                if (shouldReject && error) {
+                    reject(error);
+                }
+                else {
+                    resolve(result);
+                }
+            };
             const childProcess = exec(command, {
                 cwd,
                 env,
@@ -145,65 +163,50 @@ export class ExecutionEnvironment {
                     ? `${stdout}${stderr ? stderr : ""}`
                     : stdout;
                 if (error) {
+                    const exitCode = error.code ?? 1;
                     logger.error({
                         error: error.message,
-                        exitCode: error.code,
+                        exitCode,
                         duration,
                     }, `Command execution failed: ${command}`);
-                    const result = {
+                    settle({
                         output: preserveOutputOnError ? output : "",
-                        exitCode: error.code || 1,
+                        exitCode,
                         error,
                         command,
                         duration,
-                    };
-                    if (throwOnError) {
-                        reject(error);
-                    }
-                    else {
-                        resolve(result);
-                    }
+                    }, throwOnError, error);
                 }
                 else {
                     logger.debug({
                         duration,
                         outputLength: output.length,
                     }, `Command executed successfully: ${command}`);
-                    resolve({
+                    settle({
                         output,
                         exitCode: 0,
                         command,
                         duration,
-                    });
+                    }, false);
                 }
             });
             // Handle abort signal
             if (options.abortSignal) {
-                const abortHandler = () => {
+                abortHandler = () => {
                     logger.warn({ command, pid: childProcess.pid }, "Command execution aborted");
                     childProcess.kill("SIGTERM");
                     const error = new Error("Command execution aborted");
-                    const result = {
-                        output: preserveOutputOnError ? "" : "",
+                    settle({
+                        output: "",
                         exitCode: 1,
                         error,
                         command,
                         duration: Date.now() - startTime,
-                    };
-                    if (throwOnError) {
-                        reject(error);
-                    }
-                    else {
-                        resolve(result);
-                    }
+                    }, throwOnError, error);
                 };
                 options.abortSignal.addEventListener("abort", abortHandler, {
                     once: true,
                 });
-                // Clean up abort listener when process completes
-                childProcess.on("exit", () => {
-                    options.abortSignal?.removeEventListener("abort", abortHandler);
-                });
             }
         });
     }
@@ -211,28 +214,40 @@ export class ExecutionEnvironment {
      * Execute a command in the background
      */
     executeCommandInBackground(command, options = {}) {
+        const cwd = options.cwd || this.workingDirectory;
+        // Create the tracked process first
+        const trackedProcess = {
+            pid: -1, // Will be set after spawn
+            kill: () => false, // Will be set after spawn
+            isRunning: true,
+            originalCwd: cwd,
+            startTime: new Date(),
+            command,
+        };
         // Validate command for safety
         this.validateCommand(command);
-        const cwd = options.cwd || this.workingDirectory;
         const env = {
             ...this.environmentVariables,
             ...ttySizeEnv(),
             ...(options.env || {}),
         };
-        const shell = options.shell ||
-            this.config.execution?.shell ||
-            process.env["SHELL"] ||
-            "bash";
+        const shell = options.shell || this.config.execution?.shell || getShell();
         logger.debug({
             command,
             cwd,
             shell,
             hasAbortSignal: !!options.abortSignal,
         }, "Executing command in background");
-        // Check if already aborted
+        // Check if already aborted - return a dead process handle for consistency
         if (options.abortSignal?.aborted) {
             logger.warn({ command }, "Background command execution aborted before starting");
-            throw new Error("Background command execution aborted");
+            return {
+                pid: -1,
+                kill: () => false,
+                get isRunning() {
+                    return false;
+                },
+            };
         }
         // Spawn the process
         const childProcess = spawn(command, [], {
@@ -244,6 +259,25 @@ export class ExecutionEnvironment {
         });
         const pid = childProcess.pid ?? -1;
         let isRunning = true;
+        // Update tracked process with actual PID, isRunning getter, and kill function
+        trackedProcess.pid = pid;
+        Object.defineProperty(trackedProcess, "isRunning", {
+            get: () => isRunning,
+            enumerable: true,
+        });
+        trackedProcess.kill = () => {
+            if (isRunning) {
+                childProcess.kill();
+                isRunning = false;
+                this.backgroundProcesses.delete(pid);
+                // Clean up abort listener
+                if (abortHandler) {
+                    options.abortSignal?.removeEventListener("abort", abortHandler);
+                }
+                return true;
+            }
+            return false;
+        };
         // Set up output handlers
         if (childProcess.stdout) {
             childProcess.stdout.on("data", (data) => {
@@ -292,28 +326,46 @@ export class ExecutionEnvironment {
                 once: true,
             });
         }
-        // Create the process handle
+        // Create the public process handle with getter for live isRunning state
         const backgroundProcess = {
             pid,
-            kill: () => {
-                if (isRunning) {
-                    childProcess.kill();
-                    isRunning = false;
-                    this.backgroundProcesses.delete(pid);
-                    // Clean up abort listener
-                    if (abortHandler) {
-                        options.abortSignal?.removeEventListener("abort", abortHandler);
-                    }
-                    return true;
-                }
-                return false;
+            kill: trackedProcess.kill,
+            get isRunning() {
+                return isRunning;
             },
-            isRunning: true,
         };
         // Track the process
-        this.backgroundProcesses.set(pid, backgroundProcess);
+        this.backgroundProcesses.set(pid, trackedProcess);
         return backgroundProcess;
     }
+    /**
+     * Get background processes for a specific project directory
+     */
+    getBackgroundProcessesForProject(projectRoot) {
+        const processes = [];
+        for (const process of this.backgroundProcesses.values()) {
+            // Check if process was started in or under the project root
+            if (process.originalCwd.startsWith(projectRoot)) {
+                processes.push(process);
+            }
+        }
+        return processes;
+    }
+    /**
+     * Kill all background processes for a specific project directory
+     */
+    killBackgroundProcessesForProject(projectRoot) {
+        const processes = this.getBackgroundProcessesForProject(projectRoot);
+        logger.info(`Killing ${processes.length} background processes for project: ${projectRoot}`);
+        for (const process of processes) {
+            try {
+                process.kill();
+            }
+            catch (error) {
+                logger.warn(error, `Failed to kill process ${process.pid}`);
+            }
+        }
+    }
     /**
      * Kill all running background processes
      */
@@ -388,45 +440,31 @@ export async function initExecutionEnvironment(config = {}) {
     try {
         const executionEnv = new ExecutionEnvironment(config);
         await executionEnv.initialize();
+        // Set up cleanup for background processes
+        setupProcessCleanup(executionEnv);
         logger.info("Execution environment initialized successfully");
         return executionEnv;
     }
     catch (error) {
         logger.error(error, "Failed to initialize execution environment");
         // Return a minimal execution environment even if initialization failed
-        return new ExecutionEnvironment(config);
+        const executionEnv = new ExecutionEnvironment(config);
+        setupProcessCleanup(executionEnv);
+        return executionEnv;
     }
 }
-// const platformName = process.platform;
-// let cmd: string;
-// let args: string[] = [];
-// const useShellOption = false;
-// if (platformName === "win32") {
-//   const { execSync } = await import("node:child_process");
-//   try {
-//     execSync("where wsl", { stdio: "ignore" });
-//     cmd = "wsl.exe";
-//     args = ["--", command];
-//   } catch {
-//     cmd = "powershell.exe";
-//     args = ["-NoProfile", "-NonInteractive", "-Command", command];
-//   }
-// } else {
-//   const shell = process.env["SHELL"] || "/bin/bash";
-//   cmd = shell;
-//   args = ["-c", command];
-// }
+// Track registered execution environments for cleanup
+const registeredForCleanup = new WeakSet();
 // Set up cleanup on process exit
-export function setupProcessCleanup(executionEnv) {
-    process.on("exit", () => {
-        executionEnv.killAllBackgroundProcesses();
-    });
-    process.on("SIGINT", () => {
-        executionEnv.killAllBackgroundProcesses();
-        process.exit(0);
-    });
-    process.on("SIGTERM", () => {
+function setupProcessCleanup(executionEnv) {
+    if (registeredForCleanup.has(executionEnv)) {
+        return;
+    }
+    registeredForCleanup.add(executionEnv);
+    const cleanup = () => {
         executionEnv.killAllBackgroundProcesses();
-        process.exit(0);
-    });
+    };
+    process.on("exit", cleanup);
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
 }