@koda-sl/baker-cli 0.334.0 → 0.336.0

package/dist/cli.js

@@ -1887,7 +1887,78 @@ var audienceCreateSchema = z3.object({
       message: `${p.audienceType} audiences need a raw source config (use --file)`
     });
   }
-});
+  if (!isList && p.raw) {
+    for (const message of retargetingConfigProblems(p.raw)) {
+      ctx.addIssue({ code: "custom", path: ["raw"], message: `${p.audienceType} source config: ${message}` });
+    }
+  }
+});
+var ENGAGEMENT_LOOKBACK_DAYS = [7, 14, 28, 30, 60, 90, 180, 365];
+var WEBSITE_LOOKBACK_DAYS = ENGAGEMENT_LOOKBACK_DAYS.filter((days) => days >= 14 && days <= 180);
+var EVENT_LOOKBACK_DAYS = [730];
+var WEBSITE_SOURCE_PLATFORM = "LINKEDIN_WEBSITE_RETARGETING";
+var TRIGGER_SOURCE_TYPE_BY_PLATFORM = { [WEBSITE_SOURCE_PLATFORM]: "WEBSITE" };
+function lookbackDaysFor(sourcePlatform) {
+  if (sourcePlatform === WEBSITE_SOURCE_PLATFORM) {
+    return WEBSITE_LOOKBACK_DAYS;
+  }
+  return sourcePlatform === "EVENT_PAGES" ? EVENT_LOOKBACK_DAYS : ENGAGEMENT_LOOKBACK_DAYS;
+}
+var ENGAGEMENT_TRIGGER_URN = /^urn:li:dmpEngagementTrigger:\(urn:li:dmpEngagementSourceType:([A-Z_]+),([A-Z_]+)\)$/;
+var RETARGETING_EXAMPLE = '{"sourcePlatform":"VIDEO_ADS","type":"USER","engagementRules":[{"engagementSource":"urn:li:sponsoredCampaign:123","engagementTrigger":"urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)","timeFrame":{"timeSpan":{"duration":90,"unit":"DAY"}}}]}';
+var engagementRuleSchema = z3.object({
+  engagementSource: z3.string().regex(/^urn:li:[A-Za-z]+:\S+$/, "engagementSource must be a URN (urn:li:\u2026)"),
+  engagementTrigger: z3.string().regex(
+    ENGAGEMENT_TRIGGER_URN,
+    "engagementTrigger must be urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:<SOURCE>,<TRIGGER>)"
+  ),
+  timeFrame: z3.object({
+    timeSpan: z3.object({ duration: z3.number().int().positive(), unit: z3.literal("DAY") })
+  })
+}).passthrough();
+var engagementRulesSchema = z3.array(engagementRuleSchema).min(1);
+function retargetingConfigProblems(raw) {
+  const problems = [];
+  const sourcePlatform = typeof raw.sourcePlatform === "string" ? raw.sourcePlatform.trim() : "";
+  if (!sourcePlatform) {
+    problems.push("missing sourcePlatform");
+  }
+  if (raw.type !== "USER") {
+    problems.push('type must be "USER" \u2014 LinkedIn only attaches engagement rules to USER segments');
+  }
+  const rules = engagementRulesSchema.safeParse(raw.engagementRules);
+  if (!rules.success) {
+    const detail = rules.error.issues.map((issue) => issue.message).join("; ");
+    problems.push(
+      `engagementRules needs at least one source rule (engagementSource, engagementTrigger, timeFrame) \u2014 ${detail}. e.g. ${RETARGETING_EXAMPLE}`
+    );
+    return problems;
+  }
+  const allowed = lookbackDaysFor(sourcePlatform);
+  const expectedTriggerSource = TRIGGER_SOURCE_TYPE_BY_PLATFORM[sourcePlatform] ?? sourcePlatform;
+  for (const rule of rules.data) {
+    const triggerSource = ENGAGEMENT_TRIGGER_URN.exec(rule.engagementTrigger)?.[1];
+    if (sourcePlatform && triggerSource !== expectedTriggerSource) {
+      problems.push(
+        `engagementTrigger ${rule.engagementTrigger} is a ${triggerSource} trigger, not ${expectedTriggerSource}`
+      );
+    }
+    const days = rule.timeFrame.timeSpan.duration;
+    if (!allowed.includes(days)) {
+      problems.push(`lookback ${days} days is not offered for ${sourcePlatform} \u2014 use ${allowed.join(", ")}`);
+    }
+  }
+  const shapes = new Set(rules.data.map((rule) => `${rule.engagementTrigger}|${rule.timeFrame.timeSpan.duration}`));
+  if (shapes.size > 1) {
+    problems.push("every engagement rule on one audience must use the same trigger and lookback");
+  }
+  const sources = rules.data.map((rule) => rule.engagementSource);
+  const repeated = [...new Set(sources.filter((source, index) => sources.indexOf(source) !== index))];
+  if (repeated.length > 0) {
+    problems.push(`each engagementSource can appear in only one rule: ${repeated.join(", ")}`);
+  }
+  return problems;
+}
 var audienceUploadListSchema = z3.object({
   segment: parentRefSchema,
   listColumns: z3.array(z3.string().min(1)).optional(),
@@ -3083,12 +3154,12 @@ var budgetCreateSchema = z5.object({
   deliveryMethod: z5.enum(BUDGET_DELIVERY_METHODS).default("STANDARD"),
   explicitlyShared: z5.boolean().default(false)
 });
-var budgetUpdateSchema = z5.object({
+var budgetUpdateSchema = z5.strictObject({
   name: z5.string().min(1).max(GOOGLE_ADS_LIMITS.budget.nameMax).optional(),
   amountMicros: microsSchema.optional(),
   deliveryMethod: z5.enum(BUDGET_DELIVERY_METHODS).optional()
 }).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
-var biddingConfigSchema = z5.object({
+var biddingConfigSchema = z5.strictObject({
   type: z5.enum(BIDDING_STRATEGY_TYPES),
   targetCpaMicros: microsSchema.optional(),
   targetRoas: z5.number().positive().optional(),
@@ -3222,7 +3293,7 @@ var keywordAddSchema = z5.object({
   finalUrls: z5.array(httpsUrlSchema2).optional(),
   status: stageableStatusSchema2.default("ENABLED")
 });
-var keywordUpdateSchema = z5.object({
+var keywordUpdateSchema = z5.strictObject({
   cpcBidMicros: microsSchema.optional(),
   finalUrls: z5.array(httpsUrlSchema2).optional(),
   status: z5.enum(["ENABLED", "PAUSED", "REMOVED"]).optional()
@@ -3246,7 +3317,7 @@ var campaignSharedSetAttachSchema = z5.object({
   campaign: refSchema,
   sharedSet: refSchema
 });
-var adTextAssetSchema = z5.object({
+var adTextAssetSchema = z5.strictObject({
   text: z5.string().min(1),
   pinnedField: z5.enum(PINNED_FIELDS).optional()
 });
@@ -3270,9 +3341,11 @@ var responsiveSearchAdSchema = z5.strictObject({
 });
 var responsiveDisplayAdSchema = z5.strictObject({
   format: z5.literal("responsiveDisplay"),
-  headlines: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.responsiveDisplayAd.headlineTextMax) })).min(1).max(5),
-  longHeadline: z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.responsiveDisplayAd.longHeadlineTextMax) }),
-  descriptions: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.responsiveDisplayAd.descriptionTextMax) })).min(1).max(5),
+  headlines: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.responsiveDisplayAd.headlineTextMax) })).min(1).max(5),
+  longHeadline: z5.strictObject({
+    text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.responsiveDisplayAd.longHeadlineTextMax)
+  }),
+  descriptions: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.responsiveDisplayAd.descriptionTextMax) })).min(1).max(5),
   businessName: z5.string().min(1).max(GOOGLE_ADS_LIMITS.responsiveDisplayAd.businessNameMax),
   // A Responsive Display Ad's images are fields on the ad's own content (never campaign-level
   // asset links). Google requires ≥1 landscape marketing image (1.91:1) AND ≥1 square marketing
