browser-debugging-daemon 1.0.0

package/package.json

@@ -0,0 +1,66 @@
+{
+    "name": "browser-debugging-daemon",
+    "version": "1.0.0",
+    "description": "Playwright-based browser runtime for AI agents — SDK, HTTP daemon, and MCP server",
+    "type": "module",
+    "main": "./index.js",
+    "exports": {
+        ".": "./index.js",
+        "./runtime": "./runtime/BrowserRuntime.js",
+        "./subagent": "./subagent/BrowserSubagent.js",
+        "./orchestrator": "./orchestrator/TaskRunner.js",
+        "./shared": "./shared.js"
+    },
+    "bin": {
+        "browser-daemon": "./daemon.js",
+        "browser-mcp": "./mcp_server.js"
+    },
+    "files": [
+        "index.js",
+        "daemon.js",
+        "mcp_server.js",
+        "shared.js",
+        "runtime/",
+        "subagent/",
+        "orchestrator/",
+        "dashboard/"
+    ],
+    "keywords": [
+        "playwright",
+        "browser-automation",
+        "ai-agent",
+        "mcp",
+        "set-of-mark",
+        "subagent",
+        "browser-debugging",
+        "autonomous-agent"
+    ],
+    "license": "MIT",
+    "engines": {
+        "node": ">=18"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/JesstLe/browser-debugging-daemon"
+    },
+    "scripts": {
+        "check": "node --check index.js && node --check daemon.js && node --check mcp_server.js && node --check shared.js && node --check runtime/ArtifactStore.js && node --check runtime/BrowserRuntime.js && node --check subagent/OpenAIPlanner.js && node --check subagent/BrowserSubagent.js && node --check orchestrator/TaskRunStore.js && node --check orchestrator/RunTemplateStore.js && node --check orchestrator/TaskRunner.js && node --check dashboard/app.js && node --check examples/mock_delegate_demo.js && node --check examples/smoke_walkthrough_audit.js && node --check examples/smoke_run_recovery.js && node --check examples/smoke_run_templates.js && node --check examples/smoke_daemon_auth.js && node --check tooling/common.js && node --check tooling/generate_mcp_configs.js && node --check tooling/healthcheck.js && node --check tooling/start_ide_stack.js",
+        "smoke:mock": "node examples/mock_delegate_demo.js",
+        "smoke:walkthrough": "node examples/smoke_walkthrough_audit.js",
+        "smoke:recovery": "node examples/smoke_run_recovery.js",
+        "smoke:templates": "node examples/smoke_run_templates.js",
+        "smoke:auth": "node examples/smoke_daemon_auth.js",
+        "smoke:all": "npm run smoke:mock && npm run smoke:walkthrough && npm run smoke:recovery && npm run smoke:templates && npm run smoke:auth",
+        "ide:configs": "node tooling/generate_mcp_configs.js",
+        "ide:health": "node tooling/healthcheck.js",
+        "ide:bootstrap": "npm run ide:configs && npm run ide:health",
+        "ide:start": "node tooling/start_ide_stack.js",
+        "ide:vscode:check": "node --check ../integrations/vscode-extension/extension.cjs"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.27.1",
+        "cors": "^2.8.5",
+        "express": "^4.18.2",
+        "playwright": "^1.42.1"
+    }
+}

package/runtime/ArtifactStore.js

