@koda-sl/baker-cli 0.384.0 → 0.386.0-dev.4e118c09a

package/README.md

@@ -157,13 +157,13 @@ Use `--output` to change format:
 
 ### Ad Platforms (`baker ads`)
 
-Multi-platform ad commands. Google, Meta, and LinkedIn support both reads and **staged writes** (create/update campaigns, ad sets/ad groups, ads, creatives, audiences — applied on chat publish); X (Twitter) is read + analytics. TikTok is coming.
+Multi-platform ad commands. Google, Meta, and LinkedIn support both reads and **staged writes** (create/update campaigns, ad sets/ad groups, ads, creatives, audiences — applied on chat publish); X (Twitter) is read + analytics; ChatGPT Ads is read + analytics + staged writes. TikTok is coming.
 
 ---
 
 ### `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`) |
@@ -863,6 +863,39 @@ baker ads x targeting-constants --constant tv_shows --locale en-US
 
 ---
 
+### ChatGPT Ads (`baker ads chatgpt`)
+
+Read the company's ChatGPT Ads account (OpenAI's ads inside ChatGPT conversations) and how it performs, and stage changes to it that apply when the chat is published. The company connects one account in the dashboard (Brain → Integrations → ChatGPT Ads) with an API key from its Ads Manager; the key stays in Baker and never reaches the CLI, so there is no account id to pass.
+
+| Subcommand | What it returns |
+|---|---|
+| `account` | Name, currency, timezone, status, and the brand and account reviews that decide whether anything serves |
+| `campaigns` | Campaigns: objective, daily or lifetime budget (currency units), schedule, locations, platforms, serving issues |
+| `ad-groups` | Ad groups (`--campaign-id`): bid strategy, max bid, context hints, serving issues |
+| `ads` | Ads (`--ad-group-id`): the card's copy, image, destination, review outcome, serving issues |
+| `conversions` | Pixels (with the pixel id a landing page installs) and conversion events, with the campaigns using each |
+| `insights` | Impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, ROAS — per `--level account\|campaign\|ad_group\|ad`, over `--days N` or `--since/--until`, `--granularity`, `--segment country\|device\|platform\|product` |
+| `campaigns create\|update\|pause\|resume` | Stage a campaign change: objective, daily or lifetime budget (currency units), schedule, countries, platforms, status |
+| `ad-groups create\|update\|pause\|resume` | Stage an ad group change: context hints, bid strategy, max bid, status |
+| `ads create\|update\|pause\|resume` | Stage a chat card: title, body, landing page, image, status |
+| `account update` | Stage the advertiser's brand name or icon (`--favicon-url`) |
+| `draft` | Review the staged changes as a tree; `show`, `amend`, `remove`, `clear`. After a publish, what applied and what failed |
+
+`--full` on the list commands returns ChatGPT Ads' own objects. ChatGPT Ads refuses some metric and breakdown combinations (CPA, conversion rate and sales cannot be broken down; conversions come daily or as one total); `insights` refuses them first and says why.
+
+Writes need `BAKER_CHAT_ID`: they stage on the chat and reach ChatGPT Ads only when it is published. New entities are created paused unless `--status active`.
+
+```bash
+baker ads chatgpt account
+baker ads chatgpt insights --days 30 --granularity daily --level account
+baker ads chatgpt insights --campaign-id cmpn_123 --level ad --sort spend
+baker ads chatgpt campaigns create --name "Spring push" --objective clicks --daily-budget 20 --countries ES
+baker ads chatgpt ad-groups create --campaign-id chatgpt_temp_ab12 --name "Rooftop owners" --context-hints "solar panels for my house" --max-bid 2.50
+baker ads chatgpt draft
+```
+
+---
+
 ### Meta Ads (`baker ads meta`)
 
 Meta Marketing API (Facebook + Instagram). Connect via OAuth in the dashboard, pick which ad accounts to scope to, then call from the CLI. Account ID via `--account-id act_123` or `BAKER_META_AD_ACCOUNT_ID` env var.
@@ -892,7 +925,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 +963,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 +987,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 +1037,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 +1164,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 +1535,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
@@ -3751,6 +3789,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-FGHMWBUD.js → chunk-JHKW6IDX.js}

@@ -20,9 +20,9 @@ import {
   shouldEscalate
 } from "./chunk-HJEMOSPH.js";
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/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({
-  "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/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 ?? [];
 }
 
-// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/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-FGHMWBUD.js.map
+//# sourceMappingURL=chunk-JHKW6IDX.js.map