@@ -3295,8 +3368,8 @@ var callAdSchema = z5.strictObject({
 });
 var appAdSchema = z5.strictObject({
   format: z5.literal("app"),
-  headlines: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.appAd.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.appAd.headlinesMin).max(GOOGLE_ADS_LIMITS.appAd.headlinesMax),
-  descriptions: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.appAd.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.appAd.descriptionsMin).max(GOOGLE_ADS_LIMITS.appAd.descriptionsMax),
+  headlines: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.appAd.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.appAd.headlinesMin).max(GOOGLE_ADS_LIMITS.appAd.headlinesMax),
+  descriptions: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.appAd.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.appAd.descriptionsMin).max(GOOGLE_ADS_LIMITS.appAd.descriptionsMax),
   // An App campaign ad carries its images on its own content (`AppAdInfo.images`), not as
   // campaign-level asset links — same shape as a responsive display ad's marketing images.
   images: z5.array(refSchema).max(GOOGLE_ADS_LIMITS.appAd.imagesMax).optional(),
@@ -3319,8 +3392,8 @@ var demandGenAdSchema = z5.strictObject({
    * account with no name was created, and reads back with none. Only the video format requires one.
    */
   name: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenAd.adNameMax).optional(),
-  headlines: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenAd.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenAd.headlinesMin).max(GOOGLE_ADS_LIMITS.demandGenAd.headlinesMax),
-  descriptions: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenAd.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenAd.descriptionsMin).max(GOOGLE_ADS_LIMITS.demandGenAd.descriptionsMax),
+  headlines: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenAd.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenAd.headlinesMin).max(GOOGLE_ADS_LIMITS.demandGenAd.headlinesMax),
+  descriptions: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenAd.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenAd.descriptionsMin).max(GOOGLE_ADS_LIMITS.demandGenAd.descriptionsMax),
   businessName: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenAd.businessNameMax),
   finalUrls: z5.array(httpsUrlSchema2).min(1),
   imageAssets: z5.array(refSchema).optional(),
