@koda-sl/baker-cli 0.386.0 → 0.387.0-dev.3bafd569e

package/dist/media-RAGEJTZX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/media.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { ApiError, apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { cacheGet, cacheSet } from \"../cache.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { parseXApiError } from \"./error-parser.ts\";\nimport { resolveXAccountId } from \"./output.ts\";\n\nregisterSchema({\n  command: \"ads.x.media\",\n  description:\n    \"List media assets in the X Ads media library (images, GIFs, videos). Filter by media-type (IMAGE, GIF, VIDEO).\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"media-type\": { type: \"string\", description: \"IMAGE | GIF | VIDEO\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md\", required: false, default: \"json\" },\n  },\n});\n\nexport const mediaCommand = defineCommand({\n  meta: {\n    name: \"media\",\n    description: `List media assets in the X Ads media library.\n\nExamples:\n  baker ads x media --account-id 18ce53xyz\n  baker ads x media --account-id 18ce53xyz --media-type VIDEO`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"media-type\": { type: \"string\", description: \"IMAGE | GIF | VIDEO\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md\", required: false, default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await resolveXAccountId(args);\n    const useCache = !args[\"no-cache\"];\n    const cacheKey = `media:${accountId}:${args[\"media-type\"] ?? \"ALL\"}`;\n\n    if (useCache) {\n      const cached = cacheGet<unknown[]>(\"x-account-data\", cacheKey);\n      if (cached) {\n        writeAdsJson({ ok: true, data: cached.data, cached: true });\n        return;\n      }\n    }\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"media-type\"]) params[\"media-type\"] = args[\"media-type\"] as string;\n      if (!useCache) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<unknown[]>(\"/api/ads/x/media-library\", params);\n      if (useCache) {\n        cacheSet(\"x-account-data\", cacheKey, data, 6 * 60 * 60 * 1000);\n      }\n      const format = (args.output as string) || \"json\";\n      if (format !== \"json\") {\n        writeAdsOutput(data as Array<Record<string, unknown>>, format);\n        return;\n      }\n      writeAdsJson({ ok: true, data });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeAdsJson(parseXApiError(err.message, accountId));\n        process.exit(1);\n      }\n      writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAQ9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,oBAAoB,UAAU,MAAM;AAAA,IACjF,cAAc,EAAE,MAAM,UAAU,aAAa,uBAAuB,UAAU,MAAM;AAAA,IACpF,YAAY,EAAE,MAAM,WAAW,aAAa,cAAc,UAAU,MAAM;AAAA,IAC1E,QAAQ,EAAE,MAAM,UAAU,aAAa,uBAAuB,UAAU,OAAO,SAAS,OAAO;AAAA,EACjG;AACF,CAAC;AAEM,IAAM,eAAe,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,oBAAoB,UAAU,MAAM;AAAA,IACjF,cAAc,EAAE,MAAM,UAAU,aAAa,uBAAuB,UAAU,MAAM;AAAA,IACpF,YAAY,EAAE,MAAM,WAAW,aAAa,cAAc,UAAU,MAAM;AAAA,IAC1E,QAAQ,EAAE,MAAM,UAAU,aAAa,uBAAuB,UAAU,OAAO,SAAS,OAAO;AAAA,EACjG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,YAAY,MAAM,kBAAkB,IAAI;AAC9C,UAAM,WAAW,CAAC,KAAK,UAAU;AACjC,UAAM,WAAW,SAAS,SAAS,IAAI,KAAK,YAAY,KAAK,KAAK;AAElE,QAAI,UAAU;AACZ,YAAM,SAAS,SAAoB,kBAAkB,QAAQ;AAC7D,UAAI,QAAQ;AACV,qBAAa,EAAE,IAAI,MAAM,MAAM,OAAO,MAAM,QAAQ,KAAK,CAAC;AAC1D;AAAA,MACF;AAAA,IACF;AACA,QAAI;AACF,YAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,UAAI,KAAK,YAAY,EAAG,QAAO,YAAY,IAAI,KAAK,YAAY;AAChE,UAAI,CAAC,SAAU,QAAO,YAAY,IAAI;AACtC,YAAM,OAAO,MAAM,OAAkB,4BAA4B,MAAM;AACvE,UAAI,UAAU;AACZ,iBAAS,kBAAkB,UAAU,MAAM,IAAI,KAAK,KAAK,GAAI;AAAA,MAC/D;AACA,YAAM,SAAU,KAAK,UAAqB;AAC1C,UAAI,WAAW,QAAQ;AACrB,uBAAe,MAAwC,MAAM;AAC7D;AAAA,MACF;AACA,mBAAa,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACjC,SAAS,KAAK;AACZ,UAAI,eAAe,UAAU;AAC3B,qBAAa,eAAe,IAAI,SAAS,SAAS,CAAC;AACnD,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,mBAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,iBAAiB,SAAS,mBAAmB,EAAE,CAAC;AACzF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/media-sources-GSPAV7HT.js

@@ -0,0 +1,32 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/index.ts
+import { defineCommand } from "citty";
+var mediaSourcesCommand = defineCommand({
+  meta: {
+    name: "media-sources",
+    description: `Connect social accounts whose images and videos fill the libraries: Instagram, TikTok, YouTube (videos), LinkedIn company pages, Facebook pages. A Google Drive folder is picked by the user in the chat (request_connection, platform google-drive, choose media-folder), never added here; once connected, list, sync, schedule and remove manage it like any source. Subcommands: add, list, sync, schedule, reset, remove.
+
+Examples:
+  baker media-sources add https://www.tiktok.com/@acme
+  baker media-sources add @acme --platform instagram --every daily
+  baker media-sources list
+  baker media-sources sync youtube:acme
+  baker media-sources schedule linkedin:acme --every monthly
+  baker media-sources reset instagram:acme        # unstick an import that never finished
+  baker media-sources remove facebook:acme
+Full guide: __tooling__/docs/tools/baker/media-sources.md`
+  },
+  subCommands: {
+    add: () => import("./add-TGQIVVXH.js").then((m) => m.addCommand),
+    list: () => import("./list-GTOSN7DP.js").then((m) => m.listCommand),
+    sync: () => import("./sync-455DB46Y.js").then((m) => m.syncCommand),
+    schedule: () => import("./schedule-KQ7UIR3N.js").then((m) => m.scheduleCommand),
+    reset: () => import("./reset-HTD6LCIT.js").then((m) => m.resetCommand),
+    remove: () => import("./remove-GOYW2G4R.js").then((m) => m.removeCommand)
+  }
+});
+export {
+  mediaSourcesCommand
+};
+//# sourceMappingURL=media-sources-GSPAV7HT.js.map

package/dist/media-sources-GSPAV7HT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/media-sources/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const mediaSourcesCommand = defineCommand({\n  meta: {\n    name: \"media-sources\",\n    description: `Connect social accounts whose images and videos fill the libraries: Instagram, TikTok, YouTube (videos), LinkedIn company pages, Facebook pages. A Google Drive folder is picked by the user in the chat (request_connection, platform google-drive, choose media-folder), never added here; once connected, list, sync, schedule and remove manage it like any source. Subcommands: add, list, sync, schedule, reset, remove.\n\nExamples:\n  baker media-sources add https://www.tiktok.com/@acme\n  baker media-sources add @acme --platform instagram --every daily\n  baker media-sources list\n  baker media-sources sync youtube:acme\n  baker media-sources schedule linkedin:acme --every monthly\n  baker media-sources reset instagram:acme        # unstick an import that never finished\n  baker media-sources remove facebook:acme\nFull guide: __tooling__/docs/tools/baker/media-sources.md`,\n  },\n  subCommands: {\n    add: () => import(\"./add.ts\").then((m) => m.addCommand),\n    list: () => import(\"./list.ts\").then((m) => m.listCommand),\n    sync: () => import(\"./sync.ts\").then((m) => m.syncCommand),\n    schedule: () => import(\"./schedule.ts\").then((m) => m.scheduleCommand),\n    reset: () => import(\"./reset.ts\").then((m) => m.resetCommand),\n    remove: () => import(\"./remove.ts\").then((m) => m.removeCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,sBAAsB,cAAc;AAAA,EAC/C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWf;AAAA,EACA,aAAa;AAAA,IACX,KAAK,MAAM,OAAO,mBAAU,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;AAAA,IACtD,MAAM,MAAM,OAAO,oBAAW,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW;AAAA,IACzD,MAAM,MAAM,OAAO,oBAAW,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW;AAAA,IACzD,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,IAC5D,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,EACjE;AACF,CAAC;","names":[]}

package/dist/members-GUUVEK2Y.js

@@ -0,0 +1,44 @@
+import {
+  failApi
+} from "./chunk-7THBBTJJ.js";
+import "./chunk-SMIENBNX.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-XX6ZMCY5.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/members.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.members",
+  description: "The teammates a Task can be assigned to \u2014 everyone with access to this company that the person behind this chat can see, as { userId, name, email, role }. Pass a userId or email from here to `baker actions assign --to`. Read-only.",
+  args: {}
+});
+var membersCommand = defineCommand({
+  meta: {
+    name: "members",
+    description: "Teammates a Task can be assigned to. Example: baker actions members"
+  },
+  run: async () => {
+    try {
+      const response = await apiPost("/api/actions/members", {});
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  membersCommand
+};
+//# sourceMappingURL=members-GUUVEK2Y.js.map

package/dist/members-GUUVEK2Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/actions/members.ts"],"sourcesContent":["import type { ActionsMembersResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"actions.members\",\n  description:\n    \"The teammates a Task can be assigned to — everyone with access to this company that the person behind this chat can see, as { userId, name, email, role }. Pass a userId or email from here to `baker actions assign --to`. Read-only.\",\n  args: {},\n});\n\nexport const membersCommand = defineCommand({\n  meta: {\n    name: \"members\",\n    description: \"Teammates a Task can be assigned to. Example: baker actions members\",\n  },\n  run: async () => {\n    try {\n      const response = await apiPost<ActionsMembersResponse>(\"/api/actions/members\", {});\n      writeJson(response);\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,CAAC;AACT,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,KAAK,YAAY;AACf,QAAI;AACF,YAAM,WAAW,MAAM,QAAgC,wBAAwB,CAAC,CAAC;AACjF,gBAAU,QAAQ;AAAA,IACpB,SAAS,KAAK;AACZ,cAAQ,GAAG;AAAA,IACb;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/meta-Z37ZR3PJ.js

@@ -0,0 +1,69 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/index.ts
+import { defineCommand } from "citty";
+var metaCommand = defineCommand({
+  meta: {
+    name: "meta",
+    description: `Meta Marketing API \u2014 AI-first command surface (Facebook + Instagram ads).
+
+Discovery:
+  baker ads meta accounts                                \u2014 accounts in this company's connected scope
+  baker ads meta businesses                              \u2014 Business Manager IDs
+  baker ads meta pages                                   \u2014 Facebook Pages the selected ad accounts can promote (an ad's identity)
+  baker ads meta lead-forms --page-id 100635183117758    \u2014 instant (lead) forms on a Page, with lead counts
+  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json \u2014 stage a new form
+  baker ads meta leads --form-id 987654321               \u2014 the leads one form collected (contact details masked)
+
+Snapshot a running account (default = ACTIVE only):
+  baker ads meta campaigns --account-id act_123
+  baker ads meta adsets --campaign-id 6123
+  baker ads meta ads --adset-id 6123
+  baker ads meta campaigns --account-id act_123 --all-statuses        \u2014 include paused, archived
+
+Drill in:
+  baker ads meta account --account-id act_123                         \u2014 currency, balance, business
+  baker ads meta creatives --creative-id 9988                         \u2014 single creative detail
+  baker ads meta audiences --account-id act_123
+  baker ads meta custom-conversions --account-id act_123              \u2014 the marketer's own conversions ("my conversions")
+  baker ads meta pixels --account-id act_123                          \u2014 pixel list
+  baker ads meta pixels --pixel-id 9988 --stats --days 7              \u2014 firing health
+
+Performance (the workhorse):
+  baker ads meta insights --object act_123                                                    \u2014 defaults: level=account, intent=baseline, last_7d
+  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d
+  baker ads meta insights --object act_123 --level ad --intent ranking                        \u2014 flag creatives to refresh
+  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  \u2014 placement \xD7 age
+  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   \u2014 auto-async
+  baker ads meta insights --list-intents
+
+Audit & review:
+  baker ads meta activities --account-id act_123 --days 14
+  baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html
+Full guide: __tooling__/docs/tools/baker/ads-meta.md`
+  },
+  subCommands: {
+    accounts: () => import("./accounts-RYBDLQ6H.js").then((m) => m.accountsCommand),
+    account: () => import("./account-CLOKMTTC.js").then((m) => m.accountCommand),
+    businesses: () => import("./businesses-J7OP7MSK.js").then((m) => m.businessesCommand),
+    pages: () => import("./pages-FQ4CBAJ2.js").then((m) => m.pagesCommand),
+    "lead-forms": () => import("./leads-TPB5OFSQ.js").then((m) => m.leadFormsCommand),
+    leads: () => import("./leads-TPB5OFSQ.js").then((m) => m.leadsCommand),
+    campaigns: () => import("./campaigns-R4DXIR2Q.js").then((m) => m.campaignsCommand),
+    adsets: () => import("./adsets-AKR75THA.js").then((m) => m.adsetsCommand),
+    ads: () => import("./ads-XZCMSPM5.js").then((m) => m.adsListCommand),
+    creatives: () => import("./creatives-VMGY5SU4.js").then((m) => m.creativesCommand),
+    audiences: () => import("./audiences-NYGMBGQ3.js").then((m) => m.audiencesCommand),
+    "custom-conversions": () => import("./custom-conversions-FABS6YVT.js").then((m) => m.customConversionsCommand),
+    pixels: () => import("./pixels-CTJ43FZ4.js").then((m) => m.pixelsCommand),
+    activities: () => import("./activities-ESBF3GFS.js").then((m) => m.activitiesCommand),
+    insights: () => import("./insights-XCA4BUJW.js").then((m) => m.insightsCommand),
+    preview: () => import("./preview-5ROBOQG7.js").then((m) => m.previewCommand),
+    media: () => import("./media-JBCN6V4X.js").then((m) => m.metaMediaCommand),
+    draft: () => import("./draft-KLULNBWP.js").then((m) => m.metaDraftCommand)
+  }
+});
+export {
+  metaCommand
+};
+//# sourceMappingURL=meta-Z37ZR3PJ.js.map

package/dist/meta-Z37ZR3PJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\n/**\n * Meta Ads command surface — curated for AI agents, not 1:1 with the Marketing API.\n *\n * The HTTP backend exposes more endpoints (catalogs, studies, ad-images, labels,\n * high-demand-periods, currency lookup). They're intentionally not surfaced as\n * CLI commands because AI agents rarely need them in isolation. Hit them via\n * curl against the API if you need them.\n *\n * Default behaviors that matter:\n *   - Listings (campaigns/adsets/ads) filter to ACTIVE — pass --all-statuses to widen.\n *   - Insights filter out non-delivered rows (impressions=0) and sort by spend desc.\n *   - Insights pick a smart field bundle via --intent (baseline|revenue|funnel|ranking|video|identity).\n *   - Heavy insights queries auto-fall to async (poll loop hidden).\n *   - Attribution defaults to 7d_click,1d_view — the only windows still working as of Jan 2026.\n */\nexport const metaCommand = defineCommand({\n  meta: {\n    name: \"meta\",\n    description: `Meta Marketing API — AI-first command surface (Facebook + Instagram ads).\n\nDiscovery:\n  baker ads meta accounts                                — accounts in this company's connected scope\n  baker ads meta businesses                              — Business Manager IDs\n  baker ads meta pages                                   — Facebook Pages the selected ad accounts can promote (an ad's identity)\n  baker ads meta lead-forms --page-id 100635183117758    — instant (lead) forms on a Page, with lead counts\n  baker ads meta lead-forms create --account-id act_123 --page-id 555 --file form.json — stage a new form\n  baker ads meta leads --form-id 987654321               — the leads one form collected (contact details masked)\n\nSnapshot a running account (default = ACTIVE only):\n  baker ads meta campaigns --account-id act_123\n  baker ads meta adsets --campaign-id 6123\n  baker ads meta ads --adset-id 6123\n  baker ads meta campaigns --account-id act_123 --all-statuses        — include paused, archived\n\nDrill in:\n  baker ads meta account --account-id act_123                         — currency, balance, business\n  baker ads meta creatives --creative-id 9988                         — single creative detail\n  baker ads meta audiences --account-id act_123\n  baker ads meta custom-conversions --account-id act_123              — the marketer's own conversions (\"my conversions\")\n  baker ads meta pixels --account-id act_123                          — pixel list\n  baker ads meta pixels --pixel-id 9988 --stats --days 7              — firing health\n\nPerformance (the workhorse):\n  baker ads meta insights --object act_123                                                    — defaults: level=account, intent=baseline, last_7d\n  baker ads meta insights --object act_123 --intent revenue --date-preset last_28d\n  baker ads meta insights --object act_123 --level ad --intent ranking                        — flag creatives to refresh\n  baker ads meta insights --object act_123 --level adset --breakdowns publisher_platform,age  — placement × age\n  baker ads meta insights --object act_123 --level ad --since 2026-01-01 --until 2026-03-31   — auto-async\n  baker ads meta insights --list-intents\n\nAudit & review:\n  baker ads meta activities --account-id act_123 --days 14\n  baker ads meta preview --creative-id 9988 --ad-format MOBILE_FEED_STANDARD --out-file /tmp/p.html\nFull guide: __tooling__/docs/tools/baker/ads-meta.md`,\n  },\n  subCommands: {\n    accounts: () => import(\"./accounts.ts\").then((m) => m.accountsCommand),\n    account: () => import(\"./account.ts\").then((m) => m.accountCommand),\n    businesses: () => import(\"./businesses.ts\").then((m) => m.businessesCommand),\n    pages: () => import(\"./pages.ts\").then((m) => m.pagesCommand),\n    \"lead-forms\": () => import(\"./leads.ts\").then((m) => m.leadFormsCommand),\n    leads: () => import(\"./leads.ts\").then((m) => m.leadsCommand),\n    campaigns: () => import(\"./campaigns.ts\").then((m) => m.campaignsCommand),\n    adsets: () => import(\"./adsets.ts\").then((m) => m.adsetsCommand),\n    ads: () => import(\"./ads.ts\").then((m) => m.adsListCommand),\n    creatives: () => import(\"./creatives.ts\").then((m) => m.creativesCommand),\n    audiences: () => import(\"./audiences.ts\").then((m) => m.audiencesCommand),\n    \"custom-conversions\": () => import(\"./custom-conversions.ts\").then((m) => m.customConversionsCommand),\n    pixels: () => import(\"./pixels.ts\").then((m) => m.pixelsCommand),\n    activities: () => import(\"./activities.ts\").then((m) => m.activitiesCommand),\n    insights: () => import(\"./insights.ts\").then((m) => m.insightsCommand),\n    preview: () => import(\"./preview.ts\").then((m) => m.previewCommand),\n    media: () => import(\"./media.ts\").then((m) => m.metaMediaCommand),\n    draft: () => import(\"./draft.ts\").then((m) => m.metaDraftCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAiBvB,IAAM,cAAc,cAAc;AAAA,EACvC,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoCf;AAAA,EACA,aAAa;AAAA,IACX,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,YAAY,MAAM,OAAO,0BAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IAC3E,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,IAC5D,cAAc,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACvE,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;AAAA,IAC5D,WAAW,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACxE,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IAC/D,KAAK,MAAM,OAAO,mBAAU,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAC1D,WAAW,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACxE,WAAW,MAAM,OAAO,yBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IACxE,sBAAsB,MAAM,OAAO,kCAAyB,EAAE,KAAK,CAAC,MAAM,EAAE,wBAAwB;AAAA,IACpG,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,IAC/D,YAAY,MAAM,OAAO,0BAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,iBAAiB;AAAA,IAC3E,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,IAChE,OAAO,MAAM,OAAO,qBAAY,EAAE,KAAK,CAAC,MAAM,EAAE,gBAAgB;AAAA,EAClE;AACF,CAAC;","names":[]}

package/dist/metrics-KW6SDULI.js

@@ -0,0 +1,152 @@
+import {
+  PLANNER_FIELD_DESCRIPTIONS,
+  PLANNER_SOURCE,
+  stampPlannerRows
+} from "./chunk-2Y5V23PU.js";
+import {
+  buildAdsQueryContext,
+  warnDefaults
+} from "./chunk-3ZWWXAQZ.js";
+import "./chunk-77DN7R35.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  handleConnectionError,
+  isNotConnectedError,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-BVM5IRZW.js";
+import "./chunk-XX6ZMCY5.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/metrics.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.metrics",
+  description: 'Get historical market metrics for specific keywords. Returns { source: "keyword_planner_estimate", historical_metrics: [...] }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    keywords: { type: "string", description: "Comma-separated keywords to analyze (max 200)", required: true },
+    location: {
+      type: "string",
+      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function stampMetricsResponse(data) {
+  return { ...data, source: PLANNER_SOURCE, historical_metrics: stampPlannerRows(data.historical_metrics ?? []) };
+}
+function handleMetricsError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("google_ads", err.message);
+    }
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: { action: "reject", explanation: err.message },
+        retryable: err.code === "RATE_LIMITED"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var metricsCommand = defineCommand({
+  meta: {
+    name: "metrics",
+    description: `Get historical search metrics for specific keywords.
+
+Returns Keyword Planner ESTIMATES of market search volume, not this account's numbers. Every row carries source=keyword_planner_estimate and planner_-prefixed metrics; keep those names when you quote a figure, and never present one as an impression or click count.
+
+Examples:
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "running shoes,nike shoes,adidas shoes"
+  baker ads google keywords metrics --customer-id 1234567890 --keywords "seo tools" --location 2826`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+    keywords: { type: "string", description: "Comma-separated keywords", required: true },
+    location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+    language: { type: "string", description: "Language ID (default 1000)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const queryContext = buildAdsQueryContext(args.location, args.language);
+    const keywords = args.keywords.split(",").map((k) => k.trim()).filter(Boolean);
+    if (keywords.length === 0) {
+      writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "At least one keyword is required" } });
+      process.exit(1);
+    }
+    if (keywords.length > 200) {
+      writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Maximum 200 keywords per request" } });
+      process.exit(1);
+    }
+    const body = { customerId, keywords };
+    const managerId = getManagerIdForCustomer(customerId);
+    if (managerId) body.managerId = managerId;
+    if (args.location) body.locationIds = [args.location];
+    if (args.language) body.languageId = args.language;
+    const useCache = !args["no-cache"];
+    if (!useCache) body.skipCache = true;
+    const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("keywords", cacheKey);
+      if (cached) {
+        warnDefaults(queryContext);
+        writeAdsJson({ ok: true, data: stampMetricsResponse(cached.data), cached: true, query_context: queryContext });
+        return;
+      }
+    }
+    try {
+      const data = await apiPost("/api/ads/google/keywords/metrics", body);
+      if (useCache) {
+        cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      warnDefaults(queryContext);
+      const stamped = stampMetricsResponse(data);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(stamped.historical_metrics, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data: stamped, fields: PLANNER_FIELD_DESCRIPTIONS, query_context: queryContext });
+    } catch (err) {
+      handleMetricsError(err);
+    }
+  }
+});
+export {
+  metricsCommand,
+  stampMetricsResponse
+};
+//# sourceMappingURL=metrics-KW6SDULI.js.map

package/dist/metrics-KW6SDULI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/keywords/metrics.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { ApiError, apiPost } from \"../../../../client.ts\";\nimport { handleConnectionError, isNotConnectedError } from \"../../../../error-handler.ts\";\nimport { buildAdsQueryContext, warnDefaults } from \"../../../../geo-context.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { buildQueryCacheKey, cacheGet, cacheSet, getManagerIdForCustomer } from \"../../cache.ts\";\nimport { resolveCustomerId, writeAdsJson, writeAdsOutput } from \"../../output.ts\";\nimport type { AdsErrorEnvelope } from \"../../types.ts\";\nimport { PLANNER_FIELD_DESCRIPTIONS, PLANNER_SOURCE, type PlannerRow, stampPlannerRows } from \"./provenance.ts\";\n\nregisterSchema({\n  command: \"ads.google.keywords.metrics\",\n  description:\n    'Get historical market metrics for specific keywords. Returns { source: \"keyword_planner_estimate\", historical_metrics: [...] }. These are Keyword Planner estimates of total market search volume, not this account\\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric — read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',\n  args: {\n    \"customer-id\": {\n      type: \"string\",\n      description: \"Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.\",\n      required: false,\n    },\n    keywords: { type: \"string\", description: \"Comma-separated keywords to analyze (max 200)\", required: true },\n    location: {\n      type: \"string\",\n      description: \"Geo target ID. Defaults to 2840 (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description: \"Language ID. Defaults to 1000 (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Format: json|csv|jsonl|md\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n  },\n});\n\ntype KeywordMetric = {\n  keyword: string;\n  avg_monthly_searches: string;\n  competition: string;\n  competition_index: string;\n  low_top_of_page_bid_micros: number;\n  high_top_of_page_bid_micros: number;\n  monthly_search_volumes: Array<{ year: string; month: string; monthly_searches: string }>;\n};\n\ntype MetricsResponse = {\n  historical_metrics: KeywordMetric[];\n};\n\n/**\n * Same stamp as `keywords discover`: these are market estimates, not this account's numbers, and\n * the row has to say so in its own column names once it lands in a file.\n */\nexport function stampMetricsResponse(data: {\n  historical_metrics?: readonly PlannerRow[];\n  [key: string]: unknown;\n}): Record<string, unknown> & { historical_metrics: PlannerRow[] } {\n  return { ...data, source: PLANNER_SOURCE, historical_metrics: stampPlannerRows(data.historical_metrics ?? []) };\n}\n\nfunction handleMetricsError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (isNotConnectedError(err.code, err.message)) {\n      handleConnectionError(\"google_ads\", err.message);\n    }\n    const envelope: AdsErrorEnvelope = {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: { action: \"reject\", explanation: err.message },\n        retryable: err.code === \"RATE_LIMITED\",\n      },\n    };\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\nexport const metricsCommand = defineCommand({\n  meta: {\n    name: \"metrics\",\n    description: `Get historical search metrics for specific keywords.\n\nReturns Keyword Planner ESTIMATES of market search volume, not this account's numbers. Every row carries source=keyword_planner_estimate and planner_-prefixed metrics; keep those names when you quote a figure, and never present one as an impression or click count.\n\nExamples:\n  baker ads google keywords metrics --customer-id 1234567890 --keywords \"running shoes,nike shoes,adidas shoes\"\n  baker ads google keywords metrics --customer-id 1234567890 --keywords \"seo tools\" --location 2826`,\n  },\n  args: {\n    \"customer-id\": { type: \"string\", description: \"Google Ads customer ID\", required: false },\n    keywords: { type: \"string\", description: \"Comma-separated keywords\", required: true },\n    location: { type: \"string\", description: \"Geo target ID (default 2840)\", required: false },\n    language: { type: \"string\", description: \"Language ID (default 1000)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip cache\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|jsonl|md\", required: false, default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const customerId = await resolveCustomerId(args);\n    const queryContext = buildAdsQueryContext(args.location as string | undefined, args.language as string | undefined);\n\n    const keywords = (args.keywords as string)\n      .split(\",\")\n      .map((k) => k.trim())\n      .filter(Boolean);\n    if (keywords.length === 0) {\n      writeAdsJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"At least one keyword is required\" } });\n      process.exit(1);\n    }\n    if (keywords.length > 200) {\n      writeAdsJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"Maximum 200 keywords per request\" } });\n      process.exit(1);\n    }\n\n    const body: Record<string, unknown> = { customerId, keywords };\n    const managerId = getManagerIdForCustomer(customerId);\n    if (managerId) body.managerId = managerId;\n    if (args.location) body.locationIds = [args.location as string];\n    if (args.language) body.languageId = args.language;\n\n    const useCache = !args[\"no-cache\"];\n    if (!useCache) body.skipCache = true;\n    const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));\n\n    if (useCache) {\n      const cached = cacheGet<MetricsResponse>(\"keywords\", cacheKey);\n      if (cached) {\n        warnDefaults(queryContext);\n        writeAdsJson({ ok: true, data: stampMetricsResponse(cached.data), cached: true, query_context: queryContext });\n        return;\n      }\n    }\n\n    try {\n      const data = await apiPost<MetricsResponse>(\"/api/ads/google/keywords/metrics\", body);\n\n      if (useCache) {\n        cacheSet(\"keywords\", cacheKey, data, 24 * 60 * 60 * 1000);\n      }\n\n      warnDefaults(queryContext);\n      const stamped = stampMetricsResponse(data);\n      const format = (args.output as string) || \"json\";\n      if (format !== \"json\") {\n        writeAdsOutput(stamped.historical_metrics, format);\n        return;\n      }\n\n      writeAdsJson({ ok: true, data: stamped, fields: PLANNER_FIELD_DESCRIPTIONS, query_context: queryContext });\n    } catch (err) {\n      handleMetricsError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/models-5J4WFUD3.js

@@ -0,0 +1,155 @@
+import {
+  DEFAULT_IMAGE_GENERATE_MODEL,
+  DEFAULT_VIDEO_GENERATE_MODEL,
+  IMAGE_GENERATE_MODELS,
+  MODEL_REGISTRY,
+  VIDEO_GENERATE_MODELS,
+  maxInputReferences,
+  maxInputSlot,
+  promptMaxLength,
+  supportsReferenceToVideo
+} from "./chunk-CAMX6OHF.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/studio/models.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about \u2014 the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.";
+registerSchema({
+  command: "studio.models",
+  description: DESCRIPTION,
+  args: {
+    kind: {
+      type: "string",
+      description: "image (default) or video",
+      required: false,
+      enum: ["image", "video"]
+    },
+    model: { type: "string", description: "Just this one model, with every knob it takes", required: false }
+  }
+});
+function describeKnob(schema) {
+  if (schema.kind === "string") {
+    return {
+      type: "string",
+      ...schema.enum ? { values: [...schema.enum] } : {},
+      ...schema.maxLength !== void 0 ? { maxChars: schema.maxLength } : {}
+    };
+  }
+  if (schema.kind === "number") {
+    return {
+      type: schema.integer ? "integer" : "number",
+      ...schema.enum ? { values: [...schema.enum] } : {},
+      ...schema.min !== void 0 ? { min: schema.min } : {},
+      ...schema.max !== void 0 ? { max: schema.max } : {}
+    };
+  }
+  return { type: schema.kind };
+}
+function knobsFor(node, model) {
+  const params = MODEL_REGISTRY[node][model]?.params ?? {};
+  const knobs = {};
+  for (const [name, schema] of Object.entries(params)) {
+    if (name === "prompt") continue;
+    knobs[name] = describeKnob(schema);
+  }
+  return knobs;
+}
+function enumOf(node, model, param) {
+  const schema = MODEL_REGISTRY[node][model]?.params[param];
+  if (schema?.kind === "string") return schema.enum ? [...schema.enum] : void 0;
+  if (schema?.kind === "number") return schema.enum ? [...schema.enum] : void 0;
+  return void 0;
+}
+function imageCard(model) {
+  return {
+    id: model,
+    label: MODEL_REGISTRY.image_generate[model]?.label,
+    default: model === DEFAULT_IMAGE_GENERATE_MODEL,
+    shapes: enumOf("image_generate", model, "aspect_ratio"),
+    resolutions: enumOf("image_generate", model, "image_size") ?? "fixed by the model",
+    promptMaxChars: promptMaxLength("image_generate", model) ?? "no published limit",
+    maxReferenceImages: maxInputReferences("image_generate", model) ?? "no published limit",
+    knobs: knobsFor("image_generate", model)
+  };
+}
+function videoCard(model) {
+  const sourceClips = maxInputSlot("video_generate", model, "video");
+  return {
+    id: model,
+    label: MODEL_REGISTRY.video_generate[model]?.label,
+    default: model === DEFAULT_VIDEO_GENERATE_MODEL,
+    shapes: enumOf("video_generate", model, "aspect_ratio"),
+    resolutions: enumOf("video_generate", model, "resolution") ?? "fixed by the model",
+    seconds: enumOf("video_generate", model, "duration"),
+    promptMaxChars: promptMaxLength("video_generate", model) ?? "no published limit",
+    // Only meaningful in reference mode; a first-frame clip always takes exactly
+    // one image, whatever the model's reference slot allows.
+    referenceMode: supportsReferenceToVideo(model) ? `up to ${maxInputReferences("video_generate", model) ?? "several"} reference images` : "first frame only \u2014 this model cannot take reference images",
+    // Stated on EVERY card, not just the one model that has it: "can this build
+    // on a clip I already made" is the question that decides whether extend and
+    // edit are possible at all, and a field that appears only when the answer is
+    // yes reads as "unknown" everywhere else.
+    buildsOnClips: sourceClips ? `up to ${sourceClips} source clips \u2014 extend, edit, or carry their motion (pass with --from-clip)` : "no \u2014 this model cannot build on an existing clip",
+    knobs: knobsFor("video_generate", model)
+  };
+}
+function buildModelCards(kind, model) {
+  const ids = kind === "image" ? IMAGE_GENERATE_MODELS : VIDEO_GENERATE_MODELS;
+  const build = kind === "image" ? imageCard : videoCard;
+  const selected = model ? ids.filter((id) => id === model) : ids;
+  return selected.map((id) => build(id));
+}
+var modelsCommand = defineCommand({
+  meta: {
+    name: "models",
+    description: `${DESCRIPTION}
+
+Everything here is read from the same table the backend validates against, so it cannot drift from what a request will actually be allowed to do.
+
+Two rules that explain most refusals:
+  - A knob the chosen model does not have is REFUSED, not dropped \u2014 asking gpt-image-2 for a resolution fails rather than quietly rendering at its own size, because a setting that silently did nothing is worse than one that told you.
+  - A SHAPE is the exception: an unsupported one snaps to the nearest that model renders (4:5 on gpt-image-2 becomes 3:4), so you can ask for the ad format you want.
+
+Examples:
+  baker studio models
+  baker studio models --kind video
+  baker studio models --model recraft/recraft-v4.1-pro-vector`
+  },
+  args: {
+    kind: { type: "string", description: "image (default) | video", required: false },
+    model: { type: "string", description: "Just this one model", required: false }
+  },
+  run: ({ args }) => {
+    const kind = args.kind === "video" ? "video" : "image";
+    const model = args.model;
+    const cards = buildModelCards(kind, model);
+    if (model && cards.length === 0) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "NOT_FOUND",
+          message: `"${model}" is not a Studio ${kind} model.`,
+          fix: `Run \`baker studio models --kind ${kind}\` for the roster.`
+        }
+      });
+      process.exit(1);
+    }
+    writeJson({
+      ok: true,
+      data: cards,
+      meta: { count: cards.length },
+      hints: [
+        kind === "image" ? "Shapes snap to the nearest the model renders; every other setting is refused if the model does not have it." : "A clip starting from one exact frame uses ONE image. Only Seedance and Gemini Omni take several as references, and only Seedance 2.5 goes past 15s or builds on an existing clip."
+      ]
+    });
+  }
+});
+export {
+  buildModelCards,
+  modelsCommand
+};
+//# sourceMappingURL=models-5J4WFUD3.js.map

