@koda-sl/baker-cli 0.149.0 → 0.150.0-dev.57528fa3f

package/dist/cli.js

@@ -36,7 +36,7 @@ import {
   toModelSafeImage,
   ulid,
   validateCanvasDeep
-} from "./chunk-OO5BDH3J.js";
+} from "./chunk-JBDSJZBZ.js";
 import {
   csvOrJson,
   daysAgoIso,
@@ -75,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";
@@ -2133,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",
@@ -29018,9 +29019,505 @@ 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);
+}
+var STAGE_HINTS = [
+  "Staged only \u2014 nothing has changed in Tag Manager yet. These apply when the chat completes, in dependency order, and close as a Tag Manager version. Whether that version goes live is a per-company setting, so never promise the user their tracking is live; say the changes are ready and will apply when you finish."
+];
+async function stageOp3(op) {
+  const chatId = requireChatId();
+  try {
+    const data = await apiPost("/api/tag-manager/draft/stage", { chatId, op });
+    writeJsonEnvelope({ ok: true, data, hints: STAGE_HINTS });
+  } 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)`,
+    ...response.ops.map((op) => {
+      const status = op.result ? ` [${op.result.status}]` : "";
+      return `  ${op.ref}  ${op.summary}${status}`;
+    })
+  ];
+  if (response.versionId) {
+    lines.push(
+      "",
+      response.published ? `Applied and published as Tag Manager version ${response.versionId}. These changes are live on the site.` : `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) {
@@ -29085,7 +29582,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"
@@ -29104,7 +29601,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)."
@@ -29113,7 +29610,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.
@@ -29131,7 +29628,7 @@ Full guide: __tooling__/docs/tools/baker/tags.md`
   },
   subCommands: {
     list: listCommand10,
-    draft: draftCommand3
+    draft: draftCommand4
   },
   run: async () => {
     await listTags(false);
@@ -29139,10 +29636,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",
@@ -29150,7 +29647,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 },
@@ -29187,7 +29684,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.",
@@ -29217,7 +29714,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"
@@ -29266,7 +29763,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;
@@ -29344,7 +29841,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"
@@ -29400,7 +29897,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.
@@ -29422,10 +29919,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",
@@ -29439,7 +29936,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"
@@ -29480,7 +29977,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",
@@ -29488,7 +29985,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 },
@@ -29525,7 +30022,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.",
@@ -29535,7 +30032,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"
@@ -29587,7 +30084,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",
@@ -29621,7 +30118,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"
@@ -29675,7 +30172,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.
@@ -29699,10 +30196,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) {
@@ -29755,7 +30252,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'
@@ -29813,7 +30310,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.",
@@ -29859,7 +30356,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`
@@ -29895,7 +30392,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.",
@@ -29908,7 +30405,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"
@@ -29957,7 +30454,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);
@@ -30009,7 +30506,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"
@@ -30094,7 +30591,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",
@@ -30109,7 +30606,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'
@@ -30156,7 +30653,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) {
@@ -30189,7 +30686,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"'
@@ -30264,7 +30761,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.",
@@ -30297,7 +30794,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"
@@ -30332,7 +30829,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.",
@@ -30371,7 +30868,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"
@@ -30427,7 +30924,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.",
@@ -30535,7 +31032,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"
@@ -30650,7 +31147,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,
@@ -30678,7 +31175,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 },
@@ -30727,7 +31224,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.",
@@ -30735,7 +31232,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"
@@ -30756,7 +31253,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.",
@@ -30766,7 +31263,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"
@@ -30816,7 +31313,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.
@@ -30872,7 +31369,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);
 }
@@ -30884,15 +31381,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.
@@ -30915,6 +31412,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,