@ainyc/canonry 4.186.7 → 4.186.9

package/dist/{chunk-CFJHRXZ3.js → chunk-LNBX7RTN.js}

@@ -50,6 +50,14 @@ function forbidden(message = "Forbidden", details) {
 function quotaExceeded(metric, details) {
   return new AppError("QUOTA_EXCEEDED", `Quota exceeded for ${metric}`, 429, details);
 }
+function researchDailyLimitExceeded(projectName, limit, date) {
+  return new AppError(
+    "RESEARCH_DAILY_LIMIT_EXCEEDED",
+    `The viewer research run limit for this project has been reached today (${limit}). Try again tomorrow or ask an administrator.`,
+    429,
+    { projectName, limit, date }
+  );
+}
 function providerError(message, details) {
   return new AppError("PROVIDER_ERROR", message, 502, details);
 }
@@ -16068,225 +16076,282 @@ function sumInfraHits(segments) {
 }
 
 // ../contracts/src/research.ts
+import { z as z56 } from "zod";
+
+// ../contracts/src/users.ts
 import { z as z55 } from "zod";
-var researchRunStatusSchema = z55.enum(["queued", "running", "completed", "partial", "failed"]);
+var UserRoles = {
+  admin: "admin",
+  viewer: "viewer"
+};
+var userRoleSchema = z55.enum(["admin", "viewer"]);
+var USER_NAME_PATTERN = /^[a-z\d][\w.-]{0,63}$/i;
+var userNameSchema = z55.string().regex(
+  USER_NAME_PATTERN,
+  "A name may use letters, digits, dots, dashes and underscores, and must start with a letter or digit."
+);
+var USER_PASSWORD_MIN_LENGTH = 12;
+var userPasswordSchema = z55.string().min(
+  USER_PASSWORD_MIN_LENGTH,
+  `A password must be at least ${USER_PASSWORD_MIN_LENGTH} characters.`
+);
+function normalizeUserName(name) {
+  return name.trim().toLowerCase();
+}
+var userDtoSchema = z55.object({
+  id: z55.string(),
+  name: z55.string(),
+  role: userRoleSchema,
+  createdAt: z55.string(),
+  lastLoginAt: z55.string().nullable()
+});
+var userListDtoSchema = z55.object({
+  users: z55.array(userDtoSchema)
+});
+var createUserRequestSchema = z55.object({
+  name: userNameSchema,
+  password: userPasswordSchema,
+  role: userRoleSchema
+});
+var loginRequestSchema = z55.object({
+  name: z55.string().min(1),
+  password: z55.string().min(1)
+});
+var authSessionDtoSchema = z55.object({
+  /** True once at least one account exists, so the dashboard must sign in. */
+  authRequired: z55.boolean(),
+  /** The signed-in person, or null when nobody is signed in. */
+  user: userDtoSchema.pick({ name: true, role: true }).nullable()
+});
+var LOGIN_FAILED_MESSAGE = "Incorrect name or password.";
+
+// ../contracts/src/research.ts
+var researchRunStatusSchema = z56.enum(["queued", "running", "completed", "partial", "failed"]);
 var ResearchRunStatuses = researchRunStatusSchema.enum;
-var researchQueryStatusSchema = z55.enum(["queued", "running", "completed", "failed"]);
+var researchQueryStatusSchema = z56.enum(["queued", "running", "completed", "failed"]);
 var ResearchQueryStatuses = researchQueryStatusSchema.enum;
-var researchRunCreateSchema = z55.object({
-  queries: z55.array(z55.string().trim().min(1).max(4e3)).min(1).max(50),
-  provider: z55.string().trim().min(1).optional(),
-  model: z55.string().trim().min(1).max(200).optional(),
+var DEFAULT_VIEWER_RESEARCH_DAILY_RUN_LIMIT = 20;
+var researchRunCreateSchema = z56.object({
+  queries: z56.array(z56.string().trim().min(1).max(4e3)).min(1).max(50),
+  provider: z56.string().trim().min(1).optional(),
+  model: z56.string().trim().min(1).max(200).optional(),
   location: locationContextSchema.nullable().optional(),
-  idempotencyKey: z55.string().trim().min(1).max(128).optional()
+  idempotencyKey: z56.string().trim().min(1).max(128).optional()
 }).superRefine((value, ctx) => {
-  if (value.model && !value.provider) ctx.addIssue({ code: z55.ZodIssueCode.custom, path: ["provider"], message: "provider is required when model is supplied" });
+  if (value.model && !value.provider) ctx.addIssue({ code: z56.ZodIssueCode.custom, path: ["provider"], message: "provider is required when model is supplied" });
 });
-var researchRunSummarySchema = z55.object({
-  id: z55.string(),
-  projectId: z55.string(),
+var researchRunPrincipalSchema = z56.object({
+  kind: z56.enum(["api-key", "user"]),
+  id: z56.string(),
+  name: z56.string(),
+  role: userRoleSchema.nullable()
+});
+var researchRunSummarySchema = z56.object({
+  id: z56.string(),
+  projectId: z56.string(),
   status: researchRunStatusSchema,
-  provider: z55.string(),
-  requestedModel: z55.string().nullable(),
-  resolvedModel: z55.string(),
+  provider: z56.string(),
+  requestedModel: z56.string().nullable(),
+  resolvedModel: z56.string(),
   location: locationContextSchema.nullable(),
-  totalQueries: z55.number().int(),
-  completedQueries: z55.number().int(),
-  failedQueries: z55.number().int(),
-  error: z55.string().nullable(),
-  startedAt: z55.string().nullable(),
-  finishedAt: z55.string().nullable(),
-  createdAt: z55.string()
-});
-var researchRunQuerySchema = z55.object({
-  id: z55.string(),
-  position: z55.number().int(),
-  query: z55.string(),
+  totalQueries: z56.number().int(),
+  completedQueries: z56.number().int(),
+  failedQueries: z56.number().int(),
+  error: z56.string().nullable(),
+  initiatedBy: researchRunPrincipalSchema.nullable(),
+  startedAt: z56.string().nullable(),
+  finishedAt: z56.string().nullable(),
+  createdAt: z56.string()
+});
+var researchRunQuerySchema = z56.object({
+  id: z56.string(),
+  position: z56.number().int(),
+  query: z56.string(),
   status: researchQueryStatusSchema,
-  requestedModel: z55.string().nullable(),
-  resolvedModel: z55.string(),
-  servedModel: z55.string().nullable(),
-  answerText: z55.string().nullable(),
-  groundingSources: z55.array(groundingSourceSchema),
-  citedDomains: z55.array(z55.string()),
-  searchQueries: z55.array(z55.string()),
-  namedCompetitors: z55.array(z55.string()).default([]),
-  citedCompetitorDomains: z55.array(z55.string()).default([]),
-  answerMentioned: z55.boolean().nullable(),
+  requestedModel: z56.string().nullable(),
+  resolvedModel: z56.string(),
+  servedModel: z56.string().nullable(),
+  answerText: z56.string().nullable(),
+  groundingSources: z56.array(groundingSourceSchema),
+  citedDomains: z56.array(z56.string()),
+  searchQueries: z56.array(z56.string()),
+  namedCompetitors: z56.array(z56.string()).default([]),
+  citedCompetitorDomains: z56.array(z56.string()).default([]),
+  answerMentioned: z56.boolean().nullable(),
   citationState: citationStateSchema.nullable(),
-  error: z55.string().nullable(),
-  startedAt: z55.string().nullable(),
-  finishedAt: z55.string().nullable(),
-  createdAt: z55.string()
+  error: z56.string().nullable(),
+  startedAt: z56.string().nullable(),
+  finishedAt: z56.string().nullable(),
+  createdAt: z56.string()
 });
-var researchRunDetailSchema = researchRunSummarySchema.extend({ queries: z55.array(researchRunQuerySchema) });
-var researchRunListSchema = z55.object({ runs: z55.array(researchRunSummarySchema) });
+var researchRunDetailSchema = researchRunSummarySchema.extend({ queries: z56.array(researchRunQuerySchema) });
+var researchRunListSchema = z56.object({ runs: z56.array(researchRunSummarySchema) });
 
 // ../contracts/src/ads.ts
-import { z as z56 } from "zod";
+import { z as z57 } from "zod";
 var AdsReviewStatuses = {
   approved: "approved"
 };
 var AdsIntegrityDecisions = {
   allowed: "allowed"
 };
-var adsConnectRequestSchema = z56.object({
+var adsConnectRequestSchema = z57.object({
   /** Ads Manager "SDK key" scoped to one ad account. Stored in config.yaml, never the DB. */
-  apiKey: z56.string().min(1)
+  apiKey: z57.string().min(1)
 });
-var adsAccountDtoSchema = z56.object({
-  id: z56.string(),
-  name: z56.string(),
-  status: z56.string(),
-  currencyCode: z56.string().nullable(),
-  timezone: z56.string().nullable(),
-  url: z56.string().nullable(),
-  reviewStatus: z56.string().nullable(),
-  integrityReviewStatus: z56.string().nullable(),
-  integrityDecision: z56.string().nullable()
-});
-var adsGeoSearchQuerySchema = z56.object({
-  q: z56.string().trim().min(1).max(200),
-  limit: z56.number().int().min(1).max(100).default(20)
-});
-var adsGeoLocationDtoSchema = z56.object({
-  id: z56.string(),
-  type: z56.string(),
-  canonicalName: z56.string(),
-  countryCode: z56.string(),
-  name: z56.string(),
-  regionCode: z56.string().nullable()
+var adsAccountDtoSchema = z57.object({
+  id: z57.string(),
+  name: z57.string(),
+  status: z57.string(),
+  currencyCode: z57.string().nullable(),
+  timezone: z57.string().nullable(),
+  url: z57.string().nullable(),
+  reviewStatus: z57.string().nullable(),
+  integrityReviewStatus: z57.string().nullable(),
+  integrityDecision: z57.string().nullable()
+});
+var adsGeoSearchQuerySchema = z57.object({
+  q: z57.string().trim().min(1).max(200),
+  limit: z57.number().int().min(1).max(100).default(20)
+});
+var adsGeoLocationDtoSchema = z57.object({
+  id: z57.string(),
+  type: z57.string(),
+  canonicalName: z57.string(),
+  countryCode: z57.string(),
+  name: z57.string(),
+  regionCode: z57.string().nullable()
 });
-var adsGeoSearchResponseSchema = z56.object({
-  count: z56.number().int().nonnegative(),
-  query: z56.string(),
-  results: z56.array(adsGeoLocationDtoSchema)
+var adsGeoSearchResponseSchema = z57.object({
+  count: z57.number().int().nonnegative(),
+  query: z57.string(),
+  results: z57.array(adsGeoLocationDtoSchema)
 });
-var adsConversionPixelDtoSchema = z56.object({
-  id: z56.string(),
-  clientType: z56.string().optional(),
-  name: z56.string().optional(),
-  pixelId: z56.string().optional()
+var adsConversionPixelDtoSchema = z57.object({
+  id: z57.string(),
+  clientType: z57.string().optional(),
+  name: z57.string().optional(),
+  pixelId: z57.string().optional()
 });
-var adsConversionPixelListResponseSchema = z56.object({
-  pixels: z56.array(adsConversionPixelDtoSchema)
+var adsConversionPixelListResponseSchema = z57.object({
+  pixels: z57.array(adsConversionPixelDtoSchema)
 });
-var adsConversionEventSettingSourceDtoSchema = z56.object({
-  id: z56.string(),
-  name: z56.string().optional()
+var adsConversionEventSettingSourceDtoSchema = z57.object({
+  id: z57.string(),
+  name: z57.string().optional()
 });
-var adsConversionEventSettingDtoSchema = z56.object({
-  id: z56.string(),
-  name: z56.string().optional(),
-  eventType: z56.string().optional(),
-  customEventName: z56.string().nullable().optional(),
-  attributionWindowDays: z56.number().int().positive().optional(),
-  adAccountId: z56.string().optional(),
-  sourceIds: z56.array(z56.string()).optional(),
-  sources: z56.array(adsConversionEventSettingSourceDtoSchema).optional(),
-  archived: z56.boolean().optional(),
-  version: z56.number().int().nonnegative().optional()
-});
-var adsConversionEventSettingListResponseSchema = z56.object({
-  eventSettings: z56.array(adsConversionEventSettingDtoSchema)
-});
-var adsConnectionStatusDtoSchema = z56.object({
-  connected: z56.boolean(),
-  adAccountId: z56.string().nullable().optional(),
-  displayName: z56.string().nullable().optional(),
-  currencyCode: z56.string().nullable().optional(),
-  timezone: z56.string().nullable().optional(),
-  status: z56.string().nullable().optional(),
-  reviewStatus: z56.string().nullable().optional(),
-  integrityReviewStatus: z56.string().nullable().optional(),
-  integrityDecision: z56.string().nullable().optional(),
-  lastSyncedAt: z56.string().nullable().optional(),
+var adsConversionEventSettingDtoSchema = z57.object({
+  id: z57.string(),
+  name: z57.string().optional(),
+  eventType: z57.string().optional(),
+  customEventName: z57.string().nullable().optional(),
+  attributionWindowDays: z57.number().int().positive().optional(),
+  adAccountId: z57.string().optional(),
+  sourceIds: z57.array(z57.string()).optional(),
+  sources: z57.array(adsConversionEventSettingSourceDtoSchema).optional(),
+  archived: z57.boolean().optional(),
+  version: z57.number().int().nonnegative().optional()
+});
+var adsConversionEventSettingListResponseSchema = z57.object({
+  eventSettings: z57.array(adsConversionEventSettingDtoSchema)
+});
+var adsConnectionStatusDtoSchema = z57.object({
+  connected: z57.boolean(),
+  adAccountId: z57.string().nullable().optional(),
+  displayName: z57.string().nullable().optional(),
+  currencyCode: z57.string().nullable().optional(),
+  timezone: z57.string().nullable().optional(),
+  status: z57.string().nullable().optional(),
+  reviewStatus: z57.string().nullable().optional(),
+  integrityReviewStatus: z57.string().nullable().optional(),
+  integrityDecision: z57.string().nullable().optional(),
+  lastSyncedAt: z57.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: z56.boolean().optional()
+  conversionTrackingConfigured: z57.boolean().optional()
 });
-var adsDisconnectResponseSchema = z56.object({
-  disconnected: z56.boolean()
+var adsDisconnectResponseSchema = z57.object({
+  disconnected: z57.boolean()
 });
-var adsSyncResponseSchema = z56.object({
-  runId: z56.string(),
-  status: z56.string()
+var adsSyncResponseSchema = z57.object({
+  runId: z57.string(),
+  status: z57.string()
 });
-var adsCreativeDtoSchema = z56.object({
-  type: z56.string().nullable().optional(),
-  title: z56.string().nullable().optional(),
-  body: z56.string().nullable().optional(),
-  targetUrl: z56.string().nullable().optional(),
-  fileId: z56.string().nullable().optional()
+var adsCreativeDtoSchema = z57.object({
+  type: z57.string().nullable().optional(),
+  title: z57.string().nullable().optional(),
+  body: z57.string().nullable().optional(),
+  targetUrl: z57.string().nullable().optional(),
+  fileId: z57.string().nullable().optional()
 });
-var adsCampaignBiddingTypeSchema = z56.enum(["impressions", "clicks"]);
+var adsCampaignBiddingTypeSchema = z57.enum(["impressions", "clicks"]);
 var AdsCampaignBiddingTypes = adsCampaignBiddingTypeSchema.enum;
-var adsAdGroupBillingEventTypeSchema = z56.enum(["impression", "click"]);
+var adsAdGroupBillingEventTypeSchema = z57.enum(["impression", "click"]);
 var AdsAdGroupBillingEventTypes = adsAdGroupBillingEventTypeSchema.enum;
-var adsAdDtoSchema = z56.object({
-  id: z56.string(),
-  adGroupId: z56.string(),
-  name: z56.string(),
-  status: z56.string(),
-  reviewStatus: z56.string().nullable().optional(),
+var adsAdDtoSchema = z57.object({
+  id: z57.string(),
+  adGroupId: z57.string(),
+  name: z57.string(),
+  status: z57.string(),
+  reviewStatus: z57.string().nullable().optional(),
   creative: adsCreativeDtoSchema.nullable().optional(),
-  upstreamUpdatedAt: z56.number().int().nullable().optional(),
-  syncedAt: z56.string().optional()
+  upstreamUpdatedAt: z57.number().int().nullable().optional(),
+  syncedAt: z57.string().optional()
 });
-var adsAdGroupDtoSchema = z56.object({
-  id: z56.string(),
-  campaignId: z56.string(),
-  name: z56.string(),
-  description: z56.string().nullable().optional(),
-  status: z56.string(),
-  billingEventType: z56.union([adsAdGroupBillingEventTypeSchema, z56.null()]).optional(),
-  maxBidMicros: z56.number().int().nullable().optional(),
+var adsAdGroupDtoSchema = z57.object({
+  id: z57.string(),
+  campaignId: z57.string(),
+  name: z57.string(),
+  description: z57.string().nullable().optional(),
+  status: z57.string(),
+  billingEventType: z57.union([adsAdGroupBillingEventTypeSchema, z57.null()]).optional(),
+  maxBidMicros: z57.number().int().nullable().optional(),
   /**
    * The targeting primitive: entries are multi-line strings of
    * newline-separated example queries (the live Ads Manager format).
    */
-  contextHints: z56.array(z56.string()).default([]),
-  ads: z56.array(adsAdDtoSchema).default([]),
-  upstreamUpdatedAt: z56.number().int().nullable().optional(),
-  syncedAt: z56.string().optional()
+  contextHints: z57.array(z57.string()).default([]),
+  ads: z57.array(adsAdDtoSchema).default([]),
+  upstreamUpdatedAt: z57.number().int().nullable().optional(),
+  syncedAt: z57.string().optional()
 });
-var adsCampaignDtoSchema = z56.object({
-  id: z56.string(),
-  name: z56.string(),
-  description: z56.string().nullable().optional(),
-  status: z56.string(),
-  startTime: z56.number().int().nullable().optional(),
-  endTime: z56.number().int().nullable().optional(),
-  biddingType: z56.union([adsCampaignBiddingTypeSchema, z56.null()]).optional(),
-  dailySpendLimitMicros: z56.number().int().nullable().optional(),
-  lifetimeSpendLimitMicros: z56.number().int().nullable().optional(),
-  conversionEventSettingIds: z56.array(z56.string()).default([]),
-  locationIds: z56.array(z56.string()).optional(),
-  adGroups: z56.array(adsAdGroupDtoSchema).default([]),
-  upstreamUpdatedAt: z56.number().int().nullable().optional(),
-  syncedAt: z56.string().optional()
-});
-var adsCampaignListResponseSchema = z56.object({
-  campaigns: z56.array(adsCampaignDtoSchema)
-});
-var adsInsightLevelSchema = z56.enum(["campaign", "ad_group"]);
+var adsCampaignDtoSchema = z57.object({
+  id: z57.string(),
+  name: z57.string(),
+  description: z57.string().nullable().optional(),
+  status: z57.string(),
+  startTime: z57.number().int().nullable().optional(),
+  endTime: z57.number().int().nullable().optional(),
+  biddingType: z57.union([adsCampaignBiddingTypeSchema, z57.null()]).optional(),
+  dailySpendLimitMicros: z57.number().int().nullable().optional(),
+  lifetimeSpendLimitMicros: z57.number().int().nullable().optional(),
+  conversionEventSettingIds: z57.array(z57.string()).default([]),
+  locationIds: z57.array(z57.string()).optional(),
+  adGroups: z57.array(adsAdGroupDtoSchema).default([]),
+  upstreamUpdatedAt: z57.number().int().nullable().optional(),
+  syncedAt: z57.string().optional()
+});
+var adsCampaignListResponseSchema = z57.object({
+  campaigns: z57.array(adsCampaignDtoSchema)
+});
+var adsInsightLevelSchema = z57.enum(["campaign", "ad_group"]);
 var AdsInsightLevels = adsInsightLevelSchema.enum;
-var adsInsightRowDtoSchema = z56.object({
+var adsInsightRowDtoSchema = z57.object({
   level: adsInsightLevelSchema,
-  entityId: z56.string(),
-  date: z56.string(),
-  impressions: z56.number().int(),
-  clicks: z56.number().int(),
-  spendMicros: z56.number().int(),
+  entityId: z57.string(),
+  date: z57.string(),
+  impressions: z57.number().int(),
+  clicks: z57.number().int(),
+  spendMicros: z57.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: z56.number().int(),
+  conversions: z57.number().int(),
   /** clicks / impressions; null when impressions is 0. */
-  ctr: z56.number().nullable(),
+  ctr: z57.number().nullable(),
   /** spendMicros / clicks, rounded to integer micros; null when clicks is 0. */
-  cpcMicros: z56.number().int().nullable(),
+  cpcMicros: z57.number().int().nullable(),
   /**
    * True when `date` is the ad account's CURRENT local calendar date, so this
    * row is a running figure rather than a closed day. The sync re-reads the
@@ -16299,42 +16364,42 @@ var adsInsightRowDtoSchema = z56.object({
    * conversion metrics, so the count stays at 0 until the day closes and the
    * next sync reads the real figure. Treat it as not yet reported.
    */
-  inProgress: z56.boolean()
+  inProgress: z57.boolean()
 });
-var adsInsightsResponseSchema = z56.object({
-  rows: z56.array(adsInsightRowDtoSchema),
+var adsInsightsResponseSchema = z57.object({
+  rows: z57.array(adsInsightRowDtoSchema),
   /** Account currency for rendering spend/cpc; null before the first sync. */
-  currencyCode: z56.string().nullable().optional()
-});
-var adsRollupWindowDtoSchema = z56.object({
-  from: z56.string().nullable(),
-  to: z56.string().nullable(),
-  inProgressDate: z56.string().nullable()
-});
-var adsTotalsDtoSchema = z56.object({
-  impressions: z56.number().int(),
-  clicks: z56.number().int(),
-  spendMicros: z56.number().int(),
-  conversions: z56.number().int(),
-  ctr: z56.number().nullable(),
-  cpcMicros: z56.number().int().nullable()
-});
-var adsSummaryDtoSchema = z56.object({
-  connected: z56.boolean(),
-  displayName: z56.string().nullable().optional(),
-  currencyCode: z56.string().nullable().optional(),
-  lastSyncedAt: z56.string().nullable().optional(),
-  campaignCount: z56.number().int(),
-  adGroupCount: z56.number().int(),
-  adCount: z56.number().int(),
+  currencyCode: z57.string().nullable().optional()
+});
+var adsRollupWindowDtoSchema = z57.object({
+  from: z57.string().nullable(),
+  to: z57.string().nullable(),
+  inProgressDate: z57.string().nullable()
+});
+var adsTotalsDtoSchema = z57.object({
+  impressions: z57.number().int(),
+  clicks: z57.number().int(),
+  spendMicros: z57.number().int(),
+  conversions: z57.number().int(),
+  ctr: z57.number().nullable(),
+  cpcMicros: z57.number().int().nullable()
+});
+var adsSummaryDtoSchema = z57.object({
+  connected: z57.boolean(),
+  displayName: z57.string().nullable().optional(),
+  currencyCode: z57.string().nullable().optional(),
+  lastSyncedAt: z57.string().nullable().optional(),
+  campaignCount: z57.number().int(),
+  adGroupCount: z57.number().int(),
+  adCount: z57.number().int(),
   /** Date range the totals cover (oldest/newest rollup date), null when empty. */
   window: adsRollupWindowDtoSchema,
   /** Campaign-level rollup totals over the window (levels are not summed across). */
   totals: adsTotalsDtoSchema
 });
-var adsDeliverySnapshotStatusSchema = z56.enum(["unavailable", "partial", "complete"]);
+var adsDeliverySnapshotStatusSchema = z57.enum(["unavailable", "partial", "complete"]);
 var AdsDeliverySnapshotStatuses = adsDeliverySnapshotStatusSchema.enum;
-var adsDeliverySnapshotIssueSchema = z56.enum([
+var adsDeliverySnapshotIssueSchema = z57.enum([
   "no_ads_connection",
   "connection_not_synced",
   "no_ads_sync",
@@ -16345,12 +16410,12 @@ var adsDeliverySnapshotIssueSchema = z56.enum([
   "source_sync_not_completed"
 ]);
 var AdsDeliverySnapshotIssues = adsDeliverySnapshotIssueSchema.enum;
-var adsHistoricalCampaignRollupStatusSchema = z56.enum(["unavailable", "reported"]);
+var adsHistoricalCampaignRollupStatusSchema = z57.enum(["unavailable", "reported"]);
 var AdsHistoricalCampaignRollupStatuses = adsHistoricalCampaignRollupStatusSchema.enum;
 var AdsDeliveryConfigurationBases = {
   storedSnapshot: "stored_ads_snapshot"
 };
-var adsActivityAssessmentStateSchema = z56.enum([
+var adsActivityAssessmentStateSchema = z57.enum([
   "unavailable",
   "partial_snapshot",
   "metrics_unavailable",
@@ -16358,76 +16423,76 @@ var adsActivityAssessmentStateSchema = z56.enum([
   "no_observed_activity"
 ]);
 var AdsActivityAssessmentStates = adsActivityAssessmentStateSchema.enum;
-var adsDeliveryDiagnosticsAdSchema = z56.object({
-  id: z56.string(),
-  name: z56.string(),
-  status: z56.string(),
-  reviewStatus: z56.string().nullable()
+var adsDeliveryDiagnosticsAdSchema = z57.object({
+  id: z57.string(),
+  name: z57.string(),
+  status: z57.string(),
+  reviewStatus: z57.string().nullable()
 });
-var adsDeliveryDiagnosticsAdGroupSchema = z56.object({
-  id: z56.string(),
-  name: z56.string(),
-  status: z56.string(),
-  billingEventType: z56.union([adsAdGroupBillingEventTypeSchema, z56.null()]),
-  maxBidMicros: z56.number().int().nullable(),
-  contextHints: z56.array(z56.string()),
-  ads: z56.array(adsDeliveryDiagnosticsAdSchema)
+var adsDeliveryDiagnosticsAdGroupSchema = z57.object({
+  id: z57.string(),
+  name: z57.string(),
+  status: z57.string(),
+  billingEventType: z57.union([adsAdGroupBillingEventTypeSchema, z57.null()]),
+  maxBidMicros: z57.number().int().nullable(),
+  contextHints: z57.array(z57.string()),
+  ads: z57.array(adsDeliveryDiagnosticsAdSchema)
 });
-var adsDeliveryDiagnosticsCampaignSchema = z56.object({
-  id: z56.string(),
-  name: z56.string(),
-  status: z56.string(),
-  biddingType: z56.union([adsCampaignBiddingTypeSchema, z56.null()]),
-  dailySpendLimitMicros: z56.number().int().nullable(),
-  lifetimeSpendLimitMicros: z56.number().int().nullable(),
-  conversionEventSettingIds: z56.array(z56.string()),
-  adGroups: z56.array(adsDeliveryDiagnosticsAdGroupSchema)
-});
-var adsDeliveryDiagnosticsDtoSchema = z56.object({
-  snapshot: z56.object({
+var adsDeliveryDiagnosticsCampaignSchema = z57.object({
+  id: z57.string(),
+  name: z57.string(),
+  status: z57.string(),
+  biddingType: z57.union([adsCampaignBiddingTypeSchema, z57.null()]),
+  dailySpendLimitMicros: z57.number().int().nullable(),
+  lifetimeSpendLimitMicros: z57.number().int().nullable(),
+  conversionEventSettingIds: z57.array(z57.string()),
+  adGroups: z57.array(adsDeliveryDiagnosticsAdGroupSchema)
+});
+var adsDeliveryDiagnosticsDtoSchema = z57.object({
+  snapshot: z57.object({
     status: adsDeliverySnapshotStatusSchema,
     // A union keeps the OpenAPI form explicit enough for the generated SDK to
     // retain the complete-snapshot `null` value (rather than narrowing it to
     // the issue enum alone).
-    issue: z56.union([adsDeliverySnapshotIssueSchema, z56.null()]),
-    lastSyncedAt: z56.string().nullable(),
-    campaignCount: z56.number().int().nonnegative(),
-    adGroupCount: z56.number().int().nonnegative(),
-    adCount: z56.number().int().nonnegative(),
-    sourceSync: z56.object({
-      runId: z56.string(),
+    issue: z57.union([adsDeliverySnapshotIssueSchema, z57.null()]),
+    lastSyncedAt: z57.string().nullable(),
+    campaignCount: z57.number().int().nonnegative(),
+    adGroupCount: z57.number().int().nonnegative(),
+    adCount: z57.number().int().nonnegative(),
+    sourceSync: z57.object({
+      runId: z57.string(),
       status: runStatusSchema
     }).nullable()
   }),
-  historicalCampaignRollups: z56.object({
+  historicalCampaignRollups: z57.object({
     status: adsHistoricalCampaignRollupStatusSchema,
     window: adsRollupWindowDtoSchema,
     totals: adsTotalsDtoSchema.nullable()
   }),
-  storedConfiguration: z56.object({
-    basis: z56.literal(AdsDeliveryConfigurationBases.storedSnapshot),
-    connection: z56.object({
-      status: z56.string().nullable(),
-      reviewStatus: z56.string().nullable(),
-      integrityReviewStatus: z56.string().nullable(),
-      integrityDecision: z56.string().nullable(),
-      conversionTrackingConfigured: z56.boolean()
+  storedConfiguration: z57.object({
+    basis: z57.literal(AdsDeliveryConfigurationBases.storedSnapshot),
+    connection: z57.object({
+      status: z57.string().nullable(),
+      reviewStatus: z57.string().nullable(),
+      integrityReviewStatus: z57.string().nullable(),
+      integrityDecision: z57.string().nullable(),
+      conversionTrackingConfigured: z57.boolean()
     }).nullable(),
-    campaigns: z56.array(adsDeliveryDiagnosticsCampaignSchema)
+    campaigns: z57.array(adsDeliveryDiagnosticsCampaignSchema)
   }),
-  assessment: z56.object({ state: adsActivityAssessmentStateSchema })
-});
-var adsOperationKeySchema = z56.string().min(8).max(128).regex(/^[\w.:-]+$/, "operationKey may contain letters, numbers, dot, underscore, colon, and hyphen");
-var adsEntityIdSchema = z56.string().min(1).max(200);
-var adsNameSchema = z56.string().min(3).max(1e3).refine((value) => value.trim().length > 0);
-var adsTimestampSchema = z56.number().int().min(946684800).max(4102444800);
-var adsMicrosSchema = z56.number().int().positive().max(Number.MAX_SAFE_INTEGER);
-var adsSha256Schema = z56.string().regex(/^[a-f0-9]{64}$/);
-var adsConversionEventSettingIdsSchema = z56.array(adsEntityIdSchema).max(100).refine((ids) => new Set(ids).size === ids.length, "conversionEventSettingIds must be unique");
-var adsHttpsUrlSchema = z56.string().url().refine((value) => new URL(value).protocol === "https:", {
+  assessment: z57.object({ state: adsActivityAssessmentStateSchema })
+});
+var adsOperationKeySchema = z57.string().min(8).max(128).regex(/^[\w.:-]+$/, "operationKey may contain letters, numbers, dot, underscore, colon, and hyphen");
+var adsEntityIdSchema = z57.string().min(1).max(200);
+var adsNameSchema = z57.string().min(3).max(1e3).refine((value) => value.trim().length > 0);
+var adsTimestampSchema = z57.number().int().min(946684800).max(4102444800);
+var adsMicrosSchema = z57.number().int().positive().max(Number.MAX_SAFE_INTEGER);
+var adsSha256Schema = z57.string().regex(/^[a-f0-9]{64}$/);
+var adsConversionEventSettingIdsSchema = z57.array(adsEntityIdSchema).max(100).refine((ids) => new Set(ids).size === ids.length, "conversionEventSettingIds must be unique");
+var adsHttpsUrlSchema = z57.string().url().refine((value) => new URL(value).protocol === "https:", {
   message: "URL must use https"
 });
-var adsOperationKindSchema = z56.enum([
+var adsOperationKindSchema = z57.enum([
   "image_upload",
   "campaign_create",
   "campaign_update",
@@ -16444,25 +16509,25 @@ var adsOperationKindSchema = z56.enum([
   "ad_archive"
 ]);
 var AdsOperationKinds = adsOperationKindSchema.enum;
-var adsOperationStateSchema = z56.enum(["pending", "reconciling", "succeeded", "failed", "unknown"]);
+var adsOperationStateSchema = z57.enum(["pending", "reconciling", "succeeded", "failed", "unknown"]);
 var AdsOperationStates = adsOperationStateSchema.enum;
-var adsReconcileStrategySchema = z56.enum(["known_entity", "create_fingerprint", "manual_only"]);
+var adsReconcileStrategySchema = z57.enum(["known_entity", "create_fingerprint", "manual_only"]);
 var AdsReconcileStrategies = adsReconcileStrategySchema.enum;
-var adsUnresolvedOperationStateSchema = z56.enum([
+var adsUnresolvedOperationStateSchema = z57.enum([
   AdsOperationStates.pending,
   AdsOperationStates.unknown,
   AdsOperationStates.reconciling
 ]);
 var AdsUnresolvedOperationStates = adsUnresolvedOperationStateSchema.enum;
-var adsEntityStatusSchema = z56.enum(["active", "paused", "archived"]);
+var adsEntityStatusSchema = z57.enum(["active", "paused", "archived"]);
 var AdsEntityStatuses = adsEntityStatusSchema.enum;
-var adsEntityTypeSchema = z56.enum(["file", "campaign", "ad_group", "ad"]);
+var adsEntityTypeSchema = z57.enum(["file", "campaign", "ad_group", "ad"]);
 var AdsEntityTypes = adsEntityTypeSchema.enum;
-var adsActivationEntityTypeSchema = z56.enum(["campaign", "ad_group", "ad"]);
+var adsActivationEntityTypeSchema = z57.enum(["campaign", "ad_group", "ad"]);
 var AdsActivationEntityTypes = adsActivationEntityTypeSchema.enum;
-var adsActivationEntityRefSchema = z56.object({
+var adsActivationEntityRefSchema = z57.object({
   id: adsEntityIdSchema,
-  expectedUpdatedAt: z56.number().int().nonnegative()
+  expectedUpdatedAt: z57.number().int().nonnegative()
 }).strict();
 var adsActivationAdSchema = adsActivationEntityRefSchema;
 var ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES = 1e3;
@@ -16474,10 +16539,10 @@ function countAdsActivationManifestEntities(manifest) {
   );
 }
 var adsActivationAdGroupSchema = adsActivationEntityRefSchema.extend({
-  ads: z56.array(adsActivationAdSchema).min(1).max(ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES - 1)
+  ads: z57.array(adsActivationAdSchema).min(1).max(ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES - 1)
 }).strict();
 var adsActivationCampaignSchema = adsActivationEntityRefSchema.extend({
-  adGroups: z56.array(adsActivationAdGroupSchema).min(1).max(ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES - 1)
+  adGroups: z57.array(adsActivationAdGroupSchema).min(1).max(ADS_ACTIVATION_ABSOLUTE_MAX_ENTITIES - 1)
 }).strict();
 function compareAdsActivationEntityIds(left, right) {
   if (left < right) return -1;
@@ -16496,7 +16561,7 @@ function addCanonicalEntityOrderIssue(items, path, ctx) {
     }
   }
 }
-var adsActivationManifestSchema = z56.object({
+var adsActivationManifestSchema = z57.object({
   campaign: adsActivationCampaignSchema
 }).strict().superRefine((manifest, ctx) => {
   const entityCount = countAdsActivationManifestEntities(manifest);
@@ -16539,7 +16604,7 @@ function canonicalizeAdsActivationManifest(manifest) {
   };
 }
 var adsActivationManifestHashSchema = adsSha256Schema;
-var adsActivationGrantStateSchema = z56.enum([
+var adsActivationGrantStateSchema = z57.enum([
   "approved",
   "executing",
   "consumed",
@@ -16548,7 +16613,7 @@ var adsActivationGrantStateSchema = z56.enum([
   "unknown"
 ]);
 var AdsActivationGrantStates = adsActivationGrantStateSchema.enum;
-var adsOperationStepStateSchema = z56.enum([
+var adsOperationStepStateSchema = z57.enum([
   "pending",
   "executing",
   "active",
@@ -16559,35 +16624,35 @@ var adsOperationStepStateSchema = z56.enum([
   "unknown"
 ]);
 var AdsOperationStepStates = adsOperationStepStateSchema.enum;
-var adsReconcileFieldsSchema = z56.object({
+var adsReconcileFieldsSchema = z57.object({
   name: adsNameSchema.optional(),
-  description: z56.string().max(4e3).nullable().optional(),
+  description: z57.string().max(4e3).nullable().optional(),
   status: adsEntityStatusSchema.optional(),
   startTime: adsTimestampSchema.nullable().optional(),
   endTime: adsTimestampSchema.nullable().optional(),
   lifetimeSpendLimitMicros: adsMicrosSchema.min(1e6).optional(),
-  locationIds: z56.array(adsEntityIdSchema).max(100).optional(),
+  locationIds: z57.array(adsEntityIdSchema).max(100).optional(),
   biddingType: adsCampaignBiddingTypeSchema.optional(),
   conversionEventSettingIds: adsConversionEventSettingIdsSchema.optional(),
   campaignId: adsEntityIdSchema.optional(),
-  contextHints: z56.array(z56.string().min(1).max(1e3)).max(100).optional(),
+  contextHints: z57.array(z57.string().min(1).max(1e3)).max(100).optional(),
   maxBidMicros: adsMicrosSchema.max(1e8).optional(),
   billingEventType: adsAdGroupBillingEventTypeSchema.optional(),
   adGroupId: adsEntityIdSchema.optional(),
   creativeFingerprint: adsSha256Schema.optional()
 }).strict();
-var adsImageUploadRequestSchema = z56.object({
+var adsImageUploadRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
   imageUrl: adsHttpsUrlSchema
 });
-var adsCampaignCreateRequestSchema = z56.object({
+var adsCampaignCreateRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
   name: adsNameSchema,
-  description: z56.string().max(4e3).optional(),
+  description: z57.string().max(4e3).optional(),
   startTime: adsTimestampSchema.optional(),
   endTime: adsTimestampSchema.optional(),
   lifetimeSpendLimitMicros: adsMicrosSchema.min(1e6),
-  locationIds: z56.array(adsEntityIdSchema).min(1).max(100),
+  locationIds: z57.array(adsEntityIdSchema).min(1).max(100),
   // biddingType is BILLING (what the account pays for) and is immutable once
   // the provider creates the campaign. conversionEventSettingIds is
   // OPTIMIZATION (what delivery is steered toward). The two are independent,
@@ -16600,22 +16665,22 @@ var adsCampaignCreateRequestSchema = z56.object({
     ctx.addIssue({ code: "custom", path: ["endTime"], message: "endTime must be after startTime" });
   }
 });
-var adsAdGroupCreateRequestSchema = z56.object({
+var adsAdGroupCreateRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
   campaignId: adsEntityIdSchema,
   name: adsNameSchema,
-  description: z56.string().max(4e3).optional(),
-  contextHints: z56.array(z56.string().min(1).max(1e3)).min(1).max(100),
+  description: z57.string().max(4e3).optional(),
+  contextHints: z57.array(z57.string().min(1).max(1e3)).min(1).max(100),
   maxBidMicros: adsMicrosSchema.max(1e8),
   billingEventType: adsAdGroupBillingEventTypeSchema.optional()
 });
-var adsChatCardCreativeRequestSchema = z56.object({
-  title: z56.string().min(3).max(50),
-  body: z56.string().min(1).max(100),
+var adsChatCardCreativeRequestSchema = z57.object({
+  title: z57.string().min(3).max(50),
+  body: z57.string().min(1).max(100),
   targetUrl: adsHttpsUrlSchema,
   fileId: adsEntityIdSchema
 });
-var adsAdCreateRequestSchema = z56.object({
+var adsAdCreateRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
   adGroupId: adsEntityIdSchema,
   name: adsNameSchema,
@@ -16624,62 +16689,62 @@ var adsAdCreateRequestSchema = z56.object({
 function hasMutationField(value) {
   return Object.keys(value).some((key) => key !== "operationKey" && key !== "expectedUpdatedAt");
 }
-var adsCampaignUpdateRequestSchema = z56.object({
+var adsCampaignUpdateRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
-  expectedUpdatedAt: z56.number().int().nonnegative(),
+  expectedUpdatedAt: z57.number().int().nonnegative(),
   name: adsNameSchema.optional(),
-  description: z56.string().max(4e3).nullable().optional(),
+  description: z57.string().max(4e3).nullable().optional(),
   startTime: adsTimestampSchema.nullable().optional(),
   endTime: adsTimestampSchema.nullable().optional(),
   lifetimeSpendLimitMicros: adsMicrosSchema.min(1e6).optional(),
-  locationIds: z56.array(adsEntityIdSchema).min(1).max(100).optional()
+  locationIds: z57.array(adsEntityIdSchema).min(1).max(100).optional()
 }).refine(hasMutationField, { message: "At least one campaign field must be updated" });
-var adsAdGroupUpdateRequestSchema = z56.object({
+var adsAdGroupUpdateRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
-  expectedUpdatedAt: z56.number().int().nonnegative(),
+  expectedUpdatedAt: z57.number().int().nonnegative(),
   name: adsNameSchema.optional(),
-  description: z56.string().max(4e3).nullable().optional(),
-  contextHints: z56.array(z56.string().min(1).max(1e3)).min(1).max(100).optional(),
+  description: z57.string().max(4e3).nullable().optional(),
+  contextHints: z57.array(z57.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 = z56.object({
+var adsAdUpdateRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
-  expectedUpdatedAt: z56.number().int().nonnegative(),
+  expectedUpdatedAt: z57.number().int().nonnegative(),
   name: adsNameSchema.optional(),
   creative: adsChatCardCreativeRequestSchema.optional()
 }).refine(hasMutationField, { message: "At least one ad field must be updated" });
-var adsPauseRequestSchema = z56.object({
+var adsPauseRequestSchema = z57.object({
   operationKey: adsOperationKeySchema
 });
-var adsArchiveRequestSchema = z56.object({
+var adsArchiveRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
-  expectedUpdatedAt: z56.number().int().nonnegative()
+  expectedUpdatedAt: z57.number().int().nonnegative()
 });
-var adsOperationDtoSchema = z56.object({
-  id: z56.string(),
-  adAccountId: z56.string().nullable(),
-  operationKey: z56.string(),
+var adsOperationDtoSchema = z57.object({
+  id: z57.string(),
+  adAccountId: z57.string().nullable(),
+  operationKey: z57.string(),
   kind: adsOperationKindSchema,
   state: adsOperationStateSchema,
-  entityType: z56.union([adsEntityTypeSchema, z56.null()]),
-  entityId: z56.string().nullable(),
-  upstreamUpdatedAt: z56.number().int().nullable(),
-  errorCode: z56.string().nullable(),
-  errorMessage: z56.string().nullable(),
-  reconcileStrategy: z56.union([adsReconcileStrategySchema, z56.null()]),
+  entityType: z57.union([adsEntityTypeSchema, z57.null()]),
+  entityId: z57.string().nullable(),
+  upstreamUpdatedAt: z57.number().int().nullable(),
+  errorCode: z57.string().nullable(),
+  errorMessage: z57.string().nullable(),
+  reconcileStrategy: z57.union([adsReconcileStrategySchema, z57.null()]),
   reconcileParentId: adsEntityIdSchema.nullable(),
   reconcileFingerprint: adsSha256Schema.nullable(),
   reconcileFields: adsReconcileFieldsSchema.nullable(),
-  reconcileAttempts: z56.number().int().nonnegative(),
-  lastReconciledAt: z56.string().nullable(),
-  createdAt: z56.string(),
-  updatedAt: z56.string()
+  reconcileAttempts: z57.number().int().nonnegative(),
+  lastReconciledAt: z57.string().nullable(),
+  createdAt: z57.string(),
+  updatedAt: z57.string()
 });
-var adsOperationResponseSchema = z56.object({
+var adsOperationResponseSchema = z57.object({
   operation: adsOperationDtoSchema,
-  replayed: z56.boolean()
+  replayed: z57.boolean()
 });
-var adsActivationIsoTimestampSchema = z56.iso.datetime({ offset: true });
+var adsActivationIsoTimestampSchema = z57.iso.datetime({ offset: true });
 var adsActivationGrantBaseShape = {
   id: adsEntityIdSchema,
   projectId: adsEntityIdSchema,
@@ -16694,61 +16759,61 @@ var adsActivationGrantBaseShape = {
   updatedAt: adsActivationIsoTimestampSchema,
   revocationRequestedAt: adsActivationIsoTimestampSchema.nullable()
 };
-var adsActivationGrantApprovedDtoSchema = z56.object({
+var adsActivationGrantApprovedDtoSchema = z57.object({
   ...adsActivationGrantBaseShape,
-  state: z56.literal(AdsActivationGrantStates.approved),
-  operationId: z56.null(),
-  executionStartedAt: z56.null(),
-  consumedAt: z56.null(),
-  revokedAt: z56.null(),
-  expiredAt: z56.null()
+  state: z57.literal(AdsActivationGrantStates.approved),
+  operationId: z57.null(),
+  executionStartedAt: z57.null(),
+  consumedAt: z57.null(),
+  revokedAt: z57.null(),
+  expiredAt: z57.null()
 }).strict();
-var adsActivationGrantExecutingDtoSchema = z56.object({
+var adsActivationGrantExecutingDtoSchema = z57.object({
   ...adsActivationGrantBaseShape,
-  state: z56.literal(AdsActivationGrantStates.executing),
+  state: z57.literal(AdsActivationGrantStates.executing),
   operationId: adsEntityIdSchema,
   executionStartedAt: adsActivationIsoTimestampSchema,
-  consumedAt: z56.null(),
-  revokedAt: z56.null(),
-  expiredAt: z56.null()
+  consumedAt: z57.null(),
+  revokedAt: z57.null(),
+  expiredAt: z57.null()
 }).strict();
-var adsActivationGrantConsumedDtoSchema = z56.object({
+var adsActivationGrantConsumedDtoSchema = z57.object({
   ...adsActivationGrantBaseShape,
-  state: z56.literal(AdsActivationGrantStates.consumed),
+  state: z57.literal(AdsActivationGrantStates.consumed),
   operationId: adsEntityIdSchema,
   executionStartedAt: adsActivationIsoTimestampSchema,
   consumedAt: adsActivationIsoTimestampSchema,
-  revokedAt: z56.null(),
-  expiredAt: z56.null()
+  revokedAt: z57.null(),
+  expiredAt: z57.null()
 }).strict();
-var adsActivationGrantRevokedDtoSchema = z56.object({
+var adsActivationGrantRevokedDtoSchema = z57.object({
   ...adsActivationGrantBaseShape,
-  state: z56.literal(AdsActivationGrantStates.revoked),
-  operationId: z56.null(),
-  executionStartedAt: z56.null(),
-  consumedAt: z56.null(),
+  state: z57.literal(AdsActivationGrantStates.revoked),
+  operationId: z57.null(),
+  executionStartedAt: z57.null(),
+  consumedAt: z57.null(),
   revokedAt: adsActivationIsoTimestampSchema,
-  expiredAt: z56.null()
+  expiredAt: z57.null()
 }).strict();
-var adsActivationGrantExpiredDtoSchema = z56.object({
+var adsActivationGrantExpiredDtoSchema = z57.object({
   ...adsActivationGrantBaseShape,
-  state: z56.literal(AdsActivationGrantStates.expired),
-  operationId: z56.null(),
-  executionStartedAt: z56.null(),
-  consumedAt: z56.null(),
-  revokedAt: z56.null(),
+  state: z57.literal(AdsActivationGrantStates.expired),
+  operationId: z57.null(),
+  executionStartedAt: z57.null(),
+  consumedAt: z57.null(),
+  revokedAt: z57.null(),
   expiredAt: adsActivationIsoTimestampSchema
 }).strict();
-var adsActivationGrantUnknownDtoSchema = z56.object({
+var adsActivationGrantUnknownDtoSchema = z57.object({
   ...adsActivationGrantBaseShape,
-  state: z56.literal(AdsActivationGrantStates.unknown),
+  state: z57.literal(AdsActivationGrantStates.unknown),
   operationId: adsEntityIdSchema,
   executionStartedAt: adsActivationIsoTimestampSchema,
-  consumedAt: z56.null(),
-  revokedAt: z56.null(),
-  expiredAt: z56.null()
+  consumedAt: z57.null(),
+  revokedAt: z57.null(),
+  expiredAt: z57.null()
 }).strict();
-var adsActivationGrantDtoSchema = z56.discriminatedUnion("state", [
+var adsActivationGrantDtoSchema = z57.discriminatedUnion("state", [
   adsActivationGrantApprovedDtoSchema,
   adsActivationGrantExecutingDtoSchema,
   adsActivationGrantConsumedDtoSchema,
@@ -16774,92 +16839,92 @@ var adsActivationGrantDtoSchema = z56.discriminatedUnion("state", [
 var adsOperationStepBaseShape = {
   id: adsEntityIdSchema,
   operationId: adsEntityIdSchema,
-  ordinal: z56.number().int().nonnegative(),
+  ordinal: z57.number().int().nonnegative(),
   entityType: adsActivationEntityTypeSchema,
   entityId: adsEntityIdSchema,
-  expectedUpdatedAt: z56.number().int().nonnegative(),
+  expectedUpdatedAt: z57.number().int().nonnegative(),
   createdAt: adsActivationIsoTimestampSchema,
   updatedAt: adsActivationIsoTimestampSchema
 };
 var adsOperationStepNoErrorShape = {
-  errorCode: z56.null(),
-  errorMessage: z56.null()
+  errorCode: z57.null(),
+  errorMessage: z57.null()
 };
 var adsOperationStepErrorShape = {
-  errorCode: z56.string().min(1).max(100),
-  errorMessage: z56.string().min(1).max(500),
-  remediation: z56.string().min(1).max(500)
+  errorCode: z57.string().min(1).max(100),
+  errorMessage: z57.string().min(1).max(500),
+  remediation: z57.string().min(1).max(500)
 };
-var adsOperationStepPendingDtoSchema = z56.object({
+var adsOperationStepPendingDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepNoErrorShape,
-  state: z56.literal(AdsOperationStepStates.pending),
-  providerUpdatedAt: z56.null(),
-  remediation: z56.null(),
-  startedAt: z56.null(),
-  finishedAt: z56.null()
+  state: z57.literal(AdsOperationStepStates.pending),
+  providerUpdatedAt: z57.null(),
+  remediation: z57.null(),
+  startedAt: z57.null(),
+  finishedAt: z57.null()
 }).strict();
-var adsOperationStepExecutingDtoSchema = z56.object({
+var adsOperationStepExecutingDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepNoErrorShape,
-  state: z56.literal(AdsOperationStepStates.executing),
-  providerUpdatedAt: z56.null(),
-  remediation: z56.null(),
+  state: z57.literal(AdsOperationStepStates.executing),
+  providerUpdatedAt: z57.null(),
+  remediation: z57.null(),
   startedAt: adsActivationIsoTimestampSchema,
-  finishedAt: z56.null()
+  finishedAt: z57.null()
 }).strict();
-var adsOperationStepActiveDtoSchema = z56.object({
+var adsOperationStepActiveDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepNoErrorShape,
-  state: z56.literal(AdsOperationStepStates.active),
-  providerUpdatedAt: z56.number().int().nonnegative(),
-  remediation: z56.null(),
+  state: z57.literal(AdsOperationStepStates.active),
+  providerUpdatedAt: z57.number().int().nonnegative(),
+  remediation: z57.null(),
   startedAt: adsActivationIsoTimestampSchema,
   finishedAt: adsActivationIsoTimestampSchema
 }).strict();
-var adsOperationStepFailedDtoSchema = z56.object({
+var adsOperationStepFailedDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepErrorShape,
-  state: z56.literal(AdsOperationStepStates.failed),
-  providerUpdatedAt: z56.union([z56.number().int().nonnegative(), z56.null()]),
+  state: z57.literal(AdsOperationStepStates.failed),
+  providerUpdatedAt: z57.union([z57.number().int().nonnegative(), z57.null()]),
   startedAt: adsActivationIsoTimestampSchema,
   finishedAt: adsActivationIsoTimestampSchema
 }).strict();
-var adsOperationStepRollbackExecutingDtoSchema = z56.object({
+var adsOperationStepRollbackExecutingDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepNoErrorShape,
-  state: z56.literal(AdsOperationStepStates.rollback_executing),
-  providerUpdatedAt: z56.number().int().nonnegative(),
-  remediation: z56.string().min(1).max(500),
+  state: z57.literal(AdsOperationStepStates.rollback_executing),
+  providerUpdatedAt: z57.number().int().nonnegative(),
+  remediation: z57.string().min(1).max(500),
   startedAt: adsActivationIsoTimestampSchema,
-  finishedAt: z56.null()
+  finishedAt: z57.null()
 }).strict();
-var adsOperationStepRolledBackDtoSchema = z56.object({
+var adsOperationStepRolledBackDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepNoErrorShape,
-  state: z56.literal(AdsOperationStepStates.rolled_back),
-  providerUpdatedAt: z56.number().int().nonnegative(),
-  remediation: z56.string().min(1).max(500),
+  state: z57.literal(AdsOperationStepStates.rolled_back),
+  providerUpdatedAt: z57.number().int().nonnegative(),
+  remediation: z57.string().min(1).max(500),
   startedAt: adsActivationIsoTimestampSchema,
   finishedAt: adsActivationIsoTimestampSchema
 }).strict();
-var adsOperationStepRollbackFailedDtoSchema = z56.object({
+var adsOperationStepRollbackFailedDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepErrorShape,
-  state: z56.literal(AdsOperationStepStates.rollback_failed),
-  providerUpdatedAt: z56.number().int().nonnegative(),
+  state: z57.literal(AdsOperationStepStates.rollback_failed),
+  providerUpdatedAt: z57.number().int().nonnegative(),
   startedAt: adsActivationIsoTimestampSchema,
   finishedAt: adsActivationIsoTimestampSchema
 }).strict();
-var adsOperationStepUnknownDtoSchema = z56.object({
+var adsOperationStepUnknownDtoSchema = z57.object({
   ...adsOperationStepBaseShape,
   ...adsOperationStepErrorShape,
-  state: z56.literal(AdsOperationStepStates.unknown),
-  providerUpdatedAt: z56.union([z56.number().int().nonnegative(), z56.null()]),
+  state: z57.literal(AdsOperationStepStates.unknown),
+  providerUpdatedAt: z57.union([z57.number().int().nonnegative(), z57.null()]),
   startedAt: adsActivationIsoTimestampSchema,
   finishedAt: adsActivationIsoTimestampSchema
 }).strict();
-var adsOperationStepDtoSchema = z56.discriminatedUnion("state", [
+var adsOperationStepDtoSchema = z57.discriminatedUnion("state", [
   adsOperationStepPendingDtoSchema,
   adsOperationStepExecutingDtoSchema,
   adsOperationStepActiveDtoSchema,
@@ -16873,29 +16938,29 @@ var AdsActivationVersionPolicies = {
   exact: "exact",
   refreshSemanticallyUnchanged: "refresh_semantically_unchanged"
 };
-var adsActivationVersionPolicySchema = z56.enum([
+var adsActivationVersionPolicySchema = z57.enum([
   AdsActivationVersionPolicies.exact,
   AdsActivationVersionPolicies.refreshSemanticallyUnchanged
 ]);
-var adsActivationGrantCreateRequestSchema = z56.object({
+var adsActivationGrantCreateRequestSchema = z57.object({
   manifest: adsActivationManifestSchema,
   executorApiKeyId: adsEntityIdSchema,
   expiresAt: adsActivationIsoTimestampSchema,
   versionPolicy: adsActivationVersionPolicySchema.default(AdsActivationVersionPolicies.exact)
 }).strict();
-var adsActivationGrantResponseSchema = z56.object({
+var adsActivationGrantResponseSchema = z57.object({
   grant: adsActivationGrantDtoSchema
 }).strict();
-var adsActivationGrantRevokeRequestSchema = z56.object({}).strict();
-var adsActivateTreeRequestSchema = z56.object({
+var adsActivationGrantRevokeRequestSchema = z57.object({}).strict();
+var adsActivateTreeRequestSchema = z57.object({
   operationKey: adsOperationKeySchema,
   grantId: adsEntityIdSchema,
   manifestHash: adsActivationManifestHashSchema
 }).strict();
-var adsActivateTreeResponseSchema = z56.object({
+var adsActivateTreeResponseSchema = z57.object({
   grant: adsActivationGrantDtoSchema,
   operation: adsOperationDtoSchema,
-  steps: z56.array(adsOperationStepDtoSchema)
+  steps: z57.array(adsOperationStepDtoSchema)
 }).strict();
 var adsUnresolvedOperationStatesDefault = [
   AdsOperationStates.pending,
@@ -16914,102 +16979,102 @@ function parseUnresolvedOperationStates(value) {
   }
   return typeof value === "string" ? value.split(",").filter(Boolean) : value;
 }
-var adsUnresolvedOperationListQuerySchema = z56.object({
-  state: z56.preprocess(
+var adsUnresolvedOperationListQuerySchema = z57.object({
+  state: z57.preprocess(
     parseUnresolvedOperationStates,
-    z56.array(adsUnresolvedOperationStateSchema).min(1).max(3).refine((states) => new Set(states).size === states.length, "state values must be unique")
+    z57.array(adsUnresolvedOperationStateSchema).min(1).max(3).refine((states) => new Set(states).size === states.length, "state values must be unique")
   ),
-  limit: z56.coerce.number().int().min(1).max(200).default(100),
-  cursor: z56.string().min(1).max(1e3).optional()
+  limit: z57.coerce.number().int().min(1).max(200).default(100),
+  cursor: z57.string().min(1).max(1e3).optional()
 });
-var adsUnresolvedOperationListResponseSchema = z56.object({
-  operations: z56.array(adsOperationDtoSchema),
-  count: z56.number().int().nonnegative(),
-  nextCursor: z56.string().nullable()
+var adsUnresolvedOperationListResponseSchema = z57.object({
+  operations: z57.array(adsOperationDtoSchema),
+  count: z57.number().int().nonnegative(),
+  nextCursor: z57.string().nullable()
 });
-var adsOperationReconcileRequestSchema = z56.object({}).strict();
-var adsOperationReconcileResponseSchema = z56.object({
+var adsOperationReconcileRequestSchema = z57.object({}).strict();
+var adsOperationReconcileResponseSchema = z57.object({
   operation: adsOperationDtoSchema,
-  resolved: z56.boolean()
+  resolved: z57.boolean()
 });
-var adsLiveDeliveryQuerySchema = z56.object({
-  campaignId: z56.string().min(1).max(200).optional(),
-  lookbackDays: z56.coerce.number().int().min(1).max(30).default(7)
+var adsLiveDeliveryQuerySchema = z57.object({
+  campaignId: z57.string().min(1).max(200).optional(),
+  lookbackDays: z57.coerce.number().int().min(1).max(30).default(7)
 });
-var adsLiveEntityTypeSchema = z56.enum(["campaign", "ad_group", "ad"]);
+var adsLiveEntityTypeSchema = z57.enum(["campaign", "ad_group", "ad"]);
 var AdsLiveEntityTypes = adsLiveEntityTypeSchema.enum;
-var adsLivePresenceSchema = z56.enum(["both", "live-only", "stored-only"]);
+var adsLivePresenceSchema = z57.enum(["both", "live-only", "stored-only"]);
 var AdsLivePresences = adsLivePresenceSchema.enum;
-var adsLiveDeliveryBasisSchema = z56.literal("live-provider-read");
+var adsLiveDeliveryBasisSchema = z57.literal("live-provider-read");
 var AdsLiveDeliveryBases = { liveProviderRead: "live-provider-read" };
-var adsLiveMetricRowSchema = z56.object({
-  date: z56.string().nullable(),
-  startTime: z56.number().nullable(),
-  endTime: z56.number().nullable(),
-  impressions: z56.number().nullable(),
-  clicks: z56.number().nullable(),
-  spend: z56.number().nullable(),
-  conversions: z56.number().nullable(),
-  ctr: z56.number().nullable(),
-  cpc: z56.number().nullable(),
-  cpm: z56.number().nullable()
-});
-var adsLiveMetricValuesSchema = z56.object({
-  impressions: z56.number().int(),
-  clicks: z56.number().int(),
-  spendMicros: z56.number().int(),
-  conversions: z56.number().int()
-});
-var adsLiveMetricDeltaSchema = z56.object({
-  date: z56.string(),
+var adsLiveMetricRowSchema = z57.object({
+  date: z57.string().nullable(),
+  startTime: z57.number().nullable(),
+  endTime: z57.number().nullable(),
+  impressions: z57.number().nullable(),
+  clicks: z57.number().nullable(),
+  spend: z57.number().nullable(),
+  conversions: z57.number().nullable(),
+  ctr: z57.number().nullable(),
+  cpc: z57.number().nullable(),
+  cpm: z57.number().nullable()
+});
+var adsLiveMetricValuesSchema = z57.object({
+  impressions: z57.number().int(),
+  clicks: z57.number().int(),
+  spendMicros: z57.number().int(),
+  conversions: z57.number().int()
+});
+var adsLiveMetricDeltaSchema = z57.object({
+  date: z57.string(),
   live: adsLiveMetricValuesSchema.nullable(),
   stored: adsLiveMetricValuesSchema.nullable(),
-  drifted: z56.boolean()
+  drifted: z57.boolean()
 });
-var adsLiveFieldDeltaSchema = z56.object({
-  field: z56.string(),
-  live: z56.string().nullable(),
-  stored: z56.string().nullable()
+var adsLiveFieldDeltaSchema = z57.object({
+  field: z57.string(),
+  live: z57.string().nullable(),
+  stored: z57.string().nullable()
 });
-var adsLiveEntityStateSchema = z56.object({
-  name: z56.string().nullable(),
-  status: z56.string(),
-  reviewStatus: z56.string().nullable(),
-  mode: z56.string().nullable(),
-  updatedAt: z56.number().nullable()
+var adsLiveEntityStateSchema = z57.object({
+  name: z57.string().nullable(),
+  status: z57.string(),
+  reviewStatus: z57.string().nullable(),
+  mode: z57.string().nullable(),
+  updatedAt: z57.number().nullable()
 });
-var adsStoredEntityStateSchema = z56.object({
-  name: z56.string(),
-  status: z56.string(),
-  reviewStatus: z56.string().nullable(),
-  upstreamUpdatedAt: z56.number().nullable(),
-  syncedAt: z56.string()
+var adsStoredEntityStateSchema = z57.object({
+  name: z57.string(),
+  status: z57.string(),
+  reviewStatus: z57.string().nullable(),
+  upstreamUpdatedAt: z57.number().nullable(),
+  syncedAt: z57.string()
 });
-var adsLiveEntityComparisonSchema = z56.object({
+var adsLiveEntityComparisonSchema = z57.object({
   entityType: adsLiveEntityTypeSchema,
-  id: z56.string(),
-  parentId: z56.string().nullable(),
+  id: z57.string(),
+  parentId: z57.string().nullable(),
   presence: adsLivePresenceSchema,
   live: adsLiveEntityStateSchema.nullable(),
   stored: adsStoredEntityStateSchema.nullable(),
-  fieldDeltas: z56.array(adsLiveFieldDeltaSchema),
+  fieldDeltas: z57.array(adsLiveFieldDeltaSchema),
   /** Provider rows, unaggregated. Null for ads (no per-ad insights surface). */
-  liveMetrics: z56.array(adsLiveMetricRowSchema).nullable(),
-  metricDeltas: z56.array(adsLiveMetricDeltaSchema).nullable(),
-  drifted: z56.boolean()
+  liveMetrics: z57.array(adsLiveMetricRowSchema).nullable(),
+  metricDeltas: z57.array(adsLiveMetricDeltaSchema).nullable(),
+  drifted: z57.boolean()
 });
-var adsLiveReadFailureSchema = z56.object({
-  surface: z56.string(),
-  entityId: z56.string().nullable(),
-  upstreamStatus: z56.number().int().nullable()
+var adsLiveReadFailureSchema = z57.object({
+  surface: z57.string(),
+  entityId: z57.string().nullable(),
+  upstreamStatus: z57.number().int().nullable()
 });
-var adsLiveDeliveryDtoSchema = z56.object({
+var adsLiveDeliveryDtoSchema = z57.object({
   basis: adsLiveDeliveryBasisSchema,
   /** Instant the live read was issued; the metrics window is measured back from it. */
-  fetchedAt: z56.string(),
-  adAccountId: z56.string(),
-  storedSnapshotSyncedAt: z56.string().nullable(),
-  metricsWindow: z56.object({ lookbackDays: z56.number().int().positive() }),
+  fetchedAt: z57.string(),
+  adAccountId: z57.string(),
+  storedSnapshotSyncedAt: z57.string().nullable(),
+  metricsWindow: z57.object({ lookbackDays: z57.number().int().positive() }),
   /**
    * Two different units live here, and confusing them understates the cost of
    * this endpoint by two orders of magnitude.
@@ -17025,28 +17090,28 @@ var adsLiveDeliveryDtoSchema = z56.object({
    * no observed HTTP-request count: the pagination happens inside the provider
    * client, below the injected reader seam, so the route cannot see it.
    */
-  bounds: z56.object({
-    maxCampaigns: z56.number().int().positive(),
-    maxAdGroupsPerCampaign: z56.number().int().positive(),
-    maxAdsPerAdGroup: z56.number().int().positive(),
+  bounds: z57.object({
+    maxCampaigns: z57.number().int().positive(),
+    maxAdGroupsPerCampaign: z57.number().int().positive(),
+    maxAdsPerAdGroup: z57.number().int().positive(),
     /** Budget in logical reader calls, NOT in upstream HTTP requests. */
-    maxReaderCalls: z56.number().int().positive(),
+    maxReaderCalls: z57.number().int().positive(),
     /** Reader calls this read actually issued. Observed, not a bound. */
-    readerCalls: z56.number().int().nonnegative(),
+    readerCalls: z57.number().int().nonnegative(),
     /** Pages one paginated reader call may fetch before the client gives up. */
-    maxPagesPerReaderCall: z56.number().int().positive(),
+    maxPagesPerReaderCall: z57.number().int().positive(),
     /** Worst-case upstream HTTP requests. A documented bound, not an observation. */
-    maxUpstreamHttpRequests: z56.number().int().positive(),
-    truncated: z56.boolean()
+    maxUpstreamHttpRequests: z57.number().int().positive(),
+    truncated: z57.boolean()
   }),
-  entities: z56.array(adsLiveEntityComparisonSchema),
-  drift: z56.object({
-    entitiesCompared: z56.number().int().nonnegative(),
-    driftedEntities: z56.number().int().nonnegative(),
-    statusDrifted: z56.number().int().nonnegative(),
-    metricsDrifted: z56.number().int().nonnegative()
+  entities: z57.array(adsLiveEntityComparisonSchema),
+  drift: z57.object({
+    entitiesCompared: z57.number().int().nonnegative(),
+    driftedEntities: z57.number().int().nonnegative(),
+    statusDrifted: z57.number().int().nonnegative(),
+    metricsDrifted: z57.number().int().nonnegative()
   }),
-  errors: z56.array(adsLiveReadFailureSchema)
+  errors: z57.array(adsLiveReadFailureSchema)
 });
 function adsCtr(clicks, impressions) {
   return impressions > 0 ? clicks / impressions : null;
@@ -17078,53 +17143,6 @@ function escapeLikePattern(value) {
   return value.replace(/[\\%_]/g, (match) => `\\${match}`);
 }
 
-// ../contracts/src/users.ts
-import { z as z57 } from "zod";
-var UserRoles = {
-  admin: "admin",
-  viewer: "viewer"
-};
-var userRoleSchema = z57.enum(["admin", "viewer"]);
-var USER_NAME_PATTERN = /^[a-z\d][\w.-]{0,63}$/i;
-var userNameSchema = z57.string().regex(
-  USER_NAME_PATTERN,
-  "A name may use letters, digits, dots, dashes and underscores, and must start with a letter or digit."
-);
-var USER_PASSWORD_MIN_LENGTH = 12;
-var userPasswordSchema = z57.string().min(
-  USER_PASSWORD_MIN_LENGTH,
-  `A password must be at least ${USER_PASSWORD_MIN_LENGTH} characters.`
-);
-function normalizeUserName(name) {
-  return name.trim().toLowerCase();
-}
-var userDtoSchema = z57.object({
-  id: z57.string(),
-  name: z57.string(),
-  role: userRoleSchema,
-  createdAt: z57.string(),
-  lastLoginAt: z57.string().nullable()
-});
-var userListDtoSchema = z57.object({
-  users: z57.array(userDtoSchema)
-});
-var createUserRequestSchema = z57.object({
-  name: userNameSchema,
-  password: userPasswordSchema,
-  role: userRoleSchema
-});
-var loginRequestSchema = z57.object({
-  name: z57.string().min(1),
-  password: z57.string().min(1)
-});
-var authSessionDtoSchema = z57.object({
-  /** True once at least one account exists, so the dashboard must sign in. */
-  authRequired: z57.boolean(),
-  /** The signed-in person, or null when nobody is signed in. */
-  user: userDtoSchema.pick({ name: true, role: true }).nullable()
-});
-var LOGIN_FAILED_MESSAGE = "Incorrect name or password.";
-
 // ../contracts/src/embed.ts
 var SELF_TOKEN = "'self'";
 function normalizeFrameOrigin(raw) {
@@ -17419,6 +17437,7 @@ export {
   authInvalid,
   forbidden,
   quotaExceeded,
+  researchDailyLimitExceeded,
   providerError,
   providerAuthError,
   noProvider,
@@ -18032,8 +18051,18 @@ export {
   classifyTrafficPath,
   segmentCrawlerHits,
   sumInfraHits,
+  UserRoles,
+  USER_PASSWORD_MIN_LENGTH,
+  normalizeUserName,
+  userDtoSchema,
+  userListDtoSchema,
+  createUserRequestSchema,
+  loginRequestSchema,
+  authSessionDtoSchema,
+  LOGIN_FAILED_MESSAGE,
   ResearchRunStatuses,
   ResearchQueryStatuses,
+  DEFAULT_VIEWER_RESEARCH_DAILY_RUN_LIMIT,
   researchRunCreateSchema,
   researchRunDetailSchema,
   researchRunListSchema,
@@ -18120,15 +18149,6 @@ export {
   GOOGLE_MARKETING_LIVE_READ_SCOPE,
   GOOGLE_MARKETING_WRITE_SCOPE,
   isReadOnlyKey,
-  UserRoles,
-  USER_PASSWORD_MIN_LENGTH,
-  normalizeUserName,
-  userDtoSchema,
-  userListDtoSchema,
-  createUserRequestSchema,
-  loginRequestSchema,
-  authSessionDtoSchema,
-  LOGIN_FAILED_MESSAGE,
   splitList,
   parseOriginList,
   frameAncestorsHeaderValue,