@wrangled/cli 0.3.44 → 0.3.46

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 = {
@@ -539,20 +545,11 @@ const commands = {
         },
     },
     "creatives download": {
-        usage: "creatives download <sku | asset-path | asset-link> [--out <path>] [--open]",
+        usage: "creatives download <sku | media-id | asset-path | asset-link> [--out <path>] [--open]",
         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 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)}`);
-            await saveFile(path, bytes);
-            if (options.open)
-                openFile(resolve(path));
-            if (options.format === "json")
-                return printJson({ path: resolve(path), bytes: bytes.byteLength, contentType });
-            console.log(`Saved ${target.label} to ${path} (${fileSize(bytes.byteLength)}).`);
+                throw new CliError("Usage: creatives download <sku | media-id | asset-path | asset-link> [--out <path>] [--open]", exitCodes.usage);
+            await download(args[0], options);
         },
     },
     "creatives create": {
@@ -563,7 +560,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,18 +576,60 @@ 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.`);
         },
     },
+    "media list": {
+        usage: "media list [--sku <sku>] [--run <tool-run-id>] [--tool <tool>] [--kind image|video] [--since <date>] [--until <date>] [--limit <n>] [--cursor <media-id>]",
+        async run(args, options) {
+            if (args.length > 0)
+                throw new CliError("Usage: media list [--sku <sku>] [--run <tool-run-id>] [--tool <tool>] [--kind image|video] [--since <date>] [--until <date>] [--limit <n>] [--cursor <media-id>]", exitCodes.usage);
+            const query = new URLSearchParams();
+            for (const name of ["sku", "run", "tool", "kind", "since", "until", "limit", "cursor"]) {
+                if (options[name])
+                    query.set(name, options[name]);
+            }
+            const page = await api(await resolveConnection(options), `/api/v1/media${query.size ? `?${query}` : ""}`);
+            if (options.format === "json")
+                return printJson(page);
+            if (page.media.length === 0)
+                return console.log("No made images or videos match.");
+            const rows = page.media.map((m) => ({ ...m, prompt: excerpt(m.prompt ?? ""), cost: costLabel(m), sku: m.sku ?? "" }));
+            console.log(renderTable(["id", "tool", "prompt", "cost", "sku", "createdAt", "assetUrl"], rows));
+            if (page.nextCursor)
+                console.log(`\nMore: add --cursor ${page.nextCursor}`);
+        },
+    },
+    "media get": {
+        usage: "media get <media-id>",
+        async run(args, options) {
+            if (args.length !== 1)
+                throw new CliError("Usage: media get <media-id>", exitCodes.usage);
+            const { media } = await api(await resolveConnection(options), mediaPath(args[0]));
+            if (options.format === "json")
+                return printJson({ media });
+            const fields = { ...media, cost: costLabel(media) };
+            const shown = ["id", "tool", "model", "prompt", "input", "cost", "contentType", "sku", "creativeStatus", "assetUrl", "workerRunId", "createdAt"];
+            console.log(renderTable(["field", "value"], shown.filter((f) => fields[f] != null).map((f) => ({ field: f, value: fields[f] }))));
+        },
+    },
+    "media download": {
+        usage: "media download <media-id> [--out <path>] [--open]",
+        async run(args, options) {
+            if (args.length !== 1 || !parseMediaId(args[0]))
+                throw new CliError("Usage: media download <media-id> [--out <path>] [--open]", exitCodes.usage);
+            await download(args[0], options);
+        },
+    },
     "content create": {
         usage: "content create --kind <kind> [--name <name>] [--subject <s>] [--preview <s>] [--headline <s>] [--body <text> | @file] [--html @file] [--fields '<json>' | @file.json] [--file <path> ...] [--tool-run <id> ...] [--run <agent-run-id>] [--note <why>] [--plan <plan-id> [--role <role>]]",
         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 +647,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 +663,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 +675,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 +691,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 +702,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,7 +713,7 @@ 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);
@@ -689,7 +728,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 +740,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
@@ -716,7 +755,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: winners goals", exitCodes.usage);
-            printWinnersGoals(await api(await resolveConnection(options.apiUrl), "/api/v1/winners/goals"), options.format);
+            printWinnersGoals(await api(await resolveConnection(options), "/api/v1/winners/goals"), options.format);
         },
     },
     "winners goals set": {
@@ -724,7 +763,7 @@ const commands = {
         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.apiUrl), "/api/v1/winners/goals", { goals: args }, "PUT"), options.format);
+            printWinnersGoals(await api(await resolveConnection(options), "/api/v1/winners/goals", { goals: args }, "PUT"), options.format);
         },
     },
     "winners goals reset": {
@@ -732,7 +771,7 @@ const commands = {
         async run(args, options) {
             if (args.length > 0)
                 throw new CliError("Usage: winners goals reset", exitCodes.usage);
-            printWinnersGoals(await api(await resolveConnection(options.apiUrl), "/api/v1/winners/goals", { goals: null }, "PUT"), options.format);
+            printWinnersGoals(await api(await resolveConnection(options), "/api/v1/winners/goals", { goals: null }, "PUT"), options.format);
         },
     },
     examples: {
@@ -740,7 +779,7 @@ const commands = {
         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) {
@@ -758,7 +797,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)
@@ -784,7 +823,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);
         },
     },
