@koda-sl/baker-cli 0.499.0 → 0.501.0-dev.6e96f50b9

package/README.md

@@ -1778,6 +1778,7 @@ baker analytics events --steps hero_view,pricing_view,demo_click   # an ordered
 baker analytics devices --grain viewport  # which widths the page has to survive
 baker analytics geo --grain postal_code --country ES
 baker analytics bots                      # which crawlers fetch the site
+baker analytics companies --targets targets.csv  # which target accounts visited (by their own network; consented visitors only)
 baker analytics presets                   # what each report answers
 baker analytics ads --platform google     # what Google's traffic carries, in Google's vocabulary
 baker analytics tracking                  # do the ad URLs carry the campaign, ad group and ad at all
@@ -2400,6 +2401,148 @@ A Reddit thread link is not sent to Firecrawl (which refuses Reddit): it is read
 
 ---
 
+### `baker research linkedin-person <profile url>`
+
+Read one person's public LinkedIn profile once, to write a 1:1 ad or account page from their own stated priorities. Nothing is stored or followed.
+
+```bash
+baker research linkedin-person https://www.linkedin.com/in/jane-doe
+baker research linkedin-person https://es.linkedin.com/in/jane-doe --full
+```
+
+**Response:**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "private": false,
+    "profile_url": "https://www.linkedin.com/in/jane-doe",
+    "name": "Jane Doe",
+    "location": "Madrid, Spain",
+    "about": "I help mid-market retailers move stock planning off spreadsheets.",
+    "current_role": { "organization": "Acme Logistics", "organization_url": "https://www.linkedin.com/company/acme-logistics", "location": "Madrid", "since": "2021-07", "description": null },
+    "recent_posts": [{ "text": "Stock-outs cost us more than overstock last year.", "date": "2026-10-16T21:17:59.571Z", "url": "https://www.linkedin.com/posts/...", "kind": "Post" }],
+    "articles": [{ "title": "Why we stopped forecasting by hand", "date": "2026-10-08T15:14:03.000+00:00", "url": "https://www.linkedin.com/pulse/..." }]
+  },
+  "hints": ["For ad and page messaging only; nothing is stored — quote their stated priorities into the creative brief ..."]
+}
+```
+
+| Flag     | Description                                                                 |
+|----------|-----------------------------------------------------------------------------|
+| `--full` | Also return the provider's whole answer as `raw`                            |
+
+- Any `linkedin.com/in/<name>` link works, country subdomains included; company pages are refused.
+- LinkedIn no longer shows headlines or job titles publicly, so `current_role` is the organisation (the first on the profile with no end date), never a title.
+- A profile LinkedIn hides returns `{ "private": true }` and is not charged. Cached 24 hours per profile.
+
+---
+
+### `baker research transcript <url>`
+
+The words of one long recording — a keynote, earnings call, webinar or podcast. A YouTube link is read from its captions; any other link must be the audio or video file itself (`.mp3`, `.mp4`, `.m4a`, …) and is transcribed. Nothing is added to the video library.
+
+```bash
+baker research transcript "https://www.youtube.com/watch?v=<id>"
+baker research transcript "https://www.youtube.com/watch?v=<id>" --out keynote.txt
+baker research transcript "https://traffic.megaphone.fm/<episode>.mp3" --full
+```
+
+**Response (default):**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "url": "https://www.youtube.com/watch?v=<id>",
+    "provider": "youtube",
+    "title": "Keynote 2026",
+    "duration_sec": 2712.4,
+    "language": "English",
+    "word_count": 7120,
+    "text_chars": 40211,
+    "truncated": false,
+    "excerpt": "Good morning everyone..."
+  },
+  "hints": ["This is the opening excerpt. Re-run with `--out <file>` ..."]
+}
+```
+
+| Flag           | Description                                                              |
+|----------------|--------------------------------------------------------------------------|
+| `--full`       | Return the whole text as `text` instead of the first 3,000 characters    |
+| `--out <file>` | Write the whole text to the file and return its path as `file`           |
+
+- `provider` is `youtube` (captions) or `deepgram` (the recording transcribed); `title` comes back for YouTube only.
+- A podcast's episode page is not a recording — pass its download link (the RSS `enclosure`). A page link is refused with that fix.
+- Cached 7 days per link, so `--full` or `--out` after a first look costs nothing more.
+
+---
+
+### `baker research company <domain>` / `--search`
+
+What one company is and whether it is hiring, to fill, score and message a target-account list — or, with `--search`, the companies whose main industry, size, revenue and HQ country match, to size a market and build the list. Firmographics and site technologies come from The Companies API, hiring from PredictLeads job openings.
+
+```bash
+baker research company --search --industry computer-software,software-development --size 50-200 --country es --count
+baker research company --search --industry computer-software,software-development --size 50-200 --revenue 1m-10m,10m-50m --country es --limit 25
+baker research company acme.es
+baker research company acme.es --no-hiring
+baker research company https://www.acme.es/about --full
+```
+
+**Response (lookup):**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "domain": "acme.es",
+    "name": "Acme Logística",
+    "industry": "logistics-and-supply-chain",
+    "employees": "200-500",
+    "employees_exact": 312,
+    "hq_country": "Spain",
+    "hq_country_code": "es",
+    "hq_city": "Madrid",
+    "revenue": "50m-100m",
+    "founded": 1998,
+    "linkedin_url": "https://www.linkedin.com/company/acme-logistica",
+    "description": "Acme moves pallets across Iberia.",
+    "technologies": ["hubspot", "google-tag-manager"],
+    "technologies_total": 2,
+    "hiring": { "status": "ok", "open_jobs": 42, "new_last_30_days": 9, "top_titles": ["Account Executive"], "top_functions": [{ "function": "sales", "jobs": 12 }] }
+  }
+}
+```
+
+**Response (`--search`):** `{ "total": 1840, "page": 1, "last_page": 74, "companies": [{ "name", "domain", "industry", "employees", "revenue", "country" }] }`; with `--count`, `{ "total": 112 }`.
+
+| Flag | Description |
+|---|---|
+| `--search` | List companies matching the filters instead of reading one |
+| `--count` | With `--search`: the number of matches alone — free. Size the market with it before paying for rows |
+| `--industry <a,b>` | Main-industry slugs, comma-separated, any matching (`computer-software,software-development`). Each is checked first, free: one that is no slug is refused with the closest slugs and how many companies each matches under your other filters |
+| `--size <a,b>` | Employee bands: `1-10`, `10-50`, `50-200`, `200-500`, `500-1k`, `1k-5k`, `5k-10k`, `over-10k` |
+| `--revenue <a,b>` | Revenue bands (USD): `under-1m`, `1m-10m`, `10m-50m`, `50m-100m`, `100m-200m`, `200m-1b`, `over-1b` |
+| `--country <a,b>` | HQ country codes (ISO 3166-1 alpha-2) |
+| `--limit <n>` | Companies per page, 1-100 (default 25); each returned is billed |
+| `--page <n>` | Page to read (default 1) |
+| `--no-hiring` | Lookup: skip hiring, which costs ~20× the profile — for filling a long list |
+| `--full` | Every industry and technology, plus both providers' answers as `raw` |
+
+- Search filters on the company's **main** industry; a search hint names related industries left out, with the companies each would add under your other filters, to widen on purpose.
+- A bad `--size`, `--revenue` or `--country` is a `VALIDATION_ERROR` naming the allowed values, before any call.
+- The domain is reduced to its registrable domain (`shop.acme.co.uk` → `acme.co.uk`), the way account matching keys companies.
+- A thin profile (two of LinkedIn page, HQ country and employee band missing, or `1-10` employees) comes back with a hint to check the domain is the company's main website — a namesake often sits on a neighbouring domain (`factorial.es` vs `factorialhr.com`).
+- `name` is the provider's spelling; prefer the name on the company's LinkedIn page or site when they differ.
+- `hiring.status` is `ok`, `not_tracked` (unknown — not "not hiring"), `skipped` (`--no-hiring`) or `unavailable` (not read; the firmographics still come back, with a hint).
+- Needs `THE_COMPANIES_API_KEY` on the backend; without it both modes answer `CONFLICT` "Company data isn't switched on for this workspace yet". Hiring needs `PREDICTLEADS_API_KEY` and `PREDICTLEADS_API_TOKEN`.
+- Profiles are cached 30 days, hiring and searches 7 days, per company.
+
+---
+
 ### `baker research reddit subreddits` / `search` / `thread`
 
 Read Reddit verbatim. Reddit refuses ordinary web reads, Firecrawl, and datacenter addresses, so these commands read it through a ladder of sources — Reddit's own API (when the backend holds `REDDIT_CLIENT_ID` / `REDDIT_CLIENT_SECRET`), the Arctic Shift public archive, then Reddit's public JSON through the proxy tiers — and report which one answered.
@@ -3614,6 +3757,14 @@ baker videos fetch https://www.youtube.com/watch?v=abc123 --out ./clips
 
 Baker's YouTube source sync runs this same command on a disposable machine, with `--max-height 1080`, because a YouTube file URL only works from the IP that requested it.
 
+### `baker videos download <id> --out <dir>`
+
+Save a library video as a local `.mp4` to edit it — a video found with `baker videos search`, or one the user attached in chat. The library keeps videos as a stream, so the first call may ask for a downloadable file and wait while it is prepared: it checks every 10 seconds for up to 20 minutes (`--timeout-seconds` changes the budget), then streams the file to disk. Returns `{ file, bytes }`. The file is named after the video; an existing file is never overwritten — a second copy gets a `-2` suffix. Still not ready at the deadline: `TIMEOUT` with a `fix` to retry later. A video that could not be processed: `CONFLICT`.
+
+```bash
+baker videos download j571abc123def --out /tmp/clips
+```
+
 ### `baker videos delete <id>`
 
 Delete a video by ID.
@@ -4690,13 +4841,14 @@ baker accounts company acme.com                        # or a LinkedIn company i
 baker accounts campaigns --last-months 6 --output md   # per campaign: reached, engaged, influenced pipeline (--basis revenue)
 baker accounts influenced --model awareness --threshold 10 --output csv   # another rule, this call only
 baker accounts warm --min 0                            # every New/Rising company, below the threshold too
+baker accounts engagement --targets targets.csv        # only the target accounts; targets: reached/engaged per tier, notReached
 baker accounts crm status                              # deals from HubSpot or sent by the client; what arrived, linked Google Sheets
 baker accounts crm sheet                               # create and link the deals sheet in the client's Google Drive
 baker accounts crm check --file deals.csv              # judge a deals or company CSV offline, nothing sent
 baker accounts crm contract                            # the send-your-CRM contract, as Markdown for a developer
 ```
 
