@koda-sl/baker-cli 0.501.0 → 0.502.0

package/README.md

@@ -1169,6 +1169,12 @@ baker ads meta lead-forms spec 987654321 > form.json                  # a live f
 baker ads meta campaigns --account-id act_123                        # ACTIVE only by default
 baker ads meta ads --account-id act_123 --all-statuses               # widen to everything
 
+# "Raise it from 80 to 100 a day" — listed budgets are in cents, as Meta sends them (a hint
+# says so); --daily-budget takes whole currency. A raise past 3x the current budget is refused
+# (usually an amount copied in cents) unless restated with --confirm-budget-increase.
+baker ads meta adsets --campaign-id 6123                             # daily_budget "8000" is 80 EUR
+baker ads meta adsets update 6124 --daily-budget 100                  # summary: daily budget 80 → 100 EUR
+
 # "Find the October ad" — Meta matches the name, so only that row is read
 baker ads meta ads --account-id act_123 --all-statuses --name-contains octubre --fields id,name,adset_id,creative_id
 

package/dist/{account-assets-GAKJQB6R.js → account-assets-LSXSW4RQ.js}

@@ -221,11 +221,11 @@ var labelsCommand = defineCommand({
   },
   subCommands: {
     list: () => labelsListCommand,
-    create: () => import("./asset-writes-IE3HUPWM.js").then((m) => m.labelsCreateCommand),
-    rename: () => import("./asset-writes-IE3HUPWM.js").then((m) => m.labelsRenameCommand),
-    delete: () => import("./asset-writes-IE3HUPWM.js").then((m) => m.labelsDeleteCommand),
-    attach: () => import("./asset-writes-IE3HUPWM.js").then((m) => m.labelsAttachCommand),
-    detach: () => import("./asset-writes-IE3HUPWM.js").then((m) => m.labelsDetachCommand)
+    create: () => import("./asset-writes-6QPHEAKF.js").then((m) => m.labelsCreateCommand),
+    rename: () => import("./asset-writes-6QPHEAKF.js").then((m) => m.labelsRenameCommand),
+    delete: () => import("./asset-writes-6QPHEAKF.js").then((m) => m.labelsDeleteCommand),
+    attach: () => import("./asset-writes-6QPHEAKF.js").then((m) => m.labelsAttachCommand),
+    detach: () => import("./asset-writes-6QPHEAKF.js").then((m) => m.labelsDetachCommand)
   },
   args: labelsListArgs,
   default: "list"
@@ -287,4 +287,4 @@ export {
   instagramIdentityHints,
   labelsCommand
 };
-//# sourceMappingURL=account-assets-GAKJQB6R.js.map
+//# sourceMappingURL=account-assets-LSXSW4RQ.js.map

package/dist/{account-level-CAVVN4ZN.js → account-level-6T2WAPF3.js}

@@ -1,6 +1,6 @@
 import {
   dayPartingFromFlags
-} from "./chunk-GCLKAQUS.js";
+} from "./chunk-5YFQPJVS.js";
 import {
   bareAccountId,
   failWriteValidation,
@@ -8,8 +8,8 @@ import {
   numberFlag,
   requireTarget,
   stageOp
-} from "./chunk-YIN6QNZD.js";
-import "./chunk-5B2WEPYR.js";
+} from "./chunk-6R2BU3FJ.js";
+import "./chunk-SQCALAI7.js";
 import "./chunk-GDFJOCDO.js";
 import {
   handleMetaError
@@ -606,4 +606,4 @@ export {
   pagePostsCommand,
   reachFrequencyCommand
 };
-//# sourceMappingURL=account-level-CAVVN4ZN.js.map
+//# sourceMappingURL=account-level-6T2WAPF3.js.map

package/dist/{activities-CTGCJHLC.js → activities-LKLPORDI.js}

@@ -3,7 +3,7 @@ import {
   registerMetaListSchema,
   shapeMetaListRows,
   writeMetaListRows
-} from "./chunk-C4LZIBNP.js";
+} from "./chunk-KUY26RCF.js";
 import {
   csvOrJson,
   handleMetaError,
@@ -72,4 +72,4 @@ Examples:
 export {
   activitiesCommand
 };
-//# sourceMappingURL=activities-CTGCJHLC.js.map
+//# sourceMappingURL=activities-LKLPORDI.js.map

package/dist/{ads-HH5YTV4O.js → ads-CE3WX7VO.js}

@@ -34,7 +34,7 @@ Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedi
   },
   subCommands: {
     google: () => import("./google-ZZCSZR63.js").then((m) => m.googleCommand),
-    meta: () => import("./meta-AHI2HVBM.js").then((m) => m.metaCommand),
+    meta: () => import("./meta-CUWDMZQH.js").then((m) => m.metaCommand),
     linkedin: () => import("./linkedin-A4U6IGZX.js").then((m) => m.linkedinCommand),
     x: () => import("./x-F5CSO2RN.js").then((m) => m.xCommand),
     chatgpt: () => import("./chatgpt-23X76OFD.js").then((m) => m.chatgptCommand),
@@ -45,4 +45,4 @@ Full guides: __tooling__/docs/tools/baker/ads-<platform>.md (google|meta|linkedi
 export {
   adsCommand
 };
-//# sourceMappingURL=ads-HH5YTV4O.js.map
+//# sourceMappingURL=ads-CE3WX7VO.js.map

package/dist/{ads-WU4ITH6J.js → ads-K2TIHZFC.js}

@@ -3,7 +3,7 @@ import {
   registerMetaListSchema,
   shapeMetaListRows,
   writeMetaListRows
-} from "./chunk-C4LZIBNP.js";
+} from "./chunk-KUY26RCF.js";
 import {
   NAME_CONTAINS_ARG,
   csvOrJson,
@@ -92,15 +92,15 @@ Examples:
   },
   subCommands: {
     list: listCommand,
-    create: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsCreateCommand),
-    update: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsUpdateCommand),
-    pause: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsPauseCommand),
-    resume: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsResumeCommand),
-    archive: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsArchiveCommand),
-    delete: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsDeleteCommand),
-    duplicate: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsDuplicateCommand),
-    copy: () => import("./copy-writes-OVCOZODC.js").then((m) => m.adsCopyCommand),
-    retag: () => import("./write-commands-S7AX24WF.js").then((m) => m.adsRetagCommand)
+    create: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsCreateCommand),
+    update: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsUpdateCommand),
+    pause: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsPauseCommand),
+    resume: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsResumeCommand),
+    archive: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsArchiveCommand),
+    delete: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsDeleteCommand),
+    duplicate: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsDuplicateCommand),
+    copy: () => import("./copy-writes-2XW7VCDE.js").then((m) => m.adsCopyCommand),
+    retag: () => import("./write-commands-2L7T43YO.js").then((m) => m.adsRetagCommand)
   },
   // `args` stays even though the parent has no `run`: citty scans rawArgs for the
   // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
