@koda-sl/baker-cli 0.532.0 → 0.534.0-dev.911a80433

package/dist/stale-G2BPCBYZ.js

@@ -0,0 +1,90 @@
+import {
+  staleCreatives
+} from "./chunk-VYJLS64A.js";
+import "./chunk-EIRGJD3Q.js";
+import "./chunk-JUF6Q5X7.js";
+import "./chunk-3JV4T6XW.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-2UZHRLLO.js";
+import "./chunk-G3MN4HIX.js";
+import "./chunk-YR3OPPUE.js";
+import "./chunk-5HGAO4ZI.js";
+import "./chunk-ZOH672S6.js";
+import "./chunk-DMA67YC3.js";
+import "./chunk-6HGLQJ6A.js";
+import "./chunk-GPZVYXJZ.js";
+import "./chunk-55B4AJY3.js";
+import "./chunk-XJ5TX772.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-GYMZCJX6.js";
+import "./chunk-AGU4KGT6.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-R5LRBDEM.js";
+import "./chunk-AH6TDWYS.js";
+import "./chunk-XCRYRVKK.js";
+import "./chunk-G3MEYGXC.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-6QGBBX7F.js";
+import "./chunk-Y6MLSN6W.js";
+import "./chunk-DGZYZWMK.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-CNPYG4F3.js";
+import "./chunk-SVNH6P7O.js";
+import "./chunk-YJYKSMLF.js";
+import "./chunk-L763CNKH.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import {
+  optionalTurnId
+} from "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/stale.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "List the creatives edited since their last render in this workspace: what the models would be sent (the projected canvas, prompt.json without its `reference`/`source_context`/`notes` bookkeeping, scenes/*.json, the compositions it renders, the formats in _definition.md) no longer matches what the last completed `baker canvas run` drew, so the preview shows an older creative. Reformatting a file is not an edit. Read-only, offline and free. During a turn, re-render each one listed that the person should see with `baker canvas run <canvasPath>`. During a publish, never: Publish ships the last version the person was shown. Creatives never rendered here and half-built ones (unfilled [TODO] asset slots) are not listed. An entry with `refusedThisTurn` cannot be rendered again in this chat turn (it is ready, or had its renders or its time): do not run it; show the version it has and let the person's next message say what changes.";
+registerSchema({ command: "canvas.stale", description: DESCRIPTION, args: {} });
+var staleCommand = defineCommand({
+  meta: {
+    name: "stale",
+    description: DESCRIPTION
+  },
+  args: {},
+  async run() {
+    const cwd = process.cwd();
+    const stale = await staleCreatives(findWorkspaceRoot(cwd) ?? cwd, optionalTurnId());
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          ok: true,
+          data: { stale },
+          ...stale.length > 0 ? {
+            hints: stale.map(
+              (c) => c.refusedThisTurn ? `No render of ${c.slug} in this turn: ${c.refusedThisTurn}` : `Re-render ${c.slug} before showing it (never during a publish): baker canvas run ${c.canvasPath}`
+            )
+          } : {}
+        },
+        null,
+        2
+      )}
+`
+    );
+  }
+});
+export {
+  staleCommand
+};
+//# sourceMappingURL=stale-G2BPCBYZ.js.map

package/dist/stale-G2BPCBYZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/canvas/stale.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { optionalTurnId } from \"../../env.ts\";\nimport { findWorkspaceRoot } from \"./normalize-paths.ts\";\nimport { staleCreatives } from \"./render-state.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nconst DESCRIPTION =\n  \"List the creatives edited since their last render in this workspace: what the models would be sent (the projected canvas, prompt.json without its `reference`/`source_context`/`notes` bookkeeping, scenes/*.json, the compositions it renders, the formats in _definition.md) no longer matches what the last completed `baker canvas run` drew, so the preview shows an older creative. Reformatting a file is not an edit. Read-only, offline and free. During a turn, re-render each one listed that the person should see with `baker canvas run <canvasPath>`. During a publish, never: Publish ships the last version the person was shown. Creatives never rendered here and half-built ones (unfilled [TODO] asset slots) are not listed. An entry with `refusedThisTurn` cannot be rendered again in this chat turn (it is ready, or had its renders or its time): do not run it; show the version it has and let the person's next message say what changes.\";\n\nregisterSchema({ command: \"canvas.stale\", description: DESCRIPTION, args: {} });\n\nexport const staleCommand = defineCommand({\n  meta: {\n    name: \"stale\",\n    description: DESCRIPTION,\n  },\n  args: {},\n  async run() {\n    const cwd = process.cwd();\n    const stale = await staleCreatives(findWorkspaceRoot(cwd) ?? cwd, optionalTurnId());\n    process.stdout.write(\n      `${JSON.stringify(\n        {\n          ok: true,\n          data: { stale },\n          ...(stale.length > 0\n            ? {\n                hints: stale.map((c) =>\n                  c.refusedThisTurn\n                    ? `No render of ${c.slug} in this turn: ${c.refusedThisTurn}`\n                    : `Re-render ${c.slug} before showing it (never during a publish): baker canvas run ${c.canvasPath}`,\n                ),\n              }\n            : {}),\n        },\n        null,\n        2,\n      )}\\n`,\n    );\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAM9B,IAAM,cACJ;AAEF,eAAe,EAAE,SAAS,gBAAgB,aAAa,aAAa,MAAM,CAAC,EAAE,CAAC;AAEvE,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,MAAM,CAAC;AAAA,EACP,MAAM,MAAM;AACV,UAAM,MAAM,QAAQ,IAAI;AACxB,UAAM,QAAQ,MAAM,eAAe,kBAAkB,GAAG,KAAK,KAAK,eAAe,CAAC;AAClF,YAAQ,OAAO;AAAA,MACb,GAAG,KAAK;AAAA,QACN;AAAA,UACE,IAAI;AAAA,UACJ,MAAM,EAAE,MAAM;AAAA,UACd,GAAI,MAAM,SAAS,IACf;AAAA,YACE,OAAO,MAAM;AAAA,cAAI,CAAC,MAChB,EAAE,kBACE,gBAAgB,EAAE,IAAI,kBAAkB,EAAE,eAAe,KACzD,aAAa,EAAE,IAAI,iEAAiE,EAAE,UAAU;AAAA,YACtG;AAAA,UACF,IACA,CAAC;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA;AAAA,IACH;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/status-QNXQNAKH.js

@@ -0,0 +1,65 @@
+import {
+  failApi,
+  failValidation
+} from "./chunk-7MY3QHGA.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import {
+  getEnv
+} from "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/status.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.status",
+  description: "Resolve one or more Work Action refs by real action ID or temp_* ref in a single batch call. When BAKER_CHAT_ID is set, a temp_* ref still staged in THIS chat resolves to status 'draft' (not 'not_found') \u2014 staged ops only become published actions on chat publish.",
+  args: {
+    ref: {
+      type: "positional",
+      description: "One or more action refs: real action IDs or temp_* refs (space-separated)",
+      required: true
+    }
+  }
+});
+var statusCommand = defineCommand({
+  meta: {
+    name: "status",
+    description: "Resolve Work Action refs by real ID or temp_* ref. Example: baker actions status temp_hero jx123"
+  },
+  args: {
+    ref: { type: "positional", description: "Action ID or temp_* ref; accepts multiple refs", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const refs = [args.ref, ...Array.isArray(args._) ? args._ : []].filter((ref) => typeof ref === "string").map((ref) => ref.trim()).filter(Boolean);
+      if (refs.length === 0) {
+        failValidation("At least one action ref is required.");
+      }
+      const { BAKER_CHAT_ID } = getEnv();
+      const body = BAKER_CHAT_ID ? { refs, chatId: BAKER_CHAT_ID } : { refs };
+      const response = await apiPost("/api/actions/status", body);
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  statusCommand
+};
+//# sourceMappingURL=status-QNXQNAKH.js.map

package/dist/studio-BNYFU6ZH.js

@@ -0,0 +1,49 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/index.ts
+import { defineCommand } from "citty";
+var studioCommand = defineCommand({
+  meta: {
+    name: "studio",
+    description: `Make new imagery and clips. Every batch is recorded and shows up in the dashboard Studio for the client to review, labelled with this conversation.
+
+Make something:
+  baker studio generate <prompt> [--reference ids,paths,urls] [--model \u2026] [--aspect-ratio \u2026] [--count N]
+                                        Render 1-8 takes of one still; each is ingested into the media library as it lands
+  baker studio animate <prompt> --image <id|path|url,\u2026>
+                                        Turn a still into a clip \u2014 the prompt describes MOVEMENT, not the look
+  baker studio skills                   Craft directions you can pass to --skill
+  baker studio improve <prompt>         Sharpen a rough brief (use it for the CLIENT's words, not your own)
+
+Know what you can ask for:
+  baker studio models [--kind video] [--model <id>]
+                                        Per model: shapes, resolutions, clip lengths, prompt cap, reference limit, every knob
+
+Review and pick:
+  baker studio get <generationId>       One batch: every take, its url, whether it is in the library, why one failed
+  baker studio list [--kind image|video] [--all]
+                                        Recent batches for this conversation (--all = the whole company)
+  baker studio keep <generationId> --slot N
+                                        Mark the keeper. Stars an image; INGESTS a clip into the video library
+
+Three rules worth remembering:
+  - --reference is the biggest quality lever there is. Ground a render in a real logo, product shot or mood image.
+  - A clip is not usable anywhere until it is kept. Unkept takes are never ingested.
+  - The models disagree about what they accept, and a setting the chosen model does not have is REFUSED rather than ignored. Run baker studio models to answer "can this one do that".
+Full guide: __tooling__/docs/tools/baker/studio.md`
+  },
+  subCommands: {
+    generate: () => import("./generate-HOMLLUCN.js").then((m) => m.generateCommand),
+    animate: () => import("./animate-EOSLSA7F.js").then((m) => m.animateCommand),
+    get: () => import("./get-ZISAHMTQ.js").then((m) => m.getCommand),
+    list: () => import("./list-6YW4I4VG.js").then((m) => m.listCommand),
+    keep: () => import("./keep-YSU3XMW3.js").then((m) => m.keepCommand),
+    models: () => import("./models-WNK7Z6TR.js").then((m) => m.modelsCommand),
+    skills: () => import("./skills-FBIVWINH.js").then((m) => m.skillsCommand),
+    improve: () => import("./improve-LIKOER3S.js").then((m) => m.improveCommand)
+  }
+});
+export {
+  studioCommand
+};
+//# sourceMappingURL=studio-BNYFU6ZH.js.map

package/dist/sync-OYOS7HQL.js

@@ -0,0 +1,57 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-QTLIXCVN.js";
+import {
+  testimonialSourcesSyncRequestSchema
+} from "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/sources/sync.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.sources.sync",
+  description: "Import a review source's new reviews now. Only reviews newer than the last import are read where the site allows it.",
+  args: { id: { type: "string", description: "Source id from `testimonials sources list`", required: true } }
+});
+var syncCommand = defineCommand({
+  meta: {
+    name: "sync",
+    description: "Import a review source's new reviews now.\n\nExample: baker testimonials sources sync <source-id>"
+  },
+  args: { id: { type: "positional", description: "Source id from `testimonials sources list`", required: true } },
+  run: async ({ args }) => {
+    const parsed = testimonialSourcesSyncRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    try {
+      const data = await apiPost("/api/testimonials/sources/sync", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: data.started ? void 0 : ["An import was already running for this source; nothing new was started."]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  syncCommand
+};
+//# sourceMappingURL=sync-OYOS7HQL.js.map

package/dist/sync-definition-2VEFGHYK.js

@@ -0,0 +1,70 @@
+import {
+  buildDefinitionSyncPayload,
+  readDefinitionBody,
+  readDefinitionPlatforms,
+  readDefinitionSeriesPlace,
+  readDefinitionSourceFields,
+  readDefinitionStrategyFields,
+  readDefinitionTitle,
+  resolveCanvasPath,
+  syncCreativeDefinitionBestEffort,
+  syncDefinitionCommand
+} from "./chunk-T75WL56Z.js";
+import "./chunk-YXQFCQX2.js";
+import "./chunk-EIRGJD3Q.js";
+import "./chunk-JUF6Q5X7.js";
+import "./chunk-3JV4T6XW.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-2UZHRLLO.js";
+import "./chunk-YR3OPPUE.js";
+import "./chunk-5HGAO4ZI.js";
+import "./chunk-ZOH672S6.js";
+import "./chunk-DMA67YC3.js";
+import "./chunk-6HGLQJ6A.js";
+import "./chunk-GPZVYXJZ.js";
+import "./chunk-55B4AJY3.js";
+import "./chunk-XJ5TX772.js";
+import "./chunk-GYMZCJX6.js";
+import "./chunk-AGU4KGT6.js";
+import "./chunk-R5LRBDEM.js";
+import "./chunk-SOS4QFLE.js";
+import "./chunk-AH6TDWYS.js";
+import "./chunk-XCRYRVKK.js";
+import "./chunk-G3MEYGXC.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-6QGBBX7F.js";
+import "./chunk-Y6MLSN6W.js";
+import "./chunk-DGZYZWMK.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-CNPYG4F3.js";
+import "./chunk-SVNH6P7O.js";
+import "./chunk-YJYKSMLF.js";
+import "./chunk-L763CNKH.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  buildDefinitionSyncPayload,
+  readDefinitionBody,
+  readDefinitionPlatforms,
+  readDefinitionSeriesPlace,
+  readDefinitionSourceFields,
+  readDefinitionStrategyFields,
+  readDefinitionTitle,
+  resolveCanvasPath,
+  syncCreativeDefinitionBestEffort,
+  syncDefinitionCommand
+};
+//# sourceMappingURL=sync-definition-2VEFGHYK.js.map

package/dist/tags-56H6O7ZL.js

@@ -0,0 +1,26 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/index.ts
+import { defineCommand } from "citty";
+var tagsCommand = defineCommand({
+  meta: {
+    name: "tags",
+    description: `Manage the action tag taxonomy (built-in defaults + company custom tags). Tags are strict \u2014 only listed names work with --tags on create/update.
+
+Examples:
+  baker actions tags list                                  # available tags (defaults + custom)
+  baker actions tags create --slug pmax --description "\u2026"   # mint a custom tag
+  baker actions tags update --slug pmax --description "\u2026"   # change what it means
+  baker actions tags delete --slug pmax                     # remove a custom tag`
+  },
+  subCommands: {
+    list: () => import("./list-GS42LK5C.js").then((m) => m.tagsListCommand),
+    create: () => import("./create-7WV7XWZV.js").then((m) => m.tagsCreateCommand),
+    update: () => import("./update-JHWPEJN7.js").then((m) => m.tagsUpdateCommand),
+    delete: () => import("./delete-EH3XL26Z.js").then((m) => m.tagsDeleteCommand)
+  }
+});
+export {
+  tagsCommand
+};
+//# sourceMappingURL=tags-56H6O7ZL.js.map

package/dist/tags-CYR2IPEJ.js

@@ -0,0 +1,23 @@
+import {
+  makeTagsCommand
+} from "./chunk-UUWUJ64R.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/tags.ts
+var tagsCommand = makeTagsCommand("images", "image", "/api/images/tags");
+export {
+  tagsCommand
+};
+//# sourceMappingURL=tags-CYR2IPEJ.js.map

package/dist/tags-RBUYBAA6.js

@@ -0,0 +1,227 @@
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import {
+  TAG_IDENTIFYING_FIELD
+} from "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/tags/index.ts
+import { defineCommand } from "citty";
+
+// src/commands/tags/shared.ts
+function failApi(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  if (err instanceof Error) {
+    writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+function failValidation(message) {
+  writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function renderConfigValue(value) {
+  return value.includes("\n") ? value.replace(/\n/g, "\n      ") : value;
+}
+function renderEffectiveEntry(entry) {
+  const parts = [entry.ref, entry.type];
+  if (entry.identifier !== void 0) {
+    parts.push(entry.identifier);
+  }
+  if (entry.staged !== void 0) {
+    parts.push(`[staged: ${entry.staged}]`);
+  }
+  const secretBits = [
+    ...entry.secretsSet.map((field) => `${field} \u2713 set`),
+    ...entry.secretsPending.map((field) => `${field} \u23F3 pending`)
+  ];
+  if (secretBits.length > 0) {
+    parts.push(`[secrets: ${secretBits.join(", ")}]`);
+  }
+  const header = parts.join("  ");
+  const identifyingField = TAG_IDENTIFYING_FIELD[entry.type];
+  const configLines = Object.entries(entry.config).filter(([key]) => key !== identifyingField).map(([key, value]) => `    ${key}: ${renderConfigValue(value)}`);
+  return configLines.length > 0 ? `${header}
+${configLines.join("\n")}` : header;
+}
+function tagsListHints() {
+  return [
+    "To create, edit or delete a tag, call the `request_tag_input` approval form (tool `mcp__baker_ui__request_tag_input`, server `baker_ui`) \u2014 it is attached to every turn of this chat and collects any secret values itself.",
+    "Don't conclude the form is unavailable from your tool list: call it, and report what it returns. And never file a tag change as a Task \u2014 a Task hands the user work this chat can stage in one call."
+  ];
+}
+
+// src/commands/tags/index.ts
+registerSchema({
+  command: "tags.list",
+  description: "Effective marketing tags for this chat: production tags overlaid with the changes staged in this chat. Prints each tag's readable config in full (secrets are never included) \u2014 e.g. the Clarity projectId, GA4 measurementId, or the entire custom `code` snippet \u2014 so reuse a stored value to pre-fill a follow-up change instead of asking the user for something we already have. The printed refs (tag ids or tag_temp_*) are exactly what flow side-effect tagIds should reference. Read-only \u2014 every tag change (create, edit, delete) goes through the request_tag_input approval tool; `baker tags unstage` takes back one this chat staged.",
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list", required: false }
+  }
+});
+async function listTags(json) {
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/tags/list", { chatId });
+    const hints = tagsListHints();
+    if (json) {
+      writeJson({ ok: true, data: response, hints });
+      return;
+    }
+    if (response.tags.length === 0) {
+      process.stdout.write("No tags configured.\n");
+    } else {
+      process.stdout.write(`${response.tags.map(renderEffectiveEntry).join("\n")}
+`);
+    }
+    for (const hint of hints) {
+      process.stderr.write(`${hint}
+`);
+    }
+  } catch (err) {
+    failApi(err);
+  }
+}
+var listArgs = {
+  json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" }
+};
+var listCommand = defineCommand({
+  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"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    await listTags(args.json === true);
+  }
+});
+async function listDraft(chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/tags/draft", { chatId });
+    writeJson({ ok: true, data: response, hints: tagsListHints() });
+  } catch (err) {
+    failApi(err);
+  }
+}
+var draftCommand = defineCommand({
+  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 drop one, `baker tags unstage <ref>` with the ref printed here (or --all); to amend one, propose a follow-up change through the same tool. Takes --chat <id> to read an earlier chat's staged changes instead."
+  },
+  args: { chat: CHAT_READ_ARG },
+  run: async ({ args }) => {
+    await listDraft(args.chat);
+  }
+});
+registerSchema({
+  command: "tags.unstage",
+  description: "Take back a tag change this chat staged, before Publish \u2014 the same as discarding its row in the change review. Pass the ref `baker tags draft` prints (a tag id, or tag_temp_* for a staged create), or --all for every staged tag change. Taking back a staged create also drops the secrets the user entered for it. Never touches a live tag: to change or remove one, propose the change through request_tag_input.",
+  args: {
+    ref: { type: "string", description: "The staged change's ref, from `baker tags draft`", required: false },
+    all: { type: "boolean", description: "Take back every tag change staged in this chat", required: false }
+  }
+});
+function unstageBody(args, chatId) {
+  const ref = args.ref?.trim();
+  if (args.all === true && ref) {
+    failValidation("Pass one ref to take back that change, or --all for every staged tag change \u2014 not both.");
+  }
+  if (args.all === true) {
+    return { chatId, all: true };
+  }
+  if (!ref) {
+    failValidation("Pass the ref of the staged change (from `baker tags draft`), or --all.");
+  }
+  return { chatId, ref };
+}
+var unstageCommand = defineCommand({
+  meta: {
+    name: "unstage",
+    description: "Take back a tag change this chat staged, before Publish. Examples: baker tags unstage tag_temp_abc123 | baker tags unstage --all"
+  },
+  args: {
+    ref: { type: "positional", description: "The staged change's ref, from `baker tags draft`", required: false },
+    all: { type: "boolean", description: "Take back every tag change staged in this chat", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = unstageBody(
+        {
+          ...typeof args.ref === "string" ? { ref: args.ref } : {},
+          ...args.all === true ? { all: true } : {}
+        },
+        requireChatId()
+      );
+      const response = await apiPost("/api/tags/draft-op/remove", body);
+      writeJson({
+        ...response,
+        hints: ["Taken back: it does not apply when the chat is published. Live tags are unchanged."]
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var tagsCommand = defineCommand({
+  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.
+
+Every tag change \u2014 create, edit, or delete \u2014 goes through the request_tag_input tool (baker_ui MCP server): propose one or more changes (each becomes a tab in one approval form), pre-fill the non-secret fields you know, and the user reviews, fills secrets, and approves or skips each. Secret values (accessToken, apiSecret, authorizationToken, apiKey, conversionToken, OAuth connections) never pass through the CLI or the chat.
+
+Refs: \`baker tags list\` prints each tag's ref \u2014 a real tag id, or tag_temp_* for creates staged in this chat. Use these refs as flow side-effect tagIds; they keep resolving after publish.
+
+\`baker tags list\` prints each tag's readable config in full (secrets excluded) \u2014 the Clarity projectId, GA4 measurementId, the whole custom \`code\` snippet, etc. Reuse a stored value to pre-fill a follow-up change instead of asking the user for something already installed.
+
+To take back a change this chat staged (before Publish), \`baker tags unstage <ref>\` \u2014 the ref \`baker tags draft\` prints \u2014 or \`--all\`. It never touches a live tag.
+
+Examples:
+  baker tags list       # production + staged, full readable config + secret status
+  baker tags draft      # review the staged changes awaiting publish
+  baker tags unstage tag_temp_abc123   # take back one staged change
+Full guide: __tooling__/docs/tools/baker/tags.md`
+  },
+  subCommands: {
+    list: listCommand,
+    draft: draftCommand,
+    unstage: unstageCommand
+  },
+  // Bare `baker tags` lists the effective tags. `args` stays so citty knows this
+  // command's flags when it scans rawArgs for a subcommand name, and `default` (not
+  // `run`) dispatches the bare invocation — citty falls through to `run` after a
+  // subcommand, so a `run` here would also list on every `baker tags draft`.
+  args: listArgs,
+  default: "list"
+});
+export {
+  tagsCommand,
+  unstageBody
+};
+//# sourceMappingURL=tags-RBUYBAA6.js.map

package/dist/tags-WVJNOATS.js

@@ -0,0 +1,23 @@
+import {
+  makeTagsCommand
+} from "./chunk-UUWUJ64R.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/tags.ts
+var tagsCommand = makeTagsCommand("videos", "video", "/api/videos/tags");
+export {
+  tagsCommand
+};
+//# sourceMappingURL=tags-WVJNOATS.js.map

package/dist/tags-ZTVOZOYP.js

@@ -0,0 +1,23 @@
+import {
+  makeTagsCommand
+} from "./chunk-UUWUJ64R.js";
+import "./chunk-DYOUJERF.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/tags.ts
+var tagsCommand = makeTagsCommand("testimonials", "testimonial", "/api/testimonials/tags");
+export {
+  tagsCommand
+};
+//# sourceMappingURL=tags-ZTVOZOYP.js.map