@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/keyword-metrics-E3NJUSEQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/keyword-metrics.ts","../src/commands/research/keyword-metrics-rows.ts"],"sourcesContent":["import { RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS, type ResearchKeywordMetricsRow } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { keywordMetricsHints } from \"./hints.ts\";\nimport { keywordMetricsFields, toOutputRow } from \"./keyword-metrics-rows.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.keyword-metrics\",\n  description:\n    \"Search volume, CPC, top-of-page bids and competition for a list of keywords you name — no domain needed. This is the command for sizing a market you have keywords for; the domain-bound ones (keywords-for-site, keyword-gap) answer a different question and should not be used as a workaround for this one. The volume is Google's Keyword Planner figure resold by DataForSEO, so it is not a second opinion on `baker ads google keywords metrics` — for that, pass --clickstream. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.\",\n  args: {\n    keywords: {\n      type: \"string\",\n      description: `Comma-separated keywords (max ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS}, 80 chars each)`,\n      required: true,\n    },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, mx, br, es...) or DataForSEO location code. Defaults to us (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name. Defaults to en (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    clickstream: {\n      type: \"boolean\",\n      description:\n        \"Also return DataForSEO's own panel-derived volume (clickstream_search_volume), the only genuinely independent estimate of demand available here. Costs 2x.\",\n      required: false,\n    },\n    full: {\n      type: \"boolean\",\n      description: \"Add keyword difficulty, search intent and the 12-month volume trend to each row\",\n      required: false,\n    },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\nexport const keywordMetricsCommand = defineCommand({\n  meta: {\n    name: \"keyword-metrics\",\n    description: `Volume, CPC and competition for keywords you name. No domain required.\n\nNumbers are Keyword Planner ESTIMATES of total market volume, resold by DataForSEO — every column carrying one is named planner_. Pass --clickstream for DataForSEO's own independent estimate alongside.\n\nExamples:\n  baker research keyword-metrics \"chatbot whatsapp,agente whatsapp ecommerce\" --location mx --language es\n  baker research keyword-metrics \"chatbot whatsapp\" --location br --language pt --clickstream\n  baker research keyword-metrics \"crm software,best crm\" --full --output md`,\n  },\n  args: {\n    keywords: { type: \"positional\", description: \"Comma-separated keywords\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    clickstream: { type: \"boolean\", description: \"Add DataForSEO's own volume estimate (costs 2x)\", required: false },\n    full: { type: \"boolean\", description: \"Add difficulty, intent and the 12-month trend\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const keywords = (args.keywords as string)\n      .split(\",\")\n      .map((k) => k.trim())\n      .filter(Boolean);\n\n    if (keywords.length === 0) {\n      writeResearchJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: \"Provide at least one keyword\" },\n      });\n      process.exit(1);\n    }\n    if (keywords.length > RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: `Maximum ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} keywords per request`,\n          fix: {\n            action: \"retry_with_changes\",\n            explanation: `You sent ${keywords.length}. Split the list into batches of ${RESEARCH_KEYWORD_METRICS_MAX_KEYWORDS} and run the command once per batch — each batch is a separate charge, so batch by priority.`,\n          },\n        },\n      });\n      process.exit(1);\n    }\n\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const clickstream = Boolean(args.clickstream);\n    const full = Boolean(args.full);\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const result = await apiPost<{ data: ResearchKeywordMetricsRow[] }>(\"/api/research/keyword-metrics\", {\n        keywords,\n        location,\n        language,\n        includeClickstream: clickstream,\n        skipCache: args[\"no-cache\"] ? true : undefined,\n      });\n\n      const columns = { clickstream, full };\n      const rows = result.data.map((row) => toOutputRow(row, columns));\n      const hints = keywordMetricsHints({ rows: result.data, asked: keywords, clickstream, queryContext });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      if (format !== \"json\") {\n        writeResearchOutput(rows, format);\n        writeResearchHints([...hints, RESEARCH_DATA_NOTE], format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data: rows,\n        fields: keywordMetricsFields(columns),\n        note: RESEARCH_DATA_NOTE,\n        hints,\n        query_context: queryContext,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n","/**\n * Naming the rows of `baker research keyword-metrics` after where each number\n * came from.\n *\n * DataForSEO does not measure Google's search volume — it resells the Keyword\n * Planner figure, so `search_volume` here and `planner_avg_monthly_searches`\n * from `baker ads google keywords metrics` are one number with two names. A run\n * that did not know that presented the two side by side as agreeing sources and\n * reported the agreement as validation; they matched to the digit in all seven\n * rows because they are the same row. The only defence that survives a CSV in\n * /tmp is the column name, which is the same conclusion `ads/google/keywords/\n * provenance.ts` reached for the other half of the pair — so the same prefix is\n * used deliberately.\n *\n * The exception is clickstream: `clickstream_search_volume` is DataForSEO's own\n * panel-derived estimate and genuinely is a second opinion. It keeps its own\n * prefix so it can never be read as Google's, or Google's as it.\n */\nimport type { ResearchKeywordMetricsRow } from \"@baker/api\";\n\nexport const KEYWORD_METRICS_SOURCE = \"keyword_planner_estimate_via_dataforseo\";\n\nexport type KeywordMetricsOutputRow = Record<string, unknown>;\n\nexport interface KeywordMetricsColumnOptions {\n  /** The request asked for DataForSEO's panel volume alongside Google's. */\n  clickstream: boolean;\n  /** Add difficulty, intent and the 12-month trend. */\n  full: boolean;\n}\n\nexport function toOutputRow(\n  row: ResearchKeywordMetricsRow,\n  options: KeywordMetricsColumnOptions,\n): KeywordMetricsOutputRow {\n  const out: KeywordMetricsOutputRow = {\n    source: KEYWORD_METRICS_SOURCE,\n    keyword: row.keyword,\n    planner_search_volume: row.search_volume,\n    planner_cpc: row.cpc,\n    planner_low_top_of_page_bid: row.low_top_of_page_bid,\n    planner_high_top_of_page_bid: row.high_top_of_page_bid,\n    planner_competition: row.competition,\n    planner_competition_index: row.competition_index,\n  };\n  if (options.clickstream) {\n    out.clickstream_search_volume = row.clickstream_search_volume;\n  }\n  if (options.full) {\n    out.keyword_difficulty = row.keyword_difficulty;\n    out.main_intent = row.main_intent;\n    out.planner_monthly_searches = row.monthly_searches;\n  }\n  return out;\n}\n\nexport function keywordMetricsFields(options: KeywordMetricsColumnOptions): Record<string, string> {\n  const fields: Record<string, string> = {\n    source: `Always \"${KEYWORD_METRICS_SOURCE}\". Every planner_ column below is Google's Keyword Planner ESTIMATE of total market volume, resold by DataForSEO — the same number \\`baker ads google keywords metrics\\` returns, not an independent measurement of it. Columns without the planner_ prefix are DataForSEO's own.`,\n    keyword:\n      \"The keyword asked for. A row with every metric null means DataForSEO holds no data on it — not that nobody searches it.\",\n    planner_search_volume: \"ESTIMATE: average monthly searches across the whole market, last 12 months\",\n    planner_cpc: \"ESTIMATE: average cost per click in USD (a single blended figure, not a top-of-page range)\",\n    planner_low_top_of_page_bid: \"ESTIMATE: low-range top-of-page bid in USD\",\n    planner_high_top_of_page_bid: \"ESTIMATE: high-range top-of-page bid in USD\",\n    planner_competition: \"ESTIMATE: competition level — LOW, MEDIUM or HIGH\",\n    planner_competition_index: \"ESTIMATE: competition index 0-100 (higher = more advertisers)\",\n  };\n  if (options.clickstream) {\n    fields.clickstream_search_volume =\n      \"DataForSEO's OWN volume estimate, from clickstream panels — not Google's, and the only number here that is a genuine second opinion on demand. Expect it to differ from planner_search_volume; that is the point.\";\n  }\n  if (options.full) {\n    fields.keyword_difficulty = \"DataForSEO's 0-100 estimate of how hard ranking in the organic top 10 would be\";\n    fields.main_intent = \"DataForSEO's intent classification: informational, navigational, commercial or transactional\";\n    fields.planner_monthly_searches = \"ESTIMATE: 12-month volume breakdown ({year, month, search_volume})\";\n  }\n  return fields;\n}\n"],"mappings":"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","names":[]}