@@ -3338,9 +3411,9 @@ var demandGenVideoAdSchema = z5.strictObject({
    * IMMUTABLE — an update must be able to restate the whole content without renaming the ad.
    */
   name: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.adNameMax).optional(),
-  headlines: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenVideoAd.headlinesMin).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.headlinesMax),
-  longHeadlines: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.longHeadlineTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenVideoAd.longHeadlinesMin).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.longHeadlinesMax),
-  descriptions: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenVideoAd.descriptionsMin).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.descriptionsMax),
+  headlines: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenVideoAd.headlinesMin).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.headlinesMax),
+  longHeadlines: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.longHeadlineTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenVideoAd.longHeadlinesMin).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.longHeadlinesMax),
+  descriptions: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.demandGenVideoAd.descriptionsMin).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.descriptionsMax),
   businessName: z5.string().min(1).max(GOOGLE_ADS_LIMITS.demandGenVideoAd.businessNameMax),
   finalUrls: z5.array(httpsUrlSchema2).min(1),
   videoAssets: z5.array(refSchema).optional(),
@@ -3366,25 +3439,25 @@ var adUpdateSchema = z5.object({
   /** Whole-content replacement for RSA-like formats; re-validated against adContentSchema. */
   content: z5.record(z5.string(), z5.unknown()).optional()
 }).refine((p) => Object.values(p).some((v) => v !== void 0), "update needs at least one field");
