@koda-sl/baker-cli 0.498.0 → 0.500.0

package/dist/insights-UKWLUS5P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/insights.ts"],"sourcesContent":["import {\n  CHATGPT_ADS_GRANULARITIES,\n  CHATGPT_ADS_LEVELS,\n  CHATGPT_ADS_METRICS,\n  CHATGPT_ADS_SEGMENTS,\n  type ChatgptAdsInsightsRequest,\n  type ChatgptAdsInsightsResponse,\n  chatgptAdsInsightsRequestSchema,\n} from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { syncedFirstHint } from \"../synced-first.ts\";\nimport { CHATGPT_ADS_REFERENCE, insightsRequestFromArgs, runChatgptRead } from \"./shared.ts\";\n\nconst args = {\n  level: {\n    type: \"string\",\n    description: `What one row is: ${CHATGPT_ADS_LEVELS.join(\"|\")} (default campaign)`,\n    required: false,\n  },\n  \"campaign-id\": { type: \"string\", description: \"Report on one campaign (cmpn_…)\", required: false },\n  \"ad-group-id\": { type: \"string\", description: \"Report on one ad group (adgrp_…)\", required: false },\n  \"ad-id\": { type: \"string\", description: \"Report on one ad (ad_…)\", required: false },\n  days: {\n    type: \"string\",\n    description: \"Last N complete days, ending the account's yesterday (default 7)\",\n    required: false,\n  },\n  since: {\n    type: \"string\",\n    description: \"First day, YYYY-MM-DD, account timezone (instead of --days)\",\n    required: false,\n  },\n  until: { type: \"string\", description: \"Last day, inclusive, YYYY-MM-DD\", required: false },\n  granularity: {\n    type: \"string\",\n    description: `${CHATGPT_ADS_GRANULARITIES.join(\"|\")} (default none: one total per row)`,\n    required: false,\n  },\n  segment: {\n    type: \"string\",\n    description: `Break rows down by one of ${CHATGPT_ADS_SEGMENTS.join(\"|\")}`,\n    required: false,\n  },\n  metrics: {\n    type: \"string\",\n    description: `CSV of ${CHATGPT_ADS_METRICS.join(\",\")} (default impressions,clicks,spend,ctr,cpc,conversions,cpa)`,\n    required: false,\n  },\n  sort: { type: \"string\", description: \"Metric to rank rows by, highest first\", required: false },\n  limit: { type: \"string\", description: \"Rows, 1-2000 (default 200)\", required: false },\n} as const;\n\nregisterSchema({\n  command: \"ads.chatgpt.insights\",\n  description:\n    \"Performance of the connected ChatGPT Ads account: impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, attributed sales and ROAS, per account, campaign, ad group or ad, over a window, optionally per day and broken down by country, device, platform or product. Spend and costs are in the account currency; null means not reported, not zero.\",\n  args,\n});\n\nfunction insightsHints(report: ChatgptAdsInsightsResponse): string[] {\n  const hints: string[] = [];\n  if (report.rows.length === 0) {\n    hints.push(\n      \"No delivery in this window. Check `baker ads chatgpt campaigns` for serving issues before concluding the ads do not work.\",\n    );\n  }\n  if (report.truncated) {\n    hints.push(\"More rows matched than --limit allowed. Narrow the report or raise --limit (max 2000).\");\n  }\n  hints.push(\n    \"Conversions come from ChatGPT Ads' own pixel or Conversions API and take at least a day to appear; the most recent days are still filling in.\",\n  );\n  return hints;\n}\n\n/** Baker's synced copy holds ChatGPT rows, never their segments: a segmented read gets no synced-first hint. */\nexport function chatgptInsightsHints(report: ChatgptAdsInsightsResponse, request: ChatgptAdsInsightsRequest): string[] {\n  const hints = insightsHints(report);\n  return request.segment ? hints : [...hints, syncedFirstHint(\"chatgpt\", request.level)];\n}\n\nexport const insightsCommand = defineCommand({\n  meta: {\n    name: \"insights\",\n    description: `How a ChatGPT Ads account performs. Start here for \"how are the ChatGPT campaigns doing\".\n\nExamples:\n  baker ads chatgpt insights                                          # last 7 days, one row per campaign\n  baker ads chatgpt insights --days 30 --granularity daily --level account\n  baker ads chatgpt insights --campaign-id cmpn_123 --level ad --sort spend\n  baker ads chatgpt insights --segment country --metrics spend,clicks,conversions\n  baker ads chatgpt insights --since 2026-09-01 --until 2026-09-07 --metrics spend,order_created_roas`,\n  },\n  args,\n  run: async ({ args: input }) => {\n    const parsed = chatgptAdsInsightsRequestSchema.safeParse(insightsRequestFromArgs(input));\n    if (!parsed.success) {\n      const message = parsed.error.issues[0]?.message ?? \"Invalid report request\";\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message,\n          fix: { action: \"retry_with_modified_query\", explanation: message },\n          retryable: false,\n        },\n      });\n      process.exit(1);\n    }\n    await runChatgptRead(\n      CHATGPT_ADS_REFERENCE.insights,\n      () => apiPost<ChatgptAdsInsightsResponse>(\"/api/ads/chatgpt/insights\", parsed.data),\n      (report) => chatgptInsightsHints(report, parsed.data),\n    );\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,SAAS,qBAAqB;AAO9B,IAAM,OAAO;AAAA,EACX,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa,oBAAoB,mBAAmB,KAAK,GAAG,CAAC;AAAA,IAC7D,UAAU;AAAA,EACZ;AAAA,EACA,eAAe,EAAE,MAAM,UAAU,aAAa,wCAAmC,UAAU,MAAM;AAAA,EACjG,eAAe,EAAE,MAAM,UAAU,aAAa,yCAAoC,UAAU,MAAM;AAAA,EAClG,SAAS,EAAE,MAAM,UAAU,aAAa,gCAA2B,UAAU,MAAM;AAAA,EACnF,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,EACZ;AAAA,EACA,OAAO,EAAE,MAAM,UAAU,aAAa,mCAAmC,UAAU,MAAM;AAAA,EACzF,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa,GAAG,0BAA0B,KAAK,GAAG,CAAC;AAAA,IACnD,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa,6BAA6B,qBAAqB,KAAK,GAAG,CAAC;AAAA,IACxE,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa,UAAU,oBAAoB,KAAK,GAAG,CAAC;AAAA,IACpD,UAAU;AAAA,EACZ;AAAA,EACA,MAAM,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,EAC9F,OAAO,EAAE,MAAM,UAAU,aAAa,8BAA8B,UAAU,MAAM;AACtF;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF;AACF,CAAC;AAED,SAAS,cAAc,QAA8C;AACnE,QAAM,QAAkB,CAAC;AACzB,MAAI,OAAO,KAAK,WAAW,GAAG;AAC5B,UAAM;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,WAAW;AACpB,UAAM,KAAK,wFAAwF;AAAA,EACrG;AACA,QAAM;AAAA,IACJ;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,qBAAqB,QAAoC,SAA8C;AACrH,QAAM,QAAQ,cAAc,MAAM;AAClC,SAAO,QAAQ,UAAU,QAAQ,CAAC,GAAG,OAAO,gBAAgB,WAAW,QAAQ,KAAK,CAAC;AACvF;AAEO,IAAM,kBAAkB,cAAc;AAAA,EAC3C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQf;AAAA,EACA;AAAA,EACA,KAAK,OAAO,EAAE,MAAM,MAAM,MAAM;AAC9B,UAAM,SAAS,gCAAgC,UAAU,wBAAwB,KAAK,CAAC;AACvF,QAAI,CAAC,OAAO,SAAS;AACnB,YAAM,UAAU,OAAO,MAAM,OAAO,CAAC,GAAG,WAAW;AACnD,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,OAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,KAAK,EAAE,QAAQ,6BAA6B,aAAa,QAAQ;AAAA,UACjE,WAAW;AAAA,QACb;AAAA,MACF,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM;AAAA,MACJ,sBAAsB;AAAA,MACtB,MAAM,QAAoC,6BAA6B,OAAO,IAAI;AAAA,MAClF,CAAC,WAAW,qBAAqB,QAAQ,OAAO,IAAI;AAAA,IACtD;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/inspect-RVU5RDCE.js

