@canonry/canonry 7.0.0 → 7.1.1

package/dist/{chunk-OOUDIVIU.js → chunk-YGHPT5B2.js}

@@ -6278,8 +6278,15 @@ var snapshotDiffResponseSchema = z12.object({
   run2: z12.string(),
   diff: z12.array(snapshotDiffRowSchema)
 });
+var observedQueryCountsSchema = z12.object({
+  totalQueries: z12.number().int().nonnegative(),
+  citedQueries: z12.number().int().nonnegative(),
+  mentionedQueries: z12.number().int().nonnegative()
+});
 var runDetailDtoSchema = runDtoSchema.extend({
   snapshots: z12.array(querySnapshotDtoSchema).optional(),
+  /** Observed queries in this exact run. Null when a snapshot lacks query identity; omitted by older servers. */
+  queryCounts: observedQueryCountsSchema.nullable().optional(),
   /** The run's provider batches, oldest first. Empty when nothing was batched. */
   providerBatches: z12.array(providerBatchSummaryDtoSchema).optional(),
   /** Usage and estimated cost per provider and price tier. Empty when no answer carries usage. */
@@ -9669,14 +9676,14 @@ function breakdownShares(parts) {
   const total = parts.reduce((sum, part) => sum + Math.max(0, part), 0);
   return parts.map((part) => shareOf(part, total) ?? 0);
 }
-function wilsonInterval(successes, n, z70 = 1.96) {
+function wilsonInterval(successes, n, z71 = 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 = z70 * z70;
+  const z210 = z71 * z71;
   const denom = 1 + z210 / n;
   const center = (p + z210 / (2 * n)) / denom;
-  const margin = z70 / denom * Math.sqrt(p * (1 - p) / n + z210 / (4 * n * n));
+  const margin = z71 / 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))
@@ -9976,7 +9983,20 @@ var gscQueryTotalsDtoSchema = z27.object({
    * window paired with only `endDate` spans that many days ending on it. A
    * `null` side is unbounded.
    */
-  window: gscWindowRangeSchema
+  window: gscWindowRangeSchema.extend({
+    /**
+     * The first date with stored per-query rows (either query table), ignoring
+     * the window; `null` with none. The lower edge of what this route can
+     * answer: a window starting before it is only partly covered, because
+     * Search Analytics stores no row for an unfetched day and the sum would
+     * read as low traffic rather than missing data.
+     *
+     * Optional on the wire, like `basis` above: a server older than the field
+     * omits it, which means coverage is unknown, not that no rows are stored.
+     * This route always sends it.
+     */
+    earliestDataDate: z27.string().nullable().optional()
+  })
 });
 var gscUrlInspectionDtoSchema = z27.object({
   id: z27.string(),
@@ -11283,12 +11303,6 @@ function isRetryableHttpError(err) {
       return status >= 500 || status === 429;
     }
   }
-  if (err instanceof Error) {
-    const msg = err.message.toLowerCase();
-    if (msg.includes("fetch failed") || msg.includes("econnreset") || msg.includes("etimedout") || msg.includes("enotfound") || msg.includes("econnrefused") || msg.includes("network error")) {
-      return true;
-    }
-  }
   return true;
 }
 
@@ -16501,6 +16515,19 @@ function normalizeQueryText(value) {
   return value.trim().toLowerCase();
 }
 
+// ../contracts/src/query-counts.ts
+function summarizeObservedQueryCounts(snapshots) {
+  const queries = /* @__PURE__ */ new Set();
+  const cited = /* @__PURE__ */ new Set();
+  const mentioned = /* @__PURE__ */ new Set();
+  for (const snapshot of snapshots) {
+    queries.add(snapshot.queryId);
+    if (snapshot.citationState === CitationStates.cited) cited.add(snapshot.queryId);
+    if (snapshot.answerMentioned === true) mentioned.add(snapshot.queryId);
+  }
+  return { totalQueries: queries.size, citedQueries: cited.size, mentionedQueries: mentioned.size };
+}
+
 // ../contracts/src/citations.ts
 import { z as z55 } from "zod";
 var citationCoverageProviderSchema = z55.object({
@@ -19015,8 +19042,231 @@ function detectAgentRuntime(env) {
   return AGENT_NONE;
 }
 
-// ../contracts/src/feedback.ts
+// ../contracts/src/ui-telemetry.ts
 import { z as z64 } from "zod";
+var UI_PAGES = [
+  "/",
+  "/projects",
+  "/projects/:projectName",
+  "/projects/:projectName/portfolio",
+  "/projects/:projectName/search-console",
+  "/projects/:projectName/conversions",
+  "/projects/:projectName/local",
+  "/projects/:projectName/discovery",
+  "/projects/:projectName/queries",
+  "/projects/:projectName/properties/:targetKey",
+  "/projects/:projectName/report",
+  "/projects/:projectName/activity",
+  "/projects/:projectName/backlinks",
+  "/projects/:projectName/technical-aeo",
+  "/projects/:projectName/history",
+  "/projects/:projectName/settings",
+  "/runs",
+  "/history",
+  "/settings",
+  "/setup",
+  "/backlinks",
+  "/traffic",
+  "/traffic/:projectName/:sourceId",
+  "not-found",
+  "other"
+];
+var uiPageSchema = z64.enum(UI_PAGES);
+var UI_PROJECT_TABS = [
+  "overview",
+  "portfolio",
+  "search-console",
+  "conversions",
+  "local",
+  "discovery",
+  "queries",
+  "properties",
+  "report",
+  "activity",
+  "backlinks",
+  "technical-aeo",
+  "history",
+  "settings",
+  "other"
+];
+var uiProjectTabSchema = z64.enum(UI_PROJECT_TABS);
+var UI_ACTIONS = [
+  "sweep.launch",
+  "sweep.cancel",
+  "site_audit.launch",
+  "project.create",
+  "project.update",
+  "project.delete",
+  "query.add",
+  "query.delete",
+  "query.generate",
+  "competitor.save",
+  "competitor.delete",
+  "schedule.save",
+  "schedule.delete",
+  "provider.save",
+  "settings.save",
+  /** An OAuth flow was started; the connection is not confirmed yet. */
+  "integration.connect_started",
+  /** A connection was confirmed (credentials accepted, or a property/account chosen). */
+  "integration.connect",
+  "integration.disconnect",
+  "traffic.sync",
+  "notification.save",
+  "notification.test",
+  "measurement_plan.publish",
+  "discovery.run",
+  "api_key.create",
+  "api_key.revoke",
+  "export.download",
+  "report.download",
+  "aero.open",
+  "aero.send",
+  /** A shared filter settled on a new value (debounced; the value is never sent). */
+  "filter.change",
+  /** A table search settled on a non-empty query (debounced or Enter; the text is never sent). */
+  "search.submit"
+];
+var uiActionSchema = z64.enum(UI_ACTIONS);
+var UI_INTEGRATIONS = [
+  "google",
+  "gsc",
+  "ga",
+  "bing",
+  "gbp",
+  "wordpress",
+  "openai_ads",
+  "google_ads",
+  "gtm",
+  "traffic_cloudflare",
+  "traffic_vercel",
+  "traffic_cloud_run",
+  "traffic_wordpress"
+];
+var uiIntegrationSchema = z64.enum(UI_INTEGRATIONS);
+var UI_FILTERS = ["provider", "model", "location", "window", "query_class", "other"];
+var uiFilterSchema = z64.enum(UI_FILTERS);
+var UI_EXPORT_FORMATS = ["csv", "json", "html"];
+var UI_ERROR_KINDS = ["render", "unhandled", "api"];
+var UI_STATUS_CLASSES = ["4xx", "5xx", "network"];
+var UI_VITAL_METRICS = ["LCP", "INP", "CLS", "FCP", "TTFB"];
+var UI_VITAL_RATINGS = ["good", "needs-improvement", "poor"];
+var UI_COMPONENT_PATTERN = /^[a-z][a-z0-9-]{0,39}$/;
+var UI_ERROR_NAME_PATTERN = /^[a-z_$][\w$]{0,39}$/i;
+var UI_API_ROUTE_PATTERN = /^\/api\/v1(?:\/(?:[a-z][a-z0-9-]*(?:\.[a-z]+)?|\{[A-Za-z]+\}))*$/;
+var UI_API_ROUTE_MAX_LENGTH = 160;
+var UI_ROUTE_ID_COLLECTIONS = /* @__PURE__ */ new Set([
+  "accounts",
+  "activation-grants",
+  "ad-groups",
+  "ads",
+  "cache",
+  "campaigns",
+  "competitors",
+  "confirm",
+  "connections",
+  "containers",
+  "contracts",
+  "conversations",
+  "dismissals",
+  "insights",
+  "jobs",
+  "keys",
+  "locations",
+  "measurement-query-sets",
+  "measurement-query-templates",
+  "notifications",
+  "operations",
+  "projects",
+  "providers",
+  "queries",
+  "recommendations",
+  "runs",
+  "screenshots",
+  "segments",
+  "sessions",
+  "snapshots",
+  "sources",
+  "users",
+  "versions"
+]);
+var UI_ROUTE_FIXED_CHILDREN = /* @__PURE__ */ new Set([
+  "ads/account",
+  "ads/activation-grants",
+  "ads/ad-groups",
+  "ads/ads",
+  "ads/campaigns",
+  "ads/connect",
+  "ads/connection",
+  "ads/conversions",
+  "ads/delivery-diagnostics",
+  "ads/files",
+  "ads/geo",
+  "ads/insights",
+  "ads/live-delivery",
+  "ads/operations",
+  "ads/status",
+  "ads/summary",
+  "ads/sync",
+  "keys/self",
+  "locations/default",
+  "locations/discover",
+  "notifications/events",
+  "operations/logs",
+  "queries/generate",
+  "queries/replace-preview",
+  "runs/latest",
+  "snapshots/diff"
+]);
+var PARAM_SEGMENT = /^\{[a-z]+\}$/i;
+function isUiApiRouteTemplate(route) {
+  if (route.length > UI_API_ROUTE_MAX_LENGTH || route.includes("://")) return false;
+  if (!UI_API_ROUTE_PATTERN.test(route)) return false;
+  const segments = route.split("/").slice(3);
+  return segments.every((segment, index) => {
+    const previous = segments[index - 1];
+    if (previous === void 0 || !UI_ROUTE_ID_COLLECTIONS.has(previous)) return true;
+    return PARAM_SEGMENT.test(segment) || UI_ROUTE_FIXED_CHILDREN.has(`${previous}/${segment}`);
+  });
+}
+var uiEventBaseSchema = z64.object({
+  eventId: z64.string().uuid(),
+  uiSessionId: z64.string().uuid(),
+  page: uiPageSchema
+});
+var uiTelemetryEventSchema = z64.discriminatedUnion("event", [
+  uiEventBaseSchema.extend({
+    event: z64.literal("ui.page_viewed"),
+    tab: uiProjectTabSchema.optional()
+  }).strict(),
+  uiEventBaseSchema.extend({
+    event: z64.literal("ui.action"),
+    action: uiActionSchema,
+    tab: uiProjectTabSchema.optional(),
+    integration: uiIntegrationSchema.optional(),
+    format: z64.enum(UI_EXPORT_FORMATS).optional(),
+    filter: uiFilterSchema.optional()
+  }).strict(),
+  uiEventBaseSchema.extend({
+    event: z64.literal("ui.error"),
+    kind: z64.enum(UI_ERROR_KINDS),
+    tab: uiProjectTabSchema.optional(),
+    component: z64.string().regex(UI_COMPONENT_PATTERN).optional(),
+    errorName: z64.string().regex(UI_ERROR_NAME_PATTERN).optional(),
+    route: z64.string().max(UI_API_ROUTE_MAX_LENGTH).refine(isUiApiRouteTemplate, "route must be a route template").optional(),
+    method: z64.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional(),
+    statusClass: z64.enum(UI_STATUS_CLASSES).optional(),
+    status: z64.number().int().min(400).max(599).optional()
+  }).strict(),
+  uiEventBaseSchema.extend({
+    event: z64.literal("ui.vitals"),
+    metric: z64.enum(UI_VITAL_METRICS),
+    rating: z64.enum(UI_VITAL_RATINGS)
+  }).strict()
+]);
+
+// ../contracts/src/feedback.ts
+import { z as z65 } from "zod";
 
 // ../contracts/src/log-redaction.ts
 var REDACTED = "[REDACTED]";
@@ -19168,7 +19418,7 @@ function redactEmbeddedUrls(value) {
 
 // ../contracts/src/feedback.ts
 var FEEDBACK_KINDS = ["struggle", "bug", "improvement", "other"];
-var feedbackKindSchema = z64.enum(FEEDBACK_KINDS);
+var feedbackKindSchema = z65.enum(FEEDBACK_KINDS);
 var FEEDBACK_LIMITS = {
   summary: 500,
   details: 4e3,
@@ -19176,17 +19426,17 @@ var FEEDBACK_LIMITS = {
   command: 120,
   errorCode: 40
 };
-var feedbackSubmissionSchema = z64.object({
+var feedbackSubmissionSchema = z65.object({
   kind: feedbackKindSchema,
-  summary: z64.string().trim().min(1).max(FEEDBACK_LIMITS.summary),
-  details: z64.string().trim().min(1).max(FEEDBACK_LIMITS.details).optional(),
-  area: z64.string().trim().min(1).max(FEEDBACK_LIMITS.area).optional(),
-  command: z64.string().trim().min(1).max(FEEDBACK_LIMITS.command).optional(),
-  errorCode: z64.string().trim().min(1).max(FEEDBACK_LIMITS.errorCode).optional()
+  summary: z65.string().trim().min(1).max(FEEDBACK_LIMITS.summary),
+  details: z65.string().trim().min(1).max(FEEDBACK_LIMITS.details).optional(),
+  area: z65.string().trim().min(1).max(FEEDBACK_LIMITS.area).optional(),
+  command: z65.string().trim().min(1).max(FEEDBACK_LIMITS.command).optional(),
+  errorCode: z65.string().trim().min(1).max(FEEDBACK_LIMITS.errorCode).optional()
 }).strict();
-var feedbackAcceptedDtoSchema = z64.object({
-  accepted: z64.boolean(),
-  id: z64.string()
+var feedbackAcceptedDtoSchema = z65.object({
+  accepted: z65.boolean(),
+  id: z65.string()
 });
 function redactFeedbackText(value, limit) {
   return truncateUtf16(
@@ -19203,90 +19453,90 @@ var SECRET_FLAG_VALUE = /(?<=^|[ \t])(--?(?:[a-z\d]+-)*(?:key|token|secret|passw
 var BARE_CREDENTIAL = /\b(?:sk-[\w-]{16,}|AIza[\w-]{30,}|pplx-[A-Za-z0-9]{16,}|gh[pousr]_[A-Za-z0-9]{20,}|github_pat_\w{20,}|cnry_[\w-]{16,})/g;
 
 // ../contracts/src/operational-logs.ts
-import { z as z65 } from "zod";
-var operationalLogLevelSchema = z65.enum(["trace", "debug", "info", "warn", "error", "fatal"]);
-var diagnosticContextSchema = z65.object({
-  runId: z65.string().min(1).max(256).optional(),
-  projectId: z65.string().min(1).max(256).optional(),
-  requestId: z65.string().min(1).max(256).optional(),
-  actor: z65.string().min(1).max(512).optional(),
-  credentialId: z65.string().min(1).max(512).optional(),
-  userAgent: z65.string().min(1).max(512).optional(),
-  actorSession: z65.string().min(1).max(512).optional(),
-  method: z65.string().min(1).max(16).optional(),
-  route: z65.string().min(1).max(256).optional(),
-  operationId: z65.string().min(1).max(256).optional(),
-  jobId: z65.string().min(1).max(256).optional(),
-  taskId: z65.string().min(1).max(256).optional(),
-  traceId: z65.string().min(1).max(256).optional(),
-  provider: z65.string().min(1).max(256).optional(),
-  errorCode: z65.string().min(1).max(128).optional(),
-  attempt: z65.number().finite().optional(),
-  count: z65.number().finite().optional(),
-  total: z65.number().finite().optional(),
-  progress: z65.number().finite().optional(),
-  httpStatus: z65.number().finite().optional(),
-  statusCode: z65.number().finite().optional(),
-  durationMs: z65.number().finite().optional(),
-  bytes: z65.number().finite().optional(),
-  retryAfterMs: z65.number().finite().optional(),
-  retriable: z65.boolean().optional(),
-  retrying: z65.boolean().optional(),
-  cancelled: z65.boolean().optional(),
-  success: z65.boolean().optional()
-}).strict();
-var operationalLogEntryDtoSchema = z65.object({
-  cursor: z65.string().min(1).max(512),
-  ts: z65.string().datetime(),
+import { z as z66 } from "zod";
+var operationalLogLevelSchema = z66.enum(["trace", "debug", "info", "warn", "error", "fatal"]);
+var diagnosticContextSchema = z66.object({
+  runId: z66.string().min(1).max(256).optional(),
+  projectId: z66.string().min(1).max(256).optional(),
+  requestId: z66.string().min(1).max(256).optional(),
+  actor: z66.string().min(1).max(512).optional(),
+  credentialId: z66.string().min(1).max(512).optional(),
+  userAgent: z66.string().min(1).max(512).optional(),
+  actorSession: z66.string().min(1).max(512).optional(),
+  method: z66.string().min(1).max(16).optional(),
+  route: z66.string().min(1).max(256).optional(),
+  operationId: z66.string().min(1).max(256).optional(),
+  jobId: z66.string().min(1).max(256).optional(),
+  taskId: z66.string().min(1).max(256).optional(),
+  traceId: z66.string().min(1).max(256).optional(),
+  provider: z66.string().min(1).max(256).optional(),
+  errorCode: z66.string().min(1).max(128).optional(),
+  attempt: z66.number().finite().optional(),
+  count: z66.number().finite().optional(),
+  total: z66.number().finite().optional(),
+  progress: z66.number().finite().optional(),
+  httpStatus: z66.number().finite().optional(),
+  statusCode: z66.number().finite().optional(),
+  durationMs: z66.number().finite().optional(),
+  bytes: z66.number().finite().optional(),
+  retryAfterMs: z66.number().finite().optional(),
+  retriable: z66.boolean().optional(),
+  retrying: z66.boolean().optional(),
+  cancelled: z66.boolean().optional(),
+  success: z66.boolean().optional()
+}).strict();
+var operationalLogEntryDtoSchema = z66.object({
+  cursor: z66.string().min(1).max(512),
+  ts: z66.string().datetime(),
   level: operationalLogLevelSchema,
-  module: z65.string().min(1).max(256),
-  action: z65.string().min(1).max(256),
-  message: z65.string().max(4096).optional(),
-  runId: z65.string().min(1).max(256).optional(),
-  projectId: z65.string().min(1).max(256).optional(),
+  module: z66.string().min(1).max(256),
+  action: z66.string().min(1).max(256),
+  message: z66.string().max(4096).optional(),
+  runId: z66.string().min(1).max(256).optional(),
+  projectId: z66.string().min(1).max(256).optional(),
   context: diagnosticContextSchema
 }).strict();
-var logQuerySchema = z65.object({
+var logQuerySchema = z66.object({
   level: operationalLogLevelSchema.optional(),
-  module: z65.string().trim().min(1).max(256).optional(),
-  runId: z65.string().trim().min(1).max(256).optional(),
-  projectId: z65.string().trim().min(1).max(256).optional(),
-  actor: z65.string().trim().min(1).max(512).optional(),
-  requestId: z65.string().trim().min(1).max(256).optional(),
-  since: z65.string().datetime().optional(),
-  until: z65.string().datetime().optional(),
-  limit: z65.coerce.number().int().min(1).max(200).default(100),
-  cursor: z65.string().trim().min(1).max(512).optional()
+  module: z66.string().trim().min(1).max(256).optional(),
+  runId: z66.string().trim().min(1).max(256).optional(),
+  projectId: z66.string().trim().min(1).max(256).optional(),
+  actor: z66.string().trim().min(1).max(512).optional(),
+  requestId: z66.string().trim().min(1).max(256).optional(),
+  since: z66.string().datetime().optional(),
+  until: z66.string().datetime().optional(),
+  limit: z66.coerce.number().int().min(1).max(200).default(100),
+  cursor: z66.string().trim().min(1).max(512).optional()
 }).strict().superRefine((query, ctx) => {
   if (query.since && query.until && Date.parse(query.since) > Date.parse(query.until)) {
-    ctx.addIssue({ code: z65.ZodIssueCode.custom, path: ["until"], message: '"until" must be on or after "since".' });
+    ctx.addIssue({ code: z66.ZodIssueCode.custom, path: ["until"], message: '"until" must be on or after "since".' });
   }
 });
-var retentionPolicySchema = z65.object({
-  maxEntries: z65.number().int().positive(),
-  maxAgeSeconds: z65.number().int().positive()
+var retentionPolicySchema = z66.object({
+  maxEntries: z66.number().int().positive(),
+  maxAgeSeconds: z66.number().int().positive()
 }).strict();
-var operationalLogListDtoSchema = z65.object({
-  entries: z65.array(operationalLogEntryDtoSchema),
-  nextCursor: z65.string().min(1).max(512).nullable(),
+var operationalLogListDtoSchema = z66.object({
+  entries: z66.array(operationalLogEntryDtoSchema),
+  nextCursor: z66.string().min(1).max(512).nullable(),
   /** Matching entries left after this page. */
-  truncated: z65.number().int().nonnegative(),
+  truncated: z66.number().int().nonnegative(),
   /** Entries evicted by the active retention policy. */
-  dropped: z65.number().int().nonnegative(),
-  retention: z65.enum(["process", "durable"]),
+  dropped: z66.number().int().nonnegative(),
+  retention: z66.enum(["process", "durable"]),
   retentionPolicy: retentionPolicySchema.optional(),
   /** Best-effort persistence failures observed by this store. */
-  captureErrors: z65.number().int().nonnegative().optional(),
-  observedAt: z65.string().datetime()
+  captureErrors: z66.number().int().nonnegative().optional(),
+  observedAt: z66.string().datetime()
 }).strict();
 var OPERATIONAL_LOG_FIELDS_HEADER = "x-canonry-log-fields";
 var OPERATIONAL_LOG_OPT_IN_CONTEXT_FIELDS = ["provider"];
-var diagnosticContextReadSchema = z65.object(diagnosticContextSchema.shape);
-var operationalLogEntryReadSchema = z65.object({ ...operationalLogEntryDtoSchema.shape, context: diagnosticContextReadSchema });
-var operationalLogListReadSchema = z65.object({
+var diagnosticContextReadSchema = z66.object(diagnosticContextSchema.shape);
+var operationalLogEntryReadSchema = z66.object({ ...operationalLogEntryDtoSchema.shape, context: diagnosticContextReadSchema });
+var operationalLogListReadSchema = z66.object({
   ...operationalLogListDtoSchema.shape,
-  entries: z65.array(operationalLogEntryReadSchema),
-  retentionPolicy: z65.object(retentionPolicySchema.shape).optional()
+  entries: z66.array(operationalLogEntryReadSchema),
+  retentionPolicy: z66.object(retentionPolicySchema.shape).optional()
 });
 
 // ../contracts/src/semver.ts
@@ -19352,38 +19602,38 @@ function asRecord(value) {
 }
 
 // ../contracts/src/referral-assessment.ts
-import { z as z66 } from "zod";
-var referralAssessmentQuerySchema = z66.object({
+import { z as z67 } from "zod";
+var referralAssessmentQuerySchema = z67.object({
   startDate: calendarDateSchema,
   endDate: calendarDateSchema,
-  sourceId: z66.string().trim().min(1).optional(),
-  burstThreshold: z66.number().int().min(1).max(1e6).optional(),
-  ratioThreshold: z66.number().min(1).max(1e3).optional(),
-  limit: z66.number().int().min(1).max(500).optional()
-}).strict();
-var countsSchema = z66.object({
-  total: z66.number().int().nonnegative(),
-  paid: z66.number().int().nonnegative(),
-  organic: z66.number().int().nonnegative(),
-  unknown: z66.number().int().nonnegative()
-});
-var referralAssessmentSchema = z66.object({
-  scope: z66.object({
-    project: z66.string(),
-    sourceId: z66.string().nullable(),
-    attribution: z66.literal("project-source-only"),
-    unavailableDimensions: z66.array(z66.enum(["property", "target", "market"]))
+  sourceId: z67.string().trim().min(1).optional(),
+  burstThreshold: z67.number().int().min(1).max(1e6).optional(),
+  ratioThreshold: z67.number().min(1).max(1e3).optional(),
+  limit: z67.number().int().min(1).max(500).optional()
+}).strict();
+var countsSchema = z67.object({
+  total: z67.number().int().nonnegative(),
+  paid: z67.number().int().nonnegative(),
+  organic: z67.number().int().nonnegative(),
+  unknown: z67.number().int().nonnegative()
+});
+var referralAssessmentSchema = z67.object({
+  scope: z67.object({
+    project: z67.string(),
+    sourceId: z67.string().nullable(),
+    attribution: z67.literal("project-source-only"),
+    unavailableDimensions: z67.array(z67.enum(["property", "target", "market"]))
   }),
-  window: z66.object({ startDate: calendarDateSchema, endDate: calendarDateSchema, timeZone: z66.literal("UTC") }),
-  rule: z66.object({
-    version: z66.literal("hourly-normalized-path-v1"),
-    burstThreshold: z66.number().int().positive(),
-    ratioThreshold: z66.number().positive(),
-    calibration: z66.enum(["uncalibrated-default", "request-override"]),
-    grouping: z66.array(z66.string()),
-    confirmsAutomation: z66.literal(false)
+  window: z67.object({ startDate: calendarDateSchema, endDate: calendarDateSchema, timeZone: z67.literal("UTC") }),
+  rule: z67.object({
+    version: z67.literal("hourly-normalized-path-v1"),
+    burstThreshold: z67.number().int().positive(),
+    ratioThreshold: z67.number().positive(),
+    calibration: z67.enum(["uncalibrated-default", "request-override"]),
+    grouping: z67.array(z67.string()),
+    confirmsAutomation: z67.literal(false)
   }),
-  totals: z66.object({
+  totals: z67.object({
     raw: countsSchema,
     redirects: countsSchema,
     subresources: countsSchema,
@@ -19391,42 +19641,42 @@ var referralAssessmentSchema = z66.object({
     suspected: countsSchema,
     adjustedEstimate: countsSchema
   }),
-  bursts: z66.array(z66.object({
-    sourceId: z66.string(),
-    product: z66.string(),
-    landingPathNormalized: z66.string(),
-    tsHour: z66.string(),
+  bursts: z67.array(z67.object({
+    sourceId: z67.string(),
+    product: z67.string(),
+    landingPathNormalized: z67.string(),
+    tsHour: z67.string(),
     counts: countsSchema
   })),
-  evidence: z66.object({ total: z66.number().int().nonnegative(), returned: z66.number().int().nonnegative(), truncated: z66.boolean() }),
-  comparison: z66.object({
-    status: z66.literal("unavailable"),
-    serverCountable: z66.number().int().nonnegative(),
-    serverObservation: z66.enum(["missing", "observed-zero", "observed-positive"]),
+  evidence: z67.object({ total: z67.number().int().nonnegative(), returned: z67.number().int().nonnegative(), truncated: z67.boolean() }),
+  comparison: z67.object({
+    status: z67.literal("unavailable"),
+    serverCountable: z67.number().int().nonnegative(),
+    serverObservation: z67.enum(["missing", "observed-zero", "observed-positive"]),
     /**
      * Dimension-deduplicated GA AI sessions. With no stored AI row in the
      * window: `0` (`observed-zero`) when the latest GA sync queried the whole
      * window (GA4 omits zero rows), else `null` (`missing`).
      */
-    gaSessions: z66.number().int().nonnegative().nullable(),
-    gaObservation: z66.enum(["missing", "observed-zero", "observed-positive"]),
+    gaSessions: z67.number().int().nonnegative().nullable(),
+    gaObservation: z67.enum(["missing", "observed-zero", "observed-positive"]),
     /**
      * Descriptive quotient only (`serverCountable / gaSessions`, a multiplier
      * where 3 is three times as many, never a percent), rounded to 2
      * decimals. Not a matched, coverage-complete comparison.
      */
-    observedRatio: z66.number().nonnegative().nullable(),
+    observedRatio: z67.number().nonnegative().nullable(),
     /** Compares the rounded `observedRatio` with `rule.ratioThreshold`. */
-    observedRatioAboveThreshold: z66.boolean().nullable(),
-    ratio: z66.null(),
-    reasons: z66.array(z66.string()),
-    gaScope: z66.literal("project")
+    observedRatioAboveThreshold: z67.boolean().nullable(),
+    ratio: z67.null(),
+    reasons: z67.array(z67.string()),
+    gaScope: z67.literal("project")
   }),
-  caveats: z66.array(z66.string())
+  caveats: z67.array(z67.string())
 });
 
 // ../contracts/src/tolerant-read.ts
-import { z as z67 } from "zod";
+import { z as z68 } from "zod";
 var WRAPPER_TYPES = /* @__PURE__ */ new Set(["optional", "nullable", "default", "prefault", "readonly", "catch", "nonoptional"]);
 var DEPTH_LIMIT = 64;
 function defOf(schema) {
@@ -19437,9 +19687,9 @@ function cloneWith(schema, changes) {
 }
 function openPrimitive(values) {
   if (values.length === 0) return void 0;
-  if (values.every((value) => typeof value === "string")) return z67.string();
-  if (values.every((value) => typeof value === "number")) return z67.number();
-  if (values.every((value) => typeof value === "boolean")) return z67.boolean();
+  if (values.every((value) => typeof value === "string")) return z68.string();
+  if (values.every((value) => typeof value === "number")) return z68.number();
+  if (values.every((value) => typeof value === "boolean")) return z68.boolean();
   return void 0;
 }
 function walk2(schema, open, memo, depth) {
@@ -19453,7 +19703,7 @@ function walk2(schema, open, memo, depth) {
     const shape = Object.fromEntries(Object.entries(schema.shape).map(([key, child]) => [key, next(child)]));
     const declared = def.catchall;
     const catchall = open.get(schema) ?? (declared && defOf(declared).type !== "never" ? next(declared) : void 0);
-    result = catchall ? z67.object(shape).catchall(catchall) : z67.object(shape);
+    result = catchall ? z68.object(shape).catchall(catchall) : z68.object(shape);
   } else if (WRAPPER_TYPES.has(def.type)) {
     const inner = def.innerType;
     const mapped = next(inner);
@@ -19470,10 +19720,10 @@ function walk2(schema, open, memo, depth) {
     const options = def.options;
     const mapped = options.map(next);
     const changed = mapped.some((option, index) => option !== options[index]);
-    result = !changed ? schema : def.discriminator ? z67.union(mapped) : cloneWith(schema, { options: mapped });
+    result = !changed ? schema : def.discriminator ? z68.union(mapped) : cloneWith(schema, { options: mapped });
   } else if (def.type === "record") {
     const keyType = def.keyType, valueType = def.valueType;
-    const mappedKey = defOf(keyType).type === "enum" ? z67.string() : keyType;
+    const mappedKey = defOf(keyType).type === "enum" ? z68.string() : keyType;
     const mappedValue = next(valueType);
     result = mappedKey === keyType && mappedValue === valueType ? schema : cloneWith(schema, { keyType: mappedKey, valueType: mappedValue });
   } else if (def.type === "intersection") {
@@ -19489,7 +19739,7 @@ function walk2(schema, open, memo, depth) {
     result = changed ? cloneWith(schema, { items: mappedItems, rest: mappedRest }) : schema;
   } else if (def.type === "lazy") {
     const getter = def.getter;
-    result = z67.lazy(() => next(getter()));
+    result = z68.lazy(() => next(getter()));
   } else if (def.type === "enum") {
     result = openPrimitive(Object.values(def.entries)) ?? schema;
   } else if (def.type === "literal") {
@@ -19504,8 +19754,8 @@ function tolerantReadSchema(schema, options = {}) {
 }
 
 // ../contracts/src/sentiment-read.ts
-import { z as z68 } from "zod";
-var OPEN_COUNTS = { openKeys: [[sentimentCountsSchema, z68.number().int().nonnegative()]] };
+import { z as z69 } from "zod";
+var OPEN_COUNTS = { openKeys: [[sentimentCountsSchema, z69.number().int().nonnegative()]] };
 var sentimentSettingsReadSchema = tolerantReadSchema(sentimentSettingsSchema, OPEN_COUNTS);
 var sentimentSummaryReadSchema = tolerantReadSchema(sentimentSummarySchema, OPEN_COUNTS);
 var sentimentEvidencePageReadSchema = tolerantReadSchema(sentimentEvidencePageSchema, OPEN_COUNTS);
@@ -19515,10 +19765,10 @@ var sentimentJobReadSchema = tolerantReadSchema(sentimentJobSchema, OPEN_COUNTS)
 var sentimentJobsReadSchema = tolerantReadSchema(sentimentJobsSchema, OPEN_COUNTS);
 
 // ../contracts/src/traffic-analytics.ts
-import { z as z69 } from "zod";
+import { z as z70 } from "zod";
 var TRAFFIC_ANALYTICS_PERIOD_OPTIONS = [7, 14, 30, 90];
 var TRAFFIC_ANALYTICS_DEFAULT_PERIOD_DAYS = 30;
-var trafficAnalyticsPeriodSchema = z69.union([z69.literal(7), z69.literal(14), z69.literal(30), z69.literal(90)]).describe("Traffic activity window in days (7, 14, 30, or 90). Defaults to 30 when omitted.");
+var trafficAnalyticsPeriodSchema = z70.union([z70.literal(7), z70.literal(14), z70.literal(30), z70.literal(90)]).describe("Traffic activity window in days (7, 14, 30, or 90). Defaults to 30 when omitted.");
 function parseTrafficAnalyticsPeriod(value) {
   if (value === void 0 || value === null || value === "") return TRAFFIC_ANALYTICS_DEFAULT_PERIOD_DAYS;
   const parsed = typeof value === "number" ? value : Number(value);
@@ -19528,17 +19778,17 @@ function parseTrafficAnalyticsPeriod(value) {
   }
   return result.data;
 }
-var trafficActivityCountSchema = z69.object({ current: z69.number(), prior: z69.number(), deltaPct: percent().nullable() });
-var trafficActivitySummarySchema = z69.object({
+var trafficActivityCountSchema = z70.object({ current: z70.number(), prior: z70.number(), deltaPct: percent().nullable() });
+var trafficActivitySummarySchema = z70.object({
   /** ISO8601 inclusive lower bound of the selected window (default: 30 days). */
-  windowStart: z69.string(),
+  windowStart: z70.string(),
   /** ISO8601 inclusive upper bound. */
-  windowEnd: z69.string(),
+  windowEnd: z70.string(),
   /** Earliest stored project observation across crawler, user-fetch and referral hourly rows; not window-bound. */
-  coverageStart: z69.string().nullable(),
+  coverageStart: z70.string().nullable(),
   /** Recording began on or before the prior window start. This does not establish uninterrupted ingestion. */
-  priorWindowComplete: z69.boolean(),
-  hasData: z69.boolean().describe("True when the selected or prior window has stored crawler, user-fetch, countable referral or operator evidence, or the selected window has referral redirects. False means no qualifying stored evidence; it can occur with no, paused, errored or never-synced ingestion and out-of-window observations. It does not establish measured zero traffic or source health."),
+  priorWindowComplete: z70.boolean(),
+  hasData: z70.boolean().describe("True when the selected or prior window has stored crawler, user-fetch, countable referral or operator evidence, or the selected window has referral redirects. False means no qualifying stored evidence; it can occur with no, paused, errored or never-synced ingestion and out-of-window observations. It does not establish measured zero traffic or source health."),
   /** Verified crawler hits during the selected period and the equal preceding period. */
   verifiedCrawlerHits: trafficActivityCountSchema,
   /** Unverified crawler hits during the selected period, separate from verified hits. */
@@ -19567,7 +19817,7 @@ var trafficActivitySummarySchema = z69.object({
    * is exactly the thing to fix, so the summary must show it rather
    * than render an empty section.
    */
-  referralRedirects: z69.number().int().nonnegative(),
+  referralRedirects: z70.number().int().nonnegative(),
   /**
    * `referralArrivals` split by traffic class. The three buckets sum to it.
    *
@@ -19576,31 +19826,31 @@ var trafficActivitySummarySchema = z69.object({
    * never be resolved. Reporting them as organic would overstate earned AI
    * traffic by exactly a client's ad volume.
    */
-  referralArrivalsByClass: z69.object({
+  referralArrivalsByClass: z70.object({
     paid: trafficActivityCountSchema,
     organic: trafficActivityCountSchema,
     unclassified: trafficActivityCountSchema
   }),
   /** Pre-rendered one-line breakdown, e.g. "Paid 1,200 · Organic 24". Empty when there is nothing to split. */
-  referralArrivalsClassSummary: z69.string(),
+  referralArrivalsClassSummary: z70.string(),
   /** Per-AI-operator breakdown (OpenAI, Anthropic, Google AI, Perplexity, …). */
-  byOperator: z69.array(z69.object({
-    operator: z69.string(),
-    verifiedHits: z69.number(),
+  byOperator: z70.array(z70.object({
+    operator: z70.string(),
+    verifiedHits: z70.number(),
     /** claimed-bot UA, source IP not in a published range. */
-    unverifiedHits: z69.number(),
+    unverifiedHits: z70.number(),
     /** Per-user fetches from this operator's AI surface (ChatGPT-User, …). */
-    userFetchHits: z69.number(),
-    referralArrivals: z69.number(),
+    userFetchHits: z70.number(),
+    referralArrivals: z70.number(),
     deltaPct: percent().nullable()
   })),
   /**
    * Top crawled paths during the selected period, with both verified and
    * unverified crawler hits. These are request counts, not citation evidence.
    */
-  topCrawledPaths: z69.array(z69.object({
-    path: z69.string(),
-    verifiedHits: z69.number(),
+  topCrawledPaths: z70.array(z70.object({
+    path: z70.string(),
+    verifiedHits: z70.number(),
     /**
      * Hits from a crawler that identified itself but whose source IP could not
      * be matched against the operator's published ranges. Additive, not an
@@ -19608,36 +19858,36 @@ var trafficActivitySummarySchema = z69.object({
      * logs, for one), so for those projects every hit lands here and a
      * verified-only view reports zero against real crawl activity.
      */
-    unverifiedHits: z69.number().default(0),
+    unverifiedHits: z70.number().default(0),
     /** How many distinct AI operators crawled this path in the window. */
-    distinctOperators: z69.number()
+    distinctOperators: z70.number()
   })),
   /** AI products that sent ≥1 session in the window (referral by destination). */
-  referralProducts: z69.array(z69.object({
-    product: z69.string(),
-    arrivals: z69.number(),
-    distinctLandingPaths: z69.number()
+  referralProducts: z70.array(z70.object({
+    product: z70.string(),
+    arrivals: z70.number(),
+    distinctLandingPaths: z70.number()
   })),
   /** Daily request counts during the selected period. */
-  dailyTrend: z69.array(z69.object({
-    date: z69.string(),
-    verifiedCrawlerHits: z69.number(),
+  dailyTrend: z70.array(z70.object({
+    date: z70.string(),
+    verifiedCrawlerHits: z70.number(),
     /** See topCrawledPaths.unverifiedHits. Plotted alongside, never instead. */
-    unverifiedCrawlerHits: z69.number().default(0),
-    userFetchHits: z69.number(),
-    referralArrivals: z69.number()
+    unverifiedCrawlerHits: z70.number().default(0),
+    userFetchHits: z70.number(),
+    referralArrivals: z70.number()
   })),
   /**
    * Top landing paths for AI-referral sessions during the selected period.
    * Complements crawler paths with server-observed referral arrivals.
    */
-  topReferralLandingPaths: z69.array(z69.object({
-    path: z69.string(),
-    arrivals: z69.number(),
-    distinctProducts: z69.number()
+  topReferralLandingPaths: z70.array(z70.object({
+    path: z70.string(),
+    arrivals: z70.number(),
+    distinctProducts: z70.number()
   }))
 });
-var trafficAnalyticsResponseSchema = z69.object({
+var trafficAnalyticsResponseSchema = z70.object({
   /** Null when no non-archived traffic source is connected. Connected sources without events return zero counts. */
   activity: trafficActivitySummarySchema.nullable()
 });
@@ -20368,6 +20618,7 @@ export {
   groupIsoDateRanges,
   deriveIndexCoverage,
   normalizeQueryText,
+  summarizeObservedQueryCounts,
   citationVisibilityResponseSchema,
   emptyCitationVisibility,
   citationStateToCited,
@@ -20544,6 +20795,7 @@ export {
   AGENT_NONE,
   normalizeAgentSlug,
   detectAgentRuntime,
+  uiTelemetryEventSchema,
   isSensitiveDiagnosticQueryKey,
   redactLogValue,
   redactLogString,