@koda-sl/baker-cli 0.378.0 → 0.379.0-dev.600795410

package/dist/{chunk-VLUGGVJL.js → chunk-MK4AIHRF.js}

@@ -1,10 +1,13 @@
 import {
+  cacheGet,
+  cacheSet,
   handleConnectionError,
   needsConnectionFix,
   writeAdsJson
 } from "./chunk-XHC4LMK4.js";
 import {
-  ApiError
+  ApiError,
+  apiGet
 } from "./chunk-MF7YA62W.js";
 import {
   getEnv
@@ -46,30 +49,80 @@ function handleMetaError(err) {
   process.exit(1);
 }
 var ACCOUNT_ID_RE = /^(act_)?[0-9]+$/;
-function resolveAccountIdArg(args) {
+var META_ACCOUNTS_CACHE = { category: "meta-accounts", key: "accounts:scoped", ttlMs: 60 * 60 * 1e3 };
+function withActPrefix(id) {
+  return id.startsWith("act_") ? id : `act_${id}`;
+}
+async function fetchConnectedAccounts(useCache) {
+  if (useCache) {
+    const cached = cacheGet(META_ACCOUNTS_CACHE.category, META_ACCOUNTS_CACHE.key);
+    if (cached) return cached.data;
+  }
+  const data = await apiGet("/api/ads/meta/accounts", useCache ? {} : { "skip-cache": "true" });
+  if (useCache) {
+    cacheSet(META_ACCOUNTS_CACHE.category, META_ACCOUNTS_CACHE.key, data, META_ACCOUNTS_CACHE.ttlMs);
+  }
+  return data;
+}
+function connectedAccountId(account) {
+  const id = account.externalId ?? account.id ?? account.account_id;
+  return id && ACCOUNT_ID_RE.test(id) ? withActPrefix(id) : void 0;
+}
+async function resolveAccountIdArg(args) {
   const fromArgs = args["account-id"];
   const id = fromArgs || getEnv().BAKER_META_AD_ACCOUNT_ID;
-  if (!id) {
+  if (id) {
+    if (!ACCOUNT_ID_RE.test(id)) {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "INVALID_ACCOUNT_ID",
+          message: `Invalid account ID "${id}". Expected numeric ID, optionally prefixed with "act_".`
+        }
+      });
+      process.exit(1);
+    }
+    return withActPrefix(id);
+  }
+  let accounts;
+  try {
+    accounts = await fetchConnectedAccounts(!args["no-cache"]);
+  } catch (err) {
+    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {
+      handleConnectionError("meta_ads", err.message);
+    }
     writeAdsJson({
       ok: false,
       error: {
         code: "MISSING_ACCOUNT_ID",
-        message: "Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs."
+        message: "Could not look up this company's Meta ad accounts. Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs."
       }
     });
     process.exit(1);
   }
-  if (!ACCOUNT_ID_RE.test(id)) {
-    writeAdsJson({
-      ok: false,
-      error: {
-        code: "INVALID_ACCOUNT_ID",
-        message: `Invalid account ID "${id}". Expected numeric ID, optionally prefixed with "act_".`
-      }
-    });
-    process.exit(1);
+  const connected = accounts.flatMap((account) => {
+    const accountId = connectedAccountId(account);
+    return accountId ? [{ id: accountId, name: account.name }] : [];
+  });
+  const [single] = connected;
+  if (connected.length === 1 && single) {
+    process.stderr.write(`Using Meta ad account ${single.name ? `"${single.name}" ` : ""}(${single.id})
+`);
+    return single.id;
   }
-  return id.startsWith("act_") ? id : `act_${id}`;
+  if (connected.length === 0) {
+    handleConnectionError("meta_ads");
+  }
+  const list = connected.map((account) => `  ${account.id}${account.name ? `  ${account.name}` : ""}`).join("\n");
+  writeAdsJson({
+    ok: false,
+    error: {
+      code: "MULTIPLE_ACCOUNTS",
+      message: `This company connected ${connected.length} Meta ad accounts. Pass --account-id or set BAKER_META_AD_ACCOUNT_ID:
+${list}`
+    }
+  });
+  process.exit(1);
 }
 function getDateRange(args) {
   const datePreset = args["date-preset"];
@@ -116,6 +169,7 @@ function statusFilterHints(rows, effectiveStatus, noun) {
 export {
   metaForbiddenFix,
   handleMetaError,
+  META_ACCOUNTS_CACHE,
   resolveAccountIdArg,
   getDateRange,
   todayIso,
@@ -125,4 +179,4 @@ export {
   resolveEffectiveStatus,
   statusFilterHints
 };
-//# sourceMappingURL=chunk-VLUGGVJL.js.map
+//# sourceMappingURL=chunk-MK4AIHRF.js.map

package/dist/chunk-MK4AIHRF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/shared.ts"],"sourcesContent":["import { ApiError, apiGet } from \"../../../client.ts\";\nimport { getEnv } from \"../../../env.ts\";\nimport { handleConnectionError, needsConnectionFix } from \"../../../error-handler.ts\";\nimport { cacheGet, cacheSet } from \"../cache.ts\";\nimport { writeAdsJson } from \"../output.ts\";\nimport type { AdsErrorEnvelope, QueryFix } from \"../types.ts\";\n\nconst DAY_MS = 86_400_000;\n\n/**\n * Meta answers a permission refusal (Graph codes 200/10/294) with a bare\n * \"Permissions error\" that covers two causes needing opposite remedies: a\n * consent grant the connection never got — nothing validates Meta's granted\n * scopes after connect, unlike HubSpot's `requireCapability` — or a role the\n * user lacks on one asset, since a Pixel/Dataset, Page or catalog lives in a\n * Business and is assigned separately from the ad account. Only the blast radius\n * separates them, so hand the agent that test rather than a verdict: guessing\n * \"reconnect\" wastes the user's time on an unassigned asset, and ruling it out\n * strands a connection that really is short a scope.\n */\nexport function metaForbiddenFix(message: string): QueryFix {\n  return {\n    action: \"reject\",\n    explanation: [\n      message,\n      \"This is a permission refusal, not a dead connection, and Meta returns the same code for two causes with opposite remedies. Tell them apart by how much else works before you answer.\",\n      \"If other reads on this account are ALSO refused (campaigns, ad sets, insights), the connection is short a permission it was never granted. Only the user can widen it, by reconnecting Meta from the dashboard.\",\n      \"If those reads work and only this object is refused, the asset (pixel/dataset, Page, or catalog) belongs to a Business the connected user holds no role in. Ad-account access does not carry asset access and reconnecting cannot grant it — the client assigns that asset to the connected user or partner in Meta Business settings, under the asset's own section (Data sources → Datasets for a pixel).\",\n      \"Either way do not retry the same call, and do not abort the wider job. Continue with what you can read, and state in your answer that this specific check could not run and why — never present the task as verified when this step was skipped.\",\n    ].join(\"\\n\\n\"),\n  };\n}\n\nexport function handleMetaError(err: unknown): never {\n  if (err instanceof ApiError) {\n    if (needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"meta_ads\", err.message);\n    }\n    const envelope: AdsErrorEnvelope = {\n      ok: false,\n      error: {\n        code: err.code,\n        message: err.message,\n        fix: err.code === \"FORBIDDEN\" ? metaForbiddenFix(err.message) : { action: \"reject\", explanation: err.message },\n        retryable: err.code === \"RATE_LIMITED\" || err.code === \"UNAVAILABLE\" || err.code === \"INTERNAL_ERROR\",\n      },\n    };\n    writeAdsJson(envelope);\n    process.exit(1);\n  }\n  const message = err instanceof Error ? err.message : \"Unexpected error\";\n  writeAdsJson({ ok: false, error: { code: \"NETWORK_ERROR\", message } });\n  process.exit(1);\n}\n\nconst ACCOUNT_ID_RE = /^(act_)?[0-9]+$/;\n\n/** A row of `/api/ads/meta/accounts` — the company's picked accounts, as `baker ads meta accounts` prints them. */\ninterface ConnectedMetaAccount {\n  externalId?: string;\n  id?: string;\n  account_id?: string;\n  name?: string;\n}\n\n/** Shared with `baker ads meta accounts`, so one listing serves both. */\nexport const META_ACCOUNTS_CACHE = { category: \"meta-accounts\", key: \"accounts:scoped\", ttlMs: 60 * 60 * 1000 };\n\nfunction withActPrefix(id: string): string {\n  return id.startsWith(\"act_\") ? id : `act_${id}`;\n}\n\nasync function fetchConnectedAccounts(useCache: boolean): Promise<ConnectedMetaAccount[]> {\n  if (useCache) {\n    const cached = cacheGet<ConnectedMetaAccount[]>(META_ACCOUNTS_CACHE.category, META_ACCOUNTS_CACHE.key);\n    if (cached) return cached.data;\n  }\n  const data = await apiGet<ConnectedMetaAccount[]>(\"/api/ads/meta/accounts\", useCache ? {} : { \"skip-cache\": \"true\" });\n  if (useCache) {\n    cacheSet(META_ACCOUNTS_CACHE.category, META_ACCOUNTS_CACHE.key, data, META_ACCOUNTS_CACHE.ttlMs);\n  }\n  return data;\n}\n\nfunction connectedAccountId(account: ConnectedMetaAccount): string | undefined {\n  const id = account.externalId ?? account.id ?? account.account_id;\n  return id && ACCOUNT_ID_RE.test(id) ? withActPrefix(id) : undefined;\n}\n\n/**\n * The Meta ad account a command works on: `--account-id`, else\n * `BAKER_META_AD_ACCOUNT_ID`, else the company's only connected account — the\n * default `baker ads meta accounts` promises. With several connected, nothing\n * is picked for the agent: the refusal lists them so the next call can name one.\n */\nexport async function resolveAccountIdArg(args: Record<string, unknown>): Promise<string> {\n  const fromArgs = args[\"account-id\"] as string | undefined;\n  const id = fromArgs || getEnv().BAKER_META_AD_ACCOUNT_ID;\n  if (id) {\n    if (!ACCOUNT_ID_RE.test(id)) {\n      writeAdsJson({\n        ok: false,\n        error: {\n          code: \"INVALID_ACCOUNT_ID\",\n          message: `Invalid account ID \"${id}\". Expected numeric ID, optionally prefixed with \"act_\".`,\n        },\n      });\n      process.exit(1);\n    }\n    return withActPrefix(id);\n  }\n\n  let accounts: ConnectedMetaAccount[];\n  try {\n    accounts = await fetchConnectedAccounts(!args[\"no-cache\"]);\n  } catch (err) {\n    if (err instanceof ApiError && needsConnectionFix(err.code, err.message)) {\n      handleConnectionError(\"meta_ads\", err.message);\n    }\n    writeAdsJson({\n      ok: false,\n      error: {\n        code: \"MISSING_ACCOUNT_ID\",\n        message:\n          \"Could not look up this company's Meta ad accounts. Pass --account-id or set BAKER_META_AD_ACCOUNT_ID. Run `baker ads meta accounts` to find IDs.\",\n      },\n    });\n    process.exit(1);\n  }\n\n  const connected = accounts.flatMap((account) => {\n    const accountId = connectedAccountId(account);\n    return accountId ? [{ id: accountId, name: account.name }] : [];\n  });\n  const [single] = connected;\n  if (connected.length === 1 && single) {\n    process.stderr.write(`Using Meta ad account ${single.name ? `\"${single.name}\" ` : \"\"}(${single.id})\\n`);\n    return single.id;\n  }\n  if (connected.length === 0) {\n    handleConnectionError(\"meta_ads\");\n  }\n  const list = connected.map((account) => `  ${account.id}${account.name ? `  ${account.name}` : \"\"}`).join(\"\\n\");\n  writeAdsJson({\n    ok: false,\n    error: {\n      code: \"MULTIPLE_ACCOUNTS\",\n      message: `This company connected ${connected.length} Meta ad accounts. Pass --account-id or set BAKER_META_AD_ACCOUNT_ID:\\n${list}`,\n    },\n  });\n  process.exit(1);\n}\n\nexport function getDateRange(args: Record<string, unknown>): { datePreset?: string; since?: string; until?: string } {\n  const datePreset = args[\"date-preset\"] as string | undefined;\n  const since = args.since as string | undefined;\n  const until = args.until as string | undefined;\n  if (since && until) return { since, until };\n  return { datePreset: datePreset ?? \"last_7d\" };\n}\n\nexport function todayIso(): string {\n  return new Date().toISOString().slice(0, 10);\n}\n\nexport function daysAgoIso(days: number): string {\n  return new Date(Date.now() - days * DAY_MS).toISOString().slice(0, 10);\n}\n\nexport function csvOrJson(args: Record<string, unknown>): string {\n  return (args.output as string | undefined) ?? \"json\";\n}\n\n/**\n * Matched by Meta itself, so finding one entity by name reads only the rows that\n * match instead of the whole account.\n */\nexport const NAME_CONTAINS_ARG = {\n  type: \"string\",\n  description:\n    \"Only rows whose name contains this text, matched by Meta before anything is returned. Start here to find one entity by name: --name-contains octubre --all-statuses\",\n} as const;\n\n/**\n * Default to ACTIVE-only on listings — that's almost always what an AI agent or\n * a human glance wants. Pass `--effective-status ACTIVE,PAUSED` to override, or\n * `--all-statuses` to drop the filter entirely.\n */\nexport function resolveEffectiveStatus(args: Record<string, unknown>): string | undefined {\n  if (args[\"all-statuses\"]) {\n    return undefined;\n  }\n  const explicit = args[\"effective-status\"] as string | undefined;\n  if (explicit) {\n    return explicit;\n  }\n  return \"ACTIVE\";\n}\n\n/**\n * An empty listing under a status filter reads exactly like \"nothing exists\":\n * a paused campaign's ad sets are CAMPAIGN_PAUSED, so the ACTIVE default hides\n * every one of them. Say which filter produced the empty list and how to widen it.\n */\nexport function statusFilterHints(\n  rows: ReadonlyArray<unknown>,\n  effectiveStatus: string | undefined,\n  noun: string,\n): string[] {\n  if (rows.length > 0 || effectiveStatus === undefined) return [];\n  if (effectiveStatus === \"ACTIVE\") {\n    return [\n      `No ACTIVE ${noun}. The ACTIVE filter hides paused, archived and in-review ones (under a paused campaign or ad set that is all of them), so this does NOT mean none exist. Re-run with --all-statuses before concluding there are none.`,\n    ];\n  }\n  return [\n    `No ${noun} with effective_status ${effectiveStatus}. Re-run with --all-statuses to see every status before concluding there are none.`,\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -70,8 +70,9 @@ import {
   validateCanvasDeep,
   withoutCastName,
   ytDlpBlockSignal
-} from "./chunk-FGHMWBUD.js";
+} from "./chunk-CHJOTJTZ.js";
 import {
+  META_ACCOUNTS_CACHE,
   NAME_CONTAINS_ARG,
   csvOrJson,
   daysAgoIso,
@@ -81,7 +82,7 @@ import {
   resolveEffectiveStatus,
   statusFilterHints,
   todayIso
-} from "./chunk-VLUGGVJL.js";
+} from "./chunk-MK4AIHRF.js";
 import {
   buildQueryCacheKey,
   cacheGet,
@@ -24295,11 +24296,14 @@ Examples:
   BAKER_META_AD_ACCOUNT_ID=act_123 baker ads meta account`
   },
   args: {
-    "account-id": { type: "string", description: "Meta ad account ID (act_...)" },
+    "account-id": {
+      type: "string",
+      description: "Meta ad account ID (act_...); defaults to the only connected account"
+    },
     "no-cache": NO_CACHE_ARG
   },
   run: async ({ args: args5 }) => {
-    const accountId = resolveAccountIdArg(args5);
+    const accountId = await resolveAccountIdArg(args5);
     try {
       const params = { "account-id": accountId };
       if (args5["no-cache"]) params["skip-cache"] = "true";
@@ -24345,9 +24349,9 @@ Examples:
   run: async ({ args: args5 }) => {
     const includeAll = args5["include-all"] === true;
     const useCache = !args5["no-cache"];
-    const cacheKey = `accounts:${includeAll ? "all" : "scoped"}`;
+    const cacheKey = includeAll ? "accounts:all" : META_ACCOUNTS_CACHE.key;
     if (useCache) {
-      const cached = cacheGet("meta-accounts", cacheKey);
+      const cached = cacheGet(META_ACCOUNTS_CACHE.category, cacheKey);
       if (cached) {
         writeJsonEnvelope({
           ok: true,
@@ -24364,7 +24368,7 @@ Examples:
       if (!useCache) params["skip-cache"] = "true";
       const data = await apiGet("/api/ads/meta/accounts", params);
       if (useCache) {
-        cacheSet("meta-accounts", cacheKey, data, 60 * 60 * 1e3);
+        cacheSet(META_ACCOUNTS_CACHE.category, cacheKey, data, META_ACCOUNTS_CACHE.ttlMs);
       }
       const fmt = csvOrJson(args5);
       if (fmt !== "json") {
@@ -24537,7 +24541,7 @@ function registerMetaListSchema(kind, description, args5) {
 
 // src/commands/ads/meta/activities.ts
 var listArgs4 = {
-  "account-id": { type: "string", description: "Meta ad account ID" },
+  "account-id": { type: "string", description: "Meta ad account ID (act_...); defaults to the only connected account" },
   days: { type: "string", description: "Lookback days (default 7)" },
   limit: { type: "string", description: "Max rows" },
   "no-cache": NO_CACHE_ARG,
@@ -24566,7 +24570,7 @@ Examples:
   },
   args: listArgs4,
   run: async ({ args: args5 }) => {
-    const accountId = resolveAccountIdArg(args5);
+    const accountId = await resolveAccountIdArg(args5);
     try {
       const params = { "account-id": accountId };
       if (args5.days) params.days = args5.days;
@@ -26239,8 +26243,8 @@ import { defineCommand as defineCommand57 } from "citty";
 
 // src/commands/ads/meta/write-shared.ts
 import { readFileSync as readFileSync9 } from "fs";
-function bareAccountId2(args5) {
-  return resolveAccountIdArg(args5).replace(/^act_/, "");
+async function bareAccountId2(args5) {
+  return (await resolveAccountIdArg(args5)).replace(/^act_/, "");
 }
 function failWriteValidation3(message) {
   writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
@@ -26366,7 +26370,7 @@ async function stageStatusChange2(input) {
 // src/commands/ads/meta/write-commands.ts
 var STAGED_NOTE2 = "Staged until publish \u2014 review with `baker ads meta draft`.";
 var accountArgs2 = {
-  "account-id": { type: "string", description: "Numeric account ID or act_N" }
+  "account-id": { type: "string", description: "Numeric account ID or act_N; defaults to the only connected account" }
 };
 function campaignPayloadFromFlags2(args5) {
   return {
@@ -26422,7 +26426,7 @@ Example: baker ads meta campaigns create --name "Q3 Prospecting" --objective OUT
     file: { type: "string", description: "JSON file with the full payload; flags override file keys" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const payload = mergePayload3(loadJsonFileArg3(args5.file), campaignPayloadFromFlags2(args5));
     await stageOp2({ kind: "campaign.create", accountId, payload });
   }
@@ -26442,7 +26446,7 @@ Pass a meta_temp_* ref to amend a campaign staged in this chat. Example: baker a
     file: { type: "string", description: "JSON file with fields to change" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const payload = mergePayload3(loadJsonFileArg3(args5.file), {
       name: args5.name,
       status: upper(args5.status),
@@ -26535,7 +26539,7 @@ Example: baker ads meta custom-conversions create --name "Lead formulario" --pix
     value: { type: "string", description: "Default value of one conversion, when the site sends no value" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     await stageOp2({
       kind: "customConversion.create",
       accountId,
@@ -26592,7 +26596,7 @@ Example: baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54
   },
   args: { campaign: { type: "string", description: "Parent campaign id or meta_temp_* ref" }, ...adSetWriteArgs },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const payload = mergePayload3(loadJsonFileArg3(args5.file), adSetPayloadFromFlags(args5));
     await stageOp2({ kind: "adSet.create", accountId, payload });
   }
@@ -26606,7 +26610,7 @@ Example: baker ads meta adsets update 6123 --daily-budget 80`
   },
   args: { id: { type: "positional", description: "Ad set id or meta_temp_* ref", required: true }, ...adSetWriteArgs },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const {
       campaign_id: _drop,
       billing_event: _be,
@@ -26708,7 +26712,7 @@ Example: baker ads meta creatives create --page 555 --message "Save now" --link
     file: { type: "string", description: "JSON file with the full creative payload (carousel cards / dynamic assets)" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const payload = mergePayload3(loadJsonFileArg3(args5.file), creativePayloadFromFlags(args5));
     if (payload.creativeType === void 0) {
       payload.creativeType = "single";
@@ -26739,7 +26743,7 @@ Amending a staged (meta_temp_*) creative merges fields into the create. Example:
     }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const file = loadJsonFileArg3(args5.file);
     const payload = mergePayload3(file, {
       name: args5.name,
@@ -26773,7 +26777,7 @@ Example: baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creati
     file: { type: "string", description: "JSON file with the full payload" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const tracking = args5["tracking-file"] ? loadJsonFileArg3(args5["tracking-file"]).tracking_specs : void 0;
     const payload = mergePayload3(loadJsonFileArg3(args5.file), {
       name: args5.name,
@@ -26800,7 +26804,7 @@ Example: baker ads meta ads update 6123 --creative meta_temp_cr02`
     file: { type: "string", description: "JSON file with fields to change" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const payload = mergePayload3(loadJsonFileArg3(args5.file), {
       name: args5.name,
       status: upper(args5.status),
@@ -26836,9 +26840,9 @@ Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{si
     const { apiPost: apiPost2 } = await import("./client-GR6YL3YX.js");
     const { requireChatId: requireChatId2 } = await import("./env-4P5HOGNA.js");
     const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-NMQXZF3Z.js");
-    const { handleMetaError: handleMetaError2 } = await import("./shared-J7DQZ2ED.js");
+    const { handleMetaError: handleMetaError2 } = await import("./shared-DDBXEUL4.js");
     try {
-      const accountId = bareAccountId2(args5);
+      const accountId = await bareAccountId2(args5);
       const urlTags = typeof args5["url-tags"] === "string" ? args5["url-tags"] : void 0;
       const setRaw = typeof args5.set === "string" ? args5.set : void 0;
       if (urlTags === void 0 === (setRaw === void 0)) {
@@ -26892,7 +26896,7 @@ Example: baker ads meta audiences create --name "Site visitors 30d" --subtype WE
     file: { type: "string", description: "JSON file with lookalike_spec / rule / full payload" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const payload = mergePayload3(loadJsonFileArg3(args5.file), {
       name: args5.name,
       subtype: upper(args5.subtype),
@@ -26915,7 +26919,7 @@ var audiencesUpdateCommand = defineCommand57({
     file: { type: "string", description: "JSON file with fields to change" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const payload = mergePayload3(loadJsonFileArg3(args5.file), { name: args5.name, description: args5.description });
     await stageOp2({
       kind: "customAudience.update",
@@ -26939,7 +26943,7 @@ Example: baker ads meta media upload --kind image --image-id <bakerImageId>`
     name: { type: "string", description: "Display name / filename hint" }
   },
   run: async ({ args: args5 }) => {
-    const accountId = bareAccountId2(args5);
+    const accountId = await bareAccountId2(args5);
     const kind = String(args5.kind ?? "").toLowerCase();
     if (kind !== "image" && kind !== "video") {
       failWriteValidation3("--kind must be image or video");
@@ -26957,7 +26961,7 @@ function statusCommand3(name, kind, label) {
     meta: { name, description: `Stage ${name} for a ${label}. ${STAGED_NOTE2}` },
     args: { id: { type: "positional", description: `${label} id`, required: true }, ...accountArgs2 },
     run: async ({ args: args5 }) => {
-      const accountId = bareAccountId2(args5);
+      const accountId = await bareAccountId2(args5);
       await stageStatusChange2({
         kind,
         accountId,
@@ -26984,9 +26988,9 @@ function duplicateCommand2(entity, label) {
       const { apiPost: apiPost2 } = await import("./client-GR6YL3YX.js");
       const { requireChatId: requireChatId2 } = await import("./env-4P5HOGNA.js");
       const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-NMQXZF3Z.js");
-      const { handleMetaError: handleMetaError2 } = await import("./shared-J7DQZ2ED.js");
+      const { handleMetaError: handleMetaError2 } = await import("./shared-DDBXEUL4.js");
       try {
-        const accountId = bareAccountId2(args5);
+        const accountId = await bareAccountId2(args5);
         const chatId = requireChatId2();
         const response = await apiPost2("/api/ads/meta/draft/duplicate", {
           chatId,
@@ -27018,7 +27022,7 @@ var adsDuplicateCommand = duplicateCommand2("ad", "ad");
 
 // src/commands/ads/meta/ads.ts
 var listArgs5 = {
-  "account-id": { type: "string", description: "Meta ad account ID" },
+  "account-id": { type: "string", description: "Meta ad account ID (act_...); defaults to the only connected account" },
   "adset-id": { type: "string", description: "Filter to one adset" },
   "campaign-id": { type: "string", description: "Filter to one campaign" },
   "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
@@ -27040,7 +27044,7 @@ var listCommand4 = defineCommand58({
   },
   args: listArgs5,
   run: async ({ args: args5 }) => {
-    const accountId = resolveAccountIdArg(args5);
+    const accountId = await resolveAccountIdArg(args5);
     const effectiveStatus = resolveEffectiveStatus(args5);
     try {
       const params = { "account-id": accountId };
@@ -27100,7 +27104,7 @@ Examples:
 // src/commands/ads/meta/adsets.ts
 import { defineCommand as defineCommand59 } from "citty";
 var listArgs6 = {
-  "account-id": { type: "string", description: "Meta ad account ID" },
+  "account-id": { type: "string", description: "Meta ad account ID (act_...); defaults to the only connected account" },
   "campaign-id": { type: "string", description: "Filter to one campaign" },
   "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
@@ -27121,7 +27125,7 @@ var listCommand5 = defineCommand59({
   },
   args: listArgs6,
   run: async ({ args: args5 }) => {
-    const accountId = resolveAccountIdArg(args5);
+    const accountId = await resolveAccountIdArg(args5);
     const effectiveStatus = resolveEffectiveStatus(args5);
     try {
       const params = { "account-id": accountId };
@@ -27175,7 +27179,7 @@ Examples:
 // src/commands/ads/meta/audiences.ts
 import { defineCommand as defineCommand60 } from "citty";
 var listArgs7 = {
-  "account-id": { type: "string", description: "Meta ad account ID" },
+  "account-id": { type: "string", description: "Meta ad account ID (act_...); defaults to the only connected account" },
   limit: { type: "string", description: "Max rows" },
   "no-cache": NO_CACHE_ARG,
   output: { type: "string", description: "Output format", default: "json" }
@@ -27187,7 +27191,7 @@ var listCommand6 = defineCommand60({
   },
   args: listArgs7,
   run: async ({ args: args5 }) => {
-    const accountId = resolveAccountIdArg(args5);
+    const accountId = await resolveAccountIdArg(args5);
     try {
       const params = { "account-id": accountId };
       if (args5.limit) params.limit = args5.limit;
@@ -27261,7 +27265,7 @@ Examples:
 // src/commands/ads/meta/campaigns.ts
 import { defineCommand as defineCommand62 } from "citty";
 var listArgs8 = {
-  "account-id": { type: "string", description: "Meta ad account ID" },
+  "account-id": { type: "string", description: "Meta ad account ID (act_...); defaults to the only connected account" },
   "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
   "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter and return everything" },
   "name-contains": NAME_CONTAINS_ARG,
@@ -27281,7 +27285,7 @@ var listCommand7 = defineCommand62({
   },
   args: listArgs8,
   run: async ({ args: args5 }) => {
-    const accountId = resolveAccountIdArg(args5);
+    const accountId = await resolveAccountIdArg(args5);
     const effectiveStatus = resolveEffectiveStatus(args5);
     try {
       const params = { "account-id": accountId };
@@ -27340,7 +27344,10 @@ Examples:
 // src/commands/ads/meta/creatives.ts
 import { defineCommand as defineCommand63 } from "citty";
 var listArgs9 = {
-  "account-id": { type: "string", description: "Meta ad account ID (required if no --creative-id)" },
+  "account-id": {
+    type: "string",
+    description: "Meta ad account ID (act_...) when listing without --creative-id; defaults to the only connected account"
+  },
   "creative-id": { type: "string", description: "Single creative ID" },
   limit: { type: "string", description: "Max rows (default 500)" },
   "no-cache": NO_CACHE_ARG,
@@ -27358,7 +27365,7 @@ var listCommand8 = defineCommand63({
       if (args5["creative-id"]) {
         params["creative-id"] = args5["creative-id"];
       } else {
-        const accountId = resolveAccountIdArg(args5);
+        const accountId = await resolveAccountIdArg(args5);
         params["account-id"] = accountId;
       }
       if (args5.limit) params.limit = args5.limit;
@@ -27438,7 +27445,11 @@ registerSchema({
   command: "ads.meta.custom-conversions",
   description: "List the Custom Conversions defined on a Meta ad account \u2014 the measurement objects a marketer sets up in Events Manager (a pixel event narrowed by a rule, e.g. 'PageView on /thank-you'). Start here whenever the user talks about their own conversions rather than a standard event: an ad set optimizes toward one with `adsets create --custom-conversion-id <id>`.",
   args: {
-    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
+    "account-id": {
+      type: "string",
+      description: "Meta ad account ID (act_...); defaults to the only connected account",
+      required: false
+    },
     full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times", required: false },
     limit: { type: "string", description: "Max rows", required: false },
     "no-cache": { type: "boolean", description: "Bypass the cache", required: false },
@@ -27446,7 +27457,7 @@ registerSchema({
   }
 });
 var listArgs10 = {
-  "account-id": { type: "string", description: "Meta ad account ID" },
+  "account-id": { type: "string", description: "Meta ad account ID (act_...); defaults to the only connected account" },
   full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times" },
   limit: { type: "string", description: "Max rows" },
   "no-cache": NO_CACHE_ARG,
@@ -27459,7 +27470,7 @@ var listCommand9 = defineCommand64({
   },
   args: listArgs10,
   run: async ({ args: args5 }) => {
-    const accountId = resolveAccountIdArg(args5);
+    const accountId = await resolveAccountIdArg(args5);
     try {
       const params = { "account-id": accountId };
       if (args5.limit) params.limit = args5.limit;
@@ -28336,7 +28347,10 @@ Examples:
   baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`
   },
   args: {
-    "account-id": { type: "string", description: "Meta ad account ID" },
+    "account-id": {
+      type: "string",
+      description: "Meta ad account ID (act_...); defaults to the only connected account"
+    },
     "pixel-id": { type: "string", description: "Pixel ID for --stats" },
     stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
     aggregation: {
@@ -28380,7 +28394,7 @@ async function runStats(args5) {
   emit(data, args5);
 }
 async function runList(args5) {
-  const accountId = resolveAccountIdArg(args5);
+  const accountId = await resolveAccountIdArg(args5);
   const params = { "account-id": accountId };
   if (args5["no-cache"]) params["skip-cache"] = "true";
   const { pixels, restrictedFields } = await apiGet("/api/ads/meta/pixels", params);