@koda-sl/baker-cli 0.192.4 → 0.194.0-dev.5dba041c4

package/dist/cli.js

@@ -47,7 +47,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-ISZWNERZ.js";
+} from "./chunk-5YX3QOT3.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -90,7 +90,7 @@ import {
 } from "./chunk-YL3HDEIJ.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand209, runMain } from "citty";
+import { defineCommand as defineCommand213, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand18 } from "citty";
@@ -172,9 +172,9 @@ function compactImage(image) {
   };
 }
 function fullImage(image) {
-  const compact = compactImage(image);
+  const compact2 = compactImage(image);
   return {
-    ...compact,
+    ...compact2,
     width: image.width ?? null,
     height: image.height ?? null,
     aspectRatio: formatAspectRatio(image.aspectRatio),
@@ -248,9 +248,9 @@ function sceneLines(value) {
   });
 }
 function fullVideo(video) {
-  const compact = compactVideo(video);
+  const compact2 = compactVideo(video);
   return {
-    ...compact,
+    ...compact2,
     duration: video.duration ?? null,
     muxPlaybackId: String(video.muxPlaybackId ?? ""),
     source: String(video.source ?? ""),
@@ -291,9 +291,9 @@ function compactTestimonial(record) {
   };
 }
 function fullTestimonial(record) {
-  const compact = compactTestimonial(record);
+  const compact2 = compactTestimonial(record);
   return {
-    ...compact,
+    ...compact2,
     reviewText: String(record.reviewText ?? ""),
     highlight: record.highlight ?? null,
     summary: record.summary ?? null,
@@ -335,10 +335,10 @@ function compactWinningAd(record) {
   };
 }
 function fullWinningAd(record) {
-  const compact = compactWinningAd(record);
+  const compact2 = compactWinningAd(record);
   const dna = asRecord(record.dna);
   return {
-    ...compact,
+    ...compact2,
     winner_category: String(record.winner_category ?? ""),
     media_kind: record.media_kind ?? null,
     days_active: record.days_active ?? null,
@@ -4853,7 +4853,8 @@ var imageSourceSchema = z14.enum([
   "iconify",
   "giphy",
   "pinterest",
-  "ai_generated"
+  "ai_generated",
+  "layer_edit"
 ]);
 var imageStatusSchema = z14.enum(["uploading", "processing", "ready", "error"]);
 var upscaleConfigSchema = z14.object({
@@ -5152,6 +5153,51 @@ var imagesIngestResponseSchema = z14.object({
   deduped: z14.boolean(),
   contentHash: z14.string()
 });
+var imagesLayerizeRequestSchema = z14.object({
+  imageId: z14.string().min(1, "Missing image ID"),
+  /** Optional steer for what to separate; the model reads it as extraction instructions. */
+  instructions: z14.string().max(600).optional()
+});
+var imageLayerTextSchema = z14.object({
+  content: z14.string(),
+  fontFamily: z14.string(),
+  fontSize: z14.number(),
+  fontWeight: z14.number(),
+  color: z14.string(),
+  align: z14.enum(["left", "center", "right"]),
+  lineHeight: z14.number(),
+  letterSpacing: z14.number()
+});
+var imageLayerSchema = z14.object({
+  id: z14.string(),
+  /** `art` is a transparent cutout; `text` is live copy with its typography. */
+  kind: z14.enum(["art", "text"]),
+  name: z14.string(),
+  /** Art layers only: a permanent URL for the cutout, usable as a canvas input. */
+  url: z14.string().optional(),
+  x: z14.number(),
+  y: z14.number(),
+  width: z14.number(),
+  height: z14.number(),
+  visible: z14.boolean(),
+  opacity: z14.number(),
+  text: imageLayerTextSchema.optional()
+});
+var imagesLayersResponseSchema = z14.object({
+  layeredImageId: z14.string(),
+  imageId: z14.string(),
+  status: z14.enum(["splitting", "ready", "failed"]),
+  /** Product-language reason when `failed`; never a raw provider payload. */
+  error: z14.string().optional(),
+  /** The canvas the layers are measured in. The model may resize the source. */
+  width: z14.number(),
+  height: z14.number(),
+  /** Bottom to top. Empty until the split settles. */
+  layers: z14.array(imageLayerSchema),
+  /** Set once a flattened composition has been saved back to the library. */
+  savedImageId: z14.string().optional()
+});
+var imagesLayersRequestSchema = z14.object({ imageId: z14.string().min(1, "Missing image ID") });
 
 // ../api/src/studio.ts
 import { z as z15 } from "zod";
@@ -15687,6 +15733,74 @@ var IMAGE_HASH_REGEX = /^[A-Fa-f0-9]{16,}$/;
 
 // ../api/src/ads-meta/ops.ts
 import { z as z20 } from "zod";
+
+// ../api/src/ads-meta/placements.ts
+var FACEBOOK_POSITIONS_REQUIRING_FEED = ["marketplace", "search", "profile_feed", "notification"];
+var PLACEMENT_TARGETING_DOC = "https://developers.facebook.com/docs/marketing-api/audiences/reference/placement-targeting/";
+var CONSTRAINED_PLACEMENTS = [
+  {
+    position: "facebook_reels_overlay",
+    platform: "facebook",
+    kind: "constraint",
+    note: "Ads on Facebook Reels take two shapes and a stock 9:16 video fits neither: overlay ads are 'a single, static image ad' (JPG/PNG, 1:1, 0% ratio tolerance, headline capped at 10 characters), and post-loop ads are 1:1 video of 4-15 seconds. Expect a long-headline 9:16 creative to look wrong here.",
+    contested: false,
+    source: "https://www.facebook.com/business/ads-guide/update/image/facebook-facebook-reels-overlay"
+  },
+  {
+    position: "explore_home",
+    platform: "instagram",
+    kind: "constraint",
+    note: "Marketing API placement asset customization states 'The explore_home placement only supports the SINGLE_IMAGE format', but Meta's own Ads Guide lists Instagram Explore home under video specs. Check the account's play rate for this position before treating it as image-only.",
+    contested: true,
+    source: "https://developers.facebook.com/docs/marketing-api/dynamic-creative/placement-asset-customization/"
+  },
+  {
+    position: "right_hand_column",
+    platform: "facebook",
+    kind: "correction",
+    note: "Facebook right column publishes full video specs (MP4/MOV/GIF, 1:1 at 1440x1440 or mobile-only 4:5 at 1440x1800, 1 second to 241 minutes) \u2014 it is NOT image-only. Its real constraint is that it cannot be the only placement for a video, collection, or canvas ad.",
+    contested: false,
+    source: "https://www.facebook.com/business/ads-guide/update/video/facebook-right-hand-column"
+  }
+];
+var FACEBOOK_PREVIEW_FORMATS = {
+  feed: "MOBILE_FEED_STANDARD",
+  right_hand_column: "RIGHT_COLUMN_STANDARD",
+  marketplace: "MARKETPLACE_MOBILE",
+  story: "FACEBOOK_STORY_MOBILE",
+  facebook_reels: "FACEBOOK_REELS_MOBILE",
+  facebook_reels_overlay: "FACEBOOK_REELS_BANNER",
+  instream_video: "INSTREAM_VIDEO_MOBILE",
+  video_feeds: "INSTREAM_VIDEO_MOBILE"
+};
+var INSTAGRAM_PREVIEW_FORMATS = {
+  stream: "INSTAGRAM_STANDARD",
+  story: "INSTAGRAM_STORY",
+  reels: "INSTAGRAM_REELS",
+  explore: "INSTAGRAM_EXPLORE_CONTEXTUAL",
+  explore_home: "INSTAGRAM_EXPLORE_GRID_HOME",
+  ig_search: "INSTAGRAM_SEARCH_CHAIN",
+  profile_feed: "INSTAGRAM_PROFILE_FEED"
+};
+var PLATFORM_SCOPED_POSITIONS = /* @__PURE__ */ new Set(["story", "profile_feed"]);
+function previewFormatForPosition(position, platform) {
+  if (platform === "facebook") return FACEBOOK_PREVIEW_FORMATS[position];
+  if (platform === "instagram") return INSTAGRAM_PREVIEW_FORMATS[position];
+  if (PLATFORM_SCOPED_POSITIONS.has(position)) return void 0;
+  return FACEBOOK_PREVIEW_FORMATS[position] ?? INSTAGRAM_PREVIEW_FORMATS[position];
+}
+function placementFormatNote(position) {
+  return CONSTRAINED_PLACEMENTS.find((p) => p.position === position);
+}
+function positionsMissingRequiredFeed(targeting) {
+  const positions = targeting?.facebook_positions;
+  if (!positions?.length || positions.includes("feed")) {
+    return [];
+  }
+  return FACEBOOK_POSITIONS_REQUIRING_FEED.filter((required) => positions.includes(required));
+}
+
+// ../api/src/ads-meta/ops.ts
 var tempRefSchema3 = z20.string().regex(TEMP_REF_REGEX3, "expected a meta_temp_* reference");
 var parentRefSchema2 = z20.union([z20.string().regex(NUMERIC_ID_REGEX3, "expected a numeric id"), tempRefSchema3]);
 var moneySchema2 = z20.object({
@@ -15957,10 +16071,21 @@ function validateAdvantageAudience(p, ctx) {
     });
   }
 }
+function validateAdSetPlacements(p, ctx) {
+  const missingFeed = positionsMissingRequiredFeed(p.targeting);
+  if (missingFeed.length > 0) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["targeting", "facebook_positions"],
+      message: `Meta requires "feed" alongside ${missingFeed.join(", ")} \u2014 add "feed" to facebook_positions or drop those positions (${PLACEMENT_TARGETING_DOC})`
+    });
+  }
+}
 var adSetCreateSchema = z20.object(adSetFields).superRefine((p, ctx) => {
   validateAdSetBudgetAndBid(p, ctx);
   validateAdSetPromotedObject(p, ctx);
   validateAdvantageAudience(p, ctx);
+  validateAdSetPlacements(p, ctx);
   if (!targetingHasGeoOrAudience(p.targeting)) {
     ctx.addIssue({
       code: "custom",
@@ -15994,6 +16119,7 @@ var adSetUpdateSchema = z20.object({
     validateAdSetPromotedObject(p, ctx);
   }
   validateAdvantageAudience(p, ctx);
+  validateAdSetPlacements(p, ctx);
 });
 var messageSchema = z20.string().min(1).max(META_LIMITS.creative.messageHardMax);
 var headlineSchema2 = z20.string().min(1).max(META_LIMITS.creative.headlineMax);
@@ -17398,6 +17524,74 @@ var metaDraftCommand = defineCommand62({
 // src/commands/ads/meta/insights.ts
 import { defineCommand as defineCommand63 } from "citty";
 
+// src/commands/ads/meta/placement-delivery.ts
+var MIN_IMPRESSIONS = 100;
+var SILENT_PLAY_RATE = 0.02;
+var PLAYING_REFERENCE_RATE = 0.5;
+function toNumber(value) {
+  const n = Number(value);
+  return Number.isFinite(n) ? n : 0;
+}
+function sumActionValues(value) {
+  if (!Array.isArray(value)) return 0;
+  return value.reduce((total, entry) => {
+    const item = entry;
+    return total + toNumber(item?.value);
+  }, 0);
+}
+function aggregate(rows) {
+  const byPlacement = /* @__PURE__ */ new Map();
+  let totalImpressions = 0;
+  for (const row of rows) {
+    const position = row.platform_position;
+    if (typeof position !== "string" || position.length === 0) continue;
+    const platform = typeof row.publisher_platform === "string" ? row.publisher_platform : "";
+    const impressions = toNumber(row.impressions);
+    totalImpressions += impressions;
+    const key = `${platform}/${position}`;
+    const current = byPlacement.get(key) ?? { platform, position, impressions: 0, plays: 0, playRate: 0, share: 0 };
+    current.impressions += impressions;
+    current.plays += sumActionValues(row.video_play_actions);
+    byPlacement.set(key, current);
+  }
+  return [...byPlacement.values()].map((placement) => ({
+    ...placement,
+    playRate: placement.impressions > 0 ? placement.plays / placement.impressions : 0,
+    share: totalImpressions > 0 ? placement.impressions / totalImpressions : 0
+  }));
+}
+function previewCommand(placement) {
+  const format = previewFormatForPosition(placement.position, placement.platform);
+  return format ? `\`baker ads meta preview --creative-id <id> --placement ${placement.position} --platform ${placement.platform}\`` : `no preview format is known for ${placement.position}, so Meta's renderer cannot confirm it \u2014 say the placement is unverified rather than filling the gap`;
+}
+function isSingleAdQuery(rows) {
+  const adIds = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    if (typeof row.ad_id !== "string" || row.ad_id.length === 0) return false;
+    adIds.add(row.ad_id);
+  }
+  return adIds.size === 1;
+}
+function placementDeliveryHints(rows) {
+  const carriesVideoMetrics = rows.some((row) => Array.isArray(row.video_play_actions));
+  if (!carriesVideoMetrics || !isSingleAdQuery(rows)) return [];
+  const placements = aggregate(rows);
+  const plays = placements.some((p) => p.impressions >= MIN_IMPRESSIONS && p.playRate >= PLAYING_REFERENCE_RATE);
+  if (!plays) return [];
+  const silent = placements.filter((p) => p.impressions >= MIN_IMPRESSIONS && p.playRate < SILENT_PLAY_RATE).sort((a, b) => b.impressions - a.impressions);
+  if (silent.length === 0) return [];
+  const hints = silent.map((placement) => {
+    const note = placementFormatNote(placement.position);
+    const documented = note ? ` Meta documents this placement: ${note.note}` : "";
+    return `${placement.platform}/${placement.position} delivered ${placement.impressions.toLocaleString("en-US")} impressions (${(placement.share * 100).toFixed(1)}% of the total) and ${placement.plays.toLocaleString("en-US")} video plays \u2014 it may not be rendering the video. This is account evidence, not a rule: confirm what Meta renders there with ${previewCommand(placement)} before you say anything about it.${documented}`;
+  });
+  const combinedShare = silent.reduce((total, placement) => total + placement.share, 0) * 100;
+  hints.push(
+    `Those placements are ${combinedShare.toFixed(1)}% of delivery in this query. State that share before proposing to remove them \u2014 and note that removing placements from a live ad set is a targeting change, which Meta counts as a significant edit that re-enters the learning phase.`
+  );
+  return hints;
+}
+
 // src/commands/ads/meta/presets.ts
 var INSIGHTS_INTENTS = {
   baseline: {
@@ -17694,6 +17888,11 @@ Async is automatic for heavy queries; pass --async to force it, or --no-async to
         writeAdsOutput(sorted, fmt, body.fields);
         return;
       }
+      const hints = placementDeliveryHints(sorted);
+      if (hints.length > 0) {
+        writeJsonEnvelope({ ok: true, data: sorted, hints });
+        return;
+      }
       writeAdsJson({ ok: true, data: sorted });
     } catch (err) {
       handleMetaError(err);
@@ -17863,6 +18062,7 @@ var VALID_AD_FORMATS = [
   "INSTAGRAM_STANDARD",
   "INSTAGRAM_EXPLORE_CONTEXTUAL",
   "INSTAGRAM_EXPLORE_GRID_HOME",
+  "INSTAGRAM_SEARCH_CHAIN",
   "INSTAGRAM_SHOP",
   "INSTAGRAM_PROFILE_FEED",
   "INSTREAM_VIDEO_DESKTOP",
@@ -17878,14 +18078,47 @@ var VALID_AD_FORMATS = [
   "MARKETPLACE_MOBILE",
   "BIZ_DISCO_FEED_MOBILE"
 ];
-var previewCommand = defineCommand67({
+function failPreviewValidation(message) {
+  writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function resolvePlacement(position, platform) {
+  const platformArg = typeof platform === "string" ? platform.toLowerCase() : void 0;
+  if (platformArg && platformArg !== "facebook" && platformArg !== "instagram") {
+    failPreviewValidation("--platform must be facebook or instagram");
+  }
+  const format = previewFormatForPosition(position, platformArg);
+  if (format) {
+    return format;
+  }
+  if (PLATFORM_SCOPED_POSITIONS.has(position) && !platformArg) {
+    failPreviewValidation(
+      `--placement ${position} names a different surface on Facebook and on Instagram \u2014 add --platform facebook or --platform instagram`
+    );
+  }
+  failPreviewValidation(
+    `No Meta preview format is published for placement "${position}". Meta does not document one for every placement (Facebook notifications and profile feed, Instagram search among them), so this placement cannot be previewed \u2014 report it as unverified rather than inferring what it renders. Previewable placements: ${listPlacements()}`
+  );
+}
+function listPlacements() {
+  const facebook = Object.keys(FACEBOOK_PREVIEW_FORMATS).join(", ");
+  const instagram = Object.keys(INSTAGRAM_PREVIEW_FORMATS).join(", ");
+  return `facebook \u2014 ${facebook}; instagram \u2014 ${instagram}`;
+}
+var previewCommand2 = defineCommand67({
   meta: {
     name: "preview",
     description: `Generate a Meta-hosted preview iframe for a creative or ad. Returns iframe HTML which you
 can embed or save to a file. The iframe URL contains a short-lived access token \u2014 treat as secret.
 
+Start here when you need to know what a creative looks like in one specific placement \u2014 this is
+Meta's own renderer, so it settles "does my video show as a still image there?" without guessing.
+Pass the placement straight from an insights breakdown with --placement (a platform_position value),
+or a Meta ad_format with --ad-format. Run --list-formats to see both sets.
+
 Examples:
   baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD
+  baker ads meta preview --creative-id 6123 --placement facebook_reels_overlay --platform facebook
   baker ads meta preview --ad-id 9988 --ad-format INSTAGRAM_REELS --out-file /tmp/preview.html
   baker ads meta preview --account-id act_123 --creative '{"object_story_spec":{...}}' --ad-format MOBILE_FEED_STANDARD`
   },
@@ -17894,14 +18127,36 @@ Examples:
     "ad-id": { type: "string", description: "Existing ad ID" },
     "account-id": { type: "string", description: "Required when previewing an unpublished --creative spec" },
     creative: { type: "string", description: "JSON spec of an unpublished creative (e.g. object_story_spec)" },
-    "ad-format": { type: "string", description: "Meta ad_format enum value", required: true },
+    "ad-format": { type: "string", description: "Meta ad_format enum value (--list-formats to see them)" },
+    placement: {
+      type: "string",
+      description: "platform_position from an insights breakdown (e.g. facebook_reels_overlay) \u2014 resolved to an ad_format"
+    },
+    platform: { type: "string", description: "facebook|instagram \u2014 disambiguates --placement story / profile_feed" },
+    "list-formats": { type: "boolean", description: "Print the ad_format values and placement mappings, then exit" },
     "out-file": { type: "string", description: "Save iframe HTML to this path" },
     "skip-cache": { type: "boolean", description: "Bypass server-side cache" }
   },
   run: async ({ args }) => {
-    const adFormat = args["ad-format"];
+    if (args["list-formats"]) {
+      writeAdsJson({
+        ok: true,
+        data: {
+          adFormats: VALID_AD_FORMATS,
+          placements: { facebook: FACEBOOK_PREVIEW_FORMATS, instagram: INSTAGRAM_PREVIEW_FORMATS }
+        }
+      });
+      return;
+    }
+    const placement = args.placement;
+    const adFormat = placement ? resolvePlacement(placement, args.platform) : args["ad-format"];
+    if (!adFormat) {
+      failPreviewValidation("pass --ad-format or --placement (see --list-formats)");
+    }
     if (!VALID_AD_FORMATS.includes(adFormat)) {
-      handleMetaError(new Error(`Invalid --ad-format "${adFormat}". Run with --help to see supported values.`));
+      failPreviewValidation(
+        `Invalid --ad-format "${adFormat}". Meta publishes no complete ad_format enum, so this is the set we know: ${VALID_AD_FORMATS.join(", ")}. To preview a placement you saw in an insights breakdown, pass --placement <platform_position> instead of guessing a format name.`
+      );
     }
     const body = { adFormat };
     if (args["creative-id"]) body.creativeId = args["creative-id"];
@@ -17912,12 +18167,16 @@ Examples:
     try {
       const data = await apiPost("/api/ads/meta/preview", body);
       const html = data.map((d) => d.body).join("\n");
+      const hints = placement ? [
+        `Rendered ${placement} as ad_format ${adFormat}. Open the iframe to SEE it \u2014 Meta does not document what it renders for a creative a placement cannot take, so a preview you looked at is the evidence, and anything you did not look at stays unverified.`
+      ] : [];
       if (args["out-file"]) {
+        const summary = { ok: true, data: { file: args["out-file"], rows: data.length, adFormat } };
         writeFileSync2(args["out-file"], html, "utf-8");
-        writeAdsJson({ ok: true, data: { file: args["out-file"], rows: data.length } });
+        writeJsonEnvelope(hints.length > 0 ? { ...summary, hints } : summary);
         return;
       }
-      writeAdsJson({ ok: true, data });
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
     } catch (err) {
       handleMetaError(err);
     }
@@ -17975,7 +18234,7 @@ Full guide: __tooling__/docs/tools/baker/ads-meta.md`
     pixels: pixelsCommand,
     activities: activitiesCommand,
     insights: insightsCommand,
-    preview: previewCommand,
+    preview: previewCommand2,
     media: metaMediaCommand,
     draft: metaDraftCommand
   }
@@ -19489,13 +19748,127 @@ Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedi
   }
 });
 
-// src/commands/brand/index.ts
+// src/commands/agents/index.ts
+import { defineCommand as defineCommand89 } from "citty";
+
+// src/commands/agents/list.ts
+import { defineCommand as defineCommand87 } from "citty";
+
+// src/commands/agents/shared.ts
+function failValidation2(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function failApi2(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  const message = err instanceof Error ? err.message : "Unexpected error";
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message } });
+  process.exit(1);
+}
+
+// src/commands/agents/list.ts
+registerSchema({
+  command: "agents.list",
+  description: "The Baker agents that exist, with what each one does. Start here before recommending one, so you name a real teammate rather than inventing one.",
+  args: {}
+});
+var listCommand10 = defineCommand87({
+  meta: {
+    name: "list",
+    description: "List the Baker agents and what each does. Example: baker agents list"
+  },
+  run: async () => {
+    try {
+      const response = await apiPost(
+        "/api/official-agents/list",
+        {}
+      );
+      writeJson(response);
+    } catch (err) {
+      failApi2(err);
+    }
+  }
+});
+
+// src/commands/agents/recommend.ts
 import { defineCommand as defineCommand88 } from "citty";
+registerSchema({
+  command: "agents.recommend",
+  description: "Suggest the company switch on another Baker agent, because the work you just found belongs to it. Does not block or wait \u2014 it records the suggestion on that agent's card in Tasks and your run carries on. Calling it again refreshes the same suggestion instead of stacking another, and a suggestion the company dismissed stays dismissed. Start here: baker agents list.",
+  args: {
+    agent: { type: "string", description: "Agent id to recommend, from `baker agents list`", required: true },
+    from: { type: "string", description: "Your own agent id \u2014 who is making the suggestion", required: true },
+    reason: {
+      type: "string",
+      description: "Why, in the company's own terms, naming what you found. Shown verbatim next to the switch, so write it for a marketer, not for us.",
+      required: true
+    }
+  }
+});
+var recommendCommand = defineCommand88({
+  meta: {
+    name: "recommend",
+    description: 'Suggest switching on another Baker agent. Example: baker agents recommend --agent baker-cro --from baker-analytics-reporter --reason "Your quote page gets the most traffic and converts the worst; Baker CRO is the one that fixes that."'
+  },
+  args: {
+    agent: { type: "string", description: "Agent id to recommend", required: false },
+    from: { type: "string", description: "Your own agent id", required: false },
+    reason: { type: "string", description: "Why, in the company's terms", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const agent = args.agent;
+      const from = args.from;
+      const reason = args.reason;
+      if (!agent || !from || !reason) {
+        failValidation2("--agent, --from and --reason are all required.");
+      }
+      if (agent === from) {
+        failValidation2("An agent cannot recommend itself.");
+      }
+      const env = getEnv();
+      const response = await apiPost("/api/official-agents/recommend", {
+        agentId: agent,
+        fromAgentId: from,
+        reason,
+        ...env.BAKER_CHAT_ID ? { chatId: env.BAKER_CHAT_ID } : {}
+      });
+      writeJson(response);
+    } catch (err) {
+      failApi2(err);
+    }
+  }
+});
+
+// src/commands/agents/index.ts
+var agentsCommand = defineCommand89({
+  meta: {
+    name: "agents",
+    description: `The other Baker agents, and how to ask for one. Subcommands: list, recommend.
+
+Use this when the work in front of you belongs to a different agent than the one you are. Recommending does not block your run \u2014 it leaves the suggestion on that agent's card in Tasks, next to the switch that turns it on.
+
+Examples:
+  baker agents list
+  baker agents recommend --agent baker-cro --from baker-analytics-reporter --reason "Your quote page gets the most traffic and converts the worst."
+Full guide: __tooling__/docs/tools/baker/agents.md`
+  },
+  subCommands: {
+    list: listCommand10,
+    recommend: recommendCommand
+  }
+});
+
+// src/commands/brand/index.ts
+import { defineCommand as defineCommand91 } from "citty";
 
 // src/commands/brand/fonts.ts
 import { mkdir, readFile, writeFile } from "fs/promises";
 import path from "path";
-import { defineCommand as defineCommand87 } from "citty";
+import { defineCommand as defineCommand90 } from "citty";
 
 // src/engine/brand/fonts.ts
 var GOOGLE_CSS2 = "https://fonts.googleapis.com/css2";
@@ -19667,7 +20040,7 @@ async function readGlobalCss() {
     return "";
   }
 }
-var fontsCheckCommand = defineCommand87({
+var fontsCheckCommand = defineCommand90({
   meta: {
     name: "check",
     description: "Verify the brand's fonts really exist. For every family/weight src/styles/global.css requests from Google Fonts, ask Google what it actually serves and report anything missing \u2014 a weight nobody serves renders as a synthesized fallback and looks off-brand everywhere."
@@ -19711,7 +20084,7 @@ var fontsCheckCommand = defineCommand87({
     });
   }
 });
-var fontsFetchCommand = defineCommand87({
+var fontsFetchCommand = defineCommand90({
   meta: {
     name: "fetch",
     description: "Download a Google font into src/brand/fonts/ and print the @font-face block to paste above @theme in src/styles/global.css. Use when a brand font should be self-hosted rather than requested from Google on every page load."
@@ -19793,7 +20166,7 @@ var fontsFetchCommand = defineCommand87({
     });
   }
 });
-var fontsCommand = defineCommand87({
+var fontsCommand = defineCommand90({
   meta: {
     name: "fonts",
     description: `Verify and self-host the brand's typefaces.
@@ -19811,7 +20184,7 @@ Subcommands:
 });
 
 // src/commands/brand/index.ts
-var brandCommand = defineCommand88({
+var brandCommand = defineCommand91({
   meta: {
     name: "brand",
     description: `Brand asset verification for src/brand/.
@@ -19827,11 +20200,11 @@ Subcommands:
 });
 
 // src/commands/canvas/index.ts
-import { defineCommand as defineCommand99 } from "citty";
+import { defineCommand as defineCommand102 } from "citty";
 
 // src/commands/canvas/catalog.ts
-import { defineCommand as defineCommand89 } from "citty";
-var catalogCommand = defineCommand89({
+import { defineCommand as defineCommand92 } from "citty";
+var catalogCommand = defineCommand92({
   meta: {
     name: "catalog",
     description: "Print the agent-facing node catalog (JSON Schema). Includes every registered node grouped by category."
@@ -19846,7 +20219,7 @@ var catalogCommand = defineCommand89({
 // src/commands/canvas/critique.ts
 import { readFile as readFile2 } from "fs/promises";
 import path2 from "path";
-import { defineCommand as defineCommand90 } from "citty";
+import { defineCommand as defineCommand93 } from "citty";
 
 // src/engine/scaffold/lib/critique.ts
 var VIBE_CUE = /\b(light|lighting|golden|moody|warm|cool|tone|grade|contrast|shadow|glow|rim|backlit|neon|soft)\b/i;
@@ -19966,7 +20339,7 @@ function critiqueCanvas(canvas) {
 }
 
 // src/commands/canvas/critique.ts
-var critiqueCommand = defineCommand90({
+var critiqueCommand = defineCommand93({
   meta: {
     name: "critique",
     description: "Pre-spend creative critic (ADVISORY \u2014 never blocks). Scores a scaffolded creative BEFORE the billed render, so weak spots get fixed for free. A VIDEO creative is scored on hook strength, sound-off first-frame legibility, retention risk, and mechanism clarity; a STATIC ad on baked-text legibility risk, identity grounding, brand-type fidelity, and mechanism clarity. Ground a video hook against `baker winning-ads hooks` for a proven pattern."
@@ -20008,9 +20381,9 @@ import { execFile } from "child_process";
 import { readdir, readFile as readFile3, stat } from "fs/promises";
 import path3 from "path";
 import { promisify } from "util";
-import { defineCommand as defineCommand91 } from "citty";
+import { defineCommand as defineCommand94 } from "citty";
 var execFileAsync = promisify(execFile);
-var inspectCommand = defineCommand91({
+var inspectCommand = defineCommand94({
   meta: {
     name: "inspect",
     description: "Dump a one-page summary of a canvas run: per-node duration + cache status, list of output files in the run dir, and optionally three thumbnail frames per video output. Pass either a run_id (resolved against --outputs-dir) or an absolute run directory."
@@ -20118,12 +20491,12 @@ async function probeDuration(filePath) {
 
 // src/commands/canvas/rerun.ts
 import path14 from "path";
-import { defineCommand as defineCommand93 } from "citty";
+import { defineCommand as defineCommand96 } from "citty";
 
 // src/commands/canvas/run.ts
 import { readFile as readFile10 } from "fs/promises";
 import path13 from "path";
-import { defineCommand as defineCommand92 } from "citty";
+import { defineCommand as defineCommand95 } from "citty";
 
 // src/commands/canvas/placeholders.ts
 function unsuppliedPlaceholderAssets(canvas) {
@@ -24289,7 +24662,7 @@ async function restoreRunSnapshot(manifest, targetDir, opts = {}) {
 }
 
 // src/commands/canvas/run.ts
-var runCommand = defineCommand92({
+var runCommand = defineCommand95({
   meta: { name: "run", description: "Validate and execute a canvas JSON file." },
   args: {
     file: { type: "positional", required: true, description: "Path to canvas JSON" },
@@ -24659,7 +25032,7 @@ async function postInitialRunRecord(client, payload) {
 
 // src/commands/canvas/rerun.ts
 var SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
-var rerunCommand = defineCommand93({
+var rerunCommand = defineCommand96({
   meta: {
     name: "rerun",
     description: "Re-run a creative's latest recorded canvas. Restores its definition files from run history first, so it works in a fresh workspace that never had the source chat's files \u2014 an interrupted run resumes (in-flight jobs re-attach), a completed one re-renders from the cache."
@@ -24756,7 +25129,7 @@ async function fetchManifest(url) {
 // src/commands/canvas/scaffold-static-ad.ts
 import { access, mkdir as mkdir6, readFile as readFile12, writeFile as writeFile7 } from "fs/promises";
 import path18 from "path";
-import { defineCommand as defineCommand95 } from "citty";
+import { defineCommand as defineCommand98 } from "citty";
 
 // src/engine/scaffold/staticAd.ts
 import { z as z23 } from "zod";
@@ -25106,7 +25479,7 @@ function isValidScaffoldSlug(slug) {
 // src/commands/canvas/sync-definition.ts
 import { readdir as readdir5, readFile as readFile11, stat as stat3 } from "fs/promises";
 import path17 from "path";
-import { defineCommand as defineCommand94 } from "citty";
+import { defineCommand as defineCommand97 } from "citty";
 
 // src/commands/canvas/definition-graph.ts
 var MAX_NODES = 300;
@@ -25219,7 +25592,7 @@ async function resolveCanvasPath(inputPath) {
   const chosen = (slug ? canvases.find((name) => name === `${slug}.canvas.json`) : void 0) ?? canvases[0];
   return chosen ? path17.join(dir, chosen) : null;
 }
-var syncDefinitionCommand = defineCommand94({
+var syncDefinitionCommand = defineCommand97({
   meta: {
     name: "sync-definition",
     description: "Push a creative's current node-graph + input thumbnails to the dashboard without rendering. Runs automatically when you edit a creative's canvas.json or prompt.json."
@@ -25447,7 +25820,7 @@ async function runVisionPasses(canvas) {
     return fail3("read_outputs", e instanceof Error ? e.message : String(e));
   }
 }
-var scaffoldStaticAdCommand = defineCommand95({
+var scaffoldStaticAdCommand = defineCommand98({
   meta: {
     name: "scaffold-static-ad",
     description: "Turn a source/inspiration image into a runnable static-ad canvas. Runs billed passes \u2014 image_describe (the blueprint, baked to prompt.json as the editable 'prompt'), an AI selection of the image's MAIN identity elements, and a structured global-layout pass (the column/row grid with per-region bounds and text sizes) \u2014 then scaffolds a canvas that wires one [TODO] ingest slot per element (logo/product/subject/badge + brand font) into image_generate. By default it also fans the hero out to the platform's placement ratios (via image_aspect_adapt \u2014 the hero ratio is free, the rest are billed AI recompositions); pass --placements none for a single base ad, or a preset to pick the set. Edit prompt.json and drop the real assets, then `baker canvas run` it."
@@ -25636,7 +26009,7 @@ var scaffoldStaticAdCommand = defineCommand95({
 import { access as access2, cp, mkdir as mkdir7, readFile as readFile15, rm as rm6, writeFile as writeFile8 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
 import path21 from "path";
-import { defineCommand as defineCommand96 } from "citty";
+import { defineCommand as defineCommand99 } from "citty";
 
 // src/engine/scaffold/lib/model-router.ts
 var SEEDANCE = "bytedance/seedance-2.0";
@@ -26095,7 +26468,7 @@ async function runAnalysisPasses(deconstructCanvas, selectModel) {
     return fail4("deconstruct", e instanceof Error ? e.message : String(e));
   }
 }
-var scaffoldVideoCommand = defineCommand96({
+var scaffoldVideoCommand = defineCommand99({
   meta: {
     name: "scaffold-video",
     description: "Turn a reference video into a runnable reproduction canvas in one command. Runs billed passes \u2014 video_deconstruct (the full scene-by-scene blueprint + transcript, baked to a split, editable blueprint: a global prompt.json plus one small scenes/sNN.json per scene) and an AI selection of the video's RECURRING identity elements (person/animal/product/logo) \u2014 then scaffolds a pipeline where every scene boundary is a static-ad-grade frame (the blueprint as target_blueprint, a reference legend, the real frame as anchor) and each recurring element gets ONE shared [TODO] ingest slot wired into every frame it appears in. The clips feed Seedance an ultra-detailed motion brief (action, camera, dialogue, transcript). Edit a scene's scenes/sNN.json (or prompt.json for global cast/palette/brand), drop the real source images, then `baker canvas run`."
@@ -26405,7 +26778,7 @@ var scaffoldVideoCommand = defineCommand96({
 // src/commands/canvas/set-prompt.ts
 import { readFile as readFile16, writeFile as writeFile9 } from "fs/promises";
 import path22 from "path";
-import { defineCommand as defineCommand97 } from "citty";
+import { defineCommand as defineCommand100 } from "citty";
 function setNodePrompt(canvas, nodeId, text) {
   const nodes = canvas?.nodes;
   if (!Array.isArray(nodes)) throw new Error("canvas has no nodes array");
@@ -26420,7 +26793,7 @@ function setNodePrompt(canvas, nodeId, text) {
   newNodes[idx] = newNode;
   return { ...canvas, nodes: newNodes };
 }
-var setPromptCommand = defineCommand97({
+var setPromptCommand = defineCommand100({
   meta: {
     name: "set-prompt",
     description: "Safely set a node's params.prompt (a frame description, motion prompt, etc.) without hand-editing the JSON. Prefer --text-file for multi-line/accented copy \u2014 it preserves UTF-8 exactly, unlike shell-quoted jq."
@@ -26480,8 +26853,8 @@ var setPromptCommand = defineCommand97({
 // src/commands/canvas/validate.ts
 import { readFile as readFile17 } from "fs/promises";
 import path23 from "path";
-import { defineCommand as defineCommand98 } from "citty";
-var validateCommand = defineCommand98({
+import { defineCommand as defineCommand101 } from "citty";
+var validateCommand = defineCommand101({
   meta: {
     name: "validate",
     description: "Validate a canvas JSON file (no execution). Includes a per-node cost preview and runs each node's deep validators (composition meta checks for hyperframe_render/_snapshot)."
@@ -26551,7 +26924,7 @@ var validateCommand = defineCommand98({
 });
 
 // src/commands/canvas/index.ts
-var canvasCommand = defineCommand99({
+var canvasCommand = defineCommand102({
   meta: {
     name: "canvas",
     description: `Run Baker creative canvas JSON files locally. Local nodes execute in-process; remote nodes POST to the Convex backend gateway.
@@ -26585,7 +26958,7 @@ Full guide: __tooling__/docs/tools/baker/canvas.md`
 });
 
 // src/commands/capabilities/index.ts
-import { defineCommand as defineCommand100 } from "citty";
+import { defineCommand as defineCommand103 } from "citty";
 registerSchema({
   command: "capabilities",
   description: "Start here, before promising the user anything on an ad platform, in Analytics, or in Tag Manager. Answers three questions in one call: what is connected and with what access, what a write on each surface actually does when it lands, and what CANNOT be done here and why. Run it with no arguments for every surface; name one surface to also get the exact fields every change on it accepts.",
@@ -26628,7 +27001,7 @@ function capabilityHints(surfaces) {
   }
   return hints;
 }
-var runCapabilities = defineCommand100({
+var runCapabilities = defineCommand103({
   meta: {
     name: "capabilities",
     description: `What Baker can and cannot do for this company, before any work starts.
@@ -26684,7 +27057,7 @@ Full guide: __tooling__/docs/tools/baker/capabilities.md`
 var capabilitiesCommand = runCapabilities;
 
 // src/commands/chats/index.ts
-import { defineCommand as defineCommand101 } from "citty";
+import { defineCommand as defineCommand104 } from "citty";
 var STATUS_GROUPS = ["active", "archived", "all"];
 var REPO_SURFACES = ["knowledge", "company", "brand", "landings", "flows", "creatives"];
 function parseBoundedInt(raw, name, min, max) {
@@ -26706,7 +27079,7 @@ registerSchema({
     full: { type: "boolean", description: "Include each Session's full change list", required: false, default: false }
   }
 });
-var listCommand10 = defineCommand101({
+var listCommand11 = defineCommand104({
   meta: { name: "list", description: "List other Sessions on this account, newest first." },
   args: {
     status: { type: "string", description: "Filter: active|archived|all (default: all)", required: false },
@@ -26761,7 +27134,7 @@ registerSchema({
     }
   }
 });
-var viewCommand = defineCommand101({
+var viewCommand = defineCommand104({
   meta: {
     name: "view",
     description: "Inspect one Session's full effects \u2014 git content + actions/tags/ads, kickoff, commits."
@@ -26805,7 +27178,7 @@ registerSchema({
     }
   }
 });
-var transcriptCommand = defineCommand101({
+var transcriptCommand = defineCommand104({
   meta: { name: "transcript", description: "Read another Session's conversation." },
   args: {
     id: { type: "positional", description: "The Session id", required: true },
@@ -26857,7 +27230,7 @@ registerSchema({
     }
   }
 });
-var diffCommand = defineCommand101({
+var diffCommand = defineCommand104({
   meta: { name: "diff", description: "See a published Session's real file-level changes." },
   args: {
     id: { type: "positional", description: "The Session id", required: true },
@@ -26901,14 +27274,14 @@ var diffCommand = defineCommand101({
     }
   }
 });
-var chatsCommand = defineCommand101({
+var chatsCommand = defineCommand104({
   meta: {
     name: "chats",
     description: `Inspect other Sessions on this account (read-only): list them, view what they produced, read their conversation, and see their real file changes \u2014 so you can reuse past work for a new goal.
 Full guide: __tooling__/docs/tools/baker/chats.md`
   },
   subCommands: {
-    list: listCommand10,
+    list: listCommand11,
     view: viewCommand,
     transcript: transcriptCommand,
     diff: diffCommand
@@ -26916,10 +27289,10 @@ Full guide: __tooling__/docs/tools/baker/chats.md`
 });
 
 // src/commands/creatives/index.ts
-import { defineCommand as defineCommand103 } from "citty";
+import { defineCommand as defineCommand106 } from "citty";
 
 // src/commands/creatives/publish.ts
-import { defineCommand as defineCommand102 } from "citty";
+import { defineCommand as defineCommand105 } from "citty";
 
 // src/commands/images/api.ts
 import { readFile as readFile18 } from "fs/promises";
@@ -27066,7 +27439,7 @@ async function publishCreative(args, deps = defaultImageApiDeps) {
     chatId: chatIdFromEnv()
   });
 }
-var publishCommand = defineCommand102({
+var publishCommand = defineCommand105({
   meta: {
     name: "publish",
     description: "Publish a final static creative image to Baker Creatives and print the creative reference JSON."
@@ -27124,7 +27497,7 @@ var publishCommand = defineCommand102({
 });
 
 // src/commands/creatives/index.ts
-var creativesCommand3 = defineCommand103({
+var creativesCommand3 = defineCommand106({
   meta: {
     name: "creatives",
     description: `Publish static ad creatives as first-class Baker outputs.
@@ -27141,7 +27514,7 @@ Full guide: __tooling__/docs/tools/baker/creatives.md`
 });
 
 // src/commands/flows/index.ts
-import { defineCommand as defineCommand104 } from "citty";
+import { defineCommand as defineCommand107 } from "citty";
 
 // src/commands/flows/shared.ts
 import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync9 } from "fs";
@@ -27296,7 +27669,7 @@ function displayName(slug) {
   const name = tree.displayName;
   return typeof name === "string" && name.trim() ? name.trim() : slug;
 }
-var listCommand11 = defineCommand104({
+var listCommand12 = defineCommand107({
   meta: {
     name: "list",
     description: "List Forms in this workspace with the count of confidential fields still needing setup. Example: baker flows list"
@@ -27310,7 +27683,7 @@ var listCommand11 = defineCommand104({
     writeJson({ ok: true, data: { flows } });
   }
 });
-var showCommand3 = defineCommand104({
+var showCommand3 = defineCommand107({
   meta: {
     name: "show",
     description: "Show a Form's confidential fields and their configuration status (never secret values). Example: baker flows show contact"
@@ -27331,7 +27704,7 @@ var showCommand3 = defineCommand104({
     writeJson({ ok: true, data: response });
   }
 });
-var flowsCommand = defineCommand104({
+var flowsCommand = defineCommand107({
   meta: {
     name: "flows",
     description: `Read this workspace's Forms (flows) and the configuration status of their confidential fields \u2014 connection secrets, OAuth connections, and third-party field definitions (HubSpot, Calendly, HighLevel, SavvyCal).
@@ -27345,7 +27718,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/flows.md`
   },
   subCommands: {
-    list: listCommand11,
+    list: listCommand12,
     show: showCommand3
   },
   // Bare `baker flows` lists the Forms. This must be `default`, not `run`: citty falls
@@ -27355,10 +27728,10 @@ Full guide: __tooling__/docs/tools/baker/flows.md`
 });
 
 // src/commands/ga4/index.ts
-import { defineCommand as defineCommand111 } from "citty";
+import { defineCommand as defineCommand114 } from "citty";
 
 // src/commands/ga4/audit.ts
-import { defineCommand as defineCommand105 } from "citty";
+import { defineCommand as defineCommand108 } from "citty";
 
 // src/commands/ga4/resolve.ts
 async function fetchProperties(useCache = true) {
@@ -27424,7 +27797,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var auditCommand2 = defineCommand105({
+var auditCommand2 = defineCommand108({
   meta: {
     name: "audit",
     description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
@@ -27479,11 +27852,11 @@ Examples:
 });
 
 // src/commands/ga4/config.ts
-import { defineCommand as defineCommand106 } from "citty";
+import { defineCommand as defineCommand109 } from "citty";
 
 // src/commands/ga4/shared.ts
 import { readFileSync as readFileSync10 } from "fs";
-function failValidation2(message) {
+function failValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
@@ -27491,7 +27864,7 @@ function requireTarget4(args, entity) {
   const positional = Array.isArray(args._) ? args._[0] : void 0;
   const target = args.id ?? args.target ?? positional;
   if (typeof target !== "string" || target.length === 0) {
-    failValidation2(`pass the ${entity} id as the positional argument`);
+    failValidation3(`pass the ${entity} id as the positional argument`);
   }
   return target;
 }
@@ -27500,17 +27873,17 @@ function readJsonSource(args, flag) {
   const file = args.file;
   const raw = typeof file === "string" && file.length > 0 ? readFileSync10(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
   if (raw === void 0) {
-    failValidation2(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
+    failValidation3(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
   }
   try {
     return JSON.parse(raw);
   } catch {
-    return failValidation2(`--${flag} is not valid JSON`);
+    return failValidation3(`--${flag} is not valid JSON`);
   }
 }
 function asObject(value, flag, index) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
-    failValidation2(
+    failValidation3(
       index === void 0 ? `--${flag} must be a JSON object` : `--${flag}[${index}] must be a JSON object`
     );
   }
@@ -27525,7 +27898,7 @@ function loadJsonPayloads(args) {
     return [asObject(parsed, "json")];
   }
   if (parsed.length === 0) {
-    failValidation2("--json is an empty list \u2014 pass at least one definition");
+    failValidation3("--json is an empty list \u2014 pass at least one definition");
   }
   return parsed.map((entry, index) => asObject(entry, "json", index));
 }
@@ -27671,7 +28044,7 @@ function configHints(config) {
   }
   return hints;
 }
-var configCommand = defineCommand106({
+var configCommand = defineCommand109({
   meta: {
     name: "config",
     description: `Read how the property is configured to measure \u2014 key events, custom definitions, custom events, retention
@@ -27699,7 +28072,7 @@ Examples:
 });
 
 // src/commands/ga4/draft.ts
-import { defineCommand as defineCommand107 } from "citty";
+import { defineCommand as defineCommand110 } from "citty";
 registerSchema({
   command: "ga4.draft",
   description: "Review and undo the Google Analytics changes staged on this chat. Use `list` to see everything staged, `show` to inspect one change in full before the chat completes, `amend` to correct one in place, and `remove`/`clear` to drop them. `list` and `show` take --chat <id> to read an earlier chat's changes instead.",
@@ -27708,13 +28081,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand3 = defineCommand107({
+var draftCommand3 = defineCommand110({
   meta: {
     name: "draft",
     description: "List, show, amend, remove or clear the Google Analytics changes staged on this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
   },
   subCommands: {
-    list: defineCommand107({
+    list: defineCommand110({
       meta: { name: "list", description: "Review everything staged on this chat (--json for the raw envelope)" },
       args: {
         json: { type: "boolean", description: "Print the raw JSON envelope", required: false },
@@ -27724,7 +28097,7 @@ var draftCommand3 = defineCommand107({
         await draftList(args.json === true, args.chat);
       }
     }),
-    show: defineCommand107({
+    show: defineCommand110({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change, alongside how the property looks today \u2014 the receipt to verify it before the chat completes (never truncated)."
@@ -27741,7 +28114,7 @@ var draftCommand3 = defineCommand107({
         );
       }
     }),
-    amend: defineCommand107({
+    amend: defineCommand110({
       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-runs every check. Use this instead of remove + re-create."
@@ -27758,7 +28131,7 @@ var draftCommand3 = defineCommand107({
         });
       }
     }),
-    remove: defineCommand107({
+    remove: defineCommand110({
       meta: { name: "remove", description: "Remove one staged change" },
       args: { ref: { type: "positional", description: "Staged ref or target id", required: false } },
       run: async ({ args }) => {
@@ -27767,7 +28140,7 @@ var draftCommand3 = defineCommand107({
         });
       }
     }),
-    clear: defineCommand107({
+    clear: defineCommand110({
       meta: { name: "clear", description: "Discard all Google Analytics changes staged on this chat" },
       run: async () => {
         await draftAction2("/api/ga4/draft/clear", {});
@@ -27777,7 +28150,7 @@ var draftCommand3 = defineCommand107({
 });
 
 // src/commands/ga4/properties.ts
-import { defineCommand as defineCommand108 } from "citty";
+import { defineCommand as defineCommand111 } from "citty";
 registerSchema({
   command: "ga4.properties",
   description: "List the GA4 properties this company connected \u2014 there can be several, and every one of them is yours to query. Returns the property IDs the query and audit commands take. Run this first to find property IDs.",
@@ -27793,7 +28166,7 @@ function propertyHints(properties) {
     resources: properties.map((property) => ({ id: property.externalId, label: property.name }))
   });
 }
-var propertiesCommand = defineCommand108({
+var propertiesCommand = defineCommand111({
   meta: {
     name: "properties",
     description: `List accessible GA4 properties.
@@ -27843,7 +28216,7 @@ Examples:
 // src/commands/ga4/query.ts
 import { appendFileSync as appendFileSync2, existsSync as existsSync5, readFileSync as readFileSync11, writeFileSync as writeFileSync3 } from "fs";
 import { resolve as resolve2 } from "path";
-import { defineCommand as defineCommand109 } from "citty";
+import { defineCommand as defineCommand112 } from "citty";
 
 // src/commands/ga4/presets.ts
 var GA4_PRESETS = [
@@ -27978,7 +28351,7 @@ function handleError2(err) {
   });
   process.exit(1);
 }
-var queryCommand2 = defineCommand109({
+var queryCommand2 = defineCommand112({
   meta: {
     name: "query",
     description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
@@ -28049,7 +28422,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/ga4/write-commands.ts
-import { defineCommand as defineCommand110 } from "citty";
+import { defineCommand as defineCommand113 } from "citty";
 var PROPERTY_ARG_DESCRIPTION = "GA4 property id (optional only when one property is connected \u2014 run `baker ga4 properties`)";
 var propertyArg = { type: "string", description: PROPERTY_ARG_DESCRIPTION, required: false };
 function createJsonDescription(noun) {
@@ -28067,7 +28440,7 @@ registerSchema({
     "property-id": { type: "string", description: PROPERTY_ARG_DESCRIPTION, required: false }
   }
 });
-var keyEventCommand = defineCommand110({
+var keyEventCommand = defineCommand113({
   meta: {
     name: "key-event",
     description: `Stage key-event (conversion) changes
@@ -28080,7 +28453,7 @@ Examples:
   baker ga4 key-event delete 4185`
   },
   subCommands: {
-    create: defineCommand110({
+    create: defineCommand113({
       meta: {
         name: "create",
         description: "Stage a new key event. Needs eventName and countingMethod (ONCE_PER_EVENT or ONCE_PER_SESSION); defaultValue sets a monetary value when the event does not send one."
@@ -28101,7 +28474,7 @@ Examples:
         );
       }
     }),
-    update: defineCommand110({
+    update: defineCommand113({
       meta: {
         name: "update",
         description: "Stage a change to an existing key event (pass its id). Only countingMethod and defaultValue can change \u2014 Google will not rename a key event."
@@ -28121,7 +28494,7 @@ Examples:
         });
       }
     }),
-    delete: defineCommand110({
+    delete: defineCommand113({
       meta: {
         name: "delete",
         description: "Stage removing a key event, so the event stops counting as a conversion. The event itself keeps being collected. Irreversible once the chat completes \u2014 confirm with the user first."
@@ -28169,7 +28542,7 @@ for (const { kind, noun, createHint } of DEFINITIONS) {
 }
 function definitionCommand(definition) {
   const { command, kind, noun, example } = definition;
-  return defineCommand110({
+  return defineCommand113({
     meta: {
       name: command,
       description: `Stage ${noun} changes
@@ -28181,7 +28554,7 @@ Examples:
   baker ga4 ${command} archive 12`
     },
     subCommands: {
-      create: defineCommand110({
+      create: defineCommand113({
         meta: { name: "create", description: `Stage a new ${noun} (or a JSON array of them, staged together)` },
         args: {
           json: { type: "string", description: createJsonDescription(noun), required: false },
@@ -28199,7 +28572,7 @@ Examples:
           );
         }
       }),
-      update: defineCommand110({
+      update: defineCommand113({
         meta: {
           name: "update",
           description: `Stage a change to an existing ${noun} (pass its id). The parameter name and scope cannot change \u2014 archive and recreate for that.`
@@ -28219,7 +28592,7 @@ Examples:
           });
         }
       }),
-      archive: defineCommand110({
+      archive: defineCommand113({
         meta: {
           name: "archive",
           description: `Stage archiving a ${noun} (pass its id). It stops collecting and leaves reporting; past data stays. Irreversible once the chat completes \u2014 confirm with the user first.`
@@ -28264,7 +28637,7 @@ var dataStreamArg = {
 function withStream(args) {
   return typeof args["data-stream"] === "string" ? { dataStream: args["data-stream"] } : {};
 }
-var customEventCommand = defineCommand110({
+var customEventCommand = defineCommand113({
   meta: {
     name: "custom-event",
     description: `Stage custom events \u2014 new events built from events the site already sends
@@ -28275,7 +28648,7 @@ Examples:
   baker ga4 custom-event delete 7`
   },
   subCommands: {
-    create: defineCommand110({
+    create: defineCommand113({
       meta: {
         name: "create",
         description: "Stage a new custom event. Conditions match the source event: use field `event_name` to match the event itself, or any parameter name to match its value."
@@ -28298,7 +28671,7 @@ Examples:
         );
       }
     }),
-    update: defineCommand110({
+    update: defineCommand113({
       meta: { name: "update", description: "Stage a change to an existing custom event (pass its id)" },
       args: {
         id: { type: "positional", description: "Custom event rule id", required: false },
@@ -28317,7 +28690,7 @@ Examples:
         });
       }
     }),
-    delete: defineCommand110({
+    delete: defineCommand113({
       meta: {
         name: "delete",
         description: "Stage removing a custom event (pass its id). The event stops being created from then on; data already collected under it stays. Confirm with the user first."
@@ -28363,16 +28736,16 @@ function retentionValue(input, flag) {
   const normalized = input.trim();
   const mapped = RETENTION_BY_MONTHS[normalized] ?? (Object.values(RETENTION_BY_MONTHS).includes(normalized.toUpperCase()) ? normalized.toUpperCase() : void 0);
   if (!mapped) {
-    failValidation2(`--${flag} must be one of 2, 14, 26, 38 or 50 (months)`);
+    failValidation3(`--${flag} must be one of 2, 14, 26, 38 or 50 (months)`);
   }
   return mapped;
 }
 function booleanArg(input, flag) {
   if (input === "true") return true;
   if (input === "false") return false;
-  return failValidation2(`--${flag} must be true or false`);
+  return failValidation3(`--${flag} must be true or false`);
 }
-var dataRetentionCommand = defineCommand110({
+var dataRetentionCommand = defineCommand113({
   meta: {
     name: "data-retention",
     description: `Stage a change to how long Google Analytics keeps data
@@ -28382,7 +28755,7 @@ Examples:
   baker ga4 data-retention set --event-data 14 --user-data 14 --reset-on-activity true`
   },
   subCommands: {
-    set: defineCommand110({
+    set: defineCommand113({
       meta: { name: "set", description: "Stage the retention window (months)" },
       args: {
         "event-data": { type: "string", description: "2, 14, 26, 38 or 50", required: false },
@@ -28402,7 +28775,7 @@ Examples:
           payload.resetUserDataOnNewActivity = booleanArg(args["reset-on-activity"], "reset-on-activity");
         }
         if (Object.keys(payload).length === 0) {
-          failValidation2("pass at least one of --event-data, --user-data or --reset-on-activity");
+          failValidation3("pass at least one of --event-data, --user-data or --reset-on-activity");
         }
         await stageOp3({ kind: "ga4.dataRetention.update", payload, ...withProperty(args) });
       }
@@ -28411,7 +28784,7 @@ Examples:
 });
 
 // src/commands/ga4/index.ts
-var ga4Command = defineCommand111({
+var ga4Command = defineCommand114({
   meta: {
     name: "ga4",
     description: `Google Analytics 4. Report on a property, audit its config, and change what it measures.
@@ -28452,12 +28825,12 @@ Full guide: __tooling__/docs/tools/baker/ga4.md`
 });
 
 // src/commands/gsc/index.ts
-import { defineCommand as defineCommand115 } from "citty";
+import { defineCommand as defineCommand118 } from "citty";
 
 // src/commands/gsc/query.ts
 import { appendFileSync as appendFileSync3, existsSync as existsSync6, readFileSync as readFileSync12, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve3 } from "path";
-import { defineCommand as defineCommand112 } from "citty";
+import { defineCommand as defineCommand115 } from "citty";
 
 // src/commands/gsc/presets.ts
 var GSC_PRESETS = [
@@ -28651,7 +29024,7 @@ function handleError3(err) {
   });
   process.exit(1);
 }
-var queryCommand3 = defineCommand112({
+var queryCommand3 = defineCommand115({
   meta: {
     name: "query",
     description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
@@ -28729,7 +29102,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/gsc/sitemaps.ts
-import { defineCommand as defineCommand113 } from "citty";
+import { defineCommand as defineCommand116 } from "citty";
 registerSchema({
   command: "gsc.sitemaps",
   description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
@@ -28738,7 +29111,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitemapsCommand = defineCommand113({
+var sitemapsCommand = defineCommand116({
   meta: {
     name: "sitemaps",
     description: `List sitemaps for a site. Check health and errors.
@@ -28791,7 +29164,7 @@ Examples:
 });
 
 // src/commands/gsc/sites.ts
-import { defineCommand as defineCommand114 } from "citty";
+import { defineCommand as defineCommand117 } from "citty";
 registerSchema({
   command: "gsc.sites",
   description: "List the Search Console sites this company connected \u2014 there can be several, and every one of them is yours to query. Returns the site URLs the query and sitemaps commands take.",
@@ -28807,7 +29180,7 @@ function siteHints(sites) {
     resources: sites.map((site) => ({ id: site.siteUrl, label: site.permissionLevel }))
   });
 }
-var sitesCommand = defineCommand114({
+var sitesCommand = defineCommand117({
   meta: {
     name: "sites",
     description: `List verified Search Console sites.
@@ -28855,7 +29228,7 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-var gscCommand = defineCommand115({
+var gscCommand = defineCommand118({
   meta: {
     name: "gsc",
     description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
@@ -28879,7 +29252,7 @@ Full guide: __tooling__/docs/tools/baker/gsc.md`
 });
 
 // src/commands/history/index.ts
-import { defineCommand as defineCommand116 } from "citty";
+import { defineCommand as defineCommand119 } from "citty";
 registerSchema({
   command: "history.list",
   description: "Start here: unified account history (audit log) \u2014 everything that changed on this account, newest first: publishes, chat lifecycle, backlog actions, team changes, setup links, tags, schedules, ad-platform writes, followed advertisers, media, creatives, reports, domains, and integrations. Use it to see what happened recently before planning work. Compact by default; add --full for raw metadata per entry.",
@@ -28934,7 +29307,7 @@ function parseBoundedInt2(raw, name, min, max) {
   }
   return value;
 }
-var listCommand12 = defineCommand116({
+var listCommand13 = defineCommand119({
   meta: {
     name: "list",
     description: "List recent account changes (unified audit log), newest first."
@@ -28980,17 +29353,17 @@ var listCommand12 = defineCommand116({
     }
   }
 });
-var historyCommand = defineCommand116({
+var historyCommand = defineCommand119({
   meta: {
     name: "history",
     description: `Unified account history (audit log): what changed, who did it, and when.
 Full guide: __tooling__/docs/tools/baker/history.md`
   },
-  subCommands: { list: listCommand12 }
+  subCommands: { list: listCommand13 }
 });
 
 // src/commands/hubspot/index.ts
-import { defineCommand as defineCommand117 } from "citty";
+import { defineCommand as defineCommand120 } from "citty";
 var EMBED_TYPES = ["legacy", "v4", "unknown"];
 function failNotConnected(err) {
   if (err instanceof ApiError && err.code === "FORBIDDEN" && err.message.includes(HUBSPOT_MISSING_GRANT_MARKER)) {
@@ -29127,7 +29500,7 @@ registerSchema({
     }
   }
 });
-var formsListCommand = defineCommand117({
+var formsListCommand = defineCommand120({
   meta: {
     name: "list",
     description: "List HubSpot forms with embed type and post-submit action. Example: baker hubspot forms list --redirecting-only"
@@ -29172,7 +29545,7 @@ var formsListCommand = defineCommand117({
     }
   }
 });
-var formsViewCommand = defineCommand117({
+var formsViewCommand = defineCommand120({
   meta: {
     name: "view",
     description: "Show one HubSpot form's fields and configuration. Example: baker hubspot forms view 1a2b3c"
@@ -29224,7 +29597,7 @@ var formsViewCommand = defineCommand117({
     }
   }
 });
-var meetingsListCommand = defineCommand117({
+var meetingsListCommand = defineCommand120({
   meta: {
     name: "list",
     description: "List HubSpot meeting links (calendars). Example: baker hubspot meetings list"
@@ -29266,7 +29639,7 @@ var meetingsListCommand = defineCommand117({
     }
   }
 });
-var meetingsViewCommand = defineCommand117({
+var meetingsViewCommand = defineCommand120({
   meta: {
     name: "view",
     description: "Show one HubSpot meeting link's booking fields. Example: baker hubspot meetings view discovery-call"
@@ -29310,7 +29683,7 @@ var meetingsViewCommand = defineCommand117({
     }
   }
 });
-var formsSubmissionsCommand = defineCommand117({
+var formsSubmissionsCommand = defineCommand120({
   meta: {
     name: "submissions",
     description: "How many leads a form received, and when. Example: baker hubspot forms submissions <formId> --days 30"
@@ -29359,7 +29732,7 @@ var formsSubmissionsCommand = defineCommand117({
     }
   }
 });
-var workflowsListCommand = defineCommand117({
+var workflowsListCommand = defineCommand120({
   meta: {
     name: "list",
     description: "List HubSpot workflows. Example: baker hubspot workflows list --enabled-only"
@@ -29395,7 +29768,7 @@ var workflowsListCommand = defineCommand117({
     }
   }
 });
-var pipelinesListCommand = defineCommand117({
+var pipelinesListCommand = defineCommand120({
   meta: {
     name: "list",
     description: "List HubSpot deal pipelines and their stages. Example: baker hubspot pipelines list"
@@ -29412,7 +29785,7 @@ var pipelinesListCommand = defineCommand117({
     }
   }
 });
-var contactsSummaryCommand = defineCommand117({
+var contactsSummaryCommand = defineCommand120({
   meta: {
     name: "summary",
     description: "Whether recent leads are being worked, as counts. Example: baker hubspot contacts summary --days 30"
@@ -29482,7 +29855,7 @@ function contactLookupHints(data) {
   }
   return hints;
 }
-var contactsLookupCommand = defineCommand117({
+var contactsLookupCommand = defineCommand120({
   meta: {
     name: "lookup",
     description: "Find one contact by email and see whether it was worked. Example: baker hubspot contacts lookup a@b.com"
@@ -29506,27 +29879,27 @@ var contactsLookupCommand = defineCommand117({
     }
   }
 });
-var contactsCommand = defineCommand117({
+var contactsCommand = defineCommand120({
   meta: { name: "contacts", description: "Contacts on the connected HubSpot account." },
   subCommands: { summary: contactsSummaryCommand, lookup: contactsLookupCommand }
 });
-var formsCommand = defineCommand117({
+var formsCommand = defineCommand120({
   meta: { name: "forms", description: "HubSpot forms on the connected account." },
   subCommands: { list: formsListCommand, view: formsViewCommand, submissions: formsSubmissionsCommand }
 });
-var workflowsCommand = defineCommand117({
+var workflowsCommand = defineCommand120({
   meta: { name: "workflows", description: "HubSpot workflows on the connected account." },
   subCommands: { list: workflowsListCommand }
 });
-var pipelinesCommand = defineCommand117({
+var pipelinesCommand = defineCommand120({
   meta: { name: "pipelines", description: "HubSpot deal pipelines on the connected account." },
   subCommands: { list: pipelinesListCommand }
 });
-var meetingsCommand = defineCommand117({
+var meetingsCommand = defineCommand120({
   meta: { name: "meetings", description: "HubSpot meeting links (calendars) on the connected account." },
   subCommands: { list: meetingsListCommand, view: meetingsViewCommand }
 });
-var hubspotCommand = defineCommand117({
+var hubspotCommand = defineCommand120({
   meta: {
     name: "hubspot",
     description: `Read the connected HubSpot account \u2014 forms, the leads they received, workflows, deal pipelines and
@@ -29563,10 +29936,10 @@ Full guide: __tooling__/docs/tools/baker/hubspot.md`
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand145 } from "citty";
 
 // src/commands/images/crop.ts
-import { defineCommand as defineCommand118 } from "citty";
+import { defineCommand as defineCommand121 } from "citty";
 
 // src/lib/image/crop-sprite.ts
 import sharp from "sharp";
@@ -29691,7 +30064,7 @@ function emitError2(err) {
   }
   process.exit(1);
 }
-var cropCommand = defineCommand118({
+var cropCommand = defineCommand121({
   meta: {
     name: "crop",
     description: "Crop a rectangular region from an image.\n\nExample: baker images crop sprite.png --x 0 --y 0 --width 64 --height 64 --output icon.png"
@@ -29727,7 +30100,7 @@ var cropCommand = defineCommand118({
 });
 
 // src/commands/images/delete.ts
-import { defineCommand as defineCommand119 } from "citty";
+import { defineCommand as defineCommand122 } from "citty";
 registerSchema({
   command: "images.delete",
   description: "Delete an image by ID",
@@ -29741,7 +30114,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand = defineCommand119({
+var deleteCommand = defineCommand122({
   meta: {
     name: "delete",
     description: "Delete an image by ID. Use --dry-run to preview. Example: baker images delete j571abc123 --dry-run"
@@ -29782,7 +30155,7 @@ var deleteCommand = defineCommand119({
 });
 
 // src/commands/images/dimensions.ts
-import { defineCommand as defineCommand120 } from "citty";
+import { defineCommand as defineCommand123 } from "citty";
 
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
@@ -29805,7 +30178,7 @@ registerSchema({
     target: { type: "string", description: "Local file path or remote http(s) URL", required: true }
   }
 });
-var dimensionsCommand = defineCommand120({
+var dimensionsCommand = defineCommand123({
   meta: {
     name: "dimensions",
     description: "Read image dimensions without decoding the full file.\n\nExample: baker images dimensions ./logo.png\nExample: baker images dimensions https://acme.com/hero.png"
@@ -29849,7 +30222,7 @@ var dimensionsCommand = defineCommand120({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand121 } from "citty";
+import { defineCommand as defineCommand124 } from "citty";
 registerSchema({
   command: "images.extract",
   description: "Extract images from a URL via Firecrawl (formats: images).",
@@ -29865,7 +30238,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand121({
+var extractCommand = defineCommand124({
   meta: {
     name: "extract",
     description: "Pull every image from a single URL via Firecrawl. ~$0.001/scrape. Cap auto-ingest at 20.\n\nExample: baker images extract https://stripe.com --auto-ingest 5"
@@ -29903,7 +30276,7 @@ var extractCommand = defineCommand121({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand122 } from "citty";
+import { defineCommand as defineCommand125 } from "citty";
 registerSchema({
   command: "images.find",
   description: "Fanout image search: library first, then opted-in external providers.",
@@ -29935,7 +30308,7 @@ registerSchema({
     }
   }
 });
-var findCommand = defineCommand122({
+var findCommand = defineCommand125({
   meta: {
     name: "find",
     description: "Library-first fanout image search. Opt in to providers with --sources. `--fallback` short-circuits to externals only when library is thin. With --auto-ingest, ingested external hits return Baker-owned URLs.\n\nExample: baker images find 'office' --sources library,magnific --limit 20"
@@ -29983,7 +30356,7 @@ var findCommand = defineCommand122({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand123 } from "citty";
+import { defineCommand as defineCommand126 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -29991,7 +30364,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand2 = defineCommand123({
+var getCommand2 = defineCommand126({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -30027,7 +30400,7 @@ var getCommand2 = defineCommand123({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand124 } from "citty";
+import { defineCommand as defineCommand127 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -30059,7 +30432,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand124({
+var gifCommand = defineCommand127({
   meta: {
     name: "gif",
     description: "Search Giphy for GIFs / reaction memes \u2014 built for paid-social creative (Meta, TikTok, LinkedIn, X). Free API. Each hit carries WebP + GIF + MP4 URLs in providerMeta so you can pick the right format per platform.\n\nExample: baker images gif 'this is fine' --limit 10\nExample: baker images gif 'office reaction' --rating pg --auto-ingest 2\nExample: baker images gif --trending --limit 25"
@@ -30106,7 +30479,7 @@ var gifCommand = defineCommand124({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand125 } from "citty";
+import { defineCommand as defineCommand128 } from "citty";
 
 // src/commands/images/searchHints.ts
 var FALLBACK = {
@@ -30170,7 +30543,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand125({
+var googleCommand2 = defineCommand128({
   meta: {
     name: "google",
     description: "Google Images via the official Custom Search JSON API ($0.005/query, free 100/day). \u26A0 Source unverified \u2014 watermarks, low-res, mislabeled results are common. Use as last resort. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExample: baker images google 'industrial workshop' --type photo --size large --limit 20"
@@ -30226,7 +30599,7 @@ var googleCommand2 = defineCommand125({
 });
 
 // src/commands/images/group.ts
-import { defineCommand as defineCommand126 } from "citty";
+import { defineCommand as defineCommand129 } from "citty";
 
 // src/commands/mediaGroup.ts
 async function runMediaGroupLookup(input) {
@@ -30279,7 +30652,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand = defineCommand126({
+var groupCommand = defineCommand129({
   meta: {
     name: "group",
     description: "List every asset that arrived in the same set \u2014 the slides of one Instagram carousel, the images off one scraped page. Start here whenever a hit looks like part of a sequence: carousel slides are authored to be read in order and usually only make sense together. Takes an image or a video id, since one carousel can contain both. Example: baker images group <imageId>"
@@ -30299,7 +30672,7 @@ var groupCommand = defineCommand126({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand127 } from "citty";
+import { defineCommand as defineCommand130 } from "citty";
 registerSchema({
   command: "images.icon",
   description: "Icon lookup via Iconify (200+ icon sets, free CDN).",
@@ -30325,7 +30698,7 @@ registerSchema({
     }
   }
 });
-var iconCommand = defineCommand127({
+var iconCommand = defineCommand130({
   meta: {
     name: "icon",
     description: "Icon via Iconify (simple-icons, logos, lucide, devicon, heroicons, tabler, phosphor, material-symbols, \u2026). Free CDN, no API key.\n\nExample: baker images icon react --set devicon\nExample: baker images icon lucide:check --color '#0a0a0a'"
@@ -30365,7 +30738,7 @@ var iconCommand = defineCommand127({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand128 } from "citty";
+import { defineCommand as defineCommand131 } from "citty";
 registerSchema({
   command: "images.ingest",
   description: "Ingest a remote image URL into the library (full describe + embed).",
@@ -30377,7 +30750,7 @@ registerSchema({
     context: { type: "string", description: "Description context hint", required: false }
   }
 });
-var ingestCommand = defineCommand128({
+var ingestCommand = defineCommand131({
   meta: {
     name: "ingest",
     description: "Download a remote URL and store it in the library. Hash-deduped on bytes + externalId.\n\nExample: baker images ingest https://img.freepik.com/free-photo/xyz.jpg --source magnific --external-id 12345"
@@ -30418,8 +30791,181 @@ var ingestCommand = defineCommand128({
   }
 });
 
+// src/commands/images/layerize.ts
+import { defineCommand as defineCommand132 } from "citty";
+registerSchema({
+  command: "images.layerize",
+  description: "Split a library image into editable layers: transparent PNG cutouts for each element, plus any headline recovered as EDITABLE TEXT with its font, size, colour and position. Waits for completion by default. Costs credits.",
+  args: {
+    "image-id": { type: "string", description: "Library image ID to split", required: true },
+    instructions: {
+      type: "string",
+      description: "Optional steer for what to separate, e.g. 'keep the bottle and its shadow as one layer'",
+      required: false
+    },
+    full: { type: "boolean", description: "Include geometry and typography for every layer", required: false },
+    "max-wait": {
+      type: "number",
+      description: "Max wait ms (default 240000 = 4 min). Set 0 to fire-and-forget.",
+      required: false,
+      default: 24e4
+    }
+  }
+});
+var POLL_INTERVAL_MS3 = 4e3;
+function compact(doc) {
+  return {
+    layeredImageId: doc.layeredImageId,
+    imageId: doc.imageId,
+    status: doc.status,
+    canvas: { width: doc.width, height: doc.height },
+    layers: doc.layers.map((layer) => ({
+      id: layer.id,
+      kind: layer.kind,
+      name: layer.name,
+      ...layer.url ? { url: layer.url } : {},
+      ...layer.text ? { text: layer.text.content } : {}
+    }))
+  };
+}
+function hintsFor2(doc) {
+  const hints = [];
+  const text = doc.layers.filter((layer) => layer.kind === "text");
+  const art = doc.layers.filter((layer) => layer.kind === "art" && layer.id !== "layer-base");
+  if (text.length > 0) {
+    hints.push(
+      `${text.length} text layer(s) recovered as editable copy \u2014 run with --full for the font, size and colour to reuse when rewriting it.`
+    );
+  }
+  if (art.length > 0) {
+    hints.push(
+      `Each art layer's url is a transparent PNG on the media host: wire one straight into a canvas composition to reuse that element on its own.`
+    );
+  }
+  hints.push(
+    '"Original image" is the flat picture kept underneath. The model separates what was VISIBLE and does not repaint what sat behind a subject, so moving one can leave a gap.'
+  );
+  return hints;
+}
+async function pollUntilSettled(imageId, maxWait) {
+  const start = Date.now();
+  while (Date.now() - start < maxWait) {
+    await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS3));
+    const doc = await apiGet("/api/images/layers", { imageId });
+    if (doc.status !== "splitting") return doc;
+  }
+  return null;
+}
+var layerizeCommand = defineCommand132({
+  meta: {
+    name: "layerize",
+    description: "Split a library image into editable layers \u2014 transparent cutouts per element, plus any baked-in headline recovered as editable text with its typography.\n\nStart here: baker images layerize j571abc123def\nExample: baker images layerize j571abc123def --full\nExample: baker images layerize j571abc123def --instructions 'keep the product and its shadow together'"
+  },
+  args: {
+    "image-id": { type: "positional", description: "Library image ID", required: false },
+    instructions: { type: "string", description: "Optional steer for what to separate", required: false },
+    full: { type: "boolean", description: "Include geometry and typography", required: false },
+    "max-wait": { type: "string", description: "Max wait ms (default 240000, 0 = no wait)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const imageId = args["image-id"];
+      if (!imageId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "image-id is required" } });
+        process.exit(1);
+      }
+      const maxWait = args["max-wait"] ? Number(args["max-wait"]) : 24e4;
+      const full = Boolean(args.full);
+      const started = await apiPost("/api/images/layerize", {
+        imageId,
+        instructions: args.instructions
+      });
+      const settled = maxWait === 0 || started.status !== "splitting" ? started : await pollUntilSettled(imageId, maxWait);
+      if (!settled) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "TIMEOUT",
+            message: `Layers not ready within ${maxWait}ms`,
+            fix: `The split is still running. Read it later with: baker images layers ${imageId}`
+          }
+        });
+        process.exit(1);
+      }
+      if (settled.status === "failed") {
+        writeJson({
+          ok: false,
+          error: {
+            code: "IMAGE_PROCESSING_ERROR",
+            message: settled.error ?? "That image couldn't be split into layers",
+            fix: "Run the same command again \u2014 this provider rejects a valid request intermittently. If it fails twice more, carry on without layers."
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: true, data: full ? settled : compact(settled), hints: hintsFor2(settled) });
+    } 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: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+registerSchema({
+  command: "images.layers",
+  description: "Read the layers of an image already split with `images layerize` \u2014 free, no provider call. Use it to see what an ad says and what its pieces are.",
+  args: {
+    "image-id": { type: "string", description: "Library image ID", required: true },
+    full: { type: "boolean", description: "Include geometry and typography for every layer", required: false }
+  }
+});
+var layersCommand = defineCommand132({
+  meta: {
+    name: "layers",
+    description: "Read the layers of an image that has already been split. Free \u2014 no provider call.\n\nStart here: baker images layers j571abc123def\nExample: baker images layers j571abc123def --full"
+  },
+  args: {
+    "image-id": { type: "positional", description: "Library image ID", required: false },
+    full: { type: "boolean", description: "Include geometry and typography", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const imageId = args["image-id"];
+      if (!imageId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "image-id is required" } });
+        process.exit(1);
+      }
+      const doc = await apiGet("/api/images/layers", { imageId });
+      writeJson({ ok: true, data: args.full ? doc : compact(doc), hints: hintsFor2(doc) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            ...err.code === "NOT_FOUND" ? { fix: `Split it first: baker images layerize ${args["image-id"]}` } : {}
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({
+        ok: false,
+        error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+
 // src/commands/images/library.ts
-import { defineCommand as defineCommand129 } from "citty";
+import { defineCommand as defineCommand133 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -30445,7 +30991,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand129({
+var libraryCommand = defineCommand133({
   meta: {
     name: "library",
     description: "Search the company image library (hybrid BM25 + vector + Cohere rerank). Use this BEFORE any external provider.\n\nExample: baker images library 'hero banner' --aspect-ratio 16:9 --source magnific"
@@ -30502,7 +31048,7 @@ var libraryCommand = defineCommand129({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand130 } from "citty";
+import { defineCommand as defineCommand134 } from "citty";
 registerSchema({
   command: "images.logo",
   description: "Brand logo lookup via Brandfetch CDN (fallback/404). Auto-ingests by default.",
@@ -30527,7 +31073,7 @@ registerSchema({
     }
   }
 });
-var logoCommand = defineCommand130({
+var logoCommand = defineCommand134({
   meta: {
     name: "logo",
     description: "Brand logo via Brandfetch CDN. Returns up to 5 variants (icon, light/dark logo, light/dark symbol). Auto-ingests the first variant.\n\nExample: baker images logo stripe.com --variant logo"
@@ -30565,7 +31111,7 @@ var logoCommand = defineCommand130({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand131 } from "citty";
+import { defineCommand as defineCommand135 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -31297,7 +31843,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand = defineCommand131({
+var normalizeCommand = defineCommand135({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -31352,7 +31898,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand132 } from "citty";
+import { defineCommand as defineCommand136 } from "citty";
 registerSchema({
   command: "images.pinterest",
   description: "Pinterest image search via ScrapeCreators. Reference-grade real-world photography, product styling, interiors, fashion, food, and aesthetic mood boards. Inspect before placing \u2014 Pinterest is unverified, trademark-bearing web content.",
@@ -31372,7 +31918,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand132({
+var pinterestCommand = defineCommand136({
   meta: {
     name: "pinterest",
     description: "Pinterest image search via ScrapeCreators ($0.00188/request). Best for photo-realistic reference imagery \u2014 lifestyle, interiors, fashion, food, product styling, and mood boards to brief AI generation against. \u26A0 Unverified, trademark-bearing web content \u2014 inspect and respect rights before placing on a customer page. Browse first; auto-ingest only the pins you commit to.\n\nExamples:\n  baker images pinterest 'scandinavian living room'\n  baker images pinterest 'minimalist skincare product photography' --limit 20\n  baker images pinterest 'cozy coffee shop interior' --auto-ingest 2 --context 'Mood reference for hero photography'"
@@ -31412,7 +31958,7 @@ var pinterestCommand = defineCommand132({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand133 } from "citty";
+import { defineCommand as defineCommand137 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -31428,7 +31974,7 @@ registerSchema({
     }
   }
 });
-var screenshotCommand = defineCommand133({
+var screenshotCommand = defineCommand137({
   meta: {
     name: "screenshot",
     description: "Screenshot a URL via ScreenshotOne. $0.009/capture. Auto-ingests to library.\n\nExample: baker images screenshot https://stripe.com --full-page"
@@ -31491,7 +32037,7 @@ var screenshotCommand = defineCommand133({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand134 } from "citty";
+import { defineCommand as defineCommand138 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -31507,7 +32053,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand134({
+var searchCommand = defineCommand138({
   meta: {
     name: "search",
     description: "Semantic search images by text query. Uses hybrid BM25 + vector + reranking. Example: baker images search 'hero banner' --aspect-ratio 16:9 --tags logo"
@@ -31567,7 +32113,7 @@ var searchCommand = defineCommand134({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand135 } from "citty";
+import { defineCommand as defineCommand139 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -31599,7 +32145,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand135({
+var stickerCommand = defineCommand139({
   meta: {
     name: "sticker",
     description: "Search Giphy's sticker corpus \u2014 transparent-background WebPs / GIFs ideal for overlaying on ad creative (Meta, TikTok, Stories). Same Giphy free API as `baker images gif`; results carry WebP + GIF + MP4 URLs in providerMeta.\n\nExample: baker images sticker 'thumbs up' --limit 10\nExample: baker images sticker celebration --rating g --auto-ingest 3\nExample: baker images sticker --trending --limit 25"
@@ -31646,7 +32192,7 @@ var stickerCommand = defineCommand135({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand136 } from "citty";
+import { defineCommand as defineCommand140 } from "citty";
 var STOCK_ERROR_FIX = {
   action: "use_different_resource",
   explanation: "Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required \u2014 `find` alone searches the library only) or `baker studio generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
@@ -31723,7 +32269,7 @@ function buildStockRequest(query, args) {
   if (args.context) body.descriptionContext = args.context;
   return body;
 }
-var stockCommand = defineCommand136({
+var stockCommand = defineCommand140({
   meta: {
     name: "stock",
     description: "Stock search via Magnific \u2014 Freepik's developer API (~250M assets: photos, vectors, illustrations, icons, PSDs). $0.002/req. With --auto-ingest, ingested hits return Baker-owned URLs.\n\nExamples:\n  baker images stock 'minimalist office'\n  baker images stock 'flat office workers' --type vector\n  baker images stock 'hero photo of a kitchen' --type photo --orientation landscape --ai exclude\n  baker images stock 'brand pattern' --color '#0a0a0a' --license freemium --auto-ingest 2"
@@ -31779,7 +32325,7 @@ var stockCommand = defineCommand136({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand137 } from "citty";
+import { defineCommand as defineCommand141 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -31788,7 +32334,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand137({
+  return defineCommand141({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -31824,7 +32370,7 @@ function makeTagsCommand(command, label, endpoint) {
 var tagsCommand2 = makeTagsCommand("images", "image", "/api/images/tags");
 
 // src/commands/images/upload.ts
-import { defineCommand as defineCommand138 } from "citty";
+import { defineCommand as defineCommand142 } from "citty";
 registerSchema({
   command: "images.upload",
   description: "Upload an image to the library \u2014 local file path or remote http(s) URL.",
@@ -31862,7 +32408,7 @@ registerSchema({
 function isRemoteUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
-var uploadCommand = defineCommand138({
+var uploadCommand = defineCommand142({
   meta: {
     name: "upload",
     description: "Upload an image to the library \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: reads bytes, sends to /api/images/upload, content-type auto-detected from extension.\nRemote: dispatches to /api/images/ingest with hash-dedup on bytes + externalId.\n\nExamples:\n  baker images upload ./logo.png --source uploaded\n  baker images upload ./cert.png --context 'ISO 27001 badge \u2014 enterprise tier'\n  baker images upload https://acme.com/hero.png --source firecrawl --context 'Acme competitor pricing hero'"
@@ -31955,7 +32501,7 @@ async function uploadLocal(target, args) {
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand139 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 registerSchema({
   command: "images.upscale",
   description: "Upscale a library image via the backend (Replicate, cost-tracked). Waits for completion by default. The image must be status 'ready' and raster (not SVG/AVIF).",
@@ -31969,8 +32515,8 @@ registerSchema({
     }
   }
 });
-var POLL_INTERVAL_MS3 = 1500;
-var upscaleCommand = defineCommand139({
+var POLL_INTERVAL_MS4 = 1500;
+var upscaleCommand = defineCommand143({
   meta: {
     name: "upscale",
     description: "Upscale a library image via the Convex backend (Replicate, cost-tracked at $0.05/image). Waits for completion by default.\n\nExample: baker images upscale j571abc123def\nExample: baker images upscale j571abc123def --max-wait 0   # fire-and-forget"
@@ -32006,7 +32552,7 @@ var upscaleCommand = defineCommand139({
           });
           process.exit(1);
         }
-        await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS3));
+        await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS4));
       }
       writeJson({ ok: false, error: { code: "TIMEOUT", message: `Image not ready within ${maxWait}ms` } });
       process.exit(1);
@@ -32025,7 +32571,7 @@ var upscaleCommand = defineCommand139({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand140 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -32040,8 +32586,8 @@ registerSchema({
     }
   }
 });
-var POLL_INTERVAL_MS4 = 1500;
-var useCommand = defineCommand140({
+var POLL_INTERVAL_MS5 = 1500;
+var useCommand = defineCommand144({
   meta: {
     name: "use",
     description: "Sugar over `ingest`: download \u2192 store \u2192 wait until describe + embed complete \u2192 return ready library record.\n\nExample: baker images use https://cdn.example.com/hero.png --source uploaded"
@@ -32071,7 +32617,7 @@ var useCommand = defineCommand140({
           writeJson({ ok: true, data: { ...ingestResult, image: doc } });
           return;
         }
-        await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS4));
+        await new Promise((resolve5) => setTimeout(resolve5, POLL_INTERVAL_MS5));
       }
       writeJson({ ok: false, error: { code: "TIMEOUT", message: `Image not ready within ${maxWait}ms` } });
       process.exit(1);
@@ -32087,7 +32633,7 @@ var useCommand = defineCommand140({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand141({
+var imagesCommand = defineCommand145({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -32129,6 +32675,8 @@ Taxonomy:
 
 Paid transforms (run on the Convex backend, cost-tracked):
   baker images upscale <imageId>                       Real-ESRGAN super-resolution ($0.05/image, waits for completion)
+  baker images layerize <imageId>                      Split into editable layers; recovers baked-in copy as editable text (costs credits)
+  baker images layers <imageId>                        Read the layers of an already-split image (free)
 Full guide: __tooling__/docs/tools/baker/images.md`
   },
   subCommands: {
@@ -32153,18 +32701,20 @@ Full guide: __tooling__/docs/tools/baker/images.md`
     normalize: normalizeCommand,
     crop: cropCommand,
     dimensions: dimensionsCommand,
+    layerize: layerizeCommand,
+    layers: layersCommand,
     upscale: upscaleCommand,
     tags: tagsCommand2
   }
 });
 
 // src/commands/landing/index.ts
-import { defineCommand as defineCommand151 } from "citty";
+import { defineCommand as defineCommand155 } from "citty";
 
 // src/commands/landing/critique.ts
 import { readdir as readdir8, stat as stat6 } from "fs/promises";
 import path28 from "path";
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 
 // src/engine/landing/lib/brand-tokens.ts
 import { readFile as readFile20 } from "fs/promises";
@@ -33559,7 +34109,7 @@ function fail5(code, message, fix) {
   );
   process.exit(2);
 }
-var critiqueCommand2 = defineCommand142({
+var critiqueCommand2 = defineCommand146({
   meta: {
     name: "critique",
     description: "Start here: `baker landing critique <slug>` after building or editing a landing. Deterministic design-quality critic (ADVISORY \u2014 findings never fail it). Flags the known AI design tells (gradient text, overused fonts, side-tab borders, cream palettes, buzzword copy, broken images) tiered block/warn/advisory, respecting the client's BRAND.md as the allowlist. Also records the critique that publishing requires \u2014 run it before finishing a landing."
@@ -33668,10 +34218,10 @@ async function isDir(p) {
 }
 
 // src/commands/landing/inspiration/index.ts
-import { defineCommand as defineCommand150 } from "citty";
+import { defineCommand as defineCommand154 } from "citty";
 
 // src/commands/landing/inspiration/add.ts
-import { defineCommand as defineCommand143 } from "citty";
+import { defineCommand as defineCommand147 } from "citty";
 
 // src/commands/landing/inspiration/shared.ts
 var INSPIRATION_HINTS = {
@@ -33717,7 +34267,7 @@ registerSchema({
     note: { type: "string", description: "Why this page is worth keeping", required: false }
   }
 });
-var addCommand = defineCommand143({
+var addCommand = defineCommand147({
   meta: {
     name: "add",
     description: "Add someone else's landing page to the reference library. Example: baker landing inspiration add https://linear.app --note 'the client likes this density'"
@@ -33755,7 +34305,7 @@ var addCommand = defineCommand143({
 // src/commands/landing/inspiration/code.ts
 import { mkdir as mkdir10, writeFile as writeFile13 } from "fs/promises";
 import path29 from "path";
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand148 } from "citty";
 registerSchema({
   command: "landing.inspiration.code",
   description: "Write a reference section's standalone HTML+CSS to .baker/inspiration/<id>/ so you can read how it is built. Reference only \u2014 the structure is the lesson, the words are not yours to reuse. Consulting a section records it, and `baker landing critique` blocks a publish that ships its copy verbatim.",
@@ -33764,7 +34314,7 @@ registerSchema({
     full: { type: "boolean", description: "Print the markup inline as well as writing it", required: false }
   }
 });
-var codeCommand = defineCommand144({
+var codeCommand = defineCommand148({
   meta: {
     name: "code",
     description: "Write one reference section's standalone markup to disk. Example: baker landing inspiration code k57abc\u2026 \u2014 read it for structure, then build your own."
@@ -33821,7 +34371,7 @@ var codeCommand = defineCommand144({
 });
 
 // src/commands/landing/inspiration/favorites.ts
-import { defineCommand as defineCommand145 } from "citty";
+import { defineCommand as defineCommand149 } from "citty";
 registerSchema({
   command: "landing.inspiration.favorites",
   description: "List the reference sections this company has saved. This is what `search` looks at by default, so it is the client's own taste profile \u2014 read it before proposing a direction.",
@@ -33835,7 +34385,7 @@ registerSchema({
     }
   }
 });
-var favoritesCommand = defineCommand145({
+var favoritesCommand = defineCommand149({
   meta: {
     name: "favorites",
     description: "List this company's saved reference sections. Example: baker landing inspiration favorites --type hero,pricing"
@@ -33895,7 +34445,7 @@ registerSchema({
     note: { type: "string", description: "Why this is worth keeping", required: false }
   }
 });
-var favoriteCommand = defineCommand145({
+var favoriteCommand = defineCommand149({
   meta: {
     name: "favorite",
     description: "Save a reference section to this company. Example: baker landing inspiration favorite k57abc\u2026"
@@ -33933,7 +34483,7 @@ registerSchema({
     page: { type: "boolean", description: "Treat the id as a page rather than a section", required: false }
   }
 });
-var unfavoriteCommand = defineCommand145({
+var unfavoriteCommand = defineCommand149({
   meta: {
     name: "unfavorite",
     description: "Remove a reference section from this company's saved set. Example: baker landing inspiration unfavorite k57abc\u2026"
@@ -33955,7 +34505,7 @@ var unfavoriteCommand = defineCommand145({
 });
 
 // src/commands/landing/inspiration/page.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand150 } from "citty";
 registerSchema({
   command: "landing.inspiration.page",
   description: "Show a whole reference page as a sequence: every section top to bottom with its type and the idea behind it. This is the view to use when the question is how a good page is ORDERED rather than what one section looks like.",
@@ -33972,7 +34522,7 @@ registerSchema({
     }
   }
 });
-var pageCommand = defineCommand146({
+var pageCommand = defineCommand150({
   meta: {
     name: "page",
     description: "Show how a reference page sequences its sections. Example: baker landing inspiration page j91xyz\u2026 \u2014 the blueprint, not the pixels."
@@ -34037,7 +34587,7 @@ var pageCommand = defineCommand146({
 // src/commands/landing/inspiration/scrape.ts
 import { readFile as readFile23 } from "fs/promises";
 import path32 from "path";
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand151 } from "citty";
 
 // src/engine/landing/lib/capturedReferences.ts
 var MAX_STRINGS_PER_SECTION = 40;
@@ -35832,7 +36382,7 @@ registerSchema({
     report: { type: "boolean", description: "Write report.html. `--no-report` to skip", required: false }
   }
 });
-var scrapeCommand = defineCommand147({
+var scrapeCommand = defineCommand151({
   meta: {
     name: "scrape",
     description: "Capture a landing page to a directory, now. Example: baker landing inspiration scrape https://linear.app --out .baker/inspiration/linear.app"
@@ -35911,7 +36461,7 @@ var scrapeCommand = defineCommand147({
 // src/commands/landing/inspiration/search.ts
 import { mkdir as mkdir12, writeFile as writeFile16 } from "fs/promises";
 import path33 from "path";
-import { defineCommand as defineCommand148 } from "citty";
+import { defineCommand as defineCommand152 } from "citty";
 registerSchema({
   command: "landing.inspiration.search",
   description: "Search the shared library of real landing-page sections for reference before you design. Start here: baker landing inspiration search 'pricing with a monthly/annual toggle'. Returns the idea behind each section plus a downloaded screenshot you can Read. Defaults to this company's saved sections; pass --scope all for the whole library.",
@@ -36015,7 +36565,7 @@ async function downloadShots(results) {
   );
   return saved;
 }
-var searchCommand2 = defineCommand148({
+var searchCommand2 = defineCommand152({
   meta: {
     name: "search",
     description: "Search real landing-page sections for reference. Example: baker landing inspiration search 'dark developer hero with a terminal' --register dev-tool-minimal --scope all"
@@ -36103,7 +36653,7 @@ var searchCommand2 = defineCommand148({
 // src/commands/landing/inspiration/view.ts
 import { mkdir as mkdir13, writeFile as writeFile17 } from "fs/promises";
 import path34 from "path";
-import { defineCommand as defineCommand149 } from "citty";
+import { defineCommand as defineCommand153 } from "citty";
 registerSchema({
   command: "landing.inspiration.view",
   description: "Everything known about one section: composition, motion, design tokens, the copy it uses, why it works, and what must change to make it yours. Downloads the desktop and mobile screenshots plus the motion filmstrip so you can look at them.",
@@ -36128,7 +36678,7 @@ async function download(url, file) {
     return null;
   }
 }
-var viewCommand2 = defineCommand149({
+var viewCommand2 = defineCommand153({
   meta: {
     name: "view",
     description: "Full detail for one reference section. Example: baker landing inspiration view k57abc\u2026 \u2014 read the screenshots it saves before you build."
@@ -36211,7 +36761,7 @@ var viewCommand2 = defineCommand149({
 });
 
 // src/commands/landing/inspiration/index.ts
-var inspirationCommand = defineCommand150({
+var inspirationCommand = defineCommand154({
   meta: {
     name: "inspiration",
     description: `Reference library of real landing-page sections \u2014 look at how good pages actually solve a problem before you design one.
@@ -36253,7 +36803,7 @@ Full guide: __tooling__/docs/tools/baker/landing.md`
 });
 
 // src/commands/landing/index.ts
-var landingCommand = defineCommand151({
+var landingCommand = defineCommand155({
   meta: {
     name: "landing",
     description: `Design-quality tools for landing pages (src/pages/<slug>/).
@@ -36271,7 +36821,7 @@ Subcommands:
 });
 
 // src/commands/mcp/index.ts
-import { defineCommand as defineCommand152 } from "citty";
+import { defineCommand as defineCommand156 } from "citty";
 
 // src/commands/mcp/platforms.ts
 function readsKey(label) {
@@ -36340,7 +36890,7 @@ registerSchema({
   description: "List everything this chat can reach: managed integrations (Attio, Slack, Gmail, Google Sheets, \u2026), custom MCP servers, and the platforms the company signed in to (HubSpot, Google Ads, GA4, Search Console, Tag Manager) which you read through their own `baker` commands. Start here when the user mentions an external tool or platform.",
   args: {}
 });
-var connectedCommand = defineCommand152({
+var connectedCommand = defineCommand156({
   meta: {
     name: "connected",
     description: `Everything this chat can reach \u2014 managed integrations, custom MCP servers, and connected platforms.
@@ -36399,7 +36949,7 @@ registerSchema({
   description: "List the custom MCP servers this company's chats see (org + company + your own user scope).",
   args: {}
 });
-var listCommand13 = defineCommand152({
+var listCommand14 = defineCommand156({
   meta: { name: "list", description: "List custom MCP servers visible to this company's chats." },
   run: async () => {
     try {
@@ -36436,7 +36986,7 @@ registerSchema({
     header: { type: "string", description: 'Auth header "Key: Value" (repeatable)', required: false }
   }
 });
-var addCommand2 = defineCommand152({
+var addCommand2 = defineCommand156({
   meta: {
     name: "add",
     description: `Register a custom MCP server. Tools appear as mcp__<name>__* on the NEXT message.
@@ -36488,7 +37038,7 @@ registerSchema({
   description: "Remove a company custom MCP server by name.",
   args: { name: { type: "string", description: "Server name to remove", required: true } }
 });
-var removeCommand4 = defineCommand152({
+var removeCommand4 = defineCommand156({
   meta: {
     name: "remove",
     description: `Remove a company custom MCP server by name.
@@ -36510,7 +37060,7 @@ Example:
     }
   }
 });
-var mcpCommand = defineCommand152({
+var mcpCommand = defineCommand156({
   meta: {
     name: "mcp",
     description: `Third-party tools for this company \u2014 see what's connected, register custom HTTPS MCP endpoints.
@@ -36529,17 +37079,17 @@ Full guide: __tooling__/docs/tools/baker/mcp.md`
   },
   subCommands: {
     connected: connectedCommand,
-    list: listCommand13,
+    list: listCommand14,
     add: addCommand2,
     remove: removeCommand4
   }
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand163 } from "citty";
+import { defineCommand as defineCommand167 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand153 } from "citty";
+import { defineCommand as defineCommand157 } from "citty";
 
 // src/commands/research/output.ts
 var RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data \u2014 not exact figures. Use for directional insights, not precise measurement.";
@@ -36652,7 +37202,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand153({
+var advertisersCommand = defineCommand157({
   meta: {
     name: "advertisers",
     description: `Find domains competing for a keyword in Google SERPs.
@@ -36699,7 +37249,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand154 } from "citty";
+import { defineCommand as defineCommand158 } 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. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -36722,7 +37272,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand154({
+var autocompleteCommand = defineCommand158({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -36768,7 +37318,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand155 } from "citty";
+import { defineCommand as defineCommand159 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -36825,7 +37375,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand155({
+var countriesCommand = defineCommand159({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -36836,7 +37386,7 @@ var countriesCommand = defineCommand155({
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand156 } from "citty";
+import { defineCommand as defineCommand160 } from "citty";
 registerSchema({
   command: "research.intent",
   description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. IMPORTANT: If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
@@ -36859,7 +37409,7 @@ var FIELDS6 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand156({
+var intentCommand = defineCommand160({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -36907,7 +37457,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand157 } from "citty";
+import { defineCommand as defineCommand161 } from "citty";
 registerSchema({
   command: "research.keyword-gap",
   description: "Find keywords a competitor ranks for (organic or paid) that you don't. Discovers expansion opportunities. IMPORTANT: 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.",
@@ -36936,7 +37486,7 @@ var FIELDS7 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand157({
+var keywordGapCommand = defineCommand161({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -37010,7 +37560,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand158 } from "citty";
+import { defineCommand as defineCommand162 } 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. IMPORTANT: 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.",
@@ -37043,7 +37593,7 @@ var FIELDS8 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand158({
+var keywordsForSiteCommand = defineCommand162({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -37096,7 +37646,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand159 } from "citty";
+import { defineCommand as defineCommand163 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -37126,7 +37676,7 @@ var FIELDS9 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand159({
+var languagesCommand2 = defineCommand163({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -37137,7 +37687,7 @@ var languagesCommand2 = defineCommand159({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand160 } from "citty";
+import { defineCommand as defineCommand164 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -37156,7 +37706,7 @@ var FIELDS10 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand160({
+var lighthouseCommand = defineCommand164({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -37194,7 +37744,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand161 } from "citty";
+import { defineCommand as defineCommand165 } 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. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
@@ -37220,7 +37770,7 @@ var FIELDS11 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand161({
+var relevantPagesCommand = defineCommand165({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -37266,7 +37816,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand162 } from "citty";
+import { defineCommand as defineCommand166 } 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).",
@@ -37317,7 +37867,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand162({
+var webCommand = defineCommand166({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -37377,7 +37927,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand163({
+var researchCommand = defineCommand167({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -37418,10 +37968,10 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand174 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand164 } from "citty";
+import { defineCommand as defineCommand168 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -37429,11 +37979,11 @@ var TEMP_ID_PREFIX = "temp_";
 function writeOk2(data) {
   writeJson({ ok: true, data: data ?? null });
 }
-function failValidation3(message) {
+function failValidation4(message) {
   writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
-function failApi2(err) {
+function failApi3(err) {
   if (err instanceof ApiError) {
     writeJson({ ok: false, error: { code: err.code, message: err.message } });
     process.exit(1);
@@ -37453,7 +38003,7 @@ function isOtherTempId(id) {
 }
 function validateScheduledActionRef(ref) {
   if (isOtherTempId(ref)) {
-    failValidation3(`Scheduled action temp IDs must start with ${TEMP_SCHEDULED_ACTION_PREFIX}.`);
+    failValidation4(`Scheduled action temp IDs must start with ${TEMP_SCHEDULED_ACTION_PREFIX}.`);
   }
   if (!isTempScheduledActionId(ref)) {
     validateConvexId(ref);
@@ -37467,7 +38017,7 @@ function isPromptWithoutAgent(args, agentDisabled) {
 }
 function failIfPromptWithoutAgent(args, agentDisabled) {
   if (isPromptWithoutAgent(args, agentDisabled)) {
-    failValidation3(
+    failValidation4(
       "--prompt only applies when an agent is spawned; it has no effect with --no-spawn-agent or --spawn-agent false."
     );
   }
@@ -37482,21 +38032,21 @@ function parseBooleanFlag(raw, flagName) {
   if (raw === false || raw === "false") {
     return false;
   }
-  failValidation3(`${flagName} must be true or false.`);
+  failValidation4(`${flagName} must be true or false.`);
 }
 function buildScheduleBody(args, options) {
   const cron = args.cron;
   const runAt = args["run-at"];
   const timezone = args.timezone;
   if (cron && runAt) {
-    failValidation3("--cron and --run-at are mutually exclusive.");
+    failValidation4("--cron and --run-at are mutually exclusive.");
   }
   if (runAt) {
     if (!runAt.endsWith("Z")) {
-      failValidation3("--run-at must be an ISO UTC timestamp ending in Z.");
+      failValidation4("--run-at must be an ISO UTC timestamp ending in Z.");
     }
     if (!Number.isFinite(Date.parse(runAt))) {
-      failValidation3("--run-at must be a valid ISO timestamp.");
+      failValidation4("--run-at must be a valid ISO timestamp.");
     }
     return { runAt, ...timezone ? { timezone } : {} };
   }
@@ -37507,7 +38057,7 @@ function buildScheduleBody(args, options) {
     return { timezone };
   }
   if (options.required) {
-    failValidation3("Provide exactly one of --cron or --run-at.");
+    failValidation4("Provide exactly one of --cron or --run-at.");
   }
   return void 0;
 }
@@ -37536,7 +38086,7 @@ registerSchema({
     prompt: { type: "string", description: "Additional prompt instructions for the spawned agent", required: false }
   }
 });
-var createCommand2 = defineCommand164({
+var createCommand2 = defineCommand168({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -37556,10 +38106,10 @@ var createCommand2 = defineCommand164({
       const name = args.name;
       const description = args.description;
       if (!name || name.trim().length === 0) {
-        failValidation3("--name is required.");
+        failValidation4("--name is required.");
       }
       if (!description || description.trim().length === 0) {
-        failValidation3("--description is required.");
+        failValidation4("--description is required.");
       }
       const schedule = buildScheduleBody(args, { required: true });
       const chatId = requireChatId();
@@ -37579,13 +38129,13 @@ var createCommand2 = defineCommand164({
       const response = await apiPost("/api/scheduled-actions/create", body);
       writeJson(response);
     } catch (err) {
-      failApi2(err);
+      failApi3(err);
     }
   }
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand165 } from "citty";
+import { defineCommand as defineCommand169 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -37593,7 +38143,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand2 = defineCommand165({
+var deleteCommand2 = defineCommand169({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -37610,19 +38160,19 @@ var deleteCommand2 = defineCommand165({
     try {
       const id = args.id || args["scheduled-action-id"];
       if (!id) {
-        failValidation3("Scheduled action ID is required.");
+        failValidation4("Scheduled action ID is required.");
       }
       validateScheduledActionRef(id);
       await apiPost("/api/scheduled-actions/delete", { chatId: requireChatId(), id });
       writeOk2();
     } catch (err) {
-      failApi2(err);
+      failApi3(err);
     }
   }
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand166 } from "citty";
+import { defineCommand as defineCommand170 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -37631,7 +38181,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var getCommand3 = defineCommand166({
+var getCommand3 = defineCommand170({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -37649,13 +38199,13 @@ var getCommand3 = defineCommand166({
     try {
       const id = args.id || args["scheduled-action-id"];
       if (!id) {
-        failValidation3("Scheduled action ID is required.");
+        failValidation4("Scheduled action ID is required.");
       }
       validateScheduledActionRef(id);
       const env = getEnv();
       const chatId = typeof args.chat === "string" && args.chat.length > 0 ? args.chat : env.BAKER_CHAT_ID;
       if (isTempScheduledActionId(id) && !chatId) {
-        failValidation3("BAKER_CHAT_ID or --chat is required to get a temp scheduled action ID.");
+        failValidation4("BAKER_CHAT_ID or --chat is required to get a temp scheduled action ID.");
       }
       const body = { id };
       if (chatId) {
@@ -37664,13 +38214,13 @@ var getCommand3 = defineCommand166({
       const response = await apiPost("/api/scheduled-actions/get", body);
       writeJson(response);
     } catch (err) {
-      failApi2(err);
+      failApi3(err);
     }
   }
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand167 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 registerSchema({
   command: "scheduled-actions.list",
   description: "List published scheduled actions. Includes draft state when BAKER_CHAT_ID is set, or --chat <id> to read an earlier chat's staged schedules instead.",
@@ -37678,7 +38228,7 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var listCommand14 = defineCommand167({
+var listCommand15 = defineCommand171({
   meta: {
     name: "list",
     description: "List scheduled actions. Includes staged draft ops when BAKER_CHAT_ID is set, or --chat <id> to read an earlier chat's staged schedules instead."
@@ -37695,13 +38245,13 @@ var listCommand14 = defineCommand167({
       const response = await apiPost("/api/scheduled-actions/list", body);
       writeJson(response);
     } catch (err) {
-      failApi2(err);
+      failApi3(err);
     }
   }
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 registerSchema({
   command: "scheduled-actions.trigger",
   description: "Immediately trigger a published scheduled action. Does not require BAKER_CHAT_ID and rejects temp_sched_* IDs.",
@@ -37709,7 +38259,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand168({
+var triggerCommand = defineCommand172({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -37726,10 +38276,10 @@ var triggerCommand = defineCommand168({
     try {
       const id = args.id || args["scheduled-action-id"];
       if (!id) {
-        failValidation3("Scheduled action ID is required.");
+        failValidation4("Scheduled action ID is required.");
       }
       if (isTempScheduledActionId(id)) {
-        failValidation3("trigger requires a published scheduled action ID, not temp_sched_*.");
+        failValidation4("trigger requires a published scheduled action ID, not temp_sched_*.");
       }
       validateConvexId(id);
       const env = getEnv();
@@ -37740,13 +38290,13 @@ var triggerCommand = defineCommand168({
       const response = await apiPost("/api/scheduled-actions/trigger", body);
       writeJson(response);
     } catch (err) {
-      failApi2(err);
+      failApi3(err);
     }
   }
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand173 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -37771,7 +38321,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand2 = defineCommand169({
+var updateCommand2 = defineCommand173({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
@@ -37796,7 +38346,7 @@ var updateCommand2 = defineCommand169({
     try {
       const id = args.id || args["scheduled-action-id"];
       if (!id) {
-        failValidation3("Scheduled action ID is required.");
+        failValidation4("Scheduled action ID is required.");
       }
       validateScheduledActionRef(id);
       const body = { id };
@@ -37828,7 +38378,7 @@ var updateCommand2 = defineCommand169({
         hasPatch = true;
       }
       if (!hasPatch) {
-        failValidation3(
+        failValidation4(
           "Provide at least one of --name, --description, --cron, --run-at, --timezone, --enabled, --spawn-agent, --prompt."
         );
       }
@@ -37836,13 +38386,13 @@ var updateCommand2 = defineCommand169({
       await apiPost("/api/scheduled-actions/update", body);
       writeOk2();
     } catch (err) {
-      failApi2(err);
+      failApi3(err);
     }
   }
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand170({
+var scheduledActionsCommand = defineCommand174({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger.
@@ -37859,7 +38409,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
   },
   subCommands: {
-    list: listCommand14,
+    list: listCommand15,
     get: getCommand3,
     create: createCommand2,
     update: updateCommand2,
@@ -37869,14 +38419,14 @@ Full guide: __tooling__/docs/tools/baker/scheduled-actions.md`
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand175 } 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 schemaCommand = defineCommand171({
+var schemaCommand = defineCommand175({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -37920,14 +38470,14 @@ var schemaCommand = defineCommand171({
 });
 
 // src/commands/studio/index.ts
-import { defineCommand as defineCommand180 } from "citty";
+import { defineCommand as defineCommand184 } from "citty";
 
 // src/commands/studio/animate.ts
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand176 } from "citty";
 
 // src/commands/studio/batch.ts
 function projectBatch(generation, full) {
-  const compact = {
+  const compact2 = {
     generationId: generation.generationId,
     kind: generation.kind,
     status: generation.status,
@@ -37944,9 +38494,9 @@ function projectBatch(generation, full) {
       ...variant.error ? { error: variant.error } : {}
     }))
   };
-  if (!full) return compact;
+  if (!full) return compact2;
   return {
-    ...compact,
+    ...compact2,
     ...generation.skillId ? { skillId: generation.skillId } : {},
     ...generation.imageSettings ? { imageSettings: generation.imageSettings } : {},
     ...generation.clipSettings ? { clipSettings: generation.clipSettings } : {},
@@ -38012,7 +38562,7 @@ function resolveMaxWaitMs(wait, maxWait, defaultMs) {
   const parsed = Number(maxWait);
   return Number.isFinite(parsed) && parsed >= 0 ? parsed : defaultMs;
 }
-var POLL_INTERVAL_MS5 = 3e3;
+var POLL_INTERVAL_MS6 = 3e3;
 var defaultPollDeps = {
   get: async (generationId) => {
     const response = await apiGet(`/api/studio/generations/${generationId}`);
@@ -38025,7 +38575,7 @@ async function pollBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
   while (Date.now() < deadline) {
     const generation = await deps.get(generationId);
     if (generation.status !== "running") return generation;
-    await deps.sleep(POLL_INTERVAL_MS5);
+    await deps.sleep(POLL_INTERVAL_MS6);
   }
   return null;
 }
@@ -38368,7 +38918,7 @@ function costHintsFor(body) {
   }
   return hints;
 }
-var animateCommand = defineCommand172({
+var animateCommand = defineCommand176({
   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 '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"
@@ -38487,7 +39037,7 @@ var animateCommand = defineCommand172({
 });
 
 // src/commands/studio/generate.ts
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand177 } from "citty";
 var MODEL_LIST2 = IMAGE_MODEL_IDS;
 var DEFAULT_MAX_WAIT_MS2 = 24e4;
 registerSchema({
@@ -38617,7 +39167,7 @@ function buildGenerateBody(args, prompt) {
   }
   return body;
 }
-var generateCommand = defineCommand173({
+var generateCommand = defineCommand177({
   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]]'"
@@ -38695,7 +39245,7 @@ var generateCommand = defineCommand173({
 });
 
 // src/commands/studio/get.ts
-import { defineCommand as defineCommand174 } from "citty";
+import { defineCommand as defineCommand178 } 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.",
@@ -38704,7 +39254,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var getCommand4 = defineCommand174({
+var getCommand4 = defineCommand178({
   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"
@@ -38733,7 +39283,7 @@ var getCommand4 = defineCommand174({
 });
 
 // src/commands/studio/improve.ts
-import { defineCommand as defineCommand175 } from "citty";
+import { defineCommand as defineCommand179 } from "citty";
 var DESCRIPTION = "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",
@@ -38758,7 +39308,7 @@ registerSchema({
     }
   }
 });
-var improveCommand = defineCommand175({
+var improveCommand = defineCommand179({
   meta: {
     name: "improve",
     description: `${DESCRIPTION}
@@ -38802,7 +39352,7 @@ Examples:
 });
 
 // src/commands/studio/keep.ts
-import { defineCommand as defineCommand176 } from "citty";
+import { defineCommand as defineCommand180 } 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.",
@@ -38812,7 +39362,7 @@ registerSchema({
     undo: { type: "boolean", description: "Un-star an image, or take a kept clip back out", required: false }
   }
 });
-var keepCommand = defineCommand176({
+var keepCommand = defineCommand180({
   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"
@@ -38863,7 +39413,7 @@ var keepCommand = defineCommand176({
 });
 
 // src/commands/studio/list.ts
-import { defineCommand as defineCommand177 } from "citty";
+import { defineCommand as defineCommand181 } 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.",
@@ -38874,7 +39424,7 @@ registerSchema({
     full: { type: "boolean", description: "Include settings, references and attribution", required: false }
   }
 });
-var listCommand15 = defineCommand177({
+var listCommand16 = defineCommand181({
   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"
@@ -38908,7 +39458,7 @@ var listCommand15 = defineCommand177({
 });
 
 // src/commands/studio/models.ts
-import { defineCommand as defineCommand178 } from "citty";
+import { defineCommand as defineCommand182 } from "citty";
 var DESCRIPTION2 = "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",
@@ -38995,7 +39545,7 @@ function buildModelCards(kind, model) {
   const selected = model ? ids.filter((id) => id === model) : ids;
   return selected.map((id) => build(id));
 }
-var modelsCommand = defineCommand178({
+var modelsCommand = defineCommand182({
   meta: {
     name: "models",
     description: `${DESCRIPTION2}
@@ -39042,13 +39592,13 @@ Examples:
 });
 
 // src/commands/studio/skills.ts
-import { defineCommand as defineCommand179 } from "citty";
+import { defineCommand as defineCommand183 } 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 = defineCommand179({
+var skillsCommand = defineCommand183({
   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"
@@ -39072,7 +39622,7 @@ var skillsCommand = defineCommand179({
 });
 
 // src/commands/studio/index.ts
-var studioCommand = defineCommand180({
+var studioCommand = defineCommand184({
   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.
@@ -39106,7 +39656,7 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
     generate: generateCommand,
     animate: animateCommand,
     get: getCommand4,
-    list: listCommand15,
+    list: listCommand16,
     keep: keepCommand,
     models: modelsCommand,
     skills: skillsCommand,
@@ -39115,14 +39665,14 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 });
 
 // src/commands/tag-manager/index.ts
-import { defineCommand as defineCommand184 } from "citty";
+import { defineCommand as defineCommand188 } from "citty";
 
 // src/commands/tag-manager/draft.ts
-import { defineCommand as defineCommand181 } from "citty";
+import { defineCommand as defineCommand185 } from "citty";
 
 // src/commands/tag-manager/shared.ts
 import { readFileSync as readFileSync13 } from "fs";
-function failValidation4(message) {
+function failValidation5(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
   process.exit(1);
 }
@@ -39130,7 +39680,7 @@ function requireTarget5(args, entity) {
   const positional = Array.isArray(args._) ? args._[0] : void 0;
   const target = args.id ?? args.target ?? positional;
   if (typeof target !== "string" || target.length === 0) {
-    failValidation4(`pass the ${entity} id or path as the positional argument`);
+    failValidation5(`pass the ${entity} id or path as the positional argument`);
   }
   return target;
 }
@@ -39139,16 +39689,16 @@ function loadJsonArg2(args, flag = "json") {
   const file = args.file;
   const raw = typeof file === "string" && file.length > 0 ? readFileSync13(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
   if (raw === void 0) {
-    failValidation4(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
+    failValidation5(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
   }
   try {
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      failValidation4(`--${flag} must be a JSON object`);
+      failValidation5(`--${flag} must be a JSON object`);
     }
     return parsed;
   } catch {
-    return failValidation4(`--${flag} is not valid JSON`);
+    return failValidation5(`--${flag} is not valid JSON`);
   }
 }
 var RETRYABLE_CODES2 = /* @__PURE__ */ new Set(["RATE_LIMITED", "INTERNAL_ERROR", "NETWORK_ERROR", "TIMEOUT"]);
@@ -39241,13 +39791,13 @@ registerSchema({
     chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
   }
 });
-var draftCommand4 = defineCommand181({
+var draftCommand4 = defineCommand185({
   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: defineCommand181({
+    list: defineCommand185({
       meta: {
         name: "list",
         description: "Review everything staged on this chat (--json for the raw envelope)"
@@ -39260,7 +39810,7 @@ var draftCommand4 = defineCommand181({
         await draftList2(args.json === true, args.chat);
       }
     }),
-    show: defineCommand181({
+    show: defineCommand185({
       meta: {
         name: "show",
         description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
@@ -39277,7 +39827,7 @@ var draftCommand4 = defineCommand181({
         );
       }
     }),
-    amend: defineCommand181({
+    amend: defineCommand185({
       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."
@@ -39294,7 +39844,7 @@ var draftCommand4 = defineCommand181({
         });
       }
     }),
-    remove: defineCommand181({
+    remove: defineCommand185({
       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 }) => {
@@ -39303,7 +39853,7 @@ var draftCommand4 = defineCommand181({
         });
       }
     }),
-    clear: defineCommand181({
+    clear: defineCommand185({
       meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
       run: async () => {
         await draftAction3("/api/tag-manager/draft/clear", {});
@@ -39313,7 +39863,7 @@ var draftCommand4 = defineCommand181({
 });
 
 // src/commands/tag-manager/read.ts
-import { defineCommand as defineCommand182 } from "citty";
+import { defineCommand as defineCommand186 } 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.",
@@ -39354,7 +39904,7 @@ function containersHints(containers) {
     }))
   });
 }
-var containersCommand = defineCommand182({
+var containersCommand = defineCommand186({
   meta: {
     name: "containers",
     description: `List Tag Manager containers reachable by this company's connection.
@@ -39371,7 +39921,7 @@ Start here:
     }
   }
 });
-var readCommand = defineCommand182({
+var readCommand = defineCommand186({
   meta: {
     name: "read",
     description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
@@ -39413,7 +39963,7 @@ Examples:
 });
 
 // src/commands/tag-manager/write-commands.ts
-import { defineCommand as defineCommand183 } from "citty";
+import { defineCommand as defineCommand187 } from "citty";
 var CONTAINER_ARG_DESCRIPTION = "Numeric container id (optional only when one container is connected \u2014 run `baker tag-manager containers`)";
 var ENTITIES = [
   {
@@ -39469,10 +40019,10 @@ for (const { entity, noun, createHint } of ENTITIES) {
   });
 }
 function entityCommand(entity, noun, example) {
-  return defineCommand183({
+  return defineCommand187({
     meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
     subCommands: {
-      create: defineCommand183({
+      create: defineCommand187({
         meta: {
           name: "create",
           description: `Stage a new ${noun}
@@ -39494,7 +40044,7 @@ Examples:
           });
         }
       }),
-      update: defineCommand183({
+      update: defineCommand187({
         meta: {
           name: "update",
           description: `Stage an update to an existing ${noun} (pass its id or path)`
@@ -39514,7 +40064,7 @@ Examples:
           });
         }
       }),
-      delete: defineCommand183({
+      delete: defineCommand187({
         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 },
@@ -39555,7 +40105,7 @@ function builtinTypes(args) {
   }
   return raw.split(",").map((entry) => entry.trim());
 }
-var builtinCommand = defineCommand183({
+var builtinCommand = defineCommand187({
   meta: {
     name: "builtin",
     description: `Enable or disable built-in variables
@@ -39565,7 +40115,7 @@ Examples:
   baker tag-manager builtin disable --types formId`
   },
   subCommands: {
-    enable: defineCommand183({
+    enable: defineCommand187({
       meta: { name: "enable", description: "Stage enabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -39579,7 +40129,7 @@ Examples:
         });
       }
     }),
-    disable: defineCommand183({
+    disable: defineCommand187({
       meta: { name: "disable", description: "Stage disabling built-in variables" },
       args: {
         types: { type: "string", description: "Comma-separated types", required: false },
@@ -39597,7 +40147,7 @@ Examples:
 });
 
 // src/commands/tag-manager/index.ts
-var tagManagerCommand = defineCommand184({
+var tagManagerCommand = defineCommand188({
   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.
@@ -39634,10 +40184,10 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 });
 
 // src/commands/tags/index.ts
-import { defineCommand as defineCommand185 } from "citty";
+import { defineCommand as defineCommand189 } from "citty";
 
 // src/commands/tags/shared.ts
-function failApi3(err) {
+function failApi4(err) {
   if (err instanceof ApiError) {
     writeJson({ ok: false, error: { code: err.code, message: err.message } });
     process.exit(1);
@@ -39697,13 +40247,13 @@ async function listTags(json) {
     process.stdout.write(`${response.tags.map(renderEffectiveEntry).join("\n")}
 `);
   } catch (err) {
-    failApi3(err);
+    failApi4(err);
   }
 }
 var listArgs9 = {
   json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
 };
-var listCommand16 = defineCommand185({
+var listCommand17 = defineCommand189({
   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"
@@ -39719,10 +40269,10 @@ async function listDraft3(chat) {
     const response = await apiPost("/api/tags/draft", { chatId });
     writeJson({ ok: true, data: response });
   } catch (err) {
-    failApi3(err);
+    failApi4(err);
   }
 }
-var draftCommand5 = defineCommand185({
+var draftCommand5 = defineCommand189({
   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."
@@ -39732,7 +40282,7 @@ var draftCommand5 = defineCommand185({
     await listDraft3(args.chat);
   }
 });
-var tagsCommand3 = defineCommand185({
+var tagsCommand3 = defineCommand189({
   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.
@@ -39749,7 +40299,7 @@ Examples:
 Full guide: __tooling__/docs/tools/baker/tags.md`
   },
   subCommands: {
-    list: listCommand16,
+    list: listCommand17,
     draft: draftCommand5
   },
   // Bare `baker tags` lists the effective tags. `args` stays so citty knows this
@@ -39761,10 +40311,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand189 } from "citty";
+import { defineCommand as defineCommand193 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand186 } from "citty";
+import { defineCommand as defineCommand190 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -39772,7 +40322,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand5 = defineCommand186({
+var getCommand5 = defineCommand190({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -39809,7 +40359,7 @@ var getCommand5 = defineCommand186({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand187 } from "citty";
+import { defineCommand as defineCommand191 } from "citty";
 registerSchema({
   command: "testimonials.list",
   description: "List testimonials with optional filters.",
@@ -39839,7 +40389,7 @@ registerSchema({
     limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
   }
 });
-var listCommand17 = defineCommand187({
+var listCommand18 = defineCommand191({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -39888,7 +40438,7 @@ var listCommand17 = defineCommand187({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand188 } from "citty";
+import { defineCommand as defineCommand192 } from "citty";
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
     return null;
@@ -39966,7 +40516,7 @@ function buildSearchRequest(query, args) {
   }
   return body;
 }
-var searchCommand3 = defineCommand188({
+var searchCommand3 = defineCommand192({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -40022,7 +40572,7 @@ var searchCommand3 = defineCommand188({
 var tagsCommand4 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand189({
+var testimonialsCommand = defineCommand193({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -40038,16 +40588,16 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
   subCommands: {
     get: getCommand5,
     search: searchCommand3,
-    list: listCommand17,
+    list: listCommand18,
     tags: tagsCommand4
   }
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand195 } from "citty";
+import { defineCommand as defineCommand199 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand190 } from "citty";
+import { defineCommand as defineCommand194 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -40061,7 +40611,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand3 = defineCommand190({
+var deleteCommand3 = defineCommand194({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -40102,7 +40652,7 @@ var deleteCommand3 = defineCommand190({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand191 } from "citty";
+import { defineCommand as defineCommand195 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -40110,7 +40660,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand6 = defineCommand191({
+var getCommand6 = defineCommand195({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -40147,7 +40697,7 @@ var getCommand6 = defineCommand191({
 });
 
 // src/commands/videos/group.ts
-import { defineCommand as defineCommand192 } from "citty";
+import { defineCommand as defineCommand196 } 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)",
@@ -40156,7 +40706,7 @@ registerSchema({
     "group-key": { type: "string", description: "The set key directly, when you already have it", required: false }
   }
 });
-var groupCommand2 = defineCommand192({
+var groupCommand2 = defineCommand196({
   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>"
@@ -40176,7 +40726,7 @@ var groupCommand2 = defineCommand192({
 });
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand193 } from "citty";
+import { defineCommand as defineCommand197 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -40186,7 +40736,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand4 = defineCommand193({
+var searchCommand4 = defineCommand197({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -40238,7 +40788,7 @@ var tagsCommand5 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile24, stat as stat7 } from "fs/promises";
 import { basename as basename2, extname as extname3 } from "path";
-import { defineCommand as defineCommand194 } from "citty";
+import { defineCommand as defineCommand198 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -40277,7 +40827,7 @@ function detectContentType(filePath) {
   }
   return mime;
 }
-var uploadCommand2 = defineCommand194({
+var uploadCommand2 = defineCommand198({
   meta: {
     name: "upload",
     description: "Upload a video file to Baker via Mux direct upload. Auto-detects content type. Example: baker videos upload ./demo.mp4"
@@ -40347,7 +40897,7 @@ var uploadCommand2 = defineCommand194({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand195({
+var videosCommand = defineCommand199({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete, tags.
@@ -40372,10 +40922,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand208 } from "citty";
+import { defineCommand as defineCommand212 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand196 } from "citty";
+import { defineCommand as defineCommand200 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList2(value) {
@@ -40415,12 +40965,12 @@ function compactAdvertiser(record) {
   };
 }
 function advertiserNormalizer(record, full) {
-  const compact = compactAdvertiser(record);
+  const compact2 = compactAdvertiser(record);
   if (!full) {
-    return compact;
+    return compact2;
   }
   return {
-    ...compact,
+    ...compact2,
     scraped_name: record.scraped_name ?? null,
     image_url: record.image_url ?? null,
     platforms: Array.isArray(record.platforms) ? record.platforms : [],
@@ -40428,7 +40978,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand196({
+var advertisersCommand2 = defineCommand200({
   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'
@@ -40486,7 +41036,7 @@ var advertisersCommand2 = defineCommand196({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand197 } from "citty";
+import { defineCommand as defineCommand201 } 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.",
@@ -40532,7 +41082,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand197({
+var briefCommand = defineCommand201({
   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`
@@ -40568,7 +41118,7 @@ var briefCommand = defineCommand197({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand198 } from "citty";
+import { defineCommand as defineCommand202 } 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.",
@@ -40581,7 +41131,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand198({
+var contentCommand = defineCommand202({
   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"
@@ -40630,7 +41180,7 @@ var contentCommand = defineCommand198({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand199 } from "citty";
+import { defineCommand as defineCommand203 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList2(input.advertiser);
@@ -40682,7 +41232,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand = defineCommand199({
+var feedCommand = defineCommand203({
   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"
@@ -40767,7 +41317,7 @@ var feedCommand = defineCommand199({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand200 } from "citty";
+import { defineCommand as defineCommand204 } from "citty";
 var PLATFORMS = ["meta", "linkedin"];
 registerSchema({
   command: "winning-ads.follow",
@@ -40782,7 +41332,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand200({
+var followCommand = defineCommand204({
   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 both Meta + LinkedIn. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -40829,7 +41379,7 @@ var followCommand = defineCommand200({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand201 } from "citty";
+import { defineCommand as defineCommand205 } from "citty";
 var PLATFORMS2 = ["meta", "linkedin"];
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -40862,7 +41412,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand201({
+var followCompetitorsCommand = defineCommand205({
   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"'
@@ -40937,7 +41487,7 @@ var followCompetitorsCommand = defineCommand201({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand202 } from "citty";
+import { defineCommand as defineCommand206 } 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.",
@@ -40960,17 +41510,17 @@ function compactFollowed(record) {
   };
 }
 function followingNormalizer(record, full) {
-  const compact = compactFollowed(record);
+  const compact2 = compactFollowed(record);
   if (!full) {
-    return compact;
+    return compact2;
   }
   return {
-    ...compact,
+    ...compact2,
     image_url: record.image_url ?? null,
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand202({
+var followingCommand = defineCommand206({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. Example: baker winning-ads following --output md"
@@ -41005,7 +41555,7 @@ var followingCommand = defineCommand202({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand203 } from "citty";
+import { defineCommand as defineCommand207 } 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.",
@@ -41044,7 +41594,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand203({
+var patternsCommand = defineCommand207({
   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"
@@ -41100,7 +41650,7 @@ var patternsCommand = defineCommand203({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand204 } from "citty";
+import { defineCommand as defineCommand208 } 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.",
@@ -41208,7 +41758,7 @@ function buildSearchBody2(args) {
   }
   return body;
 }
-var searchCommand5 = defineCommand204({
+var searchCommand5 = defineCommand208({
   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"
@@ -41323,7 +41873,7 @@ var searchCommand5 = defineCommand204({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand205 } from "citty";
+import { defineCommand as defineCommand209 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -41351,7 +41901,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand205({
+  return defineCommand209({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -41400,7 +41950,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand206 } from "citty";
+import { defineCommand as defineCommand210 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -41408,7 +41958,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand206({
+var unfollowCommand = defineCommand210({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -41429,7 +41979,7 @@ var unfollowCommand = defineCommand206({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand207 } from "citty";
+import { defineCommand as defineCommand211 } 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.",
@@ -41439,7 +41989,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false }
   }
 });
-var winnersCommand = defineCommand207({
+var winnersCommand = defineCommand211({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -41489,7 +42039,7 @@ var winnersCommand = defineCommand207({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand208({
+var winningAdsCommand = defineCommand212({
   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.
@@ -41561,7 +42111,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand209({
+var main = defineCommand213({
   meta: {
     name: "baker",
     version: getCliVersion(),
@@ -41576,6 +42126,7 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
   subCommands: {
     capabilities: capabilitiesCommand,
     actions: actionsCommand,
+    agents: agentsCommand,
     "scheduled-actions": scheduledActionsCommand,
     ads: adsCommand2,
     brand: brandCommand,