@koda-sl/baker-cli 0.384.0-dev.4699b7308 → 0.385.0-dev.ec7b0e42b

package/README.md

@@ -163,7 +163,7 @@ Multi-platform ad commands. Google, Meta, and LinkedIn support both reads and **
 
 ### `baker ads google accounts`
 
-List all accessible Google Ads accounts. Run this first to find account IDs.
+List the Google Ads accounts selected for this company. Run this first to find account IDs.
 
 ```bash
 baker ads google accounts
@@ -788,7 +788,7 @@ Read X Ads campaigns, line items, promoted tweets, creatives, audiences, and ana
 
 | Subcommand | What it returns |
 |---|---|
-| `accounts` | All accessible X Ads accounts |
+| `accounts` | X Ads accounts selected for this company that X currently lists |
 | `funding` | Funding instruments for an account |
 | `campaigns` | Campaigns (filter by `--funding-instrument-ids`, `--campaign-ids`) |
 | `line-items` | Line items / ad groups (filter by `--campaign-ids`, `--line-item-ids`) |
@@ -892,7 +892,7 @@ baker ads meta insights --object act_123 --level adset \
 baker ads meta activities --account-id act_123 --days 7
 
 # "Which Page should this ad run from?"
-baker ads meta pages                                                 # Facebook Pages the user manages (tasks shows which can ADVERTISE)
+baker ads meta pages                                                 # Pages with promotingAccountIds and hasPageAccessToken
 
 # "What is the lead form collecting, and how many came in?"
 baker ads meta lead-forms --page-id 100635183117758                  # instant forms on a Page + lead counts
@@ -930,6 +930,8 @@ baker ads meta custom-conversions --account-id act_123          # id, event cate
 baker ads meta custom-conversions --account-id act_123 --full   # raw rule JSON, retention, timestamps
 ```
 
+Use a Page only with an ad account listed in its `promotingAccountIds`. Instant-form reads need `hasPageAccessToken: true` on that Page and the company's lead-ads permissions.
+
 **Custom Conversions** — a marketer's own conversion (a pixel event narrowed by a rule, e.g. "PageView on /gracias"), which is what "my conversions" almost always means. To optimize an ad set toward one, pass `--custom-conversion-id <id>` and nothing else: Baker reads the conversion off Meta at stage time and fills its pixel, event category and rule, the same four fields Ads Manager stores. Staging refuses an archived or unavailable conversion, one not built on a pixel, and one belonging to another ad account. Deleting one — in Events Manager or over the API — archives it: it leaves the panel but stays readable on the account, so the listing still shows it flagged `archived`.
 
 `custom-conversions create` stages a new one (`--name`, `--pixel-id`, `--custom-event-type`, plus `--url-contains "/gracias"` or `--rule-file`). A rule is a tree of `and`/`or` over `{"<field>":{"<operator>":<value>}}` leaves, where the field is `URL`, `event`, `referrer` or any event parameter the pixel sends (`value`, `content_category`, or your own), so `--url-contains` is only the single-URL shortcut and `--rule-file` reaches the rest. Meta accepts an unmatchable rule and reports success, so staging refuses unknown operators, bare values, empty branches and two conditions written side by side where `and` was meant, before the op is staged. A case-sensitive `contains` is a real operator and gets through — on a URL always write `i_contains`. It is create-only, because Meta's edge offers neither update nor a delete that removes — which is also why staging refuses a create whose pixel, event category and rule already exist, live on the account or staged earlier in the same chat, or one that would pass Meta's cap of 100 per account. An ad set in the same chat can chain to it with `--custom-conversion-id meta_temp_*`.
@@ -952,6 +954,11 @@ Chain a full ad from scratch with `meta_temp_*` refs (each create returns one):
 # 1. (optional) upload creative media from the Baker library → publishes an image hash
 baker ads meta media upload --account-id act_123 --kind image --image-id <bakerImageId>   # → meta_temp_img
 
