@wrangled/cli 0.3.51 → 0.3.52

package/dist/guide.js

@@ -385,6 +385,7 @@ ${cli} content unpublish <deployment-id> [--force]   take one deployed landing p
 ${cli} meta adset publish --plan '<json>' --idempotency-key <key> [--run <run-id>]   make a paused Meta ad set to add ads to
 ${cli} meta adset show <id> | meta adset reconcile <id>   read an ad set publication, or check whether one left sending landed
 ${cli} meta ad create --account act_<id> --adset <id> --file <path> --text "<words>" --headline "<h>" --link <url> [--cta <type>] [--name <n>] [--status paused|active --reason "<why>"] [--run <run-id>]   make a Facebook ad from files in one step
+${cli} meta adset budget <id> | meta campaign budget <id> (--percent <n> | --daily <n>) --reason "<why>"   change a daily budget within the workspace's limits
 ${cli} content publish-record <sku> --file <publication.json>   record a publish before sending it
 ${cli} content publish-finish <publication-id> --status sending|published|failed|not_sent_practice [--input '<json>']
 ${cli} content track-link <sku> <url> [--channel facebook|email|sms|web] [--campaign <id>]   tag a link with its SKU
@@ -392,6 +393,7 @@ ${cli} agent start | show <run-id> | runs | finish <run-id> --status <s> --file
 ${cli} agent draft --agent p3_refresh   the P3 refresh hand's counted draft
 ${cli} brand get | brand set --file <path> [--sources '<json>' | @file.json]
 ${cli} proposals create --input '<json>' | proposals list [--status <s>] [--run <run-id>]
+${cli} proposals execute <proposal-id>   apply an approved pause or budget proposal to Meta, in live mode only
 ${cli} content add-page <url>      add a landing page and read it now
 ${cli} plans create --name <name> --goal <text> --channel meta|ghl|klaviyo|web [--target '<json>'] [--landing <sku> | --landing-url <url>] [--funnel <key> --step <key>] [--run <agent-run-id>]   plan a campaign push
 ${cli} plans show <plan-id> | plans add <plan-id> <sku> [--role <role>] [--position <n>] | plans remove <plan-id> <sku>

package/dist/main.js

