@koda-sl/baker-cli 0.500.0 → 0.503.0

package/dist/media-LE2PO4Q4.js

@@ -0,0 +1,18 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/media.ts
+import { defineCommand } from "citty";
+var metaMediaCommand = defineCommand({
+  meta: {
+    name: "media",
+    description: "Stage Baker library media uploads to Meta so creatives can reference them (upload), or take an image out of the account's image library (delete --image-hash). Upload publishes an ad-image hash or video id a creative binds via --image-ref/--video-ref."
+  },
+  subCommands: {
+    upload: () => import("./write-commands-UA3FI3EX.js").then((m) => m.mediaUploadCommand),
+    delete: () => import("./asset-writes-QPJDD767.js").then((m) => m.mediaDeleteCommand)
+  }
+});
+export {
+  metaMediaCommand
+};
+//# sourceMappingURL=media-LE2PO4Q4.js.map

package/dist/media-sources-RUVU6AQT.js

@@ -0,0 +1,35 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/media-sources/index.ts
+import { defineCommand } from "citty";
+var mediaSourcesCommand = defineCommand({
+  meta: {
+    name: "media-sources",
+    description: `Follow social accounts \u2014 the company's pages and its key people (CEO, CTO, head of sales\u2026) \u2014 on Instagram, TikTok, YouTube (videos), LinkedIn (pages and /in/ profiles) and Facebook. Their posts fill Posts (\`baker posts\`), their images and videos the libraries. 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, update, 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 add https://www.linkedin.com/in/jane-doe --role ceo
+  baker media-sources update linkedin:in/jane-doe --role ceo --title "CEO & co-founder"
+  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-6TDY6LPL.js").then((m) => m.addCommand),
+    update: () => import("./update-MCUXTMIZ.js").then((m) => m.updateCommand),
+    list: () => import("./list-R3TZDYXS.js").then((m) => m.listCommand),
+    sync: () => import("./sync-GSDC2OK2.js").then((m) => m.syncCommand),
+    schedule: () => import("./schedule-P6MVM7TK.js").then((m) => m.scheduleCommand),
+    reset: () => import("./reset-63EXKSHS.js").then((m) => m.resetCommand),
+    remove: () => import("./remove-2ISYRP4H.js").then((m) => m.removeCommand)
+  }
+});
+export {
+  mediaSourcesCommand
+};
+//# sourceMappingURL=media-sources-RUVU6AQT.js.map

package/dist/members-CC7AW5XU.js

@@ -0,0 +1,45 @@
+import {
+  failApi
+} from "./chunk-2VPNX7EZ.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.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-CC7AW5XU.js.map

package/dist/meta-KS3SQSYZ.js

@@ -0,0 +1,122 @@
+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
+
+Build targeting (Meta takes ids, never names \u2014 look them up first):
+  baker ads meta targeting search --account-id act_123 --q "solar energy"  \u2014 interest/behavior/employer\u2026 ids
+  baker ads meta targeting geo --account-id act_123 --q Madrid             \u2014 location keys
+  baker ads meta targeting validate --account-id act_123 --targeting-file t.json
+  baker ads meta targeting estimate --account-id act_123 --targeting-file t.json --optimization-goal LEAD_GENERATION
+  baker ads meta targeting describe --account-id act_123 --adset-id 6123   \u2014 the audience in Meta's words
+
+Identities and libraries:
+  baker ads meta instagram-accounts --account-id act_123              \u2014 the --instagram-user an ad can run as
+  baker ads meta apps --account-id act_123                            \u2014 apps it can promote
+  baker ads meta dsa-recommendations --account-id act_123             \u2014 EU DSA beneficiary/payor names
+  baker ads meta images --account-id act_123                          \u2014 image hashes already on Meta
+  baker ads meta labels --account-id act_123
+  baker ads meta catalogs --business-id 601050769212882               \u2014 product catalogs; --catalog-id for product sets; products/sets/feeds/diagnostics
+  baker ads meta page-photos upload --page-id \u2026 --image-id \u2026           \u2014 a photo on a Page, not posted (Instant Experiences)
+  baker ads meta instant-experiences --page-id 904238019441800        \u2014 full-screen pages an ad can open (collection ads)
+  baker ads meta studies --account-id act_123                         \u2014 A/B tests; --study-id for results
+  baker ads meta high-demand-periods --campaign-id 6123               \u2014 budget boosts
+  baker ads meta page-posts --page-id 904238019441800                 \u2014 posts an ad can boost; instagram-media for Instagram
+  baker ads meta block-lists --account-id act_123                     \u2014 sites and apps ads stay off (brand safety)
+  baker ads meta reach-frequency --account-id act_123                 \u2014 reach & frequency quotes; predict | reserve | cancel
+  baker ads meta account-settings --account-id act_123 --spending-limit 5000 \u2014 account name / spending limit (staged)
+  baker ads meta comments --ad-id 120211234567890                     \u2014 comments on an ad's post
+  baker ads meta account-details --account-id act_123 --show users    \u2014 people, Meta's suggestions, Advantage+ controls, playables, page sets
+
+Drill in:
+  baker ads meta account --account-id act_123                         \u2014 currency, balance, business, whether it can deliver
+  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
+
+Automated rules (run on Meta, unattended, once published):
+  baker ads meta rules --account-id act_123                           \u2014 every rule and what it does
+  baker ads meta rules history --rule-id 1132635173044914             \u2014 what a rule did and when
+  baker ads meta rules create --name "Stop expensive ads" --apply-to ad --when "cost_per_result>20" --action pause
+
+A/B tests (Meta splits the audience between versions and calls the winner):
+  baker ads meta adsets duplicate 6123 --name "\u2026 \u2013 lookalike"         \u2014 then change ONE thing on the copy
+  baker ads meta studies create --name "Broad vs lookalike" --adsets 6123,meta_temp_ab12 --start 2026-10-20T08:00Z --days 14
+
+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-FT2SRKMD.js").then((m) => m.accountsCommand),
+    account: () => import("./account-ZY655BIU.js").then((m) => m.accountCommand),
+    businesses: () => import("./businesses-MGP2YCEU.js").then((m) => m.businessesCommand),
+    pages: () => import("./pages-J6AF5NDU.js").then((m) => m.pagesCommand),
+    "lead-forms": () => import("./leads-WKGUT3EA.js").then((m) => m.leadFormsCommand),
+    "instant-experiences": () => import("./instant-experiences-ABIS6KUQ.js").then((m) => m.instantExperiencesCommand),
+    leads: () => import("./leads-WKGUT3EA.js").then((m) => m.leadsCommand),
+    campaigns: () => import("./campaigns-PCD72XQX.js").then((m) => m.campaignsCommand),
+    adsets: () => import("./adsets-7N4UFAVA.js").then((m) => m.adsetsCommand),
+    ads: () => import("./ads-IC52FMFA.js").then((m) => m.adsListCommand),
+    creatives: () => import("./creatives-L7F4BF3F.js").then((m) => m.creativesCommand),
+    audiences: () => import("./audiences-H5WVE2ZA.js").then((m) => m.audiencesCommand),
+    "custom-conversions": () => import("./custom-conversions-6KYF26SK.js").then((m) => m.customConversionsCommand),
+    pixels: () => import("./pixels-ZZTB6NWF.js").then((m) => m.pixelsCommand),
+    activities: () => import("./activities-LKLPORDI.js").then((m) => m.activitiesCommand),
+    insights: () => import("./insights-EQW34IL4.js").then((m) => m.insightsCommand),
+    preview: () => import("./preview-CWRGDFCP.js").then((m) => m.previewCommand),
+    targeting: () => import("./targeting-SOMGPSKV.js").then((m) => m.targetingCommand),
+    "instagram-accounts": () => import("./account-assets-WZOYMT3C.js").then((m) => m.instagramAccountsCommand),
+    apps: () => import("./account-assets-WZOYMT3C.js").then((m) => m.appsCommand),
+    "dsa-recommendations": () => import("./account-assets-WZOYMT3C.js").then((m) => m.dsaRecommendationsCommand),
+    images: () => import("./account-assets-WZOYMT3C.js").then((m) => m.imagesCommand),
+    labels: () => import("./account-assets-WZOYMT3C.js").then((m) => m.labelsCommand),
+    studies: () => import("./studies-2GPTKJCT.js").then((m) => m.studiesCommand),
+    catalogs: () => import("./catalogs-OIQS5NSC.js").then((m) => m.catalogsCommand),
+    "page-photos": () => import("./page-photos-TOM74T5U.js").then((m) => m.pagePhotosCommand),
+    "page-posts": () => import("./account-level-XEDTZVNJ.js").then((m) => m.pagePostsCommand),
+    "instagram-media": () => import("./account-level-XEDTZVNJ.js").then((m) => m.instagramMediaCommand),
+    comments: () => import("./account-level-XEDTZVNJ.js").then((m) => m.commentsCommand),
+    "account-settings": () => import("./account-level-XEDTZVNJ.js").then((m) => m.accountSettingsCommand),
+    "account-details": () => import("./account-level-XEDTZVNJ.js").then((m) => m.accountDetailsCommand),
+    "block-lists": () => import("./account-level-XEDTZVNJ.js").then((m) => m.blockListsCommand),
+    "reach-frequency": () => import("./account-level-XEDTZVNJ.js").then((m) => m.reachFrequencyCommand),
+    "high-demand-periods": () => import("./account-assets-WZOYMT3C.js").then((m) => m.highDemandPeriodsCommand),
+    rules: () => import("./rules-NALFFFDR.js").then((m) => m.rulesCommand),
+    media: () => import("./media-LE2PO4Q4.js").then((m) => m.metaMediaCommand),
+    draft: () => import("./draft-RIR2V6A2.js").then((m) => m.metaDraftCommand)
+  }
+});
+export {
+  metaCommand
+};
+//# sourceMappingURL=meta-KS3SQSYZ.js.map

package/dist/metrics-K6FDCMK7.js

@@ -0,0 +1,152 @@
+import {
+  PLANNER_FIELD_DESCRIPTIONS,
+  PLANNER_SOURCE,
+  stampPlannerRows
+} from "./chunk-2Y5V23PU.js";
+import {
+  buildAdsQueryContext,
+  warnDefaults
+} from "./chunk-ZNRGH4NS.js";
+import "./chunk-4GAEB6NK.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  handleConnectionError,
+  isNotConnectedError,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.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-K6FDCMK7.js.map

package/dist/normalize-GR36PPA5.js

@@ -0,0 +1,142 @@
+import {
+  flowDataPath,
+  listFlowSlugs,
+  readFlowTree,
+  walkNodes,
+  writeFlowTree
+} from "./chunk-3SYRNFRV.js";
+import {
+  looksLikeUnresolvedVariable,
+  parseEmailRecipients
+} from "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/normalize.ts
+import { defineCommand } from "citty";
+var OPTIONAL_STRINGS = ["oauthProviderId"];
+var ARRAY_FIELDS = [
+  "fieldMapping",
+  "columnMapping",
+  "payloadKeys",
+  "eventParams",
+  "eventProperties",
+  "dataLayerParams",
+  "goalParams",
+  "fields",
+  "tagIds"
+];
+var ARRAY_OWNERS = ["", "body"];
+function dropUnsetOptionals(sideEffect, path) {
+  return OPTIONAL_STRINGS.flatMap((key) => {
+    if (!(key in sideEffect) || sideEffect[key] !== null && sideEffect[key] !== "") return [];
+    delete sideEffect[key];
+    return [{ path, change: `dropped \`${key}\` (an optional string is absent, never null)` }];
+  });
+}
+function fillNulledArrays(target, prefix, path) {
+  return ARRAY_FIELDS.flatMap((key) => {
+    if (!(key in target) || target[key] !== null) return [];
+    target[key] = [];
+    return [{ path, change: `\`${prefix}${key}: null\` \u2192 \`[]\`` }];
+  });
+}
+function tidyEmailRecipients(sideEffect, path) {
+  if (sideEffect.type !== "email") return [];
+  const config = sideEffect.encryptedConfig;
+  if (!config || typeof config !== "object" || Array.isArray(config)) return [];
+  const raw = config.email;
+  if (typeof raw !== "string" || looksLikeUnresolvedVariable(raw)) return [];
+  const { to, invalid } = parseEmailRecipients(raw);
+  if (invalid.length > 0 || to.length === 0) return [];
+  const tidied = to.join(", ");
+  if (tidied === raw) return [];
+  config.email = tidied;
+  return [{ path, change: "tidied the recipient list's spacing and separators" }];
+}
+function sideEffectsOf(node) {
+  if (!Array.isArray(node.sideEffects)) return [];
+  return node.sideEffects.filter(
+    (sideEffect) => Boolean(sideEffect) && typeof sideEffect === "object"
+  );
+}
+function normalizeSideEffect(sideEffect, where) {
+  const path = `${where} \u2192 ${String(sideEffect.id ?? "side effect")}`;
+  const arrays = ARRAY_OWNERS.flatMap((owner) => {
+    const target = owner ? sideEffect[owner] : sideEffect;
+    if (!target || typeof target !== "object") return [];
+    return fillNulledArrays(target, owner ? `${owner}.` : "", path);
+  });
+  return [...dropUnsetOptionals(sideEffect, path), ...arrays, ...tidyEmailRecipients(sideEffect, path)];
+}
+function normalizeFlowTree(tree) {
+  const changes = [];
+  for (const node of walkNodes(tree)) {
+    const where = typeof node.name === "string" && node.name ? String(node.name) : String(node.id ?? "node");
+    if (!("condition" in node)) {
+      node.condition = null;
+      changes.push({ path: where, change: "added the missing `condition: null`" });
+    }
+    for (const sideEffect of sideEffectsOf(node)) {
+      changes.push(...normalizeSideEffect(sideEffect, where));
+    }
+  }
+  return changes;
+}
+registerSchema({
+  command: "flows.normalize",
+  description: "Fix the shapes a form file is allowed to get slightly wrong: a nulled optional string, a nulled array, a missing condition. Runs automatically before a commit; you rarely need to call it.",
+  args: {
+    slug: { type: "positional", description: "Form slug. Omit to check every form.", required: false },
+    write: {
+      type: "boolean",
+      description: "Apply the fixes. Without it, reports and changes nothing",
+      required: false
+    }
+  }
+});
+var normalizeCommand = defineCommand({
+  meta: {
+    name: "normalize",
+    description: "Repair the shapes a form file is allowed to get slightly wrong. Example: baker flows normalize contact --write"
+  },
+  args: {
+    // `required: false` matters: citty makes a positional required by default,
+    // so without it the documented bare `baker flows normalize` printed a wall
+    // of usage text and exited 1 instead of checking every form.
+    slug: { type: "positional", description: "Form slug (omit for every form)", required: false },
+    write: { type: "boolean", description: "Apply the fixes" }
+  },
+  run: ({ args }) => {
+    const slugs = args.slug ? [String(args.slug)] : listFlowSlugs();
+    const forms = slugs.flatMap((slug) => {
+      const tree = readFlowTree(slug);
+      const changes = normalizeFlowTree(tree);
+      if (changes.length === 0) return [];
+      if (args.write === true) writeFlowTree(slug, tree);
+      return [{ slug, path: flowDataPath(slug), changes }];
+    });
+    const total = forms.reduce((sum, form) => sum + form.changes.length, 0);
+    writeJson({
+      ok: true,
+      data: { forms, changed: total, written: args.write === true },
+      hints: total === 0 ? ["Nothing to fix."] : args.write === true ? [`Fixed ${total} field(s).`] : [`${total} field(s) can be fixed. Re-run with --write.`]
+    });
+  }
+});
+export {
+  normalizeCommand,
+  normalizeFlowTree
+};
+//# sourceMappingURL=normalize-GR36PPA5.js.map