@@ -112,4 +112,4 @@ Examples:
 export {
   adsListCommand
 };
-//# sourceMappingURL=ads-WU4ITH6J.js.map
+//# sourceMappingURL=ads-K2TIHZFC.js.map

package/dist/{adsets-MMPN2SKX.js → adsets-MTB4LNE3.js}

@@ -7,10 +7,11 @@ import {
 } from "./chunk-G6XKD7QE.js";
 import {
   META_LIST_SHAPE_ARGS,
+  budgetUnitHints,
   registerMetaListSchema,
   shapeMetaListRows,
   writeMetaListRows
-} from "./chunk-C4LZIBNP.js";
+} from "./chunk-KUY26RCF.js";
 import {
   NAME_CONTAINS_ARG,
   csvOrJson,
@@ -130,7 +131,10 @@ var listCommand = defineCommand({
         return;
       }
       const shaped = shapeMetaListRows("adsets", data, args);
-      writeMetaListRows("adsets", shaped, csvOrJson(args), statusFilterHints(data, effectiveStatus, "ad sets"));
+      writeMetaListRows("adsets", shaped, csvOrJson(args), [
+        ...statusFilterHints(data, effectiveStatus, "ad sets"),
+        ...budgetUnitHints(data)
+      ]);
     } catch (err) {
       handleMetaError(err);
     }
@@ -156,14 +160,14 @@ Examples:
   },
   subCommands: {
     list: listCommand,
-    create: () => import("./write-commands-S7AX24WF.js").then((m) => m.adSetsCreateCommand),
-    update: () => import("./write-commands-S7AX24WF.js").then((m) => m.adSetsUpdateCommand),
-    pause: () => import("./write-commands-S7AX24WF.js").then((m) => m.adSetsPauseCommand),
-    resume: () => import("./write-commands-S7AX24WF.js").then((m) => m.adSetsResumeCommand),
-    archive: () => import("./write-commands-S7AX24WF.js").then((m) => m.adSetsArchiveCommand),
-    delete: () => import("./write-commands-S7AX24WF.js").then((m) => m.adSetsDeleteCommand),
-    duplicate: () => import("./write-commands-S7AX24WF.js").then((m) => m.adSetsDuplicateCommand),
-    copy: () => import("./copy-writes-OVCOZODC.js").then((m) => m.adSetsCopyCommand)
+    create: () => import("./write-commands-2L7T43YO.js").then((m) => m.adSetsCreateCommand),
+    update: () => import("./write-commands-2L7T43YO.js").then((m) => m.adSetsUpdateCommand),
+    pause: () => import("./write-commands-2L7T43YO.js").then((m) => m.adSetsPauseCommand),
+    resume: () => import("./write-commands-2L7T43YO.js").then((m) => m.adSetsResumeCommand),
+    archive: () => import("./write-commands-2L7T43YO.js").then((m) => m.adSetsArchiveCommand),
+    delete: () => import("./write-commands-2L7T43YO.js").then((m) => m.adSetsDeleteCommand),
+    duplicate: () => import("./write-commands-2L7T43YO.js").then((m) => m.adSetsDuplicateCommand),
+    copy: () => import("./copy-writes-2XW7VCDE.js").then((m) => m.adSetsCopyCommand)
   },
   // `args` stays even though the parent has no `run`: citty scans rawArgs for the
   // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
@@ -175,4 +179,4 @@ Examples:
 export {
   adsetsCommand
 };
-//# sourceMappingURL=adsets-MMPN2SKX.js.map
+//# sourceMappingURL=adsets-MTB4LNE3.js.map