-A deal is **influenced** when its company reached the company's influence rule — by default 3+ LinkedIn ad engagements (Awareness: 7+ impressions; Intent: 3+ clicks) — in the 12 months up to and including the month the deal was created (`--basis pipeline`, deals not won) or closed won (`--basis revenue`). It is a labelled rule, not credit: campaign rows overlap, and money is reported per currency, never summed across currencies. Deals whose company match is only a guess come back under `lowConfidence` and stay out of `summary` until the match is confirmed in Measure → Accounts. Without the deals set up there — HubSpot's pipelines and won/lost stages, or Another CRM — `influenced` and `campaigns` exit 1 with `ACCOUNTS_NOT_SET_UP`. A CRM Baker cannot read sends its companies and deals to `POST /v1/accounts/crm` (a `crm_ingest` key, `X-Baker-Mode: test` to rehearse, up to 500 records per request, records naming a person refused), is uploaded as a CSV in Measure → Accounts, or lives in a Google Sheet linked there that Baker reads every night (a row deleted from the sheet leaves Baker). A file is a deals export or a company list — a company needs only its website or LinkedIn page; `crm check` runs the same rules offline and `crm contract` prints the whole contract. The CLI never sends deals or links a sheet of the client's; `crm sheet` creates the empty deals sheet in their Google Drive and links it, applied at once (asking again returns the same sheet). `--model engagement|awareness|intent` and `--threshold N` on `influenced`, `campaigns` and `warm` read with another rule for that call only; the saved setting is unchanged. A **warm** account is New or Rising, reached the company's influence threshold this period on the rule's metric (`--min N` overrides, `--min 0` drops it), and has no open deal, no won deal and no deal lost in the last 6 months; `engagement` and `warm` rows carry `dealStatus` (`won` > `open` > `lost` > `none`), `engagement --output csv` adds `lastMonth` and `previousImpressions/Clicks/Engagements`, and `campaigns` / `company` carry each campaign's `campaignName` (null when LinkedIn could not name it). `company` returns `months` (the company's totals), `byCampaign` (the same numbers per campaign — overlapping, never add them) and its `deals` with `touchValue` and `influenced`. `warm --output csv` is the file `baker ads linkedin audiences create --type company-list --list-file` takes.
+A deal is **influenced** when its company reached the company's influence rule — by default 3+ LinkedIn ad engagements (Awareness: 7+ impressions; Intent: 3+ clicks) — in the 12 months up to and including the month the deal was created (`--basis pipeline`, deals not won) or closed won (`--basis revenue`). It is a labelled rule, not credit: campaign rows overlap, and money is reported per currency, never summed across currencies. Deals whose company match is only a guess come back under `lowConfidence` and stay out of `summary` until the match is confirmed in Measure → Accounts. Without the deals set up there — HubSpot's pipelines and won/lost stages, or Another CRM — `influenced` and `campaigns` exit 1 with `ACCOUNTS_NOT_SET_UP`. A CRM Baker cannot read sends its companies and deals to `POST /v1/accounts/crm` (a `crm_ingest` key, `X-Baker-Mode: test` to rehearse, up to 500 records per request, records naming a person refused), is uploaded as a CSV in Measure → Accounts, or lives in a Google Sheet linked there that Baker reads every night (a row deleted from the sheet leaves Baker). A file is a deals export or a company list — a company needs only its website or LinkedIn page; `crm check` runs the same rules offline and `crm contract` prints the whole contract. The CLI never sends deals or links a sheet of the client's; `crm sheet` creates the empty deals sheet in their Google Drive and links it, applied at once (asking again returns the same sheet). `--model engagement|awareness|intent` and `--threshold N` on `influenced`, `campaigns` and `warm` read with another rule for that call only; the saved setting is unchanged. A **warm** account is New or Rising, reached the company's influence threshold this period on the rule's metric (`--min N` overrides, `--min 0` drops it), and has no open deal, no won deal and no deal lost in the last 6 months; `engagement` and `warm` rows carry `dealStatus` (`won` > `open` > `lost` > `none`), `engagement --output csv` adds `lastMonth` and `previousImpressions/Clicks/Engagements`, and `campaigns` / `company` carry each campaign's `campaignName` (null when LinkedIn could not name it). `company` returns `months` (the company's totals), `byCampaign` (the same numbers per campaign — overlapping, never add them) and its `deals` with `touchValue` and `influenced`. `warm --output csv` is the file `baker ads linkedin audiences create --type company-list --list-file` takes. `--targets <file>` on `engagement`, `influenced`, `campaigns` and `warm` narrows the report to an ABM target list — a CSV with a domain or website column (name and tier optional) or a JSON array of domains or `{domain, name, tier}` — reduced to registrable domains; rows, totals and pages count the targets only, and the answer adds `targets` `{total, reached, engaged, notReached, byTier}`.
 
 ---
 

package/dist/account-MV3NLCM7.js

@@ -0,0 +1,80 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-SGU5L5JS.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/account.ts
+import { defineCommand } from "citty";
+var accountDetailCommand = defineCommand({
+  meta: {
+    name: "detail",
+    description: `Single LinkedIn ad account detail (currency, status, type).
+
+Examples:
+  baker ads linkedin account --account-id 503001492
+  baker ads linkedin account --account-urn urn:li:sponsoredAccount:503001492 --output md`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/account", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput([data], fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var accountCommand = defineCommand({
+  meta: {
+    name: "account",
+    description: `LinkedIn ad account: its detail, and the settings that apply across every ad set in it.
+
+Examples:
+  baker ads linkedin account --account-id 503001492                          \u2014 currency, status, type
+  baker ads linkedin account url-params --param utm_source=linkedin          \u2014 UTMs for every ad in the account`
+  },
+  subCommands: {
+    detail: accountDetailCommand,
+    "url-params": () => import("./write-commands-GQHYLHOF.js").then((m) => m.accountUrlParamsCommand)
+  },
+  args: accountDetailCommand.args,
+  default: "detail"
+});
+export {
+  accountCommand
+};
+//# sourceMappingURL=account-MV3NLCM7.js.map

package/dist/account-O6TGGIQI.js

@@ -0,0 +1,80 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-ZEKW4FKU.js";
+import "./chunk-ZRP7Y2DM.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/account.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.chatgpt.account",
+  description: "The connected ChatGPT Ads account: name, currency, timezone, status, and the brand and account reviews that decide whether anything in it can serve.",
+  args: {
+    full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
+  }
+});
+function accountHints(account) {
+  const hints = [];
+  if (account.brandReview.status !== "approved") {
+    const reason = account.brandReview.reason ? ` (${account.brandReview.reason})` : "";
+    hints.push(
+      `Brand review is ${account.brandReview.status}${reason}: nothing in this account serves until it is approved. Fix it in ChatGPT Ads Manager before changing campaigns.`
+    );
+  }
+  if (account.accountReview && account.accountReview.status !== "approved") {
+    hints.push(`A separate account review is ${account.accountReview.status}; delivery can wait on it too.`);
+  }
+  if (account.status === "paused") {
+    hints.push("The whole account is paused, so no campaign in it serves whatever its own status says.");
+  }
+  return hints;
+}
+var SHOW_ARGS = {
+  full: { type: "boolean", description: "Return ChatGPT Ads' own account object", required: false }
+};
+var accountShowCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "The connected ChatGPT Ads account. Example: baker ads chatgpt account"
+  },
+  args: SHOW_ARGS,
+  run: async ({ args }) => {
+    await runChatgptRead(
+      CHATGPT_ADS_REFERENCE.account,
+      () => apiGet("/api/ads/chatgpt/account", args.full ? { full: "true" } : void 0),
+      (account) => args.full ? [] : accountHints(account)
+    );
+  }
+});
+var accountCommand = defineCommand({
+  meta: {
+    name: "account",
+    description: `The connected ChatGPT Ads account. Start here: currency and timezone for every figure, and whether reviews let anything serve.
+
+Examples:
+  baker ads chatgpt account
+  baker ads chatgpt account --full
+  baker ads chatgpt account update --favicon-url https://example.com/icon.png   \u2014 staged; applies on publish`
+  },
+  subCommands: {
+    show: accountShowCommand,
+    update: () => import("./account-writes-O3VEGYR3.js").then((m) => m.accountUpdateCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: SHOW_ARGS,
+  default: "show"
+});
+export {
+  accountCommand,
+  accountHints
+};
+//# sourceMappingURL=account-O6TGGIQI.js.map

package/dist/account-reads-NUF5PNDN.js

@@ -0,0 +1,219 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-HGUYC5K6.js";
+import {
+  failWriteValidation,
+  listFlag,
+  requireCustomerId
+} from "./chunk-3VA52AHF.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-KJZPCLQE.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-Y2JZX6JB.js";
+import "./chunk-43PAN3L2.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/account-reads.ts
+import { defineCommand } from "citty";
+function register(command, description, args) {
+  registerSchema({
+    command,
+    description,
+    args: Object.fromEntries(
+      Object.entries(args).map(([name, arg]) => [
+        name,
+        { type: arg.type, description: arg.description, required: false }
+      ])
+    )
+  });
+}
+async function serviceRead(path, customerId, body) {
+  const managerId = getManagerIdForCustomer(customerId);
+  const { data } = await apiPost(path, {
+    customerId,
+    ...managerId ? { managerId } : {},
+    ...body
+  });
+  return data;
+}
+var CUSTOMER_ARG = {
+  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" }
+};
+var INVOICE_ARGS = {
+  ...CUSTOMER_ARG,
+  month: { type: "string", description: "Issue month, YYYY-MM (default: last month)" }
+};
+register(
+  "ads.google.invoices",
+  "List the invoices Google issued in one month (accounts on monthly invoicing only): id, dates, service period, subtotal/tax/total in micros, PDF link. Start here: `baker ads google invoices --customer-id 1234567890 --month 2026-09`. An account that pays automatically has no invoices \u2014 the error's fix says where its receipts are; carry on.",
+  INVOICE_ARGS
+);
+var invoicesCommand = defineCommand({
+  meta: {
+    name: "invoices",
+    description: `List one month's invoices (monthly-invoicing accounts only). Read-only.
+
+Example:
+  baker ads google invoices --customer-id 1234567890 --month 2026-09`
+  },
+  args: INVOICE_ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    try {
+      const data = await serviceRead("/api/ads/google/invoices", customerId, {
+        ...args.month ? { month: args.month } : {}
+      });
+      const hints = data.invoices.length === 0 ? [`No invoice was issued in ${data.month}. Try the month before with --month.`] : [
+        "Amounts are micros in each invoice's currency_code (divide by 1,000,000). pdf_url needs the user's Google sign-in."
+      ];
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+register(
+  "ads.google.identity-verification",
+  "Advertiser identity verification status: each program's status (PENDING_USER_ACTION, PENDING_REVIEW, SUCCESS, FAILURE), deadlines and the link where the user completes it. Start here: `baker ads google identity-verification --customer-id 1234567890`. Google only answers for accounts on monthly invoicing \u2014 otherwise the error's fix says where the user reads it; carry on.",
+  CUSTOMER_ARG
+);
+var identityVerificationCommand = defineCommand({
+  meta: {
+    name: "identity-verification",
+    description: `Advertiser identity verification status and deadlines. Read-only.
+
+Example:
+  baker ads google identity-verification --customer-id 1234567890`
+  },
+  args: CUSTOMER_ARG,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    try {
+      const data = await serviceRead(
+        "/api/ads/google/identity-verification",
+        customerId,
+        {}
+      );
+      const pending = data.programs.filter((program) => program.status === "PENDING_USER_ACTION");
+      const hints = pending.length > 0 ? [
+        `Verification is waiting on the advertiser${pending[0]?.completion_deadline ? ` (deadline ${pending[0].completion_deadline})` : ""}: give the user the action_url \u2014 ads stop serving if it lapses.`
+      ] : [];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+var PREVIEW_ARGS = {
+  ...CUSTOMER_ARG,
+  ads: {
+    type: "string",
+    description: "Comma-separated video ads of Video campaigns as {adGroupId}~{adId} (from `ads list`) \u2014 previewed live on YouTube"
+  },
+  "asset-groups": {
+    type: "string",
+    description: "Comma-separated Performance Max asset group ids (from `asset-groups list`) \u2014 previewed on Google's preview page"
+  }
+};
+register(
+  "ads.google.previews",
+  "Shareable preview links for Performance Max asset groups (Google's preview page) and video ads (live on YouTube) that already exist in the account \u2014 a link the user can open or forward. Start here: `baker ads google previews --customer-id 1234567890 --asset-groups 6743268912`. Returns { previews: [{ target, url, youtube_tv_url, expires_at }] }. Only video ads of Video campaigns can be previewed by ad (search, display and Demand Gen ads have no shareable preview); staged (unpublished) changes cannot be previewed.",
+  PREVIEW_ARGS
+);
+var previewsCommand = defineCommand({
+  meta: {
+    name: "previews",
+    description: `Shareable preview links for existing Performance Max asset groups and video ads. Read-only.
+
+Examples:
+  baker ads google previews --customer-id 1234567890 --asset-groups 6743268912
+  baker ads google previews --customer-id 1234567890 --ads 195752489650~826812181091   # a video ad, live on YouTube`
+  },
+  args: PREVIEW_ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    const ads = listFlag(args.ads);
+    const assetGroups = listFlag(args["asset-groups"]);
+    if (!ads?.length && !assetGroups?.length) failWriteValidation("pass --ads and/or --asset-groups");
+    try {
+      const data = await serviceRead("/api/ads/google/previews", customerId, {
+        ...ads ? { ads } : {},
+        ...assetGroups ? { assetGroups } : {}
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data,
+        hints: [
+          "Each link expires (expires_at). It shows what is live in the account now, not anything staged in this chat."
+        ]
+      });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+var BRAND_ARGS = {
+  ...CUSTOMER_ARG,
+  prefix: { type: "string", description: "The start of the brand's name (at least 2 letters)" }
+};
+register(
+  "ads.google.brands",
+  "Find a brand's Google entity id \u2014 what a BRANDS list member names (`keyword-lists add --brand /g/\u2026`). Start here: `baker ads google brands --customer-id 1234567890 --prefix nike`. Several brands can share a name: pick by the URL. Read-only.",
+  BRAND_ARGS
+);
+var brandsCommand = defineCommand({
+  meta: {
+    name: "brands",
+    description: `Find brand entity ids for a brand list (BRANDS). Read-only.
+
+Example:
+  baker ads google brands --customer-id 1234567890 --prefix nike`
+  },
+  args: BRAND_ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    if (typeof args.prefix !== "string" || args.prefix.trim().length < 2) {
+      failWriteValidation("--prefix needs at least the first 2 letters of the brand");
+    }
+    try {
+      const data = await serviceRead("/api/ads/google/brands", customerId, {
+        prefix: args.prefix
+      });
+      const hints = data.brands.length > 0 ? [
+        "Several brands can share a name \u2014 pick the one whose URL is the brand you mean, then `keyword-lists add --list-ref <BRANDS list> --brand <entity_id>`."
+      ] : ["No brand starts with that \u2014 try a shorter or different prefix."];
+      writeJsonEnvelope({ ok: true, data, hints });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+export {
+  brandsCommand,
+  identityVerificationCommand,
+  invoicesCommand,
+  previewsCommand
+};
+//# sourceMappingURL=account-reads-NUF5PNDN.js.map

package/dist/account-users-6VMTSBPB.js

@@ -0,0 +1,62 @@
+import {
+  bareAccountId
+} from "./chunk-QATA3YJM.js";
+import {
+  handleLinkedinError
+} from "./chunk-SGU5L5JS.js";
+import "./chunk-KJZPCLQE.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/account-users.ts
+import { defineCommand } from "citty";
+var accountUsersCommand = defineCommand({
+  meta: {
+    name: "account-users",
+    description: `Who works on the ad account and their Campaign Manager role (Billing admin, Account manager, Campaign manager, Creative manager, Viewer); \`connectedLinkedin: true\` marks the person whose connection Baker publishes with.
+Start here when: a conversation or message ad needs a sender (\`creatives create --format conversation --sender <person>\` \u2014 the default is the connected person), or a publish was refused for want of a role (a Viewer or Creative manager can't change campaigns).
+LinkedIn only gives this app each person's id, not their name.
+Example: baker ads linkedin account-users --account-id 513852526`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" }
+  },
+  run: async ({ args }) => {
+    try {
+      const data = await apiGet("/api/ads/linkedin/account-users", {
+        "account-id": bareAccountId(args)
+      });
+      writeJsonEnvelope({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  accountUsersCommand
+};
+//# sourceMappingURL=account-users-6VMTSBPB.js.map