@@ -0,0 +1,190 @@
+import {
+  fetchRunRecord
+} from "./chunk-GTNNH3AI.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-EJGAJHLB.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.js";
+import {
+  ApiError
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/canvas/inspect.ts
+import { execFile } from "child_process";
+import { readdir, readFile, stat } from "fs/promises";
+import path from "path";
+import { promisify } from "util";
+import { defineCommand } from "citty";
+var execFileAsync = promisify(execFile);
+var inspectCommand = defineCommand({
+  meta: {
+    name: "inspect",
+    description: "Dump a one-page summary of a canvas run: per-node duration + cache status, the run's outputs, and optionally three thumbnail frames per video output. Pass a run_id (r_\u2026) or an absolute run directory. A run whose folder is not in this workspace (an older version, or one rendered in another chat) is read from the company's run history instead: its status, stats, per-node results and the durable URL of every output."
+  },
+  args: {
+    run: { type: "positional", required: true, description: "Run id (e.g. r_01K...) or absolute run directory" },
+    "outputs-dir": { type: "string", description: "Per-run outputs root (default <workspace root>/canvas, where `canvas run` writes)" },
+    thumbnails: {
+      type: "boolean",
+      description: "Extract start/middle/end frames from every video output in the local run folder (requires ffmpeg)"
+    }
+  },
+  async run({ args }) {
+    const cwd = process.cwd();
+    const outputsDir = args["outputs-dir"] ? path.resolve(String(args["outputs-dir"])) : path.join(findWorkspaceRoot(cwd) ?? cwd, "canvas");
+    const runArg = String(args.run);
+    const runDir = await localRunDir(runArg, outputsDir);
+    if (!runDir) {
+      if (path.isAbsolute(runArg)) fail("not_found", `${runArg} is not a run directory`);
+      await inspectFromHistory(runArg, path.join(outputsDir, runArg));
+      return;
+    }
+    const manifest = await loadManifest(runDir);
+    const files = await listRunFiles(runDir);
+    const videos = files.filter((f) => isVideoFile(f.path));
+    let thumbnails = [];
+    if (args.thumbnails) {
+      thumbnails = await extractThumbnails(videos.map((v) => v.path));
+    }
+    const summary = {
+      ok: true,
+      source: "local",
+      run_id: manifest.run_id ?? path.basename(runDir),
+      run_dir: runDir,
+      stats: manifest.stats ?? null,
+      output: manifest.output ?? null,
+      node_runs: manifest.node_runs ?? [],
+      files: files.map((f) => ({ name: f.name, path: f.path, size_bytes: f.size })),
+      thumbnails
+    };
+    process.stdout.write(`${JSON.stringify(summary, null, 2)}
+`);
+  }
+});
+async function localRunDir(run, outputsDir) {
+  const candidate = path.isAbsolute(run) ? run : path.join(outputsDir, run);
+  const s = await stat(candidate).catch(() => null);
+  return s?.isDirectory() ? candidate : null;
+}
+async function inspectFromHistory(runId, expectedDir) {
+  let run;
+  try {
+    run = await fetchRunRecord(runId);
+  } catch (e) {
+    const reason = e instanceof ApiError ? e.message : e instanceof Error ? e.message : String(e);
+    fail("unavailable", `No run folder at ${expectedDir}, and the run history could not be read (${reason}).`);
+  }
+  if (!run) {
+    fail(
+      "not_found",
+      `No run "${runId}": there is no folder at ${expectedDir} and the company's run history has no run by that id.`
+    );
+  }
+  const summary = {
+    ok: true,
+    source: "run_history",
+    run_id: run.runId,
+    creative: run.creativeSlug ?? null,
+    status: run.status,
+    ...run.errorMessage ? { error: run.errorMessage } : {},
+    stats: {
+      total_nodes: run.stats.totalNodes,
+      cached_nodes: run.stats.cachedNodes,
+      total_credits: run.stats.totalCredits,
+      duration_ms: run.stats.durationMs
+    },
+    outputs: run.finalOutputs,
+    node_runs: run.nodes.map((node) => ({
+      node_id: node.nodeId,
+      node_type: node.nodeType,
+      cached: node.cached,
+      duration_ms: node.durationMs,
+      credits: node.credits,
+      ...node.status ? { status: node.status } : {},
+      outputs: node.outputs
+    })),
+    ...run.review ? { review: run.review } : {},
+    hints: [
+      "This run's folder is not in this workspace, so there are no local files: every output above is a durable URL. To render it again here, run `baker canvas run --slug <creative>`."
+    ]
+  };
+  process.stdout.write(`${JSON.stringify(summary, null, 2)}
+`);
+}
+function fail(code, message) {
+  process.stderr.write(`${JSON.stringify({ ok: false, error: { code, message } }, null, 2)}
+`);
+  process.exit(2);
+}
+async function loadManifest(runDir) {
+  const manifestPath = path.join(runDir, "manifest.json");
+  try {
+    const raw = await readFile(manifestPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+async function listRunFiles(runDir) {
+  const out = [];
+  const names = await readdir(runDir);
+  for (const name of names) {
+    const abs = path.join(runDir, name);
+    const s = await stat(abs).catch(() => null);
+    if (!s?.isFile()) continue;
+    out.push({ name, path: abs, size: s.size });
+  }
+  out.sort((a, b) => a.name.localeCompare(b.name));
+  return out;
+}
+function isVideoFile(p) {
+  return /\.(mp4|webm|mov)$/i.test(p);
+}
+async function extractThumbnails(videoPaths) {
+  const out = [];
+  for (const v of videoPaths) {
+    const duration = await probeDuration(v).catch(() => null);
+    if (duration === null) {
+      out.push({ video: v, frames: [] });
+      continue;
+    }
+    const frames = [];
+    const checkpoints = [0.05, 0.5, 0.95];
+    const base = v.replace(/\.[^.]+$/, "");
+    for (const ratio of checkpoints) {
+      const at = Math.max(0, Math.min(duration * ratio, duration - 0.01));
+      const dest = `${base}__frame_${Math.round(ratio * 100).toString().padStart(2, "0")}.png`;
+      try {
+        await execFileAsync("ffmpeg", ["-ss", at.toFixed(3), "-i", v, "-frames:v", "1", "-y", dest]);
+        frames.push(dest);
+      } catch {
+      }
+    }
+    out.push({ video: v, frames });
+  }
+  return out;
+}
+async function probeDuration(filePath) {
+  const { stdout } = await execFileAsync(
+    "ffprobe",
+    ["-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", filePath],
+    { encoding: "utf-8" }
+  );
+  return Number.parseFloat(stdout.trim());
+}
+export {
+  inspectCommand
+};
+//# sourceMappingURL=inspect-RVU5RDCE.js.map

package/dist/inspiration-QJNUFRNH.js

@@ -0,0 +1,53 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/landing/inspiration/index.ts
+import { defineCommand } from "citty";
+var inspirationCommand = defineCommand({
+  meta: {
+    name: "inspiration",
+    description: `Reference library of real landing-page sections \u2014 look at how good pages actually solve a problem before you design one.
+
+Start here: \`baker landing inspiration search "<what you want to see>"\` during research, BEFORE you write the Direction Contract.
+
+This is inspiration, never a clipboard. Take the mechanism \u2014 what the eye hits first, what proof arrives before the ask, how the grid is split. The words are never yours to reuse: shipping a reference's headline is a Tier 0 message-match failure.
+
+Subcommands:
+  baker landing inspiration search "<query>"  \u2014 search by look, section type, composition, register or motion; saves screenshots you can Read
+  baker landing inspiration view <id>         \u2014 one section in full: tokens, motion filmstrip, why it works, what to change
+  baker landing inspiration code <id>         \u2014 its standalone HTML+CSS, for structure only
+  baker landing inspiration page <id>         \u2014 a whole page as a sequence: how it orders its sections
+  baker landing inspiration sequences "<q>"   \u2014 what follows what across MANY pages: openers, transitions, closers
+  baker landing inspiration add <url>         \u2014 add a page to the library and save it to this company (returns immediately); --refresh re-studies a page that changed
+  baker landing inspiration favorites         \u2014 what this company has saved; the default search scope
+  baker landing inspiration favorite <id>     \u2014 save a section
+  baker landing inspiration unfavorite <id>   \u2014 unsave a section
+  baker landing inspiration retry-failed      \u2014 study again every saved page that failed
+  baker landing inspiration scrape <url>      \u2014 internal/ops: run the capture locally
+
+Examples:
+  baker landing inspiration search "pricing with a monthly/annual toggle" --max-rank 3
+  baker landing inspiration search "dark developer hero with a terminal" --register dev-tool-minimal --scope all
+  baker landing inspiration search "testimonial wall with faces and company logos" --motion scroll-reveal
+  baker landing inspiration sequences "b2b saas pricing page" --scope all
+  baker landing inspiration add https://linear.app
+
+Full guide: __tooling__/docs/tools/baker/landing.md`
+  },
+  subCommands: {
+    search: () => import("./search-AHMNQDGC.js").then((m) => m.searchCommand),
+    view: () => import("./view-G66NM2IJ.js").then((m) => m.viewCommand),
+    code: () => import("./code-MSWCKVV6.js").then((m) => m.codeCommand),
+    page: () => import("./page-QEJO3QT6.js").then((m) => m.pageCommand),
+    sequences: () => import("./sequences-2P7UQRQT.js").then((m) => m.sequencesCommand),
+    add: () => import("./add-CGHX6D4N.js").then((m) => m.addCommand),
+    favorites: () => import("./favorites-B5L4RBBH.js").then((m) => m.favoritesCommand),
+    favorite: () => import("./favorites-B5L4RBBH.js").then((m) => m.favoriteCommand),
+    unfavorite: () => import("./favorites-B5L4RBBH.js").then((m) => m.unfavoriteCommand),
+    "retry-failed": () => import("./retry-failed-P6KVU263.js").then((m) => m.retryFailedCommand),
+    scrape: () => import("./scrape-ZDBCLPGQ.js").then((m) => m.scrapeCommand)
+  }
+});
+export {
+  inspirationCommand
+};
+//# sourceMappingURL=inspiration-QJNUFRNH.js.map

package/dist/instant-experiences-Y53I7FT4.js

@@ -0,0 +1,258 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  loadJsonFileArg,
+  mergePayload,
+  requireTarget,
+  stageOp
+} from "./chunk-YIN6QNZD.js";
+import "./chunk-5B2WEPYR.js";
+import "./chunk-GDFJOCDO.js";
+import {
+  csvOrJson,
+  handleMetaError
+} from "./chunk-B2POVFR2.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-KJZPCLQE.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-Y2JZX6JB.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-UI6BKYQD.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/instant-experiences.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+var ELEMENT_FLAGS = ["text", "button", "photo-id", "video-id", "video-ref", "product-set-id", "footer"];
+function linkPair(flag, value) {
+  const [text, ...rest] = value.split("=>");
+  const url = rest.join("=>").trim();
+  if (!text?.trim() || !url) {
+    failWriteValidation(`--${flag} takes "Button text => https://\u2026" \u2014 got "${value}"`);
+  }
+  return { text: text.trim(), url };
+}
+function elementFor(flag, value) {
+  switch (flag) {
+    case "text":
+      return { type: "text", text: value };
+    case "button":
+      return { type: "button", ...linkPair(flag, value) };
+    case "footer":
+      return { type: "footer", ...linkPair(flag, value) };
+    case "photo-id":
+      return { type: "photo", photo_id: value };
+    case "video-id":
+      return { type: "video", video_id: value };
+    case "video-ref":
+      return { type: "video", videoRef: value };
+    default:
+      return { type: "product_set", product_set_id: value };
+  }
+}
+function elementFlagOf(arg) {
+  if (!arg.startsWith("--")) return void 0;
+  const eq = arg.indexOf("=");
+  const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
+  const flag = ELEMENT_FLAGS.find((candidate) => candidate === name);
+  if (!flag) return void 0;
+  return eq === -1 ? { flag } : { flag, inline: arg.slice(eq + 1) };
+}
+function canvasElementsFromRawArgs(rawArgs) {
+  const elements = [];
+  const end = rawArgs.indexOf("--");
+  const args = end === -1 ? rawArgs : rawArgs.slice(0, end);
+  for (let i = 0; i < args.length; i++) {
+    const found = elementFlagOf(args[i] ?? "");
+    if (!found) continue;
+    const value = found.inline ?? args[++i];
+    if (value === void 0 || value.startsWith("--")) failWriteValidation(`--${found.flag} needs a value`);
+    elements.push(elementFor(found.flag, value));
+  }
+  return elements;
+}
+registerSchema({
+  command: "ads.meta.instant-experiences",
+  description: "A Facebook Page's Instant Experiences \u2014 the full-screen pages an ad can open (creatives create --type instant_experience --canvas-id). Shows whether each is published: an ad opens only a published one.",
+  args: {
+    "page-id": { type: "string", description: "Facebook Page id (baker ads meta pages)", required: true },
+    output: { type: "string", description: "json|csv|jsonl|md", required: false, default: "json" }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "A Page's Instant Experiences, published or not. Runs by default. Example: baker ads meta instant-experiences --page-id 904238019441800"
+  },
+  args: {
+    "page-id": { type: "string", description: "Facebook Page id \u2014 from `baker ads meta pages`" },
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    if (!args["page-id"]) failWriteValidation("pass --page-id (from `baker ads meta pages`)");
+    try {
+      const rows = await apiGet("/api/ads/meta/instant-experiences", {
+        "page-id": String(args["page-id"])
+      });
+      const hints = rows.length === 0 ? ["This Page has no Instant Experiences. Stage one with `baker ads meta instant-experiences create`."] : [
+        "An ad opens only a published experience (is_published true): `creatives create --type instant_experience --canvas-id <id>`. A published one cannot be changed or deleted."
+      ];
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(rows, fmt, void 0, hints);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data: rows, hints });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.meta.instant-experiences.create",
+  description: "Stage a new Instant Experience on a Page \u2014 its elements in command-line order \u2014 made (and published, unless --unpublished) when the chat publishes. Meta deletes no experience, so it is only ever made at publish.",
+  args: {
+    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
+    "page-id": { type: "string", description: "The Facebook Page it belongs to", required: true },
+    name: { type: "string", description: "Name in the Page's Instant Experience library", required: true },
+    text: { type: "string", description: "A paragraph, repeatable", required: false },
+    button: { type: "string", description: '"Text => https://\u2026", repeatable', required: false },
+    "photo-id": {
+      type: "string",
+      description: "A photo on the Page, or meta_temp_* of a staged `page-photos upload`, repeatable",
+      required: false
+    },
+    "video-id": { type: "string", description: "A video of the ad account, repeatable", required: false },
+    "video-ref": { type: "string", description: "meta_temp_* of a staged video upload, repeatable", required: false },
+    "product-set-id": { type: "string", description: "Products of a catalog's product set", required: false },
+    footer: { type: "string", description: '"Text => https://\u2026" pinned at the bottom (last)', required: false },
+    background: { type: "string", description: "Background colour, six hex digits", required: false },
+    unpublished: { type: "boolean", description: "Leave it unpublished (no ad can open it yet)", required: false },
+    file: { type: "string", description: "JSON file with the whole payload", required: false }
+  }
+});
+var instantExperiencesCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new Instant Experience (the full-screen page an ad opens). ${STAGED_NOTE}
+Elements appear in the order of their flags; every element flag repeats. Published at publish unless --unpublished \u2014 an ad opens only a published one, a published one cannot be changed, and Meta deletes none.
+Pictures are Page photos (--photo-id: one on the Page, or the ref of a staged \`page-photos upload\`; a collection's photo experience takes four); videos come from the ad account (--video-id, or --video-ref of a staged \`media upload --kind video\`).
+Example: baker ads meta instant-experiences create --account-id act_123 --page-id 904238019441800 --name "Spring" --video-id 1508023623826870 --text "Our spring range" --button "Shop now => https://shop.example/spring"
+Then: baker ads meta creatives create --type instant_experience --canvas-id meta_temp_\u2026 --page 904238019441800 --message "Tap to explore" --image-hash \u2026`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or act_N (the account the ads run from)" },
+    "page-id": { type: "string", description: "The Facebook Page it belongs to \u2014 from `baker ads meta pages`" },
+    name: { type: "string", description: "Name in the Page's Instant Experience library" },
+    text: { type: "string", description: "A paragraph of text (repeatable)" },
+    button: { type: "string", description: '"Button text => https://\u2026" (repeatable)' },
+    "photo-id": {
+      type: "string",
+      description: "A photo on the Page, or meta_temp_* of a staged `page-photos upload` (repeatable)"
+    },
+    "video-id": { type: "string", description: "A video of the ad account (repeatable)" },
+    "video-ref": {
+      type: "string",
+      description: "meta_temp_* ref of a staged `media upload --kind video` (repeatable)"
+    },
+    "product-set-id": {
+      type: "string",
+      description: "Products from a catalog's product set, also shown under the ad (collection) \u2014 repeatable"
+    },
+    footer: { type: "string", description: '"Button text => https://\u2026" pinned at the bottom; must be last' },
+    background: { type: "string", description: "Background colour, six hex digits (e.g. FFFFFF)" },
+    unpublished: {
+      type: "boolean",
+      description: "Leave it unpublished \u2014 it can be changed, but no ad can open it yet"
+    },
+    file: { type: "string", description: "JSON file with the whole payload (page_id, name, elements[], publish)" }
+  },
+  run: async ({ args, rawArgs }) => {
+    const accountId = bareAccountId(args);
+    const elements = canvasElementsFromRawArgs(rawArgs);
+    const payload = mergePayload(loadJsonFileArg(args.file), {
+      page_id: args["page-id"] === void 0 ? void 0 : String(args["page-id"]),
+      name: args.name,
+      background_color: args.background,
+      elements: elements.length > 0 ? elements : void 0,
+      publish: args.unpublished === true ? false : void 0
+    });
+    await stageOp({ kind: "canvas.create", accountId, payload }, [
+      "An ad opens it with `creatives create --type instant_experience --canvas-id <ref>`."
+    ]);
+  }
+});
+registerSchema({
+  command: "ads.meta.instant-experiences.update",
+  description: "Rename or publish an UNPUBLISHED Instant Experience at publish. Meta changes nothing on a published one.",
+  args: {
+    id: { type: "positional", description: "Instant Experience id or meta_temp_* ref", required: true },
+    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
+    name: { type: "string", description: "New name", required: false },
+    publish: { type: "boolean", description: "Publish it so ads can open it", required: false }
+  }
+});
+var instantExperiencesUpdateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: `Rename or publish an unpublished Instant Experience. ${STAGED_NOTE}
+Example: baker ads meta instant-experiences update 1788652952402490 --account-id act_123 --publish`
+  },
+  args: {
+    id: { type: "positional", description: "Instant Experience id or meta_temp_* ref", required: true },
+    "account-id": { type: "string", description: "Numeric account ID or act_N" },
+    name: { type: "string", description: "New name" },
+    publish: { type: "boolean", description: "Publish it, so ads can open it \u2014 it is then fixed" }
+  },
+  run: async ({ args }) => {
+    const accountId = bareAccountId(args);
+    await stageOp({
+      kind: "canvas.update",
+      accountId,
+      target: requireTarget(args, "Instant Experience"),
+      payload: { name: args.name, publish: args.publish === true ? true : void 0 }
+    });
+  }
+});
+var instantExperiencesCommand = defineCommand({
+  meta: {
+    name: "instant-experiences",
+    description: `Instant Experiences \u2014 the full-screen page an ad opens on the phone (also behind collection ads).
+  baker ads meta instant-experiences --page-id 904238019441800        \u2014 list, with whether each is published
+  baker ads meta instant-experiences create --page-id \u2026 --name \u2026 --text \u2026 --button "Shop => https://\u2026"
+  baker ads meta instant-experiences update <id> --publish`
+  },
+  subCommands: {
+    list: listCommand,
+    create: instantExperiencesCreateCommand,
+    update: instantExperiencesUpdateCommand
+  },
+  args: { "page-id": { type: "string", description: "Facebook Page id" }, output: { type: "string", default: "json" } },
+  default: "list"
+});
+export {
+  canvasElementsFromRawArgs,
+  instantExperiencesCommand,
+  instantExperiencesCreateCommand,
+  instantExperiencesUpdateCommand
+};
+//# sourceMappingURL=instant-experiences-Y53I7FT4.js.map

