pi-agent-browser-native 0.9.3 → 0.9.5

package/dist/extensions/agent-browser/lib/input-modes/job.js

@@ -1,87 +1,9 @@
 import { isRecord } from "../parsing.js";
-import { summarizeNetworkFailures } from "../results/network.js";
-import { truncateText } from "../results/text.js";
-import { getBatchResultItems, getCommandNameFromBatchItem } from "./shared.js";
+import { isStringArray } from "./shared.js";
 import { AGENT_BROWSER_QA_LOAD_STATES, } from "./types.js";
-function describeQaChecksRun(checks) {
-    const parts = [`load:${checks.loadState}`];
-    if (checks.expectedText.length > 0)
-        parts.push(`text×${checks.expectedText.length}`);
-    if (checks.expectedSelector)
-        parts.push("selector");
-    if (checks.checkNetwork)
-        parts.push("network");
-    if (checks.checkConsole)
-        parts.push("console");
-    if (checks.checkErrors)
-        parts.push("errors");
-    if (checks.diagnosticsResetAtStart)
-        parts.push("diagnostics-reset");
-    else if (checks.checkNetwork || checks.checkConsole || checks.checkErrors)
-        parts.push("attached-diagnostics-preserved");
-    if (checks.screenshotPath)
-        parts.push("screenshot");
-    return parts.join(", ");
-}
-export function extractQaPageContext(options) {
-    if (options.attachedTarget?.title || options.attachedTarget?.url) {
-        return { title: options.attachedTarget.title, url: options.attachedTarget.url };
-    }
-    for (const item of getBatchResultItems(options.batchData)) {
-        if (getCommandNameFromBatchItem(item) !== "open" || !isRecord(item.result))
-            continue;
-        const url = typeof item.result.url === "string" ? item.result.url : undefined;
-        const title = typeof item.result.title === "string" ? item.result.title : undefined;
-        if (url || title)
-            return { title, url };
-    }
-    if (options.compiled?.checks.url) {
-        return { url: options.compiled.checks.url };
-    }
-    return {};
-}
-export function buildQaCompactPassText(options) {
-    const lines = [options.qaPreset.summary];
-    const pageParts = [options.page?.title, options.page?.url].filter((part) => typeof part === "string" && part.length > 0);
-    if (pageParts.length > 0)
-        lines.push(`Page: ${pageParts.join(" — ")}`);
-    lines.push(`Checks run: ${describeQaChecksRun(options.checks)} (${options.batchStepCount} batch step${options.batchStepCount === 1 ? "" : "s"})`);
-    if (options.checks.diagnosticsResetAtStart && (options.checks.checkNetwork || options.checks.checkConsole || options.checks.checkErrors)) {
-        lines.push("Diagnostic isolation: URL QA requests clears of enabled diagnostic buffers before opening the target.");
-    }
-    if (options.checks.attached && !options.checks.diagnosticsResetAtStart && (options.checks.checkNetwork || options.checks.checkConsole || options.checks.checkErrors)) {
-        lines.push("Attached diagnostics: existing upstream session console/network/error buffers were preserved; rows may include events from before qa.attached started.");
-    }
-    if (options.checks.screenshotPath) {
-        const verification = options.artifactVerification;
-        lines.push(verification
-            ? `Screenshot: ${options.checks.screenshotPath} (${verification.verifiedCount}/${verification.artifacts.length} verified on disk)`
-            : `Screenshot: ${options.checks.screenshotPath}`);
-    }
-    lines.push("Full diagnostic matrix: see details.qaPreset and details.batchSteps.");
-    return lines.join("\n");
-}
-export function buildQaCompactFailureText(options) {
-    const lines = [options.causalError
-            ? truncateText(options.causalError.replace(/\s+/g, " ").trim(), 700)
-            : options.qaPreset.summary];
-    const pageParts = [options.page?.title, options.page?.url].filter((part) => typeof part === "string" && part.length > 0);
-    if (pageParts.length > 0)
-        lines.push(`Page: ${pageParts.join(" — ")}`);
-    if (options.qaPreset.failedChecks.length > 0)
-        lines.push("Failed checks:", ...options.qaPreset.failedChecks.map((failure) => `- ${failure}`));
-    if (options.qaPreset.notRunChecks.length > 0)
-        lines.push("Not run:", ...options.qaPreset.notRunChecks.map((check) => `- ${check}`));
-    if (options.qaPreset.warnings.length > 0)
-        lines.push("Warnings:", ...options.qaPreset.warnings.map((warning) => `- ${warning}`));
-    lines.push(`Execution: ${options.executedStepCount ?? "unknown"}/${options.plannedStepCount} batch steps`);
-    lines.push("Full diagnostic matrix: see details.qaPreset and details.batchSteps.");
-    return lines.join("\n");
-}
+export { analyzeQaPresetResults, analyzeQaPresetTimeout } from "./qa-analysis.js";
+export { extractQaPageContext, buildQaCompactPassText, buildQaCompactFailureText, } from "./qa-presentation.js";
 const QA_VISIBLE_TEXT_TIMEOUT_MS = 5_000;
