@canonry/canonry 4.117.2 → 4.118.0

package/dist/{chunk-EZME2J2G.js → chunk-KEZWLP4O.js}

@@ -32,6 +32,9 @@ var AppError = class extends Error {
 function notFound(entity, id) {
   return new AppError("NOT_FOUND", `${entity} '${id}' not found`, 404);
 }
+function alreadyExists(entity, id) {
+  return new AppError("ALREADY_EXISTS", `${entity} '${id}' already exists`, 409);
+}
 function validationError(message, details) {
   return new AppError("VALIDATION_ERROR", message, 400, details);
 }
@@ -574,12 +577,17 @@ var auditLogEntrySchema = z3.object({
   entityType: z3.string(),
   entityId: z3.string().nullable().optional(),
   diff: z3.unknown().optional(),
+  /** Originating HTTP client, when available (dashboard browser, CLI, MCP, or external script). */
+  userAgent: z3.string().nullable().optional(),
+  /** Optional caller-supplied correlation key for grouping related mutations. */
+  actorSession: z3.string().nullable().optional(),
   createdAt: z3.string()
 });
 
 // ../contracts/src/scopes.ts
 var READ_ONLY_SCOPE = "read";
 var WILDCARD_SCOPE = "*";
+var ADS_WRITE_SCOPE = "ads.write";
 function grantsWrite(scope) {
   return scope === WILDCARD_SCOPE || scope === "write" || scope.endsWith(".write");
 }
@@ -3621,51 +3629,88 @@ function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
-// ../contracts/src/agent.ts
+// ../contracts/src/intelligence.ts
 import { z as z24 } from "zod";
-var agentProviderIdSchema = z24.enum(["claude", "openai", "gemini", "zai", "deepinfra"]);
-var agentProviderOptionDtoSchema = z24.object({
+var healthSnapshotDtoSchema = z24.object({
+  id: z24.string(),
+  projectId: z24.string(),
+  runId: z24.string().nullable(),
+  overallCitedRate: z24.number(),
+  /**
+   * Share of (query × provider) pairs where the project was MENTIONED in the
+   * answer text. Independent of `overallCitedRate` — never derived from it.
+   * Legacy snapshots persisted before the mention columns existed read back
+   * as 0 (the API coalesces NULL→0).
+   */
+  overallMentionRate: z24.number(),
+  totalPairs: z24.number().int().nonnegative(),
+  citedPairs: z24.number().int().nonnegative(),
+  /** Count of pairs mentioned in the answer text. Legacy rows read back as 0. */
+  mentionedPairs: z24.number().int().nonnegative(),
+  providerBreakdown: z24.record(z24.string(), z24.object({
+    citedRate: z24.number(),
+    mentionRate: z24.number(),
+    cited: z24.number().int().nonnegative(),
+    mentioned: z24.number().int().nonnegative(),
+    total: z24.number().int().nonnegative()
+  })),
+  createdAt: z24.string(),
+  /**
+   * `'ready'` when the snapshot reflects real data; `'no-data'` for the
+   * sentinel returned by `/health/latest` when a project has no health
+   * snapshots yet (newly created, or only failed runs). Numeric fields are
+   * zero and `providerBreakdown` is `{}` in the no-data case.
+   */
+  status: z24.enum(["ready", "no-data"]),
+  /** Reason for `status === 'no-data'`. Absent when `status === 'ready'`. */
+  reason: z24.literal("no-runs-yet").optional()
+});
+
+// ../contracts/src/agent.ts
+import { z as z25 } from "zod";
+var agentProviderIdSchema = z25.enum(["claude", "openai", "gemini", "zai", "deepinfra"]);
+var agentProviderOptionDtoSchema = z25.object({
   /** Stable identifier — what clients pass back as `provider` on the prompt endpoint. */
   id: agentProviderIdSchema,
   /** Human-readable label for UI pickers, e.g. "Anthropic (Claude)". */
-  label: z24.string(),
+  label: z25.string(),
   /** Default model if the caller doesn't pick one. */
-  defaultModel: z24.string(),
+  defaultModel: z25.string(),
   /** Whether a usable API key was found (config.yaml or provider env var). */
-  configured: z24.boolean(),
+  configured: z25.boolean(),
   /**
    * Where the key resolved from, if any. `null` when `configured === false`.
    * Surfaced so the UI can nudge users toward their preferred source of truth.
    */
-  keySource: z24.enum(["config", "env"]).nullable()
+  keySource: z25.enum(["config", "env"]).nullable()
 });
-var agentProvidersResponseDtoSchema = z24.object({
+var agentProvidersResponseDtoSchema = z25.object({
   /**
    * Every provider Aero knows about. `configured === false` entries are
    * included so the UI can render them disabled with an onboarding hint.
    */
-  providers: z24.array(agentProviderOptionDtoSchema).default([]),
+  providers: z25.array(agentProviderOptionDtoSchema).default([]),
   /**
    * Provider Aero auto-picks when no explicit override is passed. Null if
    * nothing is configured (install never exchanged a key).
    */
   defaultProvider: agentProviderIdSchema.nullable()
 });
-var memorySourceSchema = z24.enum(["aero", "user", "compaction"]);
+var memorySourceSchema = z25.enum(["aero", "user", "compaction"]);
 var MemorySources = memorySourceSchema.enum;
 var AGENT_MEMORY_VALUE_MAX_BYTES = 2 * 1024;
 var AGENT_MEMORY_KEY_MAX_LENGTH = 128;
-var agentMemoryUpsertRequestSchema = z24.object({
-  key: z24.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH),
-  value: z24.string().min(1)
+var agentMemoryUpsertRequestSchema = z25.object({
+  key: z25.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH),
+  value: z25.string().min(1)
 });
-var agentMemoryDeleteRequestSchema = z24.object({
-  key: z24.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH)
+var agentMemoryDeleteRequestSchema = z25.object({
+  key: z25.string().min(1).max(AGENT_MEMORY_KEY_MAX_LENGTH)
 });
 
 // ../contracts/src/backlinks.ts
-import { z as z25 } from "zod";
-var backlinkSourceSchema = z25.enum(["commoncrawl", "bing-webmaster"]);
+import { z as z26 } from "zod";
+var backlinkSourceSchema = z26.enum(["commoncrawl", "bing-webmaster"]);
 var BacklinkSources = backlinkSourceSchema.enum;
 function computeBacklinkSummaryMetrics(rows) {
   if (rows.length === 0) {
@@ -3681,181 +3726,181 @@ function computeBacklinkSummaryMetrics(rows) {
     top10HostsShare: share.toFixed(6)
   };
 }
-var ccReleaseSyncStatusSchema = z25.enum(["queued", "downloading", "querying", "ready", "failed"]);
+var ccReleaseSyncStatusSchema = z26.enum(["queued", "downloading", "querying", "ready", "failed"]);
 var CcReleaseSyncStatuses = ccReleaseSyncStatusSchema.enum;
-var ccReleaseSyncDtoSchema = z25.object({
-  id: z25.string(),
-  release: z25.string(),
+var ccReleaseSyncDtoSchema = z26.object({
+  id: z26.string(),
+  release: z26.string(),
   status: ccReleaseSyncStatusSchema,
-  phaseDetail: z25.string().nullable().optional(),
-  vertexPath: z25.string().nullable().optional(),
-  edgesPath: z25.string().nullable().optional(),
-  vertexSha256: z25.string().nullable().optional(),
-  edgesSha256: z25.string().nullable().optional(),
-  vertexBytes: z25.number().int().nullable().optional(),
-  edgesBytes: z25.number().int().nullable().optional(),
-  projectsProcessed: z25.number().int().nullable().optional(),
-  domainsDiscovered: z25.number().int().nullable().optional(),
-  downloadStartedAt: z25.string().nullable().optional(),
-  downloadFinishedAt: z25.string().nullable().optional(),
-  queryStartedAt: z25.string().nullable().optional(),
-  queryFinishedAt: z25.string().nullable().optional(),
-  error: z25.string().nullable().optional(),
-  createdAt: z25.string(),
-  updatedAt: z25.string()
-});
-var backlinkDomainDtoSchema = z25.object({
-  linkingDomain: z25.string(),
+  phaseDetail: z26.string().nullable().optional(),
+  vertexPath: z26.string().nullable().optional(),
+  edgesPath: z26.string().nullable().optional(),
+  vertexSha256: z26.string().nullable().optional(),
+  edgesSha256: z26.string().nullable().optional(),
+  vertexBytes: z26.number().int().nullable().optional(),
+  edgesBytes: z26.number().int().nullable().optional(),
+  projectsProcessed: z26.number().int().nullable().optional(),
+  domainsDiscovered: z26.number().int().nullable().optional(),
+  downloadStartedAt: z26.string().nullable().optional(),
+  downloadFinishedAt: z26.string().nullable().optional(),
+  queryStartedAt: z26.string().nullable().optional(),
+  queryFinishedAt: z26.string().nullable().optional(),
+  error: z26.string().nullable().optional(),
+  createdAt: z26.string(),
+  updatedAt: z26.string()
+});
+var backlinkDomainDtoSchema = z26.object({
+  linkingDomain: z26.string(),
   // For Common Crawl this is the count of distinct hosts within the linking
   // domain; for Bing Webmaster it is the count of distinct linking pages (URLs)
   // from that linking host. Read alongside `source` — the unit differs per source.
-  numHosts: z25.number().int(),
+  numHosts: z26.number().int(),
   source: backlinkSourceSchema
 });
-var backlinkSummaryDtoSchema = z25.object({
-  projectId: z25.string(),
+var backlinkSummaryDtoSchema = z26.object({
+  projectId: z26.string(),
   // Window identifier. Common Crawl uses the release slug
   // (`cc-main-YYYY-<mon>-<mon>-<mon>`); Bing Webmaster uses a synthetic
   // per-sync-day window (`bing-YYYY-MM-DD`).
-  release: z25.string(),
-  targetDomain: z25.string(),
-  totalLinkingDomains: z25.number().int(),
-  totalHosts: z25.number().int(),
-  top10HostsShare: z25.string(),
-  queriedAt: z25.string(),
+  release: z26.string(),
+  targetDomain: z26.string(),
+  totalLinkingDomains: z26.number().int(),
+  totalHosts: z26.number().int(),
+  top10HostsShare: z26.string(),
+  queriedAt: z26.string(),
   source: backlinkSourceSchema,
   // Populated when the response is filtered (e.g. ?excludeCrawlers=1).
   // Counts the rows omitted from totalLinkingDomains/totalHosts so callers
   // can show "N hidden" hints without re-deriving them.
-  excludedLinkingDomains: z25.number().int().optional(),
-  excludedHosts: z25.number().int().optional()
+  excludedLinkingDomains: z26.number().int().optional(),
+  excludedHosts: z26.number().int().optional()
 });
-var backlinkListResponseSchema = z25.object({
+var backlinkListResponseSchema = z26.object({
   // The source this response was filtered to (defaults to commoncrawl when the
   // caller omits `?source`).
   source: backlinkSourceSchema,
   summary: backlinkSummaryDtoSchema.nullable(),
-  total: z25.number().int(),
-  rows: z25.array(backlinkDomainDtoSchema)
-});
-var backlinkHistoryEntrySchema = z25.object({
-  release: z25.string(),
-  totalLinkingDomains: z25.number().int(),
-  totalHosts: z25.number().int(),
-  top10HostsShare: z25.string(),
-  queriedAt: z25.string(),
+  total: z26.number().int(),
+  rows: z26.array(backlinkDomainDtoSchema)
+});
+var backlinkHistoryEntrySchema = z26.object({
+  release: z26.string(),
+  totalLinkingDomains: z26.number().int(),
+  totalHosts: z26.number().int(),
+  top10HostsShare: z26.string(),
+  queriedAt: z26.string(),
   source: backlinkSourceSchema
 });
-var backlinkSourceAvailabilityDtoSchema = z25.object({
+var backlinkSourceAvailabilityDtoSchema = z26.object({
   source: backlinkSourceSchema,
   /**
    * The source is set up for this project:
    *  - commoncrawl: `autoExtractBacklinks` enabled AND a `ready` release sync exists.
    *  - bing-webmaster: a Bing Webmaster connection exists for the project domain.
    */
-  connected: z25.boolean(),
+  connected: z26.boolean(),
   /** Backlink rows exist for this project + source. */
-  hasData: z25.boolean(),
+  hasData: z26.boolean(),
   /** Latest window id with data for this source, null when none. */
-  latestRelease: z25.string().nullable(),
+  latestRelease: z26.string().nullable(),
   /**
    * Linking-domain count in the latest window. Excludes crawler/proxy hosts only
    * when the request sets `?excludeCrawlers=1` (default off, matching the summary
    * and domains endpoints); the dashboard passes it so the switcher pill matches
    * the metric card.
    */
-  totalLinkingDomains: z25.number().int(),
+  totalLinkingDomains: z26.number().int(),
   /** Freshness: `queriedAt` of the latest summary for this source, null when none. */
-  lastSyncedAt: z25.string().nullable()
+  lastSyncedAt: z26.string().nullable()
 });
-var backlinkSourcesResponseSchema = z25.object({
-  projectId: z25.string(),
-  targetDomain: z25.string(),
+var backlinkSourcesResponseSchema = z26.object({
+  projectId: z26.string(),
+  targetDomain: z26.string(),
   /** Availability for every known source, in a stable order. */
-  sources: z25.array(backlinkSourceAvailabilityDtoSchema),
-  anyConnected: z25.boolean(),
-  anyData: z25.boolean()
-});
-var backlinksInstallStatusDtoSchema = z25.object({
-  duckdbInstalled: z25.boolean(),
-  duckdbVersion: z25.string().nullable().optional(),
-  duckdbSpec: z25.string(),
-  pluginDir: z25.string()
-});
-var backlinksInstallResultDtoSchema = z25.object({
-  installed: z25.boolean(),
-  version: z25.string(),
-  path: z25.string(),
-  alreadyPresent: z25.boolean()
-});
-var ccAvailableReleaseSchema = z25.object({
-  release: z25.string(),
-  vertexUrl: z25.string(),
-  edgesUrl: z25.string(),
-  vertexBytes: z25.number().int().nullable(),
-  edgesBytes: z25.number().int().nullable(),
-  lastModified: z25.string().nullable()
-});
-var ccCachedReleaseSchema = z25.object({
-  release: z25.string(),
+  sources: z26.array(backlinkSourceAvailabilityDtoSchema),
+  anyConnected: z26.boolean(),
+  anyData: z26.boolean()
+});
+var backlinksInstallStatusDtoSchema = z26.object({
+  duckdbInstalled: z26.boolean(),
+  duckdbVersion: z26.string().nullable().optional(),
+  duckdbSpec: z26.string(),
+  pluginDir: z26.string()
+});
+var backlinksInstallResultDtoSchema = z26.object({
+  installed: z26.boolean(),
+  version: z26.string(),
+  path: z26.string(),
+  alreadyPresent: z26.boolean()
+});
+var ccAvailableReleaseSchema = z26.object({
+  release: z26.string(),
+  vertexUrl: z26.string(),
+  edgesUrl: z26.string(),
+  vertexBytes: z26.number().int().nullable(),
+  edgesBytes: z26.number().int().nullable(),
+  lastModified: z26.string().nullable()
+});
+var ccCachedReleaseSchema = z26.object({
+  release: z26.string(),
   syncStatus: ccReleaseSyncStatusSchema.nullable(),
-  bytes: z25.number().int(),
-  lastUsedAt: z25.string().nullable()
+  bytes: z26.number().int(),
+  lastUsedAt: z26.string().nullable()
 });
 
 // ../contracts/src/composites.ts
-import { z as z26 } from "zod";
-var metricToneSchema = z26.enum(["positive", "caution", "negative", "neutral"]);
-var scoreSummarySchema = z26.object({
-  label: z26.string(),
-  value: z26.string(),
-  delta: z26.string(),
+import { z as z27 } from "zod";
+var metricToneSchema = z27.enum(["positive", "caution", "negative", "neutral"]);
+var scoreSummarySchema = z27.object({
+  label: z27.string(),
+  value: z27.string(),
+  delta: z27.string(),
   tone: metricToneSchema,
-  description: z26.string(),
-  tooltip: z26.string().optional(),
-  trend: z26.array(z26.number()),
-  progress: z26.number().optional(),
-  providerCoverage: z26.string().optional()
+  description: z27.string(),
+  tooltip: z27.string().optional(),
+  trend: z27.array(z27.number()),
+  progress: z27.number().optional(),
+  providerCoverage: z27.string().optional()
 });
 var mentionShareSchema = scoreSummarySchema.extend({
-  breakdown: z26.object({
-    projectMentionSnapshots: z26.number().int().nonnegative(),
-    competitorMentionSnapshots: z26.number().int().nonnegative(),
-    perCompetitor: z26.array(z26.object({
-      domain: z26.string(),
-      mentionSnapshots: z26.number().int().nonnegative(),
-      shareOfCompetitiveTotal: z26.number()
+  breakdown: z27.object({
+    projectMentionSnapshots: z27.number().int().nonnegative(),
+    competitorMentionSnapshots: z27.number().int().nonnegative(),
+    perCompetitor: z27.array(z27.object({
+      domain: z27.string(),
+      mentionSnapshots: z27.number().int().nonnegative(),
+      shareOfCompetitiveTotal: z27.number()
     })),
-    snapshotsWithAnswerText: z26.number().int().nonnegative(),
-    snapshotsTotal: z26.number().int().nonnegative()
+    snapshotsWithAnswerText: z27.number().int().nonnegative(),
+    snapshotsTotal: z27.number().int().nonnegative()
   })
 });
-var movementSummarySchema = z26.object({
-  gained: z26.number().int().nonnegative(),
-  lost: z26.number().int().nonnegative(),
+var movementSummarySchema = z27.object({
+  gained: z27.number().int().nonnegative(),
+  lost: z27.number().int().nonnegative(),
   tone: metricToneSchema,
-  hasPreviousRun: z26.boolean(),
-  gainedQueries: z26.array(z26.string()).optional(),
-  lostQueries: z26.array(z26.string()).optional()
-});
-var movementComparisonSchema = z26.object({
-  hasPreviousRun: z26.boolean(),
-  comparable: z26.boolean(),
-  querySetChanged: z26.boolean(),
-  previousRunAt: z26.string().nullable(),
-  currentQueryCount: z26.number().int().nonnegative(),
-  previousQueryCount: z26.number().int().nonnegative(),
-  comparableQueryCount: z26.number().int().nonnegative(),
-  addedQueryCount: z26.number().int().nonnegative(),
-  removedQueryCount: z26.number().int().nonnegative(),
-  addedQueries: z26.array(z26.string()),
-  removedQueries: z26.array(z26.string())
-});
-var projectOverviewInsightSchema = z26.object({
-  id: z26.string(),
-  projectId: z26.string(),
-  runId: z26.string().nullable(),
-  type: z26.enum([
+  hasPreviousRun: z27.boolean(),
+  gainedQueries: z27.array(z27.string()).optional(),
+  lostQueries: z27.array(z27.string()).optional()
+});
+var movementComparisonSchema = z27.object({
+  hasPreviousRun: z27.boolean(),
+  comparable: z27.boolean(),
+  querySetChanged: z27.boolean(),
+  previousRunAt: z27.string().nullable(),
+  currentQueryCount: z27.number().int().nonnegative(),
+  previousQueryCount: z27.number().int().nonnegative(),
+  comparableQueryCount: z27.number().int().nonnegative(),
+  addedQueryCount: z27.number().int().nonnegative(),
+  removedQueryCount: z27.number().int().nonnegative(),
+  addedQueries: z27.array(z27.string()),
+  removedQueries: z27.array(z27.string())
+});
+var projectOverviewInsightSchema = z27.object({
+  id: z27.string(),
+  projectId: z27.string(),
+  runId: z27.string().nullable(),
+  type: z27.enum([
     "regression",
     "gain",
     "opportunity",
@@ -3871,70 +3916,70 @@ var projectOverviewInsightSchema = z26.object({
     "gbp-metric-drop",
     "gbp-keyword-drop"
   ]),
-  severity: z26.enum(["critical", "high", "medium", "low"]),
-  title: z26.string(),
-  query: z26.string(),
-  provider: z26.string(),
-  recommendation: z26.object({
-    action: z26.string(),
-    target: z26.string().optional(),
-    reason: z26.string()
+  severity: z27.enum(["critical", "high", "medium", "low"]),
+  title: z27.string(),
+  query: z27.string(),
+  provider: z27.string(),
+  recommendation: z27.object({
+    action: z27.string(),
+    target: z27.string().optional(),
+    reason: z27.string()
   }).optional(),
-  cause: z26.object({
-    cause: z26.string(),
-    competitorDomain: z26.string().optional(),
-    details: z26.string().optional()
+  cause: z27.object({
+    cause: z27.string(),
+    competitorDomain: z27.string().optional(),
+    details: z27.string().optional()
   }).optional(),
-  dismissed: z26.boolean(),
-  createdAt: z26.string()
-});
-var projectOverviewHealthSchema = z26.object({
-  id: z26.string(),
-  projectId: z26.string(),
-  runId: z26.string().nullable(),
-  overallCitedRate: z26.number(),
-  overallMentionRate: z26.number(),
-  totalPairs: z26.number().int().nonnegative(),
-  citedPairs: z26.number().int().nonnegative(),
-  mentionedPairs: z26.number().int().nonnegative(),
-  providerBreakdown: z26.record(z26.string(), z26.object({
-    citedRate: z26.number(),
-    mentionRate: z26.number(),
-    cited: z26.number().int().nonnegative(),
-    mentioned: z26.number().int().nonnegative(),
-    total: z26.number().int().nonnegative()
+  dismissed: z27.boolean(),
+  createdAt: z27.string()
+});
+var projectOverviewHealthSchema = z27.object({
+  id: z27.string(),
+  projectId: z27.string(),
+  runId: z27.string().nullable(),
+  overallCitedRate: z27.number(),
+  overallMentionRate: z27.number(),
+  totalPairs: z27.number().int().nonnegative(),
+  citedPairs: z27.number().int().nonnegative(),
+  mentionedPairs: z27.number().int().nonnegative(),
+  providerBreakdown: z27.record(z27.string(), z27.object({
+    citedRate: z27.number(),
+    mentionRate: z27.number(),
+    cited: z27.number().int().nonnegative(),
+    mentioned: z27.number().int().nonnegative(),
+    total: z27.number().int().nonnegative()
   })),
-  createdAt: z26.string(),
-  status: z26.enum(["ready", "no-data"]),
-  reason: z26.literal("no-runs-yet").optional()
+  createdAt: z27.string(),
+  status: z27.enum(["ready", "no-data"]),
+  reason: z27.literal("no-runs-yet").optional()
 });
-var projectOverviewDtoSchema = z26.object({
+var projectOverviewDtoSchema = z27.object({
   project: projectDtoSchema,
   latestRun: latestProjectRunDtoSchema,
   health: projectOverviewHealthSchema.nullable(),
-  topInsights: z26.array(projectOverviewInsightSchema),
-  queryCounts: z26.object({
-    totalQueries: z26.number().int().nonnegative(),
-    citedQueries: z26.number().int().nonnegative(),
-    notCitedQueries: z26.number().int().nonnegative(),
-    citedRate: z26.number(),
-    mentionedQueries: z26.number().int().nonnegative(),
-    notMentionedQueries: z26.number().int().nonnegative(),
-    mentionRate: z26.number()
+  topInsights: z27.array(projectOverviewInsightSchema),
+  queryCounts: z27.object({
+    totalQueries: z27.number().int().nonnegative(),
+    citedQueries: z27.number().int().nonnegative(),
+    notCitedQueries: z27.number().int().nonnegative(),
+    citedRate: z27.number(),
+    mentionedQueries: z27.number().int().nonnegative(),
+    notMentionedQueries: z27.number().int().nonnegative(),
+    mentionRate: z27.number()
   }),
-  providers: z26.array(z26.object({
-    provider: z26.string(),
-    citedRate: z26.number(),
-    cited: z26.number().int().nonnegative(),
-    total: z26.number().int().nonnegative()
+  providers: z27.array(z27.object({
+    provider: z27.string(),
+    citedRate: z27.number(),
+    cited: z27.number().int().nonnegative(),
+    total: z27.number().int().nonnegative()
   })),
-  transitions: z26.object({
-    since: z26.string().nullable(),
-    gained: z26.number().int().nonnegative(),
-    lost: z26.number().int().nonnegative(),
-    emerging: z26.number().int().nonnegative()
+  transitions: z27.object({
+    since: z27.string().nullable(),
+    gained: z27.number().int().nonnegative(),
+    lost: z27.number().int().nonnegative(),
+    emerging: z27.number().int().nonnegative()
   }),
-  scores: z26.object({
+  scores: z27.object({
     mention: scoreSummarySchema,
     visibility: scoreSummarySchema,
     mentionShare: mentionShareSchema,
@@ -3948,72 +3993,72 @@ var projectOverviewDtoSchema = z26.object({
   citationMovement: movementSummarySchema,
   mentionMovement: movementSummarySchema,
   movementComparison: movementComparisonSchema,
-  competitors: z26.array(z26.object({
-    id: z26.string(),
-    domain: z26.string(),
-    citationCount: z26.number().int().nonnegative(),
-    totalQueries: z26.number().int().nonnegative(),
-    pressureLabel: z26.enum(["None", "Low", "Moderate", "High"]),
-    citedQueries: z26.array(z26.string())
+  competitors: z27.array(z27.object({
+    id: z27.string(),
+    domain: z27.string(),
+    citationCount: z27.number().int().nonnegative(),
+    totalQueries: z27.number().int().nonnegative(),
+    pressureLabel: z27.enum(["None", "Low", "Moderate", "High"]),
+    citedQueries: z27.array(z27.string())
   })),
-  providerScores: z26.array(z26.object({
-    provider: z26.string(),
-    model: z26.string().nullable(),
-    score: z26.number(),
-    cited: z26.number().int().nonnegative(),
-    total: z26.number().int().nonnegative(),
-    trend: z26.array(z26.number()).optional()
+  providerScores: z27.array(z27.object({
+    provider: z27.string(),
+    model: z27.string().nullable(),
+    score: z27.number(),
+    cited: z27.number().int().nonnegative(),
+    total: z27.number().int().nonnegative(),
+    trend: z27.array(z27.number()).optional()
   })),
-  attentionItems: z26.array(z26.object({
-    id: z26.string(),
+  attentionItems: z27.array(z27.object({
+    id: z27.string(),
     tone: metricToneSchema,
-    title: z26.string(),
-    detail: z26.string(),
-    actionLabel: z26.string(),
-    href: z26.string()
+    title: z27.string(),
+    detail: z27.string(),
+    actionLabel: z27.string(),
+    href: z27.string()
   })),
-  runHistory: z26.array(z26.object({
-    runId: z26.string(),
-    createdAt: z26.string(),
-    citedCount: z26.number().int().nonnegative(),
-    totalCount: z26.number().int().nonnegative(),
-    citationRate: z26.number(),
-    mentionedCount: z26.number().int().nonnegative(),
-    mentionRate: z26.number(),
-    status: z26.string()
+  runHistory: z27.array(z27.object({
+    runId: z27.string(),
+    createdAt: z27.string(),
+    citedCount: z27.number().int().nonnegative(),
+    totalCount: z27.number().int().nonnegative(),
+    citationRate: z27.number(),
+    mentionedCount: z27.number().int().nonnegative(),
+    mentionRate: z27.number(),
+    status: z27.string()
   })),
-  suggestedQueries: z26.object({
-    rows: z26.array(z26.object({
-      query: z26.string(),
-      impressions: z26.number(),
-      clicks: z26.number(),
-      avgPosition: z26.number(),
-      reason: z26.string()
+  suggestedQueries: z27.object({
+    rows: z27.array(z27.object({
+      query: z27.string(),
+      impressions: z27.number(),
+      clicks: z27.number(),
+      avgPosition: z27.number(),
+      reason: z27.string()
     })),
-    totalCandidates: z26.number().int().nonnegative(),
-    skippedAlreadyTracked: z26.number().int().nonnegative()
+    totalCandidates: z27.number().int().nonnegative(),
+    skippedAlreadyTracked: z27.number().int().nonnegative()
   }),
-  dateRangeLabel: z26.string(),
-  contextLabel: z26.string()
-});
-var searchHitKindSchema = z26.enum(["snapshot", "insight"]);
-var projectSearchSnapshotHitSchema = z26.object({
-  kind: z26.literal("snapshot"),
-  id: z26.string(),
-  runId: z26.string(),
-  query: z26.string(),
-  provider: z26.string(),
-  model: z26.string().nullable(),
+  dateRangeLabel: z27.string(),
+  contextLabel: z27.string()
+});
+var searchHitKindSchema = z27.enum(["snapshot", "insight"]);
+var projectSearchSnapshotHitSchema = z27.object({
+  kind: z27.literal("snapshot"),
+  id: z27.string(),
+  runId: z27.string(),
+  query: z27.string(),
+  provider: z27.string(),
+  model: z27.string().nullable(),
   citationState: citationStateSchema,
-  matchedField: z26.enum(["answerText", "citedDomains", "searchQueries", "query"]),
-  snippet: z26.string(),
-  createdAt: z26.string()
-});
-var projectSearchInsightHitSchema = z26.object({
-  kind: z26.literal("insight"),
-  id: z26.string(),
-  runId: z26.string().nullable(),
-  type: z26.enum([
+  matchedField: z27.enum(["answerText", "citedDomains", "searchQueries", "query"]),
+  snippet: z27.string(),
+  createdAt: z27.string()
+});
+var projectSearchInsightHitSchema = z27.object({
+  kind: z27.literal("insight"),
+  id: z27.string(),
+  runId: z27.string().nullable(),
+  type: z27.enum([
     "regression",
     "gain",
     "opportunity",
@@ -4030,29 +4075,29 @@ var projectSearchInsightHitSchema = z26.object({
     "gbp-metric-drop",
     "gbp-keyword-drop"
   ]),
-  severity: z26.enum(["critical", "high", "medium", "low"]),
-  title: z26.string(),
-  query: z26.string(),
-  provider: z26.string(),
-  matchedField: z26.enum(["title", "query", "recommendation", "cause"]),
-  snippet: z26.string(),
-  dismissed: z26.boolean(),
-  createdAt: z26.string()
-});
-var projectSearchHitSchema = z26.discriminatedUnion("kind", [
+  severity: z27.enum(["critical", "high", "medium", "low"]),
+  title: z27.string(),
+  query: z27.string(),
+  provider: z27.string(),
+  matchedField: z27.enum(["title", "query", "recommendation", "cause"]),
+  snippet: z27.string(),
+  dismissed: z27.boolean(),
+  createdAt: z27.string()
+});
+var projectSearchHitSchema = z27.discriminatedUnion("kind", [
   projectSearchSnapshotHitSchema,
   projectSearchInsightHitSchema
 ]);
-var projectSearchResponseSchema = z26.object({
-  query: z26.string(),
-  totalHits: z26.number().int().nonnegative(),
-  truncated: z26.boolean(),
-  hits: z26.array(projectSearchHitSchema)
+var projectSearchResponseSchema = z27.object({
+  query: z27.string(),
+  totalHits: z27.number().int().nonnegative(),
+  truncated: z27.boolean(),
+  hits: z27.array(projectSearchHitSchema)
 });
 
 // ../contracts/src/content.ts
-import { z as z27 } from "zod";
-var contentActionSchema = z27.enum(["create", "expand", "refresh", "add-schema"]);
+import { z as z28 } from "zod";
+var contentActionSchema = z28.enum(["create", "expand", "refresh", "add-schema"]);
 var ContentActions = contentActionSchema.enum;
 function contentActionLabel(action) {
   switch (action) {
@@ -4066,9 +4111,9 @@ function contentActionLabel(action) {
       return "Add schema";
   }
 }
-var demandSourceSchema = z27.enum(["gsc", "competitor-evidence", "both"]);
+var demandSourceSchema = z28.enum(["gsc", "competitor-evidence", "both"]);
 var DemandSources = demandSourceSchema.enum;
-var actionConfidenceSchema = z27.enum(["high", "medium", "low"]);
+var actionConfidenceSchema = z28.enum(["high", "medium", "low"]);
 var ActionConfidences = actionConfidenceSchema.enum;
 function actionConfidenceLabel(confidence) {
   switch (confidence) {
@@ -4080,7 +4125,7 @@ function actionConfidenceLabel(confidence) {
       return "Low";
   }
 }
-var pageTypeSchema = z27.enum([
+var pageTypeSchema = z28.enum([
   "blog-post",
   "comparison",
   "listicle",
@@ -4089,7 +4134,7 @@ var pageTypeSchema = z27.enum([
   "glossary"
 ]);
 var PageTypes = pageTypeSchema.enum;
-var contentActionStateSchema = z27.enum([
+var contentActionStateSchema = z28.enum([
   "proposed",
   "briefed",
   "payload-generated",
@@ -4099,7 +4144,7 @@ var contentActionStateSchema = z27.enum([
   "dismissed"
 ]);
 var ContentActionStates = contentActionStateSchema.enum;
-var winnabilityClassSchema = z27.enum(["ownable", "ceded"]);
+var winnabilityClassSchema = z28.enum(["ownable", "ceded"]);
 var WinnabilityClasses = winnabilityClassSchema.enum;
 function winnabilityClassLabel(winnabilityClass) {
   switch (winnabilityClass) {
@@ -4134,40 +4179,40 @@ function deriveWinnabilityClass(citedSurfaceDomains, surfaceClasses, threshold =
     winnability
   };
 }
-var ourBestPageSchema = z27.object({
-  url: z27.string(),
-  gscImpressions: z27.number().nonnegative(),
-  gscClicks: z27.number().nonnegative(),
+var ourBestPageSchema = z28.object({
+  url: z28.string(),
+  gscImpressions: z28.number().nonnegative(),
+  gscClicks: z28.number().nonnegative(),
   // Null when the page came from the inventory fallback (no GSC ranking data).
-  gscAvgPosition: z27.number().nonnegative().nullable(),
-  organicSessions: z27.number().nonnegative()
+  gscAvgPosition: z28.number().nonnegative().nullable(),
+  organicSessions: z28.number().nonnegative()
 });
-var winningCompetitorSchema = z27.object({
-  domain: z27.string(),
-  url: z27.string(),
-  title: z27.string(),
-  citationCount: z27.number().int().nonnegative()
+var winningCompetitorSchema = z28.object({
+  domain: z28.string(),
+  url: z28.string(),
+  title: z28.string(),
+  citationCount: z28.number().int().nonnegative()
 });
-var scoreBreakdownSchema = z27.object({
-  demand: z27.number(),
-  competitor: z27.number(),
-  absence: z27.number(),
-  gapSeverity: z27.number()
+var scoreBreakdownSchema = z28.object({
+  demand: z28.number(),
+  competitor: z28.number(),
+  absence: z28.number(),
+  gapSeverity: z28.number()
 });
-var existingActionRefSchema = z27.object({
-  actionId: z27.string(),
+var existingActionRefSchema = z28.object({
+  actionId: z28.string(),
   state: contentActionStateSchema,
-  lastUpdated: z27.string()
+  lastUpdated: z28.string()
 });
-var contentTargetRowDtoSchema = z27.object({
-  targetRef: z27.string(),
-  query: z27.string(),
+var contentTargetRowDtoSchema = z28.object({
+  targetRef: z28.string(),
+  query: z28.string(),
   action: contentActionSchema,
   ourBestPage: ourBestPageSchema.nullable(),
   winningCompetitor: winningCompetitorSchema.nullable(),
-  score: z27.number(),
+  score: z28.number(),
   scoreBreakdown: scoreBreakdownSchema,
-  drivers: z27.array(z27.string()),
+  drivers: z28.array(z28.string()),
   demandSource: demandSourceSchema,
   actionConfidence: actionConfidenceSchema,
   existingAction: existingActionRefSchema.nullable(),
@@ -4182,134 +4227,134 @@ var contentTargetRowDtoSchema = z27.object({
    * `[0, 1]`. `null` when the gate failed open (no classification coverage for
    * the cited surface) — distinct from a computed `1.0`.
    */
-  winnability: z27.number().min(0).max(1).nullable()
-});
-var contentTargetsResponseDtoSchema = z27.object({
-  targets: z27.array(contentTargetRowDtoSchema),
-  contextMetrics: z27.object({
-    totalAiReferralSessions: z27.number().int().nonnegative(),
-    latestRunId: z27.string(),
-    runTimestamp: z27.string()
+  winnability: z28.number().min(0).max(1).nullable()
+});
+var contentTargetsResponseDtoSchema = z28.object({
+  targets: z28.array(contentTargetRowDtoSchema),
+  contextMetrics: z28.object({
+    totalAiReferralSessions: z28.number().int().nonnegative(),
+    latestRunId: z28.string(),
+    runTimestamp: z28.string()
   })
 });
-var contentTargetDismissalDtoSchema = z27.object({
-  targetRef: z27.string(),
-  addressedUrl: z27.string().nullable(),
-  note: z27.string().nullable(),
-  dismissedAt: z27.string()
+var contentTargetDismissalDtoSchema = z28.object({
+  targetRef: z28.string(),
+  addressedUrl: z28.string().nullable(),
+  note: z28.string().nullable(),
+  dismissedAt: z28.string()
 });
-var contentTargetDismissalsResponseDtoSchema = z27.object({
-  dismissals: z27.array(contentTargetDismissalDtoSchema)
+var contentTargetDismissalsResponseDtoSchema = z28.object({
+  dismissals: z28.array(contentTargetDismissalDtoSchema)
 });
-var contentTargetDismissRequestSchema = z27.object({
-  targetRef: z27.string().min(1),
+var contentTargetDismissRequestSchema = z28.object({
+  targetRef: z28.string().min(1),
   /** URL of the page the user wrote that addresses this recommendation. Stored verbatim for the audit trail; not currently used to suppress the slug-token matcher. */
-  addressedUrl: z27.string().url().optional(),
+  addressedUrl: z28.string().url().optional(),
   /** Free-form note (e.g. "covered in our Q1 content sprint"). 500 char cap is the API surface limit; the DB column is unbounded. */
-  note: z27.string().max(500).optional()
+  note: z28.string().max(500).optional()
 });
-var recommendationExplanationDtoSchema = z27.object({
-  targetRef: z27.string(),
+var recommendationExplanationDtoSchema = z28.object({
+  targetRef: z28.string(),
   /** Version of the prompt template used. Bumping the version invalidates the cache forward without touching the table. */
-  promptVersion: z27.string(),
+  promptVersion: z28.string(),
   /** Provider that produced the explanation (e.g. "claude", "gemini"). */
-  provider: z27.string(),
+  provider: z28.string(),
   /** Model id within that provider (e.g. "claude-sonnet-4-6"). */
-  model: z27.string(),
+  model: z28.string(),
   /** Markdown-formatted rationale + recommended next steps. */
-  responseText: z27.string(),
+  responseText: z28.string(),
   /** Estimated cost in millicents (1/100 of a cent). 0 when unknown. */
-  costMillicents: z27.number().int().nonnegative(),
-  generatedAt: z27.string()
+  costMillicents: z28.number().int().nonnegative(),
+  generatedAt: z28.string()
 });
-var recommendationExplainRequestSchema = z27.object({
+var recommendationExplainRequestSchema = z28.object({
   /**
    * Optional provider override (e.g. "claude" to force Claude even if
    * the project's default is Gemini). Falls through to project default
    * → auto-detect when omitted.
    */
-  provider: z27.string().optional(),
+  provider: z28.string().optional(),
   /**
    * Optional model override within the chosen provider. Falls through to
    * the `analyze`-tier default model when omitted.
    */
-  model: z27.string().optional(),
+  model: z28.string().optional(),
   /**
    * Force a fresh LLM call even if a cached explanation exists for the
    * current prompt version. Use sparingly — defeats the cache.
    */
-  forceRefresh: z27.boolean().optional()
+  forceRefresh: z28.boolean().optional()
 });
-var contentBriefDtoSchema = z27.object({
+var contentBriefDtoSchema = z28.object({
   /** The query the brief is for (echoed from the recommendation). */
-  targetQuery: z27.string().trim().min(1),
+  targetQuery: z28.string().trim().min(1),
   /** Always `ownable` in practice — the gate rejects `ceded` before synthesis. */
   winnabilityClass: winnabilityClassSchema,
   /** The differentiated content angle to take. */
-  angle: z27.string().trim().min(1),
+  angle: z28.string().trim().min(1),
   /** Why this query is winnable, citing the cited-surface signal. */
-  whyWinnable: z27.string().trim().min(1),
+  whyWinnable: z28.string().trim().min(1),
   /** The schema.org type or markup to add or extend. */
-  schemaHookup: z27.string().trim().min(1),
+  schemaHookup: z28.string().trim().min(1),
   /** Why the cited surface is controllable (the ownable-vs-ceded reasoning). */
-  controllableSurfaceRationale: z27.string().trim().min(1)
+  controllableSurfaceRationale: z28.string().trim().min(1)
 });
-var recommendationBriefDtoSchema = z27.object({
-  targetRef: z27.string(),
+var recommendationBriefDtoSchema = z28.object({
+  targetRef: z28.string(),
   /** Version of the brief prompt template; bumping invalidates the cache forward. */
-  promptVersion: z27.string(),
-  provider: z27.string(),
-  model: z27.string(),
+  promptVersion: z28.string(),
+  provider: z28.string(),
+  model: z28.string(),
   brief: contentBriefDtoSchema,
   /** Estimated cost in millicents (1/100 of a cent). 0 when unknown. */
-  costMillicents: z27.number().int().nonnegative(),
-  generatedAt: z27.string()
+  costMillicents: z28.number().int().nonnegative(),
+  generatedAt: z28.string()
 });
-var domainClassificationDtoSchema = z27.object({
-  domain: z27.string(),
+var domainClassificationDtoSchema = z28.object({
+  domain: z28.string(),
   competitorType: discoveryCompetitorTypeSchema,
-  hits: z27.number().int().nonnegative(),
-  updatedAt: z27.string()
-});
-var domainClassificationsResponseDtoSchema = z27.object({
-  classifications: z27.array(domainClassificationDtoSchema)
+  hits: z28.number().int().nonnegative(),
+  updatedAt: z28.string()
 });
-var contentGroundingSourceSchema = z27.object({
-  uri: z27.string(),
-  title: z27.string(),
-  domain: z27.string(),
-  isOurDomain: z27.boolean(),
-  isCompetitor: z27.boolean(),
-  citationCount: z27.number().int().nonnegative(),
-  providers: z27.array(providerNameSchema)
-});
-var contentSourceRowDtoSchema = z27.object({
-  query: z27.string(),
-  groundingSources: z27.array(contentGroundingSourceSchema)
+var domainClassificationsResponseDtoSchema = z28.object({
+  classifications: z28.array(domainClassificationDtoSchema)
 });
-var contentSourcesResponseDtoSchema = z27.object({
-  sources: z27.array(contentSourceRowDtoSchema),
-  latestRunId: z27.string()
-});
-var contentGapRowDtoSchema = z27.object({
-  query: z27.string(),
-  competitorDomains: z27.array(z27.string()),
-  competitorCount: z27.number().int().nonnegative(),
-  missRate: z27.number().min(0).max(1),
-  lastSeenInRunId: z27.string()
-});
-var contentGapsResponseDtoSchema = z27.object({
-  gaps: z27.array(contentGapRowDtoSchema),
-  latestRunId: z27.string()
+var contentGroundingSourceSchema = z28.object({
+  uri: z28.string(),
+  title: z28.string(),
+  domain: z28.string(),
+  isOurDomain: z28.boolean(),
+  isCompetitor: z28.boolean(),
+  citationCount: z28.number().int().nonnegative(),
+  providers: z28.array(providerNameSchema)
+});
+var contentSourceRowDtoSchema = z28.object({
+  query: z28.string(),
+  groundingSources: z28.array(contentGroundingSourceSchema)
+});
+var contentSourcesResponseDtoSchema = z28.object({
+  sources: z28.array(contentSourceRowDtoSchema),
+  latestRunId: z28.string()
+});
+var contentGapRowDtoSchema = z28.object({
+  query: z28.string(),
+  competitorDomains: z28.array(z28.string()),
+  competitorCount: z28.number().int().nonnegative(),
+  missRate: z28.number().min(0).max(1),
+  lastSeenInRunId: z28.string()
+});
+var contentGapsResponseDtoSchema = z28.object({
+  gaps: z28.array(contentGapRowDtoSchema),
+  latestRunId: z28.string()
 });
 
 // ../contracts/src/doctor.ts
-import { z as z28 } from "zod";
-var checkStatusSchema = z28.enum(["ok", "warn", "fail", "skipped"]);
+import { z as z29 } from "zod";
+var checkStatusSchema = z29.enum(["ok", "warn", "fail", "skipped"]);
 var CheckStatuses = checkStatusSchema.enum;
-var checkScopeSchema = z28.enum(["global", "project"]);
+var checkScopeSchema = z29.enum(["global", "project"]);
 var CheckScopes = checkScopeSchema.enum;
-var checkCategorySchema = z28.enum([
+var checkCategorySchema = z29.enum([
   "auth",
   "config",
   "providers",
@@ -4320,31 +4365,31 @@ var checkCategorySchema = z28.enum([
   "agent"
 ]);
 var CheckCategories = checkCategorySchema.enum;
-var checkResultSchema = z28.object({
-  id: z28.string(),
+var checkResultSchema = z29.object({
+  id: z29.string(),
   category: checkCategorySchema,
   scope: checkScopeSchema,
-  title: z28.string(),
+  title: z29.string(),
   status: checkStatusSchema,
-  code: z28.string().describe('Stable machine-readable code (e.g. "google.token.refresh-failed"). Use this for filtering and remediation logic.'),
-  summary: z28.string(),
-  remediation: z28.string().nullable().optional().describe('Operator-facing next step. Null when status is "ok" or no specific remediation applies.'),
-  details: z28.record(z28.string(), z28.unknown()).optional().describe("Structured context \u2014 principal email, redirect URI, missing scopes, etc. Stable per check id."),
-  durationMs: z28.number().int().nonnegative().describe("How long the check took to execute.")
+  code: z29.string().describe('Stable machine-readable code (e.g. "google.token.refresh-failed"). Use this for filtering and remediation logic.'),
+  summary: z29.string(),
+  remediation: z29.string().nullable().optional().describe('Operator-facing next step. Null when status is "ok" or no specific remediation applies.'),
+  details: z29.record(z29.string(), z29.unknown()).optional().describe("Structured context \u2014 principal email, redirect URI, missing scopes, etc. Stable per check id."),
+  durationMs: z29.number().int().nonnegative().describe("How long the check took to execute.")
 });
-var doctorReportSchema = z28.object({
+var doctorReportSchema = z29.object({
   scope: checkScopeSchema,
-  project: z28.string().nullable().describe('Project name when scope is "project", null otherwise.'),
-  generatedAt: z28.string().describe("ISO-8601 timestamp when this doctor run started."),
-  durationMs: z28.number().int().nonnegative(),
-  summary: z28.object({
-    total: z28.number().int().nonnegative(),
-    ok: z28.number().int().nonnegative(),
-    warn: z28.number().int().nonnegative(),
-    fail: z28.number().int().nonnegative(),
-    skipped: z28.number().int().nonnegative()
+  project: z29.string().nullable().describe('Project name when scope is "project", null otherwise.'),
+  generatedAt: z29.string().describe("ISO-8601 timestamp when this doctor run started."),
+  durationMs: z29.number().int().nonnegative(),
+  summary: z29.object({
+    total: z29.number().int().nonnegative(),
+    ok: z29.number().int().nonnegative(),
+    warn: z29.number().int().nonnegative(),
+    fail: z29.number().int().nonnegative(),
+    skipped: z29.number().int().nonnegative()
   }),
-  checks: z28.array(checkResultSchema)
+  checks: z29.array(checkResultSchema)
 });
 function summarizeCheckResults(results) {
   const summary = { total: results.length, ok: 0, warn: 0, fail: 0, skipped: 0 };
@@ -4373,52 +4418,52 @@ function normalizeQueryText(value) {
 }
 
 // ../contracts/src/citations.ts
-import { z as z29 } from "zod";
-var citationCoverageProviderSchema = z29.object({
-  provider: z29.string(),
+import { z as z30 } from "zod";
+var citationCoverageProviderSchema = z30.object({
+  provider: z30.string(),
   citationState: citationStateSchema,
-  cited: z29.boolean(),
-  mentioned: z29.boolean(),
-  runId: z29.string(),
-  runCreatedAt: z29.string()
-});
-var citationCoverageRowSchema = z29.object({
-  queryId: z29.string(),
-  query: z29.string(),
-  providers: z29.array(citationCoverageProviderSchema),
-  citedCount: z29.number().int().nonnegative(),
-  mentionedCount: z29.number().int().nonnegative(),
-  totalProviders: z29.number().int().nonnegative()
-});
-var competitorGapRowSchema = z29.object({
-  queryId: z29.string(),
-  query: z29.string(),
-  provider: z29.string(),
-  citingCompetitors: z29.array(z29.string()),
-  runId: z29.string(),
-  runCreatedAt: z29.string()
-});
-var citationVisibilitySummarySchema = z29.object({
-  providersConfigured: z29.number().int().nonnegative(),
-  providersCiting: z29.number().int().nonnegative(),
-  providersMentioning: z29.number().int().nonnegative(),
-  totalQueries: z29.number().int().nonnegative(),
+  cited: z30.boolean(),
+  mentioned: z30.boolean(),
+  runId: z30.string(),
+  runCreatedAt: z30.string()
+});
+var citationCoverageRowSchema = z30.object({
+  queryId: z30.string(),
+  query: z30.string(),
+  providers: z30.array(citationCoverageProviderSchema),
+  citedCount: z30.number().int().nonnegative(),
+  mentionedCount: z30.number().int().nonnegative(),
+  totalProviders: z30.number().int().nonnegative()
+});
+var competitorGapRowSchema = z30.object({
+  queryId: z30.string(),
+  query: z30.string(),
+  provider: z30.string(),
+  citingCompetitors: z30.array(z30.string()),
+  runId: z30.string(),
+  runCreatedAt: z30.string()
+});
+var citationVisibilitySummarySchema = z30.object({
+  providersConfigured: z30.number().int().nonnegative(),
+  providersCiting: z30.number().int().nonnegative(),
+  providersMentioning: z30.number().int().nonnegative(),
+  totalQueries: z30.number().int().nonnegative(),
   // Cross-tab buckets — each tracked query with at least one snapshot lands
   // in exactly one of these. Queries with zero snapshots are not counted in
   // any bucket; (sum of buckets) ≤ totalQueries.
-  queriesCitedAndMentioned: z29.number().int().nonnegative(),
-  queriesCitedOnly: z29.number().int().nonnegative(),
-  queriesMentionedOnly: z29.number().int().nonnegative(),
-  queriesInvisible: z29.number().int().nonnegative(),
-  latestRunId: z29.string().nullable(),
-  latestRunAt: z29.string().nullable()
-});
-var citationVisibilityResponseSchema = z29.object({
+  queriesCitedAndMentioned: z30.number().int().nonnegative(),
+  queriesCitedOnly: z30.number().int().nonnegative(),
+  queriesMentionedOnly: z30.number().int().nonnegative(),
+  queriesInvisible: z30.number().int().nonnegative(),
+  latestRunId: z30.string().nullable(),
+  latestRunAt: z30.string().nullable()
+});
+var citationVisibilityResponseSchema = z30.object({
   summary: citationVisibilitySummarySchema,
-  byQuery: z29.array(citationCoverageRowSchema),
-  competitorGaps: z29.array(competitorGapRowSchema),
-  status: z29.enum(["ready", "no-data"]),
-  reason: z29.enum(["no-runs-yet", "no-queries"]).optional()
+  byQuery: z30.array(citationCoverageRowSchema),
+  competitorGaps: z30.array(competitorGapRowSchema),
+  status: z30.enum(["ready", "no-data"]),
+  reason: z30.enum(["no-runs-yet", "no-queries"]).optional()
 });
 function emptyCitationVisibility(reason) {
   return {
@@ -4445,10 +4490,10 @@ function citationStateToCited(state) {
 }
 
 // ../contracts/src/report.ts
-import { z as z30 } from "zod";
+import { z as z31 } from "zod";
 var REPORT_PERIOD_OPTIONS = [7, 14, 30, 90];
 var REPORT_DEFAULT_PERIOD_DAYS = 30;
-var reportPeriodSchema = z30.union([z30.literal(7), z30.literal(14), z30.literal(30), z30.literal(90)]).describe("Report window in days (7, 14, 30, or 90). Defaults to 30 when omitted.");
+var reportPeriodSchema = z31.union([z31.literal(7), z31.literal(14), z31.literal(30), z31.literal(90)]).describe("Report window in days (7, 14, 30, or 90). Defaults to 30 when omitted.");
 function isReportPeriodDays(n) {
   return REPORT_PERIOD_OPTIONS.includes(n);
 }
@@ -4463,45 +4508,45 @@ function parseReportPeriodDays(value) {
 function reportComparisonWindowDays(periodDays) {
   return Math.max(1, Math.floor(periodDays / 2));
 }
-var providerLocationTreatmentSchema = z30.enum([
+var providerLocationTreatmentSchema = z31.enum([
   "prompt",
   "request-param",
   "browser-geo",
   "ignored"
 ]);
-var reportMetaLocationSchema = z30.object({
+var reportMetaLocationSchema = z31.object({
   /** Human-readable label as configured on the project (e.g. "michigan"). */
-  label: z30.string(),
+  label: z31.string(),
   /** Resolved city/region/country from the project's `LocationContext`. */
-  city: z30.string(),
-  region: z30.string(),
-  country: z30.string(),
+  city: z31.string(),
+  region: z31.string(),
+  country: z31.string(),
   /**
    * Other locations configured on the project that did NOT power this report.
    * When non-empty, callers should make clear that the report is location-scoped:
    * a separate sweep is needed to see how AI engines respond from each one.
    */
-  otherConfiguredLabels: z30.array(z30.string())
+  otherConfiguredLabels: z31.array(z31.string())
 });
-var reportProviderLocationHandlingSchema = z30.object({
+var reportProviderLocationHandlingSchema = z31.object({
   /** Provider name (matches `query_snapshots.provider`). */
-  provider: z30.string(),
+  provider: z31.string(),
   /** How this provider applied the configured location during this run. */
   treatment: providerLocationTreatmentSchema,
   /** One-sentence explanation suitable for the report. */
-  description: z30.string()
+  description: z31.string()
 });
-var reportMetaSchema = z30.object({
+var reportMetaSchema = z31.object({
   /** ISO timestamp the report was generated (server clock). */
-  generatedAt: z30.string(),
+  generatedAt: z31.string(),
   /** Project the report covers. */
-  project: z30.object({
-    id: z30.string(),
-    name: z30.string(),
-    displayName: z30.string(),
-    canonicalDomain: z30.string(),
-    country: z30.string(),
-    language: z30.string()
+  project: z31.object({
+    id: z31.string(),
+    name: z31.string(),
+    displayName: z31.string(),
+    canonicalDomain: z31.string(),
+    country: z31.string(),
+    language: z31.string()
   }),
   /**
    * The location that powered the latest visibility run, when one was set.
@@ -4516,31 +4561,31 @@ var reportMetaSchema = z30.object({
    * each provider's answer — some providers append it to the prompt, some
    * pass it as a structured request field, and some (CDP) ignore it.
    */
-  providerLocationHandling: z30.array(reportProviderLocationHandlingSchema),
+  providerLocationHandling: z31.array(reportProviderLocationHandlingSchema),
   /** Earliest data point referenced by the report (ISO date). */
-  periodStart: z30.string().nullable(),
+  periodStart: z31.string().nullable(),
   /** Latest data point referenced by the report (ISO date). */
-  periodEnd: z30.string().nullable(),
+  periodEnd: z31.string().nullable(),
   /**
    * The selected report window, in days (one of `REPORT_PERIOD_OPTIONS`).
    * Every time-windowed section scopes to this many days; renderers read it to
    * label the window ("Last 30 days", "(30d)"). Defaults to
    * `REPORT_DEFAULT_PERIOD_DAYS` when no `period` is requested.
    */
-  periodDays: z30.number().int().positive()
+  periodDays: z31.number().int().positive()
 });
-var reportExecutiveSummarySchema = z30.object({
+var reportExecutiveSummarySchema = z31.object({
   /**
    * 0..100 — share of tracked queries that were cited by at least one
    * provider in the latest run. "Cited" means the project's domain appeared
    * in the source list / grounding the AI used to answer. Computed per-query
    * (not per-(query × provider)) so the rate is invariant to provider count.
    */
-  citationRate: z30.number(),
+  citationRate: z31.number(),
   /** Numerator of `citationRate` — distinct tracked queries cited by ≥1 provider in the latest run. */
-  citedQueryCount: z30.number(),
+  citedQueryCount: z31.number(),
   /** Denominator of `citationRate` — total tracked queries. */
-  totalQueryCount: z30.number(),
+  totalQueryCount: z31.number(),
   /**
    * 0..100 — share of tracked queries where the project's brand or domain
    * appeared in at least one provider's answer text in the latest run.
@@ -4548,71 +4593,71 @@ var reportExecutiveSummarySchema = z30.object({
    * the prose without citing your domain in its sources, and vice versa.
    * Same per-query denominator as `citationRate` for consistency.
    */
-  mentionRate: z30.number(),
+  mentionRate: z31.number(),
   /** Numerator of `mentionRate` — distinct tracked queries mentioned in ≥1 provider's answer text. */
-  mentionedQueryCount: z30.number(),
+  mentionedQueryCount: z31.number(),
   /** Compared to the previous run: 'up' | 'down' | 'flat' | 'unknown' (no prior run). */
-  trend: z30.enum(["up", "down", "flat", "unknown"]),
+  trend: z31.enum(["up", "down", "flat", "unknown"]),
   /** Total tracked queries. */
-  queryCount: z30.number(),
+  queryCount: z31.number(),
   /** Total tracked competitors. */
-  competitorCount: z30.number(),
+  competitorCount: z31.number(),
   /** Number of providers in the latest run. */
-  providerCount: z30.number(),
+  providerCount: z31.number(),
   /** GSC totals across the most-recent sync window. Null when GSC is not connected. */
-  gsc: z30.object({
-    clicks: z30.number(),
-    impressions: z30.number(),
-    ctr: z30.number(),
-    avgPosition: z30.number(),
-    periodStart: z30.string(),
-    periodEnd: z30.string()
+  gsc: z31.object({
+    clicks: z31.number(),
+    impressions: z31.number(),
+    ctr: z31.number(),
+    avgPosition: z31.number(),
+    periodStart: z31.string(),
+    periodEnd: z31.string()
   }).nullable(),
   /** GA4 totals across the most-recent sync period. Null when GA4 is not connected. */
-  ga: z30.object({
-    sessions: z30.number(),
-    users: z30.number(),
-    periodStart: z30.string(),
-    periodEnd: z30.string()
+  ga: z31.object({
+    sessions: z31.number(),
+    users: z31.number(),
+    periodStart: z31.string(),
+    periodEnd: z31.string()
   }).nullable(),
   /** Top 3-5 findings, each rendered as a single-sentence narrative. */
-  findings: z30.array(z30.object({
-    title: z30.string(),
-    detail: z30.string(),
-    tone: z30.enum(["positive", "caution", "negative", "neutral"])
+  findings: z31.array(z31.object({
+    title: z31.string(),
+    detail: z31.string(),
+    tone: z31.enum(["positive", "caution", "negative", "neutral"])
   }))
 });
-var citationCellSchema = z30.object({
-  citationState: z30.enum(["cited", "not-cited", "pending"]),
-  answerMentioned: z30.boolean().nullable(),
-  model: z30.string().nullable()
+var citationCellSchema = z31.object({
+  citationState: z31.enum(["cited", "not-cited", "pending"]),
+  answerMentioned: z31.boolean().nullable(),
+  model: z31.string().nullable()
 });
-var citationScorecardSchema = z30.object({
-  queries: z30.array(z30.string()),
-  providers: z30.array(z30.string()),
+var citationScorecardSchema = z31.object({
+  queries: z31.array(z31.string()),
+  providers: z31.array(z31.string()),
   /** matrix[queryIndex][providerIndex] — null when no snapshot exists for the pair. */
-  matrix: z30.array(z30.array(citationCellSchema.nullable())),
+  matrix: z31.array(z31.array(citationCellSchema.nullable())),
   /** Per-provider citation + mention rates (0..100). */
-  providerRates: z30.array(z30.object({
-    provider: z30.string(),
-    citedCount: z30.number(),
+  providerRates: z31.array(z31.object({
+    provider: z31.string(),
+    citedCount: z31.number(),
     /** Number of snapshots for this provider where the answer text mentioned the project. */
-    mentionedCount: z30.number(),
-    totalCount: z30.number(),
-    citationRate: z30.number(),
-    mentionRate: z30.number()
+    mentionedCount: z31.number(),
+    totalCount: z31.number(),
+    citationRate: z31.number(),
+    mentionRate: z31.number()
   }))
 });
-var competitorRowSchema = z30.object({
-  domain: z30.string(),
+var competitorRowSchema = z31.object({
+  domain: z31.string(),
   /** Number of (query × provider) pairs that cited this competitor. */
-  citationCount: z30.number(),
+  citationCount: z31.number(),
   /** Out-of count for the same denominator. */
-  totalCount: z30.number(),
+  totalCount: z31.number(),
   /** 'High' | 'Moderate' | 'Low' | 'None' — from buildPortfolioProject pressure logic. */
-  pressureLabel: z30.enum(["High", "Moderate", "Low", "None"]),
+  pressureLabel: z31.enum(["High", "Moderate", "Low", "None"]),
   /** Distinct queries on which this competitor was cited. */
-  citedQueries: z30.array(z30.string()),
+  citedQueries: z31.array(z31.string()),
   /**
    * Citation share 0..100. Numerator = this competitor's `citationCount`.
    * Denominator = sum of `citationCount` across all competitors plus the
@@ -4620,30 +4665,30 @@ var competitorRowSchema = z30.object({
    * slots in the snapshot. Distinct from the project-level Mention Share
    * gauge — that one is brand-in-answer-text, this one is domain-in-source-list.
    */
-  sharePct: z30.number(),
+  sharePct: z31.number(),
   /**
    * URLs from the latest run's grounding sources whose host matches this
    * competitor's domain, with the queries each URL was cited for. Empty
    * when no grounding-source data is available (e.g. no `rawResponse` JSON
    * stored for the snapshots).
    */
-  theirCitedPages: z30.array(z30.object({ url: z30.string(), citedFor: z30.array(z30.string()) }))
+  theirCitedPages: z31.array(z31.object({ url: z31.string(), citedFor: z31.array(z31.string()) }))
 });
-var competitorLandscapeSchema = z30.object({
+var competitorLandscapeSchema = z31.object({
   /** Project's own citation count (for the bar chart comparing project vs competitors). */
-  projectCitationCount: z30.number(),
-  competitors: z30.array(competitorRowSchema)
+  projectCitationCount: z31.number(),
+  competitors: z31.array(competitorRowSchema)
 });
-var mentionRowSchema = z30.object({
-  domain: z30.string(),
+var mentionRowSchema = z31.object({
+  domain: z31.string(),
   /** Number of (query × provider) pairs whose answer text mentioned this competitor's brand or domain. */
-  mentionCount: z30.number(),
+  mentionCount: z31.number(),
   /** Out-of count for the same denominator (snapshots that had answer text). */
-  totalCount: z30.number(),
+  totalCount: z31.number(),
   /** 'High' | 'Moderate' | 'Low' | 'None' — mention frequency tier (mirrors CompetitorRow.pressureLabel). */
-  pressureLabel: z30.enum(["High", "Moderate", "Low", "None"]),
+  pressureLabel: z31.enum(["High", "Moderate", "Low", "None"]),
   /** Distinct queries on which this competitor was mentioned. */
-  mentionedQueries: z30.array(z30.string()),
+  mentionedQueries: z31.array(z31.string()),
   /**
    * Mention share 0..100. Numerator = this competitor's `mentionCount`.
    * Denominator = sum of `mentionCount` across all competitors plus the
@@ -4651,135 +4696,135 @@ var mentionRowSchema = z30.object({
    * mention. Per-competitor split of the same head-to-head measure the
    * project's hero `MentionShareDto` gauge headlines.
    */
-  sharePct: z30.number()
+  sharePct: z31.number()
 });
-var mentionLandscapeSchema = z30.object({
+var mentionLandscapeSchema = z31.object({
   /** Project's own mention count (for the bar chart comparing project vs competitors). */
-  projectMentionCount: z30.number(),
+  projectMentionCount: z31.number(),
   /** Snapshots considered — those with non-empty answerText. Drives the totalCount denominator. */
-  totalAnswerSnapshots: z30.number(),
-  competitors: z30.array(mentionRowSchema)
+  totalAnswerSnapshots: z31.number(),
+  competitors: z31.array(mentionRowSchema)
 });
-var aiSourceCategoryBucketSchema = z30.object({
+var aiSourceCategoryBucketSchema = z31.object({
   /** Category slug from packages/contracts/src/source-categories. */
-  category: z30.string(),
+  category: z31.string(),
   /** Display label. */
-  label: z30.string(),
+  label: z31.string(),
   /** Number of citations falling in this category. */
-  count: z30.number(),
+  count: z31.number(),
   /** 0..100 share of total citations. */
-  sharePct: z30.number()
+  sharePct: z31.number()
 });
-var aiSourceOriginSchema = z30.object({
-  categories: z30.array(aiSourceCategoryBucketSchema),
+var aiSourceOriginSchema = z31.object({
+  categories: z31.array(aiSourceCategoryBucketSchema),
   /** Top 20 source domains by citation count (excluding the project's own domain). */
-  topDomains: z30.array(z30.object({
-    domain: z30.string(),
-    count: z30.number(),
+  topDomains: z31.array(z31.object({
+    domain: z31.string(),
+    count: z31.number(),
     /** True when the domain is one of the project's tracked competitors. */
-    isCompetitor: z30.boolean()
+    isCompetitor: z31.boolean()
   }))
 });
-var gscQueryRowSchema = z30.object({
-  query: z30.string(),
-  clicks: z30.number(),
-  impressions: z30.number(),
-  ctr: z30.number(),
-  avgPosition: z30.number(),
+var gscQueryRowSchema = z31.object({
+  query: z31.string(),
+  clicks: z31.number(),
+  impressions: z31.number(),
+  ctr: z31.number(),
+  avgPosition: z31.number(),
   /** Heuristic categorization: 'brand' | 'lead-gen' | 'industry' | 'other'. */
-  category: z30.enum(["brand", "lead-gen", "industry", "other"])
-});
-var gscSectionSchema = z30.object({
-  periodStart: z30.string(),
-  periodEnd: z30.string(),
-  totalClicks: z30.number(),
-  totalImpressions: z30.number(),
-  ctr: z30.number(),
-  avgPosition: z30.number(),
-  topQueries: z30.array(gscQueryRowSchema),
-  categoryBreakdown: z30.array(z30.object({
-    category: z30.enum(["brand", "lead-gen", "industry", "other"]),
-    clicks: z30.number(),
-    impressions: z30.number(),
-    sharePct: z30.number()
+  category: z31.enum(["brand", "lead-gen", "industry", "other"])
+});
+var gscSectionSchema = z31.object({
+  periodStart: z31.string(),
+  periodEnd: z31.string(),
+  totalClicks: z31.number(),
+  totalImpressions: z31.number(),
+  ctr: z31.number(),
+  avgPosition: z31.number(),
+  topQueries: z31.array(gscQueryRowSchema),
+  categoryBreakdown: z31.array(z31.object({
+    category: z31.enum(["brand", "lead-gen", "industry", "other"]),
+    clicks: z31.number(),
+    impressions: z31.number(),
+    sharePct: z31.number()
   })),
-  trend: z30.array(z30.object({ date: z30.string(), clicks: z30.number(), impressions: z30.number() })),
+  trend: z31.array(z31.object({ date: z31.string(), clicks: z31.number(), impressions: z31.number() })),
   /**
    * Tracked AEO queries that have no GSC impressions in the report window.
    * Surfaces queries that may not represent real search demand.
    */
-  trackedButNoGsc: z30.array(z30.string()),
+  trackedButNoGsc: z31.array(z31.string()),
   /**
    * GSC top queries (sorted by impressions desc) that are not tracked as
    * AEO queries — the candidate set for adding to the AEO project.
    */
-  gscButNotTracked: z30.array(z30.string())
-});
-var gaTrafficSectionSchema = z30.object({
-  totalSessions: z30.number(),
-  totalUsers: z30.number(),
-  totalOrganicSessions: z30.number(),
-  periodStart: z30.string(),
-  periodEnd: z30.string(),
-  topLandingPages: z30.array(z30.object({
-    page: z30.string(),
-    sessions: z30.number(),
-    users: z30.number(),
-    organicSessions: z30.number()
+  gscButNotTracked: z31.array(z31.string())
+});
+var gaTrafficSectionSchema = z31.object({
+  totalSessions: z31.number(),
+  totalUsers: z31.number(),
+  totalOrganicSessions: z31.number(),
+  periodStart: z31.string(),
+  periodEnd: z31.string(),
+  topLandingPages: z31.array(z31.object({
+    page: z31.string(),
+    sessions: z31.number(),
+    users: z31.number(),
+    organicSessions: z31.number()
   })),
-  channelBreakdown: z30.array(z30.object({
-    channel: z30.string(),
-    sessions: z30.number(),
-    sharePct: z30.number()
+  channelBreakdown: z31.array(z31.object({
+    channel: z31.string(),
+    sessions: z31.number(),
+    sharePct: z31.number()
   }))
 });
-var socialReferralSectionSchema = z30.object({
-  totalSessions: z30.number(),
-  organicSessions: z30.number(),
-  paidSessions: z30.number(),
-  channels: z30.array(z30.object({
-    channelGroup: z30.string(),
-    sessions: z30.number(),
-    sharePct: z30.number()
+var socialReferralSectionSchema = z31.object({
+  totalSessions: z31.number(),
+  organicSessions: z31.number(),
+  paidSessions: z31.number(),
+  channels: z31.array(z31.object({
+    channelGroup: z31.string(),
+    sessions: z31.number(),
+    sharePct: z31.number()
   })),
-  topCampaigns: z30.array(z30.object({
-    source: z30.string(),
-    medium: z30.string(),
-    sessions: z30.number()
+  topCampaigns: z31.array(z31.object({
+    source: z31.string(),
+    medium: z31.string(),
+    sessions: z31.number()
   }))
 });
-var aiReferralSectionSchema = z30.object({
-  totalSessions: z30.number(),
-  totalUsers: z30.number(),
-  paidSessions: z30.number(),
-  paidUsers: z30.number(),
-  organicSessions: z30.number(),
-  organicUsers: z30.number(),
-  bySource: z30.array(z30.object({
-    source: z30.string(),
-    sessions: z30.number(),
-    users: z30.number(),
-    paidSessions: z30.number(),
-    organicSessions: z30.number(),
-    sharePct: z30.number()
+var aiReferralSectionSchema = z31.object({
+  totalSessions: z31.number(),
+  totalUsers: z31.number(),
+  paidSessions: z31.number(),
+  paidUsers: z31.number(),
+  organicSessions: z31.number(),
+  organicUsers: z31.number(),
+  bySource: z31.array(z31.object({
+    source: z31.string(),
+    sessions: z31.number(),
+    users: z31.number(),
+    paidSessions: z31.number(),
+    organicSessions: z31.number(),
+    sharePct: z31.number()
   })),
-  trend: z30.array(z30.object({ date: z30.string(), sessions: z30.number() })),
-  topLandingPages: z30.array(z30.object({
-    page: z30.string(),
-    sessions: z30.number(),
-    users: z30.number()
+  trend: z31.array(z31.object({ date: z31.string(), sessions: z31.number() })),
+  topLandingPages: z31.array(z31.object({
+    page: z31.string(),
+    sessions: z31.number(),
+    users: z31.number()
   }))
 });
-var serverActivitySectionSchema = z30.object({
+var serverActivitySectionSchema = z31.object({
   /** ISO8601 inclusive lower bound of the report window (default: 7 days). */
-  windowStart: z30.string(),
+  windowStart: z31.string(),
   /** ISO8601 inclusive upper bound. */
-  windowEnd: z30.string(),
-  hasData: z30.boolean(),
+  windowEnd: z31.string(),
+  hasData: z31.boolean(),
   /** Last-7d total verified crawler hits, with prior 7d for delta. */
-  verifiedCrawlerHits: z30.object({ current: z30.number(), prior: z30.number(), deltaPct: z30.number().nullable() }),
+  verifiedCrawlerHits: z31.object({ current: z31.number(), prior: z31.number(), deltaPct: z31.number().nullable() }),
   /** Last-7d total unverified crawler hits, separated from verified trust metrics. */
-  unverifiedCrawlerHits: z30.object({ current: z30.number(), prior: z30.number(), deltaPct: z30.number().nullable() }),
+  unverifiedCrawlerHits: z31.object({ current: z31.number(), prior: z31.number(), deltaPct: z31.number().nullable() }),
   /**
    * Last-7d on-demand per-user fetches from AI surfaces (ChatGPT-User,
    * Perplexity-User, MistralAI-User). Disjoint from `verifiedCrawlerHits` /
@@ -4788,9 +4833,9 @@ var serverActivitySectionSchema = z30.object({
    * because the operational question for user-fetch is "is this happening?"
    * not "is this a confirmed bot identity?"
    */
-  aiUserFetchHits: z30.object({ current: z30.number(), prior: z30.number(), deltaPct: z30.number().nullable() }),
+  aiUserFetchHits: z31.object({ current: z31.number(), prior: z31.number(), deltaPct: z31.number().nullable() }),
   /** Last-7d AI-referral sessions (sessionized from server-side request evidence). Paid + organic + unclassified. */
-  referralArrivals: z30.object({ current: z30.number(), prior: z30.number(), deltaPct: z30.number().nullable() }),
+  referralArrivals: z31.object({ current: z31.number(), prior: z31.number(), deltaPct: z31.number().nullable() }),
   /**
    * `referralArrivals` split by traffic class. The three buckets sum to it.
    *
@@ -4799,23 +4844,23 @@ var serverActivitySectionSchema = z30.object({
    * never be resolved. Reporting them as organic would overstate earned AI
    * traffic by exactly a client's ad volume.
    */
-  referralArrivalsByClass: z30.object({
-    paid: z30.object({ current: z30.number(), prior: z30.number(), deltaPct: z30.number().nullable() }),
-    organic: z30.object({ current: z30.number(), prior: z30.number(), deltaPct: z30.number().nullable() }),
-    unclassified: z30.object({ current: z30.number(), prior: z30.number(), deltaPct: z30.number().nullable() })
+  referralArrivalsByClass: z31.object({
+    paid: z31.object({ current: z31.number(), prior: z31.number(), deltaPct: z31.number().nullable() }),
+    organic: z31.object({ current: z31.number(), prior: z31.number(), deltaPct: z31.number().nullable() }),
+    unclassified: z31.object({ current: z31.number(), prior: z31.number(), deltaPct: z31.number().nullable() })
   }),
   /** Pre-rendered one-line breakdown, e.g. "Paid 1,200 · Organic 24". Empty when there is nothing to split. */
-  referralArrivalsClassSummary: z30.string(),
+  referralArrivalsClassSummary: z31.string(),
   /** Per-AI-operator breakdown (OpenAI, Anthropic, Google AI, Perplexity, …). */
-  byOperator: z30.array(z30.object({
-    operator: z30.string(),
-    verifiedHits: z30.number(),
+  byOperator: z31.array(z31.object({
+    operator: z31.string(),
+    verifiedHits: z31.number(),
     /** Shown to agency audience only: claimed-bot UA, source IP not in a published range. */
-    unverifiedHits: z30.number(),
+    unverifiedHits: z31.number(),
     /** Per-user fetches from this operator's AI surface (ChatGPT-User, …). */
-    userFetchHits: z30.number(),
-    referralArrivals: z30.number(),
-    deltaPct: z30.number().nullable()
+    userFetchHits: z31.number(),
+    referralArrivals: z31.number(),
+    deltaPct: z31.number().nullable()
   })),
   /**
    * Top crawled paths (verified only, last-7d). Path-level citation cross-reference
@@ -4825,88 +4870,88 @@ var serverActivitySectionSchema = z30.object({
    * citation evidence can extend this entry with a `citationState` field without
    * breaking the contract.
    */
-  topCrawledPaths: z30.array(z30.object({
-    path: z30.string(),
-    verifiedHits: z30.number(),
+  topCrawledPaths: z31.array(z31.object({
+    path: z31.string(),
+    verifiedHits: z31.number(),
     /** How many distinct AI operators crawled this path in the window. */
-    distinctOperators: z30.number()
+    distinctOperators: z31.number()
   })),
   /** AI products that sent ≥1 session in the window (referral by destination). */
-  referralProducts: z30.array(z30.object({
-    product: z30.string(),
-    arrivals: z30.number(),
-    distinctLandingPaths: z30.number()
+  referralProducts: z31.array(z31.object({
+    product: z31.string(),
+    arrivals: z31.number(),
+    distinctLandingPaths: z31.number()
   })),
   /** Daily trend, last 14d for sparkline / chart rendering. */
-  dailyTrend: z30.array(z30.object({
-    date: z30.string(),
-    verifiedCrawlerHits: z30.number(),
-    userFetchHits: z30.number(),
-    referralArrivals: z30.number()
+  dailyTrend: z31.array(z31.object({
+    date: z31.string(),
+    verifiedCrawlerHits: z31.number(),
+    userFetchHits: z31.number(),
+    referralArrivals: z31.number()
   })),
   /**
    * Top landing paths for AI-referral sessions (last-7d).
    * Complements `topCrawledPaths` (what bots fetch) with what humans actually land on.
    */
-  topReferralLandingPaths: z30.array(z30.object({
-    path: z30.string(),
-    arrivals: z30.number(),
-    distinctProducts: z30.number()
+  topReferralLandingPaths: z31.array(z31.object({
+    path: z31.string(),
+    arrivals: z31.number(),
+    distinctProducts: z31.number()
   }))
 });
-var indexingHealthSectionSchema = z30.object({
+var indexingHealthSectionSchema = z31.object({
   /** Source: 'google' | 'bing' | null when neither is connected. */
-  provider: z30.enum(["google", "bing"]).nullable(),
-  total: z30.number(),
-  indexed: z30.number(),
-  notIndexed: z30.number(),
+  provider: z31.enum(["google", "bing"]).nullable(),
+  total: z31.number(),
+  indexed: z31.number(),
+  notIndexed: z31.number(),
   /** Google-only — pages explicitly marked as deindexed. Bing reports 'unknown' instead. */
-  deindexed: z30.number(),
+  deindexed: z31.number(),
   /** Bing-only — pages with no inspection data yet. */
-  unknown: z30.number(),
+  unknown: z31.number(),
   /** 0..100. */
-  indexedPct: z30.number()
+  indexedPct: z31.number()
 });
-var citationsTrendPointSchema = z30.object({
+var citationsTrendPointSchema = z31.object({
   /** Run ID — anchor for cross-section linking. */
-  runId: z30.string(),
+  runId: z31.string(),
   /** ISO timestamp when the run finished (or createdAt fallback). */
-  date: z30.string(),
+  date: z31.string(),
   /**
    * 0..100 — same per-query unique-cited definition as
    * `ReportExecutiveSummary.citationRate`. Stable across runs with different
    * provider counts so the trend line measures real movement rather than
    * provider-count variance.
    */
-  citationRate: z30.number(),
+  citationRate: z31.number(),
   /** Numerator of `citationRate` for this run. */
-  citedQueryCount: z30.number(),
+  citedQueryCount: z31.number(),
   /** Denominator of `citationRate` for this run. */
-  totalQueryCount: z30.number(),
+  totalQueryCount: z31.number(),
   /** 0..100 — same per-query unique-mentioned definition as `ReportExecutiveSummary.mentionRate`. */
-  mentionRate: z30.number(),
+  mentionRate: z31.number(),
   /** Numerator of `mentionRate` for this run. */
-  mentionedQueryCount: z30.number(),
+  mentionedQueryCount: z31.number(),
   /**
    * Per-provider rates for the same run. Each provider's rate is per-pair
    * within that provider (`cited / scanned`), so it remains comparable
    * between providers in the same run.
    */
-  providerRates: z30.array(z30.object({
-    provider: z30.string(),
-    citationRate: z30.number(),
-    mentionRate: z30.number()
+  providerRates: z31.array(z31.object({
+    provider: z31.string(),
+    citationRate: z31.number(),
+    mentionRate: z31.number()
   }))
 });
-var reportInsightSchema = z30.object({
-  id: z30.string(),
-  type: z30.enum(["regression", "gain", "opportunity"]),
-  severity: z30.enum(["critical", "high", "medium", "low"]),
-  title: z30.string(),
-  query: z30.string(),
-  provider: z30.string(),
-  recommendation: z30.string().nullable(),
-  createdAt: z30.string(),
+var reportInsightSchema = z31.object({
+  id: z31.string(),
+  type: z31.enum(["regression", "gain", "opportunity"]),
+  severity: z31.enum(["critical", "high", "medium", "low"]),
+  title: z31.string(),
+  query: z31.string(),
+  provider: z31.string(),
+  recommendation: z31.string().nullable(),
+  createdAt: z31.string(),
   /**
    * How many times this insight fired across recent runs for the same
    * `(query, provider, type)` tuple. Always ≥ 1. Insights returned by the
@@ -4914,64 +4959,64 @@ var reportInsightSchema = z30.object({
    * surfacing the multiplicity. Use it directly instead of grouping again
    * client-side — counts derived from raw insight rows will overcount.
    */
-  instanceCount: z30.number()
+  instanceCount: z31.number()
 });
-var recommendedNextStepSchema = z30.object({
+var recommendedNextStepSchema = z31.object({
   /** 'immediate' | 'short-term' | 'medium-term' — bucketed by severity heuristic. */
-  horizon: z30.enum(["immediate", "short-term", "medium-term"]),
-  title: z30.string(),
-  rationale: z30.string()
+  horizon: z31.enum(["immediate", "short-term", "medium-term"]),
+  title: z31.string(),
+  rationale: z31.string()
 });
-var reportRateDeltaSchema = z30.object({
+var reportRateDeltaSchema = z31.object({
   /** Current value (0..100 for rates, raw count otherwise). When `window`
    *  is present this is the average over the last `window` checks. */
-  current: z30.number(),
+  current: z31.number(),
   /** Prior value compared against. When `window` is present this is the
    *  average over the prior `window` checks before that. */
-  prior: z30.number(),
+  prior: z31.number(),
   /** Absolute delta (current − prior). Negative = decrease. */
-  deltaAbs: z30.number(),
+  deltaAbs: z31.number(),
   /**
    * Signed percent change vs `prior`, rounded to a whole number. Null when
    * `prior <= 0` (percentage undefined). Renderers route count/traffic tiles
    * through the "smart %" rule — percentage when the prior base is large
    * enough (`MIN_PCT_BASE`), otherwise a rounded raw delta.
    */
-  deltaPct: z30.number().nullable(),
+  deltaPct: z31.number().nullable(),
   /**
    * Direction tag for tone mapping. Threshold is metric-specific (3pp for
    * rates, 0.5 for counts) so small noise lands as 'flat' rather than
    * flipping up/down each run.
    */
-  direction: z30.enum(["up", "down", "flat"]),
+  direction: z31.enum(["up", "down", "flat"]),
   /**
    * How many points went into each side of the average. Omitted (or 1)
    * means point-to-point (legacy "since last check"). Higher values mean
    * a rolling-average comparison — renderers should label it as
    * "vs prior N checks" when this is ≥ 2.
    */
-  window: z30.number().optional()
+  window: z31.number().optional()
 });
-var reportProviderMovementSchema = z30.object({
-  provider: z30.string(),
-  current: z30.number(),
-  prior: z30.number(),
-  deltaAbs: z30.number(),
-  direction: z30.enum(["up", "down", "flat"])
+var reportProviderMovementSchema = z31.object({
+  provider: z31.string(),
+  current: z31.number(),
+  prior: z31.number(),
+  deltaAbs: z31.number(),
+  direction: z31.enum(["up", "down", "flat"])
 });
-var whatsChangedSectionSchema = z30.object({
+var whatsChangedSectionSchema = z31.object({
   /**
    * False when there's no prior run (or fewer than the trend baseline),
    * meaning all per-metric deltas will be null. Renderers use this to swap
    * in a "establishing baseline" fallback rather than rendering empty
    * delta tiles.
    */
-  enoughHistory: z30.boolean(),
+  enoughHistory: z31.boolean(),
   /**
    * One-sentence narrative summary suitable as a section subtitle.
    * Always present — even on baseline, narrates whatever signal exists.
    */
-  headline: z30.string(),
+  headline: z31.string(),
   /** Citation rate delta vs the prior completed run. Null when no prior run. */
   citationRate: reportRateDeltaSchema.nullable(),
   /** Mention rate delta vs the prior completed run. Null when no prior run. */
@@ -4999,30 +5044,30 @@ var whatsChangedSectionSchema = z30.object({
    * deltas "vs prior {comparisonWindowDays} days" off this single value so the
    * SPA and HTML stay verbatim-identical.
    */
-  comparisonWindowDays: z30.number().int().positive(),
+  comparisonWindowDays: z31.number().int().positive(),
   /**
    * Per-provider citation rate movements (latest run vs prior run). Empty
    * when no prior run. Sorted by |deltaAbs| desc — providers with the
    * biggest swing first.
    */
-  providerMovements: z30.array(reportProviderMovementSchema),
+  providerMovements: z31.array(reportProviderMovementSchema),
   /**
    * Top wins this period — gains surfaced by the intelligence engine.
    * Capped at 5; sourced from `insights` filtered to `type: 'gain'`.
    */
-  wins: z30.array(reportInsightSchema),
+  wins: z31.array(reportInsightSchema),
   /**
    * Top regressions this period — citations or mentions lost. Capped at 5;
    * sourced from `insights` filtered to `type: 'regression'`.
    */
-  regressions: z30.array(reportInsightSchema)
-});
-var reportAudienceSchema = z30.enum(["agency", "client"]);
-var reportActionAudienceSchema = z30.enum(["agency", "client", "both"]);
-var reportActionHorizonSchema = z30.enum(["immediate", "short-term", "medium-term"]);
-var reportActionConfidenceSchema = z30.enum(["high", "medium", "low"]);
-var reportToneSchema = z30.enum(["positive", "caution", "negative", "neutral"]);
-var reportActionCategorySchema = z30.enum([
+  regressions: z31.array(reportInsightSchema)
+});
+var reportAudienceSchema = z31.enum(["agency", "client"]);
+var reportActionAudienceSchema = z31.enum(["agency", "client", "both"]);
+var reportActionHorizonSchema = z31.enum(["immediate", "short-term", "medium-term"]);
+var reportActionConfidenceSchema = z31.enum(["high", "medium", "low"]);
+var reportToneSchema = z31.enum(["positive", "caution", "negative", "neutral"]);
+var reportActionCategorySchema = z31.enum([
   "content",
   "competitors",
   "provider",
@@ -5031,23 +5076,23 @@ var reportActionCategorySchema = z30.enum([
   "location",
   "monitoring"
 ]);
-var reportActionPlanItemSchema = z30.object({
+var reportActionPlanItemSchema = z31.object({
   /** Which report audience should see this action. `both` renders in both modes. */
   audience: reportActionAudienceSchema,
   /** Stable sort priority. Lower numbers render earlier. */
-  priority: z30.number(),
+  priority: z31.number(),
   /** When this should be tackled. */
   horizon: reportActionHorizonSchema,
   category: reportActionCategorySchema,
-  title: z30.string(),
+  title: z31.string(),
   /** Direct next step written as an operator/client-friendly imperative. */
-  action: z30.string(),
+  action: z31.string(),
   /** Why this matters. Keep each entry concise and evidence-backed. */
-  why: z30.array(z30.string()),
+  why: z31.array(z31.string()),
   /** Specific observations that justify the action. */
-  evidence: z30.array(z30.string()),
+  evidence: z31.array(z31.string()),
   /** What should move if the action worked. */
-  successMetric: z30.string(),
+  successMetric: z31.string(),
   /** Confidence in the recommendation based on the available evidence. */
   confidence: reportActionConfidenceSchema,
   /**
@@ -5059,23 +5104,23 @@ var reportActionPlanItemSchema = z30.object({
    * load. Actions sourced from other signals (competitor gaps, indexing
    * issues, etc.) omit this and use their own dismiss flows.
    */
-  targetRef: z30.string().optional()
+  targetRef: z31.string().optional()
 });
-var reportClientSummarySchema = z30.object({
-  headline: z30.string(),
-  overview: z30.string(),
-  actionItems: z30.array(reportActionPlanItemSchema),
-  confidenceNotes: z30.array(z30.string())
+var reportClientSummarySchema = z31.object({
+  headline: z31.string(),
+  overview: z31.string(),
+  actionItems: z31.array(reportActionPlanItemSchema),
+  confidenceNotes: z31.array(z31.string())
 });
-var reportAgencyDiagnosticSchema = z30.object({
-  title: z30.string(),
-  detail: z30.string(),
-  severity: z30.enum(["positive", "caution", "negative", "neutral"]),
-  evidence: z30.array(z30.string())
+var reportAgencyDiagnosticSchema = z31.object({
+  title: z31.string(),
+  detail: z31.string(),
+  severity: z31.enum(["positive", "caution", "negative", "neutral"]),
+  evidence: z31.array(z31.string())
 });
-var reportAgencyDiagnosticsSchema = z30.object({
-  priorities: z30.array(reportActionPlanItemSchema),
-  diagnostics: z30.array(reportAgencyDiagnosticSchema)
+var reportAgencyDiagnosticsSchema = z31.object({
+  priorities: z31.array(reportActionPlanItemSchema),
+  diagnostics: z31.array(reportAgencyDiagnosticSchema)
 });
 function reportActionTone(action) {
   if (action.horizon === "immediate") return "negative";
@@ -5133,7 +5178,7 @@ function reportConfidenceLabel(confidence) {
       return "Low";
   }
 }
-var projectReportDtoSchema = z30.object({
+var projectReportDtoSchema = z31.object({
   meta: reportMetaSchema,
   executiveSummary: reportExecutiveSummarySchema,
   citationScorecard: citationScorecardSchema,
@@ -5147,16 +5192,16 @@ var projectReportDtoSchema = z30.object({
   /** Server-side log-evidence visibility (crawls + click-through sessions). Null when no traffic source connected. */
   serverActivity: serverActivitySectionSchema.nullable(),
   indexingHealth: indexingHealthSectionSchema.nullable(),
-  citationsTrend: z30.array(citationsTrendPointSchema),
+  citationsTrend: z31.array(citationsTrendPointSchema),
   /**
    * Trend-focused "what's changed" summary for the report's act 2. Always
    * present; renderers gate empty/baseline states via `enoughHistory`.
    */
   whatsChanged: whatsChangedSectionSchema,
-  insights: z30.array(reportInsightSchema),
-  recommendedNextSteps: z30.array(recommendedNextStepSchema),
+  insights: z31.array(reportInsightSchema),
+  recommendedNextSteps: z31.array(recommendedNextStepSchema),
   /** Canonical structured actions shared by the client and agency render modes. */
-  actionPlan: z30.array(reportActionPlanItemSchema),
+  actionPlan: z31.array(reportActionPlanItemSchema),
   /** Polished client-facing summary and action shortlist. */
   clientSummary: reportClientSummarySchema,
   /** Technical, evidence-oriented operator diagnostics for agency mode. */
@@ -5166,17 +5211,17 @@ var projectReportDtoSchema = z30.object({
    * intelligence layer (`buildContentTargetRows`). Empty when no run has
    * produced candidate queries with demand or competitor signal.
    */
-  contentOpportunities: z30.array(contentTargetRowDtoSchema),
+  contentOpportunities: z31.array(contentTargetRowDtoSchema),
   /**
    * Queries where competitors were cited but the project was not. Sourced
    * from `buildContentGapRows`. Empty until the first answer-visibility run.
    */
-  contentGaps: z30.array(contentGapRowDtoSchema),
+  contentGaps: z31.array(contentGapRowDtoSchema),
   /**
    * Per-query grounding source map (own + competitor cited URLs). Sourced
    * from `buildContentSourceRows`. Empty until the first answer-visibility run.
    */
-  groundingSources: z30.array(contentSourceRowDtoSchema)
+  groundingSources: z31.array(contentSourceRowDtoSchema)
 });
 
 // ../contracts/src/report-dedup.ts
@@ -5247,10 +5292,10 @@ function dedupeReportOpportunities(report) {
 }
 
 // ../contracts/src/skills.ts
-import { z as z31 } from "zod";
-var codingAgentSchema = z31.enum(["claude", "codex"]);
+import { z as z32 } from "zod";
+var codingAgentSchema = z32.enum(["claude", "codex"]);
 var CodingAgents = codingAgentSchema.enum;
-var skillsClientSchema = z31.enum(["claude", "codex", "all"]);
+var skillsClientSchema = z32.enum(["claude", "codex", "all"]);
 var SkillsClients = skillsClientSchema.enum;
 var SKILL_MANIFEST_FILENAME = ".canonry-skill-manifest.json";
 function classifySkillFile(params) {
@@ -5268,22 +5313,22 @@ function coerceSkillManifest(parsed) {
 }
 
 // ../contracts/src/traffic.ts
-import { z as z32 } from "zod";
-var trafficCrawlerSegmentsSchema = z32.object({
-  content: z32.number().int().nonnegative(),
-  sitemap: z32.number().int().nonnegative(),
-  robots: z32.number().int().nonnegative(),
-  asset: z32.number().int().nonnegative(),
-  other: z32.number().int().nonnegative()
-});
-var trafficPathClassSchema = z32.enum([
+import { z as z33 } from "zod";
+var trafficCrawlerSegmentsSchema = z33.object({
+  content: z33.number().int().nonnegative(),
+  sitemap: z33.number().int().nonnegative(),
+  robots: z33.number().int().nonnegative(),
+  asset: z33.number().int().nonnegative(),
+  other: z33.number().int().nonnegative()
+});
+var trafficPathClassSchema = z33.enum([
   "content",
   "sitemap",
   "robots",
   "asset",
   "other"
 ]);
-var trafficSourceTypeSchema = z32.enum([
+var trafficSourceTypeSchema = z33.enum([
   "cloud-run",
   "wordpress",
   "cloudflare",
@@ -5291,7 +5336,7 @@ var trafficSourceTypeSchema = z32.enum([
   "generic-log"
 ]);
 var TrafficSourceTypes = trafficSourceTypeSchema.enum;
-var trafficAdapterCapabilitySchema = z32.enum([
+var trafficAdapterCapabilitySchema = z33.enum([
   "raw-request-events",
   "aggregate-request-metrics",
   "request-url",
@@ -5302,252 +5347,252 @@ var trafficAdapterCapabilitySchema = z32.enum([
   "cursor-pull"
 ]);
 var TrafficAdapterCapabilities = trafficAdapterCapabilitySchema.enum;
-var trafficEvidenceKindSchema = z32.enum(["raw-request", "aggregate-bucket"]);
+var trafficEvidenceKindSchema = z33.enum(["raw-request", "aggregate-bucket"]);
 var TrafficEvidenceKinds = trafficEvidenceKindSchema.enum;
-var trafficEventConfidenceSchema = z32.enum(["observed", "provider-aggregated", "inferred"]);
+var trafficEventConfidenceSchema = z33.enum(["observed", "provider-aggregated", "inferred"]);
 var TrafficEventConfidences = trafficEventConfidenceSchema.enum;
-var trafficProviderResourceSchema = z32.object({
-  type: z32.string().nullable(),
-  labels: z32.record(z32.string(), z32.string())
+var trafficProviderResourceSchema = z33.object({
+  type: z33.string().nullable(),
+  labels: z33.record(z33.string(), z33.string())
 });
-var normalizedTrafficRequestSchema = z32.object({
+var normalizedTrafficRequestSchema = z33.object({
   sourceType: trafficSourceTypeSchema,
-  evidenceKind: z32.literal(TrafficEvidenceKinds["raw-request"]),
-  confidence: z32.literal(TrafficEventConfidences.observed),
-  eventId: z32.string().min(1),
-  observedAt: z32.string().min(1),
-  method: z32.string().nullable(),
-  requestUrl: z32.string().nullable(),
-  host: z32.string().nullable(),
-  path: z32.string().min(1),
-  queryString: z32.string().nullable(),
-  status: z32.number().int().nullable(),
-  userAgent: z32.string().nullable(),
-  remoteIp: z32.string().nullable(),
-  referer: z32.string().nullable(),
-  latencyMs: z32.number().nullable(),
-  requestSizeBytes: z32.number().int().nullable(),
-  responseSizeBytes: z32.number().int().nullable(),
+  evidenceKind: z33.literal(TrafficEvidenceKinds["raw-request"]),
+  confidence: z33.literal(TrafficEventConfidences.observed),
+  eventId: z33.string().min(1),
+  observedAt: z33.string().min(1),
+  method: z33.string().nullable(),
+  requestUrl: z33.string().nullable(),
+  host: z33.string().nullable(),
+  path: z33.string().min(1),
+  queryString: z33.string().nullable(),
+  status: z33.number().int().nullable(),
+  userAgent: z33.string().nullable(),
+  remoteIp: z33.string().nullable(),
+  referer: z33.string().nullable(),
+  latencyMs: z33.number().nullable(),
+  requestSizeBytes: z33.number().int().nullable(),
+  responseSizeBytes: z33.number().int().nullable(),
   providerResource: trafficProviderResourceSchema,
-  providerLabels: z32.record(z32.string(), z32.string())
+  providerLabels: z33.record(z33.string(), z33.string())
 });
-var normalizedTrafficPullPageSchema = z32.object({
-  events: z32.array(normalizedTrafficRequestSchema),
-  rawEntryCount: z32.number().int().nonnegative(),
-  skippedEntryCount: z32.number().int().nonnegative(),
-  nextPageToken: z32.string().optional(),
-  filter: z32.string()
+var normalizedTrafficPullPageSchema = z33.object({
+  events: z33.array(normalizedTrafficRequestSchema),
+  rawEntryCount: z33.number().int().nonnegative(),
+  skippedEntryCount: z33.number().int().nonnegative(),
+  nextPageToken: z33.string().optional(),
+  filter: z33.string()
 });
-var trafficSourceStatusSchema = z32.enum(["connected", "paused", "error", "archived"]);
+var trafficSourceStatusSchema = z33.enum(["connected", "paused", "error", "archived"]);
 var TrafficSourceStatuses = trafficSourceStatusSchema.enum;
-var trafficSourceAuthModeSchema = z32.enum(["oauth", "service-account"]);
+var trafficSourceAuthModeSchema = z33.enum(["oauth", "service-account"]);
 var TrafficSourceAuthModes = trafficSourceAuthModeSchema.enum;
-var verificationStatusSchema = z32.enum(["verified", "claimed_unverified", "unknown_ai_like"]);
+var verificationStatusSchema = z33.enum(["verified", "claimed_unverified", "unknown_ai_like"]);
 var VerificationStatuses = verificationStatusSchema.enum;
-var cloudRunSourceConfigSchema = z32.object({
-  gcpProjectId: z32.string().min(1),
-  serviceName: z32.string().nullable().optional(),
-  location: z32.string().nullable().optional(),
+var cloudRunSourceConfigSchema = z33.object({
+  gcpProjectId: z33.string().min(1),
+  serviceName: z33.string().nullable().optional(),
+  location: z33.string().nullable().optional(),
   authMode: trafficSourceAuthModeSchema
 });
-var wordpressTrafficSourceConfigSchema = z32.object({
-  baseUrl: z32.string().url(),
-  username: z32.string().min(1)
+var wordpressTrafficSourceConfigSchema = z33.object({
+  baseUrl: z33.string().url(),
+  username: z33.string().min(1)
 });
-var vercelTrafficEnvironmentSchema = z32.enum(["production", "preview"]);
+var vercelTrafficEnvironmentSchema = z33.enum(["production", "preview"]);
 var VercelTrafficEnvironments = vercelTrafficEnvironmentSchema.enum;
-var vercelTrafficSourceConfigSchema = z32.object({
+var vercelTrafficSourceConfigSchema = z33.object({
   /** Vercel project id (e.g. `prj_...`). */
-  projectId: z32.string().min(1),
+  projectId: z33.string().min(1),
   /** Vercel team or account id: the org that owns the project. */
-  teamId: z32.string().min(1),
+  teamId: z33.string().min(1),
   environment: vercelTrafficEnvironmentSchema
 });
-var trafficSourceDtoSchema = z32.object({
-  id: z32.string(),
-  projectId: z32.string(),
+var trafficSourceDtoSchema = z33.object({
+  id: z33.string(),
+  projectId: z33.string(),
   sourceType: trafficSourceTypeSchema,
-  displayName: z32.string(),
+  displayName: z33.string(),
   status: trafficSourceStatusSchema,
-  lastSyncedAt: z32.string().nullable(),
-  lastCursor: z32.string().nullable(),
-  lastError: z32.string().nullable(),
-  archivedAt: z32.string().nullable(),
-  config: z32.record(z32.string(), z32.unknown()),
-  createdAt: z32.string(),
-  updatedAt: z32.string()
-});
-var trafficConnectCloudRunRequestSchema = z32.object({
-  gcpProjectId: z32.string().min(1),
-  serviceName: z32.string().min(1).optional(),
-  location: z32.string().min(1).optional(),
-  displayName: z32.string().min(1).optional(),
+  lastSyncedAt: z33.string().nullable(),
+  lastCursor: z33.string().nullable(),
+  lastError: z33.string().nullable(),
+  archivedAt: z33.string().nullable(),
+  config: z33.record(z33.string(), z33.unknown()),
+  createdAt: z33.string(),
+  updatedAt: z33.string()
+});
+var trafficConnectCloudRunRequestSchema = z33.object({
+  gcpProjectId: z33.string().min(1),
+  serviceName: z33.string().min(1).optional(),
+  location: z33.string().min(1).optional(),
+  displayName: z33.string().min(1).optional(),
   /** Service-account JSON content (string). When omitted, defaults to OAuth via `canonry google connect <project> --type ga4` flow. */
-  keyJson: z32.string().optional()
+  keyJson: z33.string().optional()
 });
-var trafficConnectWordpressRequestSchema = z32.object({
-  baseUrl: z32.string().url(),
-  username: z32.string().min(1),
+var trafficConnectWordpressRequestSchema = z33.object({
+  baseUrl: z33.string().url(),
+  username: z33.string().min(1),
   /** WordPress Application Password (the same auth used by the content client). */
-  applicationPassword: z32.string().min(1),
-  displayName: z32.string().min(1).optional()
+  applicationPassword: z33.string().min(1),
+  displayName: z33.string().min(1).optional()
 });
-var trafficConnectVercelRequestSchema = z32.object({
+var trafficConnectVercelRequestSchema = z33.object({
   /** Vercel project id (e.g. `prj_...`) — from the Vercel dashboard or `.vercel/project.json`. */
-  projectId: z32.string().min(1),
+  projectId: z33.string().min(1),
   /** Vercel team or account id: the org that owns the project ("orgId" in .vercel/project.json). */
-  teamId: z32.string().min(1),
+  teamId: z33.string().min(1),
   /** Vercel personal access token. Stored in `~/.canonry/config.yaml`, never the DB. */
-  token: z32.string().min(1),
+  token: z33.string().min(1),
   /** Which deployment environment's request logs to pull. Default: `production`. */
   environment: vercelTrafficEnvironmentSchema.optional(),
-  displayName: z32.string().min(1).optional()
+  displayName: z33.string().min(1).optional()
 });
-var trafficSyncResponseSchema = z32.object({
-  sourceId: z32.string(),
-  runId: z32.string(),
-  syncedAt: z32.string(),
-  pulledEvents: z32.number().int().nonnegative(),
+var trafficSyncResponseSchema = z33.object({
+  sourceId: z33.string(),
+  runId: z33.string(),
+  syncedAt: z33.string(),
+  pulledEvents: z33.number().int().nonnegative(),
   /** Self-traffic events (Canonry's own tooling) dropped before rollup. */
-  selfTrafficExcluded: z32.number().int().nonnegative(),
-  crawlerHits: z32.number().int().nonnegative(),
-  aiUserFetchHits: z32.number().int().nonnegative(),
-  aiReferralHits: z32.number().int().nonnegative(),
-  unknownHits: z32.number().int().nonnegative(),
-  crawlerBucketRows: z32.number().int().nonnegative(),
-  aiUserFetchBucketRows: z32.number().int().nonnegative(),
-  aiReferralBucketRows: z32.number().int().nonnegative(),
-  sampleRows: z32.number().int().nonnegative(),
-  windowStart: z32.string(),
-  windowEnd: z32.string()
-});
-var trafficBackfillRequestSchema = z32.object({
+  selfTrafficExcluded: z33.number().int().nonnegative(),
+  crawlerHits: z33.number().int().nonnegative(),
+  aiUserFetchHits: z33.number().int().nonnegative(),
+  aiReferralHits: z33.number().int().nonnegative(),
+  unknownHits: z33.number().int().nonnegative(),
+  crawlerBucketRows: z33.number().int().nonnegative(),
+  aiUserFetchBucketRows: z33.number().int().nonnegative(),
+  aiReferralBucketRows: z33.number().int().nonnegative(),
+  sampleRows: z33.number().int().nonnegative(),
+  windowStart: z33.string(),
+  windowEnd: z33.string()
+});
+var trafficBackfillRequestSchema = z33.object({
   /** Lookback window in days. Capped server-side at the upstream log retention ceiling (Cloud Logging _Default = 30d). Default: 30. */
-  days: z32.number().int().positive().optional()
+  days: z33.number().int().positive().optional()
 });
-var trafficResetRequestSchema = z32.object({
-  advanceToNow: z32.literal(true)
+var trafficResetRequestSchema = z33.object({
+  advanceToNow: z33.literal(true)
 });
-var trafficBackfillResponseSchema = z32.object({
-  sourceId: z32.string(),
-  runId: z32.string(),
+var trafficBackfillResponseSchema = z33.object({
+  sourceId: z33.string(),
+  runId: z33.string(),
   status: runStatusSchema,
-  windowStart: z32.string(),
-  windowEnd: z32.string(),
+  windowStart: z33.string(),
+  windowEnd: z33.string(),
   /** Days actually used after server-side clamping (≤ requested). */
-  daysRequested: z32.number().int().positive(),
-  daysApplied: z32.number().int().positive()
+  daysRequested: z33.number().int().positive(),
+  daysApplied: z33.number().int().positive()
 });
-var trafficSourceTotalsSchema = z32.object({
+var trafficSourceTotalsSchema = z33.object({
   /**
    * Total classified-crawler hits in the window. UNCHANGED contract — still the
    * full count across every path class. Use `crawlerContentHits` for the
    * "content was actually crawled" signal.
    */
-  crawlerHits: z32.number().int().nonnegative(),
+  crawlerHits: z33.number().int().nonnegative(),
   /** Crawler hits against content/document paths only (= `crawlerSegments.content`). */
-  crawlerContentHits: z32.number().int().nonnegative(),
+  crawlerContentHits: z33.number().int().nonnegative(),
   /** Infrastructure crawler hits — sitemap + robots + asset fetches (`crawlerSegments.{sitemap,robots,asset}`). */
-  crawlerInfraHits: z32.number().int().nonnegative(),
+  crawlerInfraHits: z33.number().int().nonnegative(),
   /** Full per-class crawler-hit breakdown; the five buckets sum to `crawlerHits`. */
   crawlerSegments: trafficCrawlerSegmentsSchema,
-  aiUserFetchHits: z32.number().int().nonnegative(),
-  aiReferralHits: z32.number().int().nonnegative(),
-  sampleCount: z32.number().int().nonnegative()
+  aiUserFetchHits: z33.number().int().nonnegative(),
+  aiReferralHits: z33.number().int().nonnegative(),
+  sampleCount: z33.number().int().nonnegative()
 });
-var trafficSourceListResponseSchema = z32.object({
-  sources: z32.array(trafficSourceDtoSchema)
+var trafficSourceListResponseSchema = z33.object({
+  sources: z33.array(trafficSourceDtoSchema)
 });
 var trafficSourceDetailDtoSchema = trafficSourceDtoSchema.extend({
   totals24h: trafficSourceTotalsSchema,
-  latestRun: z32.object({
-    runId: z32.string(),
+  latestRun: z33.object({
+    runId: z33.string(),
     status: runStatusSchema,
-    startedAt: z32.string().nullable(),
-    finishedAt: z32.string().nullable(),
-    error: z32.string().nullable()
+    startedAt: z33.string().nullable(),
+    finishedAt: z33.string().nullable(),
+    error: z33.string().nullable()
   }).nullable()
 });
-var trafficStatusResponseSchema = z32.object({
-  sources: z32.array(trafficSourceDetailDtoSchema)
+var trafficStatusResponseSchema = z33.object({
+  sources: z33.array(trafficSourceDetailDtoSchema)
 });
-var trafficEventKindSchema = z32.enum(["crawler", "ai-user-fetch", "ai-referral"]);
+var trafficEventKindSchema = z33.enum(["crawler", "ai-user-fetch", "ai-referral"]);
 var TrafficEventKinds = trafficEventKindSchema.enum;
-var trafficCrawlerEventEntrySchema = z32.object({
-  kind: z32.literal(TrafficEventKinds.crawler),
-  sourceId: z32.string(),
-  tsHour: z32.string(),
-  botId: z32.string(),
-  operator: z32.string(),
-  verificationStatus: z32.string(),
-  pathNormalized: z32.string(),
+var trafficCrawlerEventEntrySchema = z33.object({
+  kind: z33.literal(TrafficEventKinds.crawler),
+  sourceId: z33.string(),
+  tsHour: z33.string(),
+  botId: z33.string(),
+  operator: z33.string(),
+  verificationStatus: z33.string(),
+  pathNormalized: z33.string(),
   /** Coarse class of the fetched path — lets the UI split content crawls from sitemap/robots/asset polling. */
   pathClass: trafficPathClassSchema,
-  status: z32.number().int(),
-  hits: z32.number().int().nonnegative()
-});
-var trafficAiUserFetchEventEntrySchema = z32.object({
-  kind: z32.literal(TrafficEventKinds["ai-user-fetch"]),
-  sourceId: z32.string(),
-  tsHour: z32.string(),
-  botId: z32.string(),
-  operator: z32.string(),
-  verificationStatus: z32.string(),
-  pathNormalized: z32.string(),
-  status: z32.number().int(),
-  hits: z32.number().int().nonnegative()
-});
-var trafficAiReferralEventEntrySchema = z32.object({
-  kind: z32.literal(TrafficEventKinds["ai-referral"]),
-  sourceId: z32.string(),
-  tsHour: z32.string(),
-  product: z32.string(),
-  operator: z32.string(),
-  sourceDomain: z32.string(),
-  evidenceType: z32.string(),
-  landingPathNormalized: z32.string(),
-  status: z32.number().int(),
+  status: z33.number().int(),
+  hits: z33.number().int().nonnegative()
+});
+var trafficAiUserFetchEventEntrySchema = z33.object({
+  kind: z33.literal(TrafficEventKinds["ai-user-fetch"]),
+  sourceId: z33.string(),
+  tsHour: z33.string(),
+  botId: z33.string(),
+  operator: z33.string(),
+  verificationStatus: z33.string(),
+  pathNormalized: z33.string(),
+  status: z33.number().int(),
+  hits: z33.number().int().nonnegative()
+});
+var trafficAiReferralEventEntrySchema = z33.object({
+  kind: z33.literal(TrafficEventKinds["ai-referral"]),
+  sourceId: z33.string(),
+  tsHour: z33.string(),
+  product: z33.string(),
+  operator: z33.string(),
+  sourceDomain: z33.string(),
+  evidenceType: z33.string(),
+  landingPathNormalized: z33.string(),
+  status: z33.number().int(),
   /** Total AI-referral sessions in the bucket. `paidHits + organicHits + unknownHits === hits`. */
-  hits: z32.number().int().nonnegative(),
+  hits: z33.number().int().nonnegative(),
   /** Sessions carrying paid-attribution UTM evidence (`utm_medium=cpc`, …). */
-  paidHits: z32.number().int().nonnegative(),
+  paidHits: z33.number().int().nonnegative(),
   /** Sessions with no paid-attribution evidence. Not proof the click was unpaid — an untagged ad click is indistinguishable. */
-  organicHits: z32.number().int().nonnegative(),
+  organicHits: z33.number().int().nonnegative(),
   /**
    * Sessions ingested before the classifier shipped. Their UTM tags were never
    * persisted, so they can never be resolved to paid or organic. Never fold
    * these into `organicHits`.
    */
-  unknownHits: z32.number().int().nonnegative()
+  unknownHits: z33.number().int().nonnegative()
 });
-var trafficEventEntrySchema = z32.discriminatedUnion("kind", [
+var trafficEventEntrySchema = z33.discriminatedUnion("kind", [
   trafficCrawlerEventEntrySchema,
   trafficAiUserFetchEventEntrySchema,
   trafficAiReferralEventEntrySchema
 ]);
-var trafficEventsResponseSchema = z32.object({
-  windowStart: z32.string(),
-  windowEnd: z32.string(),
-  totals: z32.object({
+var trafficEventsResponseSchema = z33.object({
+  windowStart: z33.string(),
+  windowEnd: z33.string(),
+  totals: z33.object({
     /** Total classified-crawler hits across the window. UNCHANGED contract. */
-    crawlerHits: z32.number().int().nonnegative(),
+    crawlerHits: z33.number().int().nonnegative(),
     /** Crawler hits against content/document paths only (= `crawlerSegments.content`). */
-    crawlerContentHits: z32.number().int().nonnegative(),
+    crawlerContentHits: z33.number().int().nonnegative(),
     /** Infrastructure crawler hits — sitemap + robots + asset fetches. */
-    crawlerInfraHits: z32.number().int().nonnegative(),
+    crawlerInfraHits: z33.number().int().nonnegative(),
     /** Full per-class crawler-hit breakdown; the five buckets sum to `crawlerHits`. */
     crawlerSegments: trafficCrawlerSegmentsSchema,
-    aiUserFetchHits: z32.number().int().nonnegative(),
+    aiUserFetchHits: z33.number().int().nonnegative(),
     /** Total AI-referral sessions. The three class buckets below sum to it. */
-    aiReferralHits: z32.number().int().nonnegative(),
+    aiReferralHits: z33.number().int().nonnegative(),
     /** AI-referral sessions carrying paid-attribution UTM evidence. */
-    aiReferralPaidHits: z32.number().int().nonnegative(),
+    aiReferralPaidHits: z33.number().int().nonnegative(),
     /** AI-referral sessions with no paid-attribution evidence. */
-    aiReferralOrganicHits: z32.number().int().nonnegative(),
+    aiReferralOrganicHits: z33.number().int().nonnegative(),
     /** AI-referral sessions ingested before the classifier shipped; unresolvable, never organic. */
-    aiReferralUnknownHits: z32.number().int().nonnegative()
+    aiReferralUnknownHits: z33.number().int().nonnegative()
   }),
-  events: z32.array(trafficEventEntrySchema)
+  events: z33.array(trafficEventEntrySchema)
 });
 
 // ../contracts/src/traffic-path.ts
@@ -5690,14 +5735,14 @@ function round(value, dp = 4) {
   const f = 10 ** dp;
   return (Math.round(value * f) + 0) / f;
 }
-function wilsonInterval(successes, n, z34 = 1.96) {
+function wilsonInterval(successes, n, z35 = 1.96) {
   if (!Number.isFinite(n) || n <= 0) return null;
   const s = Math.max(0, Math.min(successes, n));
   const p = s / n;
-  const z210 = z34 * z34;
+  const z210 = z35 * z35;
   const denom = 1 + z210 / n;
   const center = (p + z210 / (2 * n)) / denom;
-  const margin = z34 / denom * Math.sqrt(p * (1 - p) / n + z210 / (4 * n * n));
+  const margin = z35 / denom * Math.sqrt(p * (1 - p) / n + z210 / (4 * n * n));
   return {
     low: round(Math.max(0, center - margin)),
     high: round(Math.min(1, center + margin))
@@ -5705,118 +5750,241 @@ function wilsonInterval(successes, n, z34 = 1.96) {
 }
 
 // ../contracts/src/ads.ts
-import { z as z33 } from "zod";
-var adsConnectRequestSchema = z33.object({
+import { z as z34 } from "zod";
+var adsConnectRequestSchema = z34.object({
   /** Ads Manager "SDK key" scoped to one ad account. Stored in config.yaml, never the DB. */
-  apiKey: z33.string().min(1)
-});
-var adsConnectionStatusDtoSchema = z33.object({
-  connected: z33.boolean(),
-  adAccountId: z33.string().nullable().optional(),
-  displayName: z33.string().nullable().optional(),
-  currencyCode: z33.string().nullable().optional(),
-  timezone: z33.string().nullable().optional(),
-  status: z33.string().nullable().optional(),
-  lastSyncedAt: z33.string().nullable().optional(),
+  apiKey: z34.string().min(1)
+});
+var adsConnectionStatusDtoSchema = z34.object({
+  connected: z34.boolean(),
+  adAccountId: z34.string().nullable().optional(),
+  displayName: z34.string().nullable().optional(),
+  currencyCode: z34.string().nullable().optional(),
+  timezone: z34.string().nullable().optional(),
+  status: z34.string().nullable().optional(),
+  lastSyncedAt: z34.string().nullable().optional(),
   /** Whether the ad account has OpenAI conversion tracking (pixel or CAPI) configured,
    *  detected from synced campaigns carrying conversion_event_setting_ids. Optional:
    *  only present when connected. */
-  conversionTrackingConfigured: z33.boolean().optional()
-});
-var adsDisconnectResponseSchema = z33.object({
-  disconnected: z33.boolean()
-});
-var adsSyncResponseSchema = z33.object({
-  runId: z33.string(),
-  status: z33.string()
-});
-var adsCreativeDtoSchema = z33.object({
-  type: z33.string().nullable().optional(),
-  title: z33.string().nullable().optional(),
-  body: z33.string().nullable().optional(),
-  targetUrl: z33.string().nullable().optional()
-});
-var adsAdDtoSchema = z33.object({
-  id: z33.string(),
-  adGroupId: z33.string(),
-  name: z33.string(),
-  status: z33.string(),
-  reviewStatus: z33.string().nullable().optional(),
-  creative: adsCreativeDtoSchema.nullable().optional()
-});
-var adsAdGroupDtoSchema = z33.object({
-  id: z33.string(),
-  campaignId: z33.string(),
-  name: z33.string(),
-  status: z33.string(),
-  billingEventType: z33.string().nullable().optional(),
-  maxBidMicros: z33.number().int().nullable().optional(),
+  conversionTrackingConfigured: z34.boolean().optional()
+});
+var adsDisconnectResponseSchema = z34.object({
+  disconnected: z34.boolean()
+});
+var adsSyncResponseSchema = z34.object({
+  runId: z34.string(),
+  status: z34.string()
+});
+var adsCreativeDtoSchema = z34.object({
+  type: z34.string().nullable().optional(),
+  title: z34.string().nullable().optional(),
+  body: z34.string().nullable().optional(),
+  targetUrl: z34.string().nullable().optional(),
+  fileId: z34.string().nullable().optional()
+});
+var adsAdDtoSchema = z34.object({
+  id: z34.string(),
+  adGroupId: z34.string(),
+  name: z34.string(),
+  status: z34.string(),
+  reviewStatus: z34.string().nullable().optional(),
+  creative: adsCreativeDtoSchema.nullable().optional(),
+  upstreamUpdatedAt: z34.number().int().nullable().optional(),
+  syncedAt: z34.string().optional()
+});
+var adsAdGroupDtoSchema = z34.object({
+  id: z34.string(),
+  campaignId: z34.string(),
+  name: z34.string(),
+  description: z34.string().nullable().optional(),
+  status: z34.string(),
+  billingEventType: z34.string().nullable().optional(),
+  maxBidMicros: z34.number().int().nullable().optional(),
   /**
    * The targeting primitive: entries are multi-line strings of
    * newline-separated example queries (the live Ads Manager format).
    */
-  contextHints: z33.array(z33.string()).default([]),
-  ads: z33.array(adsAdDtoSchema).default([])
-});
-var adsCampaignDtoSchema = z33.object({
-  id: z33.string(),
-  name: z33.string(),
-  status: z33.string(),
-  biddingType: z33.string().nullable().optional(),
-  dailySpendLimitMicros: z33.number().int().nullable().optional(),
-  lifetimeSpendLimitMicros: z33.number().int().nullable().optional(),
-  adGroups: z33.array(adsAdGroupDtoSchema).default([])
-});
-var adsCampaignListResponseSchema = z33.object({
-  campaigns: z33.array(adsCampaignDtoSchema)
-});
-var adsInsightLevelSchema = z33.enum(["campaign", "ad_group"]);
+  contextHints: z34.array(z34.string()).default([]),
+  ads: z34.array(adsAdDtoSchema).default([]),
+  upstreamUpdatedAt: z34.number().int().nullable().optional(),
+  syncedAt: z34.string().optional()
+});
+var adsCampaignDtoSchema = z34.object({
+  id: z34.string(),
+  name: z34.string(),
+  description: z34.string().nullable().optional(),
+  status: z34.string(),
+  startTime: z34.number().int().nullable().optional(),
+  endTime: z34.number().int().nullable().optional(),
+  biddingType: z34.string().nullable().optional(),
+  dailySpendLimitMicros: z34.number().int().nullable().optional(),
+  lifetimeSpendLimitMicros: z34.number().int().nullable().optional(),
+  locationIds: z34.array(z34.string()).optional(),
+  adGroups: z34.array(adsAdGroupDtoSchema).default([]),
+  upstreamUpdatedAt: z34.number().int().nullable().optional(),
+  syncedAt: z34.string().optional()
+});
+var adsCampaignListResponseSchema = z34.object({
+  campaigns: z34.array(adsCampaignDtoSchema)
+});
+var adsInsightLevelSchema = z34.enum(["campaign", "ad_group"]);
 var AdsInsightLevels = adsInsightLevelSchema.enum;
-var adsInsightRowDtoSchema = z33.object({
+var adsInsightRowDtoSchema = z34.object({
   level: adsInsightLevelSchema,
-  entityId: z33.string(),
-  date: z33.string(),
-  impressions: z33.number().int(),
-  clicks: z33.number().int(),
-  spendMicros: z33.number().int(),
+  entityId: z34.string(),
+  date: z34.string(),
+  impressions: z34.number().int(),
+  clicks: z34.number().int(),
+  spendMicros: z34.number().int(),
   /** Conversion count for the row. 0 when conversion tracking is not configured.
    *  Conversion VALUE (for ROAS) is a deliberate follow-up: the upstream value
    *  field is not yet captured against a live conversion-tracking account. */
-  conversions: z33.number().int(),
+  conversions: z34.number().int(),
   /** clicks / impressions; null when impressions is 0. */
-  ctr: z33.number().nullable(),
+  ctr: z34.number().nullable(),
   /** spendMicros / clicks, rounded to integer micros; null when clicks is 0. */
-  cpcMicros: z33.number().int().nullable()
+  cpcMicros: z34.number().int().nullable()
 });
-var adsInsightsResponseSchema = z33.object({
-  rows: z33.array(adsInsightRowDtoSchema),
+var adsInsightsResponseSchema = z34.object({
+  rows: z34.array(adsInsightRowDtoSchema),
   /** Account currency for rendering spend/cpc; null before the first sync. */
-  currencyCode: z33.string().nullable().optional()
-});
-var adsTotalsDtoSchema = z33.object({
-  impressions: z33.number().int(),
-  clicks: z33.number().int(),
-  spendMicros: z33.number().int(),
-  conversions: z33.number().int(),
-  ctr: z33.number().nullable(),
-  cpcMicros: z33.number().int().nullable()
-});
-var adsSummaryDtoSchema = z33.object({
-  connected: z33.boolean(),
-  displayName: z33.string().nullable().optional(),
-  currencyCode: z33.string().nullable().optional(),
-  lastSyncedAt: z33.string().nullable().optional(),
-  campaignCount: z33.number().int(),
-  adGroupCount: z33.number().int(),
-  adCount: z33.number().int(),
+  currencyCode: z34.string().nullable().optional()
+});
+var adsTotalsDtoSchema = z34.object({
+  impressions: z34.number().int(),
+  clicks: z34.number().int(),
+  spendMicros: z34.number().int(),
+  conversions: z34.number().int(),
+  ctr: z34.number().nullable(),
+  cpcMicros: z34.number().int().nullable()
+});
+var adsSummaryDtoSchema = z34.object({
+  connected: z34.boolean(),
+  displayName: z34.string().nullable().optional(),
+  currencyCode: z34.string().nullable().optional(),
+  lastSyncedAt: z34.string().nullable().optional(),
+  campaignCount: z34.number().int(),
+  adGroupCount: z34.number().int(),
+  adCount: z34.number().int(),
   /** Date range the totals cover (oldest/newest rollup date), null when empty. */
-  window: z33.object({
-    from: z33.string().nullable(),
-    to: z33.string().nullable()
+  window: z34.object({
+    from: z34.string().nullable(),
+    to: z34.string().nullable()
   }),
   /** Campaign-level rollup totals over the window (levels are not summed across). */
   totals: adsTotalsDtoSchema
 });
+var adsOperationKeySchema = z34.string().min(8).max(128).regex(/^[\w.:-]+$/, "operationKey may contain letters, numbers, dot, underscore, colon, and hyphen");
+var adsEntityIdSchema = z34.string().min(1).max(200);
+var adsNameSchema = z34.string().min(3).max(1e3).refine((value) => value.trim().length > 0);
+var adsTimestampSchema = z34.number().int().min(946684800).max(4102444800);
+var adsMicrosSchema = z34.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+var adsHttpsUrlSchema = z34.string().url().refine((value) => new URL(value).protocol === "https:", {
+  message: "URL must use https"
+});
+var adsOperationKindSchema = z34.enum([
+  "image_upload",
+  "campaign_create",
+  "campaign_update",
+  "campaign_pause",
+  "ad_group_create",
+  "ad_group_update",
+  "ad_group_pause",
+  "ad_create",
+  "ad_update",
+  "ad_pause"
+]);
+var AdsOperationKinds = adsOperationKindSchema.enum;
+var adsOperationStateSchema = z34.enum(["pending", "succeeded", "failed", "unknown"]);
+var AdsOperationStates = adsOperationStateSchema.enum;
+var adsEntityStatusSchema = z34.enum(["active", "paused", "archived"]);
+var AdsEntityStatuses = adsEntityStatusSchema.enum;
+var adsEntityTypeSchema = z34.enum(["file", "campaign", "ad_group", "ad"]);
+var AdsEntityTypes = adsEntityTypeSchema.enum;
+var adsImageUploadRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema,
+  imageUrl: adsHttpsUrlSchema
+});
+var adsCampaignCreateRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema,
+  name: adsNameSchema,
+  description: z34.string().max(4e3).optional(),
+  startTime: adsTimestampSchema.optional(),
+  endTime: adsTimestampSchema.optional(),
+  lifetimeSpendLimitMicros: adsMicrosSchema.min(1e6),
+  locationIds: z34.array(adsEntityIdSchema).min(1).max(100)
+}).superRefine((value, ctx) => {
+  if (value.startTime !== void 0 && value.endTime !== void 0 && value.endTime <= value.startTime) {
+    ctx.addIssue({ code: "custom", path: ["endTime"], message: "endTime must be after startTime" });
+  }
+});
+var adsAdGroupCreateRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema,
+  campaignId: adsEntityIdSchema,
+  name: adsNameSchema,
+  description: z34.string().max(4e3).optional(),
+  contextHints: z34.array(z34.string().min(1).max(1e3)).min(1).max(100),
+  maxBidMicros: adsMicrosSchema.max(1e8)
+});
+var adsChatCardCreativeRequestSchema = z34.object({
+  title: z34.string().min(3).max(50),
+  body: z34.string().min(1).max(100),
+  targetUrl: adsHttpsUrlSchema,
+  fileId: adsEntityIdSchema
+});
+var adsAdCreateRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema,
+  adGroupId: adsEntityIdSchema,
+  name: adsNameSchema,
+  creative: adsChatCardCreativeRequestSchema
+});
+function hasMutationField(value) {
+  return Object.keys(value).some((key) => key !== "operationKey" && key !== "expectedUpdatedAt");
+}
+var adsCampaignUpdateRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema,
+  expectedUpdatedAt: z34.number().int().nonnegative(),
+  name: adsNameSchema.optional(),
+  description: z34.string().max(4e3).nullable().optional(),
+  startTime: adsTimestampSchema.nullable().optional(),
+  endTime: adsTimestampSchema.nullable().optional(),
+  lifetimeSpendLimitMicros: adsMicrosSchema.min(1e6).optional(),
+  locationIds: z34.array(adsEntityIdSchema).min(1).max(100).optional()
+}).refine(hasMutationField, { message: "At least one campaign field must be updated" });
+var adsAdGroupUpdateRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema,
+  expectedUpdatedAt: z34.number().int().nonnegative(),
+  name: adsNameSchema.optional(),
+  description: z34.string().max(4e3).nullable().optional(),
+  contextHints: z34.array(z34.string().min(1).max(1e3)).min(1).max(100).optional(),
+  maxBidMicros: adsMicrosSchema.max(1e8).optional()
+}).refine(hasMutationField, { message: "At least one ad group field must be updated" });
+var adsAdUpdateRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema,
+  expectedUpdatedAt: z34.number().int().nonnegative(),
+  name: adsNameSchema.optional(),
+  creative: adsChatCardCreativeRequestSchema.optional()
+}).refine(hasMutationField, { message: "At least one ad field must be updated" });
+var adsPauseRequestSchema = z34.object({
+  operationKey: adsOperationKeySchema
+});
+var adsOperationDtoSchema = z34.object({
+  id: z34.string(),
+  operationKey: z34.string(),
+  kind: adsOperationKindSchema,
+  state: adsOperationStateSchema,
+  entityType: adsEntityTypeSchema.nullable(),
+  entityId: z34.string().nullable(),
+  upstreamUpdatedAt: z34.number().int().nullable(),
+  errorCode: z34.string().nullable(),
+  errorMessage: z34.string().nullable(),
+  createdAt: z34.string(),
+  updatedAt: z34.string()
+});
+var adsOperationResponseSchema = z34.object({
+  operation: adsOperationDtoSchema,
+  replayed: z34.boolean()
+});
 function adsCtr(clicks, impressions) {
   return impressions > 0 ? clicks / impressions : null;
 }
@@ -6019,6 +6187,7 @@ export {
   notificationCreateRequestSchema,
   AppError,
   notFound,
+  alreadyExists,
   validationError,
   authRequired,
   authInvalid,
@@ -6217,6 +6386,7 @@ export {
   visibilityStateFromAnswerMentioned,
   mentionStateFromAnswerMentioned,
   brandKeyFromText,
+  healthSnapshotDtoSchema,
   agentProvidersResponseDtoSchema,
   MemorySources,
   AGENT_MEMORY_VALUE_MAX_BYTES,
@@ -6313,6 +6483,19 @@ export {
   adsInsightLevelSchema,
   adsInsightsResponseSchema,
   adsSummaryDtoSchema,
+  AdsOperationKinds,
+  AdsOperationStates,
+  AdsEntityStatuses,
+  AdsEntityTypes,
+  adsImageUploadRequestSchema,
+  adsCampaignCreateRequestSchema,
+  adsAdGroupCreateRequestSchema,
+  adsAdCreateRequestSchema,
+  adsCampaignUpdateRequestSchema,
+  adsAdGroupUpdateRequestSchema,
+  adsAdUpdateRequestSchema,
+  adsPauseRequestSchema,
+  adsOperationResponseSchema,
   adsCtr,
   adsCpcMicros,
   dollarsToMicros,
@@ -6323,6 +6506,7 @@ export {
   AI_PROVIDER_INFRA_DOMAINS,
   escapeLikePattern,
   READ_ONLY_SCOPE,
+  ADS_WRITE_SCOPE,
   isReadOnlyKey,
   splitList,
   parseOriginList,