package/dist/adsets-MTB4LNE3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/adsets.ts"],"sourcesContent":["import path from \"node:path\";\nimport { defineCommand } from \"citty\";\nimport { readAudienceNames } from \"../../../audience-names.ts\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { rememberedJev } from \"../../../engine/lib/remembered-nouls.ts\";\nimport type { ReviewUsage } from \"../../../engine/nodes/local/lib/render-review.ts\";\nimport { findWorkspaceRoot } from \"../../canvas/normalize-paths.ts\";\nimport { holdUnbilledSpend } from \"../../canvas/unbilled-spend.ts\";\nimport { writeAdsOutput } from \"../output.ts\";\nimport { adSetViewerRows, audienceNamesOf, flattenViewerRows, VIEWER_TABLE_COLUMNS } from \"./adset-viewers.ts\";\nimport {\n  budgetUnitHints,\n  META_LIST_SHAPE_ARGS,\n  registerMetaListSchema,\n  shapeMetaListRows,\n  writeMetaListRows,\n} from \"./list-rows.ts\";\nimport {\n  csvOrJson,\n  handleMetaError,\n  NAME_CONTAINS_ARG,\n  resolveAccountIdArg,\n  resolveEffectiveStatus,\n  statusFilterHints,\n} from \"./shared.ts\";\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n  \"campaign-id\": { type: \"string\", description: \"Filter to one campaign\" },\n  \"effective-status\": { type: \"string\", description: \"Comma-separated effective_status filter (overrides default)\" },\n  \"all-statuses\": { type: \"boolean\", description: \"Drop the default ACTIVE filter\" },\n  \"name-contains\": NAME_CONTAINS_ARG,\n  limit: { type: \"string\", description: \"Max rows (default 1000)\" },\n  \"no-cache\": NO_CACHE_ARG,\n  audience: {\n    type: \"boolean\",\n    description:\n      \"Who each ad set reaches, instead of the compact row: a viewer per ad set — temperature (cold|warm|hot), what they already know (brand/offer/product), placements, and the reasons, read from its targeting, the account's audiences and the campaign objective. Start here before writing an ad for an ad set: baker ads meta adsets --campaign-id 6123 --audience --output json\",\n  },\n  ...META_LIST_SHAPE_ARGS,\n} as const;\n\ntype MetaRow = Record<string, unknown>;\n\n/**\n * The audience list and the campaign objectives only sharpen the read: without them\n * each audience is read from its name and the objective is left out, so a refused\n * read degrades the viewer rather than failing the listing.\n */\nasync function readOrEmpty(path: string, params: Record<string, string>, label: string, hints: string[]) {\n  try {\n    return await apiGet<MetaRow[]>(path, params);\n  } catch (err) {\n    const message = err instanceof Error ? err.message : \"unknown error\";\n    hints.push(`Could not read the account's ${label} (${message}); the viewer was read without them.`);\n    return [];\n  }\n}\n\nasync function writeAdSetViewers(\n  adSets: MetaRow[],\n  accountParams: Record<string, string>,\n  format: string,\n  hints: string[],\n): Promise<void> {\n  const [audiences, campaigns] = await Promise.all([\n    readOrEmpty(\"/api/ads/meta/audiences\", accountParams, \"audiences\", hints),\n    readOrEmpty(\"/api/ads/meta/campaigns\", accountParams, \"campaigns\", hints),\n  ]);\n  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();\n  const cacheDir = path.join(root, \"canvas\", \".cache\");\n  const spent: ReviewUsage[] = [];\n  const readName = await readAudienceNames(\n    audienceNamesOf(adSets, audiences),\n    rememberedJev(path.join(cacheDir, \"audience-names.json\"), (u) => spent.push(u)),\n  );\n  await holdUnbilledSpend(cacheDir, spent).catch(() => undefined);\n  const rows = adSetViewerRows(adSets, audiences, campaigns, readName);\n  if (rows.length > 0) {\n    hints.push(\n      'Write each ad for the viewer of the ad set it will run in, then record it in the creative\\'s _definition.md: targetAdSet: \"<ad set id>\" and viewer: { temperature, knows, placements, source }.',\n    );\n  }\n  if (format === \"md\" || format === \"csv\") {\n    writeAdsOutput(flattenViewerRows(rows), format, [...VIEWER_TABLE_COLUMNS], hints);\n    return;\n  }\n  writeAdsOutput(rows as unknown as MetaRow[], format, undefined, hints);\n}\n\nregisterMetaListSchema(\n  \"adsets\",\n  \"List ad sets in a Meta ad account, as a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event, bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting is not in the compact row — ask for it with --fields id,name,targeting (or --full). --audience replaces the row with who each ad set reaches (a viewer: temperature, what they already know, placements, reasons) — read it before writing an ad for an ad set. Start here: baker ads meta adsets --campaign-id 6123 --all-statuses. --output json returns the rows in the envelope.\",\n  listArgs,\n);\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List ad sets in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta adsets --account-id act_123\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = resolveAccountIdArg(args);\n    const effectiveStatus = resolveEffectiveStatus(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args[\"campaign-id\"]) params[\"campaign-id\"] = args[\"campaign-id\"] as string;\n      if (effectiveStatus) params[\"effective-status\"] = effectiveStatus;\n      if (args[\"name-contains\"]) params[\"name-contains\"] = args[\"name-contains\"] as string;\n      if (args.limit) params.limit = args.limit as string;\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/adsets\", params);\n      if (args.audience) {\n        const hints = statusFilterHints(data, effectiveStatus, \"ad sets\");\n        const accountParams: Record<string, string> = { \"account-id\": accountId };\n        if (args[\"no-cache\"]) accountParams[\"skip-cache\"] = \"true\";\n        await writeAdSetViewers(data, accountParams, csvOrJson(args), hints);\n        return;\n      }\n      const shaped = shapeMetaListRows(\"adsets\", data, args);\n      writeMetaListRows(\"adsets\", shaped, csvOrJson(args), [\n        ...statusFilterHints(data, effectiveStatus, \"ad sets\"),\n        ...budgetUnitHints(data),\n      ]);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nexport const adsetsCommand = defineCommand({\n  meta: {\n    name: \"adsets\",\n    description: `List ad sets in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/copy).\nDefaults to ACTIVE only. Write subcommands stage ops on this chat's draft.\n\nListings print a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event,\nbid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting\nis not in the compact row — ask for it with --fields (dotted paths) or --full. --output json returns the rows as JSON.\n\nExamples:\n  baker ads meta adsets --account-id act_123\n  baker ads meta adsets --campaign-id 6123456789\n  baker ads meta adsets --account-id act_123 --all-statuses --name-contains retargeting   — find one ad set by name\n  baker ads meta adsets --campaign-id 6123456789 --fields id,name,targeting.geo_locations\n  baker ads meta adsets --campaign-id 6123456789 --audience --output json   — who each ad set reaches (viewer per ad set)\n  baker ads meta adsets create --campaign meta_temp_ab12 --name \"US 25-54\" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.adSetsCreateCommand),\n    update: () => import(\"./write-commands.ts\").then((m) => m.adSetsUpdateCommand),\n    pause: () => import(\"./write-commands.ts\").then((m) => m.adSetsPauseCommand),\n    resume: () => import(\"./write-commands.ts\").then((m) => m.adSetsResumeCommand),\n    archive: () => import(\"./write-commands.ts\").then((m) => m.adSetsArchiveCommand),\n    delete: () => import(\"./write-commands.ts\").then((m) => m.adSetsDeleteCommand),\n    duplicate: () => import(\"./write-commands.ts\").then((m) => m.adSetsDuplicateCommand),\n    copy: () => import(\"./copy-writes.ts\").then((m) => m.adSetsCopyCommand),\n  },\n  // `args` stays even though the parent has no `run`: citty scans rawArgs for the\n  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`\n  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare\n  // invocation — citty falls through to `run` after a subcommand, double-executing it.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":"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","names":["path"]}

package/dist/{asset-writes-IE3HUPWM.js → asset-writes-6QPHEAKF.js}

@@ -9,9 +9,9 @@ import {
   labelsDetachCommand,
   labelsRenameCommand,
   mediaDeleteCommand
-} from "./chunk-PRVX32SQ.js";
-import "./chunk-YIN6QNZD.js";
-import "./chunk-5B2WEPYR.js";
+} from "./chunk-HH7B2L3Z.js";
+import "./chunk-6R2BU3FJ.js";
+import "./chunk-SQCALAI7.js";
 import "./chunk-GDFJOCDO.js";
 import "./chunk-B2POVFR2.js";
 import "./chunk-ERSX3MKH.js";
@@ -45,4 +45,4 @@ export {
   labelsRenameCommand,
   mediaDeleteCommand
 };
-//# sourceMappingURL=asset-writes-IE3HUPWM.js.map
+//# sourceMappingURL=asset-writes-6QPHEAKF.js.map

