@koda-sl/baker-cli 0.449.0 → 0.450.0-dev.b454c3dd2

package/dist/campaigns-6T3NSUT2.js

@@ -0,0 +1,110 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg,
+  resolveStatusFilter,
+  statusesArgDescription
+} from "./chunk-N4LAYIIN.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-VFIOJD5M.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-7EPXVICM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-HR6IWNKE.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiGet
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/campaigns.ts
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+  "account-urn": { type: "string", description: "Alias for --account-id" },
+  "campaign-group-id": { type: "string", description: "Filter by campaign group" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  statuses: { type: "string", description: statusesArgDescription("campaigns") },
+  limit: { type: "string", description: "Max rows (default: 500)" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+};
+var campaignsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List LinkedIn campaigns. Runs by default when no subcommand is given."
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      const statuses = resolveStatusFilter(args, "campaigns");
+      if (statuses) params.statuses = statuses.join(",");
+      if (args["campaign-group-id"]) params["campaign-group-id"] = String(args["campaign-group-id"]);
+      if (args.limit) params.limit = String(args.limit);
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/campaigns", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List LinkedIn campaigns, or stage writes (create/update/pause/resume/archive/duplicate).
+
+Default: ACTIVE only. The schema includes the audit-relevant settings:
+  audienceExpansionEnabled \u2014 playbook \xA702 silent budget drain (should be false)
+  offsiteDeliveryEnabled   \u2014 LinkedIn Audience Network gate
+  optimizationTargetType   \u2014 driver of the bidding strategy
+  costType                 \u2014 CPC | CPM | CPV | CPS
+
+Write subcommands stage ops on this chat's draft \u2014 they never hit the LinkedIn
+API directly and apply only when the chat is published.
+
+Examples:
+  baker ads linkedin campaigns --account-id 503001492
+  baker ads linkedin campaigns --account-id 503001492 --all-statuses --output csv
+  baker ads linkedin campaigns update 123456 --daily-budget 100 --currency EUR
+  baker ads linkedin campaigns pause 123456
+  baker ads linkedin campaigns url-params 123456 --param utm_source=linkedin   \u2014 UTMs for every ad in the ad set
+  baker ads linkedin campaigns exclude-companies 123456 --org 1035,1441        \u2014 stop reaching these companies`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsArchiveCommand),
+    duplicate: () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsDuplicateCommand),
+    "url-params": () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsUrlParamsCommand),
+    "exclude-companies": () => import("./write-commands-7SJ3BOW5.js").then((m) => m.campaignsExcludeCompaniesCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it *after* running
+  // the matched subcommand, so every write would also trigger a full live list.
+  // `args` stays here so citty's subcommand scan knows which flags take a value.
+  args: listArgs,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-6T3NSUT2.js.map

package/dist/campaigns-6T3NSUT2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/campaigns.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport {\n  csvOrJson,\n  handleLinkedinError,\n  resolveAccountIdArg,\n  resolveStatusFilter,\n  statusesArgDescription,\n} from \"./shared.ts\";\n\ninterface LinkedinCampaignRow {\n  id: string;\n  urn: string;\n  account: string;\n  campaignGroup?: string;\n  name?: string;\n  type?: string;\n  status?: string;\n  servingStatuses?: string[];\n  costType?: string;\n  objectiveType?: string;\n  optimizationTargetType?: string;\n  unitCost?: { amount?: string; currencyCode?: string };\n  dailyBudget?: { amount?: string; currencyCode?: string };\n  totalBudget?: { amount?: string; currencyCode?: string };\n  runSchedule?: { start?: number; end?: number };\n  audienceExpansionEnabled?: boolean;\n  offsiteDeliveryEnabled?: boolean;\n  format?: string;\n  test?: boolean;\n}\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Numeric account ID or urn:li:sponsoredAccount:N\" },\n  \"account-urn\": { type: \"string\", description: \"Alias for --account-id\" },\n  \"campaign-group-id\": { type: \"string\", description: \"Filter by campaign group\" },\n  \"all-statuses\": { type: \"boolean\", description: \"Drop the default ACTIVE filter\" },\n  statuses: { type: \"string\", description: statusesArgDescription(\"campaigns\") },\n  limit: { type: \"string\", description: \"Max rows (default: 500)\" },\n  \"no-cache\": NO_CACHE_ARG,\n  output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n} as const;\n\nconst campaignsListCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description: \"List LinkedIn campaigns. Runs by default when no subcommand is given.\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      const statuses = resolveStatusFilter(args, \"campaigns\");\n      if (statuses) params.statuses = statuses.join(\",\");\n      if (args[\"campaign-group-id\"]) params[\"campaign-group-id\"] = String(args[\"campaign-group-id\"]);\n      if (args.limit) params.limit = String(args.limit);\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n\n      const data = await apiGet<LinkedinCampaignRow[]>(\"/api/ads/linkedin/campaigns\", params);\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data as unknown as Array<Record<string, unknown>>, fmt);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n\nexport const campaignsCommand = defineCommand({\n  meta: {\n    name: \"campaigns\",\n    description: `List LinkedIn campaigns, or stage writes (create/update/pause/resume/archive/duplicate).\n\nDefault: ACTIVE only. The schema includes the audit-relevant settings:\n  audienceExpansionEnabled — playbook §02 silent budget drain (should be false)\n  offsiteDeliveryEnabled   — LinkedIn Audience Network gate\n  optimizationTargetType   — driver of the bidding strategy\n  costType                 — CPC | CPM | CPV | CPS\n\nWrite subcommands stage ops on this chat's draft — they never hit the LinkedIn\nAPI directly and apply only when the chat is published.\n\nExamples:\n  baker ads linkedin campaigns --account-id 503001492\n  baker ads linkedin campaigns --account-id 503001492 --all-statuses --output csv\n  baker ads linkedin campaigns update 123456 --daily-budget 100 --currency EUR\n  baker ads linkedin campaigns pause 123456\n  baker ads linkedin campaigns url-params 123456 --param utm_source=linkedin   — UTMs for every ad in the ad set\n  baker ads linkedin campaigns exclude-companies 123456 --org 1035,1441        — stop reaching these companies`,\n  },\n  subCommands: {\n    list: campaignsListCommand,\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    duplicate: () => import(\"./write-commands.ts\").then((m) => m.campaignsDuplicateCommand),\n    \"url-params\": () => import(\"./write-commands.ts\").then((m) => m.campaignsUrlParamsCommand),\n    \"exclude-companies\": () => import(\"./write-commands.ts\").then((m) => m.campaignsExcludeCompaniesCommand),\n  },\n  // A parent must never declare `run`: citty falls through to it *after* running\n  // the matched subcommand, so every write would also trigger a full live list.\n  // `args` stays here so citty's subcommand scan knows which flags take a value.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAkC9B,IAAM,WAAW;AAAA,EACf,cAAc,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,EAC/F,eAAe,EAAE,MAAM,UAAU,aAAa,yBAAyB;AAAA,EACvE,qBAAqB,EAAE,MAAM,UAAU,aAAa,2BAA2B;AAAA,EAC/E,gBAAgB,EAAE,MAAM,WAAW,aAAa,iCAAiC;AAAA,EACjF,UAAU,EAAE,MAAM,UAAU,aAAa,uBAAuB,WAAW,EAAE;AAAA,EAC7E,OAAO,EAAE,MAAM,UAAU,aAAa,0BAA0B;AAAA,EAChE,YAAY;AAAA,EACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,qBAAqB,SAAS,OAAO;AAC9E;AAEA,IAAM,uBAAuB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,YAAM,WAAW,oBAAoB,MAAM,WAAW;AACtD,UAAI,SAAU,QAAO,WAAW,SAAS,KAAK,GAAG;AACjD,UAAI,KAAK,mBAAmB,EAAG,QAAO,mBAAmB,IAAI,OAAO,KAAK,mBAAmB,CAAC;AAC7F,UAAI,KAAK,MAAO,QAAO,QAAQ,OAAO,KAAK,KAAK;AAChD,UAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAE7C,YAAM,OAAO,MAAM,OAA8B,+BAA+B,MAAM;AACtF,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,MAAmD,GAAG;AACrE;AAAA,MACF;AACA,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;AAEM,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBf;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChF,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChF,OAAO,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,qBAAqB;AAAA,IAC9E,QAAQ,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,sBAAsB;AAAA,IAChF,SAAS,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,uBAAuB;AAAA,IAClF,WAAW,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,yBAAyB;AAAA,IACtF,cAAc,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,yBAAyB;AAAA,IACzF,qBAAqB,MAAM,OAAO,8BAAqB,EAAE,KAAK,CAAC,MAAM,EAAE,gCAAgC;AAAA,EACzG;AAAA;AAAA;AAAA;AAAA,EAIA,MAAM;AAAA,EACN,SAAS;AACX,CAAC;","names":[]}

package/dist/campaigns-OYMXDGWX.js

@@ -0,0 +1,107 @@
+import {
+  runListCommand
+} from "./chunk-5Z2KSVIV.js";
+import "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-C6U6UDHJ.js";
+import "./chunk-VFIOJD5M.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/campaigns.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.campaigns",
+  description: "List campaigns for an X Ads account. Optionally filter by funding-instrument-ids or campaign-ids (comma-separated). Includes deleted with --with-deleted. Falls back to BAKER_X_ADS_ACCOUNT_ID.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted campaigns", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var listArgs = {
+  "account-id": { type: "string", description: "X Ads account ID" },
+  "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs" },
+  "campaign-ids": { type: "string", description: "CSV of campaign IDs" },
+  "with-deleted": { type: "boolean", description: "Include deleted" },
+  "no-cache": { type: "boolean", description: "Skip cache" },
+  output: { type: "string", description: "Format: json|csv|md", default: "json" }
+};
+var campaignsListCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `List X Ads campaigns. Returns budget, schedule, funding instrument, status.
+
+Examples:
+  baker ads x campaigns --account-id 18ce53xyz
+  baker ads x campaigns --account-id 18ce53xyz --campaign-ids abc,def
+  baker ads x campaigns --account-id 18ce53xyz --with-deleted`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "funding-instrument-ids": { type: "string", description: "CSV of funding instrument IDs", required: false },
+    "campaign-ids": { type: "string", description: "CSV of campaign IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", 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 today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const cacheKey = `campaigns:${accountId}:${today}:${args["funding-instrument-ids"] ?? ""}:${args["campaign-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    await runListCommand({
+      path: "/api/ads/x/campaigns",
+      cacheCategory: "x-account-data",
+      cacheKey,
+      cacheTtlMs: 60 * 60 * 1e3,
+      params: {
+        "account-id": accountId,
+        "funding-instrument-ids": args["funding-instrument-ids"],
+        "campaign-ids": args["campaign-ids"],
+        "with-deleted": args["with-deleted"] ? "true" : void 0
+      },
+      format: args.output || "json",
+      accountId,
+      useCache
+    });
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `X Ads campaigns \u2014 read them, or stage a change that applies when the chat is published.
+
+Write subcommands stage ops on this chat's draft. They never call X directly.
+
+Examples:
+  baker ads x campaigns
+  baker ads x campaigns create --name "Spring" --funding-instrument-id vtbot --daily-budget 5
+  baker ads x campaigns update oilf0 --daily-budget 20
+  baker ads x campaigns pause oilf0,omyq3`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./campaign-writes-5OVLUD5E.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-5OVLUD5E.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-5OVLUD5E.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-5OVLUD5E.js").then((m) => m.campaignsResumeCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it AFTER the
+  // matched subcommand, so every write would also trigger a full live list.
+  args: listArgs,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-OYMXDGWX.js.map

package/dist/campaigns-YS3OGQXO.js

@@ -0,0 +1,76 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-FTWJFDIN.js";
+import "./chunk-VFIOJD5M.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/campaigns.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.chatgpt.campaigns",
+  description: "Every campaign in the connected ChatGPT Ads account: status, objective, daily or lifetime budget (currency units), schedule, locations, platforms, and the serving issues ChatGPT Ads reports for it.",
+  args: {
+    full: { type: "boolean", description: "Return ChatGPT Ads' own campaign objects", required: false }
+  }
+});
+var LIST_ARGS = {
+  full: { type: "boolean", description: "Return ChatGPT Ads' own campaign objects", required: false }
+};
+function campaignHints(campaigns) {
+  if (campaigns.length === 0) {
+    return ["This account has no campaigns yet."];
+  }
+  const blocked = campaigns.filter((campaign) => campaign.servingIssues.length > 0);
+  return blocked.length > 0 ? [
+    `${blocked.length} campaign(s) report serving issues. Read servingIssues before changing a bid or budget \u2014 a higher bid does not fix a paused parent, a spent budget or a rejected ad.`
+  ] : [];
+}
+var campaignsListCommand = defineCommand({
+  meta: { name: "list", description: "ChatGPT Ads campaigns, newest first. Example: baker ads chatgpt campaigns" },
+  args: LIST_ARGS,
+  run: async ({ args }) => {
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.campaigns,
+      "/api/ads/chatgpt/campaigns",
+      args.full ? { full: "true" } : void 0,
+      (campaigns) => args.full ? [] : campaignHints(campaigns)
+    );
+  }
+});
+var campaignsCommand = defineCommand({
+  meta: {
+    name: "campaigns",
+    description: `ChatGPT Ads campaigns \u2014 read them with why each one is or is not serving, or stage a change that applies when the chat is published.
+
+Write subcommands stage changes on this chat's draft. They never call ChatGPT Ads directly.
+
+Examples:
+  baker ads chatgpt campaigns
+  baker ads chatgpt campaigns create --name "Spring push" --objective clicks --daily-budget 20 --countries ES
+  baker ads chatgpt campaigns update cmpn_123 --daily-budget 35
+  baker ads chatgpt campaigns pause cmpn_123,cmpn_456`
+  },
+  subCommands: {
+    list: campaignsListCommand,
+    create: () => import("./campaign-writes-SXLZFYF6.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./campaign-writes-SXLZFYF6.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./campaign-writes-SXLZFYF6.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./campaign-writes-SXLZFYF6.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./campaign-writes-SXLZFYF6.js").then((m) => m.campaignsArchiveCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the
+  // matched subcommand, so every write would also trigger a live list.
+  args: LIST_ARGS,
+  default: "list"
+});
+export {
+  campaignsCommand
+};
+//# sourceMappingURL=campaigns-YS3OGQXO.js.map

package/dist/canvas-YQFG52IG.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_ or bkr_) + 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-EUO34T2J.js").then((m) => m.runCommand),
+    rerun: () => import("./rerun-PZK275DY.js").then((m) => m.rerunCommand),
+    validate: () => import("./validate-7YPOUKPB.js").then((m) => m.validateCommand),
+    critique: () => import("./critique-GS5VV5ZC.js").then((m) => m.critiqueCommand),
+    "viewer-check": () => import("./viewer-check-L4B4LIAX.js").then((m) => m.viewerCheckCommand),
+    catalog: () => import("./catalog-XLXIM7IW.js").then((m) => m.catalogCommand),
+    inspect: () => import("./inspect-4OOS4APT.js").then((m) => m.inspectCommand),
+    "scaffold-ad": () => import("./scaffold-ad-SW2HEWM3.js").then((m) => m.scaffoldAdCommand),
+    "scaffold-video": () => import("./scaffold-video-EI7U7RBK.js").then((m) => m.scaffoldVideoCommand),
+    "scaffold-static-ad": () => import("./scaffold-static-ad-ECTJL54Y.js").then((m) => m.scaffoldStaticAdCommand),
+    "set-prompt": () => import("./set-prompt-2HASHGWC.js").then((m) => m.setPromptCommand),
+    "sync-definition": () => import("./sync-definition-QR2N233R.js").then((m) => m.syncDefinitionCommand),
+    stale: () => import("./stale-W756ACKC.js").then((m) => m.staleCommand)
+  }
+});
+export {
+  canvasCommand
+};
+//# sourceMappingURL=canvas-YQFG52IG.js.map

package/dist/capabilities-PXBKUN2G.js

@@ -0,0 +1,145 @@
+import {
+  failApi
+} from "./chunk-SJYEY5MV.js";
+import "./chunk-7EPXVICM.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-TEINLN64.js";
+import {
+  CAPABILITY_SURFACES
+} from "./chunk-ZJWUBJYQ.js";
+import "./chunk-HR6IWNKE.js";
+import "./chunk-NE4F3FHN.js";
+import {
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import {
+  getEnv
+} from "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.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-PXBKUN2G.js.map

package/dist/capabilities-PXBKUN2G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/capabilities/index.ts"],"sourcesContent":["import {\n  CAPABILITY_SURFACES,\n  type CapabilitiesResponse,\n  type CapabilitySurfaceReport,\n  type CapabilityTool,\n} from \"@baker/api/capabilities\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"../actions/shared.ts\";\n\nregisterSchema({\n  command: \"capabilities\",\n  description:\n    \"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.\",\n  args: {\n    surface: {\n      type: \"positional\",\n      description: `One of: ${CAPABILITY_SURFACES.join(\" | \")}. Omit for all of them.`,\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Include the field-level contract of every change on every surface\",\n      required: false,\n      default: false,\n    },\n  },\n});\n\n/**\n * What the agent must not miss even if it skims the payload.\n *\n * Every line here comes from a real session that went wrong: a Tag Manager\n * change described as a draft when it was about to go live, work promised on a\n * read-only surface, an ad change called a preview after it had already spent.\n */\nexport function capabilityHints(surfaces: CapabilitySurfaceReport[], tools: CapabilityTool[] = []): string[] {\n  const hints: string[] = [];\n\n  const immediate = surfaces.filter((surface) => surface.writeMode === \"applies-at-publish\");\n  if (immediate.length > 0) {\n    hints.push(\n      `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.`,\n    );\n  }\n\n  const blocked = surfaces.filter((surface) => surface.blockers.length > 0);\n  if (blocked.length > 0) {\n    hints.push(`BLOCKED: ${blocked.flatMap((surface) => surface.blockers).join(\" \")}`);\n  }\n\n  const limitCount = surfaces.reduce((total, surface) => total + surface.limits.length, 0);\n  if (limitCount > 0) {\n    hints.push(\n      `${limitCount} thing(s) listed under \\`limits\\` cannot be done at all. Read them before you plan the work — each one says what to tell the user instead. Do not try them and report the failure as a surprise.`,\n    );\n  }\n\n  if (surfaces.length > 1) {\n    hints.push(\n      \"Naming one surface (`baker capabilities google-ads`) adds `ops` — the exact fields and accepted values of every change there. Read that instead of guessing a field name.\",\n    );\n  }\n\n  // The whole reason `tools` exists. An agent that read only `surfaces` used to\n  // conclude a company had no session-recording tool while Microsoft Clarity\n  // sat in its own tool list — and that is the source most likely to change\n  // what it decides about a page.\n  const usable = tools.filter((tool) => tool.ready);\n  if (usable.length > 0) {\n    hints.push(\n      `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.`,\n    );\n  }\n\n  const broken = tools.filter((tool) => !tool.ready);\n  if (broken.length > 0) {\n    hints.push(\n      `CONNECTED BUT UNUSABLE: ${broken.map((tool) => `${tool.label} — ${tool.note ?? \"not reachable\"}`).join(\" \")} Tell the user rather than planning around it silently.`,\n    );\n  }\n\n  return hints;\n}\n\nconst runCapabilities = defineCommand({\n  meta: {\n    name: \"capabilities\",\n    description: `What Baker can and cannot do for this company, before any work starts.\n\nReports, per surface: what is connected and with what access, what a write there does when it lands, the entities that can be changed, and — the part nothing else tells you — what cannot be changed and why.\n\nAlso returns \\`tools\\`: everything else this company can reach that is not one of those surfaces — Microsoft Clarity and any other MCP toolkit, custom servers, HubSpot. This is the one call that answers \"what do I actually have\".\n\nExamples:\n  baker capabilities\n  baker capabilities google-ads\n  baker capabilities tag-manager\n  baker capabilities --full\n\nFull guide: __tooling__/docs/tools/baker/capabilities.md`,\n  },\n  args: {\n    surface: {\n      type: \"positional\",\n      description: `Narrow to one surface: ${CAPABILITY_SURFACES.join(\" | \")}`,\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Include the field-level contract of every change on every surface\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const body: Record<string, unknown> = {};\n      const surface = args.surface as string | undefined;\n      if (surface) {\n        if (!(CAPABILITY_SURFACES as readonly string[]).includes(surface)) {\n          throw new Error(`\"${surface}\" is not a surface. Use one of: ${CAPABILITY_SURFACES.join(\", \")}`);\n        }\n        body.surface = surface;\n      }\n      if (args.full) {\n        body.full = true;\n      }\n      // Who this chat acts as: their own connected tools load with it — a\n      // personal inbox in a scheduled run of theirs — and are listed with it.\n      const actingUserId = getEnv().BAKER_ACTING_USER_ID;\n      if (actingUserId) {\n        body.actingUserId = actingUserId;\n      }\n      const response = await apiPost<CapabilitiesResponse>(\"/api/capabilities\", body);\n      const hints = capabilityHints(response.data.surfaces, response.data.tools);\n      writeJson({\n        ...response,\n        meta: { count: response.data.surfaces.length },\n        ...(hints.length > 0 ? { hints } : {}),\n      });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nexport const capabilitiesCommand = runCapabilities;\n"],"mappings":"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","names":[]}

package/dist/catalog-XLXIM7IW.js

@@ -0,0 +1,65 @@
+import {
+  catalogView,
+  defaultRegistry,
+  generateCatalog
+} from "./chunk-LYQJ4PZW.js";
+import "./chunk-FPOGPFAG.js";
+import "./chunk-NCWCZY5P.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-W3B4BHQU.js";
+import "./chunk-PZXCWSKV.js";
+import "./chunk-CAMX6OHF.js";
+import "./chunk-RX6F3GEA.js";
+import "./chunk-5HYSKH77.js";
+import "./chunk-KIGGMKAE.js";
+import "./chunk-VAJBWA2U.js";
+import "./chunk-HRYOZUSK.js";
+import "./chunk-VVZBBKRC.js";
+import "./chunk-YBMVHGY3.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.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-XLXIM7IW.js.map