@koda-sl/baker-cli 0.380.0-dev.824ccf426 → 0.381.0

package/dist/cli.js

@@ -70,7 +70,7 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-HOMVJ2D3.js";
+} from "./chunk-FGHMWBUD.js";
 import {
   NAME_CONTAINS_ARG,
   csvOrJson,
@@ -143,7 +143,7 @@ import {
 } from "./chunk-HJEMOSPH.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand255, runMain } from "citty";
+import { defineCommand as defineCommand248, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -975,6 +975,9 @@ var OBJECTIVE_CAMPAIGN_TYPES = {
   ENGAGEMENT: ["SPONSORED_UPDATES", "DYNAMIC"]
 };
 var STAGEABLE_CREATE_STATUSES = ["DRAFT", "ACTIVE", "PAUSED"];
+var CAMPAIGN_GROUP_CREATE_STATUSES = ["DRAFT", "ACTIVE"];
+var CAMPAIGN_GROUP_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "DRAFT"];
+var POLITICAL_INTENTS = ["NOT_DECLARED", "NOT_POLITICAL", "POLITICAL"];
 var CREATIVE_INTENDED_STATUSES = ["ACTIVE", "PAUSED", "DRAFT"];
 var CTA_TYPES = [
   "APPLY",
@@ -1105,17 +1108,26 @@ var entityStatusSchema = z3.enum(["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "D
 function currencyMinimums(currencyCode) {
   return CURRENCY_MINIMUMS[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM;
 }
-var campaignGroupCreateSchema = z3.object({
+var campaignGroupFieldsSchema = z3.object({
   name: z3.string().min(1).max(LINKEDIN_LIMITS.campaignGroup.nameMax),
   runSchedule: runScheduleSchema,
   totalBudget: moneySchema.optional(),
-  status: stageableStatusSchema.default("DRAFT")
+  status: z3.enum(CAMPAIGN_GROUP_CREATE_STATUSES).default("DRAFT")
+});
+var campaignGroupCreateSchema = campaignGroupFieldsSchema.superRefine((p, ctx) => {
+  if (p.totalBudget && !p.runSchedule.end) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["runSchedule", "end"],
+      message: "a group with totalBudget needs runSchedule.end"
+    });
+  }
 });
 var campaignGroupUpdateSchema = z3.object({
   name: z3.string().min(1).max(LINKEDIN_LIMITS.campaignGroup.nameMax).optional(),
   runSchedule: runScheduleSchema.optional(),
   totalBudget: moneySchema.optional(),
-  status: entityStatusSchema.optional()
+  status: z3.enum(CAMPAIGN_GROUP_STATUSES).optional()
 }).refine((p) => Object.values(p).some((val) => val !== void 0), "update needs at least one field");
 var campaignFields = {
   name: z3.string().min(1).max(LINKEDIN_LIMITS.campaign.nameMax),
@@ -1134,6 +1146,7 @@ var campaignFields = {
   connectedTelevisionOnly: z3.boolean().default(false),
   creativeSelection: z3.enum(CREATIVE_SELECTIONS).optional(),
   associatedEntity: z3.string().regex(ORGANIZATION_URN_REGEX).optional(),
+  politicalIntent: z3.enum(POLITICAL_INTENTS).default("NOT_DECLARED"),
   status: stageableStatusSchema.default("DRAFT")
 };
 function validateCampaignBudgets(p, ctx, { requireBudget }) {
@@ -1191,6 +1204,7 @@ var campaignUpdateSchema = z3.object({
   offsiteDeliveryEnabled: z3.boolean().optional(),
   connectedTelevisionOnly: z3.boolean().optional(),
   creativeSelection: z3.enum(CREATIVE_SELECTIONS).optional(),
+  politicalIntent: z3.enum(POLITICAL_INTENTS).optional(),
   status: entityStatusSchema.optional(),
   // Create-only on LinkedIn — a live campaign can't change these in place.
   // Accepted here only so `draft amend` can carry them into a staged CREATE
@@ -1816,6 +1830,17 @@ var linkedinDraftOpInputSchema = z3.discriminatedUnion("kind", [
   updateOp("leadForm.update", leadFormUpdateSchema)
 ]);
 
+// ../api/src/ads-linkedin/search-statuses.ts
+var LINKEDIN_SEARCH_STATUSES = {
+  campaignGroups: ["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "DRAFT", "PENDING_DELETION", "REMOVED"],
+  campaigns: ["ACTIVE", "PAUSED", "ARCHIVED", "COMPLETED", "CANCELED", "DRAFT", "PENDING_DELETION", "REMOVED"],
+  creatives: ["ACTIVE", "PAUSED", "ARCHIVED", "CANCELED", "DRAFT", "PENDING_DELETION", "REMOVED"]
+};
+function unsupportedLinkedinSearchStatuses(level, statuses) {
+  const accepted = LINKEDIN_SEARCH_STATUSES[level];
+  return statuses.filter((status) => !accepted.includes(status));
+}
+
 // ../api/src/ads-linkedin/wire.ts
 import { z as z7 } from "zod";
 
@@ -4534,9 +4559,6 @@ var chatChangeTypeSchema = z13.enum([
   "image",
   "video",
   "followed-advertiser",
-  // A connected social account feeding the image and video libraries, keyed
-  // on `platform:handle`. Immediate — see convex/mediaSources/mutations.ts.
-  "media-source",
   // A landing page saved to the reference library, keyed on the page.
   "landing-reference",
   // One Studio batch — the takes of one brief, as a set. See convex/lib/validators.ts.
@@ -6401,10 +6423,6 @@ var imageSourceSchema = z20.enum([
   "google_testimonial",
   "trustpilot_testimonial",
   "instagram",
-  "tiktok",
-  "linkedin",
-  "facebook",
-  "google_drive",
   "pexels",
   "pixabay",
   // Retired stock provider — kept so existing library rows stay filterable.
@@ -8215,9 +8233,7 @@ var videoSourceSchema = z30.enum([
   "bluesky",
   "dailymotion",
   "facebook",
-  "google_drive",
   "instagram",
-  "linkedin",
   "loom",
   "newgrounds",
   "ok",
@@ -12111,6 +12127,24 @@ function adCopyHints(payload) {
   return tells.slice(0, MAX_HINTS).map(hintFor);
 }
 
+// src/commands/ads/hints.ts
+function backendHints(envelope) {
+  const hints2 = envelope.hints;
+  return Array.isArray(hints2) ? hints2.filter((hint) => typeof hint === "string") : [];
+}
+function withHints(envelope, extra) {
+  const hints2 = [...backendHints(envelope), ...extra];
+  return hints2.length > 0 ? { ...envelope, hints: hints2 } : envelope;
+}
+function hintLines(envelope) {
+  return backendHints(envelope).map((hint) => `
+> ${hint}`).join("");
+}
+function splitHints(response) {
+  const { hints: hints2, ...data } = response;
+  return { data, hints: hints2 ?? [] };
+}
+
 // src/commands/ads/google/copy-list-usage.ts
 var AD_COPY_LIST_USAGE = `repeat the flag once per item, or pass one comma-separated list and wrap an item that contains a comma in double quotes: '"Fast, free quotes",Book today'. A flag given once is read as a list, so a lone item with a comma needs its double quotes too: '"Fast, free quotes"'`;
 var COPY_LIST_FLAG = {
@@ -12118,9 +12152,9 @@ var COPY_LIST_FLAG = {
   descriptions: "--descriptions",
   longHeadlines: "--long-headlines"
 };
-function valueAt(root, path49) {
+function valueAt(root, path48) {
   let node = root;
-  for (const key of path49) {
+  for (const key of path48) {
     if (node === null || typeof node !== "object") return void 0;
     node = node[key];
   }
@@ -12353,11 +12387,11 @@ function parseKeywordEntry(raw, defaultMatch) {
 function rawTextEntries(value, rawArgs) {
   return repeatedValues(rawArgs, "text", value).flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
 }
-function rawFileEntries(path49) {
-  if (typeof path49 !== "string" || path49.length === 0) {
+function rawFileEntries(path48) {
+  if (typeof path48 !== "string" || path48.length === 0) {
     return [];
   }
-  return readFileSync2(path49, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync2(path48, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
 }
 function keywordEntries(args5, rawArgs) {
   const defaultMatch = typeof args5["match-type"] === "string" ? args5["match-type"].toUpperCase() : void 0;
@@ -12380,14 +12414,14 @@ function keywordEntries(args5, rawArgs) {
   }
   return entries;
 }
-function loadJsonFileArg(path49) {
-  if (typeof path49 !== "string" || path49.length === 0) {
+function loadJsonFileArg(path48) {
+  if (typeof path48 !== "string" || path48.length === 0) {
     return {};
   }
-  const inline = path49.trimStart().startsWith("{");
-  const source = inline ? "inline JSON" : path49;
+  const inline = path48.trimStart().startsWith("{");
+  const source = inline ? "inline JSON" : path48;
   try {
-    const parsed = JSON.parse(inline ? path49 : readFileSync2(path49, "utf8"));
+    const parsed = JSON.parse(inline ? path48 : readFileSync2(path48, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
       failWriteValidation(`${source} must contain a JSON object`);
     }
@@ -12475,7 +12509,7 @@ async function stageGoogleOp(raw, hints2) {
     const chatId = requireChatId();
     const response = await apiPost("/api/ads/google/draft/stage", { chatId, op: preflight.data });
     const allHints = [...noopHints(response.data), ...hints2 ?? [], ...adCopyHints(preflight.data)];
-    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+    writeJsonEnvelope(withHints(response, allHints));
   } catch (err) {
     handleGoogleError(err);
   }
@@ -12513,7 +12547,7 @@ async function stageGoogleOps(rawOps, hints2) {
     const chatId = requireChatId();
     const response = await apiPost("/api/ads/google/draft/stage-batch", { chatId, ops });
     const allHints = [...skippedHints(response.data.skipped ?? [], ops.length), ...hints2 ?? [], ...adCopyHints(ops)];
-    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+    writeJsonEnvelope(withHints(response, allHints));
   } catch (err) {
     handleGoogleError(err);
   }
@@ -12524,10 +12558,10 @@ async function stageUpdate(kind, customerId, target2, payload, hints2) {
 async function stageTarget(kind, customerId, target2, hints2) {
   await stageGoogleOp({ kind, customerId, target: target2 }, hints2);
 }
-async function draftAction(path49, body, chat) {
+async function draftAction(path48, body, chat) {
   try {
     const chatId = resolveChatId(chat);
-    const response = await apiPost(path49, { chatId, ...body });
+    const response = await apiPost(path48, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -12541,7 +12575,7 @@ async function draftListAction(json, chat) {
       writeJsonEnvelope(response);
       return;
     }
-    process.stdout.write(`${renderDraftStatus(response.data)}
+    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}
 `);
   } catch (err) {
     handleGoogleError(err);
@@ -14945,14 +14979,14 @@ function mappingRowProblem(row) {
 
 // ../api/src/event-sources/template.ts
 var MENTION = /\{\{\s*([^{}]+?)\s*\}\}/g;
-function mentionOf(path49) {
-  return `{{${path49}}}`;
+function mentionOf(path48) {
+  return `{{${path48}}}`;
 }
 function templateMentions(template) {
   const seen = [];
   for (const match of template.matchAll(MENTION)) {
-    const path49 = (match[1] ?? "").trim();
-    if (path49 !== "" && !seen.includes(path49)) seen.push(path49);
+    const path48 = (match[1] ?? "").trim();
+    if (path48 !== "" && !seen.includes(path48)) seen.push(path48);
   }
   return seen;
 }
@@ -18307,17 +18341,17 @@ function ignoredColumnHints(columns) {
     `Ignored ${columns.length} column(s) that are not part of a conversion: ${columns.join(", ")}. A conversion carries an order id, a date, and something to match on: a click id (gclid / gbraid / wbraid), an email, a phone, or all four of givenName + familyName + country + postalCode. Optionally a value + currency, conversionCount, and eventSource (WEB / APP / IN_STORE / PHONE / OTHER). A column named just \`Name\` is ignored on purpose \u2014 Google needs the first and last name separately, so split it before re-running.`
   ];
 }
-function readRowsFile(path49) {
-  const inline = path49.trimStart().startsWith("[") || path49.trimStart().startsWith("{");
+function readRowsFile(path48) {
+  const inline = path48.trimStart().startsWith("[") || path48.trimStart().startsWith("{");
   let text2;
   try {
-    text2 = inline ? path49 : readFileSync4(path49, "utf8");
+    text2 = inline ? path48 : readFileSync4(path48, "utf8");
   } catch (err) {
-    failWriteValidation(`could not read ${path49}: ${err instanceof Error ? err.message : String(err)}`);
+    failWriteValidation(`could not read ${path48}: ${err instanceof Error ? err.message : String(err)}`);
   }
   const parsed = parseConversionRowsText(text2);
   if (!parsed.ok) {
-    failWriteValidation(`${inline ? "the conversions passed inline" : path49}: ${parsed.error}`);
+    failWriteValidation(`${inline ? "the conversions passed inline" : path48}: ${parsed.error}`);
   }
   return { rows: parsed.rows, ignoredColumns: parsed.ignoredColumns };
 }
@@ -20075,10 +20109,6 @@ Full guide: __tooling__/docs/tools/baker/ads-google.md`
 // src/commands/ads/linkedin/index.ts
 import { defineCommand as defineCommand53 } from "citty";
 
-// src/commands/ads/linkedin/write-shared.ts
-import { createHash } from "crypto";
-import { readFileSync as readFileSync5 } from "fs";
-
 // src/commands/ads/linkedin/shared.ts
 var DAY_MS2 = 864e5;
 function handleLinkedinError(err) {
@@ -20171,18 +20201,48 @@ function daysAgoIso2(days) {
 function csvOrJson2(args5) {
   return args5.output ?? "json";
 }
-function resolveStatusFilter(args5) {
+function statusesArgDescription(level) {
+  return `CSV of statuses (${LINKEDIN_SEARCH_STATUSES[level].join(",")})`;
+}
+function statusFilterError(level, statuses) {
+  const unsupported = unsupportedLinkedinSearchStatuses(level, statuses);
+  if (unsupported.length === 0) {
+    return null;
+  }
+  const accepted = LINKEDIN_SEARCH_STATUSES[level].join(",");
+  return {
+    ok: false,
+    error: {
+      code: "INVALID_STATUS",
+      message: `LinkedIn does not accept status ${unsupported.join(", ")} for this listing.`,
+      fix: {
+        action: "retry_with_flag",
+        explanation: `Re-run with --statuses from ${accepted}, or --all-statuses to drop the filter.`
+      },
+      retryable: false
+    }
+  };
+}
+function resolveStatusFilter(args5, level) {
   if (args5["all-statuses"]) {
     return void 0;
   }
   const explicit = args5.statuses;
-  if (explicit) {
-    return explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  if (!explicit) {
+    return ["ACTIVE"];
+  }
+  const statuses = explicit.split(",").map((s) => s.trim().toUpperCase()).filter(Boolean);
+  const error = statusFilterError(level, statuses);
+  if (error) {
+    writeAdsJson(error);
+    process.exit(1);
   }
-  return ["ACTIVE"];
+  return statuses;
 }
 
 // src/commands/ads/linkedin/write-shared.ts
+import { createHash } from "crypto";
+import { readFileSync as readFileSync5 } from "fs";
 var TOTAL_BUDGET_HELP = "Lifetime budget \u2014 on something already running it must exceed spend to date, or LinkedIn rejects it";
 function bareAccountId(args5) {
   const raw = resolveAccountIdArg2(args5);
@@ -20192,19 +20252,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path49) {
-  if (typeof path49 !== "string" || path49.length === 0) {
+function loadJsonFileArg2(path48) {
+  if (typeof path48 !== "string" || path48.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync5(path49, "utf8"));
+    const parsed = JSON.parse(readFileSync5(path48, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path49} must contain a JSON object`);
+      failWriteValidation2(`${path48} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path49} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path48} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -20289,15 +20349,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path49) {
-  if (typeof path49 !== "string" || path49.length === 0) {
+function loadTargetingFileArg(path48) {
+  if (typeof path48 !== "string" || path48.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path49);
+  const parsed = loadJsonFileArg2(path48);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path49} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path48} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -20332,14 +20392,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell3) => cell3.trim());
 }
-function parseListFileArg(path49, maxRows) {
-  if (typeof path49 !== "string" || path49.length === 0) {
+function parseListFileArg(path48, maxRows) {
+  if (typeof path48 !== "string" || path48.length === 0) {
     return void 0;
   }
-  const raw = readFileSync5(path49, "utf8");
+  const raw = readFileSync5(path48, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path49} needs a header row and at least one data row`);
+    failWriteValidation2(`${path48} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -20358,7 +20418,7 @@ function parseListFileArg(path49, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path49} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path48} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -20390,7 +20450,7 @@ async function stageOp(raw, hints2) {
       op: preflight.data
     });
     const allHints = [...batchNudge(response.data), ...hints2 ?? [], ...adCopyHints(preflight.data)];
-    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+    writeJsonEnvelope(withHints(response, allHints));
   } catch (err) {
     handleLinkedinError(err);
   }
@@ -20417,7 +20477,7 @@ async function stageLinkedinOps(rawOps, hints2) {
     const chatId = requireChatId();
     const response = await apiPost("/api/ads/linkedin/draft/stage-batch", { chatId, ops });
     const allHints = [...hints2 ?? [], ...adCopyHints(ops)];
-    writeJsonEnvelope(allHints.length > 0 ? { ...response, hints: allHints } : response);
+    writeJsonEnvelope(withHints(response, allHints));
   } catch (err) {
     handleLinkedinError(err);
   }
@@ -20454,11 +20514,11 @@ function readPositionals(args5) {
 function splitIdList(raw) {
   return raw.split(",").map((id) => id.trim()).filter(Boolean);
 }
-function idsFileEntries(path49) {
-  if (typeof path49 !== "string" || path49.length === 0) {
+function idsFileEntries(path48) {
+  if (typeof path48 !== "string" || path48.length === 0) {
     return [];
   }
-  return readFileSync5(path49, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+  return readFileSync5(path48, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
 }
 function requireTargets(args5, entity) {
   const positionals = readPositionals(args5);
@@ -20509,7 +20569,7 @@ registerSchema({
     "account-id": { type: "string", description: "Account ID", required: false },
     "account-urn": { type: "string", description: "Alias for --account-id", required: false },
     "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
-    statuses: { type: "string", description: "CSV of statuses", required: false },
+    statuses: { type: "string", description: statusesArgDescription("campaignGroups"), required: false },
     limit: { type: "string", description: "Max rows (default 500)", required: false },
     "no-cache": NO_CACHE_ARG,
     output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
@@ -20523,7 +20583,7 @@ registerSchema({
     "account-urn": { type: "string", description: "Alias", required: false },
     "campaign-group-id": { type: "string", description: "Filter by campaign group", required: false },
     "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
-    statuses: { type: "string", description: "CSV of statuses", required: false },
+    statuses: { type: "string", description: statusesArgDescription("campaigns"), required: false },
     limit: { type: "string", description: "Max rows", required: false },
     "no-cache": NO_CACHE_ARG,
     output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
@@ -20537,7 +20597,7 @@ registerSchema({
     "account-urn": { type: "string", description: "Alias", required: false },
     "campaign-id": { type: "string", description: "Filter by campaign", required: false },
     "all-statuses": { type: "boolean", description: "Drop the ACTIVE filter", required: false },
-    statuses: { type: "string", description: "CSV of statuses", required: false },
+    statuses: { type: "string", description: statusesArgDescription("creatives"), required: false },
     fields: {
       type: "string",
       description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage",
@@ -20810,7 +20870,11 @@ registerSchema({
       description: "3-letter currency code (defaults to the ad account currency)",
       required: false
     },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE (default DRAFT) \u2014 LinkedIn refuses a new group created PAUSED",
+      required: false
+    },
     file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
   }
 });
@@ -20868,7 +20932,16 @@ registerSchema({
     ctv: { type: "string", description: "Connected TV on|off (default off)", required: false },
     "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN", required: false },
     "associated-entity": { type: "string", description: "Organization URN", required: false },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)", required: false },
+    "political-intent": {
+      type: "string",
+      description: "NOT_DECLARED (default)|NOT_POLITICAL|POLITICAL \u2014 the advertiser's declaration; NOT_POLITICAL only after the user confirms their ads are not political advertising",
+      required: false
+    },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE|PAUSED (default DRAFT) \u2014 PAUSED needs a group that is not DRAFT",
+      required: false
+    },
     file: { type: "string", description: "JSON payload file; flags override file keys", required: false }
   }
 });
@@ -20896,6 +20969,11 @@ registerSchema({
     lan: { type: "string", description: "on|off", required: false },
     ctv: { type: "string", description: "on|off", required: false },
     "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN", required: false },
+    "political-intent": {
+      type: "string",
+      description: "NOT_DECLARED (default)|NOT_POLITICAL|POLITICAL \u2014 the advertiser's declaration; NOT_POLITICAL only after the user confirms their ads are not political advertising",
+      required: false
+    },
     status: { type: "string", description: "ACTIVE|PAUSED|ARCHIVED", required: false },
     file: { type: "string", description: "JSON file with fields to change", required: false }
   }
@@ -21291,7 +21369,8 @@ var campaignGroupsCreateCommand = defineCommand33({
   meta: {
     name: "create",
     description: `Stage a new campaign group. ${STAGED_NOTE}
-Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-07-10 --total-budget 5000 --currency EUR`
+A group can't be created PAUSED, and a --total-budget needs an --end.
+Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-07-10 --end 2026-09-30 --total-budget 5000 --currency EUR`
   },
   args: {
     ...accountArgs,
@@ -21300,7 +21379,10 @@ Example: baker ads linkedin campaign-groups create --name "Q3 ABM" --start 2026-
     end: { type: "string", description: "Run schedule end" },
     "total-budget": { type: "string", description: TOTAL_BUDGET_HELP },
     currency: { type: "string", description: "3-letter currency code (defaults to the ad account currency)" },
-    status: { type: "string", description: "DRAFT|ACTIVE|PAUSED (default DRAFT)" },
+    status: {
+      type: "string",
+      description: "DRAFT|ACTIVE (default DRAFT) \u2014 LinkedIn refuses a new group created PAUSED; pause it once it exists"
+    },
     file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
   },
   run: async ({ args: args5 }) => {
@@ -21366,9 +21448,11 @@ function campaignPayloadFromFlags(args5) {
     connectedTelevisionOnly: parseOnOffFlag(args5.ctv, "--ctv"),
     creativeSelection: args5["creative-selection"] ? String(args5["creative-selection"]).toUpperCase() : void 0,
     associatedEntity: args5["associated-entity"],
+    politicalIntent: args5["political-intent"] ? String(args5["political-intent"]).toUpperCase() : void 0,
     status: args5.status ? String(args5.status).toUpperCase() : void 0
   };
 }
+var POLITICAL_INTENT_HELP = `NOT_DECLARED (default)|NOT_POLITICAL|POLITICAL \u2014 the advertiser's own declaration. Pass NOT_POLITICAL only after the user confirms: "I confirm this is not political advertising. None of my ads qualify as political advertising under the law of the targeted countries, including EU law for ads targeted to the EU."`;
 var campaignFlagArgs = {
   ...accountArgs,
   name: { type: "string", description: "Campaign name (\u2264255 chars)" },
@@ -21389,7 +21473,8 @@ var campaignFlagArgs = {
   ctv: { type: "string", description: "Connected TV on|off" },
   "creative-selection": { type: "string", description: "OPTIMIZED|ROUND_ROBIN" },
   "associated-entity": { type: "string", description: "Organization URN" },
-  status: { type: "string", description: "DRAFT|ACTIVE|PAUSED" },
+  "political-intent": { type: "string", description: POLITICAL_INTENT_HELP },
+  status: { type: "string", description: "DRAFT|ACTIVE|PAUSED \u2014 PAUSED needs a group that is not DRAFT" },
   file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
 };
 var campaignsCreateCommand = defineCommand33({
@@ -22906,7 +22991,7 @@ var listArgs = {
   "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
   "account-urn": { type: "string", description: "Alias for --account-id" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
-  statuses: { type: "string", description: "CSV of statuses (ACTIVE,PAUSED,ARCHIVED,COMPLETED,DRAFT)" },
+  statuses: { type: "string", description: statusesArgDescription("campaignGroups") },
   limit: { type: "string", description: "Max rows (default: 500)" },
   "no-cache": NO_CACHE_ARG,
   output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
@@ -22921,7 +23006,7 @@ var campaignGroupsListCommand = defineCommand40({
     const accountId = resolveAccountIdArg2(args5);
     try {
       const params = { "account-id": accountId };
-      const statuses = resolveStatusFilter(args5);
+      const statuses = resolveStatusFilter(args5, "campaignGroups");
       if (statuses) params.statuses = statuses.join(",");
       if (args5.limit) params.limit = String(args5.limit);
       if (args5["no-cache"]) params["skip-cache"] = "true";
@@ -22972,7 +23057,7 @@ var listArgs2 = {
   "account-urn": { type: "string", description: "Alias for --account-id" },
   "campaign-group-id": { type: "string", description: "Filter by campaign group" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
-  statuses: { type: "string", description: "CSV of statuses" },
+  statuses: { type: "string", description: statusesArgDescription("campaigns") },
   limit: { type: "string", description: "Max rows (default: 500)" },
   "no-cache": NO_CACHE_ARG,
   output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
@@ -22987,7 +23072,7 @@ var campaignsListCommand = defineCommand41({
     const accountId = resolveAccountIdArg2(args5);
     try {
       const params = { "account-id": accountId };
-      const statuses = resolveStatusFilter(args5);
+      const statuses = resolveStatusFilter(args5, "campaigns");
       if (statuses) params.statuses = statuses.join(",");
       if (args5["campaign-group-id"]) params["campaign-group-id"] = String(args5["campaign-group-id"]);
       if (args5.limit) params.limit = String(args5.limit);
@@ -23220,9 +23305,9 @@ import { defineCommand as defineCommand44 } from "citty";
 function asRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
 }
-function readPath2(row, path49) {
+function readPath2(row, path48) {
   let current = row;
-  for (const segment of path49.split(".")) {
+  for (const segment of path48.split(".")) {
     const record = asRecord(current);
     if (!record) return void 0;
     current = record[segment];
@@ -23232,10 +23317,10 @@ function readPath2(row, path49) {
 function projectFields(rows, paths) {
   return rows.map((row) => {
     const projected = {};
-    for (const path49 of paths) {
-      const value = readPath2(row, path49);
+    for (const path48 of paths) {
+      const value = readPath2(row, path48);
       if (value !== void 0) {
-        projected[path49] = value;
+        projected[path48] = value;
       }
     }
     return projected;
@@ -23248,16 +23333,16 @@ function shapeListRows(rows, args5, compact4) {
     const paths = fields.split(",").map((field) => field.trim()).filter((field) => field.length > 0);
     if (paths.length > 0) {
       const projected = projectFields(raw, paths).map((row, i) => {
-        const missing = paths.filter((path49) => row[path49] === void 0);
+        const missing = paths.filter((path48) => row[path48] === void 0);
         const source = rows[i];
         if (missing.length === 0 || source === void 0) return row;
         const compactRow3 = compact4.row(source);
-        for (const path49 of missing) {
-          if (compactRow3[path49] !== void 0) row[path49] = compactRow3[path49];
+        for (const path48 of missing) {
+          if (compactRow3[path48] !== void 0) row[path48] = compactRow3[path48];
         }
         return row;
       });
-      const unmatched = paths.filter((path49) => projected.every((row) => row[path49] === void 0));
+      const unmatched = paths.filter((path48) => projected.every((row) => row[path48] === void 0));
       if (projected.length === 0 || unmatched.length === 0) return { rows: projected, fields: paths };
       const carried = /* @__PURE__ */ new Set([...compact4.columns, ...raw.flatMap((row) => Object.keys(row))]);
       return {
@@ -23337,7 +23422,7 @@ var listArgs3 = {
   "account-urn": { type: "string", description: "Alias for --account-id" },
   "campaign-id": { type: "string", description: "Filter by campaign ID" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
-  statuses: { type: "string", description: "CSV of intended statuses (ACTIVE,PAUSED,DRAFT,ARCHIVED)" },
+  statuses: { type: "string", description: statusesArgDescription("creatives") },
   fields: {
     type: "string",
     description: "CSV of dotted paths to return instead of the compact row, e.g. id,content.textAd.landingPage"
@@ -23357,7 +23442,7 @@ var creativesListCommand = defineCommand44({
     const accountId = resolveAccountIdArg2(args5);
     try {
       const params = { "account-id": accountId };
-      const statuses = resolveStatusFilter(args5);
+      const statuses = resolveStatusFilter(args5, "creatives");
       if (statuses) params.statuses = statuses.join(",");
       if (args5["campaign-id"]) params["campaign-id"] = String(args5["campaign-id"]);
       if (args5.limit) params.limit = String(args5.limit);
@@ -23664,7 +23749,7 @@ async function listDraft(json, chat) {
       writeJsonEnvelope(response);
       return;
     }
-    process.stdout.write(`${renderDraftStatus2(response.data)}
+    process.stdout.write(`${renderDraftStatus2(response.data)}${hintLines(response)}
 `);
   } catch (err) {
     handleLinkedinError(err);
@@ -24627,54 +24712,54 @@ function buildCustomConversionRule(input) {
 function customConversionRuleRefusal(rule) {
   return ruleNodeRefusal(rule, "rule");
 }
-function branchRefusal(key, value, path49) {
+function branchRefusal(key, value, path48) {
   if (!Array.isArray(value) || value.length === 0) {
-    return `${path49}.${key} must be a non-empty array of conditions \u2014 an empty one counts every event the pixel sends`;
+    return `${path48}.${key} must be a non-empty array of conditions \u2014 an empty one counts every event the pixel sends`;
   }
   for (const [index, child] of value.entries()) {
-    const refusal = ruleNodeRefusal(child, `${path49}.${key}[${index}]`);
+    const refusal = ruleNodeRefusal(child, `${path48}.${key}[${index}]`);
     if (refusal) {
       return refusal;
     }
   }
   return void 0;
 }
-function conditionRefusal(key, value, path49) {
-  return key === "and" || key === "or" ? branchRefusal(key, value, path49) : leafRefusal(key, value, path49);
+function conditionRefusal(key, value, path48) {
+  return key === "and" || key === "or" ? branchRefusal(key, value, path48) : leafRefusal(key, value, path48);
 }
-function ruleNodeRefusal(node, path49) {
+function ruleNodeRefusal(node, path48) {
   if (!isRecord2(node)) {
-    return `${path49} must be an object like {"URL":{"i_contains":"/thank-you"}}`;
+    return `${path48} must be an object like {"URL":{"i_contains":"/thank-you"}}`;
   }
   const entries = Object.entries(node);
   if (entries.length === 0) {
-    return `${path49} is empty \u2014 a rule with no condition counts every event the pixel sends`;
+    return `${path48} is empty \u2014 a rule with no condition counts every event the pixel sends`;
   }
   if (entries.length > 1) {
-    return `${path49} names ${entries.length} conditions side by side (${entries.map(([key]) => key).join(", ")}) \u2014 Meta reads one branch or one field test per object, so combine them with {"and":[\u2026]}`;
+    return `${path48} names ${entries.length} conditions side by side (${entries.map(([key]) => key).join(", ")}) \u2014 Meta reads one branch or one field test per object, so combine them with {"and":[\u2026]}`;
   }
   for (const [key, value] of entries) {
-    const refusal = conditionRefusal(key, value, path49);
+    const refusal = conditionRefusal(key, value, path48);
     if (refusal) {
       return refusal;
     }
   }
   return void 0;
 }
-function leafRefusal(field, condition, path49) {
+function leafRefusal(field, condition, path48) {
   if (!isRecord2(condition)) {
-    return `${path49}.${field} must be a test like {"i_contains":"/thank-you"}, not a bare value`;
+    return `${path48}.${field} must be a test like {"i_contains":"/thank-you"}, not a bare value`;
   }
   const tests = Object.entries(condition);
   if (tests.length === 0) {
-    return `${path49}.${field} names no test \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")}`;
+    return `${path48}.${field} names no test \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")}`;
   }
   if (tests.length > 1) {
-    return `${path49}.${field} names ${tests.length} operators at once (${tests.map(([operator]) => operator).join(", ")}) \u2014 test a field once per condition and combine them with {"and":[\u2026]}`;
+    return `${path48}.${field} names ${tests.length} operators at once (${tests.map(([operator]) => operator).join(", ")}) \u2014 test a field once per condition and combine them with {"and":[\u2026]}`;
   }
   for (const [operator] of tests) {
     if (!RULE_OPERATORS[operator]) {
-      return `${path49}.${field} uses "${operator}", which is not a Meta rule operator \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")} (URL matching is i_contains, not contains or includes)`;
+      return `${path48}.${field} uses "${operator}", which is not a Meta rule operator \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")} (URL matching is i_contains, not contains or includes)`;
     }
   }
   return void 0;
@@ -25390,11 +25475,11 @@ var updateStatusSchema = z37.enum(UPDATE_STATUSES);
 function currencyMinimums2(currencyCode) {
   return CURRENCY_MINIMUMS2[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM2;
 }
-function validateDailyBudgetFloor(money, ctx, path49) {
+function validateDailyBudgetFloor(money, ctx, path48) {
   if (money?.currencyCode) {
     const min = currencyMinimums2(money.currencyCode).dailyBudgetMin;
     if (Number(money.amount) < min) {
-      ctx.addIssue({ code: "custom", path: path49, message: `below the ${min} ${money.currencyCode} daily minimum` });
+      ctx.addIssue({ code: "custom", path: path48, message: `below the ${min} ${money.currencyCode} daily minimum` });
     }
   }
 }
@@ -26266,19 +26351,19 @@ function refuseDeleteByUpdate(payload, group) {
     );
   }
 }
-function loadJsonFileArg3(path49) {
-  if (typeof path49 !== "string" || path49.length === 0) {
+function loadJsonFileArg3(path48) {
+  if (typeof path48 !== "string" || path48.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync9(path49, "utf8"));
+    const parsed = JSON.parse(readFileSync9(path48, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation3(`${path49} must contain a JSON object`);
+      failWriteValidation3(`${path48} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation3(`${path49} is not valid JSON: ${err.message}`);
+      failWriteValidation3(`${path48} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -26369,7 +26454,7 @@ async function stageOp2(raw) {
     const chatId = requireChatId();
     const response = await apiPost("/api/ads/meta/draft/stage", { chatId, op: preflight.data });
     const copyHints = adCopyHints(preflight.data);
-    writeJsonEnvelope(copyHints.length > 0 ? { ...response, hints: copyHints } : response);
+    writeJsonEnvelope(withHints(response, copyHints));
   } catch (err) {
     handleMetaError(err);
   }
@@ -27642,7 +27727,7 @@ async function listDraft2(json, chat) {
       writeJsonEnvelope(response);
       return;
     }
-    process.stdout.write(`${renderDraftStatus3(response.data)}
+    process.stdout.write(`${renderDraftStatus3(response.data)}${hintLines(response)}
 `);
   } catch (err) {
     handleMetaError(err);
@@ -31974,12 +32059,12 @@ function flowExists(slug) {
   return existsSync3(join2(flowsDir(), slug, "_data.json"));
 }
 function readFlowTree(slug) {
-  const path49 = join2(flowsDir(), slug, "_data.json");
-  if (!existsSync3(path49)) {
+  const path48 = join2(flowsDir(), slug, "_data.json");
+  if (!existsSync3(path48)) {
     failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
   }
   try {
-    return JSON.parse(readFileSync11(path49, "utf-8"));
+    return JSON.parse(readFileSync11(path48, "utf-8"));
   } catch (error) {
     failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -32939,12 +33024,12 @@ function readPeopleFile(args5) {
 }
 function unreadablePeopleFile(args5) {
   if (!args5["people-file"]) return void 0;
-  const path49 = String(args5["people-file"]);
+  const path48 = String(args5["people-file"]);
   try {
-    readFileSync12(path49, "utf8");
+    readFileSync12(path48, "utf8");
     return void 0;
   } catch {
-    return `Couldn't read --people-file ${path49}. Check the path, or pass the people inline with --person.`;
+    return `Couldn't read --people-file ${path48}. Check the path, or pass the people inline with --person.`;
   }
 }
 function peopleLimitError(args5) {
@@ -33916,11 +34001,11 @@ function parseFieldArgs(argv) {
   for (const pair of parseRepeated(argv, "--field")) {
     const eq = pair.indexOf("=");
     const field = eq === -1 ? pair : pair.slice(0, eq);
-    const path49 = eq === -1 ? "" : pair.slice(eq + 1).trim();
+    const path48 = eq === -1 ? "" : pair.slice(eq + 1).trim();
     const problem = mappingRowProblem(field);
     if (problem !== null) throw new ConversionArgsError(problem);
-    if (path49 === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
-    mapping[field] = path49;
+    if (path48 === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
+    mapping[field] = path48;
   }
   return mapping;
 }
@@ -35522,11 +35607,11 @@ function unwrap(response) {
   }
   return response.data;
 }
-async function readAvatars(path49, params) {
-  return unwrap(await apiGet(path49, params));
+async function readAvatars(path48, params) {
+  return unwrap(await apiGet(path48, params));
 }
-async function writeAvatars(path49, body) {
-  return unwrap(await apiPost(path49, body));
+async function writeAvatars(path48, body) {
+  return unwrap(await apiPost(path48, body));
 }
 
 // src/commands/avatars/create.ts
@@ -36435,12 +36520,12 @@ function missingFontFiles(urls, available) {
 function planFontAdoption(sources, families) {
   const wanted = new Map(families.map((family) => [normalizeFamily(family), family]));
   const byFamily = /* @__PURE__ */ new Map();
-  for (const { path: path49, source } of sources) {
-    const dir = posix.dirname(path49);
+  for (const { path: path48, source } of sources) {
+    const dir = posix.dirname(path48);
     for (const face of declaredFontFaces(source)) {
       if (!wanted.has(face.family)) continue;
       const perFile = byFamily.get(face.family) ?? /* @__PURE__ */ new Map();
-      perFile.set(path49, [...perFile.get(path49) ?? [], rebaseFontFaceSrc(face.block, dir)]);
+      perFile.set(path48, [...perFile.get(path48) ?? [], rebaseFontFaceSrc(face.block, dir)]);
       byFamily.set(face.family, perFile);
     }
   }
@@ -49266,10 +49351,10 @@ function parseValueExpression(raw) {
   return parts.map(parsePart);
 }
 function trackingFieldIds() {
-  const path49 = join4(flowsDir(), "..", "tracking.ts");
-  if (!existsSync6(path49)) return null;
+  const path48 = join4(flowsDir(), "..", "tracking.ts");
+  if (!existsSync6(path48)) return null;
   try {
-    const source = readFileSync15(path49, "utf-8");
+    const source = readFileSync15(path48, "utf-8");
     const block2 = source.match(/TRACKING_FIELD_IDS\s*=\s*\[([\s\S]*?)\]\s*as const/)?.[1];
     if (!block2) return null;
     const ids = [...block2.matchAll(/"(tracking\.[a-z0-9_]+)"/g)].map((match) => match[1]);
@@ -49843,13 +49928,13 @@ function specsFromFile(parsed) {
     return `${destField}${type}=${entry?.value ?? ""}`;
   });
 }
-function readSpecFile(path49) {
+function readSpecFile(path48) {
   let raw;
   try {
-    raw = path49 === "-" ? readFileSync16(0, "utf-8") : readFileSync16(path49, "utf-8");
+    raw = path48 === "-" ? readFileSync16(0, "utf-8") : readFileSync16(path48, "utf-8");
   } catch (error) {
     refuse(
-      `Could not read ${path49 === "-" ? "the mapping from stdin" : `"${path49}"`}: ${error instanceof Error ? error.message : String(error)}`
+      `Could not read ${path48 === "-" ? "the mapping from stdin" : `"${path48}"`}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   let parsed;
@@ -49857,7 +49942,7 @@ function readSpecFile(path49) {
     parsed = JSON.parse(raw);
   } catch (error) {
     refuse(
-      `${path49 === "-" ? "stdin" : `"${path49}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+      `${path48 === "-" ? "stdin" : `"${path48}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
       'Expected { "map": { "<destField>": "<value>", \u2026 } }'
     );
   }
@@ -50156,21 +50241,21 @@ var ARRAY_FIELDS = [
   "tagIds"
 ];
 var ARRAY_OWNERS = ["", "body"];
-function dropUnsetOptionals(sideEffect, path49) {
+function dropUnsetOptionals(sideEffect, path48) {
   return OPTIONAL_STRINGS.flatMap((key) => {
     if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
     delete sideEffect[key];
-    return [{ path: path49, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+    return [{ path: path48, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
   });
 }
-function fillNulledArrays(target2, prefix, path49) {
+function fillNulledArrays(target2, prefix, path48) {
   return ARRAY_FIELDS.flatMap((key) => {
     if (!(key in target2) || target2[key] !== null) return [];
     target2[key] = [];
-    return [{ path: path49, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+    return [{ path: path48, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
   });
 }
-function tidyEmailRecipients(sideEffect, path49) {
+function tidyEmailRecipients(sideEffect, path48) {
   if (sideEffect.type !== "email") return [];
   const config = sideEffect.encryptedConfig;
   if (!config || typeof config !== "object" || Array.isArray(config)) return [];
@@ -50181,7 +50266,7 @@ function tidyEmailRecipients(sideEffect, path49) {
   const tidied = to.join(", ");
   if (tidied === raw) return [];
   config.email = tidied;
-  return [{ path: path49, change: "tidied the recipient list's spacing and separators" }];
+  return [{ path: path48, change: "tidied the recipient list's spacing and separators" }];
 }
 function sideEffectsOf(node) {
   if (!Array.isArray(node.sideEffects)) return [];
@@ -50190,13 +50275,13 @@ function sideEffectsOf(node) {
   );
 }
 function normalizeSideEffect(sideEffect, where) {
-  const path49 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const path48 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
   const arrays = ARRAY_OWNERS.flatMap((owner) => {
     const target2 = owner ? sideEffect[owner] : sideEffect;
     if (!target2 || typeof target2 !== "object") return [];
-    return fillNulledArrays(target2, owner ? `${owner}.` : "", path49);
+    return fillNulledArrays(target2, owner ? `${owner}.` : "", path48);
   });
-  return [...dropUnsetOptionals(sideEffect, path49), ...arrays, ...tidyEmailRecipients(sideEffect, path49)];
+  return [...dropUnsetOptionals(sideEffect, path48), ...arrays, ...tidyEmailRecipients(sideEffect, path48)];
 }
 function normalizeFlowTree(tree) {
   const changes = [];
@@ -51558,11 +51643,11 @@ var WARNING_HINT = "Read the warnings above before telling the user this is read
 async function stageOp3(op) {
   const chatId = requireChatId();
   try {
-    const data = await apiPost("/api/ga4/draft/stage", { chatId, op });
+    const { data, hints: hints2 } = splitHints(await apiPost("/api/ga4/draft/stage", { chatId, op }));
     writeJsonEnvelope({
       ok: true,
       data,
-      hints: [...STAGE_HINTS, ...data.warnings.length > 0 ? [WARNING_HINT] : []]
+      hints: [...hints2, ...STAGE_HINTS, ...data.warnings.length > 0 ? [WARNING_HINT] : []]
     });
   } catch (err) {
     handleError5(err);
@@ -51576,21 +51661,23 @@ async function stageOps(ops) {
   }
   const chatId = requireChatId();
   try {
-    const data = await apiPost("/api/ga4/draft/stage-batch", { chatId, ops });
+    const { data, hints: hints2 } = splitHints(
+      await apiPost("/api/ga4/draft/stage-batch", { chatId, ops })
+    );
     writeJsonEnvelope({
       ok: true,
       data,
-      hints: [...STAGE_HINTS, ...data.ops.some((op) => op.warnings.length > 0) ? [WARNING_HINT] : []]
+      hints: [...hints2, ...STAGE_HINTS, ...data.ops.some((op) => op.warnings.length > 0) ? [WARNING_HINT] : []]
     });
   } catch (err) {
     handleError5(err);
   }
 }
-async function draftAction2(path49, body, chat) {
+async function draftAction2(path48, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path49, { chatId, ...body });
-    writeJsonEnvelope({ ok: true, data });
+    const { data, hints: hints2 } = splitHints(await apiPost(path48, { chatId, ...body }));
+    writeJsonEnvelope({ ok: true, data, ...hints2.length > 0 ? { hints: hints2 } : {} });
     return data;
   } catch (err) {
     handleError5(err);
@@ -51622,12 +51709,13 @@ function renderDraft(response) {
 async function draftList(json, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost("/api/ga4/draft", { chatId });
+    const response = await apiPost("/api/ga4/draft", { chatId });
+    const { data, hints: hints2 } = splitHints(response);
     if (json) {
-      writeJsonEnvelope({ ok: true, data });
+      writeJsonEnvelope({ ok: true, data, ...hints2.length > 0 ? { hints: hints2 } : {} });
       return;
     }
-    process.stdout.write(`${renderDraft(data)}
+    process.stdout.write(`${renderDraft(data)}${hintLines(response)}
 `);
   } catch (err) {
     handleError5(err);
@@ -54118,9 +54206,9 @@ async function readImageBuffer(pathOrUrl) {
   }
   return readFile28(pathOrUrl);
 }
-async function isDirectory(path49) {
+async function isDirectory(path48) {
   try {
-    const s = await stat7(path49);
+    const s = await stat7(path48);
     return s.isDirectory();
   } catch {
     return false;
@@ -54548,13 +54636,13 @@ function resolveDownloadPath({ baseName, extension, out, outIsDirectory: outIsDi
 }
 function disambiguate(paths) {
   const taken = /* @__PURE__ */ new Set();
-  return paths.map((path49) => {
-    if (!taken.has(path49)) {
-      taken.add(path49);
-      return path49;
+  return paths.map((path48) => {
+    if (!taken.has(path48)) {
+      taken.add(path48);
+      return path48;
     }
-    const ext = extname3(path49);
-    const stem = path49.slice(0, path49.length - ext.length);
+    const ext = extname3(path48);
+    const stem = path48.slice(0, path48.length - ext.length);
     let n = 2;
     while (taken.has(`${stem}-${n}${ext}`)) n += 1;
     const unique = `${stem}-${n}${ext}`;
@@ -54680,10 +54768,10 @@ async function runDownloads(plan) {
   const paths = disambiguate(fetched.map((item) => item.path));
   const downloaded = [];
   for (const [index, item] of fetched.entries()) {
-    const path49 = paths[index] ?? item.path;
+    const path48 = paths[index] ?? item.path;
     try {
-      await atomicWrite(path49, item.buffer);
-      downloaded.push({ input: item.input, output: path49, bytes: item.buffer.length, contentType: item.contentType });
+      await atomicWrite(path48, item.buffer);
+      downloaded.push({ input: item.input, output: path48, bytes: item.buffer.length, contentType: item.contentType });
     } catch (err) {
       failed.push({ input: item.input, error: failureMessage(err, "Write failed") });
     }
@@ -62870,374 +62958,11 @@ Full guide: __tooling__/docs/tools/baker/mcp.md`
   }
 });
 
-// src/commands/media-sources/index.ts
-import { defineCommand as defineCommand189 } from "citty";
-
-// ../api/src/media-sources.ts
-import { z as z51 } from "zod";
-var mediaSourcePlatformSchema = z51.enum([
-  "instagram",
-  "tiktok",
-  "youtube",
-  "linkedin",
-  "facebook",
-  "google_drive"
-]);
-var mediaSourceRefreshIntervalSchema = z51.enum(["never", "daily", "weekly", "monthly"]);
-var mediaSourceSyncStatusSchema = z51.enum(["idle", "fetching", "processing", "error"]);
-var mediaSourceHalfSchema = z51.object({
-  sourceId: z51.string(),
-  syncStatus: mediaSourceSyncStatusSchema,
-  storedCount: z51.number().optional(),
-  pendingItems: z51.number().optional(),
-  failedItems: z51.number().optional(),
-  lastSyncedAt: z51.number().optional(),
-  errorMessage: z51.string().optional()
-});
-var mediaSourceSummarySchema = z51.object({
-  key: z51.string(),
-  platform: mediaSourcePlatformSchema,
-  platformLabel: z51.string(),
-  handle: z51.string(),
-  label: z51.string(),
-  profileUrl: z51.string(),
-  profileImageUrl: z51.string().optional(),
-  refreshInterval: mediaSourceRefreshIntervalSchema,
-  /** Absent for a platform that feeds no images (YouTube). */
-  images: mediaSourceHalfSchema.optional(),
-  videos: mediaSourceHalfSchema.optional(),
-  createdAt: z51.number()
-});
-var mediaSourceProfileSchema = z51.object({
-  platform: mediaSourcePlatformSchema,
-  handle: z51.string(),
-  displayName: z51.string(),
-  avatarUrl: z51.string(),
-  bio: z51.string(),
-  followers: z51.number().optional(),
-  postCount: z51.number().optional(),
-  isPrivate: z51.boolean(),
-  profileUrl: z51.string(),
-  channelId: z51.string().optional(),
-  /** Google Drive: the account that shared the folder with Baker. Absent for a link-shared folder. */
-  sharedBy: z51.string().optional()
-});
-var mediaSourcesAddRequestSchema = z51.object({
-  /** A profile URL or a Drive folder link, or an @handle together with `platform`. */
-  input: z51.string().trim().min(1, "Pass the account's profile URL or @handle"),
-  /** Needed only when `input` is a bare handle; a URL names its own platform. */
-  platform: mediaSourcePlatformSchema.optional(),
-  /** Auto-sync cadence. Omitted = weekly, except a Drive folder, which checks daily. */
-  every: mediaSourceRefreshIntervalSchema.optional()
-});
-var mediaSourceKeySchema = z51.string().trim().regex(/^(instagram|tiktok|youtube|linkedin|facebook|google_drive):.+$/, "Pass a source key like tiktok:nike");
-var mediaSourcesSyncRequestSchema = z51.object({ key: mediaSourceKeySchema });
-var mediaSourcesRemoveRequestSchema = z51.object({ key: mediaSourceKeySchema });
-var mediaSourcesScheduleRequestSchema = z51.object({
-  key: mediaSourceKeySchema,
-  every: mediaSourceRefreshIntervalSchema
-});
-
-// src/commands/media-sources/add.ts
-import { defineCommand as defineCommand184 } from "citty";
-
-// src/commands/media-sources/shared.ts
-function driveRefusalFix(input, code) {
-  const isDrive = /drive\.google\.com/i.test(input);
-  if (!isDrive || code !== "NOT_FOUND" && code !== "FORBIDDEN") return void 0;
-  return "Only the user can give Baker a folder, so tell them how, then carry on with the rest of the task. The quickest way: in Baker, open Images (or Videos) \u2192 Add source \u2192 Google Drive \u2192 Choose a folder, which connects their Google Drive and shares the folder in one step \u2014 once they do, it is connected and there is nothing to run. For a folder someone else owns, relay the message as written; once they say it's shared, run the same command again.";
-}
-function reportError2(err, input) {
-  if (err instanceof ApiError) {
-    const fix = input ? driveRefusalFix(input, err.code) : void 0;
-    writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-function halfState(half) {
-  if (!half) return null;
-  return {
-    status: half.syncStatus === "fetching" || half.syncStatus === "processing" ? "importing" : half.syncStatus,
-    stored: half.storedCount ?? 0,
-    ...half.pendingItems ? { pending: half.pendingItems } : {},
-    ...half.failedItems ? { failed: half.failedItems } : {},
-    ...half.lastSyncedAt ? { lastSyncedAt: new Date(half.lastSyncedAt).toISOString() } : {},
-    ...half.errorMessage ? { error: half.errorMessage } : {}
-  };
-}
-function compactSource(source) {
-  return {
-    key: source.key,
-    platform: source.platform,
-    label: source.label,
-    url: source.profileUrl,
-    autoSync: source.refreshInterval,
-    images: halfState(source.images),
-    videos: halfState(source.videos)
-  };
-}
-function isImporting(source) {
-  return [source.images, source.videos].some(
-    (half) => half?.syncStatus === "fetching" || half?.syncStatus === "processing"
-  );
-}
-
-// src/commands/media-sources/add.ts
-registerSchema({
-  command: "media-sources.add",
-  description: "Connect a public social account or a shared Google Drive folder as a source for the image and video libraries \u2014 Instagram, TikTok, YouTube (videos only), LinkedIn company pages, Facebook pages, Google Drive folders. A social account's recent posts (up to a year back) are imported; a Drive folder's images and videos, subfolders included, are imported and new files keep arriving automatically. Everything is described and made searchable in the background. Applies immediately and shows on the chat as an already-applied change. Adding a source that is already connected is a no-op.",
-  args: {
-    input: {
-      type: "string",
-      description: "Profile URL or Drive folder link (names its own platform), or @handle together with --platform",
-      required: true
-    },
-    platform: {
-      type: "string",
-      description: `Needed only for a bare handle: ${mediaSourcePlatformSchema.options.join("|")}`,
-      required: false
-    },
-    every: {
-      type: "string",
-      description: `Auto-sync cadence: ${mediaSourceRefreshIntervalSchema.options.join("|")} (default weekly; a Drive folder defaults to daily and also syncs on every change)`,
-      required: false
-    }
-  }
-});
-var addCommand3 = defineCommand184({
-  meta: {
-    name: "add",
-    description: "Connect a social account (Instagram, TikTok, YouTube, LinkedIn page, Facebook page) or a Google Drive folder as a media source. Start here with the profile URL or the folder link. A Drive folder must first be shared with Baker by someone on the team \u2014 if it isn't, the error says with which address.\n\nExamples:\n  baker media-sources add https://www.tiktok.com/@acme\n  baker media-sources add @acme --platform instagram --every daily\n  baker media-sources add https://drive.google.com/drive/folders/1AbC\u2026"
-  },
-  args: {
-    input: { type: "positional", description: "Profile URL, Drive folder link, or @handle", required: true },
-    platform: {
-      type: "string",
-      description: "instagram|tiktok|youtube|linkedin|facebook|google_drive \u2014 only for a bare handle or folder id",
-      required: false
-    },
-    every: { type: "string", description: "Auto-sync: never|daily|weekly|monthly", required: false }
-  },
-  run: async ({ args: args5 }) => {
-    const parsed = mediaSourcesAddRequestSchema.safeParse({
-      input: String(args5.input ?? ""),
-      platform: args5.platform ? String(args5.platform).toLowerCase() : void 0,
-      every: args5.every ? String(args5.every).toLowerCase() : void 0
-    });
-    if (!parsed.success) {
-      const issue = parsed.error.issues[0];
-      writeJson({
-        ok: false,
-        error: {
-          code: "VALIDATION_ERROR",
-          message: issue ? `${issue.path.join(".") || "input"}: ${issue.message}` : "Invalid request"
-        }
-      });
-      process.exit(1);
-    }
-    try {
-      const data = await apiPost("/api/media-sources/add", parsed.data, {
-        timeoutMs: 12e4
-      });
-      const hints2 = [
-        data.created ? `Connected ${data.source.label} on ${data.source.platformLabel}. Its posts are importing in the background \u2014 they become searchable with \`baker images search\` / \`baker videos search\` as each one is analysed. Check progress with \`baker media-sources list\`.` : `${data.source.label} on ${data.source.platformLabel} was already connected; a fresh import was started if one wasn't running.`
-      ];
-      if (data.source.platform === "youtube") {
-        hints2.push(
-          "YouTube feeds the video library only, newest first, a batch per sync; videos over 20 minutes are skipped."
-        );
-      }
-      if (data.source.platform === "google_drive") {
-        hints2.push(
-          "New files added to the folder (or its subfolders) are imported on their own within minutes; large originals are resized for the library, and the files in Drive stay untouched. A big folder imports in batches over the next hours."
-        );
-      }
-      if (data.source.refreshInterval === "never") {
-        hints2.push(
-          `Auto-sync is off. If the user wants new posts to keep arriving: \`baker media-sources schedule ${data.source.key} --every weekly\`.`
-        );
-      }
-      writeJson({
-        ok: true,
-        data: { created: data.created, source: compactSource(data.source), name: data.profile.displayName },
-        hints: hints2
-      });
-    } catch (err) {
-      reportError2(err, parsed.data.input);
-    }
-  }
-});
-
-// src/commands/media-sources/list.ts
-import { defineCommand as defineCommand185 } from "citty";
-registerSchema({
-  command: "media-sources.list",
-  description: "List the social accounts connected as image/video sources, with each one's key, import status and how many images and videos it has brought in.",
-  args: {}
-});
-var listCommand17 = defineCommand185({
-  meta: {
-    name: "list",
-    description: "List connected media sources (key, platform, import status, stored images/videos).\n\nExample: baker media-sources list"
-  },
-  args: {},
-  run: async () => {
-    try {
-      const { sources } = await apiGet("/api/media-sources/list");
-      const hints2 = [];
-      if (sources.length === 0) {
-        hints2.push(
-          "No sources connected. Connect the brand's own accounts with `baker media-sources add <profile URL>` to fill the image and video libraries."
-        );
-      } else if (sources.some(isImporting)) {
-        hints2.push("Some sources are still importing \u2014 their counts will grow over the next minutes.");
-      }
-      writeJson({ ok: true, data: sources.map(compactSource), hints: hints2.length > 0 ? hints2 : void 0 });
-    } catch (err) {
-      reportError2(err);
-    }
-  }
-});
-
-// src/commands/media-sources/remove.ts
-import { defineCommand as defineCommand186 } from "citty";
-registerSchema({
-  command: "media-sources.remove",
-  description: "Disconnect a media source. Stops future imports; images and videos it already brought in stay in the library. Applies immediately.",
-  args: { key: { type: "string", description: "Source key, e.g. tiktok:acme", required: true } }
-});
-var removeCommand6 = defineCommand186({
-  meta: {
-    name: "remove",
-    description: "Disconnect a media source (already-imported media stays).\n\nExample: baker media-sources remove tiktok:acme"
-  },
-  args: { key: { type: "positional", description: "Source key, e.g. tiktok:acme", required: true } },
-  run: async ({ args: args5 }) => {
-    const parsed = mediaSourcesRemoveRequestSchema.safeParse({ key: String(args5.key ?? "") });
-    if (!parsed.success) {
-      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
-      process.exit(1);
-    }
-    try {
-      const data = await apiPost("/api/media-sources/remove", parsed.data);
-      writeJson({ ok: true, data });
-    } catch (err) {
-      reportError2(err);
-    }
-  }
-});
-
-// src/commands/media-sources/schedule.ts
-import { defineCommand as defineCommand187 } from "citty";
-registerSchema({
-  command: "media-sources.schedule",
-  description: "Set how often a connected source imports new posts on its own.",
-  args: {
-    key: { type: "string", description: "Source key, e.g. tiktok:acme", required: true },
-    every: {
-      type: "string",
-      description: `Cadence: ${mediaSourceRefreshIntervalSchema.options.join("|")} (never = only on demand)`,
-      required: true
-    }
-  }
-});
-var scheduleCommand = defineCommand187({
-  meta: {
-    name: "schedule",
-    description: "Set a source's auto-sync cadence.\n\nExample: baker media-sources schedule tiktok:acme --every weekly"
-  },
-  args: {
-    key: { type: "positional", description: "Source key, e.g. tiktok:acme", required: true },
-    every: { type: "string", description: "never|daily|weekly|monthly", required: true }
-  },
-  run: async ({ args: args5 }) => {
-    const parsed = mediaSourcesScheduleRequestSchema.safeParse({
-      key: String(args5.key ?? ""),
-      every: String(args5.every ?? "").toLowerCase()
-    });
-    if (!parsed.success) {
-      const issue = parsed.error.issues[0];
-      writeJson({
-        ok: false,
-        error: { code: "VALIDATION_ERROR", message: issue ? `${issue.path.join(".")}: ${issue.message}` : "" }
-      });
-      process.exit(1);
-    }
-    try {
-      const data = await apiPost("/api/media-sources/schedule", parsed.data);
-      writeJson({ ok: true, data: { ...data, autoSync: parsed.data.every } });
-    } catch (err) {
-      reportError2(err);
-    }
-  }
-});
-
-// src/commands/media-sources/sync.ts
-import { defineCommand as defineCommand188 } from "citty";
-registerSchema({
-  command: "media-sources.sync",
-  description: "Import a connected source's new posts now. Runs in the background; only posts not yet in the library are fetched.",
-  args: {
-    key: { type: "string", description: "Source key from `media-sources list`, e.g. tiktok:acme", required: true }
-  }
-});
-var syncCommand = defineCommand188({
-  meta: {
-    name: "sync",
-    description: "Import a source's new posts now.\n\nExample: baker media-sources sync tiktok:acme"
-  },
-  args: { key: { type: "positional", description: "Source key, e.g. tiktok:acme", required: true } },
-  run: async ({ args: args5 }) => {
-    const parsed = mediaSourcesSyncRequestSchema.safeParse({ key: String(args5.key ?? "") });
-    if (!parsed.success) {
-      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "" } });
-      process.exit(1);
-    }
-    try {
-      const data = await apiPost("/api/media-sources/sync", parsed.data);
-      writeJson({
-        ok: true,
-        data,
-        hints: data.started ? void 0 : ["An import was already running for this source; nothing new was started."]
-      });
-    } catch (err) {
-      reportError2(err);
-    }
-  }
-});
-
-// src/commands/media-sources/index.ts
-var mediaSourcesCommand = defineCommand189({
-  meta: {
-    name: "media-sources",
-    description: `Connect social accounts and shared Google Drive folders whose images and videos fill the libraries: Instagram, TikTok, YouTube (videos), LinkedIn company pages, Facebook pages, Google Drive folders. Subcommands: add, list, sync, schedule, remove.
-
-Examples:
-  baker media-sources add https://www.tiktok.com/@acme
-  baker media-sources add @acme --platform instagram --every daily
-  baker media-sources add https://drive.google.com/drive/folders/1AbC\u2026
-  baker media-sources list
-  baker media-sources sync youtube:acme
-  baker media-sources schedule linkedin:acme --every monthly
-  baker media-sources remove facebook:acme
-Full guide: __tooling__/docs/tools/baker/media-sources.md`
-  },
-  subCommands: {
-    add: addCommand3,
-    list: listCommand17,
-    sync: syncCommand,
-    schedule: scheduleCommand,
-    remove: removeCommand6
-  }
-});
-
 // src/commands/research/index.ts
-import { defineCommand as defineCommand202 } from "citty";
+import { defineCommand as defineCommand196 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand190 } from "citty";
+import { defineCommand as defineCommand184 } from "citty";
 
 // src/commands/research/hints.ts
 var AD_COPY_ROUTE = 'This returns competing domains and their SERP economics \u2014 no ad copy, no headlines, no creative. For the actual copy of a competitor\'s ads: `baker winning-ads advertisers "<brand>"` \u2192 `baker winning-ads search "<brief>" --advertiser-id <id>` \u2192 `baker winning-ads content <adId>` (`primary_text` / `headline` / `cta`, plus the spoken transcript and on-screen text for video). That corpus is Meta and LinkedIn only \u2014 Google SERP ad copy is not available through any Baker command, so do not keep querying for it here.';
@@ -63439,7 +63164,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand190({
+var advertisersCommand = defineCommand184({
   meta: {
     name: "advertisers",
     description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy \u2014 for a competitor's headlines and body copy use \`baker winning-ads content <adId>\` (Meta/LinkedIn only).
@@ -63495,7 +63220,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand191 } from "citty";
+import { defineCommand as defineCommand185 } from "citty";
 registerSchema({
   command: "research.autocomplete",
   description: "Get Google Autocomplete suggestions for a seed keyword. Useful for keyword expansion and discovering what people actually search for. If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -63518,7 +63243,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand191({
+var autocompleteCommand = defineCommand185({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -63573,7 +63298,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand192 } from "citty";
+import { defineCommand as defineCommand186 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -63630,7 +63355,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand192({
+var countriesCommand = defineCommand186({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -63641,7 +63366,7 @@ var countriesCommand = defineCommand192({
 });
 
 // src/commands/research/fetch.ts
-import { defineCommand as defineCommand193 } from "citty";
+import { defineCommand as defineCommand187 } from "citty";
 var CONTENT_PREVIEW_CHARS = 2e4;
 var TIMEOUT_MS = 18e4;
 registerSchema({
@@ -63714,7 +63439,7 @@ function fetchFix(code) {
     explanation: "This read failed. Don't build a retry ladder around it \u2014 finish the rest of the job with what you can reach and name this page as a gap."
   };
 }
-var fetchCommand = defineCommand193({
+var fetchCommand = defineCommand187({
   meta: {
     name: "fetch",
     description: `Read a page an ordinary web fetch could not. Bot walls and JavaScript-rendered pages are resolved for you \u2014 you never have to retry, wait, or drive a browser yourself.
@@ -63791,7 +63516,7 @@ Examples:
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand194 } from "citty";
+import { defineCommand as defineCommand188 } from "citty";
 registerSchema({
   command: "research.intent",
   description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
@@ -63814,7 +63539,7 @@ var FIELDS7 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand194({
+var intentCommand = defineCommand188({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -63862,7 +63587,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand195 } from "citty";
+import { defineCommand as defineCommand189 } from "citty";
 registerSchema({
   command: "research.keyword-gap",
   description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
@@ -63891,7 +63616,7 @@ var FIELDS8 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand195({
+var keywordGapCommand = defineCommand189({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -63966,7 +63691,7 @@ Examples:
 });
 
 // src/commands/research/keyword-metrics.ts
-import { defineCommand as defineCommand196 } from "citty";
+import { defineCommand as defineCommand190 } from "citty";
 
 // src/commands/research/keyword-metrics-rows.ts
 var KEYWORD_METRICS_SOURCE = "keyword_planner_estimate_via_dataforseo";
@@ -64046,7 +63771,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
   }
 });
-var keywordMetricsCommand = defineCommand196({
+var keywordMetricsCommand = defineCommand190({
   meta: {
     name: "keyword-metrics",
     description: `Volume, CPC and competition for keywords you name. No domain required.
@@ -64128,7 +63853,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand197 } from "citty";
+import { defineCommand as defineCommand191 } from "citty";
 registerSchema({
   command: "research.keywords-for-site",
   description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
@@ -64161,7 +63886,7 @@ var FIELDS9 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand197({
+var keywordsForSiteCommand = defineCommand191({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -64223,7 +63948,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand198 } from "citty";
+import { defineCommand as defineCommand192 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -64253,7 +63978,7 @@ var FIELDS10 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand198({
+var languagesCommand2 = defineCommand192({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -64264,7 +63989,7 @@ var languagesCommand2 = defineCommand198({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand199 } from "citty";
+import { defineCommand as defineCommand193 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -64283,7 +64008,7 @@ var FIELDS11 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand199({
+var lighthouseCommand = defineCommand193({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -64321,7 +64046,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand200 } from "citty";
+import { defineCommand as defineCommand194 } from "citty";
 registerSchema({
   command: "research.relevant-pages",
   description: "Get the top pages of a competitor domain with organic traffic and ranking data. Shows which pages drive the most traffic. If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -64347,7 +64072,7 @@ var FIELDS12 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand200({
+var relevantPagesCommand = defineCommand194({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -64394,7 +64119,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand201 } from "citty";
+import { defineCommand as defineCommand195 } from "citty";
 registerSchema({
   command: "research.web",
   description: "Search the web with AI to answer marketing questions \u2014 competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).",
@@ -64445,7 +64170,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand201({
+var webCommand = defineCommand195({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -64507,7 +64232,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand202({
+var researchCommand = defineCommand196({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -64554,10 +64279,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-agents/index.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand207 } from "citty";
 
 // src/commands/scheduled-agents/create.ts
-import { defineCommand as defineCommand203 } from "citty";
+import { defineCommand as defineCommand197 } from "citty";
 
 // src/commands/scheduled-agents/shared.ts
 var TEMP_SCHEDULED_AGENT_PREFIX = "temp_agent_";
@@ -64924,7 +64649,7 @@ registerSchema({
     }
   }
 });
-var createCommand3 = defineCommand203({
+var createCommand3 = defineCommand197({
   meta: {
     name: "create",
     description: 'Stage a scheduled agent. Examples: baker scheduled-agents create --name "Weekly report" --description "..." --prompt "..." --cron "0 9 * * MON" | baker scheduled-agents create --name "Chase a new lead" --description "..." --prompt "Research {{payload.answers.company}} and draft a reply" --trigger form.submitted --form quote | baker scheduled-agents create --name "Big deals" --description "..." --prompt "..." --trigger webhook.received --when "deal.stage = won AND deal.amount > 10000" --times 3'
@@ -64981,7 +64706,7 @@ var createCommand3 = defineCommand203({
 });
 
 // src/commands/scheduled-agents/delete.ts
-import { defineCommand as defineCommand204 } from "citty";
+import { defineCommand as defineCommand198 } from "citty";
 registerSchema({
   command: "scheduled-agents.delete",
   description: "Stage deletion of a published scheduled agent, or cancel one this chat staged (temp_agent_*).",
@@ -64989,7 +64714,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true }
   }
 });
-var deleteCommand3 = defineCommand204({
+var deleteCommand3 = defineCommand198({
   meta: {
     name: "delete",
     description: "Stage a scheduled agent deletion. Example: baker scheduled-agents delete <id-or-temp_agent_id>"
@@ -65018,7 +64743,7 @@ var deleteCommand3 = defineCommand204({
 });
 
 // src/commands/scheduled-agents/get.ts
-import { defineCommand as defineCommand205 } from "citty";
+import { defineCommand as defineCommand199 } from "citty";
 registerSchema({
   command: "scheduled-agents.get",
   description: "Get a published scheduled agent, or one this chat has staged (temp_agent_*). A published one comes with runsAs: who each run acts as ({ name, personalTools, companyTools, notSignedIn?, toolsOff? }) \u2014 the tools a run loads, which decides whether a job like reading someone's inbox can work. Its recentRuns and any draftOps this chat staged on it come with it.",
@@ -65027,7 +64752,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var getCommand4 = defineCommand205({
+var getCommand4 = defineCommand199({
   meta: {
     name: "get",
     description: "Get a scheduled agent. Example: baker scheduled-agents get <id-or-temp_agent_id>"
@@ -65066,7 +64791,7 @@ var getCommand4 = defineCommand205({
 });
 
 // src/commands/scheduled-agents/list.ts
-import { defineCommand as defineCommand206 } from "citty";
+import { defineCommand as defineCommand200 } from "citty";
 var FULL_DESCRIPTION = "Return every item and staged change as stored, briefs included (tens of KB). Prefer `get <id>` for one item.";
 registerSchema({
   command: "scheduled-agents.list",
@@ -65076,7 +64801,7 @@ registerSchema({
     full: { type: "boolean", description: FULL_DESCRIPTION, required: false }
   }
 });
-var listCommand18 = defineCommand206({
+var listCommand17 = defineCommand200({
   meta: {
     name: "list",
     description: "List scheduled agents: id, name, trigger and status for each, plus this chat's staged changes when BAKER_CHAT_ID is set (or --chat <id> for an earlier chat's). Briefs are left out. Start here: baker scheduled-agents list; then baker scheduled-agents get <id> for one item's brief."
@@ -65102,7 +64827,7 @@ var listCommand18 = defineCommand206({
 });
 
 // src/commands/scheduled-agents/run.ts
-import { defineCommand as defineCommand207 } from "citty";
+import { defineCommand as defineCommand201 } from "citty";
 registerSchema({
   command: "scheduled-agents.run",
   description: "Run a published scheduled agent now, whatever its trigger says. Opens a Session immediately and returns its chatId. Does not need BAKER_CHAT_ID, and refuses a temp_agent_* id \u2014 a staged item has to be published before it can run.",
@@ -65110,7 +64835,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled agent ID", required: true }
   }
 });
-var runCommand2 = defineCommand207({
+var runCommand2 = defineCommand201({
   meta: {
     name: "run",
     description: "Run a published scheduled agent now. Example: baker scheduled-agents run <id>"
@@ -65142,7 +64867,7 @@ var runCommand2 = defineCommand207({
 });
 
 // src/commands/scheduled-agents/targets.ts
-import { defineCommand as defineCommand208 } from "citty";
+import { defineCommand as defineCommand202 } from "citty";
 var ARGS2 = {
   trigger: {
     type: "string",
@@ -65176,7 +64901,7 @@ registerSchema({
   description: "What a trigger can be pointed at: the open Tasks, the company's scheduled agents, its review sources, followed competitors, pages, Forms and their steps, Knowledge collections, tools. Returns each option's value (pass it to the matching flag on create/update) with its name.",
   args: ARGS2
 });
-var targetsCommand = defineCommand208({
+var targetsCommand = defineCommand202({
   meta: {
     name: "targets",
     description: `What a trigger can be pointed at \u2014 so "when a Task is picked up" becomes "when THIS Task is picked up".
@@ -65219,7 +64944,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 // src/commands/scheduled-agents/templates.ts
 import { readFile as readFile32 } from "fs/promises";
 import path46 from "path";
-import { defineCommand as defineCommand209 } from "citty";
+import { defineCommand as defineCommand203 } from "citty";
 registerSchema({
   command: "scheduled-agents.templates",
   description: "The recipes available to this company: the ones Baker ships plus the ones they wrote themselves, each with its id, what it produces and how often it is meant to run. Read this before proposing a company's automation, so every recipe you name is one that exists. Also how a company gets a recipe of its own \u2014 save a brief, prove it runs, then publish it.",
@@ -65274,7 +64999,7 @@ registerSchema({
     }
   }
 });
-var templatesCommand = defineCommand209({
+var templatesCommand = defineCommand203({
   meta: {
     name: "templates",
     description: `The recipes this company can run \u2014 Baker's own plus theirs, with what each one produces.
@@ -65370,7 +65095,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 });
 
 // src/commands/scheduled-agents/triggers.ts
-import { defineCommand as defineCommand210 } from "citty";
+import { defineCommand as defineCommand204 } from "citty";
 var ARGS3 = {
   trigger: {
     type: "string",
@@ -65456,7 +65181,7 @@ function shapeTriggerCatalog(response, filter) {
   }
   return { ok: true, data: { groups, reacting: catalog.reacting } };
 }
-var triggersCommand2 = defineCommand210({
+var triggersCommand2 = defineCommand204({
   meta: {
     name: "triggers",
     description: `Everything that can start a scheduled agent.
@@ -65486,7 +65211,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 });
 
 // src/commands/scheduled-agents/unstage.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand205 } from "citty";
 registerSchema({
   command: "scheduled-agents.unstage",
   description: "Take back what this chat staged on one scheduled agent, before Publish \u2014 the same as discarding its row in the change list. With --index, only that one change (its `index` in `baker scheduled-agents list` \u2192 draft.ops). Taking back a create also takes back the edits staged on it. Never touches a published item: to change or remove one, stage update/delete instead.",
@@ -65512,7 +65237,7 @@ function unstageBody(args5, chatId) {
   }
   return { chatId, ref: args5.ref, index };
 }
-var unstageCommand = defineCommand211({
+var unstageCommand = defineCommand205({
   meta: {
     name: "unstage",
     description: "Take back what this chat staged on a scheduled agent, before Publish. Examples: baker scheduled-agents unstage temp_agent_abc123 | baker scheduled-agents unstage <id> --index 2"
@@ -65543,7 +65268,7 @@ var unstageCommand = defineCommand211({
 });
 
 // src/commands/scheduled-agents/update.ts
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand206 } from "citty";
 registerSchema({
   command: "scheduled-agents.update",
   description: "Stage an update to a published scheduled agent, or to one this chat staged (temp_agent_*).",
@@ -65570,7 +65295,7 @@ registerSchema({
     enabled: { type: "string", description: "Replacement enabled state", required: false, enum: ["true", "false"] }
   }
 });
-var updateCommand4 = defineCommand212({
+var updateCommand4 = defineCommand206({
   meta: {
     name: "update",
     description: "Stage a scheduled agent update. Examples: baker scheduled-agents update <id> --enabled false | baker scheduled-agents update <id> --trigger form.submitted --form quote"
@@ -65641,7 +65366,7 @@ var updateCommand4 = defineCommand212({
 });
 
 // src/commands/scheduled-agents/index.ts
-var scheduledAgentsCommand = defineCommand213({
+var scheduledAgentsCommand = defineCommand207({
   meta: {
     name: "scheduled-agents",
     description: `Manage Scheduled agents. Subcommands: list, get, triggers, targets, create, update, delete, unstage, run, templates.
@@ -65670,7 +65395,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
   },
   subCommands: {
-    list: listCommand18,
+    list: listCommand17,
     get: getCommand4,
     triggers: triggersCommand2,
     targets: targetsCommand,
@@ -65684,14 +65409,14 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand208 } from "citty";
 function narrowToFamily(commandName, available) {
   const segments = commandName.split(".");
   const prefix = segments[0] === "ads" && segments[1] ? `ads.${segments[1]}.` : `${segments[0]}.`;
   const siblings = available.filter((name) => name.startsWith(prefix));
   return siblings.length > 0 ? siblings : available;
 }
-var schemaCommand2 = defineCommand214({
+var schemaCommand2 = defineCommand208({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images search (or images.search)"
@@ -65736,10 +65461,10 @@ var schemaCommand2 = defineCommand214({
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand217 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand209 } from "citty";
 
 // src/commands/studio/spokenPace.ts
 var WORDS_PER_SECOND3 = SPOKEN_WORDS_PER_SECOND;
@@ -65965,7 +65690,7 @@ function parseImageRefs(spec) {
 }
 var defaultDeps = {
   ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
-  upload: (path49) => uploadLocalImage({ file: path49, contentType: detectImageContentType(path49), source: "uploaded" })
+  upload: (path48) => uploadLocalImage({ file: path48, contentType: detectImageContentType(path48), source: "uploaded" })
 };
 async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   const refs = parseImageRefs(spec);
@@ -65985,10 +65710,10 @@ async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   }
   return { imageIds, added };
 }
-function uploadFailure(path49) {
+function uploadFailure(path48) {
   return (error) => {
     if (error instanceof ApiError) throw error;
-    throw new ApiError("VALIDATION_ERROR", `Could not read "${path49}" as an image.`);
+    throw new ApiError("VALIDATION_ERROR", `Could not read "${path48}" as an image.`);
   };
 }
 
@@ -66252,7 +65977,7 @@ async function adByHandHintFor(body) {
     return null;
   }
 }
-var animateCommand = defineCommand215({
+var animateCommand = defineCommand209({
   meta: {
     name: "animate",
     description: "Render a clip. With an image the look is already fixed, so the prompt describes MOVEMENT \u2014 what the camera does, what the subject does, in what order. With --from text there is no image and the prompt is the whole shot.\n\nA rendered clip is NOT usable anywhere until you keep it: `baker studio keep <id> --slot N` is what puts it in the video library. Takes nobody keeps are never ingested, which is what makes a rejected batch cheap.\n\nFor anything longer than 15 seconds, or to build on footage that already exists, use --model bytedance/seedance-2.5: it renders 4-30s and is the only model that reads an existing clip or an existing soundtrack.\n\nExamples:\n  baker studio animate 'slow push in, model turns to camera and smiles' --image j57abc123def456ghi789\n  baker studio animate 'she looks to camera and says: \"Hola, soy Elena\"' --avatar elena --quality 720p --aspect-ratio 9:16\n  baker studio animate 'handheld drift right, steam rising from the cup' --image './out/hero.png' --duration 6 --quality 1080p\n  baker studio animate 'product rotates once on a turntable' --image j57abc\u2026,j57def\u2026 --from references\n  baker studio animate 'she keeps walking, camera stays with her, then she stops and looks up' --image j57abc\u2026 --from references --from-clip j57batch\u2026:0 --model bytedance/seedance-2.5 --duration 20\n  baker studio animate 'hold on the product, then a slow push-in' --from references --from-video j57vid\u2026 --model bytedance/seedance-2.5\n  baker studio animate 'slow drone pull-back over a solar farm at golden hour, no people' --from text --model bytedance/seedance-2.5 --duration 12"
@@ -66377,7 +66102,7 @@ var animateCommand = defineCommand215({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand210 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -66513,7 +66238,7 @@ function buildGenerateBody(args5, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand216({
+var generateCommand = defineCommand210({
   meta: {
     name: "generate",
     description: "Start here to make an image. Renders 1-8 takes of one brief, ingests each into the media library as it lands, and shows the batch in the dashboard Studio next to the ones the client ran.\n\nModel choice: google/gemini-3.1-flash-image-preview (default \u2014 fast, best at editing a reference and at extreme ratios), google/gemini-3-pro-image-preview (highest fidelity, slower), openai/gpt-image-2 (photoreal and the cleanest in-image text \u2014 no --image-size, no 4:5 / 5:4), recraft/recraft-v4.1-pro-vector (vector/flat marks with palette control).\n\n--reference is the biggest quality lever there is: a real logo, product shot, Pinterest pin or sandbox screenshot beats any amount of adjectives.\n\nExamples:\n  baker studio generate 'matte black bottle on wet marble, hard studio light, 35mm' --aspect-ratio 3:2 --count 3\n  baker studio generate 'this bottle on a sunlit kitchen counter' --reference './src/brand/product.png,https://\u2026/kitchen.jpg'\n  baker studio generate 'founder-style selfie, kitchen background, natural light' --skill ugc-selfie-hook\n  baker studio generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
@@ -66596,7 +66321,7 @@ var generateCommand = defineCommand216({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand211 } from "citty";
 registerSchema({
   command: "studio.get",
   description: "Read one Studio batch: every take, where it lives, and why a take is missing. This is how you pick up a batch that was still rendering when the start command returned.",
@@ -66605,7 +66330,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand217({
+var getCommand5 = defineCommand211({
   meta: {
     name: "get",
     description: "Read one Studio batch \u2014 the takes, their urls, whether each is in the library, and the reason for any that failed.\n\nExample: baker studio get j57abc123def456ghi789\nExample: baker studio get j57abc123def456ghi789 --full"
@@ -66634,7 +66359,7 @@ var getCommand5 = defineCommand217({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 var DESCRIPTION2 = "Sharpen a rough brief into directed art direction \u2014 the same rewrite the client gets from the wand in the Studio prompt bar. Reach for it when you are relaying the CLIENT's own words and want them shaped without substituting your voice; when you are writing the art direction yourself, just write it, because you will do a better job than this does.";
 registerSchema({
   command: "studio.improve",
@@ -66659,7 +66384,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand218({
+var improveCommand = defineCommand212({
   meta: {
     name: "improve",
     description: `${DESCRIPTION2}
@@ -66703,7 +66428,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 registerSchema({
   command: "studio.keep",
   description: "Mark one take as the keeper. For an image this stars it, so the client reviewing the batch sees which one you used. For a CLIP it is the step that puts it in the video library \u2014 until then the clip cannot be used in a canvas, a landing, or an ad.",
@@ -66713,7 +66438,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand219({
+var keepCommand = defineCommand213({
   meta: {
     name: "keep",
     description: "Mark one take as the keeper. An image gets starred (it was already in the library); a clip gets INGESTED into the video library, which is what makes it usable anywhere else.\n\nExample: baker studio keep j57abc123def456ghi789 --slot 2\nExample: baker studio keep j57abc123def456ghi789 --slot 2 --undo"
@@ -66764,7 +66489,7 @@ var keepCommand = defineCommand219({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand214 } from "citty";
 registerSchema({
   command: "studio.list",
   description: "Recent Studio batches for THIS conversation, newest first \u2014 what you have already generated, so you re-use a take instead of paying for it twice. `--all` widens it to everything the company generated, including what people ran themselves in the dashboard.",
@@ -66775,7 +66500,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand19 = defineCommand220({
+var listCommand18 = defineCommand214({
   meta: {
     name: "list",
     description: "Recent Studio batches, newest first. Scoped to this conversation unless you pass --all.\n\nExample: baker studio list\nExample: baker studio list --kind video --limit 5\nExample: baker studio list --all   # includes batches the client ran in the dashboard"
@@ -66809,7 +66534,7 @@ var listCommand19 = defineCommand220({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand215 } from "citty";
 var DESCRIPTION3 = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
 registerSchema({
   command: "studio.models",
@@ -66896,7 +66621,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand221({
+var modelsCommand = defineCommand215({
   meta: {
     name: "models",
     description: `${DESCRIPTION3}
@@ -66943,13 +66668,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand216 } from "citty";
 registerSchema({
   command: "studio.skills",
   description: "The craft directions `studio generate --skill <id>` accepts. Each one carries directed art direction plus the model, shape and take count it wants, so you pick a look by name instead of writing the boilerplate yourself.",
   args: {}
 });
-var skillsCommand = defineCommand222({
+var skillsCommand = defineCommand216({
   meta: {
     name: "skills",
     description: "List the craft directions available to `baker studio generate --skill <id>` \u2014 what each one is for, whether it wants a reference image, and the model/shape/count it defaults to.\n\nExample: baker studio skills"
@@ -66973,7 +66698,7 @@ var skillsCommand = defineCommand222({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand223({
+var studioCommand = defineCommand217({
   meta: {
     name: "studio",
     description: `Make new imagery and clips. Every batch is recorded and shows up in the dashboard Studio for the client to review, labelled with this conversation.
@@ -67007,7 +66732,7 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
     generate: generateCommand,
     animate: animateCommand,
     get: getCommand5,
-    list: listCommand19,
+    list: listCommand18,
     keep: keepCommand,
     models: modelsCommand,
     skills: skillsCommand,
@@ -67016,10 +66741,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand221 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand218 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync21 } from "fs";
@@ -67080,17 +66805,19 @@ var STAGE_HINTS2 = [
 async function stageOp4(op) {
   const chatId = requireChatId();
   try {
-    const data = await apiPost("/api/tag-manager/draft/stage", { chatId, op });
-    writeJsonEnvelope({ ok: true, data, hints: STAGE_HINTS2 });
+    const { data, hints: hints2 } = splitHints(
+      await apiPost("/api/tag-manager/draft/stage", { chatId, op })
+    );
+    writeJsonEnvelope({ ok: true, data, hints: [...hints2, ...STAGE_HINTS2] });
   } catch (err) {
     handleError8(err);
   }
 }
-async function draftAction3(path49, body, chat) {
+async function draftAction3(path48, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path49, { chatId, ...body });
-    writeJsonEnvelope({ ok: true, data });
+    const { data, hints: hints2 } = splitHints(await apiPost(path48, { chatId, ...body }));
+    writeJsonEnvelope({ ok: true, data, ...hints2.length > 0 ? { hints: hints2 } : {} });
     return data;
   } catch (err) {
     handleError8(err);
@@ -67121,12 +66848,13 @@ function renderDraft2(response) {
 async function draftList2(json, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost("/api/tag-manager/draft", { chatId });
+    const response = await apiPost("/api/tag-manager/draft", { chatId });
+    const { data, hints: hints2 } = splitHints(response);
     if (json) {
-      writeJsonEnvelope({ ok: true, data });
+      writeJsonEnvelope({ ok: true, data, ...hints2.length > 0 ? { hints: hints2 } : {} });
       return;
     }
-    process.stdout.write(`${renderDraft2(data)}
+    process.stdout.write(`${renderDraft2(data)}${hintLines(response)}
 `);
   } catch (err) {
     handleError8(err);
@@ -67142,13 +66870,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand5 = defineCommand224({
+var draftCommand5 = defineCommand218({
   meta: {
     name: "draft",
     description: "List, show, amend, remove, or clear staged Tag Manager changes for this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
   },
   subCommands: {
-    list: defineCommand224({
+    list: defineCommand218({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -67161,7 +66889,7 @@ var draftCommand5 = defineCommand224({
         await draftList2(args5.json === true, args5.chat);
       }
     }),
-    show: defineCommand224({
+    show: defineCommand218({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -67178,7 +66906,7 @@ var draftCommand5 = defineCommand224({
         );
       }
     }),
-    amend: defineCommand224({
+    amend: defineCommand218({
       meta: {
         name: "amend",
         description: "Update a staged change in place \u2014 merges a JSON patch into its payload (objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create."
@@ -67195,7 +66923,7 @@ var draftCommand5 = defineCommand224({
         });
       }
     }),
-    remove: defineCommand224({
+    remove: defineCommand218({
       meta: { name: "remove", description: "Remove one staged change (cascades to anything depending on it)" },
       args: { ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false } },
       run: async ({ args: args5 }) => {
@@ -67204,7 +66932,7 @@ var draftCommand5 = defineCommand224({
         });
       }
     }),
-    clear: defineCommand224({
+    clear: defineCommand218({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -67214,7 +66942,7 @@ var draftCommand5 = defineCommand224({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand219 } from "citty";
 registerSchema({
   command: "tagManager.containers",
   description: "List the Google Tag Manager containers this company's connection can reach. Every container the company connected is flagged `connected: true` \u2014 there can be several, and Baker may read and change all of them. Start here to confirm which containers you are managing.",
@@ -67255,7 +66983,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand225({
+var containersCommand = defineCommand219({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -67272,7 +67000,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand225({
+var readCommand = defineCommand219({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -67314,7 +67042,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand220 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -67370,10 +67098,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand226({
+  return defineCommand220({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand226({
+      create: defineCommand220({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -67395,7 +67123,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand226({
+      update: defineCommand220({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -67415,7 +67143,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand226({
+      delete: defineCommand220({
         meta: { name: "delete", description: `Stage the deletion of a ${noun} (pass its id or path)` },
         args: {
           id: { type: "positional", description: `${noun} id or path`, required: false },
@@ -67456,7 +67184,7 @@ function builtinTypes(args5) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand226({
+var builtinCommand = defineCommand220({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -67466,7 +67194,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand226({
+    enable: defineCommand220({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -67480,7 +67208,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand226({
+    disable: defineCommand220({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -67498,7 +67226,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand227({
+var tagManagerCommand = defineCommand221({
   meta: {
     name: "tag-manager",
     description: `Read and change what lives inside the client's Google Tag Manager container \u2014 tags, triggers, variables, folders and built-in variables.
@@ -67535,7 +67263,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand222 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -67615,7 +67343,7 @@ async function listTags(json) {
 var listArgs12 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand20 = defineCommand228({
+var listCommand19 = defineCommand222({
   meta: {
     name: "list",
     description: "Effective tags for this chat (production + staged), with each tag's full readable config (secrets excluded) \u2014 reuse a stored value to pre-fill a change rather than asking the user. Refs printed here are what flow side-effect tagIds should use. Example: baker tags list"
@@ -67634,7 +67362,7 @@ async function listDraft4(chat) {
     failApi3(err);
   }
 }
-var draftCommand6 = defineCommand228({
+var draftCommand6 = defineCommand222({
   meta: {
     name: "draft",
     description: "Review the tag changes staged in this chat (read-only). Staged changes were approved via request_tag_input and apply when the chat is published; to amend or drop one, propose a follow-up change through the same tool (a delete on a tag_temp_* ref drops the staged create). Takes --chat <id> to read an earlier chat's staged changes instead."
@@ -67644,7 +67372,7 @@ var draftCommand6 = defineCommand228({
     await listDraft4(args5.chat);
   }
 });
-var tagsCommand4 = defineCommand228({
+var tagsCommand4 = defineCommand222({
   meta: {
     name: "tags",
     description: `Read the client's marketing/analytics tags (Meta pixel, GA4, Google Ads, GTM, Clarity, Hotjar, \u2026) \u2014 production tags plus the changes staged in this chat.
@@ -67661,7 +67389,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/tags.md`
   },
   subCommands: {
-    list: listCommand20,
+    list: listCommand19,
     draft: draftCommand6
   },
   // Bare `baker tags` lists the effective tags. `args` stays so citty knows this
@@ -67673,10 +67401,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand232 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand229 } from "citty";
+import { defineCommand as defineCommand223 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -67684,7 +67412,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand229({
+var getCommand6 = defineCommand223({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -67721,7 +67449,7 @@ var getCommand6 = defineCommand229({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand230 } from "citty";
+import { defineCommand as defineCommand224 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -67878,7 +67606,7 @@ function buildListParams(args5) {
   }
   return params;
 }
-var listCommand21 = defineCommand230({
+var listCommand20 = defineCommand224({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -67938,7 +67666,7 @@ var listCommand21 = defineCommand230({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand231 } from "citty";
+import { defineCommand as defineCommand225 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -68017,7 +67745,7 @@ function buildSearchRequest(query, args5) {
   }
   return body;
 }
-var searchCommand3 = defineCommand231({
+var searchCommand3 = defineCommand225({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -68081,7 +67809,7 @@ var searchCommand3 = defineCommand231({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand232({
+var testimonialsCommand = defineCommand226({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -68097,16 +67825,16 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
   subCommands: {
     get: getCommand6,
     search: searchCommand3,
-    list: listCommand21,
+    list: listCommand20,
     tags: tagsCommand5
   }
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand241 } from "citty";
+import { defineCommand as defineCommand234 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand233 } from "citty";
+import { defineCommand as defineCommand227 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -68120,7 +67848,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand233({
+var deleteCommand4 = defineCommand227({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -68161,7 +67889,7 @@ var deleteCommand4 = defineCommand233({
 });
 
 // src/commands/videos/describe.ts
-import { defineCommand as defineCommand234 } from "citty";
+import { defineCommand as defineCommand228 } from "citty";
 var DESCRIPTION_HELP2 = "What the clip actually shows, in the words someone would search for it by. This is what `baker videos search` retrieves on.";
 registerSchema({
   command: "videos.describe",
@@ -68178,7 +67906,7 @@ registerSchema({
     full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
   }
 });
-var describeCommand2 = defineCommand234({
+var describeCommand2 = defineCommand228({
   meta: {
     name: "describe",
     description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
@@ -68235,10 +67963,108 @@ Example: baker videos describe j571abc123 --description "Customer explaining how
   }
 });
 
-// src/commands/videos/fetch.ts
-import { mkdir as mkdir15 } from "fs/promises";
+// src/commands/videos/get.ts
+import { defineCommand as defineCommand229 } from "citty";
+registerSchema({
+  command: "videos.get",
+  description: "Get a single video by ID",
+  args: {
+    id: { type: "string", description: "Video ID", required: true }
+  }
+});
+var getCommand7 = defineCommand229({
+  meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
+  args: {
+    id: { type: "positional", description: "Video ID", required: false },
+    "video-id": { type: "string", description: "Video ID (alternative to positional)", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  },
+  run: async ({ args: args5 }) => {
+    try {
+      const id = args5.id || args5["video-id"];
+      if (!id) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Video ID is required" } });
+        process.exit(1);
+      }
+      validateConvexId(id);
+      const data = await apiGet("/api/videos/get", { id });
+      writeOutput(
+        { ok: true, data },
+        args5.output || "json",
+        args5.fields ? args5.fields.split(",") : void 0,
+        args5.full,
+        videoNormalizer
+      );
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/videos/group.ts
+import { defineCommand as defineCommand230 } from "citty";
+registerSchema({
+  command: "videos.group",
+  description: "List every clip and image that arrived in the same set as this video (carousel slides, one page)",
+  args: {
+    id: { type: "string", description: "A video or image id \u2014 returns that asset's whole set", required: false },
+    "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
+  }
+});
+var groupCommand2 = defineCommand230({
+  meta: {
+    name: "group",
+    description: "List every asset that arrived in the same set as this clip \u2014 the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip pulled out of one is usually missing half its meaning. Example: baker videos group <videoId>"
+  },
+  args: {
+    id: { type: "positional", description: "A video or image id from the set", required: false },
+    "group-key": { type: "string", description: "The set key, if you already have it", required: false }
+  },
+  run: async ({ args: args5 }) => {
+    await runMediaGroupLookup({
+      id: args5.id,
+      groupKey: args5["group-key"],
+      path: "/api/videos/group",
+      idLabel: "a video or image id"
+    });
+  }
+});
+
+// src/commands/videos/ingest.ts
+import { mkdtemp as mkdtemp3, rm as rm9, stat as stat11 } from "fs/promises";
+import { tmpdir as tmpdir4 } from "os";
 import path47 from "path";
-import { defineCommand as defineCommand235 } from "citty";
+import { defineCommand as defineCommand231 } from "citty";
+
+// src/lib/streamUpload.ts
+import { createHash as createHash2 } from "crypto";
+import { createReadStream } from "fs";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+async function hashFile(filePath) {
+  const hash = createHash2("sha256");
+  await pipeline(createReadStream(filePath), hash);
+  return hash.digest("hex");
+}
+async function putFileStreamed(args5) {
+  const body = Readable.toWeb(createReadStream(args5.filePath));
+  return await fetch(args5.putUrl, {
+    method: "PUT",
+    body,
+    headers: {
+      "Content-Type": args5.contentType,
+      "Content-Length": String(args5.sizeBytes)
+    },
+    duplex: "half"
+  });
+}
 
 // src/commands/videos/videoPlatforms.ts
 var PLATFORM_DOMAINS = {
@@ -68247,7 +68073,6 @@ var PLATFORM_DOMAINS = {
   tiktok: ["tiktok.com"],
   twitter: ["twitter.com", "x.com", "vxtwitter.com", "fixvx.com"],
   facebook: ["facebook.com", "fb.watch", "fb.com"],
-  linkedin: ["linkedin.com", "lnkd.in"],
   reddit: ["reddit.com", "redd.it"],
   vimeo: ["vimeo.com"],
   dailymotion: ["dailymotion.com", "dai.ly"],
@@ -68352,188 +68177,6 @@ function safePathname(rawUrl) {
   }
 }
 
-// src/commands/videos/fetch.ts
-registerSchema({
-  command: "videos.fetch",
-  description: "Download a video page (YouTube, TikTok, Vimeo, \u2026) to a local .mp4 without adding it to the library. For editing a clip locally; use `videos ingest` to add one to the library.",
-  args: {
-    url: { type: "string", description: "Video page URL", required: true },
-    out: { type: "string", description: "Directory to write the file into (created if missing)", required: true },
-    "max-seconds": {
-      type: "string",
-      description: `Refuse videos longer than this many seconds (default ${MAX_VIDEO_INGEST_SECONDS})`,
-      required: false
-    },
-    "timeout-ms": { type: "string", description: "Download time limit in milliseconds", required: false },
-    "max-height": {
-      type: "string",
-      description: "Keep a version no taller than this many pixels (e.g. 1080) when the site offers one",
-      required: false
-    }
-  }
-});
-function positiveInt(value) {
-  const parsed = typeof value === "string" ? Number.parseInt(value, 10) : Number.NaN;
-  return Number.isInteger(parsed) && parsed > 0 ? parsed : void 0;
-}
-var fetchCommand2 = defineCommand235({
-  meta: {
-    name: "fetch",
-    description: "Download a video page to a local .mp4 without adding it to the library. Same downloader as `ingest` (proxy fallback, duration check).\n\nExample: baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips"
-  },
-  args: {
-    url: { type: "positional", description: "Video page URL", required: true },
-    out: { type: "string", description: "Directory to write the file into", required: true },
-    "max-seconds": { type: "string", description: "Refuse videos longer than this", required: false },
-    "timeout-ms": { type: "string", description: "Download time limit in milliseconds", required: false },
-    "max-height": { type: "string", description: "Keep a version no taller than this (e.g. 1080)", required: false }
-  },
-  run: async ({ args: args5 }) => {
-    const url = String(args5.url ?? "");
-    const outDir = path47.resolve(String(args5.out ?? ""));
-    const maxSeconds = positiveInt(args5["max-seconds"]) ?? MAX_VIDEO_INGEST_SECONDS;
-    try {
-      await mkdir15(outDir, { recursive: true });
-      const vimeoCookie = captureVimeoCookie();
-      const probe = await probeYtDlp({ url, vimeoCookie, cookieDir: outDir });
-      if (isAudioOnly(probe.info)) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "That link is audio, not video." } });
-        process.exit(1);
-      }
-      const seconds = durationSeconds(probe.info);
-      const tooLong = refuseByDuration(seconds, maxSeconds);
-      if (tooLong) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: tooLong } });
-        process.exit(1);
-      }
-      const { filePath, tier, reducedQuality } = await runYtDlp({
-        url,
-        audioOnly: false,
-        workDir: outDir,
-        vimeoCookie,
-        timeoutMs: positiveInt(args5["timeout-ms"]) ?? downloadTimeoutMs(seconds),
-        maxHeight: positiveInt(args5["max-height"])
-      });
-      writeJson({
-        ok: true,
-        data: {
-          file: filePath,
-          durationSeconds: seconds,
-          egress: tier,
-          ...reducedQuality ? { reducedQuality: true } : {}
-        }
-      });
-    } catch (err) {
-      const message = err instanceof YtDlpError ? `${err.message}: ${err.stderrTail}`.trim() : err instanceof Error ? err.message : String(err);
-      writeJson({ ok: false, error: { code: "DOWNLOAD_FAILED", message } });
-      process.exit(1);
-    }
-  }
-});
-
-// src/commands/videos/get.ts
-import { defineCommand as defineCommand236 } from "citty";
-registerSchema({
-  command: "videos.get",
-  description: "Get a single video by ID",
-  args: {
-    id: { type: "string", description: "Video ID", required: true }
-  }
-});
-var getCommand7 = defineCommand236({
-  meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
-  args: {
-    id: { type: "positional", description: "Video ID", required: false },
-    "video-id": { type: "string", description: "Video ID (alternative to positional)", required: false },
-    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
-    fields: { type: "string", description: "Comma-separated field names to include", required: false },
-    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
-  },
-  run: async ({ args: args5 }) => {
-    try {
-      const id = args5.id || args5["video-id"];
-      if (!id) {
-        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Video ID is required" } });
-        process.exit(1);
-      }
-      validateConvexId(id);
-      const data = await apiGet("/api/videos/get", { id });
-      writeOutput(
-        { ok: true, data },
-        args5.output || "json",
-        args5.fields ? args5.fields.split(",") : void 0,
-        args5.full,
-        videoNormalizer
-      );
-    } catch (err) {
-      if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
-        process.exit(1);
-      }
-      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-      process.exit(1);
-    }
-  }
-});
-
-// src/commands/videos/group.ts
-import { defineCommand as defineCommand237 } from "citty";
-registerSchema({
-  command: "videos.group",
-  description: "List every clip and image that arrived in the same set as this video (carousel slides, one page)",
-  args: {
-    id: { type: "string", description: "A video or image id \u2014 returns that asset's whole set", required: false },
-    "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
-  }
-});
-var groupCommand2 = defineCommand237({
-  meta: {
-    name: "group",
-    description: "List every asset that arrived in the same set as this clip \u2014 the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip pulled out of one is usually missing half its meaning. Example: baker videos group <videoId>"
-  },
-  args: {
-    id: { type: "positional", description: "A video or image id from the set", required: false },
-    "group-key": { type: "string", description: "The set key, if you already have it", required: false }
-  },
-  run: async ({ args: args5 }) => {
-    await runMediaGroupLookup({
-      id: args5.id,
-      groupKey: args5["group-key"],
-      path: "/api/videos/group",
-      idLabel: "a video or image id"
-    });
-  }
-});
-
-// src/commands/videos/ingest.ts
-import { mkdtemp as mkdtemp3, rm as rm9, stat as stat11 } from "fs/promises";
-import { tmpdir as tmpdir4 } from "os";
-import path48 from "path";
-import { defineCommand as defineCommand238 } from "citty";
-
-// src/lib/streamUpload.ts
-import { createHash as createHash2 } from "crypto";
-import { createReadStream } from "fs";
-import { Readable } from "stream";
-import { pipeline } from "stream/promises";
-async function hashFile(filePath) {
-  const hash = createHash2("sha256");
-  await pipeline(createReadStream(filePath), hash);
-  return hash.digest("hex");
-}
-async function putFileStreamed(args5) {
-  const body = Readable.toWeb(createReadStream(args5.filePath));
-  return await fetch(args5.putUrl, {
-    method: "PUT",
-    body,
-    headers: {
-      "Content-Type": args5.contentType,
-      "Content-Length": String(args5.sizeBytes)
-    },
-    duplex: "half"
-  });
-}
-
 // src/commands/videos/ingest.ts
 registerSchema({
   command: "videos.ingest",
@@ -68562,7 +68205,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand238({
+var ingestCommand2 = defineCommand231({
   meta: {
     name: "ingest",
     description: "Add a video to the library from a URL. A direct file URL is handed straight to Baker, which fetches it. A page URL (YouTube, TikTok, Vimeo, Instagram) is downloaded here first, then uploaded \u2014 and a direct URL that Baker cannot fetch falls back to that same path automatically.\n\nExample: baker videos ingest https://www.youtube.com/watch?v=abc123"
@@ -68748,7 +68391,7 @@ function ingestUrl(args5) {
 }
 async function downloadThenIngest(args5, country) {
   const vimeoCookie = captureVimeoCookie();
-  const workDir = await mkdtemp3(path48.join(tmpdir4(), "videos-ingest-"));
+  const workDir = await mkdtemp3(path47.join(tmpdir4(), "videos-ingest-"));
   try {
     const probe = await probeYtDlp({ url: args5.url, country, vimeoCookie, cookieDir: workDir });
     if (isAudioOnly(probe.info)) {
@@ -68824,7 +68467,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand239 } from "citty";
+import { defineCommand as defineCommand232 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -68834,7 +68477,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand239({
+var searchCommand4 = defineCommand232({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -68886,7 +68529,7 @@ var tagsCommand6 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile33, stat as stat12 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
-import { defineCommand as defineCommand240 } from "citty";
+import { defineCommand as defineCommand233 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -68928,7 +68571,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand240({
+var uploadCommand2 = defineCommand233({
   meta: {
     name: "upload",
     description: "Upload a video to Baker \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: auto-detects content type and uploads via Mux direct upload.\nRemote: hands off to `videos ingest` (direct fetch, or download-then-upload for a YouTube/TikTok/Vimeo page).\n\nExamples:\n  baker videos upload ./demo.mp4\n  baker videos upload https://www.youtube.com/watch?v=abc123"
@@ -69012,10 +68655,10 @@ var uploadCommand2 = defineCommand240({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand241({
+var videosCommand = defineCommand234({
   meta: {
     name: "videos",
-    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, fetch, describe, delete, tags.
+    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, describe, delete, tags.
 
 Examples:
   baker videos search "product demo" --limit 5
@@ -69023,7 +68666,6 @@ Examples:
   baker videos get <video-id>
   baker videos upload ./demo.mp4
   baker videos ingest https://www.youtube.com/watch?v=abc123
-  baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips
   baker videos describe <video-id> --description "Customer testimonial, 30s"
   baker videos delete <video-id> --dry-run
   baker videos tags
@@ -69035,7 +68677,6 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
     search: searchCommand4,
     upload: uploadCommand2,
     ingest: ingestCommand2,
-    fetch: fetchCommand2,
     describe: describeCommand2,
     delete: deleteCommand4,
     tags: tagsCommand6
@@ -69043,10 +68684,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand254 } from "citty";
+import { defineCommand as defineCommand247 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand242 } from "citty";
+import { defineCommand as defineCommand235 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList3(value) {
@@ -69055,7 +68696,7 @@ function splitList3(value) {
   }
   return value.split(",").map((v) => v.trim()).filter(Boolean);
 }
-function reportError3(err) {
+function reportError2(err) {
   if (err instanceof ApiError) {
     writeJson({ ok: false, error: { code: err.code, message: err.message } });
     process.exit(1);
@@ -69099,7 +68740,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand242({
+var advertisersCommand2 = defineCommand235({
   meta: {
     name: "advertisers",
     description: 'List corpus advertisers by name or domain. Find your own advertiser for --exclude-advertiser, or a competitor for --advertiser-id / winners. Example: baker winning-ads advertisers "Deel" --output md'
@@ -69151,13 +68792,13 @@ var advertisersCommand2 = defineCommand242({
         advertiserNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand243 } from "citty";
+import { defineCommand as defineCommand236 } from "citty";
 registerSchema({
   command: "winning-ads.brief",
   description: "Generate a creative brief grounded in strategically-similar winning ads. Optionally describe the target creative with --dna (JSON) and steer with --notes.",
@@ -69203,7 +68844,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand243({
+var briefCommand = defineCommand236({
   meta: {
     name: "brief",
     description: `Generate a creative brief from winning references. Example: baker winning-ads brief --dna '{"angle":"cost savings"}' --notes "B2B, LinkedIn video" --k 8`
@@ -69233,13 +68874,13 @@ var briefCommand = defineCommand243({
       const data = await apiPost("/api/ad-library/brief", body);
       writeJson({ ok: true, data });
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand244 } from "citty";
+import { defineCommand as defineCommand237 } from "citty";
 registerSchema({
   command: "winning-ads.content",
   description: "Read what's INSIDE one winning ad: the spoken transcript, the on-screen text, and the ad copy. Use this after `search`/`winners`/`feed` return a shortlist \u2014 pass an ad_id to understand a reference before reproducing it. Add --full for speech, pacing, and soundtrack detail. Video ads carry the transcript/on-screen text; static ads carry only the copy.",
@@ -69252,7 +68893,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand244({
+var contentCommand = defineCommand237({
   meta: {
     name: "content",
     description: "Read the transcript + on-screen text + copy of one winning ad. Example: baker winning-ads content adg_123 --platform meta --full --output md"
@@ -69295,13 +68936,13 @@ var contentCommand = defineCommand244({
         adContentNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand245 } from "citty";
+import { defineCommand as defineCommand238 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList3(input.advertiser);
@@ -69353,7 +68994,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand2 = defineCommand245({
+var feedCommand2 = defineCommand238({
   meta: {
     name: "feed",
     description: "Winners across every brand you follow (browse, then trim per advertiser). Example: baker winning-ads feed --per-advertiser 5 --output md"
@@ -69432,13 +69073,13 @@ var feedCommand2 = defineCommand245({
 `);
       }
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand246 } from "citty";
+import { defineCommand as defineCommand239 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -69453,7 +69094,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand246({
+var followCommand = defineCommand239({
   meta: {
     name: "follow",
     description: 'Follow a brand to track ALL its ads \u2014 every platform and country. --platform is how we read your input, not a limit. A domain tracks every platform we can resolve. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -69494,13 +69135,13 @@ var followCommand = defineCommand246({
       }
       writeJson({ ok: true, data, hints: hints2 });
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand247 } from "citty";
+import { defineCommand as defineCommand240 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -69533,7 +69174,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand247({
+var followCompetitorsCommand = defineCommand240({
   meta: {
     name: "follow-competitors",
     description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
@@ -69602,13 +69243,13 @@ var followCompetitorsCommand = defineCommand247({
       }
       writeJson({ ok: true, data, hints: hints2.length > 0 ? hints2 : void 0 });
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand248 } from "citty";
+import { defineCommand as defineCommand241 } from "citty";
 registerSchema({
   command: "winning-ads.following",
   description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts. A brand still adding has counts that are a lie in progress; one with `discovery_failed` has counts that are short because we couldn't finish looking, which is not the same as it running no ads.",
@@ -69662,7 +69303,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand248({
+var followingCommand = defineCommand241({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. A brand's counts are only final once it is ready. Example: baker winning-ads following --output md"
@@ -69692,13 +69333,13 @@ var followingCommand = defineCommand248({
         followingNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand249 } from "citty";
+import { defineCommand as defineCommand242 } from "citty";
 registerSchema({
   command: "winning-ads.patterns",
   description: "Mine what separates two cohorts of ads: pass a comma-list of winning ad ids (--winners) and a comma-list of weaker ad ids (--duds). Returns the discriminating DNA fields.",
@@ -69737,7 +69378,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand249({
+var patternsCommand = defineCommand242({
   meta: {
     name: "patterns",
     description: "Discover what separates winning ads from weak ones. Example: baker winning-ads patterns --winners a_1,a_2,a_3 --duds a_9,a_8 --output md"
@@ -69787,13 +69428,13 @@ var patternsCommand = defineCommand249({
         (record) => discriminatorRow(record)
       );
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand250 } from "citty";
+import { defineCommand as defineCommand243 } from "citty";
 registerSchema({
   command: "winning-ads.search",
   description: "Search the ad-dna corpus of scored winning ads. Returns a lean shortlist (advertiser, summary, scores, media_url) to pick a reference to reproduce.",
@@ -69929,9 +69570,9 @@ function reportSearchError(err) {
     writeJson({ ok: false, error: { code: err.code, message: err.message, fix } });
     process.exit(1);
   }
-  reportError3(err);
+  reportError2(err);
 }
-var searchCommand5 = defineCommand250({
+var searchCommand5 = defineCommand243({
   meta: {
     name: "search",
     description: "Search winning reference ads. Example: baker winning-ads search 'B2B SaaS before/after AI automation' --platform meta --format static --winner-category winner --exclude-advertiser adv_123 --output md"
@@ -70051,7 +69692,7 @@ var searchCommand5 = defineCommand250({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand251 } from "citty";
+import { defineCommand as defineCommand244 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -70079,7 +69720,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand251({
+  return defineCommand244({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -70106,7 +69747,7 @@ function makeSeedCommand(opts) {
         }
         writeOutput({ ok: true, data: projected }, output);
       } catch (err) {
-        reportError3(err);
+        reportError2(err);
       }
     }
   });
@@ -70128,7 +69769,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand252 } from "citty";
+import { defineCommand as defineCommand245 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -70136,7 +69777,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand252({
+var unfollowCommand = defineCommand245({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -70151,13 +69792,13 @@ var unfollowCommand = defineCommand252({
       });
       writeJson({ ok: true, data });
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand253 } from "citty";
+import { defineCommand as defineCommand246 } from "citty";
 registerSchema({
   command: "winning-ads.winners",
   description: "Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.",
@@ -70167,7 +69808,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand253({
+var winnersCommand = defineCommand246({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -70211,13 +69852,13 @@ var winnersCommand = defineCommand253({
         winningAdNormalizer
       );
     } catch (err) {
-      reportError3(err);
+      reportError2(err);
     }
   }
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand254({
+var winningAdsCommand = defineCommand247({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -70289,7 +69930,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand255({
+var main = defineCommand248({
   meta: {
     name: "baker",
     version: getCliVersion(),
@@ -70329,7 +69970,6 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
     history: historyCommand2,
     hubspot: hubspotCommand,
     "winning-ads": winningAdsCommand,
-    "media-sources": mediaSourcesCommand,
     mcp: mcpCommand,
     schema: schemaCommand2
   }