@wrangled/cli 0.3.44 → 0.3.46

package/dist/playbooks.js

@@ -62,7 +62,7 @@ export const metaAdsPlaybook = `# Facebook ads agent playbook (practice mode)
 
 You are the daily Facebook ads agent for one client workspace in ${brand.name}. Each run you read the client's Meta results, write new ad ideas grounded in what already wins, make one image per idea, and propose pauses and budget changes. A person approves or rejects every proposal on the approvals page in the ${brand.name} web app.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to. Add \`--format json\` whenever you need to read a field.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why. Add \`--format json\` whenever you need to read a field.
 
 ## Rules that never bend
 
@@ -364,7 +364,7 @@ You are the weekly P3 refresh hand for one client workspace in ${brand.name}. Ea
 
 The program has already done the counting. Its draft ranks the ad sets, picks the audience template, and lists every P1 winner, marked new, already in P3, or unresolved. Your job is the judgment: which ad set to retire and why, which winners look worn out, and a short summary a busy owner can read.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to. Pass \`--agent p3_refresh\` to every \`agent\` command; without it they act on a different hand. Add \`--format json\` whenever you need to read a field.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why. Pass \`--agent p3_refresh\` to every \`agent\` command; without it they act on a different hand. Add \`--format json\` whenever you need to read a field.
 
 ## Rules that never bend
 
@@ -582,7 +582,7 @@ export const mapOffersPlaybook = `# Map offers playbook
 
 You draft one client workspace's offers and funnels map in ${brand.name}: what the client sells, in what order (the offer stack), and the steps a person walks from first seeing an ad to buying (each funnel). You write it from the client's own data. When you save it, ${brand.name} checks it against that data, and a map whose every step can be counted goes live at once. A person can undo it in the ${brand.name} web app.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to. Add \`--format json\` whenever you need to read a field.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why. Add \`--format json\` whenever you need to read a field.
 
 ## Rules that never bend
 
@@ -737,7 +737,7 @@ You draft one client workspace's two own lists of ad words in ${brand.name}: its
 
 You only suggest. Each value you add is marked not yet confirmed, and agents may use it at once. An Owner or Admin confirms, renames, merges or retires it on the Ad words page in the ${brand.name} web app.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why.
 
 ## Rules that never bend
 
@@ -843,7 +843,7 @@ You do not work out the tags yourself. The server's tagger does: \`${cli} ads au
 
 Every tag the tagger saves is proposed: usable at once, marked not yet confirmed. You never confirm, fix or reject tags; an API key cannot. A person checks the ads that carry the top 20% of spend on the Tag check page in the ${brand.name} web app.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why.
 
 ## Rules that never bend
 
@@ -931,7 +931,7 @@ You work out how one client names its Facebook campaigns, ad sets and ads, and w
 
 You only suggest. The key you save waits, not yet confirmed. An Owner or Admin answers your questions on the Ad words page's Naming tab in the ${brand.name} web app and then confirms the key. Nothing uses it until then.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why.
 
 ## Rules that never bend
 
@@ -1223,7 +1223,7 @@ export const storyPlaybook = `# Weekly story hand playbook
 
 You write the weekly story for one client workspace in ${brand.name}: a one-screen read of how the frontend marketing did (ad spend, leads, sales from the ads, cost per new customer and order value), why, what is working and what isn't, what the data can't tell us, and what to do next, then a short big picture of backend revenue, with a shorter part for the client. It covers the 7 days that ended yesterday in the client's time zone, beside the 30 days that ended then, each compared with the period before. ${brand.name} checks every number: it runs each query behind the story itself when you save, and keeps the rows it got.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to. Pass \`--agent skill\` to every \`agent\` command. Add \`--format json\` whenever you need to read a field.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why. Pass \`--agent skill\` to every \`agent\` command. Add \`--format json\` whenever you need to read a field.
 
 ## Rules that never bend
 
@@ -1471,7 +1471,7 @@ After each weekly winners and flops report, you write down why the winners won a
 
 No person approves lessons. Write only what the numbers show.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why.
 
 ## Rules that never bend
 
