@koda-sl/baker-cli 0.525.0 → 0.527.0

package/dist/campaigns-GQWFSKGC.js

@@ -0,0 +1,130 @@
+import {
+  META_LIST_SHAPE_ARGS,
+  budgetUnitHints,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-WW6JLISJ.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-BN4TDL5L.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-HPDGVK6R.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X3HPRECW.js";
+import "./chunk-65Y3RCWP.js";
+import {
+  apiGet
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/campaigns.ts
+import { defineCommand } from "citty";
+function advantagePlusHints(rows) {
+  const named = rows.flatMap((row) => {
+    const info = row.advantage_state_info;
+    const state = info?.advantage_state;
+    return typeof state === "string" && state.startsWith("ADVANTAGE_PLUS_") ? [`${String(row.id)} (${state.slice("ADVANTAGE_PLUS_".length).toLowerCase()})`] : [];
+  });
+  return named.length > 0 ? [
+    `Advantage+ campaigns: ${named.join(", ")}. Per-lever states (budget, audience, placements): --fields id,name,advantage_state_info.`
+  ] : [];
+}
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  ...META_LIST_SHAPE_ARGS
+};
+registerMetaListSchema(
+  "campaigns",
+  "List campaigns in a Meta ad account, as a table by default: id, name, effective_status, daily_budget, lifetime_budget, created_date. ACTIVE only unless --all-statuses. Start here: baker ads meta campaigns --account-id act_123 --all-statuses. --fields takes dotted paths for anything else (e.g. id,name,objective,bid_strategy,special_ad_categories,advantage_state_info); --full returns every field Meta sent; --output json returns the rows in the envelope. A hint names the campaigns Meta counts as Advantage+.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List campaigns for a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta campaigns --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = await resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/campaigns", params);
+      const shaped = shapeMetaListRows("campaigns", data, args);
+      writeMetaListRows("campaigns", shaped, csvOrJson(args), [
+        ...statusFilterHints(data, effectiveStatus, "campaigns"),
+        ...advantagePlusHints(data),
+        ...budgetUnitHints(data)
+      ]);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List campaigns for a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/copy).
+Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft and
+apply only when the chat is published.
+
+In Meta's API "campaign" is the top-of-tree object (what marketers usually call a campaign group).
+The dashboard shows effective_status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.
+
+Listings print a table by default: id, name, effective_status, daily/lifetime budget, created_date.
+--fields takes dotted paths for anything else (objective, bid_strategy, special_ad_categories, created_time,
+advantage_state_info). A hint names the campaigns Meta counts as Advantage+ \u2014 a state Meta derives from a
+campaign budget, Advantage+ audience and automatic placements on every ad set, not a setting;
+--full returns every field; --output json returns the same rows in the { ok, data } envelope.
+
+Examples:
+  baker ads meta campaigns --account-id act_123                                   # ACTIVE only
+  baker ads meta campaigns --account-id act_123 --all-statuses                    # everything
+  baker ads meta campaigns --account-id act_123 --all-statuses --name-contains Q3               # find one by name
+  baker ads meta campaigns --account-id act_123 --fields id,name,objective,bid_strategy,special_ad_categories
+  baker ads meta campaigns --account-id act_123 --output json                     # rows as JSON
+  baker ads meta campaigns create --account-id act_123 --name "Q3" --objective OUTCOME_LEADS --daily-budget 50
+  baker ads meta campaigns pause 6123 --account-id act_123`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-CY734U34.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-CY734U34.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-CY734U34.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-CY734U34.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-CY734U34.js").then((m) => m.campaignsArchiveCommand),
+    delete: () => import("./write-commands-CY734U34.js").then((m) => m.campaignsDeleteCommand),
+    duplicate: () => import("./write-commands-CY734U34.js").then((m) => m.campaignsDuplicateCommand),
+    copy: () => import("./copy-writes-EUFEVWDW.js").then((m) => m.campaignsCopyCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  advantagePlusHints,
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-GQWFSKGC.js.map

package/dist/campaigns-GQWFSKGC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/campaigns.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport {\n  budgetUnitHints,\n  META_LIST_SHAPE_ARGS,\n  registerMetaListSchema,\n  shapeMetaListRows,\n  writeMetaListRows,\n} from \"./list-rows.ts\";\nimport {\n  csvOrJson,\n  handleMetaError,\n  NAME_CONTAINS_ARG,\n  resolveAccountIdArg,\n  resolveEffectiveStatus,\n  statusFilterHints,\n} from \"./shared.ts\";\n\n/**\n * Which listed campaigns Meta counts as Advantage+, read off the derived\n * `advantage_state_info` — a hint rather than a column, so the compact row of a\n * 100-campaign account stays small. Advantage+ is not a switch: it follows from\n * a campaign budget, Advantage+ audience and automatic placements.\n */\nexport function advantagePlusHints(rows: ReadonlyArray<Record<string, unknown>>): string[] {\n  const named = rows.flatMap((row) => {\n    const info = row.advantage_state_info as { advantage_state?: unknown } | undefined;\n    const state = info?.advantage_state;\n    return typeof state === \"string\" && state.startsWith(\"ADVANTAGE_PLUS_\")\n      ? [`${String(row.id)} (${state.slice(\"ADVANTAGE_PLUS_\".length).toLowerCase()})`]\n      : [];\n  });\n  return named.length > 0\n    ? [\n        `Advantage+ campaigns: ${named.join(\", \")}. Per-lever states (budget, audience, placements): --fields id,name,advantage_state_info.`,\n      ]\n    : [];\n}\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n  \"effective-status\": { type: \"string\", description: \"Comma-separated effective_status filter (overrides default)\" },\n  \"all-statuses\": { type: \"boolean\", description: \"Drop the default ACTIVE filter and return everything\" },\n  \"name-contains\": NAME_CONTAINS_ARG,\n  limit: { type: \"string\", description: \"Max rows (default 1000)\" },\n  \"no-cache\": NO_CACHE_ARG,\n  ...META_LIST_SHAPE_ARGS,\n} as const;\n\nregisterMetaListSchema(\n  \"campaigns\",\n  \"List campaigns in a Meta ad account, as a table by default: id, name, effective_status, daily_budget, lifetime_budget, created_date. ACTIVE only unless --all-statuses. Start here: baker ads meta campaigns --account-id act_123 --all-statuses. --fields takes dotted paths for anything else (e.g. id,name,objective,bid_strategy,special_ad_categories,advantage_state_info); --full returns every field Meta sent; --output json returns the rows in the envelope. A hint names the campaigns Meta counts as Advantage+.\",\n  listArgs,\n);\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List campaigns for a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta campaigns --account-id act_123\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = await resolveAccountIdArg(args);\n    const effectiveStatus = resolveEffectiveStatus(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (effectiveStatus) params[\"effective-status\"] = effectiveStatus;\n      if (args[\"name-contains\"]) params[\"name-contains\"] = args[\"name-contains\"] as string;\n      if (args.limit) params.limit = args.limit as string;\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/campaigns\", params);\n      const shaped = shapeMetaListRows(\"campaigns\", data, args);\n      writeMetaListRows(\"campaigns\", shaped, csvOrJson(args), [\n        ...statusFilterHints(data, effectiveStatus, \"campaigns\"),\n        ...advantagePlusHints(data),\n        ...budgetUnitHints(data),\n      ]);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nexport const campaignsCommand = defineCommand({\n  meta: {\n    name: \"campaigns\",\n    description: `List campaigns for a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/copy).\nDefaults to ACTIVE only — pass --all-statuses to widen. Write subcommands stage ops on this chat's draft and\napply only when the chat is published.\n\nIn Meta's API \"campaign\" is the top-of-tree object (what marketers usually call a campaign group).\nThe dashboard shows effective_status: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES, etc.\n\nListings print a table by default: id, name, effective_status, daily/lifetime budget, created_date.\n--fields takes dotted paths for anything else (objective, bid_strategy, special_ad_categories, created_time,\nadvantage_state_info). A hint names the campaigns Meta counts as Advantage+ — a state Meta derives from a\ncampaign budget, Advantage+ audience and automatic placements on every ad set, not a setting;\n--full returns every field; --output json returns the same rows in the { ok, data } envelope.\n\nExamples:\n  baker ads meta campaigns --account-id act_123                                   # ACTIVE only\n  baker ads meta campaigns --account-id act_123 --all-statuses                    # everything\n  baker ads meta campaigns --account-id act_123 --all-statuses --name-contains Q3               # find one by name\n  baker ads meta campaigns --account-id act_123 --fields id,name,objective,bid_strategy,special_ad_categories\n  baker ads meta campaigns --account-id act_123 --output json                     # rows as JSON\n  baker ads meta campaigns create --account-id act_123 --name \"Q3\" --objective OUTCOME_LEADS --daily-budget 50\n  baker ads meta campaigns pause 6123 --account-id act_123`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.campaignsCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.campaignsUpdateCommand),\n    pause: () => import(\"./write-commands.ts\").then((m) => m.campaignsPauseCommand),\n    resume: () => import(\"./write-commands.ts\").then((m) => m.campaignsResumeCommand),\n    archive: () => import(\"./write-commands.ts\").then((m) => m.campaignsArchiveCommand),\n    delete: () => import(\"./write-commands.ts\").then((m) => m.campaignsDeleteCommand),\n    duplicate: () => import(\"./write-commands.ts\").then((m) => m.campaignsDuplicateCommand),\n    copy: () => import(\"./copy-writes.ts\").then((m) => m.campaignsCopyCommand),\n  },\n  // `args` stays even though the parent has no `run`: citty scans rawArgs for the\n  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`\n  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare\n  // invocation — citty falls through to `run` after a subcommand, double-executing it.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}

package/dist/canvas-AZ47PNYZ.js

@@ -0,0 +1,46 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/index.ts
+import { defineCommand } from "citty";
+var canvasCommand = defineCommand({
+  meta: {
+    name: "canvas",
+    description: `Run Baker creative canvas JSON files locally. Local nodes execute in-process; remote nodes POST to the Convex backend gateway.
+
+Auth: BAKER_API_KEY (bk_, bkr_ or bkv_) + BAKER_API_URL (your Convex .convex.site URL).
+
+Subcommands:
+  baker canvas validate <file.json> : bring the canvas up to date with its blueprint, then schema/registry check + composition-meta deep check + cost preview
+  baker canvas critique <file.json> : pre-spend creative critic (advisory): video hook/legibility/retention or static text/grounding/type scores, never blocks
+  baker canvas viewer-check <slug> : would the viewer this static ad reaches understand it? (what is offered, to whom, what next; run makes the same check before it spends)
+  baker canvas run <file.json> : execute the canvas, write outputs to ./canvas/<run_id>/
+  baker canvas run --slug <slug> : run a creative by name; restores its files from run history when this workspace lacks them
+  baker canvas stale : creatives edited since their last render here (re-render each one listed)
+  baker canvas sync-definition <path> : push a creative's current node-graph + input thumbnails to the dashboard without rendering (runs automatically on canvas/prompt edits)
+  baker canvas catalog : one line per node; --node <id> for its full schema
+  baker canvas inspect <run_id> : one-page summary of a run (from run history when its folder is not here)
+  baker canvas scaffold-ad --spec <spec.json> : DEFAULT for a new ad: write beats (one spoken line + one shot each), get the whole runnable canvas
+  baker canvas scaffold-video <video> : reproduce a video the USER gave you (an ad you found is inspiration, not a copy target)
+  baker canvas scaffold-static-ad <image> : turn a source image into a runnable static-ad canvas (describe + element detection)
+Full guide: __tooling__/docs/tools/baker/canvas.md`
+  },
+  subCommands: {
+    run: () => import("./run-7OCCCNJ4.js").then((m) => m.runCommand),
+    rerun: () => import("./rerun-HUFJUOEV.js").then((m) => m.rerunCommand),
+    validate: () => import("./validate-JX4FT7PL.js").then((m) => m.validateCommand),
+    critique: () => import("./critique-OK2ENBOA.js").then((m) => m.critiqueCommand),
+    "viewer-check": () => import("./viewer-check-5GREZIVJ.js").then((m) => m.viewerCheckCommand),
+    catalog: () => import("./catalog-XECCXRM6.js").then((m) => m.catalogCommand),
+    inspect: () => import("./inspect-25IVRU45.js").then((m) => m.inspectCommand),
+    "scaffold-ad": () => import("./scaffold-ad-7ADCDQBK.js").then((m) => m.scaffoldAdCommand),
+    "scaffold-video": () => import("./scaffold-video-LLBDO546.js").then((m) => m.scaffoldVideoCommand),
+    "scaffold-static-ad": () => import("./scaffold-static-ad-TV5OWISA.js").then((m) => m.scaffoldStaticAdCommand),
+    "set-prompt": () => import("./set-prompt-SYWNE4CS.js").then((m) => m.setPromptCommand),
+    "sync-definition": () => import("./sync-definition-EGHEQ57K.js").then((m) => m.syncDefinitionCommand),
+    stale: () => import("./stale-QNIJZTGD.js").then((m) => m.staleCommand)
+  }
+});
+export {
+  canvasCommand
+};
+//# sourceMappingURL=canvas-AZ47PNYZ.js.map

package/dist/capabilities-BEZXR2FZ.js

@@ -0,0 +1,147 @@
+import {
+  failApi
+} from "./chunk-J4ASA24X.js";
+import "./chunk-HVJJEQDQ.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  CAPABILITY_SURFACES
+} from "./chunk-NSBNIPIW.js";
+import "./chunk-46YLDIQG.js";
+import {
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import {
+  getEnv
+} from "./chunk-52IYZCRS.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/capabilities/index.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "capabilities",
+  description: "Start here, before promising the user anything on an ad platform, in Analytics, or in Tag Manager. Answers three questions in one call: what is connected and with what access, what a write on each surface actually does when it lands, and what CANNOT be done here and why. Run it with no arguments for every surface; name one surface to also get the exact fields every change on it accepts.",
+  args: {
+    surface: {
+      type: "positional",
+      description: `One of: ${CAPABILITY_SURFACES.join(" | ")}. Omit for all of them.`,
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include the field-level contract of every change on every surface",
+      required: false,
+      default: false
+    }
+  }
+});
+function capabilityHints(surfaces, tools = []) {
+  const hints = [];
+  const immediate = surfaces.filter((surface) => surface.writeMode === "applies-at-publish");
+  if (immediate.length > 0) {
+    hints.push(
+      `REAL AND IMMEDIATE: ${immediate.map((s) => s.label).join(", ")}. Completing this chat changes the user's live setup, so agree the changes before you finish, not after.`
+    );
+  }
+  const blocked = surfaces.filter((surface) => surface.blockers.length > 0);
+  if (blocked.length > 0) {
+    hints.push(`BLOCKED: ${blocked.flatMap((surface) => surface.blockers).join(" ")}`);
+  }
+  const limitCount = surfaces.reduce((total, surface) => total + surface.limits.length, 0);
+  if (limitCount > 0) {
+    hints.push(
+      `${limitCount} thing(s) listed under \`limits\` cannot be done at all. Read them before you plan the work \u2014 each one says what to tell the user instead. Do not try them and report the failure as a surprise.`
+    );
+  }
+  if (surfaces.length > 1) {
+    hints.push(
+      "Naming one surface (`baker capabilities google-ads`) adds `ops` \u2014 the exact fields and accepted values of every change there. Read that instead of guessing a field name."
+    );
+  }
+  const usable = tools.filter((tool) => tool.ready);
+  if (usable.length > 0) {
+    hints.push(
+      `ALSO AVAILABLE, and not on any surface above: ${usable.map((tool) => tool.label).join(", ")}. These answer WHY a page behaves as it does, which no surface here can. See \`tools[].reach\` for how to call each one.`
+    );
+  }
+  const broken = tools.filter((tool) => !tool.ready);
+  if (broken.length > 0) {
+    hints.push(
+      `CONNECTED BUT UNUSABLE: ${broken.map((tool) => `${tool.label} \u2014 ${tool.note ?? "not reachable"}`).join(" ")} Tell the user rather than planning around it silently.`
+    );
+  }
+  return hints;
+}
+var runCapabilities = defineCommand({
+  meta: {
+    name: "capabilities",
+    description: `What Baker can and cannot do for this company, before any work starts.
+
+Reports, per surface: what is connected and with what access, what a write there does when it lands, the entities that can be changed, and \u2014 the part nothing else tells you \u2014 what cannot be changed and why.
+
+Also returns \`tools\`: everything else this company can reach that is not one of those surfaces \u2014 Microsoft Clarity and any other MCP toolkit, custom servers, HubSpot. This is the one call that answers "what do I actually have".
+
+Examples:
+  baker capabilities
+  baker capabilities google-ads
+  baker capabilities tag-manager
+  baker capabilities --full
+
+Full guide: __tooling__/docs/tools/baker/capabilities.md`
+  },
+  args: {
+    surface: {
+      type: "positional",
+      description: `Narrow to one surface: ${CAPABILITY_SURFACES.join(" | ")}`,
+      required: false
+    },
+    full: {
+      type: "boolean",
+      description: "Include the field-level contract of every change on every surface",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const body = {};
+      const surface = args.surface;
+      if (surface) {
+        if (!CAPABILITY_SURFACES.includes(surface)) {
+          throw new Error(`"${surface}" is not a surface. Use one of: ${CAPABILITY_SURFACES.join(", ")}`);
+        }
+        body.surface = surface;
+      }
+      if (args.full) {
+        body.full = true;
+      }
+      const actingUserId = getEnv().BAKER_ACTING_USER_ID;
+      if (actingUserId) {
+        body.actingUserId = actingUserId;
+      }
+      const response = await apiPost("/api/capabilities", body);
+      const hints = capabilityHints(response.data.surfaces, response.data.tools);
+      writeJson({
+        ...response,
+        meta: { count: response.data.surfaces.length },
+        ...hints.length > 0 ? { hints } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var capabilitiesCommand = runCapabilities;
+export {
+  capabilitiesCommand,
+  capabilityHints
+};
+//# sourceMappingURL=capabilities-BEZXR2FZ.js.map

package/dist/cards-J2PGFKEF.js

@@ -0,0 +1,85 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-UPDIBQUC.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-HPDGVK6R.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/cards.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.cards",
+  description: "List website cards, video cards, and carousels for an X Ads account.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var cardsCommand = defineCommand({
+  meta: {
+    name: "cards",
+    description: `List X Ads cards (rich creatives).
+
+Examples:
+  baker ads x cards --account-id 18ce53xyz`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `cards:${accountId}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/cards", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 6 * 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  cardsCommand
+};
+//# sourceMappingURL=cards-J2PGFKEF.js.map

package/dist/catalog-XECCXRM6.js

@@ -0,0 +1,65 @@
+import {
+  catalogView,
+  defaultRegistry,
+  generateCatalog
+} from "./chunk-XGX2WOV2.js";
+import "./chunk-T6PTG6VM.js";
+import "./chunk-ILEJXJH2.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-LHQ6GXNF.js";
+import "./chunk-TRMZQRVV.js";
+import "./chunk-SDQLZYQG.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-6B4KNOJZ.js";
+import "./chunk-ZVXKWLLE.js";
+import "./chunk-EHIISZYD.js";
+import "./chunk-SWNCS2OD.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/catalog.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "The canvas node catalog. Start here: `baker canvas catalog` lists every node by category with one line each (a few KB). Then `--node video_generate` prints that node's full JSON Schema \u2014 params, inputs, outputs, models, when to use it. `--category image` narrows the list; add `--full` for that category's schemas. `--full` alone prints every schema (~160 KB) \u2014 prefer `--node`.";
+var ARGS = {
+  node: {
+    type: "string",
+    required: false,
+    description: "Node id(s) whose full schema to print, comma-separated. Example: --node video_generate,tts"
+  },
+  category: {
+    type: "string",
+    required: false,
+    description: "Only this category (audio, video, image, \u2026). Listed with one line per node unless --full."
+  },
+  full: {
+    type: "boolean",
+    required: false,
+    default: false,
+    description: "Print full JSON Schemas instead of the one-line index (every node, or the --category)."
+  }
+};
+registerSchema({ command: "canvas.catalog", description: DESCRIPTION, args: ARGS });
+var catalogCommand = defineCommand({
+  meta: { name: "catalog", description: DESCRIPTION },
+  args: ARGS,
+  async run({ args }) {
+    const view = catalogView(generateCatalog(defaultRegistry()), {
+      node: typeof args.node === "string" ? args.node : void 0,
+      category: typeof args.category === "string" ? args.category : void 0,
+      full: args.full === true
+    });
+    process.stdout.write(`${JSON.stringify(view, null, 2)}
+`);
+    if (!view.ok) process.exit(1);
+  }
+});
+export {
+  catalogCommand
+};
+//# sourceMappingURL=catalog-XECCXRM6.js.map

package/dist/catalogs-P5KMIMC2.js

@@ -0,0 +1,130 @@
+import {
+  failWriteValidation,
+  productFiltersArg,
+  schemaArgs
+} from "./chunk-T37PAZT2.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  chatgptAdsProductQuerySchema,
+  runChatgptListRead,
+  runChatgptRead
+} from "./chunk-SNDHR5QA.js";
+import "./chunk-HPDGVK6R.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiGet,
+  apiPost
+} from "./chunk-B4UVJCJ4.js";
+import "./chunk-AFQF6ISC.js";
+import "./chunk-52IYZCRS.js";
+import {
+  registerSchema
+} from "./chunk-FSGJSREN.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/catalogs.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.catalogs;
+registerSchema({
+  command: "ads.chatgpt.catalogs.list",
+  description: "The account's product catalogs: id (fd_\u2026), countries, and how many ad-eligible products each holds (0 while the first upload is processing).",
+  args: {}
+});
+var catalogsListCommand = defineCommand({
+  meta: { name: "list", description: "List the account's product catalogs." },
+  args: {},
+  run: async () => {
+    await runChatgptListRead(
+      REFERENCE,
+      "/api/ads/chatgpt/catalogs",
+      void 0,
+      (rows) => rows.length === 0 ? [
+        "No catalog. A catalog is created and filled in ChatGPT Ads Manager (or over its SFTP) from the company's product data \u2014 Baker does not upload products."
+      ] : ["A catalog campaign uses one: campaigns create --catalog-id fd_\u2026 --countries US \u2026"]
+    );
+  }
+});
+registerSchema({
+  command: "ads.chatgpt.catalogs.uploads",
+  description: "Each catalog's upload history: status (scanning, processing, completed, completed_with_errors, skipped, failed), rows accepted and rejected, and the problems ChatGPT Ads found.",
+  args: {}
+});
+var catalogsUploadsCommand = defineCommand({
+  meta: { name: "uploads", description: "How the catalogs' latest uploads went." },
+  args: {},
+  run: async () => {
+    await runChatgptRead(
+      REFERENCE,
+      () => apiGet("/api/ads/chatgpt/catalogs/uploads"),
+      (uploads) => uploads.some((upload) => upload.problems.length > 0 || upload.status === "failed") ? [
+        "Fix the rows named in problems in the source catalog and upload it again; Baker cannot edit catalog rows."
+      ] : []
+    );
+  }
+});
+var PRODUCTS_ARGS = {
+  "catalog-id": { type: "string", description: "The catalog (fd_\u2026)", required: true },
+  filters: {
+    type: "string",
+    description: "Conditions separated by ;, each field operator values \u2014 e.g. brand in Acme|Baker; price lte 5000. Operators: in, not_in, gt, gte, lt, lte, contains, not_contains, starts_with"
+  },
+  limit: { type: "string", description: "Products to show, 1-100 (default 20)" }
+};
+registerSchema({
+  command: "ads.chatgpt.catalogs.products",
+  description: "Preview the products a set of filters selects from a catalog \u2014 the same filters an ad group's --product-filters take. Check the match before staging them.",
+  args: schemaArgs(PRODUCTS_ARGS)
+});
+var catalogsProductsCommand = defineCommand({
+  meta: {
+    name: "products",
+    description: `Preview which products a set of filters selects.
+
+Examples:
+  baker ads chatgpt catalogs products --catalog-id fd_123
+  baker ads chatgpt catalogs products --catalog-id fd_123 --filters "brand in Acme; price lte 100"`
+  },
+  args: PRODUCTS_ARGS,
+  run: async ({ args }) => {
+    const parsed = chatgptAdsProductQuerySchema.safeParse({
+      catalogId: args["catalog-id"],
+      filters: productFiltersArg(args.filters) ?? [],
+      ...typeof args.limit === "string" && args.limit ? { limit: Number(args.limit) } : {}
+    });
+    if (!parsed.success) {
+      failWriteValidation(parsed.error.issues[0]?.message ?? "Invalid product query");
+    }
+    await runChatgptRead(
+      REFERENCE,
+      () => apiPost("/api/ads/chatgpt/catalogs/products", parsed.data),
+      (result) => [
+        ...result.matched === 0 ? [
+          "Nothing matches. Try without --filters: if that is empty too, the catalog's upload has not finished \u2014 see `catalogs uploads`."
+        ] : [],
+        ...result.products.some((product) => product.imageUrl === null) ? [
+          "Some products have no image yet (imageUrl null): ChatGPT Ads has not processed one, and a product ad shows the product's image \u2014 check the catalog's image links."
+        ] : []
+      ]
+    );
+  }
+});
+var catalogsCommand = defineCommand({
+  meta: {
+    name: "catalogs",
+    description: `Product catalogs for catalog campaigns \u2014 read them, check their uploads, preview products.
+
+Examples:
+  baker ads chatgpt catalogs
+  baker ads chatgpt catalogs uploads
+  baker ads chatgpt catalogs products --catalog-id fd_123 --filters "price lte 100"`
+  },
+  subCommands: { list: catalogsListCommand, uploads: catalogsUploadsCommand, products: catalogsProductsCommand },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: {},
+  default: "list"
+});
+export {
+  catalogsCommand
+};
+//# sourceMappingURL=catalogs-P5KMIMC2.js.map