@koda-sl/baker-cli 0.536.0 → 0.537.0

package/dist/search-XO5UPSBF.js

@@ -0,0 +1,92 @@
+import {
+  ApiError,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/search.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "images.search",
+  description: "Search images by text query. Only returns ready images.",
+  args: {
+    query: { type: "string", description: "Search query text", required: true },
+    limit: { type: "number", description: "Maximum results to return", required: false, default: 5 },
+    "min-score": { type: "number", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": {
+      type: "string",
+      description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+      required: false
+    },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false }
+  }
+});
+var searchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Semantic search images by text query. Uses hybrid BM25 + vector + reranking. Example: baker images search 'hero banner' --aspect-ratio 16:9 --tags logo"
+  },
+  args: {
+    query: { type: "positional", description: "Search query text", required: false },
+    limit: { type: "string", description: "Max results (default 5)", required: false },
+    "min-score": { type: "string", description: "Minimum relevance score (0-1)", required: false },
+    "aspect-ratio": {
+      type: "string",
+      description: "Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3)",
+      required: false
+    },
+    tags: { type: "string", description: "Comma-separated tags to filter by", required: false },
+    output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+    fields: { type: "string", description: "Comma-separated field names to include", required: false },
+    full: { type: "boolean", description: "Include full metadata", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    process.stderr.write("[deprecated] `baker images search` \u2192 use `baker images library` (removed in next minor).\n");
+    try {
+      const query = args.query;
+      if (!query) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Search query is required" } });
+        process.exit(1);
+      }
+      const body = { query };
+      if (args.limit) {
+        body.limit = Number(args.limit);
+      }
+      if (args["aspect-ratio"]) {
+        body.aspectRatio = args["aspect-ratio"];
+      }
+      if (args.tags) {
+        body.tags = args.tags.split(",").filter(Boolean);
+      }
+      let data = await apiPost("/api/images/search", body);
+      const minScore = args["min-score"] ? Number(args["min-score"]) : void 0;
+      if (minScore !== void 0) {
+        data = data.filter((r) => typeof r.score === "number" && r.score >= minScore);
+      }
+      writeOutput(
+        { ok: true, data },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        args.full
+      );
+    } 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: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  searchCommand
+};
+//# sourceMappingURL=search-XO5UPSBF.js.map

package/dist/search-copy-DDRY6HPI.js

