@canonry/canonry 5.13.0 → 5.15.0

package/dist/{chunk-UWJAATGC.js → chunk-L36TC6LB.js}

@@ -12143,6 +12143,33 @@ function categorizeSourceWithCompetitors(uri, competitorDomains, isCompetitorMat
   }
   return base;
 }
+var LISTING_MARKETPLACE_DOMAINS = [
+  "apartmentfinder.com",
+  "apartmentguide.com",
+  "apartmenthomeliving.com",
+  "apartmentlist.com",
+  "apartmentratings.com",
+  "apartments.com",
+  "craigslist.org",
+  "forrent.com",
+  "homes.com",
+  "hotpads.com",
+  "padmapper.com",
+  "realtor.com",
+  "redfin.com",
+  "rent.com",
+  "rentable.co",
+  "rentals.com",
+  "rentcafe.com",
+  "student.com",
+  "trulia.com",
+  "zillow.com",
+  "zumper.com"
+];
+function isListingMarketplace(domainOrUri) {
+  const domain = hostOf(domainOrUri) ?? domainOrUri.trim().toLowerCase();
+  return LISTING_MARKETPLACE_DOMAINS.some((marketplace) => hostMatchesDomain(domain, marketplace));
+}
 function categoryLabel(category) {
   return CATEGORY_LABELS[category];
 }
@@ -17007,6 +17034,42 @@ var adsSyncResponseSchema = z59.object({
   runId: z59.string(),
   status: z59.string()
 });