package/dist/options-ZYRVBWZA.js

@@ -0,0 +1,123 @@
+import {
+  destinationRefusal
+} from "./chunk-CQ73THKY.js";
+import "./chunk-B3IPIB2P.js";
+import "./chunk-3SYRNFRV.js";
+import {
+  failApi
+} from "./chunk-2VPNX7EZ.js";
+import {
+  FLOW_ACCOUNT_ONLY_KINDS,
+  FLOW_AGENT_DESTINATION_KINDS
+} from "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/flows/options.ts
+import { defineCommand } from "citty";
+var HUBSPOT_KINDS = {
+  hubspot: "baker hubspot forms list",
+  hubspotForm: "baker hubspot forms list",
+  hubspotMeeting: "baker hubspot meetings list"
+};
+function optionsHints(data) {
+  const { kind, options } = data;
+  if (FLOW_ACCOUNT_ONLY_KINDS.includes(kind)) {
+    return [
+      `Nothing to choose: the connected account is the destination. Wire it: baker flows connect <slug> --side-effect <id> (or --all --type ${kind}).`
+    ];
+  }
+  if (kind === "googleSpreadsheet") {
+    return [
+      "These are the only spreadsheets Baker can reach: ones someone chose for a Form before, and ones Baker created. Pick one: baker flows connect <slug> --side-effect <id> --resource <id> [--tab <name>].",
+      'None fits? Create one yourself: baker flows connect <slug> --side-effect <id> --new-sheet "<Form name> leads" --columns "Name,Email,\u2026". Only when the user wants their own existing sheet: request_flow_input.'
+    ];
+  }
+  const empty = options.length === 0 ? ["The account has none. Tell the user what to create there, or skip this step \u2014 do not invent one."] : [];
+  return [
+    ...empty,
+    `Fill the step: baker flows connect <slug> --node <stepId> --resource <id> (or --all --type ${kind}). One clear match \u2192 use it; several plausible \u2192 ask the user which.`
+  ];
+}
+registerSchema({
+  command: "flows.options",
+  description: "What a Form step or destination can be filled with, read from the connected account: Calendly events, SavvyCal links, GoHighLevel calendars and forms, the Google spreadsheets Baker can reach. Pipedrive, GoHighLevel contact and ActiveCampaign contact have nothing to choose \u2014 the account is the destination. Next: `baker flows connect <slug> --node|--side-effect <id> --resource <id>`. HubSpot has its own: `baker hubspot forms list` / `meetings list`.",
+  args: {
+    kind: {
+      type: "positional",
+      description: `One of: ${FLOW_AGENT_DESTINATION_KINDS.join(", ")}`,
+      required: true
+    },
+    account: {
+      type: "string",
+      description: "Connection id, when more than one account of the platform is connected",
+      required: false
+    }
+  }
+});
+var optionsCommand = defineCommand({
+  meta: {
+    name: "options",
+    description: "What a step or destination can be filled with, from the connected account. Start here: baker flows options calendly"
+  },
+  args: {
+    kind: { type: "positional", description: FLOW_AGENT_DESTINATION_KINDS.join(" | "), required: true },
+    account: { type: "string", description: "Connection id when several are connected" }
+  },
+  run: async ({ args }) => {
+    const kind = String(args.kind);
+    const hubspot = HUBSPOT_KINDS[kind];
+    if (hubspot) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: `HubSpot has its own list: ${hubspot}.` } });
+      process.exit(1);
+    }
+    if (!FLOW_AGENT_DESTINATION_KINDS.includes(kind)) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: `"${kind}" is not filled from a platform account.`,
+          fix: `Kinds: ${FLOW_AGENT_DESTINATION_KINDS.join(", ")}. Typed credentials (webhooks, Zapier, Crmble) go through request_flow_input.`
+        }
+      });
+      process.exit(1);
+    }
+    try {
+      const { data } = await apiPost("/api/flows/destinations/options", {
+        kind,
+        ...args.account ? { account: String(args.account) } : {}
+      });
+      writeJson({
+        ok: true,
+        data: { ...data, accounts: data.accounts.length > 1 ? data.accounts : void 0 },
+        hints: optionsHints(data)
+      });
+    } catch (err) {
+      const refusal = err instanceof ApiError ? destinationRefusal(kind, err) : null;
+      if (err instanceof ApiError && refusal !== null) {
+        writeJson({ ok: false, error: { code: refusal.code, message: err.message, fix: refusal.fix } });
+        process.exit(1);
+      }
+      failApi(err);
+    }
+  }
+});
+export {
+  optionsCommand,
+  optionsHints
+};
+//# sourceMappingURL=options-ZYRVBWZA.js.map