@koda-sl/baker-cli 0.551.0 → 0.554.0

package/dist/chunk-NIGDG522.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/meta/write-shared.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { type MetaDraftStageResponse, metaDraftOpInputSchema } from \"@baker/api/ads-meta\";\nimport { apiPost } from \"../../../client.ts\";\nimport { requireChatId } from \"../../../env.ts\";\nimport { repeatedValues } from \"../../../lib/repeatedFlags.ts\";\nimport { capabilityFix } from \"../../capabilities/fix.ts\";\nimport { booleanWordPositionalError } from \"../boolean-word-positional.ts\";\nimport { adCopyHints } from \"../copy-hints.ts\";\nimport { withHints } from \"../hints.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\n/**\n * Shared plumbing for the staged Meta write commands. Writes NEVER hit Meta\n * directly: every command stages an op against this chat's draft\n * (`/api/ads/meta/draft/stage`), the dashboard shows it as a pending Meta\n * change, and it applies when the chat is published.\n */\n\n/** Backend account ids are bare numeric — strip the `act_` prefix resolveAccountIdArg adds. */\nexport async function bareAccountId(args: Record<string, unknown>): Promise<string> {\n  return (await resolveAccountIdArg(args)).replace(/^act_/, \"\");\n}\n\nexport function failWriteValidation(message: string): never {\n  writeJsonEnvelope({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\n/** Deleting is permanent, so it only stages through `delete`, whose description carries that warning. */\nexport function refuseDeleteByUpdate(payload: Record<string, unknown>, group: \"campaigns\" | \"adsets\" | \"ads\"): void {\n  if (payload.status === \"DELETED\") {\n    failWriteValidation(\n      `update does not delete — deleting is permanent. Use \\`baker ads meta ${group} delete <id>\\` if the user asked to delete; otherwise pause or archive.`,\n    );\n  }\n}\n\n/**\n * `--file`: a JSON file path, or the JSON itself when it starts with `{` — the shape Google's\n * `--file` already takes and the one an agent writes first for a short payload (a customer list of\n * a few people).\n */\nexport function loadJsonFileArg(path: unknown): Record<string, unknown> {\n  if (typeof path !== \"string\" || path.length === 0) {\n    return {};\n  }\n  const inline = /^\\s*\\{/.test(path);\n  const source = inline ? \"inline JSON\" : path;\n  try {\n    const parsed = JSON.parse(inline ? path : readFileSync(path, \"utf8\")) as unknown;\n    if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      failWriteValidation(`${source} must contain a JSON object`);\n    }\n    return parsed as Record<string, unknown>;\n  } catch (err) {\n    if (err instanceof SyntaxError) {\n      failWriteValidation(`${source} is not valid JSON: ${err.message}`);\n    }\n    throw err;\n  }\n}\n\n/** Flags override file keys — the file is the base, flags are the overrides. */\nexport function mergePayload(file: Record<string, unknown>, flags: Record<string, unknown>): Record<string, unknown> {\n  const merged: Record<string, unknown> = { ...file };\n  for (const [key, value] of Object.entries(flags)) {\n    if (value !== undefined) {\n      merged[key] = value;\n    }\n  }\n  return merged;\n}\n\nexport function parseMoneyFlag(\n  amount: unknown,\n  currency: unknown,\n  flag: string,\n): { amount: string; currencyCode?: string } | undefined {\n  if (amount === undefined || amount === null || amount === \"\") {\n    return undefined;\n  }\n  if (currency === undefined || currency === null || currency === \"\") {\n    // Meta ad accounts are single-currency — the backend fills it in.\n    return { amount: String(amount) };\n  }\n  if (typeof currency !== \"string\" || currency.length !== 3) {\n    failWriteValidation(`${flag} got an invalid --currency (expected a 3-letter code like USD)`);\n  }\n  return { amount: String(amount), currencyCode: currency.toUpperCase() };\n}\n\n/** Accepts ISO dates (2026-07-10), ISO datetimes, or epoch millis. */\nexport function parseDateFlag(value: unknown, flag: string): number | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const raw = String(value);\n  if (/^\\d{10,}$/.test(raw)) {\n    return Number(raw);\n  }\n  const parsed = Date.parse(raw);\n  if (Number.isNaN(parsed)) {\n    failWriteValidation(`${flag} must be an ISO date (2026-07-10) or epoch milliseconds`);\n  }\n  return parsed;\n}\n\n/** Split a comma-separated flag into a trimmed, non-empty array. */\nexport function listFlag(value: unknown): string[] | undefined {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    return undefined;\n  }\n  const items = value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\n/**\n * A list flag that may be repeated as well as comma-separated\n * (`--countries ES,FR --countries DE`). citty keeps only a repeated flag's last\n * value, so the values are read from the command line (`repeatedValues`).\n */\nexport function repeatedListFlag(\n  rawArgs: readonly string[] | undefined,\n  flag: string,\n  parsed: unknown,\n): string[] | undefined {\n  const items = repeatedValues(rawArgs, flag, parsed)\n    .flatMap((value) => value.split(\",\"))\n    .map((item) => item.trim())\n    .filter(Boolean);\n  return items.length > 0 ? items : undefined;\n}\n\nexport function upper(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value.toUpperCase() : undefined;\n}\n\nexport function numberFlag(value: unknown, flag: string): number | undefined {\n  if (value === undefined || value === null || value === \"\") {\n    return undefined;\n  }\n  const n = Number(value);\n  if (!Number.isFinite(n)) {\n    failWriteValidation(`${flag} must be a number`);\n  }\n  return n;\n}\n\n/**\n * Accepts whichever positional the command declared (`id`, `target`, `ref`) or the raw positional.\n *\n * `--flag false` is refused first: citty turns it into the flag set to TRUE plus a stray positional,\n * so on `campaigns duplicate 6123 --replace false` the copy stages AND the live original is staged\n * for pause — the opposite of what was typed, with an \"ok\" receipt. This is the only place on this\n * surface that reads positionals, and every target-taking command goes through it.\n */\nexport function requireTarget(args: Record<string, unknown>, entity: string): string {\n  const inverted = booleanWordPositionalError(args, entity);\n  if (inverted !== undefined) {\n    failWriteValidation(inverted);\n  }\n  const positional = Array.isArray(args._) ? args._[0] : undefined;\n  const target = args.id ?? args.target ?? args.ref ?? positional;\n  if (typeof target !== \"string\" || target.length === 0) {\n    failWriteValidation(`pass the ${entity} id as the positional argument`);\n  }\n  return target;\n}\n\ninterface StageEnvelope extends Record<string, unknown> {\n  ok: true;\n  data: MetaDraftStageResponse;\n}\n\n/**\n * Preflight-validates the op against the shared `@baker/api/ads-meta` contract\n * (same schema the backend enforces), then stages it. Prints the staged\n * envelope — ref, mode (always `live`: publishing reaches the real ad account),\n * summary, warnings.\n */\n/** The op parsed against the shared contract, or the validation envelope printed and the process ended. */\nfunction preflightOp(raw: Record<string, unknown>) {\n  const preflight = metaDraftOpInputSchema.safeParse(raw);\n  if (!preflight.success) {\n    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join(\".\"), message: issue.message }));\n    writeJsonEnvelope({\n      ok: false,\n      error: {\n        code: \"VALIDATION_ERROR\",\n        message: fields.map((field) => (field.path ? `${field.path}: ${field.message}` : field.message)).join(\"; \"),\n        fields,\n        fix: capabilityFix(\"meta-ads\"),\n      },\n    });\n    process.exit(1);\n  }\n  return preflight.data;\n}\n\nexport async function stageOp(raw: Record<string, unknown>, extraHints: readonly string[] = []): Promise<void> {\n  const op = preflightOp(raw);\n  try {\n    const chatId = requireChatId();\n    const response = await apiPost<StageEnvelope>(\"/api/ads/meta/draft/stage\", { chatId, op });\n    const copyHints = await adCopyHints(op);\n    writeJsonEnvelope(withHints(response, [...copyHints, ...extraHints]));\n  } catch (err) {\n    handleMetaError(err);\n  }\n}\n\n/**\n * Stage several ops as one command and print one envelope: each staged op's\n * receipt, in order. Stops at the first refusal, which names the op it was —\n * the ones before it stay staged, and the envelope says which.\n */\nexport async function stageOps(raws: readonly Record<string, unknown>[]): Promise<void> {\n  const ops = raws.map(preflightOp);\n  const chatId = requireChatId();\n  const staged: MetaDraftStageResponse[] = [];\n  for (const op of ops) {\n    try {\n      const response = await apiPost<StageEnvelope>(\"/api/ads/meta/draft/stage\", { chatId, op });\n      staged.push(response.data);\n    } catch (err) {\n      if (staged.length > 0) {\n        process.stderr.write(`staged before the refusal: ${staged.map((entry) => entry.ref).join(\", \")}\\n`);\n      }\n      handleMetaError(err);\n    }\n  }\n  writeJsonEnvelope({ ok: true, data: staged });\n}\n\nexport async function stageStatusChange(input: {\n  kind: \"campaign.update\" | \"adSet.update\" | \"adCreative.update\" | \"ad.update\" | \"customAudience.update\";\n  accountId: string;\n  target: string;\n  status: \"ACTIVE\" | \"PAUSED\" | \"ARCHIVED\" | \"DELETED\";\n}): Promise<void> {\n  await stageOp({\n    kind: input.kind,\n    accountId: input.accountId,\n    target: input.target,\n    payload: { status: input.status },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-NPJRACA2.js