package/dist/{audience-writes-VXQTCSHH.js → audience-writes-3PSC7LRY.js}

@@ -3,19 +3,19 @@ import {
   customerListBatches,
   customerListFromFile,
   customerListUploadRefusal
-} from "./chunk-YGCRKABE.js";
+} from "./chunk-SHLA4JF7.js";
 import {
   bareAccountId,
   failWriteValidation,
   repeatedListFlag,
   requireTarget,
   stageOp
-} from "./chunk-YIN6QNZD.js";
+} from "./chunk-6R2BU3FJ.js";
 import {
   CUSTOMER_LIST_BATCH_ROWS,
   CUSTOMER_LIST_MAX_BATCHES,
   brandSafetyTargetingFields
-} from "./chunk-5B2WEPYR.js";
+} from "./chunk-SQCALAI7.js";
 import "./chunk-GDFJOCDO.js";
 import {
   csvOrJson,
@@ -322,4 +322,4 @@ export {
   savedAudiencesCommand,
   targetingFromSavedAudience
 };
-//# sourceMappingURL=audience-writes-VXQTCSHH.js.map
+//# sourceMappingURL=audience-writes-3PSC7LRY.js.map

package/dist/{audiences-75WHI3A3.js → audiences-UZ2V66OY.js}

@@ -67,11 +67,11 @@ Examples:
   },
   subCommands: {
     list: listCommand,
-    create: () => import("./write-commands-S7AX24WF.js").then((m) => m.audiencesCreateCommand),
-    update: () => import("./write-commands-S7AX24WF.js").then((m) => m.audiencesUpdateCommand),
-    delete: () => import("./audience-writes-VXQTCSHH.js").then((m) => m.audiencesDeleteCommand),
-    members: () => import("./audience-writes-VXQTCSHH.js").then((m) => m.audiencesMembersCommand),
-    saved: () => import("./audience-writes-VXQTCSHH.js").then((m) => m.savedAudiencesCommand)
+    create: () => import("./write-commands-2L7T43YO.js").then((m) => m.audiencesCreateCommand),
+    update: () => import("./write-commands-2L7T43YO.js").then((m) => m.audiencesUpdateCommand),
+    delete: () => import("./audience-writes-3PSC7LRY.js").then((m) => m.audiencesDeleteCommand),
+    members: () => import("./audience-writes-3PSC7LRY.js").then((m) => m.audiencesMembersCommand),
+    saved: () => import("./audience-writes-3PSC7LRY.js").then((m) => m.savedAudiencesCommand)
   },
   // `args` stays even though the parent has no `run`: citty scans rawArgs for the
   // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
@@ -83,4 +83,4 @@ Examples:
 export {
   audiencesCommand
 };
-//# sourceMappingURL=audiences-75WHI3A3.js.map
+//# sourceMappingURL=audiences-UZ2V66OY.js.map

package/dist/{campaigns-WHMJUFYV.js → campaigns-XSAJ3XSB.js}

@@ -1,9 +1,10 @@
 import {
   META_LIST_SHAPE_ARGS,
+  budgetUnitHints,
   registerMetaListSchema,
   shapeMetaListRows,
   writeMetaListRows
-} from "./chunk-C4LZIBNP.js";
+} from "./chunk-KUY26RCF.js";
 import {
   NAME_CONTAINS_ARG,
   csvOrJson,
@@ -71,7 +72,8 @@ var listCommand = defineCommand({
       const shaped = shapeMetaListRows("campaigns", data, args);
       writeMetaListRows("campaigns", shaped, csvOrJson(args), [
         ...statusFilterHints(data, effectiveStatus, "campaigns"),
-        ...advantagePlusHints(data)
+        ...advantagePlusHints(data),
+        ...budgetUnitHints(data)
       ]);
     } catch (err) {
       handleMetaError(err);
@@ -105,14 +107,14 @@ Examples:
   },
   subCommands: {
     list: listCommand,
-    create: () => import("./write-commands-S7AX24WF.js").then((m) => m.campaignsCreateCommand),
-    update: () => import("./write-commands-S7AX24WF.js").then((m) => m.campaignsUpdateCommand),
-    pause: () => import("./write-commands-S7AX24WF.js").then((m) => m.campaignsPauseCommand),
-    resume: () => import("./write-commands-S7AX24WF.js").then((m) => m.campaignsResumeCommand),
-    archive: () => import("./write-commands-S7AX24WF.js").then((m) => m.campaignsArchiveCommand),
-    delete: () => import("./write-commands-S7AX24WF.js").then((m) => m.campaignsDeleteCommand),
-    duplicate: () => import("./write-commands-S7AX24WF.js").then((m) => m.campaignsDuplicateCommand),
-    copy: () => import("./copy-writes-OVCOZODC.js").then((m) => m.campaignsCopyCommand)
+    create: () => import("./write-commands-2L7T43YO.js").then((m) => m.campaignsCreateCommand),
+    update: () => import("./write-commands-2L7T43YO.js").then((m) => m.campaignsUpdateCommand),
+    pause: () => import("./write-commands-2L7T43YO.js").then((m) => m.campaignsPauseCommand),
+    resume: () => import("./write-commands-2L7T43YO.js").then((m) => m.campaignsResumeCommand),
+    archive: () => import("./write-commands-2L7T43YO.js").then((m) => m.campaignsArchiveCommand),
+    delete: () => import("./write-commands-2L7T43YO.js").then((m) => m.campaignsDeleteCommand),
+    duplicate: () => import("./write-commands-2L7T43YO.js").then((m) => m.campaignsDuplicateCommand),
+    copy: () => import("./copy-writes-2XW7VCDE.js").then((m) => m.campaignsCopyCommand)
   },
   // `args` stays even though the parent has no `run`: citty scans rawArgs for the
   // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
@@ -125,4 +127,4 @@ export {
   advantagePlusHints,
   campaignsCommand
 };
-//# sourceMappingURL=campaigns-WHMJUFYV.js.map
+//# sourceMappingURL=campaigns-XSAJ3XSB.js.map

package/dist/campaigns-XSAJ3XSB.js.map

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

package/dist/{catalogs-ORSZM5SY.js → catalogs-AIRFPJAJ.js}

@@ -7,10 +7,10 @@ import {
   requireTarget,
   stageOp,
   upper
-} from "./chunk-YIN6QNZD.js";
+} from "./chunk-6R2BU3FJ.js";
 import {
   retailerIdFilter
-} from "./chunk-5B2WEPYR.js";
+} from "./chunk-SQCALAI7.js";
 import "./chunk-GDFJOCDO.js";
 import {
   csvOrJson,
@@ -776,4 +776,4 @@ export {
   productFieldsFromArgs,
   productSetFilterFromArgs
 };
-//# sourceMappingURL=catalogs-ORSZM5SY.js.map
+//# sourceMappingURL=catalogs-AIRFPJAJ.js.map

package/dist/{chunk-GCLKAQUS.js → chunk-5YFQPJVS.js}

@@ -2,7 +2,7 @@ import {
   failWriteValidation,
   parseDateFlag,
   parseMoneyFlag
-} from "./chunk-YIN6QNZD.js";
+} from "./chunk-6R2BU3FJ.js";
 import {
   repeatedValues
 } from "./chunk-ERSX3MKH.js";