@@ -0,0 +1,202 @@
+import fs from "fs";
+import path from "path";
+
+const ARTIFACT_MAX_SESSIONS = Number.parseInt(process.env.BROWSER_ARTIFACT_MAX_SESSIONS, 10);
+const ARTIFACT_MAX_AGE_DAYS = Number.parseFloat(process.env.BROWSER_ARTIFACT_MAX_AGE_DAYS);
+
+function sanitizeSegment(value) {
+    return String(value)
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60) || "artifact";
+}
+
+export class ArtifactStore {
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+        this.rootDir = path.join(baseDir, "artifacts");
+        this.currentViewPath = path.join(baseDir, "current_view.png");
+        this.sessionId = null;
+        this.sessionDir = null;
+        this.screenshotsDir = null;
+        this.videosDir = null;
+        this.tracesDir = null;
+        this.eventsPath = null;
+        this.tracePath = null;
+        this.stepCounter = 0;
+        this.maxSessions = Number.isFinite(ARTIFACT_MAX_SESSIONS) && ARTIFACT_MAX_SESSIONS > 0
+            ? Math.floor(ARTIFACT_MAX_SESSIONS)
+            : null;
+        this.maxAgeMs = Number.isFinite(ARTIFACT_MAX_AGE_DAYS) && ARTIFACT_MAX_AGE_DAYS > 0
+            ? ARTIFACT_MAX_AGE_DAYS * 24 * 60 * 60 * 1000
+            : null;
+    }
+
+    startSession() {
+        this.cleanupRetainedSessions();
+        const sessionId = new Date().toISOString().replace(/[:.]/g, "-");
+        const sessionDir = path.join(this.rootDir, sessionId);
+
+        this.sessionId = sessionId;
+        this.sessionDir = sessionDir;
+        this.screenshotsDir = path.join(sessionDir, "screenshots");
+        this.videosDir = path.join(sessionDir, "videos");
+        this.tracesDir = path.join(sessionDir, "traces");
+        this.eventsPath = path.join(sessionDir, "events.jsonl");
+        this.tracePath = null;
+        this.stepCounter = 0;
+
+        fs.mkdirSync(this.screenshotsDir, { recursive: true });
+        fs.mkdirSync(this.videosDir, { recursive: true });
+        fs.mkdirSync(this.tracesDir, { recursive: true });
+    }
+
+    cleanupRetainedSessions() {
+        if (!fs.existsSync(this.rootDir)) {
+            return;
+        }
+
+        const entries = fs.readdirSync(this.rootDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => {
+                const sessionPath = path.join(this.rootDir, entry.name);
+                const stats = fs.statSync(sessionPath);
+                return {
+                    path: sessionPath,
+                    mtimeMs: stats.mtimeMs,
+                };
+            })
+            .sort((left, right) => right.mtimeMs - left.mtimeMs);
+
+        const now = Date.now();
+        const kept = [];
+        for (const entry of entries) {
+            const exceedsAge = this.maxAgeMs ? (now - entry.mtimeMs) > this.maxAgeMs : false;
+            const exceedsCount = this.maxSessions ? kept.length >= this.maxSessions : false;
+
+            if (exceedsAge || exceedsCount) {
+                fs.rmSync(entry.path, { recursive: true, force: true });
+                continue;
+            }
+
+            kept.push(entry);
+        }
+    }
+
+    ensureActiveSession() {
+        if (!this.sessionDir) {
+            throw new Error("Artifact session has not been initialized.");
+        }
+    }
+
+    getVideoDir() {
+        this.ensureActiveSession();
+        return this.videosDir;
+    }
+
+    getVideoPath(label = "video") {
+        this.ensureActiveSession();
+        return path.join(this.videosDir, `${sanitizeSegment(label)}_${Date.now()}.webm`);
+    }
+
+    getAttachedFramesDir(label = "attached-frames") {
+        this.ensureActiveSession();
+        const framesDir = path.join(this.videosDir, `${sanitizeSegment(label)}_${Date.now()}`);
+        fs.mkdirSync(framesDir, { recursive: true });
+        return framesDir;
+    }
+
+    getCurrentViewPath() {
+        return this.currentViewPath;
+    }
+
+    getStepScreenshotPath(label) {
+        this.ensureActiveSession();
+        this.stepCounter += 1;
+        const filename = `${String(this.stepCounter).padStart(3, "0")}_${sanitizeSegment(label)}.png`;
+        return path.join(this.screenshotsDir, filename);
+    }
+
+    getTracePath(label = "trace") {
+        this.ensureActiveSession();
+        this.tracePath = path.join(this.tracesDir, `${sanitizeSegment(label)}_${Date.now()}.zip`);
+        return this.tracePath;
+    }
+
+    getConsoleLogPath() {
+        this.ensureActiveSession();
+        return path.join(this.sessionDir, "console.json");
+    }
+
+    getNetworkLogPath() {
+        this.ensureActiveSession();
+        return path.join(this.sessionDir, "network.json");
+    }
+
+    getErrorLogPath() {
+        this.ensureActiveSession();
+        return path.join(this.sessionDir, "errors.json");
+    }
+
+    listTraceFiles() {
+        if (!this.tracesDir || !fs.existsSync(this.tracesDir)) {
+            return [];
+        }
+
+        return fs.readdirSync(this.tracesDir)
+            .filter((name) => name.endsWith(".zip"))
+            .map((name) => path.join(this.tracesDir, name))
+            .sort();
+    }
+
+    appendEvent(type, payload = {}) {
+        this.ensureActiveSession();
+        const entry = {
+            timestamp: new Date().toISOString(),
+            type,
+            payload,
+        };
+        fs.appendFileSync(this.eventsPath, `${JSON.stringify(entry)}\n`, "utf8");
+    }
+
+    writeJson(filename, data) {
+        this.ensureActiveSession();
+        const filePath = path.join(this.sessionDir, filename);
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf8");
+        return filePath;
+    }
+
+    writeText(filename, text) {
+        this.ensureActiveSession();
+        const filePath = path.join(this.sessionDir, filename);
+        fs.writeFileSync(filePath, text, "utf8");
+        return filePath;
+    }
+
+    listVideoFiles() {
+        if (!this.videosDir || !fs.existsSync(this.videosDir)) {
+            return [];
+        }
+
+        return fs.readdirSync(this.videosDir)
+            .filter((name) => name.endsWith(".webm"))
+            .map((name) => path.join(this.videosDir, name));
+    }
+
+    getSummary() {
+        return {
+            sessionId: this.sessionId,
+            sessionDir: this.sessionDir,
+            currentViewPath: this.currentViewPath,
+            screenshotsDir: this.screenshotsDir,
+            videosDir: this.videosDir,
+            videoFiles: this.listVideoFiles(),
+            tracesDir: this.tracesDir,
+            traceFiles: this.listTraceFiles(),
+            eventsPath: this.eventsPath,
+            tracePath: this.tracePath,
+        };
+    }
+}