@wrangled/cli 0.3.43 → 0.3.45

package/dist/main.js

@@ -4,7 +4,7 @@ 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, readCredentials, removeCredentials, resolveApiUrl, resolveConnection, UnreadableCredentialsError, writeCredentials, entryTagFlags, streamSigned, } from "./api.js";
+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 { brand, envPrefix } from "./brand.js";
 import { firstSymlink, inRunFolder, writeFileAtomic } from "./files.js";
 import { guide, skill } from "./guide.js";
@@ -19,41 +19,47 @@ 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 = {
     login: {
-        usage: `login   (paste the key when asked, pipe it on stdin, or set ${envPrefix}_API_KEY)`,
+        usage: `login [--client <name>]   (paste the key when asked, pipe it on stdin, or set ${envPrefix}_API_KEY); --client saves it under that client's name`,
         async run(args, options) {
             if (args.length > 0) {
                 throw new CliError(`login takes no arguments. Pipe the key on stdin or set ${envPrefix}_API_KEY.`, exitCodes.usage);
             }
+            const client = options.client === undefined ? undefined : parseClientName(options.client);
             const apiKey = await readKeyFromUser();
-            const stored = await readCredentials().catch((error) => {
+            const saved = await readSavedLogins().catch((error) => {
                 if (error instanceof UnreadableCredentialsError)
                     return null;
                 throw error;
             });
-            const apiUrl = resolveApiUrl(options.apiUrl, stored);
+            const apiUrl = resolveApiUrl(options.apiUrl, (client === undefined ? undefined : saved?.clients[client]) ?? saved?.default ?? null);
             const me = await api({ apiUrl, apiKey }, "/api/v1/me");
-            const path = await writeCredentials({ apiKey, apiUrl });
+            const path = await writeCredentials({ apiKey, apiUrl }, { client });
             if (options.format === "json")
                 return printJson(me);
-            console.log(`Logged in to ${me.workspace.name} (${me.workspace.slug}) at ${apiUrl}.`);
+            console.log(`Logged in to ${me.workspace.name} (${me.workspace.slug}) at ${apiUrl}${client === undefined ? "" : ` as client ${client}`}.`);
             console.log(`Saved credentials to ${path}.`);
         },
     },
     logout: {
-        usage: "logout",
-        async run() {
-            await removeCredentials();
-            console.log("Logged out.");
+        usage: "logout [--client <name>]   (without --client, removes the default login and keeps named clients)",
+        async run(_args, options) {
+            const client = options.client === undefined ? undefined : parseClientName(options.client);
+            await removeCredentials(client);
+            console.log(client === undefined ? "Logged out." : `Logged out of client ${client}.`);
         },
     },
     whoami: {
-        usage: "whoami",
+        usage: "whoami   (also says which client's key is in use and why)",
         async run(_args, options) {
-            const me = await api(await resolveConnection(options.apiUrl), "/api/v1/me");
+            const { connection, choice } = await resolveLogin(options);
+            const me = await api(connection, "/api/v1/me");
+            const client = "client" in choice ? choice.client : null;
+            const clientFile = choice.source === "folder" ? choice.path : null;
             if (options.format === "json")
-                return printJson(me);
+                return printJson({ ...me, client, source: choice.source, clientFile });
             const { name, slug, id } = me.workspace;
             console.log(renderTable(["workspace", "slug", "id", "library access"], [{ workspace: name, slug, id, "library access": me.knowledge ? "on" : "off" }]));
+            console.log(`\n${clientReason(choice)}`);
         },
     },
     "knowledge search": {
@@ -72,7 +78,7 @@ const commands = {
                 query.set("library", options.library);
             for (const [field, value] of filters)
                 query.set(field, value);
-            const answer = await api(await resolveConnection(options.apiUrl), `/api/v1/knowledge/search?${query}`);
+            const answer = await api(await resolveConnection(options), `/api/v1/knowledge/search?${query}`);
             if (options.format === "json")
                 return printJson(answer);
             console.log(answer.results.length === 0 ? "Nothing in the library matched." : answer.results.map(knowledgeBlock).join("\n\n"));
@@ -102,7 +108,7 @@ const commands = {
                     })),
                 }
                 : await readToolInput(options);
-            const result = await api(await resolveConnection(options.apiUrl), KNOWLEDGE_TAGS_PATH, body);
+            const result = await api(await resolveConnection(options), KNOWLEDGE_TAGS_PATH, body);
             if (options.format === "json")
                 return printJson(result);
             console.log(`Tagged ${result.tagged}, took off ${result.removed}.`);
@@ -121,7 +127,7 @@ const commands = {
             if (options.search !== undefined)
                 query.set("search", options.search);
             const path = `/api/v1/warehouse/schema${query.size > 0 ? `?${query}` : ""}`;
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             if (options.summary) {
                 const summary = await api(connection, path);
                 if (options.format === "json")
@@ -162,7 +168,7 @@ const commands = {
                 throw new CliError("--all saves to a file: add --out <file.csv | file.ndjson | file.json>.", exitCodes.usage);
             }
             const sql = await readSql(args, options.file);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             if (options.all)
                 return saveWholeAnswer(connection, sql, options.out, options.format);
             const text = await apiText(connection, "/api/v1/warehouse/query", { sql });
@@ -182,7 +188,7 @@ const commands = {
             if (args.length > 0)
                 throw new CliError("Usage: funnel [--from <date>] [--to <date>] [--grain day|week|month]", exitCodes.usage);
             const query = reportQuery(options, { grain: options.grain });
-            const { funnel } = await api(await resolveConnection(options.apiUrl), `/api/v1/reports/funnel${query}`);
+            const { funnel } = await api(await resolveConnection(options), `/api/v1/reports/funnel${query}`);
             if (options.format === "json")
                 return printJson({ funnel });
             printReport(`Funnel by ${funnel.grain}`, funnel, ["period", "currency"], FUNNEL_NUMBERS);
@@ -195,7 +201,7 @@ const commands = {
             if (args.length > 0)
                 throw new CliError("Usage: money [--from <date>] [--to <date>] [--grain day|week|month]", exitCodes.usage);
             const query = reportQuery(options, { grain: options.grain });
-            const { money } = await api(await resolveConnection(options.apiUrl), `/api/v1/reports/money${query}`);
+            const { money } = await api(await resolveConnection(options), `/api/v1/reports/money${query}`);
             if (options.format === "json")
                 return printJson({ money });
             printReport(`Money by ${money.grain}`, money, ["period", "currency"], MONEY_NUMBERS);
@@ -218,7 +224,7 @@ const commands = {
             if (args.length > 0)
                 throw new CliError("Usage: campaigns [--from <date>] [--to <date>] [--channel <channel>] [--limit <n>]", exitCodes.usage);
             const query = reportQuery(options, { channel: options.channel, limit: options.limit });
-            const { campaignResults } = await api(await resolveConnection(options.apiUrl), `/api/v1/reports/campaigns${query}`);
+            const { campaignResults } = await api(await resolveConnection(options), `/api/v1/reports/campaigns${query}`);
             if (options.format === "json")
                 return printJson({ campaignResults });
             const title = campaignResults.channel === null ? "Campaigns, best first" : `${campaignResults.channel} campaigns, best first`;
@@ -229,7 +235,7 @@ const commands = {
     "tools list": {
         usage: "tools list",
         async run(_args, options) {
-            const { tools } = await api(await resolveConnection(options.apiUrl), "/api/v1/tools");
+            const { tools } = await api(await resolveConnection(options), "/api/v1/tools");
             if (options.format === "json")
                 return printJson({ tools });
             console.log(renderTable(["id", "mode", "output", "title"], tools));
@@ -242,7 +248,7 @@ const commands = {
             if (!tool || rest.length > 0)
                 throw new CliError("Usage: tools run <tool> [--input '<json>']", exitCodes.usage);
             const input = await readToolInput(options);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const body = {
                 input,
                 ...(options.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : {}),
@@ -257,7 +263,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: tools get <run-id>", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const { run } = await api(connection, `/api/v1/runs/${encodeURIComponent(args[0])}`);
             printRun(await waitForRun(connection, run, options.wait), options.format);
         },
@@ -267,7 +273,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: sources list", exitCodes.usage);
-            const { sources } = await api(await resolveConnection(options.apiUrl), "/api/v1/sources");
+            const { sources } = await api(await resolveConnection(options), "/api/v1/sources");
             if (options.format === "json")
                 return printJson({ sources });
             if (sources.length === 0)
@@ -296,7 +302,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: sources show <id>", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const path = `/api/v1/sources/${encodeURIComponent(args[0])}`;
             const { source } = await api(connection, path);
             const { runs } = await api(connection, `${path}/runs?limit=${SOURCE_RUNS_SHOWN}`);
@@ -340,7 +346,7 @@ const commands = {
             const [id, ...assignments] = args;
             if (!id)
                 throw new CliError("Usage: sources settings <id> [<key>=<value> ...]", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const path = `/api/v1/sources/${encodeURIComponent(id)}/settings`;
             let { settings } = await api(connection, path);
             if (assignments.length > 0) {
@@ -366,7 +372,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: intake list", exitCodes.usage);
-            const { endpoints } = await api(await resolveConnection(options.apiUrl), INTAKE_PATH);
+            const { endpoints } = await api(await resolveConnection(options), INTAKE_PATH);
             if (options.format === "json")
                 return printJson({ endpoints });
             if (endpoints.length === 0)
@@ -396,7 +402,7 @@ const commands = {
                 ...(retentionDays === undefined ? {} : { retentionDays }),
                 ...(signingKey === undefined ? {} : { signingKey }),
             };
-            printIntakeToken(await api(await resolveConnection(options.apiUrl), INTAKE_PATH, body), options.format);
+            printIntakeToken(await api(await resolveConnection(options), INTAKE_PATH, body), options.format);
         },
     },
     "intake rotate": {
@@ -405,7 +411,7 @@ const commands = {
             if (args.length !== 1)
                 throw new CliError("Usage: intake rotate <id>", exitCodes.usage);
             const path = `${intakePath(args[0])}/rotate`;
-            printIntakeToken(await api(await resolveConnection(options.apiUrl), path, {}), options.format);
+            printIntakeToken(await api(await resolveConnection(options), path, {}), options.format);
         },
     },
     "intake signing-key": {
@@ -415,7 +421,7 @@ const commands = {
                 throw new CliError("Usage: intake signing-key <id> --signing-key-stdin", exitCodes.usage);
             const signingKey = await readSigningKey();
             const path = `${intakePath(args[0])}/signing-key`;
-            const { endpoint } = await api(await resolveConnection(options.apiUrl), path, { signingKey }, "PUT");
+            const { endpoint } = await api(await resolveConnection(options), path, { signingKey }, "PUT");
             if (options.format === "json")
                 return printJson({ endpoint });
             console.log(`Replaced the ${endpoint.kind} signing key. Every ${endpoint.kind} address in the workspace now checks against it.`);
@@ -462,7 +468,7 @@ const commands = {
             if (!options.yes) {
                 throw new CliError("This deletes the address and every event it has saved. Add --yes to confirm: intake delete <id> --yes", exitCodes.usage);
             }
-            const result = await api(await resolveConnection(options.apiUrl), intakePath(args[0]), undefined, "DELETE");
+            const result = await api(await resolveConnection(options), intakePath(args[0]), undefined, "DELETE");
             if (options.format === "json")
                 return printJson(result);
             console.log("Deleted the address and its saved events.");
@@ -476,7 +482,7 @@ const commands = {
                 throw new CliError(usage, exitCodes.usage);
             const name = importName(options.table);
             const file = await readImportFile(args[0]);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const result = await uploadCsv(connection, name, file);
             if (options.format === "json")
                 return printJson(result);
@@ -495,7 +501,7 @@ const commands = {
                 throw new CliError(`This drops the table import_${name} and all its rows. Add --yes to confirm: import remove --table ${name} --yes`, exitCodes.usage);
             }
             const path = `/api/v1/imports/csv?table=${encodeURIComponent(name)}`;
-            const result = await api(await resolveConnection(options.apiUrl), path, undefined, "DELETE");
+            const result = await api(await resolveConnection(options), path, undefined, "DELETE");
             if (options.format === "json")
                 return printJson(result);
             console.log(`Removed ${result.table} and its rows.`);
@@ -512,7 +518,7 @@ const commands = {
             if (options.limit)
                 query.set("limit", options.limit);
             const path = `/api/v1/creatives${query.size ? `?${query}` : ""}`;
-            const { creatives } = await api(await resolveConnection(options.apiUrl), path);
+            const { creatives } = await api(await resolveConnection(options), path);
             if (options.format === "json")
                 return printJson({ creatives });
             if (creatives.length === 0)
@@ -526,7 +532,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: creatives show <sku>", exitCodes.usage);
-            const { creative } = await api(await resolveConnection(options.apiUrl), `/api/v1/creatives/${encodeURIComponent(args[0])}`);
+            const { creative } = await api(await resolveConnection(options), `/api/v1/creatives/${encodeURIComponent(args[0])}`);
             if (options.format === "json")
                 return printJson({ creative });
             const fields = {
@@ -543,7 +549,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: creatives download <sku | asset-path | asset-link> [--out <path>] [--open]", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const target = await downloadTarget(args[0], connection);
             const { bytes, contentType } = await apiDownload(connection, `${ASSET_ROUTE}${target.assetPath.split("/").map(encodeURIComponent).join("/")}`);
             const path = await savePath(options.out, extname(target.fileName) ? target.fileName : `${target.fileName}.${extensionFor(contentType)}`);
@@ -563,7 +569,7 @@ const commands = {
             }
             const lineage = options.lineage === undefined ? undefined : await parseJson(options.lineage, "--lineage");
             const tags = options.tags === undefined ? undefined : await parseJson(options.tags, "--tags");
-            const { creatives } = await api(await resolveConnection(options.apiUrl), "/api/v1/creatives", {
+            const { creatives } = await api(await resolveConnection(options), "/api/v1/creatives", {
                 runId: options.run,
                 ...(lineage === undefined ? {} : { lineage }),
                 ...(tags === undefined ? {} : { tags }),
@@ -579,7 +585,7 @@ const commands = {
             if (args.length !== 1)
                 throw new CliError("Usage: creatives tag <sku> --file <tags.json> | < tags.json", exitCodes.usage);
             const tags = await readToolInput(options);
-            const { creative } = await api(await resolveConnection(options.apiUrl), `/api/v1/creatives/${encodeURIComponent(args[0])}/tags`, { tags }, "PATCH");
+            const { creative } = await api(await resolveConnection(options), `/api/v1/creatives/${encodeURIComponent(args[0])}/tags`, { tags }, "PATCH");
             if (options.format === "json")
                 return printJson({ creative });
             console.log(`Tagged ${creative.sku}. The tags read ${creative.tagsStatus} until a person confirms them in the app.`);
@@ -590,7 +596,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0 || !options.kind)
                 throw new CliError("Usage: content create --kind ad|email|sms|landing_page|video|social_post [...]", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const content = await api(connection, "/api/v1/content", {
                 kind: options.kind,
                 ...(await contentInput(options, connection)),
@@ -608,7 +614,7 @@ const commands = {
             }
             if (options.language !== undefined && options.transcript === undefined)
                 throw new CliError("--language goes with --transcript.", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const content = await api(connection, "/api/v1/content/captures", {
                 kind: options.kind,
                 ...(await contentInput(options, connection)),
@@ -624,7 +630,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: guide", exitCodes.usage);
-            const guide = await api(await resolveConnection(options.apiUrl), "/api/v1/guide");
+            const guide = await api(await resolveConnection(options), "/api/v1/guide");
             if (options.format === "json")
                 return printJson(guide);
             process.stdout.write(guide.text);
@@ -636,7 +642,7 @@ const commands = {
             if (args.length > 0)
                 throw new CliError("Usage: brief [--from <date>] [--to <date>] [--channel <channel>] [--campaign <id>] [--top <n>]", exitCodes.usage);
             const query = reportQuery(options, { channel: options.channel, campaignId: options.campaign, top: options.top });
-            const brief = await api(await resolveConnection(options.apiUrl), `/api/v1/brief${query}`);
+            const brief = await api(await resolveConnection(options), `/api/v1/brief${query}`);
             if (options.format === "json")
                 return printJson(brief);
             process.stdout.write(brief.text);
@@ -652,7 +658,7 @@ const commands = {
             for (const [name, value] of Object.entries({ step: options.step, funnel: options.funnel, page: options.page }))
                 if (value !== undefined)
                     query.set(name, value);
-            const brief = await api(await resolveConnection(options.apiUrl), `/api/v1/pages/brief?${query}`);
+            const brief = await api(await resolveConnection(options), `/api/v1/pages/brief?${query}`);
             if (options.format === "json")
                 return printJson(brief);
             process.stdout.write(brief.text);
@@ -663,7 +669,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: pages results [--from <date>] [--to <date>] [--page <address | page key | item id>]", exitCodes.usage);
-            const results = await api(await resolveConnection(options.apiUrl), `/api/v1/pages/results${reportQuery(options, { page: options.page })}`);
+            const results = await api(await resolveConnection(options), `/api/v1/pages/results${reportQuery(options, { page: options.page })}`);
             if (options.format === "json")
                 return printJson(results);
             printPageResults(results);
@@ -674,14 +680,14 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: messages results [--from <date>] [--to <date>] [--channel email|text] [--sequence <workflow id>]", exitCodes.usage);
-            const results = await api(await resolveConnection(options.apiUrl), `/api/v1/messages/results${reportQuery(options, { channel: options.channel, sequence: options.sequence })}`);
+            const results = await api(await resolveConnection(options), `/api/v1/messages/results${reportQuery(options, { channel: options.channel, sequence: options.sequence })}`);
             if (options.format === "json")
                 return printJson(results);
             printMessageResults(results);
         },
     },
     winners: {
-        usage: "winners [--week <YYYY-MM-DD> | --days <n> | --from <YYYY-MM-DD> --to <YYYY-MM-DD>] [--top <n>] [--ad-format image|video|carousel]   (which Facebook ads and landing pages won and flopped, judged on real sales: first-touch, or Triple Whale's orders when the workspace has them)",
+        usage: "winners [--week <YYYY-MM-DD> | --days <n> | --from <YYYY-MM-DD> --to <YYYY-MM-DD>] [--top <n>] [--ad-format image|video|carousel]   (which Facebook ads and landing pages won and flopped, judged on each client's goal; see winners goals)",
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: winners [--week <date> | --days <n> | --from <date> --to <date>] [--top <n>] [--ad-format image|video|carousel]", exitCodes.usage);
@@ -689,7 +695,7 @@ const commands = {
             for (const [name, value] of Object.entries({ ...winnersPeriod(options), top: options.top, format: options.entryTags.format }))
                 if (value !== undefined)
                     query.set(name, value);
-            const report = await api(await resolveConnection(options.apiUrl), `/api/v1/winners${query.size ? `?${query}` : ""}`);
+            const report = await api(await resolveConnection(options), `/api/v1/winners${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson(report);
             process.stdout.write(winnersText(report));
@@ -701,7 +707,7 @@ const commands = {
             if (args.length > 0)
                 throw new CliError("Usage: winners send-to-exodus [--week <date> | --days <n> | --from <date> --to <date>] [--dry-run]", exitCodes.usage);
             const period = Object.entries(winnersPeriod(options)).filter(([, value]) => value !== undefined);
-            const sent = await api(await resolveConnection(options.apiUrl), "/api/v1/winners/exodus", { ...Object.fromEntries(period), dryRun: options.dryRun });
+            const sent = await api(await resolveConnection(options), "/api/v1/winners/exodus", { ...Object.fromEntries(period), dryRun: options.dryRun });
             if (options.format === "json")
                 printJson(sent);
             else
@@ -711,12 +717,36 @@ const commands = {
                 throw new CliError(`${failed} of ${sent.pages.length} ${sent.pages.length === 1 ? "page was" : "pages were"} not sent; see above.`, exitCodes.error);
         },
     },
+    "winners goals": {
+        usage: "winners goals   (the goals this client's ads are judged on, in order, whether each has data, and which one winners uses now)",
+        async run(args, options) {
+            if (args.length > 0)
+                throw new CliError("Usage: winners goals", exitCodes.usage);
+            printWinnersGoals(await api(await resolveConnection(options), "/api/v1/winners/goals"), options.format);
+        },
+    },
+    "winners goals set": {
+        usage: "winners goals set <goal> [<goal> ...]   (judge this client's ads on these goals, the first with data first: sales, sales:triple_whale, booked_calls, meta_results, first_leads)",
+        async run(args, options) {
+            if (args.length === 0)
+                throw new CliError("Usage: winners goals set <goal> [<goal> ...]", exitCodes.usage);
+            printWinnersGoals(await api(await resolveConnection(options), "/api/v1/winners/goals", { goals: args }, "PUT"), options.format);
+        },
+    },
+    "winners goals reset": {
+        usage: "winners goals reset   (go back to the default goals: Triple Whale's orders, then first-touch sales, then first leads)",
+        async run(args, options) {
+            if (args.length > 0)
+                throw new CliError("Usage: winners goals reset", exitCodes.usage);
+            printWinnersGoals(await api(await resolveConnection(options), "/api/v1/winners/goals", { goals: null }, "PUT"), options.format);
+        },
+    },
     examples: {
         usage: "examples   (plain questions with SQL that answers them, for the tables this workspace has)",
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: examples", exitCodes.usage);
-            const { examples } = await api(await resolveConnection(options.apiUrl), "/api/v1/examples");
+            const { examples } = await api(await resolveConnection(options), "/api/v1/examples");
             if (options.format === "json")
                 return printJson({ examples });
             for (const e of examples) {
@@ -734,7 +764,7 @@ const commands = {
                 throw new CliError("Usage: content search [--text <words>] [--kind <kind>] [--sort <column>] [...]; put several words in quotes", exitCodes.usage);
             const filters = { text: options.text, mode: options.mode, kind: options.kind, platform: options.platform, origin: options.origin, from: options.from, to: options.to, sort: options.sort, order: options.order, limit: options.limit };
             const query = new URLSearchParams(Object.entries(filters).filter((entry) => entry[1] !== undefined));
-            const { results } = await api(await resolveConnection(options.apiUrl), `/api/v1/content${query.size ? `?${query}` : ""}`);
+            const { results } = await api(await resolveConnection(options), `/api/v1/content${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson({ results });
             if (results.length === 0)
@@ -760,7 +790,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: content show <sku | item-id>", exitCodes.usage);
-            const content = await api(await resolveConnection(options.apiUrl), `/api/v1/content/${encodeURIComponent(args[0])}`);
+            const content = await api(await resolveConnection(options), `/api/v1/content/${encodeURIComponent(args[0])}`);
             printContent(content, options.format);
         },
     },
@@ -770,7 +800,7 @@ const commands = {
             if (args.length !== 1)
                 throw new CliError("Usage: content pull <dir> [--kind <kind>] [--platform <platform>] [--origin discovered|made] [--media] [--full]", exitCodes.usage);
             const filters = Object.fromEntries(Object.entries({ kind: options.kind, platform: options.platform, origin: options.origin }).filter((e) => e[1] !== undefined));
-            const report = await pullContent(await resolveConnection(options.apiUrl), args[0], filters, { media: options.media, full: options.full });
+            const report = await pullContent(await resolveConnection(options), args[0], filters, { media: options.media, full: options.full });
             if (options.format === "json")
                 return printJson(report);
             const media = options.media ? `, ${report.media} new media file${report.media === 1 ? "" : "s"}` : "";
@@ -786,7 +816,7 @@ const commands = {
             if (args.length !== 1)
                 throw new CliError("Usage: content diff <sku | item-id> [--from <n>] [--to <n>]", exitCodes.usage);
             const query = new URLSearchParams(Object.entries({ from: options.from, to: options.to }).filter((entry) => entry[1] !== undefined));
-            const diff = await api(await resolveConnection(options.apiUrl), `/api/v1/content/${encodeURIComponent(args[0])}/diff${query.size ? `?${query}` : ""}`);
+            const diff = await api(await resolveConnection(options), `/api/v1/content/${encodeURIComponent(args[0])}/diff${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson(diff);
             printContentDiff(diff);
@@ -797,7 +827,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: content edit <sku | item-id> [--body <text> | @file] [--note <why>] [...]", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const input = await contentInput(options, connection);
             if (Object.keys(input).every((k) => k === "runId" || k === "note")) {
                 throw new CliError("content edit needs something to change, such as --body, --subject or --file.", exitCodes.usage);
@@ -811,7 +841,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 2)
                 throw new CliError("Usage: content status <sku | item-id> <status> [--platform <platform> [--object-type <type>] --external-id <id>]", exitCodes.usage);
-            const content = await api(await resolveConnection(options.apiUrl), `/api/v1/content/${encodeURIComponent(args[0])}/status`, {
+            const content = await api(await resolveConnection(options), `/api/v1/content/${encodeURIComponent(args[0])}/status`, {
                 status: args[1],
                 ...(options.platform === undefined ? {} : { platform: options.platform }),
                 ...(options.objectType === undefined ? {} : { objectType: options.objectType }),
@@ -829,7 +859,7 @@ const commands = {
             const version = options.version === undefined ? undefined : Number(options.version);
             if (version !== undefined && !(Number.isInteger(version) && version >= 1))
                 throw new CliError("--version must be a whole number from 1.", exitCodes.usage);
-            const { publication } = await api(await resolveConnection(options.apiUrl), `/api/v1/content/${encodeURIComponent(args[0])}/publish`, {
+            const { publication } = await api(await resolveConnection(options), `/api/v1/content/${encodeURIComponent(args[0])}/publish`, {
                 publisher: options.to,
                 target: await parseJson(options.target, "--target"),
                 idempotencyKey: options.idempotencyKey,
@@ -845,7 +875,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: content reconcile <publication-id>", exitCodes.usage);
-            const { publication } = await api(await resolveConnection(options.apiUrl), `/api/v1/publications/${encodeURIComponent(args[0])}/reconcile`, {});
+            const { publication } = await api(await resolveConnection(options), `/api/v1/publications/${encodeURIComponent(args[0])}/reconcile`, {});
             printPublication(publication, options.format);
         },
     },
@@ -855,7 +885,7 @@ const commands = {
             if (args.length !== 0 || options.plan === undefined || !options.idempotencyKey) {
                 throw new CliError("Usage: meta adset publish --plan '<json>' --idempotency-key <key> [--run <run-id>]", exitCodes.usage);
             }
-            const { adsetPublication } = await api(await resolveConnection(options.apiUrl), "/api/v1/meta/adsets", {
+            const { adsetPublication } = await api(await resolveConnection(options), "/api/v1/meta/adsets", {
                 plan: await parseJson(options.plan, "--plan"),
                 idempotencyKey: options.idempotencyKey,
                 ...(options.run === undefined ? {} : { runId: options.run }),
@@ -868,7 +898,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: meta adset show <adset-publication-id>", exitCodes.usage);
-            const { adsetPublication } = await api(await resolveConnection(options.apiUrl), `/api/v1/meta/adsets/${encodeURIComponent(args[0])}`);
+            const { adsetPublication } = await api(await resolveConnection(options), `/api/v1/meta/adsets/${encodeURIComponent(args[0])}`);
             printAdSetPublication(adsetPublication, options.format);
         },
     },
@@ -877,7 +907,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: meta adset reconcile <adset-publication-id>", exitCodes.usage);
-            const { adsetPublication } = await api(await resolveConnection(options.apiUrl), `/api/v1/meta/adsets/${encodeURIComponent(args[0])}/reconcile`, {});
+            const { adsetPublication } = await api(await resolveConnection(options), `/api/v1/meta/adsets/${encodeURIComponent(args[0])}/reconcile`, {});
             printAdSetPublication(adsetPublication, options.format);
         },
     },
@@ -886,7 +916,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: content unpublish <deployment-id> [--force]", exitCodes.usage);
-            const { deployment } = await api(await resolveConnection(options.apiUrl), `/api/v1/deployments/${encodeURIComponent(args[0])}/unpublish`, options.force ? { force: true } : {});
+            const { deployment } = await api(await resolveConnection(options), `/api/v1/deployments/${encodeURIComponent(args[0])}/unpublish`, options.force ? { force: true } : {});
             if (options.format === "json")
                 return printJson({ deployment });
             printFields({
@@ -904,7 +934,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: content publish-record <sku | item-id> --file <publication.json>", exitCodes.usage);
-            const { publication } = await api(await resolveConnection(options.apiUrl), `/api/v1/content/${encodeURIComponent(args[0])}/publications`, await readToolInput(options));
+            const { publication } = await api(await resolveConnection(options), `/api/v1/content/${encodeURIComponent(args[0])}/publications`, await readToolInput(options));
             printPublication(publication, options.format);
         },
     },
@@ -915,7 +945,7 @@ const commands = {
                 throw new CliError("Usage: content publish-finish <publication-id> --status sending|published|failed|not_sent_practice [--file <outcome.json>]", exitCodes.usage);
             }
             const outcome = await readToolInput(options);
-            const { publication } = await api(await resolveConnection(options.apiUrl), `/api/v1/publications/${encodeURIComponent(args[0])}`, { ...outcome, status: options.status }, "PATCH");
+            const { publication } = await api(await resolveConnection(options), `/api/v1/publications/${encodeURIComponent(args[0])}`, { ...outcome, status: options.status }, "PATCH");
             printPublication(publication, options.format);
         },
     },
@@ -924,7 +954,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: agent start", exitCodes.usage);
-            const start = await api(await resolveConnection(options.apiUrl), `${agentPath(options)}/runs`, {});
+            const start = await api(await resolveConnection(options), `${agentPath(options)}/runs`, {});
             if (options.format === "json")
                 return printJson(start);
             const { run, quota, brandProfile } = start;
@@ -944,7 +974,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: agent show <run-id>", exitCodes.usage);
-            const shown = await api(await resolveConnection(options.apiUrl), `${agentPath(options)}/runs/${encodeURIComponent(args[0])}`);
+            const shown = await api(await resolveConnection(options), `${agentPath(options)}/runs/${encodeURIComponent(args[0])}`);
             if (options.format === "json")
                 return printJson(shown);
             const { run, proposals } = shown;
@@ -958,7 +988,7 @@ const commands = {
         usage: "agent runs [--limit <n>]",
         async run(_args, options) {
             const query = options.limit ? `?limit=${encodeURIComponent(options.limit)}` : "";
-            const { runs } = await api(await resolveConnection(options.apiUrl), `${agentPath(options)}/runs${query}`);
+            const { runs } = await api(await resolveConnection(options), `${agentPath(options)}/runs${query}`);
             if (options.format === "json")
                 return printJson({ runs });
             if (runs.length === 0)
@@ -973,7 +1003,7 @@ const commands = {
                 throw new CliError("Usage: agent finish <run-id> --status succeeded|failed [--file report.md]", exitCodes.usage);
             }
             const report = await readText(options.file, "the report");
-            const { run } = await api(await resolveConnection(options.apiUrl), `${agentPath(options)}/runs/${encodeURIComponent(args[0])}/finish`, { status: options.status, report });
+            const { run } = await api(await resolveConnection(options), `${agentPath(options)}/runs/${encodeURIComponent(args[0])}/finish`, { status: options.status, report });
             if (options.format === "json")
                 return printJson({ run });
             console.log(`Finished run ${run.id} as ${run.status}.`);
@@ -984,7 +1014,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: agent draft --agent p3_refresh", exitCodes.usage);
-            const body = await api(await resolveConnection(options.apiUrl), `${agentPath(options)}/draft`);
+            const body = await api(await resolveConnection(options), `${agentPath(options)}/draft`);
             if (options.format === "json")
                 return printJson(body);
             const { draft } = body;
@@ -1025,7 +1055,7 @@ const commands = {
     "brand get": {
         usage: "brand get",
         async run(_args, options) {
-            const { profile } = await api(await resolveConnection(options.apiUrl), "/api/v1/brand-profile");
+            const { profile } = await api(await resolveConnection(options), "/api/v1/brand-profile");
             if (options.format === "json")
                 return printJson({ profile });
             if (!profile)
@@ -1041,7 +1071,7 @@ const commands = {
                 throw new CliError("Usage: brand set [--file <path>] [--sources '<json>' | @file.json]", exitCodes.usage);
             const markdown = await readText(options.file, "the brand profile");
             const sources = options.sources === undefined ? [] : await parseJson(options.sources, "--sources");
-            const { profile } = await api(await resolveConnection(options.apiUrl), "/api/v1/brand-profile", { markdown, sources }, "PUT");
+            const { profile } = await api(await resolveConnection(options), "/api/v1/brand-profile", { markdown, sources }, "PUT");
             if (options.format === "json")
                 return printJson({ profile });
             console.log(`Saved brand profile version ${profile.version}.`);
@@ -1052,7 +1082,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: content add-page <url>", exitCodes.usage);
-            const { page } = await api(await resolveConnection(options.apiUrl), "/api/v1/content/pages", { url: args[0] });
+            const { page } = await api(await resolveConnection(options), "/api/v1/content/pages", { url: args[0] });
             if (options.format === "json")
                 return printJson({ page });
             console.log(renderTable(["key", "status", "version", "changed", "headline", "blocks"], [{ ...page, blocks: page.blockCount }]));
@@ -1066,7 +1096,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 2)
                 throw new CliError("Usage: content track-link <sku> <url> [--channel facebook|email|sms|web] [--campaign <id>]", exitCodes.usage);
-            const { url } = await api(await resolveConnection(options.apiUrl), "/api/v1/content/track-link", {
+            const { url } = await api(await resolveConnection(options), "/api/v1/content/track-link", {
                 sku: args[0],
                 url: args[1],
                 channel: options.channel,
@@ -1082,7 +1112,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: trail <plan-id | sku | item-id>", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const ref = args[0];
             const trailOf = (query) => api(connection, `/api/v1/trail?${query}=${encodeURIComponent(ref)}`);
             // Plans and items both have uuid ids: an id that names no plan is read as an item.
@@ -1102,7 +1132,7 @@ const commands = {
             if (args.length > 0)
                 throw new CliError("Usage: funnels show [--version <n>]", exitCodes.usage);
             const query = options.version === undefined ? "" : `?version=${wholeNumber(options.version, "--version")}`;
-            const view = await api(await resolveConnection(options.apiUrl), `${FUNNELS_PATH}${query}`);
+            const view = await api(await resolveConnection(options), `${FUNNELS_PATH}${query}`);
             if (options.format === "json")
                 return printJson(view);
             process.stdout.write(view.text);
@@ -1113,7 +1143,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: funnels numbers [--funnel <key>] [--from <date>] [--to <date>]", exitCodes.usage);
-            const view = await api(await resolveConnection(options.apiUrl), `${FUNNELS_PATH}/numbers${reportQuery(options, { funnel: options.funnel })}`);
+            const view = await api(await resolveConnection(options), `${FUNNELS_PATH}/numbers${reportQuery(options, { funnel: options.funnel })}`);
             if (options.format === "json")
                 return printJson(view);
             process.stdout.write(view.text);
@@ -1124,7 +1154,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0 || options.from !== undefined)
                 throw new CliError("Usage: funnels leaks [--funnel <key>] [--to <date>]", exitCodes.usage);
-            const view = await api(await resolveConnection(options.apiUrl), `${FUNNELS_PATH}/leaks${reportQuery(options, { funnel: options.funnel })}`);
+            const view = await api(await resolveConnection(options), `${FUNNELS_PATH}/leaks${reportQuery(options, { funnel: options.funnel })}`);
             if (options.format === "json")
                 return printJson(view);
             process.stdout.write(view.text);
@@ -1135,7 +1165,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: funnels evidence", exitCodes.usage);
-            const view = await api(await resolveConnection(options.apiUrl), `${FUNNELS_PATH}/evidence`);
+            const view = await api(await resolveConnection(options), `${FUNNELS_PATH}/evidence`);
             if (options.format === "json")
                 return printJson(view);
             process.stdout.write(view.text);
@@ -1153,7 +1183,7 @@ const commands = {
             const map = await parseJson(`@${options.file}`, "--file");
             const evidence = options.evidence === undefined ? undefined : await parseJson(options.evidence, "--evidence");
             const questions = options.questions === undefined ? undefined : await parseJson(options.questions, "--questions");
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const basedOn = options.basedOn === undefined ? null : wholeNumber(options.basedOn, "--based-on");
             const saved = await api(connection, `${FUNNELS_PATH}/draft`, { map, note: options.note, evidence, based_on: basedOn, counts_from: options.countsFrom, questions }, "PUT");
             if (options.format === "json")
@@ -1183,7 +1213,7 @@ const commands = {
     "funnels versions": {
         usage: "funnels versions [--diff <a> <b>]   every version of the map, or what changed from version a to b",
         async run(args, options) {
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             if (options.diff !== undefined) {
                 if (args.length !== 1)
                     throw new CliError("Usage: funnels versions --diff <a> <b>", exitCodes.usage);
@@ -1230,7 +1260,7 @@ const commands = {
             }
             if (options.status)
                 query.set("status", options.status);
-            const { facts } = await api(await resolveConnection(options.apiUrl), `${FACTS_PATH}${query.size ? `?${query}` : ""}`);
+            const { facts } = await api(await resolveConnection(options), `${FACTS_PATH}${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson({ facts });
             if (facts.length === 0)
@@ -1252,7 +1282,7 @@ const commands = {
                 query.set("sort", options.sort);
             if (options.limit)
                 query.set("limit", options.limit);
-            const read = await api(await resolveConnection(options.apiUrl), `${VOICE_PATH}${query.size ? `?${query}` : ""}`);
+            const read = await api(await resolveConnection(options), `${VOICE_PATH}${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson(read);
             if ("lines" in read) {
@@ -1277,7 +1307,7 @@ const commands = {
                 query.set("status", options.status);
             if (options.limit)
                 query.set("limit", options.limit);
-            const { tags } = await api(await resolveConnection(options.apiUrl), `${AD_TAGS_PATH}${query.size ? `?${query}` : ""}`);
+            const { tags } = await api(await resolveConnection(options), `${AD_TAGS_PATH}${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson({ tags });
             if (tags.length === 0)
@@ -1290,7 +1320,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: ads tag --file <tags.json> | < tags.json", exitCodes.usage);
-            const result = await api(await resolveConnection(options.apiUrl), AD_TAGS_PATH, await readToolInput(options));
+            const result = await api(await resolveConnection(options), AD_TAGS_PATH, await readToolInput(options));
             if (options.format === "json")
                 return printJson(result);
             console.log(`Proposed tags for ${result.proposed.length} ${result.proposed.length === 1 ? "ad" : "ads"}. A person confirms or rejects them in the app.`);
@@ -1304,7 +1334,7 @@ const commands = {
             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);
+            const result = await api(await resolveConnection(options), AD_AUTOTAG_PATH, body);
             if (options.format === "json")
                 return printJson(result);
             const plural = (n) => `${n} ${n === 1 ? "ad" : "ads"}`;
@@ -1331,7 +1361,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: ads tag-formats [--limit <n>] [--json]", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const total = { tagged: 0, no_format: 0 };
             let after = null;
             for (;;) {
@@ -1360,7 +1390,7 @@ const commands = {
                 throw new CliError("Usage: content tags [<item-id>] [--kind email|text|page] [--status <status>] [--limit <n>] [--json]", exitCodes.usage);
             const filters = { item: args[0], kind: options.kind, status: options.status, limit: options.limit };
             const query = new URLSearchParams(Object.entries(filters).filter((entry) => entry[1] !== undefined));
-            const { tags } = await api(await resolveConnection(options.apiUrl), `${CONTENT_TAGS_PATH}${query.size ? `?${query}` : ""}`);
+            const { tags } = await api(await resolveConnection(options), `${CONTENT_TAGS_PATH}${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson({ tags });
             if (tags.length === 0)
@@ -1374,7 +1404,7 @@ const commands = {
             if (args.length > 0)
                 throw new CliError("Usage: content to-check [--limit <n>] [--json]", exitCodes.usage);
             const query = new URLSearchParams({ to_check: "1", ...(options.limit ? { limit: options.limit } : {}) });
-            const { tags } = await api(await resolveConnection(options.apiUrl), `${CONTENT_TAGS_PATH}?${query}`);
+            const { tags } = await api(await resolveConnection(options), `${CONTENT_TAGS_PATH}?${query}`);
             if (options.format === "json")
                 return printJson({ tags });
             if (tags.length === 0)
@@ -1390,7 +1420,7 @@ const commands = {
                 ...(options.kind ? { kinds: options.kind.split(",") } : {}),
                 ...(options.limit ? { limit: Number(options.limit) } : {}),
             };
-            const result = await api(await resolveConnection(options.apiUrl), CONTENT_AUTOTAG_PATH, body);
+            const result = await api(await resolveConnection(options), CONTENT_AUTOTAG_PATH, body);
             if (options.format === "json")
                 return printJson(result);
             const plural = (n) => `${n} ${n === 1 ? "item" : "items"}`;
@@ -1415,7 +1445,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: facts show <id>", exitCodes.usage);
-            const { fact } = await api(await resolveConnection(options.apiUrl), `${FACTS_PATH}/${encodeURIComponent(args[0])}`);
+            const { fact } = await api(await resolveConnection(options), `${FACTS_PATH}/${encodeURIComponent(args[0])}`);
             if (options.format === "json")
                 return printJson({ fact });
             const nameKey = fact.key === NAME_KEY ? nameKeyLines(fact.value) : null;
@@ -1430,7 +1460,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: facts propose --file <fact.json> | < fact.json", exitCodes.usage);
-            const { fact } = await api(await resolveConnection(options.apiUrl), FACTS_PATH, await readToolInput(options));
+            const { fact } = await api(await resolveConnection(options), FACTS_PATH, await readToolInput(options));
             if (options.format === "json")
                 return printJson({ fact });
             console.log(`Proposed fact ${fact.id}. A person confirms or rejects it in the app.`);
@@ -1450,7 +1480,7 @@ const commands = {
             for (const dimension of options.dimension ?? [])
                 params.append("dimension", dimension);
             const query = params.size > 0 ? `?${params}` : "";
-            const { lessons } = await api(await resolveConnection(options.apiUrl), `${LESSONS_PATH}${query}`);
+            const { lessons } = await api(await resolveConnection(options), `${LESSONS_PATH}${query}`);
             if (options.format === "json")
                 return printJson({ lessons });
             if (lessons.length === 0) {
@@ -1465,7 +1495,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: lessons add --file <lesson.json> | < lesson.json", exitCodes.usage);
-            const recorded = await api(await resolveConnection(options.apiUrl), LESSONS_PATH, await readToolInput(options));
+            const recorded = await api(await resolveConnection(options), LESSONS_PATH, await readToolInput(options));
             if (options.format === "json")
                 return printJson(recorded);
             const { lesson, outcome } = recorded;
@@ -1489,7 +1519,7 @@ const commands = {
                 query.set("funnel", options.funnel);
             if (options.limit)
                 query.set("limit", options.limit);
-            const { tests } = await api(await resolveConnection(options.apiUrl), `${TESTS_PATH}${query.size ? `?${query}` : ""}`);
+            const { tests } = await api(await resolveConnection(options), `${TESTS_PATH}${query.size ? `?${query}` : ""}`);
             if (options.format === "json")
                 return printJson({ tests });
             if (tests.length === 0)
@@ -1502,7 +1532,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: tests show <id|test_id>", exitCodes.usage);
-            const { test } = await api(await resolveConnection(options.apiUrl), testPath(args[0]));
+            const { test } = await api(await resolveConnection(options), testPath(args[0]));
             if (options.format === "json")
                 return printJson({ test });
             printTest(test);
@@ -1513,7 +1543,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: tests draft --file <test.json> | < test.json", exitCodes.usage);
-            const { test } = await api(await resolveConnection(options.apiUrl), TESTS_PATH, await readToolInput(options));
+            const { test } = await api(await resolveConnection(options), TESTS_PATH, await readToolInput(options));
             if (options.format === "json")
                 return printJson({ test });
             console.log(`Drafted test ${test.test_id} (${test.id}).`);
@@ -1524,7 +1554,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: tests start <id|test_id>", exitCodes.usage);
-            const { test } = await api(await resolveConnection(options.apiUrl), `${testPath(args[0])}/start`, {});
+            const { test } = await api(await resolveConnection(options), `${testPath(args[0])}/start`, {});
             if (options.format === "json")
                 return printJson({ test });
             console.log(`Test ${test.test_id} is running from ${test.started_on}.`);
@@ -1535,7 +1565,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError('Usage: tests abandon <id|test_id> [--note "<why>"]', exitCodes.usage);
-            const { test } = await api(await resolveConnection(options.apiUrl), `${testPath(args[0])}/abandon`, options.note ? { note: options.note } : {});
+            const { test } = await api(await resolveConnection(options), `${testPath(args[0])}/abandon`, options.note ? { note: options.note } : {});
             if (options.format === "json")
                 return printJson({ test });
             console.log(`Abandoned test ${test.test_id}.`);
@@ -1546,7 +1576,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: tests results <id|test_id>", exitCodes.usage);
-            const { results } = await api(await resolveConnection(options.apiUrl), `${testPath(args[0])}/results`);
+            const { results } = await api(await resolveConnection(options), `${testPath(args[0])}/results`);
             if (options.format === "json")
                 return printJson({ results });
             printResults(results);
@@ -1558,7 +1588,7 @@ const commands = {
             if (args.length !== 1 || !options.decision) {
                 throw new CliError('Usage: tests decide <id|test_id> --decision <scale|continue|iterate|hold|stop> [--note "<why>"]', exitCodes.usage);
             }
-            const decided = await api(await resolveConnection(options.apiUrl), `${testPath(args[0])}/decide`, options.note ? { decision: options.decision, note: options.note } : { decision: options.decision });
+            const decided = await api(await resolveConnection(options), `${testPath(args[0])}/decide`, options.note ? { decision: options.decision, note: options.note } : { decision: options.decision });
             if (options.format === "json")
                 return printJson(decided);
             const { test, lesson, next_test: next } = decided;
@@ -1574,7 +1604,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1 || !options.note)
                 throw new CliError('Usage: lessons retire <id> --note "<why it is no longer true>"', exitCodes.usage);
-            const { lesson } = await api(await resolveConnection(options.apiUrl), `${LESSONS_PATH}/${encodeURIComponent(args[0])}/retire`, { reason: options.note });
+            const { lesson } = await api(await resolveConnection(options), `${LESSONS_PATH}/${encodeURIComponent(args[0])}/retire`, { reason: options.note });
             if (options.format === "json")
                 return printJson({ lesson });
             console.log(`Retired lesson ${lesson.id}.`);
@@ -1585,7 +1615,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: grammar | grammar propose --file <values.json>", exitCodes.usage);
-            const answer = await api(await resolveConnection(options.apiUrl), GRAMMAR_PATH);
+            const answer = await api(await resolveConnection(options), GRAMMAR_PATH);
             if (options.format === "json")
                 return printJson(answer);
             process.stdout.write(answer.text);
@@ -1596,7 +1626,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: grammar propose --file <values.json> | < values.json", exitCodes.usage);
-            const result = await api(await resolveConnection(options.apiUrl), `${GRAMMAR_PATH}/proposals`, await readToolInput(options));
+            const result = await api(await resolveConnection(options), `${GRAMMAR_PATH}/proposals`, await readToolInput(options));
             if (options.format === "json")
                 return printJson(result);
             const named = (refs) => refs.map((r) => `${r.part} ${r.key}`).join(", ");
@@ -1610,7 +1640,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: voice lists", exitCodes.usage);
-            const lists = await api(await resolveConnection(options.apiUrl), VOICE_LISTS_PATH);
+            const lists = await api(await resolveConnection(options), VOICE_LISTS_PATH);
             if (options.format === "json")
                 return printJson(lists);
             const rows = [
@@ -1631,7 +1661,7 @@ const commands = {
             if (!kind || !["competitor", "subreddit", "search_phrase"].includes(kind) || value === undefined || rest.length > 0) {
                 throw new CliError('Usage: voice suggest competitor|subreddit|search_phrase "<value>" [--note <why>]; put a value with spaces in quotes', exitCodes.usage);
             }
-            const result = await api(await resolveConnection(options.apiUrl), VOICE_SUGGESTIONS_PATH, { kind, value, note: options.note });
+            const result = await api(await resolveConnection(options), VOICE_SUGGESTIONS_PATH, { kind, value, note: options.note });
             if (options.format === "json")
                 return printJson(result);
             if (result.outcome === "already_listed")
@@ -1646,7 +1676,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: story | story list | story show <version> | story submit --file <story.json>", exitCodes.usage);
-            const { story } = await api(await resolveConnection(options.apiUrl), `${STORIES_PATH}/latest`);
+            const { story } = await api(await resolveConnection(options), `${STORIES_PATH}/latest`);
             if (options.format === "json")
                 return printJson({ story });
             if (!story)
@@ -1659,7 +1689,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: story list", exitCodes.usage);
-            const { stories } = await api(await resolveConnection(options.apiUrl), STORIES_PATH);
+            const { stories } = await api(await resolveConnection(options), STORIES_PATH);
             if (options.format === "json")
                 return printJson({ stories });
             if (stories.length === 0)
@@ -1682,7 +1712,7 @@ const commands = {
             if (args.length !== 1)
                 throw new CliError("Usage: story show <version>", exitCodes.usage);
             // `show latest` reaches the newest-story route, which answers null before the first story.
-            const { story } = await api(await resolveConnection(options.apiUrl), `${STORIES_PATH}/${encodeURIComponent(args[0])}`);
+            const { story } = await api(await resolveConnection(options), `${STORIES_PATH}/${encodeURIComponent(args[0])}`);
             if (options.format === "json")
                 return printJson({ story });
             if (!story)
@@ -1695,7 +1725,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: story submit --file <story.json> | < story.json", exitCodes.usage);
-            const { story } = await api(await resolveConnection(options.apiUrl), STORIES_PATH, await readToolInput(options));
+            const { story } = await api(await resolveConnection(options), STORIES_PATH, await readToolInput(options));
             if (options.format === "json")
                 return printJson({ story });
             console.log(`Saved story version ${story.version}.`);
@@ -1707,7 +1737,7 @@ const commands = {
             if (args.length > 0 || !options.name || !options.goal || !options.channel) {
                 throw new CliError("Usage: plans create --name <name> --goal <text> --channel meta|ghl|klaviyo|web [--target '<json>'] [--landing <sku> | --landing-url <url>] [--funnel <key> --step <key>]", exitCodes.usage);
             }
-            const { plan } = await api(await resolveConnection(options.apiUrl), "/api/v1/launch-plans", {
+            const { plan } = await api(await resolveConnection(options), "/api/v1/launch-plans", {
                 name: options.name,
                 goal: await textOrFile(options.goal),
                 channel: options.channel,
@@ -1726,7 +1756,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: plans show <plan-id>", exitCodes.usage);
-            const { plan } = await api(await resolveConnection(options.apiUrl), planPath(args[0]));
+            const { plan } = await api(await resolveConnection(options), planPath(args[0]));
             printPlan(plan, options.format);
         },
     },
@@ -1738,7 +1768,7 @@ const commands = {
             const position = options.position === undefined ? undefined : Number(options.position);
             if (position !== undefined && (!Number.isInteger(position) || position < 0))
                 throw new CliError("--position must be a whole number from 0.", exitCodes.usage);
-            const { plan } = await api(await resolveConnection(options.apiUrl), `${planPath(args[0])}/items`, {
+            const { plan } = await api(await resolveConnection(options), `${planPath(args[0])}/items`, {
                 item: args[1],
                 ...(options.role === undefined ? {} : { role: options.role }),
                 ...(position === undefined ? {} : { position }),
@@ -1752,7 +1782,7 @@ const commands = {
             if (args.length !== 2)
                 throw new CliError("Usage: plans remove <plan-id> <sku | item-id>", exitCodes.usage);
             const path = `${planPath(args[0])}/items?item=${encodeURIComponent(args[1])}`;
-            const { plan } = await api(await resolveConnection(options.apiUrl), path, undefined, "DELETE");
+            const { plan } = await api(await resolveConnection(options), path, undefined, "DELETE");
             printPlan(plan, options.format);
         },
     },
@@ -1761,7 +1791,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 2)
                 throw new CliError("Usage: plans status <plan-id> draft|ready|publishing|live|done|cancelled", exitCodes.usage);
-            const { plan } = await api(await resolveConnection(options.apiUrl), planPath(args[0]), { status: args[1] }, "PATCH");
+            const { plan } = await api(await resolveConnection(options), planPath(args[0]), { status: args[1] }, "PATCH");
             printPlan(plan, options.format);
         },
     },
@@ -1770,7 +1800,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: proposals create --input '<json>'", exitCodes.usage);
-            const { proposal } = await api(await resolveConnection(options.apiUrl), "/api/v1/proposals", await readToolInput(options));
+            const { proposal } = await api(await resolveConnection(options), "/api/v1/proposals", await readToolInput(options));
             if (options.format === "json")
                 return printJson({ proposal });
             console.log(renderTable(PROPOSAL_COLUMNS, [proposalRow(proposal)]));
@@ -1789,7 +1819,7 @@ const commands = {
             if (options.limit)
                 query.set("limit", options.limit);
             const path = `/api/v1/proposals${query.size ? `?${query}` : ""}`;
-            const { proposals } = await api(await resolveConnection(options.apiUrl), path);
+            const { proposals } = await api(await resolveConnection(options), path);
             if (options.format === "json")
                 return printJson({ proposals });
             if (proposals.length === 0)
@@ -1817,7 +1847,7 @@ const commands = {
             if (options.harness !== undefined)
                 query.set("harnesses", options.harness);
             const path = `/api/operator/skills/${name}/versions${query.size ? `?${query}` : ""}`;
-            const published = await apiUpload(await operatorConnection(options.apiUrl), path, zip, "application/zip");
+            const published = await apiUpload(await operatorConnection(options), path, zip, "application/zip");
             if (options.format === "json")
                 return printJson(published);
             console.log(`${published.name} version ${published.version}`);
@@ -1829,7 +1859,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: skill list", exitCodes.usage);
-            const { skills } = await api(await operatorConnection(options.apiUrl), "/api/operator/skills");
+            const { skills } = await api(await operatorConnection(options), "/api/operator/skills");
             if (options.format === "json")
                 return printJson({ skills });
             if (skills.length === 0)
@@ -1869,7 +1899,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: worker list", exitCodes.usage);
-            const { workers } = await api(await resolveConnection(options.apiUrl), "/api/v1/workers");
+            const { workers } = await api(await resolveConnection(options), "/api/v1/workers");
             if (options.format === "json")
                 return printJson({ workers });
             if (workers.length === 0)
@@ -1893,7 +1923,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: worker runs <hand-id | skill> [--limit <n>]", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const id = await workerId(connection, args[0]);
             const query = options.limit === undefined ? "" : `?limit=${encodeURIComponent(options.limit)}`;
             const { runs } = await api(connection, `/api/v1/workers/${encodeURIComponent(id)}/runs${query}`);
@@ -1909,7 +1939,7 @@ const commands = {
         async run(args, options) {
             if (args.length !== 1)
                 throw new CliError("Usage: worker run-now <hand-id | skill>", exitCodes.usage);
-            const connection = await resolveConnection(options.apiUrl);
+            const connection = await resolveConnection(options);
             const id = await workerId(connection, args[0]);
             const queued = await api(connection, `/api/v1/workers/${encodeURIComponent(id)}/run-now`, {});
             if (options.format === "json")
@@ -1969,6 +1999,18 @@ const commands = {
         },
     },
 };
+function clientReason(choice) {
+    switch (choice.source) {
+        case "env":
+            return `Using the key in ${envPrefix}_API_KEY, which beats --client, client files and saved logins.`;
+        case "flag":
+            return `Using client ${choice.client}, from --client.`;
+        case "folder":
+            return `Using client ${choice.client}, from the client file ${choice.path}.`;
+        case "default":
+            return `Using the default login (no --client flag and no ${CLIENT_FILE} file in this folder or above it).`;
+    }
+}
 /** Runs `work` with the runner's settings from the environment; SIGINT or SIGTERM stops the run in hand, reported failed. */
 async function withRunner(options, work) {
     const token = process.env[RUNNER_TOKEN_ENV];
@@ -2008,7 +2050,7 @@ async function installLibrarySkill(ref, options) {
     if (options.codex && options.project)
         throw new CliError("--codex installs a skill for every Codex run, under CODEX_HOME; drop --project", exitCodes.usage);
     const query = ref.version === null ? "" : `?version=${ref.version}`;
-    const download = await api(await operatorConnection(options.apiUrl), `/api/operator/skills/${ref.name}/download${query}`);
+    const download = await api(await operatorConnection(options), `/api/operator/skills/${ref.name}/download${query}`);
     const files = unpackSkill(download, await getSigned(download.url));
     const { skillsDir, above } = options.codex ? { skillsDir: codexSkillsDir(), above: [] } : claudeSkillsDir(options.project);
     const path = await installSkillFolder(skillsDir, download.name, files, above);
@@ -2071,16 +2113,21 @@ function money(value, currency) {
 /** A model that splits credit between ads gives fractional counts: show tenths at most, grouped as the server writes them. */
 const tenths = (n) => n.toLocaleString("en-US", { maximumFractionDigits: 1 });
 const counted = (n, one) => `${tenths(n)} ${tenths(n) === "1" ? one : `${one}s`}`;
+const SALE = { one: "sale", many: "sales" };
+const FIRST_LEAD = { one: "first lead", many: "first leads" };
+const winnersWords = (report) => report.goal === undefined ? { primary: SALE, fallback: FIRST_LEAD } : { primary: report.goal, fallback: report.fallbackGoal ?? null };
+const countOf = (n, { one, many }) => `${tenths(n)} ${tenths(n) === "1" ? one : many}`;
 /** An ad's line: name, SKU and campaign, its numbers, its tags, then why it is on the list. */
-function winnersAdLines(ad, currency) {
+function winnersAdLines(ad, currency, words) {
     const n = ad.numbers;
     const onSales = ad.judgedOn === "sales";
-    const cost = onSales
-        ? n.costPerSale === null ? "no sales" : `${money(n.costPerSale, currency)} per sale`
-        : n.costPerSignup === null ? "no first leads" : `${money(n.costPerSignup, currency)} per first lead`;
+    // Ads are judged on the fallback only when there is one; first leads stand in for a list the server never fills.
+    const goal = onSales ? words.primary : (words.fallback ?? FIRST_LEAD);
+    const [costPer, number] = onSales ? [n.costPerSale, n.sales] : [n.costPerSignup, n.signups];
+    const cost = costPer === null ? `no ${goal.many}` : `${money(costPer, currency)} per ${goal.one}`;
     const name = [ad.name ?? `Ad ${ad.adId}`, ad.sku && `[${ad.sku}]`, ad.campaignName && `(${ad.campaignName})`].filter(Boolean).join(" ");
     const tags = Object.entries(ad.tags).map(([field, value]) => `${field}: ${value}`).join(", ");
-    const count = onSales ? n.sales !== null && counted(n.sales, "sale") : n.signups !== null && counted(n.signups, "first lead");
+    const count = number !== null && countOf(number, goal);
     const facebook = n.facebookResults == null ? "" : `, Facebook counts ${tenths(n.facebookResults)}`;
     return `- ${name}: spent ${money(n.spend, currency)}, ${count ? `${count}, ` : ""}${cost}${facebook}${tags ? `. Tags: ${tags}` : ""}\n  ${ad.pickedBecause}\n`;
 }
@@ -2097,14 +2144,14 @@ function winnersPageLines(page, currency) {
     const bought = onSales && n.salesPerVisit !== null ? `, ${Math.round(n.salesPerVisit * 1000) / 10}% of visitors bought` : "";
     return `- ${ad}${name}: ${counted(Math.round(n.visits), "visit")}, spent ${money(n.spend, currency)}, ${count ? `${count}, ` : ""}${cost}${bought}\n  ${page.pickedBecause}\n`;
 }
-function winnersWindowText(title, window) {
+function winnersWindowText(title, window, words) {
     const head = `\n## ${title}\n`;
     if (window.sections.length === 0)
         return `${head}\nNo Facebook ad spent in these dates.\n`;
     return (head +
         window.sections
             .map((s) => {
-            const list = (heading, ads) => `\n${heading}\n${ads.length === 0 ? "- none\n" : ads.map((ad) => winnersAdLines(ad, s.currency)).join("")}`;
+            const list = (heading, ads) => `\n${heading}\n${ads.length === 0 ? "- none\n" : ads.map((ad) => winnersAdLines(ad, s.currency, words)).join("")}`;
             const places = (heading, rows) => `\n${heading}\n${rows.length === 0 ? "- none\n" : rows.map((row) => winnersPageLines(row, s.currency)).join("")}`;
             const placeLists = (what, lists) => places(`${what}: winners`, lists.winners) +
                 places(`${what}: flops`, lists.flops) +
@@ -2115,15 +2162,18 @@ function winnersWindowText(title, window) {
                 ? ""
                 : placeLists("Landing pages", s.pages) +
                     (any(s.pairs) ? placeLists("Ad and page pairs", s.pairs) : "\nAd and page pairs: none to compare. No ad sent people to two pages, and no page got people from two ads, with enough visits.\n");
+            const { primary, fallback } = words;
             const account = s.salesSource === "not_connected"
-                ? "sales are not connected"
+                ? `${primary.many} are not connected`
                 : s.accountCostPerSale === null
-                    ? "no sale credited to a Facebook ad in these dates"
-                    : `the account paid ${money(s.accountCostPerSale, s.currency)} per sale`;
-            const tied = s.adSales === null || !s.facebookSales ? "" : ` ${tenths(s.adSales)} of ${counted(s.facebookSales, "Facebook sale")} could be tied to a specific ad.`;
-            const tests = s.tests.map((t) => `- Test ${t.testId}${t.hypothesisId ? ` (idea ${t.hypothesisId})` : ""}: ${counted(t.ads.length, "ad")}, spent ${money(t.spend, s.currency)}, ${counted(t.sales, "sale")}` +
-                `${t.costPerSale === null ? "" : `, ${money(t.costPerSale, s.currency)} per sale`}\n`);
-            return (`\nIn ${s.currency}: ${account}.${tied} ${s.adsJudgedOnSales} judged on sales, ${s.adsJudgedOnSignups} judged on first leads.\n` +
+                    ? `no ${primary.one} credited to a Facebook ad in these dates`
+                    : `the account paid ${money(s.accountCostPerSale, s.currency)} per ${primary.one}`;
+            const facebookWords = { one: `Facebook ${primary.one}`, many: `Facebook ${primary.many}` };
+            const tied = s.adSales === null || !s.facebookSales ? "" : ` ${tenths(s.adSales)} of ${countOf(s.facebookSales, facebookWords)} could be tied to a specific ad.`;
+            const tests = s.tests.map((t) => `- Test ${t.testId}${t.hypothesisId ? ` (idea ${t.hypothesisId})` : ""}: ${counted(t.ads.length, "ad")}, spent ${money(t.spend, s.currency)}, ${countOf(t.sales, primary)}` +
+                `${t.costPerSale === null ? "" : `, ${money(t.costPerSale, s.currency)} per ${primary.one}`}\n`);
+            const onFallback = fallback === null ? "" : `, ${s.adsJudgedOnSignups} judged on ${fallback.many}`;
+            return (`\nIn ${s.currency}: ${account}.${tied} ${s.adsJudgedOnSales} judged on ${primary.many}${onFallback}.\n` +
                 s.notes.map((note) => `${note}\n`).join("") +
                 list("Winners", s.winners) +
                 list("Flops", s.flops) +
@@ -2173,18 +2223,37 @@ function winnersSendText(sent) {
         lines.push("Left out:", ...sent.skipped.map((s) => `  ${s.adId}: ${s.reason}`));
     return `${lines.join("\n")}\n`;
 }
-/** How an older server, which sent no rule, credited a sale. */
+/** How an older server, which sent no rule and judged only on sales, credited a sale. */
 const FIRST_TOUCH_SALE_RULE = "Each sale goes to the Facebook ad that first brought the buyer in; payments typed into GoHighLevel by hand never count toward an ad.";
 /**
- * The winners report as plain Markdown: what a sale means, then the dates asked for and, unless they are the same dates,
- * the last 30 days, each currency apart.
+ * The winners report as plain Markdown: which goal the ads are judged on and what one means, then the dates asked for and,
+ * unless they are the same dates, the last 30 days, each currency apart.
  */
 function winnersText(report) {
     const { week, last30Days } = report;
+    const words = winnersWords(report);
     return (`# Winners and flops for ${report.workspace}${report.format ? `, ${report.format} ads only` : ""}\n\n` +
-        `A sale means ${report.saleMeans}. ${report.saleRule ?? FIRST_TOUCH_SALE_RULE}\n` +
-        winnersWindowText(winnersDatesTitle(report.window), week) +
-        (week.from === last30Days.from && week.to === last30Days.to ? "" : winnersWindowText(`Last 30 days, ${last30Days.from} to ${last30Days.to}`, last30Days)));
+        (report.goalSentence ? `${report.goalSentence}\n` : "") +
+        `A ${words.primary.one} means ${report.saleMeans}. ${report.saleRule ?? FIRST_TOUCH_SALE_RULE}\n` +
+        winnersWindowText(winnersDatesTitle(report.window), week, words) +
+        (week.from === last30Days.from && week.to === last30Days.to ? "" : winnersWindowText(`Last 30 days, ${last30Days.from} to ${last30Days.to}`, last30Days, words)));
+}
+function printWinnersGoals(goals, format) {
+    if (format === "json")
+        return printJson(goals);
+    process.stdout.write(winnersGoalsText(goals));
+}
+/** The goals in order, each with whether its data is connected, then which one winners judges on now and why. */
+function winnersGoalsText({ goals, isDefault, chosen }) {
+    const rows = goals.map((g, i) => ({
+        order: String(i + 1),
+        goal: g.source === "first_touch" || g.source === "meta" ? g.kind : `${g.kind}:${g.source}`,
+        counts: g.label,
+        data: g.measurable ? "connected" : "not connected",
+    }));
+    return (`${renderTable(["order", "goal", "counts", "data"], rows)}\n\n` +
+        `${isDefault ? "This is the default list; no goals have been set for this client." : "These goals were set for this client."}\n` +
+        `${chosen.sentence}\n`);
 }
 function reportQuery(options, extra) {
     const query = new URLSearchParams();
@@ -2458,6 +2527,8 @@ ${Object.values(commands)
 Options:
   --format table|json   output format (default: table)
   --api-url <url>       API base URL
+  --client <name>       use that client's saved login (login --client <name> saves it); beats a ${CLIENT_FILE} file, which
+                        names the client for its folder and every folder below it; ${envPrefix}_API_KEY beats both
   --wait <seconds>      how long tools run and tools get wait for a run (default: ${DEFAULT_WAIT_SECONDS}; 0 returns at once)
   --agent <kind>        which agent the agent commands use: meta_ads (default) or p3_refresh; in a scheduled hand's run, skill
                         (the run's skill's agent) is the default
@@ -2549,6 +2620,12 @@ ${envPrefix}_OPERATOR_TOKEN instead of an API key, as do worker promote and work
 version a scheduled hand is trying the one in use, there and on every hand of the skill on an older version; worker
 drop stops trying it.
 
+winners judges a client's Facebook ads on its goals, tried in order: the first goal whose data is connected is the one
+used, and ads too new to judge on it are judged on the next connected goal of another kind. sales means first-touch
+sales from every connected payment source; to judge on Stripe sales, connect Stripe, then put sales first.
+sales:triple_whale means the orders Triple Whale credits to each ad. Meta's applications (submit_application_website)
+are judged through meta_results once the Meta source's result types are set to them.
+
 runner and runner once take the runner token in ${RUNNER_TOKEN_ENV}. ${HARNESS_COMMAND_ENV}, if set, names a program
 the runner starts instead of Claude Code or Codex.
 
@@ -2562,6 +2639,7 @@ function parseOptions(argv) {
             format: { type: "string", default: "table" },
             json: { type: "boolean", default: false },
             "api-url": { type: "string" },
+            client: { type: "string" },
             file: { type: "string", multiple: true },
             project: { type: "boolean", default: false },
             input: { type: "string" },
@@ -2670,6 +2748,7 @@ function parseOptions(argv) {
         options: {
             format: values.json ? "json" : values.format,
             apiUrl: values["api-url"],
+            client: values.client,
             file: values.file?.at(-1),
             files: values.file ?? [],
             project: values.project,
@@ -2765,7 +2844,7 @@ function parseOptions(argv) {
 async function changeCandidate(change, args, options) {
     if (args.length !== 1 || !options.workspace)
         throw new CliError(`Usage: worker ${change} <skill> --workspace <slug>`, exitCodes.usage);
-    return api(await operatorConnection(options.apiUrl), `/api/operator/workers/${change}`, { workspace: options.workspace, skill: args[0] });
+    return api(await operatorConnection(options), `/api/operator/workers/${change}`, { workspace: options.workspace, skill: args[0] });
 }
 function findCommand(positionals) {
     const three = positionals.slice(0, 3).join(" ");
@@ -3514,7 +3593,7 @@ function printIntakeToken({ endpoint, address, token, link, subscription }, form
     console.error(`The token for ${endpoint.label} is shown only now. Rotate it if it is lost.`);
 }
 async function patchIntake(id, body, options, done) {
-    const { endpoint } = await api(await resolveConnection(options.apiUrl), intakePath(id), body, "PATCH");
+    const { endpoint } = await api(await resolveConnection(options), intakePath(id), body, "PATCH");
     if (options.format === "json")
         return printJson({ endpoint });
     console.log(done(endpoint));