-function formatQaExpectedTextPreview(text) {
-    return JSON.stringify(text.length > 80 ? `${text.slice(0, 77)}...` : text);
-}
 function buildQaVisibleTextPredicate(text) {
     return `(() => {
   const expected = ${JSON.stringify(text)}.replace(/\\s+/g, " ").trim();
@@ -97,9 +19,10 @@ function buildQaVisibleTextPredicate(text) {
     if (style.display === "none" || style.visibility === "hidden" || Number(style.opacity) === 0) return false;
     return element.getClientRects().length > 0;
   };
-  const hasVisibleAncestors = (node) => {
+  const ancestorsAllowVisibility = (node) => {
     for (let element = node.parentElement; element; element = element.parentElement) {
-      if (!isVisibleElement(element)) return false;
+      const style = window.getComputedStyle(element);
+      if (style.display === "none" || Number(style.opacity) === 0) return false;
       if (element === root) break;
     }
     return true;
@@ -107,283 +30,166 @@ function buildQaVisibleTextPredicate(text) {
   const textWalker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
   let visitedText = 0;
   for (let node = textWalker.nextNode(); node && visitedText < 6000; node = textWalker.nextNode(), visitedText += 1) {
-    if (!hasVisibleAncestors(node)) continue;
+    const parent = node.parentElement;
+    if (!(parent instanceof HTMLElement) || skipTags.has(parent.tagName)) continue;
+    if (window.getComputedStyle(parent).visibility === "hidden" || !ancestorsAllowVisibility(node)) continue;
     if (normalize(node.nodeValue).includes(expected)) return true;
   }
   const elementWalker = document.createTreeWalker(root, NodeFilter.SHOW_ELEMENT);
   let visitedElements = 0;
   for (let node = elementWalker.nextNode(); node && visitedElements < 3000; node = elementWalker.nextNode(), visitedElements += 1) {
     const element = node;
-    if (!isVisibleElement(element) || !("value" in element)) continue;
+    if (!isVisibleElement(element) || !ancestorsAllowVisibility(element) || !("value" in element)) continue;
     if (normalize(element.value).includes(expected)) return true;
   }
   return false;
 })()`;
 }
