@canonry/canonry 7.67.0 → 7.68.0

package/dist/{chunk-KJLICF53.js → chunk-LABVR6K7.js}

@@ -1,10 +1,10 @@
 import {
   registeredProviderNames
-} from "./chunk-NHHZQWMI.js";
+} from "./chunk-XMXYUP7X.js";
 import {
   configExists,
   loadConfigRaw
-} from "./chunk-UNCOK6DA.js";
+} from "./chunk-MVRPFLEL.js";
 
 // src/setup-state.ts
 import fs from "fs";
@@ -28,7 +28,7 @@ async function buildSetupState() {
   }
   if (dbPath && fs.existsSync(dbPath)) {
     try {
-      const { createClient, projects, queries: queriesTable } = await import("./src-6IHGEMT2.js");
+      const { createClient, projects, queries: queriesTable } = await import("./src-VUD6WO5N.js");
       const db = createClient(dbPath);
       project_count = db.select({ id: projects.id }).from(projects).all().length;
       const firstQuery = db.select({ id: queriesTable.id }).from(queriesTable).limit(1).all();
@@ -47,7 +47,7 @@ function queueServeHandoff() {
 async function runPendingServeHandoff(format) {
   if (!pendingServeHandoff) return;
   pendingServeHandoff = false;
-  const { serveCommand } = await import("./serve-6JYPUU24.js");
+  const { serveCommand } = await import("./serve-3BSLRICO.js");
   await serveCommand(format);
 }
 

package/dist/{chunk-YP743QX5.js → chunk-LTMQ4MHF.js}

@@ -1,6 +1,6 @@
 import {
   cloudflareQueueNameSchema
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/cloudflare-traffic-config.ts
 function unsupportedDeliveryMode(deliveryMode) {

package/dist/{chunk-UNCOK6DA.js → chunk-MVRPFLEL.js}

@@ -20,7 +20,7 @@ import {
   resolveProviderModel,
   schedulableRunKindSchema,
   sentimentEvaluatorProviderSchema
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // ../config/src/index.ts
 import { z as z4 } from "zod";

package/dist/{chunk-LU3M54IY.js → chunk-PAVSKSKA.js}

@@ -23,7 +23,7 @@ import {
   measurementDraftUpsertGroupRequestSchema,
   measurementDraftUpsertMarketRequestSchema,
   measurementDraftUpsertTargetRequestSchema
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/measurement-draft-actions.ts
 import { z } from "zod";

package/dist/{chunk-IEBMODUI.js → chunk-QXCQSRHL.js}

@@ -1,7 +1,7 @@
 import {
   answerServiceAdapters,
   answerServiceDescriptors
-} from "./chunk-XMIKSCAO.js";
+} from "./chunk-ARYBII44.js";
 import {
   AeroLlmUsageFeatures,
   aeroTurnStatus,
@@ -27,14 +27,14 @@ import {
   resolveConfiguredAgentProvider,
   resolveSessionProviderAndModel,
   setAeroSystemPrompt
-} from "./chunk-32BTTG5N.js";
+} from "./chunk-U3EJ5RW7.js";
 import {
   AeroToolProfiles,
   AeroToolScopes,
   buildAeroStateTools,
   isAeroToolProfile,
   truncateToolResult
-} from "./chunk-XIA6NWIF.js";
+} from "./chunk-W7PA35VJ.js";
 import {
   getGoogleAuthConfig,
   getGoogleConnection,
@@ -53,7 +53,7 @@ import {
   removeCloudflareTrafficConnection,
   removeCloudflareTrafficConnectionBySourceId,
   upsertCloudflareTrafficConnection
-} from "./chunk-YP743QX5.js";
+} from "./chunk-LTMQ4MHF.js";
 import {
   claudeAdapter,
   embedQueries,
@@ -64,7 +64,7 @@ import {
   openaiAdapter,
   openrouterAdapter,
   perplexityAdapter
-} from "./chunk-5DMESZDF.js";
+} from "./chunk-IVBJEVHS.js";
 import {
   classifyUsageSurface,
   createApiUsageTelemetry,
@@ -76,7 +76,7 @@ import {
   startOutcomeTimer,
   trackFeatureCompleted,
   trackInstallState
-} from "./chunk-RRS7U6HQ.js";
+} from "./chunk-ZUXFHO4T.js";
 import {
   isLoopbackBindHost
 } from "./chunk-TSENU4GG.js";
@@ -84,7 +84,7 @@ import {
   isApiProviderRegistrable,
   isCdpProviderRegistrable,
   registeredProviderNames
-} from "./chunk-NHHZQWMI.js";
+} from "./chunk-XMXYUP7X.js";
 import {
   checkLatestVersionForServer,
   getOrCreateAnonymousId,
@@ -95,17 +95,17 @@ import {
   recordDashboardEvent,
   setTelemetryPreference,
   trackEvent
-} from "./chunk-ZGUR4AZM.js";
+} from "./chunk-7AXVACK6.js";
 import {
   createCanonryMcpServer
-} from "./chunk-VR4MYSEH.js";
+} from "./chunk-4KMUJOYL.js";
 import {
   CANONRY_MCP_TIERS,
   CANONRY_MCP_TOOLKIT_NAMES
 } from "./chunk-NDTU7FGL.js";
 import {
   ApiClient
-} from "./chunk-XEPEMON2.js";
+} from "./chunk-FDRZQH3Y.js";
 import {
   AGENT_PROVIDERS,
   adapterSupportsBatch,
@@ -136,21 +136,21 @@ import {
   saveConfigPatch,
   sentimentInstallReadiness,
   updateSharedProviderExecutionGate
-} from "./chunk-UNCOK6DA.js";
+} from "./chunk-MVRPFLEL.js";
 import {
   getBundledSkillSnapshots
-} from "./chunk-MLOGEXIO.js";
+} from "./chunk-2D7O5UHJ.js";
 import {
   computeFactorAverages,
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout,
   recordedSharePct
-} from "./chunk-P74TPIWZ.js";
+} from "./chunk-RNA6ZCM6.js";
 import {
   CanonryMcpToolNames,
   canonryMcpTools
-} from "./chunk-37R6GTU7.js";
+} from "./chunk-YIIIYNPW.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -162,11 +162,11 @@ import {
   addLogListener,
   createFastifyLogger,
   createLogger