package/dist/intent-57BBLPLP.js

@@ -0,0 +1,95 @@
+import {
+  handleResearchError,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-GSKZ3ZDO.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-PGRDGQ23.js";
+import "./chunk-ANLLW3KZ.js";
+import "./chunk-ERSL4WZT.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/intent.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.intent",
+  description: "Classify Google Search intent for keywords. Determines if someone searching is looking to buy, research, or navigate. If --language is omitted, defaults to English (en). The response includes a query_context object showing which language was used.",
+  args: {
+    keywords: {
+      type: "string",
+      description: "Comma-separated keywords (min 3 chars each, max 1000 keywords)",
+      required: true
+    },
+    language: {
+      type: "string",
+      description: "Language code or name. Defaults to en (English) if omitted \u2014 always set this for non-English keywords",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  keyword: "The keyword analyzed",
+  intent: "Primary Google Search intent: informational, navigational, commercial, transactional",
+  probability: "Confidence score 0.0-1.0"
+};
+var intentCommand = defineCommand({
+  meta: {
+    name: "intent",
+    description: `Classify Google Search intent for keywords. Returns intent type and confidence.
+
+Examples:
+  baker research intent "buy running shoes,best running shoes 2026,how to tie running shoes"
+  baker research intent "crm software" --language spanish`
+  },
+  args: {
+    keywords: { type: "positional", description: "Comma-separated keywords", required: true },
+    language: { type: "string", description: "Language code or name (default: en)", 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 rawKeywords = args.keywords;
+    const keywords = rawKeywords.split(",").map((k) => k.trim()).filter((k) => k.length >= 3);
+    if (keywords.length === 0) {
+      writeResearchJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Provide at least one keyword (min 3 chars each)" }
+      });
+      process.exit(1);
+    }
+    const language = args.language || void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(void 0, language, { skipLocation: true });
+    try {
+      const data = await apiPost("/api/research/intent", {
+        keywords,
+        language,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        return;
+      }
+      writeResearchJson({ ok: true, data, fields: FIELDS, query_context: queryContext });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  intentCommand
+};
+//# sourceMappingURL=intent-57BBLPLP.js.map