package/dist/keywords-for-site-RH47P4GJ.js

@@ -0,0 +1,124 @@
+import {
+  keywordsForSiteHints
+} from "./chunk-PIWMNKWI.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-TBEUMOEL.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-2SCPDSFN.js";
+import "./chunk-EVYXTT7V.js";
+import "./chunk-XML7AJM3.js";
+import {
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/keywords-for-site.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.keywords-for-site",
+  description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+  args: {
+    target: { type: "string", description: "Domain or URL to analyze (positional)", required: true },
+    location: {
+      type: "string",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    sort: {
+      type: "string",
+      description: "Sort: search_volume, competition, cpc (default: search_volume)",
+      required: false
+    },
+    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  keyword: "Keyword the site targets",
+  search_volume: "Monthly search volume",
+  cpc: "Cost per click in USD",
+  competition: "LOW, MEDIUM, or HIGH",
+  competition_index: "Competition score 0-100"
+};
+var keywordsForSiteCommand = defineCommand({
+  meta: {
+    name: "keywords-for-site",
+    description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
+
+Examples:
+  baker research keywords-for-site "competitor.com"
+  baker research keywords-for-site "competitor.com" --type paid --limit 20
+  baker research keywords-for-site "competitor.com" --type organic --location uk`
+  },
+  args: {
+    target: { type: "positional", description: "Domain or URL to analyze", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    sort: { type: "string", description: "Sort: search_volume, competition, cpc", required: false },
+    type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+    limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+    output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  },
+  run: async ({ args }) => {
+    const target = args.target;
+    const location = args.location || void 0;
+    const language = args.language || void 0;
+    const sort = args.sort || void 0;
+    const type = args.type || void 0;
+    const limit = args.limit ? Number(args.limit) : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(location, language);
+    try {
+      const data = await apiPost("/api/research/keywords-for-site", {
+        target,
+        location,
+        language,
+        sort,
+        type,
+        limit,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      const hints = keywordsForSiteHints(data.length, queryContext, type);
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data,
+        fields: FIELDS,
+        note: RESEARCH_DATA_NOTE,
+        query_context: queryContext,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  keywordsForSiteCommand
+};
+//# sourceMappingURL=keywords-for-site-RH47P4GJ.js.map

package/dist/keywords-for-site-RH47P4GJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/keywords-for-site.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { buildResearchQueryContext, warnDefaults } from \"../../geo-context.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { keywordsForSiteHints } from \"./hints.ts\";\nimport {\n  handleResearchError,\n  RESEARCH_DATA_NOTE,\n  writeResearchHints,\n  writeResearchJson,\n  writeResearchOutput,\n} from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.keywords-for-site\",\n  description:\n    \"Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.\",\n  args: {\n    target: { type: \"string\", description: \"Domain or URL to analyze (positional)\", required: true },\n    location: {\n      type: \"string\",\n      description:\n        \"Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted — always set this for non-US markets\",\n      required: false,\n    },\n    language: {\n      type: \"string\",\n      description:\n        \"Language code or name. Defaults to en (English) if omitted — always set this for non-English markets\",\n      required: false,\n    },\n    sort: {\n      type: \"string\",\n      description: \"Sort: search_volume, competition, cpc (default: search_volume)\",\n      required: false,\n    },\n    type: { type: \"string\", description: \"Filter: paid, organic, all (default: all)\", required: false },\n    limit: { type: \"string\", description: \"Max results (default: 50, max: 1000)\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n});\n\ninterface KeywordForSite {\n  keyword: string;\n  search_volume: number;\n  cpc: number;\n  competition: string;\n  competition_index: number;\n}\n\nconst FIELDS: Record<string, string> = {\n  keyword: \"Keyword the site targets\",\n  search_volume: \"Monthly search volume\",\n  cpc: \"Cost per click in USD\",\n  competition: \"LOW, MEDIUM, or HIGH\",\n  competition_index: \"Competition score 0-100\",\n};\n\nexport const keywordsForSiteCommand = defineCommand({\n  meta: {\n    name: \"keywords-for-site\",\n    description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.\n\nExamples:\n  baker research keywords-for-site \"competitor.com\"\n  baker research keywords-for-site \"competitor.com\" --type paid --limit 20\n  baker research keywords-for-site \"competitor.com\" --type organic --location uk`,\n  },\n  args: {\n    target: { type: \"positional\", description: \"Domain or URL to analyze\", required: true },\n    location: { type: \"string\", description: \"Country code or location code (default: us)\", required: false },\n    language: { type: \"string\", description: \"Language code or name (default: en)\", required: false },\n    sort: { type: \"string\", description: \"Sort: search_volume, competition, cpc\", required: false },\n    type: { type: \"string\", description: \"Filter: paid, organic, all (default: all)\", required: false },\n    limit: { type: \"string\", description: \"Max results (default: 50, max: 1000)\", required: false },\n    output: { type: \"string\", description: \"Format: json|csv|md|jsonl\", required: false, default: \"json\" },\n    \"no-cache\": { type: \"boolean\", description: \"Skip server cache, hit API directly\", required: false },\n  },\n  run: async ({ args }) => {\n    const target = args.target as string;\n    const location = (args.location as string) || undefined;\n    const language = (args.language as string) || undefined;\n    const sort = (args.sort as string) || undefined;\n    const type = (args.type as string) || undefined;\n    const limit = args.limit ? Number(args.limit) : undefined;\n    const skipCache = args[\"no-cache\"] ? true : undefined;\n    const queryContext = buildResearchQueryContext(location, language);\n\n    try {\n      const data = await apiPost<KeywordForSite[]>(\"/api/research/keywords-for-site\", {\n        target,\n        location,\n        language,\n        sort,\n        type,\n        limit,\n        skipCache,\n      });\n\n      warnDefaults(queryContext);\n      const format = (args.output as string) || \"json\";\n      const hints = keywordsForSiteHints(data.length, queryContext, type);\n      if (format !== \"json\") {\n        writeResearchOutput(data as unknown as Array<Record<string, unknown>>, format);\n        writeResearchHints(hints, format);\n        return;\n      }\n      writeResearchJson({\n        ok: true,\n        data,\n        fields: FIELDS,\n        note: RESEARCH_DATA_NOTE,\n        query_context: queryContext,\n        hints,\n      });\n    } catch (err) {\n      handleResearchError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAa9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,QAAQ,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,KAAK;AAAA,IAC/F,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,IACZ;AAAA,IACA,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,MAAM,EAAE,MAAM,UAAU,aAAa,6CAA6C,UAAU,MAAM;AAAA,IAClG,OAAO,EAAE,MAAM,UAAU,aAAa,wCAAwC,UAAU,MAAM;AAAA,IAC9F,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AACF,CAAC;AAUD,IAAM,SAAiC;AAAA,EACrC,SAAS;AAAA,EACT,eAAe;AAAA,EACf,KAAK;AAAA,EACL,aAAa;AAAA,EACb,mBAAmB;AACrB;AAEO,IAAM,yBAAyB,cAAc;AAAA,EAClD,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf;AAAA,EACA,MAAM;AAAA,IACJ,QAAQ,EAAE,MAAM,cAAc,aAAa,4BAA4B,UAAU,KAAK;AAAA,IACtF,UAAU,EAAE,MAAM,UAAU,aAAa,+CAA+C,UAAU,MAAM;AAAA,IACxG,UAAU,EAAE,MAAM,UAAU,aAAa,uCAAuC,UAAU,MAAM;AAAA,IAChG,MAAM,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IAC9F,MAAM,EAAE,MAAM,UAAU,aAAa,6CAA6C,UAAU,MAAM;AAAA,IAClG,OAAO,EAAE,MAAM,UAAU,aAAa,wCAAwC,UAAU,MAAM;AAAA,IAC9F,QAAQ,EAAE,MAAM,UAAU,aAAa,6BAA6B,UAAU,OAAO,SAAS,OAAO;AAAA,IACrG,YAAY,EAAE,MAAM,WAAW,aAAa,uCAAuC,UAAU,MAAM;AAAA,EACrG;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,KAAK;AACpB,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,WAAY,KAAK,YAAuB;AAC9C,UAAM,OAAQ,KAAK,QAAmB;AACtC,UAAM,OAAQ,KAAK,QAAmB;AACtC,UAAM,QAAQ,KAAK,QAAQ,OAAO,KAAK,KAAK,IAAI;AAChD,UAAM,YAAY,KAAK,UAAU,IAAI,OAAO;AAC5C,UAAM,eAAe,0BAA0B,UAAU,QAAQ;AAEjE,QAAI;AACF,YAAM,OAAO,MAAM,QAA0B,mCAAmC;AAAA,QAC9E;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAED,mBAAa,YAAY;AACzB,YAAM,SAAU,KAAK,UAAqB;AAC1C,YAAM,QAAQ,qBAAqB,KAAK,QAAQ,cAAc,IAAI;AAClE,UAAI,WAAW,QAAQ;AACrB,4BAAoB,MAAmD,MAAM;AAC7E,2BAAmB,OAAO,MAAM;AAChC;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,eAAe;AAAA,QACf;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/landing-4PA7GCPM.js

@@ -0,0 +1,28 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/index.ts
+import { defineCommand } from "citty";
+var landingCommand = defineCommand({
+  meta: {
+    name: "landing",
+    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.
+
+Start here: \`baker landing critique <slug>\` after building or editing a landing.
+
+Subcommands:
+  baker landing inspiration      \u2014 reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.
+  baker landing variant <control> <slug> \u2014 the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \`baker experiment plan\` first.
+  baker landing critique <slug>   \u2014 design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and positioning integrity (copy ranking a competitor above the client), tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires \u2014 run it before finishing a landing.
+  baker landing export start      \u2014 download the PUBLISHED landings as a ZIP of plain HTML ("download my landings", "send me the HTML"); \`baker landing export status <id>\` gives the link.`
+  },
+  subCommands: {
+    inspiration: () => import("./inspiration-I4MMKAWA.js").then((m) => m.inspirationCommand),
+    critique: () => import("./critique-CMLAPVUB.js").then((m) => m.critiqueCommand),
+    variant: () => import("./variant-FLZJYGYL.js").then((m) => m.variantCommand),
+    export: () => import("./export-JQRMBJ7D.js").then((m) => m.exportCommand)
+  }
+});
+export {
+  landingCommand
+};
+//# sourceMappingURL=landing-4PA7GCPM.js.map

package/dist/landing-4PA7GCPM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/landing/index.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\n\nexport const landingCommand = defineCommand({\n  meta: {\n    name: \"landing\",\n    description: `Design-quality tools for landing pages (src/pages/<slug>/), and downloading the published ones.\n\nStart here: \\`baker landing critique <slug>\\` after building or editing a landing.\n\nSubcommands:\n  baker landing inspiration      — reference library of real landing-page sections; search it during research, BEFORE writing the Direction Contract. Inspiration only: take the mechanism, never the words.\n  baker landing variant <control> <slug> — the alternative version of a page for an A/B test: shares the control's sections, forks only the component you name, so the two arms differ by exactly your hypothesis. Run \\`baker experiment plan\\` first.\n  baker landing critique <slug>   — design-quality critic (advisory): flags the known AI 'slop' tells (gradient text, overused fonts, side-tab borders, cream palettes, broken images) and reads the copy in any language for buzzwords, AI copy tells and positioning integrity (copy ranking a competitor above the client), tiered block/warn/advisory, respecting the client's brand. Records the critique the publish quality gate requires — run it before finishing a landing.\n  baker landing export start      — download the PUBLISHED landings as a ZIP of plain HTML (\"download my landings\", \"send me the HTML\"); \\`baker landing export status <id>\\` gives the link.`,\n  },\n  subCommands: {\n    inspiration: () => import(\"./inspiration/index.ts\").then((m) => m.inspirationCommand),\n    critique: () => import(\"./critique.ts\").then((m) => m.critiqueCommand),\n    variant: () => import(\"./variant.ts\").then((m) => m.variantCommand),\n    export: () => import(\"./export.ts\").then((m) => m.exportCommand),\n  },\n});\n"],"mappings":";;;AAAA,SAAS,qBAAqB;AAEvB,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASf;AAAA,EACA,aAAa;AAAA,IACX,aAAa,MAAM,OAAO,2BAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;AAAA,IACpF,UAAU,MAAM,OAAO,wBAAe,EAAE,KAAK,CAAC,MAAM,EAAE,eAAe;AAAA,IACrE,SAAS,MAAM,OAAO,uBAAc,EAAE,KAAK,CAAC,MAAM,EAAE,cAAc;AAAA,IAClE,QAAQ,MAAM,OAAO,sBAAa,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa;AAAA,EACjE;AACF,CAAC;","names":[]}

package/dist/languages-JDYL2N5F.js

@@ -0,0 +1,40 @@
+import {
+  GOOGLE_ADS_LANGUAGES
+} from "./chunk-2SCPDSFN.js";
+import "./chunk-EVYXTT7V.js";
+import {
+  writeAdsJson
+} from "./chunk-VFIOJD5M.js";
+import "./chunk-XML7AJM3.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/languages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.languages",
+  description: "List all supported language IDs for --language flag in Google Ads keyword commands.",
+  args: {}
+});
+var FIELDS = {
+  id: "Language ID to pass as --language",
+  name: "Language name"
+};
+var languagesCommand = defineCommand({
+  meta: {
+    name: "languages",
+    description: "List all supported language IDs for --language flag."
+  },
+  run: () => {
+    writeAdsJson({ ok: true, data: GOOGLE_ADS_LANGUAGES, fields: FIELDS });
+  }
+});
+export {
+  languagesCommand
+};
+//# sourceMappingURL=languages-JDYL2N5F.js.map

package/dist/languages-JDYL2N5F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/keywords/languages.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { GOOGLE_ADS_LANGUAGES } from \"../../../../geo-context.ts\";\nimport { registerSchema } from \"../../../../schemas.ts\";\nimport { writeAdsJson } from \"../../output.ts\";\n\nregisterSchema({\n  command: \"ads.google.keywords.languages\",\n  description: \"List all supported language IDs for --language flag in Google Ads keyword commands.\",\n  args: {},\n});\n\nconst FIELDS: Record<string, string> = {\n  id: \"Language ID to pass as --language\",\n  name: \"Language name\",\n};\n\nexport const languagesCommand = defineCommand({\n  meta: {\n    name: \"languages\",\n    description: \"List all supported language IDs for --language flag.\",\n  },\n  run: () => {\n    writeAdsJson({ ok: true, data: GOOGLE_ADS_LANGUAGES, fields: FIELDS });\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAK9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,CAAC;AACT,CAAC;AAED,IAAM,SAAiC;AAAA,EACrC,IAAI;AAAA,EACJ,MAAM;AACR;AAEO,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,KAAK,MAAM;AACT,iBAAa,EAAE,IAAI,MAAM,MAAM,sBAAsB,QAAQ,OAAO,CAAC;AAAA,EACvE;AACF,CAAC;","names":[]}

package/dist/languages-JMVNOHMG.js

@@ -0,0 +1,55 @@
+import {
+  writeResearchJson
+} from "./chunk-TBEUMOEL.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/languages.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.languages",
+  description: "List all supported language codes for --language flag in research commands.",
+  args: {}
+});
+var LANGUAGES = [
+  { code: "en", name: "english" },
+  { code: "es", name: "spanish" },
+  { code: "fr", name: "french" },
+  { code: "de", name: "german" },
+  { code: "it", name: "italian" },
+  { code: "pt", name: "portuguese" },
+  { code: "nl", name: "dutch" },
+  { code: "ja", name: "japanese" },
+  { code: "ko", name: "korean" },
+  { code: "zh", name: "chinese" },
+  { code: "ar", name: "arabic" },
+  { code: "ru", name: "russian" },
+  { code: "pl", name: "polish" },
+  { code: "tr", name: "turkish" },
+  { code: "sv", name: "swedish" },
+  { code: "no", name: "norwegian" },
+  { code: "da", name: "danish" },
+  { code: "fi", name: "finnish" }
+];
+var FIELDS = {
+  code: "Language code to pass as --language",
+  name: "Language name (also accepted by --language)"
+};
+var languagesCommand = defineCommand({
+  meta: {
+    name: "languages",
+    description: "List all supported language codes for --language flag."
+  },
+  run: () => {
+    writeResearchJson({ ok: true, data: LANGUAGES, fields: FIELDS });
+  }
+});
+export {
+  languagesCommand
+};
+//# sourceMappingURL=languages-JMVNOHMG.js.map

package/dist/languages-JMVNOHMG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/languages.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { writeResearchJson } from \"./output.ts\";\n\nregisterSchema({\n  command: \"research.languages\",\n  description: \"List all supported language codes for --language flag in research commands.\",\n  args: {},\n});\n\nconst LANGUAGES: Array<{ code: string; name: string }> = [\n  { code: \"en\", name: \"english\" },\n  { code: \"es\", name: \"spanish\" },\n  { code: \"fr\", name: \"french\" },\n  { code: \"de\", name: \"german\" },\n  { code: \"it\", name: \"italian\" },\n  { code: \"pt\", name: \"portuguese\" },\n  { code: \"nl\", name: \"dutch\" },\n  { code: \"ja\", name: \"japanese\" },\n  { code: \"ko\", name: \"korean\" },\n  { code: \"zh\", name: \"chinese\" },\n  { code: \"ar\", name: \"arabic\" },\n  { code: \"ru\", name: \"russian\" },\n  { code: \"pl\", name: \"polish\" },\n  { code: \"tr\", name: \"turkish\" },\n  { code: \"sv\", name: \"swedish\" },\n  { code: \"no\", name: \"norwegian\" },\n  { code: \"da\", name: \"danish\" },\n  { code: \"fi\", name: \"finnish\" },\n];\n\nconst FIELDS: Record<string, string> = {\n  code: \"Language code to pass as --language\",\n  name: \"Language name (also accepted by --language)\",\n};\n\nexport const languagesCommand = defineCommand({\n  meta: {\n    name: \"languages\",\n    description: \"List all supported language codes for --language flag.\",\n  },\n  run: () => {\n    writeResearchJson({ ok: true, data: LANGUAGES, fields: FIELDS });\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAI9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,CAAC;AACT,CAAC;AAED,IAAM,YAAmD;AAAA,EACvD,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,aAAa;AAAA,EACjC,EAAE,MAAM,MAAM,MAAM,QAAQ;AAAA,EAC5B,EAAE,MAAM,MAAM,MAAM,WAAW;AAAA,EAC/B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,EAC9B,EAAE,MAAM,MAAM,MAAM,YAAY;AAAA,EAChC,EAAE,MAAM,MAAM,MAAM,SAAS;AAAA,EAC7B,EAAE,MAAM,MAAM,MAAM,UAAU;AAChC;AAEA,IAAM,SAAiC;AAAA,EACrC,MAAM;AAAA,EACN,MAAM;AACR;AAEO,IAAM,mBAAmB,cAAc;AAAA,EAC5C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA,KAAK,MAAM;AACT,sBAAkB,EAAE,IAAI,MAAM,MAAM,WAAW,QAAQ,OAAO,CAAC;AAAA,EACjE;AACF,CAAC;","names":[]}

package/dist/layerize-RPD6SNP6.js

@@ -0,0 +1,190 @@
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/layerize.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.layerize",
+  description: "Split a library image into editable layers: transparent PNG cutouts for each element, plus any headline recovered as EDITABLE TEXT with its font, size, colour and position. Waits for completion by default. Costs credits.",
+  args: {
+    "image-id": { type: "string", description: "Library image ID to split", required: true },
+    instructions: {
+      type: "string",
+      description: "Optional steer for what to separate, e.g. 'keep the bottle and its shadow as one layer'",
+      required: false
+    },
+    full: { type: "boolean", description: "Include geometry and typography for every layer", required: false },
+    "max-wait": {
+      type: "number",
+      description: "Max wait ms (default 240000 = 4 min). Set 0 to fire-and-forget.",
+      required: false,
+      default: 24e4
+    }
+  }
+});
+var POLL_INTERVAL_MS = 4e3;
+function compact(doc) {
+  return {
+    layeredImageId: doc.layeredImageId,
+    imageId: doc.imageId,
+    status: doc.status,
+    canvas: { width: doc.width, height: doc.height },
+    layers: doc.layers.map((layer) => ({
+      id: layer.id,
+      kind: layer.kind,
+      name: layer.name,
+      ...layer.url ? { url: layer.url } : {},
+      ...layer.text ? { text: layer.text.content } : {}
+    }))
+  };
+}
+function hintsFor(doc) {
+  const hints = [];
+  const text = doc.layers.filter((layer) => layer.kind === "text");
+  const art = doc.layers.filter((layer) => layer.kind === "art" && layer.id !== "layer-base");
+  if (text.length > 0) {
+    hints.push(
+      `${text.length} text layer(s) recovered as editable copy \u2014 run with --full for the font, size and colour to reuse when rewriting it.`
+    );
+  }
+  if (art.length > 0) {
+    hints.push(
+      `Each art layer's url is a transparent PNG on the media host: wire one straight into a canvas composition to reuse that element on its own.`
+    );
+  }
+  hints.push(
+    '"Original image" is the flat picture kept underneath. The model separates what was VISIBLE and does not repaint what sat behind a subject, so moving one can leave a gap.'
+  );
+  return hints;
+}
+async function pollUntilSettled(imageId, maxWait) {
+  const start = Date.now();
+  while (Date.now() - start < maxWait) {
+    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+    const doc = await apiGet("/api/images/layers", { imageId });
+    if (doc.status !== "splitting") return doc;
+  }
+  return null;
+}
+var layerizeCommand = defineCommand({
+  meta: {
+    name: "layerize",
+    description: "Split a library image into editable layers \u2014 transparent cutouts per element, plus any baked-in headline recovered as editable text with its typography.\n\nStart here: baker images layerize j571abc123def\nExample: baker images layerize j571abc123def --full\nExample: baker images layerize j571abc123def --instructions 'keep the product and its shadow together'"
+  },
+  args: {
+    "image-id": { type: "positional", description: "Library image ID", required: false },
+    instructions: { type: "string", description: "Optional steer for what to separate", required: false },
+    full: { type: "boolean", description: "Include geometry and typography", required: false },
+    "max-wait": { type: "string", description: "Max wait ms (default 240000, 0 = no wait)", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const imageId = args["image-id"];
+      if (!imageId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "image-id is required" } });
+        process.exit(1);
+      }
+      const maxWait = args["max-wait"] ? Number(args["max-wait"]) : 24e4;
+      const full = Boolean(args.full);
+      const started = await apiPost("/api/images/layerize", {
+        imageId,
+        instructions: args.instructions
+      });
+      const settled = maxWait === 0 || started.status !== "splitting" ? started : await pollUntilSettled(imageId, maxWait);
+      if (!settled) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "TIMEOUT",
+            message: `Layers not ready within ${maxWait}ms`,
+            fix: `The split is still running. Read it later with: baker images layers ${imageId}`
+          }
+        });
+        process.exit(1);
+      }
+      if (settled.status === "failed") {
+        writeJson({
+          ok: false,
+          error: {
+            code: "IMAGE_PROCESSING_ERROR",
+            message: settled.error ?? "That image couldn't be split into layers",
+            fix: "Run the same command again \u2014 this provider rejects a valid request intermittently. If it fails twice more, carry on without layers."
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({ ok: true, data: full ? settled : compact(settled), hints: hintsFor(settled) });
+    } catch (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: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+registerSchema({
+  command: "images.layers",
+  description: "Read the layers of an image already split with `images layerize` \u2014 free, no provider call. Use it to see what an ad says and what its pieces are.",
+  args: {
+    "image-id": { type: "string", description: "Library image ID", required: true },
+    full: { type: "boolean", description: "Include geometry and typography for every layer", required: false }
+  }
+});
+var layersCommand = defineCommand({
+  meta: {
+    name: "layers",
+    description: "Read the layers of an image that has already been split. Free \u2014 no provider call.\n\nStart here: baker images layers j571abc123def\nExample: baker images layers j571abc123def --full"
+  },
+  args: {
+    "image-id": { type: "positional", description: "Library image ID", required: false },
+    full: { type: "boolean", description: "Include geometry and typography", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const imageId = args["image-id"];
+      if (!imageId) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "image-id is required" } });
+        process.exit(1);
+      }
+      const doc = await apiGet("/api/images/layers", { imageId });
+      writeJson({ ok: true, data: args.full ? doc : compact(doc), hints: hintsFor(doc) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({
+          ok: false,
+          error: {
+            code: err.code,
+            message: err.message,
+            ...err.code === "NOT_FOUND" ? { fix: `Split it first: baker images layerize ${args["image-id"]}` } : {}
+          }
+        });
+        process.exit(1);
+      }
+      writeJson({
+        ok: false,
+        error: { code: "INTERNAL_ERROR", message: err instanceof Error ? err.message : "Unexpected error" }
+      });
+      process.exit(1);
+    }
+  }
+});
+export {
+  layerizeCommand,
+  layersCommand
+};
+//# sourceMappingURL=layerize-RPD6SNP6.js.map

package/dist/layerize-RPD6SNP6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/layerize.ts"],"sourcesContent":["import type { ImagesLayersResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\n\nregisterSchema({\n  command: \"images.layerize\",\n  description:\n    \"Split a library image into editable layers: transparent PNG cutouts for each element, plus any headline recovered as EDITABLE TEXT with its font, size, colour and position. Waits for completion by default. Costs credits.\",\n  args: {\n    \"image-id\": { type: \"string\", description: \"Library image ID to split\", required: true },\n    instructions: {\n      type: \"string\",\n      description: \"Optional steer for what to separate, e.g. 'keep the bottle and its shadow as one layer'\",\n      required: false,\n    },\n    full: { type: \"boolean\", description: \"Include geometry and typography for every layer\", required: false },\n    \"max-wait\": {\n      type: \"number\",\n      description: \"Max wait ms (default 240000 = 4 min). Set 0 to fire-and-forget.\",\n      required: false,\n      default: 240000,\n    },\n  },\n});\n\nconst POLL_INTERVAL_MS = 4000;\n\n/**\n * What the agent sees by default.\n *\n * Compact means: what each layer IS, and — for copy — what it says. The art\n * URLs are in even at this level because they are the reusable thing: a\n * transparent cutout of the product is exactly what gets wired into a canvas\n * composition next. Geometry and typography sit behind `--full`, since those\n * only matter once you are placing a layer rather than choosing one.\n */\nfunction compact(doc: ImagesLayersResponse) {\n  return {\n    layeredImageId: doc.layeredImageId,\n    imageId: doc.imageId,\n    status: doc.status,\n    canvas: { width: doc.width, height: doc.height },\n    layers: doc.layers.map((layer) => ({\n      id: layer.id,\n      kind: layer.kind,\n      name: layer.name,\n      ...(layer.url ? { url: layer.url } : {}),\n      ...(layer.text ? { text: layer.text.content } : {}),\n    })),\n  };\n}\n\nfunction hintsFor(doc: ImagesLayersResponse): string[] {\n  const hints: string[] = [];\n  const text = doc.layers.filter((layer) => layer.kind === \"text\");\n  const art = doc.layers.filter((layer) => layer.kind === \"art\" && layer.id !== \"layer-base\");\n\n  if (text.length > 0) {\n    hints.push(\n      `${text.length} text layer(s) recovered as editable copy — run with --full for the font, size and colour to reuse when rewriting it.`,\n    );\n  }\n  if (art.length > 0) {\n    hints.push(\n      `Each art layer's url is a transparent PNG on the media host: wire one straight into a canvas composition to reuse that element on its own.`,\n    );\n  }\n  // Said every time, because it is the limit that makes a result look broken.\n  hints.push(\n    '\"Original image\" is the flat picture kept underneath. The model separates what was VISIBLE and does not repaint what sat behind a subject, so moving one can leave a gap.',\n  );\n  return hints;\n}\n\n/** Poll until the split stops being `splitting`, or the budget runs out. */\nasync function pollUntilSettled(imageId: string, maxWait: number): Promise<ImagesLayersResponse | null> {\n  const start = Date.now();\n  while (Date.now() - start < maxWait) {\n    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));\n    const doc = await apiGet<ImagesLayersResponse>(\"/api/images/layers\", { imageId });\n    if (doc.status !== \"splitting\") return doc;\n  }\n  return null;\n}\n\nexport const layerizeCommand = defineCommand({\n  meta: {\n    name: \"layerize\",\n    description:\n      \"Split a library image into editable layers — transparent cutouts per element, plus any baked-in headline recovered as editable text with its typography.\\n\\nStart here: baker images layerize j571abc123def\\nExample: baker images layerize j571abc123def --full\\nExample: baker images layerize j571abc123def --instructions 'keep the product and its shadow together'\",\n  },\n  args: {\n    \"image-id\": { type: \"positional\", description: \"Library image ID\", required: false },\n    instructions: { type: \"string\", description: \"Optional steer for what to separate\", required: false },\n    full: { type: \"boolean\", description: \"Include geometry and typography\", required: false },\n    \"max-wait\": { type: \"string\", description: \"Max wait ms (default 240000, 0 = no wait)\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const imageId = args[\"image-id\"] as string | undefined;\n      if (!imageId) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"image-id is required\" } });\n        process.exit(1);\n      }\n      const maxWait = args[\"max-wait\"] ? Number(args[\"max-wait\"]) : 240000;\n      const full = Boolean(args.full);\n\n      const started = await apiPost<ImagesLayersResponse>(\"/api/images/layerize\", {\n        imageId,\n        instructions: args.instructions as string | undefined,\n      });\n\n      const settled =\n        maxWait === 0 || started.status !== \"splitting\" ? started : await pollUntilSettled(imageId, maxWait);\n\n      if (!settled) {\n        writeJson({\n          ok: false,\n          error: {\n            code: \"TIMEOUT\",\n            message: `Layers not ready within ${maxWait}ms`,\n            fix: `The split is still running. Read it later with: baker images layers ${imageId}`,\n          },\n        });\n        process.exit(1);\n      }\n      if (settled.status === \"failed\") {\n        // Degrade, don't abort: the split is one step of a bigger job, and the\n        // provider rejects a valid request often enough that \"try again\" is\n        // usually the right next move rather than giving up on the whole task.\n        writeJson({\n          ok: false,\n          error: {\n            code: \"IMAGE_PROCESSING_ERROR\",\n            message: settled.error ?? \"That image couldn't be split into layers\",\n            fix: \"Run the same command again — this provider rejects a valid request intermittently. If it fails twice more, carry on without layers.\",\n          },\n        });\n        process.exit(1);\n      }\n\n      writeJson({ ok: true, data: full ? settled : compact(settled), hints: hintsFor(settled) });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({ ok: false, error: { code: err.code, message: err.message } });\n        process.exit(1);\n      }\n      writeJson({\n        ok: false,\n        error: { code: \"INTERNAL_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n      });\n      process.exit(1);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"images.layers\",\n  description:\n    \"Read the layers of an image already split with `images layerize` — free, no provider call. Use it to see what an ad says and what its pieces are.\",\n  args: {\n    \"image-id\": { type: \"string\", description: \"Library image ID\", required: true },\n    full: { type: \"boolean\", description: \"Include geometry and typography for every layer\", required: false },\n  },\n});\n\nexport const layersCommand = defineCommand({\n  meta: {\n    name: \"layers\",\n    description:\n      \"Read the layers of an image that has already been split. Free — no provider call.\\n\\nStart here: baker images layers j571abc123def\\nExample: baker images layers j571abc123def --full\",\n  },\n  args: {\n    \"image-id\": { type: \"positional\", description: \"Library image ID\", required: false },\n    full: { type: \"boolean\", description: \"Include geometry and typography\", required: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const imageId = args[\"image-id\"] as string | undefined;\n      if (!imageId) {\n        writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: \"image-id is required\" } });\n        process.exit(1);\n      }\n\n      const doc = await apiGet<ImagesLayersResponse>(\"/api/images/layers\", { imageId });\n      writeJson({ ok: true, data: args.full ? doc : compact(doc), hints: hintsFor(doc) });\n    } catch (err) {\n      if (err instanceof ApiError) {\n        writeJson({\n          ok: false,\n          error: {\n            code: err.code,\n            message: err.message,\n            ...(err.code === \"NOT_FOUND\" ? { fix: `Split it first: baker images layerize ${args[\"image-id\"]}` } : {}),\n          },\n        });\n        process.exit(1);\n      }\n      writeJson({\n        ok: false,\n        error: { code: \"INTERNAL_ERROR\", message: err instanceof Error ? err.message : \"Unexpected error\" },\n      });\n      process.exit(1);\n    }\n  },\n});\n"],"mappings":"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","names":[]}