@koda-sl/baker-cli 0.532.0 → 0.534.0-dev.911a80433

package/dist/customers-VJ3TXILQ.js

@@ -0,0 +1,59 @@
+import {
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials
+} from "./chunk-2PC26XRF.js";
+import "./chunk-E3FMS5DA.js";
+import "./chunk-WEQZ563U.js";
+import "./chunk-QPPQXU3U.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-AGU4KGT6.js";
+import "./chunk-R5LRBDEM.js";
+import "./chunk-DGZYZWMK.js";
+import "./chunk-F3CZFUXZ.js";
+import "./chunk-SVNH6P7O.js";
+import "./chunk-YJYKSMLF.js";
+import "./chunk-L763CNKH.js";
+import "./chunk-DYOUJERF.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-MUS2UTWU.js";
+import "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials
+};
+//# sourceMappingURL=customers-VJ3TXILQ.js.map

package/dist/delete-3H377GOM.js

@@ -0,0 +1,67 @@
+import {
+  failApi,
+  failValidation,
+  validateScheduledAgentRef,
+  writeOk
+} from "./chunk-KUM36NSV.js";
+import "./chunk-VCOIFNYH.js";
+import "./chunk-DYOUJERF.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-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import {
+  requireChatId
+} from "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.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-3H377GOM.js.map

package/dist/delete-EH3XL26Z.js

@@ -0,0 +1,57 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-7MY3QHGA.js";
+import "./chunk-DYOUJERF.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-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.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-EH3XL26Z.js.map

package/dist/delete-QYSOAVP4.js

@@ -0,0 +1,69 @@
+import {
+  reportError,
+  reportInvalid
+} from "./chunk-QTLIXCVN.js";
+import {
+  testimonialsDeleteRequestSchema
+} from "./chunk-DYOUJERF.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-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-HZPTQRX6.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-QYSOAVP4.js.map

package/dist/demographics-GKJZ5PV2.js

@@ -0,0 +1,141 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-G53CUQZV.js";
+import {
+  writeAdsJson
+} from "./chunk-LV7EU6HM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-NLW25WW3.js";
+import "./chunk-DYOUJERF.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-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import "./chunk-HZPTQRX6.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-GKJZ5PV2.js.map

package/dist/discard-46RALLBO.js