@@ -284,4 +284,4 @@ export {
   clearFromFlags,
   clearArg
 };
-//# sourceMappingURL=chunk-GCLKAQUS.js.map
+//# sourceMappingURL=chunk-5YFQPJVS.js.map

package/dist/{chunk-YIN6QNZD.js → chunk-6R2BU3FJ.js}

@@ -1,6 +1,6 @@
 import {
   metaDraftOpInputSchema
-} from "./chunk-5B2WEPYR.js";
+} from "./chunk-SQCALAI7.js";
 import {
   handleMetaError,
   resolveAccountIdArg
@@ -204,4 +204,4 @@ export {
   stageOps,
   stageStatusChange
 };
-//# sourceMappingURL=chunk-YIN6QNZD.js.map
+//# sourceMappingURL=chunk-6R2BU3FJ.js.map

package/dist/{chunk-PRVX32SQ.js → chunk-HH7B2L3Z.js}

@@ -5,7 +5,7 @@ import {
   requireTarget,
   stageOp,
   stageOps
-} from "./chunk-YIN6QNZD.js";
+} from "./chunk-6R2BU3FJ.js";
 import {
   repeatedValues
 } from "./chunk-ERSX3MKH.js";
@@ -216,4 +216,4 @@ export {
   labelsAttachCommand,
   labelsDetachCommand
 };
-//# sourceMappingURL=chunk-PRVX32SQ.js.map
+//# sourceMappingURL=chunk-HH7B2L3Z.js.map

package/dist/{chunk-C4LZIBNP.js → chunk-KUY26RCF.js}

@@ -129,6 +129,14 @@ function compactActivity(row) {
     ...change !== void 0 ? { change } : {}
   };
 }
+function budgetUnitHints(rows) {
+  const listed = rows.map((row) => Number(row.daily_budget ?? row.lifetime_budget)).find((amount) => Number.isFinite(amount) && amount > 0);
+  if (listed === void 0) return [];
+  const whole = listed / 100;
+  return [
+    `Budgets here are in the account currency's smallest unit, as Meta sends them: daily_budget ${listed} is ${whole} in EUR or USD (currencies without cents, such as JPY, are not divided). Money flags take whole currency: --daily-budget ${whole}, never ${listed}.`
+  ];
+}
 var PROJECTIONS = {
   campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
   adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },
@@ -183,9 +191,10 @@ function registerMetaListSchema(kind, description, args) {
 }
 
 export {
+  budgetUnitHints,
   shapeMetaListRows,
   writeMetaListRows,
   META_LIST_SHAPE_ARGS,
   registerMetaListSchema
 };
-//# sourceMappingURL=chunk-C4LZIBNP.js.map
+//# sourceMappingURL=chunk-KUY26RCF.js.map

