@wrangled/cli 0.3.14 → 0.3.15

package/dist/guide.js

@@ -172,6 +172,8 @@ Ads not made here (built by hand or by an agency, names in no pattern) get the m
 
 To suggest tags, write them as JSON and run \`${cli} ads tag --file tags.json\` (or pipe it on stdin), up to 500 ads at a time: \`{"ads": [{"ad_id": "120214567890123", "tags": {"angle": "discovery", "desire": "money", "hook_spot": "spoken", "hook_text": "$29,000 is the smallest lead", "hook_kind": "big_win", "format": "video", "style": "presenter", "tag_reasons": {"worry": "none"}}, "confidence": "medium", "evidence": {"ad_name": "County lead v2", "transcript_start": "$29,000 is the smallest lead"}}]}\`. The tag fields are \`marketing\`, \`offer_key\`, \`landing_funnel_key\`, \`landing_step_key\`, \`persona\`, \`awareness\`, \`concept\`, \`angle\`, \`desire\`, \`hook_spot\`, \`hook_text\`, \`hook_kind\`, \`hook2_spot\`, \`hook2_kind\`, \`format\`, \`style\`, \`speaker\`, \`cta\`, \`proof\` and \`worry\`; leave out what you did not judge. A part with no value goes in \`tag_reasons\` as \`none\` (nothing on its list applies) or \`unclear\` (too little to judge, never \`high\` confidence). Confidence is \`high\`, \`medium\` or \`low\`. A value off its list is refused with the allowed values. New tags replace an ad's proposed ones, which stay as \`replaced\`; an ad whose tags a person confirmed is kept as it is.
 
+To have the server tag ads for you, run \`${cli} ads autotag\` (\`--limit <n>\`, 1 to 100, default 25; \`--ad <id>\` for one ad; \`--json\`). It takes the biggest spenders with no tags yet, so each run moves on to the next ones (with \`--ad\`, that ad, its proposed tags asked about again and confirmed ones kept), reads each one's copy, video transcript and picture description, and asks TypeSafe's Jev the grammar's questions through the tool gateway, so a run's tool cap applies. Ads with the same copy, headlines, button, link and media are asked about once and share the tags; asking again about an unchanged ad costs nothing. It costs a tiny fraction of a cent per ad. The tags are proposed, with each part's confidence in the evidence; read them with \`${cli} ads tags\`.
+
 For what worked, query the \`ad_performance_tagged\` view: every Meta ad's daily results with its live tags next to them, \`tags_source\` (\`ad_tags\`, or null when untagged) and \`tags_status\`.
 
 ## Ad words
@@ -285,6 +287,7 @@ ${cli} funnels draft --file <map.json> [--note <why>] [--evidence '<json>' | @fi
 ${cli} facts [--kind <kind>] [--subject <type>[:<ref>]] [--status <status>] [--json] | facts show <id>   settled facts about the data, to treat as true
 ${cli} facts propose --file <fact.json>   suggest a fact for a person to confirm
 ${cli} ads tags [--ad <id>] [--status <status>] [--limit <n>] | ads tag --file <tags.json>   the marketing tags of ads not made here, and suggesting them
+${cli} ads autotag [--limit <n>] [--ad <id>]   have the server propose tags for the biggest spenders not yet tagged
 ${cli} grammar [--format json]   every list ads are tagged from, this client's personas and concepts included
 ${cli} grammar propose --file <values.json>   suggest personas and concepts for a person to confirm
 ${cli} voice [--kind opener|objection|phrase] [--limit <n>] [--json]   what customers keep saying, grouped and counted, with real quotes

package/dist/main.js

@@ -1156,6 +1156,32 @@ const commands = {
                 console.log(`Kept as they are, since a person confirmed their tags: ${result.kept.map((k) => k.adId).join(", ")}.`);
         },
     },
+    "ads autotag": {
+        usage: "ads autotag [--limit <n>] [--ad <id>] [--json]   propose marketing tags for the biggest-spending ads not yet tagged, or one ad",
+        async run(args, options) {
+            if (args.length > 0)
+                throw new CliError("Usage: ads autotag [--limit <n>] [--ad <id>] [--json]", exitCodes.usage);
+            const body = { ...(options.ad ? { ad_ids: [options.ad] } : {}), ...(options.limit ? { limit: Number(options.limit) } : {}) };
+            const result = await api(await resolveConnection(options.apiUrl), AD_AUTOTAG_PATH, body);
+            if (options.format === "json")
+                return printJson(result);
+            const plural = (n) => `${n} ${n === 1 ? "ad" : "ads"}`;
+            console.log(`Proposed tags for ${plural(result.proposed.length)}, asking about ${result.creatives} ${result.creatives === 1 ? "creative" : "creatives"} for $${result.costUsd.toFixed(4)}. A person confirms or rejects them in the app.`);
+            if (result.proposed.length > 0)
+                console.log(renderTable(["ad", "id", "confidence"], result.proposed.map((p) => ({ ad: p.adId, id: p.id, confidence: p.confidence }))));
+            if (result.kept.length > 0)
+                console.log(`Kept as they are, since a person confirmed their tags: ${result.kept.join(", ")}.`);
+            for (const reason of ["not_marketing", "gate_unclear", "no_content", "not_found"]) {
+                const ids = result.skipped.filter((s) => s.reason === reason).map((s) => s.adId);
+                if (ids.length > 0)
+                    console.log(`${SKIP_REASONS[reason]}: ${ids.join(", ")}.`);
+            }
+            for (const failure of result.failed)
+                console.log(`Failed for ${failure.adIds.join(", ")}: ${failure.error}`);
+            if (result.stopped === "tool_cap")
+                console.log("Stopped early: the run's tool spending cap was reached.");
+        },
+    },
     "facts show": {
         usage: "facts show <id>   one fact with its value and evidence",
         async run(args, options) {
@@ -1683,6 +1709,8 @@ function printReport(title, report, labels, numbers) {
 const agentPath = (options) => `/api/v1/agents/${encodeURIComponent(options.agent)}`;
 const FACTS_PATH = "/api/v1/facts";
 const AD_TAGS_PATH = "/api/v1/ad-tags";
+const AD_AUTOTAG_PATH = "/api/v1/ad-tags/autotag";
+const SKIP_REASONS = { not_marketing: "Not marketing, so only that answer was saved", gate_unclear: "Could not tell whether it is marketing, so only that was saved", no_content: "Nothing to read", not_found: "No such ad" };
 const AD_TAG_COLUMNS = ["id", "ad", "status", "confidence", "offer", "persona", "angle", "hook", "format", "author"];
 const GRAMMAR_PATH = "/api/v1/grammar";
 const VOICE_LISTS_PATH = "/api/v1/voice-lists";
@@ -1818,9 +1846,9 @@ Options:
   --from, --to <n>      with content diff, the two versions to compare (default: the one before the current one, and the current one)
   --sort <column>       how content search sorts: recent (default) or a content_scorecard number, such as click_rate or roas
   --order desc|asc      content search's sort direction (default: desc, best or newest first)
-  --limit <n>           how many results content search, creatives list, campaigns, voice and ads tags return
+  --limit <n>           how many results content search, creatives list, campaigns, voice and ads tags return, or how many ads ads autotag tags
   --library <slug>      with knowledge search, only this library, such as creative-cartel
-  --ad <id>             with ads tags, only this Meta ad's tags
+  --ad <id>             with ads tags, only this Meta ad's tags; with ads autotag, only this ad
   --max-seconds <n>     stop a runner's run after this many seconds, if that comes before its deadline
   --workspace <slug>    for worker promote and worker drop: the workspace whose hand they change
   -h, --help            show this help

package/package.json

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