@hasna/browser 0.4.10 → 0.4.12

package/dist/index.js

@@ -9888,6 +9888,94 @@ var init_schema = __esm(() => {
   init_dist();
 });
 
+// src/lib/dialogs.ts
+var exports_dialogs = {};
+__export(exports_dialogs, {
+  setupDialogHandler: () => setupDialogHandler,
+  handleDialog: () => handleDialog,
+  getDialogs: () => getDialogs,
+  clearDialogs: () => clearDialogs
+});
+function setupDialogHandler(page, sessionId) {
+  const onDialog = (dialog) => {
+    const info = {
+      type: dialog.type(),
+      message: dialog.message(),
+      default_value: dialog.defaultValue(),
+      timestamp: new Date().toISOString()
+    };
+    const autoTimer = setTimeout(() => {
+      try {
+        dialog.dismiss().catch(() => {});
+      } catch {}
+      const list = pendingDialogs.get(sessionId);
+      if (list) {
+        const idx = list.findIndex((p) => p.dialog === dialog);
+        if (idx >= 0)
+          list.splice(idx, 1);
+        if (list.length === 0)
+          pendingDialogs.delete(sessionId);
+      }
+    }, AUTO_DISMISS_MS);
+    const pending = { dialog, info, autoTimer };
+    if (!pendingDialogs.has(sessionId)) {
+      pendingDialogs.set(sessionId, []);
+    }
+    pendingDialogs.get(sessionId).push(pending);
+  };
+  page.on("dialog", onDialog);
+  return () => {
+    page.off("dialog", onDialog);
+    const list = pendingDialogs.get(sessionId);
+    if (list) {
+      for (const p of list)
+        clearTimeout(p.autoTimer);
+      pendingDialogs.delete(sessionId);
+    }
+  };
+}
+function getDialogs(sessionId) {
+  const list = pendingDialogs.get(sessionId);
+  if (!list)
+    return [];
+  return list.map((p) => p.info);
+}
+async function handleDialog(sessionId, action, promptText) {
+  const list = pendingDialogs.get(sessionId);
+  if (!list || list.length === 0) {
+    return { handled: false };
+  }
+  const pending = list.shift();
+  clearTimeout(pending.autoTimer);
+  if (list.length === 0) {
+    pendingDialogs.delete(sessionId);
+  }
+  try {
+    if (action === "accept") {
+      await pending.dialog.accept(promptText);
+    } else {
+      await pending.dialog.dismiss();
+    }
+  } catch {}
+  return { handled: true, dialog: pending.info };
+}
+function clearDialogs(sessionId) {
+  const list = pendingDialogs.get(sessionId);
+  if (list) {
+    for (const p of list) {
+      clearTimeout(p.autoTimer);
+      try {
+        p.dialog.dismiss().catch(() => {});
+      } catch {}
+    }
+    pendingDialogs.delete(sessionId);
+  }
+}
+var pendingDialogs, AUTO_DISMISS_MS = 5000;
+var init_dialogs = __esm(() => {
+  pendingDialogs = new Map;
+});
+
 // src/engines/cdp.ts
 var exports_cdp = {};
 __export(exports_cdp, {
@@ -9895,9 +9983,9 @@ __export(exports_cdp, {
   CDPClient: () => CDPClient
 });
 async function connectToExistingBrowser(cdpUrl) {
-  const { chromium: chromium2 } = await import("playwright");
+  const { chromium: chromium3 } = await import("playwright");
   try {
-    return await chromium2.connectOverCDP(cdpUrl);
+    return await chromium3.connectOverCDP(cdpUrl);
   } catch (err) {
     throw new BrowserError(`Failed to connect to browser at ${cdpUrl}: ${err instanceof Error ? err.message : String(err)}. Start Chrome with: google-chrome --remote-debugging-port=9222`, "CDP_CONNECT_FAILED", true);
   }
@@ -10014,94 +10102,6 @@ var init_cdp = __esm(() => {
   init_types();
 });
 
-// src/lib/dialogs.ts
-var exports_dialogs = {};
-__export(exports_dialogs, {
-  setupDialogHandler: () => setupDialogHandler,
-  handleDialog: () => handleDialog,
-  getDialogs: () => getDialogs,
-  clearDialogs: () => clearDialogs
-});
-function setupDialogHandler(page, sessionId) {
-  const onDialog = (dialog) => {
-    const info = {
-      type: dialog.type(),
-      message: dialog.message(),
-      default_value: dialog.defaultValue(),
-      timestamp: new Date().toISOString()
-    };
-    const autoTimer = setTimeout(() => {
-      try {
-        dialog.dismiss().catch(() => {});
-      } catch {}
-      const list = pendingDialogs.get(sessionId);
-      if (list) {
-        const idx = list.findIndex((p) => p.dialog === dialog);
-        if (idx >= 0)
-          list.splice(idx, 1);
-        if (list.length === 0)
-          pendingDialogs.delete(sessionId);
-      }
-    }, AUTO_DISMISS_MS);
-    const pending = { dialog, info, autoTimer };
-    if (!pendingDialogs.has(sessionId)) {
-      pendingDialogs.set(sessionId, []);
-    }
-    pendingDialogs.get(sessionId).push(pending);
-  };
-  page.on("dialog", onDialog);
-  return () => {
-    page.off("dialog", onDialog);
-    const list = pendingDialogs.get(sessionId);
-    if (list) {
-      for (const p of list)
-        clearTimeout(p.autoTimer);
-      pendingDialogs.delete(sessionId);
-    }
-  };
-}
-function getDialogs(sessionId) {
-  const list = pendingDialogs.get(sessionId);
-  if (!list)
-    return [];
-  return list.map((p) => p.info);
-}
-async function handleDialog(sessionId, action, promptText) {
-  const list = pendingDialogs.get(sessionId);
-  if (!list || list.length === 0) {
-    return { handled: false };
-  }
-  const pending = list.shift();
-  clearTimeout(pending.autoTimer);
-  if (list.length === 0) {
-    pendingDialogs.delete(sessionId);
-  }
-  try {
-    if (action === "accept") {
-      await pending.dialog.accept(promptText);
-    } else {
-      await pending.dialog.dismiss();
-    }
-  } catch {}
-  return { handled: true, dialog: pending.info };
-}
-function clearDialogs(sessionId) {
-  const list = pendingDialogs.get(sessionId);
-  if (list) {
-    for (const p of list) {
-      clearTimeout(p.autoTimer);
-      try {
-        p.dialog.dismiss().catch(() => {});
-      } catch {}
-    }
-    pendingDialogs.delete(sessionId);
-  }
-}
-var pendingDialogs, AUTO_DISMISS_MS = 5000;
-var init_dialogs = __esm(() => {
-  pendingDialogs = new Map;
-});
-
 // src/lib/storage-state.ts
 var exports_storage_state = {};
 __export(exports_storage_state, {
@@ -17311,201 +17311,65 @@ var require_lib3 = __commonJS((exports, module) => {
 });
 
 // src/index.ts
-init_schema();
 init_types();
 
-// src/db/projects.ts
+// src/lib/session.ts
+init_types();
+init_types();
+
+// src/db/sessions.ts
 init_schema();
 init_types();
 import { randomUUID } from "crypto";
-function createProject(data) {
+function createSession(data) {
   const db = getDatabase();
   const id = randomUUID();
-  db.prepare("INSERT INTO projects (id, name, path, description) VALUES (?, ?, ?, ?)").run(id, data.name, data.path, data.description ?? null);
-  return getProject(id);
-}
-function ensureProject(name, path, description) {
-  const db = getDatabase();
-  const existing = db.query("SELECT * FROM projects WHERE name = ?").get(name);
-  if (existing)
-    return existing;
-  return createProject({ name, path, description });
+  if (data.agentId) {
+    const exists = db.query("SELECT id FROM agents WHERE id = ?").get(data.agentId);
+    if (!exists) {
+      db.prepare("INSERT INTO agents (id, name) VALUES (?, ?)").run(data.agentId, data.agentId);
+    }
+  }
+  let name = data.name ?? null;
+  if (name) {
+    const existing = db.query("SELECT id FROM sessions WHERE name = ?").get(name);
+    if (existing) {
+      name = `${name}-${id.slice(0, 6)}`;
+    }
+  }
+  db.prepare("INSERT INTO sessions (id, engine, project_id, agent_id, start_url, name) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.engine, data.projectId ?? null, data.agentId ?? null, data.startUrl ?? null, name);
+  return getSession(id);
 }
-function getProject(id) {
+function getSessionByName(name) {
   const db = getDatabase();
-  const row = db.query("SELECT * FROM projects WHERE id = ?").get(id);
-  if (!row)
-    throw new ProjectNotFoundError(id);
-  return row;
+  return db.query("SELECT * FROM sessions WHERE name = ?").get(name) ?? null;
 }
-function getProjectByName(name) {
+function renameSession(id, name) {
   const db = getDatabase();
-  return db.query("SELECT * FROM projects WHERE name = ?").get(name) ?? null;
+  db.prepare("UPDATE sessions SET name = ? WHERE id = ?").run(name, id);
+  return getSession(id);
 }
-function listProjects() {
+function getSession(id) {
   const db = getDatabase();
-  return db.query("SELECT * FROM projects ORDER BY created_at DESC").all();
+  const row = db.query("SELECT * FROM sessions WHERE id = ?").get(id);
+  if (!row)
+    throw new SessionNotFoundError(id);
+  return row;
 }
-function updateProject(id, data) {
+function listSessions(filter) {
   const db = getDatabase();
-  const fields = [];
+  const conditions = [];
   const values = [];
-  if (data.name !== undefined) {
-    fields.push("name = ?");
-    values.push(data.name);
-  }
-  if (data.path !== undefined) {
-    fields.push("path = ?");
-    values.push(data.path);
+  if (filter?.status) {
+    conditions.push("status = ?");
+    values.push(filter.status);
   }
-  if (data.description !== undefined) {
-    fields.push("description = ?");
-    values.push(data.description ?? null);
+  if (filter?.projectId) {
+    conditions.push("project_id = ?");
+    values.push(filter.projectId);
   }
-  if (fields.length === 0)
-    return getProject(id);
-  values.push(id);
-  db.prepare(`UPDATE projects SET ${fields.join(", ")} WHERE id = ?`).run(...values);
-  return getProject(id);
-}
-function deleteProject(id) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM projects WHERE id = ?").run(id);
-}
-// src/db/agents.ts
-init_schema();
-init_types();
-import { randomUUID as randomUUID2 } from "crypto";
-function registerAgent(name, opts = {}) {
-  const db = getDatabase();
-  const existing = db.query("SELECT * FROM agents WHERE name = ?").get(name);
-  if (existing) {
-    db.prepare("UPDATE agents SET last_seen = datetime('now'), session_id = ?, project_id = ?, working_dir = ? WHERE name = ?").run(opts.sessionId ?? existing.session_id ?? null, opts.projectId ?? existing.project_id ?? null, opts.workingDir ?? existing.working_dir ?? null, name);
-    return getAgentByName(name);
-  }
-  const id = randomUUID2();
-  db.prepare("INSERT INTO agents (id, name, description, session_id, project_id, working_dir) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, opts.description ?? null, opts.sessionId ?? null, opts.projectId ?? null, opts.workingDir ?? null);
-  return getAgent(id);
-}
-function heartbeat(agentId) {
-  const db = getDatabase();
-  const agent = db.query("SELECT * FROM agents WHERE id = ?").get(agentId);
-  if (!agent)
-    throw new AgentNotFoundError(agentId);
-  db.prepare("UPDATE agents SET last_seen = datetime('now') WHERE id = ?").run(agentId);
-  db.prepare("INSERT INTO heartbeats (id, agent_id, session_id) VALUES (?, ?, ?)").run(randomUUID2(), agentId, agent.session_id ?? null);
-}
-function getAgent(id) {
-  const db = getDatabase();
-  const row = db.query("SELECT * FROM agents WHERE id = ?").get(id);
-  if (!row)
-    throw new AgentNotFoundError(id);
-  return row;
-}
-function getAgentByName(name) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM agents WHERE name = ?").get(name) ?? null;
-}
-function listAgents(projectId) {
-  const db = getDatabase();
-  if (projectId) {
-    return db.query("SELECT * FROM agents WHERE project_id = ? ORDER BY last_seen DESC").all(projectId);
-  }
-  return db.query("SELECT * FROM agents ORDER BY last_seen DESC").all();
-}
-function updateAgent(id, data) {
-  const db = getDatabase();
-  const fields = [];
-  const values = [];
-  if (data.name !== undefined) {
-    fields.push("name = ?");
-    values.push(data.name ?? null);
-  }
-  if (data.description !== undefined) {
-    fields.push("description = ?");
-    values.push(data.description ?? null);
-  }
-  if (data.session_id !== undefined) {
-    fields.push("session_id = ?");
-    values.push(data.session_id ?? null);
-  }
-  if (data.project_id !== undefined) {
-    fields.push("project_id = ?");
-    values.push(data.project_id ?? null);
-  }
-  if (data.working_dir !== undefined) {
-    fields.push("working_dir = ?");
-    values.push(data.working_dir ?? null);
-  }
-  if (fields.length === 0)
-    return getAgent(id);
-  values.push(id);
-  db.prepare(`UPDATE agents SET ${fields.join(", ")} WHERE id = ?`).run(...values);
-  return getAgent(id);
-}
-function deleteAgent(id) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM agents WHERE id = ?").run(id);
-}
-function cleanStaleAgents(thresholdMs) {
-  const db = getDatabase();
-  const cutoff = new Date(Date.now() - thresholdMs).toISOString().replace("T", " ").split(".")[0];
-  const result = db.prepare("DELETE FROM agents WHERE last_seen < ?").run(cutoff);
-  return result.changes;
-}
-// src/db/sessions.ts
-init_schema();
-init_types();
-import { randomUUID as randomUUID3 } from "crypto";
-function createSession(data) {
-  const db = getDatabase();
-  const id = randomUUID3();
-  if (data.agentId) {
-    const exists = db.query("SELECT id FROM agents WHERE id = ?").get(data.agentId);
-    if (!exists) {
-      db.prepare("INSERT INTO agents (id, name) VALUES (?, ?)").run(data.agentId, data.agentId);
-    }
-  }
-  let name = data.name ?? null;
-  if (name) {
-    const existing = db.query("SELECT id FROM sessions WHERE name = ?").get(name);
-    if (existing) {
-      name = `${name}-${id.slice(0, 6)}`;
-    }
-  }
-  db.prepare("INSERT INTO sessions (id, engine, project_id, agent_id, start_url, name) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.engine, data.projectId ?? null, data.agentId ?? null, data.startUrl ?? null, name);
-  return getSession(id);
-}
-function getSessionByName(name) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM sessions WHERE name = ?").get(name) ?? null;
-}
-function renameSession(id, name) {
-  const db = getDatabase();
-  db.prepare("UPDATE sessions SET name = ? WHERE id = ?").run(name, id);
-  return getSession(id);
-}
-function getSession(id) {
-  const db = getDatabase();
-  const row = db.query("SELECT * FROM sessions WHERE id = ?").get(id);
-  if (!row)
-    throw new SessionNotFoundError(id);
-  return row;
-}
-function listSessions(filter) {
-  const db = getDatabase();
-  const conditions = [];
-  const values = [];
-  if (filter?.status) {
-    conditions.push("status = ?");
-    values.push(filter.status);
-  }
-  if (filter?.projectId) {
-    conditions.push("project_id = ?");
-    values.push(filter.projectId);
-  }
-  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
-  return db.query(`SELECT * FROM sessions ${where} ORDER BY created_at DESC`).all(...values);
+  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+  return db.query(`SELECT * FROM sessions ${where} ORDER BY created_at DESC`).all(...values);
 }
 function updateSessionStatus(id, status) {
   const db = getDatabase();
@@ -17536,229 +17400,38 @@ function deleteSession(id) {
   const db = getDatabase();
   db.prepare("DELETE FROM sessions WHERE id = ?").run(id);
 }
-// src/db/snapshots.ts
-init_schema();
-import { randomUUID as randomUUID4 } from "crypto";
-function createSnapshot(data) {
-  const db = getDatabase();
-  const id = randomUUID4();
-  db.prepare("INSERT INTO snapshots (id, session_id, url, title, html, screenshot_path) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.session_id, data.url, data.title ?? null, data.html ?? null, data.screenshot_path ?? null);
-  return getSnapshot(id);
-}
-function getSnapshot(id) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM snapshots WHERE id = ?").get(id) ?? null;
-}
-function listSnapshots(sessionId) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM snapshots WHERE session_id = ? ORDER BY timestamp DESC").all(sessionId);
-}
-function deleteSnapshot(id) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM snapshots WHERE id = ?").run(id);
-}
-function deleteSnapshotsBySession(sessionId) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM snapshots WHERE session_id = ?").run(sessionId);
-}
-// src/db/network-log.ts
-init_schema();
-import { randomUUID as randomUUID5 } from "crypto";
-function logRequest(data) {
-  const db = getDatabase();
-  const id = randomUUID5();
-  db.prepare(`INSERT INTO network_log (id, session_id, method, url, status_code, request_headers,
-     response_headers, request_body, body_size, duration_ms, resource_type)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, data.session_id, data.method, data.url, data.status_code ?? null, data.request_headers ?? null, data.response_headers ?? null, data.request_body ?? null, data.body_size ?? null, data.duration_ms ?? null, data.resource_type ?? null);
-  return getNetworkRequest(id);
-}
-function getNetworkRequest(id) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM network_log WHERE id = ?").get(id) ?? null;
-}
-function getNetworkLog(sessionId) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM network_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
-}
-function clearNetworkLog(sessionId) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM network_log WHERE session_id = ?").run(sessionId);
-}
-function deleteNetworkRequest(id) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM network_log WHERE id = ?").run(id);
-}
-// src/db/console-log.ts
-init_schema();
-import { randomUUID as randomUUID6 } from "crypto";
-function logConsoleMessage(data) {
-  const db = getDatabase();
-  const id = randomUUID6();
-  db.prepare("INSERT INTO console_log (id, session_id, level, message, source, line_number) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.session_id, data.level, data.message, data.source ?? null, data.line_number ?? null);
-  return getConsoleMessage(id);
-}
-function getConsoleMessage(id) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM console_log WHERE id = ?").get(id) ?? null;
-}
-function getConsoleLog(sessionId, level) {
-  const db = getDatabase();
-  if (level) {
-    return db.query("SELECT * FROM console_log WHERE session_id = ? AND level = ? ORDER BY timestamp ASC").all(sessionId, level);
+
+// src/engines/playwright.ts
+init_types();
+import { chromium } from "playwright";
+var DEFAULT_VIEWPORT = { width: 1280, height: 720 };
+async function launchPlaywright(options) {
+  try {
+    return await chromium.launch({
+      headless: options?.headless ?? true,
+      executablePath: options?.executablePath
+    });
+  } catch (err) {
+    throw new BrowserError(`Failed to launch Playwright browser: ${err instanceof Error ? err.message : String(err)}`, "PLAYWRIGHT_LAUNCH_FAILED", true);
   }
-  return db.query("SELECT * FROM console_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
 }
-function clearConsoleLog(sessionId) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM console_log WHERE session_id = ?").run(sessionId);
+async function getPage(browser, options) {
+  const context = await browser.newContext({
+    viewport: options?.viewport ?? DEFAULT_VIEWPORT,
+    userAgent: options?.userAgent,
+    locale: options?.locale
+  });
+  return context.newPage();
 }
-// src/db/recordings.ts
-init_schema();
-init_types();
-import { randomUUID as randomUUID7 } from "crypto";
-function deserialize(row) {
-  return {
-    ...row,
-    project_id: row.project_id ?? undefined,
-    start_url: row.start_url ?? undefined,
-    steps: JSON.parse(row.steps)
-  };
+async function closeBrowser(browser) {
+  try {
+    await browser.close();
+  } catch {}
 }
-function createRecording(data) {
-  const db = getDatabase();
-  const id = randomUUID7();
-  db.prepare("INSERT INTO recordings (id, name, project_id, start_url, steps) VALUES (?, ?, ?, ?, ?)").run(id, data.name, data.project_id ?? null, data.start_url ?? null, JSON.stringify(data.steps ?? []));
-  return getRecording(id);
-}
-function getRecording(id) {
-  const db = getDatabase();
-  const row = db.query("SELECT * FROM recordings WHERE id = ?").get(id);
-  if (!row)
-    throw new RecordingNotFoundError(id);
-  return deserialize(row);
-}
-function listRecordings(projectId) {
-  const db = getDatabase();
-  const rows = projectId ? db.query("SELECT * FROM recordings WHERE project_id = ? ORDER BY created_at DESC").all(projectId) : db.query("SELECT * FROM recordings ORDER BY created_at DESC").all();
-  return rows.map(deserialize);
-}
-function updateRecording(id, data) {
-  const db = getDatabase();
-  const fields = [];
-  const values = [];
-  if (data.name !== undefined) {
-    fields.push("name = ?");
-    values.push(data.name);
-  }
-  if (data.steps !== undefined) {
-    fields.push("steps = ?");
-    values.push(JSON.stringify(data.steps));
-  }
-  if (data.start_url !== undefined) {
-    fields.push("start_url = ?");
-    values.push(data.start_url ?? null);
-  }
-  if (fields.length === 0)
-    return getRecording(id);
-  values.push(id);
-  db.prepare(`UPDATE recordings SET ${fields.join(", ")} WHERE id = ?`).run(...values);
-  return getRecording(id);
-}
-function deleteRecording(id) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM recordings WHERE id = ?").run(id);
-}
-// src/db/crawl-results.ts
-init_schema();
-import { randomUUID as randomUUID8 } from "crypto";
-function deserialize2(row) {
-  const pages = JSON.parse(row.pages);
-  return {
-    id: row.id,
-    project_id: row.project_id ?? undefined,
-    start_url: row.start_url,
-    depth: row.depth,
-    pages,
-    total_links: pages.reduce((acc, p) => acc + p.links.length, 0),
-    errors: JSON.parse(row.errors),
-    created_at: row.created_at
-  };
-}
-function createCrawlResult(data) {
-  const db = getDatabase();
-  const id = randomUUID8();
-  db.prepare("INSERT INTO crawl_results (id, project_id, start_url, depth, pages, links, errors) VALUES (?, ?, ?, ?, ?, ?, ?)").run(id, data.project_id ?? null, data.start_url, data.depth, JSON.stringify(data.pages), JSON.stringify(data.pages.flatMap((p) => p.links)), JSON.stringify(data.errors));
-  return getCrawlResult(id);
-}
-function getCrawlResult(id) {
-  const db = getDatabase();
-  const row = db.query("SELECT * FROM crawl_results WHERE id = ?").get(id);
-  return row ? deserialize2(row) : null;
-}
-function listCrawlResults(projectId) {
-  const db = getDatabase();
-  const rows = projectId ? db.query("SELECT * FROM crawl_results WHERE project_id = ? ORDER BY created_at DESC").all(projectId) : db.query("SELECT * FROM crawl_results ORDER BY created_at DESC").all();
-  return rows.map(deserialize2);
-}
-function deleteCrawlResult(id) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM crawl_results WHERE id = ?").run(id);
-}
-// src/db/heartbeats.ts
-init_schema();
-import { randomUUID as randomUUID9 } from "crypto";
-function recordHeartbeat(agentId, sessionId) {
-  const db = getDatabase();
-  const id = randomUUID9();
-  db.prepare("INSERT INTO heartbeats (id, agent_id, session_id) VALUES (?, ?, ?)").run(id, agentId, sessionId ?? null);
-  db.prepare("UPDATE agents SET last_seen = datetime('now') WHERE id = ?").run(agentId);
-  return getLastHeartbeat(agentId);
-}
-function getLastHeartbeat(agentId) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM heartbeats WHERE agent_id = ? ORDER BY timestamp DESC LIMIT 1").get(agentId) ?? null;
-}
-function listHeartbeats(agentId, limit = 50) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM heartbeats WHERE agent_id = ? ORDER BY timestamp DESC LIMIT ?").all(agentId, limit);
-}
-function cleanOldHeartbeats(olderThanMs) {
-  const db = getDatabase();
-  const cutoff = new Date(Date.now() - olderThanMs).toISOString().replace("T", " ").split(".")[0];
-  const result = db.prepare("DELETE FROM heartbeats WHERE timestamp < ?").run(cutoff);
-  return result.changes;
-}
-// src/engines/playwright.ts
-init_types();
-import { chromium } from "playwright";
-var DEFAULT_VIEWPORT = { width: 1280, height: 720 };
-async function launchPlaywright(options) {
-  try {
-    return await chromium.launch({
-      headless: options?.headless ?? true,
-      executablePath: options?.executablePath
-    });
-  } catch (err) {
-    throw new BrowserError(`Failed to launch Playwright browser: ${err instanceof Error ? err.message : String(err)}`, "PLAYWRIGHT_LAUNCH_FAILED", true);
-  }
-}
-async function getPage(browser, options) {
-  const context = await browser.newContext({
-    viewport: options?.viewport ?? DEFAULT_VIEWPORT,
-    userAgent: options?.userAgent,
-    locale: options?.locale
-  });
-  return context.newPage();
-}
-async function closeBrowser(browser) {
-  try {
-    await browser.close();
-  } catch {}
-}
-async function closePage(page) {
-  try {
-    await page.context().close();
-  } catch {}
+async function closePage(page) {
+  try {
+    await page.context().close();
+  } catch {}
 }
 
 class BrowserPool {
@@ -17813,9 +17486,6 @@ class BrowserPool {
   }
 }
 
-// src/index.ts
-init_cdp();
-
 // src/engines/lightpanda.ts
 init_types();
 import { execSync, spawn } from "child_process";
@@ -17959,15 +17629,19 @@ class LightpandaPage {
     await this.page.context().close();
   }
 }
-// src/engines/selector.ts
-init_types();
 
 // src/engines/bun-webview.ts
 init_schema();
 import { join as join7 } from "path";
 import { mkdirSync as mkdirSync5 } from "fs";
 function isBunWebViewAvailable() {
-  return typeof globalThis.Bun !== "undefined" && typeof globalThis.Bun.WebView !== "undefined";
+  if (typeof globalThis.Bun === "undefined" || typeof globalThis.Bun.WebView === "undefined") {
+    return false;
+  }
+  if (process.platform === "linux" && process.env["BROWSER_ENABLE_BUN_WEBVIEW"] !== "1") {
+    return false;
+  }
+  return true;
 }
 function getProfileDir(profileName) {
   const base = getDataDir2();
@@ -18361,6 +18035,9 @@ class BunWebViewSession {
   }
 }
 
+// src/engines/selector.ts
+init_types();
+
 // src/engines/tui.ts
 init_types();
 import { execSync as execSync2, spawn as spawn2 } from "child_process";
@@ -18814,9 +18491,6 @@ function inferUseCase(label) {
   };
   return map[label.toLowerCase()] ?? "spa_navigate" /* SPA_NAVIGATE */;
 }
-// src/lib/session.ts
-init_types();
-init_types();
 
 // src/lib/tui-recording.ts
 var recordingIntervals = new Map;
@@ -18828,6 +18502,34 @@ function stopTuiRecording(sessionId) {
   recordingIntervals.delete(sessionId);
 }
 
+// src/db/network-log.ts
+init_schema();
+import { randomUUID as randomUUID2 } from "crypto";
+function logRequest(data) {
+  const db = getDatabase();
+  const id = randomUUID2();
+  db.prepare(`INSERT INTO network_log (id, session_id, method, url, status_code, request_headers,
+     response_headers, request_body, body_size, duration_ms, resource_type)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, data.session_id, data.method, data.url, data.status_code ?? null, data.request_headers ?? null, data.response_headers ?? null, data.request_body ?? null, data.body_size ?? null, data.duration_ms ?? null, data.resource_type ?? null);
+  return getNetworkRequest(id);
+}
+function getNetworkRequest(id) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM network_log WHERE id = ?").get(id) ?? null;
+}
+function getNetworkLog(sessionId) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM network_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
+}
+function clearNetworkLog(sessionId) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM network_log WHERE session_id = ?").run(sessionId);
+}
+function deleteNetworkRequest(id) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM network_log WHERE id = ?").run(id);
+}
+
 // src/lib/network.ts
 function enableNetworkLogging(page, sessionId) {
   const requestStart = new Map;
@@ -18950,6 +18652,31 @@ function startHAR(page) {
   };
 }
 
+// src/db/console-log.ts
+init_schema();
+import { randomUUID as randomUUID3 } from "crypto";
+function logConsoleMessage(data) {
+  const db = getDatabase();
+  const id = randomUUID3();
+  db.prepare("INSERT INTO console_log (id, session_id, level, message, source, line_number) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.session_id, data.level, data.message, data.source ?? null, data.line_number ?? null);
+  return getConsoleMessage(id);
+}
+function getConsoleMessage(id) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM console_log WHERE id = ?").get(id) ?? null;
+}
+function getConsoleLog(sessionId, level) {
+  const db = getDatabase();
+  if (level) {
+    return db.query("SELECT * FROM console_log WHERE session_id = ? AND level = ? ORDER BY timestamp ASC").all(sessionId, level);
+  }
+  return db.query("SELECT * FROM console_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
+}
+function clearConsoleLog(sessionId) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM console_log WHERE session_id = ?").run(sessionId);
+}
+
 // src/lib/console.ts
 function enableConsoleCapture(page, sessionId) {
   const onConsole = (msg) => {
@@ -19451,7 +19178,7 @@ function countActiveSessions2() {
   return countActiveSessions();
 }
 
-// src/index.ts
+// src/sdk.ts
 init_actions();
 
 // src/lib/extractor.ts
@@ -19618,6 +19345,698 @@ async function getPageInfo(page) {
     viewport
   };
 }
+
+// src/lib/screenshot.ts
+init_types();
+var import_sharp = __toESM(require_lib3(), 1);
+import { join as join10 } from "path";
+import { mkdirSync as mkdirSync7 } from "fs";
+
+// src/db/gallery.ts
+init_schema();
+import { randomUUID as randomUUID4 } from "crypto";
+import { join as join9, resolve, relative as relative2, isAbsolute } from "path";
+function validateDataPath(filePath) {
+  if (filePath.includes("..")) {
+    throw new Error(`File path must not contain '..': ${filePath}`);
+  }
+  const dataDir = resolve(getDataDir2());
+  const resolved = resolve(isAbsolute(filePath) ? filePath : join9(dataDir, filePath));
+  const rel = relative2(dataDir, resolved);
+  if (rel.startsWith("..") || isAbsolute(rel)) {
+    throw new Error(`File path must be within data directory: ${filePath}`);
+  }
+  return filePath;
+}
+function deserialize(row) {
+  return {
+    id: row.id,
+    session_id: row.session_id ?? undefined,
+    project_id: row.project_id ?? undefined,
+    url: row.url ?? undefined,
+    title: row.title ?? undefined,
+    path: row.path,
+    thumbnail_path: row.thumbnail_path ?? undefined,
+    format: row.format ?? undefined,
+    width: row.width ?? undefined,
+    height: row.height ?? undefined,
+    original_size_bytes: row.original_size_bytes ?? undefined,
+    compressed_size_bytes: row.compressed_size_bytes ?? undefined,
+    compression_ratio: row.compression_ratio ?? undefined,
+    tags: (() => {
+      try {
+        return JSON.parse(row.tags);
+      } catch {
+        return [];
+      }
+    })(),
+    notes: row.notes ?? undefined,
+    is_favorite: row.is_favorite === 1,
+    created_at: row.created_at
+  };
+}
+function createEntry(data) {
+  const db = getDatabase();
+  const id = randomUUID4();
+  validateDataPath(data.path);
+  if (data.thumbnail_path)
+    validateDataPath(data.thumbnail_path);
+  db.prepare(`
+    INSERT INTO gallery_entries
+      (id, session_id, project_id, url, title, path, thumbnail_path, format,
+       width, height, original_size_bytes, compressed_size_bytes, compression_ratio,
+       tags, notes, is_favorite)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, data.session_id ?? null, data.project_id ?? null, data.url ?? null, data.title ?? null, data.path, data.thumbnail_path ?? null, data.format ?? null, data.width ?? null, data.height ?? null, data.original_size_bytes ?? null, data.compressed_size_bytes ?? null, data.compression_ratio ?? null, JSON.stringify(data.tags ?? []), data.notes ?? null, data.is_favorite ? 1 : 0);
+  return getEntry(id);
+}
+function getEntry(id) {
+  const db = getDatabase();
+  const row = db.query("SELECT * FROM gallery_entries WHERE id = ?").get(id);
+  return row ? deserialize(row) : null;
+}
+
+// src/lib/screenshot.ts
+init_schema();
+function getScreenshotDir(projectId) {
+  const base = join10(getDataDir2(), "screenshots");
+  const date = new Date().toISOString().split("T")[0];
+  const dir = projectId ? join10(base, projectId, date) : join10(base, date);
+  mkdirSync7(dir, { recursive: true });
+  return dir;
+}
+async function compressBuffer(raw, format, quality, maxWidth) {
+  let pipeline = import_sharp.default(raw).resize({ width: maxWidth, withoutEnlargement: true });
+  switch (format) {
+    case "webp":
+      return pipeline.webp({ quality, effort: 4 }).toBuffer();
+    case "jpeg":
+      return pipeline.jpeg({ quality, mozjpeg: true }).toBuffer();
+    case "png":
+      return pipeline.png({ compressionLevel: 9 }).toBuffer();
+  }
+}
+async function generateThumbnail(raw, dir, stem) {
+  const thumbPath = join10(dir, `${stem}.thumb.webp`);
+  const thumbBuffer = await import_sharp.default(raw).resize({ width: 200, withoutEnlargement: true }).webp({ quality: 70, effort: 3 }).toBuffer();
+  await Bun.write(thumbPath, thumbBuffer);
+  return { path: thumbPath, base64: thumbBuffer.toString("base64") };
+}
+async function takeScreenshot(page, opts) {
+  try {
+    const dir = getScreenshotDir(opts?.projectId);
+    const timestamp = Date.now();
+    const format = opts?.format ?? "webp";
+    const compress = opts?.compress ?? true;
+    const maxWidth = opts?.maxWidth ?? 1200;
+    const quality = opts?.quality ?? (format === "webp" ? 80 : format === "jpeg" ? 70 : undefined);
+    const stem = String(timestamp);
+    const rawOpts = {
+      fullPage: opts?.fullPage ?? false,
+      type: "png"
+    };
+    let rawBuffer;
+    const isBunView = typeof page.getNativeView === "function";
+    if (opts?.selector) {
+      if (isBunView) {
+        const uint8 = await page.screenshot();
+        rawBuffer = Buffer.from(uint8 instanceof Uint8Array ? uint8 : await uint8);
+      } else {
+        const el = await page.$(opts.selector);
+        if (!el)
+          throw new BrowserError(`Element not found: ${opts.selector}`, "ELEMENT_NOT_FOUND");
+        rawBuffer = await el.screenshot(rawOpts);
+      }
+    } else if (isBunView) {
+      const uint8 = await page.screenshot();
+      rawBuffer = Buffer.from(uint8 instanceof Uint8Array ? uint8 : await uint8);
+    } else {
+      rawBuffer = await page.screenshot(rawOpts);
+    }
+    const originalSizeBytes = rawBuffer.length;
+    const MAX_SIZE_BYTES = 500 * 1024;
+    let finalBuffer;
+    let compressed = true;
+    let fallback = false;
+    try {
+      if (compress && format !== "png") {
+        finalBuffer = await compressBuffer(rawBuffer, format, quality ?? 70, maxWidth);
+        if (finalBuffer.length > MAX_SIZE_BYTES) {
+          const reducedFormat = format === "webp" ? "webp" : "jpeg";
+          for (const q of [60, 50, 40, 30]) {
+            const attempt = await compressBuffer(rawBuffer, reducedFormat, q, maxWidth);
+            if (attempt.length <= MAX_SIZE_BYTES) {
+              finalBuffer = attempt;
+              break;
+            }
+          }
+        }
+      } else if (compress && format === "png") {
+        finalBuffer = await compressBuffer(rawBuffer, "png", quality ?? 9, maxWidth);
+      } else {
+        finalBuffer = rawBuffer;
+        compressed = false;
+      }
+    } catch (sharpErr) {
+      fallback = true;
+      compressed = false;
+      finalBuffer = rawBuffer;
+    }
+    const compressedSizeBytes = finalBuffer.length;
+    const compressionRatio = originalSizeBytes > 0 ? compressedSizeBytes / originalSizeBytes : 1;
+    const ext = format;
+    const screenshotPath = opts?.path ?? join10(dir, `${stem}.${ext}`);
+    await Bun.write(screenshotPath, finalBuffer);
+    let thumbnailPath;
+    let thumbnailBase64;
+    if (opts?.thumbnail !== false) {
+      const thumb = await generateThumbnail(rawBuffer, dir, stem);
+      thumbnailPath = thumb.path;
+      thumbnailBase64 = thumb.base64;
+    }
+    const meta = await import_sharp.default(finalBuffer).metadata();
+    const width = meta.width ?? (page.viewportSize()?.width ?? 1280);
+    const height = meta.height ?? (page.viewportSize()?.height ?? 720);
+    const result = {
+      path: screenshotPath,
+      base64: finalBuffer.toString("base64"),
+      width,
+      height,
+      size_bytes: compressedSizeBytes,
+      original_size_bytes: originalSizeBytes,
+      compressed_size_bytes: compressedSizeBytes,
+      compression_ratio: compressionRatio,
+      thumbnail_path: thumbnailPath,
+      thumbnail_base64: thumbnailBase64,
+      ...fallback ? { fallback: true, compressed: false } : {}
+    };
+    if (opts?.track !== false) {
+      try {
+        const url = await page.url().valueOf();
+        let title;
+        try {
+          title = await page.title();
+        } catch {}
+        const entry = createEntry({
+          session_id: opts?.sessionId,
+          project_id: opts?.projectId,
+          url,
+          title,
+          path: screenshotPath,
+          thumbnail_path: thumbnailPath,
+          format: ext,
+          width,
+          height,
+          original_size_bytes: originalSizeBytes,
+          compressed_size_bytes: compressedSizeBytes,
+          compression_ratio: compressionRatio,
+          tags: [],
+          is_favorite: false
+        });
+        result.gallery_id = entry.id;
+      } catch {}
+    }
+    return result;
+  } catch (err) {
+    if (err instanceof BrowserError)
+      throw err;
+    throw new BrowserError(`Screenshot failed: ${err instanceof Error ? err.message : String(err)}`, "SCREENSHOT_FAILED");
+  }
+}
+async function generatePDF(page, opts) {
+  try {
+    const base = join10(getDataDir2(), "pdfs");
+    const date = new Date().toISOString().split("T")[0];
+    const dir = opts?.projectId ? join10(base, opts.projectId, date) : join10(base, date);
+    mkdirSync7(dir, { recursive: true });
+    const timestamp = Date.now();
+    const pdfPath = opts?.path ?? join10(dir, `${timestamp}.pdf`);
+    const buffer = await page.pdf({
+      path: pdfPath,
+      format: opts?.format ?? "A4",
+      landscape: opts?.landscape ?? false,
+      margin: opts?.margin,
+      printBackground: opts?.printBackground ?? true
+    });
+    return {
+      path: pdfPath,
+      base64: Buffer.from(buffer).toString("base64"),
+      size_bytes: buffer.length
+    };
+  } catch (err) {
+    throw new BrowserError(`PDF generation failed: ${err instanceof Error ? err.message : String(err)}`, "PDF_FAILED");
+  }
+}
+
+// src/sdk.ts
+function buildDependencies(input) {
+  return {
+    createSession: input?.createSession ?? createSession2,
+    closeSession: input?.closeSession ?? closeSession2,
+    getSessionPage: input?.getSessionPage ?? getSessionPage,
+    getPageInfo: input?.getPageInfo ?? getPageInfo,
+    navigate: input?.navigate ?? navigate,
+    click: input?.click ?? click,
+    typeText: input?.typeText ?? type,
+    fill: input?.fill ?? fill,
+    pressKey: input?.pressKey ?? pressKey,
+    waitForSelector: input?.waitForSelector ?? waitForSelector,
+    takeScreenshot: input?.takeScreenshot ?? takeScreenshot
+  };
+}
+
+class BrowserSDK {
+  deps;
+  sessions = new Map;
+  constructor(options = {}) {
+    this.deps = buildDependencies(options.dependencies);
+  }
+  async open(options = {}) {
+    const { session, page } = await this.deps.createSession(options);
+    const handle = { id: session.id, session, page };
+    this.sessions.set(handle.id, handle);
+    return handle;
+  }
+  async createSession(options = {}) {
+    return this.open(options);
+  }
+  getPage(ref) {
+    if (typeof ref !== "string")
+      return ref.page;
+    return this.sessions.get(ref)?.page ?? this.deps.getSessionPage(ref);
+  }
+  async pageInfo(ref) {
+    return this.deps.getPageInfo(this.getPage(ref));
+  }
+  async navigate(ref, url, opts) {
+    await this.deps.navigate(this.getPage(ref), url, opts?.timeout);
+    return this.pageInfo(ref);
+  }
+  async click(ref, selector, opts) {
+    return this.deps.click(this.getPage(ref), selector, {
+      timeout: opts?.timeout,
+      selfHeal: opts?.selfHeal
+    });
+  }
+  async fill(ref, selector, value, opts) {
+    return this.deps.fill(this.getPage(ref), selector, value, opts?.timeout, opts?.selfHeal);
+  }
+  async type(ref, selector, text, opts) {
+    return this.deps.typeText(this.getPage(ref), selector, text, {
+      timeout: opts?.timeout,
+      clear: opts?.clear,
+      selfHeal: opts?.selfHeal
+    });
+  }
+  async pressKey(ref, key) {
+    return this.deps.pressKey(this.getPage(ref), key);
+  }
+  async waitForSelector(ref, selector, opts) {
+    return this.deps.waitForSelector(this.getPage(ref), selector, opts);
+  }
+  async screenshot(ref, options) {
+    const sessionId = typeof ref === "string" ? ref : ref.id;
+    return this.deps.takeScreenshot(this.getPage(ref), {
+      ...options,
+      sessionId
+    });
+  }
+  async close(ref) {
+    const sessionId = typeof ref === "string" ? ref : ref.id;
+    this.sessions.delete(sessionId);
+    return this.deps.closeSession(sessionId);
+  }
+  async run(options) {
+    const ownsSession = !options.session;
+    const handle = options.session ? this.resolveHandle(options.session) : await this.open(options.sessionOptions);
+    const stepResults = [];
+    try {
+      for (const step of options.steps) {
+        stepResults.push(await this.runStep(handle, step));
+      }
+      return {
+        session: handle.session,
+        pageInfo: await this.pageInfo(handle),
+        steps: stepResults
+      };
+    } finally {
+      const shouldClose = options.autoClose ?? ownsSession;
+      if (shouldClose) {
+        await this.close(handle);
+      }
+    }
+  }
+  resolveHandle(ref) {
+    if (typeof ref !== "string")
+      return ref;
+    const cached = this.sessions.get(ref);
+    if (cached)
+      return cached;
+    return {
+      id: ref,
+      session: {
+        id: ref,
+        engine: "playwright",
+        status: "active",
+        created_at: new Date(0).toISOString()
+      },
+      page: this.deps.getSessionPage(ref)
+    };
+  }
+  async runStep(handle, step) {
+    switch (step.type) {
+      case "navigate":
+        await this.navigate(handle, step.url, { timeout: step.timeout });
+        return { type: step.type, ok: true };
+      case "click":
+        await this.click(handle, step.selector, { timeout: step.timeout, selfHeal: step.selfHeal });
+        return { type: step.type, ok: true };
+      case "fill":
+        await this.fill(handle, step.selector, step.value, { timeout: step.timeout, selfHeal: step.selfHeal });
+        return { type: step.type, ok: true };
+      case "type":
+        await this.type(handle, step.selector, step.text, {
+          timeout: step.timeout,
+          clear: step.clear,
+          selfHeal: step.selfHeal
+        });
+        return { type: step.type, ok: true };
+      case "press":
+        await this.pressKey(handle, step.key);
+        return { type: step.type, ok: true };
+      case "wait":
+        await this.waitForSelector(handle, step.selector, {
+          timeout: step.timeout,
+          state: step.state
+        });
+        return { type: step.type, ok: true };
+      case "screenshot":
+        return {
+          type: step.type,
+          ok: true,
+          screenshot: await this.screenshot(handle, step.options)
+        };
+      case "pageInfo":
+        return {
+          type: step.type,
+          ok: true,
+          info: await this.pageInfo(handle)
+        };
+    }
+  }
+}
+function createBrowserSDK(options) {
+  return new BrowserSDK(options);
+}
+
+// src/index.ts
+init_schema();
+
+// src/db/projects.ts
+init_schema();
+init_types();
+import { randomUUID as randomUUID5 } from "crypto";
+function createProject(data) {
+  const db = getDatabase();
+  const id = randomUUID5();
+  db.prepare("INSERT INTO projects (id, name, path, description) VALUES (?, ?, ?, ?)").run(id, data.name, data.path, data.description ?? null);
+  return getProject(id);
+}
+function ensureProject(name, path, description) {
+  const db = getDatabase();
+  const existing = db.query("SELECT * FROM projects WHERE name = ?").get(name);
+  if (existing)
+    return existing;
+  return createProject({ name, path, description });
+}
+function getProject(id) {
+  const db = getDatabase();
+  const row = db.query("SELECT * FROM projects WHERE id = ?").get(id);
+  if (!row)
+    throw new ProjectNotFoundError(id);
+  return row;
+}
+function getProjectByName(name) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM projects WHERE name = ?").get(name) ?? null;
+}
+function listProjects() {
+  const db = getDatabase();
+  return db.query("SELECT * FROM projects ORDER BY created_at DESC").all();
+}
+function updateProject(id, data) {
+  const db = getDatabase();
+  const fields = [];
+  const values = [];
+  if (data.name !== undefined) {
+    fields.push("name = ?");
+    values.push(data.name);
+  }
+  if (data.path !== undefined) {
+    fields.push("path = ?");
+    values.push(data.path);
+  }
+  if (data.description !== undefined) {
+    fields.push("description = ?");
+    values.push(data.description ?? null);
+  }
+  if (fields.length === 0)
+    return getProject(id);
+  values.push(id);
+  db.prepare(`UPDATE projects SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+  return getProject(id);
+}
+function deleteProject(id) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM projects WHERE id = ?").run(id);
+}
+// src/db/agents.ts
+init_schema();
+init_types();
+import { randomUUID as randomUUID6 } from "crypto";
+function registerAgent(name, opts = {}) {
+  const db = getDatabase();
+  const existing = db.query("SELECT * FROM agents WHERE name = ?").get(name);
+  if (existing) {
+    db.prepare("UPDATE agents SET last_seen = datetime('now'), session_id = ?, project_id = ?, working_dir = ? WHERE name = ?").run(opts.sessionId ?? existing.session_id ?? null, opts.projectId ?? existing.project_id ?? null, opts.workingDir ?? existing.working_dir ?? null, name);
+    return getAgentByName(name);
+  }
+  const id = randomUUID6();
+  db.prepare("INSERT INTO agents (id, name, description, session_id, project_id, working_dir) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, opts.description ?? null, opts.sessionId ?? null, opts.projectId ?? null, opts.workingDir ?? null);
+  return getAgent(id);
+}
+function heartbeat(agentId) {
+  const db = getDatabase();
+  const agent = db.query("SELECT * FROM agents WHERE id = ?").get(agentId);
+  if (!agent)
+    throw new AgentNotFoundError(agentId);
+  db.prepare("UPDATE agents SET last_seen = datetime('now') WHERE id = ?").run(agentId);
+  db.prepare("INSERT INTO heartbeats (id, agent_id, session_id) VALUES (?, ?, ?)").run(randomUUID6(), agentId, agent.session_id ?? null);
+}
+function getAgent(id) {
+  const db = getDatabase();
+  const row = db.query("SELECT * FROM agents WHERE id = ?").get(id);
+  if (!row)
+    throw new AgentNotFoundError(id);
+  return row;
+}
+function getAgentByName(name) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM agents WHERE name = ?").get(name) ?? null;
+}
+function listAgents(projectId) {
+  const db = getDatabase();
+  if (projectId) {
+    return db.query("SELECT * FROM agents WHERE project_id = ? ORDER BY last_seen DESC").all(projectId);
+  }
+  return db.query("SELECT * FROM agents ORDER BY last_seen DESC").all();
+}
+function updateAgent(id, data) {
+  const db = getDatabase();
+  const fields = [];
+  const values = [];
+  if (data.name !== undefined) {
+    fields.push("name = ?");
+    values.push(data.name ?? null);
+  }
+  if (data.description !== undefined) {
+    fields.push("description = ?");
+    values.push(data.description ?? null);
+  }
+  if (data.session_id !== undefined) {
+    fields.push("session_id = ?");
+    values.push(data.session_id ?? null);
+  }
+  if (data.project_id !== undefined) {
+    fields.push("project_id = ?");
+    values.push(data.project_id ?? null);
+  }
+  if (data.working_dir !== undefined) {
+    fields.push("working_dir = ?");
+    values.push(data.working_dir ?? null);
+  }
+  if (fields.length === 0)
+    return getAgent(id);
+  values.push(id);
+  db.prepare(`UPDATE agents SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+  return getAgent(id);
+}
+function deleteAgent(id) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM agents WHERE id = ?").run(id);
+}
+function cleanStaleAgents(thresholdMs) {
+  const db = getDatabase();
+  const cutoff = new Date(Date.now() - thresholdMs).toISOString().replace("T", " ").split(".")[0];
+  const result = db.prepare("DELETE FROM agents WHERE last_seen < ?").run(cutoff);
+  return result.changes;
+}
+// src/db/snapshots.ts
+init_schema();
+import { randomUUID as randomUUID7 } from "crypto";
+function createSnapshot(data) {
+  const db = getDatabase();
+  const id = randomUUID7();
+  db.prepare("INSERT INTO snapshots (id, session_id, url, title, html, screenshot_path) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.session_id, data.url, data.title ?? null, data.html ?? null, data.screenshot_path ?? null);
+  return getSnapshot(id);
+}
+function getSnapshot(id) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM snapshots WHERE id = ?").get(id) ?? null;
+}
+function listSnapshots(sessionId) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM snapshots WHERE session_id = ? ORDER BY timestamp DESC").all(sessionId);
+}
+function deleteSnapshot(id) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM snapshots WHERE id = ?").run(id);
+}
+function deleteSnapshotsBySession(sessionId) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM snapshots WHERE session_id = ?").run(sessionId);
+}
+// src/db/recordings.ts
+init_schema();
+init_types();
+import { randomUUID as randomUUID8 } from "crypto";
+function deserialize2(row) {
+  return {
+    ...row,
+    project_id: row.project_id ?? undefined,
+    start_url: row.start_url ?? undefined,
+    steps: JSON.parse(row.steps)
+  };
+}
+function createRecording(data) {
+  const db = getDatabase();
+  const id = randomUUID8();
+  db.prepare("INSERT INTO recordings (id, name, project_id, start_url, steps) VALUES (?, ?, ?, ?, ?)").run(id, data.name, data.project_id ?? null, data.start_url ?? null, JSON.stringify(data.steps ?? []));
+  return getRecording(id);
+}
+function getRecording(id) {
+  const db = getDatabase();
+  const row = db.query("SELECT * FROM recordings WHERE id = ?").get(id);
+  if (!row)
+    throw new RecordingNotFoundError(id);
+  return deserialize2(row);
+}
+function listRecordings(projectId) {
+  const db = getDatabase();
+  const rows = projectId ? db.query("SELECT * FROM recordings WHERE project_id = ? ORDER BY created_at DESC").all(projectId) : db.query("SELECT * FROM recordings ORDER BY created_at DESC").all();
+  return rows.map(deserialize2);
+}
+function updateRecording(id, data) {
+  const db = getDatabase();
+  const fields = [];
+  const values = [];
+  if (data.name !== undefined) {
+    fields.push("name = ?");
+    values.push(data.name);
+  }
+  if (data.steps !== undefined) {
+    fields.push("steps = ?");
+    values.push(JSON.stringify(data.steps));
+  }
+  if (data.start_url !== undefined) {
+    fields.push("start_url = ?");
+    values.push(data.start_url ?? null);
+  }
+  if (fields.length === 0)
+    return getRecording(id);
+  values.push(id);
+  db.prepare(`UPDATE recordings SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+  return getRecording(id);
+}
+function deleteRecording(id) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM recordings WHERE id = ?").run(id);
+}
+// src/db/crawl-results.ts
+init_schema();
+import { randomUUID as randomUUID9 } from "crypto";
+function deserialize3(row) {
+  const pages = JSON.parse(row.pages);
+  return {
+    id: row.id,
+    project_id: row.project_id ?? undefined,
+    start_url: row.start_url,
+    depth: row.depth,
+    pages,
+    total_links: pages.reduce((acc, p) => acc + p.links.length, 0),
+    errors: JSON.parse(row.errors),
+    created_at: row.created_at
+  };
+}
+function createCrawlResult(data) {
+  const db = getDatabase();
+  const id = randomUUID9();
+  db.prepare("INSERT INTO crawl_results (id, project_id, start_url, depth, pages, links, errors) VALUES (?, ?, ?, ?, ?, ?, ?)").run(id, data.project_id ?? null, data.start_url, data.depth, JSON.stringify(data.pages), JSON.stringify(data.pages.flatMap((p) => p.links)), JSON.stringify(data.errors));
+  return getCrawlResult(id);
+}
+function getCrawlResult(id) {
+  const db = getDatabase();
+  const row = db.query("SELECT * FROM crawl_results WHERE id = ?").get(id);
+  return row ? deserialize3(row) : null;
+}
+function listCrawlResults(projectId) {
+  const db = getDatabase();
+  const rows = projectId ? db.query("SELECT * FROM crawl_results WHERE project_id = ? ORDER BY created_at DESC").all(projectId) : db.query("SELECT * FROM crawl_results ORDER BY created_at DESC").all();
+  return rows.map(deserialize3);
+}
+function deleteCrawlResult(id) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM crawl_results WHERE id = ?").run(id);
+}
+// src/db/heartbeats.ts
+init_schema();
+import { randomUUID as randomUUID10 } from "crypto";
+function recordHeartbeat(agentId, sessionId) {
+  const db = getDatabase();
+  const id = randomUUID10();
+  db.prepare("INSERT INTO heartbeats (id, agent_id, session_id) VALUES (?, ?, ?)").run(id, agentId, sessionId ?? null);
+  db.prepare("UPDATE agents SET last_seen = datetime('now') WHERE id = ?").run(agentId);
+  return getLastHeartbeat(agentId);
+}
+function getLastHeartbeat(agentId) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM heartbeats WHERE agent_id = ? ORDER BY timestamp DESC LIMIT 1").get(agentId) ?? null;
+}
+function listHeartbeats(agentId, limit = 50) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM heartbeats WHERE agent_id = ? ORDER BY timestamp DESC LIMIT ?").all(agentId, limit);
+}
+function cleanOldHeartbeats(olderThanMs) {
+  const db = getDatabase();
+  const cutoff = new Date(Date.now() - olderThanMs).toISOString().replace("T", " ").split(".")[0];
+  const result = db.prepare("DELETE FROM heartbeats WHERE timestamp < ?").run(cutoff);
+  return result.changes;
+}
+
+// src/index.ts
+init_cdp();
+init_actions();
+
 // src/lib/performance.ts
 init_cdp();
 async function getPerformanceMetrics(page) {
@@ -19706,247 +20125,6 @@ async function startCoverage(page) {
     }
   };
 }
-// src/lib/screenshot.ts
-init_types();
-var import_sharp = __toESM(require_lib3(), 1);
-import { join as join10 } from "path";
-import { mkdirSync as mkdirSync7 } from "fs";
-
-// src/db/gallery.ts
-init_schema();
-import { randomUUID as randomUUID10 } from "crypto";
-import { join as join9, resolve, relative as relative2, isAbsolute } from "path";
-function validateDataPath(filePath) {
-  if (filePath.includes("..")) {
-    throw new Error(`File path must not contain '..': ${filePath}`);
-  }
-  const dataDir = resolve(getDataDir2());
-  const resolved = resolve(isAbsolute(filePath) ? filePath : join9(dataDir, filePath));
-  const rel = relative2(dataDir, resolved);
-  if (rel.startsWith("..") || isAbsolute(rel)) {
-    throw new Error(`File path must be within data directory: ${filePath}`);
-  }
-  return filePath;
-}
-function deserialize3(row) {
-  return {
-    id: row.id,
-    session_id: row.session_id ?? undefined,
-    project_id: row.project_id ?? undefined,
-    url: row.url ?? undefined,
-    title: row.title ?? undefined,
-    path: row.path,
-    thumbnail_path: row.thumbnail_path ?? undefined,
-    format: row.format ?? undefined,
-    width: row.width ?? undefined,
-    height: row.height ?? undefined,
-    original_size_bytes: row.original_size_bytes ?? undefined,
-    compressed_size_bytes: row.compressed_size_bytes ?? undefined,
-    compression_ratio: row.compression_ratio ?? undefined,
-    tags: (() => {
-      try {
-        return JSON.parse(row.tags);
-      } catch {
-        return [];
-      }
-    })(),
-    notes: row.notes ?? undefined,
-    is_favorite: row.is_favorite === 1,
-    created_at: row.created_at
-  };
-}
-function createEntry(data) {
-  const db = getDatabase();
-  const id = randomUUID10();
-  validateDataPath(data.path);
-  if (data.thumbnail_path)
-    validateDataPath(data.thumbnail_path);
-  db.prepare(`
-    INSERT INTO gallery_entries
-      (id, session_id, project_id, url, title, path, thumbnail_path, format,
-       width, height, original_size_bytes, compressed_size_bytes, compression_ratio,
-       tags, notes, is_favorite)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(id, data.session_id ?? null, data.project_id ?? null, data.url ?? null, data.title ?? null, data.path, data.thumbnail_path ?? null, data.format ?? null, data.width ?? null, data.height ?? null, data.original_size_bytes ?? null, data.compressed_size_bytes ?? null, data.compression_ratio ?? null, JSON.stringify(data.tags ?? []), data.notes ?? null, data.is_favorite ? 1 : 0);
-  return getEntry(id);
-}
-function getEntry(id) {
-  const db = getDatabase();
-  const row = db.query("SELECT * FROM gallery_entries WHERE id = ?").get(id);
-  return row ? deserialize3(row) : null;
-}
-
-// src/lib/screenshot.ts
-init_schema();
-function getScreenshotDir(projectId) {
-  const base = join10(getDataDir2(), "screenshots");
-  const date = new Date().toISOString().split("T")[0];
-  const dir = projectId ? join10(base, projectId, date) : join10(base, date);
-  mkdirSync7(dir, { recursive: true });
-  return dir;
-}
-async function compressBuffer(raw, format, quality, maxWidth) {
-  let pipeline = import_sharp.default(raw).resize({ width: maxWidth, withoutEnlargement: true });
-  switch (format) {
-    case "webp":
-      return pipeline.webp({ quality, effort: 4 }).toBuffer();
-    case "jpeg":
-      return pipeline.jpeg({ quality, mozjpeg: true }).toBuffer();
-    case "png":
-      return pipeline.png({ compressionLevel: 9 }).toBuffer();
-  }
-}
-async function generateThumbnail(raw, dir, stem) {
-  const thumbPath = join10(dir, `${stem}.thumb.webp`);
-  const thumbBuffer = await import_sharp.default(raw).resize({ width: 200, withoutEnlargement: true }).webp({ quality: 70, effort: 3 }).toBuffer();
-  await Bun.write(thumbPath, thumbBuffer);
-  return { path: thumbPath, base64: thumbBuffer.toString("base64") };
-}
-async function takeScreenshot(page, opts) {
-  try {
-    const dir = getScreenshotDir(opts?.projectId);
-    const timestamp = Date.now();
-    const format = opts?.format ?? "webp";
-    const compress = opts?.compress ?? true;
-    const maxWidth = opts?.maxWidth ?? 1200;
-    const quality = opts?.quality ?? (format === "webp" ? 80 : format === "jpeg" ? 70 : undefined);
-    const stem = String(timestamp);
-    const rawOpts = {
-      fullPage: opts?.fullPage ?? false,
-      type: "png"
-    };
-    let rawBuffer;
-    const isBunView = typeof page.getNativeView === "function";
-    if (opts?.selector) {
-      if (isBunView) {
-        const uint8 = await page.screenshot();
-        rawBuffer = Buffer.from(uint8 instanceof Uint8Array ? uint8 : await uint8);
-      } else {
-        const el = await page.$(opts.selector);
-        if (!el)
-          throw new BrowserError(`Element not found: ${opts.selector}`, "ELEMENT_NOT_FOUND");
-        rawBuffer = await el.screenshot(rawOpts);
-      }
-    } else if (isBunView) {
-      const uint8 = await page.screenshot();
-      rawBuffer = Buffer.from(uint8 instanceof Uint8Array ? uint8 : await uint8);
-    } else {
-      rawBuffer = await page.screenshot(rawOpts);
-    }
-    const originalSizeBytes = rawBuffer.length;
-    const MAX_SIZE_BYTES = 500 * 1024;
-    let finalBuffer;
-    let compressed = true;
-    let fallback = false;
-    try {
-      if (compress && format !== "png") {
-        finalBuffer = await compressBuffer(rawBuffer, format, quality ?? 70, maxWidth);
-        if (finalBuffer.length > MAX_SIZE_BYTES) {
-          const reducedFormat = format === "webp" ? "webp" : "jpeg";
-          for (const q of [60, 50, 40, 30]) {
-            const attempt = await compressBuffer(rawBuffer, reducedFormat, q, maxWidth);
-            if (attempt.length <= MAX_SIZE_BYTES) {
-              finalBuffer = attempt;
-              break;
-            }
-          }
-        }
-      } else if (compress && format === "png") {
-        finalBuffer = await compressBuffer(rawBuffer, "png", quality ?? 9, maxWidth);
-      } else {
-        finalBuffer = rawBuffer;
-        compressed = false;
-      }
-    } catch (sharpErr) {
-      fallback = true;
-      compressed = false;
-      finalBuffer = rawBuffer;
-    }
-    const compressedSizeBytes = finalBuffer.length;
-    const compressionRatio = originalSizeBytes > 0 ? compressedSizeBytes / originalSizeBytes : 1;
-    const ext = format;
-    const screenshotPath = opts?.path ?? join10(dir, `${stem}.${ext}`);
-    await Bun.write(screenshotPath, finalBuffer);
-    let thumbnailPath;
-    let thumbnailBase64;
-    if (opts?.thumbnail !== false) {
-      const thumb = await generateThumbnail(rawBuffer, dir, stem);
-      thumbnailPath = thumb.path;
-      thumbnailBase64 = thumb.base64;
-    }
-    const meta = await import_sharp.default(finalBuffer).metadata();
-    const width = meta.width ?? (page.viewportSize()?.width ?? 1280);
-    const height = meta.height ?? (page.viewportSize()?.height ?? 720);
-    const result = {
-      path: screenshotPath,
-      base64: finalBuffer.toString("base64"),
-      width,
-      height,
-      size_bytes: compressedSizeBytes,
-      original_size_bytes: originalSizeBytes,
-      compressed_size_bytes: compressedSizeBytes,
-      compression_ratio: compressionRatio,
-      thumbnail_path: thumbnailPath,
-      thumbnail_base64: thumbnailBase64,
-      ...fallback ? { fallback: true, compressed: false } : {}
-    };
-    if (opts?.track !== false) {
-      try {
-        const url = await page.url().valueOf();
-        let title;
-        try {
-          title = await page.title();
-        } catch {}
-        const entry = createEntry({
-          session_id: opts?.sessionId,
-          project_id: opts?.projectId,
-          url,
-          title,
-          path: screenshotPath,
-          thumbnail_path: thumbnailPath,
-          format: ext,
-          width,
-          height,
-          original_size_bytes: originalSizeBytes,
-          compressed_size_bytes: compressedSizeBytes,
-          compression_ratio: compressionRatio,
-          tags: [],
-          is_favorite: false
-        });
-        result.gallery_id = entry.id;
-      } catch {}
-    }
-    return result;
-  } catch (err) {
-    if (err instanceof BrowserError)
-      throw err;
-    throw new BrowserError(`Screenshot failed: ${err instanceof Error ? err.message : String(err)}`, "SCREENSHOT_FAILED");
-  }
-}
-async function generatePDF(page, opts) {
-  try {
-    const base = join10(getDataDir2(), "pdfs");
-    const date = new Date().toISOString().split("T")[0];
-    const dir = opts?.projectId ? join10(base, opts.projectId, date) : join10(base, date);
-    mkdirSync7(dir, { recursive: true });
-    const timestamp = Date.now();
-    const pdfPath = opts?.path ?? join10(dir, `${timestamp}.pdf`);
-    const buffer = await page.pdf({
-      path: pdfPath,
-      format: opts?.format ?? "A4",
-      landscape: opts?.landscape ?? false,
-      margin: opts?.margin,
-      printBackground: opts?.printBackground ?? true
-    });
-    return {
-      path: pdfPath,
-      base64: Buffer.from(buffer).toString("base64"),
-      size_bytes: buffer.length
-    };
-  } catch (err) {
-    throw new BrowserError(`PDF generation failed: ${err instanceof Error ? err.message : String(err)}`, "PDF_FAILED");
-  }
-}
 // src/lib/storage.ts
 async function getCookies(page, filter) {
   const cookies = await page.context().cookies();
@@ -20404,6 +20582,7 @@ export {
   createRecording,
   createProject,
   createCrawlResult,
+  createBrowserSDK,
   crawl,
   countActiveSessions2 as countActiveSessions,
   connectToExistingBrowser,
@@ -20438,6 +20617,7 @@ export {
   EngineNotAvailableError,
   ElementNotFoundError,
   CDPClient,
+  BrowserSDK,
   BrowserPool,
   BrowserError,
   AgentNotFoundError