package/dist/{chunk-C4LZIBNP.js.map → chunk-KUY26RCF.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/ads/meta/list-rows.ts"],"sourcesContent":["import { registerSchema } from \"../../../schemas.ts\";\nimport { asRecord, type CompactProjection, type ShapedRows, shapeListRows } from \"../list-rows.ts\";\nimport { writeAdsOutput } from \"../output.ts\";\n\n/**\n * The compact row of each Meta listing. The backend asks Graph for every field a\n * write or an audit might need (targeting, tracking specs, three status fields),\n * and 100 campaigns or two days of activity passed through whole ran to 55–78 KB.\n * A compact row carries what an agent decides with; `--fields` reaches any other\n * path and `--full` returns the record Graph sent.\n *\n * `effective_status` is the one status kept: it is what Ads Manager shows, and\n * `status`/`configured_status` only restate the toggle it already folds in.\n *\n * Listings print a table by default: keyed JSON repeats every column name on\n * every row, and 100 campaigns stayed near 30 KB even compact. `--output json`\n * returns the same rows in the envelope.\n */\n\ntype MetaRow = Record<string, unknown>;\n\nexport type MetaListKind = \"campaigns\" | \"adsets\" | \"ads\" | \"activities\";\n\nfunction pick(row: MetaRow, keys: readonly string[]): MetaRow {\n  const picked: MetaRow = {};\n  for (const key of keys) {\n    if (row[key] !== undefined) picked[key] = row[key];\n  }\n  return picked;\n}\n\n/**\n * An account's campaign list is the widest listing an agent reads (100+ rows), so\n * its row is the narrowest: what a campaign is called, whether it runs and what\n * it spends. Objective, bid strategy and Special Ad Category are one `--fields`\n * away; the creation day is enough to order by, and `--fields created_time` has\n * the timestamp.\n */\nconst CAMPAIGN_COLUMNS = [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\", \"created_date\"] as const;\n\n/** Why delivery stops and what Meta suggests: columns only when a row has one. */\nconst DIAGNOSTIC_COLUMNS = [\"issues\", \"suggestions\"] as const;\n\nfunction compactCampaign(row: MetaRow): MetaRow {\n  const created = row.created_time;\n  return {\n    ...pick(row, [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\"]),\n    ...(typeof created === \"string\" ? { created_date: created.slice(0, 10) } : {}),\n    ...diagnostics(row),\n  };\n}\n\nconst ADSET_KEYS = [\n  \"id\",\n  \"name\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"optimization_goal\",\n  \"billing_event\",\n  \"bid_strategy\",\n  \"daily_budget\",\n  \"lifetime_budget\",\n  \"destination_type\",\n  // A Dynamic Creative ad set refuses every new ad, which changes the plan before anything is staged.\n  \"is_dynamic_creative\",\n] as const;\n\nconst ADSET_COLUMNS = [...ADSET_KEYS, \"learning_stage\", \"end_time\", \"created_time\"] as const;\n\nfunction compactAdSet(row: MetaRow): MetaRow {\n  const learning = asRecord(row.learning_stage_info)?.status;\n  return {\n    ...pick(row, ADSET_KEYS),\n    ...(typeof learning === \"string\" ? { learning_stage: learning } : {}),\n    ...pick(row, [\"end_time\", \"created_time\"]),\n    ...diagnostics(row),\n  };\n}\n\nconst AD_COLUMNS = [\n  \"id\",\n  \"name\",\n  \"adset_id\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"creative_id\",\n  \"issues\",\n  \"created_time\",\n] as const;\n\n/** Why an ad is WITH_ISSUES — the one reason to open `issues_info`, in its own words. */\nfunction adIssues(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const issue = asRecord(entry);\n    const text = issue?.error_summary ?? issue?.error_message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Meta's suggestions for a campaign or ad set (`recommendations`), by their titles. */\nfunction suggestions(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const recommendation = asRecord(entry);\n    const text = recommendation?.title ?? recommendation?.message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Why a campaign or ad set cannot deliver, and what Meta suggests — only when Meta says something. */\nfunction diagnostics(row: MetaRow): MetaRow {\n  const issues = adIssues(row.issues_info);\n  const suggested = suggestions(row.recommendations);\n  return {\n    ...(issues.length > 0 ? { issues } : {}),\n    ...(suggested.length > 0 ? { suggestions: suggested } : {}),\n  };\n}\n\nfunction compactAd(row: MetaRow): MetaRow {\n  const creativeId = asRecord(row.creative)?.id;\n  const issues = adIssues(row.issues_info);\n  return {\n    ...pick(row, [\"id\", \"name\", \"adset_id\", \"campaign_id\", \"effective_status\"]),\n    ...(creativeId !== undefined ? { creative_id: creativeId } : {}),\n    ...(issues.length > 0 ? { issues } : {}),\n    ...pick(row, [\"created_time\"]),\n  };\n}\n\nconst ACTIVITY_COLUMNS = [\n  \"event_time\",\n  \"event_type\",\n  \"actor_name\",\n  \"object_type\",\n  \"object_name\",\n  \"object_id\",\n  \"change\",\n] as const;\n\nfunction isScalar(value: unknown): value is string | number | null {\n  return value === null || typeof value === \"string\" || typeof value === \"number\";\n}\n\n/**\n * `extra_data` is a JSON string whose shape varies by event type and carries most\n * of an activity's bytes (image URLs, whole targeting specs). A status, name,\n * budget or goal change stores its before and after as two plain values — those\n * read as one line; any richer change stays behind `--fields extra_data`.\n */\nexport function activityChange(extraData: unknown): string | undefined {\n  if (typeof extraData !== \"string\") return undefined;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(extraData);\n  } catch {\n    return undefined;\n  }\n  const data = asRecord(parsed);\n  // An absent old_value is one this read did not observe, not an unset one — only `null` means \"none\".\n  if (!data || !(\"new_value\" in data) || !(\"old_value\" in data)) return undefined;\n  const { old_value: before, new_value: after } = data;\n  if (!isScalar(before) || !isScalar(after)) return undefined;\n  const show = (value: string | number | null) => (value === null ? \"(none)\" : String(value));\n  return `${show(before)} → ${show(after)}`;\n}\n\nfunction compactActivity(row: MetaRow): MetaRow {\n  const change = activityChange(row.extra_data);\n  return {\n    ...pick(row, [\"event_time\", \"event_type\", \"actor_name\", \"object_type\", \"object_name\", \"object_id\"]),\n    ...(change !== undefined ? { change } : {}),\n  };\n}\n\nconst PROJECTIONS: Record<MetaListKind, CompactProjection<MetaRow>> = {\n  campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  ads: { row: compactAd, columns: AD_COLUMNS },\n  activities: { row: compactActivity, columns: ACTIVITY_COLUMNS },\n};\n\nexport function shapeMetaListRows(kind: MetaListKind, rows: MetaRow[], args: Record<string, unknown>): ShapedRows {\n  return shapeListRows(rows, args, PROJECTIONS[kind]);\n}\n\nconst NOUNS: Record<MetaListKind, string> = {\n  campaigns: \"campaigns\",\n  adsets: \"ad sets\",\n  ads: \"ads\",\n  activities: \"activities\",\n};\n\n/**\n * A table of no rows prints nothing at all, which reads as a failed call — so an empty\n * listing says so, and says why when a status filter may be hiding rows.\n */\nexport function writeMetaListRows(kind: MetaListKind, shaped: ShapedRows, format: string, hints: string[] = []): void {\n  if (format === \"md\" && shaped.rows.length === 0) {\n    process.stdout.write(`${hints.length > 0 ? hints.join(\"\\n\") : `No ${NOUNS[kind]} matched.`}\\n`);\n    return;\n  }\n  writeAdsOutput(shaped.rows, format, shaped.fields, [...hints, ...(shaped.hints ?? [])]);\n}\n\n/** The projection flags every Meta listing shares, worded once for help and `baker schema`. */\nexport const META_LIST_SHAPE_ARGS = {\n  fields: {\n    type: \"string\",\n    description: \"CSV of dotted paths to return instead of the compact row, e.g. id,name,targeting.geo_locations\",\n  },\n  full: { type: \"boolean\", description: \"Return every field Meta sent (targeting, tracking specs, raw extra_data)\" },\n  output: {\n    type: \"string\",\n    description: \"md|json|csv|jsonl — md (default) prints a table; json returns the rows in the { ok, data } envelope\",\n    default: \"md\",\n  },\n} as const;\n\ninterface ListArgDef {\n  type: string;\n  description?: string;\n  default?: unknown;\n}\n\n/**\n * `baker schema ads.meta.<list>`, read off the same arg defs the command parses,\n * so the introspection an agent checks before a call cannot promise a flag the\n * command refuses — `--full` on `adsets` was guessed three times in one Session.\n */\nexport function registerMetaListSchema(\n  kind: MetaListKind,\n  description: string,\n  args: Record<string, ListArgDef>,\n): void {\n  registerSchema({\n    command: `ads.meta.${kind}`,\n    description,\n    args: Object.fromEntries(\n      Object.entries(args).map(([name, def]) => [\n        name,\n        {\n          type: def.type,\n          description: def.description ?? \"\",\n          required: false,\n          ...(def.default !== undefined ? { default: def.default } : {}),\n        },\n      ]),\n    ),\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/commands/ads/meta/list-rows.ts"],"sourcesContent":["import { registerSchema } from \"../../../schemas.ts\";\nimport { asRecord, type CompactProjection, type ShapedRows, shapeListRows } from \"../list-rows.ts\";\nimport { writeAdsOutput } from \"../output.ts\";\n\n/**\n * The compact row of each Meta listing. The backend asks Graph for every field a\n * write or an audit might need (targeting, tracking specs, three status fields),\n * and 100 campaigns or two days of activity passed through whole ran to 55–78 KB.\n * A compact row carries what an agent decides with; `--fields` reaches any other\n * path and `--full` returns the record Graph sent.\n *\n * `effective_status` is the one status kept: it is what Ads Manager shows, and\n * `status`/`configured_status` only restate the toggle it already folds in.\n *\n * Listings print a table by default: keyed JSON repeats every column name on\n * every row, and 100 campaigns stayed near 30 KB even compact. `--output json`\n * returns the same rows in the envelope.\n */\n\ntype MetaRow = Record<string, unknown>;\n\nexport type MetaListKind = \"campaigns\" | \"adsets\" | \"ads\" | \"activities\";\n\nfunction pick(row: MetaRow, keys: readonly string[]): MetaRow {\n  const picked: MetaRow = {};\n  for (const key of keys) {\n    if (row[key] !== undefined) picked[key] = row[key];\n  }\n  return picked;\n}\n\n/**\n * An account's campaign list is the widest listing an agent reads (100+ rows), so\n * its row is the narrowest: what a campaign is called, whether it runs and what\n * it spends. Objective, bid strategy and Special Ad Category are one `--fields`\n * away; the creation day is enough to order by, and `--fields created_time` has\n * the timestamp.\n */\nconst CAMPAIGN_COLUMNS = [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\", \"created_date\"] as const;\n\n/** Why delivery stops and what Meta suggests: columns only when a row has one. */\nconst DIAGNOSTIC_COLUMNS = [\"issues\", \"suggestions\"] as const;\n\nfunction compactCampaign(row: MetaRow): MetaRow {\n  const created = row.created_time;\n  return {\n    ...pick(row, [\"id\", \"name\", \"effective_status\", \"daily_budget\", \"lifetime_budget\"]),\n    ...(typeof created === \"string\" ? { created_date: created.slice(0, 10) } : {}),\n    ...diagnostics(row),\n  };\n}\n\nconst ADSET_KEYS = [\n  \"id\",\n  \"name\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"optimization_goal\",\n  \"billing_event\",\n  \"bid_strategy\",\n  \"daily_budget\",\n  \"lifetime_budget\",\n  \"destination_type\",\n  // A Dynamic Creative ad set refuses every new ad, which changes the plan before anything is staged.\n  \"is_dynamic_creative\",\n] as const;\n\nconst ADSET_COLUMNS = [...ADSET_KEYS, \"learning_stage\", \"end_time\", \"created_time\"] as const;\n\nfunction compactAdSet(row: MetaRow): MetaRow {\n  const learning = asRecord(row.learning_stage_info)?.status;\n  return {\n    ...pick(row, ADSET_KEYS),\n    ...(typeof learning === \"string\" ? { learning_stage: learning } : {}),\n    ...pick(row, [\"end_time\", \"created_time\"]),\n    ...diagnostics(row),\n  };\n}\n\nconst AD_COLUMNS = [\n  \"id\",\n  \"name\",\n  \"adset_id\",\n  \"campaign_id\",\n  \"effective_status\",\n  \"creative_id\",\n  \"issues\",\n  \"created_time\",\n] as const;\n\n/** Why an ad is WITH_ISSUES — the one reason to open `issues_info`, in its own words. */\nfunction adIssues(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const issue = asRecord(entry);\n    const text = issue?.error_summary ?? issue?.error_message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Meta's suggestions for a campaign or ad set (`recommendations`), by their titles. */\nfunction suggestions(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value.flatMap((entry) => {\n    const recommendation = asRecord(entry);\n    const text = recommendation?.title ?? recommendation?.message;\n    return typeof text === \"string\" && text ? [text] : [];\n  });\n}\n\n/** Why a campaign or ad set cannot deliver, and what Meta suggests — only when Meta says something. */\nfunction diagnostics(row: MetaRow): MetaRow {\n  const issues = adIssues(row.issues_info);\n  const suggested = suggestions(row.recommendations);\n  return {\n    ...(issues.length > 0 ? { issues } : {}),\n    ...(suggested.length > 0 ? { suggestions: suggested } : {}),\n  };\n}\n\nfunction compactAd(row: MetaRow): MetaRow {\n  const creativeId = asRecord(row.creative)?.id;\n  const issues = adIssues(row.issues_info);\n  return {\n    ...pick(row, [\"id\", \"name\", \"adset_id\", \"campaign_id\", \"effective_status\"]),\n    ...(creativeId !== undefined ? { creative_id: creativeId } : {}),\n    ...(issues.length > 0 ? { issues } : {}),\n    ...pick(row, [\"created_time\"]),\n  };\n}\n\nconst ACTIVITY_COLUMNS = [\n  \"event_time\",\n  \"event_type\",\n  \"actor_name\",\n  \"object_type\",\n  \"object_name\",\n  \"object_id\",\n  \"change\",\n] as const;\n\nfunction isScalar(value: unknown): value is string | number | null {\n  return value === null || typeof value === \"string\" || typeof value === \"number\";\n}\n\n/**\n * `extra_data` is a JSON string whose shape varies by event type and carries most\n * of an activity's bytes (image URLs, whole targeting specs). A status, name,\n * budget or goal change stores its before and after as two plain values — those\n * read as one line; any richer change stays behind `--fields extra_data`.\n */\nexport function activityChange(extraData: unknown): string | undefined {\n  if (typeof extraData !== \"string\") return undefined;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(extraData);\n  } catch {\n    return undefined;\n  }\n  const data = asRecord(parsed);\n  // An absent old_value is one this read did not observe, not an unset one — only `null` means \"none\".\n  if (!data || !(\"new_value\" in data) || !(\"old_value\" in data)) return undefined;\n  const { old_value: before, new_value: after } = data;\n  if (!isScalar(before) || !isScalar(after)) return undefined;\n  const show = (value: string | number | null) => (value === null ? \"(none)\" : String(value));\n  return `${show(before)} → ${show(after)}`;\n}\n\nfunction compactActivity(row: MetaRow): MetaRow {\n  const change = activityChange(row.extra_data);\n  return {\n    ...pick(row, [\"event_time\", \"event_type\", \"actor_name\", \"object_type\", \"object_name\", \"object_id\"]),\n    ...(change !== undefined ? { change } : {}),\n  };\n}\n\n/**\n * The unit a listing's budgets are in, said once rather than as a column (a\n * 100-campaign table stays small). Meta lists money in the account currency's\n * smallest unit and Baker passes it through unchanged (published reports read\n * it that way), while every money flag takes whole currency. An agent that once\n * took a listed \"8000\" for the flag's unit staged 10,000 EUR a day instead of 100.\n */\nexport function budgetUnitHints(rows: ReadonlyArray<Record<string, unknown>>): string[] {\n  const listed = rows\n    .map((row) => Number(row.daily_budget ?? row.lifetime_budget))\n    .find((amount) => Number.isFinite(amount) && amount > 0);\n  if (listed === undefined) return [];\n  const whole = listed / 100;\n  return [\n    `Budgets here are in the account currency's smallest unit, as Meta sends them: daily_budget ${listed} is ${whole} in EUR or USD (currencies without cents, such as JPY, are not divided). Money flags take whole currency: --daily-budget ${whole}, never ${listed}.`,\n  ];\n}\n\nconst PROJECTIONS: Record<MetaListKind, CompactProjection<MetaRow>> = {\n  campaigns: { row: compactCampaign, columns: CAMPAIGN_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  adsets: { row: compactAdSet, columns: ADSET_COLUMNS, whenPresent: DIAGNOSTIC_COLUMNS },\n  ads: { row: compactAd, columns: AD_COLUMNS },\n  activities: { row: compactActivity, columns: ACTIVITY_COLUMNS },\n};\n\nexport function shapeMetaListRows(kind: MetaListKind, rows: MetaRow[], args: Record<string, unknown>): ShapedRows {\n  return shapeListRows(rows, args, PROJECTIONS[kind]);\n}\n\nconst NOUNS: Record<MetaListKind, string> = {\n  campaigns: \"campaigns\",\n  adsets: \"ad sets\",\n  ads: \"ads\",\n  activities: \"activities\",\n};\n\n/**\n * A table of no rows prints nothing at all, which reads as a failed call — so an empty\n * listing says so, and says why when a status filter may be hiding rows.\n */\nexport function writeMetaListRows(kind: MetaListKind, shaped: ShapedRows, format: string, hints: string[] = []): void {\n  if (format === \"md\" && shaped.rows.length === 0) {\n    process.stdout.write(`${hints.length > 0 ? hints.join(\"\\n\") : `No ${NOUNS[kind]} matched.`}\\n`);\n    return;\n  }\n  writeAdsOutput(shaped.rows, format, shaped.fields, [...hints, ...(shaped.hints ?? [])]);\n}\n\n/** The projection flags every Meta listing shares, worded once for help and `baker schema`. */\nexport const META_LIST_SHAPE_ARGS = {\n  fields: {\n    type: \"string\",\n    description: \"CSV of dotted paths to return instead of the compact row, e.g. id,name,targeting.geo_locations\",\n  },\n  full: { type: \"boolean\", description: \"Return every field Meta sent (targeting, tracking specs, raw extra_data)\" },\n  output: {\n    type: \"string\",\n    description: \"md|json|csv|jsonl — md (default) prints a table; json returns the rows in the { ok, data } envelope\",\n    default: \"md\",\n  },\n} as const;\n\ninterface ListArgDef {\n  type: string;\n  description?: string;\n  default?: unknown;\n}\n\n/**\n * `baker schema ads.meta.<list>`, read off the same arg defs the command parses,\n * so the introspection an agent checks before a call cannot promise a flag the\n * command refuses — `--full` on `adsets` was guessed three times in one Session.\n */\nexport function registerMetaListSchema(\n  kind: MetaListKind,\n  description: string,\n  args: Record<string, ListArgDef>,\n): void {\n  registerSchema({\n    command: `ads.meta.${kind}`,\n    description,\n    args: Object.fromEntries(\n      Object.entries(args).map(([name, def]) => [\n        name,\n        {\n          type: def.type,\n          description: def.description ?? \"\",\n          required: false,\n          ...(def.default !== undefined ? { default: def.default } : {}),\n        },\n      ]),\n    ),\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-YGCRKABE.js → chunk-SHLA4JF7.js}

@@ -5,7 +5,7 @@ import {
   UNHASHED_CUSTOMER_LIST_KEYS,
   customAudienceMembersSchema,
   customerListBatchSchema
-} from "./chunk-5B2WEPYR.js";
+} from "./chunk-SQCALAI7.js";
 
 // src/commands/ads/meta/customer-list.ts
 import { createHash } from "crypto";
