@koda-sl/baker-cli 0.562.0 → 0.563.0-dev.25ca3cbc8

package/dist/chunk-RL4QUOVQ.js

@@ -0,0 +1,91 @@
+import {
+  definitionPlatformOf,
+  parseDefinitionDelivery,
+  resolveDelivery,
+  resolveFormatList
+} from "./chunk-A3MZX27M.js";
+import {
+  AD_PLACEMENTS
+} from "./chunk-UQA3ASVK.js";
+import {
+  CAPABILITY_SURFACES
+} from "./chunk-R7XDGNZD.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+
+// src/commands/canvas/scaffold-delivery.ts
+var flagText = (value) => typeof value === "string" || typeof value === "number" ? String(value).trim() || void 0 : void 0;
+function deliveryInputOf(flags, definition, idea) {
+  const platformsFlag = flagText(flags.platforms);
+  const legacyPlatform = flagText(flags.platform);
+  const legacyPlacements = flagText(flags.placements);
+  const aspect = flagText(flags.aspect);
+  const formatsFlag = flagText(flags.formats);
+  const targetAdSet = flagText(flags["target-adset"]);
+  return {
+    ...platformsFlag ? { platformsFlag } : {},
+    ...legacyPlatform ? { legacyPlatform } : {},
+    ...legacyPlacements ? { legacyPlacements } : {},
+    ...aspect ? { aspect } : {},
+    ...formatsFlag ? { formatsFlag } : {},
+    ...idea && idea.length > 0 ? { idea } : {},
+    definition,
+    ...targetAdSet ? { targetAdSet } : {}
+  };
+}
+function namesDelivery(flags) {
+  return [flags.platforms, flags.platform, flags.placements, flags.formats].some((f) => flagText(f) !== void 0);
+}
+var SURFACE_PLATFORMS = {
+  "meta-ads": "meta",
+  "linkedin-ads": "linkedin",
+  "google-ads": "google_demandgen",
+  "x-ads": "x",
+  "chatgpt-ads": "chatgpt"
+};
+async function connectedAdPlatforms() {
+  try {
+    const response = await apiPost("/api/capabilities", {}, { timeoutMs: 15e3 });
+    return response.data.surfaces.filter((s) => s.connected && CAPABILITY_SURFACES.includes(s.surface)).flatMap((s) => SURFACE_PLATFORMS[s.surface] ? [SURFACE_PLATFORMS[s.surface]] : []);
+  } catch {
+    return [];
+  }
+}
+async function scaffoldDelivery(flags, definitionText, idea) {
+  const definition = definitionText === null ? null : parseDefinitionDelivery(definitionText);
+  const input = deliveryInputOf(flags, definition, idea);
+  const resolved = resolveDelivery(input);
+  if (resolved.ok || resolved.error.code !== "platform_required") return resolved;
+  return resolveDelivery({ ...input, connected: await connectedAdPlatforms() });
+}
+function deliveryDefinitionFields(delivery) {
+  const platforms = delivery.platforms.map((p) => p.trim());
+  return {
+    // The collection names whole platforms; a placement named alone records its platform.
+    platforms: [...new Set(platforms.map(platformOfName))],
+    platform: definitionPlatformOf(platforms[0] ?? ""),
+    formats: resolveFormatList(delivery.formats)
+  };
+}
+function platformOfName(name) {
+  return AD_PLACEMENTS.find((p) => p.id === name)?.platform ?? name;
+}
+function deliveryNote(delivery, renderRatio) {
+  const from = {
+    flag: "as asked",
+    idea: "from the idea",
+    definition: "from _definition.md",
+    legacy_definition: "from _definition.md's platform",
+    adset: "from its Meta ad set"
+  };
+  return `Made for ${delivery.platforms.join(", ")} (${from[delivery.source]}): delivers ${delivery.formats.join(", ")}, the ${delivery.lead} designed first (rendered at ${renderRatio}) and every other size re-laid out from it.`;
+}
+
+export {
+  namesDelivery,
+  scaffoldDelivery,
+  deliveryDefinitionFields,
+  deliveryNote
+};
+//# sourceMappingURL=chunk-RL4QUOVQ.js.map

package/dist/chunk-S5NSCPWH.js