+var ADS_QUERY_STRING_TEMPLATE_MACROS = [
+  "campaign_id",
+  "ad_group_id",
+  "ad_id",
+  "ad_account_id",
+  "oppref"
+];
+var ADS_QUERY_STRING_PAIR = /^[\w.-]+=[^&#\s]*$/;
+var ADS_QUERY_STRING_MACRO = /\{([^}]*)\}/g;
+var adsQueryStringTemplateSchema = z59.string().min(1).max(1e3).superRefine((value, ctx) => {
+  const fail = (message) => ctx.addIssue({ code: "custom", message });
+  if (value.startsWith("?") || value.startsWith("&")) {
+    fail("Tracking template must not start with ? or &");
+    return;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const pair of value.split("&")) {
+    if (!ADS_QUERY_STRING_PAIR.test(pair)) {
+      fail(`Tracking template pair '${pair}' must be key=value without whitespace, # or &`);
+      return;
+    }
+    const key = pair.slice(0, pair.indexOf("="));
+    if (seen.has(key)) {
+      fail(`Tracking template repeats the parameter '${key}'`);
+      return;
+    }
+    seen.add(key);
+  }
+  for (const match of value.matchAll(ADS_QUERY_STRING_MACRO)) {
+    const macro = match[1];
+    if (!ADS_QUERY_STRING_TEMPLATE_MACROS.includes(macro)) {
+      fail(`Tracking template macro '{${macro}}' is not supported`);
+      return;
+    }
+  }
+});
 var adsCreativeDtoSchema = z59.object({
   type: z59.string().nullable().optional(),
   title: z59.string().nullable().optional(),
@@ -17025,6 +17088,8 @@ var adsAdDtoSchema = z59.object({
   status: z59.string(),
   reviewStatus: z59.string().nullable().optional(),
   creative: adsCreativeDtoSchema.nullable().optional(),
+  /** Provider tracking parameters appended to this entity's click URLs. */
+  landingPageQueryStringTemplate: z59.string().nullable().optional(),
   upstreamUpdatedAt: z59.number().int().nullable().optional(),
   syncedAt: z59.string().optional()
 });
@@ -17042,6 +17107,8 @@ var adsAdGroupDtoSchema = z59.object({
    */
   contextHints: z59.array(z59.string()).default([]),
   ads: z59.array(adsAdDtoSchema).default([]),
+  /** Provider tracking parameters appended to this entity's click URLs. */
+  landingPageQueryStringTemplate: z59.string().nullable().optional(),
   upstreamUpdatedAt: z59.number().int().nullable().optional(),
   syncedAt: z59.string().optional()
 });
@@ -17058,6 +17125,8 @@ var adsCampaignDtoSchema = z59.object({
   conversionEventSettingIds: z59.array(z59.string()).default([]),
   locationIds: z59.array(z59.string()).optional(),
   adGroups: z59.array(adsAdGroupDtoSchema).default([]),
+  /** Provider tracking parameters appended to this entity's click URLs. */
+  landingPageQueryStringTemplate: z59.string().nullable().optional(),
   upstreamUpdatedAt: z59.number().int().nullable().optional(),
   syncedAt: z59.string().optional()
 });
@@ -17368,7 +17437,8 @@ var adsReconcileFieldsSchema = z59.object({
   maxBidMicros: adsMicrosSchema.max(1e8).optional(),
   billingEventType: adsAdGroupBillingEventTypeSchema.optional(),
   adGroupId: adsEntityIdSchema.optional(),
-  creativeFingerprint: adsSha256Schema.optional()
+  creativeFingerprint: adsSha256Schema.optional(),
+  landingPageQueryStringTemplate: adsQueryStringTemplateSchema.nullable().optional()
 }).strict();
 var adsImageUploadRequestSchema = z59.object({
   operationKey: adsOperationKeySchema,
@@ -17388,7 +17458,9 @@ var adsCampaignCreateRequestSchema = z59.object({
   // and the provider accepts a clicks campaign carrying no conversion event
   // settings, so neither field is conditioned on the other here.
   biddingType: adsCampaignBiddingTypeSchema.optional(),
-  conversionEventSettingIds: adsConversionEventSettingIdsSchema.optional()
+  conversionEventSettingIds: adsConversionEventSettingIdsSchema.optional(),
+  /** Optional tracking parameters applied to click URLs under this entity. */
+  landingPageQueryStringTemplate: adsQueryStringTemplateSchema.optional()
 }).superRefine((value, ctx) => {
   if (value.startTime !== void 0 && value.endTime !== void 0 && value.endTime <= value.startTime) {
     ctx.addIssue({ code: "custom", path: ["endTime"], message: "endTime must be after startTime" });
@@ -17401,7 +17473,9 @@ var adsAdGroupCreateRequestSchema = z59.object({
   description: z59.string().max(4e3).optional(),
   contextHints: z59.array(z59.string().min(1).max(1e3)).min(1).max(100),
   maxBidMicros: adsMicrosSchema.max(1e8),
-  billingEventType: adsAdGroupBillingEventTypeSchema.optional()
+  billingEventType: adsAdGroupBillingEventTypeSchema.optional(),
+  /** Optional tracking parameters applied to click URLs under this entity. */
+  landingPageQueryStringTemplate: adsQueryStringTemplateSchema.optional()
 });
 var adsChatCardCreativeRequestSchema = z59.object({
   title: z59.string().min(3).max(50),
@@ -17413,7 +17487,9 @@ var adsAdCreateRequestSchema = z59.object({
   operationKey: adsOperationKeySchema,
   adGroupId: adsEntityIdSchema,
   name: adsNameSchema,
-  creative: adsChatCardCreativeRequestSchema
+  creative: adsChatCardCreativeRequestSchema,
+  /** Optional tracking parameters applied to click URLs under this entity. */
+  landingPageQueryStringTemplate: adsQueryStringTemplateSchema.optional()
 });
 function hasMutationField(value) {
   return Object.keys(value).some((key) => key !== "operationKey" && key !== "expectedUpdatedAt");
@@ -17426,7 +17502,9 @@ var adsCampaignUpdateRequestSchema = z59.object({
   startTime: adsTimestampSchema.nullable().optional(),
   endTime: adsTimestampSchema.nullable().optional(),
   lifetimeSpendLimitMicros: adsMicrosSchema.min(1e6).optional(),
-  locationIds: z59.array(adsEntityIdSchema).min(1).max(100).optional()
+  locationIds: z59.array(adsEntityIdSchema).min(1).max(100).optional(),
+  /** Tracking parameters for this entity's click URLs; null clears them. */
+  landingPageQueryStringTemplate: adsQueryStringTemplateSchema.nullable().optional()
 }).refine(hasMutationField, { message: "At least one campaign field must be updated" });
 var adsAdGroupUpdateRequestSchema = z59.object({
   operationKey: adsOperationKeySchema,
@@ -17434,13 +17512,17 @@ var adsAdGroupUpdateRequestSchema = z59.object({
   name: adsNameSchema.optional(),
   description: z59.string().max(4e3).nullable().optional(),
   contextHints: z59.array(z59.string().min(1).max(1e3)).min(1).max(100).optional(),
-  maxBidMicros: adsMicrosSchema.max(1e8).optional()
+  maxBidMicros: adsMicrosSchema.max(1e8).optional(),
+  /** Tracking parameters for this entity's click URLs; null clears them. */
+  landingPageQueryStringTemplate: adsQueryStringTemplateSchema.nullable().optional()
 }).refine(hasMutationField, { message: "At least one ad group field must be updated" });
 var adsAdUpdateRequestSchema = z59.object({
   operationKey: adsOperationKeySchema,
   expectedUpdatedAt: z59.number().int().nonnegative(),
   name: adsNameSchema.optional(),
-  creative: adsChatCardCreativeRequestSchema.optional()
+  creative: adsChatCardCreativeRequestSchema.optional(),
+  /** Tracking parameters for this entity's click URLs; null clears them. */
+  landingPageQueryStringTemplate: adsQueryStringTemplateSchema.nullable().optional()
 }).refine(hasMutationField, { message: "At least one ad field must be updated" });
 var adsPauseRequestSchema = z59.object({
   operationKey: adsOperationKeySchema
@@ -19739,6 +19821,7 @@ export {
   shareOfVoiceSummary,
   categorizeSource,
   categorizeSourceWithCompetitors,
+  isListingMarketplace,
   categoryLabel,
   cosineSimilarity,
   clusterByCosine,

package/dist/{chunk-TDHRUXN3.js → chunk-SJ7ZOFL5.js}

@@ -17,12 +17,12 @@ import {
   resolveOperatorApiKeyIds,
   runWithUsageTags,
   saveConfigPatch
-} from "./chunk-IPGBK7XR.js";
+} from "./chunk-ZGZSROSR.js";
 import {
   deleteSiteCrawlGraphLayout,
   persistSiteCrawlGraphLayout,
   prepareSiteCrawlGraphLayout
-} from "./chunk-IDZQ5H3J.js";
+} from "./chunk-CDQDPUY4.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -73,6 +73,7 @@ import {
   createCredentialChecker,
   createFastifyLogger,
   createLogger,
+  createRunCompetitorResolver,
   createUserSession,
   deliverWebhook,
   determineCitationState,
@@ -183,7 +184,7 @@ import {
   siteLivenessState,
   toAlertView,
   usageCounters
-} from "./chunk-Q35D2R2P.js";
+} from "./chunk-3YAPVVFN.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_NONE,
@@ -344,7 +345,7 @@ import {
   visibilityReportRequestSchema,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-UWJAATGC.js";
+} from "./chunk-L36TC6LB.js";
 
 // src/runtime-context.ts
 function cliRuntimeContext(env = process.env, stdio = process) {
@@ -6490,7 +6491,7 @@ function nonBlank(value) {
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "894086f6a60be75c0ade892884adf57ef7a38291" : void 0;
+  const embedded = true ? "979d2ea6821a78ddc2d2df35600c4b208e4ecff7" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {
@@ -6966,6 +6967,8 @@ var JobRunner = class {
       log2.info("run.dispatch", { runId, providerCount: activeProviders.length, providers: activeProviders.map((p) => p.adapter.name) });
       const projectCompetitors = this.db.select().from(competitors).where(eq2(competitors.projectId, projectId)).all();
       const competitorDomains = projectCompetitors.map((c) => c.domain);
+      const resolveCompetitors = createRunCompetitorResolver(this.db, competitorDomains);
+      const competitorsFor = (executionId) => resolveCompetitors(existingRun.measurementPlanVersionId, executionId);
       const allDomains = effectiveDomains({
         canonicalDomain: project.canonicalDomain,
         ownedDomains: project.ownedDomains
@@ -7168,7 +7171,7 @@ var JobRunner = class {
       const slotContext = {
         runId,
         allDomains,
-        competitorDomains,
+        competitorsFor,
         allBrandNames,
         executionGates,
         providerDispatchCounts,
@@ -7426,7 +7429,8 @@ var JobRunner = class {
         else providerErrors.set(provider, `No ${provider} provider is configured on this instance, so its missing answers did not run.`);
       }
       const projectCompetitors = this.db.select().from(competitors).where(eq2(competitors.projectId, projectId)).all();
-      const competitorDomains = projectCompetitors.map((c) => c.domain);
+      const resolveCompetitors = createRunCompetitorResolver(this.db, projectCompetitors.map((c) => c.domain));
+      const competitorsFor = (executionId) => resolveCompetitors(run.measurementPlanVersionId, executionId);
       const allDomains = effectiveDomains({ canonicalDomain: project.canonicalDomain, ownedDomains: project.ownedDomains });
       const allBrandNames = effectiveBrandNames({ displayName: project.displayName, aliases: project.aliases });
       const todayPeriod = getCurrentUsageDay();
@@ -7480,7 +7484,7 @@ var JobRunner = class {
       const ctx = {
         runId,
         allDomains,
-        competitorDomains,
+        competitorsFor,
         allBrandNames,
         executionGates,
         providerDispatchCounts,
@@ -7580,6 +7584,7 @@ var JobRunner = class {
   async executePlanSlot(ctx, registeredProvider, unit) {
     const { adapter, config: providerConfig } = registeredProvider;
     const providerName = adapter.name;
+    const { domains: competitorDomains, aliases: competitorAliases } = ctx.competitorsFor(unit.executionId);
     const gate = ctx.executionGates.get(providerName);
     if (!gate) {
       throw new Error(`Missing execution gate for provider ${providerName}`);
@@ -7597,7 +7602,7 @@ var JobRunner = class {
           {
             query: unit.queryText,
             canonicalDomains: ctx.allDomains,
-            competitorDomains: ctx.competitorDomains,
+            competitorDomains,
             location: requestedContext ?? void 0
           },
           config
@@ -7634,13 +7639,14 @@ var JobRunner = class {
           ctx.allBrandNames,
           ctx.allDomains
         );
-        const overlap = computeCompetitorOverlap(normalized, ctx.competitorDomains);
+        const overlap = computeCompetitorOverlap(normalized, competitorDomains, competitorAliases);
         const extractedCompetitors = extractRecommendedCompetitors(
           normalized.answerText,
           ctx.allDomains,
           normalized.citedDomains,
-          ctx.competitorDomains,
-          ctx.allBrandNames
+          competitorDomains,
+          ctx.allBrandNames,
+          competitorAliases
         );
         const snapshotId = crypto6.randomUUID();
         let screenshotRelPath = null;
@@ -8601,6 +8607,30 @@ function validateChatCardCreative(value) {
   validateId(value.file_id, "Ad creative file id");
   validateHttpUrl(value.target_url, "Ad creative target URL");
 }
+var MAX_QUERY_STRING_TEMPLATE_LENGTH = 1e3;
+function validateLandingPageConfiguration(value, label) {
+  if (value === void 0 || value === null) return;
+  validateRequestObject(value, `${label} landing_page_configuration`);
+  const template = value.query_string_template;
+  if (template === null) return;
+  if (typeof template !== "string" || template.trim().length === 0 || template.length > MAX_QUERY_STRING_TEMPLATE_LENGTH) {
+    throw new OpenAiAdsApiError(
+      `${label} query_string_template must be 1-${MAX_QUERY_STRING_TEMPLATE_LENGTH} characters`,
+      400
+    );
+  }
+  if (/\s/.test(template) || template.startsWith("?") || template.startsWith("&")) {
+    throw new OpenAiAdsApiError(
+      `${label} query_string_template must be a bare query string without whitespace or a leading ? or &`,
+      400
+    );
+  }
+}
+function parseLandingPageQueryStringTemplate(value) {
+  if (!isRecord(value)) return null;
+  const template = value.query_string_template;
+  return typeof template === "string" && template.trim().length > 0 ? template : null;
+}
 function validateCreateCampaignRequest(request) {
   validateRequestObject(request, "Campaign create request");
   validateEntityName(request.name, "Campaign name");
@@ -8610,6 +8640,7 @@ function validateCreateCampaignRequest(request) {
   validateCampaignTimestamp(request.end_time, "Campaign end_time");
   validateCampaignBidding(request);
   validateCampaignTargeting(request.targeting);
+  validateLandingPageConfiguration(request.landing_page_configuration, "Campaign create request");
 }
 function validateUpdateCampaignRequest(request) {
   validatePublicUpdateRequest(request, "Campaign update request");
@@ -8618,6 +8649,7 @@ function validateUpdateCampaignRequest(request) {
   validateCampaignTimestamp(request.start_time, "Campaign start_time");
   validateCampaignTimestamp(request.end_time, "Campaign end_time");
   validateCampaignTargeting(request.targeting);
+  validateLandingPageConfiguration(request.landing_page_configuration, "Campaign update request");
 }
 function validateCreateAdGroupRequest(request) {
   validateRequestObject(request, "Ad group create request");
@@ -8626,12 +8658,14 @@ function validateCreateAdGroupRequest(request) {
   validatePausedCreateStatus(request.status, "Ad group create request");
   validateContextHints(request.context_hints);
   validateBiddingConfig(request.bidding_config);
+  validateLandingPageConfiguration(request.landing_page_configuration, "Ad group create request");
 }
 function validateUpdateAdGroupRequest(request) {
   validatePublicUpdateRequest(request, "Ad group update request");
   if (request.name !== void 0) validateEntityName(request.name, "Ad group name");
   validateContextHints(request.context_hints);
   if (request.bidding_config !== void 0) validateBiddingConfig(request.bidding_config);
+  validateLandingPageConfiguration(request.landing_page_configuration, "Ad group update request");
 }
 function validateCreateAdRequest(request) {
   validateRequestObject(request, "Ad create request");
@@ -8639,11 +8673,13 @@ function validateCreateAdRequest(request) {
   validateEntityName(request.name, "Ad name");
   validatePausedCreateStatus(request.status, "Ad create request");
   validateChatCardCreative(request.creative);
+  validateLandingPageConfiguration(request.landing_page_configuration, "Ad create request");
 }
 function validateUpdateAdRequest(request) {
   validatePublicUpdateRequest(request, "Ad update request");
   if (request.name !== void 0) validateEntityName(request.name, "Ad name");
   if (request.creative !== void 0) validateChatCardCreative(request.creative);
+  validateLandingPageConfiguration(request.landing_page_configuration, "Ad update request");
 }
 function adsClientLog(level, action, ctx) {
   const entry = {
@@ -9088,6 +9124,7 @@ async function executeAdsSync(db, runId, projectId, opts) {
           lifetimeSpendLimitMicros: campaign.budget?.lifetime_spend_limit_micros ?? null,
           conversionEventSettingIds: campaign.conversion_event_setting_ids ?? [],
           targeting: campaign.targeting,
+          landingPageQueryStringTemplate: parseLandingPageQueryStringTemplate(campaign.landing_page_configuration),
           upstreamCreatedAt: campaign.created_at,
           upstreamUpdatedAt: campaign.updated_at,
           syncRunId: runId,
@@ -9104,6 +9141,7 @@ async function executeAdsSync(db, runId, projectId, opts) {
             billingEventType: group.bidding_config?.billing_event_type ?? null,
             maxBidMicros: group.bidding_config?.max_bid_micros ?? null,
             contextHints: group.context_hints,
+            landingPageQueryStringTemplate: parseLandingPageQueryStringTemplate(group.landing_page_configuration),
             upstreamCreatedAt: group.created_at,
             upstreamUpdatedAt: group.updated_at,
             syncRunId: runId,
@@ -9118,6 +9156,7 @@ async function executeAdsSync(db, runId, projectId, opts) {
               status: ad.status,
               creative: ad.creative,
               reviewStatus: ad.review_status ?? ad.review?.status ?? null,
+              landingPageQueryStringTemplate: parseLandingPageQueryStringTemplate(ad.landing_page_configuration),
               upstreamCreatedAt: ad.created_at,
               upstreamUpdatedAt: ad.updated_at,
               syncRunId: runId,
@@ -11568,10 +11607,11 @@ async function backfillAnswerVisibilityCommand(opts) {
   let reparsed = 0;
   let providerErrors = 0;
   if (scopedProjects.length > 0) {
-    const runRows = projectFilter ? db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(and13(
+    const runRows = projectFilter ? db.select({ id: runs.id, projectId: runs.projectId, planVersionId: runs.measurementPlanVersionId }).from(runs).where(and13(
       eq15(runs.kind, RunKinds["answer-visibility"]),
       inArray6(runs.projectId, scopedProjects.map((project) => project.id))
-    )).all() : db.select({ id: runs.id, projectId: runs.projectId }).from(runs).where(eq15(runs.kind, RunKinds["answer-visibility"])).all();
+    )).all() : db.select({ id: runs.id, projectId: runs.projectId, planVersionId: runs.measurementPlanVersionId }).from(runs).where(eq15(runs.kind, RunKinds["answer-visibility"])).all();
+    const planVersionByRun = new Map(runRows.map((run) => [run.id, run.planVersionId]));
     const runIdsByProject = /* @__PURE__ */ new Map();
     for (const run of runRows) {
       const existing = runIdsByProject.get(run.projectId);
@@ -11580,6 +11620,7 @@ async function backfillAnswerVisibilityCommand(opts) {
     }
     for (const project of scopedProjects) {
       const competitorDomains = db.select({ domain: competitors.domain }).from(competitors).where(eq15(competitors.projectId, project.id)).all().map((row) => row.domain);
+      const competitorsForRun = createRunCompetitorResolver(db, competitorDomains);
       const runIds = runIdsByProject.get(project.id) ?? [];
       if (runIds.length === 0) continue;
       const projectDomains = effectiveDomains({
@@ -11594,6 +11635,8 @@ async function backfillAnswerVisibilityCommand(opts) {
         const batchRunIds = runIds.slice(offset, offset + SNAPSHOT_BATCH_SIZE);
         const snapshotRows = db.select({
           id: querySnapshots.id,
+          runId: querySnapshots.runId,
+          executionId: querySnapshots.measurementExecutionId,
           provider: querySnapshots.provider,
           citationState: querySnapshots.citationState,
           answerMentioned: querySnapshots.answerMentioned,
@@ -11634,13 +11677,15 @@ async function backfillAnswerVisibilityCommand(opts) {
             };
             const nextCitationState = determineCitationState(normalized, projectDomains);
             const nextCitedDomains = reparsedResult.citedDomains;
-            const nextCompetitorOverlap = computeCompetitorOverlap(normalized, competitorDomains);
+            const runCompetitors = competitorsForRun(planVersionByRun.get(snapshot.runId), snapshot.executionId);
+            const nextCompetitorOverlap = computeCompetitorOverlap(normalized, runCompetitors.domains, runCompetitors.aliases);
             const nextRecommendedCompetitors = extractRecommendedCompetitors(
               normalized.answerText,
               projectDomains,
               normalized.citedDomains,
-              competitorDomains,
-              projectBrandNames
+              runCompetitors.domains,
+              projectBrandNames,
+              runCompetitors.aliases
             );
             const nextRawResponse = stringifyStoredSnapshotEnvelope(
               snapshot.rawResponse,
@@ -11867,8 +11912,10 @@ function backfillProjectAnswerMentions(db, projectId, opts) {
   const project = db.select().from(projects).where(eq15(projects.id, projectId)).get();
   if (!project) return { examined: 0, updated: 0, mentioned: 0 };
   const competitorDomains = db.select({ domain: competitors.domain }).from(competitors).where(eq15(competitors.projectId, projectId)).all().map((row) => row.domain);
-  const runRows = db.select({ id: runs.id }).from(runs).where(and13(eq15(runs.kind, RunKinds["answer-visibility"]), eq15(runs.projectId, projectId))).all();
+  const runRows = db.select({ id: runs.id, planVersionId: runs.measurementPlanVersionId }).from(runs).where(and13(eq15(runs.kind, RunKinds["answer-visibility"]), eq15(runs.projectId, projectId))).all();
   const runIds = runRows.map((r) => r.id);
+  const planVersionByRun = new Map(runRows.map((run) => [run.id, run.planVersionId]));
+  const competitorsForRun = createRunCompetitorResolver(db, competitorDomains);
   let examined = 0;
   let updated = 0;
   let wouldUpdate = 0;
@@ -11888,6 +11935,8 @@ function backfillProjectAnswerMentions(db, projectId, opts) {
     const batchRunIds = runIds.slice(offset, offset + SNAPSHOT_BATCH_SIZE);
     const snapshotRows = db.select({
       id: querySnapshots.id,
+      runId: querySnapshots.runId,
+      executionId: querySnapshots.measurementExecutionId,
       provider: querySnapshots.provider,
       answerMentioned: querySnapshots.answerMentioned,
       answerText: querySnapshots.answerText,
@@ -11913,13 +11962,15 @@ function backfillProjectAnswerMentions(db, projectId, opts) {
         retrievalStatus: "unknown",
         searchQueries: []
       };
-      const nextCompetitorOverlap = computeCompetitorOverlap(normalized, competitorDomains);
+      const runCompetitors = competitorsForRun(planVersionByRun.get(snapshot.runId), snapshot.executionId);
+      const nextCompetitorOverlap = computeCompetitorOverlap(normalized, runCompetitors.domains, runCompetitors.aliases);
       const nextRecommendedCompetitors = extractRecommendedCompetitors(
         answerText,
         projectDomains,
         citedDomains,
-        competitorDomains,
-        projectBrandNames
+        runCompetitors.domains,
+        projectBrandNames,
+        runCompetitors.aliases
       );
       const nextPatch = {};
       if (snapshot.answerMentioned !== nextAnswerMentioned) {
@@ -12016,7 +12067,7 @@ function readStoredGroundingSources(rawResponse) {
   return result2;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-PM7MC5VC.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-EAUKUVVM.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -18469,7 +18520,8 @@ async function createServer(opts) {
     lifetimeSpendLimitMicros: entity.budget?.lifetime_spend_limit_micros ?? null,
     locationIds: entity.targeting?.locations?.include?.map((location) => location.id) ?? [],
     biddingType: entity.bidding_type,
-    conversionEventSettingIds: entity.conversion_event_setting_ids
+    conversionEventSettingIds: entity.conversion_event_setting_ids,
+    landingPageQueryStringTemplate: parseLandingPageQueryStringTemplate(entity.landing_page_configuration)
   });
   const adsAdGroupEntityResult = (entity, campaignId) => ({
     ...adsEntityResult(entity),
@@ -18477,12 +18529,15 @@ async function createServer(opts) {
     campaignId: campaignId ?? null,
     contextHints: entity.context_hints,
     maxBidMicros: entity.bidding_config?.max_bid_micros ?? null,
-    billingEventType: entity.bidding_config?.billing_event_type ?? null
+    billingEventType: entity.bidding_config?.billing_event_type ?? null,
+    landingPageQueryStringTemplate: parseLandingPageQueryStringTemplate(entity.landing_page_configuration)
   });
   const adsAdEntityResult = (entity, adGroupId) => ({
     ...adsEntityResult(entity),
-    adGroupId: adGroupId ?? null
+    adGroupId: adGroupId ?? null,
+    landingPageQueryStringTemplate: parseLandingPageQueryStringTemplate(entity.landing_page_configuration)
   });
+  const landingPageConfigurationUpdate = (template) => template === void 0 ? void 0 : template === null ? null : { query_string_template: template };
   const adsOperator = {
     uploadImage: async (apiKey, imageUrl) => {
       const result2 = await uploadImageFromUrl(apiKey, imageUrl);
@@ -18499,7 +18554,8 @@ async function createServer(opts) {
       budget: { lifetime_spend_limit_micros: input.lifetimeSpendLimitMicros },
       bidding_type: input.biddingType,
       conversion_event_setting_ids: input.conversionEventSettingIds,
-      targeting: { locations: { include: input.locationIds.map((id) => ({ id })) } }
+      targeting: { locations: { include: input.locationIds.map((id) => ({ id })) } },
+      landing_page_configuration: input.landingPageQueryStringTemplate === void 0 ? void 0 : { query_string_template: input.landingPageQueryStringTemplate }
     })),
     updateCampaign: async (apiKey, id, input) => adsCampaignEntityResult(await updateCampaign(apiKey, id, {
       name: input.name,
@@ -18507,7 +18563,8 @@ async function createServer(opts) {
       start_time: input.startTime,
       end_time: input.endTime,
       budget: input.lifetimeSpendLimitMicros === void 0 ? void 0 : { lifetime_spend_limit_micros: input.lifetimeSpendLimitMicros },
-      targeting: input.locationIds === void 0 ? void 0 : { locations: { include: input.locationIds.map((locationId) => ({ id: locationId })) } }
+      targeting: input.locationIds === void 0 ? void 0 : { locations: { include: input.locationIds.map((locationId) => ({ id: locationId })) } },
+      landing_page_configuration: landingPageConfigurationUpdate(input.landingPageQueryStringTemplate)
     })),
     activateCampaign: async (apiKey, id) => adsCampaignEntityResult(await activateCampaign(apiKey, id)),
     pauseCampaign: async (apiKey, id) => adsCampaignEntityResult(await pauseCampaign(apiKey, id)),
@@ -18523,7 +18580,8 @@ async function createServer(opts) {
       bidding_config: {
         billing_event_type: input.billingEventType,
         max_bid_micros: input.maxBidMicros
-      }
+      },
+      landing_page_configuration: input.landingPageQueryStringTemplate === void 0 ? void 0 : { query_string_template: input.landingPageQueryStringTemplate }
     })),
     updateAdGroup: async (apiKey, id, input) => {
       let biddingConfig;
@@ -18540,7 +18598,8 @@ async function createServer(opts) {
         name: input.name,
         description: input.description,
         context_hints: input.contextHints,
-        bidding_config: biddingConfig
+        bidding_config: biddingConfig,
+        landing_page_configuration: landingPageConfigurationUpdate(input.landingPageQueryStringTemplate)
       }));
     },
     activateAdGroup: async (apiKey, id) => adsAdGroupEntityResult(await activateAdGroup(apiKey, id)),
@@ -18558,7 +18617,8 @@ async function createServer(opts) {
         body: input.creative.body,
         target_url: input.creative.targetUrl,
         file_id: input.creative.fileId
-      }
+      },
+      landing_page_configuration: input.landingPageQueryStringTemplate === void 0 ? void 0 : { query_string_template: input.landingPageQueryStringTemplate }
     })),
     updateAd: async (apiKey, id, input) => adsAdEntityResult(await updateAd(apiKey, id, {
       name: input.name,
@@ -18568,7 +18628,8 @@ async function createServer(opts) {
         body: input.creative.body,
         target_url: input.creative.targetUrl,
         file_id: input.creative.fileId
-      } : void 0
+      } : void 0,
+      landing_page_configuration: landingPageConfigurationUpdate(input.landingPageQueryStringTemplate)
     })),
     activateAd: async (apiKey, id) => adsAdEntityResult(await activateAd(apiKey, id)),
     pauseAd: async (apiKey, id) => adsAdEntityResult(await pauseAd(apiKey, id)),

package/dist/{chunk-IPGBK7XR.js → chunk-ZGZSROSR.js}

@@ -133,7 +133,7 @@ import {
   upgradeCaveatFor,
   upgradeCommandFor,
   visibilityReportRequestSchema
-} from "./chunk-UWJAATGC.js";
+} from "./chunk-L36TC6LB.js";
 
 // src/cli-error.ts
 function isMachineFormat(format) {

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-TDHRUXN3.js";
+} from "./chunk-SJ7ZOFL5.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-6YLNO2T5.js";
+} from "./chunk-JO5HHEJV.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -66,13 +66,13 @@ import {
   shouldPrintServeSkillsNudge,
   systemError,
   usageError
-} from "./chunk-IPGBK7XR.js";
+} from "./chunk-ZGZSROSR.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-IDZQ5H3J.js";
+import "./chunk-CDQDPUY4.js";
 import "./chunk-AOJU5LKX.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
@@ -88,7 +88,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-Q35D2R2P.js";
+} from "./chunk-3YAPVVFN.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -173,7 +173,7 @@ import {
   snapshotProviderModeSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-UWJAATGC.js";
+} from "./chunk-L36TC6LB.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -438,7 +438,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-IZFTJI7E.js");
+  const { createDemoServer } = await import("./demo-server-QLQUVMKJ.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {

package/dist/{demo-server-IZFTJI7E.js → demo-server-QLQUVMKJ.js}

@@ -4,7 +4,7 @@ import {
 import {
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-IDZQ5H3J.js";
+} from "./chunk-CDQDPUY4.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -83,7 +83,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-Q35D2R2P.js";
+} from "./chunk-3YAPVVFN.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -104,7 +104,7 @@ import {
   measurementPlanV2Schema,
   placementLinkDecision,
   siteAuditPageFactorSchema
-} from "./chunk-UWJAATGC.js";
+} from "./chunk-L36TC6LB.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";