@forkpoint/agent-lighthouse-core 4.0.0 → 4.1.0

package/dist/index.d.mts

@@ -385,6 +385,14 @@ interface ScanConditions {
         gatedCount: number;
         reasons: Record<string, number>;
     };
+    /** The wall-clock budget the scan ran under, and whether it ran out. */
+    budget?: {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        /** Audits reported `na` because the budget ran out before they started. */
+        skippedCount: number;
+    };
 }
 interface ReadinessVitals {
     commerce: number;
@@ -675,9 +683,10 @@ interface AuditTrace {
      * `ran` — the audit executed and returned.
      * `skipped` — no scanned page matched its `applicablePageTypes`.
      * `gated` — the scan never obtained evidence the audit needs.
+     * `budget` — the scan's wall-clock budget ran out before it started.
      * `error` — it threw, or its result was rejected by the schema.
      */
-    outcome: "ran" | "skipped" | "gated" | "error";
+    outcome: "ran" | "skipped" | "gated" | "budget" | "error";
     status: CheckStatus;
     score: number;
     weight: number;
@@ -755,12 +764,23 @@ declare function planAudits(ctx: CheckContext, config: ScanConfig, options?: Pla
     runnable: RunnableAudit[];
     skipped: CheckResult[];
 };
+/** A budget as a sentence names it: whole seconds, or milliseconds under one. */
+declare function formatBudget(ms: number): string;
+/** What an aborted budget signal says, for the stub that names it. */
+declare function budgetReason(signal: AbortSignal): string;
 /**
  * Execute all audits registered in the config against the scan context.
  * Returns check results grouped into categories with weighted scores.
  * Pass a precomputed `plan` (from {@link planAudits}) to avoid recomputing it.
+ *
+ * `budget` is the scan's wall-clock budget. Once it is aborted, no further
+ * audit is constructed, and none that was still running is believed: both
+ * report `na` tagged {@link TAG_SKIPPED_SCAN_BUDGET}. The running one is
+ * withheld because a request the budget refused answers with an error, and
+ * an audit reads that error as a broken link or a missing artifact. That
+ * would be a claim about the clock, not about the site.
  */
-declare function runAudits(ctx: CheckContext, config: ScanConfig, onEvent?: (event: AuditProgressEvent) => void, plan?: AuditPlan, onTrace?: AuditTraceHandler): Promise<AuditRunResult>;
+declare function runAudits(ctx: CheckContext, config: ScanConfig, onEvent?: (event: AuditProgressEvent) => void, plan?: AuditPlan, onTrace?: AuditTraceHandler, budget?: AbortSignal): Promise<AuditRunResult>;
 
 type PhaseId = "fetch-root" | "fetch-pages" | "analyze" | "audits" | "report";
 type ScanEvent = {
@@ -845,7 +865,20 @@ interface ScanOptions {
     pages?: PageOverride[] | null;
     /** Explicitly declared page type for the target URL. */
     pageType?: PageType;
+    /**
+     * The caller's cancellation. Aborting it makes `runScan` throw; the scan
+     * budget below never does.
+     */
     signal?: AbortSignal;
+    /**
+     * Wall-clock budget for the whole scan, in milliseconds. Defaults to
+     * {@link SCAN_TIMEOUT_MS}. When it runs out the scan finishes with what it
+     * has: requests in flight abort, no further request is sent, and every
+     * audit not yet started, or still running when it went, reports `na`
+     * tagged `skipped:scan-budget`. `conditions.budget` on the report records
+     * it. `0` disables the budget.
+     */
+    timeoutMs?: number;
     /**
      * Restrict the scan to these category ids. Unknown ids simply match nothing —
      * validate them at the entry point so the operator hears about a typo.
@@ -1287,7 +1320,14 @@ declare const DEFAULT_ORIGIN_CACHE_TTL_MS: number;
  */
 declare const DEFAULT_ORIGIN_CACHE_MAX_ENTRIES = 256;
 declare const REQUEST_TIMEOUT_MS = 10000;
-declare const SCAN_TIMEOUT_MS = 60000;
+/**
+ * Wall-clock budget for one scan. When it runs out, requests in flight are
+ * aborted, no further request is sent, and every audit not yet started is
+ * reported `na` tagged `skipped:scan-budget`. 180 s clears the 95th
+ * percentile of the curated corpus (109 s on 2026-09-02) with margin; the
+ * scans it cuts ran 5 to 17 minutes.
+ */
+declare const SCAN_TIMEOUT_MS = 180000;
 declare const MAX_RESPONSE_BODY_BYTES: number;
 /** @deprecated Unused internally; retained for published API stability. Scheduled for removal in v4. */
 declare const MAX_CONCURRENT_REQUESTS = 10;
@@ -1296,6 +1336,8 @@ declare const TAG_SKIPPED_PAGE_TYPE = "skipped:page-type";
 declare const TAG_SCAN_ERROR = "scan-error";
 /** An audit the scan could not feed: it needs evidence this scan never got. */
 declare const TAG_SKIPPED_NO_EVIDENCE = "skipped:no-evidence";
+/** An audit the scan never started: its wall-clock budget ran out first. */
+declare const TAG_SKIPPED_SCAN_BUDGET = "skipped:scan-budget";
 /** Display names for the 8 v2 categories. */
 declare const CATEGORY_NAMES: Record<string, string>;
 declare const READINESS_WEIGHTS: {
@@ -1335,6 +1377,12 @@ declare function calculateCategoryScore(checks: CheckResult[]): number;
  */
 declare function buildCategoryResult(id: string, checks: CheckResult[], mass?: number): CategoryResult;
 declare function calculateOverallScore(categories: CategoryResult[]): number;
+/**
+ * How much of the registry's evidence mass the checks carrying `tag` hold.
+ * The gate and the scan budget both stub audits as `na` under their own
+ * tag, and each is judged against {@link GATED_MASS_UNSCORED_THRESHOLD}.
+ */
+declare function skippedMassShare(checks: CheckResult[], tag: string): number;
 
 /**
  * Read product fields straight from the scanned product page(s)' structured
@@ -1716,6 +1764,22 @@ declare const ScanConditionsSchema: z.ZodObject<{
         informativeCount: number;
         gatedCount: number;
     }>;
+    budget: z.ZodOptional<z.ZodObject<{
+        limitMs: z.ZodNumber;
+        elapsedMs: z.ZodNumber;
+        exhausted: z.ZodBoolean;
+        skippedCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    }, {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     origin: {
@@ -1741,6 +1805,12 @@ declare const ScanConditionsSchema: z.ZodObject<{
         informativeCount: number;
         gatedCount: number;
     };
+    budget?: {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    } | undefined;
 }, {
     url: string;
     origin: {
@@ -1766,6 +1836,12 @@ declare const ScanConditionsSchema: z.ZodObject<{
         informativeCount: number;
         gatedCount: number;
     };
+    budget?: {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    } | undefined;
 }>;
 
 declare function normalizeUrl(input: string): string;
@@ -1801,6 +1877,8 @@ interface AgentLighthouseConfig {
     outputDir?: string;
     /** Maximum number of pages to discover & scan */
     maxPages?: number;
+    /** Scan budget in seconds; 0 disables it. The flag `--timeout` overrides it. */
+    timeout?: number;
 }
 /** Helper function for type-safe configuration files */
 declare function defineConfig(config: AgentLighthouseConfig): AgentLighthouseConfig;
@@ -1831,4 +1909,4 @@ type AcpLinkType = (typeof ACP_LINK_TYPES)[number];
  */
 declare function resolvePolicyLinks(ctx: CheckContext): Map<AcpLinkType, string>;
 
-export { ACP_LINK_TYPES, AI_CRAWLER_UAS, AUDIT_ID_PATTERN, type AcpLinkType, type AgentLighthouseConfig, Audit, type AuditGuidance, AuditGuidanceSchema, type AuditMeta, AuditMetaSchema, type AuditPlan, type AuditProgressEvent, type AuditRegistration, type AuditResult, AuditResultSchema, type AuditRunResult, type AuditTier, AuditTierSchema, type AuditTrace, type AuditTraceHandler, BASELINE_UA, type BlockClass, CATEGORY_IDS, CATEGORY_MASS, CATEGORY_NAMES, type CategoryConfig, type CategoryResult, type CheckContext, type CheckFn, type CheckPriority, CheckPrioritySchema, type CheckRecommendation, type CheckResult, CheckResultSchema, type CheckStatus, CheckStatusSchema, type CssRule, DEFAULT_ORIGIN_CACHE_MAX_ENTRIES, DEFAULT_ORIGIN_CACHE_TTL_MS, DEFAULT_SCAN_LIMIT, type DeprecationNotice, DeprecationNoticeSchema, type EvidenceGrade, EvidenceGradeSchema, type EvidenceKey, EvidenceKeySchema, type ExpectedKind, type FetchClass, type FetchOptions, type FetchResult, type FetcherOptions, type FieldStatus, type FixEffort, FixEffortSchema, MAX_CONCURRENT_REQUESTS, MAX_PAGES_PER_SCAN, MAX_RESPONSE_BODY_BYTES, ORIGIN_EVIDENCE_VERSION, OriginCache, type OriginCacheOptions, type OriginEvidence, PAGE_TYPE_LABELS, PHASE_WEIGHTS, PRESETS, type PageContext, type PageCss, type PageJudgement, type PageOverride, type PageType, PageTypeSchema, type PhaseId, type PresetName, type PresetOptions, type ProductFieldVerification, ProgressTracker, READINESS_WEIGHTS, REQUEST_TIMEOUT_MS, type ReadinessVitals, type RobotsFile, type RobotsGroup, type RobotsRule, SCANNER_USER_AGENT, SCAN_TIMEOUT_MS, SCORE_TIER_LABELS, type ScanConditions, ScanConditionsSchema, type ScanConfig, type ScanEvent, type ScanEvidence, type ScanOptions, type ScanReport, type ScanValidity, type ScoreDisplayMode, ScoreDisplayModeSchema, type ScoreTier, type SitemapEntry, type SitemapTree, TAG_SCAN_ERROR, TAG_SKIPPED_NO_EVIDENCE, TAG_SKIPPED_PAGE_TYPE, type UaProbe, type WafProtection, allEvidenceMet, allJsonLdNodes, boundedDispatcher, buildCategoryResult, buildScanEvidence, calculateCategoryScore, calculateOverallScore, classifyFetch, classifyResponse, collectPageCss, collectSitemapEntries, computeOriginCacheKey, createFetcher, defaultConfig, defaultOriginCache, defineConfig, detectPageType, detectWafProtection, evidenceUrl, extractDomain, extractForms, extractHeadLinks, extractHeadings, extractImages, extractInternalLinks, extractJsonLd, extractMarkdownLinks, extractMetaTags, extractNavLinks, extractProductFieldVerification, extractScripts, extractStylesheetUrls, filterConfig, flattenJsonLd, formatTrace, getMainContentText, getPreset, getRenderedText, getScoreTier, getTierColor, getTierLabel, getWordCount, groupsForBot, hasNamedGroup, isBlanketBlocked, isInformative, isPathAllowed, isPrivateIp, isRealFile, isSafeUrl, isW3CDateTime, joinUrl, judgePages, loadConfigFile, logger, matchesUserAgent, normalizeNewlines, normalizeUrl, outcomeOf, pagesOfType, parseCssRules, parseHtml, parseRobots, parseRobotsFile, planAudits, probeUaParity, resolvePolicyLinks, runAudits, runScan, sampleEntries, shouldBypassOriginCache, stripBom, topLevelJsonLd, traceFromCheck, weightForGrade };
+export { ACP_LINK_TYPES, AI_CRAWLER_UAS, AUDIT_ID_PATTERN, type AcpLinkType, type AgentLighthouseConfig, Audit, type AuditGuidance, AuditGuidanceSchema, type AuditMeta, AuditMetaSchema, type AuditPlan, type AuditProgressEvent, type AuditRegistration, type AuditResult, AuditResultSchema, type AuditRunResult, type AuditTier, AuditTierSchema, type AuditTrace, type AuditTraceHandler, BASELINE_UA, type BlockClass, CATEGORY_IDS, CATEGORY_MASS, CATEGORY_NAMES, type CategoryConfig, type CategoryResult, type CheckContext, type CheckFn, type CheckPriority, CheckPrioritySchema, type CheckRecommendation, type CheckResult, CheckResultSchema, type CheckStatus, CheckStatusSchema, type CssRule, DEFAULT_ORIGIN_CACHE_MAX_ENTRIES, DEFAULT_ORIGIN_CACHE_TTL_MS, DEFAULT_SCAN_LIMIT, type DeprecationNotice, DeprecationNoticeSchema, type EvidenceGrade, EvidenceGradeSchema, type EvidenceKey, EvidenceKeySchema, type ExpectedKind, type FetchClass, type FetchOptions, type FetchResult, type FetcherOptions, type FieldStatus, type FixEffort, FixEffortSchema, MAX_CONCURRENT_REQUESTS, MAX_PAGES_PER_SCAN, MAX_RESPONSE_BODY_BYTES, ORIGIN_EVIDENCE_VERSION, OriginCache, type OriginCacheOptions, type OriginEvidence, PAGE_TYPE_LABELS, PHASE_WEIGHTS, PRESETS, type PageContext, type PageCss, type PageJudgement, type PageOverride, type PageType, PageTypeSchema, type PhaseId, type PresetName, type PresetOptions, type ProductFieldVerification, ProgressTracker, READINESS_WEIGHTS, REQUEST_TIMEOUT_MS, type ReadinessVitals, type RobotsFile, type RobotsGroup, type RobotsRule, SCANNER_USER_AGENT, SCAN_TIMEOUT_MS, SCORE_TIER_LABELS, type ScanConditions, ScanConditionsSchema, type ScanConfig, type ScanEvent, type ScanEvidence, type ScanOptions, type ScanReport, type ScanValidity, type ScoreDisplayMode, ScoreDisplayModeSchema, type ScoreTier, type SitemapEntry, type SitemapTree, TAG_SCAN_ERROR, TAG_SKIPPED_NO_EVIDENCE, TAG_SKIPPED_PAGE_TYPE, TAG_SKIPPED_SCAN_BUDGET, type UaProbe, type WafProtection, allEvidenceMet, allJsonLdNodes, boundedDispatcher, budgetReason, buildCategoryResult, buildScanEvidence, calculateCategoryScore, calculateOverallScore, classifyFetch, classifyResponse, collectPageCss, collectSitemapEntries, computeOriginCacheKey, createFetcher, defaultConfig, defaultOriginCache, defineConfig, detectPageType, detectWafProtection, evidenceUrl, extractDomain, extractForms, extractHeadLinks, extractHeadings, extractImages, extractInternalLinks, extractJsonLd, extractMarkdownLinks, extractMetaTags, extractNavLinks, extractProductFieldVerification, extractScripts, extractStylesheetUrls, filterConfig, flattenJsonLd, formatBudget, formatTrace, getMainContentText, getPreset, getRenderedText, getScoreTier, getTierColor, getTierLabel, getWordCount, groupsForBot, hasNamedGroup, isBlanketBlocked, isInformative, isPathAllowed, isPrivateIp, isRealFile, isSafeUrl, isW3CDateTime, joinUrl, judgePages, loadConfigFile, logger, matchesUserAgent, normalizeNewlines, normalizeUrl, outcomeOf, pagesOfType, parseCssRules, parseHtml, parseRobots, parseRobotsFile, planAudits, probeUaParity, resolvePolicyLinks, runAudits, runScan, sampleEntries, shouldBypassOriginCache, skippedMassShare, stripBom, topLevelJsonLd, traceFromCheck, weightForGrade };

package/dist/index.d.ts

@@ -385,6 +385,14 @@ interface ScanConditions {
         gatedCount: number;
         reasons: Record<string, number>;
     };
+    /** The wall-clock budget the scan ran under, and whether it ran out. */
+    budget?: {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        /** Audits reported `na` because the budget ran out before they started. */
+        skippedCount: number;
+    };
 }
 interface ReadinessVitals {
     commerce: number;
@@ -675,9 +683,10 @@ interface AuditTrace {
      * `ran` — the audit executed and returned.
      * `skipped` — no scanned page matched its `applicablePageTypes`.
      * `gated` — the scan never obtained evidence the audit needs.
+     * `budget` — the scan's wall-clock budget ran out before it started.
      * `error` — it threw, or its result was rejected by the schema.
      */
-    outcome: "ran" | "skipped" | "gated" | "error";
+    outcome: "ran" | "skipped" | "gated" | "budget" | "error";
     status: CheckStatus;
     score: number;
     weight: number;
@@ -755,12 +764,23 @@ declare function planAudits(ctx: CheckContext, config: ScanConfig, options?: Pla
     runnable: RunnableAudit[];
     skipped: CheckResult[];
 };
+/** A budget as a sentence names it: whole seconds, or milliseconds under one. */
+declare function formatBudget(ms: number): string;
+/** What an aborted budget signal says, for the stub that names it. */
+declare function budgetReason(signal: AbortSignal): string;
 /**
  * Execute all audits registered in the config against the scan context.
  * Returns check results grouped into categories with weighted scores.
  * Pass a precomputed `plan` (from {@link planAudits}) to avoid recomputing it.
+ *
+ * `budget` is the scan's wall-clock budget. Once it is aborted, no further
+ * audit is constructed, and none that was still running is believed: both
+ * report `na` tagged {@link TAG_SKIPPED_SCAN_BUDGET}. The running one is
+ * withheld because a request the budget refused answers with an error, and
+ * an audit reads that error as a broken link or a missing artifact. That
+ * would be a claim about the clock, not about the site.
  */
-declare function runAudits(ctx: CheckContext, config: ScanConfig, onEvent?: (event: AuditProgressEvent) => void, plan?: AuditPlan, onTrace?: AuditTraceHandler): Promise<AuditRunResult>;
+declare function runAudits(ctx: CheckContext, config: ScanConfig, onEvent?: (event: AuditProgressEvent) => void, plan?: AuditPlan, onTrace?: AuditTraceHandler, budget?: AbortSignal): Promise<AuditRunResult>;
 
 type PhaseId = "fetch-root" | "fetch-pages" | "analyze" | "audits" | "report";
 type ScanEvent = {
@@ -845,7 +865,20 @@ interface ScanOptions {
     pages?: PageOverride[] | null;
     /** Explicitly declared page type for the target URL. */
     pageType?: PageType;
+    /**
+     * The caller's cancellation. Aborting it makes `runScan` throw; the scan
+     * budget below never does.
+     */
     signal?: AbortSignal;
+    /**
+     * Wall-clock budget for the whole scan, in milliseconds. Defaults to
+     * {@link SCAN_TIMEOUT_MS}. When it runs out the scan finishes with what it
+     * has: requests in flight abort, no further request is sent, and every
+     * audit not yet started, or still running when it went, reports `na`
+     * tagged `skipped:scan-budget`. `conditions.budget` on the report records
+     * it. `0` disables the budget.
+     */
+    timeoutMs?: number;
     /**
      * Restrict the scan to these category ids. Unknown ids simply match nothing —
      * validate them at the entry point so the operator hears about a typo.
@@ -1287,7 +1320,14 @@ declare const DEFAULT_ORIGIN_CACHE_TTL_MS: number;
  */
 declare const DEFAULT_ORIGIN_CACHE_MAX_ENTRIES = 256;
 declare const REQUEST_TIMEOUT_MS = 10000;
-declare const SCAN_TIMEOUT_MS = 60000;
+/**
+ * Wall-clock budget for one scan. When it runs out, requests in flight are
+ * aborted, no further request is sent, and every audit not yet started is
+ * reported `na` tagged `skipped:scan-budget`. 180 s clears the 95th
+ * percentile of the curated corpus (109 s on 2026-09-02) with margin; the
+ * scans it cuts ran 5 to 17 minutes.
+ */
+declare const SCAN_TIMEOUT_MS = 180000;
 declare const MAX_RESPONSE_BODY_BYTES: number;
 /** @deprecated Unused internally; retained for published API stability. Scheduled for removal in v4. */
 declare const MAX_CONCURRENT_REQUESTS = 10;
@@ -1296,6 +1336,8 @@ declare const TAG_SKIPPED_PAGE_TYPE = "skipped:page-type";
 declare const TAG_SCAN_ERROR = "scan-error";
 /** An audit the scan could not feed: it needs evidence this scan never got. */
 declare const TAG_SKIPPED_NO_EVIDENCE = "skipped:no-evidence";
+/** An audit the scan never started: its wall-clock budget ran out first. */
+declare const TAG_SKIPPED_SCAN_BUDGET = "skipped:scan-budget";
 /** Display names for the 8 v2 categories. */
 declare const CATEGORY_NAMES: Record<string, string>;
 declare const READINESS_WEIGHTS: {
@@ -1335,6 +1377,12 @@ declare function calculateCategoryScore(checks: CheckResult[]): number;
  */
 declare function buildCategoryResult(id: string, checks: CheckResult[], mass?: number): CategoryResult;
 declare function calculateOverallScore(categories: CategoryResult[]): number;
+/**
+ * How much of the registry's evidence mass the checks carrying `tag` hold.
+ * The gate and the scan budget both stub audits as `na` under their own
+ * tag, and each is judged against {@link GATED_MASS_UNSCORED_THRESHOLD}.
+ */
+declare function skippedMassShare(checks: CheckResult[], tag: string): number;
 
 /**
  * Read product fields straight from the scanned product page(s)' structured
@@ -1716,6 +1764,22 @@ declare const ScanConditionsSchema: z.ZodObject<{
         informativeCount: number;
         gatedCount: number;
     }>;
+    budget: z.ZodOptional<z.ZodObject<{
+        limitMs: z.ZodNumber;
+        elapsedMs: z.ZodNumber;
+        exhausted: z.ZodBoolean;
+        skippedCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    }, {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     origin: {
@@ -1741,6 +1805,12 @@ declare const ScanConditionsSchema: z.ZodObject<{
         informativeCount: number;
         gatedCount: number;
     };
+    budget?: {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    } | undefined;
 }, {
     url: string;
     origin: {
@@ -1766,6 +1836,12 @@ declare const ScanConditionsSchema: z.ZodObject<{
         informativeCount: number;
         gatedCount: number;
     };
+    budget?: {
+        limitMs: number;
+        elapsedMs: number;
+        exhausted: boolean;
+        skippedCount: number;
+    } | undefined;
 }>;
 
 declare function normalizeUrl(input: string): string;
@@ -1801,6 +1877,8 @@ interface AgentLighthouseConfig {
     outputDir?: string;
     /** Maximum number of pages to discover & scan */
     maxPages?: number;
+    /** Scan budget in seconds; 0 disables it. The flag `--timeout` overrides it. */
+    timeout?: number;
 }
 /** Helper function for type-safe configuration files */
 declare function defineConfig(config: AgentLighthouseConfig): AgentLighthouseConfig;
@@ -1831,4 +1909,4 @@ type AcpLinkType = (typeof ACP_LINK_TYPES)[number];
  */
 declare function resolvePolicyLinks(ctx: CheckContext): Map<AcpLinkType, string>;
 
-export { ACP_LINK_TYPES, AI_CRAWLER_UAS, AUDIT_ID_PATTERN, type AcpLinkType, type AgentLighthouseConfig, Audit, type AuditGuidance, AuditGuidanceSchema, type AuditMeta, AuditMetaSchema, type AuditPlan, type AuditProgressEvent, type AuditRegistration, type AuditResult, AuditResultSchema, type AuditRunResult, type AuditTier, AuditTierSchema, type AuditTrace, type AuditTraceHandler, BASELINE_UA, type BlockClass, CATEGORY_IDS, CATEGORY_MASS, CATEGORY_NAMES, type CategoryConfig, type CategoryResult, type CheckContext, type CheckFn, type CheckPriority, CheckPrioritySchema, type CheckRecommendation, type CheckResult, CheckResultSchema, type CheckStatus, CheckStatusSchema, type CssRule, DEFAULT_ORIGIN_CACHE_MAX_ENTRIES, DEFAULT_ORIGIN_CACHE_TTL_MS, DEFAULT_SCAN_LIMIT, type DeprecationNotice, DeprecationNoticeSchema, type EvidenceGrade, EvidenceGradeSchema, type EvidenceKey, EvidenceKeySchema, type ExpectedKind, type FetchClass, type FetchOptions, type FetchResult, type FetcherOptions, type FieldStatus, type FixEffort, FixEffortSchema, MAX_CONCURRENT_REQUESTS, MAX_PAGES_PER_SCAN, MAX_RESPONSE_BODY_BYTES, ORIGIN_EVIDENCE_VERSION, OriginCache, type OriginCacheOptions, type OriginEvidence, PAGE_TYPE_LABELS, PHASE_WEIGHTS, PRESETS, type PageContext, type PageCss, type PageJudgement, type PageOverride, type PageType, PageTypeSchema, type PhaseId, type PresetName, type PresetOptions, type ProductFieldVerification, ProgressTracker, READINESS_WEIGHTS, REQUEST_TIMEOUT_MS, type ReadinessVitals, type RobotsFile, type RobotsGroup, type RobotsRule, SCANNER_USER_AGENT, SCAN_TIMEOUT_MS, SCORE_TIER_LABELS, type ScanConditions, ScanConditionsSchema, type ScanConfig, type ScanEvent, type ScanEvidence, type ScanOptions, type ScanReport, type ScanValidity, type ScoreDisplayMode, ScoreDisplayModeSchema, type ScoreTier, type SitemapEntry, type SitemapTree, TAG_SCAN_ERROR, TAG_SKIPPED_NO_EVIDENCE, TAG_SKIPPED_PAGE_TYPE, type UaProbe, type WafProtection, allEvidenceMet, allJsonLdNodes, boundedDispatcher, buildCategoryResult, buildScanEvidence, calculateCategoryScore, calculateOverallScore, classifyFetch, classifyResponse, collectPageCss, collectSitemapEntries, computeOriginCacheKey, createFetcher, defaultConfig, defaultOriginCache, defineConfig, detectPageType, detectWafProtection, evidenceUrl, extractDomain, extractForms, extractHeadLinks, extractHeadings, extractImages, extractInternalLinks, extractJsonLd, extractMarkdownLinks, extractMetaTags, extractNavLinks, extractProductFieldVerification, extractScripts, extractStylesheetUrls, filterConfig, flattenJsonLd, formatTrace, getMainContentText, getPreset, getRenderedText, getScoreTier, getTierColor, getTierLabel, getWordCount, groupsForBot, hasNamedGroup, isBlanketBlocked, isInformative, isPathAllowed, isPrivateIp, isRealFile, isSafeUrl, isW3CDateTime, joinUrl, judgePages, loadConfigFile, logger, matchesUserAgent, normalizeNewlines, normalizeUrl, outcomeOf, pagesOfType, parseCssRules, parseHtml, parseRobots, parseRobotsFile, planAudits, probeUaParity, resolvePolicyLinks, runAudits, runScan, sampleEntries, shouldBypassOriginCache, stripBom, topLevelJsonLd, traceFromCheck, weightForGrade };
+export { ACP_LINK_TYPES, AI_CRAWLER_UAS, AUDIT_ID_PATTERN, type AcpLinkType, type AgentLighthouseConfig, Audit, type AuditGuidance, AuditGuidanceSchema, type AuditMeta, AuditMetaSchema, type AuditPlan, type AuditProgressEvent, type AuditRegistration, type AuditResult, AuditResultSchema, type AuditRunResult, type AuditTier, AuditTierSchema, type AuditTrace, type AuditTraceHandler, BASELINE_UA, type BlockClass, CATEGORY_IDS, CATEGORY_MASS, CATEGORY_NAMES, type CategoryConfig, type CategoryResult, type CheckContext, type CheckFn, type CheckPriority, CheckPrioritySchema, type CheckRecommendation, type CheckResult, CheckResultSchema, type CheckStatus, CheckStatusSchema, type CssRule, DEFAULT_ORIGIN_CACHE_MAX_ENTRIES, DEFAULT_ORIGIN_CACHE_TTL_MS, DEFAULT_SCAN_LIMIT, type DeprecationNotice, DeprecationNoticeSchema, type EvidenceGrade, EvidenceGradeSchema, type EvidenceKey, EvidenceKeySchema, type ExpectedKind, type FetchClass, type FetchOptions, type FetchResult, type FetcherOptions, type FieldStatus, type FixEffort, FixEffortSchema, MAX_CONCURRENT_REQUESTS, MAX_PAGES_PER_SCAN, MAX_RESPONSE_BODY_BYTES, ORIGIN_EVIDENCE_VERSION, OriginCache, type OriginCacheOptions, type OriginEvidence, PAGE_TYPE_LABELS, PHASE_WEIGHTS, PRESETS, type PageContext, type PageCss, type PageJudgement, type PageOverride, type PageType, PageTypeSchema, type PhaseId, type PresetName, type PresetOptions, type ProductFieldVerification, ProgressTracker, READINESS_WEIGHTS, REQUEST_TIMEOUT_MS, type ReadinessVitals, type RobotsFile, type RobotsGroup, type RobotsRule, SCANNER_USER_AGENT, SCAN_TIMEOUT_MS, SCORE_TIER_LABELS, type ScanConditions, ScanConditionsSchema, type ScanConfig, type ScanEvent, type ScanEvidence, type ScanOptions, type ScanReport, type ScanValidity, type ScoreDisplayMode, ScoreDisplayModeSchema, type ScoreTier, type SitemapEntry, type SitemapTree, TAG_SCAN_ERROR, TAG_SKIPPED_NO_EVIDENCE, TAG_SKIPPED_PAGE_TYPE, TAG_SKIPPED_SCAN_BUDGET, type UaProbe, type WafProtection, allEvidenceMet, allJsonLdNodes, boundedDispatcher, budgetReason, buildCategoryResult, buildScanEvidence, calculateCategoryScore, calculateOverallScore, classifyFetch, classifyResponse, collectPageCss, collectSitemapEntries, computeOriginCacheKey, createFetcher, defaultConfig, defaultOriginCache, defineConfig, detectPageType, detectWafProtection, evidenceUrl, extractDomain, extractForms, extractHeadLinks, extractHeadings, extractImages, extractInternalLinks, extractJsonLd, extractMarkdownLinks, extractMetaTags, extractNavLinks, extractProductFieldVerification, extractScripts, extractStylesheetUrls, filterConfig, flattenJsonLd, formatBudget, formatTrace, getMainContentText, getPreset, getRenderedText, getScoreTier, getTierColor, getTierLabel, getWordCount, groupsForBot, hasNamedGroup, isBlanketBlocked, isInformative, isPathAllowed, isPrivateIp, isRealFile, isSafeUrl, isW3CDateTime, joinUrl, judgePages, loadConfigFile, logger, matchesUserAgent, normalizeNewlines, normalizeUrl, outcomeOf, pagesOfType, parseCssRules, parseHtml, parseRobots, parseRobotsFile, planAudits, probeUaParity, resolvePolicyLinks, runAudits, runScan, sampleEntries, shouldBypassOriginCache, skippedMassShare, stripBom, topLevelJsonLd, traceFromCheck, weightForGrade };