-var textAssetSchema = z5.object({ type: z5.literal("text"), text: z5.string().min(1) });
-var imageAssetSchema = z5.object({
+var textAssetSchema = z5.strictObject({ type: z5.literal("text"), text: z5.string().min(1) });
+var imageAssetSchema = z5.strictObject({
   type: z5.literal("image"),
   imageId: z5.string().min(1),
   name: z5.string().optional()
 });
-var youtubeVideoAssetSchema = z5.object({
+var youtubeVideoAssetSchema = z5.strictObject({
   type: z5.literal("youtubeVideo"),
   youtubeVideoId: z5.string().min(1),
   name: z5.string().optional()
 });
-var sitelinkAssetSchema = z5.object({
+var sitelinkAssetSchema = z5.strictObject({
   type: z5.literal("sitelink"),
   linkText: z5.string().min(1).max(GOOGLE_ADS_LIMITS.asset.sitelinkLinkTextMax),
   description1: z5.string().max(GOOGLE_ADS_LIMITS.asset.sitelinkDescriptionMax).optional(),
   description2: z5.string().max(GOOGLE_ADS_LIMITS.asset.sitelinkDescriptionMax).optional(),
   finalUrls: z5.array(httpsUrlSchema2).min(1)
 });
-var calloutAssetSchema = z5.object({
+var calloutAssetSchema = z5.strictObject({
   type: z5.literal("callout"),
   calloutText: z5.string().min(1).max(GOOGLE_ADS_LIMITS.asset.calloutTextMax)
 });
@@ -3399,12 +3472,12 @@ var structuredSnippetHeaderSchema = z5.string().min(1).transform((header, ctx) =
   }
   return canonical2;
 });
-var structuredSnippetAssetSchema = z5.object({
+var structuredSnippetAssetSchema = z5.strictObject({
   type: z5.literal("structuredSnippet"),
   header: structuredSnippetHeaderSchema,
   values: z5.array(z5.string().min(1).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValueMax)).min(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMin).max(GOOGLE_ADS_LIMITS.asset.structuredSnippetValuesMax)
 });
-var callToActionAssetSchema = z5.object({ type: z5.literal("callToAction"), callToAction: z5.string().min(1) });
+var callToActionAssetSchema = z5.strictObject({ type: z5.literal("callToAction"), callToAction: z5.string().min(1) });
 var assetCreateSchema = z5.discriminatedUnion("type", [
   textAssetSchema,
   imageAssetSchema,
@@ -3414,7 +3487,7 @@ var assetCreateSchema = z5.discriminatedUnion("type", [
   structuredSnippetAssetSchema,
   callToActionAssetSchema
 ]);
-var assetUpdateSchema = z5.object({
+var assetUpdateSchema = z5.strictObject({
   name: z5.string().min(1).optional(),
   linkText: z5.string().min(1).max(GOOGLE_ADS_LIMITS.asset.sitelinkLinkTextMax).optional(),
   description1: z5.string().max(GOOGLE_ADS_LIMITS.asset.sitelinkDescriptionMax).optional(),
@@ -3458,9 +3531,9 @@ var assetGroupCreateSchema = z5.object({
   campaign: refSchema,
   name: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.nameMax),
   finalUrls: z5.array(httpsUrlSchema2).min(1),
-  headlines: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.assetGroup.headlinesMin).max(GOOGLE_ADS_LIMITS.assetGroup.headlinesMax),
-  longHeadlines: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.longHeadlineTextMax) })).min(GOOGLE_ADS_LIMITS.assetGroup.longHeadlinesMin).max(GOOGLE_ADS_LIMITS.assetGroup.longHeadlinesMax),
-  descriptions: z5.array(z5.object({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.assetGroup.descriptionsMin).max(GOOGLE_ADS_LIMITS.assetGroup.descriptionsMax),
+  headlines: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.headlineTextMax) })).min(GOOGLE_ADS_LIMITS.assetGroup.headlinesMin).max(GOOGLE_ADS_LIMITS.assetGroup.headlinesMax),
+  longHeadlines: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.longHeadlineTextMax) })).min(GOOGLE_ADS_LIMITS.assetGroup.longHeadlinesMin).max(GOOGLE_ADS_LIMITS.assetGroup.longHeadlinesMax),
+  descriptions: z5.array(z5.strictObject({ text: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.descriptionTextMax) })).min(GOOGLE_ADS_LIMITS.assetGroup.descriptionsMin).max(GOOGLE_ADS_LIMITS.assetGroup.descriptionsMax),
   businessName: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.businessNameMax),
   imageAssets: z5.array(refSchema).optional(),
   squareImageAssets: z5.array(refSchema).optional(),
@@ -3473,7 +3546,7 @@ var assetGroupAssetAttachSchema = z5.object({
   asset: refSchema,
   fieldType: z5.enum(ASSET_GROUP_ASSET_FIELD_TYPES)
 });
-var assetGroupUpdateSchema = z5.object({
+var assetGroupUpdateSchema = z5.strictObject({
   name: z5.string().min(1).max(GOOGLE_ADS_LIMITS.assetGroup.nameMax).optional(),
   finalUrls: z5.array(httpsUrlSchema2).min(1).optional(),
   status: z5.enum(["ENABLED", "PAUSED", "REMOVED"]).optional()
@@ -3524,7 +3597,7 @@ var conversionActionCreateSchema = z5.object({
   primaryForGoal: z5.boolean().optional()
 });
 var HIDDEN_CONVERSION_STATUS_ERROR = 'Google rejects status HIDDEN on every conversion action write ("the field\'s value is on a deny-list"), so it is not part of this contract. To stop automated bidding optimizing toward a conversion while it keeps measuring, demote it instead: `baker ads google conversions update --target <id> --no-primary`. To stop it counting altogether, use `status: "REMOVED"`. Pick one of those and carry on with the rest of the job.';
-var conversionActionUpdateSchema = z5.object({
+var conversionActionUpdateSchema = z5.strictObject({
   name: z5.string().min(1).max(GOOGLE_ADS_LIMITS.conversionAction.nameMax).optional(),
   category: z5.enum(CONVERSION_ACTION_CATEGORIES).optional(),
   countingType: z5.enum(CONVERSION_COUNTING_TYPES).optional(),
@@ -3568,7 +3641,7 @@ var biddingStrategyCreateSchema = z5.object({
     ctx.addIssue({ code: "custom", path: ["config", "type"], message: PORTFOLIO_TARGET_CPC_MESSAGE });
   }
 });
-var biddingStrategyUpdateSchema = z5.object({
+var biddingStrategyUpdateSchema = z5.strictObject({
   name: z5.string().min(1).max(GOOGLE_ADS_LIMITS.biddingStrategy.nameMax).optional(),
   config: biddingConfigSchema.optional()
 }).superRefine((p, ctx) => {
@@ -3589,15 +3662,15 @@ var labelAttachSchema = z5.object({
   parent: refSchema,
   label: refSchema
 });
-var locationCriterionSchema = z5.object({
+var locationCriterionSchema = z5.strictObject({
   criterionType: z5.literal("location"),
   geoTargetConstant: z5.union([z5.string().regex(GEO_TARGET_CONSTANT_REGEX), z5.string().regex(NUMERIC_ID_REGEX2)])
 });
-var languageCriterionSchema = z5.object({
+var languageCriterionSchema = z5.strictObject({
   criterionType: z5.literal("language"),
   languageConstant: z5.union([z5.string().regex(LANGUAGE_CONSTANT_REGEX), z5.string().regex(NUMERIC_ID_REGEX2)])
 });
-var adScheduleCriterionSchema = z5.object({
+var adScheduleCriterionSchema = z5.strictObject({
   criterionType: z5.literal("adSchedule"),
   dayOfWeek: z5.enum(DAYS_OF_WEEK),
   startHour: z5.number().int().min(0).max(23),
@@ -3608,7 +3681,7 @@ var adScheduleCriterionSchema = z5.object({
 var bidModifierSchema = z5.number().min(0).max(10).refine((v) => v === 0 || v >= 0.1, {
   message: "bid modifier must be 0 (exclude the device) or between 0.1 and 10.0"
 });
-var deviceCriterionSchema = z5.object({
+var deviceCriterionSchema = z5.strictObject({
   criterionType: z5.literal("device"),
   device: z5.enum(DEVICE_TYPES),
   bidModifier: bidModifierSchema.optional()
@@ -3632,7 +3705,7 @@ var campaignCriterionAddSchema = z5.object({
     });
   }
 });
-var campaignCriterionUpdateSchema = z5.object({
+var campaignCriterionUpdateSchema = z5.strictObject({
   bidModifier: bidModifierSchema
 });
 var GOOGLE_DRAFT_OP_KINDS = [
@@ -19937,7 +20010,11 @@ registerSchema({
     name: { type: "string", description: "Audience name (\u2264100 chars)", required: true },
     type: { type: "string", description: "company-list|user-list|retargeting|engagement", required: true },
     "list-file": { type: "string", description: "CSV file with the list rows", required: false },
-    file: { type: "string", description: "JSON raw source config for retargeting/engagement", required: false }
+    file: {
+      type: "string",
+      description: "JSON raw source config for retargeting/engagement \u2014 sourcePlatform, type USER, and engagementRules (engagementSource, engagementTrigger, timeFrame)",
+      required: false
+    }
   }
 });
 registerSchema({
@@ -20689,7 +20766,10 @@ Example: baker ads linkedin audiences create --name "ABM Tier-1" --type company-
     name: { type: "string", description: "Audience name (\u2264100 chars)" },
     type: { type: "string", description: AUDIENCE_TYPES2.join("|") },
     "list-file": { type: "string", description: "CSV file with the list rows (header row required)" },
-    file: { type: "string", description: "JSON file with a raw source config (retargeting/engagement)" }
+    file: {
+      type: "string",
+      description: 'JSON file with a raw source config (retargeting/engagement) \u2014 sourcePlatform, type USER and at least one engagementRules entry, e.g. {"sourcePlatform":"VIDEO_ADS","type":"USER","engagementRules":[{"engagementSource":"urn:li:sponsoredCampaign:123","engagementTrigger":"urn:li:dmpEngagementTrigger:(urn:li:dmpEngagementSourceType:VIDEO_ADS,FIRST_QUARTILE)","timeFrame":{"timeSpan":{"duration":90,"unit":"DAY"}}}]}'
+    }
   },
   run: async ({ args: args5 }) => {
     const accountId = bareAccountId(args5);
@@ -22373,6 +22453,10 @@ function renderOutcome2(data, lines) {
   lines.push(`LinkedIn Ads \u2014 published \xB7 ${summary || `${data.count} op(s)`} \xB7 ${data.mode}`);
   for (const op of data.ops ?? []) {
     const status = op.result?.status;
+    if (status === "applied" && op.result?.error) {
+      lines.push(`  \u26A0 ${op.summary} \u2014 applied in part: ${op.result.error}`);
+      continue;
+    }
     if (status !== "failed" && status !== "skipped") {
       continue;
     }