@@ -794,7 +833,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"}` : "";
@@ -810,7 +849,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);
@@ -821,7 +860,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);
@@ -835,7 +874,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 }),
@@ -853,7 +892,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,
@@ -869,7 +908,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);
         },
     },
@@ -879,7 +918,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 }),
@@ -892,7 +931,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);
         },
     },
@@ -901,7 +940,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);
         },
     },
@@ -910,7 +949,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({
@@ -928,7 +967,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);
         },
     },
@@ -939,7 +978,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);
         },
     },
@@ -948,7 +987,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;
@@ -968,7 +1007,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;
@@ -982,7 +1021,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)
@@ -997,7 +1036,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}.`);
@@ -1008,7 +1047,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;
@@ -1049,7 +1088,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)
@@ -1065,7 +1104,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}.`);
@@ -1076,7 +1115,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 }]));
@@ -1090,7 +1129,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,
@@ -1106,7 +1145,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.
@@ -1126,7 +1165,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);
@@ -1137,7 +1176,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);
@@ -1148,7 +1187,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);
@@ -1159,7 +1198,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);
@@ -1177,7 +1216,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")
@@ -1207,7 +1246,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);
@@ -1254,7 +1293,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)
@@ -1276,7 +1315,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) {
@@ -1301,7 +1340,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)
@@ -1314,7 +1353,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.`);
@@ -1328,7 +1367,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"}`;
@@ -1355,7 +1394,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 (;;) {
@@ -1384,7 +1423,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)
@@ -1398,7 +1437,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)
@@ -1414,7 +1453,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"}`;
@@ -1439,7 +1478,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;
@@ -1454,7 +1493,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.`);
@@ -1474,7 +1513,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) {
@@ -1489,7 +1528,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;
@@ -1513,7 +1552,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)
@@ -1526,7 +1565,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);
@@ -1537,7 +1576,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}).`);
@@ -1548,7 +1587,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}.`);
@@ -1559,7 +1598,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}.`);
@@ -1570,7 +1609,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);
@@ -1582,7 +1621,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;
@@ -1598,7 +1637,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}.`);
@@ -1609,7 +1648,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);
@@ -1620,7 +1659,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(", ");
@@ -1634,7 +1673,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 = [
@@ -1655,7 +1694,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")
@@ -1670,7 +1709,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)
@@ -1683,7 +1722,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)
@@ -1706,7 +1745,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)
@@ -1719,7 +1758,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}.`);
@@ -1731,7 +1770,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,
@@ -1750,7 +1789,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);
         },
     },
@@ -1762,7 +1801,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 }),
@@ -1776,7 +1815,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);
         },
     },
@@ -1785,7 +1824,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);
         },
     },
@@ -1794,7 +1833,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)]));
@@ -1813,7 +1852,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)
@@ -1841,7 +1880,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}`);
@@ -1853,7 +1892,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)
@@ -1893,7 +1932,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)
@@ -1917,7 +1956,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}`);
@@ -1933,7 +1972,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")
@@ -1993,6 +2032,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];
@@ -2032,7 +2083,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);
@@ -2509,6 +2560,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
@@ -2519,11 +2572,11 @@ Options:
                         for warehouse schema, a table to describe in full; repeat for several
   --summary             warehouse schema: one short row per table (kind, source, column count, summary)
   --search <words>      warehouse schema: describe in full the tables whose name, description or columns mention a word
-  --out <path>          the file, or existing folder, creatives download and warehouse query save to; warehouse query
+  --out <path>          the file, or existing folder, creatives download, media download and warehouse query save to; warehouse query
                         writes CSV for a .csv path, otherwise JSON
   --all                 with warehouse query --out, save the whole answer (up to 1,000,000 rows or 50 MiB) instead of
                         the first 1,000 rows or 5 MiB; .ndjson or .jsonl saves one JSON row per line
-  --open                open the file creatives download saved
+  --open                open the file creatives download or media download saved
   --media               with content pull, also save each item's files and HTML under media/ in the folder
   --full                with content pull, fetch every item, not only what changed since the last pull (brings new numbers)
   --force               content unpublish: take the page down even while delivering Meta ads link to it
@@ -2548,7 +2601,14 @@ Options:
   --source <text>       where the content content capture saves came from, in words
   --url <url>           the address of the content content capture saves
   --tool-run <id>       a succeeded tool run content create and edit link; repeat for several