package/dist/models-5J4WFUD3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/studio/models.ts"],"sourcesContent":["import {\n  DEFAULT_IMAGE_GENERATE_MODEL,\n  DEFAULT_VIDEO_GENERATE_MODEL,\n  IMAGE_GENERATE_MODELS,\n  MODEL_REGISTRY,\n  maxInputReferences,\n  maxInputSlot,\n  type NodeKind,\n  type ParamSchema,\n  promptMaxLength,\n  supportsReferenceToVideo,\n  VIDEO_GENERATE_MODELS,\n} from \"@baker/canvas-contract\";\nimport { defineCommand } from \"citty\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nconst DESCRIPTION =\n  \"What each Studio model actually accepts: its shapes, resolutions, clip lengths, prompt character cap, how many reference images it takes, and which knobs it has. Read this before a batch you care about — the models disagree far more than they look like they do, and a setting the chosen model does not have is REFUSED, not ignored.\";\n\nregisterSchema({\n  command: \"studio.models\",\n  description: DESCRIPTION,\n  args: {\n    kind: {\n      type: \"string\",\n      description: \"image (default) or video\",\n      required: false,\n      enum: [\"image\", \"video\"],\n    },\n    model: { type: \"string\", description: \"Just this one model, with every knob it takes\", required: false },\n  },\n});\n\n/** One knob, as the agent needs to see it: what it takes, not how it is typed. */\ntype Knob = { values?: (string | number)[]; min?: number; max?: number; maxChars?: number; type: string };\n\nfunction describeKnob(schema: ParamSchema): Knob {\n  if (schema.kind === \"string\") {\n    return {\n      type: \"string\",\n      ...(schema.enum ? { values: [...schema.enum] } : {}),\n      ...(schema.maxLength !== undefined ? { maxChars: schema.maxLength } : {}),\n    };\n  }\n  if (schema.kind === \"number\") {\n    return {\n      type: schema.integer ? \"integer\" : \"number\",\n      ...(schema.enum ? { values: [...schema.enum] } : {}),\n      ...(schema.min !== undefined ? { min: schema.min } : {}),\n      ...(schema.max !== undefined ? { max: schema.max } : {}),\n    };\n  }\n  return { type: schema.kind };\n}\n\n/**\n * `prompt` is described by its own top-level `promptMaxChars` field and every\n * model requires it, so repeating it inside the knob list is noise.\n */\nfunction knobsFor(node: NodeKind, model: string): Record<string, Knob> {\n  const params = MODEL_REGISTRY[node][model]?.params ?? {};\n  const knobs: Record<string, Knob> = {};\n  for (const [name, schema] of Object.entries(params)) {\n    if (name === \"prompt\") continue;\n    knobs[name] = describeKnob(schema);\n  }\n  return knobs;\n}\n\nfunction enumOf(node: NodeKind, model: string, param: string): (string | number)[] | undefined {\n  const schema = MODEL_REGISTRY[node][model]?.params[param];\n  if (schema?.kind === \"string\") return schema.enum ? [...schema.enum] : undefined;\n  if (schema?.kind === \"number\") return schema.enum ? [...schema.enum] : undefined;\n  return undefined;\n}\n\ntype ModelCard = Record<string, unknown>;\n\nfunction imageCard(model: string): ModelCard {\n  return {\n    id: model,\n    label: MODEL_REGISTRY.image_generate[model]?.label,\n    default: model === DEFAULT_IMAGE_GENERATE_MODEL,\n    shapes: enumOf(\"image_generate\", model, \"aspect_ratio\"),\n    resolutions: enumOf(\"image_generate\", model, \"image_size\") ?? \"fixed by the model\",\n    promptMaxChars: promptMaxLength(\"image_generate\", model) ?? \"no published limit\",\n    maxReferenceImages: maxInputReferences(\"image_generate\", model) ?? \"no published limit\",\n    knobs: knobsFor(\"image_generate\", model),\n  };\n}\n\nfunction videoCard(model: string): ModelCard {\n  const sourceClips = maxInputSlot(\"video_generate\", model, \"video\");\n  return {\n    id: model,\n    label: MODEL_REGISTRY.video_generate[model]?.label,\n    default: model === DEFAULT_VIDEO_GENERATE_MODEL,\n    shapes: enumOf(\"video_generate\", model, \"aspect_ratio\"),\n    resolutions: enumOf(\"video_generate\", model, \"resolution\") ?? \"fixed by the model\",\n    seconds: enumOf(\"video_generate\", model, \"duration\"),\n    promptMaxChars: promptMaxLength(\"video_generate\", model) ?? \"no published limit\",\n    // Only meaningful in reference mode; a first-frame clip always takes exactly\n    // one image, whatever the model's reference slot allows.\n    referenceMode: supportsReferenceToVideo(model)\n      ? `up to ${maxInputReferences(\"video_generate\", model) ?? \"several\"} reference images`\n      : \"first frame only — this model cannot take reference images\",\n    // Stated on EVERY card, not just the one model that has it: \"can this build\n    // on a clip I already made\" is the question that decides whether extend and\n    // edit are possible at all, and a field that appears only when the answer is\n    // yes reads as \"unknown\" everywhere else.\n    buildsOnClips: sourceClips\n      ? `up to ${sourceClips} source clips — extend, edit, or carry their motion (pass with --from-clip)`\n      : \"no — this model cannot build on an existing clip\",\n    knobs: knobsFor(\"video_generate\", model),\n  };\n}\n\nexport function buildModelCards(kind: \"image\" | \"video\", model?: string): ModelCard[] {\n  const ids = kind === \"image\" ? IMAGE_GENERATE_MODELS : VIDEO_GENERATE_MODELS;\n  const build = kind === \"image\" ? imageCard : videoCard;\n  const selected = model ? ids.filter((id) => id === model) : ids;\n  return selected.map((id) => build(id));\n}\n\nexport const modelsCommand = defineCommand({\n  meta: {\n    name: \"models\",\n    description: `${DESCRIPTION}\n\nEverything here is read from the same table the backend validates against, so it cannot drift from what a request will actually be allowed to do.\n\nTwo rules that explain most refusals:\n  - A knob the chosen model does not have is REFUSED, not dropped — asking gpt-image-2 for a resolution fails rather than quietly rendering at its own size, because a setting that silently did nothing is worse than one that told you.\n  - A SHAPE is the exception: an unsupported one snaps to the nearest that model renders (4:5 on gpt-image-2 becomes 3:4), so you can ask for the ad format you want.\n\nExamples:\n  baker studio models\n  baker studio models --kind video\n  baker studio models --model recraft/recraft-v4.1-pro-vector`,\n  },\n  args: {\n    kind: { type: \"string\", description: \"image (default) | video\", required: false },\n    model: { type: \"string\", description: \"Just this one model\", required: false },\n  },\n  run: ({ args }) => {\n    const kind = args.kind === \"video\" ? \"video\" : \"image\";\n    const model = args.model as string | undefined;\n    const cards = buildModelCards(kind, model);\n\n    if (model && cards.length === 0) {\n      writeJson({\n        ok: false,\n        error: {\n          code: \"NOT_FOUND\",\n          message: `\"${model}\" is not a Studio ${kind} model.`,\n          fix: `Run \\`baker studio models --kind ${kind}\\` for the roster.`,\n        },\n      });\n      process.exit(1);\n    }\n\n    writeJson({\n      ok: true,\n      data: cards,\n      meta: { count: cards.length },\n      hints: [\n        kind === \"image\"\n          ? \"Shapes snap to the nearest the model renders; every other setting is refused if the model does not have it.\"\n          : \"A clip starting from one exact frame uses ONE image. Only Seedance and Gemini Omni take several as references, and only Seedance 2.5 goes past 15s or builds on an existing clip.\",\n      ],\n    });\n  },\n});\n"],"mappings":"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","names":[]}