@hasna/browser 0.2.1 → 0.2.3

package/dist/cli/index.js

@@ -19363,14 +19363,24 @@ var init_dist = __esm(() => {
 var exports_login_scripts = {};
 __export(exports_login_scripts, {
   saveScript: () => saveScript,
+  runScriptAsync: () => runScriptAsync,
   runScript: () => runScript,
   loadScript: () => loadScript,
   listScripts: () => listScripts,
+  listJobs: () => listJobs,
+  getJob: () => getJob,
   deleteScript: () => deleteScript,
   createUsestableScript: () => createUsestableScript
 });
+import { randomUUID as randomUUID10 } from "crypto";
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, existsSync as existsSync6, mkdirSync as mkdirSync8, readdirSync as readdirSync4 } from "fs";
 import { join as join9 } from "path";
+function getJob(jobId) {
+  return activeJobs.get(jobId) ?? null;
+}
+function listJobs() {
+  return Array.from(activeJobs.values());
+}
 function getScriptsDir() {
   const dir = join9(getDataDir(), "scripts");
   mkdirSync8(dir, { recursive: true });
@@ -19417,15 +19427,34 @@ function interpolate(template, vars) {
     return vars[key] ?? match;
   });
 }
-async function runScript(script, page, overrides = {}) {
+function stepDescription(step) {
+  return step.description ?? `${step.type}${step.action ? `:${step.action}` : ""}${step.connector ? `:${step.connector}` : ""}`;
+}
+async function runScript(script, page, overrides = {}, jobId) {
   const t0 = Date.now();
   const vars = { ...script.variables, ...overrides };
   const errors = [];
   let executed = 0;
   let failed = 0;
+  const job = jobId && activeJobs.has(jobId) ? activeJobs.get(jobId) : {
+    id: jobId ?? randomUUID10(),
+    script_name: script.name,
+    status: "running",
+    current_step: 0,
+    total_steps: script.steps.length,
+    current_step_description: "Starting...",
+    steps_log: [],
+    started_at: new Date().toISOString()
+  };
+  activeJobs.set(job.id, job);
   for (let i = 0;i < script.steps.length; i++) {
     const step = script.steps[i];
+    const desc = stepDescription(step);
     executed++;
+    job.current_step = i + 1;
+    job.current_step_description = desc;
+    job.steps_log.push({ step: i + 1, type: step.type, description: desc, status: "running" });
+    const stepStart = Date.now();
     try {
       switch (step.type) {
         case "browser":
@@ -19462,15 +19491,22 @@ async function runScript(script, page, overrides = {}) {
           break;
         }
       }
+      const logEntry = job.steps_log[job.steps_log.length - 1];
+      logEntry.status = "ok";
+      logEntry.duration_ms = Date.now() - stepStart;
     } catch (err) {
       failed++;
       const msg = `Step ${i + 1} (${step.type}/${step.action ?? step.connector ?? ""}): ${err instanceof Error ? err.message : String(err)}`;
       errors.push(msg);
+      const logEntry = job.steps_log[job.steps_log.length - 1];
+      logEntry.status = "failed";
+      logEntry.error = err instanceof Error ? err.message : String(err);
+      logEntry.duration_ms = Date.now() - stepStart;
       if (step.type === "browser" && step.action === "navigate")
         break;
     }
   }
-  return {
+  const result = {
     success: failed === 0,
     steps_executed: executed,
     steps_failed: failed,
@@ -19478,6 +19514,28 @@ async function runScript(script, page, overrides = {}) {
     errors,
     duration_ms: Date.now() - t0
   };
+  job.status = failed === 0 ? "completed" : "failed";
+  job.result = result;
+  return result;
+}
+function runScriptAsync(script, page, overrides = {}) {
+  const jobId = randomUUID10();
+  const job = {
+    id: jobId,
+    script_name: script.name,
+    status: "running",
+    current_step: 0,
+    total_steps: script.steps.length,
+    current_step_description: "Starting...",
+    steps_log: [],
+    started_at: new Date().toISOString()
+  };
+  activeJobs.set(jobId, job);
+  runScript(script, page, overrides, jobId).catch((err) => {
+    job.status = "failed";
+    job.current_step_description = `Fatal error: ${err instanceof Error ? err.message : String(err)}`;
+  });
+  return jobId;
 }
 async function runBrowserStep(step, page, vars) {
   const action = step.action;
@@ -19565,6 +19623,9 @@ async function runConnectorStep(step, vars) {
     vars[step.save_as] = result.stdout;
   }
 }
+function decodeHtmlEntities(str) {
+  return str.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&#x27;/g, "'");
+}
 function runExtractStep(step, vars) {
   const saveTo = step.save_as ?? "extracted";
   if (step.pattern) {
@@ -19572,7 +19633,7 @@ function runExtractStep(step, vars) {
     const regex = new RegExp(step.pattern);
     const match = regex.exec(source);
     if (match) {
-      vars[saveTo] = match[1] ?? match[0];
+      vars[saveTo] = decodeHtmlEntities(match[1] ?? match[0]);
     }
   }
   if (step.json_path) {
@@ -19637,8 +19698,10 @@ function createUsestableScript(email) {
     updated_at: new Date().toISOString()
   };
 }
+var activeJobs;
 var init_login_scripts = __esm(() => {
   init_schema();
+  activeJobs = new Map;
 });
 
 // src/lib/daemon-client.ts
@@ -23767,7 +23830,7 @@ __export(exports_downloads, {
   deleteDownload: () => deleteDownload,
   cleanStaleDownloads: () => cleanStaleDownloads
 });
-import { randomUUID as randomUUID10 } from "crypto";
+import { randomUUID as randomUUID11 } from "crypto";
 import { join as join11, basename, extname } from "path";
 import { mkdirSync as mkdirSync9, existsSync as existsSync8, readdirSync as readdirSync5, statSync as statSync2, unlinkSync as unlinkSync2, copyFileSync, writeFileSync as writeFileSync4, readFileSync as readFileSync6 } from "fs";
 import { homedir as homedir10 } from "os";
@@ -23788,7 +23851,7 @@ function metaPath(filePath) {
 }
 function saveToDownloads(buffer, filename, opts) {
   const dir = getDownloadsDir(opts?.sessionId);
-  const id = randomUUID10();
+  const id = randomUUID11();
   const ext = extname(filename) || "";
   const stem = basename(filename, ext);
   const uniqueName = `${stem}-${id.slice(0, 8)}${ext}`;
@@ -24196,10 +24259,10 @@ __export(exports_workflows, {
   getWorkflow: () => getWorkflow,
   deleteWorkflow: () => deleteWorkflow
 });
-import { randomUUID as randomUUID11 } from "crypto";
+import { randomUUID as randomUUID12 } from "crypto";
 function saveWorkflow(data) {
   const db = getDatabase();
-  const id = randomUUID11();
+  const id = randomUUID12();
   db.prepare("INSERT OR REPLACE INTO workflows (id, name, description, steps, start_url) VALUES (?, ?, ?, ?, ?)").run(id, data.name, data.description ?? null, JSON.stringify(data.steps), data.startUrl ?? null);
   return getWorkflow(id);
 }
@@ -24359,10 +24422,10 @@ __export(exports_auth_flow, {
   getAuthFlow: () => getAuthFlow,
   deleteAuthFlow: () => deleteAuthFlow
 });
-import { randomUUID as randomUUID12 } from "crypto";
+import { randomUUID as randomUUID13 } from "crypto";
 function saveAuthFlow(data) {
   const db = getDatabase();
-  const id = randomUUID12();
+  const id = randomUUID13();
   db.prepare("INSERT OR REPLACE INTO auth_flows (id, name, domain, recording_id, storage_state_path) VALUES (?, ?, ?, ?, ?)").run(id, data.name, data.domain, data.recordingId ?? null, data.storageStatePath ?? null);
   return getAuthFlow(id);
 }
@@ -24542,13 +24605,13 @@ __export(exports_datasets, {
   exportDataset: () => exportDataset,
   deleteDataset: () => deleteDataset
 });
-import { randomUUID as randomUUID13 } from "crypto";
+import { randomUUID as randomUUID14 } from "crypto";
 import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync11 } from "fs";
 import { join as join13 } from "path";
 import { homedir as homedir12 } from "os";
 function saveDataset(data) {
   const db = getDatabase();
-  const id = randomUUID13();
+  const id = randomUUID14();
   const existing = db.query("SELECT id FROM datasets WHERE name = ?").get(data.name);
   if (existing) {
     db.prepare("UPDATE datasets SET data = ?, row_count = ?, source_url = ?, schema = ?, last_refresh = datetime('now'), updated_at = datetime('now') WHERE name = ?").run(JSON.stringify(data.rows), data.rows.length, data.sourceUrl ?? null, data.schema ? JSON.stringify(data.schema) : null, data.name);
@@ -29349,7 +29412,7 @@ import { Database as Database3 } from "bun:sqlite";
 import { mkdirSync as mkdirSync13 } from "fs";
 import { join as join15, dirname as dirname6 } from "path";
 import { homedir as homedir14 } from "os";
-import { randomUUID as randomUUID14 } from "crypto";
+import { randomUUID as randomUUID15 } from "crypto";
 import { mkdirSync as mkdirSync23, copyFileSync as copyFileSync3, statSync as statSync3 } from "fs";
 import { join as join34 } from "path";
 import { homedir as homedir33 } from "os";
@@ -29729,7 +29792,7 @@ function guessMimeType(name) {
 function sendMessage(opts) {
   const db2 = getDb();
   const explicitSession = opts.session_id && opts.session_id.trim().length > 0 ? opts.session_id : undefined;
-  const sessionId = explicitSession ?? (opts.space ? `space:${opts.space}` : `${[opts.from, opts.to].sort().join("-")}-${randomUUID14().slice(0, 8)}`);
+  const sessionId = explicitSession ?? (opts.space ? `space:${opts.space}` : `${[opts.from, opts.to].sort().join("-")}-${randomUUID15().slice(0, 8)}`);
   const metadata = opts.metadata ? JSON.stringify(opts.metadata) : null;
   const normalizedPriority = opts.priority === "low" || opts.priority === "normal" || opts.priority === "high" || opts.priority === "urgent" ? opts.priority : "normal";
   const blocking = opts.blocking ? 1 : 0;
@@ -41418,7 +41481,7 @@ __export(exports_cron_manager, {
   deleteCronJob: () => deleteCronJob,
   createCronJob: () => createCronJob
 });
-import { randomUUID as randomUUID15 } from "crypto";
+import { randomUUID as randomUUID16 } from "crypto";
 function ensureCronTable() {
   const db2 = getDatabase();
   db2.exec(`
@@ -41447,7 +41510,7 @@ function ensureCronTable() {
 function createCronJob(schedule, task, name) {
   ensureCronTable();
   const db2 = getDatabase();
-  const id = randomUUID15();
+  const id = randomUUID16();
   db2.prepare(`
     INSERT INTO cron_jobs (id, name, schedule, task_json, enabled)
     VALUES (?, ?, ?, ?, 1)
@@ -41505,7 +41568,7 @@ function getCronEvents(jobId, limit = 10) {
 async function executeCronJob(job) {
   ensureCronTable();
   const db2 = getDatabase();
-  const eventId = randomUUID15();
+  const eventId = randomUUID16();
   const startedAt = new Date().toISOString();
   db2.prepare("INSERT INTO cron_events (id, job_id, started_at) VALUES (?, ?, ?)").run(eventId, job.id, startedAt);
   try {
@@ -41596,7 +41659,7 @@ __export(exports_url_watcher, {
   deleteWatchJob: () => deleteWatchJob,
   createWatchJob: () => createWatchJob
 });
-import { randomUUID as randomUUID16 } from "crypto";
+import { randomUUID as randomUUID17 } from "crypto";
 import { createHash } from "crypto";
 function ensureWatchTables() {
   const db2 = getDatabase();
@@ -41628,7 +41691,7 @@ function ensureWatchTables() {
 function createWatchJob(url, schedule, opts) {
   ensureWatchTables();
   const db2 = getDatabase();
-  const id = randomUUID16();
+  const id = randomUUID17();
   db2.prepare(`
     INSERT INTO watch_jobs (id, name, url, schedule, selector, extract_schema, enabled)
     VALUES (?, ?, ?, ?, ?, ?, 1)
@@ -41664,7 +41727,7 @@ function getWatchEvents(watchId, limit = 20) {
 async function checkWatchJob(job) {
   ensureWatchTables();
   const db2 = getDatabase();
-  const eventId = randomUUID16();
+  const eventId = randomUUID17();
   const checkedAt = new Date().toISOString();
   let newContent = "";
   try {
@@ -43571,13 +43634,13 @@ var init_mcp = __esm(async () => {
       return err(e);
     }
   });
-  server.tool("browser_script_run", "Run a saved login script \u2014 multi-step workflow combining browser actions + connector calls (e.g. magic link login via Gmail). One command, fully automated.", {
+  server.tool("browser_script_run", "Run a saved login script asynchronously. Returns a job_id immediately \u2014 poll with browser_script_status for step-by-step progress. Combines browser actions + connector calls (e.g. magic link login via Gmail).", {
     name: exports_external.string().describe("Script name (e.g. 'usestable')"),
     session_id: exports_external.string().optional(),
     variables: exports_external.record(exports_external.string()).optional().describe("Override script variables (e.g. {email: 'foo@bar.com'})")
   }, async ({ name, session_id, variables }) => {
     try {
-      const { loadScript: loadScript2, runScript: runScript2 } = await Promise.resolve().then(() => (init_login_scripts(), exports_login_scripts));
+      const { loadScript: loadScript2, runScriptAsync: runScriptAsync2 } = await Promise.resolve().then(() => (init_login_scripts(), exports_login_scripts));
       const script = loadScript2(name);
       if (!script)
         return err(new Error(`Script '${name}' not found. Use browser_script_list to see available scripts.`));
@@ -43587,12 +43650,29 @@ var init_mcp = __esm(async () => {
         sid = resolveSessionId(session_id);
         page = getSessionPage(sid);
       } else {
-        const result2 = await createSession2({ headless: true });
-        sid = result2.session.id;
-        page = result2.page;
+        const result = await createSession2({ headless: true });
+        sid = result.session.id;
+        page = result.page;
       }
-      const result = await runScript2(script, page, variables ?? {});
-      return json({ ...result, session_id: sid, url: page.url() });
+      const jobId = runScriptAsync2(script, page, variables ?? {});
+      return json({ job_id: jobId, session_id: sid, script: name, total_steps: script.steps.length, message: "Script running in background. Poll with browser_script_status for progress." });
+    } catch (e) {
+      return err(e);
+    }
+  });
+  server.tool("browser_script_status", "Check the progress of a running login script. Shows current step, step-by-step log with durations, and final result when complete.", { job_id: exports_external.string() }, async ({ job_id }) => {
+    try {
+      const { getJob: getJob2 } = await Promise.resolve().then(() => (init_login_scripts(), exports_login_scripts));
+      const job = getJob2(job_id);
+      if (!job)
+        return err(new Error(`Job '${job_id}' not found`));
+      return json({
+        status: job.status,
+        progress: `${job.current_step}/${job.total_steps}`,
+        current_step: job.current_step_description,
+        steps_log: job.steps_log,
+        result: job.result ?? undefined
+      });
     } catch (e) {
       return err(e);
     }
@@ -44362,10 +44442,10 @@ __export(exports_snapshots, {
   deleteSnapshot: () => deleteSnapshot,
   createSnapshot: () => createSnapshot
 });
-import { randomUUID as randomUUID17 } from "crypto";
+import { randomUUID as randomUUID18 } from "crypto";
 function createSnapshot(data) {
   const db2 = getDatabase();
-  const id = randomUUID17();
+  const id = randomUUID18();
   db2.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);
 }

package/dist/lib/login-scripts.d.ts

@@ -45,6 +45,26 @@ export interface ScriptRunResult {
     errors: string[];
     duration_ms: number;
 }
+export interface ScriptJob {
+    id: string;
+    script_name: string;
+    status: "running" | "completed" | "failed";
+    current_step: number;
+    total_steps: number;
+    current_step_description: string;
+    steps_log: Array<{
+        step: number;
+        type: string;
+        description: string;
+        status: "ok" | "failed" | "running";
+        duration_ms?: number;
+        error?: string;
+    }>;
+    result?: ScriptRunResult;
+    started_at: string;
+}
+export declare function getJob(jobId: string): ScriptJob | null;
+export declare function listJobs(): ScriptJob[];
 export declare function saveScript(script: LoginScript): string;
 export declare function loadScript(name: string): LoginScript | null;
 export declare function listScripts(): Array<{
@@ -54,6 +74,11 @@ export declare function listScripts(): Array<{
     steps: number;
 }>;
 export declare function deleteScript(name: string): boolean;
-export declare function runScript(script: LoginScript, page: Page, overrides?: Record<string, string>): Promise<ScriptRunResult>;
+export declare function runScript(script: LoginScript, page: Page, overrides?: Record<string, string>, jobId?: string): Promise<ScriptRunResult>;
+/**
+ * Run a script asynchronously — returns immediately with a job ID.
+ * Poll with getJob(jobId) for progress.
+ */
+export declare function runScriptAsync(script: LoginScript, page: Page, overrides?: Record<string, string>): string;
 export declare function createUsestableScript(email: string): LoginScript;
 //# sourceMappingURL=login-scripts.d.ts.map

package/dist/lib/login-scripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login-scripts.d.ts","sourceRoot":"","sources":["../../src/lib/login-scripts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC;AAEjG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,qBAAqB,GAAG,eAAe,GAAG,UAAU,CAAC;IAC7G,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAUD,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAOtD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI3D;AAED,wBAAgB,WAAW,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAY1G;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMlD;AAYD,wBAAsB,SAAS,CAC7B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACrC,OAAO,CAAC,eAAe,CAAC,CAmE1B;AAmID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CA2ChE"}
+{"version":3,"file":"login-scripts.d.ts","sourceRoot":"","sources":["../../src/lib/login-scripts.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.js

@@ -17120,14 +17120,24 @@ var init_dist = __esm(() => {
 var exports_login_scripts = {};
 __export(exports_login_scripts, {
   saveScript: () => saveScript,
+  runScriptAsync: () => runScriptAsync,
   runScript: () => runScript,
   loadScript: () => loadScript,
   listScripts: () => listScripts,
+  listJobs: () => listJobs,
+  getJob: () => getJob,
   deleteScript: () => deleteScript,
   createUsestableScript: () => createUsestableScript
 });
+import { randomUUID as randomUUID12 } from "crypto";
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync6, mkdirSync as mkdirSync10, readdirSync as readdirSync5 } from "fs";
 import { join as join10 } from "path";
+function getJob(jobId) {
+  return activeJobs.get(jobId) ?? null;
+}
+function listJobs() {
+  return Array.from(activeJobs.values());
+}
 function getScriptsDir() {
   const dir = join10(getDataDir(), "scripts");
   mkdirSync10(dir, { recursive: true });
@@ -17174,15 +17184,34 @@ function interpolate(template, vars) {
     return vars[key] ?? match;
   });
 }
-async function runScript(script, page, overrides = {}) {
+function stepDescription(step) {
+  return step.description ?? `${step.type}${step.action ? `:${step.action}` : ""}${step.connector ? `:${step.connector}` : ""}`;
+}
+async function runScript(script, page, overrides = {}, jobId) {
   const t0 = Date.now();
   const vars = { ...script.variables, ...overrides };
   const errors2 = [];
   let executed = 0;
   let failed = 0;
+  const job = jobId && activeJobs.has(jobId) ? activeJobs.get(jobId) : {
+    id: jobId ?? randomUUID12(),
+    script_name: script.name,
+    status: "running",
+    current_step: 0,
+    total_steps: script.steps.length,
+    current_step_description: "Starting...",
+    steps_log: [],
+    started_at: new Date().toISOString()
+  };
+  activeJobs.set(job.id, job);
   for (let i = 0;i < script.steps.length; i++) {
     const step = script.steps[i];
+    const desc = stepDescription(step);
     executed++;
+    job.current_step = i + 1;
+    job.current_step_description = desc;
+    job.steps_log.push({ step: i + 1, type: step.type, description: desc, status: "running" });
+    const stepStart = Date.now();
     try {
       switch (step.type) {
         case "browser":
@@ -17219,15 +17248,22 @@ async function runScript(script, page, overrides = {}) {
           break;
         }
       }
+      const logEntry = job.steps_log[job.steps_log.length - 1];
+      logEntry.status = "ok";
+      logEntry.duration_ms = Date.now() - stepStart;
     } catch (err) {
       failed++;
       const msg = `Step ${i + 1} (${step.type}/${step.action ?? step.connector ?? ""}): ${err instanceof Error ? err.message : String(err)}`;
       errors2.push(msg);
+      const logEntry = job.steps_log[job.steps_log.length - 1];
+      logEntry.status = "failed";
+      logEntry.error = err instanceof Error ? err.message : String(err);
+      logEntry.duration_ms = Date.now() - stepStart;
       if (step.type === "browser" && step.action === "navigate")
         break;
     }
   }
-  return {
+  const result = {
     success: failed === 0,
     steps_executed: executed,
     steps_failed: failed,
@@ -17235,6 +17271,28 @@ async function runScript(script, page, overrides = {}) {
     errors: errors2,
     duration_ms: Date.now() - t0
   };
+  job.status = failed === 0 ? "completed" : "failed";
+  job.result = result;
+  return result;
+}
+function runScriptAsync(script, page, overrides = {}) {
+  const jobId = randomUUID12();
+  const job = {
+    id: jobId,
+    script_name: script.name,
+    status: "running",
+    current_step: 0,
+    total_steps: script.steps.length,
+    current_step_description: "Starting...",
+    steps_log: [],
+    started_at: new Date().toISOString()
+  };
+  activeJobs.set(jobId, job);
+  runScript(script, page, overrides, jobId).catch((err) => {
+    job.status = "failed";
+    job.current_step_description = `Fatal error: ${err instanceof Error ? err.message : String(err)}`;
+  });
+  return jobId;
 }
 async function runBrowserStep(step, page, vars) {
   const action = step.action;
@@ -17322,6 +17380,9 @@ async function runConnectorStep(step, vars) {
     vars[step.save_as] = result.stdout;
   }
 }
+function decodeHtmlEntities(str) {
+  return str.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&#x27;/g, "'");
+}
 function runExtractStep(step, vars) {
   const saveTo = step.save_as ?? "extracted";
   if (step.pattern) {
@@ -17329,7 +17390,7 @@ function runExtractStep(step, vars) {
     const regex = new RegExp(step.pattern);
     const match = regex.exec(source);
     if (match) {
-      vars[saveTo] = match[1] ?? match[0];
+      vars[saveTo] = decodeHtmlEntities(match[1] ?? match[0]);
     }
   }
   if (step.json_path) {
@@ -17394,8 +17455,10 @@ function createUsestableScript(email) {
     updated_at: new Date().toISOString()
   };
 }
+var activeJobs;
 var init_login_scripts = __esm(() => {
   init_schema();
+  activeJobs = new Map;
 });
 
 // src/lib/api-detector.ts
@@ -17404,7 +17467,7 @@ __export(exports_api_detector, {
   listDiscoveredAPIs: () => listDiscoveredAPIs,
   detectAPIs: () => detectAPIs
 });
-import { randomUUID as randomUUID12 } from "crypto";
+import { randomUUID as randomUUID13 } from "crypto";
 function detectAPIs(sessionId) {
   const db = getDatabase();
   const requests = db.query(`SELECT method, url, status_code, response_headers, body_size
@@ -17440,7 +17503,7 @@ function detectAPIs(sessionId) {
   }
   const apis = Array.from(seen.values());
   for (const api of apis) {
-    const id = randomUUID12();
+    const id = randomUUID13();
     db.prepare("INSERT OR IGNORE INTO api_endpoints (id, session_id, url, method, status_code, content_type) VALUES (?, ?, ?, ?, ?, ?)").run(id, sessionId, api.url, api.method, api.status_code, api.content_type);
   }
   return apis;
@@ -17545,13 +17608,13 @@ __export(exports_datasets, {
   exportDataset: () => exportDataset,
   deleteDataset: () => deleteDataset
 });
-import { randomUUID as randomUUID13 } from "crypto";
+import { randomUUID as randomUUID14 } from "crypto";
 import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync11 } from "fs";
 import { join as join11 } from "path";
 import { homedir as homedir10 } from "os";
 function saveDataset(data) {
   const db = getDatabase();
-  const id = randomUUID13();
+  const id = randomUUID14();
   const existing = db.query("SELECT id FROM datasets WHERE name = ?").get(data.name);
   if (existing) {
     db.prepare("UPDATE datasets SET data = ?, row_count = ?, source_url = ?, schema = ?, last_refresh = datetime('now'), updated_at = datetime('now') WHERE name = ?").run(JSON.stringify(data.rows), data.rows.length, data.sourceUrl ?? null, data.schema ? JSON.stringify(data.schema) : null, data.name);
@@ -22442,7 +22505,7 @@ import { Database as Database3 } from "bun:sqlite";
 import { mkdirSync as mkdirSync13 } from "fs";
 import { join as join14, dirname as dirname6 } from "path";
 import { homedir as homedir13 } from "os";
-import { randomUUID as randomUUID14 } from "crypto";
+import { randomUUID as randomUUID15 } from "crypto";
 import { mkdirSync as mkdirSync23, copyFileSync as copyFileSync3, statSync as statSync3 } from "fs";
 import { join as join34 } from "path";
 import { homedir as homedir33 } from "os";
@@ -22822,7 +22885,7 @@ function guessMimeType(name) {
 function sendMessage(opts) {
   const db2 = getDb();
   const explicitSession = opts.session_id && opts.session_id.trim().length > 0 ? opts.session_id : undefined;
-  const sessionId = explicitSession ?? (opts.space ? `space:${opts.space}` : `${[opts.from, opts.to].sort().join("-")}-${randomUUID14().slice(0, 8)}`);
+  const sessionId = explicitSession ?? (opts.space ? `space:${opts.space}` : `${[opts.from, opts.to].sort().join("-")}-${randomUUID15().slice(0, 8)}`);
   const metadata = opts.metadata ? JSON.stringify(opts.metadata) : null;
   const normalizedPriority = opts.priority === "low" || opts.priority === "normal" || opts.priority === "high" || opts.priority === "urgent" ? opts.priority : "normal";
   const blocking = opts.blocking ? 1 : 0;
@@ -34511,7 +34574,7 @@ __export(exports_cron_manager, {
   deleteCronJob: () => deleteCronJob,
   createCronJob: () => createCronJob
 });
-import { randomUUID as randomUUID15 } from "crypto";
+import { randomUUID as randomUUID16 } from "crypto";
 function ensureCronTable() {
   const db2 = getDatabase();
   db2.exec(`
@@ -34540,7 +34603,7 @@ function ensureCronTable() {
 function createCronJob(schedule, task, name) {
   ensureCronTable();
   const db2 = getDatabase();
-  const id = randomUUID15();
+  const id = randomUUID16();
   db2.prepare(`
     INSERT INTO cron_jobs (id, name, schedule, task_json, enabled)
     VALUES (?, ?, ?, ?, 1)
@@ -34598,7 +34661,7 @@ function getCronEvents(jobId, limit = 10) {
 async function executeCronJob(job) {
   ensureCronTable();
   const db2 = getDatabase();
-  const eventId = randomUUID15();
+  const eventId = randomUUID16();
   const startedAt = new Date().toISOString();
   db2.prepare("INSERT INTO cron_events (id, job_id, started_at) VALUES (?, ?, ?)").run(eventId, job.id, startedAt);
   try {
@@ -34689,7 +34752,7 @@ __export(exports_url_watcher, {
   deleteWatchJob: () => deleteWatchJob,
   createWatchJob: () => createWatchJob
 });
-import { randomUUID as randomUUID16 } from "crypto";
+import { randomUUID as randomUUID17 } from "crypto";
 import { createHash } from "crypto";
 function ensureWatchTables() {
   const db2 = getDatabase();
@@ -34721,7 +34784,7 @@ function ensureWatchTables() {
 function createWatchJob(url, schedule, opts) {
   ensureWatchTables();
   const db2 = getDatabase();
-  const id = randomUUID16();
+  const id = randomUUID17();
   db2.prepare(`
     INSERT INTO watch_jobs (id, name, url, schedule, selector, extract_schema, enabled)
     VALUES (?, ?, ?, ?, ?, ?, 1)
@@ -34757,7 +34820,7 @@ function getWatchEvents(watchId, limit = 20) {
 async function checkWatchJob(job) {
   ensureWatchTables();
   const db2 = getDatabase();
-  const eventId = randomUUID16();
+  const eventId = randomUUID17();
   const checkedAt = new Date().toISOString();
   let newContent = "";
   try {
@@ -41384,13 +41447,13 @@ server.tool("browser_profile_delete", "Delete a saved browser profile", { name:
     return err(e);
   }
 });
-server.tool("browser_script_run", "Run a saved login script \u2014 multi-step workflow combining browser actions + connector calls (e.g. magic link login via Gmail). One command, fully automated.", {
+server.tool("browser_script_run", "Run a saved login script asynchronously. Returns a job_id immediately \u2014 poll with browser_script_status for step-by-step progress. Combines browser actions + connector calls (e.g. magic link login via Gmail).", {
   name: exports_external.string().describe("Script name (e.g. 'usestable')"),
   session_id: exports_external.string().optional(),
   variables: exports_external.record(exports_external.string()).optional().describe("Override script variables (e.g. {email: 'foo@bar.com'})")
 }, async ({ name, session_id, variables }) => {
   try {
-    const { loadScript: loadScript2, runScript: runScript2 } = await Promise.resolve().then(() => (init_login_scripts(), exports_login_scripts));
+    const { loadScript: loadScript2, runScriptAsync: runScriptAsync2 } = await Promise.resolve().then(() => (init_login_scripts(), exports_login_scripts));
     const script = loadScript2(name);
     if (!script)
       return err(new Error(`Script '${name}' not found. Use browser_script_list to see available scripts.`));
@@ -41400,12 +41463,29 @@ server.tool("browser_script_run", "Run a saved login script \u2014 multi-step wo
       sid = resolveSessionId(session_id);
       page = getSessionPage(sid);
     } else {
-      const result2 = await createSession2({ headless: true });
-      sid = result2.session.id;
-      page = result2.page;
+      const result = await createSession2({ headless: true });
+      sid = result.session.id;
+      page = result.page;
     }
-    const result = await runScript2(script, page, variables ?? {});
-    return json({ ...result, session_id: sid, url: page.url() });
+    const jobId = runScriptAsync2(script, page, variables ?? {});
+    return json({ job_id: jobId, session_id: sid, script: name, total_steps: script.steps.length, message: "Script running in background. Poll with browser_script_status for progress." });
+  } catch (e) {
+    return err(e);
+  }
+});
+server.tool("browser_script_status", "Check the progress of a running login script. Shows current step, step-by-step log with durations, and final result when complete.", { job_id: exports_external.string() }, async ({ job_id }) => {
+  try {
+    const { getJob: getJob2 } = await Promise.resolve().then(() => (init_login_scripts(), exports_login_scripts));
+    const job = getJob2(job_id);
+    if (!job)
+      return err(new Error(`Job '${job_id}' not found`));
+    return json({
+      status: job.status,
+      progress: `${job.current_step}/${job.total_steps}`,
+      current_step: job.current_step_description,
+      steps_log: job.steps_log,
+      result: job.result ?? undefined
+    });
   } catch (e) {
     return err(e);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/browser",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "General-purpose browser agent toolkit — Playwright, Chrome DevTools Protocol, Lightpanda with auto engine selection. CLI + MCP + REST + SDK.",
   "type": "module",
   "main": "dist/index.js",