@koda-sl/baker-cli 0.377.0 → 0.379.0-dev.0114084a3

package/dist/cli.js

@@ -70,8 +70,9 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-FGHMWBUD.js";
+} from "./chunk-CHJOTJTZ.js";
 import {
+  NAME_CONTAINS_ARG,
   csvOrJson,
   daysAgoIso,
   getDateRange,
@@ -80,7 +81,7 @@ import {
   resolveEffectiveStatus,
   statusFilterHints,
   todayIso
-} from "./chunk-WKGKDYX3.js";
+} from "./chunk-VLUGGVJL.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -142,7 +143,7 @@ import {
 } from "./chunk-HJEMOSPH.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand248, runMain } from "citty";
+import { defineCommand as defineCommand255, runMain } from "citty";
 
 // src/cache-flag.ts
 var NO_CACHE_ARG = {
@@ -4533,6 +4534,9 @@ 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.
@@ -6397,6 +6401,9 @@ var imageSourceSchema = z20.enum([
   "google_testimonial",
   "trustpilot_testimonial",
   "instagram",
+  "tiktok",
+  "linkedin",
+  "facebook",
   "pexels",
   "pixabay",
   // Retired stock provider — kept so existing library rows stay filterable.
@@ -8208,6 +8215,7 @@ var videoSourceSchema = z30.enum([
   "dailymotion",
   "facebook",
   "instagram",
+  "linkedin",
   "loom",
   "newgrounds",
   "ok",
@@ -12108,9 +12116,9 @@ var COPY_LIST_FLAG = {
   descriptions: "--descriptions",
   longHeadlines: "--long-headlines"
 };
-function valueAt(root, path48) {
+function valueAt(root, path49) {
   let node = root;
-  for (const key of path48) {
+  for (const key of path49) {
     if (node === null || typeof node !== "object") return void 0;
     node = node[key];
   }
@@ -12343,11 +12351,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(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function rawFileEntries(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return [];
   }
-  return readFileSync2(path48, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+  return readFileSync2(path49, "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;
@@ -12370,14 +12378,14 @@ function keywordEntries(args5, rawArgs) {
   }
   return entries;
 }
-function loadJsonFileArg(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function loadJsonFileArg(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return {};
   }
-  const inline = path48.trimStart().startsWith("{");
-  const source = inline ? "inline JSON" : path48;
+  const inline = path49.trimStart().startsWith("{");
+  const source = inline ? "inline JSON" : path49;
   try {
-    const parsed = JSON.parse(inline ? path48 : readFileSync2(path48, "utf8"));
+    const parsed = JSON.parse(inline ? path49 : readFileSync2(path49, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
       failWriteValidation(`${source} must contain a JSON object`);
     }
@@ -12514,10 +12522,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(path48, body, chat) {
+async function draftAction(path49, body, chat) {
   try {
     const chatId = resolveChatId(chat);
-    const response = await apiPost(path48, { chatId, ...body });
+    const response = await apiPost(path49, { chatId, ...body });
     writeJsonEnvelope(response);
   } catch (err) {
     handleGoogleError(err);
@@ -14935,14 +14943,14 @@ function mappingRowProblem(row) {
 
 // ../api/src/event-sources/template.ts
 var MENTION = /\{\{\s*([^{}]+?)\s*\}\}/g;
-function mentionOf(path48) {
-  return `{{${path48}}}`;
+function mentionOf(path49) {
+  return `{{${path49}}}`;
 }
 function templateMentions(template) {
   const seen = [];
   for (const match of template.matchAll(MENTION)) {
-    const path48 = (match[1] ?? "").trim();
-    if (path48 !== "" && !seen.includes(path48)) seen.push(path48);
+    const path49 = (match[1] ?? "").trim();
+    if (path49 !== "" && !seen.includes(path49)) seen.push(path49);
   }
   return seen;
 }
@@ -18297,17 +18305,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(path48) {
-  const inline = path48.trimStart().startsWith("[") || path48.trimStart().startsWith("{");
+function readRowsFile(path49) {
+  const inline = path49.trimStart().startsWith("[") || path49.trimStart().startsWith("{");
   let text2;
   try {
-    text2 = inline ? path48 : readFileSync4(path48, "utf8");
+    text2 = inline ? path49 : readFileSync4(path49, "utf8");
   } catch (err) {
-    failWriteValidation(`could not read ${path48}: ${err instanceof Error ? err.message : String(err)}`);
+    failWriteValidation(`could not read ${path49}: ${err instanceof Error ? err.message : String(err)}`);
   }
   const parsed = parseConversionRowsText(text2);
   if (!parsed.ok) {
-    failWriteValidation(`${inline ? "the conversions passed inline" : path48}: ${parsed.error}`);
+    failWriteValidation(`${inline ? "the conversions passed inline" : path49}: ${parsed.error}`);
   }
   return { rows: parsed.rows, ignoredColumns: parsed.ignoredColumns };
 }
@@ -20182,19 +20190,19 @@ function failWriteValidation2(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg2(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function loadJsonFileArg2(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync5(path48, "utf8"));
+    const parsed = JSON.parse(readFileSync5(path49, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation2(`${path48} must contain a JSON object`);
+      failWriteValidation2(`${path49} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation2(`${path48} is not valid JSON: ${err.message}`);
+      failWriteValidation2(`${path49} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -20279,15 +20287,15 @@ function parseLocaleFlag(value) {
   }
   return { language: match[1], country: match[2].toUpperCase() };
 }
-function loadTargetingFileArg(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function loadTargetingFileArg(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return void 0;
   }
-  const parsed = loadJsonFileArg2(path48);
+  const parsed = loadJsonFileArg2(path49);
   const criteria = parsed.targetingCriteria ?? parsed;
   if (!criteria.include) {
     failWriteValidation2(
-      `${path48} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
+      `${path49} must contain targeting criteria with an "include" block (see baker schema ads.linkedin.campaigns.create)`
     );
   }
   return criteria;
@@ -20322,14 +20330,14 @@ function parseCsvLine(line) {
   cells.push(current);
   return cells.map((cell3) => cell3.trim());
 }
-function parseListFileArg(path48, maxRows) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function parseListFileArg(path49, maxRows) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return void 0;
   }
-  const raw = readFileSync5(path48, "utf8");
+  const raw = readFileSync5(path49, "utf8");
   const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
   if (lines.length < 2) {
-    failWriteValidation2(`${path48} needs a header row and at least one data row`);
+    failWriteValidation2(`${path49} needs a header row and at least one data row`);
   }
   const columns = parseCsvLine(lines[0]).map((column) => column.trim());
   const rows = [];
@@ -20348,7 +20356,7 @@ function parseListFileArg(path48, maxRows) {
     }
   }
   if (rows.length > maxRows) {
-    failWriteValidation2(`${path48} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
+    failWriteValidation2(`${path49} has ${rows.length} rows \u2014 the inline limit is ${maxRows}. Split the list.`);
   }
   return { columns, rows };
 }
@@ -20444,11 +20452,11 @@ function readPositionals(args5) {
 function splitIdList(raw) {
   return raw.split(",").map((id) => id.trim()).filter(Boolean);
 }
-function idsFileEntries(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function idsFileEntries(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return [];
   }
-  return readFileSync5(path48, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#")).flatMap(splitIdList);
+  return readFileSync5(path49, "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);
@@ -23210,9 +23218,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, path48) {
+function readPath2(row, path49) {
   let current = row;
-  for (const segment of path48.split(".")) {
+  for (const segment of path49.split(".")) {
     const record = asRecord(current);
     if (!record) return void 0;
     current = record[segment];
@@ -23222,10 +23230,10 @@ function readPath2(row, path48) {
 function projectFields(rows, paths) {
   return rows.map((row) => {
     const projected = {};
-    for (const path48 of paths) {
-      const value = readPath2(row, path48);
+    for (const path49 of paths) {
+      const value = readPath2(row, path49);
       if (value !== void 0) {
-        projected[path48] = value;
+        projected[path49] = value;
       }
     }
     return projected;
@@ -23238,16 +23246,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((path48) => row[path48] === void 0);
+        const missing = paths.filter((path49) => row[path49] === void 0);
         const source = rows[i];
         if (missing.length === 0 || source === void 0) return row;
         const compactRow3 = compact4.row(source);
-        for (const path48 of missing) {
-          if (compactRow3[path48] !== void 0) row[path48] = compactRow3[path48];
+        for (const path49 of missing) {
+          if (compactRow3[path49] !== void 0) row[path49] = compactRow3[path49];
         }
         return row;
       });
-      const unmatched = paths.filter((path48) => projected.every((row) => row[path48] === void 0));
+      const unmatched = paths.filter((path49) => projected.every((row) => row[path49] === 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 {
@@ -24617,54 +24625,54 @@ function buildCustomConversionRule(input) {
 function customConversionRuleRefusal(rule) {
   return ruleNodeRefusal(rule, "rule");
 }
-function branchRefusal(key, value, path48) {
+function branchRefusal(key, value, path49) {
   if (!Array.isArray(value) || value.length === 0) {
-    return `${path48}.${key} must be a non-empty array of conditions \u2014 an empty one counts every event the pixel sends`;
+    return `${path49}.${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, `${path48}.${key}[${index}]`);
+    const refusal = ruleNodeRefusal(child, `${path49}.${key}[${index}]`);
     if (refusal) {
       return refusal;
     }
   }
   return void 0;
 }
-function conditionRefusal(key, value, path48) {
-  return key === "and" || key === "or" ? branchRefusal(key, value, path48) : leafRefusal(key, value, path48);
+function conditionRefusal(key, value, path49) {
+  return key === "and" || key === "or" ? branchRefusal(key, value, path49) : leafRefusal(key, value, path49);
 }
-function ruleNodeRefusal(node, path48) {
+function ruleNodeRefusal(node, path49) {
   if (!isRecord2(node)) {
-    return `${path48} must be an object like {"URL":{"i_contains":"/thank-you"}}`;
+    return `${path49} must be an object like {"URL":{"i_contains":"/thank-you"}}`;
   }
   const entries = Object.entries(node);
   if (entries.length === 0) {
-    return `${path48} is empty \u2014 a rule with no condition counts every event the pixel sends`;
+    return `${path49} is empty \u2014 a rule with no condition counts every event the pixel sends`;
   }
   if (entries.length > 1) {
-    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]}`;
+    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]}`;
   }
   for (const [key, value] of entries) {
-    const refusal = conditionRefusal(key, value, path48);
+    const refusal = conditionRefusal(key, value, path49);
     if (refusal) {
       return refusal;
     }
   }
   return void 0;
 }
-function leafRefusal(field, condition, path48) {
+function leafRefusal(field, condition, path49) {
   if (!isRecord2(condition)) {
-    return `${path48}.${field} must be a test like {"i_contains":"/thank-you"}, not a bare value`;
+    return `${path49}.${field} must be a test like {"i_contains":"/thank-you"}, not a bare value`;
   }
   const tests = Object.entries(condition);
   if (tests.length === 0) {
-    return `${path48}.${field} names no test \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")}`;
+    return `${path49}.${field} names no test \u2014 use one of ${Object.keys(RULE_OPERATORS).join(", ")}`;
   }
   if (tests.length > 1) {
-    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]}`;
+    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]}`;
   }
   for (const [operator] of tests) {
     if (!RULE_OPERATORS[operator]) {
-      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 `${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 void 0;
@@ -25145,7 +25153,8 @@ var LEAD_FORM_CTA_TYPES = [
 var AD_FORMATS2 = ["SINGLE_IMAGE", "CAROUSEL", "SINGLE_VIDEO"];
 var ENROLL_STATUSES = ["OPT_IN", "OPT_OUT"];
 var STAGEABLE_CREATE_STATUSES4 = ["ACTIVE", "PAUSED"];
-var UPDATE_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED"];
+var UPDATE_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED", "DELETED"];
+var CREATIVE_UPDATE_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED"];
 var CUSTOM_AUDIENCE_SUBTYPES = ["CUSTOM", "WEBSITE", "ENGAGEMENT", "LOOKALIKE"];
 var CUSTOMER_FILE_SOURCES = [
   "USER_PROVIDED_ONLY",
@@ -25368,7 +25377,7 @@ function positionsMissingRequiredFeed(targeting) {
 // ../api/src/ads-meta/ops.ts
 var tempRefSchema4 = z37.string().regex(TEMP_REF_REGEX4, "expected a meta_temp_* reference");
 var parentRefSchema3 = z37.union([z37.string().regex(NUMERIC_ID_REGEX3, "expected a numeric id"), tempRefSchema4]);
-var moneySchema2 = z37.object({
+var moneySchema2 = z37.strictObject({
   amount: z37.string().regex(/^\d+(\.\d{1,3})?$/, "expected a decimal amount like 50 or 50.00").refine((val) => Number(val) > 0, "amount must be greater than zero"),
   currencyCode: z37.string().length(3).optional()
 });
@@ -25379,11 +25388,11 @@ var updateStatusSchema = z37.enum(UPDATE_STATUSES);
 function currencyMinimums2(currencyCode) {
   return CURRENCY_MINIMUMS2[currencyCode] ?? DEFAULT_CURRENCY_MINIMUM2;
 }
-function validateDailyBudgetFloor(money, ctx, path48) {
+function validateDailyBudgetFloor(money, ctx, path49) {
   if (money?.currencyCode) {
     const min = currencyMinimums2(money.currencyCode).dailyBudgetMin;
     if (Number(money.amount) < min) {
-      ctx.addIssue({ code: "custom", path: path48, message: `below the ${min} ${money.currencyCode} daily minimum` });
+      ctx.addIssue({ code: "custom", path: path49, message: `below the ${min} ${money.currencyCode} daily minimum` });
     }
   }
 }
@@ -25456,7 +25465,7 @@ function targetingHardLimitsDemographics(t) {
   return narrowsAgeMax || narrowsAgeMin || narrowsGender;
 }
 var specialAdCategoriesSchema = z37.array(z37.enum(SPECIAL_AD_CATEGORIES)).default(["NONE"]);
-var campaignCreateSchema4 = z37.object({
+var campaignCreateSchema4 = z37.strictObject({
   name: z37.string().min(1).max(META_LIMITS.campaign.nameMax),
   objective: z37.enum(OBJECTIVES2),
   status: stageableStatusSchema3.default("PAUSED"),
@@ -25494,7 +25503,7 @@ var campaignCreateSchema4 = z37.object({
     });
   }
 });
-var campaignUpdateSchema4 = z37.object({
+var campaignUpdateSchema4 = z37.strictObject({
   name: z37.string().min(1).max(META_LIMITS.campaign.nameMax).optional(),
   status: updateStatusSchema.optional(),
   bid_strategy: z37.enum(BID_STRATEGIES2).optional(),
@@ -25512,7 +25521,7 @@ var campaignUpdateSchema4 = z37.object({
   }
   validateDailyBudgetFloor(p.dailyBudget, ctx, ["dailyBudget", "amount"]);
 });
-var promotedObjectSchema = z37.object({
+var promotedObjectFields = {
   page_id: parentRefSchema3.optional(),
   pixel_id: z37.string().regex(NUMERIC_ID_REGEX3).optional(),
   custom_event_type: z37.enum(CUSTOM_EVENT_TYPES).optional(),
@@ -25532,9 +25541,12 @@ var promotedObjectSchema = z37.object({
   product_set_id: z37.string().regex(NUMERIC_ID_REGEX3).optional(),
   whatsapp_phone_number: z37.string().optional(),
   offline_conversion_data_set_id: z37.string().regex(NUMERIC_ID_REGEX3).optional()
-}).partial();
+};
+var promotedObjectSchema = z37.strictObject(promotedObjectFields, {
+  error: (issue) => issue.code === "unrecognized_keys" ? `promoted_object does not take ${issue.keys.map((key) => `"${key}"`).join(", ")} \u2014 it takes ${Object.keys(promotedObjectFields).join(", ")}` : void 0
+});
 var attributionSpecSchema = z37.array(
-  z37.object({
+  z37.strictObject({
     event_type: z37.enum(ATTRIBUTION_EVENT_TYPES),
     window_days: z37.union([z37.literal(1), z37.literal(7), z37.literal(28)])
   })
@@ -25699,7 +25711,7 @@ function validateAdSetPlacements(p, ctx) {
     ctx.addIssue({ code: "custom", path: ["targeting"], message: `${message} (${PLACEMENT_TARGETING_DOC})` });
   }
 }
-var adSetCreateSchema = z37.object(adSetFields).superRefine((p, ctx) => {
+var adSetCreateSchema = z37.strictObject(adSetFields).superRefine((p, ctx) => {
   validateAdSetBudgetAndBid(p, ctx);
   validateAdSetPromotedObject(p, ctx);
   validateAdvantageAudience(p, ctx);
@@ -25712,7 +25724,7 @@ var adSetCreateSchema = z37.object(adSetFields).superRefine((p, ctx) => {
     });
   }
 });
-var adSetUpdateSchema = z37.object({
+var adSetUpdateSchema = z37.strictObject({
   name: adSetFields.name.optional(),
   status: updateStatusSchema.optional(),
   dailyBudget: moneySchema2.optional(),
@@ -25742,7 +25754,7 @@ var adSetUpdateSchema = z37.object({
 var messageSchema = z37.string().min(1).max(META_LIMITS.creative.messageHardMax);
 var headlineSchema2 = z37.string().min(1).max(META_LIMITS.creative.headlineMax);
 var descriptionSchema = z37.string().min(1).max(META_LIMITS.creative.descriptionMax);
-var callToActionSchema = z37.object({
+var callToActionSchema = z37.strictObject({
   type: z37.enum(CTA_TYPES2),
   /** Overrides the base link for the CTA button; defaults to the ad's link. */
   link: httpsUrlSchema3.optional(),
@@ -25763,7 +25775,7 @@ var callToActionSchema = z37.object({
     });
   }
 });
-var creativeEnhancementsSchema = z37.object({
+var creativeEnhancementsSchema = z37.strictObject({
   standardEnhancements: z37.enum(ENROLL_STATUSES).optional(),
   features: z37.record(z37.string(), z37.enum(ENROLL_STATUSES)).optional()
 });
@@ -25794,7 +25806,7 @@ function countImageRefs(p) {
 function countVideoRefs(p) {
   return [p.videoId, p.videoRef].filter(Boolean).length;
 }
-var singleCreativeSchema = z37.object({
+var singleCreativeSchema = z37.strictObject({
   creativeType: z37.literal("single"),
   ...creativeSharedFields,
   /** Primary text. */
@@ -25828,7 +25840,7 @@ var singleCreativeSchema = z37.object({
     });
   }
 });
-var carouselCardSchema = z37.object({
+var carouselCardSchema = z37.strictObject({
   link: httpsUrlSchema3,
   headline: z37.string().max(META_LIMITS.creative.headlineMax).optional(),
   description: z37.string().max(META_LIMITS.creative.descriptionMax).optional(),
@@ -25851,7 +25863,7 @@ var carouselCardSchema = z37.object({
     ctx.addIssue({ code: "custom", path: ["videoId"], message: "each card is an image OR a video, not both" });
   }
 });
-var carouselCreativeSchema2 = z37.object({
+var carouselCreativeSchema2 = z37.strictObject({
   creativeType: z37.literal("carousel"),
   ...creativeSharedFields,
   message: messageSchema,
@@ -25873,19 +25885,19 @@ var carouselCreativeSchema2 = z37.object({
     });
   }
 });
-var dynamicImageSchema = z37.object({ ...imageMediaFields }).refine((p) => countImageRefs(p) === 1, "each dynamic image needs exactly one reference");
-var dynamicVideoSchema = z37.object({
+var dynamicImageSchema = z37.strictObject({ ...imageMediaFields }).refine((p) => countImageRefs(p) === 1, "each dynamic image needs exactly one reference");
+var dynamicVideoSchema = z37.strictObject({
   videoId: videoMediaFields.videoId,
   videoRef: videoMediaFields.videoRef,
   thumbnailHash: videoMediaFields.thumbnailHash
 }).refine((p) => countVideoRefs(p) === 1, "each dynamic video needs exactly one reference");
 var DYN = META_LIMITS.creative;
-var dynamicCreativeSchema = z37.object({
+var dynamicCreativeSchema = z37.strictObject({
   creativeType: z37.literal("dynamic"),
   ...creativeSharedFields,
-  bodies: z37.array(z37.object({ text: messageSchema })).min(DYN.dynamicTextsMin).max(DYN.dynamicTextsMax),
-  titles: z37.array(z37.object({ text: headlineSchema2 })).min(DYN.dynamicTextsMin).max(DYN.dynamicTextsMax),
-  descriptions: z37.array(z37.object({ text: descriptionSchema })).max(DYN.dynamicTextsMax).optional(),
+  bodies: z37.array(z37.strictObject({ text: messageSchema })).min(DYN.dynamicTextsMin).max(DYN.dynamicTextsMax),
+  titles: z37.array(z37.strictObject({ text: headlineSchema2 })).min(DYN.dynamicTextsMin).max(DYN.dynamicTextsMax),
+  descriptions: z37.array(z37.strictObject({ text: descriptionSchema })).max(DYN.dynamicTextsMax).optional(),
   images: z37.array(dynamicImageSchema).optional(),
   videos: z37.array(dynamicVideoSchema).optional(),
   /**
@@ -25901,7 +25913,7 @@ var dynamicCreativeSchema = z37.object({
    * different enums.
    */
   call_to_action: callToActionSchema.optional(),
-  link_urls: z37.array(z37.object({ website_url: httpsUrlSchema3, display_url: z37.string().optional() })).min(1),
+  link_urls: z37.array(z37.strictObject({ website_url: httpsUrlSchema3, display_url: z37.string().optional() })).min(1),
   /**
    * `asset_feed_spec.optimization_type` — passed through as a free string on
    * purpose. Meta's own 400 enumerates ten values and then accepts
@@ -25932,7 +25944,7 @@ var dynamicCreativeSchema = z37.object({
     });
   });
 });
-var existingPostCreativeSchema = z37.object({
+var existingPostCreativeSchema = z37.strictObject({
   creativeType: z37.literal("existing_post"),
   name: creativeSharedFields.name,
   /** "<page_id>_<post_id>" object story id of the post to promote. */
@@ -25941,7 +25953,7 @@ var existingPostCreativeSchema = z37.object({
   url_tags: creativeSharedFields.url_tags,
   enhancements: creativeSharedFields.enhancements
 });
-var specCreativeSchema = z37.object({
+var specCreativeSchema = z37.strictObject({
   creativeType: z37.literal("spec"),
   name: creativeSharedFields.name,
   url_tags: creativeSharedFields.url_tags,
@@ -25970,29 +25982,29 @@ var creativeContentSchema2 = z37.discriminatedUnion("creativeType", [
   specCreativeSchema
 ]);
 var adCreativeCreateSchema = creativeContentSchema2;
-var adCreativeUpdateSchema = z37.object({
+var adCreativeUpdateSchema = z37.strictObject({
   name: z37.string().max(META_LIMITS.creative.nameMax).optional(),
-  status: updateStatusSchema.optional(),
+  status: z37.enum(CREATIVE_UPDATE_STATUSES).optional(),
   /** Content patch — only honored when the target is a staged meta_temp_* creative. */
   content: z37.record(z37.string(), z37.unknown()).optional()
 }).refine((p) => Object.values(p).some((val) => val !== void 0), "update needs at least one field");
-var adCreateSchema2 = z37.object({
+var adCreateSchema2 = z37.strictObject({
   name: z37.string().min(1).max(META_LIMITS.ad.nameMax),
   adset_id: parentRefSchema3,
   status: stageableStatusSchema3.default("PAUSED"),
-  creative: z37.object({ creative_id: parentRefSchema3 }),
+  creative: z37.strictObject({ creative_id: parentRefSchema3 }),
   /** Conversion pixel / offline event set / view tags — structural passthrough. */
   tracking_specs: z37.array(z37.record(z37.string(), z37.unknown())).optional()
 });
-var adUpdateSchema2 = z37.object({
+var adUpdateSchema2 = z37.strictObject({
   name: z37.string().min(1).max(META_LIMITS.ad.nameMax).optional(),
   status: updateStatusSchema.optional(),
   /** Swapping the creative is the Meta way to "edit" an ad's creative. */
-  creative: z37.object({ creative_id: parentRefSchema3 }).optional(),
+  creative: z37.strictObject({ creative_id: parentRefSchema3 }).optional(),
   tracking_specs: z37.array(z37.record(z37.string(), z37.unknown())).optional()
 }).refine((p) => Object.values(p).some((val) => val !== void 0), "update needs at least one field");
-var lookalikeSpecSchema = z37.object({
-  origin: z37.array(z37.object({ id: parentRefSchema3 })).min(1),
+var lookalikeSpecSchema = z37.strictObject({
+  origin: z37.array(z37.strictObject({ id: parentRefSchema3 })).min(1),
   ratio: z37.number().min(0.01).max(0.2).optional(),
   country: z37.string().length(2).optional()
 });
@@ -26010,7 +26022,7 @@ function mixedEventSourceTypes(rule) {
   const distinct = [...new Set(types)].sort();
   return distinct.length > 1 ? distinct : [];
 }
-var customAudienceCreateSchema = z37.object({
+var customAudienceCreateSchema = z37.strictObject({
   name: z37.string().min(1).max(META_LIMITS.audience.nameMax),
   subtype: z37.enum(CUSTOM_AUDIENCE_SUBTYPES),
   description: z37.string().max(500).optional(),
@@ -26042,11 +26054,11 @@ var customAudienceCreateSchema = z37.object({
     });
   }
 });
-var customAudienceUpdateSchema = z37.object({
+var customAudienceUpdateSchema = z37.strictObject({
   name: z37.string().min(1).max(META_LIMITS.audience.nameMax).optional(),
   description: z37.string().max(500).optional()
 }).refine((p) => Object.values(p).some((val) => val !== void 0), "update needs at least one field");
-var customConversionCreateSchema = z37.object({
+var customConversionCreateSchema = z37.strictObject({
   name: z37.string().min(1).max(META_LIMITS.customConversion.nameMax),
   description: z37.string().max(META_LIMITS.customConversion.descriptionMax).optional(),
   /** The pixel the conversion counts from — `event_source_id` on the wire. Baker never creates pixels, so this is always a real id. */
@@ -26062,7 +26074,7 @@ var customConversionCreateSchema = z37.object({
     ctx.addIssue({ code: "custom", path: ["rule"], message: refusal });
   }
 });
-var mediaUploadSchema = z37.object({
+var mediaUploadSchema = z37.strictObject({
   kind: z37.enum(MEDIA_KINDS),
   bakerImageId: bakerMediaIdSchema2.optional(),
   bakerVideoId: bakerMediaIdSchema2.optional(),
@@ -26245,19 +26257,26 @@ function failWriteValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function loadJsonFileArg3(path48) {
-  if (typeof path48 !== "string" || path48.length === 0) {
+function refuseDeleteByUpdate(payload, group) {
+  if (payload.status === "DELETED") {
+    failWriteValidation3(
+      `update does not delete \u2014 deleting is permanent. Use \`baker ads meta ${group} delete <id>\` if the user asked to delete; otherwise pause or archive.`
+    );
+  }
+}
+function loadJsonFileArg3(path49) {
+  if (typeof path49 !== "string" || path49.length === 0) {
     return {};
   }
   try {
-    const parsed = JSON.parse(readFileSync9(path48, "utf8"));
+    const parsed = JSON.parse(readFileSync9(path49, "utf8"));
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failWriteValidation3(`${path48} must contain a JSON object`);
+      failWriteValidation3(`${path49} must contain a JSON object`);
     }
     return parsed;
   } catch (err) {
     if (err instanceof SyntaxError) {
-      failWriteValidation3(`${path48} is not valid JSON: ${err.message}`);
+      failWriteValidation3(`${path49} is not valid JSON: ${err.message}`);
     }
     throw err;
   }
@@ -26452,6 +26471,7 @@ Pass a meta_temp_* ref to amend a campaign staged in this chat. Example: baker a
       start_time: parseDateFlag2(args5.start, "--start"),
       stop_time: parseDateFlag2(args5.stop, "--stop")
     });
+    refuseDeleteByUpdate(payload, "campaigns");
     await stageOp2({
       kind: "campaign.update",
       accountId,
@@ -26612,6 +26632,7 @@ Example: baker ads meta adsets update 6123 --daily-budget 80`
       ...payload
     } = adSetPayloadFromFlags(args5);
     const merged = mergePayload3(loadJsonFileArg3(args5.file), payload);
+    refuseDeleteByUpdate(merged, "adsets");
     await stageOp2({
       kind: "adSet.update",
       accountId,
@@ -26805,6 +26826,7 @@ Example: baker ads meta ads update 6123 --creative meta_temp_cr02`
       status: upper(args5.status),
       creative: args5.creative ? { creative_id: String(args5.creative) } : void 0
     });
+    refuseDeleteByUpdate(payload, "ads");
     await stageOp2({
       kind: "ad.update",
       accountId,
@@ -26835,7 +26857,7 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
     const { apiPost: apiPost2 } = await import("./client-GR6YL3YX.js");
     const { requireChatId: requireChatId2 } = await import("./env-4P5HOGNA.js");
     const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-NMQXZF3Z.js");
-    const { handleMetaError: handleMetaError2 } = await import("./shared-VAA3SCQR.js");
+    const { handleMetaError: handleMetaError2 } = await import("./shared-J7DQZ2ED.js");
     try {
       const accountId = bareAccountId2(args5);
       const urlTags = typeof args5["url-tags"] === "string" ? args5["url-tags"] : void 0;
@@ -26950,10 +26972,16 @@ Example: baker ads meta media upload --kind image --image-id <bakerImageId>`
     });
   }
 });
+var STATUS_BY_COMMAND = { pause: "PAUSED", resume: "ACTIVE", archive: "ARCHIVED", delete: "DELETED" };
+var STATUS_COMMAND_NOTE = {
+  archive: "Archived stays readable in Ads Manager and can be found with --effective-status ARCHIVED.",
+  delete: "Deleting is permanent and cannot be undone \u2014 Meta removes it and everything under it. Prefer pause or archive unless the user asked to delete."
+};
 function statusCommand3(name, kind, label) {
-  const status = name === "pause" ? "PAUSED" : name === "resume" ? "ACTIVE" : "ARCHIVED";
+  const status = STATUS_BY_COMMAND[name];
+  const note = STATUS_COMMAND_NOTE[name];
   return defineCommand57({
-    meta: { name, description: `Stage ${name} for a ${label}. ${STAGED_NOTE2}` },
+    meta: { name, description: `Stage ${name} for a ${label}. ${note ? `${note} ` : ""}${STAGED_NOTE2}` },
     args: { id: { type: "positional", description: `${label} id`, required: true }, ...accountArgs2 },
     run: async ({ args: args5 }) => {
       const accountId = bareAccountId2(args5);
@@ -26983,7 +27011,7 @@ function duplicateCommand2(entity, label) {
       const { apiPost: apiPost2 } = await import("./client-GR6YL3YX.js");
       const { requireChatId: requireChatId2 } = await import("./env-4P5HOGNA.js");
       const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-NMQXZF3Z.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-VAA3SCQR.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-J7DQZ2ED.js");
       try {
         const accountId = bareAccountId2(args5);
         const chatId = requireChatId2();
@@ -27005,14 +27033,17 @@ function duplicateCommand2(entity, label) {
 var campaignsPauseCommand2 = statusCommand3("pause", "campaign.update", "campaign");
 var campaignsResumeCommand2 = statusCommand3("resume", "campaign.update", "campaign");
 var campaignsArchiveCommand2 = statusCommand3("archive", "campaign.update", "campaign");
+var campaignsDeleteCommand = statusCommand3("delete", "campaign.update", "campaign");
 var campaignsDuplicateCommand2 = duplicateCommand2("campaign", "campaign");
 var adSetsPauseCommand = statusCommand3("pause", "adSet.update", "ad set");
 var adSetsResumeCommand = statusCommand3("resume", "adSet.update", "ad set");
 var adSetsArchiveCommand = statusCommand3("archive", "adSet.update", "ad set");
+var adSetsDeleteCommand = statusCommand3("delete", "adSet.update", "ad set");
 var adSetsDuplicateCommand = duplicateCommand2("adSet", "ad set");
 var adsPauseCommand = statusCommand3("pause", "ad.update", "ad");
 var adsResumeCommand = statusCommand3("resume", "ad.update", "ad");
 var adsArchiveCommand = statusCommand3("archive", "ad.update", "ad");
+var adsDeleteCommand = statusCommand3("delete", "ad.update", "ad");
 var adsDuplicateCommand = duplicateCommand2("ad", "ad");
 
 // src/commands/ads/meta/ads.ts
@@ -27022,6 +27053,7 @@ var listArgs5 = {
   "campaign-id": { type: "string", description: "Filter to one campaign" },
   "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
   limit: { type: "string", description: "Max rows (default 1000)" },
   "no-cache": NO_CACHE_ARG,
   ...META_LIST_SHAPE_ARGS
@@ -27045,6 +27077,7 @@ var listCommand4 = defineCommand58({
       if (args5["adset-id"]) params["adset-id"] = args5["adset-id"];
       if (args5["campaign-id"]) params["campaign-id"] = args5["campaign-id"];
       if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args5["name-contains"]) params["name-contains"] = args5["name-contains"];
       if (args5.limit) params.limit = args5.limit;
       if (args5["no-cache"]) params["skip-cache"] = "true";
       const data = await apiGet("/api/ads/meta/ads", params);
@@ -27058,7 +27091,7 @@ var listCommand4 = defineCommand58({
 var adsListCommand = defineCommand58({
   meta: {
     name: "ads",
-    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/duplicate/retag).
+    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/retag).
 Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft.
 
 The dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.
@@ -27070,6 +27103,7 @@ preview_shareable_link); --full returns every field; --output json returns the r
 Examples:
   baker ads meta ads --account-id act_123
   baker ads meta ads --adset-id 6123
+  baker ads meta ads --account-id act_123 --all-statuses --name-contains octubre --fields id,name,adset_id,creative_id   \u2014 find one ad by name
   baker ads meta ads --adset-id 6123 --fields id,name,preview_shareable_link
   baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creative meta_temp_cr01
   baker ads meta ads pause 6123 --account-id act_123
@@ -27082,6 +27116,7 @@ Examples:
     pause: adsPauseCommand,
     resume: adsResumeCommand,
     archive: adsArchiveCommand,
+    delete: adsDeleteCommand,
     duplicate: adsDuplicateCommand,
     retag: adsRetagCommand
   },
@@ -27100,6 +27135,7 @@ var listArgs6 = {
   "campaign-id": { type: "string", description: "Filter to one campaign" },
   "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
   limit: { type: "string", description: "Max rows (default 1000)" },
   "no-cache": NO_CACHE_ARG,
   ...META_LIST_SHAPE_ARGS
@@ -27122,6 +27158,7 @@ var listCommand5 = defineCommand59({
       const params = { "account-id": accountId };
       if (args5["campaign-id"]) params["campaign-id"] = args5["campaign-id"];
       if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args5["name-contains"]) params["name-contains"] = args5["name-contains"];
       if (args5.limit) params.limit = args5.limit;
       if (args5["no-cache"]) params["skip-cache"] = "true";
       const data = await apiGet("/api/ads/meta/adsets", params);
@@ -27135,7 +27172,7 @@ var listCommand5 = defineCommand59({
 var adsetsCommand = defineCommand59({
   meta: {
     name: "adsets",
-    description: `List ad sets in a Meta ad account, or stage writes (create/update/pause/resume/archive/duplicate).
+    description: `List ad sets in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate).
 Defaults to ACTIVE only. Write subcommands stage ops on this chat's draft.
 
 Listings print a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event,
@@ -27145,6 +27182,7 @@ is not in the compact row \u2014 ask for it with --fields (dotted paths) or --fu
 Examples:
   baker ads meta adsets --account-id act_123
   baker ads meta adsets --campaign-id 6123456789
+  baker ads meta adsets --account-id act_123 --all-statuses --name-contains retargeting   \u2014 find one ad set by name
   baker ads meta adsets --campaign-id 6123456789 --fields id,name,targeting.geo_locations
   baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json`
   },
@@ -27155,6 +27193,7 @@ Examples:
     pause: adSetsPauseCommand,
     resume: adSetsResumeCommand,
     archive: adSetsArchiveCommand,
+    delete: adSetsDeleteCommand,
     duplicate: adSetsDuplicateCommand
   },
   // `args` stays even though the parent has no `run`: citty scans rawArgs for the
@@ -27257,6 +27296,7 @@ var listArgs8 = {
   "account-id": { type: "string", description: "Meta ad account ID" },
   "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
+  "name-contains": NAME_CONTAINS_ARG,
   limit: { type: "string", description: "Max rows (default 1000)" },
   "no-cache": NO_CACHE_ARG,
   ...META_LIST_SHAPE_ARGS
@@ -27278,6 +27318,7 @@ var listCommand7 = defineCommand62({
     try {
       const params = { "account-id": accountId };
       if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args5["name-contains"]) params["name-contains"] = args5["name-contains"];
       if (args5.limit) params.limit = args5.limit;
       if (args5["no-cache"]) params["skip-cache"] = "true";
       const data = await apiGet("/api/ads/meta/campaigns", params);
@@ -27291,7 +27332,7 @@ var listCommand7 = defineCommand62({
 var campaignsCommand3 = defineCommand62({
   meta: {
     name: "campaigns",
-    description: `List campaigns for a Meta ad account, or stage writes (create/update/pause/resume/archive/duplicate).
+    description: `List campaigns for a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate).
 Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft and
 apply only when the chat is published.
 
@@ -27305,6 +27346,7 @@ Listings print a table by default: id, name, effective_status, daily/lifetime bu
 Examples:
   baker ads meta campaigns --account-id act_123                                   # ACTIVE only
   baker ads meta campaigns --account-id act_123 --all-statuses                    # everything
+  baker ads meta campaigns --account-id act_123 --all-statuses --name-contains Q3               # find one by name
   baker ads meta campaigns --account-id act_123 --fields id,name,objective,bid_strategy,special_ad_categories
   baker ads meta campaigns --account-id act_123 --output json                     # rows as JSON
   baker ads meta campaigns create --account-id act_123 --name "Q3" --objective OUTCOME_LEADS --daily-budget 50
@@ -27317,6 +27359,7 @@ Examples:
     pause: campaignsPauseCommand2,
     resume: campaignsResumeCommand2,
     archive: campaignsArchiveCommand2,
+    delete: campaignsDeleteCommand,
     duplicate: campaignsDuplicateCommand2
   },
   // `args` stays even though the parent has no `run`: citty scans rawArgs for the
@@ -31929,12 +31972,12 @@ function flowExists(slug) {
   return existsSync3(join2(flowsDir(), slug, "_data.json"));
 }
 function readFlowTree(slug) {
-  const path48 = join2(flowsDir(), slug, "_data.json");
-  if (!existsSync3(path48)) {
+  const path49 = join2(flowsDir(), slug, "_data.json");
+  if (!existsSync3(path49)) {
     failLocal(`No form "${slug}". Run "baker flows list" to see the forms in this workspace.`);
   }
   try {
-    return JSON.parse(readFileSync11(path48, "utf-8"));
+    return JSON.parse(readFileSync11(path49, "utf-8"));
   } catch (error) {
     failLocal(`Could not read form "${slug}": ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -32894,12 +32937,12 @@ function readPeopleFile(args5) {
 }
 function unreadablePeopleFile(args5) {
   if (!args5["people-file"]) return void 0;
-  const path48 = String(args5["people-file"]);
+  const path49 = String(args5["people-file"]);
   try {
-    readFileSync12(path48, "utf8");
+    readFileSync12(path49, "utf8");
     return void 0;
   } catch {
-    return `Couldn't read --people-file ${path48}. Check the path, or pass the people inline with --person.`;
+    return `Couldn't read --people-file ${path49}. Check the path, or pass the people inline with --person.`;
   }
 }
 function peopleLimitError(args5) {
@@ -33871,11 +33914,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 path48 = eq === -1 ? "" : pair.slice(eq + 1).trim();
+    const path49 = eq === -1 ? "" : pair.slice(eq + 1).trim();
     const problem = mappingRowProblem(field);
     if (problem !== null) throw new ConversionArgsError(problem);
-    if (path48 === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
-    mapping[field] = path48;
+    if (path49 === "") throw new ConversionArgsError(`--field ${field} needs a path: --field ${field}=<dotted.path>.`);
+    mapping[field] = path49;
   }
   return mapping;
 }
@@ -35477,11 +35520,11 @@ function unwrap(response) {
   }
   return response.data;
 }
-async function readAvatars(path48, params) {
-  return unwrap(await apiGet(path48, params));
+async function readAvatars(path49, params) {
+  return unwrap(await apiGet(path49, params));
 }
-async function writeAvatars(path48, body) {
-  return unwrap(await apiPost(path48, body));
+async function writeAvatars(path49, body) {
+  return unwrap(await apiPost(path49, body));
 }
 
 // src/commands/avatars/create.ts
@@ -36390,12 +36433,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: path48, source } of sources) {
-    const dir = posix.dirname(path48);
+  for (const { path: path49, source } of sources) {
+    const dir = posix.dirname(path49);
     for (const face of declaredFontFaces(source)) {
       if (!wanted.has(face.family)) continue;
       const perFile = byFamily.get(face.family) ?? /* @__PURE__ */ new Map();
-      perFile.set(path48, [...perFile.get(path48) ?? [], rebaseFontFaceSrc(face.block, dir)]);
+      perFile.set(path49, [...perFile.get(path49) ?? [], rebaseFontFaceSrc(face.block, dir)]);
       byFamily.set(face.family, perFile);
     }
   }
@@ -49221,10 +49264,10 @@ function parseValueExpression(raw) {
   return parts.map(parsePart);
 }
 function trackingFieldIds() {
-  const path48 = join4(flowsDir(), "..", "tracking.ts");
-  if (!existsSync6(path48)) return null;
+  const path49 = join4(flowsDir(), "..", "tracking.ts");
+  if (!existsSync6(path49)) return null;
   try {
-    const source = readFileSync15(path48, "utf-8");
+    const source = readFileSync15(path49, "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]);
@@ -49798,13 +49841,13 @@ function specsFromFile(parsed) {
     return `${destField}${type}=${entry?.value ?? ""}`;
   });
 }
-function readSpecFile(path48) {
+function readSpecFile(path49) {
   let raw;
   try {
-    raw = path48 === "-" ? readFileSync16(0, "utf-8") : readFileSync16(path48, "utf-8");
+    raw = path49 === "-" ? readFileSync16(0, "utf-8") : readFileSync16(path49, "utf-8");
   } catch (error) {
     refuse(
-      `Could not read ${path48 === "-" ? "the mapping from stdin" : `"${path48}"`}: ${error instanceof Error ? error.message : String(error)}`
+      `Could not read ${path49 === "-" ? "the mapping from stdin" : `"${path49}"`}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   let parsed;
@@ -49812,7 +49855,7 @@ function readSpecFile(path48) {
     parsed = JSON.parse(raw);
   } catch (error) {
     refuse(
-      `${path48 === "-" ? "stdin" : `"${path48}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
+      `${path49 === "-" ? "stdin" : `"${path49}"`} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
       'Expected { "map": { "<destField>": "<value>", \u2026 } }'
     );
   }
@@ -50111,21 +50154,21 @@ var ARRAY_FIELDS = [
   "tagIds"
 ];
 var ARRAY_OWNERS = ["", "body"];
-function dropUnsetOptionals(sideEffect, path48) {
+function dropUnsetOptionals(sideEffect, path49) {
   return OPTIONAL_STRINGS.flatMap((key) => {
     if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
     delete sideEffect[key];
-    return [{ path: path48, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+    return [{ path: path49, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
   });
 }
-function fillNulledArrays(target2, prefix, path48) {
+function fillNulledArrays(target2, prefix, path49) {
   return ARRAY_FIELDS.flatMap((key) => {
     if (!(key in target2) || target2[key] !== null) return [];
     target2[key] = [];
-    return [{ path: path48, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+    return [{ path: path49, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
   });
 }
-function tidyEmailRecipients(sideEffect, path48) {
+function tidyEmailRecipients(sideEffect, path49) {
   if (sideEffect.type !== "email") return [];
   const config = sideEffect.encryptedConfig;
   if (!config || typeof config !== "object" || Array.isArray(config)) return [];
@@ -50136,7 +50179,7 @@ function tidyEmailRecipients(sideEffect, path48) {
   const tidied = to.join(", ");
   if (tidied === raw) return [];
   config.email = tidied;
-  return [{ path: path48, change: "tidied the recipient list's spacing and separators" }];
+  return [{ path: path49, change: "tidied the recipient list's spacing and separators" }];
 }
 function sideEffectsOf(node) {
   if (!Array.isArray(node.sideEffects)) return [];
@@ -50145,13 +50188,13 @@ function sideEffectsOf(node) {
   );
 }
 function normalizeSideEffect(sideEffect, where) {
-  const path48 = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const path49 = `${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}.` : "", path48);
+    return fillNulledArrays(target2, owner ? `${owner}.` : "", path49);
   });
-  return [...dropUnsetOptionals(sideEffect, path48), ...arrays, ...tidyEmailRecipients(sideEffect, path48)];
+  return [...dropUnsetOptionals(sideEffect, path49), ...arrays, ...tidyEmailRecipients(sideEffect, path49)];
 }
 function normalizeFlowTree(tree) {
   const changes = [];
@@ -51541,10 +51584,10 @@ async function stageOps(ops) {
     handleError5(err);
   }
 }
-async function draftAction2(path48, body, chat) {
+async function draftAction2(path49, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path48, { chatId, ...body });
+    const data = await apiPost(path49, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -54073,9 +54116,9 @@ async function readImageBuffer(pathOrUrl) {
   }
   return readFile28(pathOrUrl);
 }
-async function isDirectory(path48) {
+async function isDirectory(path49) {
   try {
-    const s = await stat7(path48);
+    const s = await stat7(path49);
     return s.isDirectory();
   } catch {
     return false;
@@ -54503,13 +54546,13 @@ function resolveDownloadPath({ baseName, extension, out, outIsDirectory: outIsDi
 }
 function disambiguate(paths) {
   const taken = /* @__PURE__ */ new Set();
-  return paths.map((path48) => {
-    if (!taken.has(path48)) {
-      taken.add(path48);
-      return path48;
+  return paths.map((path49) => {
+    if (!taken.has(path49)) {
+      taken.add(path49);
+      return path49;
     }
-    const ext = extname3(path48);
-    const stem = path48.slice(0, path48.length - ext.length);
+    const ext = extname3(path49);
+    const stem = path49.slice(0, path49.length - ext.length);
     let n = 2;
     while (taken.has(`${stem}-${n}${ext}`)) n += 1;
     const unique = `${stem}-${n}${ext}`;
@@ -54635,10 +54678,10 @@ async function runDownloads(plan) {
   const paths = disambiguate(fetched.map((item) => item.path));
   const downloaded = [];
   for (const [index, item] of fetched.entries()) {
-    const path48 = paths[index] ?? item.path;
+    const path49 = paths[index] ?? item.path;
     try {
-      await atomicWrite(path48, item.buffer);
-      downloaded.push({ input: item.input, output: path48, bytes: item.buffer.length, contentType: item.contentType });
+      await atomicWrite(path49, item.buffer);
+      downloaded.push({ input: item.input, output: path49, bytes: item.buffer.length, contentType: item.contentType });
     } catch (err) {
       failed.push({ input: item.input, error: failureMessage(err, "Write failed") });
     }
@@ -62825,11 +62868,353 @@ 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"]);
+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()
+});
+var mediaSourcesAddRequestSchema = z51.object({
+  /** A profile URL, 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 = off (sync on demand). */
+  every: mediaSourceRefreshIntervalSchema.optional()
+});
+var mediaSourceKeySchema = z51.string().trim().regex(/^(instagram|tiktok|youtube|linkedin|facebook):.+$/, "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 reportError2(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);
+}
+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 as a source for the image and video libraries \u2014 Instagram, TikTok, YouTube (videos only), LinkedIn company pages, Facebook pages. Its recent posts (up to a year back) are imported, described and made searchable; the import runs in the background. Applies immediately and shows on the chat as an already-applied change. Adding an account that is already connected is a no-op.",
+  args: {
+    input: {
+      type: "string",
+      description: "Profile URL (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 never \u2014 sync on demand)`,
+      required: false
+    }
+  }
+});
+var addCommand3 = defineCommand184({
+  meta: {
+    name: "add",
+    description: "Connect a social account (Instagram, TikTok, YouTube, LinkedIn page, Facebook page) as a media source. Start here with the profile URL.\n\nExamples:\n  baker media-sources add https://www.tiktok.com/@acme\n  baker media-sources add @acme --platform instagram --every weekly\n  baker media-sources add https://www.youtube.com/@acme"
+  },
+  args: {
+    input: { type: "positional", description: "Profile URL or @handle", required: true },
+    platform: {
+      type: "string",
+      description: "instagram|tiktok|youtube|linkedin|facebook \u2014 only for a bare handle",
+      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.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);
+    }
+  }
+});
+
+// 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 whose posts fill the image and video libraries: Instagram, TikTok, YouTube (videos), LinkedIn company pages, Facebook pages. Subcommands: add, list, sync, schedule, remove.
+
+Examples:
+  baker media-sources add https://www.tiktok.com/@acme
+  baker media-sources add @acme --platform instagram --every weekly
+  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 defineCommand196 } from "citty";
+import { defineCommand as defineCommand202 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand184 } from "citty";
+import { defineCommand as defineCommand190 } 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.';
@@ -63031,7 +63416,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand184({
+var advertisersCommand = defineCommand190({
   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).
@@ -63087,7 +63472,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand185 } from "citty";
+import { defineCommand as defineCommand191 } 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).",
@@ -63110,7 +63495,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand185({
+var autocompleteCommand = defineCommand191({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -63165,7 +63550,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand186 } from "citty";
+import { defineCommand as defineCommand192 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -63222,7 +63607,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand186({
+var countriesCommand = defineCommand192({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -63233,7 +63618,7 @@ var countriesCommand = defineCommand186({
 });
 
 // src/commands/research/fetch.ts
-import { defineCommand as defineCommand187 } from "citty";
+import { defineCommand as defineCommand193 } from "citty";
 var CONTENT_PREVIEW_CHARS = 2e4;
 var TIMEOUT_MS = 18e4;
 registerSchema({
@@ -63306,7 +63691,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 = defineCommand187({
+var fetchCommand = defineCommand193({
   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.
@@ -63383,7 +63768,7 @@ Examples:
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand188 } from "citty";
+import { defineCommand as defineCommand194 } 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.",
@@ -63406,7 +63791,7 @@ var FIELDS7 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand188({
+var intentCommand = defineCommand194({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -63454,7 +63839,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand189 } from "citty";
+import { defineCommand as defineCommand195 } 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.",
@@ -63483,7 +63868,7 @@ var FIELDS8 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand189({
+var keywordGapCommand = defineCommand195({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -63558,7 +63943,7 @@ Examples:
 });
 
 // src/commands/research/keyword-metrics.ts
-import { defineCommand as defineCommand190 } from "citty";
+import { defineCommand as defineCommand196 } from "citty";
 
 // src/commands/research/keyword-metrics-rows.ts
 var KEYWORD_METRICS_SOURCE = "keyword_planner_estimate_via_dataforseo";
@@ -63638,7 +64023,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
   }
 });
-var keywordMetricsCommand = defineCommand190({
+var keywordMetricsCommand = defineCommand196({
   meta: {
     name: "keyword-metrics",
     description: `Volume, CPC and competition for keywords you name. No domain required.
@@ -63720,7 +64105,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand191 } from "citty";
+import { defineCommand as defineCommand197 } 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.",
@@ -63753,7 +64138,7 @@ var FIELDS9 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand191({
+var keywordsForSiteCommand = defineCommand197({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -63815,7 +64200,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand192 } from "citty";
+import { defineCommand as defineCommand198 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -63845,7 +64230,7 @@ var FIELDS10 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand192({
+var languagesCommand2 = defineCommand198({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -63856,7 +64241,7 @@ var languagesCommand2 = defineCommand192({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand193 } from "citty";
+import { defineCommand as defineCommand199 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -63875,7 +64260,7 @@ var FIELDS11 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand193({
+var lighthouseCommand = defineCommand199({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -63913,7 +64298,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand194 } from "citty";
+import { defineCommand as defineCommand200 } 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).",
@@ -63939,7 +64324,7 @@ var FIELDS12 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand194({
+var relevantPagesCommand = defineCommand200({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -63986,7 +64371,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand195 } from "citty";
+import { defineCommand as defineCommand201 } 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).",
@@ -64037,7 +64422,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand195({
+var webCommand = defineCommand201({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -64099,7 +64484,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand196({
+var researchCommand = defineCommand202({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -64146,10 +64531,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-agents/index.ts
-import { defineCommand as defineCommand207 } from "citty";
+import { defineCommand as defineCommand213 } from "citty";
 
 // src/commands/scheduled-agents/create.ts
-import { defineCommand as defineCommand197 } from "citty";
+import { defineCommand as defineCommand203 } from "citty";
 
 // src/commands/scheduled-agents/shared.ts
 var TEMP_SCHEDULED_AGENT_PREFIX = "temp_agent_";
@@ -64516,7 +64901,7 @@ registerSchema({
     }
   }
 });
-var createCommand3 = defineCommand197({
+var createCommand3 = defineCommand203({
   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'
@@ -64573,7 +64958,7 @@ var createCommand3 = defineCommand197({
 });
 
 // src/commands/scheduled-agents/delete.ts
-import { defineCommand as defineCommand198 } from "citty";
+import { defineCommand as defineCommand204 } from "citty";
 registerSchema({
   command: "scheduled-agents.delete",
   description: "Stage deletion of a published scheduled agent, or cancel one this chat staged (temp_agent_*).",
@@ -64581,7 +64966,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true }
   }
 });
-var deleteCommand3 = defineCommand198({
+var deleteCommand3 = defineCommand204({
   meta: {
     name: "delete",
     description: "Stage a scheduled agent deletion. Example: baker scheduled-agents delete <id-or-temp_agent_id>"
@@ -64610,7 +64995,7 @@ var deleteCommand3 = defineCommand198({
 });
 
 // src/commands/scheduled-agents/get.ts
-import { defineCommand as defineCommand199 } from "citty";
+import { defineCommand as defineCommand205 } 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.",
@@ -64619,7 +65004,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var getCommand4 = defineCommand199({
+var getCommand4 = defineCommand205({
   meta: {
     name: "get",
     description: "Get a scheduled agent. Example: baker scheduled-agents get <id-or-temp_agent_id>"
@@ -64658,7 +65043,7 @@ var getCommand4 = defineCommand199({
 });
 
 // src/commands/scheduled-agents/list.ts
-import { defineCommand as defineCommand200 } from "citty";
+import { defineCommand as defineCommand206 } 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",
@@ -64668,7 +65053,7 @@ registerSchema({
     full: { type: "boolean", description: FULL_DESCRIPTION, required: false }
   }
 });
-var listCommand17 = defineCommand200({
+var listCommand18 = defineCommand206({
   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."
@@ -64694,7 +65079,7 @@ var listCommand17 = defineCommand200({
 });
 
 // src/commands/scheduled-agents/run.ts
-import { defineCommand as defineCommand201 } from "citty";
+import { defineCommand as defineCommand207 } 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.",
@@ -64702,7 +65087,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled agent ID", required: true }
   }
 });
-var runCommand2 = defineCommand201({
+var runCommand2 = defineCommand207({
   meta: {
     name: "run",
     description: "Run a published scheduled agent now. Example: baker scheduled-agents run <id>"
@@ -64734,7 +65119,7 @@ var runCommand2 = defineCommand201({
 });
 
 // src/commands/scheduled-agents/targets.ts
-import { defineCommand as defineCommand202 } from "citty";
+import { defineCommand as defineCommand208 } from "citty";
 var ARGS2 = {
   trigger: {
     type: "string",
@@ -64768,7 +65153,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 = defineCommand202({
+var targetsCommand = defineCommand208({
   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".
@@ -64811,7 +65196,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 defineCommand203 } from "citty";
+import { defineCommand as defineCommand209 } 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.",
@@ -64866,7 +65251,7 @@ registerSchema({
     }
   }
 });
-var templatesCommand = defineCommand203({
+var templatesCommand = defineCommand209({
   meta: {
     name: "templates",
     description: `The recipes this company can run \u2014 Baker's own plus theirs, with what each one produces.
@@ -64962,7 +65347,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 });
 
 // src/commands/scheduled-agents/triggers.ts
-import { defineCommand as defineCommand204 } from "citty";
+import { defineCommand as defineCommand210 } from "citty";
 var ARGS3 = {
   trigger: {
     type: "string",
@@ -65048,7 +65433,7 @@ function shapeTriggerCatalog(response, filter) {
   }
   return { ok: true, data: { groups, reacting: catalog.reacting } };
 }
-var triggersCommand2 = defineCommand204({
+var triggersCommand2 = defineCommand210({
   meta: {
     name: "triggers",
     description: `Everything that can start a scheduled agent.
@@ -65078,7 +65463,7 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 });
 
 // src/commands/scheduled-agents/unstage.ts
-import { defineCommand as defineCommand205 } from "citty";
+import { defineCommand as defineCommand211 } 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.",
@@ -65104,7 +65489,7 @@ function unstageBody(args5, chatId) {
   }
   return { chatId, ref: args5.ref, index };
 }
-var unstageCommand = defineCommand205({
+var unstageCommand = defineCommand211({
   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"
@@ -65135,7 +65520,7 @@ var unstageCommand = defineCommand205({
 });
 
 // src/commands/scheduled-agents/update.ts
-import { defineCommand as defineCommand206 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 registerSchema({
   command: "scheduled-agents.update",
   description: "Stage an update to a published scheduled agent, or to one this chat staged (temp_agent_*).",
@@ -65162,7 +65547,7 @@ registerSchema({
     enabled: { type: "string", description: "Replacement enabled state", required: false, enum: ["true", "false"] }
   }
 });
-var updateCommand4 = defineCommand206({
+var updateCommand4 = defineCommand212({
   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"
@@ -65233,7 +65618,7 @@ var updateCommand4 = defineCommand206({
 });
 
 // src/commands/scheduled-agents/index.ts
-var scheduledAgentsCommand = defineCommand207({
+var scheduledAgentsCommand = defineCommand213({
   meta: {
     name: "scheduled-agents",
     description: `Manage Scheduled agents. Subcommands: list, get, triggers, targets, create, update, delete, unstage, run, templates.
@@ -65262,7 +65647,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
   },
   subCommands: {
-    list: listCommand17,
+    list: listCommand18,
     get: getCommand4,
     triggers: triggersCommand2,
     targets: targetsCommand,
@@ -65276,14 +65661,14 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand208 } from "citty";
+import { defineCommand as defineCommand214 } 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 = defineCommand208({
+var schemaCommand2 = defineCommand214({
   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)"
@@ -65328,10 +65713,10 @@ var schemaCommand2 = defineCommand208({
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand217 } from "citty";
+import { defineCommand as defineCommand223 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand209 } from "citty";
+import { defineCommand as defineCommand215 } from "citty";
 
 // src/commands/studio/spokenPace.ts
 var WORDS_PER_SECOND3 = SPOKEN_WORDS_PER_SECOND;
@@ -65557,7 +65942,7 @@ function parseImageRefs(spec) {
 }
 var defaultDeps = {
   ingest: (url) => apiPost("/api/images/ingest", { url, source: "uploaded" }),
-  upload: (path48) => uploadLocalImage({ file: path48, contentType: detectImageContentType(path48), source: "uploaded" })
+  upload: (path49) => uploadLocalImage({ file: path49, contentType: detectImageContentType(path49), source: "uploaded" })
 };
 async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   const refs = parseImageRefs(spec);
@@ -65577,10 +65962,10 @@ async function resolveLibraryImageIds(spec, limit, deps = defaultDeps) {
   }
   return { imageIds, added };
 }
-function uploadFailure(path48) {
+function uploadFailure(path49) {
   return (error) => {
     if (error instanceof ApiError) throw error;
-    throw new ApiError("VALIDATION_ERROR", `Could not read "${path48}" as an image.`);
+    throw new ApiError("VALIDATION_ERROR", `Could not read "${path49}" as an image.`);
   };
 }
 
@@ -65844,7 +66229,7 @@ async function adByHandHintFor(body) {
     return null;
   }
 }
-var animateCommand = defineCommand209({
+var animateCommand = defineCommand215({
   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"
@@ -65969,7 +66354,7 @@ var animateCommand = defineCommand209({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand210 } from "citty";
+import { defineCommand as defineCommand216 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -66105,7 +66490,7 @@ function buildGenerateBody(args5, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand210({
+var generateCommand = defineCommand216({
   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]]'"
@@ -66188,7 +66573,7 @@ var generateCommand = defineCommand210({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand211 } from "citty";
+import { defineCommand as defineCommand217 } 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.",
@@ -66197,7 +66582,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand5 = defineCommand211({
+var getCommand5 = defineCommand217({
   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"
@@ -66226,7 +66611,7 @@ var getCommand5 = defineCommand211({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand212 } from "citty";
+import { defineCommand as defineCommand218 } 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",
@@ -66251,7 +66636,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand212({
+var improveCommand = defineCommand218({
   meta: {
     name: "improve",
     description: `${DESCRIPTION2}
@@ -66295,7 +66680,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand213 } from "citty";
+import { defineCommand as defineCommand219 } 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.",
@@ -66305,7 +66690,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand213({
+var keepCommand = defineCommand219({
   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"
@@ -66356,7 +66741,7 @@ var keepCommand = defineCommand213({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand214 } from "citty";
+import { defineCommand as defineCommand220 } 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.",
@@ -66367,7 +66752,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand18 = defineCommand214({
+var listCommand19 = defineCommand220({
   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"
@@ -66401,7 +66786,7 @@ var listCommand18 = defineCommand214({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand215 } from "citty";
+import { defineCommand as defineCommand221 } 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",
@@ -66488,7 +66873,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand215({
+var modelsCommand = defineCommand221({
   meta: {
     name: "models",
     description: `${DESCRIPTION3}
@@ -66535,13 +66920,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand216 } from "citty";
+import { defineCommand as defineCommand222 } 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 = defineCommand216({
+var skillsCommand = defineCommand222({
   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"
@@ -66565,7 +66950,7 @@ var skillsCommand = defineCommand216({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand217({
+var studioCommand = defineCommand223({
   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.
@@ -66599,7 +66984,7 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
     generate: generateCommand,
     animate: animateCommand,
     get: getCommand5,
-    list: listCommand18,
+    list: listCommand19,
     keep: keepCommand,
     models: modelsCommand,
     skills: skillsCommand,
@@ -66608,10 +66993,10 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand221 } from "citty";
+import { defineCommand as defineCommand227 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand218 } from "citty";
+import { defineCommand as defineCommand224 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync21 } from "fs";
@@ -66678,10 +67063,10 @@ async function stageOp4(op) {
     handleError8(err);
   }
 }
-async function draftAction3(path48, body, chat) {
+async function draftAction3(path49, body, chat) {
   const chatId = resolveChatId(chat);
   try {
-    const data = await apiPost(path48, { chatId, ...body });
+    const data = await apiPost(path49, { chatId, ...body });
     writeJsonEnvelope({ ok: true, data });
     return data;
   } catch (err) {
@@ -66734,13 +67119,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand5 = defineCommand218({
+var draftCommand5 = defineCommand224({
   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: defineCommand218({
+    list: defineCommand224({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -66753,7 +67138,7 @@ var draftCommand5 = defineCommand218({
         await draftList2(args5.json === true, args5.chat);
       }
     }),
-    show: defineCommand218({
+    show: defineCommand224({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -66770,7 +67155,7 @@ var draftCommand5 = defineCommand218({
         );
       }
     }),
-    amend: defineCommand218({
+    amend: defineCommand224({
       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."
@@ -66787,7 +67172,7 @@ var draftCommand5 = defineCommand218({
         });
       }
     }),
-    remove: defineCommand218({
+    remove: defineCommand224({
       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 }) => {
@@ -66796,7 +67181,7 @@ var draftCommand5 = defineCommand218({
         });
       }
     }),
-    clear: defineCommand218({
+    clear: defineCommand224({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -66806,7 +67191,7 @@ var draftCommand5 = defineCommand218({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand219 } from "citty";
+import { defineCommand as defineCommand225 } 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.",
@@ -66847,7 +67232,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand219({
+var containersCommand = defineCommand225({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -66864,7 +67249,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand219({
+var readCommand = defineCommand225({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -66906,7 +67291,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand220 } from "citty";
+import { defineCommand as defineCommand226 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -66962,10 +67347,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand220({
+  return defineCommand226({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand220({
+      create: defineCommand226({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -66987,7 +67372,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand220({
+      update: defineCommand226({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -67007,7 +67392,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand220({
+      delete: defineCommand226({
         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 },
@@ -67048,7 +67433,7 @@ function builtinTypes(args5) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand220({
+var builtinCommand = defineCommand226({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -67058,7 +67443,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand220({
+    enable: defineCommand226({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -67072,7 +67457,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand220({
+    disable: defineCommand226({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -67090,7 +67475,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand221({
+var tagManagerCommand = defineCommand227({
   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.
@@ -67127,7 +67512,7 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand222 } from "citty";
+import { defineCommand as defineCommand228 } from "citty";
 
 // src/commands/tags/shared.ts
 function failApi3(err) {
@@ -67207,7 +67592,7 @@ async function listTags(json) {
 var listArgs12 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand19 = defineCommand222({
+var listCommand20 = defineCommand228({
   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"
@@ -67226,7 +67611,7 @@ async function listDraft4(chat) {
     failApi3(err);
   }
 }
-var draftCommand6 = defineCommand222({
+var draftCommand6 = defineCommand228({
   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."
@@ -67236,7 +67621,7 @@ var draftCommand6 = defineCommand222({
     await listDraft4(args5.chat);
   }
 });
-var tagsCommand4 = defineCommand222({
+var tagsCommand4 = defineCommand228({
   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.
@@ -67253,7 +67638,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/tags.md`
   },
   subCommands: {
-    list: listCommand19,
+    list: listCommand20,
     draft: draftCommand6
   },
   // Bare `baker tags` lists the effective tags. `args` stays so citty knows this
@@ -67265,10 +67650,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand226 } from "citty";
+import { defineCommand as defineCommand232 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand223 } from "citty";
+import { defineCommand as defineCommand229 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -67276,7 +67661,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand6 = defineCommand223({
+var getCommand6 = defineCommand229({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -67313,7 +67698,7 @@ var getCommand6 = defineCommand223({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand224 } from "citty";
+import { defineCommand as defineCommand230 } from "citty";
 
 // src/commands/testimonials/emptyCorpusHints.ts
 function resolveEmptyReason({
@@ -67470,7 +67855,7 @@ function buildListParams(args5) {
   }
   return params;
 }
-var listCommand20 = defineCommand224({
+var listCommand21 = defineCommand230({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -67530,7 +67915,7 @@ var listCommand20 = defineCommand224({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand225 } from "citty";
+import { defineCommand as defineCommand231 } from "citty";
 var FILTER_FLAGS2 = ["source", "rating-min", "rating-max", "status", "sentiment", "language", "tags"];
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
@@ -67609,7 +67994,7 @@ function buildSearchRequest(query, args5) {
   }
   return body;
 }
-var searchCommand3 = defineCommand225({
+var searchCommand3 = defineCommand231({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -67673,7 +68058,7 @@ var searchCommand3 = defineCommand225({
 var tagsCommand5 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand226({
+var testimonialsCommand = defineCommand232({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -67689,16 +68074,16 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
   subCommands: {
     get: getCommand6,
     search: searchCommand3,
-    list: listCommand20,
+    list: listCommand21,
     tags: tagsCommand5
   }
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand234 } from "citty";
+import { defineCommand as defineCommand241 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand227 } from "citty";
+import { defineCommand as defineCommand233 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -67712,7 +68097,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand4 = defineCommand227({
+var deleteCommand4 = defineCommand233({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -67753,7 +68138,7 @@ var deleteCommand4 = defineCommand227({
 });
 
 // src/commands/videos/describe.ts
-import { defineCommand as defineCommand228 } from "citty";
+import { defineCommand as defineCommand234 } 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",
@@ -67770,7 +68155,7 @@ registerSchema({
     full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
   }
 });
-var describeCommand2 = defineCommand228({
+var describeCommand2 = defineCommand234({
   meta: {
     name: "describe",
     description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
@@ -67827,108 +68212,10 @@ Example: baker videos describe j571abc123 --description "Customer explaining how
   }
 });
 
-// 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";
+// src/commands/videos/fetch.ts
+import { mkdir as mkdir15 } from "fs/promises";
 import path47 from "path";
-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"
-  });
-}
+import { defineCommand as defineCommand235 } from "citty";
 
 // src/commands/videos/videoPlatforms.ts
 var PLATFORM_DOMAINS = {
@@ -67937,6 +68224,7 @@ 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"],
@@ -68041,6 +68329,181 @@ 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 }
+  }
+});
+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 }
+  },
+  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)
+      });
+      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",
@@ -68069,7 +68532,7 @@ registerSchema({
     "dry-run": { type: "boolean", description: "Preview the operation without executing", required: false }
   }
 });
-var ingestCommand2 = defineCommand231({
+var ingestCommand2 = defineCommand238({
   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"
@@ -68255,7 +68718,7 @@ function ingestUrl(args5) {
 }
 async function downloadThenIngest(args5, country) {
   const vimeoCookie = captureVimeoCookie();
-  const workDir = await mkdtemp3(path47.join(tmpdir4(), "videos-ingest-"));
+  const workDir = await mkdtemp3(path48.join(tmpdir4(), "videos-ingest-"));
   try {
     const probe = await probeYtDlp({ url: args5.url, country, vimeoCookie, cookieDir: workDir });
     if (isAudioOnly(probe.info)) {
@@ -68331,7 +68794,7 @@ async function uploadToAssetStore(filePath, sizeBytes) {
 }
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand232 } from "citty";
+import { defineCommand as defineCommand239 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -68341,7 +68804,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand232({
+var searchCommand4 = defineCommand239({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -68393,7 +68856,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 defineCommand233 } from "citty";
+import { defineCommand as defineCommand240 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -68435,7 +68898,7 @@ function detectContentType(filePath) {
 function isRemoteUrl3(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand2 = defineCommand233({
+var uploadCommand2 = defineCommand240({
   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"
@@ -68519,10 +68982,10 @@ var uploadCommand2 = defineCommand233({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand234({
+var videosCommand = defineCommand241({
   meta: {
     name: "videos",
-    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, describe, delete, tags.
+    description: `Find and manage videos in Baker. Subcommands: search, get, upload, ingest, fetch, describe, delete, tags.
 
 Examples:
   baker videos search "product demo" --limit 5
@@ -68530,6 +68993,7 @@ 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
@@ -68541,6 +69005,7 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
     search: searchCommand4,
     upload: uploadCommand2,
     ingest: ingestCommand2,
+    fetch: fetchCommand2,
     describe: describeCommand2,
     delete: deleteCommand4,
     tags: tagsCommand6
@@ -68548,10 +69013,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand247 } from "citty";
+import { defineCommand as defineCommand254 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand235 } from "citty";
+import { defineCommand as defineCommand242 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList3(value) {
@@ -68560,7 +69025,7 @@ function splitList3(value) {
   }
   return value.split(",").map((v) => v.trim()).filter(Boolean);
 }
-function reportError2(err) {
+function reportError3(err) {
   if (err instanceof ApiError) {
     writeJson({ ok: false, error: { code: err.code, message: err.message } });
     process.exit(1);
@@ -68604,7 +69069,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand235({
+var advertisersCommand2 = defineCommand242({
   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'
@@ -68656,13 +69121,13 @@ var advertisersCommand2 = defineCommand235({
         advertiserNormalizer
       );
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand236 } from "citty";
+import { defineCommand as defineCommand243 } 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.",
@@ -68708,7 +69173,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand236({
+var briefCommand = defineCommand243({
   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`
@@ -68738,13 +69203,13 @@ var briefCommand = defineCommand236({
       const data = await apiPost("/api/ad-library/brief", body);
       writeJson({ ok: true, data });
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand237 } from "citty";
+import { defineCommand as defineCommand244 } 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.",
@@ -68757,7 +69222,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand237({
+var contentCommand = defineCommand244({
   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"
@@ -68800,13 +69265,13 @@ var contentCommand = defineCommand237({
         adContentNormalizer
       );
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand238 } from "citty";
+import { defineCommand as defineCommand245 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList3(input.advertiser);
@@ -68858,7 +69323,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand2 = defineCommand238({
+var feedCommand2 = defineCommand245({
   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"
@@ -68937,13 +69402,13 @@ var feedCommand2 = defineCommand238({
 `);
       }
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand239 } from "citty";
+import { defineCommand as defineCommand246 } from "citty";
 var PLATFORMS = adLibraryPlatformSchema.options;
 registerSchema({
   command: "winning-ads.follow",
@@ -68958,7 +69423,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand239({
+var followCommand = defineCommand246({
   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'
@@ -68999,13 +69464,13 @@ var followCommand = defineCommand239({
       }
       writeJson({ ok: true, data, hints: hints2 });
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand240 } from "citty";
+import { defineCommand as defineCommand247 } from "citty";
 var PLATFORMS2 = adLibraryPlatformSchema.options;
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -69038,7 +69503,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand240({
+var followCompetitorsCommand = defineCommand247({
   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"'
@@ -69107,13 +69572,13 @@ var followCompetitorsCommand = defineCommand240({
       }
       writeJson({ ok: true, data, hints: hints2.length > 0 ? hints2 : void 0 });
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand241 } from "citty";
+import { defineCommand as defineCommand248 } 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.",
@@ -69167,7 +69632,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand241({
+var followingCommand = defineCommand248({
   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"
@@ -69197,13 +69662,13 @@ var followingCommand = defineCommand241({
         followingNormalizer
       );
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand242 } from "citty";
+import { defineCommand as defineCommand249 } 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.",
@@ -69242,7 +69707,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand242({
+var patternsCommand = defineCommand249({
   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"
@@ -69292,13 +69757,13 @@ var patternsCommand = defineCommand242({
         (record) => discriminatorRow(record)
       );
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand243 } from "citty";
+import { defineCommand as defineCommand250 } 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.",
@@ -69434,9 +69899,9 @@ function reportSearchError(err) {
     writeJson({ ok: false, error: { code: err.code, message: err.message, fix } });
     process.exit(1);
   }
-  reportError2(err);
+  reportError3(err);
 }
-var searchCommand5 = defineCommand243({
+var searchCommand5 = defineCommand250({
   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"
@@ -69556,7 +70021,7 @@ var searchCommand5 = defineCommand243({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand244 } from "citty";
+import { defineCommand as defineCommand251 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -69584,7 +70049,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand244({
+  return defineCommand251({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -69611,7 +70076,7 @@ function makeSeedCommand(opts) {
         }
         writeOutput({ ok: true, data: projected }, output);
       } catch (err) {
-        reportError2(err);
+        reportError3(err);
       }
     }
   });
@@ -69633,7 +70098,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand245 } from "citty";
+import { defineCommand as defineCommand252 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -69641,7 +70106,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand245({
+var unfollowCommand = defineCommand252({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -69656,13 +70121,13 @@ var unfollowCommand = defineCommand245({
       });
       writeJson({ ok: true, data });
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand246 } from "citty";
+import { defineCommand as defineCommand253 } 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.",
@@ -69672,7 +70137,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin|tiktok", required: false }
   }
 });
-var winnersCommand = defineCommand246({
+var winnersCommand = defineCommand253({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -69716,13 +70181,13 @@ var winnersCommand = defineCommand246({
         winningAdNormalizer
       );
     } catch (err) {
-      reportError2(err);
+      reportError3(err);
     }
   }
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand247({
+var winningAdsCommand = defineCommand254({
   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.
@@ -69794,7 +70259,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand248({
+var main = defineCommand255({
   meta: {
     name: "baker",
     version: getCliVersion(),
@@ -69834,6 +70299,7 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
     history: historyCommand2,
     hubspot: hubspotCommand,
     "winning-ads": winningAdsCommand,
+    "media-sources": mediaSourcesCommand,
     mcp: mcpCommand,
     schema: schemaCommand2
   }