@koda-sl/baker-cli 0.554.0 → 0.556.0

package/dist/custom-conversions-V7QPZIB4.js

@@ -0,0 +1,128 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-QY7EK6Q4.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-QYH2UZAK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import {
+  apiGet
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/custom-conversions.ts
+import { defineCommand } from "citty";
+function compactCustomConversion(row) {
+  return {
+    id: row.id,
+    name: row.name,
+    custom_event_type: row.custom_event_type,
+    counts: row.rule_summary,
+    pixel_id: row.pixel?.id,
+    last_fired_time: row.last_fired_time,
+    ...row.is_archived ? { archived: true } : {},
+    ...row.is_unavailable ? { unavailable: true } : {}
+  };
+}
+function customConversionHints(rows) {
+  if (rows.length === 0) {
+    return [
+      "This account has no custom conversions. Optimize toward a standard pixel event instead (`--pixel-id` + `--custom-event-type`), or stage one: `baker ads meta custom-conversions create --name \u2026 --pixel-id \u2026 --custom-event-type LEAD --url-contains /thank-you`."
+    ];
+  }
+  const hints = [
+    "To optimize an ad set toward one: `baker ads meta adsets create \u2026 --optimization-goal OFFSITE_CONVERSIONS --custom-conversion-id <id>`. Baker fills the pixel and the event category from the conversion \u2014 do not also pass --pixel-id or --custom-event-type."
+  ];
+  const neverFired = rows.filter((row) => !row.is_archived && !row.last_fired_time);
+  if (neverFired.length > 0) {
+    hints.push(
+      `${neverFired.length === 1 ? "This conversion has" : `${neverFired.length} of these have`} never fired (${neverFired.map((row) => row.name ?? row.id).join(
+        ", "
+      )}). Meta cannot optimize toward an event it has never seen, so an ad set pointed at one delivers without learning \u2014 check the rule matches a page the site actually serves before spending on it.`
+    );
+  }
+  return hints;
+}
+registerSchema({
+  command: "ads.meta.custom-conversions",
+  description: "List the Custom Conversions defined on a Meta ad account \u2014 the measurement objects a marketer sets up in Events Manager (a pixel event narrowed by a rule, e.g. 'PageView on /thank-you'). Start here whenever the user talks about their own conversions rather than a standard event: an ad set optimizes toward one with `adsets create --custom-conversion-id <id>`.",
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
+    full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times", required: false },
+    limit: { type: "string", description: "Max rows", required: false },
+    "no-cache": { type: "boolean", description: "Bypass the cache", required: false },
+    output: { type: "string", description: "json|csv", required: false, default: "json" }
+  }
+});
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times" },
+  limit: { type: "string", description: "Max rows" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "Output format: json|csv|jsonl|md", default: "json" }
+};
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List custom conversions. Runs by default when no subcommand is given. Example: baker ads meta custom-conversions --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = await resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const rows = await apiGet("/api/ads/meta/custom-conversions", params);
+      const data = args.full ? rows.map((row) => ({ ...row })) : rows.map((row) => ({ ...compactCustomConversion(row) }));
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data, hints: customConversionHints(rows) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var customConversionsCommand = defineCommand({
+  meta: {
+    name: "custom-conversions",
+    description: `List the Custom Conversions on an ad account, or stage a new one \u2014 a pixel event narrowed by a rule, set up in Events Manager.
+Use this whenever the user says "my conversions" rather than naming a standard event: the id here is what an ad set optimizes toward.
+
+Examples:
+  baker ads meta custom-conversions --account-id act_123
+  baker ads meta custom-conversions --account-id act_123 --full   # raw rule JSON
+  baker ads meta custom-conversions create --name "Lead formulario" --pixel-id 9988 --custom-event-type LEAD --url-contains "/gracias"`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-F5XPPLOO.js").then((m) => m.customConversionsCreateCommand),
+    update: () => import("./asset-writes-JVFE457M.js").then((m) => m.customConversionsUpdateCommand),
+    delete: () => import("./asset-writes-JVFE457M.js").then((m) => m.customConversionsDeleteCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for
+  // the subcommand name using THIS command's arg defs. `default` (not `run`)
+  // dispatches the bare invocation.
+  args: listArgs,
+  default: "list"
+});
+export {
+  compactCustomConversion,
+  customConversionHints,
+  customConversionsCommand
+};
+//# sourceMappingURL=custom-conversions-V7QPZIB4.js.map

package/dist/customers-IDB6NLQ6.js

@@ -0,0 +1,65 @@
+import {
+  FITS,
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepOnTopic,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials,
+  webPageUrls
+} from "./chunk-SPBUE7R4.js";
+import "./chunk-KKKZRQFY.js";
+import "./chunk-UCJAPB5Y.js";
+import "./chunk-CXYX6G3I.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-Y5PNLB24.js";
+import "./chunk-N3PASNUA.js";
+import "./chunk-DLM5OSHM.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-EL3TDR5S.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  FITS,
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepOnTopic,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials,
+  webPageUrls
+};
+//# sourceMappingURL=customers-IDB6NLQ6.js.map

package/dist/delete-2QKVUKKB.js

@@ -0,0 +1,67 @@
+import {
+  failApi,
+  failValidation,
+  validateScheduledAgentRef,
+  writeOk
+} from "./chunk-7BVRFQN4.js";
+import "./chunk-WR5Y64OE.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/delete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.delete",
+  description: "Stage deletion of a published scheduled agent, or cancel one this chat staged (temp_agent_*).",
+  args: {
+    id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Stage a scheduled agent deletion. Example: baker scheduled-agents delete <id-or-temp_agent_id>"
+  },
+  args: {
+    id: { type: "positional", description: "Scheduled agent ID or temp_agent_* draft ID", required: false },
+    "scheduled-agent-id": {
+      type: "string",
+      description: "Scheduled agent ID (alternative to positional)",
+      required: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["scheduled-agent-id"];
+      if (!id) {
+        failValidation("Scheduled agent ID is required.");
+      }
+      validateScheduledAgentRef(id);
+      await apiPost("/api/scheduled-agents/delete", { chatId: requireChatId(), id });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  deleteCommand
+};
+//# sourceMappingURL=delete-2QKVUKKB.js.map

package/dist/delete-B7BKF24X.js

@@ -0,0 +1,57 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-BS2MC62Y.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/delete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.tags.delete",
+  description: "Delete a company custom action tag by slug. Built-in default tags cannot be deleted. Existing actions keep the slug (it just stops appearing in the taxonomy).",
+  args: {
+    slug: { type: "string", description: "Custom tag slug to delete", required: true }
+  }
+});
+var tagsDeleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Delete a custom action tag. Example: baker actions tags delete --slug pmax"
+  },
+  args: {
+    slug: { type: "string", description: "Custom tag slug", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const slug = args.slug;
+      if (!slug || slug.trim().length === 0) {
+        failValidation("--slug is required.");
+      }
+      await apiPost("/api/actions/tags/delete", { name: slug });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  tagsDeleteCommand
+};
+//# sourceMappingURL=delete-B7BKF24X.js.map

package/dist/delete-HBRYUWAA.js

@@ -0,0 +1,69 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-3J52GJAY.js";
+import {
+  testimonialsDeleteRequestSchema
+} from "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/delete.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "testimonials.delete",
+  description: "Remove one testimonial from the library, with the images it brought in. Applies immediately and cannot be undone \u2014 confirm with the user first; --dry-run previews.",
+  args: {
+    id: { type: "string", description: "Testimonial id from `testimonials list|search`", required: true },
+    "dry-run": { type: "boolean", description: "Preview without removing", required: false, default: false }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Remove one testimonial (and its images) from the library. Applies immediately \u2014 confirm with the user first.\n\nExample: baker testimonials delete <testimonial-id> --dry-run"
+  },
+  args: {
+    id: { type: "positional", description: "Testimonial id from `testimonials list|search`", required: true },
+    "dry-run": { type: "boolean", description: "Preview without removing", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    const parsed = testimonialsDeleteRequestSchema.safeParse({ id: String(args.id ?? "") });
+    if (!parsed.success) reportInvalid(parsed.error.issues[0]);
+    if (args["dry-run"]) {
+      writeJson({ ok: true, dryRun: true, operation: "testimonials.delete", params: parsed.data });
+      return;
+    }
+    try {
+      const data = await apiPost("/api/testimonials/delete", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: [
+          "Already removed: publishing or discarding this chat will not bring it back. If its review page is still a source, the next import can add it again \u2014 remove the source to stop that."
+        ]
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  deleteCommand
+};
+//# sourceMappingURL=delete-HBRYUWAA.js.map

package/dist/demographics-JHB3NFLU.js

@@ -0,0 +1,141 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-OTFHIGEO.js";
+import {
+  writeAdsJson
+} from "./chunk-QYH2UZAK.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-GO6ISZUZ.js";
+import "./chunk-MKLAZD23.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-MSMTG6OC.js";
+import {
+  apiPost
+} from "./chunk-GFWWHCBF.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/demographics.ts
+import { defineCommand } from "citty";
+var DEFAULT_PIVOTS = ["job-title", "company", "industry", "seniority", "job-function", "company-size"];
+function numberOf(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : 0;
+  if (typeof v === "string") {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+  }
+  return 0;
+}
+function topByImpressions(rows, limit) {
+  return [...rows].sort((a, b) => numberOf(b.impressions) - numberOf(a.impressions)).slice(0, limit);
+}
+var demographicsCommand = defineCommand({
+  meta: {
+    name: "demographics",
+    description: `Sweep all firmographic pivots in one command \u2014 LinkedIn's superpower.
+
+Default pivots:
+  job-title, company, industry, seniority, job-function, company-size
+
+Use --pivots to narrow the sweep. Output is one section per pivot, each with
+top-N rows by impressions (configurable via --top-n).
+
+Demographic data is delayed 12-24h with a \u22653-event privacy floor \u2014 small
+buckets are silently dropped. The CLI surfaces this in 'warnings' when the
+result set comes back unexpectedly empty.
+
+Examples:
+  baker ads linkedin demographics --campaign-id 1234
+  baker ads linkedin demographics --campaign-id 1234 --pivots job-title,company
+  baker ads linkedin demographics --campaign-id 1234 --last-days 30 --top-n 25`
+  },
+  args: {
+    "campaign-id": { type: "string", description: "Comma-separated campaign IDs (required)" },
+    pivots: { type: "string", description: `CSV of pivots (default: ${DEFAULT_PIVOTS.join(",")})` },
+    "top-n": { type: "string", description: "Top rows per pivot (default: 10)" },
+    intent: { type: "string", description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline)" },
+    start: { type: "string", description: "Start date YYYY-MM-DD" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 30)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const fmt = csvOrJson(args);
+    if (fmt !== "json") {
+      writeAdsJson({
+        ok: false,
+        error: {
+          code: "UNSUPPORTED_FORMAT",
+          message: "demographics returns a structured per-pivot report \u2014 only --output json supported."
+        }
+      });
+      process.exit(1);
+    }
+    const campaignIdsRaw = args["campaign-id"];
+    if (!campaignIdsRaw) {
+      handleLinkedinError(new Error("--campaign-id is required (CSV for multi)."));
+    }
+    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
+    const pivotsRaw = args.pivots?.split(",").map((s) => s.trim().toLowerCase());
+    const pivots = pivotsRaw && pivotsRaw.length > 0 ? pivotsRaw : DEFAULT_PIVOTS;
+    const topN = args["top-n"] ? Number(args["top-n"]) : 10;
+    const intent = args.intent ?? "baseline";
+    const { start, end } = resolveRange(args);
+    try {
+      const results = [];
+      for (const pivot of pivots) {
+        const data = await apiPost("/api/ads/linkedin/analytics", {
+          request: {
+            level: "campaign",
+            ids,
+            intent,
+            pivot,
+            start,
+            end,
+            granularity: "ALL",
+            limit: 500
+          },
+          skipCache: Boolean(args["no-cache"])
+        });
+        results.push({ pivot, rows: topByImpressions(data.rows, topN), warnings: data.warnings });
+      }
+      writeAdsJson({
+        ok: true,
+        data: {
+          query: { campaigns: ids, start, end, intent, topN },
+          pivots: results
+        }
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+function resolveRange(args) {
+  const start = args.start;
+  const end = args.end;
+  if (start) {
+    return { start, end };
+  }
+  const days = args["last-days"] ? Number(args["last-days"]) : 30;
+  if (!Number.isFinite(days) || days < 1) {
+    handleLinkedinError(new Error("Invalid --last-days; must be a positive integer."));
+  }
+  return { start: daysAgoIso(days), end: todayIso() };
+}
+export {
+  demographicsCommand
+};
+//# sourceMappingURL=demographics-JHB3NFLU.js.map

package/dist/dimensions-KI3OENZD.js

@@ -0,0 +1,101 @@
+import {
+  isRemoteUrl,
+  readImageBuffer
+} from "./chunk-LC6PVPJX.js";
+import "./chunk-X6U3B6YK.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/dimensions.ts
+import { defineCommand } from "citty";
+
+// src/lib/image/dimensions.ts
+import { imageSize } from "image-size";
+function getDimensionsFromBuffer(buffer) {
+  const result = imageSize(buffer);
+  if (!result.width || !result.height) return null;
+  return {
+    width: result.width,
+    height: result.height,
+    aspectRatio: result.width / result.height,
+    format: result.type ?? null
+  };
+}
+
+// src/commands/images/dimensions.ts
+registerSchema({
+  command: "images.dimensions",
+  description: "Return width, height, aspect ratio, and format for a local file or remote URL.",
+  args: {
+    target: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+    output: { type: "string", description: "Output format: json|md. Default: json", required: false },
+    fields: {
+      type: "string",
+      description: "Comma-separated field names to include (e.g. width,height)",
+      required: false
+    }
+  }
+});
+var dimensionsCommand = defineCommand({
+  meta: {
+    name: "dimensions",
+    description: "Read image dimensions without decoding the full file.\n\nExample: baker images dimensions ./logo.png\nExample: baker images dimensions https://acme.com/hero.png"
+  },
+  args: {
+    target: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+    output: { type: "string", description: "Output format: json|md", required: false },
+    // --fields is the flag an agent reaches for when it wants two numbers out of
+    // six. It used to be accepted silently and ignored (citty drops unknown
+    // flags), so the caller assumed the projection had failed and fell back to
+    // regexing raw JSON. Accepting it is cheaper than explaining it.
+    fields: { type: "string", description: "Comma-separated field names to include", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const target = args.target;
+      if (!target) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "target argument is required" } });
+        process.exit(1);
+      }
+      const buffer = await readImageBuffer(target);
+      const dims = getDimensionsFromBuffer(buffer);
+      if (!dims) {
+        writeJson({
+          ok: false,
+          error: { code: "IMAGE_PROCESSING_ERROR", message: `Could not extract dimensions from ${target}` }
+        });
+        process.exit(1);
+      }
+      writeOutput(
+        {
+          ok: true,
+          data: {
+            target,
+            source: isRemoteUrl(target) ? "url" : "file",
+            width: dims.width,
+            height: dims.height,
+            aspectRatio: Math.round(dims.aspectRatio * 1e4) / 1e4,
+            format: dims.format
+          }
+        },
+        args.output || "json",
+        args.fields ? args.fields.split(",") : void 0,
+        false,
+        (record) => record
+      );
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unexpected error";
+      writeJson({ ok: false, error: { code: "IMAGE_PROCESSING_ERROR", message } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  dimensionsCommand
+};
+//# sourceMappingURL=dimensions-KI3OENZD.js.map