@@ -0,0 +1,69 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-7MY3QHGA.js";
+import "./chunk-DYOUJERF.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-MUS2UTWU.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import {
+  requireChatId
+} from "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/discard.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.discard",
+  description: "Stage discard of an action \u2014 no claim needed; retire any action you're not working on. Applies on chat publish. Blocked only if another chat currently has it claimed.",
+  args: {
+    id: { type: "string", description: "Action ID", required: true },
+    reason: { type: "string", description: "Optional reason", required: false }
+  }
+});
+var discardCommand = defineCommand({
+  meta: {
+    name: "discard",
+    description: 'Stage discard of an action (no claim needed). Example: baker actions discard <id> --reason "obsolete"'
+  },
+  args: {
+    id: { type: "positional", description: "Action ID", required: false },
+    "action-id": { type: "string", description: "Action ID", required: false },
+    reason: { type: "string", description: "Reason for discarding", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      validateConvexId(id);
+      const chatId = requireChatId();
+      await apiPost("/api/actions/discard", {
+        chatId,
+        actionId: id,
+        reason: args.reason
+      });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  discardCommand
+};
+//# sourceMappingURL=discard-46RALLBO.js.map

package/dist/discover-C4TG7JP7.js

@@ -0,0 +1,172 @@
+import {
+  PLANNER_FIELD_DESCRIPTIONS,
+  PLANNER_SOURCE,
+  stampPlannerRows
+} from "./chunk-2Y5V23PU.js";
+import {
+  buildAdsQueryContext,
+  warnDefaults
+} from "./chunk-URMAEVZO.js";
+import "./chunk-IZABTTW5.js";
+import {
+  buildQueryCacheKey,
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  handleConnectionError,
+  isNotConnectedError,
+  resolveCustomerId,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-LV7EU6HM.js";
+import "./chunk-MUS2UTWU.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-CIW3Q7B2.js";
+import "./chunk-O7AMKMII.js";
+import "./chunk-VPF5A7CM.js";
+import {
+  registerSchema
+} from "./chunk-HZPTQRX6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/discover.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.keywords.discover",
+  description: 'Discover keyword ideas from seed keywords or URLs. Returns { source: "keyword_planner_estimate", keywords, total_results, next_page_token? }. These are Keyword Planner estimates of total market search volume, not this account\'s data: every row carries a source column and every metric is prefixed planner_ (planner_avg_monthly_searches, planner_competition, ...). Never report a planner_ number as impressions, clicks or any account metric \u2014 read those with `baker ads google query` against the account. If --location and --language are omitted, they default to United States (2840) and English (1000); `query_context` shows which were used.',
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    seeds: { type: "string", description: "Comma-separated seed keywords (max 10)", required: false },
+    url: { type: "string", description: "URL to extract keyword ideas from", required: false },
+    location: {
+      type: "string",
+      description: "Geo target ID. Defaults to 2840 (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language ID. Defaults to 1000 (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    limit: { type: "string", description: "Max keyword ideas (default: 20, max: 100)", required: false, default: 20 },
+    cursor: {
+      type: "string",
+      description: "Pagination cursor from previous response (next_page_token)",
+      required: false
+    },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+function stampDiscoverResponse(data) {
+  return { ...data, source: PLANNER_SOURCE, keywords: stampPlannerRows(data.keywords ?? []) };
+}
+function buildDiscoverBody(customerId, args) {
+  const body = {
+    customerId,
+    pageSize: args.limit ? Number(args.limit) : 20
+  };
+  const managerId = getManagerIdForCustomer(customerId);
+  if (managerId) body.managerId = managerId;
+  const seeds = args.seeds ? args.seeds.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+  if (seeds) body.seeds = seeds;
+  if (args.url) body.url = args.url;
+  if (args.location) body.locationIds = [args.location];
+  if (args.language) body.languageId = args.language;
+  if (args.cursor) body.pageToken = args.cursor;
+  return body;
+}
+function handleKeywordError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("google_ads", err.message);
+    }
+    const envelope = {
+      ok: false,
+      error: {
+        code: err.code,
+        message: err.message,
+        fix: { action: "reject", explanation: err.message },
+        retryable: err.code === "RATE_LIMITED"
+      }
+    };
+    writeAdsJson(envelope);
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var discoverCommand = defineCommand({
+  meta: {
+    name: "discover",
+    description: `Discover new keyword ideas from seed keywords or competitor URLs.
+
+Returns Keyword Planner ESTIMATES of market search volume, not this account's numbers. Every row carries source=keyword_planner_estimate and planner_-prefixed metrics; keep those names when you quote a figure, and never present one as an impression or click count.
+
+Examples:
+  baker ads google keywords discover --customer-id 1234567890 --seeds "running shoes,athletic footwear"
+  baker ads google keywords discover --customer-id 1234567890 --url "https://competitor.com"
+  baker ads google keywords discover --customer-id 1234567890 --seeds "seo tools" --location 2826 --limit 50`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID", required: false },
+    seeds: { type: "string", description: "Comma-separated seed keywords", required: false },
+    url: { type: "string", description: "URL to extract ideas from", required: false },
+    location: { type: "string", description: "Geo target ID (default 2840)", required: false },
+    language: { type: "string", description: "Language ID (default 1000)", required: false },
+    limit: { type: "string", description: "Max results (default 20)", required: false },
+    cursor: { type: "string", description: "Pagination cursor from previous response", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|jsonl|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const queryContext = buildAdsQueryContext(args.location, args.language);
+    if (!args.seeds && !args.url) {
+      writeAdsJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "Provide --seeds or --url (at least one required)" }
+      });
+      process.exit(1);
+    }
+    const body = buildDiscoverBody(customerId, args);
+    const useCache = !args["no-cache"] && !args.cursor;
+    if (!useCache) body.skipCache = true;
+    const cacheKey = buildQueryCacheKey(customerId, JSON.stringify(body));
+    if (useCache) {
+      const cached = cacheGet("keywords", cacheKey);
+      if (cached) {
+        warnDefaults(queryContext);
+        writeAdsJson({ ok: true, data: stampDiscoverResponse(cached.data), cached: true, query_context: queryContext });
+        return;
+      }
+    }
+    try {
+      const data = await apiPost("/api/ads/google/keywords/discover", body);
+      if (useCache) {
+        cacheSet("keywords", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      warnDefaults(queryContext);
+      const stamped = stampDiscoverResponse(data);
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(stamped.keywords, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data: stamped, fields: PLANNER_FIELD_DESCRIPTIONS, query_context: queryContext });
+    } catch (err) {
+      handleKeywordError(err);
+    }
+  }
+});
+export {
+  discoverCommand,
+  stampDiscoverResponse
+};
+//# sourceMappingURL=discover-C4TG7JP7.js.map