@@ -388,4 +388,4 @@ export {
   customerListBatches,
   customerListUploadRefusal
 };
-//# sourceMappingURL=chunk-YGCRKABE.js.map
+//# sourceMappingURL=chunk-SHLA4JF7.js.map

package/dist/{chunk-5B2WEPYR.js → chunk-SQCALAI7.js}

@@ -4157,11 +4157,14 @@ function createOp(kind, payload) {
 function updateOp(kind, payload) {
   return z12.object({ kind: z12.literal(kind), accountId: accountIdSchema, target: updateTargetSchema, payload });
 }
+function budgetUpdateOp(kind, payload) {
+  return updateOp(kind, payload).extend({ confirmBudgetIncrease: z12.boolean().optional() });
+}
 var metaDraftOpInputSchema = z12.discriminatedUnion("kind", [
   createOp("campaign.create", campaignCreateSchema),
-  updateOp("campaign.update", campaignUpdateSchema),
+  budgetUpdateOp("campaign.update", campaignUpdateSchema),
   createOp("adSet.create", adSetCreateSchema),
-  updateOp("adSet.update", adSetUpdateSchema),
+  budgetUpdateOp("adSet.update", adSetUpdateSchema),
   createOp("adCreative.create", adCreativeCreateSchema),
   updateOp("adCreative.update", adCreativeUpdateSchema),
   createOp("ad.create", adCreateSchema),
@@ -4223,4 +4226,4 @@ export {
   metaTargetingSchema,
   metaDraftOpInputSchema
 };
-//# sourceMappingURL=chunk-5B2WEPYR.js.map
+//# sourceMappingURL=chunk-SQCALAI7.js.map