@koda-sl/baker-cli 0.386.0-dev.8b1f99042 → 0.387.0-dev.907d5a285

package/README.md

@@ -157,7 +157,7 @@ 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.
 
 ---
 
@@ -863,6 +863,41 @@ 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 conversions, 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, the conversions it measures (`--conversion-event-ids`) |
+| `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`) |
+| `conversions create` | Stage a conversion — a standard event (`lead_created`, `order_created`, …) or a custom one by name — counted from the account's pixel |
+| `conversions events` | What the pixel delivered in the last ~15 minutes — proof a site sends the event |
+| `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.
@@ -954,6 +989,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" \

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