@wrangled/cli 0.3.49 → 0.3.50

package/dist/api.js

@@ -21,6 +21,8 @@ export class UnreadableCredentialsError extends CliError {
  * in src/lib/knowledge/tags.ts. format's flag is --ad-format, because --format picks the output.
  */
 export const entryTagFlags = { angle: "angle", hook_kind: "hook-kind", format: "ad-format", awareness: "awareness" };
+/** The most ads or ad sets one meta ads|adset pause|resume sends; the server refuses more. */
+export const META_IDS_MAX = 10;
 /** The days before a sale in which a click or reply helps it, as the app counts them (MESSAGE_CREDIT_DAYS). */
 export const MESSAGE_CREDIT_DAYS = 7;
 /** Copies of the server's IMPORT_LIMITS and import name rule; src/lib/cli-consistency.test.ts keeps them in step. */

package/dist/main.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
 import { mkdir, readFile, stat } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, dirname, extname, join, resolve } from "node:path";
 import { parseArgs } from "node:util";
-import { api, ApiError, apiDownload, apiText, apiUpload, CliError, exitCodes, getSigned, IMPORT_LIMITS, IMPORT_NAME_PATTERN, putSigned, CLIENT_FILE, parseClientName, readSavedLogins, removeCredentials, resolveApiUrl, resolveConnection, resolveLogin, UnreadableCredentialsError, writeCredentials, entryTagFlags, streamSigned, } from "./api.js";
+import { api, ApiError, apiDownload, apiText, apiUpload, CliError, exitCodes, getSigned, IMPORT_LIMITS, META_IDS_MAX, IMPORT_NAME_PATTERN, putSigned, CLIENT_FILE, parseClientName, readSavedLogins, removeCredentials, resolveApiUrl, resolveConnection, resolveLogin, UnreadableCredentialsError, writeCredentials, entryTagFlags, streamSigned, } from "./api.js";
 import { brand, envPrefix } from "./brand.js";
 import { firstSymlink, inRunFolder, writeFileAtomic } from "./files.js";
 import { scheduleCreateBody, scheduleIdFor, SCHEDULES_CREATE_USAGE } from "./schedules.js";
@@ -17,6 +18,7 @@ import { AGENT_ENV, HARNESS_COMMAND_ENV, RUNNER_TOKEN_ENV, runLoop, runOnce } fr
 import { SKILL_NAME_PATTERN } from "./skill-zip.js";
 import { installSkillFolder, operatorConnection, packSkill, parseSkillRef, readSkillFolder, unpackSkill, } from "./skills.js";
 const DEFAULT_WAIT_SECONDS = 300;
+const META_CHANGE_COLUMNS = ["id", "level", "object", "change", "status", "when", "by", "reason"];
 const SERVER_WAIT_CAP = 50;
 const VOICE_USAGE = "voice [--kind opener|objection|pain|desire|phrase] [--since <YYYY-MM-DD>] [--sort common|useful] [--limit <n>] [--json]";
 const commands = {
@@ -997,6 +999,46 @@ const commands = {
             printAdSetPublication(adsetPublication, options.format);
         },
     },
