@koda-sl/baker-cli 0.148.0 → 0.149.0-dev.183ac88ea

package/dist/cli.js

@@ -24,6 +24,7 @@ import {
   imageProfileFor,
   isPersistedAssetRef,
   looksLikeHttpUrl,
+  nearestSupportedAspectRatio,
   parseRefExpr,
   platformFormats,
   requireCredentialsFromEnv,
@@ -31,10 +32,11 @@ import {
   sha256Hex,
   spineInputFlags,
   spineInputOps,
+  supportsParam,
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-2F5SCTNS.js";
+} from "./chunk-JBDSJZBZ.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -73,7 +75,7 @@ import {
 } from "./chunk-RK67WL4O.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand178, runMain } from "citty";
+import { defineCommand as defineCommand182, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand18 } from "citty";
@@ -2131,6 +2133,7 @@ var chatChangeTypeSchema = z5.enum([
   "linkedin-ads",
   "google-ads",
   "meta-ads",
+  "tag-manager",
   // Immediate (already-applied) library effects — see lib/chatChanges.ts.
   "image",
   "video",
@@ -2707,8 +2710,9 @@ var rgbTriple = z8.tuple([
   z8.number().int().min(0).max(255)
 ]);
 var imageGenerateModelSchema = z8.enum([
+  "openai/gpt-image-2",
+  // Legacy — see the registry entry; kept so pre-switch canvases still run.
   "openai/gpt-5.4-image-2",
-  "google/gemini-3.5-flash",
   "google/gemini-3.1-flash-image-preview",
   "google/gemini-3-pro-image-preview",
   "recraft/recraft-v4.1-pro-vector"
@@ -16653,7 +16657,9 @@ function buildFrameRef(edge, url, framePrompt, present2, ctx, nodes) {
   const imageProfile = imageProfileFor(ctx.imageModel);
   const genParams = {
     model: ctx.imageModel,
-    image_size: "2K",
+    // gpt-image-2 derives pixel dimensions from the ratio and has no size knob,
+    // so asking for 2K there is an `unknown_param` at validate.
+    ...supportsParam("image_generate", ctx.imageModel, "image_size") ? { image_size: "2K" } : {},
     // Per-model image defaults (gpt-image: quality=high — OpenRouter forwards it; we do
     // NOT send input_fidelity, which gpt-image-2 forces high automatically).
     ...imageProfile?.paramDefaults ?? {},
@@ -16668,7 +16674,7 @@ function buildFrameRef(edge, url, framePrompt, present2, ctx, nodes) {
       ctx.imageModel
     )
   };
-  if (ctx.genAr) genParams.aspect_ratio = ctx.genAr;
+  if (ctx.genAr) genParams.aspect_ratio = nearestSupportedAspectRatio("image_generate", ctx.imageModel, ctx.genAr);
   const genId = `s${ctx.sceneIndex}${tag}_${edge}`;
   nodes.push({
     id: genId,
@@ -20395,8 +20401,13 @@ function scaffoldStaticAd(input, elementsInput, opts) {
     inputs: { reference, target_blueprint: "$ref:prompt.asset" },
     params: {
       model: opts.genModel,
-      aspect_ratio: baseAspectRatio(blueprint, opts),
-      image_size: "2K",
+      // The hero renders at the closest ratio its model actually accepts; the
+      // placement fan-out below adapts it to the exact platform formats, which
+      // is also how a 4:5 Meta feed ad gets made on a model that has no 4:5.
+      aspect_ratio: nearestSupportedAspectRatio("image_generate", opts.genModel, baseAspectRatio(blueprint, opts)),
+      ...supportsParam("image_generate", opts.genModel, "image_size") ? { image_size: "2K" } : {},
+      // Per-model image defaults (gpt-image: quality=high).
+      ...imageProfileFor(opts.genModel)?.paramDefaults ?? {},
       prompt
     }
   });
@@ -20763,7 +20774,7 @@ function resolveModels(args) {
     describeModel: pick("describe-model", "image_describe", "~google/gemini-pro-latest"),
     selectModel: pick("select-model", "text_generate", "~google/gemini-flash-latest"),
     layoutModel: pick("layout-model", "text_generate", "~google/gemini-flash-latest"),
-    genModel: pick("gen-model", "image_generate", "openai/gpt-5.4-image-2")
+    genModel: pick("gen-model", "image_generate", "openai/gpt-image-2")
   };
 }
 var PLATFORM_PLACEMENTS = {
@@ -21405,7 +21416,7 @@ function resolveModels2(args) {
     // Default to the strongest image model (matches the static-ad scaffold); the
     // frame generators need the most faithful text/identity reproduction. Override
     // with --image-model for a cheaper/faster pass.
-    imageModel: pick("image-model", "image_generate", "openai/gpt-5.4-image-2")
+    imageModel: pick("image-model", "image_generate", "openai/gpt-image-2")
   };
 }
 function hasPhotorealCast(elements) {
@@ -24115,7 +24126,7 @@ async function resolveReferences(spec) {
 var generateCommand = defineCommand114({
   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: google/gemini-3.1-flash-image-preview (Nano Banana flash \u2014 default, fast, extreme aspect ratios) & google/gemini-3.5-flash (fast), google/gemini-3-pro-image-preview (Nano Banana Pro \u2014 highest fidelity), openai/gpt-5.4-image-2 (photoreal, cleanest in-image text, best for ad/landing reproduction), 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 openai/gpt-5.4-image-2 --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]]'"
+    description: "Generate an image with AI and store it in the library (cost-tracked per request via OpenRouter usage). Models mirror the canvas: google/gemini-3.1-flash-image-preview (Nano Banana flash \u2014 default, fast, extreme aspect ratios), google/gemini-3-pro-image-preview (Nano Banana Pro \u2014 highest fidelity), openai/gpt-image-2 (photoreal, cleanest in-image text, best for ad/landing reproduction \u2014 no --image-size, and no 4:5 / 5:4), 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 openai/gpt-image-2 --aspect-ratio 3:2\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]]'"
   },
   args: {
     prompt: { type: "positional", description: "What to generate", required: false },
@@ -24288,6 +24299,34 @@ var gifCommand = defineCommand116({
 
 // src/commands/images/google.ts
 import { defineCommand as defineCommand117 } from "citty";
+
+// src/commands/images/searchHints.ts
+var FALLBACK = {
+  stock: "Still empty \u2192 `baker images find <query> --sources library,pinterest,google` (one call across the providers stock does not cover \u2014 `--sources` is required, `find` alone searches the library only) or `baker images generate` to make the asset. Do not re-run this search with reshuffled flags.",
+  google: "Still empty \u2192 `baker images generate` to make the asset. Google is the last-resort provider; there is nothing below it to retry."
+};
+function emptyResultHints({ provider, hitCount, activeFilters }) {
+  if (hitCount > 0) {
+    return [];
+  }
+  const hints = [];
+  if (activeFilters.length > 0) {
+    hints.push(
+      `No hits. Drop the filters before touching the query \u2014 ${activeFilters.join(", ")} narrowed this search and filter combinations are the usual cause of an empty result.`
+    );
+  }
+  hints.push(FALLBACK[provider]);
+  return hints;
+}
+function activeFilterFlags(args, candidates) {
+  return candidates.filter((flag) => args[flag] !== void 0 && args[flag] !== "").map((flag) => `--${flag}`);
+}
+
+// src/commands/images/google.ts
+var GOOGLE_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Generate the asset instead of retrying Google. Google is the last-resort image provider. Run `baker images generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
 registerSchema({
   command: "images.google",
   description: "Google Images search via the official Custom Search JSON API. Unverified source \u2014 inspect before placing.",
@@ -24358,10 +24397,18 @@ var googleCommand2 = defineCommand117({
       if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
       if (args.context) body.descriptionContext = args.context;
       const data = await apiPost("/api/images/google", body);
-      writeJson({ ok: true, data });
+      const hints = emptyResultHints({
+        provider: "google",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "size", "color", "safe"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
     } catch (err) {
       if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        writeJson({
+          ok: false,
+          error: { code: err.code, message: err.message, fix: GOOGLE_ERROR_FIX }
+        });
         process.exit(1);
       }
       writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
@@ -25719,6 +25766,10 @@ var stickerCommand = defineCommand126({
 
 // src/commands/images/stock.ts
 import { defineCommand as defineCommand127 } from "citty";
+var STOCK_ERROR_FIX = {
+  action: "use_different_resource",
+  explanation: "Switch provider instead of retrying stock search. Stock search is one of several image sources. Run `baker images find <query> --sources library,pinterest,google` (`--sources` is required \u2014 `find` alone searches the library only) or `baker images generate` to make the asset. Never sleep-and-retry this command \u2014 the CLI already backs off on rate limits. If no image can be sourced, continue the rest of the task with a placeholder rather than aborting it."
+};
 registerSchema({
   command: "images.stock",
   description: "Stock photo, vector illustration, icon-set, and PSD search via Magnific (Freepik's developer API).",
@@ -25776,6 +25827,21 @@ registerSchema({
     }
   }
 });
+function buildStockRequest(query, args) {
+  const body = { query };
+  if (args.type) body.contentType = args.type;
+  if (args.orientation) body.orientation = args.orientation;
+  if (args.license) body.license = args.license;
+  if (args.color) body.color = args.color;
+  if (args.ai) body.aiGenerated = args.ai;
+  if (args.people) body.people = args.people;
+  if (args.order) body.order = args.order;
+  if (args.limit) body.limit = Number(args.limit);
+  if (args.page) body.page = Number(args.page);
+  if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
+  if (args.context) body.descriptionContext = args.context;
+  return body;
+}
 var stockCommand = defineCommand127({
   meta: {
     name: "stock",
@@ -25806,23 +25872,23 @@ var stockCommand = defineCommand127({
         writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Query is required" } });
         process.exit(1);
       }
-      const body = { query };
-      if (args.type) body.contentType = args.type;
-      if (args.orientation) body.orientation = args.orientation;
-      if (args.license) body.license = args.license;
-      if (args.color) body.color = args.color;
-      if (args.ai) body.aiGenerated = args.ai;
-      if (args.people) body.people = args.people;
-      if (args.order) body.order = args.order;
-      if (args.limit) body.limit = Number(args.limit);
-      if (args.page) body.page = Number(args.page);
-      if (args["auto-ingest"]) body.autoIngest = Number(args["auto-ingest"]);
-      if (args.context) body.descriptionContext = args.context;
-      const data = await apiPost("/api/images/stock", body);
-      writeJson({ ok: true, data });
+      const data = await apiPost("/api/images/stock", buildStockRequest(query, args));
+      const hints = emptyResultHints({
+        provider: "stock",
+        hitCount: data.hits.length,
+        activeFilters: activeFilterFlags(args, ["type", "orientation", "license", "color", "ai", "people"])
+      });
+      writeJson({ ok: true, data, ...hints.length ? { hints } : {} });
     } catch (err) {
       if (err instanceof ApiError) {
-        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            fix: STOCK_ERROR_FIX
+          }
+        });
         process.exit(1);
       }
       writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
@@ -28953,9 +29019,514 @@ var schemaCommand = defineCommand154({
   }
 });
 
-// src/commands/tags/index.ts
+// src/commands/tag-manager/index.ts
+import { defineCommand as defineCommand158 } from "citty";
+
+// src/commands/tag-manager/draft.ts
 import { defineCommand as defineCommand155 } from "citty";
 
+// src/commands/tag-manager/shared.ts
+import { readFileSync as readFileSync12 } from "fs";
+function failValidation3(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function requireTarget4(args, entity) {
+  const positional = Array.isArray(args._) ? args._[0] : void 0;
+  const target = args.id ?? args.target ?? positional;
+  if (typeof target !== "string" || target.length === 0) {
+    failValidation3(`pass the ${entity} id or path as the positional argument`);
+  }
+  return target;
+}
+function loadJsonArg(args, flag = "json") {
+  const inline = args[flag];
+  const file = args.file;
+  const raw = typeof file === "string" && file.length > 0 ? readFileSync12(file, "utf8") : typeof inline === "string" && inline.length > 0 ? inline : void 0;
+  if (raw === void 0) {
+    failValidation3(`pass --${flag} with inline JSON or --file with a path to a JSON file`);
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failValidation3(`--${flag} must be a JSON object`);
+    }
+    return parsed;
+  } catch {
+    return failValidation3(`--${flag} is not valid JSON`);
+  }
+}
+function handleError3(err) {
+  if (err instanceof ApiError) {
+    const notConnected = err.code === "NOT_FOUND" || err.code === "UNAUTHORIZED";
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        ...notConnected ? {
+          fix: {
+            action: "ask_user",
+            explanation: "Tag Manager is not connected for this company yet. Ask the user to connect Tag Manager in Settings \u2192 Connections and pick the container to manage, then retry. Continue with the rest of the task in the meantime."
+          }
+        } : {},
+        retryable: false
+      }
+    });
+    process.exit(1);
+  }
+  writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function stageHints(response) {
+  const hints = [];
+  if (response.mode === "simulated") {
+    hints.push(
+      "Tag Manager writes are SIMULATED for this company \u2014 this change will not reach the real container on publish."
+    );
+  }
+  hints.push(
+    "Staged only. On publish these changes land in a new Tag Manager version that is NOT published \u2014 tell the user to publish that version in Tag Manager to make it live."
+  );
+  return hints;
+}
+async function stageOp3(op) {
+  const chatId = requireChatId();
+  try {
+    const data = await apiPost("/api/tag-manager/draft/stage", { chatId, op });
+    writeJsonEnvelope({ ok: true, data, hints: stageHints(data) });
+  } catch (err) {
+    handleError3(err);
+  }
+}
+async function draftAction2(path27, body) {
+  const chatId = requireChatId();
+  try {
+    const data = await apiPost(path27, { chatId, ...body });
+    writeJsonEnvelope({ ok: true, data });
+    return data;
+  } catch (err) {
+    handleError3(err);
+  }
+}
+function renderDraft(response) {
+  if (response.count === 0) {
+    return "No Tag Manager changes staged on this chat.";
+  }
+  const lines = [
+    `${response.count} staged Tag Manager change(s) \u2014 mode: ${response.mode}`,
+    ...response.ops.map((op) => {
+      const status = op.result ? ` [${op.result.status}]` : "";
+      return `  ${op.ref}  ${op.summary}${status}`;
+    })
+  ];
+  if (response.versionId) {
+    lines.push(
+      "",
+      `Applied into Tag Manager version ${response.versionId}. It is NOT published \u2014 publish it in Tag Manager to go live.`
+    );
+  }
+  if (response.compilerError) {
+    lines.push("", `Tag Manager reported a problem building the version: ${response.compilerError}`);
+  }
+  return lines.join("\n");
+}
+async function draftList(json) {
+  const chatId = requireChatId();
+  try {
+    const data = await apiPost("/api/tag-manager/draft", { chatId });
+    if (json) {
+      writeJsonEnvelope({ ok: true, data });
+      return;
+    }
+    process.stdout.write(`${renderDraft(data)}
+`);
+  } catch (err) {
+    handleError3(err);
+  }
+}
+
+// src/commands/tag-manager/draft.ts
+registerSchema({
+  command: "tagManager.draft",
+  description: "Review and undo the Tag Manager changes staged on this chat. Use `list` to see everything staged, `show` to inspect one change in full before publish, `amend` to correct one in place, and `remove`/`clear` to drop them.",
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list", required: false }
+  }
+});
+var draftCommand3 = defineCommand155({
+  meta: {
+    name: "draft",
+    description: "List, show, amend, remove, or clear staged Tag Manager changes for this chat"
+  },
+  subCommands: {
+    list: defineCommand155({
+      meta: {
+        name: "list",
+        description: "Review everything staged on this chat (--json for the raw envelope)"
+      },
+      args: { json: { type: "boolean", description: "Print the raw JSON envelope", required: false } },
+      run: async ({ args }) => {
+        await draftList(args.json === true);
+      }
+    }),
+    show: defineCommand155({
+      meta: {
+        name: "show",
+        description: "Print the full staged payload for one change \u2014 the receipt to verify it looks right before publish (never truncated)."
+      },
+      args: { ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false } },
+      run: async ({ args }) => {
+        await draftAction2("/api/tag-manager/draft/show", {
+          ref: requireTarget4(args, "change")
+        });
+      }
+    }),
+    amend: defineCommand155({
+      meta: {
+        name: "amend",
+        description: "Update a staged change in place \u2014 merges a JSON patch into its payload (objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create."
+      },
+      args: {
+        ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false },
+        patch: { type: "string", description: "Inline JSON patch object", required: false },
+        file: { type: "string", description: "JSON file with the patch object", required: false }
+      },
+      run: async ({ args }) => {
+        await draftAction2("/api/tag-manager/draft/amend", {
+          ref: requireTarget4(args, "change"),
+          patch: loadJsonArg(args, "patch")
+        });
+      }
+    }),
+    remove: defineCommand155({
+      meta: { name: "remove", description: "Remove one staged change (cascades to anything depending on it)" },
+      args: { ref: { type: "positional", description: "Staged ref (gtm_temp_*) or target", required: false } },
+      run: async ({ args }) => {
+        await draftAction2("/api/tag-manager/draft/remove", {
+          ref: requireTarget4(args, "change")
+        });
+      }
+    }),
+    clear: defineCommand155({
+      meta: { name: "clear", description: "Discard all Tag Manager changes staged on this chat" },
+      run: async () => {
+        await draftAction2("/api/tag-manager/draft/clear", {});
+      }
+    })
+  }
+});
+
+// src/commands/tag-manager/read.ts
+import { defineCommand as defineCommand156 } from "citty";
+registerSchema({
+  command: "tagManager.containers",
+  description: "List the Google Tag Manager containers this company's connection can reach. The connected container is flagged. Start here to confirm which container you are managing.",
+  args: {}
+});
+registerSchema({
+  command: "tagManager.read",
+  description: "Read what is currently inside a Tag Manager container: tags, triggers, variables, folders and enabled built-in variables. Start here before proposing any change, so you edit what exists instead of duplicating it. Compact by default; pass --full for raw Tag Manager objects.",
+  args: {
+    container: { type: "string", description: "Numeric container id (defaults to the connected one)", required: false },
+    workspace: { type: "string", description: "Workspace id (defaults to the default workspace)", required: false },
+    entities: {
+      type: "string",
+      description: "Comma-separated subset: tag,trigger,variable,folder,builtInVariable",
+      required: false
+    },
+    full: { type: "boolean", description: "Include the raw Tag Manager object for each entity", required: false }
+  }
+});
+function fail6(err) {
+  if (err instanceof ApiError) {
+    const notConnected = err.code === "NOT_FOUND" || err.code === "UNAUTHORIZED";
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        ...notConnected ? {
+          fix: {
+            action: "ask_user",
+            explanation: "Tag Manager is not connected for this company yet. Ask the user to connect Tag Manager in Settings \u2192 Connections and choose the container to manage, then retry. Continue with the rest of the task in the meantime."
+          }
+        } : {},
+        retryable: false
+      }
+    });
+    process.exit(1);
+  }
+  writeJsonEnvelope({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var containersCommand = defineCommand156({
+  meta: {
+    name: "containers",
+    description: `List Tag Manager containers reachable by this company's connection.
+
+Start here:
+  baker tag-manager containers`
+  },
+  run: async () => {
+    try {
+      const data = await apiGet("/api/tag-manager/containers");
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      fail6(err);
+    }
+  }
+});
+var readCommand = defineCommand156({
+  meta: {
+    name: "read",
+    description: `Read the current contents of the Tag Manager container \u2014 always do this before staging changes.
+
+Examples:
+  baker tag-manager read
+  baker tag-manager read --entities tag,trigger
+  baker tag-manager read --full`
+  },
+  args: {
+    container: { type: "string", description: "Numeric container id", required: false },
+    workspace: { type: "string", description: "Workspace id", required: false },
+    entities: { type: "string", description: "Comma-separated entity subset", required: false },
+    full: { type: "boolean", description: "Include raw Tag Manager objects", required: false }
+  },
+  run: async ({ args }) => {
+    const entities = typeof args.entities === "string" && args.entities.length > 0 ? args.entities.split(",").map((entry) => entry.trim()) : void 0;
+    try {
+      const data = await apiPost("/api/tag-manager/read", {
+        containerId: args.container,
+        workspaceId: args.workspace,
+        entities,
+        full: args.full === true
+      });
+      const hints = [];
+      if (data.installedContainerMismatch) {
+        hints.push(data.installedContainerMismatch);
+      }
+      hints.push(
+        "Reference an existing trigger or variable by its numeric id or {{Name}}. To reference something you are staging in this same chat, use its gtm_temp_* ref and the executor resolves it at publish."
+      );
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      fail6(err);
+    }
+  }
+});
+
+// src/commands/tag-manager/write-commands.ts
+import { defineCommand as defineCommand157 } from "citty";
+var ENTITIES = [
+  {
+    entity: "tag",
+    noun: "tag",
+    createHint: 'Payload needs name + type (e.g. "gaawe" for a GA4 event) and usually parameter[] and firingTriggerId[]. Reference a trigger by its numeric id, or by a gtm_temp_* ref if you are staging it in this same chat.'
+  },
+  {
+    entity: "trigger",
+    noun: "trigger",
+    createHint: 'Payload needs name + type (e.g. "pageview", "click", "customEvent"). Stage the trigger BEFORE the tag that fires on it, then reference it by its gtm_temp_* ref.'
+  },
+  {
+    entity: "variable",
+    noun: "variable",
+    createHint: 'Payload needs name + type (e.g. "v" for a data layer variable, "c" for a constant). Other entities reference a variable by NAME as {{Variable Name}}.'
+  },
+  {
+    entity: "folder",
+    noun: "folder",
+    createHint: "Payload needs name. Use folders to keep a large container legible."
+  }
+];
+for (const { entity, noun, createHint } of ENTITIES) {
+  registerSchema({
+    command: `tagManager.${entity}.create`,
+    description: `Stage the creation of a Tag Manager ${noun}. ${createHint} Staged only \u2014 applies on publish into an unpublished container version.`,
+    args: {
+      json: { type: "string", description: `Inline JSON ${noun} definition`, required: false },
+      file: { type: "string", description: `Path to a JSON file with the ${noun} definition`, required: false },
+      container: { type: "string", description: "Numeric container id", required: false }
+    }
+  });
+  registerSchema({
+    command: `tagManager.${entity}.update`,
+    description: `Stage an update to an existing Tag Manager ${noun}. Pass the ${noun} id or path as the positional argument and the changed fields as JSON. Read the container first so you send the fields you mean to change.`,
+    args: {
+      json: { type: "string", description: "Inline JSON with the changed fields", required: false },
+      file: { type: "string", description: "Path to a JSON file with the changed fields", required: false }
+    }
+  });
+  registerSchema({
+    command: `tagManager.${entity}.delete`,
+    description: `Stage the deletion of a Tag Manager ${noun}. Pass its id or path as the positional argument. Deleting is irreversible once the resulting version is published \u2014 confirm with the user first.`,
+    args: {}
+  });
+}
+function entityCommand(entity, noun) {
+  return defineCommand157({
+    meta: { name: entity, description: `Stage ${noun} changes on this chat's Tag Manager draft` },
+    subCommands: {
+      create: defineCommand157({
+        meta: {
+          name: "create",
+          description: `Stage a new ${noun}
+
+Examples:
+  baker tag-manager ${entity} create --json '{"name":"GA4 Config","type":"googtag"}'
+  baker tag-manager ${entity} create --file ./${entity}.json`
+        },
+        args: {
+          json: { type: "string", description: "Inline JSON definition", required: false },
+          file: { type: "string", description: "Path to a JSON file", required: false },
+          container: { type: "string", description: "Numeric container id", required: false }
+        },
+        run: async ({ args }) => {
+          await stageOp3({
+            kind: `tagManager.${entity}.create`,
+            payload: loadJsonArg(args),
+            ...typeof args.container === "string" ? { containerId: args.container } : {}
+          });
+        }
+      }),
+      update: defineCommand157({
+        meta: {
+          name: "update",
+          description: `Stage an update to an existing ${noun} (pass its id or path)`
+        },
+        args: {
+          id: { type: "positional", description: `${noun} id or path`, required: false },
+          json: { type: "string", description: "Inline JSON with changed fields", required: false },
+          file: { type: "string", description: "Path to a JSON file", required: false },
+          container: { type: "string", description: "Numeric container id", required: false }
+        },
+        run: async ({ args }) => {
+          await stageOp3({
+            kind: `tagManager.${entity}.update`,
+            target: requireTarget4(args, noun),
+            payload: loadJsonArg(args),
+            ...typeof args.container === "string" ? { containerId: args.container } : {}
+          });
+        }
+      }),
+      delete: defineCommand157({
+        meta: { name: "delete", description: `Stage the deletion of a ${noun} (pass its id or path)` },
+        args: {
+          id: { type: "positional", description: `${noun} id or path`, required: false },
+          container: { type: "string", description: "Numeric container id", required: false }
+        },
+        run: async ({ args }) => {
+          await stageOp3({
+            kind: `tagManager.${entity}.delete`,
+            target: requireTarget4(args, noun),
+            ...typeof args.container === "string" ? { containerId: args.container } : {}
+          });
+        }
+      })
+    }
+  });
+}
+var tagCommand = entityCommand("tag", "tag");
+var triggerCommand2 = entityCommand("trigger", "trigger");
+var variableCommand = entityCommand("variable", "variable");
+var folderCommand = entityCommand("folder", "folder");
+registerSchema({
+  command: "tagManager.builtin",
+  description: "Enable or disable Tag Manager built-in variables by type (e.g. clickUrl, pageUrl, formId). Built-in variables must be enabled before a trigger or tag can reference them as {{Click URL}}.",
+  args: {
+    types: { type: "string", description: "Comma-separated built-in variable types", required: true }
+  }
+});
+function builtinTypes(args) {
+  const raw = args.types;
+  if (typeof raw !== "string" || raw.length === 0) {
+    process.stdout.write(
+      `${JSON.stringify({ ok: false, error: { code: "VALIDATION_ERROR", message: "pass --types with comma-separated built-in variable types" } }, null, 2)}
+`
+    );
+    process.exit(1);
+  }
+  return raw.split(",").map((entry) => entry.trim());
+}
+var builtinCommand = defineCommand157({
+  meta: {
+    name: "builtin",
+    description: `Enable or disable built-in variables
+
+Examples:
+  baker tag-manager builtin enable --types clickUrl,clickText
+  baker tag-manager builtin disable --types formId`
+  },
+  subCommands: {
+    enable: defineCommand157({
+      meta: { name: "enable", description: "Stage enabling built-in variables" },
+      args: {
+        types: { type: "string", description: "Comma-separated types", required: false },
+        container: { type: "string", description: "Numeric container id", required: false }
+      },
+      run: async ({ args }) => {
+        await stageOp3({
+          kind: "tagManager.builtInVariable.enable",
+          payload: { type: builtinTypes(args) },
+          ...typeof args.container === "string" ? { containerId: args.container } : {}
+        });
+      }
+    }),
+    disable: defineCommand157({
+      meta: { name: "disable", description: "Stage disabling built-in variables" },
+      args: {
+        types: { type: "string", description: "Comma-separated types", required: false },
+        container: { type: "string", description: "Numeric container id", required: false }
+      },
+      run: async ({ args }) => {
+        await stageOp3({
+          kind: "tagManager.builtInVariable.disable",
+          payload: { type: builtinTypes(args) },
+          ...typeof args.container === "string" ? { containerId: args.container } : {}
+        });
+      }
+    })
+  }
+});
+
+// src/commands/tag-manager/index.ts
+var tagManagerCommand = defineCommand158({
+  meta: {
+    name: "tag-manager",
+    description: `Read and change what lives inside the client's Google Tag Manager container \u2014 tags, triggers, variables, folders and built-in variables.
+
+Start here:
+  baker tag-manager read                       \u2014 see what the container holds today
+
+Then stage changes (nothing is sent to Tag Manager until publish):
+  baker tag-manager trigger create --json '{"name":"Quote Submit","type":"customEvent"}'
+  baker tag-manager tag create --json '{"name":"GA4 Quote","type":"gaawe","firingTriggerId":["gtm_temp_trigger_..."]}'
+  baker tag-manager draft list                 \u2014 review everything staged
+
+On publish, staged changes are written into a new Tag Manager version that is NOT published.
+Tell the user to publish that version in Tag Manager to make it live.
+
+This owns the CONTENTS of the container. Installing the container snippet on the site is a
+different job \u2014 that is \`baker tags\` with the googleTagManager tag.
+
+Full guide: __tooling__/docs/tools/baker/tag-manager.md`
+  },
+  subCommands: {
+    containers: containersCommand,
+    read: readCommand,
+    tag: tagCommand,
+    trigger: triggerCommand2,
+    variable: variableCommand,
+    folder: folderCommand,
+    builtin: builtinCommand,
+    draft: draftCommand3
+  }
+});
+
+// src/commands/tags/index.ts
+import { defineCommand as defineCommand159 } from "citty";
+
 // src/commands/tags/shared.ts
 function failApi3(err) {
   if (err instanceof ApiError) {
@@ -29020,7 +29591,7 @@ async function listTags(json) {
     failApi3(err);
   }
 }
-var listCommand10 = defineCommand155({
+var listCommand10 = defineCommand159({
   meta: {
     name: "list",
     description: "Effective tags for this chat (production + staged), with each tag's full readable config (secrets excluded) \u2014 reuse a stored value to pre-fill a change rather than asking the user. Refs printed here are what flow side-effect tagIds should use. Example: baker tags list"
@@ -29039,7 +29610,7 @@ async function listDraft3() {
     failApi3(err);
   }
 }
-var draftCommand3 = defineCommand155({
+var draftCommand4 = defineCommand159({
   meta: {
     name: "draft",
     description: "Review the tag changes staged in this chat (read-only). Staged changes were approved via request_tag_input and apply when the chat is published; to amend or drop one, propose a follow-up change through the same tool (a delete on a tag_temp_* ref drops the staged create)."
@@ -29048,7 +29619,7 @@ var draftCommand3 = defineCommand155({
     await listDraft3();
   }
 });
-var tagsCommand3 = defineCommand155({
+var tagsCommand3 = defineCommand159({
   meta: {
     name: "tags",
     description: `Read the client's marketing/analytics tags (Meta pixel, GA4, Google Ads, GTM, Clarity, Hotjar, \u2026) \u2014 production tags plus the changes staged in this chat.
@@ -29066,7 +29637,7 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
   },
   subCommands: {
     list: listCommand10,
-    draft: draftCommand3
+    draft: draftCommand4
   },
   run: async () => {
     await listTags(false);
@@ -29074,10 +29645,10 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
 });
 
 // src/commands/testimonials/index.ts
-import { defineCommand as defineCommand159 } from "citty";
+import { defineCommand as defineCommand163 } from "citty";
 
 // src/commands/testimonials/get.ts
-import { defineCommand as defineCommand156 } from "citty";
+import { defineCommand as defineCommand160 } from "citty";
 registerSchema({
   command: "testimonials.get",
   description: "Get a single testimonial by ID",
@@ -29085,7 +29656,7 @@ registerSchema({
     id: { type: "string", description: "Testimonial ID", required: true }
   }
 });
-var getCommand4 = defineCommand156({
+var getCommand4 = defineCommand160({
   meta: { name: "get", description: "Get a single testimonial by ID. Example: baker testimonials get j571abc123" },
   args: {
     id: { type: "positional", description: "Testimonial ID", required: false },
@@ -29122,7 +29693,7 @@ var getCommand4 = defineCommand156({
 });
 
 // src/commands/testimonials/list.ts
-import { defineCommand as defineCommand157 } from "citty";
+import { defineCommand as defineCommand161 } from "citty";
 registerSchema({
   command: "testimonials.list",
   description: "List testimonials with optional filters.",
@@ -29152,7 +29723,7 @@ registerSchema({
     limit: { type: "number", description: "Max results (default 50)", required: false, default: 50 }
   }
 });
-var listCommand11 = defineCommand157({
+var listCommand11 = defineCommand161({
   meta: {
     name: "list",
     description: "List testimonials with optional filters. Example: baker testimonials list --source google --sentiment positive"
@@ -29201,7 +29772,7 @@ var listCommand11 = defineCommand157({
 });
 
 // src/commands/testimonials/search.ts
-import { defineCommand as defineCommand158 } from "citty";
+import { defineCommand as defineCommand162 } from "citty";
 function languageBiasHint(results, requestedLanguage) {
   if (requestedLanguage) {
     return null;
@@ -29279,7 +29850,7 @@ function buildSearchRequest(query, args) {
   }
   return body;
 }
-var searchCommand2 = defineCommand158({
+var searchCommand2 = defineCommand162({
   meta: {
     name: "search",
     description: "Semantic search testimonials by text query. Uses hybrid BM25 + vector + reranking. Example: baker testimonials search 'great service' --rating-min 4"
@@ -29335,7 +29906,7 @@ var searchCommand2 = defineCommand158({
 var tagsCommand4 = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
 
 // src/commands/testimonials/index.ts
-var testimonialsCommand = defineCommand159({
+var testimonialsCommand = defineCommand163({
   meta: {
     name: "testimonials",
     description: `Find and browse testimonials in Baker. Subcommands: search, get, list, tags.
@@ -29357,10 +29928,10 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
 });
 
 // src/commands/videos/index.ts
-import { defineCommand as defineCommand164 } from "citty";
+import { defineCommand as defineCommand168 } from "citty";
 
 // src/commands/videos/delete.ts
-import { defineCommand as defineCommand160 } from "citty";
+import { defineCommand as defineCommand164 } from "citty";
 registerSchema({
   command: "videos.delete",
   description: "Delete a video by ID",
@@ -29374,7 +29945,7 @@ registerSchema({
     }
   }
 });
-var deleteCommand3 = defineCommand160({
+var deleteCommand3 = defineCommand164({
   meta: {
     name: "delete",
     description: "Delete a video by ID. Use --dry-run to preview. Example: baker videos delete j571abc123 --dry-run"
@@ -29415,7 +29986,7 @@ var deleteCommand3 = defineCommand160({
 });
 
 // src/commands/videos/get.ts
-import { defineCommand as defineCommand161 } from "citty";
+import { defineCommand as defineCommand165 } from "citty";
 registerSchema({
   command: "videos.get",
   description: "Get a single video by ID",
@@ -29423,7 +29994,7 @@ registerSchema({
     id: { type: "string", description: "Video ID", required: true }
   }
 });
-var getCommand5 = defineCommand161({
+var getCommand5 = defineCommand165({
   meta: { name: "get", description: "Get a single video by ID. Example: baker videos get j571abc123" },
   args: {
     id: { type: "positional", description: "Video ID", required: false },
@@ -29460,7 +30031,7 @@ var getCommand5 = defineCommand161({
 });
 
 // src/commands/videos/search.ts
-import { defineCommand as defineCommand162 } from "citty";
+import { defineCommand as defineCommand166 } from "citty";
 registerSchema({
   command: "videos.search",
   description: "Search videos by text query. Only returns ready videos.",
@@ -29470,7 +30041,7 @@ registerSchema({
     tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
   }
 });
-var searchCommand3 = defineCommand162({
+var searchCommand3 = defineCommand166({
   meta: {
     name: "search",
     description: "Semantic search videos by text query. Uses hybrid BM25 + vector + reranking. Example: baker videos search 'product demo' --tags tutorial"
@@ -29522,7 +30093,7 @@ var tagsCommand5 = makeTagsCommand("videos", "video", "/api/videos/tags");
 // src/commands/videos/upload.ts
 import { readFile as readFile22, stat as stat7 } from "fs/promises";
 import { extname as extname3 } from "path";
-import { defineCommand as defineCommand163 } from "citty";
+import { defineCommand as defineCommand167 } from "citty";
 var MIME_MAP = {
   ".mp4": "video/mp4",
   ".mov": "video/quicktime",
@@ -29556,7 +30127,7 @@ function detectContentType(filePath) {
   }
   return mime;
 }
-var uploadCommand2 = defineCommand163({
+var uploadCommand2 = defineCommand167({
   meta: {
     name: "upload",
     description: "Upload a video file to Baker via Mux direct upload. Auto-detects content type. Example: baker videos upload ./demo.mp4"
@@ -29610,7 +30181,7 @@ var uploadCommand2 = defineCommand163({
 });
 
 // src/commands/videos/index.ts
-var videosCommand = defineCommand164({
+var videosCommand = defineCommand168({
   meta: {
     name: "videos",
     description: `Find and manage videos in Baker. Subcommands: search, get, upload, delete, tags.
@@ -29634,10 +30205,10 @@ Full guide: __tooling__/docs/tools/baker/videos.md`
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand177 } from "citty";
+import { defineCommand as defineCommand181 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
-import { defineCommand as defineCommand165 } from "citty";
+import { defineCommand as defineCommand169 } from "citty";
 
 // src/commands/winning-ads/shared.ts
 function splitList(value) {
@@ -29690,7 +30261,7 @@ function advertiserNormalizer(record, full) {
     last_synced_at: record.last_synced_at ?? null
   };
 }
-var advertisersCommand2 = defineCommand165({
+var advertisersCommand2 = defineCommand169({
   meta: {
     name: "advertisers",
     description: 'List corpus advertisers by name or domain. Find your own advertiser for --exclude-advertiser, or a competitor for --advertiser-id / winners. Example: baker winning-ads advertisers "Deel" --output md'
@@ -29748,7 +30319,7 @@ var advertisersCommand2 = defineCommand165({
 });
 
 // src/commands/winning-ads/brief.ts
-import { defineCommand as defineCommand166 } from "citty";
+import { defineCommand as defineCommand170 } from "citty";
 registerSchema({
   command: "winning-ads.brief",
   description: "Generate a creative brief grounded in strategically-similar winning ads. Optionally describe the target creative with --dna (JSON) and steer with --notes.",
@@ -29794,7 +30365,7 @@ function parseDna(raw) {
   }
   return parsed;
 }
-var briefCommand = defineCommand166({
+var briefCommand = defineCommand170({
   meta: {
     name: "brief",
     description: `Generate a creative brief from winning references. Example: baker winning-ads brief --dna '{"angle":"cost savings"}' --notes "B2B, LinkedIn video" --k 8`
@@ -29830,7 +30401,7 @@ var briefCommand = defineCommand166({
 });
 
 // src/commands/winning-ads/content.ts
-import { defineCommand as defineCommand167 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 registerSchema({
   command: "winning-ads.content",
   description: "Read what's INSIDE one winning ad: the spoken transcript, the on-screen text, and the ad copy. Use this after `search`/`winners`/`feed` return a shortlist \u2014 pass an ad_id to understand a reference before reproducing it. Add --full for speech, pacing, and soundtrack detail. Video ads carry the transcript/on-screen text; static ads carry only the copy.",
@@ -29843,7 +30414,7 @@ registerSchema({
     }
   }
 });
-var contentCommand = defineCommand167({
+var contentCommand = defineCommand171({
   meta: {
     name: "content",
     description: "Read the transcript + on-screen text + copy of one winning ad. Example: baker winning-ads content adg_123 --platform meta --full --output md"
@@ -29892,7 +30463,7 @@ var contentCommand = defineCommand167({
 });
 
 // src/commands/winning-ads/feed.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 function buildFeedParams(input) {
   const params = {};
   const advertiser = splitList(input.advertiser);
@@ -29944,7 +30515,7 @@ registerSchema({
     format: { type: "string", description: "Comma-separated formats to include (e.g. static,video)", required: false }
   }
 });
-var feedCommand = defineCommand168({
+var feedCommand = defineCommand172({
   meta: {
     name: "feed",
     description: "Winners across every brand you follow (browse, then trim per advertiser). Example: baker winning-ads feed --per-advertiser 5 --output md"
@@ -30029,7 +30600,7 @@ var feedCommand = defineCommand168({
 });
 
 // src/commands/winning-ads/follow.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand173 } from "citty";
 var PLATFORMS = ["meta", "linkedin"];
 registerSchema({
   command: "winning-ads.follow",
@@ -30044,7 +30615,7 @@ registerSchema({
     label: { type: "string", description: "Optional display label (defaults to the resolved name)", required: false }
   }
 });
-var followCommand = defineCommand169({
+var followCommand = defineCommand173({
   meta: {
     name: "follow",
     description: 'Follow a brand to track ALL its ads \u2014 every platform and country. --platform is how we read your input, not a limit. A domain tracks both Meta + LinkedIn. Example: baker winning-ads follow "deel.com" --platform meta'
@@ -30091,7 +30662,7 @@ var followCommand = defineCommand169({
 });
 
 // src/commands/winning-ads/follow-competitors.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand174 } from "citty";
 var PLATFORMS2 = ["meta", "linkedin"];
 var BATCH_TIMEOUT_MS = 3e5;
 function buildFollowBatchBody(input) {
@@ -30124,7 +30695,7 @@ registerSchema({
     }
   }
 });
-var followCompetitorsCommand = defineCommand170({
+var followCompetitorsCommand = defineCommand174({
   meta: {
     name: "follow-competitors",
     description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
@@ -30199,7 +30770,7 @@ var followCompetitorsCommand = defineCommand170({
 });
 
 // src/commands/winning-ads/following.ts
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand175 } from "citty";
 registerSchema({
   command: "winning-ads.following",
   description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts.",
@@ -30232,7 +30803,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand171({
+var followingCommand = defineCommand175({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. Example: baker winning-ads following --output md"
@@ -30267,7 +30838,7 @@ var followingCommand = defineCommand171({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand176 } from "citty";
 registerSchema({
   command: "winning-ads.patterns",
   description: "Mine what separates two cohorts of ads: pass a comma-list of winning ad ids (--winners) and a comma-list of weaker ad ids (--duds). Returns the discriminating DNA fields.",
@@ -30306,7 +30877,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand172({
+var patternsCommand = defineCommand176({
   meta: {
     name: "patterns",
     description: "Discover what separates winning ads from weak ones. Example: baker winning-ads patterns --winners a_1,a_2,a_3 --duds a_9,a_8 --output md"
@@ -30362,7 +30933,7 @@ var patternsCommand = defineCommand172({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand177 } from "citty";
 registerSchema({
   command: "winning-ads.search",
   description: "Search the ad-dna corpus of scored winning ads. Returns a lean shortlist (advertiser, summary, scores, media_url) to pick a reference to reproduce.",
@@ -30470,7 +31041,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand173({
+var searchCommand4 = defineCommand177({
   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"
@@ -30585,7 +31156,7 @@ var searchCommand4 = defineCommand173({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand174 } from "citty";
+import { defineCommand as defineCommand178 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -30613,7 +31184,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand174({
+  return defineCommand178({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -30662,7 +31233,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand175 } from "citty";
+import { defineCommand as defineCommand179 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -30670,7 +31241,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand175({
+var unfollowCommand = defineCommand179({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -30691,7 +31262,7 @@ var unfollowCommand = defineCommand175({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand176 } from "citty";
+import { defineCommand as defineCommand180 } from "citty";
 registerSchema({
   command: "winning-ads.winners",
   description: "Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.",
@@ -30701,7 +31272,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false }
   }
 });
-var winnersCommand = defineCommand176({
+var winnersCommand = defineCommand180({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -30751,7 +31322,7 @@ var winnersCommand = defineCommand176({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand177({
+var winningAdsCommand = defineCommand181({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -30807,7 +31378,7 @@ Full guide: __tooling__/docs/tools/baker/winning-ads.md`
 });
 
 // src/version.ts
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync13 } from "fs";
 function packageJsonUrl() {
   return new URL("../package.json", import.meta.url);
 }
@@ -30819,15 +31390,15 @@ function parsePackageVersion(raw) {
   throw new Error("Invalid CLI package.json: missing version");
 }
 function getCliVersion() {
-  return parsePackageVersion(readFileSync12(packageJsonUrl(), "utf8"));
+  return parsePackageVersion(readFileSync13(packageJsonUrl(), "utf8"));
 }
 
 // src/cli.ts
-var main = defineCommand178({
+var main = defineCommand182({
   meta: {
     name: "baker",
     version: getCliVersion(),
-    description: `AI-agent CLI for finding and managing images, videos, testimonials, action items, scheduled actions, marketing tags, account history, and ad platform data in Baker.
+    description: `AI-agent CLI for finding and managing images, videos, testimonials, action items, scheduled actions, marketing tags, Tag Manager containers, account history, and ad platform data in Baker.
 
 Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.
 Chat: Set BAKER_CHAT_ID for action and scheduled-action commands that stage changes against a chat.
@@ -30850,6 +31421,7 @@ Introspection: Run 'baker schema <command>' to inspect argument schemas.`
     testimonials: testimonialsCommand,
     canvas: canvasCommand,
     tags: tagsCommand3,
+    "tag-manager": tagManagerCommand,
     chats: chatsCommand,
     history: historyCommand,
     "winning-ads": winningAdsCommand,