@hasna/testers 0.0.2 → 0.0.4

package/dist/mcp/index.js

@@ -4080,7 +4080,10 @@ function screenshotFromRow(row) {
     filePath: row.file_path,
     width: row.width,
     height: row.height,
-    timestamp: row.timestamp
+    timestamp: row.timestamp,
+    description: row.description,
+    pageUrl: row.page_url,
+    thumbnailPath: row.thumbnail_path
   };
 }
 function scheduleFromRow(row) {
@@ -4289,6 +4292,34 @@ var MIGRATIONS = [
   CREATE INDEX IF NOT EXISTS idx_schedules_project ON schedules(project_id);
   CREATE INDEX IF NOT EXISTS idx_schedules_enabled ON schedules(enabled);
   CREATE INDEX IF NOT EXISTS idx_schedules_next_run ON schedules(next_run_at);
+  `,
+  `
+  ALTER TABLE screenshots ADD COLUMN description TEXT;
+  ALTER TABLE screenshots ADD COLUMN page_url TEXT;
+  ALTER TABLE screenshots ADD COLUMN thumbnail_path TEXT;
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS auth_presets (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    email TEXT NOT NULL,
+    password TEXT NOT NULL,
+    login_path TEXT DEFAULT '/login',
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS webhooks (
+    id TEXT PRIMARY KEY,
+    url TEXT NOT NULL,
+    events TEXT NOT NULL DEFAULT '["failed"]',
+    project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+    secret TEXT,
+    active INTEGER NOT NULL DEFAULT 1,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_webhooks_active ON webhooks(active);
   `
 ];
 function applyMigrations(database) {
@@ -4686,9 +4717,9 @@ function createScreenshot(input) {
   const id = uuid();
   const timestamp = now();
   db2.query(`
-    INSERT INTO screenshots (id, result_id, step_number, action, file_path, width, height, timestamp)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(id, input.resultId, input.stepNumber, input.action, input.filePath, input.width, input.height, timestamp);
+    INSERT INTO screenshots (id, result_id, step_number, action, file_path, width, height, timestamp, description, page_url, thumbnail_path)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, input.resultId, input.stepNumber, input.action, input.filePath, input.width, input.height, timestamp, input.description ?? null, input.pageUrl ?? null, input.thumbnailPath ?? null);
   return getScreenshot(id);
 }
 function getScreenshot(id) {
@@ -4805,7 +4836,7 @@ async function closeBrowser(browser) {
 }
 
 // src/lib/screenshotter.ts
-import { mkdirSync as mkdirSync2, existsSync as existsSync2 } from "fs";
+import { mkdirSync as mkdirSync2, existsSync as existsSync2, writeFileSync } from "fs";
 import { join as join2 } from "path";
 import { homedir as homedir2 } from "os";
 function slugify(text) {
@@ -4814,16 +4845,51 @@ function slugify(text) {
 function generateFilename(stepNumber, action) {
   const padded = String(stepNumber).padStart(3, "0");
   const slug = slugify(action);
-  return `${padded}-${slug}.png`;
+  return `${padded}_${slug}.png`;
+}
+function formatDate(date) {
+  return date.toISOString().slice(0, 10);
+}
+function formatTime(date) {
+  return date.toISOString().slice(11, 19).replace(/:/g, "-");
 }
-function getScreenshotDir(baseDir, runId, scenarioSlug) {
-  return join2(baseDir, runId, scenarioSlug);
+function getScreenshotDir(baseDir, runId, scenarioSlug, projectName, timestamp) {
+  const now2 = timestamp ?? new Date;
+  const project = projectName ?? "default";
+  const dateDir = formatDate(now2);
+  const timeDir = `${formatTime(now2)}_${runId.slice(0, 8)}`;
+  return join2(baseDir, project, dateDir, timeDir, scenarioSlug);
 }
 function ensureDir(dirPath) {
   if (!existsSync2(dirPath)) {
     mkdirSync2(dirPath, { recursive: true });
   }
 }
+function writeMetaSidecar(screenshotPath, meta) {
+  const metaPath = screenshotPath.replace(/\.png$/, ".meta.json").replace(/\.jpeg$/, ".meta.json");
+  try {
+    writeFileSync(metaPath, JSON.stringify(meta, null, 2), "utf-8");
+  } catch {}
+}
+async function generateThumbnail(page, screenshotDir, filename) {
+  try {
+    const thumbDir = join2(screenshotDir, "_thumbnail");
+    ensureDir(thumbDir);
+    const thumbFilename = filename.replace(/\.(png|jpeg)$/, ".thumb.$1");
+    const thumbPath = join2(thumbDir, thumbFilename);
+    const viewport = page.viewportSize();
+    if (viewport) {
+      await page.screenshot({
+        path: thumbPath,
+        type: "png",
+        clip: { x: 0, y: 0, width: Math.min(viewport.width, 1280), height: Math.min(viewport.height, 720) }
+      });
+    }
+    return thumbPath;
+  } catch {
+    return null;
+  }
+}
 var DEFAULT_BASE_DIR = join2(homedir2(), ".testers", "screenshots");
 
 class Screenshotter {
@@ -4831,15 +4897,20 @@ class Screenshotter {
   format;
   quality;
   fullPage;
+  projectName;
+  runTimestamp;
   constructor(options = {}) {
     this.baseDir = options.baseDir ?? DEFAULT_BASE_DIR;
     this.format = options.format ?? "png";
     this.quality = options.quality ?? 90;
     this.fullPage = options.fullPage ?? false;
+    this.projectName = options.projectName ?? "default";
+    this.runTimestamp = new Date;
   }
   async capture(page, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.screenshot({
@@ -4849,16 +4920,32 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
+    const thumbnailPath = await generateThumbnail(page, dir, filename);
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath
     };
   }
   async captureFullPage(page, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.screenshot({
@@ -4868,16 +4955,32 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
+    const thumbnailPath = await generateThumbnail(page, dir, filename);
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath
     };
   }
   async captureElement(page, selector, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.locator(selector).screenshot({
@@ -4886,11 +4989,25 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath: null
     };
   }
 }
@@ -5673,7 +5790,10 @@ async function runSingleScenario(scenario, runId, options) {
         action: ss.action,
         filePath: ss.filePath,
         width: ss.width,
-        height: ss.height
+        height: ss.height,
+        description: ss.description,
+        pageUrl: ss.pageUrl,
+        thumbnailPath: ss.thumbnailPath
       });
       emit({ type: "screenshot:captured", screenshotPath: ss.filePath, scenarioId: scenario.id, runId });
     }
@@ -5771,6 +5891,79 @@ async function runByFilter(options) {
   }
   return runBatch(scenarios, options);
 }
+function startRunAsync(options) {
+  const config = loadConfig();
+  const model = resolveModel(options.model ?? config.defaultModel);
+  let scenarios;
+  if (options.scenarioIds && options.scenarioIds.length > 0) {
+    const all = listScenarios({ projectId: options.projectId });
+    scenarios = all.filter((s) => options.scenarioIds.includes(s.id) || options.scenarioIds.includes(s.shortId));
+  } else {
+    scenarios = listScenarios({
+      projectId: options.projectId,
+      tags: options.tags,
+      priority: options.priority
+    });
+  }
+  const parallel = options.parallel ?? 1;
+  const run = createRun({
+    url: options.url,
+    model,
+    headed: options.headed,
+    parallel,
+    projectId: options.projectId
+  });
+  if (scenarios.length === 0) {
+    updateRun(run.id, { status: "passed", total: 0, finished_at: new Date().toISOString() });
+    return { runId: run.id, scenarioCount: 0 };
+  }
+  updateRun(run.id, { status: "running", total: scenarios.length });
+  (async () => {
+    const results = [];
+    try {
+      if (parallel <= 1) {
+        for (const scenario of scenarios) {
+          const result = await runSingleScenario(scenario, run.id, options);
+          results.push(result);
+        }
+      } else {
+        const queue = [...scenarios];
+        const running = [];
+        const processNext = async () => {
+          const scenario = queue.shift();
+          if (!scenario)
+            return;
+          const result = await runSingleScenario(scenario, run.id, options);
+          results.push(result);
+          await processNext();
+        };
+        const workers = Math.min(parallel, scenarios.length);
+        for (let i = 0;i < workers; i++) {
+          running.push(processNext());
+        }
+        await Promise.all(running);
+      }
+      const passed = results.filter((r) => r.status === "passed").length;
+      const failed = results.filter((r) => r.status === "failed" || r.status === "error").length;
+      updateRun(run.id, {
+        status: failed > 0 ? "failed" : "passed",
+        passed,
+        failed,
+        total: scenarios.length,
+        finished_at: new Date().toISOString()
+      });
+      emit({ type: "run:complete", runId: run.id });
+    } catch (error) {
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      updateRun(run.id, {
+        status: "failed",
+        finished_at: new Date().toISOString()
+      });
+      emit({ type: "run:complete", runId: run.id, error: errorMsg });
+    }
+  })();
+  return { runId: run.id, scenarioCount: scenarios.length };
+}
 function estimateCost(model, tokens) {
   const costs = {
     "claude-haiku-4-5-20251001": 0.1,
@@ -6223,7 +6416,7 @@ class Scheduler {
 
 // src/mcp/index.ts
 var server = new McpServer({
-  name: "testers-mcp",
+  name: "testers",
   version: "0.0.1"
 });
 server.tool("create_scenario", "Create a new test scenario", {
@@ -6337,18 +6530,15 @@ server.tool("run_scenarios", "Run test scenarios against a URL", {
   parallel: exports_external.number().optional().describe("Number of parallel workers")
 }, async ({ url, tags, scenarioIds, priority, model, headed, parallel }) => {
   try {
-    const { run, results } = await runByFilter({ url, tags, scenarioIds, priority, model, headed, parallel });
-    const passed = results.filter((r) => r.status === "passed").length;
-    const failed = results.filter((r) => r.status === "failed" || r.status === "error").length;
-    const skipped = results.filter((r) => r.status === "skipped").length;
+    const { runId, scenarioCount } = startRunAsync({ url, tags, scenarioIds, priority, model, headed, parallel });
     const text = [
-      `Run ${run.id} \u2014 ${run.status}`,
-      `URL: ${run.url}`,
-      `Total: ${results.length} | Passed: ${passed} | Failed: ${failed} | Skipped: ${skipped}`,
-      `Model: ${run.model}`,
-      `Started: ${run.startedAt}`,
-      run.finishedAt ? `Finished: ${run.finishedAt}` : null
-    ].filter(Boolean).join(`
+      `Run started: ${runId}`,
+      `Scenarios: ${scenarioCount}`,
+      `URL: ${url}`,
+      `Status: running (async)`,
+      ``,
+      `Poll with get_run to check progress.`
+    ].join(`
 `);
     return { content: [{ type: "text", text }] };
   } catch (error) {
@@ -6592,6 +6782,6 @@ async function main() {
   await server.connect(transport);
 }
 main().catch((error) => {
-  console.error("Failed to start testers-mcp:", error);
+  console.error("Failed to start testers:", error);
   process.exit(1);
 });

package/dist/server/index.js

@@ -77,7 +77,10 @@ function screenshotFromRow(row) {
     filePath: row.file_path,
     width: row.width,
     height: row.height,
-    timestamp: row.timestamp
+    timestamp: row.timestamp,
+    description: row.description,
+    pageUrl: row.page_url,
+    thumbnailPath: row.thumbnail_path
   };
 }
 function scheduleFromRow(row) {
@@ -279,6 +282,34 @@ var MIGRATIONS = [
   CREATE INDEX IF NOT EXISTS idx_schedules_project ON schedules(project_id);
   CREATE INDEX IF NOT EXISTS idx_schedules_enabled ON schedules(enabled);
   CREATE INDEX IF NOT EXISTS idx_schedules_next_run ON schedules(next_run_at);
+  `,
+  `
+  ALTER TABLE screenshots ADD COLUMN description TEXT;
+  ALTER TABLE screenshots ADD COLUMN page_url TEXT;
+  ALTER TABLE screenshots ADD COLUMN thumbnail_path TEXT;
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS auth_presets (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL UNIQUE,
+    email TEXT NOT NULL,
+    password TEXT NOT NULL,
+    login_path TEXT DEFAULT '/login',
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  `,
+  `
+  CREATE TABLE IF NOT EXISTS webhooks (
+    id TEXT PRIMARY KEY,
+    url TEXT NOT NULL,
+    events TEXT NOT NULL DEFAULT '["failed"]',
+    project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+    secret TEXT,
+    active INTEGER NOT NULL DEFAULT 1,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  CREATE INDEX IF NOT EXISTS idx_webhooks_active ON webhooks(active);
   `
 ];
 function applyMigrations(database) {
@@ -679,9 +710,9 @@ function createScreenshot(input) {
   const id = uuid();
   const timestamp = now();
   db2.query(`
-    INSERT INTO screenshots (id, result_id, step_number, action, file_path, width, height, timestamp)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-  `).run(id, input.resultId, input.stepNumber, input.action, input.filePath, input.width, input.height, timestamp);
+    INSERT INTO screenshots (id, result_id, step_number, action, file_path, width, height, timestamp, description, page_url, thumbnail_path)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, input.resultId, input.stepNumber, input.action, input.filePath, input.width, input.height, timestamp, input.description ?? null, input.pageUrl ?? null, input.thumbnailPath ?? null);
   return getScreenshot(id);
 }
 function getScreenshot(id) {
@@ -739,7 +770,7 @@ async function closeBrowser(browser) {
 }
 
 // src/lib/screenshotter.ts
-import { mkdirSync as mkdirSync2, existsSync as existsSync2 } from "fs";
+import { mkdirSync as mkdirSync2, existsSync as existsSync2, writeFileSync } from "fs";
 import { join as join2 } from "path";
 import { homedir as homedir2 } from "os";
 function slugify(text) {
@@ -748,16 +779,51 @@ function slugify(text) {
 function generateFilename(stepNumber, action) {
   const padded = String(stepNumber).padStart(3, "0");
   const slug = slugify(action);
-  return `${padded}-${slug}.png`;
+  return `${padded}_${slug}.png`;
+}
+function formatDate(date) {
+  return date.toISOString().slice(0, 10);
 }
-function getScreenshotDir(baseDir, runId, scenarioSlug) {
-  return join2(baseDir, runId, scenarioSlug);
+function formatTime(date) {
+  return date.toISOString().slice(11, 19).replace(/:/g, "-");
+}
+function getScreenshotDir(baseDir, runId, scenarioSlug, projectName, timestamp) {
+  const now2 = timestamp ?? new Date;
+  const project = projectName ?? "default";
+  const dateDir = formatDate(now2);
+  const timeDir = `${formatTime(now2)}_${runId.slice(0, 8)}`;
+  return join2(baseDir, project, dateDir, timeDir, scenarioSlug);
 }
 function ensureDir(dirPath) {
   if (!existsSync2(dirPath)) {
     mkdirSync2(dirPath, { recursive: true });
   }
 }
+function writeMetaSidecar(screenshotPath, meta) {
+  const metaPath = screenshotPath.replace(/\.png$/, ".meta.json").replace(/\.jpeg$/, ".meta.json");
+  try {
+    writeFileSync(metaPath, JSON.stringify(meta, null, 2), "utf-8");
+  } catch {}
+}
+async function generateThumbnail(page, screenshotDir, filename) {
+  try {
+    const thumbDir = join2(screenshotDir, "_thumbnail");
+    ensureDir(thumbDir);
+    const thumbFilename = filename.replace(/\.(png|jpeg)$/, ".thumb.$1");
+    const thumbPath = join2(thumbDir, thumbFilename);
+    const viewport = page.viewportSize();
+    if (viewport) {
+      await page.screenshot({
+        path: thumbPath,
+        type: "png",
+        clip: { x: 0, y: 0, width: Math.min(viewport.width, 1280), height: Math.min(viewport.height, 720) }
+      });
+    }
+    return thumbPath;
+  } catch {
+    return null;
+  }
+}
 var DEFAULT_BASE_DIR = join2(homedir2(), ".testers", "screenshots");
 
 class Screenshotter {
@@ -765,15 +831,20 @@ class Screenshotter {
   format;
   quality;
   fullPage;
+  projectName;
+  runTimestamp;
   constructor(options = {}) {
     this.baseDir = options.baseDir ?? DEFAULT_BASE_DIR;
     this.format = options.format ?? "png";
     this.quality = options.quality ?? 90;
     this.fullPage = options.fullPage ?? false;
+    this.projectName = options.projectName ?? "default";
+    this.runTimestamp = new Date;
   }
   async capture(page, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.screenshot({
@@ -783,16 +854,32 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
+    const thumbnailPath = await generateThumbnail(page, dir, filename);
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath
     };
   }
   async captureFullPage(page, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.screenshot({
@@ -802,16 +889,32 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
+    const thumbnailPath = await generateThumbnail(page, dir, filename);
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath
     };
   }
   async captureElement(page, selector, options) {
-    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug);
-    const filename = generateFilename(options.stepNumber, options.action);
+    const action = options.description ?? options.action;
+    const dir = getScreenshotDir(this.baseDir, options.runId, options.scenarioSlug, this.projectName, this.runTimestamp);
+    const filename = generateFilename(options.stepNumber, action);
     const filePath = join2(dir, filename);
     ensureDir(dir);
     await page.locator(selector).screenshot({
@@ -820,11 +923,25 @@ class Screenshotter {
       quality: this.format === "jpeg" ? this.quality : undefined
     });
     const viewport = page.viewportSize() ?? { width: 0, height: 0 };
+    const pageUrl = page.url();
+    const timestamp = new Date().toISOString();
+    writeMetaSidecar(filePath, {
+      stepNumber: options.stepNumber,
+      action: options.action,
+      description: options.description ?? null,
+      pageUrl,
+      viewport,
+      timestamp,
+      filePath
+    });
     return {
       filePath,
       width: viewport.width,
       height: viewport.height,
-      timestamp: new Date().toISOString()
+      timestamp,
+      description: options.description ?? null,
+      pageUrl,
+      thumbnailPath: null
     };
   }
 }
@@ -1607,7 +1724,10 @@ async function runSingleScenario(scenario, runId, options) {
         action: ss.action,
         filePath: ss.filePath,
         width: ss.width,
-        height: ss.height
+        height: ss.height,
+        description: ss.description,
+        pageUrl: ss.pageUrl,
+        thumbnailPath: ss.thumbnailPath
       });
       emit({ type: "screenshot:captured", screenshotPath: ss.filePath, scenarioId: scenario.id, runId });
     }

package/dist/types/index.d.ts

@@ -79,6 +79,9 @@ export interface ScreenshotRow {
     width: number;
     height: number;
     timestamp: string;
+    description: string | null;
+    page_url: string | null;
+    thumbnail_path: string | null;
 }
 export interface ScheduleRow {
     id: string;
@@ -174,6 +177,9 @@ export interface Screenshot {
     width: number;
     height: number;
     timestamp: string;
+    description: string | null;
+    pageUrl: string | null;
+    thumbnailPath: string | null;
 }
 export interface Schedule {
     id: string;