@@ -0,0 +1,249 @@
+import {
+  readWorkspaceBrandDoc
+} from "./chunk-DWA42GNM.js";
+import {
+  brandTokensSchema
+} from "./chunk-OVNVYNVH.js";
+
+// src/engine/landing/lib/brand-tokens.ts
+import { readFile } from "fs/promises";
+import path from "path";
+
+// src/engine/landing/lib/color.ts
+var NEUTRAL_COLOR_KEYWORDS = /* @__PURE__ */ new Set([
+  "transparent",
+  "currentcolor",
+  "black",
+  "white",
+  "gray",
+  "grey",
+  "silver",
+  "dimgray",
+  "dimgrey",
+  "darkgray",
+  "darkgrey",
+  "lightgray",
+  "lightgrey",
+  "gainsboro",
+  "whitesmoke"
+]);
+function hexChannels(color) {
+  const long = color.match(/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})(?:[0-9a-f]{2})?$/i);
+  if (long)
+    return [
+      Number.parseInt(long[1] ?? "0", 16),
+      Number.parseInt(long[2] ?? "0", 16),
+      Number.parseInt(long[3] ?? "0", 16)
+    ];
+  const short = color.match(/^#([0-9a-f])([0-9a-f])([0-9a-f])(?:[0-9a-f])?$/i);
+  if (short) {
+    const dup = (s) => Number.parseInt(`${s ?? "0"}${s ?? "0"}`, 16);
+    return [dup(short[1]), dup(short[2]), dup(short[3])];
+  }
+  return null;
+}
+function parseColor(raw) {
+  const c = String(raw || "").trim().toLowerCase();
+  if (!c || c === "transparent") return null;
+  const rgb = c.match(/rgba?\(\s*([\d.]+)[\s,]+([\d.]+)[\s,]+([\d.]+)(?:[\s,/]+([\d.]+%?))?\s*\)/i);
+  if (rgb) {
+    const alpha = rgb[4];
+    const a = alpha === void 0 ? 1 : alpha.endsWith("%") ? Number.parseFloat(alpha) / 100 : Number.parseFloat(alpha);
+    return { r: Number(rgb[1]), g: Number(rgb[2]), b: Number(rgb[3]), a };
+  }
+  const oklch = parseOklch(c);
+  if (oklch) return oklch;
+  const hex = hexChannels(c);
+  if (hex) return { r: hex[0], g: hex[1], b: hex[2], a: 1 };
+  return null;
+}
+function parseOklch(c) {
+  const m = c.match(/oklch\(\s*([\d.]+%?)\s+([\d.]+%?)\s+([\d.]+)(?:deg)?(?:\s*\/\s*([\d.]+%?))?\s*\)/i);
+  if (!m) return null;
+  const pct = (s, scale) => s.endsWith("%") ? Number.parseFloat(s) / 100 * scale : Number.parseFloat(s);
+  const alpha = m[4];
+  const a = alpha === void 0 ? 1 : pct(alpha, 1);
+  return { ...oklchToRgb(pct(m[1] ?? "0", 1), pct(m[2] ?? "0", 0.4), Number.parseFloat(m[3] ?? "0")), a };
+}
+function oklchToRgb(L, C, H) {
+  const hRad = H * Math.PI / 180;
+  const a = C * Math.cos(hRad);
+  const b = C * Math.sin(hRad);
+  const l = (L + 0.3963377774 * a + 0.2158037573 * b) ** 3;
+  const m = (L - 0.1055613458 * a - 0.0638541728 * b) ** 3;
+  const s = (L - 0.0894841775 * a - 1.291485548 * b) ** 3;
+  const lin = [
+    4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,
+    -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,
+    -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s
+  ].map((v) => {
+    const g = v <= 31308e-7 ? 12.92 * v : 1.055 * Math.sign(v) * Math.abs(v) ** (1 / 2.4) - 0.055;
+    return Math.round(Math.max(0, Math.min(1, g)) * 255);
+  });
+  return { r: lin[0] ?? 0, g: lin[1] ?? 0, b: lin[2] ?? 0 };
+}
+function isNeutralAuthoredColor(rawColor) {
+  const c = String(rawColor || "").trim().toLowerCase();
+  if (!c) return false;
+  if (NEUTRAL_COLOR_KEYWORDS.has(c)) return true;
+  if (/^rgba?\(/i.test(c)) {
+    const channels2 = c.match(/^rgba?\(\s*([\d.]+)[\s,]+([\d.]+)[\s,]+([\d.]+)/i);
+    if (channels2) {
+      const values = [1, 2, 3].map((i) => Number(channels2[i]));
+      return Math.max(...values) - Math.min(...values) < 30;
+    }
+    return false;
+  }
+  const oklch = c.match(/oklch\(\s*[\d.]+%?\s+([\d.-]+)/i);
+  if (oklch) return Number.parseFloat(oklch[1] ?? "0") < 0.02;
+  const lch = c.match(/lch\(\s*[\d.]+%?\s+([\d.-]+)/i);
+  if (lch) return Number.parseFloat(lch[1] ?? "0") < 3;
+  const hsl = c.match(/hsla?\(\s*[\d.-]+\s*,?\s*([\d.]+)%/i);
+  if (hsl) return Number.parseFloat(hsl[1] ?? "0") < 10;
+  const channels = hexChannels(c);
+  if (channels) return Math.max(...channels) - Math.min(...channels) < 30;
+  return false;
+}
+function hasChroma(c, threshold = 30) {
+  if (!c) return false;
+  return Math.max(c.r, c.g, c.b) - Math.min(c.r, c.g, c.b) >= threshold;
+}
+function getHue(c) {
+  if (!c) return 0;
+  const r = c.r / 255;
+  const g = c.g / 255;
+  const b = c.b / 255;
+  const max = Math.max(r, g, b);
+  const min = Math.min(r, g, b);
+  if (max === min) return 0;
+  const d = max - min;
+  let h;
+  if (max === r) h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+  else if (max === g) h = ((b - r) / d + 2) / 6;
+  else h = ((r - g) / d + 4) / 6;
+  return Math.round(h * 360);
+}
+function isAiPurpleHue(hue) {
+  return hue >= 225 && hue <= 310;
+}
+function isCreamColor(c) {
+  if (Math.min(c.r, c.g, c.b) < 209) return false;
+  if (!(c.r >= c.g && c.g >= c.b)) return false;
+  const warmth = c.r - c.b;
+  return warmth >= 6 && warmth <= 48;
+}
+
+// src/engine/landing/lib/brand-tokens.ts
+var EMPTY = { fonts: /* @__PURE__ */ new Set(), colors: [], gradientStops: [], hasTokens: false };
+function isNotAFamily(value) {
+  return /^[1-9]00$/.test(value) || /^\d+(?:\.\d+)?(?:px|rem|em|%|pt|vw|vh|ch|ex)$/i.test(value) || /^(?:normal|bold|bolder|lighter|italic|oblique|none|auto|inherit|initial|unset)$/i.test(value);
+}
+function parseBrandTokens(globalCss, brandDoc) {
+  const fonts = /* @__PURE__ */ new Set();
+  const colors = [];
+  parseGlobalCss(globalCss, fonts, colors);
+  for (const font of brandDoc?.fonts ?? []) if (font.use) fonts.add(font.family.toLowerCase());
+  for (const color of brandDoc?.colors ?? []) {
+    const parsed = color.use ? parseColor(color.hex) : null;
+    if (parsed) colors.push(parsed);
+  }
+  return { fonts, colors, gradientStops: [], hasTokens: fonts.size > 0 || colors.length > 0 };
+}
+var COLOR_LITERAL = /#[0-9a-f]{3,8}\b|rgba?\([^)]*\)|oklch\([^)]*\)/gi;
+function chromaticStops(text) {
+  return (text.match(COLOR_LITERAL) ?? []).map(parseColor).filter((c) => c !== null && hasChroma(c));
+}
+function brandDocGradientStops(brandMd) {
+  const gradients = brandMd.match(/(?:repeating-)?(?:linear|radial|conic)-gradient\((?:[^()]|\([^()]*\))*\)/gi) ?? [];
+  return gradients.flatMap(chromaticStops);
+}
+function parseGlobalCss(rawCss, fonts, colors) {
+  const globalCss = rawCss.replace(/\/\*[\s\S]*?\*\//g, (block) => block.replace(/[^\n]/g, " "));
+  for (const m of globalCss.matchAll(/(?<![\w-])--font-([\w-]*)\s*:\s*([^;]+);/gi)) {
+    const slug = m[1] ?? "";
+    if (slug.includes("--") || /^weight(?:$|[-\s])/i.test(slug)) continue;
+    const first = (m[2] ?? "").split(",")[0]?.trim().replace(/^['"]|['"]$/g, "").toLowerCase();
+    if (!first || isNotAFamily(first)) continue;
+    fonts.add(first);
+  }
+  for (const m of globalCss.matchAll(
+    /--color-[\w-]*\s*:\s*(#[0-9a-f]{3,8}\b|rgba?\([^)]+\)|oklch\([^)]+\)|hsla?\([^)]+\))/gi
+  )) {
+    const c = parseColor(m[1] ?? "");
+    if (c) colors.push(c);
+  }
+}
+function brandTokensFromCanonical(tokens) {
+  const fonts = new Set(tokens.fonts.map((f) => f.family.toLowerCase()));
+  const colors = [];
+  for (const color of tokens.colors) {
+    const parsed = parseColor(color.value);
+    if (parsed) colors.push(parsed);
+  }
+  return { fonts, colors, gradientStops: [], hasTokens: fonts.size > 0 || colors.length > 0 };
+}
+async function loadBrandTokens(projectRoot, opts = {}) {
+  const gradientStops = brandDocGradientStops(await safeRead(path.join(projectRoot, "src", "brand", "BRAND.md")));
+  const brand = await loadCommittedTokens(projectRoot, opts);
+  return gradientStops.length > 0 ? { ...brand, gradientStops, hasTokens: true } : brand;
+}
+async function loadCommittedTokens(projectRoot, opts) {
+  const tokensRaw = await safeRead(path.join(projectRoot, "src", "brand", "tokens.json"));
+  if (tokensRaw) {
+    try {
+      const canonical = brandTokensSchema.safeParse(JSON.parse(tokensRaw));
+      if (canonical.success) return brandTokensFromCanonical(canonical.data);
+    } catch {
+    }
+  }
+  const globalCss = await safeRead(path.join(projectRoot, "src", "styles", "global.css"));
+  const brandDoc = await readWorkspaceBrandDoc(projectRoot, {
+    ...opts.readBrandDoc ? { read: opts.readBrandDoc } : {},
+    ...opts.onSpend ? { onSpend: opts.onSpend } : {}
+  });
+  if (!globalCss && !brandDoc) return EMPTY;
+  return parseBrandTokens(globalCss, brandDoc);
+}
+async function safeRead(file) {
+  try {
+    return await readFile(file, "utf8");
+  } catch {
+    return "";
+  }
+}
+function brandCommitsFont(brand, snippet) {
+  if (brand.fonts.size === 0) return false;
+  const lower = snippet.toLowerCase();
+  for (const f of brand.fonts) if (f.length >= 3 && lower.includes(f)) return true;
+  return false;
+}
+function brandCommitsAiHue(brand) {
+  return brand.colors.some((c) => hasChroma(c, 40) && isAiPurpleHue(getHue(c)));
+}
+var SAME_COLOR_TOLERANCE = 6;
+function sameColor(a, b) {
+  return Math.abs(a.r - b.r) <= SAME_COLOR_TOLERANCE && Math.abs(a.g - b.g) <= SAME_COLOR_TOLERANCE && Math.abs(a.b - b.b) <= SAME_COLOR_TOLERANCE;
+}
+function brandCommitsGradient(brand, snippet) {
+  const stops = chromaticStops(snippet);
+  if (stops.length === 0) return false;
+  const committed = [...brand.colors, ...brand.gradientStops];
+  return stops.every((stop) => committed.some((c) => sameColor(c, stop)));
+}
+function brandCommitsCream(brand) {
+  return brand.colors.some((c) => isCreamColor(c));
+}
+
+export {
+  parseColor,
+  isNeutralAuthoredColor,
+  hasChroma,
+  isCreamColor,
+  parseBrandTokens,
+  loadBrandTokens,
+  brandCommitsFont,
+  brandCommitsAiHue,
+  brandCommitsGradient,
+  brandCommitsCream
+};
+//# sourceMappingURL=chunk-S5NSCPWH.js.map

package/dist/chunk-SROKJC6V.js

@@ -0,0 +1,61 @@
+import {
+  COST_TYPES,
+  OBJECTIVE_TYPES,
+  calendarDaySchema,
+  targetingCriteriaSchema
+} from "./chunk-OVNVYNVH.js";
+
+// ../api/src/ads-linkedin/planning.ts
+import { z } from "zod";
+var moneySchema = z.object({
+  amount: z.string().regex(/^\d+(\.\d+)?$/, "use a plain amount such as 250 or 5.57"),
+  currencyCode: z.string().regex(/^[A-Z]{3}$/).optional()
+});
+var accountIdSchema = z.string().min(1);
+var linkedinBidPricingRequestSchema = z.object({
+  accountId: accountIdSchema,
+  objectiveType: z.enum(OBJECTIVE_TYPES),
+  costType: z.enum(COST_TYPES).default("CPC"),
+  campaignType: z.enum(["SPONSORED_UPDATES", "TEXT_AD", "SPONSORED_INMAILS"]).default("SPONSORED_UPDATES"),
+  /** EXACT = audience expansion off, the playbook default. */
+  matchType: z.enum(["EXACT", "AUDIENCE_EXPANDED"]).default("EXACT"),
+  targetingCriteria: targetingCriteriaSchema,
+  skipCache: z.boolean().optional()
+});
+var LINKEDIN_FORECAST_DEFAULT_DAYS = 30;
+var linkedinForecastRequestSchema = z.object({
+  accountId: accountIdSchema,
+  objectiveType: z.enum(OBJECTIVE_TYPES).optional(),
+  costType: z.enum(COST_TYPES).default("CPC"),
+  campaignType: z.enum(["SPONSORED_UPDATES", "SPONSORED_INMAILS", "DYNAMIC"]).default("SPONSORED_UPDATES"),
+  /** First forecast day (UTC); defaults to tomorrow — LinkedIn forecasts only the future. */
+  startDate: calendarDaySchema.optional(),
+  days: z.number().int().min(1).max(365).default(LINKEDIN_FORECAST_DEFAULT_DAYS),
+  dailyBudget: moneySchema.optional(),
+  totalBudget: moneySchema.optional(),
+  /** A manual bid; without one LinkedIn forecasts its automated bidding. */
+  bid: moneySchema.optional(),
+  optimizationTarget: z.string().regex(/^[A-Z_]+$/).optional(),
+  targetingCriteria: targetingCriteriaSchema,
+  /** Add LinkedIn's raw series (daily, 7-day, 30-day) to the summary. */
+  full: z.boolean().default(false),
+  skipCache: z.boolean().optional()
+}).superRefine((req, ctx) => {
+  if (!req.dailyBudget && !req.totalBudget) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["totalBudget"],
+      message: "a budget is required (daily or total) \u2014 LinkedIn forecasts what a budget buys"
+    });
+  }
+  if (req.dailyBudget && req.totalBudget) {
+    ctx.addIssue({ code: "custom", path: ["totalBudget"], message: "pass a daily or a total budget, not both" });
+  }
+});
+
+export {
+  linkedinBidPricingRequestSchema,
+  LINKEDIN_FORECAST_DEFAULT_DAYS,
+  linkedinForecastRequestSchema
+};
+//# sourceMappingURL=chunk-SROKJC6V.js.map

package/dist/chunk-SRR7XEI3.js

@@ -0,0 +1,169 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-YD6OZSSY.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-RBCO3C3Q.js";
+import {
+  X_DRAFT_BATCH_MAX,
+  xDraftOpInputSchema
+} from "./chunk-OVNVYNVH.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+
+// src/commands/ads/x/write-shared.ts
+function failWriteValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function failPreflight(fields) {
+  writeJsonEnvelope({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: fields.map((f) => f.path ? `${f.path}: ${f.message}` : f.message).join("; "),
+      fields,
+      fix: {
+        action: "reject",
+        explanation: "Fix the named fields and stage again. Nothing was staged \u2014 the draft is exactly as it was before this call."
+      }
+    }
+  });
+  process.exit(1);
+}
+function handleXWriteError(err, accountId) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, accountId));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function decimalPlaces(value) {
+  const [mantissa, exponent] = String(value).trim().split(/e/i);
+  const written = (mantissa?.split(".")[1] ?? "").length;
+  return Math.max(0, written - (exponent ? Number(exponent) : 0));
+}
+function parseXMoney(value) {
+  if (value === void 0 || value === "") {
+    return { ok: true, micros: void 0 };
+  }
+  const amount = Number(value);
+  if (!Number.isFinite(amount) || amount <= 0) {
+    return { ok: false, reason: "must be a positive amount, for example 12.50" };
+  }
+  if (decimalPlaces(value) > 6) {
+    return { ok: false, reason: "is finer than X can express \u2014 it takes whole micros" };
+  }
+  return { ok: true, micros: Math.round(amount * 1e6) };
+}
+function microsFromArg(value, flag) {
+  const parsed = parseXMoney(value);
+  if (!parsed.ok) {
+    failWriteValidation(`${flag} ${parsed.reason}`);
+  }
+  return parsed.micros;
+}
+function csvArg(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  const parts = value.split(",").map((s) => s.trim()).filter(Boolean);
+  return parts.length > 0 ? parts : void 0;
+}
+function compact(payload) {
+  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0));
+}
+function batchNudge(data) {
+  const count = data?.sameKindStaged;
+  if (!count) {
+    return [];
+  }
+  return [
+    `${count} other change${count === 1 ? "" : "s"} of this kind and payload ${count === 1 ? "is" : "are"} already staged \u2014 pass every id to one call (\`--ids a,b,c\`) instead of one call each.`
+  ];
+}
+async function stageXOp(raw, hints) {
+  const preflight = xDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    failPreflight(preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message })));
+  }
+  const accountId = String(raw.accountId ?? "\u2014");
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/x/draft/stage", { chatId, op: preflight.data });
+    const allHints = [...batchNudge(response.data), ...hints ?? []];
+    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+  } catch (err) {
+    handleXWriteError(err, accountId);
+  }
+}
+async function stageXOps(rawOps, hints) {
+  if (rawOps.length === 1 && rawOps[0]) {
+    await stageXOp(rawOps[0], hints);
+    return;
+  }
+  if (rawOps.length > X_DRAFT_BATCH_MAX) {
+    failWriteValidation(`at most ${X_DRAFT_BATCH_MAX} changes can be staged in one call`);
+  }
+  const ops = [];
+  for (const [index, raw] of rawOps.entries()) {
+    const preflight = xDraftOpInputSchema.safeParse(raw);
+    if (!preflight.success) {
+      failPreflight(
+        preflight.error.issues.map((issue) => ({
+          path: `ops[${index}]${issue.path.length > 0 ? `.${issue.path.join(".")}` : ""}`,
+          message: issue.message
+        }))
+      );
+    }
+    ops.push(preflight.data);
+  }
+  const accountId = String(rawOps[0]?.accountId ?? "\u2014");
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/x/draft/stage-batch", { chatId, ops });
+    writeJsonEnvelope(hints && hints.length > 0 ? { ...response, hints } : response);
+  } catch (err) {
+    handleXWriteError(err, accountId);
+  }
+}
+async function stageAccountId(args) {
+  return await resolveXAccountId(args);
+}
+function requireTarget(args, name) {
+  const value = args[name];
+  if (typeof value !== "string" || value.length === 0) {
+    failWriteValidation(`${name} is required`);
+  }
+  return value;
+}
+function requireTargets(args, name) {
+  const ids = csvArg(args[name]);
+  if (!ids) {
+    failWriteValidation(`${name} is required \u2014 pass one or more ids, comma-separated`);
+  }
+  return ids;
+}
+
+export {
+  failWriteValidation,
+  microsFromArg,
+  csvArg,
+  compact,
+  stageXOp,
+  stageXOps,
+  stageAccountId,
+  requireTarget,
+  requireTargets
+};
+//# sourceMappingURL=chunk-SRR7XEI3.js.map