@askjo/camoufox-browser 1.0.5 → 1.0.7

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@askjo/camoufox-browser",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Headless browser automation server and OpenClaw plugin for AI agents - anti-detection, element refs, and session isolation",
   "main": "server-camoufox.js",
   "license": "MIT",
-  "author": "Jo Inc <hello@askjo.ai>",
+  "author": "Jo Inc <oss@askjo.ai>",
   "homepage": "https://github.com/jo-inc/camoufox-browser#readme",
   "repository": {
     "type": "git",

package/plugin.ts

@@ -2,15 +2,28 @@
  * Camoufox Browser - OpenClaw Plugin
  *
  * Provides browser automation tools using the Camoufox anti-detection browser.
- * Run the server separately: npm start (or ./run-camoufox.sh -p PORT)
+ * Server auto-starts when plugin loads (configurable via autoStart: false).
  */
 
 import { spawn, ChildProcess } from "child_process";
-import { join } from "path";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+// Get plugin directory - works in both ESM and CJS contexts
+const getPluginDir = (): string => {
+  try {
+    // ESM context
+    return dirname(fileURLToPath(import.meta.url));
+  } catch {
+    // CJS context
+    return __dirname;
+  }
+};
 
 interface PluginConfig {
   url?: string;
   autoStart?: boolean;
+  port?: number;
 }
 
 interface ToolResult {
@@ -41,6 +54,67 @@ interface PluginApi {
 
 let serverProcess: ChildProcess | null = null;
 
+async function startServer(
+  pluginDir: string,
+  port: number,
+  log: PluginApi["log"]
+): Promise<ChildProcess> {
+  const serverPath = join(pluginDir, "server-camoufox.js");
+  const proc = spawn("node", [serverPath], {
+    cwd: pluginDir,
+    env: { ...process.env, PORT: String(port) },
+    stdio: ["ignore", "pipe", "pipe"],
+    detached: false,
+  });
+
+  proc.stdout?.on("data", (data: Buffer) => {
+    const msg = data.toString().trim();
+    if (msg) log.info(`[server] ${msg}`);
+  });
+
+  proc.stderr?.on("data", (data: Buffer) => {
+    const msg = data.toString().trim();
+    if (msg) log.error(`[server] ${msg}`);
+  });
+
+  proc.on("error", (err) => {
+    log.error(`Server process error: ${err.message}`);
+    serverProcess = null;
+  });
+
+  proc.on("exit", (code) => {
+    if (code !== 0 && code !== null) {
+      log.error(`Server exited with code ${code}`);
+    }
+    serverProcess = null;
+  });
+
+  // Wait for server to be ready
+  const baseUrl = `http://localhost:${port}`;
+  for (let i = 0; i < 30; i++) {
+    await new Promise((r) => setTimeout(r, 500));
+    try {
+      const res = await fetch(`${baseUrl}/health`);
+      if (res.ok) {
+        log.info(`Camoufox server ready on port ${port}`);
+        return proc;
+      }
+    } catch {
+      // Server not ready yet
+    }
+  }
+  throw new Error("Server failed to start within 15 seconds");
+}
+
+async function checkServerRunning(baseUrl: string): Promise<boolean> {
+  try {
+    const res = await fetch(`${baseUrl}/health`);
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
 async function fetchApi(
   baseUrl: string,
   path: string,
@@ -68,7 +142,26 @@ function toToolResult(data: unknown): ToolResult {
 }
 
 export default function register(api: PluginApi) {
-  const baseUrl = api.config.url || "http://localhost:9377";
+  const port = api.config.port || 9377;
+  const baseUrl = api.config.url || `http://localhost:${port}`;
+  const autoStart = api.config.autoStart !== false; // default true
+  const pluginDir = getPluginDir();
+
+  // Auto-start server if configured (default: true)
+  if (autoStart) {
+    (async () => {
+      const alreadyRunning = await checkServerRunning(baseUrl);
+      if (alreadyRunning) {
+        api.log.info(`Camoufox server already running at ${baseUrl}`);
+      } else {
+        try {
+          serverProcess = await startServer(pluginDir, port, api.log);
+        } catch (err) {
+          api.log.error(`Failed to auto-start server: ${(err as Error).message}`);
+        }
+      }
+    })();
+  }
 
   api.registerTool(
     {
@@ -317,22 +410,24 @@ export default function register(api: PluginApi) {
           try {
             const health = await fetchApi(baseUrl, "/health");
             api.log.info(`Camoufox server at ${baseUrl}: ${JSON.stringify(health)}`);
-          } catch (e) {
+          } catch {
             api.log.error(`Camoufox server at ${baseUrl}: not reachable`);
           }
           break;
         case "start":
           if (serverProcess) {
-            api.log.info("Camoufox server already running");
+            api.log.info("Camoufox server already running (managed)");
+            return;
+          }
+          if (await checkServerRunning(baseUrl)) {
+            api.log.info(`Camoufox server already running at ${baseUrl}`);
             return;
           }
-          const pluginDir = __dirname;
-          serverProcess = spawn("npm", ["start"], {
-            cwd: pluginDir,
-            stdio: "inherit",
-            detached: true,
-          });
-          api.log.info(`Started camoufox-browser server (pid: ${serverProcess.pid})`);
+          try {
+            serverProcess = await startServer(pluginDir, port, api.log);
+          } catch (err) {
+            api.log.error(`Failed to start server: ${(err as Error).message}`);
+          }
           break;
         case "stop":
           if (serverProcess) {