-} from "./chunk-UHLWNU6I.js";
+} from "./chunk-ZU6X4SN2.js";
 import {
   computeCitedCompetitorDomains,
   determineCitationState
-} from "./chunk-EKSXR7RJ.js";
+} from "./chunk-K2P2XO6P.js";
 import {
   BingApiError,
   CC_CACHE_DIR,
@@ -286,7 +286,7 @@ import {
   webhookResponseReason,
   webhookTargetRefusalReason,
   writeAuditLog
-} from "./chunk-AVISYPUU.js";
+} from "./chunk-6W3ENB2X.js";
 import {
   OperationalLogStore,
   SentimentIdempotencyConflict,
@@ -372,7 +372,7 @@ import {
   siteLivenessState,
   trafficSources,
   usageCounters
-} from "./chunk-6DJN7HCK.js";
+} from "./chunk-ARIYTYOM.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AI_ENGINE_DOMAINS,
@@ -621,7 +621,7 @@ import {
   winnabilityClassLabel,
   withRetry,
   withSkippedProviders
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/google-marketing-runtime.ts
 import crypto2 from "crypto";
@@ -5804,7 +5804,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "bc41644d8fe1f58eb00fd3cf4e6fc224834d7d24" : void 0;
+  const embedded = true ? "4030f8c56ac36f1152e96e1f1d51596dcb592e84" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {

package/dist/{chunk-G6PZEDTH.js → chunk-R42VEDCB.js}

@@ -1,13 +1,13 @@
 import {
   createApiClient
-} from "./chunk-XEPEMON2.js";
+} from "./chunk-FDRZQH3Y.js";
 import {
   emitJsonl
 } from "./chunk-Z7IUAJOF.js";
 import {
   measurementDraftOperationSchema,
   runMeasurementDraftAction
-} from "./chunk-LU3M54IY.js";
+} from "./chunk-PAVSKSKA.js";
 import {
   isMachineFormat,
   systemError
@@ -37,7 +37,7 @@ import {
   unattributedAnswersLabel,
   uncheckedSourcesLabel,
   visibilityReportRequestSchema
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/commands/measurement-plan.ts
 import crypto from "crypto";

package/dist/{chunk-P74TPIWZ.js → chunk-RNA6ZCM6.js}

@@ -5,7 +5,7 @@ import {
   siteCrawlGraphNodes,
   siteCrawlPages,
   siteCrawlSnapshots
-} from "./chunk-6DJN7HCK.js";
+} from "./chunk-ARIYTYOM.js";
 import {
   SITE_CRAWL_GRAPH_MAX_EDGES,
   SITE_CRAWL_GRAPH_MAX_NODES,
@@ -15,7 +15,7 @@ import {
   factorStatusFromDistribution,
   factorStatusFromScore,
   roundPreservingTotal
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/site-audit-factors.ts
 function recordedSharePct(factor) {

package/dist/{chunk-32BTTG5N.js → chunk-U3EJ5RW7.js}

@@ -5,7 +5,7 @@ import {
   isStoredPageReadTool,
   isStoredReadTool,
   truncateToolResult
-} from "./chunk-XIA6NWIF.js";
+} from "./chunk-W7PA35VJ.js";
 import {
   CANONRY_MCP_TOOLKITS
 } from "./chunk-NDTU7FGL.js";
@@ -22,23 +22,24 @@ import {
   resolveApiKeyFor,
   resolveModelForProvider,
   validateAgentProviderRegistry
-} from "./chunk-UNCOK6DA.js";
+} from "./chunk-MVRPFLEL.js";
 import {
   CanonryMcpToolNames,
   canonryMcpTools
-} from "./chunk-37R6GTU7.js";
+} from "./chunk-YIIIYNPW.js";
 import {
   agentToolEvents,
   llmUsageEvents
-} from "./chunk-6DJN7HCK.js";
+} from "./chunk-ARIYTYOM.js";
 import {
   MeasurementPortfolioLists,
+  SeoCapabilities,
   agentTurnLimitsSchema,
   agentVisibilityEvidence,
   describeError,
   validationError,
   visibilityReportRequestSchema
-} from "./chunk-XEGYSZEV.js";
+} from "./chunk-VPZMSV3Q.js";
 
 // src/agent/session.ts
 import fs3 from "fs";