@@ -1594,7 +1594,7 @@ export const weeklyLoopPlaybook = `# Weekly loop playbook (sample)
 
 A sample to borrow from, not a schedule, for a local orchestrator agent that runs a client's Facebook ads with its owner. It reads what sold, learns from it, gathers fresh material, gets new ads made, has them published through Adzara, and later reads their results back. It is written as a week, but its steps can run daily, several times a week or weekly, each on its own rhythm: the winners report covers whatever dates you ask for. ${brand.name} supplies the data and keeps no part of the loop's decisions.
 
-Every \`${cli}\` command acts on the one workspace the saved API key belongs to. Each step also names the MCP tool that does the same, for an agent connected over MCP without a shell.
+Every \`${cli}\` command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why. Each step also names the MCP tool that does the same, for an agent connected over MCP without a shell.
 
 ## Rules that never bend
 
@@ -1704,7 +1704,7 @@ export const pagesPlaybook = `# Page playbook
 
 You write one landing page for a client workspace in ${brand.name}: a page for a step of the client's funnel, or a new version of a page that already runs. ${brand.name} does not build pages. It hands you what already works, and takes the finished page back so its results count. A person approves every page before it goes online.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to. Add \`--format json\` whenever you need to read a field.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why. Add \`--format json\` whenever you need to read a field.
 
 ## Rules that never bend
 
@@ -1808,7 +1808,7 @@ Once a week you turn the funnel's costliest leaks into test ideas, put them to t
 
 ${brand.name} keeps the record of each test and no approvals. The owner says yes or no to each idea in your own session, and a change goes live through its own path, never through this playbook.
 
-You work only through the \`${cli}\` CLI. Every command acts on the one workspace the saved API key belongs to.
+You work only through the \`${cli}\` CLI. Every command acts on one workspace, picked by \`--client\` or by a client file in this folder or above it, otherwise the default login. \`${cli} whoami\` says which one and why.
 
 ## Rules that never bend
 

package/dist/runner/run.js

@@ -151,7 +151,7 @@ async function execute(claim, dir, options, signal, log) {
     const skillsDir = join(dir, claim.harness === "claude" ? ".claude" : ".codex", "skills");
     await installSkillFolder(skillsDir, claim.skill.name, unpackSkill(claim.skill, await getSigned(claim.skill.url)), []);
     const configHome = join(dir, ".config");
-    await writeCredentials({ apiKey: claim.runKey, apiUrl: options.apiUrl }, configHome);
+    await writeCredentials({ apiKey: claim.runKey, apiUrl: options.apiUrl }, { configHome });
     const binDir = join(dir, ".bin");
     await mkdir(binDir);
     await writeFile(join(binDir, brand.slug), cliShim(options.cliMain), { mode: 0o755 });

package/dist/skills.js

@@ -1,7 +1,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { lstat, mkdir, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { CliError, exitCodes, readCredentials, resolveApiUrl, UnreadableCredentialsError } from "./api.js";
+import { chosenApiUrl, CliError, exitCodes } from "./api.js";
 import { envPrefix } from "./brand.js";
 import { firstSymlink, inRunFolder } from "./files.js";
 import { readSkillZip, refuseOversizedFiles, refuseOversizedZip, refuseTooManyFiles, SKILL_NAME_PATTERN, SkillZipError, zipSkillFiles, } from "./skill-zip.js";
@@ -9,16 +9,11 @@ export const OPERATOR_TOKEN_ENV = `${envPrefix}_OPERATOR_TOKEN`;
 // Env files hold secrets, and a published skill reaches every workspace.
 const skipped = (entry) => [".git", "node_modules", ".DS_Store", ".env", ".envrc"].includes(entry) || entry.startsWith(".env.");
 /** Operator commands (the skill library, promoting and dropping a scheduled hand's candidate) take the operator token, never the workspace API key. */
-export async function operatorConnection(apiUrlFlag) {
+export async function operatorConnection(options) {
     const token = process.env[OPERATOR_TOKEN_ENV];
     if (!token)
         throw new CliError(`Set ${OPERATOR_TOKEN_ENV} to the server's OPERATOR_TOKEN for operator commands.`, exitCodes.auth);
-    const stored = await readCredentials().catch((error) => {
-        if (error instanceof UnreadableCredentialsError)
-            return null;
-        throw error;
-    });
-    const apiUrl = resolveApiUrl(apiUrlFlag, stored);
+    const apiUrl = await chosenApiUrl(options);
     return { apiUrl, apiKey: token, rejected: `The operator token in ${OPERATOR_TOKEN_ENV} was rejected by ${apiUrl}.` };
 }
 /** `my-skill` or `my-skill@3`; a null version means the latest published one. */

package/package.json

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