@@ -1,35 +0,0 @@
-import {
-  ApiError
-} from "./chunk-B2OHCWYB.js";
-import {
-  writeJson
-} from "./chunk-WCIS4FZH.js";
-
-// src/commands/winning-ads/shared.ts
-function splitList(value) {
-  if (!value) {
-    return [];
-  }
-  return value.split(",").map((v) => v.trim()).filter(Boolean);
-}
-function reportError(err) {
-  if (err instanceof ApiError) {
-    writeJson({ ok: false, error: { code: err.code, message: err.message } });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-var PLATFORM_NAMES = {
-  meta: "Meta",
-  linkedin: "LinkedIn",
-  tiktok: "TikTok",
-  google: "Google Ads"
-};
-
-export {
-  splitList,
-  reportError,
-  PLATFORM_NAMES
-};
-//# sourceMappingURL=chunk-NPJRACA2.js.map

package/dist/chunk-NSBNIPIW.js

@@ -1,225 +0,0 @@
-// ../api/src/capabilities/surfaces.ts
-var CAPABILITY_SURFACES = [
-  "google-ads",
-  "meta-ads",
-  "linkedin-ads",
-  "x-ads",
-  "chatgpt-ads",
-  "tag-manager",
-  "ga4",
-  "gsc",
-  "shopify"
-];
-var CAPABILITY_SURFACE_SPECS = {
-  "google-ads": {
-    id: "google-ads",
-    label: "Google Ads",
-    provider: "google-ads",
-    resourceNoun: "ad account",
-    writePath: "staged-live",
-    writeScopes: ["https://www.googleapis.com/auth/adwords"],
-    commands: "baker ads google"
-  },
-  "meta-ads": {
-    id: "meta-ads",
-    label: "Meta Ads",
-    provider: "meta",
-    resourceNoun: "ad account",
-    writePath: "staged-live",
-    writeScopes: ["ads_management"],
-    commands: "baker ads meta"
-  },
-  "linkedin-ads": {
-    id: "linkedin-ads",
-    label: "LinkedIn Ads",
-    provider: "linkedin",
-    resourceNoun: "ad account",
-    writePath: "staged-live",
-    writeScopes: ["rw_ads"],
-    commands: "baker ads linkedin"
-  },
-  "x-ads": {
-    id: "x-ads",
-    label: "X Ads",
-    provider: "x-ads",
-    resourceNoun: "ad account",
-    writePath: "staged-live",
-    /**
-     * Empty on purpose, and the one surface where that does NOT mean read-only.
-     * X Ads authenticates with OAuth 1.0a, which has no scope strings at all —
-     * write access is granted to the *app* by X's Ads API access review, not
-     * per connection. There is therefore no scope to check, and inventing one
-     * would make `scopeBlockers` refuse every X write for a permission that
-     * does not exist.
-     */
-    writeScopes: [],
-    commands: "baker ads x"
-  },
-  "chatgpt-ads": {
-    id: "chatgpt-ads",
-    label: "ChatGPT Ads",
-    // Connected with the client's own Ads API key (`chatgptAdsConnections`), not an OAuth grant.
-    provider: "chatgpt-ads",
-    resourceNoun: "ad account",
-    writePath: "staged-live",
-    /**
-     * Empty because the pasted key has no scopes: it reaches its one account
-     * whole. When OpenAI approves Baker's OAuth app this becomes
-     * `ads.admin.all.write` and `connectsWith` goes away.
-     */
-    writeScopes: [],
-    commands: "baker ads chatgpt",
-    connectsWith: "api-key"
-  },
-  "tag-manager": {
-    id: "tag-manager",
-    label: "Tag Manager",
-    provider: "google-tag-manager",
-    resourceNoun: "container",
-    writePath: "staged-immediate",
-    writeScopes: [
-      "https://www.googleapis.com/auth/tagmanager.edit.containers",
-      "https://www.googleapis.com/auth/tagmanager.edit.containerversions",
-      "https://www.googleapis.com/auth/tagmanager.publish"
-    ],
-    commands: "baker tag-manager"
-  },
-  ga4: {
-    id: "ga4",
-    label: "Google Analytics 4",
-    provider: "google-analytics",
-    resourceNoun: "property",
-    // Like Tag Manager: staged during the chat, applied for real at publish,
-    // every time. A connection made before writes existed is
-    // read-only until it is reconnected, and `access` does NOT say so — it
-    // reports what the Baker app asks Google for, which is now app-wide
-    // read-write. The per-company signal is `scopeBlockers`, which compares
-    // `writeScopes` against the scopes that connection actually recorded.
-    writePath: "staged-immediate",
-    writeScopes: ["https://www.googleapis.com/auth/analytics.edit"],
-    commands: "baker ga4"
-  },
-  gsc: {
-    id: "gsc",
-    label: "Search Console",
-    provider: "google-search-console",
-    resourceNoun: "site",
-    writePath: "read-only",
-    writeScopes: ["https://www.googleapis.com/auth/webmasters"],
-    commands: "baker gsc"
-  },
-  shopify: {
-    id: "shopify",
-    label: "Shopify store",
-    provider: "shopify",
-    resourceNoun: "store",
-    // Staged during the chat and applied to the real store when it completes,
-    // every time; each applied change can be put back by another publish
-    // (`baker shopify undo`). The write permissions are optional scopes the
-    // store grants when a change first needs one, so `scopeBlockers` is the
-    // per-company signal.
-    writePath: "staged-immediate",
-    writeScopes: [
-      "write_products",
-      "write_publications",
-      "write_discounts",
-      "write_online_store_navigation",
-      "write_marketing_events"
-    ],
-    commands: "baker shopify"
-  }
-};
-
-// ../api/src/capabilities/index.ts
-import { z } from "zod";
-var capabilitySurfaceSchema = z.enum(CAPABILITY_SURFACES);
-var capabilitiesRequestSchema = z.object({
-  /** Narrow to one surface. Omit for every surface the company could use. */
-  surface: capabilitySurfaceSchema.optional(),
-  /** Include the field-level contract of every op, not just the entity list. */
-  full: z.boolean().optional(),
-  /**
-   * Who the chat acts as (`BAKER_ACTING_USER_ID`). Adds that person's own
-   * connected tools — they load for this turn, and for nobody else's.
-   */
-  actingUserId: z.string().optional()
-});
-var capabilityResourceSchema = z.object({
-  id: z.string(),
-  name: z.string().optional()
-});
-var capabilityOpSchema = z.object({
-  kind: z.string(),
-  /** True when the op changes something that already exists and must be named. */
-  needsTarget: z.boolean(),
-  required: z.array(z.string()),
-  optional: z.array(z.string()),
-  /** Field → the values it accepts, for fields that take a fixed set. */
-  choices: z.record(z.string(), z.array(z.string())),
-  /** False when the platform accepts fields beyond the listed ones. */
-  fieldsAreComplete: z.boolean()
-});
-var capabilityLimitViewSchema = z.object({
-  capability: z.string(),
-  cause: z.enum(["not_built", "provider_forbids", "no_permission"]),
-  detail: z.string()
-});
-var capabilityWriteModeSchema = z.enum(["live", "applies-at-publish", "none"]);
-var capabilitySurfaceReportSchema = z.object({
-  surface: capabilitySurfaceSchema,
-  label: z.string(),
-  connected: z.boolean(),
-  /** What the user picked when connecting. Empty when nothing is selected yet. */
-  resources: z.array(capabilityResourceSchema),
-  access: z.enum(["read-write", "read-only", "not-connected"]),
-  writeMode: capabilityWriteModeSchema,
-  /** One sentence about the write mode, safe to repeat to the user. */
-  writeModeNote: z.string(),
-  /** Entities this surface can change at all, e.g. "campaign", "keyword". */
-  writableEntities: z.array(z.string()),
-  /** Things wrong with the connection itself: needs reconnecting, missing a permission. */
-  blockers: z.array(z.string()),
-  /** What cannot be done here, and why. */
-  limits: z.array(capabilityLimitViewSchema),
-  /** The per-op contract. Present when one surface was asked for, or with `full`. */
-  ops: z.array(capabilityOpSchema).optional(),
-  /** Where to look next: `baker ads google`, `baker ga4`, … */
-  commands: z.string()
-});
-var capabilityToolSchema = z.object({
-  /** `microsoft_clarity`, `hubspot`, or the name the user gave a custom server. */
-  key: z.string(),
-  label: z.string(),
-  /** `mcp` — tools in the agent's own list. `platform` — signed in, read through the CLI. */
-  kind: z.enum(["mcp", "platform"]),
-  /** How to actually reach it, in one phrase the agent can act on. */
-  reach: z.string(),
-  /**
-   * Whether it can be used right now.
-   *
-   * A connection that exists and is expired is worse than one that is absent:
-   * it reads as available and fails at the moment it is needed, which on an
-   * unattended run is a report with a hole in it and no explanation.
-   */
-  ready: z.boolean(),
-  /** Why it is not ready, or what it is for. Absent when neither needs saying. */
-  note: z.string().optional()
-});
-var capabilitiesResponseSchema = z.object({
-  ok: z.literal(true),
-  data: z.object({
-    surfaces: z.array(capabilitySurfaceReportSchema),
-    /**
-     * Everything else this company can reach. Shared connections only —
-     * a teammate's private per-user connection belongs to whoever started the
-     * session and is visible in the agent's own tool list, not here.
-     */
-    tools: z.array(capabilityToolSchema)
-  })
-});
-
-export {
-  CAPABILITY_SURFACES,
-  CAPABILITY_SURFACE_SPECS
-};
-//# sourceMappingURL=chunk-NSBNIPIW.js.map

package/dist/chunk-NSBNIPIW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../api/src/capabilities/surfaces.ts","../../api/src/capabilities/index.ts"],"sourcesContent":["/**\n * The marketing surfaces Baker can reach, and — the part that exists nowhere\n * else — what it cannot do on each of them.\n *\n * Every other introspection surface (`baker schema <cmd>`, the family docs)\n * describes what the agent CAN do. An agent that needs to know a capability is\n * absent has, until now, only been able to find out by trying: promising a GA4\n * property merge and then discovering the connection is read-only, or probing\n * four spellings of a conversion-action field that does not exist. Both cost a\n * retraction in front of a client.\n *\n * This module is deliberately thin on prose and heavy on `evidence`. A\n * hand-maintained \"cannot do\" list rots the same way the Tag Manager built-in\n * trigger whitelist in this repo rotted down to one entry, so each limit carries\n * a machine-checkable claim about the code that makes it true, and\n * `packages/backend/convex/capabilities/coverage.test.ts` fails when a claim\n * stops holding — when the scope is finally requested, when the op ships, when\n * the guard is renamed away. `asserted` is the escape hatch for the handful of\n * facts that live outside this repo entirely, and it has to say why.\n */\n\nexport const CAPABILITY_SURFACES = [\n  \"google-ads\",\n  \"meta-ads\",\n  \"linkedin-ads\",\n  \"x-ads\",\n  \"chatgpt-ads\",\n  \"tag-manager\",\n  \"ga4\",\n  \"gsc\",\n  \"shopify\",\n] as const;\nexport type CapabilitySurfaceId = (typeof CAPABILITY_SURFACES)[number];\n\n/**\n * How a change on this surface reaches the outside world.\n *  - `staged-live`       — staged during the chat and applied against the real\n *                          ad account at publish. The per-company write flags\n *                          that could once make this simulated are retired, so\n *                          a completed chat spends the client's money.\n *  - `staged-immediate`  — staged during the chat and applied at publish for\n *                          real, every time. Tag Manager: completing the chat\n *                          changes the user's production container.\n *  - `read-only`         — nothing here writes.\n *\n * The first two split on consequence, not on certainty: both always apply, but\n * one costs ad spend and the other cuts a container version, and the agent has\n * to tell the user which.\n */\nexport type CapabilityWritePath = \"staged-live\" | \"staged-immediate\" | \"read-only\";\n\nexport interface CapabilitySurfaceSpec {\n  id: CapabilitySurfaceId;\n  /** How the user names it. */\n  label: string;\n  /** The `oauthProviders.type` this surface connects through; `chatgpt-ads` connects with a pasted key instead. */\n  provider: string;\n  /** What the user picks when connecting: \"ad account\", \"property\", \"container\". */\n  resourceNoun: string;\n  writePath: CapabilityWritePath;\n  /**\n   * OAuth scopes that would grant writes. Access is derived by intersecting these\n   * with the scopes the app actually requests — which is why \"GA4 is read-only\"\n   * is a fact about the connection, not a sentence someone typed.\n   */\n  writeScopes: string[];\n  /** Where to look next on this surface. */\n  commands: string;\n  /**\n   * How the company connects. Absent is an OAuth grant, whose scopes decide\n   * access. `api-key` is a pasted key that reaches one account whole, so the\n   * write path alone decides it.\n   */\n  connectsWith?: \"api-key\";\n}\n\nexport const CAPABILITY_SURFACE_SPECS: Readonly<Record<CapabilitySurfaceId, CapabilitySurfaceSpec>> = {\n  \"google-ads\": {\n    id: \"google-ads\",\n    label: \"Google Ads\",\n    provider: \"google-ads\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    writeScopes: [\"https://www.googleapis.com/auth/adwords\"],\n    commands: \"baker ads google\",\n  },\n  \"meta-ads\": {\n    id: \"meta-ads\",\n    label: \"Meta Ads\",\n    provider: \"meta\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    writeScopes: [\"ads_management\"],\n    commands: \"baker ads meta\",\n  },\n  \"linkedin-ads\": {\n    id: \"linkedin-ads\",\n    label: \"LinkedIn Ads\",\n    provider: \"linkedin\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    writeScopes: [\"rw_ads\"],\n    commands: \"baker ads linkedin\",\n  },\n  \"x-ads\": {\n    id: \"x-ads\",\n    label: \"X Ads\",\n    provider: \"x-ads\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    /**\n     * Empty on purpose, and the one surface where that does NOT mean read-only.\n     * X Ads authenticates with OAuth 1.0a, which has no scope strings at all —\n     * write access is granted to the *app* by X's Ads API access review, not\n     * per connection. There is therefore no scope to check, and inventing one\n     * would make `scopeBlockers` refuse every X write for a permission that\n     * does not exist.\n     */\n    writeScopes: [],\n    commands: \"baker ads x\",\n  },\n  \"chatgpt-ads\": {\n    id: \"chatgpt-ads\",\n    label: \"ChatGPT Ads\",\n    // Connected with the client's own Ads API key (`chatgptAdsConnections`), not an OAuth grant.\n    provider: \"chatgpt-ads\",\n    resourceNoun: \"ad account\",\n    writePath: \"staged-live\",\n    /**\n     * Empty because the pasted key has no scopes: it reaches its one account\n     * whole. When OpenAI approves Baker's OAuth app this becomes\n     * `ads.admin.all.write` and `connectsWith` goes away.\n     */\n    writeScopes: [],\n    commands: \"baker ads chatgpt\",\n    connectsWith: \"api-key\",\n  },\n  \"tag-manager\": {\n    id: \"tag-manager\",\n    label: \"Tag Manager\",\n    provider: \"google-tag-manager\",\n    resourceNoun: \"container\",\n    writePath: \"staged-immediate\",\n    writeScopes: [\n      \"https://www.googleapis.com/auth/tagmanager.edit.containers\",\n      \"https://www.googleapis.com/auth/tagmanager.edit.containerversions\",\n      \"https://www.googleapis.com/auth/tagmanager.publish\",\n    ],\n    commands: \"baker tag-manager\",\n  },\n  ga4: {\n    id: \"ga4\",\n    label: \"Google Analytics 4\",\n    provider: \"google-analytics\",\n    resourceNoun: \"property\",\n    // Like Tag Manager: staged during the chat, applied for real at publish,\n    // every time. A connection made before writes existed is\n    // read-only until it is reconnected, and `access` does NOT say so — it\n    // reports what the Baker app asks Google for, which is now app-wide\n    // read-write. The per-company signal is `scopeBlockers`, which compares\n    // `writeScopes` against the scopes that connection actually recorded.\n    writePath: \"staged-immediate\",\n    writeScopes: [\"https://www.googleapis.com/auth/analytics.edit\"],\n    commands: \"baker ga4\",\n  },\n  gsc: {\n    id: \"gsc\",\n    label: \"Search Console\",\n    provider: \"google-search-console\",\n    resourceNoun: \"site\",\n    writePath: \"read-only\",\n    writeScopes: [\"https://www.googleapis.com/auth/webmasters\"],\n    commands: \"baker gsc\",\n  },\n  shopify: {\n    id: \"shopify\",\n    label: \"Shopify store\",\n    provider: \"shopify\",\n    resourceNoun: \"store\",\n    // Staged during the chat and applied to the real store when it completes,\n    // every time; each applied change can be put back by another publish\n    // (`baker shopify undo`). The write permissions are optional scopes the\n    // store grants when a change first needs one, so `scopeBlockers` is the\n    // per-company signal.\n    writePath: \"staged-immediate\",\n    writeScopes: [\n      \"write_products\",\n      \"write_publications\",\n      \"write_discounts\",\n      \"write_online_store_navigation\",\n      \"write_marketing_events\",\n    ],\n    commands: \"baker shopify\",\n  },\n};\n\n/**\n * Why a capability is missing. The distinction is what decides what the agent\n * tells the user, so it is part of the contract rather than left to prose:\n *  - `not_built`        — the platform allows it, Baker has not built it. It may\n *                         be possible by hand in the platform's own interface.\n *  - `provider_forbids` — the platform rejects it however it is asked. Nobody can\n *                         do it, so do not hand the user a manual route.\n *  - `no_permission`    — the connection was never granted the access. Reading\n *                         works, changing does not; it is manual work today.\n */\nexport type CapabilityLimitCause = \"not_built\" | \"provider_forbids\" | \"no_permission\";\n\n/**\n * The checkable claim behind a limit. `coverage.test.ts` re-derives each one.\n */\nexport type CapabilityLimitEvidence =\n  /** The app never requests this OAuth scope, so nothing can write here. */\n  | { kind: \"scope\"; scope: string }\n  /** No staged op with these kinds exists, so there is nothing to stage. */\n  | { kind: \"noOpKind\"; kinds: string[] }\n  /** A field on a staged op does not accept this value. */\n  | { kind: \"noChoice\"; opKind: string; field: string; value: string }\n  /** A stage-time guard refuses it before anything is spent. */\n  | { kind: \"guard\"; module: string; symbol: string }\n  /** Nothing in this repository encodes it; the note says why. */\n  | { kind: \"asserted\"; note: string };\n\nexport interface CapabilityLimit {\n  surface: CapabilitySurfaceId;\n  /** What an agent would set out to do, in the words it would use. */\n  capability: string;\n  cause: CapabilityLimitCause;\n  /** Why it cannot happen and what to do instead. Agent-facing, plain English. */\n  detail: string;\n  evidence: CapabilityLimitEvidence;\n}\n\n/**\n * Ordered by how often getting it wrong has cost something. Keep entries to\n * things an agent would plausibly promise a client before checking.\n */\nexport const CAPABILITY_LIMITS: readonly CapabilityLimit[] = [\n  {\n    surface: \"shopify\",\n    capability: \"Edit the store's theme files — templates, sections, the theme's code or its stylesheet\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Shopify only lets an app write theme files with an exemption it grants case by case, and editing a merchant's theme breaks the App Store's rules for an app like Baker. Say exactly what to change and where (Online Store → Themes → Customize), and carry on with the rest of the job.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"Shopify's rule, not this repository's: `write_themes` needs Shopify's exemption and App Store requirement 5.1.1 forbids theme edits by an app of this kind. The app's TOML declares no `write_themes` (scopes.test.ts holds the backend's list equal to it).\",\n    },\n  },\n  {\n    surface: \"shopify\",\n    capability: \"Create or delete products, change stock levels, or change whether a product is published\",\n    cause: \"not_built\",\n    detail:\n      \"Baker changes products' copy, SEO, tags, type, options' SKU, barcode, weight and price, custom fields, collections, discount codes, redirects and its own campaigns in Shopify Marketing. Making or removing a product, its stock and its status are the merchant's, in Shopify admin; say what to do there and carry on.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"shopify.product.create\", \"shopify.product.delete\", \"shopify.inventory.set\", \"shopify.product.publish\"],\n    },\n  },\n  {\n    surface: \"shopify\",\n    capability: \"Make a discount code for named customers or a customer segment\",\n    cause: \"not_built\",\n    detail:\n      \"Every discount code Baker creates is for everyone who has the code. A code for named customers or a segment is made in Shopify admin → Discounts.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"shopify.discountCode.createForCustomers\", \"shopify.discountAutomatic.create\"],\n    },\n  },\n  {\n    surface: \"shopify\",\n    capability: \"Make a collection whose products join by rules (a tag, a price, a type), or delete one\",\n    cause: \"not_built\",\n    detail:\n      \"Baker makes collections of hand-picked products and adds or removes products by hand. A collection whose products join by its rules is set up in Shopify admin; Baker refuses to delete one, because undo could not rebuild its rules.\",\n    evidence: { kind: \"guard\", module: \"shopify/writes/collectionRestore.ts\", symbol: \"restorability\" },\n  },\n  {\n    surface: \"ga4\",\n    capability:\n      \"Create, merge or delete a property; create a data stream or change its name, URL or cross-domain settings; change the property's time zone or currency\",\n    cause: \"not_built\",\n    detail:\n      \"Baker configures what a property MEASURES — key events, custom dimensions and metrics, custom events, audiences, the data retention window, a web stream's enhanced measurement (the events GA4 collects on its own) — plus the property's name, industry category and Google Ads link. It does not create or merge properties, create data streams or change a stream's name, URL or cross-domain settings. Time zone and currency are deliberately excluded even though the API allows them: both change how every future day is bucketed without reprocessing history, so a correction puts a step in the middle of every time series the user compares against. Tell the user exactly what to change in the Google Analytics admin screens and carry on with the rest of the job.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"ga4.dataStream.create\", \"ga4.dataStream.update\", \"ga4.property.create\"],\n    },\n  },\n  {\n    surface: \"ga4\",\n    capability: \"Change who is already in an audience, or build one from a sequence of steps\",\n    cause: \"provider_forbids\",\n    detail:\n      \"An audience can be CREATED and ARCHIVED here, and its name and description changed. Everything that defines who is in it — the conditions, the membership window, the exclusion mode — is marked Immutable by Google and cannot be edited on an audience that exists, however it is asked. Fixing a definition therefore means archiving the audience and creating a replacement, which does NOT carry the users the first one gathered. Say that before staging the archive. Sequence-based audiences (`sequenceFilter`) are not offered: they are the easiest shape in this API to get subtly wrong and the mistake is permanent, so build them by hand in Google Analytics if one is genuinely needed.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"The immutability is Google's, declared in the Admin API v1alpha `Audience` resource (`filter_clauses`, `membership_duration_days` and `exclusion_duration_mode` are all marked Immutable) — no code in this repository can be read to confirm a rule the provider enforces. What this repo does hold is the consequence: `GA4_IMMUTABLE_FIELDS.audience` in `packages/api/src/ga4/ops.ts` drives the refusal, and `ga4.test.ts` pins that an update carrying one of those fields is rejected with the archive-and-recreate wording rather than a zod key error.\",\n    },\n  },\n  {\n    surface: \"ga4\",\n    capability: \"Try a Google Analytics configuration change without it taking effect\",\n    cause: \"not_built\",\n    detail:\n      \"Google Analytics changes always apply to the real property: staged changes apply when the chat completes, and an applied change is in effect immediately — there is no version to publish afterwards and no undo. The user reviewing the Analytics tab and completing the chat is the review, so agree the changes with them before you complete it.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"An absence: the GA4 executor has no simulated branch and GA4 drafts have no `mode` column, and no test can assert the absence of a mode that was never modelled. The nearest positive check is that the three ad surfaces do carry one — a `mode` column on their drafts and an `executeSimulated` branch in each executor — which the `staged-live` vs `staged-immediate` write paths already encode. Their per-company write gates are retired, so every ad draft is stamped `live`; the branch survives only for drafts published while the gates existed.\",\n    },\n  },\n  {\n    surface: \"gsc\",\n    capability:\n      \"Change anything in Search Console — add or verify a property, submit or delete a sitemap, set a preferred domain\",\n    cause: \"no_permission\",\n    detail:\n      \"Baker's Search Console connection is read-only (webmasters.readonly). `baker gsc sitemaps` lists what is already submitted; it cannot submit one. Hand submission to the user in Search Console and carry on.\",\n    evidence: { kind: \"scope\", scope: \"https://www.googleapis.com/auth/webmasters\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Change a conversion action that Google itself created — Smart campaign calls and directions, the in-ad lead form's submit, YouTube subscriptions and follow-on views, Floodlight and Search Ads 360 imports, store visits, codeless webpage actions\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google rejects every write against one of its own conversion actions, a rename as flatly as a removal. Baker refuses these at stage time so no publish is spent on them. There is no manual route either — the Google Ads interface will not change them — so do not hand the user one. Leave the action alone and say so.\",\n    evidence: {\n      module: \"ads/google/writes/conversionSafety.ts\",\n      kind: \"guard\",\n      symbol: \"googleOwnedConversionRefusal\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Switch a demographic dimension — age, gender, parental status, household income — between Targeting and Observation\",\n    cause: \"not_built\",\n    detail:\n      \"`baker ads google audiences targeting` sets the AUDIENCE dimension only. The demographic rows are read before every write and sent back exactly as they were, so nothing is lost — but changing one is manual work in the Google Ads interface. Say which one to change and where, and carry on with the rest of the job.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.targetingSetting.set\", field: \"audience\", value: \"AGE_RANGE\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Hide a conversion action (status HIDDEN)\",\n    cause: \"provider_forbids\",\n    detail:\n      'Google denies HIDDEN on every conversion-action write (\"the field\\'s value is on a deny-list for this field\"), so it is not part of the write contract — even though actions hidden long ago still read back as HIDDEN. To take an action out of automated bidding while it keeps measuring, demote it: `baker ads google conversions update <id> --no-primary`. To stop it counting, set status REMOVED.',\n    evidence: { kind: \"noChoice\", opKind: \"google.conversionAction.update\", field: \"status\", value: \"HIDDEN\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Build a combined, converters or lookalike audience from an audience or conversion action created in the same chat\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google builds these lists from audiences and conversion actions that already exist in the account; one created in the same publish is not found. Stage and publish the parts first, then build the combined, converters or lookalike audience on their ids in a later chat — and tell the user it takes two publishes.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"Enforced by `existingRefSchema` inside `audienceCreateSchema` (packages/api ops.ts), which no capability check reads; the provider half is live on v25: a logical operand on a list created in the same request was RESOURCE_NOT_FOUND, a basic list over a conversion action created with it INVALID_CONVERSION_TYPE, and lookalike seeds are int64 ids.\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create a Google Analytics (GA4) conversion action in Google Ads\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google's API cannot create a Google Analytics conversion — they are imported, not created. Make sure the event is a key event in Google Analytics and the property is linked to Google Ads, then ask the user to import it in Google Ads (Goals → Conversions → New conversion action → Import → Google Analytics 4). To measure it with a Google Ads tag instead, stage a WEBPAGE conversion.\",\n    evidence: {\n      kind: \"noChoice\",\n      opKind: \"google.conversionAction.create\",\n      field: \"type\",\n      value: \"GOOGLE_ANALYTICS_4_CUSTOM\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Target the area around the business's own locations (a location group)\",\n    cause: \"not_built\",\n    detail:\n      'A location group targets a radius around the account\\'s location assets, and Baker cannot stage location assets yet — Google refuses a location group on an account without them. Target a radius around an address or a point instead (`criterionType: \"proximity\"` on `campaign-criteria add`), or tell the user to add the business locations in Google Ads; carry on with the rest of the job.',\n    evidence: {\n      kind: \"asserted\",\n      note: 'The refusal is in the shared criterion contract, not a Convex guard: `criterionSpecSchema` in `packages/api/src/ads-google/criteria.ts` answers `criterionType: \"locationGroup\"` with LOCATION_GROUP_MESSAGE, pinned by `criteria.test.ts`. Live on v25 (3865083115, no location assets) every location-group variant was refused — `enable_customer_level_location_asset_set` with \"The error code is not in this version.\", a geo-constant group with `location_group.feed` REQUIRED.',\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create a Video or Local campaign\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google's API does not create Video campaigns at all (refused for every sub-type and bidding), and Local campaigns were retired into Performance Max. For video on YouTube, stage a Demand Gen campaign with a Demand Gen video ad; for store visits, Performance Max. A Video views or reach campaign is the user's to create in Google Ads — say so, with the settings you recommend. Existing Video campaigns can still be read, paused and edited.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.campaign.create\", field: \"channelType\", value: \"VIDEO\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create a Smart campaign\",\n    cause: \"not_built\",\n    detail:\n      \"A Smart campaign's business details (phone, website, business profile) are a setting Google refuses to check before publishing (RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY), so Baker cannot stage one it could validate. Stage a Search or Performance Max campaign instead, or hand the Smart campaign to the user in Google Ads and carry on with the rest of the job. Shopping, App, Travel and Hotel campaigns ARE stageable — each with the account link it needs. Existing Smart campaigns can still be read, paused and edited.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.campaign.create\", field: \"channelType\", value: \"SMART\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability:\n      \"Create a campaign of a retired sub-type — Search or Display Express, Gmail, Smart Display, Smart Shopping, Video action, app promotion on Search\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google refuses every one of these on a create. Leave the sub-type out for a standard campaign of the same type; Gmail and Video action now run through Demand Gen, Smart Shopping through Performance Max.\",\n    evidence: {\n      kind: \"noChoice\",\n      opKind: \"google.campaign.create\",\n      field: \"channelSubType\",\n      value: \"DISPLAY_GMAIL_AD\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Set a campaign budget to accelerated delivery\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google still stores a budget set to accelerated delivery, but refuses to attach it to any campaign, so it can never spend. Every budget is staged with standard delivery (Google paces it across the day). If the user wants to spend faster, raise the daily amount instead — and say that is what you did.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.budget.create\", field: \"deliveryMethod\", value: \"ACCELERATED\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Create or edit a call ad (call-only ad)\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google removed the call ad from its API, so nobody can create one or change an existing one through it. To take phone calls from search, stage a responsive search ad and tell the user to add the phone number as a call asset in Google Ads (Baker cannot stage call assets yet). Carry on with the rest of the job.\",\n    evidence: {\n      kind: \"asserted\",\n      note: 'The format sits inside the ad content union, not on a top-level payload field, so no `noChoice` check can see it. `adContentSchema` answers `format: \"call\"` with CALL_AD_RETIRED_MESSAGE (packages/api ops.test.ts pins it); the provider half is v25\\'s `Ad` message having no `call_ad` — a validateOnly request on 3865083115 was refused `Unknown name \"callAd\"` (2026-10-08).',\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Remove a device setting from a campaign once it has one\",\n    cause: \"provider_forbids\",\n    detail:\n      \"A device criterion can be added with `campaign-criteria add` and re-bid afterwards, but Google rejects every removal of one — including a criterion the same account created itself days earlier (observed). So the undo for a bid boost is NOT a removal: it is `baker ads google campaign-criteria update <criterion-resource-name> --bid-modifier 1`, where 0 stops ads serving on that device and 0.1–10.0 bid down or up. Read `campaign_criterion.resource_name` and `campaign_criterion.bid_modifier` (type = DEVICE) first to see which devices the campaign already has. Baker refuses a staged device removal before publish; don't abort the job over it.\",\n    evidence: {\n      kind: \"guard\",\n      module: \"ads/google/writes/stage.ts\",\n      symbol: \"deviceCriterionRemovalRefusal\",\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Change which conversion action counts calls from ads (account call reporting)\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google's API refuses any write of the account's call conversion action, even the one it already uses. Call reporting itself and whether calls count as conversions ARE stageable (`baker ads google account update --call-reporting --call-conversions`). Hand the action choice to the user: Google Ads → Admin → Account settings → Call reporting. Carry on with the rest of the job.\",\n    evidence: {\n      kind: \"asserted\",\n      note: '`customerUpdateSchema` is strict and carries no callConversionAction, so an op naming it is refused at stage; the provider half: a validateOnly customer update of `call_reporting_setting.call_conversion_action` on 3865083115 — with the live value and with another action — was refused \"The error code is not in this version.\" (v25, 2026-10-08).',\n    },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Put a label on an asset (sitelink, image, callout …)\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google Ads has no labels on assets — its API labels campaigns, ad groups, ads and keywords only, and staging refuses an asset. Label the campaign or ad group that uses the asset, or give the asset a findable name, and carry on with the rest of the job.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.label.attach\", field: \"level\", value: \"asset\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Put a label on the advertiser account itself\",\n    cause: \"provider_forbids\",\n    detail:\n      \"Google applies a label to an account only from the manager account above it (CANNOT_ATTACH_NON_MANAGER_LABEL_TO_CUSTOMER, live v25), and Baker works inside the advertiser account. Label the campaigns instead, or tell the user to label the account from their manager account in Google Ads; carry on with the rest of the job.\",\n    evidence: { kind: \"noChoice\", opKind: \"google.label.attach\", field: \"level\", value: \"customer\" },\n  },\n  {\n    surface: \"google-ads\",\n    capability: \"Change billing, payment methods, or account-level spend limits\",\n    cause: \"not_built\",\n    detail:\n      \"Nothing that touches money setup is stageable — no op exists for it. Report on spend, then hand billing changes to the user in Google Ads. Account settings that are not money (auto-tagging, the account tracking template and final URL suffix, call reporting, video inventory) ARE stageable: `baker ads google account update`.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\"google.billingSetup.create\", \"google.accountBudget.create\"],\n    },\n  },\n  {\n    surface: \"meta-ads\",\n    capability:\n      \"Push delivery to an ad — dedicate a share of the campaign or ad-set budget to one ad for a set number of days\",\n    cause: \"not_built\",\n    detail:\n      'Meta ships push delivery as an Ads Manager control only: the Marketing API\\'s ad object takes a schedule, a display sequence and tracking, and nothing that dedicates budget to one ad. So nothing can stage it and no publish can apply it — do not offer to switch it on, and never report a starved ad as pushed. Hand the user the click path and the settings you are recommending: Ad level > Ad setup > \"show more settings\" (next to ad scheduling) > \"Help ensure delivery by dedicating a portion of your budget to your ad\", then the percentage of budget and the number of days, for the one ad you name. It needs at least 2 ads in the ad set, and only one ad per ad set should be pushed. Then carry on with the rest of the job.',\n    evidence: { kind: \"noOpKind\", kinds: [\"ad.pushDelivery\"] },\n  },\n  {\n    surface: \"linkedin-ads\",\n    capability: \"Move a live ad to another ad set, or change a live ad set's type, locale, or associated organization\",\n    cause: \"provider_forbids\",\n    detail:\n      \"LinkedIn treats these as create-only: they can be corrected while the change is still staged, but not on something already live. Baker refuses the amend rather than staging a write LinkedIn will reject. Create the replacement instead, and say why.\",\n    evidence: { kind: \"guard\", module: \"ads/linkedin/writes/amend.ts\", symbol: \"rejectedLiveKeys\" },\n  },\n  {\n    surface: \"tag-manager\",\n    capability: \"Create, delete, or move a Tag Manager account, container, or workspace\",\n    cause: \"not_built\",\n    detail:\n      \"Baker works inside the containers the company connected — it changes tags, triggers, variables, folders, built-in variables and container settings, and nothing above that level. Ask the user to create the container in Tag Manager and connect it, then carry on.\",\n    evidence: {\n      kind: \"noOpKind\",\n      kinds: [\n        \"tagManager.container.create\",\n        \"tagManager.container.delete\",\n        \"tagManager.account.create\",\n        \"tagManager.workspace.create\",\n      ],\n    },\n  },\n  {\n    surface: \"tag-manager\",\n    capability: \"Try a container change without it going live\",\n    cause: \"not_built\",\n    detail:\n      \"Tag Manager changes always apply to the real container: staged changes apply to its working workspace when the chat completes, and a clean run cuts and publishes a container version, which takes them live on the site. Completing the chat is the review, so get the user's agreement before you complete it.\",\n    evidence: {\n      kind: \"asserted\",\n      note: \"An absence: the Tag Manager executor has no simulated branch and its drafts have no `mode` column, and no test can assert the absence of a mode that was never modelled. The nearest positive check is that the three ad surfaces do carry one — a `mode` column on their drafts and an `executeSimulated` branch in each executor — which the `staged-live` vs `staged-immediate` write paths already encode. Their per-company write gates are retired, so every ad draft is stamped `live`; the branch survives only for drafts published while the gates existed.\",\n    },\n  },\n];\n","/**\n * Contract for `/api/capabilities` — what Baker can and cannot do for this\n * company, answered before any work starts (`baker capabilities`).\n *\n * Convex `Id<T>` values are plain `z.string()`; this package must not depend on\n * `convex`. Nothing here carries a token, key, or anything a credential could be\n * reconstructed from — the response names accounts and permissions, never\n * secrets.\n */\nimport { z } from \"zod\";\nimport { CAPABILITY_SURFACES } from \"./surfaces\";\n\nexport { describeOpUnion, type OpDescription } from \"./op-fields\";\nexport {\n  CAPABILITY_LIMITS,\n  CAPABILITY_SURFACE_SPECS,\n  CAPABILITY_SURFACES,\n  type CapabilityLimit,\n  type CapabilityLimitCause,\n  type CapabilityLimitEvidence,\n  type CapabilitySurfaceId,\n  type CapabilitySurfaceSpec,\n  type CapabilityWritePath,\n} from \"./surfaces\";\n\nexport const capabilitySurfaceSchema = z.enum(CAPABILITY_SURFACES);\n\nexport const capabilitiesRequestSchema = z.object({\n  /** Narrow to one surface. Omit for every surface the company could use. */\n  surface: capabilitySurfaceSchema.optional(),\n  /** Include the field-level contract of every op, not just the entity list. */\n  full: z.boolean().optional(),\n  /**\n   * Who the chat acts as (`BAKER_ACTING_USER_ID`). Adds that person's own\n   * connected tools — they load for this turn, and for nobody else's.\n   */\n  actingUserId: z.string().optional(),\n});\nexport type CapabilitiesRequest = z.infer<typeof capabilitiesRequestSchema>;\n\n/** A connected account, property, site or container. Identity only. */\nexport const capabilityResourceSchema = z.object({\n  id: z.string(),\n  name: z.string().optional(),\n});\nexport type CapabilityResource = z.infer<typeof capabilityResourceSchema>;\n\nexport const capabilityOpSchema = z.object({\n  kind: z.string(),\n  /** True when the op changes something that already exists and must be named. */\n  needsTarget: z.boolean(),\n  required: z.array(z.string()),\n  optional: z.array(z.string()),\n  /** Field → the values it accepts, for fields that take a fixed set. */\n  choices: z.record(z.string(), z.array(z.string())),\n  /** False when the platform accepts fields beyond the listed ones. */\n  fieldsAreComplete: z.boolean(),\n});\nexport type CapabilityOp = z.infer<typeof capabilityOpSchema>;\n\nexport const capabilityLimitViewSchema = z.object({\n  capability: z.string(),\n  cause: z.enum([\"not_built\", \"provider_forbids\", \"no_permission\"]),\n  detail: z.string(),\n});\nexport type CapabilityLimitView = z.infer<typeof capabilityLimitViewSchema>;\n\n/**\n * `live` — writes reach the real platform at publish.\n * `applies-at-publish` — publishing changes the real thing, with no version step after.\n * `none` — this surface does not write.\n *\n * There is no `simulated`: the per-company gates that produced it on Google,\n * Meta and LinkedIn are all retired, so no surface can report a write that\n * touches nothing. Leaving the value in the contract would keep alive the one\n * sentence this report exists to prevent — \"your ads are only a preview\".\n */\nexport const capabilityWriteModeSchema = z.enum([\"live\", \"applies-at-publish\", \"none\"]);\nexport type CapabilityWriteMode = z.infer<typeof capabilityWriteModeSchema>;\n\nexport const capabilitySurfaceReportSchema = z.object({\n  surface: capabilitySurfaceSchema,\n  label: z.string(),\n  connected: z.boolean(),\n  /** What the user picked when connecting. Empty when nothing is selected yet. */\n  resources: z.array(capabilityResourceSchema),\n  access: z.enum([\"read-write\", \"read-only\", \"not-connected\"]),\n  writeMode: capabilityWriteModeSchema,\n  /** One sentence about the write mode, safe to repeat to the user. */\n  writeModeNote: z.string(),\n  /** Entities this surface can change at all, e.g. \"campaign\", \"keyword\". */\n  writableEntities: z.array(z.string()),\n  /** Things wrong with the connection itself: needs reconnecting, missing a permission. */\n  blockers: z.array(z.string()),\n  /** What cannot be done here, and why. */\n  limits: z.array(capabilityLimitViewSchema),\n  /** The per-op contract. Present when one surface was asked for, or with `full`. */\n  ops: z.array(capabilityOpSchema).optional(),\n  /** Where to look next: `baker ads google`, `baker ga4`, … */\n  commands: z.string(),\n});\nexport type CapabilitySurfaceReport = z.infer<typeof capabilitySurfaceReportSchema>;\n\n/**\n * A source that is available to this company but is not one of the seven\n * marketing surfaces above.\n *\n * These exist because \"what do I have?\" had no single answer, and the gap was\n * not academic: Microsoft Clarity arrives over MCP and HubSpot is read through\n * the CLI, so neither appears in `surfaces` — and an agent that checked only\n * this command concluded it had no Clarity while Clarity was sitting in its own\n * tool list. That is the source most likely to change what it decides.\n *\n * Deliberately NOT modelled as a surface. A surface carries `ops`,\n * `writableEntities` and a write mode, all of which describe a staged-write\n * contract Baker owns. An MCP toolkit has none of that — Baker did not define\n * its tools and cannot enumerate their fields — so filing one under `surfaces`\n * would mean either lying about the contract or leaving four fields empty on\n * every row and inviting the reader to wonder which.\n */\nexport const capabilityToolSchema = z.object({\n  /** `microsoft_clarity`, `hubspot`, or the name the user gave a custom server. */\n  key: z.string(),\n  label: z.string(),\n  /** `mcp` — tools in the agent's own list. `platform` — signed in, read through the CLI. */\n  kind: z.enum([\"mcp\", \"platform\"]),\n  /** How to actually reach it, in one phrase the agent can act on. */\n  reach: z.string(),\n  /**\n   * Whether it can be used right now.\n   *\n   * A connection that exists and is expired is worse than one that is absent:\n   * it reads as available and fails at the moment it is needed, which on an\n   * unattended run is a report with a hole in it and no explanation.\n   */\n  ready: z.boolean(),\n  /** Why it is not ready, or what it is for. Absent when neither needs saying. */\n  note: z.string().optional(),\n});\nexport type CapabilityTool = z.infer<typeof capabilityToolSchema>;\n\nexport const capabilitiesResponseSchema = z.object({\n  ok: z.literal(true),\n  data: z.object({\n    surfaces: z.array(capabilitySurfaceReportSchema),\n    /**\n     * Everything else this company can reach. Shared connections only —\n     * a teammate's private per-user connection belongs to whoever started the\n     * session and is visible in the agent's own tool list, not here.\n     */\n    tools: z.array(capabilityToolSchema),\n  }),\n});\nexport type CapabilitiesResponse = z.infer<typeof capabilitiesResponseSchema>;\n"],"mappings":"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","names":[]}

package/dist/chunk-OMDN3MON.js

@@ -1,23 +0,0 @@
-import {
-  creativesRunResponseSchema
-} from "./chunk-6OCQ4DM6.js";
-import {
-  ApiError,
-  apiPost
-} from "./chunk-B2OHCWYB.js";
-
-// src/commands/canvas/run-history.ts
-async function fetchRunRecord(runId, post = apiPost) {
-  try {
-    const response = await post("/api/creatives/run", { runId });
-    return creativesRunResponseSchema.parse(response).data;
-  } catch (e) {
-    if (e instanceof ApiError && e.code === "NOT_FOUND") return null;
-    throw e;
-  }
-}
-
-export {
-  fetchRunRecord
-};
-//# sourceMappingURL=chunk-OMDN3MON.js.map

package/dist/chunk-OMW4EUKA.js

@@ -1,125 +0,0 @@
-import {
-  apiGet
-} from "./chunk-B2OHCWYB.js";
-
-// src/commands/studio/batch.ts
-function projectBatch(generation, full) {
-  const compact = {
-    generationId: generation.generationId,
-    kind: generation.kind,
-    status: generation.status,
-    prompt: generation.prompt,
-    model: generation.model,
-    aspectRatio: generation.aspectRatio,
-    variants: generation.variants.map((variant) => ({
-      slot: variant.slot,
-      status: variant.status,
-      ...variant.imageId ? { imageId: variant.imageId } : {},
-      ...variant.videoId ? { videoId: variant.videoId } : {},
-      ...variant.url ? { url: variant.url } : {},
-      inLibrary: variant.inLibrary,
-      ...variant.error ? { error: variant.error } : {}
-    }))
-  };
-  if (!full) return compact;
-  return {
-    ...compact,
-    ...generation.skillId ? { skillId: generation.skillId } : {},
-    ...generation.imageSettings ? { imageSettings: generation.imageSettings } : {},
-    ...generation.clipSettings ? { clipSettings: generation.clipSettings } : {},
-    ...generation.referenceImageIds ? { referenceImageIds: generation.referenceImageIds } : {},
-    ...generation.chatId ? { chatId: generation.chatId } : {},
-    createdAt: generation.createdAt
-  };
-}
-function slotArg(candidates) {
-  return candidates.length === 1 ? `--slot ${candidates[0]?.slot}` : "--slot <n>";
-}
-function chooseFirst(candidates) {
-  return candidates.length === 1 ? "" : " Look at the takes and pick one \u2014 do not default to the first.";
-}
-function batchHints(generation) {
-  const id = generation.generationId;
-  if (generation.status === "running") {
-    return [
-      `Still rendering. Run \`baker studio get ${id}\` when you need the result \u2014 do not start the same batch again.`
-    ];
-  }
-  const hints = [];
-  const ready = generation.variants.filter((variant) => variant.status === "ready");
-  const failed = generation.variants.filter((variant) => variant.status === "failed");
-  if (generation.kind === "image" && ready.length > 0) {
-    hints.push(
-      'Every rendered image is already in the media library and searchable \u2014 `baker images library "<what it shows>"` finds it, and you can use its image id straight away.'
-    );
-    hints.push(
-      `Mark the take you are using: \`baker studio keep ${id} ${slotArg(ready)}\` stars it so the client reviews the right one.${chooseFirst(ready)}`
-    );
-  }
-  const unkeptClips = ready.filter((variant) => !variant.inLibrary);
-  if (generation.kind === "video" && unkeptClips.length > 0) {
-    hints.push(
-      `A clip is not usable anywhere \u2014 canvas, landing, ad \u2014 until you keep it. \`baker studio keep ${id} ${slotArg(unkeptClips)}\` puts it in the video library; takes nobody keeps are never ingested.${chooseFirst(unkeptClips)}`
-    );
-  }
-  if (generation.status === "partial" && failed.length > 0) {
-    hints.push(
-      `${failed.length === 1 ? "This take" : "These takes"} did not render \u2014 ${failed.map((variant) => `take ${variant.slot}: ${variant.error ?? "no reason given"}`).join("; ")}. Use the ones that did and carry on; do not re-run the whole batch.`
-    );
-  }
-  if (generation.status === "failed") {
-    hints.push(
-      `No take rendered \u2014 ${failed[0]?.error ?? "no reason given"}. Continue the job with a sourced or existing asset rather than stopping.`
-    );
-  }
-  return hints;
-}
-function waitingHint(outcome, generationId, maxWaitMs) {
-  const collect = `Run \`baker studio get ${generationId}\` to pick it up \u2014 the batch is still going, so do not start it again.`;
-  if (outcome.kind === "unreachable") {
-    return `The batch started and is rendering, but reading it back failed (${outcome.reason}). ${collect}`;
-  }
-  return `Still rendering after ${Math.round(maxWaitMs / 1e3)}s. ${collect}`;
-}
-var FALSEY_FLAG_VALUES = /* @__PURE__ */ new Set(["false", "0", "no", "off"]);
-function resolveMaxWaitMs(wait, maxWait, defaultMs) {
-  if (typeof wait === "string" && FALSEY_FLAG_VALUES.has(wait.trim().toLowerCase())) return 0;
-  if (wait === false) return 0;
-  if (maxWait === void 0 || maxWait === "") return defaultMs;
-  const parsed = Number(maxWait);
-  return Number.isFinite(parsed) && parsed >= 0 ? parsed : defaultMs;
-}
-var POLL_INTERVAL_MS = 3e3;
-var defaultPollDeps = {
-  get: async (generationId) => {
-    const response = await apiGet(`/api/studio/generations/${generationId}`);
-    return response.generation;
-  },
-  sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
-};
-async function pollBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
-  const deadline = Date.now() + maxWaitMs;
-  while (Date.now() < deadline) {
-    const generation = await deps.get(generationId);
-    if (generation.status !== "running") return generation;
-    await deps.sleep(POLL_INTERVAL_MS);
-  }
-  return null;
-}
-async function awaitBatch(generationId, maxWaitMs, deps = defaultPollDeps) {
-  try {
-    const generation = await pollBatch(generationId, maxWaitMs, deps);
-    return generation ? { kind: "settled", generation } : { kind: "still-running" };
-  } catch (error) {
-    return { kind: "unreachable", reason: error instanceof Error ? error.message : "the read failed" };
-  }
-}
-
-export {
-  projectBatch,
-  batchHints,
-  waitingHint,
-  resolveMaxWaitMs,
-  awaitBatch
-};
-//# sourceMappingURL=chunk-OMW4EUKA.js.map

package/dist/chunk-P2XBADY3.js

@@ -1,42 +0,0 @@
-import {
-  ApiError
-} from "./chunk-B2OHCWYB.js";
-import {
-  writeJson
-} from "./chunk-WCIS4FZH.js";
-
-// src/commands/studio/errors.ts
-var CREDIT_HINTS = ["credit", "top up", "billing", "quota"];
-function studioStartFix(message) {
-  const lower = message.toLowerCase();
-  if (CREDIT_HINTS.some((hint) => lower.includes(hint))) {
-    return {
-      action: "Stop generating and finish the task with assets that already exist",
-      explanation: "No generation will run until the plan is topped up, so retrying costs time and changes nothing. Source or reuse an image instead, complete the rest of the work, and tell the user the new artwork could not be produced."
-    };
-  }
-  return {
-    action: "Drop or correct the setting the message names, then run the command once more",
-    explanation: "The message says which model was chosen and what it accepts. If the setting is not essential to the brief, leave it out rather than switching model. Do not abort the wider job over one refused setting."
-  };
-}
-function failStudioCommand(error, opts = {}) {
-  if (error instanceof ApiError) {
-    writeJson({
-      ok: false,
-      error: {
-        code: error.code,
-        message: error.message,
-        ...opts.withFix ? { fix: studioStartFix(error.message) } : {}
-      }
-    });
-    process.exit(1);
-  }
-  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
-  process.exit(1);
-}
-
-export {
-  failStudioCommand
-};
-//# sourceMappingURL=chunk-P2XBADY3.js.map