+# For on-ad leads, choose a Page with this account in promotingAccountIds and hasPageAccessToken: true
+baker ads meta lead-forms create --account-id act_123 --page-id 555 --name "Free audit" \
+  --questions FULL_NAME,EMAIL,PHONE --privacy-policy-url https://example.com/privacy \
+  --follow-up-url https://example.com   # → meta_temp_form
+
 # 2. campaign → ad set → creative → ad
 baker ads meta campaigns create   --account-id act_123 --name "Q3 Prospecting" --objective OUTCOME_LEADS --daily-budget 50   # → meta_temp_camp
 baker ads meta adsets create      --account-id act_123 --campaign meta_temp_camp --name "US 25-54" \
@@ -997,9 +1004,8 @@ To find one entity by name, pass `--name-contains <text>` to `campaigns`, `adset
 
 ```
 accounts            # ad accounts in the connected scope
-accounts --include-all   # every account the token can see (admin/debug)
 account             # single-account detail (currency, balance, business, status)
-businesses          # /me/businesses
+businesses          # businesses linked to selected ad accounts
 campaigns           # ACTIVE-only by default
 adsets              # filter by --campaign-id
 ads                 # filter by --adset-id or --campaign-id
@@ -1125,7 +1131,6 @@ baker ads linkedin bid-pricing --account-id 503001492 \
 
 ```
 accounts                       # accounts in the connected picker scope
-accounts --include-all         # every account the token can see
 account                        # single-account detail (currency, type, status)
 
 campaign-groups                # default ACTIVE-only
@@ -1497,7 +1502,7 @@ A Google Analytics connection made before writes shipped is read-only and every
 
 ### `baker ga4 properties`
 
-List accessible GA4 properties. Run this first to find property IDs.
+List the GA4 properties selected for this company. Run this first to find property IDs.
 
 ```bash
 baker ga4 properties
@@ -3754,6 +3759,10 @@ baker schema tag-manager read   # Kebab-case paths resolve to their registered n
 
 Not every command registers a schema. On `NOT_FOUND` the error carries a structured `fix` pointing at `--help` and the family's agent doc (`__tooling__/docs/tools/baker/<family>.md` in sandboxes). Every top-level family's `--help` also ends with a `Full guide:` line pointing at that doc; `packages/cli/__tests__/doc-coverage.test.ts` fails CI if a mounted command is missing from its family doc.
 
+### `baker tag-manager containers`
+
+Lists the company's selected Tag Manager containers that the connected Google account can still open. If access to a selected container was lost, the response names it in `unavailableContainers` and asks the user to reconnect with an account that can open it.
+
 ## `baker studio` — make new imagery
 
 The generation lane. `baker images` **sources** what already exists; `baker studio` **makes** what doesn't. Every call opens a *batch* — one brief, 1-8 takes, rendered in parallel — recorded against the calling chat and shown in the dashboard Studio next to the batches the client ran themselves.

package/dist/{chunk-CHJOTJTZ.js → chunk-JHKW6IDX.js}

@@ -20,9 +20,9 @@ import {
   shouldEscalate
 } from "./chunk-HJEMOSPH.js";
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/509a695c9237c6e3727f1f1f99169917f329e3ff3f7877be290b684e24bf153d/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
-  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js"(exports, module) {
+  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/509a695c9237c6e3727f1f1f99169917f329e3ff3f7877be290b684e24bf153d/node_modules/safe-stable-stringify/index.js"(exports, module) {
     "use strict";
     var { hasOwnProperty } = Object.prototype;
     var stringify = configure2();
@@ -1123,7 +1123,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/esm/wrapper.js
+// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/509a695c9237c6e3727f1f1f99169917f329e3ff3f7877be290b684e24bf153d/node_modules/safe-stable-stringify/esm/wrapper.js
 var import__ = __toESM(require_safe_stable_stringify(), 1);
 var configure = import__.default.configure;
 var wrapper_default = import__.default;
@@ -9986,4 +9986,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-CHJOTJTZ.js.map
+//# sourceMappingURL=chunk-JHKW6IDX.js.map