@@ -765,14 +766,19 @@ async function readAeroViewEvidence(options) {
   const base = `/${(options.basePath ?? "").replace(/^\/+|\/+$/g, "")}`.replace(/\/$/, "");
   if (context?.view === "seo") {
     const overview = await client.getSeoOverview(projectName, { profileId: context.seoProfileId, runId: context.seoRunId });
+    const evidence2 = overview.evidenceRun;
+    const marketRankings = evidence2?.capabilities.includes(SeoCapabilities["market-rankings"]) ? await client.getSeoMarketRankingSummary(projectName, { profileId: evidence2.profileId, runId: evidence2.id, regionKey: context.seoRegionKey, marketKey: context.seoMarketKey }) : void 0;
     const search = new URLSearchParams(context.seoProfileId ? { seoProfileId: context.seoProfileId } : {});
     if (context.seoRunId) search.set("seoRunId", context.seoRunId);
+    if (context.seoRegionKey) search.set("seoRegion", context.seoRegionKey);
+    if (context.seoMarketKey) search.set("seoMarket", context.seoMarketKey);
     return {
       context,
       retrievedAt: (/* @__PURE__ */ new Date()).toISOString(),
       source: { label: "Open SEO data", href: `${base}/projects/${encodeURIComponent(projectName)}/seo-data?${search}` },
       overview,
-      interpretation: "Stored third-party SEO estimates. Preserve profile, scope, locale, dataset and collection date. Estimates are not Search Console observations or AI citation and mention coverage. Missing or partial data is not zero. This read does not refresh data."
+      ...marketRankings ? { marketRankings } : {},
+      interpretation: "Stored third-party SEO estimates. Preserve profile, scope, locale, dataset and collection date. Estimates are not Search Console observations or AI citation and mention coverage. Missing or partial data is not zero. This read does not refresh data." + (marketRankings ? " Market rankings are observed Google positions of tracked non-brand queries, counted by rank band for the region or market on screen; a failed or unsearched query has no rank. Read its rows with canonry_seo_market_rankings and the same keys." : "")
     };
   }
   if (context?.view === "site-health") {

package/dist/{chunk-GTPGYFZ4.js → chunk-V6ALEP33.js}

@@ -1,9 +1,9 @@
 import {
   trackIntegrationConnection
-} from "./chunk-RRS7U6HQ.js";
+} from "./chunk-ZUXFHO4T.js";
 import {
   cliRuntimeContext
-} from "./chunk-ZGUR4AZM.js";
+} from "./chunk-7AXVACK6.js";
 
 // src/cli-connection-telemetry.ts
 function trackCliConnection(properties) {

package/dist/{chunk-XEGYSZEV.js → chunk-VPZMSV3Q.js}

@@ -13366,6 +13366,7 @@ var STORED_READ_OPERATIONS = /* @__PURE__ */ new Set([
   "GET /api/v1/projects/{name}/seo/domain-intelligence",
   "GET /api/v1/projects/{name}/seo/ranked-keywords",
   "GET /api/v1/projects/{name}/seo/market-rankings",
+  "GET /api/v1/projects/{name}/seo/market-rankings/summary",
   "GET /api/v1/projects/{name}/gbp/local-post-attempt",
   "GET /api/v1/openapi.json",
   "GET /api/v1/screenshots/{snapshotId}",
@@ -21386,6 +21387,7 @@ var seoMarketRankingContextSchema = z66.object({
   queryText: z66.string(),
   queryClass: queryClassSchema
 }).strict();
+var seoMarketRankingCompetitorSchema = z66.object({ domain: z66.string(), rankOrganic: z66.number().int().positive() }).strict();
 var seoMarketRankingSearchStatusSchema = z66.enum(["completed", "partial", "failed", "cancelled"]);
 var SeoMarketRankingSearchStatuses = seoMarketRankingSearchStatusSchema.enum;
 var seoMarketRankingSchema = seoMarketRankingContextSchema.extend({
@@ -21399,11 +21401,18 @@ var seoMarketRankingSchema = seoMarketRankingContextSchema.extend({
   url: z66.string().nullable(),
   /** Organic results the search checked: the requested depth, less when partial, 0 when it failed or never ran. */
   depth: z66.number().int().nonnegative(),
-  /** Tracked competitors found in the same results, by their best organic position. */
-  competitors: z66.array(z66.object({ domain: z66.string(), rankOrganic: z66.number().int().positive() }).strict()),
+  /** Tracked competitors found in the same results at their best organic position, best first. */
+  competitors: z66.array(seoMarketRankingCompetitorSchema),
   /** Where the results came from; null when the search returned none. */
   provenance: seoProvenanceSchema.nullable()
 }).strict();
+var seoMarketRankingOutcomeSchema = z66.enum(["page-1", "ranks-11-20", "ranks-21-plus", "not-ranked", "partly-checked", "failed", "cancelled"]);
+var SeoMarketRankingOutcomes = seoMarketRankingOutcomeSchema.enum;
+var seoMarketRankingRowSchema = seoMarketRankingSchema.extend({
+  outcome: seoMarketRankingOutcomeSchema,
+  /** A tracked competitor ranks above the target in these results, or ranks while the target is not in them. */
+  rivalAhead: z66.boolean()
+}).strict();
 var seoResultsSchema = z66.object({
   keywordMetrics: z66.array(seoKeywordMetricsSchema),
   domainIntelligence: z66.array(seoDomainIntelligenceSchema),
@@ -21488,11 +21497,57 @@ var seoPageShape = {
 var seoKeywordMetricsListSchema = z66.object({ ...seoPageShape, items: z66.array(seoKeywordMetricsSchema) }).strict();
 var seoDomainIntelligenceListSchema = z66.object({ ...seoPageShape, items: z66.array(seoDomainIntelligenceSchema) }).strict();
 var seoRankedKeywordListSchema = z66.object({ ...seoPageShape, items: z66.array(seoRankedKeywordSchema) }).strict();
+var seoMarketRankingFilterSchema = z66.enum(["needs-work", "page-1", "ranks-11-20", "ranks-21-plus", "not-ranked", "partly-checked", "rival-ahead", "failed", "cancelled"]);
+var SeoMarketRankingFilters = seoMarketRankingFilterSchema.enum;
+var seoMarketRankingSortSchema = z66.enum(["market", "rank", "-rank", "query", "-query"]);
+var SeoMarketRankingSorts = seoMarketRankingSortSchema.enum;
 var seoMarketRankingQuerySchema = seoEvidenceQuerySchema.extend({
+  marketKey: z66.string().min(1).max(200).optional(),
+  regionKey: z66.string().min(1).max(200).optional(),
+  outcome: seoMarketRankingFilterSchema.optional(),
+  /** Case-insensitive text found in the query, its searched text or its market label. */
+  q: z66.string().trim().min(1).max(200).optional(),
+  sort: seoMarketRankingSortSchema.optional()
+}).strict();
+var seoMarketRankingListSchema = z66.object({ ...seoPageShape, items: z66.array(seoMarketRankingRowSchema) }).strict();
+var seoMarketRankingCountsSchema = z66.object({
+  queries: z66.number().int().nonnegative(),
+  page1: z66.number().int().nonnegative(),
+  ranks11To20: z66.number().int().nonnegative(),
+  ranks21Plus: z66.number().int().nonnegative(),
+  /** Not in the requested depth: only searches that checked all of it, never a partial one. */
+  notRanked: z66.number().int().nonnegative(),
+  /** A partial search that did not reach the site; ranks past what it checked are unknown. */
+  partlyChecked: z66.number().int().nonnegative(),
+  failed: z66.number().int().nonnegative(),
+  cancelled: z66.number().int().nonnegative(),
+  needsWork: z66.number().int().nonnegative(),
+  /** Rows where a tracked competitor ranks above the target; overlaps the outcome counts. */
+  rivalAhead: z66.number().int().nonnegative()
+}).strict();
+var seoMarketRankingGroupKindSchema = z66.enum(["region", "market"]);
+var SeoMarketRankingGroupKinds = seoMarketRankingGroupKindSchema.enum;
+var seoMarketRankingGroupSchema = z66.object({
+  key: z66.string(),
+  label: z66.string(),
+  kind: seoMarketRankingGroupKindSchema,
+  counts: seoMarketRankingCountsSchema
+}).strict();
+var seoMarketRankingSummaryQuerySchema = seoEvidenceQuerySchema.pick({ profileId: true, runId: true }).extend({
   marketKey: z66.string().min(1).max(200).optional(),
   regionKey: z66.string().min(1).max(200).optional()
 }).strict();
-var seoMarketRankingListSchema = z66.object({ ...seoPageShape, items: z66.array(seoMarketRankingSchema) }).strict();
+var seoMarketRankingSummarySchema = z66.object({
+  runId: z66.string().nullable(),
+  depth: z66.number().int().positive().nullable(),
+  regionKey: z66.string().nullable(),
+  marketKey: z66.string().nullable(),
+  /** Names of the selected region and market; null when none is selected or the refresh has no rows for it. */
+  regionLabel: z66.string().nullable(),
+  marketLabel: z66.string().nullable(),
+  totals: seoMarketRankingCountsSchema,
+  groups: z66.array(seoMarketRankingGroupSchema)
+}).strict();
 var seoOverviewSchema = z66.object({
   status: seoStatusSchema,
   profiles: z66.array(seoProfileSchema),
@@ -21509,6 +21564,7 @@ var seoOverviewSchema = z66.object({
   keywordMetricsCount: z66.number().int().nonnegative(),
   domainIntelligenceCount: z66.number().int().nonnegative(),
   rankedKeywordCount: z66.number().int().nonnegative(),
+  /** Rows the market-rankings read returns for the evidence refresh, searches that failed or never ran included. */
   marketRankingCount: z66.number().int().nonnegative()
 }).strict();
 var seoMicrosSchema = z66.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
@@ -23311,11 +23367,11 @@ function resolveModelPrice(provider, model, overrides) {
   }
   return null;
 }
-function estimateAnswerCostMicros(usage, price, tier) {
+function estimateAnswerCostMicros(usage, price, tier2) {
   const cachedInputRate = price.cachedInputPerMTok ?? DEFAULT_CACHED_INPUT_MULTIPLIER * price.inputPerMTok;
   const cacheWriteRate = price.cacheWritePerMTok ?? DEFAULT_CACHE_WRITE_MULTIPLIER * price.inputPerMTok;
   const tokenMicros = usage.inputTokens * price.inputPerMTok + usage.cachedInputTokens * cachedInputRate + usage.cacheWriteTokens * cacheWriteRate + usage.outputTokens * price.outputPerMTok;
-  const tierMultiplier = tier === PricingTiers.batch ? price.batchTokenDiscount ?? DEFAULT_BATCH_TOKEN_DISCOUNT : 1;
+  const tierMultiplier = tier2 === PricingTiers.batch ? price.batchTokenDiscount ?? DEFAULT_BATCH_TOKEN_DISCOUNT : 1;
   const billedSearchUnits = price.searchUnit === SearchUnits.prompt ? usage.searchCount > 0 ? 1 : 0 : usage.searchCount;
   const searchMicros = billedSearchUnits * (price.searchPer1k ?? 0) * 1e3;
   return Math.round(tokenMicros * tierMultiplier + searchMicros);
@@ -23821,6 +23877,9 @@ var agentViewContextSchema = z82.object({
   view: z82.enum(["project", "visibility", "property", "queries", "site-health", "seo"]),
   seoProfileId: z82.string().trim().min(1).max(128).optional(),
   seoRunId: z82.string().trim().min(1).max(128).optional(),
+  /** The market-rankings region and market the SEO view is narrowed to. */
+  seoRegionKey: z82.string().trim().min(1).max(200).optional(),
+  seoMarketKey: z82.string().trim().min(1).max(200).optional(),
   unavailableReason: z82.string().trim().min(1).max(512).optional(),
   selection: visibilityReportRequestSchema.optional(),
   page: z82.object({
@@ -23830,6 +23889,7 @@ var agentViewContextSchema = z82.object({
 }).strict().superRefine((value, ctx) => {
   if (value.seoProfileId && value.view !== "seo") ctx.addIssue({ code: "custom", message: "SEO profile context requires the SEO view." });
   if (value.seoRunId && value.view !== "seo") ctx.addIssue({ code: "custom", message: "SEO run context requires the SEO view." });
+  if ((value.seoRegionKey || value.seoMarketKey) && value.view !== "seo") ctx.addIssue({ code: "custom", message: "SEO market context requires the SEO view." });
   if (value.page && value.view !== "site-health") ctx.addIssue({ code: "custom", message: "Page context requires Site Health." });
   if (value.selection && !["visibility", "property", "queries"].includes(value.view)) ctx.addIssue({ code: "custom", message: "Measurement selection requires a measurement view." });
 });
@@ -26152,6 +26212,162 @@ var cliCatalogSchema = z92.object({
   }))
 });
 
+// ../contracts/src/seo-market-rankings.ts
+var PAGE_ONE_LAST_RANK = 10;
+var CLOSE_LAST_RANK = 20;
+function bestCompetitorRank(competitors) {
+  return competitors.reduce((best, competitor) => best === null || competitor.rankOrganic < best ? competitor.rankOrganic : best, null);
+}
+function outcomeOf(row) {
+  switch (row.searchStatus) {
+    case SeoMarketRankingSearchStatuses.failed:
+      return SeoMarketRankingOutcomes.failed;
+    case SeoMarketRankingSearchStatuses.cancelled:
+      return SeoMarketRankingOutcomes.cancelled;
+    case SeoMarketRankingSearchStatuses.completed:
+    case SeoMarketRankingSearchStatuses.partial: {
+      const rank = row.rankOrganic;
+      if (rank === null) return row.searchStatus === SeoMarketRankingSearchStatuses.partial ? SeoMarketRankingOutcomes["partly-checked"] : SeoMarketRankingOutcomes["not-ranked"];
+      if (rank <= PAGE_ONE_LAST_RANK) return SeoMarketRankingOutcomes["page-1"];
+      return rank <= CLOSE_LAST_RANK ? SeoMarketRankingOutcomes["ranks-11-20"] : SeoMarketRankingOutcomes["ranks-21-plus"];
+    }
+    default: {
+      const unknown = row.searchStatus;
+      return unknown;
+    }
+  }
+}
+function marketRankingRow(row) {
+  const best = bestCompetitorRank(row.competitors);
+  return { ...row, outcome: outcomeOf(row), rivalAhead: best !== null && (row.rankOrganic === null || best < row.rankOrganic) };
+}
+function matchesMarketRankingFilter(row, filter) {
+  switch (filter) {
+    case SeoMarketRankingFilters["needs-work"]:
+      return row.outcome === SeoMarketRankingOutcomes["ranks-11-20"] || row.outcome === SeoMarketRankingOutcomes["ranks-21-plus"] || row.outcome === SeoMarketRankingOutcomes["not-ranked"] || row.outcome === SeoMarketRankingOutcomes["partly-checked"];
+    case SeoMarketRankingFilters["rival-ahead"]:
+      return row.rivalAhead;
+    case SeoMarketRankingFilters["page-1"]:
+    case SeoMarketRankingFilters["ranks-11-20"]:
+    case SeoMarketRankingFilters["ranks-21-plus"]:
+    case SeoMarketRankingFilters["not-ranked"]:
+    case SeoMarketRankingFilters["partly-checked"]:
+    case SeoMarketRankingFilters.failed:
+    case SeoMarketRankingFilters.cancelled:
+      return row.outcome === filter;
+    default: {
+      const unknown = filter;
+      return unknown;
+    }
+  }
+}
+function matchesMarketRankingText(row, text) {
+  const needle = text.trim().toLowerCase();
+  return !needle || [row.queryText, row.searchText, row.marketLabel].some((value) => value.toLowerCase().includes(needle));
+}
+var byMarket = (a, b) => compareText(a.regionLabel ?? "", b.regionLabel ?? "") || compareText(a.marketLabel, b.marketLabel) || compareText(a.searchText, b.searchText) || compareText(a.queryText, b.queryText);
+var byQuery = (a, b) => compareText(a.queryText.toLowerCase(), b.queryText.toLowerCase()) || byMarket(a, b);
+function tier(row) {
+  switch (row.outcome) {
+    case SeoMarketRankingOutcomes["page-1"]:
+    case SeoMarketRankingOutcomes["ranks-11-20"]:
+    case SeoMarketRankingOutcomes["ranks-21-plus"]:
+      return 0;
+    case SeoMarketRankingOutcomes["partly-checked"]:
+      return 1;
+    case SeoMarketRankingOutcomes["not-ranked"]:
+      return 2;
+    case SeoMarketRankingOutcomes.failed:
+      return 3;
+    case SeoMarketRankingOutcomes.cancelled:
+      return 4;
+    default: {
+      const unknown = row.outcome;
+      return unknown;
+    }
+  }
+}
+function worst(row) {
+  const order = tier(row);
+  return order === 2 ? 0 : order === 0 ? 2 : order;
+}
+var unranked = (row) => tier(row) === 1 || tier(row) === 2;
+var rivalOrder = (a, b) => (bestCompetitorRank(a.competitors) ?? Number.MAX_SAFE_INTEGER) - (bestCompetitorRank(b.competitors) ?? Number.MAX_SAFE_INTEGER);
+function compareMarketRankingsBy(sort) {
+  switch (sort) {
+    case SeoMarketRankingSorts.market:
+      return byMarket;
+    case SeoMarketRankingSorts.query:
+      return byQuery;
+    case SeoMarketRankingSorts["-query"]:
+      return (a, b) => byQuery(b, a);
+    case SeoMarketRankingSorts.rank:
+      return (a, b) => tier(a) - tier(b) || (a.rankOrganic !== null && b.rankOrganic !== null ? a.rankOrganic - b.rankOrganic : 0) || (unranked(a) ? rivalOrder(a, b) : 0) || byQuery(a, b);
+    case SeoMarketRankingSorts["-rank"]:
+      return (a, b) => worst(a) - worst(b) || (a.rankOrganic !== null && b.rankOrganic !== null ? b.rankOrganic - a.rankOrganic : 0) || (unranked(a) ? rivalOrder(a, b) : 0) || byQuery(a, b);
+    default: {
+      const unknown = sort;
+      return unknown;
+    }
+  }
+}
+function marketRankingBands(depth, totals) {
+  const fills = (count3, firstRank) => depth === null || depth >= firstRank || (totals?.[count3] ?? 0) > 0;
+  const bands = [{ count: "page1", filter: SeoMarketRankingFilters["page-1"], label: "Page 1" }];
+  if (fills("ranks11To20", 11)) bands.push({ count: "ranks11To20", filter: SeoMarketRankingFilters["ranks-11-20"], label: "11-20" });
+  if (fills("ranks21Plus", 21)) bands.push({ count: "ranks21Plus", filter: SeoMarketRankingFilters["ranks-21-plus"], label: depth === null || depth <= 21 ? "21 and deeper" : `21-${depth}` });
+  bands.push({ count: "notRanked", filter: SeoMarketRankingFilters["not-ranked"], label: depth === null ? "Not ranked" : `Not in top ${depth}` });
+  return bands;
+}
+function countMarketRankings(rows) {
+  const counts = { queries: rows.length, page1: 0, ranks11To20: 0, ranks21Plus: 0, notRanked: 0, partlyChecked: 0, failed: 0, cancelled: 0, needsWork: 0, rivalAhead: 0 };
+  for (const row of rows) {
+    switch (row.outcome) {
+      case SeoMarketRankingOutcomes["page-1"]:
+        counts.page1++;
+        break;
+      case SeoMarketRankingOutcomes["ranks-11-20"]:
+        counts.ranks11To20++;
+        break;
+      case SeoMarketRankingOutcomes["ranks-21-plus"]:
+        counts.ranks21Plus++;
+        break;
+      case SeoMarketRankingOutcomes["not-ranked"]:
+        counts.notRanked++;
+        break;
+      case SeoMarketRankingOutcomes["partly-checked"]:
+        counts.partlyChecked++;
+        break;
+      case SeoMarketRankingOutcomes.failed:
+        counts.failed++;
+        break;
+      case SeoMarketRankingOutcomes.cancelled:
+        counts.cancelled++;
+        break;
+      default: {
+        const unknown = row.outcome;
+        return unknown;
+      }
+    }
+    if (row.rivalAhead) counts.rivalAhead++;
+  }
+  counts.needsWork = counts.ranks11To20 + counts.ranks21Plus + counts.notRanked + counts.partlyChecked;
+  return counts;
+}
+function groupMarketRankings(rows, scope) {
+  if (scope.marketKey !== void 0) return [];
+  const groups = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const region = scope.regionKey === void 0 && row.regionKey !== null;
+    const key = region ? row.regionKey : row.marketKey;
+    const id2 = `${region ? "region" : "market"}\0${key}`;
+    const group = groups.get(id2) ?? { key, label: region ? row.regionLabel ?? key : row.marketLabel, kind: region ? SeoMarketRankingGroupKinds.region : SeoMarketRankingGroupKinds.market, rows: [] };
+    group.rows.push(row);
+    groups.set(id2, group);
+  }
+  return [...groups.values()].map((group) => ({ key: group.key, label: group.label, kind: group.kind, counts: countMarketRankings(group.rows) })).sort((a, b) => b.counts.ranks11To20 - a.counts.ranks11To20 || b.counts.ranks21Plus - a.counts.ranks21Plus || compareText(a.label, b.label) || compareText(a.key, b.key));
+}
+
 export {
   apiKeyDtoSchema,
   apiKeyListDtoSchema,
@@ -27387,6 +27603,7 @@ export {
   seoQuoteSchema,
   seoSyncInputSchema,
   SeoMarketRankingSearchStatuses,
+  SeoMarketRankingOutcomes,
   emptySeoResults,
   seoSearchTextForQuery,
   seoRunSchema,
@@ -27396,11 +27613,23 @@ export {
   seoKeywordMetricsListSchema,
   seoDomainIntelligenceListSchema,
   seoRankedKeywordListSchema,
+  seoMarketRankingFilterSchema,
+  seoMarketRankingSortSchema,
+  SeoMarketRankingSorts,
   seoMarketRankingQuerySchema,
   seoMarketRankingListSchema,
+  seoMarketRankingSummaryQuerySchema,
+  seoMarketRankingSummarySchema,
   seoOverviewSchema,
   seoOperatorTaskSchema,
   seoReconcileInputSchema,
   seoReconcileResultSchema,
-  SeoAdapterOutcomes
+  SeoAdapterOutcomes,
+  marketRankingRow,
+  matchesMarketRankingFilter,
+  matchesMarketRankingText,
+  compareMarketRankingsBy,
+  marketRankingBands,
+  countMarketRankings,
+  groupMarketRankings
 };