seo 0.2.14 → 0.2.16

package/dist/index.d.ts

@@ -244,6 +244,13 @@ declare const providerPreferenceSchema: z.ZodEnum<{
   cheap: "cheap";
   authoritative: "authoritative";
 }>;
+declare const providerSpendLimitOverridesSchema: z.ZodObject<{
+  dailyNoticeMicros: z.ZodOptional<z.ZodNumber>;
+  dailyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  monthlyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  maxRequestsPerReport: z.ZodOptional<z.ZodNumber>;
+  maxRowsPerReport: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
 declare const analyticsConnectionsSchema: z.ZodDefault<z.ZodObject<{
   google: z.ZodOptional<z.ZodObject<{
     propertyId: z.ZodString;
@@ -322,6 +329,29 @@ declare const configSchema: z.ZodObject<{
       cheap: "cheap";
       authoritative: "authoritative";
     }>>;
+    costLimits: z.ZodOptional<z.ZodObject<{
+      dataforseo: z.ZodOptional<z.ZodObject<{
+        dailyNoticeMicros: z.ZodOptional<z.ZodNumber>;
+        dailyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        monthlyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxRequestsPerReport: z.ZodOptional<z.ZodNumber>;
+        maxRowsPerReport: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>>;
+      semrush: z.ZodOptional<z.ZodObject<{
+        dailyNoticeMicros: z.ZodOptional<z.ZodNumber>;
+        dailyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        monthlyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxRequestsPerReport: z.ZodOptional<z.ZodNumber>;
+        maxRowsPerReport: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>>;
+      ahrefs: z.ZodOptional<z.ZodObject<{
+        dailyNoticeMicros: z.ZodOptional<z.ZodNumber>;
+        dailyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        monthlyHardLimitMicros: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        maxRequestsPerReport: z.ZodOptional<z.ZodNumber>;
+        maxRowsPerReport: z.ZodOptional<z.ZodNumber>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>>;
   }, z.core.$strip>>;
   security: z.ZodDefault<z.ZodObject<{
     useKeychain: z.ZodDefault<z.ZodBoolean>;
@@ -658,6 +688,7 @@ interface ExtractedPage {
 }
 //#endregion
 //#region packages/core/src/types/providers.d.ts
+/** @deprecated Use ProviderCostEvidence from providers/contracts. */
 interface CreditUsage {
   provider: string;
   units: number;
@@ -666,16 +697,19 @@ interface CreditUsage {
   calls: number;
   cacheHits?: number;
 }
+/** @deprecated Use ProviderEvidence from providers/contracts. */
 interface ProviderResult<T> {
   data: T;
   usage: CreditUsage;
   warnings?: string[];
   cached?: boolean;
 }
+/** @deprecated Use a capability-specific request type. */
 interface ProviderOpts {
   database?: string;
   refresh?: boolean;
 }
+/** @deprecated Use KeywordMetric from providers/contracts. */
 interface KeywordOverview {
   phrase: string;
   volume?: number;
@@ -685,6 +719,7 @@ interface KeywordOverview {
   intent?: string;
   results?: number;
 }
+/** @deprecated Use a capability-specific row type from providers/contracts. */
 interface KeywordRow {
   phrase: string;
   volume?: number;
@@ -695,6 +730,11 @@ interface KeywordRow {
   domain?: string;
   position?: number;
 }
+/**
+ * @deprecated Use the small capability interfaces from providers/contracts.
+ * This compatibility contract remains until the registered reports replace
+ * the provider-specific MCP passthrough.
+ */
 interface KeywordDataProvider {
   readonly name: string;
   readonly capabilities: {
@@ -725,9 +765,11 @@ interface KeywordDataProvider {
     resetAt?: string;
   }>;
 }
+/** @deprecated Use a capability-specific provider contract. */
 interface SerpProvider {
   readonly name: string;
 }
+/** @deprecated Use a capability-specific provider contract. */
 interface BacklinkProvider {
   readonly name: string;
 }
@@ -2239,7 +2281,7 @@ declare function analyzePageOpportunitiesFromRows(input: PageOpportunityAnalysis
 type PageOpportunityFocus = PageOpportunityType | 'no-data';
 //#endregion
 //#region packages/core/src/analyze/page-opportunities.d.ts
-type SearchAnalytics$10 = typeof querySearchAnalytics;
+type SearchAnalytics$11 = typeof querySearchAnalytics;
 type FetchPage$4 = typeof fetchPage;
 type ExtractPage$3 = typeof extractPage;
 type PageOpportunityInput = {
@@ -2311,7 +2353,7 @@ type PageOpportunityReport = {
   recommendations: string[];
 };
 type PageOpportunityDependencies = {
-  searchAnalytics: SearchAnalytics$10;
+  searchAnalytics: SearchAnalytics$11;
   fetch: FetchPage$4;
   extract: ExtractPage$3;
   now: () => Date;
@@ -4816,8 +4858,8 @@ declare const crawlPageSnapshotSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodNumber>;
     error: z.ZodOptional<z.ZodString>;
     state: z.ZodOptional<z.ZodEnum<{
-      unavailable: "unavailable";
       available: "available";
+      unavailable: "unavailable";
       "rate-limited": "rate-limited";
       "confirmed-broken": "confirmed-broken";
       transient: "transient";
@@ -5980,8 +6022,8 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       status: z.ZodOptional<z.ZodNumber>;
       error: z.ZodOptional<z.ZodString>;
       state: z.ZodOptional<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -6377,8 +6419,8 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deferredUrls: z.ZodNumber;
     limit: z.ZodNumber;
     outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-      unavailable: "unavailable";
       available: "available";
+      unavailable: "unavailable";
       "rate-limited": "rate-limited";
       "confirmed-broken": "confirmed-broken";
       transient: "transient";
@@ -7429,8 +7471,8 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       status: z.ZodOptional<z.ZodNumber>;
       error: z.ZodOptional<z.ZodString>;
       state: z.ZodOptional<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -7826,8 +7868,8 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deferredUrls: z.ZodNumber;
     limit: z.ZodNumber;
     outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-      unavailable: "unavailable";
       available: "available";
+      unavailable: "unavailable";
       "rate-limited": "rate-limited";
       "confirmed-broken": "confirmed-broken";
       transient: "transient";
@@ -8878,8 +8920,8 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       status: z.ZodOptional<z.ZodNumber>;
       error: z.ZodOptional<z.ZodString>;
       state: z.ZodOptional<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -9275,8 +9317,8 @@ declare const crawlReportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     deferredUrls: z.ZodNumber;
     limit: z.ZodNumber;
     outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-      unavailable: "unavailable";
       available: "available";
+      unavailable: "unavailable";
       "rate-limited": "rate-limited";
       "confirmed-broken": "confirmed-broken";
       transient: "transient";
@@ -10329,8 +10371,8 @@ declare const crawlerSchemas: {
         status: z.ZodOptional<z.ZodNumber>;
         error: z.ZodOptional<z.ZodString>;
         state: z.ZodOptional<z.ZodEnum<{
-          unavailable: "unavailable";
           available: "available";
+          unavailable: "unavailable";
           "rate-limited": "rate-limited";
           "confirmed-broken": "confirmed-broken";
           transient: "transient";
@@ -10726,8 +10768,8 @@ declare const crawlerSchemas: {
       deferredUrls: z.ZodNumber;
       limit: z.ZodNumber;
       outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -11778,8 +11820,8 @@ declare const crawlerSchemas: {
         status: z.ZodOptional<z.ZodNumber>;
         error: z.ZodOptional<z.ZodString>;
         state: z.ZodOptional<z.ZodEnum<{
-          unavailable: "unavailable";
           available: "available";
+          unavailable: "unavailable";
           "rate-limited": "rate-limited";
           "confirmed-broken": "confirmed-broken";
           transient: "transient";
@@ -12175,8 +12217,8 @@ declare const crawlerSchemas: {
       deferredUrls: z.ZodNumber;
       limit: z.ZodNumber;
       outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -13227,8 +13269,8 @@ declare const crawlerSchemas: {
         status: z.ZodOptional<z.ZodNumber>;
         error: z.ZodOptional<z.ZodString>;
         state: z.ZodOptional<z.ZodEnum<{
-          unavailable: "unavailable";
           available: "available";
+          unavailable: "unavailable";
           "rate-limited": "rate-limited";
           "confirmed-broken": "confirmed-broken";
           transient: "transient";
@@ -13624,8 +13666,8 @@ declare const crawlerSchemas: {
       deferredUrls: z.ZodNumber;
       limit: z.ZodNumber;
       outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -14810,8 +14852,8 @@ declare const crawlerSchemas: {
       status: z.ZodOptional<z.ZodNumber>;
       error: z.ZodOptional<z.ZodString>;
       state: z.ZodOptional<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -15594,8 +15636,8 @@ declare const crawlerJsonSchemas: {
         status: z.ZodOptional<z.ZodNumber>;
         error: z.ZodOptional<z.ZodString>;
         state: z.ZodOptional<z.ZodEnum<{
-          unavailable: "unavailable";
           available: "available";
+          unavailable: "unavailable";
           "rate-limited": "rate-limited";
           "confirmed-broken": "confirmed-broken";
           transient: "transient";
@@ -15991,8 +16033,8 @@ declare const crawlerJsonSchemas: {
       deferredUrls: z.ZodNumber;
       limit: z.ZodNumber;
       outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -17043,8 +17085,8 @@ declare const crawlerJsonSchemas: {
         status: z.ZodOptional<z.ZodNumber>;
         error: z.ZodOptional<z.ZodString>;
         state: z.ZodOptional<z.ZodEnum<{
-          unavailable: "unavailable";
           available: "available";
+          unavailable: "unavailable";
           "rate-limited": "rate-limited";
           "confirmed-broken": "confirmed-broken";
           transient: "transient";
@@ -17440,8 +17482,8 @@ declare const crawlerJsonSchemas: {
       deferredUrls: z.ZodNumber;
       limit: z.ZodNumber;
       outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -18492,8 +18534,8 @@ declare const crawlerJsonSchemas: {
         status: z.ZodOptional<z.ZodNumber>;
         error: z.ZodOptional<z.ZodString>;
         state: z.ZodOptional<z.ZodEnum<{
-          unavailable: "unavailable";
           available: "available";
+          unavailable: "unavailable";
           "rate-limited": "rate-limited";
           "confirmed-broken": "confirmed-broken";
           transient: "transient";
@@ -18889,8 +18931,8 @@ declare const crawlerJsonSchemas: {
       deferredUrls: z.ZodNumber;
       limit: z.ZodNumber;
       outcomes: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -20075,8 +20117,8 @@ declare const crawlerJsonSchemas: {
       status: z.ZodOptional<z.ZodNumber>;
       error: z.ZodOptional<z.ZodString>;
       state: z.ZodOptional<z.ZodEnum<{
-        unavailable: "unavailable";
         available: "available";
+        unavailable: "unavailable";
         "rate-limited": "rate-limited";
         "confirmed-broken": "confirmed-broken";
         transient: "transient";
@@ -20299,9 +20341,9 @@ declare function analyzeCtrUnderperformersFromRows(input: {
 };
 //#endregion
 //#region packages/core/src/analyze/ctr-underperformers.d.ts
-type SearchAnalytics$9 = typeof querySearchAnalytics;
+type SearchAnalytics$10 = typeof querySearchAnalytics;
 interface CtrUnderperformerDependencies {
-  searchAnalytics: SearchAnalytics$9;
+  searchAnalytics: SearchAnalytics$10;
   now: () => Date;
 }
 declare function ctrUnderperformersReport(input: {
@@ -20499,7 +20541,7 @@ declare function resolveSegmentRanges(input: {
 };
 //#endregion
 //#region packages/core/src/analyze/segment-impact.d.ts
-type SearchAnalytics$8 = typeof querySearchAnalytics;
+type SearchAnalytics$9 = typeof querySearchAnalytics;
 interface SegmentImpactInput {
   site: string;
   dimension?: SegmentDimension;
@@ -20513,7 +20555,7 @@ interface SegmentImpactInput {
   refresh?: boolean;
 }
 interface SegmentImpactDependencies {
-  searchAnalytics: SearchAnalytics$8;
+  searchAnalytics: SearchAnalytics$9;
   now: () => Date;
 }
 declare function compareSegmentRows(input: {
@@ -20708,7 +20750,7 @@ declare const CANNIBAL_MINIMUM_PAGE_SHARE = 0.1;
 declare const CANNIBAL_MAXIMUM_DOMINANT_SHARE = 0.8;
 //#endregion
 //#region packages/core/src/analyze/site-diagnostics/cannibal.d.ts
-type SearchAnalytics$7 = typeof querySearchAnalytics;
+type SearchAnalytics$8 = typeof querySearchAnalytics;
 interface CannibalReportInput {
   site: string;
   days?: number;
@@ -20721,7 +20763,7 @@ interface CannibalReportInput {
   refresh?: boolean;
 }
 interface CannibalDependencies {
-  searchAnalytics: SearchAnalytics$7;
+  searchAnalytics: SearchAnalytics$8;
   now: () => Date;
 }
 declare function cannibalReport(input: CannibalReportInput, dependencies?: CannibalDependencies): Promise<CannibalReport>;
@@ -20889,7 +20931,7 @@ declare function decayComparisonRange(current: {
 };
 //#endregion
 //#region packages/core/src/analyze/site-diagnostics/decaying.d.ts
-type SearchAnalytics$6 = typeof querySearchAnalytics;
+type SearchAnalytics$7 = typeof querySearchAnalytics;
 interface DecayingReportInput {
   site: string;
   days?: number;
@@ -20905,7 +20947,7 @@ interface DecayingReportInput {
   refresh?: boolean;
 }
 interface DecayingDependencies {
-  searchAnalytics: SearchAnalytics$6;
+  searchAnalytics: SearchAnalytics$7;
   now: () => Date;
 }
 declare function decayingReport(input: DecayingReportInput, dependencies?: DecayingDependencies): Promise<DecayReport>;
@@ -21051,7 +21093,7 @@ type AnalyzeQuickWinsInput = {
 declare function analyzeQuickWinsFromRows(input: AnalyzeQuickWinsInput): QuickWinAnalysis;
 //#endregion
 //#region packages/core/src/analyze/site-diagnostics/quick-wins.d.ts
-type SearchAnalytics$5 = typeof querySearchAnalytics;
+type SearchAnalytics$6 = typeof querySearchAnalytics;
 type FetchPage$3 = typeof fetchPage;
 type ExtractPage$2 = typeof extractPage;
 type QuickWinsInput = {
@@ -21070,7 +21112,7 @@ type QuickWinsInput = {
   refresh?: boolean;
 };
 type QuickWinsDependencies = {
-  searchAnalytics: SearchAnalytics$5;
+  searchAnalytics: SearchAnalytics$6;
   fetch: FetchPage$3;
   extract: ExtractPage$2;
   now: () => Date;
@@ -21312,7 +21354,7 @@ type AnalyzeStrikingDistanceInput = {
 declare function analyzeStrikingDistanceRows(input: AnalyzeStrikingDistanceInput): StrikingDistanceAnalysis;
 //#endregion
 //#region packages/core/src/analyze/striking-distance.d.ts
-type SearchAnalytics$4 = typeof querySearchAnalytics;
+type SearchAnalytics$5 = typeof querySearchAnalytics;
 type VerifyQueryContent = typeof verifyQueryContent;
 type StrikingDistanceInput = {
   site: string;
@@ -21377,7 +21419,7 @@ type StrikingDistanceReport = {
   recommendations: string[];
 };
 type StrikingDistanceDependencies = {
-  searchAnalytics: SearchAnalytics$4;
+  searchAnalytics: SearchAnalytics$5;
   verifyContent: VerifyQueryContent;
   now: () => Date;
 };
@@ -22056,7 +22098,7 @@ interface InternalLinksAnalysis {
 declare function analyzeInternalLinksFromRows(input: InternalLinksAnalysisInput): InternalLinksAnalysis;
 //#endregion
 //#region packages/core/src/analyze/internal-links.d.ts
-type SearchAnalytics$3 = typeof querySearchAnalytics;
+type SearchAnalytics$4 = typeof querySearchAnalytics;
 type FetchPage$2 = typeof fetchPage;
 type ExtractPage$1 = typeof extractPage;
 interface InternalLinksInput {
@@ -22073,13 +22115,566 @@ interface InternalLinksInput {
   refresh?: boolean;
 }
 interface InternalLinksDependencies {
-  searchAnalytics: SearchAnalytics$3;
+  searchAnalytics: SearchAnalytics$4;
   fetch: FetchPage$2;
   extract: ExtractPage$1;
   now: () => Date;
 }
 declare function internalLinksReport(input: InternalLinksInput, dependencies?: InternalLinksDependencies): Promise<InternalLinksReport>;
 //#endregion
+//#region packages/core/src/providers/contracts.d.ts
+declare const providerIdSchema: z.ZodEnum<{
+  dataforseo: "dataforseo";
+  semrush: "semrush";
+  ahrefs: "ahrefs";
+}>;
+type ProviderId = z.infer<typeof providerIdSchema>;
+declare const providerCapabilitySchema: z.ZodEnum<{
+  "keyword-metrics": "keyword-metrics";
+  "keyword-discovery": "keyword-discovery";
+  "serp-snapshot": "serp-snapshot";
+  "domain-overview": "domain-overview";
+  "ranked-keywords": "ranked-keywords";
+  "relevant-pages": "relevant-pages";
+  "serp-competitors": "serp-competitors";
+  "link-summary": "link-summary";
+  "referring-domains": "referring-domains";
+  backlinks: "backlinks";
+  "domain-rating": "domain-rating";
+  "local-search": "local-search";
+  "ai-mentions": "ai-mentions";
+  "ai-prompt-observation": "ai-prompt-observation";
+}>;
+type ProviderCapability = z.infer<typeof providerCapabilitySchema>;
+declare const searchMarketSchema: z.ZodObject<{
+  searchEngine: z.ZodDefault<z.ZodEnum<{
+    google: "google";
+    bing: "bing";
+  }>>;
+  countryCode: z.ZodString;
+  languageCode: z.ZodString;
+  location: z.ZodOptional<z.ZodObject<{
+    code: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  device: z.ZodOptional<z.ZodEnum<{
+    mobile: "mobile";
+    desktop: "desktop";
+  }>>;
+}, z.core.$strict>;
+type SearchMarket = z.infer<typeof searchMarketSchema>;
+type ProviderValue<T> = {
+  state: 'observed';
+  value: T;
+} | {
+  state: 'missing' | 'unavailable' | 'invalid';
+  value: null;
+  reason: string;
+};
+declare function observedValue<T>(value: T): ProviderValue<T>;
+declare function unavailableValue<T>(state: 'missing' | 'unavailable' | 'invalid', reason: string): ProviderValue<T>;
+type ProviderWarning = {
+  code: string;
+  message: string;
+  field?: string;
+  row?: number;
+};
+type ProviderCoverage = {
+  requestedRows: number | null;
+  returnedRows: number | null;
+  retainedRows: number | null;
+  invalidRows: number;
+  providerTotalRows: number | null;
+  completeness: 'complete' | 'partial' | 'capped' | 'filtered' | 'unavailable' | 'invalid' | 'unknown';
+  nextCursor: string | null;
+};
+type ProviderCacheEvidence = {
+  status: 'hit' | 'miss' | 'bypass';
+  storedAt: string | null;
+  expiresAt: string | null;
+};
+type ProviderCostEvidence = {
+  currency: 'USD';
+  estimatedMicros: number | null;
+  actualMicros: number | null;
+  taskIds: string[];
+};
+type ProviderRequestEvidence = {
+  operation: string;
+  endpoint: string;
+  limit: number | null;
+  filters: Record<string, string | number | boolean>;
+  sort: string[];
+};
+type ProviderEvidence<T> = {
+  schemaVersion: 1;
+  provider: ProviderId;
+  capability: ProviderCapability;
+  data: T;
+  observedAt: string;
+  market: SearchMarket;
+  coverage: ProviderCoverage;
+  cache: ProviderCacheEvidence;
+  cost: ProviderCostEvidence;
+  request: ProviderRequestEvidence;
+  warnings: ProviderWarning[];
+};
+type ProviderCapabilitySupport = {
+  capability: ProviderCapability;
+  status: 'available' | 'unavailable';
+  reason?: string;
+  markets: 'all' | readonly ProviderMarketSupport[];
+};
+type ProviderMarketSupport = {
+  searchEngines?: readonly SearchMarket['searchEngine'][];
+  countryCodes?: readonly string[];
+  languageCodes?: readonly string[];
+  devices?: readonly NonNullable<SearchMarket['device']>[];
+  location?: 'any' | 'country-only' | 'canonical';
+};
+interface ProviderAdapter {
+  readonly provider: ProviderId;
+  readonly capabilitySupport: readonly ProviderCapabilitySupport[];
+}
+type KeywordMetric = {
+  keyword: string;
+  monthlySearchVolume: ProviderValue<number>;
+  monthlySearches: ProviderValue<KeywordMonthlySearch[]>;
+  searchVolumeUpdatedAt: ProviderValue<string>;
+  cpcUsd: ProviderValue<number>;
+  paidCompetition: ProviderValue<number>;
+  keywordDifficulty: ProviderValue<number>;
+  intent: ProviderValue<string>;
+  resultCount: ProviderValue<number>;
+};
+type KeywordMonthlySearch = {
+  year: number;
+  month: number;
+  searchVolume: number;
+};
+type ProviderRequestContext = {
+  projectId?: string;
+  reportId: string;
+  reportRunId: string;
+};
+type KeywordMetricsRequest = {
+  keywords: string[];
+  market: SearchMarket;
+  refresh?: boolean;
+  context?: ProviderRequestContext;
+};
+interface KeywordMetricsProvider extends ProviderAdapter {
+  keywordMetrics(input: KeywordMetricsRequest): Promise<ProviderEvidence<KeywordMetric[]>>;
+}
+type KeywordMetricsCostEstimate = {
+  schemaVersion: 1;
+  provider: ProviderId;
+  capability: 'keyword-metrics';
+  currency: 'USD';
+  requestedRows: number;
+  requestCount: number;
+  estimatedMicros: number | null;
+  observedAt: string;
+  completeness: 'complete' | 'unavailable';
+  basis: string;
+};
+interface KeywordMetricsCostEstimator extends ProviderAdapter {
+  estimateKeywordMetricsCost(input: {
+    requestedRows: number;
+    market: SearchMarket;
+  }): Promise<KeywordMetricsCostEstimate>;
+}
+declare const keywordDiscoverySourceSchema: z.ZodEnum<{
+  ideas: "ideas";
+  related: "related";
+  suggestions: "suggestions";
+}>;
+type KeywordDiscoverySource = z.infer<typeof keywordDiscoverySourceSchema>;
+type KeywordIdeaSource = {
+  seed: string;
+  source: KeywordDiscoverySource;
+};
+type KeywordIdea = KeywordMetric & {
+  sources: KeywordIdeaSource[];
+};
+type KeywordDiscoveryRequest = {
+  seeds: string[];
+  sources: KeywordDiscoverySource[];
+  market: SearchMarket;
+  limit: number;
+  refresh?: boolean;
+  context?: ProviderRequestContext;
+};
+interface KeywordDiscoveryProvider extends ProviderAdapter {
+  discoverKeywords(input: KeywordDiscoveryRequest): Promise<ProviderEvidence<KeywordIdea[]>>;
+}
+type SerpOrganicResult = {
+  rankGroup: number;
+  rankAbsolute: number;
+  page: number;
+  domain: string;
+  url: string;
+  title: string | null;
+  description: string | null;
+  isFeaturedSnippet: boolean | null;
+};
+type SerpSnapshot = {
+  keyword: string;
+  effectiveKeyword: string;
+  searchEngineDomain: string | null;
+  checkedAt: string;
+  checkUrl: string | null;
+  resultCount: number | null;
+  pagesCount: number | null;
+  features: string[];
+  organicResults: SerpOrganicResult[];
+};
+type SerpSnapshotRequest = {
+  keyword: string;
+  market: SearchMarket;
+  depth: number;
+  refresh?: boolean;
+  context?: ProviderRequestContext;
+};
+interface SerpSnapshotProvider extends ProviderAdapter {
+  serpSnapshot(input: SerpSnapshotRequest): Promise<ProviderEvidence<SerpSnapshot>>;
+}
+//#endregion
+//#region packages/core/src/providers/resolver.d.ts
+type ProviderCandidate = {
+  adapter: ProviderAdapter;
+  connected: boolean;
+  priority: number;
+};
+type ProviderResolution = {
+  status: 'available';
+  provider: ProviderAdapter;
+  considered: ProviderId[];
+} | {
+  status: 'unavailable';
+  reason: 'provider-not-registered' | 'provider-not-connected' | 'capability-not-supported' | 'market-not-supported';
+  considered: ProviderId[];
+};
+declare function resolveProvider(input: {
+  capability: ProviderCapability;
+  market: SearchMarket;
+  candidates: readonly ProviderCandidate[];
+  provider?: ProviderId;
+}): ProviderResolution;
+//#endregion
+//#region packages/core/src/analyze/keyword-metrics.d.ts
+type KeywordTrend = {
+  state: 'observed';
+  direction: 'increasing' | 'decreasing' | 'stable' | 'increased-from-zero';
+  recentAverage: number;
+  previousAverage: number;
+  absoluteChange: number;
+  percentChange: ProviderValue<number>;
+  months: Array<{
+    year: number;
+    month: number;
+  }>;
+  methodology: string;
+} | {
+  state: 'unavailable';
+  reason: string;
+};
+type KeywordMetricAnalysis = {
+  keyword: string;
+  trend: KeywordTrend;
+};
+type KeywordMetricFinding = {
+  code: 'recent-demand-increase' | 'recent-demand-decrease';
+  keyword: string;
+  evidenceRef: string;
+  principle: string;
+  detail: string;
+};
+type KeywordMetricsReport = {
+  schemaVersion: 1;
+  generatedAt: string;
+  dataStatus: 'complete' | 'partial' | 'unavailable';
+  market: SearchMarket;
+  summary: {
+    requestedKeywords: number;
+    providerRows: number;
+    keywordsWithObservedVolume: number;
+    observedZeroVolume: number;
+    missingOrInvalidVolume: number;
+    increasingTrends: number;
+    decreasingTrends: number;
+    stableTrends: number;
+    unavailableTrends: number;
+    verdict: string;
+  };
+  evidence: ProviderEvidence<KeywordMetric[]>;
+  analysis: KeywordMetricAnalysis[];
+  findings: KeywordMetricFinding[];
+  caveats: string[];
+  nextSteps: string[];
+};
+type KeywordMetricsReportDependencies = {
+  candidates?: readonly ProviderCandidate[];
+  now?: () => Date;
+};
+declare function analyzeKeywordTrend(metric: KeywordMetric): KeywordTrend;
+declare function keywordMetricsReport(input: {
+  keywords: string[];
+  market: SearchMarket;
+  provider?: ProviderId;
+  projectId?: string;
+  context?: Partial<ProviderRequestContext>;
+  refresh?: boolean;
+}, dependencies?: KeywordMetricsReportDependencies): Promise<KeywordMetricsReport>;
+//#endregion
+//#region packages/core/src/analyze/pseo/query-insights.d.ts
+type PseoQueryPattern = {
+  label: string;
+  queryCount: number;
+  clicks: number;
+  impressions: number;
+  examples: string[];
+};
+//#endregion
+//#region packages/core/src/analyze/second-page-analysis.d.ts
+declare function analyzeSecondPageRows(input: AnalyzeSecondPageInput): SecondPageAnalysis;
+//#endregion
+//#region packages/core/src/analyze/keyword-opportunity-contract.d.ts
+type KeywordOpportunitySource = 'quick-wins' | 'second-page' | 'striking-distance';
+type KeywordOpportunitiesInput = {
+  site: string;
+  days?: number;
+  minImpressions?: number;
+  limit?: number;
+  keywordLimit?: number;
+  queriesPerPage?: number;
+  clusterLimit?: number;
+  brandTerms?: string[];
+  includeBrand?: boolean;
+  includeExternal?: boolean;
+  market?: SearchMarket;
+  provider?: ProviderId;
+  projectId?: string;
+  refresh?: boolean;
+};
+type BoundedSecondPageItem = Omit<SecondPageItem, 'queries'> & {
+  queries: SecondPageItem['queries'];
+  queryCoverage: {
+    available: number;
+    returned: number;
+    omitted: number;
+  };
+};
+type QuickWinsSection = Omit<QuickWinAnalysis, 'eligibleItems'>;
+type SecondPageSection = Omit<SecondPageAnalysis, 'items'> & {
+  items: BoundedSecondPageItem[];
+};
+type StrikingDistanceSection = Omit<StrikingDistanceAnalysis, 'groups'> & {
+  groups: StrikingDistanceAnalysis['groups'];
+  groupCoverage: {
+    available: number;
+    returned: number;
+    omitted: number;
+  };
+};
+type KeywordOpportunityFirstParty = {
+  provider: 'google-search-console';
+  dimensions: ['query', 'page'];
+  searchType: 'web';
+  dataState: 'final';
+  rowsFetched: number;
+  calls: number;
+  maxRows: number;
+  possiblyTruncated: boolean;
+  completeness: 'retained-query-rows-only';
+  quickWins: QuickWinsSection;
+  secondPage: SecondPageSection;
+  strikingDistance: StrikingDistanceSection;
+};
+type KeywordOpportunityExternal = {
+  requested: boolean;
+  status: 'not-requested' | 'skipped' | 'complete' | 'partial' | 'unavailable';
+  selection: {
+    availableKeywords: number;
+    requestedKeywords: number;
+    omittedKeywords: number;
+    method: 'round-robin-first-party-sections';
+  };
+  report: KeywordMetricsReport | null;
+  reason?: string;
+  error?: {
+    code: 'PROVIDER_UNAVAILABLE' | 'RATE_LIMITED';
+    message: string;
+    retryable: boolean;
+  };
+};
+type KeywordOpportunityCombined = {
+  keyword: string;
+  sources: KeywordOpportunitySource[];
+  firstParty: {
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    averagePosition: number;
+    urls: Array<{
+      url: string;
+      clicks: number;
+      impressions: number;
+      ctr: number;
+      averagePosition: number;
+    }>;
+    urlCoverage: {
+      available: number;
+      returned: number;
+      omitted: number;
+    };
+  };
+  external?: {
+    evidenceRef: string;
+    monthlySearchVolume: KeywordMetric['monthlySearchVolume'];
+    cpcUsd: KeywordMetric['cpcUsd'];
+    keywordDifficulty: KeywordMetric['keywordDifficulty'];
+    intent: KeywordMetric['intent'];
+    resultCount: KeywordMetric['resultCount'];
+    trend: KeywordTrend;
+  };
+};
+type KeywordOpportunityCluster = QueryCluster & {
+  externalContext: {
+    selectedQueries: number;
+    metricsWithObservedVolume: number;
+    metricEvidenceRefs: string[];
+  };
+};
+type KeywordOpportunityFinding = {
+  code: 'provider-zero-with-first-party-impressions';
+  keyword: string;
+  evidenceRefs: [string, string];
+  detail: string;
+  action: string;
+} | {
+  code: 'recent-demand-increase';
+  keyword: string;
+  evidenceRefs: [string, string];
+  detail: string;
+  action: string;
+} | {
+  code: 'programmatic-template-cluster';
+  keyword: string;
+  evidenceRefs: [string];
+  detail: string;
+  action: string;
+};
+type KeywordOpportunityDataSourcePrompt = {
+  clusterRef: string;
+  queryLabel: string;
+  instruction: string;
+  requiredChecks: readonly ['stable entity IDs and join keys', 'required attributes and missing-value rules', 'source provenance and usage rights', 'update cadence and freshness checks', 'page uniqueness and duplicate prevention', 'representative output and internal-link review'];
+  evidenceBoundary: string;
+};
+type KeywordOpportunitiesReport = {
+  schemaVersion: 1;
+  site: string;
+  generatedAt: string;
+  range: {
+    startDate: string;
+    endDate: string;
+  };
+  rangeDays: number;
+  dataStatus: 'complete' | 'partial' | 'empty' | 'filtered';
+  summary: {
+    sourceRows: number;
+    quickWinCandidates: number;
+    secondPageCandidates: number;
+    strikingDistanceCandidates: number;
+    availableCandidateKeywords: number;
+    returnedCandidateKeywords: number;
+    externalMetricsObserved: number;
+    candidateClusters: number;
+    programmaticTemplateClusters: number;
+    verdict: string;
+  };
+  methodology: {
+    id: 'gsc_keyword_opportunities_v1';
+    sourceAcquisition: 'one-bounded-query-page-acquisition';
+    opportunityAnalyses: readonly ['gsc_quick_wins_v2', 'gsc_second_page_v2', 'gsc_striking_distance_v2'];
+    externalSelection: 'round-robin-first-party-sections';
+    externalChangesPriorityScore: false;
+    clustersUse: 'returned-opportunity-keyword-subset';
+    clusterMinImpressions: 25;
+  };
+  firstParty: KeywordOpportunityFirstParty;
+  external: KeywordOpportunityExternal;
+  combined: KeywordOpportunityCombined[];
+  candidateClusters: KeywordOpportunityCluster[];
+  programmaticPatterns: PseoQueryPattern[];
+  findings: KeywordOpportunityFinding[];
+  dataSourcePrompts: KeywordOpportunityDataSourcePrompt[];
+  caveats: string[];
+  nextSteps: string[];
+};
+//#endregion
+//#region packages/core/src/analyze/keyword-opportunities.d.ts
+type SearchAnalytics$3 = typeof querySearchAnalytics;
+type KeywordMetrics = typeof keywordMetricsReport;
+type KeywordOpportunitiesDependencies = {
+  searchAnalytics?: SearchAnalytics$3;
+  keywordMetrics?: KeywordMetrics;
+  now?: () => Date;
+};
+declare function keywordOpportunitiesReport(input: KeywordOpportunitiesInput, dependencies?: KeywordOpportunitiesDependencies): Promise<KeywordOpportunitiesReport>;
+//#endregion
+//#region packages/core/src/analyze/keyword-research.d.ts
+type KeywordResearchAnalysis = {
+  keyword: string;
+  sourceCount: number;
+  seedCount: number;
+  trend: KeywordTrend;
+};
+type KeywordResearchFinding = {
+  code: 'multi-source-keyword' | 'recent-demand-increase';
+  keyword: string;
+  evidenceRef: string;
+  principle: string;
+  detail: string;
+};
+type KeywordResearchReport = {
+  schemaVersion: 1;
+  generatedAt: string;
+  dataStatus: 'complete' | 'partial' | 'unavailable';
+  market: SearchMarket;
+  summary: {
+    requestedSeeds: number;
+    requestedSources: number;
+    discoveredKeywords: number;
+    keywordsWithObservedVolume: number;
+    observedZeroVolume: number;
+    missingOrInvalidVolume: number;
+    keywordsFoundBySeveralSources: number;
+    increasingTrends: number;
+    verdict: string;
+  };
+  evidence: ProviderEvidence<KeywordIdea[]>;
+  analysis: KeywordResearchAnalysis[];
+  findings: KeywordResearchFinding[];
+  caveats: string[];
+  nextSteps: string[];
+};
+type KeywordResearchReportDependencies = {
+  candidates?: readonly ProviderCandidate[];
+  now?: () => Date;
+};
+declare function keywordResearchReport(input: {
+  seeds: string[];
+  sources?: KeywordDiscoverySource[];
+  market: SearchMarket;
+  limit?: number;
+  provider?: ProviderId;
+  projectId?: string;
+  context?: Partial<ProviderRequestContext>;
+  refresh?: boolean;
+}, dependencies?: KeywordResearchReportDependencies): Promise<KeywordResearchReport>;
+//#endregion
 //#region packages/core/src/analyze/monitoring/crawl-diff.d.ts
 declare function compareCrawlPages(input: {
   current: CrawlPageSnapshot[];
@@ -22484,14 +23079,15 @@ declare namespace SqliteDatabase {
 }
 //#endregion
 //#region packages/core/src/storage/database.d.ts
+declare function ensurePrivateDatabaseFiles(path: string): void;
 declare function getDb(): SqliteDatabase.Database;
-declare function noteCacheWrite(sizeBytes?: number): void;
+declare function noteCacheWrite(sizeBytes?: number, database?: SqliteDatabase.Database): void;
 declare function checkDatabaseReadiness(): {
   dbPath: string;
 };
 declare function hashKey(parts: unknown[]): string;
 declare function getCacheStats(): CacheStats;
-declare function clearCache(provider?: 'gsc' | 'google-analytics' | 'semrush' | 'http', olderThanMs?: number): number;
+declare function clearCache(provider?: 'gsc' | 'google-analytics' | 'semrush' | 'dataforseo' | 'http', olderThanMs?: number): number;
 //#endregion
 //#region packages/core/src/analyze/monitoring/index-watch.d.ts
 declare const INDEX_WATCH_ATTEMPT_RETENTION = 20;
@@ -22808,15 +23404,6 @@ declare function performanceAudit(input: {
   now?: () => Date;
 }): Promise<PerformanceAuditReport>;
 //#endregion
-//#region packages/core/src/analyze/pseo/query-insights.d.ts
-type PseoQueryPattern = {
-  label: string;
-  queryCount: number;
-  clicks: number;
-  impressions: number;
-  examples: string[];
-};
-//#endregion
 //#region packages/core/src/analyze/pseo/types.d.ts
 type PseoQueryPageRow = {
   query: string;
@@ -23093,15 +23680,34 @@ declare function pseoAuditOptions(input: Omit<PseoAuditInput, 'site'>): {
   rate?: FetchRateControls | undefined;
   progress?: ProgressReporter | undefined;
 };
-declare function pseoAuditReport(input: PseoAuditInput, dependencies?: PseoDependencies): Promise<PseoAuditReport>;
-//#endregion
-//#region packages/core/src/analyze/pseo/markdown.d.ts
-declare function renderPseoMarkdown(report: PseoAuditReport): string;
-//#endregion
-//#region packages/core/src/presentation.d.ts
-type PresentationScalar = boolean | number | string | null;
-type PresentationTableColumn = {
-  key: string;
+type PseoAuditAcquisition = {
+  options: ReturnType<typeof pseoAuditOptions>;
+  generatedAt: string;
+  range: {
+    startDate: string;
+    endDate: string;
+  };
+  warnings: string[];
+  sitemapUrls: string[];
+  pageRows: PseoPageRow[];
+  queryPageRows: PseoQueryPageRow[];
+  pageRowsFetched: number;
+  queryPageRowsFetched: number;
+};
+declare function acquirePseoAuditEvidence(input: PseoAuditInput, dependencies?: PseoDependencies): Promise<PseoAuditAcquisition>;
+declare function buildPseoAuditFromAcquisition(input: PseoAuditInput, acquisition: PseoAuditAcquisition, evidence?: {
+  crawl: PseoCrawlSample[];
+  inspection: PseoInspectionSample[];
+}): PseoAuditReport;
+declare function pseoAuditReport(input: PseoAuditInput, dependencies?: PseoDependencies): Promise<PseoAuditReport>;
+//#endregion
+//#region packages/core/src/analyze/pseo/markdown.d.ts
+declare function renderPseoMarkdown(report: PseoAuditReport): string;
+//#endregion
+//#region packages/core/src/presentation.d.ts
+type PresentationScalar = boolean | number | string | null;
+type PresentationTableColumn = {
+  key: string;
   label: string;
   type?: 'number' | 'string' | 'url';
 };
@@ -23127,6 +23733,276 @@ type Presentation = {
 //#region packages/core/src/analyze/pseo/presentation.d.ts
 declare function pseoPresentation(report: PseoAuditReport): Presentation;
 //#endregion
+//#region packages/core/src/analyze/pseo-opportunity-contract.d.ts
+type PseoOpportunitiesInput = Pick<PseoAuditInput, 'site' | 'days' | 'sitemaps' | 'maxSitemapUrls' | 'templateLimit' | 'minimumTemplateUrls' | 'minimumTemplateShare' | 'minimumTemplateImpressions' | 'brandTerms' | 'includeBrand' | 'refresh'> & {
+  clusterLimit?: number;
+  includeExternal?: boolean;
+  market?: SearchMarket;
+  provider?: ProviderId;
+  discoverySources?: KeywordDiscoverySource[];
+  discoveryLimit?: number;
+  candidateLimit?: number;
+  serpLimit?: number;
+  serpDepth?: number;
+  projectId?: string;
+};
+type PseoOpportunityTemplate = {
+  signature: string;
+  shape: PseoAuditTemplate['shape'];
+  sampleUrls: string[];
+  population: {
+    discoveredUrls: number;
+    gscVisibleUrls: number;
+    untestedUrls: number;
+  };
+  searchEvidence: {
+    clicks: number;
+    impressions: number;
+    averagePosition: number;
+    topQueries: Array<{
+      query: string;
+      clicks: number;
+      impressions: number;
+      position: number;
+    }>;
+    queryPatterns: PseoAuditTemplate['metrics']['queryPatterns'];
+  };
+  evidenceClass: 'search-evidenced-template' | 'observed-template';
+  auditVerdict: PseoAuditTemplate['verdict'];
+  confidence: PseoAuditTemplate['confidence'];
+  evidenceRef: string;
+};
+type PseoOpportunityCluster = Pick<QueryCluster, 'label' | 'intent' | 'totals' | 'template' | 'summary' | 'recommendation'> & {
+  queries: QueryCluster['queries'];
+  evidenceClass: 'template-mapped' | 'query-cluster';
+  templateRef: string | null;
+  evidenceRef: string;
+};
+type PseoResearchSeed = {
+  keyword: string;
+  source: 'template' | 'query-cluster';
+  evidenceRef: string;
+  templateRef: string | null;
+};
+type PseoExternalCandidate = {
+  keyword: string;
+  classification: 'existing-first-party-query' | 'search-evidenced-template-expansion' | 'new-template-research';
+  seedRefs: string[];
+  templateRefs: string[];
+  sources: KeywordIdea['sources'];
+  monthlySearchVolume: KeywordIdea['monthlySearchVolume'];
+  keywordDifficulty: KeywordIdea['keywordDifficulty'];
+  intent: KeywordIdea['intent'];
+  resultCount: KeywordIdea['resultCount'];
+  evidenceRef: string;
+};
+type PseoExternalAcquisition = Pick<ProviderEvidence<never>, 'provider' | 'observedAt' | 'market' | 'coverage' | 'cache' | 'cost' | 'request' | 'warnings'>;
+type PseoDiscoveryEvidence = {
+  requested: boolean;
+  status: 'not-requested' | 'skipped' | 'complete' | 'partial' | 'unavailable';
+  seeds: PseoResearchSeed[];
+  acquisition: PseoExternalAcquisition | null;
+  availableCandidates: number;
+  returnedCandidates: number;
+  omittedCandidates: number;
+  candidates: PseoExternalCandidate[];
+  reason?: string;
+  error?: {
+    code: string;
+    message: string;
+    retryable: boolean;
+  };
+};
+type PseoSerpObservation = {
+  keyword: string;
+  status: 'complete' | 'partial' | 'unavailable';
+  acquisition: PseoExternalAcquisition | null;
+  features: string[];
+  organicResults: SerpOrganicResult[];
+  resultCoverage: {
+    available: number;
+    returned: number;
+    omitted: number;
+  };
+  reason?: string;
+  error?: {
+    code: string;
+    message: string;
+    retryable: boolean;
+  };
+};
+type PseoSerpEvidence = {
+  requested: boolean;
+  requestedQueries: number;
+  completedQueries: number;
+  failedQueries: number;
+  observations: PseoSerpObservation[];
+};
+type PseoCompetitorPattern = {
+  domain: string;
+  queryCount: number;
+  resultCount: number;
+  bestRank: number;
+  queries: string[];
+  sampleUrls: string[];
+  repeatedTemplates: Array<{
+    signature: string;
+    urlCount: number;
+    sampleUrls: string[];
+  }>;
+  evidenceRefs: string[];
+};
+type PseoDataSourceBrief = {
+  candidateRef: string;
+  proposalType: 'template-expansion' | 'new-template-research';
+  instruction: string;
+  requiredChecks: readonly ['entities and required fields', 'stable identifiers and join keys', 'geographic and language coverage', 'update cadence and stale-data handling', 'source provenance, licensing, and attribution', 'validation rules and missing-value stop conditions', 'bounded inventory and duplicate prevention', 'representative output, crawl, canonical, and internal-link review'];
+  evidenceBoundary: string;
+};
+type PseoOpportunityFinding = {
+  code: 'template-expansion-candidate';
+  evidenceRefs: [string, string];
+  detail: string;
+  action: string;
+} | {
+  code: 'new-template-research-candidate';
+  evidenceRefs: [string];
+  detail: string;
+  action: string;
+} | {
+  code: 'competitor-repeated-pattern';
+  evidenceRefs: [string];
+  detail: string;
+  action: string;
+};
+type PseoKnownCost = {
+  currency: 'USD';
+  knownEstimatedMicros: number;
+  knownActualMicros: number;
+  unknownEstimatedRequests: number;
+  unknownActualRequests: number;
+  taskIds: string[];
+};
+type PseoOpportunitiesReport = {
+  schemaVersion: 1;
+  methodology: 'pseo_opportunities_v1';
+  site: string;
+  generatedAt: string;
+  dataStatus: 'complete' | 'partial' | 'empty' | 'filtered';
+  market: SearchMarket | null;
+  summary: {
+    observedTemplates: number;
+    searchEvidencedTemplates: number;
+    queryClusters: number;
+    researchSeeds: number;
+    discoveredCandidates: number;
+    templateExpansionCandidates: number;
+    newTemplateResearchCandidates: number;
+    serpSnapshots: number;
+    observedCompetitors: number;
+    dataSourceBriefs: number;
+    verdict: string;
+  };
+  source: {
+    pseoAudit: {
+      range: {
+        startDate: string;
+        endDate: string;
+      };
+      dataStatus: PseoAuditReport['dataStatus'];
+      pageRows: number;
+      queryPageRows: number;
+      pageRowsPossiblyTruncated: boolean;
+      queryPageRowsPossiblyTruncated: boolean;
+      discoveredUrls: number;
+      returnedTemplates: number;
+    };
+    queryClusters: {
+      range: {
+        startDate: string;
+        endDate: string;
+      };
+      returnedClusters: number;
+      returnedQueries: number;
+      completeness: 'returned-clusters-only';
+      minImpressions: number;
+      limit: number;
+    };
+    external: {
+      discovery: PseoDiscoveryEvidence;
+      serps: PseoSerpEvidence;
+      cost: PseoKnownCost;
+    };
+  };
+  selection: {
+    templateLimit: number;
+    clusterLimit: number;
+    seedLimit: 5;
+    discoveryLimit: number;
+    candidateLimit: number;
+    serpLimit: number;
+    serpDepth: number;
+    organicResultsPerSnapshot: 10;
+    competitorLimit: 10;
+    dataSourceBriefLimit: 3;
+    candidateOrder: 'classification-source-count-volume-keyword-v1';
+  };
+  templates: PseoOpportunityTemplate[];
+  queryClusters: PseoOpportunityCluster[];
+  competitors: PseoCompetitorPattern[];
+  findings: PseoOpportunityFinding[];
+  dataSourceBriefs: PseoDataSourceBrief[];
+  caveats: string[];
+  nextSteps: string[];
+};
+//#endregion
+//#region packages/core/src/analyze/serp-results.d.ts
+type SerpDomainSummary = {
+  domain: string;
+  resultCount: number;
+  ranks: number[];
+};
+type SerpResultFinding = {
+  code: 'query-correction' | 'repeated-domain';
+  evidenceRef: string;
+  principle: string;
+  detail: string;
+};
+type SerpResultsReport = {
+  schemaVersion: 1;
+  generatedAt: string;
+  dataStatus: 'complete' | 'partial' | 'unavailable';
+  market: SearchMarket;
+  summary: {
+    keyword: string;
+    effectiveKeyword: string;
+    requestedDepth: number;
+    organicResults: number;
+    uniqueDomains: number;
+    observedFeatures: number;
+    correctedQuery: boolean;
+    verdict: string;
+  };
+  evidence: ProviderEvidence<SerpSnapshot>;
+  domains: SerpDomainSummary[];
+  findings: SerpResultFinding[];
+  caveats: string[];
+  nextSteps: string[];
+};
+type SerpResultsReportDependencies = {
+  candidates?: readonly ProviderCandidate[];
+  now?: () => Date;
+};
+declare function serpResultsReport(input: {
+  keyword: string;
+  market: SearchMarket;
+  depth?: number;
+  provider?: ProviderId;
+  projectId?: string;
+  context?: Partial<ProviderRequestContext>;
+  refresh?: boolean;
+}, dependencies?: SerpResultsReportDependencies): Promise<SerpResultsReport>;
+//#endregion
 //#region packages/core/src/analyze/query-cluster-primitives.d.ts
 type QueryClusterRow = {
   query: string;
@@ -23186,8 +24062,10 @@ type QueryClusterReport = {
   caveats: string[];
   recommendations: string[];
 };
+type QueryClusterSourceRow = Awaited<ReturnType<typeof querySearchAnalytics>>['rows'][number];
 declare function queryClusterReport(input: {
   site: string;
+  days?: number;
   scope?: string;
   brand?: string;
   brandTerms?: string[];
@@ -23196,6 +24074,54 @@ declare function queryClusterReport(input: {
   limit?: number;
   refresh?: boolean;
 }): Promise<QueryClusterReport>;
+declare function buildQueryClusterReportFromRows(input: {
+  site: string;
+  days: number;
+  range: {
+    startDate: string;
+    endDate: string;
+  };
+  generatedAt: string;
+  rows: QueryClusterSourceRow[];
+  scope?: string;
+  brand?: string;
+  brandTerms?: string[];
+  includeBrand?: boolean;
+  minImpressions?: number;
+  limit?: number;
+}): QueryClusterReport;
+//#endregion
+//#region packages/core/src/analyze/pseo-opportunities/input.d.ts
+type ValidatedPseoOpportunitiesInput = Omit<PseoOpportunitiesInput, 'days' | 'templateLimit' | 'clusterLimit' | 'discoverySources' | 'discoveryLimit' | 'candidateLimit' | 'serpLimit' | 'serpDepth' | 'market' | 'provider'> & {
+  days: number;
+  templateLimit: number;
+  clusterLimit: number;
+  discoverySources: KeywordDiscoverySource[];
+  discoveryLimit: number;
+  candidateLimit: number;
+  serpLimit: number;
+  serpDepth: number;
+  market?: SearchMarket;
+  provider?: PseoOpportunitiesInput['provider'];
+};
+//#endregion
+//#region packages/core/src/analyze/pseo-opportunities/first-party-acquisition.d.ts
+type PseoOpportunityFirstPartyReport = {
+  audit: PseoAuditReport;
+  queryClusters: QueryClusterReport;
+};
+declare function pseoOpportunityFirstPartyReport(options: ValidatedPseoOpportunitiesInput, dependencies?: {
+  acquirePseoAuditEvidence?: typeof acquirePseoAuditEvidence;
+}): Promise<PseoOpportunityFirstPartyReport>;
+//#endregion
+//#region packages/core/src/analyze/pseo-opportunities/report.d.ts
+type PseoOpportunitiesDependencies = {
+  firstPartyReport?: typeof pseoOpportunityFirstPartyReport;
+  keywordResearchReport?: typeof keywordResearchReport;
+  serpResultsReport?: typeof serpResultsReport;
+  now?: () => Date;
+};
+declare function pseoOpportunitiesReport(input: PseoOpportunitiesInput, dependencies?: PseoOpportunitiesDependencies): Promise<PseoOpportunitiesReport>;
 //#endregion
 //#region packages/core/src/errors.d.ts
 type SeoErrorCode = 'ACCESS_DENIED' | 'AUTH_CONFIG_REQUIRED' | 'AUTH_EXPIRED' | 'AUTH_REQUIRED' | 'INSUFFICIENT_DATA' | 'INTERNAL_ERROR' | 'INVALID_INPUT' | 'OPTIONAL_PROVIDER_UNAVAILABLE' | 'PROPERTY_NOT_FOUND' | 'PROVIDER_UNAVAILABLE' | 'RATE_LIMITED';
@@ -23306,8 +24232,259 @@ declare function reportNarrative(input: {
 //#region packages/core/src/analyze/reports/presentation.d.ts
 declare function reportPresentation(report: ReportNarrative): Presentation;
 //#endregion
-//#region packages/core/src/analyze/second-page-analysis.d.ts
-declare function analyzeSecondPageRows(input: AnalyzeSecondPageInput): SecondPageAnalysis;
+//#region packages/core/src/keyword-sets/limits.d.ts
+declare const KEYWORD_SET_LIMITS: {
+  readonly setsPerProject: 25;
+  readonly totalSets: 100;
+  readonly keywordsPerSet: 10000;
+  readonly totalKeywords: 100000;
+  readonly mutationKeywords: 1000;
+  readonly tagsPerKeyword: 20;
+  readonly outputRows: 1000;
+  readonly logicalBytes: number;
+};
+declare const KEYWORD_SET_FIELD_LIMITS: {
+  readonly name: 80;
+  readonly projectId: 80;
+  readonly sourceReport: 100;
+  readonly keyword: 80;
+  readonly keywordWords: 10;
+  readonly tag: 40;
+  readonly url: 2048;
+  readonly metricJsonBytes: number;
+};
+//#endregion
+//#region packages/core/src/keyword-sets/types.d.ts
+type KeywordSetPageMapping = {
+  kind: 'target' | 'proposed';
+  url: string;
+};
+type SavedKeywordMetric = {
+  schemaVersion: 1;
+  provider: ProviderId;
+  observedAt: string;
+  metric: KeywordMetric;
+};
+type KeywordSet = {
+  schemaVersion: 1;
+  id: string;
+  projectId: string;
+  name: string;
+  market: SearchMarket;
+  provider: ProviderId | null;
+  sourceReport: string | null;
+  keywordCount: number;
+  tagCount: number;
+  createdAt: string;
+  updatedAt: string;
+  lastRefreshedAt: string | null;
+};
+type KeywordSetItem = {
+  keyword: string;
+  normalizedKeyword: string;
+  tags: string[];
+  page: KeywordSetPageMapping | null;
+  latestMetric: SavedKeywordMetric | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type KeywordSetDetail = {
+  schemaVersion: 1;
+  set: KeywordSet;
+  items: KeywordSetItem[];
+  pagination: {
+    offset: number;
+    limit: number;
+    returned: number;
+    total: number;
+    nextOffset: number | null;
+  };
+  filter: {
+    tag: string | null;
+  };
+};
+type KeywordSetMutationItem = {
+  keyword: string;
+  tags?: string[];
+  page?: KeywordSetPageMapping | null;
+  latestMetric?: SavedKeywordMetric | null;
+};
+type KeywordSetMutationResult = {
+  setId: string;
+  requested: number;
+  normalized: number;
+  added: number;
+  removed: number;
+  existing: number;
+  updated: number;
+  keywordCount: number;
+};
+//#endregion
+//#region packages/core/src/keyword-sets/rows.d.ts
+type KeywordSetStoreOptions = {
+  database?: SqliteDatabase.Database;
+  now?: () => Date;
+  id?: () => string;
+  maxLogicalBytes?: number;
+};
+declare function keywordSetLogicalBytes(db?: SqliteDatabase.Database): number;
+//#endregion
+//#region packages/core/src/keyword-sets/mutations.d.ts
+declare function addKeywordsToSet(input: {
+  projectId: string;
+  idOrName: string;
+  items: KeywordSetMutationItem[];
+}, options?: KeywordSetStoreOptions): KeywordSetMutationResult;
+declare function removeKeywordsFromSet(input: {
+  projectId: string;
+  idOrName: string;
+  keywords: string[];
+}, options?: KeywordSetStoreOptions): KeywordSetMutationResult;
+declare function setKeywordSetRefreshTime(input: {
+  projectId: string;
+  idOrName: string;
+  refreshedAt: string;
+}, options?: KeywordSetStoreOptions): KeywordSet;
+//#endregion
+//#region packages/core/src/keyword-sets/refresh.d.ts
+type KeywordSetRefreshReport = {
+  schemaVersion: 1;
+  generatedAt: string;
+  mode: 'preview' | 'executed';
+  dataStatus: 'complete' | 'partial' | 'unavailable';
+  set: {
+    id: string;
+    name: string;
+    projectId: string;
+    totalKeywords: number;
+  };
+  selection: {
+    offset: number;
+    limit: number;
+    selectedKeywords: number;
+    nextOffset: number | null;
+    completeness: 'complete' | 'capped';
+  };
+  cost: KeywordMetricsCostEstimate;
+  execution: null | {
+    attemptedBatches: number;
+    completeBatches: number;
+    partialBatches: number;
+    failedBatches: number;
+    savedSnapshots: number;
+    actualMicros: number | null;
+    warnings: Array<{
+      batch: number;
+      message: string;
+    }>;
+    errors: Array<{
+      batch: number;
+      message: string;
+    }>;
+  };
+  caveats: string[];
+  nextSteps: string[];
+};
+type KeywordSetRefreshDependencies = {
+  candidates?: readonly ProviderCandidate[];
+  keywordMetrics?: typeof keywordMetricsReport;
+  now?: () => Date;
+  store?: KeywordSetStoreOptions;
+};
+declare function refreshKeywordSet(input: {
+  projectId: string;
+  idOrName: string;
+  provider?: ProviderId;
+  limit?: number;
+  offset?: number;
+  execute?: boolean;
+}, dependencies?: KeywordSetRefreshDependencies): Promise<KeywordSetRefreshReport>;
+//#endregion
+//#region packages/core/src/keyword-sets/schema.d.ts
+declare const KEYWORD_SET_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS keyword_sets (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL,\n  name TEXT NOT NULL,\n  market_json TEXT NOT NULL,\n  provider TEXT CHECK(provider IS NULL OR provider IN ('dataforseo', 'semrush', 'ahrefs')),\n  source_report TEXT,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  last_refreshed_at INTEGER,\n  UNIQUE(project_id, name COLLATE NOCASE)\n);\nCREATE INDEX IF NOT EXISTS idx_keyword_sets_project\n  ON keyword_sets(project_id, updated_at DESC, id);\n\nCREATE TABLE IF NOT EXISTS keyword_set_items (\n  set_id TEXT NOT NULL,\n  normalized_keyword TEXT NOT NULL,\n  display_keyword TEXT NOT NULL,\n  metric_json TEXT,\n  metric_provider TEXT CHECK(metric_provider IS NULL OR metric_provider IN ('dataforseo', 'semrush', 'ahrefs')),\n  metric_observed_at TEXT,\n  page_kind TEXT CHECK(page_kind IS NULL OR page_kind IN ('target', 'proposed')),\n  page_url TEXT,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  PRIMARY KEY(set_id, normalized_keyword),\n  FOREIGN KEY(set_id) REFERENCES keyword_sets(id) ON DELETE CASCADE\n) WITHOUT ROWID;\nCREATE INDEX IF NOT EXISTS idx_keyword_set_items_set\n  ON keyword_set_items(set_id, normalized_keyword);\n\nCREATE TABLE IF NOT EXISTS keyword_set_tags (\n  set_id TEXT NOT NULL,\n  normalized_keyword TEXT NOT NULL,\n  tag TEXT NOT NULL,\n  PRIMARY KEY(set_id, normalized_keyword, tag),\n  FOREIGN KEY(set_id, normalized_keyword)\n    REFERENCES keyword_set_items(set_id, normalized_keyword) ON DELETE CASCADE\n) WITHOUT ROWID;\nCREATE INDEX IF NOT EXISTS idx_keyword_set_tags_lookup\n  ON keyword_set_tags(set_id, tag, normalized_keyword);\n";
+//#endregion
+//#region packages/core/src/keyword-sets/store.d.ts
+declare function createKeywordSet(input: {
+  projectId: string;
+  name: string;
+  market: unknown;
+  provider?: unknown;
+  sourceReport?: string;
+}, options?: KeywordSetStoreOptions): KeywordSet;
+declare function listKeywordSets(input: {
+  projectId: string;
+  limit?: number;
+  offset?: number;
+}, options?: KeywordSetStoreOptions): KeywordSet[];
+declare function getKeywordSet(input: {
+  projectId: string;
+  idOrName: string;
+  tag?: string;
+  limit?: number;
+  offset?: number;
+}, options?: KeywordSetStoreOptions): KeywordSetDetail;
+declare function deleteKeywordSet(input: {
+  projectId: string;
+  idOrName: string;
+}, options?: KeywordSetStoreOptions): boolean;
+//#endregion
+//#region packages/core/src/keyword-sets/validation.d.ts
+declare function normalizeSavedKeyword(value: string): string;
+//#endregion
+//#region packages/core/src/analyze/saved-keywords.d.ts
+type SavedKeywordSetReport = {
+  schemaVersion: 1;
+  generatedAt: string;
+  dataStatus: 'complete' | 'partial' | 'unavailable';
+  summary: {
+    name: string;
+    totalKeywords: number;
+    matchedKeywords: number;
+    returnedKeywords: number;
+    metricSnapshots: number;
+    observedVolumes: number;
+    observedZeroVolumes: number;
+    unavailableVolumeSnapshots: number;
+    staleMetricSnapshots: number;
+    mappedKeywords: number;
+    targetPages: number;
+    proposedPages: number;
+    distinctTags: number;
+    verdict: string;
+  };
+  evidence: KeywordSetDetail;
+  analysis: {
+    metricFreshnessDays: number;
+    tagGroups: Array<{
+      tag: string;
+      keywordCount: number;
+    }>;
+    pageMappings: Array<{
+      url: string;
+      kind: 'target' | 'proposed';
+      keywordCount: number;
+    }>;
+  };
+  findings: Array<{
+    code: 'missing-metrics' | 'unavailable-volume-evidence' | 'stale-metrics' | 'unmapped-keywords';
+    evidenceRef: string;
+    detail: string;
+    action: string;
+  }>;
+  caveats: string[];
+  nextSteps: string[];
+};
+declare function savedKeywordSetReport(input: {
+  projectId: string;
+  idOrName: string;
+  tag?: string;
+  limit?: number;
+  offset?: number;
+  staleDays?: number;
+}, dependencies?: {
+  getKeywordSet?: typeof getKeywordSet;
+  now?: () => Date;
+}): SavedKeywordSetReport;
 //#endregion
 //#region packages/core/src/analyze/second-page.d.ts
 type SearchAnalytics = typeof querySearchAnalytics;
@@ -24947,18 +26124,542 @@ declare function fileSize(path: string): number;
 declare function plural(count: number, singular: string, pluralLabel?: string): string;
 declare function countLabel(count: number, singular: string, pluralLabel?: string): string;
 //#endregion
+//#region packages/core/src/providers/cost-limits.d.ts
+type ProviderSpendLimits = {
+  dailyNoticeMicros: number;
+  dailyHardLimitMicros: number | null;
+  monthlyHardLimitMicros: number | null;
+  maxRequestsPerReport: number;
+  maxRowsPerReport: number;
+};
+declare const DEFAULT_PROVIDER_SPEND_LIMITS: ProviderSpendLimits;
+declare function getProviderSpendLimits(provider: ProviderId): ProviderSpendLimits;
+declare function setProviderSpendLimits(provider: ProviderId, limits: ProviderSpendLimits): ProviderSpendLimits;
+//#endregion
+//#region packages/core/src/storage/provider-spend.d.ts
+declare const PROVIDER_SPEND_RETENTION_DAYS: number;
+declare const PROVIDER_SPEND_MAX_ROWS = 50000;
+declare const PROVIDER_SPEND_MAX_BYTES: number;
+type ProviderSpendState = 'reserved' | 'succeeded' | 'partial' | 'failed' | 'unknown';
+type ProviderSpendReservationInput = {
+  provider: ProviderId;
+  capability: ProviderCapability;
+  endpoint: string;
+  projectId?: string;
+  reportId: string;
+  reportRunId: string;
+  requestedRows: number;
+  estimatedCostMicros: number;
+};
+type ProviderSpendReservation = ProviderSpendReservationInput & {
+  id: string;
+  occurredAt: string;
+  expiresAt: string;
+};
+type ProviderSpendFinalization = {
+  provider: ProviderId;
+  state: Exclude<ProviderSpendState, 'reserved' | 'unknown'>;
+  actualCostMicros: number | null;
+  returnedRows: number | null;
+  taskIds: string[];
+};
+type ProviderSpendNotice = {
+  provider: ProviderId;
+  thresholdMicros: number;
+  periodStart: string;
+  spentMicros: number;
+};
+type ProviderSpendSummary = {
+  provider: ProviderId;
+  periodTimezone: 'UTC';
+  today: {
+    periodStart: string;
+    effectiveCostMicros: number;
+    actualCostMicros: number;
+    estimatedOrUnknownCostMicros: number;
+    requests: number;
+  };
+  month: {
+    periodStart: string;
+    effectiveCostMicros: number;
+    actualCostMicros: number;
+    estimatedOrUnknownCostMicros: number;
+    requests: number;
+  };
+  retained: {
+    effectiveCostMicros: number;
+    actualCostMicros: number;
+    estimatedOrUnknownCostMicros: number;
+    requests: number;
+    oldestAt: string | null;
+    newestAt: string | null;
+  };
+  states: Record<ProviderSpendState, number>;
+  limits: ProviderSpendLimits;
+  retention: {
+    days: number;
+    maxRows: number;
+    maxBytes: number;
+    logicalBytes: number;
+  };
+};
+declare function reserveProviderSpend(input: ProviderSpendReservationInput, options?: {
+  database?: SqliteDatabase.Database;
+  limits?: ProviderSpendLimits;
+  now?: number;
+}): ProviderSpendReservation;
+declare function finalizeProviderSpend(reservationId: string, result: ProviderSpendFinalization, options?: {
+  database?: SqliteDatabase.Database;
+  limits?: ProviderSpendLimits;
+  now?: number;
+}): ProviderSpendNotice | null;
+declare function getProviderSpendSummary(provider: ProviderId, options?: {
+  database?: SqliteDatabase.Database;
+  limits?: ProviderSpendLimits;
+  now?: number;
+}): ProviderSpendSummary;
+//#endregion
+//#region packages/core/src/providers/transport.d.ts
+type ProviderFetch = (url: string | URL, init?: RequestInit$1) => Promise<Response$1>;
+type ProviderRequestInput = {
+  provider: ProviderId;
+  operation: string;
+  url: string | URL;
+  init?: RequestInit$1;
+  fetch: ProviderFetch;
+  maxResponseBytes: number;
+  timeoutMs: number;
+  retry?: 'never' | 'safe';
+  retryDelayMs?: number;
+};
+declare function providerRequestText(input: ProviderRequestInput): Promise<string>;
+declare function providerRequestJson<T>(input: ProviderRequestInput & {
+  schema: z.ZodType<T>;
+}): Promise<T>;
+//#endregion
+//#region packages/core/src/providers/dataforseo/credentials.d.ts
+declare const DATAFORSEO_LOGIN_ENV = "SEO_DATAFORSEO_LOGIN";
+declare const DATAFORSEO_PASSWORD_ENV = "SEO_DATAFORSEO_PASSWORD";
+declare const DATAFORSEO_CREDENTIAL_SECRET = "dataforseo-credentials";
+type DataForSeoCredentials = {
+  login: string;
+  password: string;
+};
+type StoredDataForSeoCredentials = DataForSeoCredentials & {
+  source: ProviderSecretSource;
+  migrated: boolean;
+};
+declare function writeDataForSeoCredentials(credentials: DataForSeoCredentials): Promise<Exclude<ProviderSecretSource, 'environment'>>;
+declare function readDataForSeoCredentials(input?: {
+  env?: NodeJS.ProcessEnv;
+}): Promise<StoredDataForSeoCredentials | undefined>;
+declare function deleteDataForSeoCredentials(): Promise<void>;
+//#endregion
+//#region packages/core/src/providers/dataforseo/discovery-schema.d.ts
+declare const dataForSeoDiscoveryResponseSchema: z.ZodObject<{
+  status_code: z.ZodNumber;
+  status_message: z.ZodString;
+  cost: z.ZodOptional<z.ZodNumber>;
+  tasks_count: z.ZodNumber;
+  tasks_error: z.ZodNumber;
+  tasks: z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    status_code: z.ZodNumber;
+    status_message: z.ZodString;
+    cost: z.ZodOptional<z.ZodNumber>;
+    result_count: z.ZodOptional<z.ZodNumber>;
+    result: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      seed_keyword: z.ZodOptional<z.ZodString>;
+      seed_keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      total_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      items_count: z.ZodOptional<z.ZodNumber>;
+      offset_token: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      items: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        keyword: z.ZodString;
+        keyword_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          search_volume: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          cpc: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          competition: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          monthly_searches: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            year: z.ZodNumber;
+            month: z.ZodNumber;
+            search_volume: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          }, z.core.$loose>>>>;
+          last_updated_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        keyword_properties: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          keyword_difficulty: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        serp_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          se_results_count: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        }, z.core.$strip>>>;
+        search_intent_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          main_intent: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            informational: "informational";
+            navigational: "navigational";
+            commercial: "commercial";
+            transactional: "transactional";
+          }>>>;
+        }, z.core.$strip>>>;
+      }, z.core.$loose>, z.ZodObject<{
+        keyword_data: z.ZodObject<{
+          keyword: z.ZodString;
+          keyword_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            search_volume: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            cpc: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            competition: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            monthly_searches: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+              year: z.ZodNumber;
+              month: z.ZodNumber;
+              search_volume: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, z.core.$loose>>>>;
+            last_updated_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+          }, z.core.$strip>>>;
+          keyword_properties: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            keyword_difficulty: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          }, z.core.$strip>>>;
+          serp_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            se_results_count: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+          }, z.core.$strip>>>;
+          search_intent_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            main_intent: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+              informational: "informational";
+              navigational: "navigational";
+              commercial: "commercial";
+              transactional: "transactional";
+            }>>>;
+          }, z.core.$strip>>>;
+        }, z.core.$loose>;
+        depth: z.ZodOptional<z.ZodNumber>;
+        related_keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      }, z.core.$loose>]>>>>;
+    }, z.core.$loose>>>>;
+  }, z.core.$loose>>;
+}, z.core.$loose>;
+type DataForSeoDiscoveryResponse = z.infer<typeof dataForSeoDiscoveryResponseSchema>;
+//#endregion
+//#region packages/core/src/providers/dataforseo/paid-request.d.ts
+type DataForSeoUnitPrice = {
+  perRequestMicros: number | null;
+  perResultMicros: number | null;
+};
+//#endregion
+//#region packages/core/src/providers/dataforseo/schema.d.ts
+declare const dataForSeoKeywordOverviewResponseSchema: z.ZodObject<{
+  status_code: z.ZodNumber;
+  status_message: z.ZodString;
+  cost: z.ZodOptional<z.ZodNumber>;
+  tasks_count: z.ZodNumber;
+  tasks_error: z.ZodNumber;
+  tasks: z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    status_code: z.ZodNumber;
+    status_message: z.ZodString;
+    cost: z.ZodOptional<z.ZodNumber>;
+    result_count: z.ZodOptional<z.ZodNumber>;
+    result: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      items_count: z.ZodOptional<z.ZodNumber>;
+      items: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        keyword: z.ZodString;
+        keyword_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          search_volume: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          cpc: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          competition: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          monthly_searches: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            year: z.ZodNumber;
+            month: z.ZodNumber;
+            search_volume: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+          }, z.core.$loose>>>>;
+          last_updated_time: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strip>>>;
+        keyword_properties: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          keyword_difficulty: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        serp_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          se_results_count: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        }, z.core.$strip>>>;
+        search_intent_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          main_intent: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            informational: "informational";
+            navigational: "navigational";
+            commercial: "commercial";
+            transactional: "transactional";
+          }>>>;
+        }, z.core.$strip>>>;
+      }, z.core.$loose>>>>;
+    }, z.core.$loose>>>>;
+  }, z.core.$loose>>;
+}, z.core.$loose>;
+type DataForSeoKeywordOverviewResponse = z.infer<typeof dataForSeoKeywordOverviewResponseSchema>;
+//#endregion
+//#region packages/core/src/providers/dataforseo/serp-schema.d.ts
+declare const dataForSeoSerpResponseSchema: z.ZodObject<{
+  status_code: z.ZodNumber;
+  status_message: z.ZodString;
+  cost: z.ZodOptional<z.ZodNumber>;
+  tasks_count: z.ZodNumber;
+  tasks_error: z.ZodNumber;
+  tasks: z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    status_code: z.ZodNumber;
+    status_message: z.ZodString;
+    cost: z.ZodOptional<z.ZodNumber>;
+    result_count: z.ZodOptional<z.ZodNumber>;
+    result: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      keyword: z.ZodString;
+      se_domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      check_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      datetime: z.ZodString;
+      spell: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        keyword: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>>>;
+      item_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      se_results_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      pages_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      items_count: z.ZodOptional<z.ZodNumber>;
+      items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        rank_group: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        rank_absolute: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        page: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        domain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        is_featured_snippet: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+      }, z.core.$loose>>>;
+    }, z.core.$loose>>>>;
+  }, z.core.$loose>>;
+}, z.core.$loose>;
+type DataForSeoSerpResponse = z.infer<typeof dataForSeoSerpResponseSchema>;
+//#endregion
+//#region packages/core/src/providers/dataforseo/client-types.d.ts
+type DataForSeoAccountSnapshot = {
+  provider: 'dataforseo';
+  login: string;
+  timezone: string | null;
+  balanceMicros: number | null;
+  depositedMicros: number | null;
+  accountDailySpendMicros: number | null;
+  accountDailySpendPeriod: string | null;
+  accountDailyLimitMicros: number | null;
+  keywordOverviewPrice: DataForSeoUnitPrice;
+  keywordDiscoveryPrices: Record<KeywordDiscoverySource, DataForSeoUnitPrice>;
+  serpLiveAdvancedPrice: DataForSeoUnitPrice;
+  backlinksSubscriptionExpiresAt: string | null;
+  aiMentionsSubscriptionExpiresAt: string | null;
+  apiVersion: string | null;
+  requestCostMicros: number;
+  taskIds: string[];
+  observedAt: string;
+};
+type DataForSeoClientOptions = {
+  fetch?: ProviderFetch;
+  credentials?: () => DataForSeoCredentials | undefined | Promise<DataForSeoCredentials | undefined>;
+  baseUrl?: string;
+  timeoutMs?: number;
+  maxResponseBytes?: number;
+  now?: () => Date;
+  database?: SqliteDatabase.Database;
+  keywordOverviewTtlMs?: number;
+  keywordDiscoveryTtlMs?: number;
+  serpTtlMs?: number;
+  accountPricingTtlMs?: number;
+  spendLimits?: ProviderSpendLimits;
+};
+type DataForSeoKeywordOverviewRequest = {
+  keywords: string[];
+  languageCode: string;
+  locationCode?: number;
+  locationName?: string;
+  includeSerpInfo?: boolean;
+  includeClickstreamData?: boolean;
+  refresh?: boolean;
+  projectId?: string;
+  reportId: string;
+  reportRunId: string;
+};
+type DataForSeoKeywordOverviewSnapshot = {
+  response: DataForSeoKeywordOverviewResponse;
+  observedAt: string;
+  returnedRows: number;
+  cache: ProviderCacheEvidence;
+  cost: ProviderCostEvidence;
+  spendNotice: ProviderSpendNotice | null;
+  warnings: ProviderWarning[];
+};
+type DataForSeoKeywordDiscoveryRequest = {
+  source: KeywordDiscoverySource;
+  seeds: string[];
+  languageCode: string;
+  locationCode?: number;
+  locationName?: string;
+  limit: number;
+  refresh?: boolean;
+  context: ProviderRequestContext;
+};
+type DataForSeoKeywordDiscoverySnapshot = {
+  response: DataForSeoDiscoveryResponse;
+  observedAt: string;
+  returnedRows: number;
+  providerTotalRows: number | null;
+  nextCursor: string | null;
+  cache: ProviderCacheEvidence;
+  cost: ProviderCostEvidence;
+  spendNotice: ProviderSpendNotice | null;
+  warnings: ProviderWarning[];
+};
+type DataForSeoSerpRequest = {
+  keyword: string;
+  languageCode: string;
+  locationCode?: number;
+  locationName?: string;
+  device: 'desktop' | 'mobile';
+  depth: number;
+  refresh?: boolean;
+  context: ProviderRequestContext;
+};
+type DataForSeoSerpSnapshot = {
+  response: DataForSeoSerpResponse;
+  observedAt: string;
+  returnedRows: number;
+  cache: ProviderCacheEvidence;
+  cost: ProviderCostEvidence;
+  spendNotice: ProviderSpendNotice | null;
+  warnings: ProviderWarning[];
+};
+//#endregion
+//#region packages/core/src/providers/dataforseo/client.d.ts
+declare class DataForSeoClient {
+  private readonly fetch;
+  private readonly credentials;
+  private readonly baseUrl;
+  private readonly timeoutMs;
+  private readonly maxResponseBytes;
+  private readonly now;
+  private readonly database;
+  private readonly keywordOverviewTtlMs;
+  private readonly keywordDiscoveryTtlMs;
+  private readonly serpTtlMs;
+  private readonly accountPricingTtlMs;
+  private readonly spendLimits;
+  private accountPricing;
+  private accountPricingRequest;
+  constructor(options?: DataForSeoClientOptions);
+  private getCredentials;
+  private authorization;
+  private userDataForCredentials;
+  userData(): Promise<DataForSeoAccountSnapshot>;
+  private pricingForCredentials;
+  private paidPost;
+  keywordOverview(input: DataForSeoKeywordOverviewRequest): Promise<DataForSeoKeywordOverviewSnapshot>;
+  keywordDiscovery(input: DataForSeoKeywordDiscoveryRequest): Promise<DataForSeoKeywordDiscoverySnapshot>;
+  serpLive(input: DataForSeoSerpRequest): Promise<DataForSeoSerpSnapshot>;
+}
+//#endregion
+//#region packages/core/src/providers/dataforseo/keyword-discovery.d.ts
+type KeywordDiscoveryClient = Pick<DataForSeoClient, 'keywordDiscovery'>;
+type DataForSeoKeywordDiscoveryProviderOptions = DataForSeoClientOptions & {
+  client?: KeywordDiscoveryClient;
+};
+declare class DataForSeoKeywordDiscoveryProvider implements KeywordDiscoveryProvider {
+  readonly provider: "dataforseo";
+  readonly capabilitySupport: readonly [{
+    readonly capability: "keyword-discovery";
+    readonly status: "available";
+    readonly markets: readonly [{
+      readonly searchEngines: readonly ["google"];
+      readonly location: "country-only";
+    }];
+  }];
+  private readonly client;
+  constructor(options?: DataForSeoKeywordDiscoveryProviderOptions);
+  discoverKeywords(input: KeywordDiscoveryRequest): Promise<ProviderEvidence<KeywordIdea[]>>;
+}
+//#endregion
+//#region packages/core/src/providers/dataforseo/keyword-metrics.d.ts
+type KeywordMetricsClient = Pick<DataForSeoClient, 'keywordOverview'> & Partial<Pick<DataForSeoClient, 'userData'>>;
+type DataForSeoKeywordMetricsProviderOptions = DataForSeoClientOptions & {
+  client?: KeywordMetricsClient;
+};
+declare class DataForSeoKeywordMetricsProvider implements KeywordMetricsProvider, KeywordMetricsCostEstimator {
+  readonly provider: "dataforseo";
+  readonly capabilitySupport: readonly [{
+    readonly capability: "keyword-metrics";
+    readonly status: "available";
+    readonly markets: readonly [{
+      readonly searchEngines: readonly ["google"];
+      readonly location: "country-only";
+    }];
+  }];
+  private readonly client;
+  constructor(options?: DataForSeoKeywordMetricsProviderOptions);
+  estimateKeywordMetricsCost(input: {
+    requestedRows: number;
+    market: SearchMarket;
+  }): Promise<KeywordMetricsCostEstimate>;
+  keywordMetrics(input: KeywordMetricsRequest): Promise<ProviderEvidence<KeywordMetric[]>>;
+}
+//#endregion
+//#region packages/core/src/providers/dataforseo/serp-snapshot.d.ts
+type SerpClient = Pick<DataForSeoClient, 'serpLive'>;
+type DataForSeoSerpSnapshotProviderOptions = DataForSeoClientOptions & {
+  client?: SerpClient;
+};
+declare class DataForSeoSerpSnapshotProvider implements SerpSnapshotProvider {
+  readonly provider: "dataforseo";
+  readonly capabilitySupport: readonly [{
+    readonly capability: "serp-snapshot";
+    readonly status: "available";
+    readonly markets: readonly [{
+      readonly searchEngines: readonly ["google"];
+      readonly devices: readonly ["desktop", "mobile"];
+      readonly location: "any";
+    }];
+  }];
+  private readonly client;
+  constructor(options?: DataForSeoSerpSnapshotProviderOptions);
+  serpSnapshot(input: SerpSnapshotRequest): Promise<ProviderEvidence<SerpSnapshot>>;
+}
+//#endregion
 //#region packages/core/src/providers/dataforseo.d.ts
+type DataForSeoProviderOptions = DataForSeoClientOptions;
 declare class DataForSeoProvider implements KeywordDataProvider {
   readonly name = "dataforseo";
   readonly capabilities: {
     overview: boolean;
   };
-  private getAuthHeader;
+  private readonly client;
+  constructor(options?: DataForSeoProviderOptions);
   keywordOverview(phrase: string, opts?: ProviderOpts): Promise<ProviderResult<KeywordOverview>>;
 }
 //#endregion
+//#region packages/core/src/providers/errors.d.ts
+type ProviderErrorCode = 'configuration' | 'authentication' | 'budget-limit' | 'rate-limit' | 'timeout' | 'response-too-large' | 'invalid-response' | 'remote-error';
+declare class ProviderError extends Error {
+  readonly provider: ProviderId;
+  readonly operation: string;
+  readonly code: ProviderErrorCode;
+  readonly status: number | null;
+  readonly retryable: boolean;
+  constructor(input: {
+    provider: ProviderId;
+    operation: string;
+    code: ProviderErrorCode;
+    message: string;
+    status?: number;
+    retryable?: boolean;
+    cause?: unknown;
+  });
+  toJSON(): Record<string, unknown>;
+}
+//#endregion
 //#region packages/core/src/providers/router.d.ts
-declare function getKeywordProvider(prefer?: 'cheap' | 'authoritative'): KeywordDataProvider | undefined;
+declare function getKeywordProvider(prefer?: 'cheap' | 'authoritative', dependencies?: {
+  readConfig?: () => AppConfig;
+  hasDataForSeoCredentials?: () => boolean | Promise<boolean>;
+}): Promise<KeywordDataProvider | undefined>;
 //#endregion
 //#region packages/core/src/providers/semrush.d.ts
 declare class SemrushProvider implements KeywordDataProvider {
@@ -25235,7 +26936,7 @@ declare const TELEMETRY_TIMEOUT_MS = 2000;
 declare const TELEMETRY_EVENTS: readonly ["first_run", "setup_complete", "audit_start", "audit_complete", "audit_failed", "first_audit_complete", "active_d1", "active_d7", "active_d30"];
 declare const TELEMETRY_AGENTS: readonly ["claude-code", "cursor", "codex", "cli", "unknown"];
 declare const TELEMETRY_ERROR_CATEGORIES: readonly ["auth", "crawl_timeout", "network", "config", "unknown"];
-declare const TELEMETRY_REPORTS: readonly ["affected-urls", "agent-readiness", "ai-readiness", "ai-referrals", "ai-search-scorecard", "audit-page", "audit-urls", "bing-webmaster-overview", "cannibalisation", "community-intent", "compare-crawls", "content-optimization", "crawl-diff", "site-crawl", "ctr-underperformers", "decaying-pages", "setup-check", "entity-readiness", "explain-crawl-issue", "geo-gaps", "crawl-report", "index-coverage", "index-coverage-plan", "index-monitor", "index-watch", "internal-links", "link-evidence", "server-log-analysis", "link-recovery", "crawl-history", "crawler-rules", "llms-txt-audit", "generate-llms-txt", "measure-change", "monthly-report", "okf-build", "okf-validate", "page-opportunities", "performance-audit", "pseo-audit", "query-clusters", "quick-wins", "redirect-trace", "narrative-report", "second-page", "segment-impact", "striking-distance", "seo-to-ai-query", "top-fixes", "traffic-anomaly", "update-correlation", "search-performance-overview", "monthly-action-plan", "refresh-priorities", "technical-watch", "update-postmortem"];
+declare const TELEMETRY_REPORTS: readonly ["affected-urls", "agent-readiness", "ai-readiness", "ai-referrals", "ai-search-scorecard", "audit-page", "audit-urls", "bing-webmaster-overview", "cannibalisation", "community-intent", "compare-crawls", "content-optimization", "crawl-diff", "site-crawl", "ctr-underperformers", "decaying-pages", "setup-check", "entity-readiness", "explain-crawl-issue", "geo-gaps", "crawl-report", "index-coverage", "index-coverage-plan", "index-monitor", "index-watch", "internal-links", "keyword-metrics", "keyword-opportunities", "keyword-research", "saved-keywords", "link-evidence", "server-log-analysis", "link-recovery", "crawl-history", "crawler-rules", "llms-txt-audit", "generate-llms-txt", "measure-change", "monthly-report", "okf-build", "okf-validate", "page-opportunities", "performance-audit", "pseo-audit", "pseo-opportunities", "query-clusters", "quick-wins", "redirect-trace", "narrative-report", "second-page", "segment-impact", "serp-results", "striking-distance", "seo-to-ai-query", "top-fixes", "traffic-anomaly", "update-correlation", "search-performance-overview", "monthly-action-plan", "refresh-priorities", "technical-watch", "update-postmortem"];
 type TelemetryEvent = (typeof TELEMETRY_EVENTS)[number];
 type TelemetryAgent = (typeof TELEMETRY_AGENTS)[number];
 type TelemetryErrorCategory = (typeof TELEMETRY_ERROR_CATEGORIES)[number];
@@ -25310,5 +27011,5 @@ declare function isoDate(daysAgo?: number): string;
 //#region packages/core/src/version.d.ts
 declare const SEO_VERSION: string;
 //#endregion
-export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, AUTOMATIC_BASELINE_SITE_RETENTION, AUTOMATIC_BASELINE_TOTAL_RETENTION, AccessBlockEvidence, AffectedUrl, AffectedUrlFilters, AffectedUrlResult, AffectedUrlSelection, type AgentDiscoveryDataStatus, type AgentEndpointDiscovery, type AgentEndpointObservation, type AgentLinkHeaderEntry, type AgentLinkHeaderObservation, AgentReadinessCheck, AgentReadinessCheckStatus, type AgentReadinessProfile, AgentReadinessReport, AgentReadinessSection, type AgentRepresentationResponse, type AgentSkillObservation, AiReadinessReport, type AiReferralDataSource, type AiReferralMetrics, type AiReferralQueryEvidence, type AiReferralReport, type AiReferralSourceDefinition, AiSearchScorecard, AnalyticsMetricDelta, AnalyticsTestMetrics, type AnalyzeCannibalRowsInput, type AnalyzeDecayInput, type AnalyzeQuickWinsInput, type AnalyzeSecondPageInput, type AnalyzeStrikingDistanceInput, AppConfig, AuditPageDependencies, AuditPageReport, AuthorizedGoogleClient, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, BacklinkProvider, BingCrawlRow, BingDimensionRow, BingLinkCountRow, BingLinkPage, BingRows, BingTrafficRow, BingUrlLinkRow, BingWebmasterClient, BingWebmasterCredentials, BingWebmasterSite, BoundedSitemapInventory, BrandTermCandidate, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_RUN_RETENTION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, CacheStats, type CannibalAnalysis, CannibalDependencies, type CannibalItem, type CannibalPage, type CannibalReport, CannibalReportInput, type CannibalSelection, type CannibalSuppression, type CannibalSuppressionReason, ChangeMeasurement, ChangeMeasurementAttempt, ChangeRow, ChangeScope, ClientProfile, ClientProfileInput, CollectedLinkEvidence, CommunityIntent, CommunityIntentClassification, CommunityIntentReport, ContentExtractionDiagnostics, ContentExtractor, ContentGroup, ContentGroupDimension, ContentGroupMatchType, ContentGroupRow, ContentOptimizationIntent, ContentOptimizationReport, CoverageField, CrawlAccessSummary, type CrawlAgentDiscovery, CrawlAiBotAccess, CrawlAiResourceSignal, CrawlAiSignals, CrawlAnalyticsDataSource, CrawlConfig, CrawlConfigInput, CrawlDataSourceStatus, CrawlDataSourceWindow, CrawlDiffItem, CrawlDiffRecommendation, CrawlDiffReport, CrawlExternalLinkVerification, CrawlFetchRateConfig, CrawlImplementationQueueInput, CrawlImplementationQueueItem, CrawlImplementationQueueOutput, CrawlIssue, CrawlIssueGroup, CrawlLinkGraph, CrawlMode, CrawlOneResult, CrawlOutputFormat, CrawlPageRow, CrawlPageSnapshot, CrawlReport, CrawlReportDataSources, CrawlReportMeta, CrawlReportSaveOptions, CrawlReportStorageEnvelope, CrawlReportStoreAdapter, CrawlReportSummary, CrawlRequestObservation, CrawlResponseObservation, CrawlRun, CrawlRunRow, CrawlRunStats, CrawlSearchDataSource, type CrawlSiteChecks, type CrawlSiteDependencies, CrawlSitemapDiscovery, CrawlSkipImpact, CrawlSkipReason, CrawlSkipReasonCount, CrawlSkippedUrlsByImpact, CrawlSnapshotDiffReport, CrawlSnapshotIssueChange, CrawlSnapshotPageChange, CrawlStatusEvent, CrawlStatusHandler, CrawlStatusPhase, CrawlStrategy, CrawlerCategory, CrawlerIdentity, CrawlerPathSummary, CrawlerSummary, CredentialsProvider, CreditUsage, CsvFile, CsvRow, CsvValue, type CtrUnderperformer, CtrUnderperformerDependencies, type CtrUnderperformerSelection, DataForSeoProvider, type DecayAnalysis, type DecayComparison, type DecayDiagnosis, type DecayGroup, type DecayItem, type DecayMetrics, type DecayReport, type DecaySelection, type DecaySignal, DecayingDependencies, DecayingReportInput, DiagnosePropertyDependencies, DiagnosePropertyReport, DiagnosisDataStatus, DiagnosisPriority, DoctorCheck, DueIndexSelection, DueIndexUrl, EffectiveSnippetControl, EntityReadinessCheck, EntityReadinessReport, ExternalLinkCheck, ExternalLinkCheckAttempt, ExternalLinkCheckState, ExtractedLinkLocation, ExtractedPage, FetchPageDependencies, type FetchPageOptions, type FetchRateControls, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, Ga4AccountSummary, Ga4DataStream, Ga4PropertySummary, Ga4ReportRequest, Ga4RunReportResult, Ga4WebStreamCandidate, Ga4WebStreamMatch, GenerateLlmsTxtOptions, GeneratedLlmsTxt, GeoGap, GeoGapFilters, GeoGapResult, type GoogleAccessTokenClient, GoogleRichResultAssessment, GoogleRichResultAssessmentSelection, GoogleRichResultAssessmentStatus, GscRow, HttpProfile, INDEXNOW_ENDPOINT, INDEXNOW_KEYS_SECRET, INDEXNOW_KEY_ENV, INDEXNOW_MAX_URLS, INDEX_WATCH_ATTEMPT_RETENTION, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, IndexCoverageBoundedSection, IndexCoverageCandidateItem, IndexCoverageControlReason, IndexCoverageControlledItem, IndexCoverageCrawlInput, IndexCoverageInput, IndexCoverageInventoryItem, IndexCoveragePlan, IndexCoveragePlanInput, IndexCoverageReport, IndexCoverageReportDependencies, IndexCoverageReportInput, IndexCoverageSearchConsoleInput, IndexCoverageSearchVisibilityItem, IndexCoverageSignalsReport, IndexCoverageSitemapInput, IndexCoverageSourceCompleteness, IndexCoverageSourceEvidence, IndexCoverageSourceMembership, IndexCoverageTemplateReview, IndexMonitorPropertyRun, IndexMonitorReport, IndexNowKey, IndexNowKeySource, IndexNowSubmission, IndexPlanProperty, IndexPlanSuggestion, IndexPropertyUrlAllocation, IndexWatchChange, IndexWatchChangeKind, IndexWatchDependencies, IndexWatchIssueCode, IndexWatchItem, IndexWatchPrevious, IndexWatchReport, IndexWatchRow, IndexWatchStore, type InternalLinkCandidate, type InternalLinkMatchKind, type InternalLinkOpportunity, type InternalLinkQueryMatch, InternalLinksAnalysis, InternalLinksAnalysisInput, InternalLinksDependencies, InternalLinksInput, type InternalLinksReport, type InternalLinksSelection, type InternalLinksWarning, type JavaScriptRenderingInput, type JavaScriptRenderingMode, JsonFileStorageAdapter, KeywordDataProvider, KeywordOverview, KeywordRow, LINK_RECOVER_RUN_RETENTION, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LatestCrawlSummaryRow, LighthouseFailureCode, LinkEvidenceProvenance, LinkEvidenceProvider, LinkEvidenceRow, LinkRecoverItem, LinkRecoverReport, LinkRecoverSummary, LinkTargetCount, LlmsAuditIssue, LlmsAuditReport, type LlmsTxtLinkObservation, LocalCredentialsProvider, LogPruneResult, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, type MarkdownAlternateObservation, type MarkdownQualityObservation, MeasureChangeDependencies, MetricDelta, MonitoringStatusCheck, MonitoringStatusReport, NarrativeSection, type OAuthClientConfig, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, OkfBundle, OkfExplainReport, OkfFile, OkfValidationIssue, OkfValidationReport, OpportunityBenchmarkRow, PageFetchDiagnostics, PageFetchResult, type PageOpportunityAnalysis, type PageOpportunityAnalysisInput, type PageOpportunityBenchmark, PageOpportunityInput, type PageOpportunityItem, PageOpportunityReport, type PageOpportunitySelection, type PageOpportunityType, type PageOpportunityVerification, type PageRenderer, PageSearchMetrics, PageTopQuery, PartialDiagnosisReason, PerformanceAuditReport, PerformanceFieldData, PerformanceFieldMetric, PerformanceMetric, PerformanceRating, PositionBenchmark, Presentation, PresentationChart, PresentationScalar, PresentationTable, PresentationTableColumn, PriorityQueueItem, ProgressReporter, ProviderOpts, ProviderResult, ProviderSecret, ProviderSecretSource, PseoAuditInput, type PseoAuditReport, type PseoAuditTemplate, type PseoCrawlSample, type PseoCrawlTechnicalStatus, PseoDependencies, type PseoEntityFit, type PseoIndexStatus, type PseoInspectionSample, type PseoPageRow, type PseoQueryCoverage, type PseoQueryPageRow, PseoTemplateCluster, type PseoTemplateMetrics, PseoTemplateShape, QueryCluster, type QueryClusterPage, type QueryClusterRow, QueryContentClassification, QueryContentCoverage, QueryContentSignal, QueryFieldCoverage, type QuickWinAnalysis, type QuickWinGroup, type QuickWinItem, type QuickWinSelection, type QuickWinTemplateRecommendation, QuickWinsDependencies, QuickWinsInput, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, RawLinkEvidenceRow, ReadinessCheck, ReadinessSection, ReadinessStatus, Recommendation, RedirectTraceIssue, RedirectTraceReport, RedirectTraceStep, RenderingDocumentDifference, RenderingDocumentField, RenderingDocumentSnapshot, ReportHtmlInput, ReportHtmlSection, ReportHtmlView, ReportNarrative, ResolveTechnicalBaselineInput, ResponseSizeLimitError, RobotsDirective, RuleCategory, RuleId, RuleInfo, RuleRecommendation, RuleSeverity, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, ScorecardBand, ScorecardCheck, ScorecardCheckId, ScorecardObservation, ScorecardStatus, SearchAnalyticsRequest, SearchDateWindow, SearchPageBatch, SearchStatusIncident, SearchUpdate, type SecondPageAnalysis, SecondPageDependencies, SecondPageInput, type SecondPageItem, type SecondPageQuery, type SecondPageRecommendation, type SecondPageReport, type SecondPageSelection, type SegmentDimension, SegmentImpactDependencies, SegmentImpactInput, type SegmentImpactItem, type SegmentImpactReport, type SegmentImpactSelection, type SegmentPeriodEvidence, type SegmentRange, SemrushProvider, SeoChange, SeoCliPathOptions, SeoCliPaths, SeoError, SeoErrorCode, SeoToAiQueryReport, SerpProvider, ServerLogEvidence, ServerLogFormat, ServerLogRecord, ServiceAccountAccessTokenClient, ServiceAccountConfig, ServiceAccountStatus, SessionLedger, SitemapDocument, SitemapFetchResult, SitemapInvalidLoc, SitemapLastmodObservation, SkippedDiagnosisSection, SnippetControlEvidence, StatusBreakdown, StorageAdapter, StoredTokens, type StrikingDistanceAnalysis, type StrikingDistanceAnalysisGroup, type StrikingDistanceAnalysisItem, StrikingDistanceDependencies, StrikingDistanceInput, StrikingDistanceItem, StrikingDistanceReport, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_NOTICE, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, TechnicalBaseline, TechnicalBaselineDependencies, TechnicalBaselineStatus, TelemetryAgent, TelemetryDisableReason, TelemetryErrorCategory, TelemetryEvent, TelemetryOptions, TelemetryPayload, TelemetryReport, TelemetryState, TelemetryStatus, TemplateAwareReport, TestMetrics, TitleWidthEstimate, TokenStorageMode, TokenStorageStatus, TopFix, TopFixFilters, TrafficAnomaly, TrafficAnomalyCoverage, TrafficAnomalyReport, type UnmatchedSegment, UpdateConfounder, UpdateCorrelationReport, UrlInspectionRequest, UrlInspectionResult, WorkflowAction, WorkflowReport, WorkflowStep, addStatus, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyticsConnectionsSchema, analyzeAiReferralRows, analyzeBingCrawl, analyzeBingDimensions, analyzeBingTraffic, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, bingAnalysisDefaults, bingWebmasterOverview, bingWebmasterSiteUrl, boundedSitemapInventory, buildOkfBundle, buildPseoAuditReportFromRows, buildTelemetryPayload, cannibalReport, changeMeasurementCsvRows, checkDatabaseReadiness, classifyCommunityIntent, classifyCrawler, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, collectBingLinkEvidence, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareLinkEvidence, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createBingWebmasterClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createIndexNowKey, createIndexNowKeyRecord, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteProviderSecret, deleteTokens, deriveBrandTerms, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, emptyStatusBreakdown, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, expectedCtrForPosition, explainOkfValidation, explainRule, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fetchText, fileSize, finalGscDateRange, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getPreviousRun, getPrivacySnapshot, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleAnalyticsPropertyId, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, importLinkEvidence, importServerLog, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, initializeTelemetry, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isTelemetryCi, isTelemetryReport, isoDate, isoWeek, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, linkEntries, linkEvidenceKey, linkEvidenceReport, linkRecover, linkRecoverRecommendation, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listIndexNowKeys, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, loginWithLoopback, makeRunId, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLinkEvidenceRow, normalizeLoadedCrawlReport, noteCacheWrite, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseCombinedLogLine, parseIndexNowSite, parseJsonLogLine, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, propertyMatchesUrl, providerPreferenceSchema, pruneIndexWatchSnapshots, pruneLogs, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, readBoundedResponseText, readConfig, readOauthClient, readProviderSecret, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, redirectTrace, refreshAuthToken, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, removeIndexNowKey, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderReportHtml, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, resolveIndexNowKey, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, safeError, saveClient, saveCrawlReport, saveIndexNowKey, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, serverLogReport, sessionSourceInListFilter, setClientBingSite, setDefaultClient, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, strikingDistance, submitIndexNow, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, telemetryErrorCategory, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, unavailableSegmentImpactReport, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateIndexNowKey, validateIndexNowKeyRecord, validateOkfFiles, verifyIndexNowKey, verifyQueryContent, workflowPresentation, writeConfig, writeOauthClient, writeProviderSecret, writeTokens, xRobotsDirectives };
+export { AI_REFERRAL_SOURCES, AI_REFERRAL_SOURCES_VERSION, AI_SEARCH_SCORECARD_METHODOLOGY_ID, AI_SEARCH_SCORECARD_METHODOLOGY_VERSION, AUDIT_PAGE_RULE_IDS, AUTOMATIC_BASELINE_SITE_RETENTION, AUTOMATIC_BASELINE_TOTAL_RETENTION, AccessBlockEvidence, AffectedUrl, AffectedUrlFilters, AffectedUrlResult, AffectedUrlSelection, type AgentDiscoveryDataStatus, type AgentEndpointDiscovery, type AgentEndpointObservation, type AgentLinkHeaderEntry, type AgentLinkHeaderObservation, AgentReadinessCheck, AgentReadinessCheckStatus, type AgentReadinessProfile, AgentReadinessReport, AgentReadinessSection, type AgentRepresentationResponse, type AgentSkillObservation, AiReadinessReport, type AiReferralDataSource, type AiReferralMetrics, type AiReferralQueryEvidence, type AiReferralReport, type AiReferralSourceDefinition, AiSearchScorecard, AnalyticsMetricDelta, AnalyticsTestMetrics, type AnalyzeCannibalRowsInput, type AnalyzeDecayInput, type AnalyzeQuickWinsInput, type AnalyzeSecondPageInput, type AnalyzeStrikingDistanceInput, AppConfig, AuditPageDependencies, AuditPageReport, AuthorizedGoogleClient, BING_API_KEY_ENV, BING_API_KEY_SECRET, BROWSER_USER_AGENT, BacklinkProvider, BingCrawlRow, BingDimensionRow, BingLinkCountRow, BingLinkPage, BingRows, BingTrafficRow, BingUrlLinkRow, BingWebmasterClient, BingWebmasterCredentials, BingWebmasterSite, BoundedSecondPageItem, BoundedSitemapInventory, BrandTermCandidate, CANNIBAL_MAXIMUM_DOMINANT_SHARE, CANNIBAL_MINIMUM_PAGE_SHARE, CRAWL_REPORT_STORAGE_VERSION, CRAWL_RUN_RETENTION, CRAWL_SKIP_REASONS, CTR_DEFAULT_LIMIT, CTR_DEFAULT_MIN_IMPRESSIONS, CTR_MAX_LIMIT, CTR_MAX_MIN_IMPRESSIONS, CacheStats, type CannibalAnalysis, CannibalDependencies, type CannibalItem, type CannibalPage, type CannibalReport, CannibalReportInput, type CannibalSelection, type CannibalSuppression, type CannibalSuppressionReason, ChangeMeasurement, ChangeMeasurementAttempt, ChangeRow, ChangeScope, ClientProfile, ClientProfileInput, CollectedLinkEvidence, CommunityIntent, CommunityIntentClassification, CommunityIntentReport, ContentExtractionDiagnostics, ContentExtractor, ContentGroup, ContentGroupDimension, ContentGroupMatchType, ContentGroupRow, ContentOptimizationIntent, ContentOptimizationReport, CoverageField, CrawlAccessSummary, type CrawlAgentDiscovery, CrawlAiBotAccess, CrawlAiResourceSignal, CrawlAiSignals, CrawlAnalyticsDataSource, CrawlConfig, CrawlConfigInput, CrawlDataSourceStatus, CrawlDataSourceWindow, CrawlDiffItem, CrawlDiffRecommendation, CrawlDiffReport, CrawlExternalLinkVerification, CrawlFetchRateConfig, CrawlImplementationQueueInput, CrawlImplementationQueueItem, CrawlImplementationQueueOutput, CrawlIssue, CrawlIssueGroup, CrawlLinkGraph, CrawlMode, CrawlOneResult, CrawlOutputFormat, CrawlPageRow, CrawlPageSnapshot, CrawlReport, CrawlReportDataSources, CrawlReportMeta, CrawlReportSaveOptions, CrawlReportStorageEnvelope, CrawlReportStoreAdapter, CrawlReportSummary, CrawlRequestObservation, CrawlResponseObservation, CrawlRun, CrawlRunRow, CrawlRunStats, CrawlSearchDataSource, type CrawlSiteChecks, type CrawlSiteDependencies, CrawlSitemapDiscovery, CrawlSkipImpact, CrawlSkipReason, CrawlSkipReasonCount, CrawlSkippedUrlsByImpact, CrawlSnapshotDiffReport, CrawlSnapshotIssueChange, CrawlSnapshotPageChange, CrawlStatusEvent, CrawlStatusHandler, CrawlStatusPhase, CrawlStrategy, CrawlerCategory, CrawlerIdentity, CrawlerPathSummary, CrawlerSummary, CredentialsProvider, CreditUsage, CsvFile, CsvRow, CsvValue, type CtrUnderperformer, CtrUnderperformerDependencies, type CtrUnderperformerSelection, DATAFORSEO_CREDENTIAL_SECRET, DATAFORSEO_LOGIN_ENV, DATAFORSEO_PASSWORD_ENV, DEFAULT_PROVIDER_SPEND_LIMITS, type DataForSeoAccountSnapshot, DataForSeoClient, type DataForSeoClientOptions, DataForSeoCredentials, DataForSeoKeywordDiscoveryProvider, DataForSeoKeywordDiscoveryProviderOptions, type DataForSeoKeywordDiscoveryRequest, type DataForSeoKeywordDiscoverySnapshot, DataForSeoKeywordMetricsProvider, DataForSeoKeywordMetricsProviderOptions, type DataForSeoKeywordOverviewRequest, type DataForSeoKeywordOverviewSnapshot, DataForSeoProvider, type DataForSeoSerpRequest, type DataForSeoSerpSnapshot, DataForSeoSerpSnapshotProvider, DataForSeoSerpSnapshotProviderOptions, type DecayAnalysis, type DecayComparison, type DecayDiagnosis, type DecayGroup, type DecayItem, type DecayMetrics, type DecayReport, type DecaySelection, type DecaySignal, DecayingDependencies, DecayingReportInput, DiagnosePropertyDependencies, DiagnosePropertyReport, DiagnosisDataStatus, DiagnosisPriority, DoctorCheck, DueIndexSelection, DueIndexUrl, EffectiveSnippetControl, EntityReadinessCheck, EntityReadinessReport, ExternalLinkCheck, ExternalLinkCheckAttempt, ExternalLinkCheckState, ExtractedLinkLocation, ExtractedPage, FetchPageDependencies, type FetchPageOptions, type FetchRateControls, GSC_FINAL_DATA_LAG_DAYS, GSC_TIME_ZONE, Ga4AccountSummary, Ga4DataStream, Ga4PropertySummary, Ga4ReportRequest, Ga4RunReportResult, Ga4WebStreamCandidate, Ga4WebStreamMatch, GenerateLlmsTxtOptions, GeneratedLlmsTxt, GeoGap, GeoGapFilters, GeoGapResult, type GoogleAccessTokenClient, GoogleRichResultAssessment, GoogleRichResultAssessmentSelection, GoogleRichResultAssessmentStatus, GscRow, HttpProfile, INDEXNOW_ENDPOINT, INDEXNOW_KEYS_SECRET, INDEXNOW_KEY_ENV, INDEXNOW_MAX_URLS, INDEX_WATCH_ATTEMPT_RETENTION, INTERNAL_LINK_LEXICAL_TARGET_LIMIT, INTERNAL_LINK_MATCH_EVIDENCE_LIMIT, IndexCoverageBoundedSection, IndexCoverageCandidateItem, IndexCoverageControlReason, IndexCoverageControlledItem, IndexCoverageCrawlInput, IndexCoverageInput, IndexCoverageInventoryItem, IndexCoveragePlan, IndexCoveragePlanInput, IndexCoverageReport, IndexCoverageReportDependencies, IndexCoverageReportInput, IndexCoverageSearchConsoleInput, IndexCoverageSearchVisibilityItem, IndexCoverageSignalsReport, IndexCoverageSitemapInput, IndexCoverageSourceCompleteness, IndexCoverageSourceEvidence, IndexCoverageSourceMembership, IndexCoverageTemplateReview, IndexMonitorPropertyRun, IndexMonitorReport, IndexNowKey, IndexNowKeySource, IndexNowSubmission, IndexPlanProperty, IndexPlanSuggestion, IndexPropertyUrlAllocation, IndexWatchChange, IndexWatchChangeKind, IndexWatchDependencies, IndexWatchIssueCode, IndexWatchItem, IndexWatchPrevious, IndexWatchReport, IndexWatchRow, IndexWatchStore, type InternalLinkCandidate, type InternalLinkMatchKind, type InternalLinkOpportunity, type InternalLinkQueryMatch, InternalLinksAnalysis, InternalLinksAnalysisInput, InternalLinksDependencies, InternalLinksInput, type InternalLinksReport, type InternalLinksSelection, type InternalLinksWarning, type JavaScriptRenderingInput, type JavaScriptRenderingMode, JsonFileStorageAdapter, KEYWORD_SET_FIELD_LIMITS, KEYWORD_SET_LIMITS, KEYWORD_SET_SCHEMA_SQL, KeywordDataProvider, KeywordDiscoveryProvider, KeywordDiscoveryRequest, KeywordDiscoverySource, KeywordIdea, KeywordIdeaSource, KeywordMetric, KeywordMetricAnalysis, KeywordMetricFinding, KeywordMetricsCostEstimate, KeywordMetricsCostEstimator, KeywordMetricsProvider, KeywordMetricsReport, KeywordMetricsReportDependencies, KeywordMetricsRequest, KeywordMonthlySearch, KeywordOpportunitiesDependencies, KeywordOpportunitiesInput, KeywordOpportunitiesReport, KeywordOpportunityCluster, KeywordOpportunityCombined, KeywordOpportunityDataSourcePrompt, KeywordOpportunityExternal, KeywordOpportunityFinding, KeywordOpportunityFirstParty, KeywordOpportunitySource, KeywordOverview, KeywordResearchAnalysis, KeywordResearchFinding, KeywordResearchReport, KeywordResearchReportDependencies, KeywordRow, KeywordSet, KeywordSetDetail, KeywordSetItem, KeywordSetMutationItem, KeywordSetMutationResult, KeywordSetPageMapping, KeywordSetRefreshDependencies, KeywordSetRefreshReport, type KeywordSetStoreOptions, KeywordTrend, LINK_RECOVER_RUN_RETENTION, LOG_MAX_AGE_MS, LOG_MAX_FILE_BYTES, LOG_MAX_TOTAL_BYTES, LatestCrawlSummaryRow, LighthouseFailureCode, LinkEvidenceProvenance, LinkEvidenceProvider, LinkEvidenceRow, LinkRecoverItem, LinkRecoverReport, LinkRecoverSummary, LinkTargetCount, LlmsAuditIssue, LlmsAuditReport, type LlmsTxtLinkObservation, LocalCredentialsProvider, LogPruneResult, MAX_CRAWL_CONCURRENCY, MAX_CRAWL_DEPTH, MAX_CRAWL_PAGES, MAX_CRAWL_TIMEOUT_MS, type MarkdownAlternateObservation, type MarkdownQualityObservation, MeasureChangeDependencies, MetricDelta, MonitoringStatusCheck, MonitoringStatusReport, NarrativeSection, type OAuthClientConfig, OKF_DEFAULT_CONCEPTS, OKF_MAX_CONCEPTS, OkfBundle, OkfExplainReport, OkfFile, OkfValidationIssue, OkfValidationReport, OpportunityBenchmarkRow, PROVIDER_SPEND_MAX_BYTES, PROVIDER_SPEND_MAX_ROWS, PROVIDER_SPEND_RETENTION_DAYS, PageFetchDiagnostics, PageFetchResult, type PageOpportunityAnalysis, type PageOpportunityAnalysisInput, type PageOpportunityBenchmark, PageOpportunityInput, type PageOpportunityItem, PageOpportunityReport, type PageOpportunitySelection, type PageOpportunityType, type PageOpportunityVerification, type PageRenderer, PageSearchMetrics, PageTopQuery, PartialDiagnosisReason, PerformanceAuditReport, PerformanceFieldData, PerformanceFieldMetric, PerformanceMetric, PerformanceRating, PositionBenchmark, Presentation, PresentationChart, PresentationScalar, PresentationTable, PresentationTableColumn, PriorityQueueItem, ProgressReporter, ProviderAdapter, ProviderCacheEvidence, ProviderCandidate, ProviderCapability, ProviderCapabilitySupport, ProviderCostEvidence, ProviderCoverage, ProviderError, ProviderErrorCode, ProviderEvidence, ProviderFetch, ProviderId, ProviderMarketSupport, ProviderOpts, ProviderRequestContext, ProviderRequestEvidence, ProviderRequestInput, ProviderResolution, ProviderResult, ProviderSecret, ProviderSecretSource, ProviderSpendFinalization, ProviderSpendLimits, ProviderSpendNotice, ProviderSpendReservation, ProviderSpendReservationInput, ProviderSpendState, ProviderSpendSummary, ProviderValue, ProviderWarning, PseoAuditAcquisition, PseoAuditInput, type PseoAuditReport, type PseoAuditTemplate, type PseoCompetitorPattern, type PseoCrawlSample, type PseoCrawlTechnicalStatus, type PseoDataSourceBrief, PseoDependencies, type PseoDiscoveryEvidence, type PseoEntityFit, type PseoExternalAcquisition, type PseoExternalCandidate, type PseoIndexStatus, type PseoInspectionSample, type PseoKnownCost, PseoOpportunitiesDependencies, type PseoOpportunitiesInput, type PseoOpportunitiesReport, type PseoOpportunityCluster, type PseoOpportunityFinding, type PseoOpportunityTemplate, type PseoPageRow, type PseoQueryCoverage, type PseoQueryPageRow, type PseoResearchSeed, type PseoSerpEvidence, type PseoSerpObservation, PseoTemplateCluster, type PseoTemplateMetrics, PseoTemplateShape, QueryCluster, type QueryClusterPage, QueryClusterReport, type QueryClusterRow, QueryClusterSourceRow, QueryContentClassification, QueryContentCoverage, QueryContentSignal, QueryFieldCoverage, type QuickWinAnalysis, type QuickWinGroup, type QuickWinItem, type QuickWinSelection, type QuickWinTemplateRecommendation, QuickWinsDependencies, QuickWinsInput, QuickWinsSection, REPORT_BASELINE_MAX_AGE_MS, REPORT_BASELINE_MAX_DEPTH, REPORT_BASELINE_MAX_PAGES, RawLinkEvidenceRow, ReadinessCheck, ReadinessSection, ReadinessStatus, Recommendation, RedirectTraceIssue, RedirectTraceReport, RedirectTraceStep, RenderingDocumentDifference, RenderingDocumentField, RenderingDocumentSnapshot, ReportHtmlInput, ReportHtmlSection, ReportHtmlView, ReportNarrative, ResolveTechnicalBaselineInput, ResponseSizeLimitError, RobotsDirective, RuleCategory, RuleId, RuleInfo, RuleRecommendation, RuleSeverity, SCORECARD_CHECK_WEIGHTS, SCORECARD_STATUS_CREDIT, SEO_CRAWLER_IDENTITY, SEO_CRAWLER_TOKEN, SEO_CRAWLER_USER_AGENT, SEO_VERSION, SERP_TITLE_REFERENCE_WIDTH_PX, SERP_TITLE_WIDTH_PROFILE, SavedKeywordMetric, SavedKeywordSetReport, ScorecardBand, ScorecardCheck, ScorecardCheckId, ScorecardObservation, ScorecardStatus, SearchAnalyticsRequest, SearchDateWindow, SearchMarket, SearchPageBatch, SearchStatusIncident, SearchUpdate, type SecondPageAnalysis, SecondPageDependencies, SecondPageInput, type SecondPageItem, type SecondPageQuery, type SecondPageRecommendation, type SecondPageReport, SecondPageSection, type SecondPageSelection, type SegmentDimension, SegmentImpactDependencies, SegmentImpactInput, type SegmentImpactItem, type SegmentImpactReport, type SegmentImpactSelection, type SegmentPeriodEvidence, type SegmentRange, SemrushProvider, SeoChange, SeoCliPathOptions, SeoCliPaths, SeoError, SeoErrorCode, SeoToAiQueryReport, SerpDomainSummary, SerpOrganicResult, SerpProvider, SerpResultFinding, SerpResultsReport, SerpResultsReportDependencies, SerpSnapshot, SerpSnapshotProvider, SerpSnapshotRequest, ServerLogEvidence, ServerLogFormat, ServerLogRecord, ServiceAccountAccessTokenClient, ServiceAccountConfig, ServiceAccountStatus, SessionLedger, SitemapDocument, SitemapFetchResult, SitemapInvalidLoc, SitemapLastmodObservation, SkippedDiagnosisSection, SnippetControlEvidence, StatusBreakdown, StorageAdapter, StoredDataForSeoCredentials, StoredTokens, type StrikingDistanceAnalysis, type StrikingDistanceAnalysisGroup, type StrikingDistanceAnalysisItem, StrikingDistanceDependencies, StrikingDistanceInput, StrikingDistanceItem, StrikingDistanceReport, StrikingDistanceSection, TELEMETRY_AGENTS, TELEMETRY_ENDPOINT, TELEMETRY_ERROR_CATEGORIES, TELEMETRY_EVENTS, TELEMETRY_NOTICE, TELEMETRY_REPORTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_TIMEOUT_MS, TechnicalBaseline, TechnicalBaselineDependencies, TechnicalBaselineStatus, TelemetryAgent, TelemetryDisableReason, TelemetryErrorCategory, TelemetryEvent, TelemetryOptions, TelemetryPayload, TelemetryReport, TelemetryState, TelemetryStatus, TemplateAwareReport, TestMetrics, TitleWidthEstimate, TokenStorageMode, TokenStorageStatus, TopFix, TopFixFilters, TrafficAnomaly, TrafficAnomalyCoverage, TrafficAnomalyReport, type UnmatchedSegment, UpdateConfounder, UpdateCorrelationReport, UrlInspectionRequest, UrlInspectionResult, WorkflowAction, WorkflowReport, WorkflowStep, acquirePseoAuditEvidence, addKeywordsToSet, addStatus, affectedUrls, agentReadiness, aiPromptsForQuery, aiReadiness, aiReferralSourceForValue, aiReferralsReport, aiSearchScorecard, allocateIndexUrlsToProperties, analyticsConnectionsSchema, analyzeAiReferralRows, analyzeBingCrawl, analyzeBingDimensions, analyzeBingTraffic, analyzeCannibalRows, analyzeCtrUnderperformersFromRows, analyzeDecay, analyzeIndexCoverageSignals, analyzeInternalLinksFromRows, analyzeKeywordTrend, analyzePageOpportunitiesFromRows, analyzeQueryClustersFromRows, analyzeQuickWinsFromRows, analyzeSecondPageRows, analyzeSegmentRows, analyzeStrikingDistanceRows, analyzeTrafficAnomalyRows, assertCrawlConfigLimits, assertUrlMatchesGscProperty, attachCrawlRecommendations, auditCrawlPages, auditCrawlRequests, auditLlmsTxt, auditPage, authStatus, bingAnalysisDefaults, bingWebmasterOverview, bingWebmasterSiteUrl, boundedSitemapInventory, buildOkfBundle, buildPseoAuditFromAcquisition, buildPseoAuditReportFromRows, buildQueryClusterReportFromRows, buildTelemetryPayload, cannibalReport, changeMeasurementCsvRows, checkDatabaseReadiness, classifyCommunityIntent, classifyCrawler, clearCache, clientProfileSchema, clusterPseoTemplates, clusterQueryRows, collectAgentDiscovery, collectBingLinkEvidence, combineRobotsValues, communityIntentReport, compareCrawlPages, compareCrawlReports, compareLinkEvidence, compareSegmentRows, configSchema, contentCoverageRecommendation, contentCoverageType, contentOptimizationFromPageOpportunities, contentOptimizationReport, countLabel, crawlConfigHash, crawlConfigSchema, crawlDefinitionId, crawlDiff, crawlFixToQueueItem, crawlImplementationQueueWorkflow, crawlIssueGroupSchema, crawlIssueSchema, crawlOne, crawlPageSnapshotSchema, crawlReportSchema, crawlReportStore, crawlReportSummarySchema, crawlRequestObservationSchema, crawlRunId, crawlSite, crawlSkipImpact, crawlSkipReasonCountsFromRecord, crawlStatusOnly, crawlTopFixSchema, crawlerJsonSchemas, crawlerRuleCategorySchema, crawlerRuleIdSchema, crawlerRuleInfoSchema, crawlerRuleRecommendationSchema, crawlerRuleSeveritySchema, crawlerSchemas, createAuthorizedClient, createBingWebmasterClient, createContentGroup, createCrawlReport, createCtrBenchmarkContext, createGoogleAccessTokenClient, createIndexNowKey, createIndexNowKeyRecord, createKeywordSet, createLogger, createPageRenderer, ctrUnderperformersReport, decayClusterDrafts, decayComparisonRange, decayingReport, deleteChange, deleteClient, deleteContentGroup, deleteCrawlReport, deleteDataForSeoCredentials, deleteKeywordSet, deleteProviderSecret, deleteTokens, deriveBrandTerms, detectBrandTerms, detectTelemetryAgent, diagnoseCsvFiles, diagnoseProperty, diagnosePropertyWorkflow, effectiveRobotsDirectives, effectiveSnippetControl, emptyStatusBreakdown, ensurePrivateDatabaseFiles, ensureSeoCliDirs, entityReadiness, estimateSerpTitleWidth, expectedCtrForPosition, explainOkfValidation, explainRule, fetchCruxFieldData, fetchPage, fetchPageStatus, fetchSearchStatusIncidents, fetchSitemapUrls, fetchText, fileSize, finalGscDateRange, finalizeProviderSpend, findOverlappingSearchUpdates, formatRelativeExpiry, ga4MatchReason, ga4PropertyIdFromName, ga4ReportQualityWarnings, ga4RequestCanUseCache, ga4RowsToObjects, generateLlmsTxt, geoGaps, geoGapsReport, getAuthModeStatus, getCacheStats, getChange, getClient, getClientConfig, getContentGroup, getDb, getKeywordProvider, getKeywordSet, getPreviousRun, getPrivacySnapshot, getProviderSpendLimits, getProviderSpendSummary, getRepeatedLinkRecoverUrls, getRunPages, getSeoCliPaths, getServiceAccountConfig, getServiceAccountStatus, getTelemetryStatus, getTokenStorageStatus, googleAnalyticsPropertyId, groupCrawlIssues, hasMetaRobotsDirective, hasRule, hasXRobotsDirective, hashKey, importLinkEvidence, importServerLog, indexCoveragePlan, indexCoverageSignals, indexMonitor, indexWatch, inferPseoTemplate, inferTemplateMovement, initializeTelemetry, insertCrawlRun, insertLinkRecoverRun, inspectUrl, internalLinksReport, interpretUpdateCorrelation, isBrandQuery, isCompatibleTechnicalBaseline, isCurrentTechnicalBaseline, isEntityEvidenceSchemaType, isSiteIdentitySchemaType, isSkippableReportError, isTelemetryCi, isTelemetryReport, isoDate, isoWeek, keywordDiscoverySourceSchema, keywordMetricsReport, keywordOpportunitiesReport, keywordResearchReport, keywordSetLogicalBytes, latestCrawlReport, latestCrawlSummaries, latestFinalGscDate, latestIndexWatchSummary, latestLinkRecoverSummary, linkEntries, linkEvidenceKey, linkEvidenceReport, linkRecover, linkRecoverRecommendation, listChanges, listClients, listContentGroups, listCrawlReports, listGa4AccountSummaries, listGa4DataStreams, listIndexNowKeys, listKeywordSets, listRules, listSearchUpdates, listSites, loadCrawlReport, localCredentialsProvider, loginWithLoopback, makeRunId, matchGa4WebStreams, measureChange, measureCoverage, metaRobotsDirectives, migrateLegacyMacConfig, missingOAuthClientMessage, missingSharedClientLoginMessage, monitoringStatus, monthlyReport, monthlyReportWorkflow, narrativeCsvFiles, normalizeCrawlConfig, normalizeCrawlSkipReasonCounts, normalizeForCoverage, normalizeHttpUrl, normalizeJavaScriptRenderingMode, normalizeLinkEvidenceRow, normalizeLoadedCrawlReport, normalizeSavedKeyword, noteCacheWrite, observedValue, okfConceptLimit, pageEvidenceRecommendation, pageOpportunitiesReport, parseCombinedLogLine, parseIndexNowSite, parseJsonLogLine, parseOlderThan, parsePseoPath, performanceAudit, performanceReportIsCacheable, planDueIndexUrls, planIndexCoverageFromUrls, plural, propertyMatchesUrl, providerCapabilitySchema, providerIdSchema, providerPreferenceSchema, providerRequestJson, providerRequestText, providerSpendLimitOverridesSchema, pruneIndexWatchSnapshots, pruneLogs, pseoAuditOptions, pseoAuditReport, pseoCsvFiles, pseoIndexStatus, pseoOpportunitiesReport, pseoPresentation, publicHttpFetch, queryClusterReport, queryClusterTokens, queryContentCoverageFromPage, queryContentFieldsFromPage, queryFieldCoverage, queryOpportunityRecommendation, queryPageMetrics, queryPageTopQuery, queryPagesMetrics, queryPagesMetricsBatch, queryPagesTopQueries, queryPagesTopQueriesBatch, querySearchAnalytics, quickWinsCsvRows, quickWinsReport, readBoundedResponseText, readConfig, readDataForSeoCredentials, readOauthClient, readProviderSecret, readTokens, recommendCrawlDiffItem, recommendationForRule, recordChange, redirectTrace, refreshAuthToken, refreshKeywordSet, refreshPrioritiesCsvFiles, refreshPrioritiesWorkflow, removeIndexNowKey, removeKeywordsFromSet, renderCrawlCsv, renderCrawlHtml, renderCrawlJunit, renderCrawlMarkdownTickets, renderCrawlPagesCsv, renderCrawlPretty, renderCsv, renderPresentationTablesMarkdown, renderPseoMarkdown, renderReportHtml, renderWorkflowMarkdown, reportNarrative, reportPresentation, requestHeaders, reserveProviderSpend, resolveIndexNowKey, resolveProvider, resolveSegmentRanges, resolveSeoCliPaths, resolveTechnicalBaseline, reviewObservations, roundedPosition, runDoctor, runGa4Report, safeError, saveClient, saveCrawlReport, saveIndexNowKey, savedKeywordSetReport, searchMarketSchema, secondPage, segmentComparisonRange, segmentImpact, segmentRangeDays, selectAffectedUrls, selectDueIndexUrls, seoErrorEnvelope, seoToAiQueryReport, serpResultsReport, serverLogReport, sessionSourceInListFilter, setClientBingSite, setDefaultClient, setKeywordSetRefreshTime, setProviderSpendLimits, setTelemetryEnabled, setTokenStorageMode, shiftIsoDate, shouldExcludeBrandQuery, siteSchema, sqliteCrawlReportStore, strikingDistance, submitIndexNow, summarizeCrawlReport, pageTechnicalSignals as technicalPageSignals, technicalWatchWorkflow, telemetryErrorCategory, templateForUrl, toSeoError, tokenSchema, topCrawlRecommendations, topFixes, trackTelemetryReportComplete, trackTelemetryReportFailed, trackTelemetryReportStart, trackTelemetrySetupComplete, trafficAnomaly, unavailableSegmentImpactReport, unavailableValue, unicodeTokens, updateCorrelation, updatePostmortemCsvFiles, updatePostmortemWorkflow, validateIndexNowKey, validateIndexNowKeyRecord, validateOkfFiles, verifyIndexNowKey, verifyQueryContent, workflowPresentation, writeConfig, writeDataForSeoCredentials, writeOauthClient, writeProviderSecret, writeTokens, xRobotsDirectives };
 //# sourceMappingURL=index.d.ts.map