+    "meta ads pause": metaStatusCommand("ads", "pause"),
+    "meta ads resume": metaStatusCommand("ads", "resume"),
+    "meta adset pause": metaStatusCommand("adset", "pause"),
+    "meta adset resume": metaStatusCommand("adset", "resume"),
+    "meta changes": {
+        usage: "meta changes [--since <YYYY-MM-DD>]   the log of Meta ads and ad sets turned on or off, newest first",
+        async run(args, options) {
+            if (args.length !== 0)
+                throw new CliError("Usage: meta changes [--since <YYYY-MM-DD>]", exitCodes.usage);
+            const query = new URLSearchParams();
+            if (options.since)
+                query.set("since", options.since);
+            const { changes } = await api(await resolveConnection(options), `/api/v1/meta/changes${query.size ? `?${query}` : ""}`);
+            if (options.format === "json")
+                return printJson({ changes });
+            console.log(changes.length ? renderTable(META_CHANGE_COLUMNS, changes.map(metaChangeRow)) : "No Meta changes yet.");
+        },
+    },
+    "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',
+        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);
+            const idempotencyKey = options.idempotencyKey ?? announceKey(`undo-${randomUUID()}`);
+            const result = await api(await resolveConnection(options), `/api/v1/meta/changes/${encodeURIComponent(args[0])}/undo`, {
+                reason: options.reason,
+                idempotencyKey,
+            });
+            printMetaStatusResult(result, options.format);
+        },
+    },
+    "meta changes reconcile": {
+        usage: "meta changes reconcile <change-id>   settle a change Meta's answer was lost for, from what Meta reads now",
+        async run(args, options) {
+            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);
+        },
+    },
     "content unpublish": {
         usage: "content unpublish <deployment-id> [--force]",
         async run(args, options) {
@@ -2817,13 +2859,14 @@ Options:
   --source <text>       where the content content capture saves came from, in words
   --url <url>           the address of the content content capture saves
   --tool-run <id>       a succeeded tool run content create and edit link; repeat for several
-  --run <id>            the agent run making the content (content), the tool run to record (creatives create), or the tool
-                        run whose outputs media list shows
+  --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 and meta changes undo record in the change log
   --sku <sku>           with media list, only the output that became this creative
   --tool <tool>         with media list, only this tool's outputs, such as kie:nano-banana
   --kind image|video    with media list, only images or only videos
   --since, --until <YYYY-MM-DD | ISO time>   with media list, made at or after --since and before --until (a day: through
-                        its end, in UTC)
+                        its end, in UTC); with meta changes, only changes from --since on
   --cursor <media-id>   with media list, the next page: the id it printed after "More"
   --platform, --external-id   where content status launched says it was published, and that platform's id for it
   --object-type <type>  what that platform's sync calls it (campaign_message or flow_message on klaviyo); needed where
@@ -2916,6 +2959,7 @@ function parseOptions(argv) {
             ad: { type: "string" },
             limit: { type: "string" },
             run: { type: "string" },
+            reason: { type: "string" },
             lineage: { type: "string" },
             tags: { type: "string" },
             sources: { type: "string" },
@@ -3041,6 +3085,7 @@ function parseOptions(argv) {
             ad: values.ad,
             limit: values.limit,
             run: values.run,
+            reason: values.reason,
             lineage: values.lineage,
             tags: values.tags,
             sources: values.sources,
@@ -3581,6 +3626,54 @@ function printPublication(publication, format) {
         finished: publication.finishedAt,
     });
 }
+function metaStatusCommand(noun, verb) {
+    const usage = `meta ${noun} ${verb} <${noun === "ads" ? "ad" : "adset"}-id>... --reason "<why>" [--run <run-id>] [--idempotency-key <key>]`;
+    return {
+        usage: `${usage}   ${verb === "pause" ? "turn off" : "turn on"} up to ${META_IDS_MAX} ${noun === "ads" ? "ads" : "ad sets"} on the control list`,
+        async run(args, options) {
+            if (args.length === 0 || args.length > META_IDS_MAX || !options.reason)
+                throw new CliError(`Usage: ${usage}`, exitCodes.usage);
+            const idempotencyKey = options.idempotencyKey ?? announceKey(`${verb}-${randomUUID()}`);
+            const result = await api(await resolveConnection(options), "/api/v1/meta/changes", {
+                level: noun === "ads" ? "ad" : "adset",
+                ids: args,
+                status: verb === "pause" ? "paused" : "active",
+                reason: options.reason,
+                idempotencyKey,
+                ...(options.run === undefined ? {} : { runId: options.run }),
+            });
+            printMetaStatusResult(result, options.format);
+        },
+    };
+}
+function metaChangeRow(c) {
+    return {
+        id: c.id,
+        level: c.level,
+        object: c.objectId,
+        change: `${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,
+        reason: excerpt(c.reason, 60),
+    };
+}
+/** Told on stderr before the request goes out, so a request whose answer is lost can be sent again with the same key. */
+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) {
+    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 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.`);
+    }
+}
 function printAdSetPublication(publication, format) {
     if (format === "json")
         return printJson({ adsetPublication: publication });

package/package.json

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