-  --run <id>            the agent run making the content (content), or the tool run to record (creatives create)
+  --run <id>            the agent run making the content (content), the tool run to record (creatives create), or the tool
+                        run whose outputs media list shows
+  --sku <sku>           with media list, only the output that became this creative
+  --tool <tool>         with media list, only this tool's outputs, such as kie:nano-banana
+  --kind image|video    with media list, only images or only videos
+  --since, --until <YYYY-MM-DD | ISO time>   with media list, made at or after --since and before --until (a day: through
+                        its end, in UTC)
+  --cursor <media-id>   with media list, the next page: the id it printed after "More"
   --platform, --external-id   where content status launched says it was published, and that platform's id for it
   --object-type <type>  what that platform's sync calls it (campaign_message or flow_message on klaviyo); needed where
                         the sync matches several kinds, so its next read joins the item
@@ -2580,9 +2640,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, ads tags, content tags and content to-check
-                        return, how many ads ads autotag tags and how many items content autotag tags, or how many
-                        ads each ads tag-formats batch looks at (default 2000)
+  --limit <n>           how many results content search, creatives list, media list, campaigns, voice, ads tags, content tags
+                        and content to-check return, how many ads ads autotag tags and how many items content autotag
+                        tags, or how many ads each ads tag-formats batch looks at (default 2000)
   --library <slug>      with knowledge search, only this library: creative-cartel, exodus or meta-policy
   --angle, --hook-kind, --ad-format, --awareness <value>   with knowledge search, only library entries tagged that way, and
                         your own ads tagged the same way with their results; with knowledge tag, the tags to put on an entry;
@@ -2619,6 +2679,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" },
@@ -2648,6 +2709,10 @@ function parseOptions(argv) {
             yes: { type: "boolean", default: false },
             from: { type: "string" },
             since: { type: "string" },
+            until: { type: "string" },
+            sku: { type: "string" },
+            tool: { type: "string" },
+            cursor: { type: "string" },
             to: { type: "string" },
             grain: { type: "string" },
             channel: { type: "string" },
@@ -2727,6 +2792,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,
@@ -2758,6 +2824,10 @@ function parseOptions(argv) {
             yes: values.yes,
             from: values.from,
             since: values.since,
+            until: values.until,
+            sku: values.sku,
+            tool: values.tool,
+            cursor: values.cursor,
             to: values.to,
             grain: values.grain,
             channel: values.channel,
@@ -2822,7 +2892,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(" ");
@@ -3369,8 +3439,44 @@ async function readImportFile(path) {
     return readFile(path);
 }
 const ASSET_ROUTE = "/api/v1/assets/";
-/** What `creatives download` fetches, from a SKU, an asset path, or an asset link as `creatives show` prints it. */
+/** Saves a creative's or a made output's file, as `creatives download` and `media download` do. */
+async function download(arg, options) {
+    const connection = await resolveConnection(options);
+    const target = await downloadTarget(arg, 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)}`);
+    await saveFile(path, bytes);
+    if (options.open)
+        openFile(resolve(path));
+    if (options.format === "json")
+        return printJson({ path: resolve(path), bytes: bytes.byteLength, contentType });
+    console.log(`Saved ${target.label} to ${path} (${fileSize(bytes.byteLength)}).`);
+}
+const MEDIA_ID = /^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}):(0|[1-9]\d{0,3})$/i;
+function parseMediaId(raw) {
+    const match = MEDIA_ID.exec(raw);
+    return match ? { runId: match[1].toLowerCase(), index: Number(match[2]) } : null;
+}
+// A media id's colon is sent as it is, so the route reads the id whether or not the server decodes the path.
+function mediaPath(raw) {
+    const id = parseMediaId(raw);
+    if (!id)
+        throw new CliError(`"${excerpt(raw)}" is not a media id; media list prints them as <run id>:<index>.`, exitCodes.usage);
+    return `/api/v1/media/${id.runId}:${id.index}`;
+}
+function costLabel(media) {
+    return `${media.costCents}¢${media.costIsEstimate ? " (estimate)" : ""}`;
+}
+/** What `creatives download` fetches, from a SKU, a media id, an asset path, or an asset link as `creatives show` prints it. */
 async function downloadTarget(arg, connection) {
+    const output = parseMediaId(arg);
+    if (output) {
+        const { media } = await api(connection, mediaPath(arg));
+        if (!media.assetPath)
+            throw new CliError(`${media.id} has no stored file to download.`, exitCodes.error);
+        const name = media.sku ?? `${output.runId}-${output.index}`;
+        return { label: media.sku ?? media.id, assetPath: media.assetPath, fileName: `${name}${extname(media.assetPath)}` };
+    }
     const routeAt = arg.indexOf(ASSET_ROUTE);
     if (routeAt !== -1 || arg.includes("/")) {
         const assetPath = routeAt === -1 ? arg : decodeLinkPath(arg.slice(routeAt + ASSET_ROUTE.length).replace(/[?#].*$/, ""));
@@ -3571,7 +3677,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));