@@ -0,0 +1,168 @@
+import {
+  reportError
+} from "./chunk-4OY6SHHM.js";
+import {
+  apiGet
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  searchCopyPartKindSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/search-copy.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = "What one brand says on Google Search, read from its search ads: every headline with its hook (category, brand, free, price_discount, outcome, proof, new_timely, comparison, audience, location, feature, call_to_action, question), descriptions, sitelinks and callouts, each `running` or `dropped` (every ad that carried it has stopped: what the brand stopped paying for), with how many ads carried it and the longest any ran. Plus the hook mix of running vs dropped headlines and the headlines that name a rival. Each list opens with its first --limit rows; `part_totals` says how many there are in all, and `--part <kind> --offset <n>` reads the next page of one list (`next_offset` until the end). Compact by default; --running keeps what still runs; --full adds dates, the addresses the ads show and running counts. Google publishes no search ad's destination, only the address printed on it, so a `landing` is that address and may not be a real page.";
+registerSchema({
+  command: "winning-ads.search-copy",
+  description: DESCRIPTION,
+  args: {
+    advertiser: { type: "string", description: "Advertiser id (from `advertisers` or `following`)", required: true },
+    limit: { type: "number", description: "Rows per list 1-100 (default 15)", required: false, default: 15 },
+    part: {
+      type: "string",
+      description: "Read one list a page at a time: headlines|descriptions|sitelinks|callouts",
+      required: false
+    },
+    offset: { type: "number", description: "With --part: rows to skip (the last page's next_offset)", required: false },
+    running: { type: "boolean", description: "Only what still runs", required: false, default: false },
+    full: { type: "boolean", description: "Dates, the addresses the ads show and running counts", required: false }
+  }
+});
+var PART_KINDS = searchCopyPartKindSchema.options;
+var keep = (running) => (p) => !running || p.status === "running";
+function compactSearchCopy(copy, opts) {
+  const brief = (p) => ({ text: p.text, status: p.status, ads: p.ads });
+  return {
+    advertiser_id: copy.advertiser_id,
+    totals: copy.totals,
+    ...copy.part_totals ? { part_totals: copy.part_totals } : {},
+    headlines: copy.headlines.filter(keep(opts.running)).map((h) => ({
+      text: h.text,
+      hook: h.hook,
+      status: h.status,
+      ads: h.ads,
+      longest_days: h.longest_days,
+      landing: h.landing_pages[0] ?? null,
+      ad_id: h.example_ad_id,
+      ...h.names_rival ? { names_rival: true } : {}
+    })),
+    descriptions: copy.descriptions.filter(keep(opts.running)).map(brief),
+    sitelinks: copy.sitelinks.filter(keep(opts.running)).map(brief),
+    callouts: copy.callouts.filter(keep(opts.running)).map(brief),
+    hooks: copy.hooks,
+    rival_headlines: copy.rival_headlines
+  };
+}
+function searchCopyView(copy, opts) {
+  if (!opts.full) return compactSearchCopy(copy, { running: opts.running });
+  if (!opts.running) return copy;
+  const headlines = copy.headlines.filter(keep(true));
+  const live = new Set(headlines.map((h) => h.text));
+  return {
+    ...copy,
+    headlines,
+    descriptions: copy.descriptions.filter(keep(true)),
+    sitelinks: copy.sitelinks.filter(keep(true)),
+    callouts: copy.callouts.filter(keep(true)),
+    rival_headlines: copy.rival_headlines.filter((text) => live.has(text))
+  };
+}
+function searchCopyPageView(page, opts) {
+  const end = page.offset + page.parts.length;
+  const parts = page.parts.filter((p) => !opts.running || p.status === "running");
+  return {
+    advertiser_id: page.advertiser_id,
+    part: page.part,
+    offset: page.offset,
+    total: page.total,
+    next_offset: end < page.total ? end : null,
+    parts: opts.full ? parts : parts.map((p) => ({ text: p.text, ...p.hook ? { hook: p.hook } : {}, status: p.status, ads: p.ads }))
+  };
+}
+function searchCopyHints(copy) {
+  if (copy.totals.ads === 0) {
+    return [
+      'The library holds no Google search ads for this brand. Follow it on Google by its website (`baker winning-ads follow "<brand website>"`) and read again after the scan; for a one-off look, `baker research google-ads <domain> --copy`.'
+    ];
+  }
+  const hints = [];
+  const unread = copy.totals.ads - copy.totals.read;
+  if (unread > 0) {
+    hints.push(
+      `${unread} of ${copy.totals.ads} search ads are not read yet (extracted before their parts were read); the lists cover the other ${copy.totals.read}.`
+    );
+  }
+  hints.push(
+    "`dropped` is inferred: Google dates ads, not headlines. Read one ad whole with `baker winning-ads content <ad_id> --platform google`."
+  );
+  for (const kind of PART_KINDS) {
+    const listed = copy[kind].length;
+    const total = copy.part_totals?.[kind] ?? listed;
+    if (total > listed) {
+      hints.push(
+        `${kind}: ${listed} of ${total} listed. Next page: \`baker winning-ads search-copy ${copy.advertiser_id} --part ${kind} --offset ${listed}\` \u2014 never call ${listed} the whole list.`
+      );
+    }
+  }
+  return hints;
+}
+var searchCopyCommand = defineCommand({
+  meta: {
+    name: "search-copy",
+    description: "What one brand says on Google Search: headlines with their hooks, descriptions, sitelinks and callouts, running or dropped. Start here: baker winning-ads search-copy adv_123 --running \xB7 next page of one list: --part sitelinks --offset 15"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    limit: { type: "string", description: "Rows per list 1-100 (default 15)", required: false },
+    part: {
+      type: "string",
+      description: "One list a page at a time: headlines|descriptions|sitelinks|callouts",
+      required: false
+    },
+    offset: { type: "string", description: "With --part: rows to skip (the last page's next_offset)", required: false },
+    running: { type: "boolean", description: "Only what still runs", required: false, default: false },
+    full: { type: "boolean", description: "Dates, every landing page and running counts", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = { id: String(args.advertiser) };
+      if (args.limit) params.limit = String(args.limit);
+      if (args.part) {
+        const page = await apiGet("/api/ad-library/advertiser-search-copy/page", {
+          ...params,
+          part: String(args.part),
+          offset: String(args.offset ?? 0)
+        });
+        const view = searchCopyPageView(page, { full: Boolean(args.full), running: Boolean(args.running) });
+        writeJson({
+          ok: true,
+          data: view,
+          hints: view.next_offset === null ? [`That was the last of ${page.total} ${page.part}.`] : [
+            `Next page: \`baker winning-ads search-copy ${page.advertiser_id} --part ${page.part} --offset ${view.next_offset}\``
+          ]
+        });
+        return;
+      }
+      const copy = await apiGet("/api/ad-library/advertiser-search-copy", params);
+      writeJson({
+        ok: true,
+        data: searchCopyView(copy, { full: Boolean(args.full), running: Boolean(args.running) }),
+        hints: searchCopyHints(copy)
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  compactSearchCopy,
+  searchCopyCommand,
+  searchCopyHints,
+  searchCopyPageView,
+  searchCopyView
+};
+//# sourceMappingURL=search-copy-DDRY6HPI.js.map

package/dist/seeds-HH5E7GCS.js

@@ -0,0 +1,101 @@
+import {
+  reportError
+} from "./chunk-4OY6SHHM.js";
+import {
+  apiGet
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/seeds.ts
+import { defineCommand } from "citty";
+function leanSeedRow(r) {
+  return {
+    key: r.key,
+    lift: r.lift,
+    brands_for: r.brands_for,
+    brands_against: r.brands_against,
+    count: r.count,
+    mean_winner_score: r.mean_winner_score,
+    winner_share: r.winner_share
+  };
+}
+function buildSeedParams(field, args) {
+  const params = { field };
+  if (args.platform) params.platform = String(args.platform);
+  if (args.awareness) params.awareness_stage = String(args.awareness);
+  if (args.industry) params.industry = String(args.industry);
+  if (args.limit) params.limit = String(args.limit);
+  return params;
+}
+function makeSeedCommand(opts) {
+  registerSchema({
+    command: `winning-ads.${opts.name}`,
+    description: opts.description,
+    args: {
+      platform: { type: "string", description: "Single platform (meta,linkedin,tiktok,google)", required: false },
+      awareness: { type: "string", description: "Single awareness stage", required: false },
+      industry: { type: "string", description: "Single industry seed", required: false },
+      limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
+    }
+  });
+  return defineCommand({
+    meta: { name: opts.name, description: opts.description },
+    args: {
+      platform: { type: "string", description: "Single platform to segment on", required: false },
+      awareness: { type: "string", description: "Single awareness stage to segment on", required: false },
+      industry: { type: "string", description: "Single industry seed to segment on", required: false },
+      limit: { type: "string", description: "Max keys 1-100 (default 20)", required: false, default: "20" },
+      output: { type: "string", description: "Output format: json|files|md", required: false, default: "json" },
+      full: { type: "boolean", description: "Include the segment breakdown per key", required: false, default: false }
+    },
+    run: async ({ args }) => {
+      try {
+        const params = buildSeedParams(opts.field, args);
+        const data = await apiGet("/api/ad-library/seed-catalog", params);
+        const rows = Array.isArray(data?.patterns) ? data.patterns : [];
+        const full = args.full;
+        const projected = rows.map((r) => full ? r : leanSeedRow(r));
+        const output = args.output || "json";
+        if (output === "json") {
+          writeJson({
+            ok: true,
+            data: { field: data?.field ?? opts.field, segment: data?.segment ?? null, patterns: projected }
+          });
+          return;
+        }
+        writeOutput({ ok: true, data: projected }, output);
+      } catch (err) {
+        reportError(err);
+      }
+    }
+  });
+}
+var hooksCommand = makeSeedCommand({
+  name: "hooks",
+  field: "hook_archetype",
+  description: "Top winner-weighted HOOK seeds for a segment (from the ad-dna pattern rollup). Ground a creative in a proven hook for the exact platform+awareness+industry, then feed the chosen seed to `search --hook-archetype`."
+});
+var mechanismsCommand = makeSeedCommand({
+  name: "mechanisms",
+  field: "mechanism_type",
+  description: "Top winner-weighted PRODUCT mechanism seeds for a segment: how the advertised product claims to work (proprietary formula, AI automated, done-for-you\u2026). Not the ad's persuasion device: for that use `hooks` and `formats`."
+});
+var formatsCommand = makeSeedCommand({
+  name: "formats",
+  field: "static_format_pattern",
+  description: "Top winner-weighted static ad FORMAT patterns for a segment (from the ad-dna pattern rollup)."
+});
+export {
+  formatsCommand,
+  hooksCommand,
+  leanSeedRow,
+  mechanismsCommand
+};
+//# sourceMappingURL=seeds-HH5E7GCS.js.map

package/dist/select-WVNPJDXP.js

@@ -0,0 +1,110 @@
+import {
+  versionOf
+} from "./chunk-SMDJW5W4.js";
+import "./chunk-TNQJDM2P.js";
+import "./chunk-TQDZQT6U.js";
+import "./chunk-NJIRVF2B.js";
+import "./chunk-BBGKZJXP.js";
+import "./chunk-EKX37C3T.js";
+import "./chunk-GTIQUOYC.js";
+import "./chunk-R2VP7FK4.js";
+import "./chunk-GY6N42PE.js";
+import "./chunk-6EMVPPSQ.js";
+import "./chunk-LXV2U4MI.js";
+import "./chunk-A5PQYKVO.js";
+import "./chunk-YFIWCMVC.js";
+import "./chunk-WTYKTPZP.js";
+import "./chunk-CB7GZQVN.js";
+import "./chunk-2AJ5UNOF.js";
+import "./chunk-G6XKD7QE.js";
+import "./chunk-NRMJWNX3.js";
+import "./chunk-W3PJ7V4W.js";
+import "./chunk-CM2LECNX.js";
+import "./chunk-AMHVCMBW.js";
+import "./chunk-NQ5O2NCJ.js";
+import "./chunk-RW32BYY3.js";
+import "./chunk-DGCUPJZD.js";
+import "./chunk-FSLSISPI.js";
+import "./chunk-GT76FWES.js";
+import "./chunk-4PWC4KAK.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import {
+  creativesSelectRequestSchema
+} from "./chunk-3LH5ANM4.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-TI4UL56R.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/creatives/select.ts
+import { defineCommand } from "citty";
+var DESCRIPTION = `Choose the version of a creative to keep, and optionally which of its options, only when the user says to keep this version in this chat. The creative shows that version as the chosen one, and the choice counts as the user's approval. A version you render after it replaces it when the chat is published (the user saw that one last). It does not save the image to their library (that is baker creatives publish) and puts nothing into an ad.
+Start here: baker creatives select --slug spring-offer
+Only some options of a version that made several: --options "ugc,2" (labels or numbers). Naming options again replaces the earlier pick.`;
+var ARGS = {
+  slug: { type: "string", description: "The creative: its folder name under src/creatives/.", required: true },
+  run: {
+    type: "string",
+    description: "The version to keep: its canvas run id (r_\u2026) Left out, the version the creative shows now (its last render).",
+    required: false
+  },
+  options: {
+    type: "string",
+    description: 'Keep only these options of the version, comma-separated: labels ("ugc"), numbers ("2") or slots. Left out, the whole version.',
+    required: false
+  }
+};
+registerSchema({ command: "creatives.select", description: DESCRIPTION, args: ARGS });
+function fail(code, message) {
+  writeJson({ ok: false, error: { code, message } });
+  process.exit(1);
+}
+var selectCommand = defineCommand({
+  meta: { name: "select", description: DESCRIPTION },
+  args: ARGS,
+  run: async ({ args }) => {
+    const options = typeof args.options === "string" ? args.options.split(",").map((option) => option.trim()).filter((option) => option.length > 0) : [];
+    const parsed = creativesSelectRequestSchema.safeParse({
+      slug: args.slug,
+      runId: await versionOf(String(args.slug), args.run).then(
+        (run) => run ?? fail("VALIDATION_ERROR", "--run: this creative has no rendered version here; name one (r_\u2026).")
+      ),
+      ...options.length > 0 ? { options } : {}
+    });
+    if (!parsed.success) {
+      const issue = parsed.error.issues[0];
+      fail("VALIDATION_ERROR", `--${String(issue?.path[0] ?? "args")}: ${issue?.message ?? "invalid"}`);
+    }
+    try {
+      const response = await apiPost("/api/creatives/select", parsed.data);
+      writeJson(response);
+    } catch (err) {
+      if (err instanceof ApiError) fail(err.code, err.message);
+      fail("INTERNAL_ERROR", "Unexpected error");
+    }
+  }
+});
+export {
+  selectCommand
+};
+//# sourceMappingURL=select-WVNPJDXP.js.map