@@ -1029,8 +1029,10 @@ const commands = {
     "meta ads resume": metaStatusCommand("ads", "resume"),
     "meta adset pause": metaStatusCommand("adset", "pause"),
     "meta adset resume": metaStatusCommand("adset", "resume"),
+    "meta adset budget": metaBudgetCommand("adset"),
+    "meta campaign budget": metaBudgetCommand("campaign"),
     "meta changes": {
-        usage: "meta changes [--since <YYYY-MM-DD>]   the log of Meta ads and ad sets turned on or off, newest first",
+        usage: "meta changes [--since <YYYY-MM-DD>]   the log of Meta ads and ad sets turned on or off and budgets changed, newest first",
         async run(args, options) {
             if (args.length !== 0)
                 throw new CliError("Usage: meta changes [--since <YYYY-MM-DD>]", exitCodes.usage);
@@ -1044,7 +1046,7 @@ const commands = {
         },
     },
     "meta changes undo": {
-        usage: 'meta changes undo <change-id> --reason "<why>" [--idempotency-key <key>]   put the ad or ad set back the way it was',
+        usage: 'meta changes undo <change-id> --reason "<why>" [--idempotency-key <key>]   put the ad, ad set or budget back the way it was',
         async run(args, options) {
             if (args.length !== 1 || !options.reason)
                 throw new CliError('Usage: meta changes undo <change-id> --reason "<why>" [--idempotency-key <key>]', exitCodes.usage);
@@ -1053,7 +1055,7 @@ const commands = {
                 reason: options.reason,
                 idempotencyKey,
             });
-            printMetaStatusResult(result, options.format);
+            printMetaChangeResult(result, options.format);
         },
     },
     "meta changes reconcile": {
@@ -1062,7 +1064,7 @@ const commands = {
             if (args.length !== 1)
                 throw new CliError("Usage: meta changes reconcile <change-id>", exitCodes.usage);
             const { change } = await api(await resolveConnection(options), `/api/v1/meta/changes/${encodeURIComponent(args[0])}/reconcile`, {});
-            printMetaStatusResult({ changes: [change], unchanged: [] }, options.format);
+            printMetaChangeResult({ changes: [change], unchanged: [] }, options.format);
         },
     },
     "content unpublish": {
@@ -2058,6 +2060,15 @@ const commands = {
             console.log(renderTable(PROPOSAL_COLUMNS, proposals.map(proposalRow)));
         },
     },
+    "proposals execute": {
+        usage: "proposals execute <proposal-id>   apply an approved pause or budget proposal to Meta (live mode only), within the control list",
+        async run(args, options) {
+            if (args.length !== 1)
+                throw new CliError("Usage: proposals execute <proposal-id>", exitCodes.usage);
+            const result = await api(await resolveConnection(options), `/api/v1/proposals/${encodeURIComponent(args[0])}/execute`, {});
+            printMetaChangeResult(result, options.format);
+        },
+    },
     "skill publish": {
         usage: "skill publish <dir> [--notes <text>] [--harness claude,codex]",
         async run(args, options) {
@@ -2887,7 +2898,9 @@ Options:
   --tool-run <id>       a succeeded tool run content create and edit link; repeat for several
   --run <id>            the agent run making the content (content) or the Meta change (meta ads|adset), the tool run to
                         record (creatives create), or the tool run whose outputs media list shows
-  --reason <why>        why: what meta ads|adset pause|resume, meta changes undo and meta ad create --status active record in the change log
+  --reason <why>        why: what meta ads|adset pause|resume, meta adset|campaign budget, meta changes undo and meta ad create --status active record in the change log
+  --percent <n>         with meta adset|campaign budget, the whole-number percent change from Meta's daily budget now (--percent=-10 lowers it)
+  --daily <n>           with meta adset|campaign budget, the new daily budget in the currency's smallest unit (6000 is 60.00 USD)
   --account <act_id>    meta ad create: the ad account
   --adset <id>          meta ad create: the ad set the new ad goes into
   --text <text | @file> meta ad create: the ad's primary text
@@ -2992,6 +3005,8 @@ function parseOptions(argv) {
             limit: { type: "string" },
             run: { type: "string" },
             reason: { type: "string" },
+            percent: { type: "string" },
+            daily: { type: "string" },
             lineage: { type: "string" },
             tags: { type: "string" },
             sources: { type: "string" },
@@ -3122,6 +3137,8 @@ function parseOptions(argv) {
             limit: values.limit,
             run: values.run,
             reason: values.reason,
+            percent: values.percent,
+            daily: values.daily,
             lineage: values.lineage,
             tags: values.tags,
             sources: values.sources,
@@ -3692,7 +3709,35 @@ function metaStatusCommand(noun, verb) {
                 idempotencyKey,
                 ...(options.run === undefined ? {} : { runId: options.run }),
             });
-            printMetaStatusResult(result, options.format);
+            printMetaChangeResult(result, options.format);
+        },
+    };
+}
+/** A daily budget change, for agents to compute from Meta's budget now (--percent) or to set outright in the currency's smallest unit (--daily). */
+function metaBudgetCommand(level) {
+    const usage = `meta ${level} budget <${level}-id> (--percent <n> | --daily <smallest units>) --reason "<why>" [--run <run-id>] [--idempotency-key <key>]`;
+    return {
+        usage: `${usage}   change ${level === "adset" ? "an ad set's" : "a campaign's"} daily budget on the control list, within the workspace's limits`,
+        async run(args, options) {
+            if (args.length !== 1 || !options.reason || (options.percent === undefined) === (options.daily === undefined))
+                throw new CliError(`Usage: ${usage}`, exitCodes.usage);
+            const whole = (text, flag) => {
+                const n = Number(text);
+                if (text.trim() === "" || !Number.isInteger(n))
+                    throw new CliError(`${flag} must be a whole number.`, exitCodes.usage);
+                return n;
+            };
+            const amount = options.percent !== undefined ? { changePercent: whole(options.percent, "--percent") } : { dailyBudget: whole(options.daily, "--daily") };
+            const idempotencyKey = options.idempotencyKey ?? announceKey(`budget-${randomUUID()}`);
+            const result = await api(await resolveConnection(options), "/api/v1/meta/budgets", {
+                level,
+                id: args[0],
+                ...amount,
+                reason: options.reason,
+                idempotencyKey,
+                ...(options.run === undefined ? {} : { runId: options.run }),
+            });
+            printMetaChangeResult(result, options.format);
         },
     };
 }
@@ -3701,7 +3746,7 @@ function metaChangeRow(c) {
         id: c.id,
         level: c.level,
         object: c.objectId,
-        change: `${c.before.status} -> ${c.after.status}`,
+        change: c.kind === "budget" ? `daily budget ${c.before.dailyBudget} -> ${c.after.dailyBudget}` : `${c.before.status} -> ${c.after.status}`,
         status: c.undoneBy ? `${c.status} (undone by ${c.undoneBy})` : c.error ? `${c.status}: ${c.error}` : c.status,
         when: c.createdAt,
         by: c.requestedBy,
@@ -3713,13 +3758,15 @@ function announceKey(key) {
     console.error(`Idempotency key: ${key} (if no answer comes, send the same command again with --idempotency-key ${key})`);
     return key;
 }
-function printMetaStatusResult(result, format) {
+function printMetaChangeResult(result, format) {
     if (format === "json")
         return printJson(result);
     if (result.changes.length > 0)
         console.log(renderTable(META_CHANGE_COLUMNS, result.changes.map(metaChangeRow)));
-    for (const u of result.unchanged)
-        console.log(`${u.level === "ad" ? "Ad" : "Ad set"} ${u.objectId} was already ${u.status}; nothing was sent.`);
+    for (const u of result.unchanged) {
+        const what = { ad: "Ad", adset: "Ad set", campaign: "Campaign" }[u.level];
+        console.log("status" in u ? `${what} ${u.objectId} was already ${u.status}; nothing was sent.` : `${what} ${u.objectId}'s daily budget is already ${u.dailyBudget}; nothing was sent.`);
+    }
     for (const c of result.changes.filter((c) => c.status === "sending")) {
         console.log(`Meta's answer for change ${c.id} was lost. Run \`${brand.slug} meta changes reconcile ${c.id}\` in a minute to settle it.`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrangled/cli",
-  "version": "0.3.51",
+  "version": "0.3.52",
   "description": "Command-line access to your marketing data warehouse, for people and coding agents",
   "type": "module",
   "bin": {