@detiq/crawler 1.1.11 → 1.1.13

package/dist/locator-extractor.js

@@ -34,6 +34,12 @@ function elementToPlaywrightLocator(element) {
   const text = (element.text ?? "").trim();
   const meaning = (element.meaning ?? "").trim();
   const role = mapRole(element.role);
+  const ariaState = {};
+  if (element.ariaState && typeof element.ariaState === "object") {
+    for (const [k, v] of Object.entries(element.ariaState)) {
+      if (typeof v === "string") ariaState[k] = v;
+    }
+  }
   const label = meaning || text || testId || ariaLabel || placeholder || id || name || "element";
   const key = toKey(label);
   if (testId) {
@@ -68,6 +74,18 @@ function elementToPlaywrightLocator(element) {
       };
     }
   }
+  if ((role === "checkbox" || role === "radio") && meaning) {
+    const isChecked = ariaState["checked"];
+    const stateOpt = isChecked === "true" ? `, { name: ${JSON.stringify(meaning)}, checked: true }` : isChecked === "false" ? `, { name: ${JSON.stringify(meaning)}, checked: false }` : `, { name: ${JSON.stringify(meaning)} }`;
+    return {
+      key,
+      expression: `page.getByRole(${JSON.stringify(role)}${stateOpt})`,
+      elementType: role,
+      confidence: "high",
+      source: "role-name",
+      description: meaning
+    };
+  }
   if ((role === "checkbox" || role === "radio") && ariaLabel) {
     return {
       key,
@@ -78,10 +96,26 @@ function elementToPlaywrightLocator(element) {
       description: ariaLabel
     };
   }
+  const tabLikeRoles = ["tab", "option", "treeitem", "menuitem", "menuitemcheckbox", "menuitemradio", "gridcell"];
+  if (tabLikeRoles.includes(role ?? "") && meaning) {
+    const isSelected = ariaState["selected"];
+    const isCurrent = ariaState["current"];
+    const stateOpt = isSelected === "true" ? `, { name: ${JSON.stringify(meaning)}, selected: true }` : isCurrent ? `, { name: ${JSON.stringify(meaning)} }` : `, { name: ${JSON.stringify(meaning)} }`;
+    return {
+      key,
+      expression: `page.getByRole(${JSON.stringify(role)}${stateOpt})`,
+      elementType: role ?? "element",
+      confidence: "high",
+      source: "role-name",
+      description: meaning
+    };
+  }
   if ((role === "button" || role === "link") && meaning) {
+    const isPressed = ariaState["pressed"];
+    const stateOpt = isPressed === "true" ? `, { name: ${JSON.stringify(meaning)}, pressed: true }` : isPressed === "false" ? `, { name: ${JSON.stringify(meaning)}, pressed: false }` : `, { name: ${JSON.stringify(meaning)} }`;
     return {
       key,
-      expression: `page.getByRole(${JSON.stringify(role)}, { name: ${JSON.stringify(meaning)} })`,
+      expression: `page.getByRole(${JSON.stringify(role)}${stateOpt})`,
       elementType: role,
       confidence: "high",
       source: "role-name",

package/dist/locator-extractor.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/locator-extractor.ts"],
-  "sourcesContent": ["/**\n * Converts raw DB Element records (role, meaning, notes JSON) into Playwright-idiomatic locator strings.\n * Priority: data-testid \u2192 aria-label/placeholder (inputs) \u2192 role+name (buttons/links) \u2192 heading \u2192 text \u2192 id\n */\n\nexport interface PlaywrightLocator {\n  key: string;           // camelCase property name for page object\n  expression: string;    // e.g. \"page.getByRole('button', { name: 'Submit' })\"\n  elementType: string;   // button | input | link | heading | text | element\n  confidence: 'high' | 'medium' | 'low';\n  source: 'testid' | 'label' | 'placeholder' | 'role-name' | 'heading' | 'text' | 'id';\n  description: string;   // human-readable label\n}\n\n/** Parse the notes JSON string stored on Element records. */\nfunction parseNotes(notes: unknown): Record<string, string> {\n  if (!notes) return {};\n  try {\n    const parsed = typeof notes === 'string' ? JSON.parse(notes) : notes;\n    if (parsed && typeof parsed === 'object') return parsed as Record<string, string>;\n  } catch {}\n  return {};\n}\n\n/** Map crawler role strings to Playwright role values. */\nfunction mapRole(role?: string | null): string | null {\n  if (!role) return null;\n  const r = role.toLowerCase().trim();\n  if (r === 'button' || r === 'submit' || r === 'reset') return 'button';\n  if (r === 'link' || r === 'a' || r === 'anchor') return 'link';\n  if (r === 'textbox' || r === 'input' || r === 'text' || r === 'email' || r === 'password' || r === 'tel' || r === 'number' || r === 'search') return 'textbox';\n  if (r === 'combobox' || r === 'select' || r === 'dropdown') return 'combobox';\n  if (r === 'checkbox') return 'checkbox';\n  if (r === 'radio') return 'radio';\n  if (r === 'heading' || r === 'h1' || r === 'h2' || r === 'h3' || r === 'h4' || r === 'h5' || r === 'h6') return 'heading';\n  if (r === 'img' || r === 'image') return 'img';\n  if (r === 'nav' || r === 'navigation') return 'navigation';\n  return r;\n}\n\n/** Convert \"Submit Form Button\" \u2192 \"submitFormButton\" */\nfunction toKey(text: string): string {\n  return text\n    .replace(/[^a-zA-Z0-9\\s]/g, ' ')\n    .replace(/\\s+(.)/g, (_, c) => c.toUpperCase())\n    .replace(/^(.)/, (_, c) => c.toLowerCase())\n    .replace(/\\s/g, '')\n    .slice(0, 40)\n    || 'element';\n}\n\n/** Convert a single DB Element record to a Playwright locator. Returns null if insufficient data. */\nexport function elementToPlaywrightLocator(element: {\n  role?: string | null;\n  meaning?: string | null;\n  text?: string | null;\n  notes?: unknown;\n  selector?: string | null;\n}): PlaywrightLocator | null {\n  const attrs = parseNotes(element.notes);\n  const testId = attrs['data-testid'];\n  const ariaLabel = attrs['aria-label'] || element.meaning;\n  const id = attrs['id'];\n  const placeholder = attrs['placeholder'];\n  const name = attrs['name'];\n  const text = (element.text ?? '').trim();\n  const meaning = (element.meaning ?? '').trim();\n  const role = mapRole(element.role);\n\n  const label = meaning || text || testId || ariaLabel || placeholder || id || name || 'element';\n  const key = toKey(label);\n\n  // Priority 1: data-testid\n  if (testId) {\n    return {\n      key,\n      expression: `page.getByTestId(${JSON.stringify(testId)})`,\n      elementType: role ?? 'element',\n      confidence: 'high',\n      source: 'testid',\n      description: meaning || testId,\n    };\n  }\n\n  // Priority 2: input/combobox/textarea with label \u2192 getByLabel; with placeholder \u2192 getByPlaceholder\n  if (role === 'textbox' || role === 'combobox') {\n    if (ariaLabel) {\n      return {\n        key,\n        expression: `page.getByLabel(${JSON.stringify(ariaLabel)})`,\n        elementType: 'input',\n        confidence: 'high',\n        source: 'label',\n        description: ariaLabel,\n      };\n    }\n    if (placeholder) {\n      return {\n        key,\n        expression: `page.getByPlaceholder(${JSON.stringify(placeholder)})`,\n        elementType: 'input',\n        confidence: 'high',\n        source: 'placeholder',\n        description: placeholder,\n      };\n    }\n  }\n\n  // Priority 3: checkbox/radio \u2192 getByLabel\n  if ((role === 'checkbox' || role === 'radio') && ariaLabel) {\n    return {\n      key,\n      expression: `page.getByLabel(${JSON.stringify(ariaLabel)})`,\n      elementType: role,\n      confidence: 'high',\n      source: 'label',\n      description: ariaLabel,\n    };\n  }\n\n  // Priority 4: button/link with meaningful name \u2192 getByRole\n  if ((role === 'button' || role === 'link') && meaning) {\n    return {\n      key,\n      expression: `page.getByRole(${JSON.stringify(role)}, { name: ${JSON.stringify(meaning)} })`,\n      elementType: role,\n      confidence: 'high',\n      source: 'role-name',\n      description: meaning,\n    };\n  }\n\n  // Priority 5: heading \u2192 getByRole heading\n  if (role === 'heading' && (meaning || text)) {\n    const name2 = meaning || text;\n    return {\n      key,\n      expression: `page.getByRole('heading', { name: ${JSON.stringify(name2)} })`,\n      elementType: 'heading',\n      confidence: 'medium',\n      source: 'heading',\n      description: name2,\n    };\n  }\n\n  // Priority 6: existing CSS selector from crawler\n  if (element.selector && element.selector.length > 0) {\n    return {\n      key,\n      expression: `page.locator(${JSON.stringify(element.selector)})`,\n      elementType: role ?? 'element',\n      confidence: 'medium',\n      source: 'id',\n      description: meaning || text || element.selector,\n    };\n  }\n\n  // Priority 7: id from attrs\n  if (id) {\n    return {\n      key,\n      expression: `page.locator(${JSON.stringify('#' + id)})`,\n      elementType: role ?? 'element',\n      confidence: 'medium',\n      source: 'id',\n      description: meaning || id,\n    };\n  }\n\n  // Priority 8: fallback to text content\n  if (meaning || text) {\n    const t = meaning || text;\n    return {\n      key,\n      expression: `page.getByText(${JSON.stringify(t)}, { exact: false })`,\n      elementType: role ?? 'text',\n      confidence: 'low',\n      source: 'text',\n      description: t,\n    };\n  }\n\n  return null;\n}\n\n/**\n * Convert an array of DB Element records to deduplicated Playwright locators.\n * Deduplicates by key \u2014 higher confidence wins.\n */\nexport function elementsToPlaywrightLocators(elements: Array<{\n  role?: string | null;\n  meaning?: string | null;\n  text?: string | null;\n  notes?: unknown;\n  selector?: string | null;\n  isInteractive?: boolean | null;\n}>): PlaywrightLocator[] {\n  const CONFIDENCE_RANK = { high: 0, medium: 1, low: 2 };\n  const byKey = new Map<string, PlaywrightLocator>();\n\n  for (const el of elements) {\n    const loc = elementToPlaywrightLocator(el);\n    if (!loc) continue;\n    const existing = byKey.get(loc.key);\n    if (!existing || CONFIDENCE_RANK[loc.confidence] < CONFIDENCE_RANK[existing.confidence]) {\n      byKey.set(loc.key, loc);\n    }\n  }\n\n  return Array.from(byKey.values());\n}\n\n/**\n * Format locators as a block for injection into LLM script generation prompts.\n * Returns empty string if no locators.\n */\nexport function formatLocatorsForPrompt(locators: PlaywrightLocator[]): string {\n  if (locators.length === 0) return '';\n  const lines = locators.map(l =>\n    `  ${l.key}: ${l.expression}  // ${l.description} [${l.confidence}]`\n  );\n  return [\n    'EXTRACTED PAGE LOCATORS (use these EXACTLY \u2014 do not invent other selectors; these were verified against the live page):',\n    ...lines,\n  ].join('\\n');\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Converts raw DB Element records (role, meaning, notes JSON) into Playwright-idiomatic locator strings.\n * Priority: data-testid \u2192 aria-label/placeholder (inputs) \u2192 role+name (buttons/links) \u2192 heading \u2192 text \u2192 id\n */\n\nexport interface PlaywrightLocator {\n  key: string;           // camelCase property name for page object\n  expression: string;    // e.g. \"page.getByRole('button', { name: 'Submit' })\"\n  elementType: string;   // button | input | link | heading | text | element\n  confidence: 'high' | 'medium' | 'low';\n  source: 'testid' | 'label' | 'placeholder' | 'role-name' | 'heading' | 'text' | 'id';\n  description: string;   // human-readable label\n}\n\n/** Parse the notes JSON string stored on Element records. */\nfunction parseNotes(notes: unknown): Record<string, string> {\n  if (!notes) return {};\n  try {\n    const parsed = typeof notes === 'string' ? JSON.parse(notes) : notes;\n    if (parsed && typeof parsed === 'object') return parsed as Record<string, string>;\n  } catch {}\n  return {};\n}\n\n/** Map crawler role strings to Playwright role values. */\nfunction mapRole(role?: string | null): string | null {\n  if (!role) return null;\n  const r = role.toLowerCase().trim();\n  if (r === 'button' || r === 'submit' || r === 'reset') return 'button';\n  if (r === 'link' || r === 'a' || r === 'anchor') return 'link';\n  if (r === 'textbox' || r === 'input' || r === 'text' || r === 'email' || r === 'password' || r === 'tel' || r === 'number' || r === 'search') return 'textbox';\n  if (r === 'combobox' || r === 'select' || r === 'dropdown') return 'combobox';\n  if (r === 'checkbox') return 'checkbox';\n  if (r === 'radio') return 'radio';\n  if (r === 'heading' || r === 'h1' || r === 'h2' || r === 'h3' || r === 'h4' || r === 'h5' || r === 'h6') return 'heading';\n  if (r === 'img' || r === 'image') return 'img';\n  if (r === 'nav' || r === 'navigation') return 'navigation';\n  return r;\n}\n\n/** Convert \"Submit Form Button\" \u2192 \"submitFormButton\" */\nfunction toKey(text: string): string {\n  return text\n    .replace(/[^a-zA-Z0-9\\s]/g, ' ')\n    .replace(/\\s+(.)/g, (_, c) => c.toUpperCase())\n    .replace(/^(.)/, (_, c) => c.toLowerCase())\n    .replace(/\\s/g, '')\n    .slice(0, 40)\n    || 'element';\n}\n\n/** Convert a single DB Element record to a Playwright locator. Returns null if insufficient data. */\nexport function elementToPlaywrightLocator(element: {\n  role?: string | null;\n  meaning?: string | null;\n  text?: string | null;\n  notes?: unknown;\n  selector?: string | null;\n  ariaState?: Record<string, unknown> | null;\n}): PlaywrightLocator | null {\n  const attrs = parseNotes(element.notes);\n  const testId = attrs['data-testid'];\n  const ariaLabel = attrs['aria-label'] || element.meaning;\n  const id = attrs['id'];\n  const placeholder = attrs['placeholder'];\n  const name = attrs['name'];\n  const text = (element.text ?? '').trim();\n  const meaning = (element.meaning ?? '').trim();\n  const role = mapRole(element.role);\n  const ariaState: Record<string, string> = {};\n  if (element.ariaState && typeof element.ariaState === 'object') {\n    for (const [k, v] of Object.entries(element.ariaState)) {\n      if (typeof v === 'string') ariaState[k] = v;\n    }\n  }\n\n  const label = meaning || text || testId || ariaLabel || placeholder || id || name || 'element';\n  const key = toKey(label);\n\n  // Priority 1: data-testid\n  if (testId) {\n    return {\n      key,\n      expression: `page.getByTestId(${JSON.stringify(testId)})`,\n      elementType: role ?? 'element',\n      confidence: 'high',\n      source: 'testid',\n      description: meaning || testId,\n    };\n  }\n\n  // Priority 2: input/combobox/textarea with label \u2192 getByLabel; with placeholder \u2192 getByPlaceholder\n  if (role === 'textbox' || role === 'combobox') {\n    if (ariaLabel) {\n      return {\n        key,\n        expression: `page.getByLabel(${JSON.stringify(ariaLabel)})`,\n        elementType: 'input',\n        confidence: 'high',\n        source: 'label',\n        description: ariaLabel,\n      };\n    }\n    if (placeholder) {\n      return {\n        key,\n        expression: `page.getByPlaceholder(${JSON.stringify(placeholder)})`,\n        elementType: 'input',\n        confidence: 'high',\n        source: 'placeholder',\n        description: placeholder,\n      };\n    }\n  }\n\n  // Priority 3: checkbox/radio \u2192 getByRole with optional checked state from ariaState\n  if ((role === 'checkbox' || role === 'radio') && meaning) {\n    const isChecked = ariaState['checked'];\n    const stateOpt = isChecked === 'true' ? `, { name: ${JSON.stringify(meaning)}, checked: true }` : isChecked === 'false' ? `, { name: ${JSON.stringify(meaning)}, checked: false }` : `, { name: ${JSON.stringify(meaning)} }`;\n    return {\n      key,\n      expression: `page.getByRole(${JSON.stringify(role)}${stateOpt})`,\n      elementType: role,\n      confidence: 'high',\n      source: 'role-name',\n      description: meaning,\n    };\n  }\n  if ((role === 'checkbox' || role === 'radio') && ariaLabel) {\n    return {\n      key,\n      expression: `page.getByLabel(${JSON.stringify(ariaLabel)})`,\n      elementType: role,\n      confidence: 'high',\n      source: 'label',\n      description: ariaLabel,\n    };\n  }\n\n  // Priority 3b: tab/option/treeitem \u2192 getByRole with optional selected state\n  const tabLikeRoles = ['tab', 'option', 'treeitem', 'menuitem', 'menuitemcheckbox', 'menuitemradio', 'gridcell'];\n  if (tabLikeRoles.includes(role ?? '') && meaning) {\n    const isSelected = ariaState['selected'];\n    const isCurrent = ariaState['current'];\n    const stateOpt = isSelected === 'true' ? `, { name: ${JSON.stringify(meaning)}, selected: true }` : isCurrent ? `, { name: ${JSON.stringify(meaning)} }` : `, { name: ${JSON.stringify(meaning)} }`;\n    return {\n      key,\n      expression: `page.getByRole(${JSON.stringify(role)}${stateOpt})`,\n      elementType: role ?? 'element',\n      confidence: 'high',\n      source: 'role-name',\n      description: meaning,\n    };\n  }\n\n  // Priority 4: button/link with meaningful name \u2192 getByRole; include pressed state for toggles\n  if ((role === 'button' || role === 'link') && meaning) {\n    const isPressed = ariaState['pressed'];\n    const stateOpt = isPressed === 'true' ? `, { name: ${JSON.stringify(meaning)}, pressed: true }` : isPressed === 'false' ? `, { name: ${JSON.stringify(meaning)}, pressed: false }` : `, { name: ${JSON.stringify(meaning)} }`;\n    return {\n      key,\n      expression: `page.getByRole(${JSON.stringify(role)}${stateOpt})`,\n      elementType: role,\n      confidence: 'high',\n      source: 'role-name',\n      description: meaning,\n    };\n  }\n\n  // Priority 5: heading \u2192 getByRole heading\n  if (role === 'heading' && (meaning || text)) {\n    const name2 = meaning || text;\n    return {\n      key,\n      expression: `page.getByRole('heading', { name: ${JSON.stringify(name2)} })`,\n      elementType: 'heading',\n      confidence: 'medium',\n      source: 'heading',\n      description: name2,\n    };\n  }\n\n  // Priority 6: existing CSS selector from crawler\n  if (element.selector && element.selector.length > 0) {\n    return {\n      key,\n      expression: `page.locator(${JSON.stringify(element.selector)})`,\n      elementType: role ?? 'element',\n      confidence: 'medium',\n      source: 'id',\n      description: meaning || text || element.selector,\n    };\n  }\n\n  // Priority 7: id from attrs\n  if (id) {\n    return {\n      key,\n      expression: `page.locator(${JSON.stringify('#' + id)})`,\n      elementType: role ?? 'element',\n      confidence: 'medium',\n      source: 'id',\n      description: meaning || id,\n    };\n  }\n\n  // Priority 8: fallback to text content\n  if (meaning || text) {\n    const t = meaning || text;\n    return {\n      key,\n      expression: `page.getByText(${JSON.stringify(t)}, { exact: false })`,\n      elementType: role ?? 'text',\n      confidence: 'low',\n      source: 'text',\n      description: t,\n    };\n  }\n\n  return null;\n}\n\n/**\n * Convert an array of DB Element records to deduplicated Playwright locators.\n * Deduplicates by key \u2014 higher confidence wins.\n */\nexport function elementsToPlaywrightLocators(elements: Array<{\n  role?: string | null;\n  meaning?: string | null;\n  text?: string | null;\n  notes?: unknown;\n  selector?: string | null;\n  isInteractive?: boolean | null;\n  ariaState?: Record<string, unknown> | null;\n}>): PlaywrightLocator[] {\n  const CONFIDENCE_RANK = { high: 0, medium: 1, low: 2 };\n  const byKey = new Map<string, PlaywrightLocator>();\n\n  for (const el of elements) {\n    const loc = elementToPlaywrightLocator(el);\n    if (!loc) continue;\n    const existing = byKey.get(loc.key);\n    if (!existing || CONFIDENCE_RANK[loc.confidence] < CONFIDENCE_RANK[existing.confidence]) {\n      byKey.set(loc.key, loc);\n    }\n  }\n\n  return Array.from(byKey.values());\n}\n\n/**\n * Format locators as a block for injection into LLM script generation prompts.\n * Returns empty string if no locators.\n */\nexport function formatLocatorsForPrompt(locators: PlaywrightLocator[]): string {\n  if (locators.length === 0) return '';\n  const lines = locators.map(l =>\n    `  ${l.key}: ${l.expression}  // ${l.description} [${l.confidence}]`\n  );\n  return [\n    'EXTRACTED PAGE LOCATORS (use these EXACTLY \u2014 do not invent other selectors; these were verified against the live page):',\n    ...lines,\n  ].join('\\n');\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/test-executor.js

@@ -78,6 +78,98 @@ function applyHealInfo(result, r) {
   result.healReasoning = r.healReasoning;
   result.healConfidence = r.healConfidence;
 }
+async function executeExecutionStep(page, step, options = {}) {
+  const result = {};
+  const timeout = step.timeout ?? parseInt(process.env.TEST_STEP_TIMEOUT_MS ?? "8000", 10);
+  switch (step.action) {
+    case "navigate":
+      if (!step.url) throw new Error("Navigate step missing url");
+      assertCrawlUrlSafe(step.url);
+      await page.goto(step.url, { waitUntil: "domcontentloaded", timeout });
+      break;
+    case "click": {
+      const r = await resolveLocator(page, step, options.healCtx);
+      if (!r) throw new Error("Could not resolve locator");
+      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+      result.elementSelector = step.selector;
+      await r.loc.first().click({ timeout });
+      applyHealInfo(result, r);
+      break;
+    }
+    case "fill": {
+      const r = await resolveLocator(page, step, options.healCtx);
+      if (!r) throw new Error("Could not resolve locator");
+      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+      result.elementSelector = step.selector;
+      await r.loc.first().fill(step.value ?? "", { timeout });
+      applyHealInfo(result, r);
+      break;
+    }
+    case "select": {
+      const r = await resolveLocator(page, step, options.healCtx);
+      if (!r) throw new Error("Could not resolve locator");
+      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+      result.elementSelector = step.selector;
+      await r.loc.first().selectOption(step.value ?? "", { timeout });
+      applyHealInfo(result, r);
+      break;
+    }
+    case "hover": {
+      const r = await resolveLocator(page, step, options.healCtx);
+      if (!r) throw new Error("Could not resolve locator");
+      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+      result.elementSelector = step.selector;
+      await r.loc.first().hover({ timeout });
+      applyHealInfo(result, r);
+      break;
+    }
+    case "press_key":
+      await page.keyboard.press(step.value ?? "Enter");
+      break;
+    case "assert_visible": {
+      const r = await resolveLocator(page, step, options.healCtx);
+      if (!r) throw new Error("Could not resolve locator");
+      await r.loc.first().waitFor({ state: "visible", timeout });
+      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+      result.elementSelector = step.selector;
+      applyHealInfo(result, r);
+      break;
+    }
+    case "assert_text": {
+      const r = await resolveLocator(page, step, options.healCtx);
+      if (!r) throw new Error("Could not resolve locator");
+      const text = await r.loc.first().textContent({ timeout });
+      if (!text?.includes(step.value ?? "")) {
+        throw new Error(`Expected text "${step.value}" not found. Got: "${text?.slice(0, 100)}"`);
+      }
+      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+      result.elementSelector = step.selector;
+      applyHealInfo(result, r);
+      break;
+    }
+    case "assert_url": {
+      const url = page.url();
+      if (!url.includes(step.value ?? "")) {
+        throw new Error(`Expected URL to contain "${step.value}". Got: "${url}"`);
+      }
+      break;
+    }
+    case "wait":
+      await page.waitForTimeout(step.timeout ?? parseInt(process.env.TEST_STEP_DELAY_MS ?? "2000", 10));
+      break;
+    case "screenshot":
+      break;
+    case "script":
+    case "setVariable":
+      if (step.value) {
+        await page.evaluate(step.value).catch((err) => {
+          throw new Error(`Script execution failed: ${err.message}`);
+        });
+      }
+      break;
+  }
+  return result;
+}
 async function runPlan(page, plan, options, consoleLogs, networkErrors) {
   const stepResults = [];
   let errorStep;
@@ -174,6 +266,15 @@ async function runPlan(page, plan, options, consoleLogs, networkErrors) {
           result.screenshotPath = ssPath;
           break;
         }
+        case "script":
+        case "setVariable": {
+          if (step.value) {
+            await page.evaluate(step.value).catch((err) => {
+              throw new Error(`Script execution failed: ${err.message}`);
+            });
+          }
+          break;
+        }
       }
       result.status = "PASSED";
     } catch (err) {
@@ -327,6 +428,7 @@ async function executeTestPlan(plan, options) {
   };
 }
 export {
+  executeExecutionStep,
   executeTestPlan
 };
 //# sourceMappingURL=test-executor.js.map

package/dist/test-executor.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/test-executor.ts"],
-  "sourcesContent": ["import { chromium, firefox, webkit, type Page, type Locator } from 'playwright';\nimport type { ExecutionStep } from '@detiq/agents';\nimport { assertCrawlUrlSafe } from '@detiq/core';\nimport { analyzeFailure } from './failure-analysis-agent.js';\n\nexport interface StepResult {\n  stepNumber: number;\n  description: string;\n  status: 'PASSED' | 'FAILED' | 'SKIPPED';\n  duration: number;\n  error?: string;\n  screenshotPath?: string;\n  healed?: boolean;\n  /** 'mechanical' = same selector text, different Playwright locator strategy.\n   *  'ai' = AI Self-Healing Agent matched a semantically different element\n   *  (the app's selector text itself changed, e.g. \"Sign In\" -> \"Log In\"). */\n  healedVia?: 'mechanical' | 'ai';\n  healReasoning?: string;\n  healConfidence?: number;\n  elementBoundingRect?: { x: number; y: number; width: number; height: number } | null;\n  elementSelector?: string;\n}\n\nexport interface ExecutionResult {\n  stepResults: StepResult[];\n  status: 'PASSED' | 'FAILED' | 'ERROR' | 'FLAKY';\n  errorStep?: number;\n  totalDuration: number;\n  finalScreenshotPath?: string;\n  retryCount?: number;\n  consoleLogs?: Array<{ type: string; text: string; timestamp: number }>;\n  networkErrors?: Array<{ url: string; status: number; method: string; timestamp: number }>;\n  rootCauseSummary?: string;\n  networkTimings?: Array<{ url: string; method: string; status: number; duration: number }>;\n}\n\nconst LOCATOR_STRATEGIES: ExecutionStep['selectorStrategy'][] = ['text', 'label', 'role', 'css'];\n\nfunction buildLocator(page: Page, selector: string, strategy: ExecutionStep['selectorStrategy'] = 'text'): Locator {\n  switch (strategy) {\n    case 'css':   return page.locator(selector);\n    case 'text':  return page.getByText(selector, { exact: false });\n    case 'role':  return page.getByRole(selector as any);\n    case 'label': return page.getByLabel(selector);\n    default:      return page.locator(selector);\n  }\n}\n\n/** Scans the live page for visible interactive elements \u2014 the \"current page elements\"\n *  fed to the AI Self-Healing Agent when mechanical locator strategies fail. */\nasync function extractCurrentPageElements(page: Page): Promise<Array<{ meaning: string; role: string; ariaLabel?: string; textContent?: string }>> {\n  return page.evaluate(() => {\n    const els = Array.from(document.querySelectorAll<HTMLElement>(\n      'a, button, input, select, textarea, [role=\"button\"], [role=\"link\"], [role=\"tab\"], [role=\"menuitem\"], [aria-label]'\n    ));\n    return els\n      .filter((el) => {\n        const rect = el.getBoundingClientRect();\n        return rect.width > 0 && rect.height > 0;\n      })\n      .slice(0, 200)\n      .map((el) => {\n        const ariaLabel = el.getAttribute('aria-label') ?? undefined;\n        const textContent = (el.textContent ?? '').replace(/\\s+/g, ' ').trim().slice(0, 100) || undefined;\n        const role = el.getAttribute('role') ?? el.tagName.toLowerCase();\n        return { meaning: ariaLabel || textContent || role, role, ariaLabel, textContent };\n      });\n  });\n}\n\n/**\n * Resolves a step's target element in three tiers:\n *  1. Exact selector + strategy as generated.\n *  2. Mechanical: same selector text, other Playwright locator strategies\n *     (handles a strategy mismatch, not an actual UI change).\n *  3. AI: when tenantId/projectId are supplied, asks the Self-Healing Agent to find\n *     the current page's best semantic match for the failed step description \u2014 the\n *     tier that actually survives the app's selector text changing.\n */\nasync function resolveLocator(\n  page: Page,\n  step: ExecutionStep,\n  healCtx?: { tenantId: string; projectId: string },\n): Promise<{ loc: Locator; healed: boolean; healedVia?: 'mechanical' | 'ai'; healReasoning?: string; healConfidence?: number } | null> {\n  const { selector, selectorStrategy = 'text' } = step;\n  if (!selector) return null;\n\n  const primary = buildLocator(page, selector, selectorStrategy);\n  const attached = await primary.first().isVisible({ timeout: parseInt(process.env.TEST_WAIT_TIMEOUT_MS ?? '1500', 10) }).catch(() => false);\n  if (attached) return { loc: primary, healed: false };\n\n  // Tier 2 \u2014 mechanical: try other strategies before giving up\n  for (const strategy of LOCATOR_STRATEGIES) {\n    if (strategy === selectorStrategy) continue;\n    const loc = buildLocator(page, selector, strategy);\n    const visible = await loc.first().isVisible({ timeout: parseInt(process.env.TEST_SHORT_TIMEOUT_MS ?? '800', 10) }).catch(() => false);\n    if (visible) return { loc, healed: true, healedVia: 'mechanical' };\n  }\n\n  // Tier 3 \u2014 AI: the selector text itself may no longer match anything on the page.\n  if (healCtx) {\n    try {\n      const { healElement } = await import('@detiq/agents');\n      const currentPageElements = await extractCurrentPageElements(page);\n      const result = await healElement({\n        tenantId: healCtx.tenantId,\n        projectId: healCtx.projectId,\n        failedElementMeaning: step.description || selector,\n        currentPageElements,\n      });\n      if (result.healed && result.updatedTest) {\n        const healedLoc = page.getByText(result.updatedTest.elementMeaning, { exact: false });\n        const visible = await healedLoc.first().isVisible({ timeout: parseInt(process.env.TEST_WAIT_TIMEOUT_MS ?? '1500', 10) }).catch(() => false);\n        if (visible) {\n          return {\n            loc: healedLoc,\n            healed: true,\n            healedVia: 'ai',\n            healReasoning: result.reasoning,\n            healConfidence: result.confidence,\n          };\n        }\n      }\n    } catch {\n      // AI healing is a best-effort last resort \u2014 any failure here (LLM error, bad\n      // JSON, etc.) just falls through to the caller's normal Playwright error below.\n    }\n  }\n\n  // Return primary \u2014 caller will fail with a meaningful Playwright error\n  return { loc: primary, healed: false };\n}\n\nfunction applyHealInfo(result: StepResult, r: { healed: boolean; healedVia?: 'mechanical' | 'ai'; healReasoning?: string; healConfidence?: number }): void {\n  result.healed = r.healed;\n  result.healedVia = r.healedVia;\n  result.healReasoning = r.healReasoning;\n  result.healConfidence = r.healConfidence;\n}\n\nasync function runPlan(\n  page: Page,\n  plan: ExecutionStep[],\n  options: { screenshotDir: string; testRunId: string; onStepComplete?: (result: StepResult) => void; healCtx?: { tenantId: string; projectId: string } },\n  consoleLogs: Array<{ type: string; text: string; timestamp: number }>,\n  networkErrors: Array<{ url: string; status: number; method: string; timestamp: number }>,\n): Promise<{ stepResults: StepResult[]; errorStep?: number; finalScreenshotPath?: string; consoleLogs: typeof consoleLogs; networkErrors: typeof networkErrors }> {\n  const stepResults: StepResult[] = [];\n  let errorStep: number | undefined;\n  let finalScreenshotPath: string | undefined;\n\n  for (const step of plan) {\n    const stepStart = Date.now();\n    const result: StepResult = {\n      stepNumber: step.stepNumber,\n      description: step.description,\n      status: 'FAILED',\n      duration: 0,\n    };\n\n    try {\n      const timeout = step.timeout ?? parseInt(process.env.TEST_STEP_TIMEOUT_MS ?? '8000', 10);\n\n      switch (step.action) {\n        case 'navigate':\n          if (!step.url) throw new Error('Navigate step missing url');\n          assertCrawlUrlSafe(step.url);\n          await page.goto(step.url, { waitUntil: 'domcontentloaded', timeout });\n          break;\n\n        case 'click': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().click({ timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'fill': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().fill(step.value ?? '', { timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'select': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().selectOption(step.value ?? '', { timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'hover': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().hover({ timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'press_key':\n          await page.keyboard.press(step.value ?? 'Enter');\n          break;\n\n        case 'assert_visible': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          await r.loc.first().waitFor({ state: 'visible', timeout });\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'assert_text': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          const text = await r.loc.first().textContent({ timeout });\n          if (!text?.includes(step.value ?? '')) {\n            throw new Error(`Expected text \"${step.value}\" not found. Got: \"${text?.slice(0, 100)}\"`);\n          }\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'assert_url': {\n          const url = page.url();\n          if (!url.includes(step.value ?? '')) {\n            throw new Error(`Expected URL to contain \"${step.value}\". Got: \"${url}\"`);\n          }\n          break;\n        }\n\n        case 'wait':\n          await page.waitForTimeout(step.timeout ?? parseInt(process.env.TEST_STEP_DELAY_MS ?? '2000', 10));\n          break;\n\n        case 'screenshot': {\n          const ssPath = `${options.screenshotDir}/${options.testRunId}-step-${step.stepNumber}.png`;\n          await page.screenshot({ path: ssPath, fullPage: true });\n          result.screenshotPath = ssPath;\n          break;\n        }\n      }\n\n      result.status = 'PASSED';\n    } catch (err: any) {\n      result.status = step.optional ? 'SKIPPED' : 'FAILED';\n      result.error = err.message;\n      if (!step.optional) {\n        errorStep = step.stepNumber;\n      }\n    }\n\n    try {\n      await page.waitForLoadState('networkidle', { timeout: parseInt(process.env.TEST_NETWORK_IDLE_TIMEOUT_MS ?? '1500', 10) }).catch(() => {});\n      if (!result.screenshotPath) {\n        const ssPath = `${options.screenshotDir}/${options.testRunId}-step-${step.stepNumber}.png`;\n        await page.screenshot({ path: ssPath, fullPage: true });\n        result.screenshotPath = ssPath;\n      }\n    } catch { /* Screenshot evidence is best-effort and should not fail the run. */ }\n\n    result.duration = Date.now() - stepStart;\n    stepResults.push(result);\n    options.onStepComplete?.(result);\n\n    if (result.status === 'FAILED') break;\n  }\n\n  try {\n    const finalPath = `${options.screenshotDir}/${options.testRunId}-final.png`;\n    await page.screenshot({ path: finalPath, fullPage: true });\n    finalScreenshotPath = finalPath;\n  } catch { /* non-fatal */ }\n\n  return { stepResults, errorStep, finalScreenshotPath, consoleLogs, networkErrors };\n}\n\nfunction interpolate(template: string | undefined, data: Record<string, string>): string | undefined {\n  if (!template) return template;\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_, key) => data[key] ?? `{{${key}}}`);\n}\n\nexport async function executeTestPlan(\n  plan: ExecutionStep[],\n  options: {\n    screenshotDir: string;\n    testRunId: string;\n    viewport?: { width: number; height: number };\n    onStepComplete?: (result: StepResult) => void;\n    /** Run the test up to this many times to detect flakiness (default 1). */\n    maxRuns?: number;\n    browser?: 'chromium' | 'firefox' | 'webkit';\n    /** Data row for parameterized execution: substitutes {{varname}} in step fields. */\n    dataRow?: Record<string, string>;\n    /** Enables the AI Self-Healing Agent tier when a step's selector can't be resolved\n     *  even after trying alternate locator strategies. Omit to keep mechanical-only\n     *  healing (no LLM calls during execution). */\n    healCtx?: { tenantId: string; projectId: string };\n    /** Decrypted Playwright storageState JSON \u2014 restores a logged-in session so\n     *  steps don't have to re-authenticate. Without this, any test case behind a\n     *  login wall fails at the first authenticated step. */\n    storageState?: string;\n  },\n): Promise<ExecutionResult> {\n  if (options.dataRow && Object.keys(options.dataRow).length > 0) {\n    const data = options.dataRow;\n    plan = plan.map((step) => ({\n      ...step,\n      url: interpolate(step.url, data),\n      selector: interpolate(step.selector, data),\n      value: interpolate(step.value, data),\n      description: interpolate(step.description, data) ?? step.description,\n    }));\n  }\n  const maxRuns = options.maxRuns ?? 1;\n  const browserEngine = { chromium, firefox, webkit }[options.browser ?? 'chromium'] ?? chromium;\n  const start = Date.now();\n\n  const outcomes: ('PASSED' | 'FAILED')[] = [];\n  let lastResult: Awaited<ReturnType<typeof runPlan>> | null = null;\n  let lastNetworkTimings: Array<{ url: string; method: string; status: number; duration: number }> = [];\n\n  for (let run = 0; run < maxRuns; run++) {\n    const browser = await browserEngine.launch({\n      headless: true,\n      // Optional override for environments with a non-standard/pre-provisioned\n      // browser install (e.g. a custom base image with only system Chromium).\n      ...(process.env.PLAYWRIGHT_EXECUTABLE_PATH ? { executablePath: process.env.PLAYWRIGHT_EXECUTABLE_PATH } : {}),\n    });\n    let parsedStorageState: any;\n    try {\n      parsedStorageState = options.storageState ? JSON.parse(options.storageState) : undefined;\n    } catch {\n      parsedStorageState = undefined;\n    }\n    const context = await browser.newContext({\n      viewport: options.viewport ?? { width: 1440, height: 900 },\n      ...(parsedStorageState ? { storageState: parsedStorageState } : {}),\n    });\n    const page = await context.newPage();\n\n    await page\n      .addStyleTag({ content: '*, *::before, *::after { animation-duration: 0s !important; transition-duration: 0s !important; }' })\n      .catch(() => {});\n\n    const consoleLogs: Array<{ type: string; text: string; timestamp: number }> = [];\n    const networkErrors: Array<{ url: string; status: number; method: string; timestamp: number }> = [];\n    const networkTimings: Array<{ url: string; method: string; status: number; duration: number }> = [];\n    const requestStartTimes = new Map<string, number>();\n\n    page.on('console', msg => {\n      if (consoleLogs.length < 100) {\n        consoleLogs.push({ type: msg.type(), text: msg.text().slice(0, 500), timestamp: Date.now() });\n      }\n    });\n    page.on('request', request => {\n      const url = request.url();\n      if (url.includes('/api/') || url.match(/\\/(graphql|rest|v\\d)\\//)) {\n        requestStartTimes.set(request.url(), Date.now());\n      }\n    });\n    page.on('response', response => {\n      const url = response.url();\n      const start = requestStartTimes.get(url);\n      if (start && networkTimings.length < 200) {\n        networkTimings.push({ url: url.slice(0, 300), method: response.request().method(), status: response.status(), duration: Date.now() - start });\n        requestStartTimes.delete(url);\n      }\n      if (!response.ok() && !url.includes('favicon') && networkErrors.length < 50) {\n        networkErrors.push({\n          url: url.slice(0, 300),\n          status: response.status(),\n          method: response.request().method(),\n          timestamp: Date.now(),\n        });\n      }\n    });\n\n    const TEST_EXECUTION_TIMEOUT_MS = 5 * 60_000;\n    lastResult = await Promise.race([\n      runPlan(page, plan, options, consoleLogs, networkErrors),\n      new Promise<never>((_, reject) =>\n        setTimeout(() => reject(new Error('Test execution timed out')), TEST_EXECUTION_TIMEOUT_MS)\n      ),\n    ]);\n    lastNetworkTimings = networkTimings;\n    await browser.close();\n\n    const passed = !lastResult.stepResults.some((r) => r.status === 'FAILED');\n    outcomes.push(passed ? 'PASSED' : 'FAILED');\n\n    // If all subsequent runs are consistent with first, no need to keep going\n    if (run > 0 && outcomes.every((o) => o === outcomes[0])) break;\n  }\n\n  const passCount = outcomes.filter((o) => o === 'PASSED').length;\n  const failCount = outcomes.filter((o) => o === 'FAILED').length;\n\n  let status: ExecutionResult['status'];\n  if (maxRuns > 1 && passCount > 0 && failCount > 0) {\n    status = 'FLAKY';\n  } else if (passCount === outcomes.length) {\n    status = 'PASSED';\n  } else {\n    status = 'FAILED';\n  }\n\n  let rootCauseSummary: string | undefined;\n  if (status === 'FAILED' || status === 'FLAKY') {\n    const failedStep = lastResult!.stepResults.find(s => s.status === 'FAILED');\n    rootCauseSummary = await analyzeFailure({\n      tenantId: options.healCtx?.tenantId,\n      error: failedStep?.error ?? 'Unknown error',\n      stepDescription: failedStep?.description,\n      consoleLogs: lastResult!.consoleLogs,\n      networkErrors: lastResult!.networkErrors,\n      screenshotPath: lastResult!.finalScreenshotPath,\n    }).catch(() => undefined) ?? undefined;\n  }\n\n  return {\n    stepResults: lastResult!.stepResults,\n    status,\n    errorStep: lastResult!.errorStep,\n    totalDuration: Date.now() - start,\n    finalScreenshotPath: lastResult!.finalScreenshotPath,\n    retryCount: outcomes.length - 1,\n    consoleLogs: lastResult!.consoleLogs,\n    networkErrors: lastResult!.networkErrors,\n    rootCauseSummary,\n    networkTimings: lastNetworkTimings,\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { chromium, firefox, webkit, type Page, type Locator } from 'playwright';\nimport type { ExecutionStep } from '@detiq/agents';\nimport { assertCrawlUrlSafe } from '@detiq/core';\nimport { analyzeFailure } from './failure-analysis-agent.js';\n\nexport interface StepResult {\n  stepNumber: number;\n  description: string;\n  status: 'PASSED' | 'FAILED' | 'SKIPPED';\n  duration: number;\n  error?: string;\n  screenshotPath?: string;\n  healed?: boolean;\n  /** 'mechanical' = same selector text, different Playwright locator strategy.\n   *  'ai' = AI Self-Healing Agent matched a semantically different element\n   *  (the app's selector text itself changed, e.g. \"Sign In\" -> \"Log In\"). */\n  healedVia?: 'mechanical' | 'ai';\n  healReasoning?: string;\n  healConfidence?: number;\n  elementBoundingRect?: { x: number; y: number; width: number; height: number } | null;\n  elementSelector?: string;\n}\n\nexport interface ExecutionResult {\n  stepResults: StepResult[];\n  status: 'PASSED' | 'FAILED' | 'ERROR' | 'FLAKY';\n  errorStep?: number;\n  totalDuration: number;\n  finalScreenshotPath?: string;\n  retryCount?: number;\n  consoleLogs?: Array<{ type: string; text: string; timestamp: number }>;\n  networkErrors?: Array<{ url: string; status: number; method: string; timestamp: number }>;\n  rootCauseSummary?: string;\n  networkTimings?: Array<{ url: string; method: string; status: number; duration: number }>;\n}\n\nconst LOCATOR_STRATEGIES: ExecutionStep['selectorStrategy'][] = ['text', 'label', 'role', 'css'];\n\nfunction buildLocator(page: Page, selector: string, strategy: ExecutionStep['selectorStrategy'] = 'text'): Locator {\n  switch (strategy) {\n    case 'css':   return page.locator(selector);\n    case 'text':  return page.getByText(selector, { exact: false });\n    case 'role':  return page.getByRole(selector as any);\n    case 'label': return page.getByLabel(selector);\n    default:      return page.locator(selector);\n  }\n}\n\n/** Scans the live page for visible interactive elements \u2014 the \"current page elements\"\n *  fed to the AI Self-Healing Agent when mechanical locator strategies fail. */\nasync function extractCurrentPageElements(page: Page): Promise<Array<{ meaning: string; role: string; ariaLabel?: string; textContent?: string }>> {\n  return page.evaluate(() => {\n    const els = Array.from(document.querySelectorAll<HTMLElement>(\n      'a, button, input, select, textarea, [role=\"button\"], [role=\"link\"], [role=\"tab\"], [role=\"menuitem\"], [aria-label]'\n    ));\n    return els\n      .filter((el) => {\n        const rect = el.getBoundingClientRect();\n        return rect.width > 0 && rect.height > 0;\n      })\n      .slice(0, 200)\n      .map((el) => {\n        const ariaLabel = el.getAttribute('aria-label') ?? undefined;\n        const textContent = (el.textContent ?? '').replace(/\\s+/g, ' ').trim().slice(0, 100) || undefined;\n        const role = el.getAttribute('role') ?? el.tagName.toLowerCase();\n        return { meaning: ariaLabel || textContent || role, role, ariaLabel, textContent };\n      });\n  });\n}\n\n/**\n * Resolves a step's target element in three tiers:\n *  1. Exact selector + strategy as generated.\n *  2. Mechanical: same selector text, other Playwright locator strategies\n *     (handles a strategy mismatch, not an actual UI change).\n *  3. AI: when tenantId/projectId are supplied, asks the Self-Healing Agent to find\n *     the current page's best semantic match for the failed step description \u2014 the\n *     tier that actually survives the app's selector text changing.\n */\nasync function resolveLocator(\n  page: Page,\n  step: ExecutionStep,\n  healCtx?: { tenantId: string; projectId: string },\n): Promise<{ loc: Locator; healed: boolean; healedVia?: 'mechanical' | 'ai'; healReasoning?: string; healConfidence?: number } | null> {\n  const { selector, selectorStrategy = 'text' } = step;\n  if (!selector) return null;\n\n  const primary = buildLocator(page, selector, selectorStrategy);\n  const attached = await primary.first().isVisible({ timeout: parseInt(process.env.TEST_WAIT_TIMEOUT_MS ?? '1500', 10) }).catch(() => false);\n  if (attached) return { loc: primary, healed: false };\n\n  // Tier 2 \u2014 mechanical: try other strategies before giving up\n  for (const strategy of LOCATOR_STRATEGIES) {\n    if (strategy === selectorStrategy) continue;\n    const loc = buildLocator(page, selector, strategy);\n    const visible = await loc.first().isVisible({ timeout: parseInt(process.env.TEST_SHORT_TIMEOUT_MS ?? '800', 10) }).catch(() => false);\n    if (visible) return { loc, healed: true, healedVia: 'mechanical' };\n  }\n\n  // Tier 3 \u2014 AI: the selector text itself may no longer match anything on the page.\n  if (healCtx) {\n    try {\n      const { healElement } = await import('@detiq/agents');\n      const currentPageElements = await extractCurrentPageElements(page);\n      const result = await healElement({\n        tenantId: healCtx.tenantId,\n        projectId: healCtx.projectId,\n        failedElementMeaning: step.description || selector,\n        currentPageElements,\n      });\n      if (result.healed && result.updatedTest) {\n        const healedLoc = page.getByText(result.updatedTest.elementMeaning, { exact: false });\n        const visible = await healedLoc.first().isVisible({ timeout: parseInt(process.env.TEST_WAIT_TIMEOUT_MS ?? '1500', 10) }).catch(() => false);\n        if (visible) {\n          return {\n            loc: healedLoc,\n            healed: true,\n            healedVia: 'ai',\n            healReasoning: result.reasoning,\n            healConfidence: result.confidence,\n          };\n        }\n      }\n    } catch {\n      // AI healing is a best-effort last resort \u2014 any failure here (LLM error, bad\n      // JSON, etc.) just falls through to the caller's normal Playwright error below.\n    }\n  }\n\n  // Return primary \u2014 caller will fail with a meaningful Playwright error\n  return { loc: primary, healed: false };\n}\n\nfunction applyHealInfo(result: StepResult, r: { healed: boolean; healedVia?: 'mechanical' | 'ai'; healReasoning?: string; healConfidence?: number }): void {\n  result.healed = r.healed;\n  result.healedVia = r.healedVia;\n  result.healReasoning = r.healReasoning;\n  result.healConfidence = r.healConfidence;\n}\n\nexport async function executeExecutionStep(\n  page: Page,\n  step: ExecutionStep,\n  options: { healCtx?: { tenantId: string; projectId: string } } = {},\n): Promise<Pick<StepResult, 'healed' | 'healedVia' | 'healReasoning' | 'healConfidence' | 'elementBoundingRect' | 'elementSelector'>> {\n  const result: Pick<StepResult, 'healed' | 'healedVia' | 'healReasoning' | 'healConfidence' | 'elementBoundingRect' | 'elementSelector'> = {};\n  const timeout = step.timeout ?? parseInt(process.env.TEST_STEP_TIMEOUT_MS ?? '8000', 10);\n\n  switch (step.action) {\n    case 'navigate':\n      if (!step.url) throw new Error('Navigate step missing url');\n      assertCrawlUrlSafe(step.url);\n      await page.goto(step.url, { waitUntil: 'domcontentloaded', timeout });\n      break;\n\n    case 'click': {\n      const r = await resolveLocator(page, step, options.healCtx);\n      if (!r) throw new Error('Could not resolve locator');\n      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n      result.elementSelector = step.selector;\n      await r.loc.first().click({ timeout });\n      applyHealInfo(result as StepResult, r);\n      break;\n    }\n\n    case 'fill': {\n      const r = await resolveLocator(page, step, options.healCtx);\n      if (!r) throw new Error('Could not resolve locator');\n      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n      result.elementSelector = step.selector;\n      await r.loc.first().fill(step.value ?? '', { timeout });\n      applyHealInfo(result as StepResult, r);\n      break;\n    }\n\n    case 'select': {\n      const r = await resolveLocator(page, step, options.healCtx);\n      if (!r) throw new Error('Could not resolve locator');\n      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n      result.elementSelector = step.selector;\n      await r.loc.first().selectOption(step.value ?? '', { timeout });\n      applyHealInfo(result as StepResult, r);\n      break;\n    }\n\n    case 'hover': {\n      const r = await resolveLocator(page, step, options.healCtx);\n      if (!r) throw new Error('Could not resolve locator');\n      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n      result.elementSelector = step.selector;\n      await r.loc.first().hover({ timeout });\n      applyHealInfo(result as StepResult, r);\n      break;\n    }\n\n    case 'press_key':\n      await page.keyboard.press(step.value ?? 'Enter');\n      break;\n\n    case 'assert_visible': {\n      const r = await resolveLocator(page, step, options.healCtx);\n      if (!r) throw new Error('Could not resolve locator');\n      await r.loc.first().waitFor({ state: 'visible', timeout });\n      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n      result.elementSelector = step.selector;\n      applyHealInfo(result as StepResult, r);\n      break;\n    }\n\n    case 'assert_text': {\n      const r = await resolveLocator(page, step, options.healCtx);\n      if (!r) throw new Error('Could not resolve locator');\n      const text = await r.loc.first().textContent({ timeout });\n      if (!text?.includes(step.value ?? '')) {\n        throw new Error(`Expected text \"${step.value}\" not found. Got: \"${text?.slice(0, 100)}\"`);\n      }\n      result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n      result.elementSelector = step.selector;\n      applyHealInfo(result as StepResult, r);\n      break;\n    }\n\n    case 'assert_url': {\n      const url = page.url();\n      if (!url.includes(step.value ?? '')) {\n        throw new Error(`Expected URL to contain \"${step.value}\". Got: \"${url}\"`);\n      }\n      break;\n    }\n\n    case 'wait':\n      await page.waitForTimeout(step.timeout ?? parseInt(process.env.TEST_STEP_DELAY_MS ?? '2000', 10));\n      break;\n\n    case 'screenshot':\n      break;\n\n    case 'script':\n    case 'setVariable':\n      if (step.value) {\n        await page.evaluate(step.value).catch(err => {\n          throw new Error(`Script execution failed: ${err.message}`);\n        });\n      }\n      break;\n  }\n\n  return result;\n}\n\nasync function runPlan(\n  page: Page,\n  plan: ExecutionStep[],\n  options: { screenshotDir: string; testRunId: string; onStepComplete?: (result: StepResult) => void; healCtx?: { tenantId: string; projectId: string } },\n  consoleLogs: Array<{ type: string; text: string; timestamp: number }>,\n  networkErrors: Array<{ url: string; status: number; method: string; timestamp: number }>,\n): Promise<{ stepResults: StepResult[]; errorStep?: number; finalScreenshotPath?: string; consoleLogs: typeof consoleLogs; networkErrors: typeof networkErrors }> {\n  const stepResults: StepResult[] = [];\n  let errorStep: number | undefined;\n  let finalScreenshotPath: string | undefined;\n\n  for (const step of plan) {\n    const stepStart = Date.now();\n    const result: StepResult = {\n      stepNumber: step.stepNumber,\n      description: step.description,\n      status: 'FAILED',\n      duration: 0,\n    };\n\n    try {\n      const timeout = step.timeout ?? parseInt(process.env.TEST_STEP_TIMEOUT_MS ?? '8000', 10);\n\n      switch (step.action) {\n        case 'navigate':\n          if (!step.url) throw new Error('Navigate step missing url');\n          assertCrawlUrlSafe(step.url);\n          await page.goto(step.url, { waitUntil: 'domcontentloaded', timeout });\n          break;\n\n        case 'click': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().click({ timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'fill': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().fill(step.value ?? '', { timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'select': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().selectOption(step.value ?? '', { timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'hover': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          await r.loc.first().hover({ timeout });\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'press_key':\n          await page.keyboard.press(step.value ?? 'Enter');\n          break;\n\n        case 'assert_visible': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          await r.loc.first().waitFor({ state: 'visible', timeout });\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'assert_text': {\n          const r = await resolveLocator(page, step, options.healCtx);\n          if (!r) throw new Error('Could not resolve locator');\n          const text = await r.loc.first().textContent({ timeout });\n          if (!text?.includes(step.value ?? '')) {\n            throw new Error(`Expected text \"${step.value}\" not found. Got: \"${text?.slice(0, 100)}\"`);\n          }\n          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);\n          result.elementSelector = step.selector;\n          applyHealInfo(result, r);\n          break;\n        }\n\n        case 'assert_url': {\n          const url = page.url();\n          if (!url.includes(step.value ?? '')) {\n            throw new Error(`Expected URL to contain \"${step.value}\". Got: \"${url}\"`);\n          }\n          break;\n        }\n\n        case 'wait':\n          await page.waitForTimeout(step.timeout ?? parseInt(process.env.TEST_STEP_DELAY_MS ?? '2000', 10));\n          break;\n\n        case 'screenshot': {\n          const ssPath = `${options.screenshotDir}/${options.testRunId}-step-${step.stepNumber}.png`;\n          await page.screenshot({ path: ssPath, fullPage: true });\n          result.screenshotPath = ssPath;\n          break;\n        }\n\n        case 'script':\n        case 'setVariable': {\n          if (step.value) {\n            // Execute arbitrary JS string. Often used by manual test builder extension for custom variables\n            // or assertions.\n            await page.evaluate(step.value).catch(err => {\n              throw new Error(`Script execution failed: ${err.message}`);\n            });\n          }\n          break;\n        }\n      }\n\n      result.status = 'PASSED';\n    } catch (err: any) {\n      result.status = step.optional ? 'SKIPPED' : 'FAILED';\n      result.error = err.message;\n      if (!step.optional) {\n        errorStep = step.stepNumber;\n      }\n    }\n\n    try {\n      await page.waitForLoadState('networkidle', { timeout: parseInt(process.env.TEST_NETWORK_IDLE_TIMEOUT_MS ?? '1500', 10) }).catch(() => {});\n      if (!result.screenshotPath) {\n        const ssPath = `${options.screenshotDir}/${options.testRunId}-step-${step.stepNumber}.png`;\n        await page.screenshot({ path: ssPath, fullPage: true });\n        result.screenshotPath = ssPath;\n      }\n    } catch { /* Screenshot evidence is best-effort and should not fail the run. */ }\n\n    result.duration = Date.now() - stepStart;\n    stepResults.push(result);\n    options.onStepComplete?.(result);\n\n    if (result.status === 'FAILED') break;\n  }\n\n  try {\n    const finalPath = `${options.screenshotDir}/${options.testRunId}-final.png`;\n    await page.screenshot({ path: finalPath, fullPage: true });\n    finalScreenshotPath = finalPath;\n  } catch { /* non-fatal */ }\n\n  return { stepResults, errorStep, finalScreenshotPath, consoleLogs, networkErrors };\n}\n\nfunction interpolate(template: string | undefined, data: Record<string, string>): string | undefined {\n  if (!template) return template;\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (_, key) => data[key] ?? `{{${key}}}`);\n}\n\nexport async function executeTestPlan(\n  plan: ExecutionStep[],\n  options: {\n    screenshotDir: string;\n    testRunId: string;\n    viewport?: { width: number; height: number };\n    onStepComplete?: (result: StepResult) => void;\n    /** Run the test up to this many times to detect flakiness (default 1). */\n    maxRuns?: number;\n    browser?: 'chromium' | 'firefox' | 'webkit';\n    /** Data row for parameterized execution: substitutes {{varname}} in step fields. */\n    dataRow?: Record<string, string>;\n    /** Enables the AI Self-Healing Agent tier when a step's selector can't be resolved\n     *  even after trying alternate locator strategies. Omit to keep mechanical-only\n     *  healing (no LLM calls during execution). */\n    healCtx?: { tenantId: string; projectId: string };\n    /** Decrypted Playwright storageState JSON \u2014 restores a logged-in session so\n     *  steps don't have to re-authenticate. Without this, any test case behind a\n     *  login wall fails at the first authenticated step. */\n    storageState?: string;\n  },\n): Promise<ExecutionResult> {\n  if (options.dataRow && Object.keys(options.dataRow).length > 0) {\n    const data = options.dataRow;\n    plan = plan.map((step) => ({\n      ...step,\n      url: interpolate(step.url, data),\n      selector: interpolate(step.selector, data),\n      value: interpolate(step.value, data),\n      description: interpolate(step.description, data) ?? step.description,\n    }));\n  }\n  const maxRuns = options.maxRuns ?? 1;\n  const browserEngine = { chromium, firefox, webkit }[options.browser ?? 'chromium'] ?? chromium;\n  const start = Date.now();\n\n  const outcomes: ('PASSED' | 'FAILED')[] = [];\n  let lastResult: Awaited<ReturnType<typeof runPlan>> | null = null;\n  let lastNetworkTimings: Array<{ url: string; method: string; status: number; duration: number }> = [];\n\n  for (let run = 0; run < maxRuns; run++) {\n    const browser = await browserEngine.launch({\n      headless: true,\n      // Optional override for environments with a non-standard/pre-provisioned\n      // browser install (e.g. a custom base image with only system Chromium).\n      ...(process.env.PLAYWRIGHT_EXECUTABLE_PATH ? { executablePath: process.env.PLAYWRIGHT_EXECUTABLE_PATH } : {}),\n    });\n    let parsedStorageState: any;\n    try {\n      parsedStorageState = options.storageState ? JSON.parse(options.storageState) : undefined;\n    } catch {\n      parsedStorageState = undefined;\n    }\n    const context = await browser.newContext({\n      viewport: options.viewport ?? { width: 1440, height: 900 },\n      ...(parsedStorageState ? { storageState: parsedStorageState } : {}),\n    });\n    const page = await context.newPage();\n\n    await page\n      .addStyleTag({ content: '*, *::before, *::after { animation-duration: 0s !important; transition-duration: 0s !important; }' })\n      .catch(() => {});\n\n    const consoleLogs: Array<{ type: string; text: string; timestamp: number }> = [];\n    const networkErrors: Array<{ url: string; status: number; method: string; timestamp: number }> = [];\n    const networkTimings: Array<{ url: string; method: string; status: number; duration: number }> = [];\n    const requestStartTimes = new Map<string, number>();\n\n    page.on('console', msg => {\n      if (consoleLogs.length < 100) {\n        consoleLogs.push({ type: msg.type(), text: msg.text().slice(0, 500), timestamp: Date.now() });\n      }\n    });\n    page.on('request', request => {\n      const url = request.url();\n      if (url.includes('/api/') || url.match(/\\/(graphql|rest|v\\d)\\//)) {\n        requestStartTimes.set(request.url(), Date.now());\n      }\n    });\n    page.on('response', response => {\n      const url = response.url();\n      const start = requestStartTimes.get(url);\n      if (start && networkTimings.length < 200) {\n        networkTimings.push({ url: url.slice(0, 300), method: response.request().method(), status: response.status(), duration: Date.now() - start });\n        requestStartTimes.delete(url);\n      }\n      if (!response.ok() && !url.includes('favicon') && networkErrors.length < 50) {\n        networkErrors.push({\n          url: url.slice(0, 300),\n          status: response.status(),\n          method: response.request().method(),\n          timestamp: Date.now(),\n        });\n      }\n    });\n\n    const TEST_EXECUTION_TIMEOUT_MS = 5 * 60_000;\n    lastResult = await Promise.race([\n      runPlan(page, plan, options, consoleLogs, networkErrors),\n      new Promise<never>((_, reject) =>\n        setTimeout(() => reject(new Error('Test execution timed out')), TEST_EXECUTION_TIMEOUT_MS)\n      ),\n    ]);\n    lastNetworkTimings = networkTimings;\n    await browser.close();\n\n    const passed = !lastResult.stepResults.some((r) => r.status === 'FAILED');\n    outcomes.push(passed ? 'PASSED' : 'FAILED');\n\n    // If all subsequent runs are consistent with first, no need to keep going\n    if (run > 0 && outcomes.every((o) => o === outcomes[0])) break;\n  }\n\n  const passCount = outcomes.filter((o) => o === 'PASSED').length;\n  const failCount = outcomes.filter((o) => o === 'FAILED').length;\n\n  let status: ExecutionResult['status'];\n  if (maxRuns > 1 && passCount > 0 && failCount > 0) {\n    status = 'FLAKY';\n  } else if (passCount === outcomes.length) {\n    status = 'PASSED';\n  } else {\n    status = 'FAILED';\n  }\n\n  let rootCauseSummary: string | undefined;\n  if (status === 'FAILED' || status === 'FLAKY') {\n    const failedStep = lastResult!.stepResults.find(s => s.status === 'FAILED');\n    rootCauseSummary = await analyzeFailure({\n      tenantId: options.healCtx?.tenantId,\n      error: failedStep?.error ?? 'Unknown error',\n      stepDescription: failedStep?.description,\n      consoleLogs: lastResult!.consoleLogs,\n      networkErrors: lastResult!.networkErrors,\n      screenshotPath: lastResult!.finalScreenshotPath,\n    }).catch(() => undefined) ?? undefined;\n  }\n\n  return {\n    stepResults: lastResult!.stepResults,\n    status,\n    errorStep: lastResult!.errorStep,\n    totalDuration: Date.now() - start,\n    finalScreenshotPath: lastResult!.finalScreenshotPath,\n    retryCount: outcomes.length - 1,\n    consoleLogs: lastResult!.consoleLogs,\n    networkErrors: lastResult!.networkErrors,\n    rootCauseSummary,\n    networkTimings: lastNetworkTimings,\n  };\n}\n"],
+  "mappings": "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",
   "names": ["start"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@detiq/crawler",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "private": false,
   "publishConfig": {
     "access": "public",

package/src/content-chunker.ts

@@ -21,9 +21,9 @@ export function estimateTokens(text: string): number {
 }
 
 export function chunkContent(text: string, opts: ChunkOpts): Chunk[] {
-  const size = opts.chunkSize ?? 2000;
+  const size = opts.chunkSize ?? (parseInt(process.env.CRAWLER_CONTENT_CHUNK_SIZE ?? '') || 2000);
   const charSize = size * 4;
-  const overlap = opts.overlap ?? 200;
+  const overlap = opts.overlap ?? (parseInt(process.env.CRAWLER_CONTENT_CHUNK_OVERLAP ?? '') || 200);
   const overlapChars = overlap * 4;
 
   switch (opts.strategy) {