-function qaVisibleTextWaitPassed(item, step) {
-    if (step.args[0] !== "wait" || step.args[1] !== "--fn")
-        return undefined;
-    if (!item || item.success === false)
-        return false;
-    if (typeof item.result === "boolean")
-        return item.result;
-    if (isRecord(item.result) && typeof item.result.result === "boolean")
-        return item.result.result;
-    return true;
-}
-function extractQaTextAssertionResultText(item) {
-    if (!item || item.success === false)
-        return undefined;
-    const result = item.result;
-    if (typeof result === "string")
-        return result;
-    if (!isRecord(result))
-        return undefined;
-    for (const key of ["result", "text", "value"]) {
-        const value = result[key];
-        if (typeof value === "string")
-            return value;
-    }
-    return undefined;
-}
-function qaErrorSignature(error) {
-    if (typeof error === "string")
-        return error;
-    try {
-        return JSON.stringify(error);
+function validateQaIdentity(input) {
+    if (input.attached !== undefined && typeof input.attached !== "boolean") {
+        return "qa.attached must be a boolean when provided.";
     }
-    catch {
-        return String(error);
+    if (input.attached === true) {
+        return input.url === undefined ? undefined : "qa.url must be omitted when qa.attached is true.";
     }
+    return typeof input.url !== "string" || input.url.trim().length === 0
+        ? "qa.url must be a non-empty string."
+        : undefined;
 }
-function subtractQaBaselineErrors(errors, baselineErrors) {
-    const baselineCounts = new Map();
-    for (const error of baselineErrors) {
-        const signature = qaErrorSignature(error);
-        baselineCounts.set(signature, (baselineCounts.get(signature) ?? 0) + 1);
-    }
-    let matchedCount = 0;
-    const novelErrors = errors.filter((error) => {
-        const signature = qaErrorSignature(error);
-        const count = baselineCounts.get(signature) ?? 0;
-        if (count === 0)
-            return true;
-        baselineCounts.set(signature, count - 1);
-        matchedCount += 1;
-        return false;
-    });
-    return { matchedCount, novelErrors };
-}
-function isDiagnosticResetCommand(item) {
-    const command = item.command;
-    if (!Array.isArray(command) || !command.every((token) => typeof token === "string"))
-        return false;
-    const [name, subcommand] = command;
-    return command.includes("--clear") && (name === "console" || name === "errors" || (name === "network" && subcommand === "requests"));
-}
-export function analyzeQaPresetTimeout(compiled) {
-    if (compiled.checks.expectedText.length === 0)
-        return undefined;
-    const failedChecks = compiled.checks.expectedText.map((text) => `expected text was not verified before timeout: ${formatQaExpectedTextPreview(text)}`);
-    return {
-        failedChecks,
-        notRunChecks: [],
-        passed: false,
-        summary: `QA preset failed: ${failedChecks.join("; ")}.`,
-        warnings: ["The wrapper timed out before expected-text evidence could be verified; inspect timeoutPartialProgress and retry with a narrower readiness condition if the page was still loading."],
-    };
-}
-function describeNotRunQaChecks(compiled, executedStepCount) {
-    const checks = [];
-    let expectedTextIndex = 0;
-    for (const [index, step] of compiled.steps.entries()) {
-        let check;
-        if (step.action === "assertText") {
-            const expected = compiled.checks.expectedText[expectedTextIndex++];
-            if (expected)
-                check = `expected text: ${formatQaExpectedTextPreview(expected)}`;
-        }
-        else if (step.args[0] === "wait" && step.args[1] === "--load") {
-            check = `load state: ${step.args[2]}`;
-        }
-        else if (compiled.checks.expectedSelector && step.args[0] === "wait" && step.args[1] === compiled.checks.expectedSelector) {
-            check = `expected selector: ${formatQaExpectedTextPreview(compiled.checks.expectedSelector)}`;
-        }
-        else if (step.args[0] === "network" && !step.args.includes("--clear")) {
-            check = "network diagnostics";
-        }
-        else if (step.args[0] === "console" && !step.args.includes("--clear")) {
-            check = "console diagnostics";
+function validateQaOptions(input) {
+    for (const field of ["expectedSelector", "screenshotPath"]) {
+        const value = input[field];
+        if (value !== undefined && (typeof value !== "string" || value.trim().length === 0)) {
+            return `qa.${field} must be a non-empty string when provided.`;
         }
-        else if (step.args[0] === "errors" && !step.args.includes("--clear") && step.generatedFrom !== "qa.errorBaselineAfterClear") {
-            check = "page error diagnostics";
-        }
-        else if (step.action === "screenshot") {
-            check = `screenshot: ${formatQaExpectedTextPreview(step.args[1] ?? "")}`;
-        }
-        if (index >= executedStepCount && check)
-            checks.push(check);
     }
-    return checks;
-}
-export function analyzeQaPresetResults(data, compiled) {
-    const items = getBatchResultItems(data);
-    if (items.length === 0)
-        return undefined;
-    const failedChecks = [];
-    const warnings = [];
-    const baselineErrorIndex = compiled?.checks.diagnosticsResetAtStart && compiled.checks.checkErrors
-        ? compiled.steps.findIndex((step) => step.generatedFrom === "qa.errorBaselineAfterClear")
-        : -1;
-    const baselineErrorItem = baselineErrorIndex >= 0 ? items[baselineErrorIndex] : undefined;
-    const baselineErrorResult = isRecord(baselineErrorItem?.result) ? baselineErrorItem.result : undefined;
-    const baselineErrors = Array.isArray(baselineErrorResult?.errors) ? baselineErrorResult.errors : [];
-    for (const [index, item] of items.entries()) {
-        if (item.success === false) {
-            failedChecks.push(`${getCommandNameFromBatchItem(item) ?? "step"} failed`);
-        }
-        if (index === baselineErrorIndex)
-            continue;
-        const result = isRecord(item.result) ? item.result : undefined;
-        const commandName = getCommandNameFromBatchItem(item);
-        if (compiled?.checks.diagnosticsResetAtStart && isDiagnosticResetCommand(item)) {
-            continue;
-        }
-        if (commandName === "errors" && Array.isArray(result?.errors) && result.errors.length > 0) {
-            const { matchedCount, novelErrors } = subtractQaBaselineErrors(result.errors, baselineErrors);
-            if (novelErrors.length > 0)
-                failedChecks.push(`${novelErrors.length} page error(s)`);
-            if (matchedCount > 0)
-                failedChecks.push(`page-error check could not be verified (${matchedCount} row(s) matched the post-clear baseline; old residue and identical new errors are indistinguishable)`);
-        }
-        if (commandName === "console" && Array.isArray(result?.messages)) {
-            const errorCount = result.messages.filter((message) => isRecord(message) && /error/i.test(String(message.type ?? message.level ?? ""))).length;
-            if (errorCount > 0)
-                failedChecks.push(`${errorCount} console error message(s)`);
-        }
-        if (commandName === "network" && Array.isArray(result?.requests)) {
-            const networkFailures = summarizeNetworkFailures(result.requests);
-            if (networkFailures.actionableCount > 0)
-                failedChecks.push(`${networkFailures.actionableCount} actionable failed network request(s)`);
-            if (networkFailures.benignCount > 0)
-                warnings.push(`${networkFailures.benignCount} benign network request failure(s) ignored`);
+    for (const field of ["checkConsole", "checkErrors", "checkNetwork"]) {
+        const value = input[field];
+        if (value !== undefined && typeof value !== "boolean") {
+            return `qa.${field} must be a boolean when provided.`;
         }
     }
-    if (compiled?.checks.expectedText.length) {
-        let expectedTextIndex = 0;
-        compiled.steps.forEach((step, index) => {
-            if (step.action !== "assertText")
-                return;
-            const expected = compiled.checks.expectedText[expectedTextIndex++];
-            if (!expected)
-                return;
-            if (!items[index])
-                return;
-            const visibleTextPassed = qaVisibleTextWaitPassed(items[index], step);
-            if (visibleTextPassed === true)
-                return;
-            const actual = extractQaTextAssertionResultText(items[index]);
-            if (!actual || !actual.includes(expected))
-                failedChecks.push(`expected text not found: ${formatQaExpectedTextPreview(expected)}`);
-        });
+    return undefined;
+}
+function normalizeExpectedText(value) {
+    if (value === undefined) {
+        return [];
     }
-    const stoppedEarly = compiled && items.length < compiled.steps.length;
-    const failedFast = stoppedEarly && items.at(-1)?.success === false;
-    if (stoppedEarly && !failedFast)
-        failedChecks.push("QA execution could not be verified (incomplete batch results)");
-    const uniqueFailures = [...new Set(failedChecks)];
-    const uniqueWarnings = [...new Set(warnings)];
-    const notRunChecks = compiled && failedFast ? describeNotRunQaChecks(compiled, items.length) : [];
-    return {
-        failedChecks: uniqueFailures,
-        notRunChecks,
-        passed: uniqueFailures.length === 0,
-        summary: uniqueFailures.length === 0
-            ? uniqueWarnings.length === 0 ? "QA preset passed." : `QA preset passed with warnings: ${uniqueWarnings.join("; ")}.`
-            : `QA preset failed: ${uniqueFailures.join("; ")}.`,
-        warnings: uniqueWarnings,
-    };
+    return typeof value === "string" ? [value] : value;
 }
-export function compileAgentBrowserQaPreset(input) {
+function validateQa(input) {
     if (!isRecord(input)) {
         return { error: "qa must be an object." };
     }
-    const attached = input.attached === true;
-    if (input.attached !== undefined && typeof input.attached !== "boolean") {
-        return { error: "qa.attached must be a boolean when provided." };
-    }
-    const url = input.url;
-    if (attached && url !== undefined) {
-        return { error: "qa.url must be omitted when qa.attached is true." };
+    const identityError = validateQaIdentity(input);
+    if (identityError !== undefined) {
+        return { error: identityError };
     }
-    if (!attached && (typeof url !== "string" || url.trim().length === 0)) {
-        return { error: "qa.url must be a non-empty string." };
+    const expectedText = normalizeExpectedText(input.expectedText);
+    if (!isStringArray(expectedText) || expectedText.some((text) => text.trim().length === 0)) {
+        return {
+            error: "qa.expectedText must be a non-empty string or array of non-empty strings when provided.",
+        };
     }
-    const normalizedUrl = typeof url === "string" ? url.trim() : undefined;
-    const expectedText = input.expectedText === undefined
-        ? []
-        : typeof input.expectedText === "string"
-            ? [input.expectedText]
-            : Array.isArray(input.expectedText)
-                ? input.expectedText
-                : undefined;
-    if (!expectedText || expectedText.some((text) => typeof text !== "string" || text.trim().length === 0)) {
-        return { error: "qa.expectedText must be a non-empty string or array of non-empty strings when provided." };
+    const optionsError = validateQaOptions(input);
+    if (optionsError !== undefined) {
+        return { error: optionsError };
     }
-    const expectedSelector = input.expectedSelector;
-    if (expectedSelector !== undefined && (typeof expectedSelector !== "string" || expectedSelector.trim().length === 0)) {
-        return { error: "qa.expectedSelector must be a non-empty string when provided." };
-    }
-    const screenshotPath = input.screenshotPath;
-    if (screenshotPath !== undefined && (typeof screenshotPath !== "string" || screenshotPath.trim().length === 0)) {
-        return { error: "qa.screenshotPath must be a non-empty string when provided." };
-    }
-    for (const field of ["checkConsole", "checkErrors", "checkNetwork"]) {
-        if (input[field] !== undefined && typeof input[field] !== "boolean") {
-            return { error: `qa.${field} must be a boolean when provided.` };
-        }
-    }
-    const rawLoadState = input.loadState;
-    if (rawLoadState !== undefined && (typeof rawLoadState !== "string" || !AGENT_BROWSER_QA_LOAD_STATES.includes(rawLoadState))) {
+    const loadState = AGENT_BROWSER_QA_LOAD_STATES.find((value) => value === input.loadState);
+    if (input.loadState !== undefined && loadState === undefined) {
         return { error: `qa.loadState must be one of: ${AGENT_BROWSER_QA_LOAD_STATES.join(", ")}.` };
     }
-    const checkConsole = typeof input.checkConsole === "boolean" ? input.checkConsole : !attached;
-    const checkErrors = typeof input.checkErrors === "boolean" ? input.checkErrors : !attached;
-    const checkNetwork = typeof input.checkNetwork === "boolean" ? input.checkNetwork : !attached;
-    const loadState = rawLoadState ?? "domcontentloaded";
-    const diagnosticsResetAtStart = !attached;
+    return { checks: qaChecks(input, expectedText, loadState ?? "domcontentloaded") };
+}
+function qaChecks(input, expectedText, loadState) {
+    const attached = input.attached === true;
+    return {
+        attached,
+        checkConsole: typeof input.checkConsole === "boolean" ? input.checkConsole : !attached,
+        checkErrors: typeof input.checkErrors === "boolean" ? input.checkErrors : !attached,
+        checkNetwork: typeof input.checkNetwork === "boolean" ? input.checkNetwork : !attached,
+        diagnosticsResetAtStart: !attached,
+        expectedSelector: typeof input.expectedSelector === "string" ? input.expectedSelector : undefined,
+        expectedText,
+        loadState,
+        screenshotPath: typeof input.screenshotPath === "string" ? input.screenshotPath : undefined,
+        url: typeof input.url === "string" ? input.url.trim() : undefined,
+    };
+}
+function diagnosticResetSteps(checks) {
     const steps = [];
-    if (diagnosticsResetAtStart && checkNetwork)
+    if (!checks.diagnosticsResetAtStart) {
+        return steps;
+    }
+    if (checks.checkNetwork) {
         steps.push({ action: "wait", args: ["network", "requests", "--clear"] });
-    if (diagnosticsResetAtStart && checkConsole)
+    }
+    if (checks.checkConsole) {
         steps.push({ action: "wait", args: ["console", "--clear"] });
-    if (diagnosticsResetAtStart && checkErrors) {
+    }
+    if (checks.checkErrors) {
         steps.push({ action: "wait", args: ["errors", "--clear"] });
         steps.push({ action: "wait", args: ["errors"], generatedFrom: "qa.errorBaselineAfterClear" });
     }
-    if (!attached && normalizedUrl)
-        steps.push({ action: "open", args: ["open", normalizedUrl] });
-    steps.push({ action: "wait", args: ["wait", "--load", loadState] });
-    if (checkConsole || checkErrors)
+    return steps;
+}
+function readinessSteps(checks) {
+    const steps = [];
+    if (!checks.attached && checks.url !== undefined && checks.url.length > 0) {
+        steps.push({ action: "open", args: ["open", checks.url] });
+    }
+    steps.push({ action: "wait", args: ["wait", "--load", checks.loadState] });
+    if (checks.checkConsole || checks.checkErrors) {
         steps.push({ action: "wait", args: ["wait", "150"], generatedFrom: "qa.diagnosticSettle" });
-    for (const text of expectedText) {
-        steps.push({ action: "assertText", args: ["wait", "--fn", buildQaVisibleTextPredicate(text), "--timeout", String(QA_VISIBLE_TEXT_TIMEOUT_MS)] });
     }
-    if (typeof expectedSelector === "string") {
-        steps.push({ action: "wait", args: ["wait", expectedSelector] });
+    for (const text of checks.expectedText) {
+        steps.push({
+            action: "assertText",
+            args: [
+                "wait",
+                "--fn",
+                buildQaVisibleTextPredicate(text),
+                "--timeout",
+                String(QA_VISIBLE_TEXT_TIMEOUT_MS),
+            ],
+        });
+    }
+    if (checks.expectedSelector !== undefined) {
+        steps.push({ action: "wait", args: ["wait", checks.expectedSelector] });
     }
-    if (checkNetwork)
+    return steps;
+}
+function diagnosticReadSteps(checks) {
+    const steps = [];
+    if (checks.checkNetwork) {
         steps.push({ action: "wait", args: ["network", "requests"] });
-    if (checkConsole)
+    }
+    if (checks.checkConsole) {
         steps.push({ action: "wait", args: ["console"] });
-    if (checkErrors)
+    }
+    if (checks.checkErrors) {
         steps.push({ action: "wait", args: ["errors"] });
-    if (typeof screenshotPath === "string")
-        steps.push({ action: "screenshot", args: ["screenshot", screenshotPath] });
+    }
+    if (checks.screenshotPath !== undefined) {
+        steps.push({ action: "screenshot", args: ["screenshot", checks.screenshotPath] });
+    }
+    return steps;
+}
+export function compileAgentBrowserQaPreset(input) {
+    const validation = validateQa(input);
+    if (validation.error !== undefined) {
+        return { error: validation.error };
+    }
+    const checks = validation.checks;
+    const steps = [
+        ...diagnosticResetSteps(checks),
+        ...readinessSteps(checks),
+        ...diagnosticReadSteps(checks),
+    ];
     return {
         compiled: {
             args: ["batch", "--bail"],
-            checks: { attached, checkConsole, checkErrors, checkNetwork, diagnosticsResetAtStart, expectedSelector, expectedText, loadState, screenshotPath, url: normalizedUrl },
+            checks,
             failFast: true,
             stdin: JSON.stringify(steps.map((step) => step.args)),
             steps,

package/dist/extensions/agent-browser/lib/input-modes/lookup-network-evidence.js

@@ -0,0 +1,116 @@
+import { isRecord } from "../parsing.js";
+import { getLookupResultPayload, sourceCandidatesFromValue } from "./lookup-source-evidence.js";
+import { getBatchResultItems } from "./shared.js";
+function networkRequestMatchesQuery(url, queryText) {
+    return (queryText === undefined ||
+        url === undefined ||
+        url.includes(queryText) ||
+        queryText.includes(url));
+}
+function isFailedNetworkRecord(request) {
+    const status = typeof request.status === "number" ? request.status : undefined;
+    const error = typeof request.error === "string" ? request.error : undefined;
+    return request.failed === true || error !== undefined || (status !== undefined && status >= 400);
+}
+function requestId(request) {
+    if (typeof request.id === "string") {
+        return request.id;
+    }
+    return typeof request.requestId === "string" ? request.requestId : undefined;
+}
+function failedRequestValues(payload) {
+    if (isRecord(payload) && Array.isArray(payload.requests)) {
+        return payload.requests;
+    }
+    if (Array.isArray(payload)) {
+        return payload;
+    }
+    return isRecord(payload) ? [payload] : [];
+}
+export function getFailedNetworkRequests(data, queryText) {
+    const failed = [];
+    for (const item of getBatchResultItems(data)) {
+        for (const request of failedRequestValues(getLookupResultPayload(item))) {
+            if (!isRecord(request)) {
+                continue;
+            }
+            const url = typeof request.url === "string" ? request.url : undefined;
+            if (!networkRequestMatchesQuery(url, queryText) || !isFailedNetworkRecord(request)) {
+                continue;
+            }
+            failed.push({
+                error: typeof request.error === "string" ? request.error : undefined,
+                method: typeof request.method === "string" ? request.method : undefined,
+                requestId: requestId(request),
+                status: typeof request.status === "number" ? request.status : undefined,
+                url,
+            });
+        }
+    }
+    const seenRequestIds = new Set();
+    return failed.filter(({ requestId: id }) => {
+        if (id === undefined) {
+            return true;
+        }
+        if (seenRequestIds.has(id)) {
+            return false;
+        }
+        seenRequestIds.add(id);
+        return true;
+    });
+}
+export function distinctNetworkCandidates(candidates) {
+    const keys = new Set();
+    return candidates.filter((candidate) => {
+        const key = [
+            candidate.source,
+            candidate.file ?? "",
+            candidate.line ?? "",
+            candidate.requestUrl ?? "",
+        ].join(":");
+        if (keys.has(key)) {
+            return false;
+        }
+        keys.add(key);
+        return true;
+    });
+}
+function initiatorCandidates(request) {
+    const requestUrl = typeof request.url === "string" ? request.url : undefined;
+    return [request.initiator, request.stack, request.source, request.trace].flatMap((field) => sourceCandidatesFromValue(field, {
+        source: "dom-attribute",
+        evidence: ["failed network request included source-like initiator metadata"],
+    }).map((candidate) => ({
+        confidence: "medium",
+        evidence: candidate.evidence,
+        file: candidate.file,
+        line: candidate.line,
+        requestUrl,
+        source: "initiator",
+    })));
+}
+function correlatesWithFailure(value, failedIds, failedUrls) {
+    const id = requestId(value);
+    const url = typeof value.url === "string" ? value.url : undefined;
+    return (id !== undefined && failedIds.has(id)) || (url !== undefined && failedUrls.has(url));
+}
+export function observeInitiatorCandidates(data, failedRequests, queryText) {
+    const failedIds = new Set(failedRequests.map((request) => request.requestId).filter((value) => value !== undefined));
+    const failedUrls = new Set(failedRequests.map((request) => request.url).filter((value) => value !== undefined));
+    const candidates = [];
+    for (const item of getBatchResultItems(data)) {
+        const payload = getLookupResultPayload(item);
+        const values = isRecord(payload) && Array.isArray(payload.requests) ? payload.requests : [payload];
+        for (const value of values) {
+            if (!isRecord(value)) {
+                continue;
+            }
+            const url = typeof value.url === "string" ? value.url : undefined;
+            if (networkRequestMatchesQuery(url, queryText) &&
+                (correlatesWithFailure(value, failedIds, failedUrls) || isFailedNetworkRecord(value))) {
+                candidates.push(...initiatorCandidates(value));
+            }
+        }
+    }
+    return distinctNetworkCandidates(candidates);
+}