@hasna/testers 0.0.37 → 0.0.39

package/dist/cli/index.js

@@ -16697,12 +16697,19 @@ var init_personas = __esm(() => {
 // src/lib/screenshotter.ts
 import { mkdirSync as mkdirSync7, existsSync as existsSync8, writeFileSync as writeFileSync2 } from "fs";
 import { join as join10 } from "path";
-function slugify(text) {
-  return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+function truncateSlug(slug, maxLength) {
+  if (slug.length <= maxLength)
+    return slug;
+  const truncated = slug.slice(0, maxLength).replace(/-+$/g, "");
+  return truncated || slug.slice(0, maxLength);
+}
+function slugify(text, maxLength) {
+  const slug = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return maxLength ? truncateSlug(slug, maxLength) : slug;
 }
 function generateFilename(stepNumber, action) {
   const padded = String(stepNumber).padStart(3, "0");
-  const slug = slugify(action);
+  const slug = slugify(action, MAX_ACTION_SLUG_LENGTH);
   return `${padded}_${slug}.png`;
 }
 function formatDate(date) {
@@ -16716,7 +16723,8 @@ function getScreenshotDir(baseDir, runId, scenarioSlug, projectName, timestamp)
   const project = projectName ?? "default";
   const dateDir = formatDate(now2);
   const timeDir = `${formatTime(now2)}_${runId.slice(0, 8)}`;
-  return join10(baseDir, project, dateDir, timeDir, scenarioSlug);
+  const safeScenarioSlug = slugify(scenarioSlug, MAX_SCENARIO_SLUG_LENGTH) || "scenario";
+  return join10(baseDir, project, dateDir, timeDir, safeScenarioSlug);
 }
 function ensureDir(dirPath) {
   if (!existsSync8(dirPath)) {
@@ -16874,7 +16882,7 @@ class Screenshotter {
     };
   }
 }
-var DEFAULT_BASE_DIR;
+var MAX_ACTION_SLUG_LENGTH = 80, MAX_SCENARIO_SLUG_LENGTH = 96, DEFAULT_BASE_DIR;
 var init_screenshotter = __esm(() => {
   init_paths();
   DEFAULT_BASE_DIR = join10(getTestersDir(), "screenshots");
@@ -18137,6 +18145,7 @@ __export(exports_runner, {
   runByFilter: () => runByFilter,
   runBatch: () => runBatch,
   resolveScenariosForRun: () => resolveScenariosForRun,
+  resolveAgentMaxTurns: () => resolveAgentMaxTurns,
   resolveAgentApiKeyForModel: () => resolveAgentApiKeyForModel,
   onRunEvent: () => onRunEvent,
   applyStructuredAssertionsToResult: () => applyStructuredAssertionsToResult
@@ -18154,6 +18163,14 @@ function emit(event) {
 function resolveAgentApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey) {
   return resolveProviderApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey);
 }
+function resolveAgentMaxTurns(options) {
+  if (options.maxTurns !== undefined) {
+    const parsed = Math.floor(options.maxTurns);
+    if (Number.isFinite(parsed) && parsed > 0)
+      return parsed;
+  }
+  return options.minimal ? 10 : 30;
+}
 function assertionDescription(result) {
   return result.assertion.description || `${result.assertion.type}${result.assertion.selector ? ` ${result.assertion.selector}` : ""}`;
 }
@@ -18373,7 +18390,7 @@ async function runSingleScenario(scenario, runId, options) {
       runId,
       sessionId: result.id,
       baseUrl: options.url,
-      maxTurns: effectiveOptions.minimal ? 10 : 30,
+      maxTurns: resolveAgentMaxTurns(effectiveOptions),
       a11y: effectiveOptions.a11y,
       persona: persona ? {
         name: persona.name,
@@ -93980,7 +93997,7 @@ import chalk6 from "chalk";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.37",
+  version: "0.0.39",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",
@@ -94558,6 +94575,7 @@ function formatSmokeReport(result) {
 
 // src/lib/quick-qa.ts
 init_health_scan();
+var DEFAULT_QUICK_QA_OVERALL_TIMEOUT_MS = 120000;
 var DEFAULT_QUICK_QA_SCANNERS = [
   "console",
   "network",
@@ -94608,7 +94626,17 @@ function resolveQuickQaSelection(options = {}) {
 }
 async function runQuickQa(options) {
   const start = Date.now();
-  const health = await runHealthScan({
+  const timeoutMs = options.overallTimeoutMs ?? DEFAULT_QUICK_QA_OVERALL_TIMEOUT_MS;
+  return withQuickQaTimeout(runQuickQaUnbounded(options, start), {
+    url: options.url,
+    start,
+    timeoutMs
+  });
+}
+async function runQuickQaUnbounded(options, start) {
+  const healthScanner = options.healthScanner ?? runHealthScan;
+  const smokeRunner = options.smokeRunner ?? runSmoke;
+  const health = await healthScanner({
     url: options.url,
     pages: options.pages,
     projectId: options.projectId,
@@ -94618,7 +94646,7 @@ async function runQuickQa(options) {
     maxPages: options.maxPages,
     wcagLevel: options.wcagLevel
   });
-  const smoke = options.includeSmoke === false ? null : await runSmoke({
+  const smoke = options.includeSmoke === false ? null : await smokeRunner({
     url: options.url,
     model: options.model,
     headed: options.headed,
@@ -94632,6 +94660,62 @@ async function runQuickQa(options) {
     durationMs: Date.now() - start
   });
 }
+function withQuickQaTimeout(promise, options) {
+  if (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0)
+    return promise;
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      resolve(buildQuickQaTimeoutResult({
+        url: options.url,
+        start: options.start,
+        timeoutMs: options.timeoutMs
+      }));
+    }, options.timeoutMs);
+    promise.then((result) => {
+      clearTimeout(timer);
+      resolve(result);
+    }, (error) => {
+      clearTimeout(timer);
+      reject(error);
+    });
+  });
+}
+function buildQuickQaTimeoutResult(input) {
+  const now2 = new Date;
+  const durationMs = Math.max(0, Date.now() - input.start);
+  const message = `Quick QA timed out after ${input.timeoutMs}ms before all checks finished. Increase --overall-timeout or skip slow checks.`;
+  const health = {
+    url: input.url,
+    scannedAt: now2.toISOString(),
+    durationMs,
+    totalIssues: 1,
+    newIssues: 1,
+    regressedIssues: 0,
+    existingIssues: 0,
+    results: [{
+      url: input.url,
+      pages: [input.url],
+      scannedAt: now2.toISOString(),
+      durationMs,
+      issues: [{
+        type: "performance",
+        severity: "high",
+        pageUrl: input.url,
+        message,
+        detail: {
+          check: "quick-qa",
+          timeoutMs: input.timeoutMs
+        }
+      }]
+    }]
+  };
+  return buildQuickQaResult({
+    url: input.url,
+    health,
+    smoke: null,
+    durationMs
+  });
+}
 function buildQuickQaResult(input) {
   const healthActionable = input.health.newIssues + input.health.regressedIssues;
   const smokeIssues = input.smoke?.issuesFound.length ?? 0;
@@ -97476,7 +97560,7 @@ program2.command("remove <id>").alias("uninstall").description("Remove a scenari
 program2.command("run [url] [description]").alias("test").description("Run test scenarios against a URL").option("-t, --tag <tag>", "Filter by tag (repeatable)", (val, acc) => {
   acc.push(val);
   return acc;
-}, []).option("-s, --scenario <id>", "Run specific scenario ID").option("-p, --priority <level>", "Filter by priority").option("--headed", "Run browser in headed mode", false).option("-m, --model <model>", "AI model to use").option("--parallel <n>", "Number of parallel browsers", "1").option("--json", "Output results as JSON", false).option("-o, --output <filepath>", "Write JSON results to file").option("--timeout <ms>", "Timeout in milliseconds").option("--from-todos", "Import scenarios from todos before running", false).option("--project <id>", "Project ID").option("-b, --background", "Start run in background and return immediately", false).option("--browser <engine>", "Browser engine: playwright (default), lightpanda (9x faster, no screenshots), or bun (native WKWebView, 11x faster, Bun canary required)", "playwright").option("--env <name>", "Use a named environment for the URL").option("--dry-run", "Print what would run without launching browser", false).option("--retry <n>", "Retry failed scenarios up to n times", "0").option("--samples <n>", "Run each scenario N times and report flakiness (pass rate)", "1").option("--flakiness-threshold <n>", "Pass rate threshold below which a scenario is marked flaky (0-1)", "0.95").option("--a11y [level]", "Run axe-core WCAG accessibility scan after each navigation (level: A, AA, AAA \u2014 default AA)").option("--self-heal", "Enable AI-powered selector repair when elements can't be found (requires judgeModel or ANTHROPIC_API_KEY)", false).option("--verbose", "Show per-step timing and full tool results", false).option("--watch-results", "When used with --background, poll and display live results table until run completes", false).option("--failed-only", "Only show failed/error scenarios in output (passed count shown as summary)", false).option("--smoke", "Run only smoke-tagged scenarios (fast validation suite, <2 min)", false).option("--minimal", "Fastest possible run: cheapest model, max parallelism, min turns (ideal for CI)", false).option("--github-comment", "Post pass/fail summary as a GitHub PR comment (requires GITHUB_TOKEN env var)", false).option("--pr <number>", "GitHub PR number (auto-detected from GITHUB_REF if not provided)").option("--persona <id>", "Override persona for this run (comma-separated IDs for divergence testing)").option("--max-cost <dollars>", "Hard budget cap in dollars \u2014 abort if estimated cost exceeds this (e.g. 0.50 for 50 cents)").option("--cache-max-age <seconds>", "Skip scenarios that passed at the same URL within this many seconds (0 = disabled)", "0").option("--diff", "Auto-detect changed files from git diff and run only relevant scenarios", false).option("--auto-generate", "If no scenarios exist, crawl the URL and generate scenarios automatically (enabled by default when a URL is given as the first arg)").option("--no-auto-generate", "Disable automatic scenario generation when no scenarios exist").option("--overall-timeout <ms>", "Hard overall timeout for the whole run in milliseconds (default 10 minutes)").option("-y, --yes", "Skip confirmation prompts (e.g. proceed past budget warnings)", false).action(async (urlArg, description, opts) => {
+}, []).option("-s, --scenario <id>", "Run specific scenario ID").option("-p, --priority <level>", "Filter by priority").option("--headed", "Run browser in headed mode", false).option("-m, --model <model>", "AI model to use").option("--parallel <n>", "Number of parallel browsers", "1").option("--json", "Output results as JSON", false).option("-o, --output <filepath>", "Write JSON results to file").option("--timeout <ms>", "Timeout in milliseconds").option("--from-todos", "Import scenarios from todos before running", false).option("--project <id>", "Project ID").option("-b, --background", "Start run in background and return immediately", false).option("--browser <engine>", "Browser engine: playwright (default), lightpanda (9x faster, no screenshots), or bun (native WKWebView, 11x faster, Bun canary required)", "playwright").option("--env <name>", "Use a named environment for the URL").option("--dry-run", "Print what would run without launching browser", false).option("--retry <n>", "Retry failed scenarios up to n times", "0").option("--samples <n>", "Run each scenario N times and report flakiness (pass rate)", "1").option("--flakiness-threshold <n>", "Pass rate threshold below which a scenario is marked flaky (0-1)", "0.95").option("--a11y [level]", "Run axe-core WCAG accessibility scan after each navigation (level: A, AA, AAA \u2014 default AA)").option("--self-heal", "Enable AI-powered selector repair when elements can't be found (requires judgeModel or ANTHROPIC_API_KEY)", false).option("--verbose", "Show per-step timing and full tool results", false).option("--watch-results", "When used with --background, poll and display live results table until run completes", false).option("--failed-only", "Only show failed/error scenarios in output (passed count shown as summary)", false).option("--smoke", "Run only smoke-tagged scenarios (fast validation suite, <2 min)", false).option("--minimal", "Fastest possible run: cheapest model, max parallelism, min turns (ideal for CI)", false).option("--max-turns <n>", "Maximum AI browser-agent turns before reporting an error").option("--github-comment", "Post pass/fail summary as a GitHub PR comment (requires GITHUB_TOKEN env var)", false).option("--pr <number>", "GitHub PR number (auto-detected from GITHUB_REF if not provided)").option("--persona <id>", "Override persona for this run (comma-separated IDs for divergence testing)").option("--max-cost <dollars>", "Hard budget cap in dollars \u2014 abort if estimated cost exceeds this (e.g. 0.50 for 50 cents)").option("--cache-max-age <seconds>", "Skip scenarios that passed at the same URL within this many seconds (0 = disabled)", "0").option("--diff", "Auto-detect changed files from git diff and run only relevant scenarios", false).option("--auto-generate", "If no scenarios exist, crawl the URL and generate scenarios automatically (enabled by default when a URL is given as the first arg)").option("--no-auto-generate", "Disable automatic scenario generation when no scenarios exist").option("--overall-timeout <ms>", "Hard overall timeout for the whole run in milliseconds (default 10 minutes)").option("-y, --yes", "Skip confirmation prompts (e.g. proceed past budget warnings)", false).action(async (urlArg, description, opts) => {
   try {
     const projectId = resolveProject2(opts.project);
     let url2 = urlArg;
@@ -97626,6 +97710,7 @@ program2.command("run [url] [description]").alias("test").description("Run test
         headed: opts.headed,
         parallel: parseInt(opts.parallel, 10),
         timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+        maxTurns: opts.maxTurns ? parseInt(opts.maxTurns, 10) : undefined,
         projectId,
         engine: opts.browser
       });
@@ -97744,6 +97829,7 @@ program2.command("run [url] [description]").alias("test").description("Run test
         headed: opts.headed,
         parallel: parseInt(opts.parallel, 10),
         timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+        maxTurns: opts.maxTurns ? parseInt(opts.maxTurns, 10) : undefined,
         retry: parseInt(opts.retry ?? "0", 10),
         projectId,
         engine: opts.browser,
@@ -97848,6 +97934,7 @@ program2.command("run [url] [description]").alias("test").description("Run test
       headed: opts.headed,
       parallel: parseInt(opts.parallel, 10),
       timeout: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+      maxTurns: opts.maxTurns ? parseInt(opts.maxTurns, 10) : undefined,
       retry: parseInt(opts.retry ?? "0", 10),
       projectId,
       engine: opts.browser,
@@ -99145,7 +99232,7 @@ program2.command("quick-qa <url>").alias("quick-check").description("Run a fast
 }, []).option("--max-pages <n>", "Max pages to crawl for link checks", "20").option("--skip <check>", "Skip a check: console|network|links|perf|smoke|a11y (repeatable)", (v2, acc) => {
   acc.push(v2);
   return acc;
-}, []).option("--a11y [level]", "Include WCAG accessibility scan at A, AA, or AAA (default AA)").option("--no-smoke", "Skip autonomous smoke exploration").option("-m, --model <model>", "AI model for autonomous smoke", "quick").option("--headed", "Run browser checks in headed mode", false).option("--timeout <ms>", "Navigation timeout per page in ms", "15000").option("--project <id>", "Project ID for issue tracking").option("--json", "Output results as JSON", false).option("-o, --output <file>", "Write JSON results to a file").action(async (url2, opts) => {
+}, []).option("--a11y [level]", "Include WCAG accessibility scan at A, AA, or AAA (default AA)").option("--no-smoke", "Skip autonomous smoke exploration").option("-m, --model <model>", "AI model for autonomous smoke", "quick").option("--headed", "Run browser checks in headed mode", false).option("--timeout <ms>", "Navigation timeout per page in ms", "15000").option("--overall-timeout <ms>", "Hard overall timeout for the quick QA run in milliseconds", String(DEFAULT_QUICK_QA_OVERALL_TIMEOUT_MS)).option("--project <id>", "Project ID for issue tracking").option("--json", "Output results as JSON", false).option("-o, --output <file>", "Write JSON results to a file").action(async (url2, opts) => {
   try {
     const projectId = resolveProject2(opts.project);
     const includeA11y = opts.a11y !== undefined;
@@ -99166,6 +99253,7 @@ program2.command("quick-qa <url>").alias("quick-check").description("Run a fast
       projectId,
       headed: opts.headed,
       timeoutMs: parseInt(opts.timeout, 10),
+      overallTimeoutMs: parseInt(opts.overallTimeout, 10),
       maxPages: parseInt(opts.maxPages, 10),
       scanners: selection.scanners,
       includeSmoke: selection.includeSmoke,

package/dist/index.js

@@ -13880,12 +13880,21 @@ init_browser_lightpanda();
 init_paths();
 import { mkdirSync as mkdirSync7, existsSync as existsSync8, writeFileSync as writeFileSync2 } from "fs";
 import { join as join10 } from "path";
-function slugify(text) {
-  return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+var MAX_ACTION_SLUG_LENGTH = 80;
+var MAX_SCENARIO_SLUG_LENGTH = 96;
+function truncateSlug(slug, maxLength) {
+  if (slug.length <= maxLength)
+    return slug;
+  const truncated = slug.slice(0, maxLength).replace(/-+$/g, "");
+  return truncated || slug.slice(0, maxLength);
+}
+function slugify(text, maxLength) {
+  const slug = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return maxLength ? truncateSlug(slug, maxLength) : slug;
 }
 function generateFilename(stepNumber, action) {
   const padded = String(stepNumber).padStart(3, "0");
-  const slug = slugify(action);
+  const slug = slugify(action, MAX_ACTION_SLUG_LENGTH);
   return `${padded}_${slug}.png`;
 }
 function formatDate(date) {
@@ -13899,7 +13908,8 @@ function getScreenshotDir(baseDir, runId, scenarioSlug, projectName, timestamp)
   const project = projectName ?? "default";
   const dateDir = formatDate(now2);
   const timeDir = `${formatTime(now2)}_${runId.slice(0, 8)}`;
-  return join10(baseDir, project, dateDir, timeDir, scenarioSlug);
+  const safeScenarioSlug = slugify(scenarioSlug, MAX_SCENARIO_SLUG_LENGTH) || "scenario";
+  return join10(baseDir, project, dateDir, timeDir, safeScenarioSlug);
 }
 function ensureDir(dirPath) {
   if (!existsSync8(dirPath)) {
@@ -16452,6 +16462,14 @@ function emit(event) {
 function resolveAgentApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey) {
   return resolveProviderApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey);
 }
+function resolveAgentMaxTurns(options) {
+  if (options.maxTurns !== undefined) {
+    const parsed = Math.floor(options.maxTurns);
+    if (Number.isFinite(parsed) && parsed > 0)
+      return parsed;
+  }
+  return options.minimal ? 10 : 30;
+}
 function assertionDescription(result) {
   return result.assertion.description || `${result.assertion.type}${result.assertion.selector ? ` ${result.assertion.selector}` : ""}`;
 }
@@ -16671,7 +16689,7 @@ async function runSingleScenario(scenario, runId, options) {
       runId,
       sessionId: result.id,
       baseUrl: options.url,
-      maxTurns: effectiveOptions.minimal ? 10 : 30,
+      maxTurns: resolveAgentMaxTurns(effectiveOptions),
       a11y: effectiveOptions.a11y,
       persona: persona ? {
         name: persona.name,
@@ -19135,6 +19153,7 @@ async function notifyHealthScan(url, counts) {
 }
 
 // src/lib/quick-qa.ts
+var DEFAULT_QUICK_QA_OVERALL_TIMEOUT_MS = 120000;
 var DEFAULT_QUICK_QA_SCANNERS = [
   "console",
   "network",
@@ -19185,7 +19204,17 @@ function resolveQuickQaSelection(options = {}) {
 }
 async function runQuickQa(options) {
   const start = Date.now();
-  const health = await runHealthScan({
+  const timeoutMs = options.overallTimeoutMs ?? DEFAULT_QUICK_QA_OVERALL_TIMEOUT_MS;
+  return withQuickQaTimeout(runQuickQaUnbounded(options, start), {
+    url: options.url,
+    start,
+    timeoutMs
+  });
+}
+async function runQuickQaUnbounded(options, start) {
+  const healthScanner = options.healthScanner ?? runHealthScan;
+  const smokeRunner = options.smokeRunner ?? runSmoke;
+  const health = await healthScanner({
     url: options.url,
     pages: options.pages,
     projectId: options.projectId,
@@ -19195,7 +19224,7 @@ async function runQuickQa(options) {
     maxPages: options.maxPages,
     wcagLevel: options.wcagLevel
   });
-  const smoke = options.includeSmoke === false ? null : await runSmoke({
+  const smoke = options.includeSmoke === false ? null : await smokeRunner({
     url: options.url,
     model: options.model,
     headed: options.headed,
@@ -19209,6 +19238,62 @@ async function runQuickQa(options) {
     durationMs: Date.now() - start
   });
 }
+function withQuickQaTimeout(promise, options) {
+  if (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0)
+    return promise;
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      resolve(buildQuickQaTimeoutResult({
+        url: options.url,
+        start: options.start,
+        timeoutMs: options.timeoutMs
+      }));
+    }, options.timeoutMs);
+    promise.then((result) => {
+      clearTimeout(timer);
+      resolve(result);
+    }, (error) => {
+      clearTimeout(timer);
+      reject(error);
+    });
+  });
+}
+function buildQuickQaTimeoutResult(input) {
+  const now2 = new Date;
+  const durationMs = Math.max(0, Date.now() - input.start);
+  const message = `Quick QA timed out after ${input.timeoutMs}ms before all checks finished. Increase --overall-timeout or skip slow checks.`;
+  const health = {
+    url: input.url,
+    scannedAt: now2.toISOString(),
+    durationMs,
+    totalIssues: 1,
+    newIssues: 1,
+    regressedIssues: 0,
+    existingIssues: 0,
+    results: [{
+      url: input.url,
+      pages: [input.url],
+      scannedAt: now2.toISOString(),
+      durationMs,
+      issues: [{
+        type: "performance",
+        severity: "high",
+        pageUrl: input.url,
+        message,
+        detail: {
+          check: "quick-qa",
+          timeoutMs: input.timeoutMs
+        }
+      }]
+    }]
+  };
+  return buildQuickQaResult({
+    url: input.url,
+    health,
+    smoke: null,
+    durationMs
+  });
+}
 function buildQuickQaResult(input) {
   const healthActionable = input.health.newIssues + input.health.regressedIssues;
   const smokeIssues = input.smoke?.issuesFound.length ?? 0;

package/dist/lib/quick-qa.d.ts

@@ -1,8 +1,9 @@
-import { type HealthScanOptions, type HealthScanSummary } from "./health-scan.js";
-import { type SmokeResult } from "./smoke.js";
+import { runHealthScan, type HealthScanOptions, type HealthScanSummary } from "./health-scan.js";
+import { runSmoke, type SmokeResult } from "./smoke.js";
 export type QuickQaScanner = NonNullable<HealthScanOptions["scanners"]>[number];
 export type QuickQaSkipTarget = QuickQaScanner | "smoke";
 export type QuickQaStatus = "passed" | "warn" | "failed";
+export declare const DEFAULT_QUICK_QA_OVERALL_TIMEOUT_MS = 120000;
 export declare const DEFAULT_QUICK_QA_SCANNERS: QuickQaScanner[];
 export interface QuickQaSelection {
     scanners: QuickQaScanner[];
@@ -15,11 +16,14 @@ export interface QuickQaOptions {
     projectId?: string;
     headed?: boolean;
     timeoutMs?: number;
+    overallTimeoutMs?: number;
     maxPages?: number;
     scanners?: QuickQaScanner[];
     includeSmoke?: boolean;
     model?: string;
     wcagLevel?: "A" | "AA" | "AAA";
+    healthScanner?: typeof runHealthScan;
+    smokeRunner?: typeof runSmoke;
 }
 export interface QuickQaCheckSummary {
     name: "health" | "smoke";
@@ -50,6 +54,11 @@ export declare function resolveQuickQaSelection(options?: {
     scanners?: QuickQaScanner[];
 }): QuickQaSelection;
 export declare function runQuickQa(options: QuickQaOptions): Promise<QuickQaResult>;
+export declare function buildQuickQaTimeoutResult(input: {
+    url: string;
+    start: number;
+    timeoutMs: number;
+}): QuickQaResult;
 export declare function buildQuickQaResult(input: {
     url: string;
     health: HealthScanSummary;

package/dist/lib/quick-qa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quick-qa.d.ts","sourceRoot":"","sources":["../../src/lib/quick-qa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChF,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,OAAO,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD,eAAO,MAAM,yBAAyB,EAAE,cAAc,EAKrD,CAAC;AAgBF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,CAK5E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CACxB,GAAG,gBAAgB,CAwBxB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BhF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,aAAa,CA2DhB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA8CjE"}
+{"version":3,"file":"quick-qa.d.ts","sourceRoot":"","sources":["../../src/lib/quick-qa.ts"],"names":[],"mappings":"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"}

package/dist/lib/runner.d.ts

@@ -23,6 +23,7 @@ export interface RunOptions {
     skipBudgetCheck?: boolean;
     cacheMaxAgeMs?: number;
     minimal?: boolean;
+    maxTurns?: number;
     recordVideo?: boolean;
 }
 export interface RunEvent {
@@ -47,6 +48,7 @@ export interface RunEvent {
 export type RunEventHandler = (event: RunEvent) => void;
 export declare function onRunEvent(handler: RunEventHandler): void;
 export declare function resolveAgentApiKeyForModel(model: string, explicitApiKey?: string, configuredAnthropicApiKey?: string): string | undefined;
+export declare function resolveAgentMaxTurns(options: Pick<RunOptions, "minimal" | "maxTurns">): number;
 type AgentScenarioStatus = Extract<ResultStatus, "passed" | "failed" | "error">;
 export interface StructuredAssertionOutcome {
     status: AgentScenarioStatus;

package/dist/lib/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/lib/runner.ts"],"names":[],"mappings":"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"}

package/dist/lib/screenshotter.d.ts

@@ -1,5 +1,5 @@
 import type { Page } from "playwright";
-export declare function slugify(text: string): string;
+export declare function slugify(text: string, maxLength?: number): string;
 export declare function generateFilename(stepNumber: number, action: string): string;
 /**
  * Build the screenshot directory for a run:

package/dist/lib/screenshotter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshotter.d.ts","sourceRoot":"","sources":["../../src/lib/screenshotter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3E;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,IAAI,GACf,MAAM,CAMR;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAID,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAuBD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC5G,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxH,IAAI,CAON;AAkCD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,YAAY,CAAO;gBAEf,OAAO,GAAE,oBAAyB;IASxC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAmDpE,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiD5E,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA6CpG"}
+{"version":3,"file":"screenshotter.d.ts","sourceRoot":"","sources":["../../src/lib/screenshotter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAgBvC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI3E;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,IAAI,GACf,MAAM,CAOR;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAID,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAuBD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC5G,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxH,IAAI,CAON;AAkCD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,YAAY,CAAO;gBAEf,OAAO,GAAE,oBAAyB;IASxC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAmDpE,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiD5E,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA6CpG"}

package/dist/mcp/index.js

@@ -52,7 +52,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/testers",
-    version: "0.0.37",
+    version: "0.0.39",
     description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
     type: "module",
     main: "dist/index.js",
@@ -19805,12 +19805,19 @@ var init_personas = __esm(() => {
 // src/lib/screenshotter.ts
 import { mkdirSync as mkdirSync7, existsSync as existsSync8, writeFileSync as writeFileSync2 } from "fs";
 import { join as join10 } from "path";
-function slugify(text) {
-  return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+function truncateSlug(slug, maxLength) {
+  if (slug.length <= maxLength)
+    return slug;
+  const truncated = slug.slice(0, maxLength).replace(/-+$/g, "");
+  return truncated || slug.slice(0, maxLength);
+}
+function slugify(text, maxLength) {
+  const slug = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return maxLength ? truncateSlug(slug, maxLength) : slug;
 }
 function generateFilename(stepNumber, action) {
   const padded = String(stepNumber).padStart(3, "0");
-  const slug = slugify(action);
+  const slug = slugify(action, MAX_ACTION_SLUG_LENGTH);
   return `${padded}_${slug}.png`;
 }
 function formatDate(date) {
@@ -19824,7 +19831,8 @@ function getScreenshotDir(baseDir, runId, scenarioSlug, projectName, timestamp)
   const project = projectName ?? "default";
   const dateDir = formatDate(now2);
   const timeDir = `${formatTime(now2)}_${runId.slice(0, 8)}`;
-  return join10(baseDir, project, dateDir, timeDir, scenarioSlug);
+  const safeScenarioSlug = slugify(scenarioSlug, MAX_SCENARIO_SLUG_LENGTH) || "scenario";
+  return join10(baseDir, project, dateDir, timeDir, safeScenarioSlug);
 }
 function ensureDir(dirPath) {
   if (!existsSync8(dirPath)) {
@@ -19982,7 +19990,7 @@ class Screenshotter {
     };
   }
 }
-var DEFAULT_BASE_DIR;
+var MAX_ACTION_SLUG_LENGTH = 80, MAX_SCENARIO_SLUG_LENGTH = 96, DEFAULT_BASE_DIR;
 var init_screenshotter = __esm(() => {
   init_paths();
   DEFAULT_BASE_DIR = join10(getTestersDir(), "screenshots");
@@ -21180,6 +21188,7 @@ __export(exports_runner, {
   runByFilter: () => runByFilter,
   runBatch: () => runBatch,
   resolveScenariosForRun: () => resolveScenariosForRun,
+  resolveAgentMaxTurns: () => resolveAgentMaxTurns,
   resolveAgentApiKeyForModel: () => resolveAgentApiKeyForModel,
   onRunEvent: () => onRunEvent,
   applyStructuredAssertionsToResult: () => applyStructuredAssertionsToResult
@@ -21197,6 +21206,14 @@ function emit(event) {
 function resolveAgentApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey) {
   return resolveProviderApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey);
 }
+function resolveAgentMaxTurns(options) {
+  if (options.maxTurns !== undefined) {
+    const parsed = Math.floor(options.maxTurns);
+    if (Number.isFinite(parsed) && parsed > 0)
+      return parsed;
+  }
+  return options.minimal ? 10 : 30;
+}
 function assertionDescription(result) {
   return result.assertion.description || `${result.assertion.type}${result.assertion.selector ? ` ${result.assertion.selector}` : ""}`;
 }
@@ -21416,7 +21433,7 @@ async function runSingleScenario(scenario, runId, options) {
       runId,
       sessionId: result.id,
       baseUrl: options.url,
-      maxTurns: effectiveOptions.minimal ? 10 : 30,
+      maxTurns: resolveAgentMaxTurns(effectiveOptions),
       a11y: effectiveOptions.a11y,
       persona: persona ? {
         name: persona.name,

package/dist/server/index.js

@@ -46910,7 +46910,7 @@ import { join as join14 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/testers",
-  version: "0.0.37",
+  version: "0.0.39",
   description: "AI-powered QA testing CLI \u2014 spawns cheap AI agents to test web apps with headless browsers",
   type: "module",
   main: "dist/index.js",
@@ -48303,12 +48303,21 @@ init_browser();
 init_paths();
 import { mkdirSync as mkdirSync5, existsSync as existsSync7, writeFileSync as writeFileSync2 } from "fs";
 import { join as join9 } from "path";
-function slugify(text) {
-  return text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+var MAX_ACTION_SLUG_LENGTH = 80;
+var MAX_SCENARIO_SLUG_LENGTH = 96;
+function truncateSlug(slug, maxLength) {
+  if (slug.length <= maxLength)
+    return slug;
+  const truncated = slug.slice(0, maxLength).replace(/-+$/g, "");
+  return truncated || slug.slice(0, maxLength);
+}
+function slugify(text, maxLength) {
+  const slug = text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return maxLength ? truncateSlug(slug, maxLength) : slug;
 }
 function generateFilename(stepNumber, action) {
   const padded = String(stepNumber).padStart(3, "0");
-  const slug = slugify(action);
+  const slug = slugify(action, MAX_ACTION_SLUG_LENGTH);
   return `${padded}_${slug}.png`;
 }
 function formatDate(date) {
@@ -48322,7 +48331,8 @@ function getScreenshotDir(baseDir, runId, scenarioSlug, projectName, timestamp)
   const project = projectName ?? "default";
   const dateDir = formatDate(now2);
   const timeDir = `${formatTime(now2)}_${runId.slice(0, 8)}`;
-  return join9(baseDir, project, dateDir, timeDir, scenarioSlug);
+  const safeScenarioSlug = slugify(scenarioSlug, MAX_SCENARIO_SLUG_LENGTH) || "scenario";
+  return join9(baseDir, project, dateDir, timeDir, safeScenarioSlug);
 }
 function ensureDir(dirPath) {
   if (!existsSync7(dirPath)) {
@@ -49404,6 +49414,14 @@ function emit(event) {
 function resolveAgentApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey) {
   return resolveProviderApiKeyForModel(model, explicitApiKey, configuredAnthropicApiKey);
 }
+function resolveAgentMaxTurns(options) {
+  if (options.maxTurns !== undefined) {
+    const parsed = Math.floor(options.maxTurns);
+    if (Number.isFinite(parsed) && parsed > 0)
+      return parsed;
+  }
+  return options.minimal ? 10 : 30;
+}
 function assertionDescription(result) {
   return result.assertion.description || `${result.assertion.type}${result.assertion.selector ? ` ${result.assertion.selector}` : ""}`;
 }
@@ -49623,7 +49641,7 @@ async function runSingleScenario(scenario, runId, options) {
       runId,
       sessionId: result.id,
       baseUrl: options.url,
-      maxTurns: effectiveOptions.minimal ? 10 : 30,
+      maxTurns: resolveAgentMaxTurns(effectiveOptions),
       a11y: effectiveOptions.a11y,
       persona: persona ? {
         name: persona.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/testers",
-  "version": "0.0.37",
+  "version": "0.0.39",
   "description": "AI-powered QA testing CLI — spawns cheap AI agents to test web apps with headless browsers",
   "type": "module",
   "main": "dist/index.js",