isol8 0.4.2 → 0.5.0

package/dist/index.js

@@ -146,7 +146,8 @@ var DEFAULT_CONFIG = {
     autoPrune: true,
     maxContainerAgeMs: 3600000
   },
-  dependencies: {}
+  dependencies: {},
+  debug: false
 };
 function loadConfig(cwd) {
   const searchPaths = [
@@ -180,7 +181,8 @@ function mergeConfig(defaults, overrides) {
     dependencies: {
       ...defaults.dependencies,
       ...overrides.dependencies
-    }
+    },
+    debug: overrides.debug ?? defaults.debug
   };
 }
 // src/engine/docker.ts
@@ -192,9 +194,12 @@ import Docker from "dockerode";
 var adapters = new Map;
 var extensionMap = new Map;
 var RuntimeRegistry = {
-  register(adapter) {
+  register(adapter, aliases = []) {
     adapters.set(adapter.name, adapter);
     extensionMap.set(adapter.getFileExtension(), adapter);
+    for (const ext of aliases) {
+      extensionMap.set(ext, adapter);
+    }
   },
   get(name) {
     const adapter = adapters.get(name);
@@ -280,7 +285,7 @@ var NodeAdapter = {
     return ["node", "-e", code];
   },
   getFileExtension() {
-    return ".js";
+    return ".mjs";
   }
 };
 
@@ -301,11 +306,34 @@ var PythonAdapter = {
 
 // src/runtime/index.ts
 RuntimeRegistry.register(PythonAdapter);
-RuntimeRegistry.register(NodeAdapter);
+RuntimeRegistry.register(NodeAdapter, [".js", ".cjs"]);
 RuntimeRegistry.register(BunAdapter);
 RuntimeRegistry.register(bashAdapter);
 RuntimeRegistry.register(DenoAdapter);
 
+// src/utils/logger.ts
+class Logger {
+  debugMode = false;
+  setDebug(enabled) {
+    this.debugMode = enabled;
+  }
+  debug(...args) {
+    if (this.debugMode) {
+      console.log("[DEBUG]", ...args);
+    }
+  }
+  info(...args) {
+    console.log(...args);
+  }
+  warn(...args) {
+    console.warn("[WARN]", ...args);
+  }
+  error(...args) {
+    console.error("[ERROR]", ...args);
+  }
+}
+var logger = new Logger;
+
 // src/engine/concurrency.ts
 class Semaphore {
   max;
@@ -414,26 +442,32 @@ class ContainerPool {
       ...this.createOptions,
       Image: image
     });
+    logger.debug(`[Pool] Container ${container.id} created for image: ${image}`);
     await container.start();
+    logger.debug(`[Pool] Container ${container.id} started`);
     return container;
   }
   replenish(image) {
     if (this.replenishing.has(image)) {
+      logger.debug(`[Pool] Replenishment for ${image} already in progress`);
       return;
     }
     this.replenishing.add(image);
+    logger.debug(`[Pool] Starting background replenishment for image: ${image}`);
     const promise = this.createContainer(image).then((container) => {
       const pool = this.pools.get(image) ?? [];
       if (pool.length < this.poolSize) {
         pool.push({ container, createdAt: Date.now() });
         this.pools.set(image, pool);
+        logger.debug(`[Pool] Replenished container ${container.id} added to pool for ${image}. Pool size: ${pool.length}`);
       } else {
+        logger.debug(`[Pool] Replenished container ${container.id} not needed (pool for ${image} is full), destroying`);
         container.remove({ force: true }).catch((err) => {
-          console.error(`[Pool] Error destroying unneeded replenished container ${container.id}:`, err);
+          logger.error(`[Pool] Error destroying unneeded replenished container ${container.id}:`, err);
         });
       }
     }).catch((err) => {
-      console.error(`[Pool] Error during replenishment for ${image}:`, err);
+      logger.error(`[Pool] Error during replenishment for ${image}:`, err);
     }).finally(() => {
       this.replenishing.delete(image);
       this.pendingReplenishments.delete(promise);
@@ -632,7 +666,7 @@ function getInstallCommand(runtime, packages) {
 }
 async function installPackages(container, runtime, packages) {
   const cmd = getInstallCommand(runtime, packages);
-  console.error(`[DEBUG] Installing packages: ${JSON.stringify(cmd)}`);
+  logger.debug(`Installing packages: ${JSON.stringify(cmd)}`);
   const env = [
     "PATH=/sandbox/.local/bin:/sandbox/.npm-global/bin:/sandbox/.bun-global/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin"
   ];
@@ -696,6 +730,7 @@ class DockerIsol8 {
   semaphore;
   sandboxSize;
   tmpSize;
+  persist;
   container = null;
   persistentRuntime = null;
   pool = null;
@@ -715,6 +750,10 @@ class DockerIsol8 {
     this.semaphore = new Semaphore(maxConcurrent);
     this.sandboxSize = options.sandboxSize ?? "512m";
     this.tmpSize = options.tmpSize ?? "256m";
+    this.persist = options.persist ?? false;
+    if (options.debug) {
+      logger.setDebug(true);
+    }
   }
   async start() {}
   async stop() {
@@ -790,7 +829,8 @@ class DockerIsol8 {
         if (this.network === "filtered") {
           await startProxy(container, this.networkFilter);
         }
-        const filePath = `${SANDBOX_WORKDIR}/main${adapter.getFileExtension()}`;
+        const ext = req.fileExtension ?? adapter.getFileExtension();
+        const filePath = `${SANDBOX_WORKDIR}/main${ext}`;
         await writeFileViaExec(container, filePath, req.code);
         if (req.installPackages?.length) {
           await installPackages(container, req.runtime, req.installPackages);
@@ -821,9 +861,13 @@ class DockerIsol8 {
         const execStream = await exec.start({ Tty: false });
         yield* this.streamExecOutput(execStream, exec, container, timeoutMs);
       } finally {
-        try {
-          await container.remove({ force: true });
-        } catch {}
+        if (this.persist) {
+          logger.debug(`[Persist] Leaving container running for inspection: ${container.id}`);
+        } else {
+          try {
+            await container.remove({ force: true });
+          } catch {}
+        }
       }
     } finally {
       this.semaphore.release();
@@ -864,7 +908,8 @@ class DockerIsol8 {
       if (this.network === "filtered") {
         await startProxy(container, this.networkFilter);
       }
-      const filePath = `${SANDBOX_WORKDIR}/main${adapter.getFileExtension()}`;
+      const ext = req.fileExtension ?? adapter.getFileExtension();
+      const filePath = `${SANDBOX_WORKDIR}/main${ext}`;
       await writeFileViaExec(container, filePath, req.code);
       if (req.installPackages?.length) {
         await installPackages(container, req.runtime, req.installPackages);
@@ -910,7 +955,11 @@ class DockerIsol8 {
         ...req.outputPaths ? { files: await this.retrieveFiles(container, req.outputPaths) } : {}
       };
     } finally {
-      await this.pool.release(container, image);
+      if (this.persist) {
+        logger.debug(`[Persist] Leaving container running for inspection: ${container.id}`);
+      } else {
+        await this.pool.release(container, image);
+      }
     }
   }
   async executePersistent(req) {
@@ -921,7 +970,8 @@ class DockerIsol8 {
     } else if (this.persistentRuntime?.name !== adapter.name) {
       throw new Error(`Cannot switch runtime from "${this.persistentRuntime?.name}" to "${adapter.name}". Each persistent container supports a single runtime. Create a new Isol8 instance for a different runtime.`);
     }
-    const filePath = `${SANDBOX_WORKDIR}/exec_${Date.now()}${adapter.getFileExtension()}`;
+    const ext = req.fileExtension ?? adapter.getFileExtension();
+    const filePath = `${SANDBOX_WORKDIR}/exec_${Date.now()}${ext}`;
     if (this.readonlyRootFs) {
       await writeFileViaExec(this.container, filePath, req.code);
     } else {
@@ -1383,7 +1433,7 @@ function createServer(options) {
 // package.json
 var package_default = {
   name: "isol8",
-  version: "0.4.1",
+  version: "0.4.3",
   description: "Secure code execution engine for AI agents",
   author: "Illusion47586",
   license: "MIT",
@@ -1501,4 +1551,4 @@ export {
   BunAdapter
 };
 
-//# debugId=B16E985AABF04C9E64756E2164756E21
+//# debugId=BFAE8F3A0F89B57E64756E2164756E21