@koda-sl/baker-cli 0.99.0-dev.40c99be71 → 0.99.1-dev.5b1957cc

package/dist/cli.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import {
-  AssetRef,
   ELEVENLABS_MAX_MUSIC_LENGTH_MS,
   IMAGE_GENERATE_MODELS,
   MODEL_REGISTRY,
@@ -8,16 +7,15 @@ import {
   ValidationError,
   createEngineFromEnv,
   defaultRegistry,
-  extForMime,
   generateCatalog,
   validateCanvasDeep
-} from "./chunk-FOK2JPRW.js";
+} from "./chunk-26K7V346.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand150, runMain } from "citty";
+import { defineCommand as defineCommand152, runMain } from "citty";
 
 // src/commands/actions/index.ts
-import { defineCommand as defineCommand17 } from "citty";
+import { defineCommand as defineCommand18 } from "citty";
 
 // src/commands/actions/claim.ts
 import { defineCommand } from "citty";
@@ -45,9 +43,6 @@ function getEnv() {
   }
   return cached;
 }
-function runtimeEnvVar(name) {
-  return process.env[name];
-}
 function requireChatId() {
   const env = getEnv();
   if (!env.BAKER_CHAT_ID) {
@@ -152,9 +147,9 @@ async function handleResponse(response) {
     throw new ApiError("INTERNAL_ERROR", "Failed to parse API response as JSON");
   }
 }
-async function apiGet(path12, params) {
+async function apiGet(path11, params) {
   const env = getEnv();
-  const url = new URL(path12, env.BAKER_API_URL);
+  const url = new URL(path11, env.BAKER_API_URL);
   if (params) {
     const clean = sanitizeParams(params);
     for (const [key, value] of Object.entries(clean)) {
@@ -179,12 +174,12 @@ async function apiGet(path12, params) {
   }
   return handleResponse(response);
 }
-async function apiPost(path12, body, opts) {
+async function apiPost(path11, body, opts) {
   const env = getEnv();
   const timeoutMs = opts?.timeoutMs ?? 6e4;
   let response;
   try {
-    response = await fetchWithRateLimitRetry(new URL(path12, env.BAKER_API_URL).toString(), {
+    response = await fetchWithRateLimitRetry(new URL(path11, env.BAKER_API_URL).toString(), {
       method: "POST",
       headers: {
         Authorization: `Bearer ${env.BAKER_API_KEY}`,
@@ -562,12 +557,17 @@ var claimCommand = defineCommand({
 
 // src/commands/actions/complete.ts
 import { defineCommand as defineCommand2 } from "citty";
+var COMPLETE_NOTE_MIN = 20;
 registerSchema({
   command: "actions.complete",
-  description: "Stage completion of an action (it was DONE). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. Do NOT use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.",
+  description: "Stage completion of an action (it was DONE). Accepts a real action ID (must be claimed) or a temp ID from the same draft. The action becomes completed when the chat is published. --note is REQUIRED and must describe what you actually did to resolve it (what changed, where, and the outcome) \u2014 it is the client-facing record surfaced by `baker actions log`. Do NOT use this to drop an action you no longer want \u2014 to remove a staged op use `actions draft remove`, to close an unwanted published action use `actions discard`.",
   args: {
     id: { type: "string", description: "Action ID or temp ID", required: true },
-    note: { type: "string", description: "What was done \u2014 context for the team and AI", required: false }
+    note: {
+      type: "string",
+      description: "REQUIRED. Detailed description of what you did to resolve this: what changed, where, and the outcome. This is the durable, client-facing record shown by `baker actions log`.",
+      required: true
+    }
   }
 });
 var completeCommand = defineCommand2({
@@ -578,7 +578,11 @@ var completeCommand = defineCommand2({
   args: {
     id: { type: "positional", description: "Action ID or temp ID", required: false },
     "action-id": { type: "string", description: "Action ID or temp ID", required: false },
-    note: { type: "string", description: "What was done \u2014 context for the team and AI", required: false }
+    note: {
+      type: "string",
+      description: "REQUIRED. What you did to resolve this: what changed, where, and the outcome.",
+      required: false
+    }
   },
   run: async ({ args }) => {
     try {
@@ -589,8 +593,14 @@ var completeCommand = defineCommand2({
       if (!isTempId(id)) {
         validateConvexId(id);
       }
+      const note = args.note?.trim() ?? "";
+      if (note.length < COMPLETE_NOTE_MIN) {
+        failValidation(
+          `--note is required and must describe what you did (\u2265${COMPLETE_NOTE_MIN} chars): what changed, where, and the outcome. This becomes the client-facing record surfaced by \`baker actions log\`.`
+        );
+      }
       const chatId = requireChatId();
-      await apiPost("/api/actions/complete", { chatId, actionRef: id, note: args.note });
+      await apiPost("/api/actions/complete", { chatId, actionRef: id, note });
       writeOk();
     } catch (err) {
       failApi(err);
@@ -970,8 +980,77 @@ var listCommand2 = defineCommand8({
   }
 });
 
-// src/commands/actions/release.ts
+// src/commands/actions/log.ts
 import { defineCommand as defineCommand9 } from "citty";
+var DAY_MS = 864e5;
+function startOfLocalDay(date) {
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate()).getTime();
+}
+function resolveWindow(args) {
+  const fromArg = args.from;
+  const toArg = args.to;
+  if (fromArg) {
+    const fromMs = Date.parse(fromArg);
+    if (Number.isNaN(fromMs)) {
+      failValidation(`--from is not a valid ISO date/datetime: ${fromArg}`);
+    }
+    const toMs = toArg ? Date.parse(toArg) : Date.now();
+    if (Number.isNaN(toMs)) {
+      failValidation(`--to is not a valid ISO date/datetime: ${toArg}`);
+    }
+    return { fromMs, toMs };
+  }
+  const since = (args.since ?? "today").trim().toLowerCase();
+  const now = Date.now();
+  if (since === "today") {
+    return { fromMs: startOfLocalDay(new Date(now)), toMs: now };
+  }
+  if (since === "yesterday") {
+    const todayStart = startOfLocalDay(new Date(now));
+    return { fromMs: todayStart - DAY_MS, toMs: todayStart };
+  }
+  const days = /^(\d+)d$/.exec(since);
+  if (days) {
+    return { fromMs: now - Number(days[1]) * DAY_MS, toMs: now };
+  }
+  return failValidation(`--since must be one of: today | yesterday | <N>d (e.g. 7d). Got: ${since}`);
+}
+registerSchema({
+  command: "actions.log",
+  description: "List actions COMPLETED in a time window, newest first, each with its completion note (what was done). Use this to report to the client what was accomplished \u2014 e.g. `baker actions log` for today, or `baker actions log --since 7d` for the last week. Only published completions appear (not ops staged in an unpublished chat). Window defaults to today in local time.",
+  args: {
+    since: {
+      type: "string",
+      description: "Relative window: today | yesterday | <N>d (e.g. 7d). Default: today.",
+      required: false
+    },
+    from: { type: "string", description: "Window start (ISO date/datetime). Overrides --since.", required: false },
+    to: { type: "string", description: "Window end (ISO date/datetime). Defaults to now.", required: false }
+  }
+});
+var logCommand = defineCommand9({
+  meta: {
+    name: "log",
+    description: "List completed actions in a window with their completion notes (what was done). Example: baker actions log --since today"
+  },
+  args: {
+    since: { type: "string", description: "today | yesterday | <N>d (default: today)", required: false },
+    from: { type: "string", description: "Window start (ISO). Overrides --since", required: false },
+    to: { type: "string", description: "Window end (ISO). Defaults to now", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const { fromMs, toMs } = resolveWindow(args);
+      const response = await apiPost("/api/actions/log", { fromMs, toMs });
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+
+// src/commands/actions/release.ts
+import { defineCommand as defineCommand10 } from "citty";
 registerSchema({
   command: "actions.release",
   description: "Release an action you previously claimed (no-op if you don't own the claim).",
@@ -979,7 +1058,7 @@ registerSchema({
     id: { type: "string", description: "Action ID", required: true }
   }
 });
-var releaseCommand = defineCommand9({
+var releaseCommand = defineCommand10({
   meta: {
     name: "release",
     description: "Release a claim you made on an action. Example: baker actions release <action-id>"
@@ -1005,7 +1084,7 @@ var releaseCommand = defineCommand9({
 });
 
 // src/commands/actions/status.ts
-import { defineCommand as defineCommand10 } from "citty";
+import { defineCommand as defineCommand11 } from "citty";
 registerSchema({
   command: "actions.status",
   description: "Resolve one or more Work Action refs by real action ID or temp_* ref in a single batch call. When BAKER_CHAT_ID is set, a temp_* ref still staged in THIS chat resolves to status 'draft' (not 'not_found') \u2014 staged ops only become published actions on chat publish.",
@@ -1013,7 +1092,7 @@ registerSchema({
     refs: { type: "string", description: "One or more action refs: real action IDs or temp_* refs", required: true }
   }
 });
-var statusCommand = defineCommand10({
+var statusCommand = defineCommand11({
   meta: {
     name: "status",
     description: "Resolve Work Action refs by real ID or temp_* ref. Example: baker actions status temp_hero jx123"
@@ -1038,10 +1117,10 @@ var statusCommand = defineCommand10({
 });
 
 // src/commands/actions/tags/index.ts
-import { defineCommand as defineCommand14 } from "citty";
+import { defineCommand as defineCommand15 } from "citty";
 
 // src/commands/actions/tags/create.ts
-import { defineCommand as defineCommand11 } from "citty";
+import { defineCommand as defineCommand12 } from "citty";
 registerSchema({
   command: "actions.tags.create",
   description: "Create a company custom action tag, minting a new slug usable with --tags. The name is slugified (lowercased, spaces\u2192hyphens). Use when no existing tag fits the work.",
@@ -1050,7 +1129,7 @@ registerSchema({
     description: { type: "string", description: "What this tag means", required: false }
   }
 });
-var tagsCreateCommand = defineCommand11({
+var tagsCreateCommand = defineCommand12({
   meta: {
     name: "create",
     description: 'Create a custom action tag. Example: baker actions tags create --slug pmax --description "Performance Max work"'
@@ -1077,7 +1156,7 @@ var tagsCreateCommand = defineCommand11({
 });
 
 // src/commands/actions/tags/delete.ts
-import { defineCommand as defineCommand12 } from "citty";
+import { defineCommand as defineCommand13 } from "citty";
 registerSchema({
   command: "actions.tags.delete",
   description: "Delete a company custom action tag by slug. Built-in default tags cannot be deleted. Existing actions keep the slug (it just stops appearing in the taxonomy).",
@@ -1085,7 +1164,7 @@ registerSchema({
     slug: { type: "string", description: "Custom tag slug to delete", required: true }
   }
 });
-var tagsDeleteCommand = defineCommand12({
+var tagsDeleteCommand = defineCommand13({
   meta: {
     name: "delete",
     description: "Delete a custom action tag. Example: baker actions tags delete --slug pmax"
@@ -1108,13 +1187,13 @@ var tagsDeleteCommand = defineCommand12({
 });
 
 // src/commands/actions/tags/list.ts
-import { defineCommand as defineCommand13 } from "citty";
+import { defineCommand as defineCommand14 } from "citty";
 registerSchema({
   command: "actions.tags.list",
   description: "List the available action tag taxonomy (built-in defaults + this company's custom tags). Tags are strict \u2014 only these names are accepted by --tags. Run before tagging.",
   args: { output: { type: "string", description: "Output format: md|json", required: false, default: "md" } }
 });
-var tagsListCommand = defineCommand13({
+var tagsListCommand = defineCommand14({
   meta: {
     name: "list",
     description: "List available action tag names (defaults + company custom tags). Use before --tags. Example: baker actions tags list"
@@ -1144,7 +1223,7 @@ var tagsListCommand = defineCommand13({
 });
 
 // src/commands/actions/tags/index.ts
-var tagsCommand = defineCommand14({
+var tagsCommand = defineCommand15({
   meta: {
     name: "tags",
     description: `Manage the action tag taxonomy (built-in defaults + company custom tags). Tags are strict \u2014 only listed names work with --tags on create/update.
@@ -1162,7 +1241,7 @@ Examples:
 });
 
 // src/commands/actions/unlink.ts
-import { defineCommand as defineCommand15 } from "citty";
+import { defineCommand as defineCommand16 } from "citty";
 registerSchema({
   command: "actions.unlink",
   description: "Stage removal of a 'blocker -> blocked' dependency. The blocked action must be claimed by current chat.",
@@ -1171,7 +1250,7 @@ registerSchema({
     blocked: { type: "string", description: "Blocked action ID (must be claimed by current chat)", required: true }
   }
 });
-var unlinkCommand = defineCommand15({
+var unlinkCommand = defineCommand16({
   meta: {
     name: "unlink",
     description: "Stage removal of a dependency. Example: baker actions unlink --blocker <id> --blocked <id>"
@@ -1203,7 +1282,7 @@ var unlinkCommand = defineCommand15({
 });
 
 // src/commands/actions/update.ts
-import { defineCommand as defineCommand16 } from "citty";
+import { defineCommand as defineCommand17 } from "citty";
 registerSchema({
   command: "actions.update",
   description: "Stage an update on a claimed action (name, description, tags, and/or priority). Applies on publish. --tags REPLACES the tag set; pass --tags '' to clear. --priority accepts urgent|high|medium|low or 'none' to clear back to unset (== normal).",
@@ -1223,7 +1302,7 @@ registerSchema({
     }
   }
 });
-var updateCommand = defineCommand16({
+var updateCommand = defineCommand17({
   meta: {
     name: "update",
     description: 'Stage an update on a claimed action. Example: baker actions update <id> --name "New name"'
@@ -1265,10 +1344,10 @@ var updateCommand = defineCommand16({
 });
 
 // src/commands/actions/index.ts
-var actionsCommand = defineCommand17({
+var actionsCommand = defineCommand18({
   meta: {
     name: "actions",
-    description: `Manage action items for the current chat. Subcommands: list, draft, get, status, claim, release, create, update, complete, discard, link, unlink.
+    description: `Manage action items for the current chat. Subcommands: list, log, draft, get, status, claim, release, create, update, complete, discard, link, unlink.
 
 Lifecycle: claim an action before working on it. Stage create/update/complete/discard/link via this CLI; they apply when the chat is published. Release if you decide not to work on it after all.
 
@@ -1276,6 +1355,8 @@ Staged vs published: create/update/complete/discard/link are STAGED in this chat
 
 Examples:
   baker actions list                          # bucketed view of PUBLISHED actions
+  baker actions log                            # actions COMPLETED today, with what was done (client report)
+  baker actions log --since 7d                 # everything completed in the last 7 days
   baker actions draft                         # review what THIS chat has staged (pre-publish)
   baker actions draft remove temp_hero         # drop a staged create (cascades its complete/link ops)
   baker actions draft clear                    # drop everything staged in this chat
@@ -1288,6 +1369,7 @@ Examples:
   },
   subCommands: {
     list: listCommand2,
+    log: logCommand,
     draft: draftCommand,
     get: getCommand,
     status: statusCommand,
@@ -1304,13 +1386,13 @@ Examples:
 });
 
 // src/commands/ads/index.ts
-import { defineCommand as defineCommand77 } from "citty";
+import { defineCommand as defineCommand78 } from "citty";
 
 // src/commands/ads/google/index.ts
-import { defineCommand as defineCommand28 } from "citty";
+import { defineCommand as defineCommand29 } from "citty";
 
 // src/commands/ads/google/accounts.ts
-import { defineCommand as defineCommand18 } from "citty";
+import { defineCommand as defineCommand19 } from "citty";
 
 // src/commands/ads/cache.ts
 import { createHash } from "crypto";
@@ -1332,31 +1414,31 @@ function cachePath(category, key) {
   return join(dir, `${hashKey(key)}.json`);
 }
 function cacheGet(category, key) {
-  const path12 = cachePath(category, key);
-  if (!existsSync(path12)) {
+  const path11 = cachePath(category, key);
+  if (!existsSync(path11)) {
     return null;
   }
   try {
-    const raw = readFileSync(path12, "utf-8");
+    const raw = readFileSync(path11, "utf-8");
     const entry = JSON.parse(raw);
     if (entry.expiresAt < Date.now()) {
-      rmSync(path12, { force: true });
+      rmSync(path11, { force: true });
       return null;
     }
     return entry;
   } catch {
-    rmSync(path12, { force: true });
+    rmSync(path11, { force: true });
     return null;
   }
 }
 function cacheSet(category, key, data, ttlMs, fields) {
-  const path12 = cachePath(category, key);
+  const path11 = cachePath(category, key);
   const entry = {
     expiresAt: Date.now() + ttlMs,
     data,
     fields
   };
-  writeFileSync(path12, JSON.stringify(entry), "utf-8");
+  writeFileSync(path11, JSON.stringify(entry), "utf-8");
 }
 var HOUR = 60 * 60 * 1e3;
 var MINUTE = 60 * 1e3;
@@ -1586,7 +1668,7 @@ function handleAccountsError(err) {
   writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
   process.exit(1);
 }
-var accountsCommand = defineCommand18({
+var accountsCommand = defineCommand19({
   meta: {
     name: "accounts",
     description: `List accessible Google Ads accounts. Returns customer IDs needed for all other commands.
@@ -1626,7 +1708,7 @@ Examples:
 });
 
 // src/commands/ads/google/changes.ts
-import { defineCommand as defineCommand19 } from "citty";
+import { defineCommand as defineCommand20 } from "citty";
 
 // src/commands/ads/field-descriptions.ts
 var FIELD_DESCRIPTIONS = {
@@ -2178,7 +2260,7 @@ registerSchema({
     output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
   }
 });
-var changesCommand = defineCommand19({
+var changesCommand = defineCommand20({
   meta: {
     name: "changes",
     description: `Get recent changes in a Google Ads account with performance data.
@@ -2229,7 +2311,7 @@ Examples:
 });
 
 // src/commands/ads/google/currency.ts
-import { defineCommand as defineCommand20 } from "citty";
+import { defineCommand as defineCommand21 } from "citty";
 registerSchema({
   command: "ads.google.currency",
   description: "Get the currency code for a Google Ads account. Returns currency_code, customer_id, account_name, and access_type. Call this before interpreting cost_micros values.",
@@ -2241,7 +2323,7 @@ registerSchema({
     }
   }
 });
-var currencyCommand = defineCommand20({
+var currencyCommand = defineCommand21({
   meta: {
     name: "currency",
     description: `Get account currency code. Use this to interpret metrics.cost_micros values.
@@ -2290,10 +2372,10 @@ Examples:
 });
 
 // src/commands/ads/google/keywords/index.ts
-import { defineCommand as defineCommand25 } from "citty";
+import { defineCommand as defineCommand26 } from "citty";
 
 // src/commands/ads/google/keywords/discover.ts
-import { defineCommand as defineCommand21 } from "citty";
+import { defineCommand as defineCommand22 } from "citty";
 
 // src/geo-context.ts
 var GOOGLE_ADS_LOCATIONS = [
@@ -2568,7 +2650,7 @@ function handleKeywordError(err) {
   writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
   process.exit(1);
 }
-var discoverCommand = defineCommand21({
+var discoverCommand = defineCommand22({
   meta: {
     name: "discover",
     description: `Discover new keyword ideas from seed keywords or competitor URLs.
@@ -2630,7 +2712,7 @@ Examples:
 });
 
 // src/commands/ads/google/keywords/languages.ts
-import { defineCommand as defineCommand22 } from "citty";
+import { defineCommand as defineCommand23 } from "citty";
 registerSchema({
   command: "ads.google.keywords.languages",
   description: "List all supported language IDs for --language flag in Google Ads keyword commands.",
@@ -2640,7 +2722,7 @@ var FIELDS = {
   id: "Language ID to pass as --language",
   name: "Language name"
 };
-var languagesCommand = defineCommand22({
+var languagesCommand = defineCommand23({
   meta: {
     name: "languages",
     description: "List all supported language IDs for --language flag."
@@ -2651,7 +2733,7 @@ var languagesCommand = defineCommand22({
 });
 
 // src/commands/ads/google/keywords/locations.ts
-import { defineCommand as defineCommand23 } from "citty";
+import { defineCommand as defineCommand24 } from "citty";
 registerSchema({
   command: "ads.google.keywords.locations",
   description: "List all supported geo target IDs for --location flag in Google Ads keyword commands.",
@@ -2661,7 +2743,7 @@ var FIELDS2 = {
   id: "Geo target ID to pass as --location",
   name: "Country/region name"
 };
-var locationsCommand = defineCommand23({
+var locationsCommand = defineCommand24({
   meta: {
     name: "locations",
     description: "List all supported geo target IDs for --location flag."
@@ -2672,7 +2754,7 @@ var locationsCommand = defineCommand23({
 });
 
 // src/commands/ads/google/keywords/metrics.ts
-import { defineCommand as defineCommand24 } from "citty";
+import { defineCommand as defineCommand25 } from "citty";
 registerSchema({
   command: "ads.google.keywords.metrics",
   description: "Get historical metrics for specific keywords. Returns { historical_metrics: [...] } with snake_case fields matching the Google Ads API. IMPORTANT: If --location and --language are omitted, defaults to United States (2840) and English (1000). The response includes a query_context object showing which location/language were used.",
@@ -2696,7 +2778,7 @@ registerSchema({
     output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
   }
 });
-var metricsCommand = defineCommand24({
+var metricsCommand = defineCommand25({
   meta: {
     name: "metrics",
     description: `Get historical search metrics for specific keywords.
@@ -2783,7 +2865,7 @@ Examples:
 });
 
 // src/commands/ads/google/keywords/index.ts
-var keywordsCommand = defineCommand25({
+var keywordsCommand = defineCommand26({
   meta: {
     name: "keywords",
     description: `Keyword research tools. Subcommands: discover, metrics, locations, languages.
@@ -2803,8 +2885,8 @@ Examples:
 });
 
 // src/commands/ads/google/library/index.ts
-import { defineCommand as defineCommand26 } from "citty";
-var listAdvertisers = defineCommand26({
+import { defineCommand as defineCommand27 } from "citty";
+var listAdvertisers = defineCommand27({
   meta: {
     name: "list-advertisers",
     description: "List tracked Google advertisers and their accounts"
@@ -2821,7 +2903,7 @@ var listAdvertisers = defineCommand26({
     }
   }
 });
-var syncStatus = defineCommand26({
+var syncStatus = defineCommand27({
   meta: {
     name: "sync-status",
     description: "Check the sync status and ad counts of a Google account"
@@ -2841,7 +2923,7 @@ var syncStatus = defineCommand26({
     writeAdsJson({ ok: true, data });
   }
 });
-var searchAds = defineCommand26({
+var searchAds = defineCommand27({
   meta: {
     name: "search-ads",
     description: "Search and filter Google ads for an account"
@@ -2898,7 +2980,7 @@ var searchAds = defineCommand26({
     }
   }
 });
-var searchAdvertiser = defineCommand26({
+var searchAdvertiser = defineCommand27({
   meta: {
     name: "search-advertiser",
     description: "Search for an advertiser on the Google Ads Transparency Center"
@@ -2933,7 +3015,7 @@ var searchAdvertiser = defineCommand26({
 function sleep(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
-var track = defineCommand26({
+var track = defineCommand27({
   meta: {
     name: "track",
     description: "Track a new Google advertiser (from search results). Waits for initial sync to complete before returning."
@@ -2991,7 +3073,7 @@ var track = defineCommand26({
     process.exit(1);
   }
 });
-var sync = defineCommand26({
+var sync = defineCommand27({
   meta: {
     name: "sync",
     description: "Trigger an immediate sync for a Google account. Waits for completion before returning."
@@ -3035,7 +3117,7 @@ var sync = defineCommand26({
     process.exit(1);
   }
 });
-var searchCompetitors = defineCommand26({
+var searchCompetitors = defineCommand27({
   meta: {
     name: "search-competitors",
     description: "Search for competitors running Google ads for a keyword (DataForSEO)"
@@ -3067,7 +3149,7 @@ var searchCompetitors = defineCommand26({
     }
   }
 });
-var library = defineCommand26({
+var library = defineCommand27({
   meta: {
     name: "library",
     description: "Manage and search the Google Ads Library"
@@ -3086,7 +3168,7 @@ var library = defineCommand26({
 // src/commands/ads/google/query.ts
 import { appendFileSync, existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
-import { defineCommand as defineCommand27 } from "citty";
+import { defineCommand as defineCommand28 } from "citty";
 
 // src/commands/ads/google/preflight.ts
 function buildCommand2(query, customerId) {
@@ -3542,7 +3624,7 @@ function handleQueryError(err, finalQuery, customerId) {
   });
   process.exit(1);
 }
-var queryCommand = defineCommand27({
+var queryCommand = defineCommand28({
   meta: {
     name: "query",
     description: `Run GAQL queries against Google Ads. Supports raw GAQL, presets, pagination, file export, and caching.
@@ -3600,7 +3682,7 @@ Examples:
 });
 
 // src/commands/ads/google/index.ts
-var googleCommand = defineCommand28({
+var googleCommand = defineCommand29({
   meta: {
     name: "google",
     description: `Google Ads commands. Query campaigns, keywords, search terms, and more via GAQL.
@@ -3628,7 +3710,7 @@ Examples:
 });
 
 // src/commands/ads/linkedin/index.ts
-import { defineCommand as defineCommand46 } from "citty";
+import { defineCommand as defineCommand47 } from "citty";
 
 // src/commands/ads/linkedin/schemas.ts
 registerSchema({
@@ -3928,10 +4010,10 @@ registerSchema({
 });
 
 // src/commands/ads/linkedin/account.ts
-import { defineCommand as defineCommand29 } from "citty";
+import { defineCommand as defineCommand30 } from "citty";
 
 // src/commands/ads/linkedin/shared.ts
-var DAY_MS = 864e5;
+var DAY_MS2 = 864e5;
 function handleLinkedinError(err) {
   if (err instanceof ApiError) {
     if (err.code === "UNAUTHORIZED") {
@@ -4014,7 +4096,7 @@ function todayIso() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
 function daysAgoIso(days) {
-  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);
+  return new Date(Date.now() - days * DAY_MS2).toISOString().slice(0, 10);
 }
 function csvOrJson(args) {
   return args.output ?? "json";
@@ -4031,7 +4113,7 @@ function resolveStatusFilter(args) {
 }
 
 // src/commands/ads/linkedin/account.ts
-var accountCommand = defineCommand29({
+var accountCommand = defineCommand30({
   meta: {
     name: "account",
     description: `Single LinkedIn ad account detail (currency, status, type).
@@ -4065,9 +4147,9 @@ Examples:
 });
 
 // src/commands/ads/linkedin/accounts.ts
-import { defineCommand as defineCommand30 } from "citty";
+import { defineCommand as defineCommand31 } from "citty";
 var ACCOUNTS_TTL_MS = 60 * 60 * 1e3;
-var accountsCommand2 = defineCommand30({
+var accountsCommand2 = defineCommand31({
   meta: {
     name: "accounts",
     description: `List LinkedIn ad accounts in this company's connected scope.
@@ -4115,7 +4197,7 @@ Examples:
 });
 
 // src/commands/ads/linkedin/analytics.ts
-import { defineCommand as defineCommand31 } from "citty";
+import { defineCommand as defineCommand32 } from "citty";
 
 // src/commands/ads/linkedin/presets.ts
 var INTENTS = {
@@ -4387,7 +4469,7 @@ function numberOf(v) {
   }
   return 0;
 }
-var analyticsCommand = defineCommand31({
+var analyticsCommand = defineCommand32({
   meta: {
     name: "analytics",
     description: `Performance reporting \u2014 the workhorse for AI agents.
@@ -4515,7 +4597,7 @@ Examples \u2014 common AI questions:
 
 // src/commands/ads/linkedin/audience-size.ts
 import { readFileSync as readFileSync3 } from "fs";
-import { defineCommand as defineCommand32 } from "citty";
+import { defineCommand as defineCommand33 } from "citty";
 function loadTargeting(args) {
   const inline = args.targeting;
   if (inline) {
@@ -4537,7 +4619,7 @@ function loadTargeting(args) {
   }
   handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
 }
-var audienceSizeCommand = defineCommand32({
+var audienceSizeCommand = defineCommand33({
   meta: {
     name: "audience-size",
     description: `Estimate audience size for a targeting payload \u2014 pre-launch sanity check.
@@ -4582,7 +4664,7 @@ Examples:
 });
 
 // src/commands/ads/linkedin/audit.ts
-import { defineCommand as defineCommand33 } from "citty";
+import { defineCommand as defineCommand34 } from "citty";
 var SEVERITY_RANK = {
   critical: 0,
   high: 1,
@@ -4641,7 +4723,7 @@ function noteOf(f) {
   const fix = f.fix?.explanation ?? "";
   return [fix, ev].filter(Boolean).join(" \u2014 ");
 }
-var auditCommand = defineCommand33({
+var auditCommand = defineCommand34({
   meta: {
     name: "audit",
     description: `Run a LinkedIn Ads playbook audit \u2014 30+ checks across Settings, Tracking,
@@ -4708,7 +4790,7 @@ Examples:
 
 // src/commands/ads/linkedin/bid-pricing.ts
 import { readFileSync as readFileSync4 } from "fs";
-import { defineCommand as defineCommand34 } from "citty";
+import { defineCommand as defineCommand35 } from "citty";
 function loadTargeting2(args) {
   const inline = args.targeting;
   if (inline) {
@@ -4730,7 +4812,7 @@ function loadTargeting2(args) {
   }
   handleLinkedinError(new Error("Pass --targeting-file <path> or --targeting '{...JSON...}'"));
 }
-var bidPricingCommand = defineCommand34({
+var bidPricingCommand = defineCommand35({
   meta: {
     name: "bid-pricing",
     description: `Get LinkedIn's suggested bid range for a targeting + objective + cost type.
@@ -4780,8 +4862,8 @@ Examples:
 });
 
 // src/commands/ads/linkedin/campaign-groups.ts
-import { defineCommand as defineCommand35 } from "citty";
-var campaignGroupsCommand = defineCommand35({
+import { defineCommand as defineCommand36 } from "citty";
+var campaignGroupsCommand = defineCommand36({
   meta: {
     name: "campaign-groups",
     description: `List LinkedIn campaign groups.
@@ -4824,8 +4906,8 @@ Examples:
 });
 
 // src/commands/ads/linkedin/campaigns.ts
-import { defineCommand as defineCommand36 } from "citty";
-var campaignsCommand = defineCommand36({
+import { defineCommand as defineCommand37 } from "citty";
+var campaignsCommand = defineCommand37({
   meta: {
     name: "campaigns",
     description: `List LinkedIn campaigns.
@@ -4874,8 +4956,8 @@ Examples:
 });
 
 // src/commands/ads/linkedin/conversation.ts
-import { defineCommand as defineCommand37 } from "citty";
-var conversationCommand = defineCommand37({
+import { defineCommand as defineCommand38 } from "citty";
+var conversationCommand = defineCommand38({
   meta: {
     name: "conversation",
     description: `Per-button click rates inside Sponsored Messaging / Conversation Ads.
@@ -4938,14 +5020,14 @@ Examples:
 });
 
 // src/commands/ads/linkedin/conversions.ts
-import { defineCommand as defineCommand38 } from "citty";
-var DAY_MS2 = 864e5;
+import { defineCommand as defineCommand39 } from "citty";
+var DAY_MS3 = 864e5;
 function healthOf(rules) {
   const enabled = rules.filter((r) => r.enabled !== false);
   const capi = enabled.filter((r) => r.conversionMethod === "CONVERSIONS_API");
   const pixel = enabled.filter((r) => r.conversionMethod === "PIXEL");
   const staleCapi = capi.filter(
-    (r) => !r.lastConversionReportedAt || Date.now() - r.lastConversionReportedAt > 7 * DAY_MS2
+    (r) => !r.lastConversionReportedAt || Date.now() - r.lastConversionReportedAt > 7 * DAY_MS3
   );
   const longView = enabled.filter(
     (r) => r.viewThroughAttributionWindowSize !== void 0 && r.viewThroughAttributionWindowSize > 7
@@ -4964,7 +5046,7 @@ function healthOf(rules) {
     wrongLeadDedup: wrongDedup
   };
 }
-var listCmd = defineCommand38({
+var listCmd = defineCommand39({
   meta: {
     name: "list",
     description: `List conversion rules on the account.`
@@ -4992,7 +5074,7 @@ var listCmd = defineCommand38({
     }
   }
 });
-var healthCmd = defineCommand38({
+var healthCmd = defineCommand39({
   meta: {
     name: "health",
     description: `5-point Insight Tag / CAPI health check (playbook \xA707).
@@ -5022,7 +5104,7 @@ Surfaces:
     }
   }
 });
-var conversionsCommand = defineCommand38({
+var conversionsCommand = defineCommand39({
   meta: {
     name: "conversions",
     description: `Conversion rules \u2014 Insight Tag and Conversions API.
@@ -5038,8 +5120,8 @@ Subcommands:
 });
 
 // src/commands/ads/linkedin/creatives.ts
-import { defineCommand as defineCommand39 } from "citty";
-var creativesCommand = defineCommand39({
+import { defineCommand as defineCommand40 } from "citty";
+var creativesCommand = defineCommand40({
   meta: {
     name: "creatives",
     description: `List LinkedIn creatives (ads).
@@ -5088,7 +5170,7 @@ Examples:
 });
 
 // src/commands/ads/linkedin/demographics.ts
-import { defineCommand as defineCommand40 } from "citty";
+import { defineCommand as defineCommand41 } from "citty";
 var DEFAULT_PIVOTS = ["job-title", "company", "industry", "seniority", "job-function", "company-size"];
 function numberOf2(v) {
   if (typeof v === "number") return Number.isFinite(v) ? v : 0;
@@ -5101,7 +5183,7 @@ function numberOf2(v) {
 function topByImpressions(rows, limit) {
   return [...rows].sort((a, b) => numberOf2(b.impressions) - numberOf2(a.impressions)).slice(0, limit);
 }
-var demographicsCommand = defineCommand40({
+var demographicsCommand = defineCommand41({
   meta: {
     name: "demographics",
     description: `Sweep all firmographic pivots in one command \u2014 LinkedIn's superpower.
@@ -5198,8 +5280,8 @@ function resolveRange(args) {
 }
 
 // src/commands/ads/linkedin/facets.ts
-import { defineCommand as defineCommand41 } from "citty";
-var listCmd2 = defineCommand41({
+import { defineCommand as defineCommand42 } from "citty";
+var listCmd2 = defineCommand42({
   meta: {
     name: "list",
     description: `List every targeting facet LinkedIn supports.
@@ -5227,7 +5309,7 @@ seniorities, titles, employers, growthRate, companyCategory, skills, etc.).`
     }
   }
 });
-var valuesCmd = defineCommand41({
+var valuesCmd = defineCommand42({
   meta: {
     name: "values",
     description: `Look up entity values for a single facet \u2014 full list or typeahead search.
@@ -5268,7 +5350,7 @@ or the full URN (urn:li:adTargetingFacet:industries).`
     }
   }
 });
-var facetsCommand = defineCommand41({
+var facetsCommand = defineCommand42({
   meta: {
     name: "facets",
     description: `LinkedIn targeting facets and entity lookup.
@@ -5286,7 +5368,7 @@ Subcommands:
 
 // src/commands/ads/linkedin/forecast.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { defineCommand as defineCommand42 } from "citty";
+import { defineCommand as defineCommand43 } from "citty";
 function loadTargeting3(args) {
   const inline = args.targeting;
   if (inline) {
@@ -5316,7 +5398,7 @@ function parseMoney(raw) {
   }
   return { amount: m[1] ?? "0", currencyCode: m[2] ?? "USD" };
 }
-var forecastCommand = defineCommand42({
+var forecastCommand = defineCommand43({
   meta: {
     name: "forecast",
     description: `Forecast reach + impressions + clicks + spend for a hypothetical campaign.
@@ -5363,9 +5445,9 @@ Examples:
 });
 
 // src/commands/ads/linkedin/leads.ts
-import { defineCommand as defineCommand43 } from "citty";
-var DAY_MS3 = 864e5;
-var leadsCommand = defineCommand43({
+import { defineCommand as defineCommand44 } from "citty";
+var DAY_MS4 = 864e5;
+var leadsCommand = defineCommand44({
   meta: {
     name: "leads",
     description: `List Lead Gen Form responses (playbook \xA707).
@@ -5400,7 +5482,7 @@ Examples:
       if (args["form-id"]) params["form-id"] = String(args["form-id"]);
       if (args["campaign-id"]) params["campaign-id"] = String(args["campaign-id"]);
       const sinceDays = args["since-days"] ? Number(args["since-days"]) : void 0;
-      const sinceMs = args["since-ms"] ? Number(args["since-ms"]) : sinceDays ? Date.now() - sinceDays * DAY_MS3 : void 0;
+      const sinceMs = args["since-ms"] ? Number(args["since-ms"]) : sinceDays ? Date.now() - sinceDays * DAY_MS4 : void 0;
       if (sinceMs) params["since-ms"] = String(sinceMs);
       if (args.limit) params.limit = String(args.limit);
       if (args["skip-cache"]) params["skip-cache"] = "true";
@@ -5425,7 +5507,7 @@ Examples:
 });
 
 // src/commands/ads/linkedin/resolve.ts
-import { defineCommand as defineCommand44 } from "citty";
+import { defineCommand as defineCommand45 } from "citty";
 function toOrgUrn(raw) {
   const trimmed = raw.trim();
   if (trimmed.length === 0) {
@@ -5436,7 +5518,7 @@ function toOrgUrn(raw) {
   }
   return /^\d+$/.test(trimmed) ? `urn:li:organization:${trimmed}` : null;
 }
-var resolveCommand = defineCommand44({
+var resolveCommand = defineCommand45({
   meta: {
     name: "resolve",
     description: `Resolve organization URNs to company names.
@@ -5478,8 +5560,8 @@ couldn't be resolved \u2014 typically an org outside LinkedIn's targetable set.`
 });
 
 // src/commands/ads/linkedin/top-companies.ts
-import { defineCommand as defineCommand45 } from "citty";
-var topCompaniesCommand = defineCommand45({
+import { defineCommand as defineCommand46 } from "citty";
+var topCompaniesCommand = defineCommand46({
   meta: {
     name: "top-companies",
     description: `Top companies whose employees saw / clicked / converted on a campaign.
@@ -5550,7 +5632,7 @@ Examples:
 });
 
 // src/commands/ads/linkedin/index.ts
-var linkedinCommand = defineCommand46({
+var linkedinCommand = defineCommand47({
   meta: {
     name: "linkedin",
     description: `LinkedIn Marketing API \u2014 AI-first command surface for B2B ad insights.
@@ -5602,13 +5684,13 @@ Account ID format:
 });
 
 // src/commands/ads/meta/index.ts
-import { defineCommand as defineCommand59 } from "citty";
+import { defineCommand as defineCommand60 } from "citty";
 
 // src/commands/ads/meta/account.ts
-import { defineCommand as defineCommand47 } from "citty";
+import { defineCommand as defineCommand48 } from "citty";
 
 // src/commands/ads/meta/shared.ts
-var DAY_MS4 = 864e5;
+var DAY_MS5 = 864e5;
 function handleMetaError(err) {
   if (err instanceof ApiError) {
     if (err.code === "UNAUTHORIZED" || err.code === "NOT_FOUND") {
@@ -5667,7 +5749,7 @@ function todayIso2() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
 function daysAgoIso2(days) {
-  return new Date(Date.now() - days * DAY_MS4).toISOString().slice(0, 10);
+  return new Date(Date.now() - days * DAY_MS5).toISOString().slice(0, 10);
 }
 function csvOrJson2(args) {
   return args.output ?? "json";
@@ -5684,7 +5766,7 @@ function resolveEffectiveStatus(args) {
 }
 
 // src/commands/ads/meta/account.ts
-var accountCommand2 = defineCommand47({
+var accountCommand2 = defineCommand48({
   meta: {
     name: "account",
     description: `Show single Meta ad account detail (currency, timezone, balance, business).
@@ -5711,8 +5793,8 @@ Examples:
 });
 
 // src/commands/ads/meta/accounts.ts
-import { defineCommand as defineCommand48 } from "citty";
-var accountsCommand3 = defineCommand48({
+import { defineCommand as defineCommand49 } from "citty";
+var accountsCommand3 = defineCommand49({
   meta: {
     name: "accounts",
     description: `List Meta ad accounts in this company's connected scope.
@@ -5760,8 +5842,8 @@ Examples:
 });
 
 // src/commands/ads/meta/activities.ts
-import { defineCommand as defineCommand49 } from "citty";
-var activitiesCommand = defineCommand49({
+import { defineCommand as defineCommand50 } from "citty";
+var activitiesCommand = defineCommand50({
   meta: {
     name: "activities",
     description: `Audit log of recent ad-account changes (created, paused, edited). Default lookback 7 days,
@@ -5798,8 +5880,8 @@ Examples:
 });
 
 // src/commands/ads/meta/ads.ts
-import { defineCommand as defineCommand50 } from "citty";
-var adsListCommand = defineCommand50({
+import { defineCommand as defineCommand51 } from "citty";
+var adsListCommand = defineCommand51({
   meta: {
     name: "ads",
     description: `List ads in a Meta ad account. Defaults to ACTIVE only \u2014 pass --all-statuses to widen.
@@ -5847,8 +5929,8 @@ Examples:
 });
 
 // src/commands/ads/meta/adsets.ts
-import { defineCommand as defineCommand51 } from "citty";
-var adsetsCommand = defineCommand51({
+import { defineCommand as defineCommand52 } from "citty";
+var adsetsCommand = defineCommand52({
   meta: {
     name: "adsets",
     description: `List ad sets in a Meta ad account, optionally scoped to one campaign. Defaults to ACTIVE only.
@@ -5890,8 +5972,8 @@ Examples:
 });
 
 // src/commands/ads/meta/audiences.ts
-import { defineCommand as defineCommand52 } from "citty";
-var audiencesCommand = defineCommand52({
+import { defineCommand as defineCommand53 } from "citty";
+var audiencesCommand = defineCommand53({
   meta: {
     name: "audiences",
     description: `List custom audiences for a Meta ad account. Includes lookalikes, website-pixel audiences,
@@ -5926,8 +6008,8 @@ Examples:
 });
 
 // src/commands/ads/meta/businesses.ts
-import { defineCommand as defineCommand53 } from "citty";
-var businessesCommand = defineCommand53({
+import { defineCommand as defineCommand54 } from "citty";
+var businessesCommand = defineCommand54({
   meta: {
     name: "businesses",
     description: `List Meta Business Manager accounts the connected user has access to. Required for ad-studies and product-catalogs commands.
@@ -5957,8 +6039,8 @@ Examples:
 });
 
 // src/commands/ads/meta/campaigns.ts
-import { defineCommand as defineCommand54 } from "citty";
-var campaignsCommand2 = defineCommand54({
+import { defineCommand as defineCommand55 } from "citty";
+var campaignsCommand2 = defineCommand55({
   meta: {
     name: "campaigns",
     description: `List campaigns for a Meta ad account. Defaults to ACTIVE only \u2014 pass --all-statuses to widen.
@@ -6002,8 +6084,8 @@ Examples:
 });
 
 // src/commands/ads/meta/creatives.ts
-import { defineCommand as defineCommand55 } from "citty";
-var creativesCommand2 = defineCommand55({
+import { defineCommand as defineCommand56 } from "citty";
+var creativesCommand2 = defineCommand56({
   meta: {
     name: "creatives",
     description: `List ad creatives in an account, or fetch a single creative by ID.
@@ -6047,7 +6129,7 @@ Examples:
 });
 
 // src/commands/ads/meta/insights.ts
-import { defineCommand as defineCommand56 } from "citty";
+import { defineCommand as defineCommand57 } from "citty";
 
 // src/commands/ads/meta/presets.ts
 var INSIGHTS_INTENTS = {
@@ -6252,7 +6334,7 @@ function sortRowsBySpendDesc(rows) {
     return sb - sa;
   });
 }
-var insightsCommand = defineCommand56({
+var insightsCommand = defineCommand57({
   meta: {
     name: "insights",
     description: `Performance reporting \u2014 the main Meta tool for AI agents.
@@ -6353,8 +6435,8 @@ Async is automatic for heavy queries; pass --async to force it, or --no-async to
 });
 
 // src/commands/ads/meta/pixels.ts
-import { defineCommand as defineCommand57 } from "citty";
-var pixelsCommand = defineCommand57({
+import { defineCommand as defineCommand58 } from "citty";
+var pixelsCommand = defineCommand58({
   meta: {
     name: "pixels",
     description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
@@ -6425,7 +6507,7 @@ function emit(data, args) {
 
 // src/commands/ads/meta/preview.ts
 import { writeFileSync as writeFileSync3 } from "fs";
-import { defineCommand as defineCommand58 } from "citty";
+import { defineCommand as defineCommand59 } from "citty";
 var VALID_AD_FORMATS = [
   "DESKTOP_FEED_STANDARD",
   "MOBILE_FEED_STANDARD",
@@ -6459,7 +6541,7 @@ var VALID_AD_FORMATS = [
   "MARKETPLACE_MOBILE",
   "BIZ_DISCO_FEED_MOBILE"
 ];
-var previewCommand = defineCommand58({
+var previewCommand = defineCommand59({
   meta: {
     name: "preview",
     description: `Generate a Meta-hosted preview iframe for a creative or ad. Returns iframe HTML which you
@@ -6506,7 +6588,7 @@ Examples:
 });
 
 // src/commands/ads/meta/index.ts
-var metaCommand = defineCommand59({
+var metaCommand = defineCommand60({
   meta: {
     name: "meta",
     description: `Meta Marketing API \u2014 AI-first command surface (Facebook + Instagram ads).
@@ -6558,10 +6640,10 @@ Audit & review:
 });
 
 // src/commands/ads/x/index.ts
-import { defineCommand as defineCommand76 } from "citty";
+import { defineCommand as defineCommand77 } from "citty";
 
 // src/commands/ads/x/accounts.ts
-import { defineCommand as defineCommand60 } from "citty";
+import { defineCommand as defineCommand61 } from "citty";
 registerSchema({
   command: "ads.x.accounts",
   description: "List all accessible X Ads accounts. Returns accounts with id (base36), name, approval_status, timezone, currency. Run this first to find account IDs for other commands.",
@@ -6589,7 +6671,7 @@ function handleAccountsError2(err) {
   writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
   process.exit(1);
 }
-var accountsCommand4 = defineCommand60({
+var accountsCommand4 = defineCommand61({
   meta: {
     name: "accounts",
     description: `List accessible X Ads accounts. Returns account IDs needed for all other commands.
@@ -6629,7 +6711,7 @@ Examples:
 });
 
 // src/commands/ads/x/active-entities.ts
-import { defineCommand as defineCommand61 } from "citty";
+import { defineCommand as defineCommand62 } from "citty";
 
 // src/commands/ads/x/error-parser.ts
 function mapXErrorCode(message) {
@@ -6780,7 +6862,7 @@ function parseCsv(v) {
   const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
   return parts.length > 0 ? parts : void 0;
 }
-var activeEntitiesCommand = defineCommand61({
+var activeEntitiesCommand = defineCommand62({
   meta: {
     name: "active-entities",
     description: `List entities with metric activity in a time range.
@@ -6838,7 +6920,7 @@ Examples:
 });
 
 // src/commands/ads/x/audiences.ts
-import { defineCommand as defineCommand62 } from "citty";
+import { defineCommand as defineCommand63 } from "citty";
 registerSchema({
   command: "ads.x.audiences",
   description: "List custom audiences for an X Ads account. Returns id, name, audience_size, audience_type, targetable status. Audiences need 100+ active users in the past 90 days to be targetable.",
@@ -6847,7 +6929,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var audiencesCommand2 = defineCommand62({
+var audiencesCommand2 = defineCommand63({
   meta: {
     name: "audiences",
     description: `List X Ads custom audiences.
@@ -6896,7 +6978,7 @@ Examples:
 });
 
 // src/commands/ads/x/campaigns.ts
-import { defineCommand as defineCommand63 } from "citty";
+import { defineCommand as defineCommand64 } from "citty";
 
 // src/commands/ads/x/run-list.ts
 function buildCleanParams(opts) {
@@ -6959,7 +7041,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var campaignsCommand3 = defineCommand63({
+var campaignsCommand3 = defineCommand64({
   meta: {
     name: "campaigns",
     description: `List X Ads campaigns. Returns budget, schedule, funding instrument, status.
@@ -7001,7 +7083,7 @@ Examples:
 });
 
 // src/commands/ads/x/cards.ts
-import { defineCommand as defineCommand64 } from "citty";
+import { defineCommand as defineCommand65 } from "citty";
 registerSchema({
   command: "ads.x.cards",
   description: "List website cards, video cards, and carousels for an X Ads account.",
@@ -7010,7 +7092,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var cardsCommand = defineCommand64({
+var cardsCommand = defineCommand65({
   meta: {
     name: "cards",
     description: `List X Ads cards (rich creatives).
@@ -7059,7 +7141,7 @@ Examples:
 });
 
 // src/commands/ads/x/funding.ts
-import { defineCommand as defineCommand65 } from "citty";
+import { defineCommand as defineCommand66 } from "citty";
 registerSchema({
   command: "ads.x.funding",
   description: "List funding instruments for an X Ads account. Returns id, type, currency, credit_limit_local_micro, funded_amount_local_micro, status. Falls back to BAKER_X_ADS_ACCOUNT_ID env var.",
@@ -7068,7 +7150,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var fundingCommand = defineCommand65({
+var fundingCommand = defineCommand66({
   meta: {
     name: "funding",
     description: `List funding instruments for an X Ads account.
@@ -7117,7 +7199,7 @@ Examples:
 });
 
 // src/commands/ads/x/line-items.ts
-import { defineCommand as defineCommand66 } from "citty";
+import { defineCommand as defineCommand67 } from "citty";
 registerSchema({
   command: "ads.x.lineItems",
   description: "List line items (ad groups) for an X Ads account. Returns bid, product_type, objective, placements, schedule. Filter by campaign-ids or line-item-ids (CSV).",
@@ -7129,7 +7211,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var lineItemsCommand = defineCommand66({
+var lineItemsCommand = defineCommand67({
   meta: {
     name: "line-items",
     description: `List X Ads line items (ad groups).
@@ -7170,7 +7252,7 @@ Examples:
 });
 
 // src/commands/ads/x/media.ts
-import { defineCommand as defineCommand67 } from "citty";
+import { defineCommand as defineCommand68 } from "citty";
 registerSchema({
   command: "ads.x.media",
   description: "List media assets in the X Ads media library (images, GIFs, videos). Filter by media-type (IMAGE, GIF, VIDEO).",
@@ -7180,7 +7262,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var mediaCommand = defineCommand67({
+var mediaCommand = defineCommand68({
   meta: {
     name: "media",
     description: `List media assets in the X Ads media library.
@@ -7232,7 +7314,7 @@ Examples:
 });
 
 // src/commands/ads/x/promoted-tweets.ts
-import { defineCommand as defineCommand68 } from "citty";
+import { defineCommand as defineCommand69 } from "citty";
 registerSchema({
   command: "ads.x.promotedTweets",
   description: "List promoted tweets for an X Ads account. Returns id, line_item_id, tweet_id, approval_status. Filter by line-item-ids (CSV).",
@@ -7243,7 +7325,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var promotedTweetsCommand = defineCommand68({
+var promotedTweetsCommand = defineCommand69({
   meta: {
     name: "promoted-tweets",
     description: `List X Ads promoted tweets.
@@ -7297,11 +7379,11 @@ Examples:
 });
 
 // src/commands/ads/x/stats/index.ts
-import { defineCommand as defineCommand73 } from "citty";
+import { defineCommand as defineCommand74 } from "citty";
 
 // src/commands/ads/x/stats/job.ts
 import { gunzipSync } from "zlib";
-import { defineCommand as defineCommand69 } from "citty";
+import { defineCommand as defineCommand70 } from "citty";
 var POLL_INTERVAL_MS2 = 1e4;
 var DEADLINE_MS = 12 * 60 * 1e3;
 var RESULT_CACHE_TTL_MS = 6 * 60 * 60 * 1e3;
@@ -7371,7 +7453,7 @@ async function pollUntilDone(accountId, jobId) {
 function buildCacheKey(body) {
   return `stats-job:${JSON.stringify(body)}`;
 }
-var statsJobCommand = defineCommand69({
+var statsJobCommand = defineCommand70({
   meta: {
     name: "job",
     description: `Async X Ads stats job, sync from the CLI's perspective. Creates \u2192 polls \u2192 downloads \u2192 returns.
@@ -7476,7 +7558,7 @@ For fine-grained control (don't wait, poll yourself), use:
 });
 
 // src/commands/ads/x/stats/job-create.ts
-import { defineCommand as defineCommand70 } from "citty";
+import { defineCommand as defineCommand71 } from "citty";
 registerSchema({
   command: "ads.x.statsJobCreate",
   description: "Create an asynchronous X Ads stats job (range up to 90 days non-segmented, 45 days segmented). Returns a job id; poll with `stats job-status`. Times must be ISO 8601 hour-aligned.",
@@ -7499,7 +7581,7 @@ function parseCsv3(v) {
   const parts = v.split(",").map((s) => s.trim()).filter(Boolean);
   return parts.length > 0 ? parts : void 0;
 }
-var statsJobCreateCommand = defineCommand70({
+var statsJobCreateCommand = defineCommand71({
   meta: {
     name: "job-create",
     description: `Create an async X Ads stats job (up to 90 days, supports segmentation).
@@ -7562,7 +7644,7 @@ Examples:
 });
 
 // src/commands/ads/x/stats/job-status.ts
-import { defineCommand as defineCommand71 } from "citty";
+import { defineCommand as defineCommand72 } from "citty";
 registerSchema({
   command: "ads.x.statsJobStatus",
   description: "Check the status of one or more X Ads stats jobs. Returns status (PROCESSING|SUCCESS|FAILED) and a downloadable url when SUCCESS. Pass --job-id or --job-ids (CSV).",
@@ -7572,7 +7654,7 @@ registerSchema({
     "job-ids": { type: "string", description: "CSV of job IDs", required: false }
   }
 });
-var statsJobStatusCommand = defineCommand71({
+var statsJobStatusCommand = defineCommand72({
   meta: {
     name: "job-status",
     description: `Poll the status of an async X Ads stats job.
@@ -7613,7 +7695,7 @@ Examples:
 });
 
 // src/commands/ads/x/stats/sync.ts
-import { defineCommand as defineCommand72 } from "citty";
+import { defineCommand as defineCommand73 } from "citty";
 
 // src/commands/ads/x/presets.ts
 var X_STATS_PRESETS = [
@@ -7772,7 +7854,7 @@ async function runSync(args, q) {
     process.exit(1);
   }
 }
-var statsSyncCommand = defineCommand72({
+var statsSyncCommand = defineCommand73({
   meta: {
     name: "sync",
     description: `Synchronous X Ads analytics (max 7-day window).
@@ -7815,7 +7897,7 @@ Examples:
 });
 
 // src/commands/ads/x/stats/index.ts
-var statsCommand = defineCommand73({
+var statsCommand = defineCommand74({
   meta: {
     name: "stats",
     description: `X Ads analytics. Sync (\u22647 days, no segmentation) or async jobs (\u226490 days, segmentable).
@@ -7843,7 +7925,7 @@ Examples:
 });
 
 // src/commands/ads/x/targeting-constants.ts
-import { defineCommand as defineCommand74 } from "citty";
+import { defineCommand as defineCommand75 } from "citty";
 var ALLOWED_CONSTANTS = [
   "locations",
   "interests",
@@ -7871,7 +7953,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var targetingConstantsCommand = defineCommand74({
+var targetingConstantsCommand = defineCommand75({
   meta: {
     name: "targeting-constants",
     description: `Lookup X Ads targeting constants.
@@ -7921,7 +8003,7 @@ Examples:
 });
 
 // src/commands/ads/x/targeting-criteria.ts
-import { defineCommand as defineCommand75 } from "citty";
+import { defineCommand as defineCommand76 } from "citty";
 registerSchema({
   command: "ads.x.targetingCriteria",
   description: "List targeting criteria attached to line items in an X Ads account. Returns targeting_type, targeting_value, name, operator_type per criterion. Filter by line-item-ids.",
@@ -7931,7 +8013,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache", required: false }
   }
 });
-var targetingCriteriaCommand = defineCommand75({
+var targetingCriteriaCommand = defineCommand76({
   meta: {
     name: "targeting-criteria",
     description: `List targeting criteria attached to line items.
@@ -7982,7 +8064,7 @@ Examples:
 });
 
 // src/commands/ads/x/index.ts
-var xCommand = defineCommand76({
+var xCommand = defineCommand77({
   meta: {
     name: "x",
     description: `X (Twitter) Ads commands. Read campaigns, line items, promoted tweets, creatives, audiences, and analytics.
@@ -8020,7 +8102,7 @@ The CLI auto-detects --account-id when exactly one X Ads account is connected, o
 });
 
 // src/commands/ads/index.ts
-var adsCommand = defineCommand77({
+var adsCommand = defineCommand78({
   meta: {
     name: "ads",
     description: `Ad platform commands. Each platform exposes its own native command surface \u2014 no forced parity.
@@ -8053,8 +8135,8 @@ Examples:
 import { defineCommand as defineCommand86 } from "citty";
 
 // src/commands/canvas/catalog.ts
-import { defineCommand as defineCommand78 } from "citty";
-var catalogCommand = defineCommand78({
+import { defineCommand as defineCommand79 } from "citty";
+var catalogCommand = defineCommand79({
   meta: {
     name: "catalog",
     description: "Print the agent-facing node catalog (JSON Schema). Includes every registered node grouped by category."
@@ -8066,293 +8148,76 @@ var catalogCommand = defineCommand78({
   }
 });
 
-// src/commands/canvas/gallery.ts
-import { readdir, readFile } from "fs/promises";
+// src/commands/canvas/inspect.ts
+import { execFile } from "child_process";
+import { readdir, readFile, stat } from "fs/promises";
 import path from "path";
-import { defineCommand as defineCommand79 } from "citty";
-
-// src/engine/gallery/descriptor.ts
-var KNOWN_RATIOS = [
-  ["9:16", 9 / 16],
-  ["4:5", 4 / 5],
-  ["1:1", 1],
-  ["1.91:1", 1.91],
-  ["16:9", 16 / 9],
-  ["4:1", 4]
-];
-var RATIO_TOLERANCE = 0.06;
-function aspectLabel(width, height) {
-  if (!width || !height) {
-    return "other";
-  }
-  const ratio = width / height;
-  let best = "other";
-  let bestErr = Number.POSITIVE_INFINITY;
-  for (const [label, value] of KNOWN_RATIOS) {
-    const err = Math.abs(ratio - value) / value;
-    if (err < bestErr) {
-      bestErr = err;
-      best = label;
+import { promisify } from "util";
+import { defineCommand as defineCommand80 } from "citty";
+var execFileAsync = promisify(execFile);
+var inspectCommand = defineCommand80({
+  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."
+  },
+  args: {
+    run: { type: "positional", required: true, description: "Run id (e.g. r_01K...) or absolute run directory" },
+    "outputs-dir": { type: "string", description: "Per-run outputs root (default ./canvas)" },
+    thumbnails: {
+      type: "boolean",
+      description: "Extract start/middle/end frames from every video output (requires ffmpeg)"
     }
+  },
+  async run({ args }) {
+    const outputsDir = path.resolve(String(args["outputs-dir"] ?? "canvas"));
+    const runArg = String(args.run);
+    const runDir = await resolveRunDir(runArg, outputsDir);
+    const manifest = await loadManifest(runDir);
+    const files = await listRunFiles(runDir);
+    const videos = files.filter((f) => isVideoFile(f.path));
+    let thumbnails = [];
+    if (args.thumbnails) {
+      thumbnails = await extractThumbnails(videos.map((v) => v.path));
+    }
+    const summary = {
+      ok: true,
+      run_id: manifest.run_id ?? path.basename(runDir),
+      run_dir: runDir,
+      stats: manifest.stats ?? null,
+      output: manifest.output ?? null,
+      node_runs: manifest.node_runs ?? [],
+      files: files.map((f) => ({ name: f.name, path: f.path, size_bytes: f.size })),
+      thumbnails
+    };
+    process.stdout.write(`${JSON.stringify(summary, null, 2)}
+`);
   }
-  return bestErr <= RATIO_TOLERANCE ? best : `${width}x${height}`;
-}
-function visualRef(value) {
-  const parsed = AssetRef.safeParse(value);
-  if (!parsed.success) {
-    return null;
-  }
-  if (parsed.data.kind !== "image" && parsed.data.kind !== "video") {
-    return null;
+});
+async function resolveRunDir(run, outputsDir) {
+  if (path.isAbsolute(run)) {
+    const s2 = await stat(run).catch(() => null);
+    if (s2?.isDirectory()) return run;
+    throw new Error(`inspect: ${run} is not a directory`);
   }
-  return parsed.data;
-}
-function deliverableFor(ref, stem, resolveLocal) {
-  const width = "width" in ref ? ref.width : void 0;
-  const height = "height" in ref ? ref.height : void 0;
-  return {
-    kind: ref.kind,
-    format: aspectLabel(width, height),
-    // Remote-node outputs already carry a public R2 url; local composites are
-    // resolved against the mounted run dir's public base.
-    url: ref.url ?? resolveLocal(`${stem}.${extForMime(ref.mime)}`),
-    width,
-    height,
-    label: stem
-  };
+  const candidate = path.join(outputsDir, run);
+  const s = await stat(candidate).catch(() => null);
+  if (s?.isDirectory()) return candidate;
+  throw new Error(`inspect: no run directory at ${candidate}`);
 }
-function deliverablesFromOutput(output, resolveLocal) {
-  if (Array.isArray(output)) {
-    const out = [];
-    output.forEach((entry, i) => {
-      const ref2 = visualRef(entry);
-      if (ref2) {
-        out.push(deliverableFor(ref2, `_final__${i}`, resolveLocal));
-      }
-    });
-    return out;
-  }
-  const ref = visualRef(output);
-  return ref ? [deliverableFor(ref, "_final", resolveLocal)] : [];
-}
-function buildGeneration(runId, manifest, resolveLocal) {
-  const m = manifest ?? {};
-  const credits = typeof m.stats?.total_credits === "number" ? m.stats.total_credits : 0;
-  return {
-    runId,
-    createdAt: typeof m.completed_at === "number" ? m.completed_at : 0,
-    credits,
-    deliverables: deliverablesFromOutput(m.output, resolveLocal)
-  };
-}
-function buildGalleryDescriptor(input) {
-  const generations = [...input.generations].sort((a, b) => b.createdAt - a.createdAt);
-  return {
-    slug: input.slug,
-    title: input.definition.title,
-    platform: input.definition.platform,
-    status: input.definition.status,
-    reference: input.definition.reference,
-    selectedRun: input.definition.selectedRun,
-    generations
-  };
-}
-function titleFromSlug(slug) {
-  return slug.split(/[-_/]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
-}
-function stripQuotes(raw) {
-  const trimmed = raw.trim();
-  if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
-    return trimmed.slice(1, -1);
-  }
-  return trimmed;
-}
-function parseInlineList(raw) {
-  return raw.slice(1, -1).split(",").map((item) => stripQuotes(item)).filter(Boolean);
-}
-function parseFrontmatter(markdown) {
-  const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  const block = match?.[1];
-  if (!block) {
-    return {};
-  }
-  const out = {};
-  let listKey = null;
-  for (const line of block.split(/\r?\n/)) {
-    const item = line.match(/^\s+-\s+(.*)$/)?.[1];
-    if (listKey && item !== void 0) {
-      out[listKey].push(stripQuotes(item));
-      continue;
-    }
-    const kv = line.match(/^([A-Za-z0-9_]+):\s*(.*)$/);
-    if (!kv?.[1]) {
-      continue;
-    }
-    listKey = null;
-    const key = kv[1];
-    const value = (kv[2] ?? "").trim();
-    if (value === "") {
-      out[key] = [];
-      listKey = key;
-    } else if (value.startsWith("[") && value.endsWith("]")) {
-      out[key] = parseInlineList(value);
-    } else {
-      out[key] = stripQuotes(value);
-    }
-  }
-  return out;
-}
-function asString(value) {
-  if (typeof value === "string" && value.length > 0) {
-    return value;
-  }
-  return void 0;
-}
-function asList(value) {
-  if (Array.isArray(value)) {
-    return value;
-  }
-  return typeof value === "string" && value.length > 0 ? [value] : [];
-}
-function parseCreativeDefinition(markdown, slug) {
-  const fm = parseFrontmatter(markdown);
-  return {
-    title: asString(fm.title) ?? titleFromSlug(slug),
-    platform: asList(fm.platform),
-    formats: asList(fm.formats),
-    status: asString(fm.status) ?? "draft",
-    reference: asString(fm.reference),
-    selectedRun: asString(fm.selected_run)
-  };
-}
-
-// src/commands/canvas/gallery.ts
-async function readJson(file) {
-  try {
-    return JSON.parse(await readFile(file, "utf8"));
-  } catch {
-    return null;
-  }
-}
-async function listRunDirs(runsDir) {
-  try {
-    const entries = await readdir(runsDir, { withFileTypes: true });
-    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
-  } catch {
-    return [];
-  }
-}
-var galleryCommand = defineCommand79({
-  meta: {
-    name: "gallery",
-    description: "Read a creative's _definition.md + every persisted run manifest and emit the gallery descriptor (JSON) the dashboard renders."
-  },
-  args: {
-    dir: { type: "positional", required: true, description: "Creative folder, e.g. src/creatives/<slug>" },
-    "workspace-dir": { type: "string", description: "R2-mounted workspace root (default ./.creatives-workspace)" },
-    "public-url": { type: "string", description: "R2 public base (default $R2_PUBLIC_URL)" },
-    "company-id": { type: "string", description: "Company id for the R2 prefix (default $BAKER_COMPANY_ID)" }
-  },
-  async run({ args }) {
-    const creativeDir = path.resolve(String(args.dir));
-    const slug = path.basename(creativeDir);
-    const workspaceDir = path.resolve(String(args["workspace-dir"] ?? ".creatives-workspace"));
-    const runsDir = path.join(workspaceDir, slug, "runs");
-    const publicUrl = (args["public-url"] ?? runtimeEnvVar("R2_PUBLIC_URL") ?? "").replace(/\/+$/, "");
-    const companyId = String(args["company-id"] ?? runtimeEnvVar("BAKER_COMPANY_ID") ?? "");
-    const definitionPath = path.join(creativeDir, "_definition.md");
-    let definitionMd = "";
-    try {
-      definitionMd = await readFile(definitionPath, "utf8");
-    } catch {
-    }
-    const definition = parseCreativeDefinition(definitionMd, slug);
-    const generations = [];
-    for (const runId of await listRunDirs(runsDir)) {
-      const manifest = await readJson(path.join(runsDir, runId, "manifest.json"));
-      if (!manifest) {
-        continue;
-      }
-      const runDir = path.join(runsDir, runId);
-      const resolveLocal = (filename) => publicUrl && companyId ? `${publicUrl}/creatives/${companyId}/${slug}/runs/${runId}/${filename}` : path.join(runDir, filename);
-      generations.push(buildGeneration(runId, manifest, resolveLocal));
-    }
-    const descriptor = buildGalleryDescriptor({ slug, definition, generations });
-    process.stdout.write(`${JSON.stringify({ ok: true, descriptor }, null, 2)}
-`);
-  }
-});
-
-// src/commands/canvas/inspect.ts
-import { execFile } from "child_process";
-import { readdir as readdir2, readFile as readFile2, stat } from "fs/promises";
-import path2 from "path";
-import { promisify } from "util";
-import { defineCommand as defineCommand80 } from "citty";
-var execFileAsync = promisify(execFile);
-var inspectCommand = defineCommand80({
-  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."
-  },
-  args: {
-    run: { type: "positional", required: true, description: "Run id (e.g. r_01K...) or absolute run directory" },
-    "outputs-dir": { type: "string", description: "Per-run outputs root (default ./canvas)" },
-    thumbnails: {
-      type: "boolean",
-      description: "Extract start/middle/end frames from every video output (requires ffmpeg)"
-    }
-  },
-  async run({ args }) {
-    const outputsDir = path2.resolve(String(args["outputs-dir"] ?? "canvas"));
-    const runArg = String(args.run);
-    const runDir = await resolveRunDir(runArg, outputsDir);
-    const manifest = await loadManifest(runDir);
-    const files = await listRunFiles(runDir);
-    const videos = files.filter((f) => isVideoFile(f.path));
-    let thumbnails = [];
-    if (args.thumbnails) {
-      thumbnails = await extractThumbnails(videos.map((v) => v.path));
-    }
-    const summary = {
-      ok: true,
-      run_id: manifest.run_id ?? path2.basename(runDir),
-      run_dir: runDir,
-      stats: manifest.stats ?? null,
-      output: manifest.output ?? null,
-      node_runs: manifest.node_runs ?? [],
-      files: files.map((f) => ({ name: f.name, path: f.path, size_bytes: f.size })),
-      thumbnails
-    };
-    process.stdout.write(`${JSON.stringify(summary, null, 2)}
-`);
-  }
-});
-async function resolveRunDir(run, outputsDir) {
-  if (path2.isAbsolute(run)) {
-    const s2 = await stat(run).catch(() => null);
-    if (s2?.isDirectory()) return run;
-    throw new Error(`inspect: ${run} is not a directory`);
-  }
-  const candidate = path2.join(outputsDir, run);
-  const s = await stat(candidate).catch(() => null);
-  if (s?.isDirectory()) return candidate;
-  throw new Error(`inspect: no run directory at ${candidate}`);
-}
-async function loadManifest(runDir) {
-  const manifestPath = path2.join(runDir, "manifest.json");
-  try {
-    const raw = await readFile2(manifestPath, "utf-8");
-    return JSON.parse(raw);
-  } catch {
-    return {};
+async function loadManifest(runDir) {
+  const manifestPath = path.join(runDir, "manifest.json");
+  try {
+    const raw = await readFile(manifestPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
   }
 }
 async function listRunFiles(runDir) {
   const out = [];
-  const names = await readdir2(runDir);
+  const names = await readdir(runDir);
   for (const name of names) {
-    const abs = path2.join(runDir, name);
+    const abs = path.join(runDir, name);
     const s = await stat(abs).catch(() => null);
     if (!s?.isFile()) continue;
     out.push({ name, path: abs, size: s.size });
@@ -8397,8 +8262,8 @@ async function probeDuration(filePath) {
 }
 
 // src/commands/canvas/run.ts
-import { readFile as readFile3 } from "fs/promises";
-import path5 from "path";
+import { readFile as readFile2 } from "fs/promises";
+import path4 from "path";
 import { defineCommand as defineCommand81 } from "citty";
 
 // src/commands/canvas/placeholders.ts
@@ -8418,7 +8283,7 @@ function unsuppliedPlaceholderAssets(canvas) {
 }
 
 // src/commands/canvas/resolve-paths.ts
-import path3 from "path";
+import path2 from "path";
 function resolveRelativeCanvasPaths(canvas, baseDir) {
   if (!canvas || typeof canvas !== "object") return canvas;
   const c = canvas;
@@ -8431,37 +8296,37 @@ function resolveNode(node, baseDir) {
   const params = n.params;
   if (!params || typeof params !== "object") return node;
   if (n.type === "ingest" && params.source === "path" && isResolvableRelative(params.path)) {
-    return { ...node, params: { ...params, path: path3.resolve(baseDir, params.path) } };
+    return { ...node, params: { ...params, path: path2.resolve(baseDir, params.path) } };
   }
   if (n.type === "hyperframe_render" && isResolvableRelative(params.composition)) {
-    return { ...node, params: { ...params, composition: path3.resolve(baseDir, params.composition) } };
+    return { ...node, params: { ...params, composition: path2.resolve(baseDir, params.composition) } };
   }
   return node;
 }
 function isResolvableRelative(value) {
-  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !path3.isAbsolute(value);
+  return typeof value === "string" && value.length > 0 && !value.includes("[TODO") && !path2.isAbsolute(value);
 }
 
 // src/commands/canvas/run-retention.ts
 import { rm } from "fs/promises";
-import path4 from "path";
+import path3 from "path";
 function runDirsToPrune(entries, keep, currentRunId) {
   const runs = entries.filter((e) => /^r_[0-9A-Za-z]+$/.test(e) && e !== currentRunId).sort();
   if (keep <= 0) return runs;
   return runs.slice(0, Math.max(0, runs.length - keep));
 }
 async function pruneOldRuns(outputsDir, keep, currentRunId, log) {
-  const { readdir: readdir4 } = await import("fs/promises");
+  const { readdir: readdir3 } = await import("fs/promises");
   let entries;
   try {
-    entries = await readdir4(outputsDir);
+    entries = await readdir3(outputsDir);
   } catch {
     return;
   }
   const toPrune = runDirsToPrune(entries, keep, currentRunId);
   if (toPrune.length === 0) return;
   for (const dir of toPrune) {
-    await rm(path4.join(outputsDir, dir), { recursive: true, force: true }).catch(
+    await rm(path3.join(outputsDir, dir), { recursive: true, force: true }).catch(
       (e) => log(`[prune   ] could not remove ${dir}: ${e.message}`)
     );
   }
@@ -8483,8 +8348,8 @@ var runCommand = defineCommand81({
     }
   },
   async run({ args }) {
-    const filePath = path5.resolve(String(args.file));
-    const raw = await readFile3(filePath, "utf8");
+    const filePath = path4.resolve(String(args.file));
+    const raw = await readFile2(filePath, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -8494,7 +8359,7 @@ var runCommand = defineCommand81({
 `);
       process.exit(2);
     }
-    parsed = resolveRelativeCanvasPaths(parsed, path5.dirname(filePath));
+    parsed = resolveRelativeCanvasPaths(parsed, path4.dirname(filePath));
     const pending = unsuppliedPlaceholderAssets(parsed);
     if (pending.length > 0) {
       process.stderr.write(
@@ -8528,7 +8393,7 @@ var runCommand = defineCommand81({
       });
       const keepRuns = args["keep-runs"] !== void 0 ? Number(args["keep-runs"]) : void 0;
       if (keepRuns !== void 0 && Number.isFinite(keepRuns)) {
-        const outputsDir = args["outputs-dir"] ? path5.resolve(String(args["outputs-dir"])) : path5.resolve("canvas");
+        const outputsDir = args["outputs-dir"] ? path4.resolve(String(args["outputs-dir"])) : path4.resolve("canvas");
         await pruneOldRuns(outputsDir, keepRuns, result.run_id, (line) => process.stdout.write(`${line}
 `));
       }
@@ -8563,8 +8428,8 @@ var runCommand = defineCommand81({
 });
 
 // src/commands/canvas/scaffold-static-ad.ts
-import { readFile as readFile4, writeFile } from "fs/promises";
-import path6 from "path";
+import { readFile as readFile3, writeFile } from "fs/promises";
+import path5 from "path";
 import { defineCommand as defineCommand82 } from "citty";
 
 // src/engine/scaffold/staticAd.ts
@@ -8778,7 +8643,7 @@ var SELECT_SYSTEM = 'You identify the MAIN, identity-critical visual elements of
 var SELECT_PROMPT = 'AD BLUEPRINT (from image_describe):\n{{blueprint}}\n\nFrom this blueprint, list ONLY the elements that are prominent, important, and identity-bearing \u2014 the ones a reproduction must ground in a real asset:\n- the brand logo/wordmark (from brands_logos with function_in_image = advertiser_brand) -> type "logo"\n- trust/rating/certification/app-store/review badges (brands_logos with function_in_image = trust_badge | review_platform | certification_or_seal | app_store_badge | payment_method) -> type "badge"\n- a showcased/hero product or package (a foreground entry in subjects that the ad is selling) -> type "product"\n- a foreground person whose identity matters (from people) -> type "person"\n- a foreground animal/character with a specific expression (from subjects) -> type "animal"\n\nDROP background extras, decorative props, generic scenery, and anything small or incidental. Keep at most ~6. If there are none, return an empty list.\n\nFor each kept element return: { "type": one of logo|product|person|animal|badge, "label": a short UPPER_SNAKE_CASE name (e.g. LOGO, PRODUCT, HERO_DOG, TRUSTPILOT), "description": a concrete reusable description to source/shoot the real asset (include the exact expression for a living subject), "expression": the facial expression for a living subject or null, "reason": why it is identity-critical, "locator": the blueprint entry this element came from as { "collection": one of "subjects" | "people" | "brands_logos", "index": its 0-based position in that array } (people -> people; logos/badges -> brands_logos; products/animals/objects -> subjects). Output ONLY the JSON object.';
 async function loadAssetText(ref, label) {
   const r = ref;
-  if (typeof r?.path === "string") return readFile4(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile3(r.path, "utf8");
   if (typeof r?.url === "string") {
     const res = await fetch(r.url);
     if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
@@ -8901,10 +8766,10 @@ var scaffoldStaticAdCommand = defineCommand82({
     "skip-font": { type: "boolean", description: "Skip the brand-font \u2192 type-specimen slot" }
   },
   async run({ args }) {
-    const imagePath = path6.resolve(String(args.file));
-    const outPath = args.out ? path6.resolve(String(args.out)) : path6.join(path6.dirname(imagePath), "static-ad.canvas.json");
-    const outDir = path6.dirname(outPath);
-    const blueprintPath = path6.join(outDir, "prompt.json");
+    const imagePath = path5.resolve(String(args.file));
+    const outPath = args.out ? path5.resolve(String(args.out)) : path5.join(path5.dirname(imagePath), "static-ad.canvas.json");
+    const outDir = path5.dirname(outPath);
+    const blueprintPath = path5.join(outDir, "prompt.json");
     const { describeModel, selectModel, layoutModel, genModel } = resolveModels(args);
     const describeCanvas = buildDescribeCanvas(
       imagePath,
@@ -8961,7 +8826,7 @@ var scaffoldStaticAdCommand = defineCommand82({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path6.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
+            edit_prompt: `Edit ${path5.basename(blueprintPath)} \u2014 it is the blueprint generated from your image; rewrite it into the ad you want (palette, copy, claims, subjects). It feeds the generator directly.`,
             assets_to_supply: report.elements,
             font_slot: report.includes_font ? "Drop a brand font at the [TODO] brandfont path, or delete the brandfont + type_ref nodes to skip it." : "skipped (--skip-font)",
             note: "Replace every [TODO] ingest path with a real file, then `baker canvas validate` and `baker canvas run`. Running generates a billed image \u2014 it is not free."
@@ -8976,13 +8841,13 @@ var scaffoldStaticAdCommand = defineCommand82({
 });
 
 // src/commands/canvas/scaffold-video.ts
-import { cp, mkdir, readFile as readFile7, writeFile as writeFile2 } from "fs/promises";
-import path9 from "path";
+import { cp, mkdir, readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
+import path8 from "path";
 import { defineCommand as defineCommand83 } from "citty";
 
 // src/engine/nodes/local/lib/sceneDetect.ts
 import { execFile as execFile2 } from "child_process";
-import { mkdtemp, readdir as readdir3, readFile as readFile5, rm as rm2 } from "fs/promises";
+import { mkdtemp, readdir as readdir2, readFile as readFile4, rm as rm2 } from "fs/promises";
 import { tmpdir } from "os";
 import { join as join2 } from "path";
 import { promisify as promisify2 } from "util";
@@ -9046,9 +8911,9 @@ async function runSceneDetectOnce(filePath, threshold, minSceneLenS, timeoutMs)
       ],
       { encoding: "utf-8", maxBuffer: 32 * 1024 * 1024, timeout: timeoutMs }
     );
-    const csvName = (await readdir3(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
+    const csvName = (await readdir2(outDir)).find((f) => f.toLowerCase().endsWith(".csv"));
     if (!csvName) return [];
-    return parsePySceneDetectCsvCuts(await readFile5(join2(outDir, csvName), "utf-8"));
+    return parsePySceneDetectCsvCuts(await readFile4(join2(outDir, csvName), "utf-8"));
   } finally {
     await rm2(outDir, { recursive: true, force: true });
   }
@@ -11593,23 +11458,23 @@ function videoReport(input, elementsInput) {
 
 // src/commands/canvas/composition-path.ts
 import { existsSync as existsSync3 } from "fs";
-import path7 from "path";
+import path6 from "path";
 function resolveShippedCanvasDir(name, startDir, exists = existsSync3, maxDepth = 8) {
-  const rel = path7.join("canvas", name);
+  const rel = path6.join("canvas", name);
   let dir = startDir;
   for (let i = 0; i < maxDepth; i++) {
-    const candidate = path7.join(dir, rel);
-    if (exists(path7.join(candidate, "meta.json"))) return candidate;
-    const parent = path7.dirname(dir);
+    const candidate = path6.join(dir, rel);
+    if (exists(path6.join(candidate, "meta.json"))) return candidate;
+    const parent = path6.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path7.resolve(startDir, "../../../", rel);
+  return path6.resolve(startDir, "../../../", rel);
 }
 
 // src/commands/canvas/gitignore.ts
-import { appendFile, readFile as readFile6 } from "fs/promises";
-import path8 from "path";
+import { appendFile, readFile as readFile5 } from "fs/promises";
+import path7 from "path";
 function missingGitignoreEntries(existing, entries) {
   const present = new Set(
     existing.split("\n").map((l) => l.trim().replace(/\/+$/, "")).filter((l) => l.length > 0 && !l.startsWith("#"))
@@ -11617,10 +11482,10 @@ function missingGitignoreEntries(existing, entries) {
   return entries.filter((e) => !present.has(e.trim().replace(/\/+$/, "")));
 }
 async function ensureGitignore(dir, entries) {
-  const file = path8.join(dir, ".gitignore");
+  const file = path7.join(dir, ".gitignore");
   let existing;
   try {
-    existing = await readFile6(file, "utf8");
+    existing = await readFile5(file, "utf8");
   } catch {
     return;
   }
@@ -11659,7 +11524,7 @@ ONE PERSON, MULTIPLE LOOKS: if a single individual plays MULTIPLE personas or wa
 For each kept element return: { "type": one of person|animal|product|logo|badge|location, "label": a short UPPER_SNAKE_CASE name (e.g. HERO, CREATOR_SKEPTIC, INSURANCE_CARD, LOGO), "description": a concrete reusable description to source/shoot the real asset \u2014 for a person/animal give a NEUTRAL castable role (e.g. "hero pet-owner, woman in her 30s" or "a small beagle"), NOT the original individual's literal face/identity: we RECAST with a FRESH person/animal, so never tell the agent to reuse the original. "expression": a living subject's typical expression or null, "cast_id": the global.cast id if it maps to one else null, "same_as": the label of another element this is the SAME individual as (different wardrobe/persona) else null, "scenes": the 0-based indices of ONLY the scenes where the element is ACTUALLY VISIBLE ON SCREEN \u2014 judged from that scene's start_frame_prompt / end_frame_prompt subjects and its action_detail, NOT from who is merely speaking. A narrator heard over b-roll is NOT present in that b-roll scene; a dog-running cutaway does NOT contain the couch creator just because she talks across it. Do NOT pad the list \u2014 an element wrongly listed in a scene makes the reproduction render the wrong subject there (e.g. the creator appearing in a pure-dog b-roll). When in doubt, leave a scene OUT. Output ONLY the JSON object.`;
 async function loadAssetText2(ref, label) {
   const r = ref;
-  if (typeof r?.path === "string") return readFile7(r.path, "utf8");
+  if (typeof r?.path === "string") return readFile6(r.path, "utf8");
   if (typeof r?.url === "string") {
     const res = await fetch(r.url);
     if (!res.ok) throw new Error(`failed to fetch ${label} (${res.status})`);
@@ -11678,7 +11543,7 @@ async function loadTranscriptBestEffort(ref) {
 async function stageCaptions(outDir, transcript) {
   const text = transcript?.trim();
   if (!text || text === "[]") return {};
-  const compositionPath = path9.join(outDir, "tiktok-captions-composition");
+  const compositionPath = path8.join(outDir, "tiktok-captions-composition");
   await cp(SHIPPED_CAPTIONS_DIR, compositionPath, { recursive: true });
   return { compositionPath };
 }
@@ -11840,11 +11705,11 @@ var scaffoldVideoCommand = defineCommand83({
     }
   },
   async run({ args }) {
-    const videoPath = path9.resolve(String(args.file));
-    const base = path9.basename(videoPath, path9.extname(videoPath));
-    const outPath = args.out ? path9.resolve(String(args.out)) : path9.join(path9.dirname(videoPath), `${base}.video.canvas.json`);
-    const outDir = path9.dirname(outPath);
-    const blueprintPath = path9.join(outDir, "prompt.json");
+    const videoPath = path8.resolve(String(args.file));
+    const base = path8.basename(videoPath, path8.extname(videoPath));
+    const outPath = args.out ? path8.resolve(String(args.out)) : path8.join(path8.dirname(videoPath), `${base}.video.canvas.json`);
+    const outDir = path8.dirname(outPath);
+    const blueprintPath = path8.join(outDir, "prompt.json");
     const frames = args.frames === "reuse" ? "reuse" : "generate";
     const maxScenes = args["max-scenes"] ? Number(args["max-scenes"]) : void 0;
     if (Number.isFinite(maxScenes)) {
@@ -11867,11 +11732,11 @@ var scaffoldVideoCommand = defineCommand83({
     const annotated = annotateBlueprintWithElements(blueprint, elements);
     await writeFile2(blueprintPath, `${JSON.stringify(annotated, null, 2)}
 `, "utf8");
-    const compositionDest = path9.join(outDir, "video-overlay-composition");
+    const compositionDest = path8.join(outDir, "video-overlay-composition");
     await cp(SHIPPED_COMPOSITION_DIR, compositionDest, { recursive: true });
-    const indexPath = path9.join(compositionDest, "index.html");
+    const indexPath = path8.join(compositionDest, "index.html");
     const overlayHtml = buildOverlayHtml(blueprint);
-    const indexHtml = await readFile7(indexPath, "utf8");
+    const indexHtml = await readFile6(indexPath, "utf8");
     const injected = indexHtml.replace("<!--OVERLAYS-->", () => overlayHtml);
     if (injected === indexHtml && overlayHtml.trim()) {
       fail2(
@@ -11884,9 +11749,9 @@ var scaffoldVideoCommand = defineCommand83({
     const opts = {
       imageModel,
       videoModel,
-      overlayCompositionPath: path9.relative(outDir, compositionDest),
-      captionsCompositionPath: captions.compositionPath ? path9.relative(outDir, captions.compositionPath) : void 0,
-      blueprintPath: path9.relative(outDir, blueprintPath),
+      overlayCompositionPath: path8.relative(outDir, compositionDest),
+      captionsCompositionPath: captions.compositionPath ? path8.relative(outDir, captions.compositionPath) : void 0,
+      blueprintPath: path8.relative(outDir, blueprintPath),
       frames,
       ambient: Boolean(args.ambient),
       ...args.resolution ? { resolution: String(args.resolution) } : {}
@@ -11927,7 +11792,7 @@ var scaffoldVideoCommand = defineCommand83({
             run_estimated_credits: validation.estimatedCredits
           },
           checklist: {
-            edit_prompt: `Edit ${path9.basename(blueprintPath)} \u2014 the blueprint deconstructed from your video; rewrite it into the ad you want (cast, palette, copy, claims). Every scene frame reads it via target_blueprint.`,
+            edit_prompt: `Edit ${path8.basename(blueprintPath)} \u2014 the blueprint deconstructed from your video; rewrite it into the ad you want (cast, palette, copy, claims). Every scene frame reads it via target_blueprint.`,
             recurring_elements_to_supply: report.elements,
             voices_to_confirm: report.dialogue.map((d) => ({
               scene: d.scene,
@@ -11953,8 +11818,8 @@ var scaffoldVideoCommand = defineCommand83({
 });
 
 // src/commands/canvas/set-prompt.ts
-import { readFile as readFile8, writeFile as writeFile3 } from "fs/promises";
-import path10 from "path";
+import { readFile as readFile7, writeFile as writeFile3 } from "fs/promises";
+import path9 from "path";
 import { defineCommand as defineCommand84 } from "citty";
 function setNodePrompt(canvas, nodeId, text) {
   const nodes = canvas?.nodes;
@@ -11982,17 +11847,17 @@ var setPromptCommand = defineCommand84({
     "text-file": { type: "string", description: "Read the new prompt from a UTF-8 file (preserves accents/newlines)" }
   },
   async run({ args }) {
-    const filePath = path10.resolve(String(args.file));
+    const filePath = path9.resolve(String(args.file));
     let canvas;
     try {
-      canvas = JSON.parse(await readFile8(filePath, "utf8"));
+      canvas = JSON.parse(await readFile7(filePath, "utf8"));
     } catch (e) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "parse", message: String(e) } }, null, 2)}
 `);
       process.exit(2);
     }
     let text;
-    if (args["text-file"]) text = await readFile8(path10.resolve(String(args["text-file"])), "utf8");
+    if (args["text-file"]) text = await readFile7(path9.resolve(String(args["text-file"])), "utf8");
     else if (args.text !== void 0) text = String(args.text);
     else {
       process.stderr.write(
@@ -12013,7 +11878,7 @@ var setPromptCommand = defineCommand84({
       process.exit(2);
       return;
     }
-    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path10.dirname(filePath)), defaultRegistry());
+    const validation = await validateCanvasDeep(resolveRelativeCanvasPaths(updated, path9.dirname(filePath)), defaultRegistry());
     if (!validation.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, error: { code: "validation", issues: validation.issues } }, null, 2)}
 `);
@@ -12028,8 +11893,8 @@ var setPromptCommand = defineCommand84({
 });
 
 // src/commands/canvas/validate.ts
-import { readFile as readFile9 } from "fs/promises";
-import path11 from "path";
+import { readFile as readFile8 } from "fs/promises";
+import path10 from "path";
 import { defineCommand as defineCommand85 } from "citty";
 var validateCommand = defineCommand85({
   meta: {
@@ -12038,8 +11903,8 @@ var validateCommand = defineCommand85({
   },
   args: { file: { type: "positional", required: true, description: "Path to canvas JSON" } },
   async run({ args }) {
-    const filePath = path11.resolve(String(args.file));
-    const raw = await readFile9(filePath, "utf8");
+    const filePath = path10.resolve(String(args.file));
+    const raw = await readFile8(filePath, "utf8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -12049,7 +11914,7 @@ var validateCommand = defineCommand85({
 `);
       process.exit(2);
     }
-    parsed = resolveRelativeCanvasPaths(parsed, path11.dirname(filePath));
+    parsed = resolveRelativeCanvasPaths(parsed, path10.dirname(filePath));
     const result = await validateCanvasDeep(parsed, defaultRegistry());
     if (!result.ok) {
       process.stderr.write(`${JSON.stringify({ ok: false, issues: result.issues }, null, 2)}
@@ -12086,7 +11951,6 @@ Subcommands:
   baker canvas run <file.json>        \u2014 execute the canvas, write outputs to ./canvas/<run_id>/
   baker canvas catalog                \u2014 print the agent-facing node + composition catalog (JSON Schema)
   baker canvas inspect <run_id>       \u2014 one-page summary of a completed run
-  baker canvas gallery <dir>          \u2014 read a creative folder's _definition.md + run manifests into the dashboard gallery descriptor (JSON)
   baker canvas scaffold-video <video>                \u2014 turn a reference video into a runnable reproduction canvas (deconstruct + recurring-element detection)
   baker canvas scaffold-static-ad <image>            \u2014 turn a source image into a runnable static-ad canvas (describe + element detection)`
   },
@@ -12095,18 +11959,333 @@ Subcommands:
     validate: validateCommand,
     catalog: catalogCommand,
     inspect: inspectCommand,
-    gallery: galleryCommand,
     "scaffold-video": scaffoldVideoCommand,
     "scaffold-static-ad": scaffoldStaticAdCommand,
     "set-prompt": setPromptCommand
   }
 });
 
+// src/commands/creatives/index.ts
+import { defineCommand as defineCommand88 } from "citty";
+
+// src/commands/creatives/publish.ts
+import { extname as extname2 } from "path";
+import { defineCommand as defineCommand87 } from "citty";
+
+// src/commands/images/api.ts
+import { readFile as readFile9 } from "fs/promises";
+import { extname } from "path";
+var imageProcessingTimeoutMs = 18e4;
+var imageReadyPollIntervalMs = 2e3;
+var mimeMap = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".avif": "image/avif"
+};
+var defaultImageApiDeps = {
+  readFile: readFile9,
+  post: apiPost,
+  get: apiGet,
+  sleep: (ms) => new Promise((resolve5) => setTimeout(resolve5, ms))
+};
+function detectImageContentType(filePath, opts = {}) {
+  const ext = extname(filePath).toLowerCase();
+  const contentType = mimeMap[ext];
+  if (!contentType || opts.allowedContentTypes && !opts.allowedContentTypes.includes(contentType)) {
+    throw new ApiError(
+      "VALIDATION_ERROR",
+      opts.unsupportedMessage ?? `Cannot detect content type for extension "${ext}". Use --content-type.`
+    );
+  }
+  return contentType;
+}
+async function uploadLocalImage(args, deps = defaultImageApiDeps) {
+  const fileBuffer = await deps.readFile(args.file);
+  const body = {
+    base64: fileBuffer.toString("base64"),
+    contentType: args.contentType
+  };
+  if (args.source) body.source = args.source;
+  if (args.descriptionContext) body.descriptionContext = args.descriptionContext;
+  return deps.post("/api/images/upload", body, { timeoutMs: imageProcessingTimeoutMs });
+}
+function getImage(deps, imageId) {
+  return deps.get("/api/images/get", { id: imageId });
+}
+async function waitForReadyImage(deps, imageId, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? imageProcessingTimeoutMs;
+  const pollIntervalMs = opts.pollIntervalMs ?? imageReadyPollIntervalMs;
+  const deadline = Date.now() + timeoutMs;
+  let lastStatus = "unknown";
+  while (Date.now() <= deadline) {
+    const image = await getImage(deps, imageId);
+    lastStatus = image.status ?? "unknown";
+    if (image.status === "ready") {
+      return image;
+    }
+    if (image.status === "error") {
+      throw new ApiError("IMAGE_PROCESSING_ERROR", "Image processing failed");
+    }
+    await deps.sleep(pollIntervalMs);
+  }
+  throw new ApiError("TIMEOUT", `Image was not ready before timeout; last status: ${lastStatus}`);
+}
+
+// src/commands/creatives/publish.ts
+var creativeTag = "creative";
+var winningAdsTag = "winning-ads";
+var creativeTags = [creativeTag, winningAdsTag];
+var creativeImageContentTypes = ["image/png", "image/jpeg", "image/webp"];
+var creativeVideoContentTypesByExtension = {
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime",
+  ".webm": "video/webm"
+};
+var videoProcessingTimeoutMs = 5 * 60 * 1e3;
+var videoReadyPollIntervalMs = 5e3;
+var defaultCreativePublishDeps = {
+  ...defaultImageApiDeps,
+  fetch
+};
+registerSchema({
+  command: "creatives.publish",
+  description: "Publish a final creative image or video, apply creative and winning-ads tags, and return an asset reference.",
+  args: {
+    file: { type: "string", description: "Local PNG/JPG/WebP/MP4/MOV/WebM creative path", required: true },
+    title: { type: "string", description: "Human title for the creative output", required: true },
+    body: { type: "string", description: "Reference traceability body for the creative output", required: true }
+  }
+});
+function uniqueTags(tags) {
+  return [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))];
+}
+function requiredMetadata(args) {
+  const title = args.title.trim();
+  const body = args.body.trim();
+  if (!title) {
+    throw new ApiError("VALIDATION_ERROR", "--title is required");
+  }
+  if (!body) {
+    throw new ApiError("VALIDATION_ERROR", "--body is required");
+  }
+  return { title, body };
+}
+function detectCreativeContentType(filePath) {
+  const ext = extname2(filePath).toLowerCase();
+  const videoContentType = creativeVideoContentTypesByExtension[ext];
+  if (videoContentType) {
+    return videoContentType;
+  }
+  return detectImageContentType(filePath, {
+    allowedContentTypes: creativeImageContentTypes,
+    unsupportedMessage: "Unsupported creative extension. Use PNG, JPG, WebP, MP4, MOV, or WebM."
+  });
+}
+function isVideoContentType(contentType) {
+  return contentType.startsWith("video/");
+}
+function imageToCreativeReference(image, title) {
+  if (!image.imageUrl) {
+    throw new ApiError("IMAGE_PROCESSING_ERROR", "Published image is missing imageUrl");
+  }
+  const tags = uniqueTags([...image.tags ?? [], ...creativeTags]);
+  return {
+    type: "image",
+    slug: image._id,
+    title,
+    body: image.description,
+    tags,
+    imageUrl: image.imageUrl,
+    thumbnailUrl: image.thumbnailUrl ?? image.imageUrl,
+    storageKey: image.storageKey,
+    width: image.width,
+    height: image.height,
+    aspectRatio: image.aspectRatio,
+    source: image.source
+  };
+}
+function videoToCreativeReference(video, title) {
+  const tags = uniqueTags([...video.tags, ...creativeTags]);
+  return {
+    type: "video",
+    slug: video._id,
+    title,
+    body: video.description,
+    tags,
+    thumbnailUrl: video.thumbnailUrl,
+    muxPlaybackId: video.muxPlaybackId,
+    playbackUrl: video.muxPlaybackId ? `https://stream.mux.com/${video.muxPlaybackId}.m3u8` : void 0,
+    duration: video.duration,
+    width: video.width,
+    height: video.height,
+    aspectRatio: video.aspectRatio,
+    source: video.source
+  };
+}
+async function updateImageMetadata(deps, args) {
+  await deps.post("/api/images/update-description", {
+    imageId: args.imageId,
+    name: args.title,
+    description: args.body,
+    tags: args.tags
+  });
+}
+function createVideoUpload(deps) {
+  return deps.post("/api/videos/upload", {});
+}
+function getVideo(deps, videoId) {
+  return deps.get("/api/videos/get", { id: videoId });
+}
+async function updateVideoMetadata(deps, args) {
+  await deps.post("/api/videos/update-description", {
+    videoId: args.videoId,
+    name: args.title,
+    description: args.body,
+    tags: args.tags
+  });
+}
+async function waitForReadyVideo(deps, videoId, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? videoProcessingTimeoutMs;
+  const pollIntervalMs = opts.pollIntervalMs ?? videoReadyPollIntervalMs;
+  const deadline = Date.now() + timeoutMs;
+  let lastStatus = "unknown";
+  while (Date.now() <= deadline) {
+    const video = await getVideo(deps, videoId);
+    lastStatus = video.status ?? "unknown";
+    if (video.status === "ready") {
+      return video;
+    }
+    if (video.status === "error") {
+      throw new ApiError(
+        "INTERNAL_ERROR",
+        `Video processing failed for videoId ${videoId}: ${video.errorMessage ?? "unknown error"}`
+      );
+    }
+    await deps.sleep(pollIntervalMs);
+  }
+  throw new ApiError("TIMEOUT", `Video was not ready before timeout; videoId: ${videoId}; last status: ${lastStatus}`);
+}
+async function uploadLocalVideo(args, deps) {
+  const { uploadUrl, videoId } = await createVideoUpload(deps);
+  const fileBuffer = await deps.readFile(args.file);
+  const uploadResponse = await deps.fetch(uploadUrl, {
+    method: "PUT",
+    headers: { "Content-Type": args.contentType },
+    body: fileBuffer
+  });
+  if (!uploadResponse.ok) {
+    throw new ApiError(
+      "INTERNAL_ERROR",
+      `Mux upload failed: HTTP ${uploadResponse.status} ${uploadResponse.statusText}`
+    );
+  }
+  return { videoId };
+}
+async function publishCreativeImage(args, deps) {
+  const upload = await uploadLocalImage(
+    {
+      file: args.file,
+      contentType: args.contentType,
+      source: "ai_generated",
+      descriptionContext: args.body
+    },
+    deps
+  );
+  const readyImage = await waitForReadyImage(deps, upload.imageId, { timeoutMs: imageProcessingTimeoutMs });
+  const tags = uniqueTags([...readyImage.tags ?? [], ...creativeTags]);
+  await updateImageMetadata(deps, { imageId: upload.imageId, title: args.title, body: args.body, tags });
+  const taggedImage = await getImage(deps, upload.imageId);
+  return {
+    imageId: upload.imageId,
+    reference: imageToCreativeReference({ ...readyImage, ...taggedImage }, args.title)
+  };
+}
+async function publishCreativeVideo(args, deps) {
+  const { videoId } = await uploadLocalVideo({ file: args.file, contentType: args.contentType }, deps);
+  const readyVideo = await waitForReadyVideo(deps, videoId);
+  const tags = uniqueTags([...readyVideo.tags, ...creativeTags]);
+  await updateVideoMetadata(deps, { videoId, title: args.title, body: args.body, tags });
+  const taggedVideo = await getVideo(deps, videoId);
+  return { videoId, reference: videoToCreativeReference(taggedVideo, args.title) };
+}
+function publishCreative(args, deps = defaultCreativePublishDeps) {
+  try {
+    const metadata = requiredMetadata(args);
+    const contentType = detectCreativeContentType(args.file);
+    if (isVideoContentType(contentType)) {
+      return publishCreativeVideo({ file: args.file, ...metadata, contentType }, deps);
+    }
+    return publishCreativeImage({ file: args.file, ...metadata, contentType }, deps);
+  } catch (error) {
+    return Promise.reject(error);
+  }
+}
+var publishCommand = defineCommand87({
+  meta: {
+    name: "publish",
+    description: "Publish a final creative image or video, tag it as creative and winning-ads, and print the asset reference JSON."
+  },
+  args: {
+    file: { type: "positional", description: "Local PNG/JPG/WebP/MP4/MOV/WebM creative path", required: false },
+    title: { type: "string", description: "Human title for the creative output", required: false },
+    body: { type: "string", description: "Reference traceability body for the creative output", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const file = args.file;
+      const title = args.title;
+      const body = args.body;
+      if (!file) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "File path is required" } });
+        process.exit(1);
+      }
+      if (!title) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "--title is required" } });
+        process.exit(1);
+      }
+      if (!body) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "--body is required" } });
+        process.exit(1);
+      }
+      const data = await publishCreative({ file, title, body });
+      writeJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/creatives/index.ts
+var creativesCommand3 = defineCommand88({
+  meta: {
+    name: "creatives",
+    description: `Publish ad creatives as first-class Baker outputs.
+
+Creative handoff:
+  baker creatives publish ./canvas/run/final.png --title "Winning Ads: Offer + Meta 4:5 + Angle" --body "Reference: Advertiser[ad_id]: https://example.com/ad.mp4
+Angle adapted: Client-safe angle"
+
+Publishing routes images to Images and videos to the video library, applies creative + winning-ads tags, and returns an asset reference for chat previews.`
+  },
+  subCommands: {
+    publish: publishCommand
+  }
+});
+
 // src/commands/ga4/index.ts
-import { defineCommand as defineCommand90 } from "citty";
+import { defineCommand as defineCommand92 } from "citty";
 
 // src/commands/ga4/audit.ts
-import { defineCommand as defineCommand87 } from "citty";
+import { defineCommand as defineCommand89 } from "citty";
 
 // src/commands/ga4/resolve.ts
 async function fetchProperties(useCache = true) {
@@ -12169,7 +12348,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var auditCommand2 = defineCommand87({
+var auditCommand2 = defineCommand89({
   meta: {
     name: "audit",
     description: `Run all GA4 admin health checks. Returns property config with playbook warnings.
@@ -12221,7 +12400,7 @@ Examples:
 });
 
 // src/commands/ga4/properties.ts
-import { defineCommand as defineCommand88 } from "citty";
+import { defineCommand as defineCommand90 } from "citty";
 registerSchema({
   command: "ga4.properties",
   description: "List all accessible GA4 properties. Returns property IDs needed for query and audit commands. Run this first to find property IDs.",
@@ -12229,7 +12408,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var propertiesCommand = defineCommand88({
+var propertiesCommand = defineCommand90({
   meta: {
     name: "properties",
     description: `List accessible GA4 properties.
@@ -12279,7 +12458,7 @@ Examples:
 // src/commands/ga4/query.ts
 import { appendFileSync as appendFileSync2, existsSync as existsSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve2 } from "path";
-import { defineCommand as defineCommand89 } from "citty";
+import { defineCommand as defineCommand91 } from "citty";
 
 // src/commands/ga4/presets.ts
 var GA4_PRESETS = [
@@ -12411,7 +12590,7 @@ function handleError(err) {
   });
   process.exit(1);
 }
-var queryCommand2 = defineCommand89({
+var queryCommand2 = defineCommand91({
   meta: {
     name: "query",
     description: `Run GA4 Data API reports. Preset-first with free-form escape hatch.
@@ -12482,7 +12661,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/ga4/index.ts
-var ga4Command = defineCommand90({
+var ga4Command = defineCommand92({
   meta: {
     name: "ga4",
     description: `Google Analytics 4 commands. Audit property config, run playbook-aligned reports.
@@ -12505,12 +12684,12 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-import { defineCommand as defineCommand94 } from "citty";
+import { defineCommand as defineCommand96 } from "citty";
 
 // src/commands/gsc/query.ts
 import { appendFileSync as appendFileSync3, existsSync as existsSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve3 } from "path";
-import { defineCommand as defineCommand91 } from "citty";
+import { defineCommand as defineCommand93 } from "citty";
 
 // src/commands/gsc/presets.ts
 var GSC_PRESETS = [
@@ -12698,7 +12877,7 @@ function handleError2(err) {
   });
   process.exit(1);
 }
-var queryCommand3 = defineCommand91({
+var queryCommand3 = defineCommand93({
   meta: {
     name: "query",
     description: `Run GSC Search Analytics queries. Preset-first with free-form escape hatch.
@@ -12776,7 +12955,7 @@ Free-form (escape hatch):
 });
 
 // src/commands/gsc/sitemaps.ts
-import { defineCommand as defineCommand92 } from "citty";
+import { defineCommand as defineCommand94 } from "citty";
 registerSchema({
   command: "gsc.sitemaps",
   description: "List sitemaps for a Search Console site. Check sitemap health and errors.",
@@ -12785,7 +12964,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitemapsCommand = defineCommand92({
+var sitemapsCommand = defineCommand94({
   meta: {
     name: "sitemaps",
     description: `List sitemaps for a site. Check health and errors.
@@ -12835,7 +13014,7 @@ Examples:
 });
 
 // src/commands/gsc/sites.ts
-import { defineCommand as defineCommand93 } from "citty";
+import { defineCommand as defineCommand95 } from "citty";
 registerSchema({
   command: "gsc.sites",
   description: "List all verified Google Search Console sites. Returns site URLs needed for query and sitemaps commands.",
@@ -12843,7 +13022,7 @@ registerSchema({
     "no-cache": { type: "boolean", description: "Skip cache, hit API directly", required: false }
   }
 });
-var sitesCommand = defineCommand93({
+var sitesCommand = defineCommand95({
   meta: {
     name: "sites",
     description: `List verified Search Console sites.
@@ -12891,7 +13070,7 @@ Examples:
 });
 
 // src/commands/gsc/index.ts
-var gscCommand = defineCommand94({
+var gscCommand = defineCommand96({
   meta: {
     name: "gsc",
     description: `Google Search Console commands. PPC-SEO arbitrage, brand halo analysis, negative keyword discovery.
@@ -12914,10 +13093,10 @@ Examples:
 });
 
 // src/commands/images/index.ts
-import { defineCommand as defineCommand118 } from "citty";
+import { defineCommand as defineCommand120 } from "citty";
 
 // src/commands/images/crop.ts
-import { defineCommand as defineCommand95 } from "citty";
+import { defineCommand as defineCommand97 } from "citty";
 
 // src/lib/image/crop-sprite.ts
 import sharp from "sharp";
@@ -12933,7 +13112,7 @@ function cropSprite(input, region) {
 // src/lib/image/io.ts
 import { randomBytes } from "crypto";
 import { glob as fsGlob, readFile as readFile10, rename, stat as stat2, writeFile as writeFile4 } from "fs/promises";
-import { dirname, extname, join as join3, resolve as resolve4 } from "path";
+import { dirname, extname as extname3, join as join3, resolve as resolve4 } from "path";
 var REMOTE_RE = /^https?:\/\//i;
 var GLOB_RE = /[*?[\]{}]/;
 function isRemoteUrl(value) {
@@ -12970,16 +13149,16 @@ async function readImageBuffer(pathOrUrl) {
   }
   return readFile10(pathOrUrl);
 }
-async function isDirectory(path12) {
+async function isDirectory(path11) {
   try {
-    const s = await stat2(path12);
+    const s = await stat2(path11);
     return s.isDirectory();
   } catch {
     return false;
   }
 }
 async function resolveOutputPath(inputPath, outputArg, options) {
-  const base = options.newExtension ? inputPath.slice(0, -extname(inputPath).length) + options.newExtension : inputPath;
+  const base = options.newExtension ? inputPath.slice(0, -extname3(inputPath).length) + options.newExtension : inputPath;
   if (!outputArg) return base;
   if (options.multipleInputs || await isDirectory(outputArg)) {
     const filename = base.split("/").pop() ?? "out.png";
@@ -13042,7 +13221,7 @@ function emitError2(err) {
   }
   process.exit(1);
 }
-var cropCommand = defineCommand95({
+var cropCommand = defineCommand97({
   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"
@@ -13078,7 +13257,7 @@ var cropCommand = defineCommand95({
 });
 
 // src/commands/images/delete.ts
-import { defineCommand as defineCommand96 } from "citty";
+import { defineCommand as defineCommand98 } from "citty";
 registerSchema({
   command: "images.delete",
   description: "Delete an image by ID",
@@ -13092,7 +13271,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand = defineCommand96({
+var deleteCommand = defineCommand98({
   meta: {
     name: "delete",
     description: "Delete an image by ID. Use --dry-run to preview. Example: baker images delete j571abc123 --dry-run"
@@ -13133,7 +13312,7 @@ var deleteCommand = defineCommand96({
 });
 
 // src/commands/images/dimensions.ts
-import { defineCommand as defineCommand97 } from "citty";
+import { defineCommand as defineCommand99 } from "citty";
 
 // src/lib/image/dimensions.ts
 import { imageSize } from "image-size";
@@ -13156,7 +13335,7 @@ registerSchema({
     target: { type: "string", description: "Local file path or remote http(s) URL", required: true }
   }
 });
-var dimensionsCommand = defineCommand97({
+var dimensionsCommand = defineCommand99({
   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"
@@ -13200,7 +13379,7 @@ var dimensionsCommand = defineCommand97({
 });
 
 // src/commands/images/extract.ts
-import { defineCommand as defineCommand98 } from "citty";
+import { defineCommand as defineCommand100 } from "citty";
 registerSchema({
   command: "images.extract",
   description: "Extract images from a URL via Firecrawl (formats: images).",
@@ -13216,7 +13395,7 @@ registerSchema({
     }
   }
 });
-var extractCommand = defineCommand98({
+var extractCommand = defineCommand100({
   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"
@@ -13254,7 +13433,7 @@ var extractCommand = defineCommand98({
 });
 
 // src/commands/images/find.ts
-import { defineCommand as defineCommand99 } from "citty";
+import { defineCommand as defineCommand101 } from "citty";
 registerSchema({
   command: "images.find",
   description: "Fanout image search: library first, then opted-in external providers.",
@@ -13286,7 +13465,7 @@ registerSchema({
     }
   }
 });
-var findCommand = defineCommand99({
+var findCommand = defineCommand101({
   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"
@@ -13333,7 +13512,7 @@ var findCommand = defineCommand99({
 
 // src/commands/images/generate.ts
 import { readFile as readFile11 } from "fs/promises";
-import { defineCommand as defineCommand100 } from "citty";
+import { defineCommand as defineCommand102 } from "citty";
 import sharp2 from "sharp";
 var GENERATE_TIMEOUT_MS = 18e4;
 var REFERENCE_MAX_EDGE = 1536;
@@ -13429,7 +13608,7 @@ async function resolveReferences(spec) {
   }
   return out;
 }
-var generateCommand = defineCommand100({
+var generateCommand = defineCommand102({
   meta: {
     name: "generate",
     description: "Generate an image with AI and store it in the library (cost-tracked per request via OpenRouter usage). Models mirror the canvas: openai/gpt-5.4-image-2 (default \u2014 photoreal, cleanest text, best for ad/landing reproduction), google/gemini-3-pro-image-preview (Nano Banana Pro), google/gemini-3.5-flash & google/gemini-3.1-flash-image-preview (fast, extreme aspect ratios), recraft/recraft-v4.1-pro-vector (vector/SVG-style with palette control). The result is auto-ingested (describe + embed), so the next `baker images library` query finds it. Pass --reference with image URLs and/or local file paths (Pinterest, stock, brand assets, sandbox files) to ground generation in reality.\n\nExamples:\n  baker images generate 'a friendly golden retriever sitting in a bright modern living room' --aspect-ratio 16:9\n  baker images generate 'hero shot of a matte black water bottle on marble' --model google/gemini-3-pro-image-preview --image-size 2K\n  baker images generate 'lifestyle photo matching this mood' --reference 'https://\u2026/ref1.jpg,https://\u2026/ref2.jpg'\n  baker images generate 'put this product on a marble countertop, soft daylight' --reference './src/brand/logos/product.png,./refs/kitchen-mood.jpg'\n  baker images generate 'flat geometric mascot, brand palette' --model recraft/recraft-v4.1-pro-vector --rgb-colors '[[10,10,10],[255,80,0]]'"
@@ -13481,7 +13660,7 @@ var generateCommand = defineCommand100({
 });
 
 // src/commands/images/get.ts
-import { defineCommand as defineCommand101 } from "citty";
+import { defineCommand as defineCommand103 } from "citty";
 registerSchema({
   command: "images.get",
   description: "Get a single image by ID",
@@ -13489,7 +13668,7 @@ registerSchema({
     id: { type: "string", description: "Image ID", required: true }
   }
 });
-var getCommand2 = defineCommand101({
+var getCommand2 = defineCommand103({
   meta: { name: "get", description: "Get a single image by ID. Example: baker images get j571abc123" },
   args: {
     id: { type: "positional", description: "Image ID", required: false },
@@ -13525,7 +13704,7 @@ var getCommand2 = defineCommand101({
 });
 
 // src/commands/images/gif.ts
-import { defineCommand as defineCommand102 } from "citty";
+import { defineCommand as defineCommand104 } from "citty";
 registerSchema({
   command: "images.gif",
   description: "Search Giphy for GIFs / reaction memes (paid social creative).",
@@ -13557,7 +13736,7 @@ registerSchema({
     }
   }
 });
-var gifCommand = defineCommand102({
+var gifCommand = defineCommand104({
   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"
@@ -13604,7 +13783,7 @@ var gifCommand = defineCommand102({
 });
 
 // src/commands/images/google.ts
-import { defineCommand as defineCommand103 } from "citty";
+import { defineCommand as defineCommand105 } from "citty";
 registerSchema({
   command: "images.google",
   description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
@@ -13640,7 +13819,7 @@ registerSchema({
     }
   }
 });
-var googleCommand2 = defineCommand103({
+var googleCommand2 = defineCommand105({
   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"
@@ -13688,7 +13867,7 @@ var googleCommand2 = defineCommand103({
 });
 
 // src/commands/images/icon.ts
-import { defineCommand as defineCommand104 } from "citty";
+import { defineCommand as defineCommand106 } from "citty";
 registerSchema({
   command: "images.icon",
   description: "Icon lookup via Iconify (200+ icon sets, free CDN).",
@@ -13714,7 +13893,7 @@ registerSchema({
     }
   }
 });
-var iconCommand = defineCommand104({
+var iconCommand = defineCommand106({
   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'"
@@ -13754,7 +13933,7 @@ var iconCommand = defineCommand104({
 });
 
 // src/commands/images/ingest.ts
-import { defineCommand as defineCommand105 } from "citty";
+import { defineCommand as defineCommand107 } from "citty";
 registerSchema({
   command: "images.ingest",
   description: "Ingest a remote image URL into the library (full describe + embed).",
@@ -13766,7 +13945,7 @@ registerSchema({
     context: { type: "string", description: "Description context hint", required: false }
   }
 });
-var ingestCommand = defineCommand105({
+var ingestCommand = defineCommand107({
   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"
@@ -13808,7 +13987,7 @@ var ingestCommand = defineCommand105({
 });
 
 // src/commands/images/library.ts
-import { defineCommand as defineCommand106 } from "citty";
+import { defineCommand as defineCommand108 } from "citty";
 registerSchema({
   command: "images.library",
   description: "Search the company image library. Returns only ready images.",
@@ -13834,7 +14013,7 @@ registerSchema({
     }
   }
 });
-var libraryCommand = defineCommand106({
+var libraryCommand = defineCommand108({
   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"
@@ -13891,7 +14070,7 @@ var libraryCommand = defineCommand106({
 });
 
 // src/commands/images/logo.ts
-import { defineCommand as defineCommand107 } from "citty";
+import { defineCommand as defineCommand109 } from "citty";
 registerSchema({
   command: "images.logo",
   description: "Brand logo lookup via Brandfetch CDN (fallback/404). Auto-ingests by default.",
@@ -13916,7 +14095,7 @@ registerSchema({
     }
   }
 });
-var logoCommand = defineCommand107({
+var logoCommand = defineCommand109({
   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"
@@ -13954,7 +14133,7 @@ var logoCommand = defineCommand107({
 });
 
 // src/commands/images/normalize.ts
-import { defineCommand as defineCommand108 } from "citty";
+import { defineCommand as defineCommand110 } from "citty";
 
 // src/lib/image/color-changer.ts
 import quantize from "quantize";
@@ -14686,7 +14865,7 @@ function coerceRawArgs(args) {
     "dry-run": bool(args["dry-run"])
   };
 }
-var normalizeCommand = defineCommand108({
+var normalizeCommand = defineCommand110({
   meta: {
     name: "normalize",
     description: `Normalize logos / images: declarative recolor + bg removal + trim + resize. Operates on local files; writes in-place by default.
@@ -14741,7 +14920,7 @@ Examples:
 });
 
 // src/commands/images/pinterest.ts
-import { defineCommand as defineCommand109 } from "citty";
+import { defineCommand as defineCommand111 } 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.",
@@ -14761,7 +14940,7 @@ registerSchema({
     }
   }
 });
-var pinterestCommand = defineCommand109({
+var pinterestCommand = defineCommand111({
   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'"
@@ -14801,7 +14980,7 @@ var pinterestCommand = defineCommand109({
 });
 
 // src/commands/images/screenshot.ts
-import { defineCommand as defineCommand110 } from "citty";
+import { defineCommand as defineCommand112 } from "citty";
 registerSchema({
   command: "images.screenshot",
   description: "Capture a website screenshot via ScreenshotOne. Auto-ingests on success.",
@@ -14817,7 +14996,7 @@ registerSchema({
     }
   }
 });
-var screenshotCommand = defineCommand110({
+var screenshotCommand = defineCommand112({
   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"
@@ -14867,7 +15046,7 @@ var screenshotCommand = defineCommand110({
 });
 
 // src/commands/images/search.ts
-import { defineCommand as defineCommand111 } from "citty";
+import { defineCommand as defineCommand113 } from "citty";
 registerSchema({
   command: "images.search",
   description: "Search images by text query. Only returns ready images.",
@@ -14883,7 +15062,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand = defineCommand111({
+var searchCommand = defineCommand113({
   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"
@@ -14943,7 +15122,7 @@ var searchCommand = defineCommand111({
 });
 
 // src/commands/images/sticker.ts
-import { defineCommand as defineCommand112 } from "citty";
+import { defineCommand as defineCommand114 } from "citty";
 registerSchema({
   command: "images.sticker",
   description: "Search Giphy stickers \u2014 transparent-background overlays for ad creative.",
@@ -14975,7 +15154,7 @@ registerSchema({
     }
   }
 });
-var stickerCommand = defineCommand112({
+var stickerCommand = defineCommand114({
   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"
@@ -15022,7 +15201,7 @@ var stickerCommand = defineCommand112({
 });
 
 // src/commands/images/stock.ts
-import { defineCommand as defineCommand113 } from "citty";
+import { defineCommand as defineCommand115 } from "citty";
 registerSchema({
   command: "images.stock",
   description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
@@ -15080,7 +15259,7 @@ registerSchema({
     }
   }
 });
-var stockCommand = defineCommand113({
+var stockCommand = defineCommand115({
   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"
@@ -15136,7 +15315,7 @@ var stockCommand = defineCommand113({
 });
 
 // src/lib/tags-command.ts
-import { defineCommand as defineCommand114 } from "citty";
+import { defineCommand as defineCommand116 } from "citty";
 function makeTagsCommand(command, label, endpoint) {
   registerSchema({
     command: `${command}.tags`,
@@ -15145,7 +15324,7 @@ function makeTagsCommand(command, label, endpoint) {
       output: { type: "string", description: "Output format: md|json", required: false, default: "md" }
     }
   });
-  return defineCommand114({
+  return defineCommand116({
     meta: {
       name: "tags",
       description: `List the available ${label} tag names (defaults + company custom tags). Use before filtering with --tags. Example: baker ${command} tags`
@@ -15181,18 +15360,7 @@ function makeTagsCommand(command, label, endpoint) {
 var tagsCommand2 = makeTagsCommand("images", "image", "/api/images/tags");
 
 // src/commands/images/upload.ts
-import { readFile as readFile12 } from "fs/promises";
-import { extname as extname2 } from "path";
-import { defineCommand as defineCommand115 } from "citty";
-var MIME_MAP = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".webp": "image/webp",
-  ".svg": "image/svg+xml",
-  ".avif": "image/avif"
-};
+import { defineCommand as defineCommand117 } from "citty";
 registerSchema({
   command: "images.upload",
   description: "Upload an image to the library \u2014 local file path or remote http(s) URL.",
@@ -15230,15 +15398,7 @@ registerSchema({
 function isRemoteUrl2(value) {
   return /^https?:\/\//i.test(value);
 }
-function detectContentType(filePath) {
-  const ext = extname2(filePath).toLowerCase();
-  const mime = MIME_MAP[ext];
-  if (!mime) {
-    throw new ApiError("VALIDATION_ERROR", `Cannot detect content type for extension "${ext}". Use --content-type.`);
-  }
-  return mime;
-}
-var uploadCommand = defineCommand115({
+var uploadCommand = defineCommand117({
   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'"
@@ -15306,7 +15466,7 @@ async function uploadRemote(target, args) {
   writeJson({ ok: true, data });
 }
 async function uploadLocal(target, args) {
-  const contentType = args["content-type"] || detectContentType(target);
+  const contentType = args["content-type"] || detectImageContentType(target);
   if (args["dry-run"]) {
     writeJson({
       ok: true,
@@ -15321,17 +15481,17 @@ async function uploadLocal(target, args) {
     });
     return;
   }
-  const fileBuffer = await readFile12(target);
-  const base64 = fileBuffer.toString("base64");
-  const body = { base64, contentType };
-  if (args.source) body.source = args.source;
-  if (args.context) body.descriptionContext = args.context;
-  const data = await apiPost("/api/images/upload", body);
+  const data = await uploadLocalImage({
+    file: target,
+    contentType,
+    source: args.source,
+    descriptionContext: args.context
+  });
   writeJson({ ok: true, data });
 }
 
 // src/commands/images/upscale.ts
-import { defineCommand as defineCommand116 } from "citty";
+import { defineCommand as defineCommand118 } 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).",
@@ -15346,7 +15506,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS3 = 1500;
-var upscaleCommand = defineCommand116({
+var upscaleCommand = defineCommand118({
   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"
@@ -15401,7 +15561,7 @@ var upscaleCommand = defineCommand116({
 });
 
 // src/commands/images/use.ts
-import { defineCommand as defineCommand117 } from "citty";
+import { defineCommand as defineCommand119 } from "citty";
 registerSchema({
   command: "images.use",
   description: "Ingest a URL and wait for the library record to be ready.",
@@ -15417,7 +15577,7 @@ registerSchema({
   }
 });
 var POLL_INTERVAL_MS4 = 1500;
-var useCommand = defineCommand117({
+var useCommand = defineCommand119({
   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"
@@ -15463,7 +15623,7 @@ var useCommand = defineCommand117({
 });
 
 // src/commands/images/index.ts
-var imagesCommand = defineCommand118({
+var imagesCommand = defineCommand120({
   meta: {
     name: "images",
     description: `Find, source, and normalize images. Subcommands route by provider so cost + license are explicit.
@@ -15533,10 +15693,10 @@ Paid transforms (run on the Convex backend, cost-tracked):
 });
 
 // src/commands/research/index.ts
-import { defineCommand as defineCommand129 } from "citty";
+import { defineCommand as defineCommand131 } from "citty";
 
 // src/commands/research/advertisers.ts
-import { defineCommand as defineCommand119 } from "citty";
+import { defineCommand as defineCommand121 } 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.";
@@ -15649,7 +15809,7 @@ var FIELDS3 = {
   etv: "Estimated traffic value (USD)",
   visibility: "SERP visibility score (0-1)"
 };
-var advertisersCommand = defineCommand119({
+var advertisersCommand = defineCommand121({
   meta: {
     name: "advertisers",
     description: `Find domains competing for a keyword in Google SERPs.
@@ -15696,7 +15856,7 @@ Examples:
 });
 
 // src/commands/research/autocomplete.ts
-import { defineCommand as defineCommand120 } from "citty";
+import { defineCommand as defineCommand122 } 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).",
@@ -15719,7 +15879,7 @@ registerSchema({
 var FIELDS4 = {
   suggestion: "Autocomplete suggestion from Google"
 };
-var autocompleteCommand = defineCommand120({
+var autocompleteCommand = defineCommand122({
   meta: {
     name: "autocomplete",
     description: `Get Google Autocomplete suggestions for keyword expansion.
@@ -15765,7 +15925,7 @@ Examples:
 });
 
 // src/commands/research/countries.ts
-import { defineCommand as defineCommand121 } from "citty";
+import { defineCommand as defineCommand123 } from "citty";
 registerSchema({
   command: "research.countries",
   description: "List all supported country codes for --location flag in research commands.",
@@ -15822,7 +15982,7 @@ var FIELDS5 = {
   code: "Country code to pass as --location",
   name: "Country name"
 };
-var countriesCommand = defineCommand121({
+var countriesCommand = defineCommand123({
   meta: {
     name: "countries",
     description: "List all supported country codes for --location flag."
@@ -15833,7 +15993,7 @@ var countriesCommand = defineCommand121({
 });
 
 // src/commands/research/intent.ts
-import { defineCommand as defineCommand122 } from "citty";
+import { defineCommand as defineCommand124 } 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.",
@@ -15856,7 +16016,7 @@ var FIELDS6 = {
   intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
   probability: "Confidence score 0.0-1.0"
 };
-var intentCommand = defineCommand122({
+var intentCommand = defineCommand124({
   meta: {
     name: "intent",
     description: `Classify Google Search intent for keywords. Returns intent type and confidence.
@@ -15904,7 +16064,7 @@ Examples:
 });
 
 // src/commands/research/keyword-gap.ts
-import { defineCommand as defineCommand123 } from "citty";
+import { defineCommand as defineCommand125 } 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.",
@@ -15933,7 +16093,7 @@ var FIELDS7 = {
   cpc: "Cost per click USD",
   their_position: "Competitor's ranking position"
 };
-var keywordGapCommand = defineCommand123({
+var keywordGapCommand = defineCommand125({
   meta: {
     name: "keyword-gap",
     description: `Find keywords a competitor has that you don't. Supports pagination via --offset.
@@ -16007,7 +16167,7 @@ Examples:
 });
 
 // src/commands/research/keywords-for-site.ts
-import { defineCommand as defineCommand124 } from "citty";
+import { defineCommand as defineCommand126 } 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.",
@@ -16040,7 +16200,7 @@ var FIELDS8 = {
   competition: "LOW, MEDIUM, or HIGH",
   competition_index: "Competition score 0-100"
 };
-var keywordsForSiteCommand = defineCommand124({
+var keywordsForSiteCommand = defineCommand126({
   meta: {
     name: "keywords-for-site",
     description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
@@ -16093,7 +16253,7 @@ Examples:
 });
 
 // src/commands/research/languages.ts
-import { defineCommand as defineCommand125 } from "citty";
+import { defineCommand as defineCommand127 } from "citty";
 registerSchema({
   command: "research.languages",
   description: "List all supported language codes for --language flag in research commands.",
@@ -16123,7 +16283,7 @@ var FIELDS9 = {
   code: "Language code to pass as --language",
   name: "Language name (also accepted by --language)"
 };
-var languagesCommand2 = defineCommand125({
+var languagesCommand2 = defineCommand127({
   meta: {
     name: "languages",
     description: "List all supported language codes for --language flag."
@@ -16134,7 +16294,7 @@ var languagesCommand2 = defineCommand125({
 });
 
 // src/commands/research/lighthouse.ts
-import { defineCommand as defineCommand126 } from "citty";
+import { defineCommand as defineCommand128 } from "citty";
 registerSchema({
   command: "research.lighthouse",
   description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
@@ -16153,7 +16313,7 @@ var FIELDS10 = {
   speed_index_ms: "Speed Index in ms (good: < 3400)",
   interactive_ms: "Time to Interactive in ms (good: < 3800)"
 };
-var lighthouseCommand = defineCommand126({
+var lighthouseCommand = defineCommand128({
   meta: {
     name: "lighthouse",
     description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
@@ -16191,7 +16351,7 @@ Examples:
 });
 
 // src/commands/research/relevant-pages.ts
-import { defineCommand as defineCommand127 } from "citty";
+import { defineCommand as defineCommand129 } 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).",
@@ -16217,7 +16377,7 @@ var FIELDS11 = {
   keywords: "Total organic keywords the page ranks for",
   top_10: "Keywords in positions 1-10"
 };
-var relevantPagesCommand = defineCommand127({
+var relevantPagesCommand = defineCommand129({
   meta: {
     name: "relevant-pages",
     description: `Get the top pages of a competitor domain with traffic data.
@@ -16263,7 +16423,7 @@ Examples:
 });
 
 // src/commands/research/web.ts
-import { defineCommand as defineCommand128 } from "citty";
+import { defineCommand as defineCommand130 } 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).",
@@ -16314,7 +16474,7 @@ async function runDeepResearch(question) {
   }
   throw new Error("Deep research timed out");
 }
-var webCommand = defineCommand128({
+var webCommand = defineCommand130({
   meta: {
     name: "web",
     description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
@@ -16374,7 +16534,7 @@ Examples:
 });
 
 // src/commands/research/index.ts
-var researchCommand = defineCommand129({
+var researchCommand = defineCommand131({
   meta: {
     name: "research",
     description: `Competitive intelligence and AI-powered research commands.
@@ -16414,10 +16574,10 @@ Examples:
 });
 
 // src/commands/scheduled-actions/index.ts
-import { defineCommand as defineCommand136 } from "citty";
+import { defineCommand as defineCommand138 } from "citty";
 
 // src/commands/scheduled-actions/create.ts
-import { defineCommand as defineCommand130 } from "citty";
+import { defineCommand as defineCommand132 } from "citty";
 
 // src/commands/scheduled-actions/shared.ts
 var TEMP_SCHEDULED_ACTION_PREFIX = "temp_sched_";
@@ -16458,6 +16618,16 @@ function validateScheduledActionRef(ref) {
 function isNoSpawnAgentFlagSet(args) {
   return args["no-spawn-agent"] === true || args.noSpawnAgent === true || args.spawnAgent === false;
 }
+function isPromptWithoutAgent(args, agentDisabled) {
+  return agentDisabled && typeof args.prompt === "string";
+}
+function failIfPromptWithoutAgent(args, agentDisabled) {
+  if (isPromptWithoutAgent(args, agentDisabled)) {
+    failValidation2(
+      "--prompt only applies when an agent is spawned; it has no effect with --no-spawn-agent or --spawn-agent false."
+    );
+  }
+}
 function parseBooleanFlag(raw, flagName) {
   if (raw === void 0) {
     return void 0;
@@ -16522,7 +16692,7 @@ registerSchema({
     prompt: { type: "string", description: "Additional prompt instructions for the spawned agent", required: false }
   }
 });
-var createCommand2 = defineCommand130({
+var createCommand2 = defineCommand132({
   meta: {
     name: "create",
     description: 'Stage a scheduled action. Example: baker scheduled-actions create --name "Weekly report" --description "..." --cron "0 9 * * MON"'
@@ -16550,6 +16720,7 @@ var createCommand2 = defineCommand130({
       const schedule = buildScheduleBody(args, { required: true });
       const chatId = requireChatId();
       const noSpawnAgent = isNoSpawnAgentFlagSet(args);
+      failIfPromptWithoutAgent(args, noSpawnAgent);
       const body = {
         chatId,
         name,
@@ -16570,7 +16741,7 @@ var createCommand2 = defineCommand130({
 });
 
 // src/commands/scheduled-actions/delete.ts
-import { defineCommand as defineCommand131 } from "citty";
+import { defineCommand as defineCommand133 } from "citty";
 registerSchema({
   command: "scheduled-actions.delete",
   description: "Stage deletion of a published scheduled action or cancellation of a temp_sched_* draft creation.",
@@ -16578,7 +16749,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var deleteCommand2 = defineCommand131({
+var deleteCommand2 = defineCommand133({
   meta: {
     name: "delete",
     description: "Stage scheduled action deletion. Example: baker scheduled-actions delete <id-or-temp_sched_id>"
@@ -16607,7 +16778,7 @@ var deleteCommand2 = defineCommand131({
 });
 
 // src/commands/scheduled-actions/get.ts
-import { defineCommand as defineCommand132 } from "citty";
+import { defineCommand as defineCommand134 } from "citty";
 registerSchema({
   command: "scheduled-actions.get",
   description: "Get a published scheduled action or a temp_sched_* draft-created scheduled action.",
@@ -16615,7 +16786,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID or temp_sched_* draft ID", required: true }
   }
 });
-var getCommand3 = defineCommand132({
+var getCommand3 = defineCommand134({
   meta: {
     name: "get",
     description: "Get a scheduled action. Example: baker scheduled-actions get <id-or-temp_sched_id>"
@@ -16652,13 +16823,13 @@ var getCommand3 = defineCommand132({
 });
 
 // src/commands/scheduled-actions/list.ts
-import { defineCommand as defineCommand133 } from "citty";
+import { defineCommand as defineCommand135 } from "citty";
 registerSchema({
   command: "scheduled-actions.list",
   description: "List published scheduled actions. Includes draft state when BAKER_CHAT_ID is set.",
   args: {}
 });
-var listCommand3 = defineCommand133({
+var listCommand3 = defineCommand135({
   meta: {
     name: "list",
     description: "List scheduled actions. Includes staged draft ops when BAKER_CHAT_ID is set."
@@ -16679,7 +16850,7 @@ var listCommand3 = defineCommand133({
 });
 
 // src/commands/scheduled-actions/trigger.ts
-import { defineCommand as defineCommand134 } from "citty";
+import { defineCommand as defineCommand136 } 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.",
@@ -16687,7 +16858,7 @@ registerSchema({
     id: { type: "string", description: "Published scheduled action ID", required: true }
   }
 });
-var triggerCommand = defineCommand134({
+var triggerCommand = defineCommand136({
   meta: {
     name: "trigger",
     description: "Immediately trigger a published scheduled action. Example: baker scheduled-actions trigger <id>"
@@ -16724,7 +16895,7 @@ var triggerCommand = defineCommand134({
 });
 
 // src/commands/scheduled-actions/update.ts
-import { defineCommand as defineCommand135 } from "citty";
+import { defineCommand as defineCommand137 } from "citty";
 registerSchema({
   command: "scheduled-actions.update",
   description: "Stage an update to a published scheduled action or temp_sched_* draft-created scheduled action.",
@@ -16749,7 +16920,7 @@ registerSchema({
     prompt: { type: "string", description: "Replacement additional spawned-agent instructions", required: false }
   }
 });
-var updateCommand2 = defineCommand135({
+var updateCommand2 = defineCommand137({
   meta: {
     name: "update",
     description: "Stage a scheduled action update. Example: baker scheduled-actions update <id> --enabled false"
@@ -16800,6 +16971,7 @@ var updateCommand2 = defineCommand135({
         body.spawnAgent = spawnAgent;
         hasPatch = true;
       }
+      failIfPromptWithoutAgent(args, spawnAgent === false);
       if (typeof args.prompt === "string") {
         body.agentPrompt = args.prompt;
         hasPatch = true;
@@ -16819,7 +16991,7 @@ var updateCommand2 = defineCommand135({
 });
 
 // src/commands/scheduled-actions/index.ts
-var scheduledActionsCommand = defineCommand136({
+var scheduledActionsCommand = defineCommand138({
   meta: {
     name: "scheduled-actions",
     description: `Manage Scheduled Actions. Subcommands: list, get, create, update, delete, trigger.
@@ -16845,8 +17017,8 @@ Examples:
 });
 
 // src/commands/schema.ts
-import { defineCommand as defineCommand137 } from "citty";
-var schemaCommand = defineCommand137({
+import { defineCommand as defineCommand139 } from "citty";
+var schemaCommand = defineCommand139({
   meta: {
     name: "schema",
     description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
@@ -16882,10 +17054,10 @@ var schemaCommand = defineCommand137({
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand141 } from "citty";
+import { defineCommand as defineCommand143 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand138 } from "citty";
+import { defineCommand as defineCommand140 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -16893,7 +17065,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand4 = defineCommand138({
+var getCommand4 = defineCommand140({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -16930,7 +17102,7 @@ var getCommand4 = defineCommand138({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand139 } from "citty";
+import { defineCommand as defineCommand141 } from "citty";
 registerSchema({
   command: "testimonials.list",
   description: "List testimonials with optional filters.",
@@ -16960,7 +17132,7 @@ registerSchema({
     limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
   }
 });
-var listCommand4 = defineCommand139({
+var listCommand4 = defineCommand141({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -17009,7 +17181,7 @@ var listCommand4 = defineCommand139({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand140 } from "citty";
+import { defineCommand as defineCommand142 } from "citty";
 registerSchema({
   command: "testimonials.search",
   description: "Search testimonials by text query. Uses hybrid BM25 + vector + reranking.",
@@ -17040,7 +17212,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand2 = defineCommand140({
+var searchCommand2 = defineCommand142({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -17114,7 +17286,7 @@ var searchCommand2 = defineCommand140({
 var tagsCommand3 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand141({
+var testimonialsCommand = defineCommand143({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -17135,10 +17307,10 @@ Examples:
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand146 } from "citty";
+import { defineCommand as defineCommand148 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand142 } from "citty";
+import { defineCommand as defineCommand144 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -17152,7 +17324,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand3 = defineCommand142({
+var deleteCommand3 = defineCommand144({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -17193,7 +17365,7 @@ var deleteCommand3 = defineCommand142({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand143 } from "citty";
+import { defineCommand as defineCommand145 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -17201,7 +17373,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand5 = defineCommand143({
+var getCommand5 = defineCommand145({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -17238,7 +17410,7 @@ var getCommand5 = defineCommand143({
 });
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand144 } from "citty";
+import { defineCommand as defineCommand146 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -17248,7 +17420,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand3 = defineCommand144({
+var searchCommand3 = defineCommand146({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -17298,10 +17470,10 @@ var searchCommand3 = defineCommand144({
 var tagsCommand4 = makeTagsCommand("videos", "video", "/api/videos/tags");
 
 // src/commands/videos/upload.ts
-import { readFile as readFile13, stat as stat3 } from "fs/promises";
-import { extname as extname3 } from "path";
-import { defineCommand as defineCommand145 } from "citty";
-var MIME_MAP2 = {
+import { readFile as readFile12, stat as stat3 } from "fs/promises";
+import { extname as extname4 } from "path";
+import { defineCommand as defineCommand147 } from "citty";
+var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
   ".webm": "video/webm",
@@ -17326,15 +17498,15 @@ registerSchema({
     }
   }
 });
-function detectContentType2(filePath) {
-  const ext = extname3(filePath).toLowerCase();
-  const mime = MIME_MAP2[ext];
+function detectContentType(filePath) {
+  const ext = extname4(filePath).toLowerCase();
+  const mime = MIME_MAP[ext];
   if (!mime) {
     throw new ApiError("VALIDATION_ERROR", `Cannot detect content type for extension "${ext}". Use --content-type.`);
   }
   return mime;
 }
-var uploadCommand2 = defineCommand145({
+var uploadCommand2 = defineCommand147({
   meta: {
     name: "upload",
     description: "Upload a video file to Baker via Mux direct upload. Auto-detects content type. Example: baker videos upload ./demo.mp4"
@@ -17351,7 +17523,7 @@ var uploadCommand2 = defineCommand145({
         writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "File path is required" } });
         process.exit(1);
       }
-      const contentType = args["content-type"] || detectContentType2(filePath);
+      const contentType = args["content-type"] || detectContentType(filePath);
       if (args["dry-run"]) {
         const fileStats = await stat3(filePath);
         writeJson({
@@ -17363,7 +17535,7 @@ var uploadCommand2 = defineCommand145({
         return;
       }
       const { uploadUrl, videoId } = await apiPost("/api/videos/upload", {});
-      const fileBuffer = await readFile13(filePath);
+      const fileBuffer = await readFile12(filePath);
       const uploadResponse = await fetch(uploadUrl, {
         method: "PUT",
         headers: { "Content-Type": contentType },
@@ -17388,7 +17560,7 @@ var uploadCommand2 = defineCommand145({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand146({
+var videosCommand = defineCommand148({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete, tags.
@@ -17411,10 +17583,10 @@ Examples:
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand149 } from "citty";
+import { defineCommand as defineCommand151 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand147 } from "citty";
+import { defineCommand as defineCommand149 } from "citty";
 registerSchema({
   command: "winning-ads.advertisers",
   description: "Resolve a brand name to advertiser_id(s) in the ad-dna corpus \u2014 to find your OWN advertiser (to --exclude-advertiser) or a competitor (to --advertiser-id).",
@@ -17427,7 +17599,7 @@ registerSchema({
 function identity(record) {
   return record;
 }
-var advertisersCommand2 = defineCommand147({
+var advertisersCommand2 = defineCommand149({
   meta: {
     name: "advertisers",
     description: 'Resolve a brand name to advertiser_id(s). Use it to find your own advertiser for --exclude-advertiser, or a competitor for --advertiser-id. Example: baker winning-ads advertisers "Deel" --output md'
@@ -17478,7 +17650,8 @@ var advertisersCommand2 = defineCommand147({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand148 } from "citty";
+import { defineCommand as defineCommand150 } from "citty";
+import { z as z4 } from "zod";
 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.",
@@ -17586,7 +17759,39 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand148({
+function toOutputRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return Object.fromEntries(Object.entries(value));
+}
+var winningAdsSearchResponseSchema = z4.object({
+  results: z4.array(z4.unknown()).optional(),
+  pool_size: z4.number().nullable().optional(),
+  match_confidence: z4.string().nullable().optional(),
+  ownAdvertiserExclusion: z4.object({
+    status: z4.enum(["applied", "unresolved", "skipped"]),
+    excludedIds: z4.array(z4.string())
+  }).nullable().optional()
+});
+function parseWinningAdsSearchResponse(data) {
+  const parsed = winningAdsSearchResponseSchema.safeParse(data);
+  if (!parsed.success) {
+    throw new ApiError("INTERNAL_ERROR", "Invalid winning ads search response");
+  }
+  return parsed.data;
+}
+function buildSearchOutputData(data, options) {
+  const rawResults = Array.isArray(data?.results) ? data.results : [];
+  const results = rawResults.map((r) => winningAdNormalizer(toOutputRecord(r), options.full));
+  return {
+    results,
+    pool_size: data?.pool_size ?? null,
+    match_confidence: data?.match_confidence ?? null,
+    ownAdvertiserExclusion: data?.ownAdvertiserExclusion ?? null
+  };
+}
+var searchCommand4 = defineCommand150({
   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"
@@ -17664,19 +17869,12 @@ var searchCommand4 = defineCommand148({
         });
         process.exit(1);
       }
-      const data = await apiPost(
-        "/api/winning-ads/search",
-        body
-      );
+      const data = parseWinningAdsSearchResponse(await apiPost("/api/winning-ads/search", body));
       const output = args.output || "json";
       const full = args.full;
       const rawResults = Array.isArray(data?.results) ? data.results : [];
       if (output === "json") {
-        const results = rawResults.map((r) => winningAdNormalizer(r, full));
-        writeJson({
-          ok: true,
-          data: { results, pool_size: data?.pool_size ?? null, match_confidence: data?.match_confidence ?? null }
-        });
+        writeJson({ ok: true, data: buildSearchOutputData(data, { full }) });
         return;
       }
       writeOutput(
@@ -17698,7 +17896,7 @@ var searchCommand4 = defineCommand148({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand149({
+var winningAdsCommand = defineCommand151({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -17738,7 +17936,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand150({
+var main = defineCommand152({
   meta: {
     name: "baker",
     version: getCliVersion(),
@@ -17757,6 +17955,7 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
     ga4: ga4Command,
     gsc: gscCommand,
     research: researchCommand,
+    creatives: creativesCommand3,
     images: imagesCommand,
     videos: videosCommand,
     testimonials: testimonialsCommand,