@koda-sl/baker-cli 0.572.0 → 0.574.0

package/dist/adsets-HNFBX4LB.js

@@ -0,0 +1,182 @@
+import {
+  VIEWER_TABLE_COLUMNS,
+  adSetViewerRows,
+  audienceNamesOf,
+  flattenViewerRows,
+  readAudienceNames
+} from "./chunk-G6XKD7QE.js";
+import {
+  META_LIST_SHAPE_ARGS,
+  budgetUnitHints,
+  registerMetaListSchema,
+  shapeMetaListRows,
+  writeMetaListRows
+} from "./chunk-5IHZTLDH.js";
+import {
+  NAME_CONTAINS_ARG,
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg,
+  resolveEffectiveStatus,
+  statusFilterHints
+} from "./chunk-FCD5BPC5.js";
+import {
+  rememberedJev
+} from "./chunk-HZ7QUFUW.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsOutput
+} from "./chunk-VJUVTMHY.js";
+import {
+  holdUnbilledSpend
+} from "./chunk-T4HIFVNK.js";
+import {
+  findWorkspaceRoot
+} from "./chunk-CGLNCFAG.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-HPF3USL2.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
+import "./chunk-E2G2USTA.js";
+import "./chunk-EFZVDV7F.js";
+import "./chunk-U3LO5TDH.js";
+import "./chunk-TJTCHTR4.js";
+import {
+  apiGet
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/adsets.ts
+import path from "path";
+import { defineCommand } from "citty";
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  "campaign-id": { type: "string", description: "Filter to one campaign" },
+  "effective-status": { type: "string", description: "Comma-separated effective_status filter (overrides default)" },
+  "all-statuses": { type: "boolean", description: "Drop the default ACTIVE filter" },
+  "name-contains": NAME_CONTAINS_ARG,
+  limit: { type: "string", description: "Max rows (default 1000)" },
+  "no-cache": NO_CACHE_ARG,
+  audience: {
+    type: "boolean",
+    description: "Who each ad set reaches, instead of the compact row: a viewer per ad set \u2014 temperature (cold|warm|hot), what they already know (brand/offer/product), placements, and the reasons, read from its targeting, the account's audiences and the campaign objective. Start here before writing an ad for an ad set: baker ads meta adsets --campaign-id 6123 --audience --output json"
+  },
+  ...META_LIST_SHAPE_ARGS
+};
+async function readOrEmpty(path2, params, label, hints) {
+  try {
+    return await apiGet(path2, params);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "unknown error";
+    hints.push(`Could not read the account's ${label} (${message}); the viewer was read without them.`);
+    return [];
+  }
+}
+async function writeAdSetViewers(adSets, accountParams, format, hints) {
+  const [audiences, campaigns] = await Promise.all([
+    readOrEmpty("/api/ads/meta/audiences", accountParams, "audiences", hints),
+    readOrEmpty("/api/ads/meta/campaigns", accountParams, "campaigns", hints)
+  ]);
+  const root = findWorkspaceRoot(process.cwd()) ?? process.cwd();
+  const cacheDir = path.join(root, "canvas", ".cache");
+  const spent = [];
+  const readName = await readAudienceNames(
+    audienceNamesOf(adSets, audiences),
+    rememberedJev(path.join(cacheDir, "audience-names.json"), (u) => spent.push(u))
+  );
+  await holdUnbilledSpend(cacheDir, spent).catch(() => void 0);
+  const rows = adSetViewerRows(adSets, audiences, campaigns, readName);
+  if (rows.length > 0) {
+    hints.push(
+      `Write each ad for the viewer of the ad set it will run in, then record it in the creative's _definition.md: targetAdSet: "<ad set id>" and viewer: { temperature, knows, placements, source }.`
+    );
+  }
+  if (format === "md" || format === "csv") {
+    writeAdsOutput(flattenViewerRows(rows), format, [...VIEWER_TABLE_COLUMNS], hints);
+    return;
+  }
+  writeAdsOutput(rows, format, void 0, hints);
+}
+registerMetaListSchema(
+  "adsets",
+  "List ad sets in a Meta ad account, as a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event, bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting is not in the compact row \u2014 ask for it with --fields id,name,targeting (or --full). --audience replaces the row with who each ad set reaches (a viewer: temperature, what they already know, placements, reasons) \u2014 read it before writing an ad for an ad set. Start here: baker ads meta adsets --campaign-id 6123 --all-statuses. --output json returns the rows in the envelope.",
+  listArgs
+);
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List ad sets in a Meta ad account. Runs by default when no subcommand is given. Example: baker ads meta adsets --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = await resolveAccountIdArg(args);
+    const effectiveStatus = resolveEffectiveStatus(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["campaign-id"]) params["campaign-id"] = args["campaign-id"];
+      if (effectiveStatus) params["effective-status"] = effectiveStatus;
+      if (args["name-contains"]) params["name-contains"] = args["name-contains"];
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/meta/adsets", params);
+      if (args.audience) {
+        const hints = statusFilterHints(data, effectiveStatus, "ad sets");
+        const accountParams = { "account-id": accountId };
+        if (args["no-cache"]) accountParams["skip-cache"] = "true";
+        await writeAdSetViewers(data, accountParams, csvOrJson(args), hints);
+        return;
+      }
+      const shaped = shapeMetaListRows("adsets", data, args);
+      writeMetaListRows("adsets", shaped, csvOrJson(args), [
+        ...statusFilterHints(data, effectiveStatus, "ad sets"),
+        ...budgetUnitHints(data)
+      ]);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var adsetsCommand = defineCommand({
+  meta: {
+    name: "adsets",
+    description: `List ad sets in a Meta ad account, or stage writes (create/update/pause/resume/archive/delete/duplicate/copy).
+Defaults to ACTIVE only. Write subcommands stage ops on this chat's draft.
+
+Listings print a table by default: id, name, campaign_id, effective_status, optimization_goal, billing_event,
+bid_strategy, budgets, destination_type, is_dynamic_creative, learning_stage, end_time, created_time. Targeting
+is not in the compact row \u2014 ask for it with --fields (dotted paths) or --full. --output json returns the rows as JSON.
+
+Examples:
+  baker ads meta adsets --account-id act_123
+  baker ads meta adsets --campaign-id 6123456789
+  baker ads meta adsets --account-id act_123 --all-statuses --name-contains retargeting   \u2014 find one ad set by name
+  baker ads meta adsets --campaign-id 6123456789 --fields id,name,targeting.geo_locations
+  baker ads meta adsets --campaign-id 6123456789 --audience --output json   \u2014 who each ad set reaches (viewer per ad set)
+  baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-XFYXMTXO.js").then((m) => m.adSetsCreateCommand),
+    update: () => import("./write-commands-XFYXMTXO.js").then((m) => m.adSetsUpdateCommand),
+    pause: () => import("./write-commands-XFYXMTXO.js").then((m) => m.adSetsPauseCommand),
+    resume: () => import("./write-commands-XFYXMTXO.js").then((m) => m.adSetsResumeCommand),
+    archive: () => import("./write-commands-XFYXMTXO.js").then((m) => m.adSetsArchiveCommand),
+    delete: () => import("./write-commands-XFYXMTXO.js").then((m) => m.adSetsDeleteCommand),
+    duplicate: () => import("./write-commands-XFYXMTXO.js").then((m) => m.adSetsDuplicateCommand),
+    copy: () => import("./copy-writes-ER5ZB5C4.js").then((m) => m.adSetsCopyCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for the
+  // subcommand name using THIS command's arg defs, so without them `--account-id act_1`
+  // would read `act_1` as a subcommand. `default` (not `run`) dispatches the bare
+  // invocation — citty falls through to `run` after a subcommand, double-executing it.
+  args: listArgs,
+  default: "list"
+});
+export {
+  adsetsCommand
+};
+//# sourceMappingURL=adsets-HNFBX4LB.js.map

package/dist/advertisers-RVTUZ53M.js

@@ -0,0 +1,123 @@
+import {
+  advertisersHints
+} from "./chunk-P3CYWSTO.js";
+import {
+  RESEARCH_DATA_NOTE,
+  handleResearchError,
+  writeResearchHints,
+  writeResearchJson,
+  writeResearchOutput
+} from "./chunk-7PKEBTVP.js";
+import {
+  buildResearchQueryContext,
+  warnDefaults
+} from "./chunk-IGCS3X4F.js";
+import "./chunk-BMMXYR7A.js";
+import "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/advertisers.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.advertisers",
+  description: 'Returns a ranked list of domains competing for one keyword in Google, with avg SERP position, relevance rating, estimated traffic value and visibility \u2014 domain economics, not ad copy. Despite the name it returns no headlines, descriptions or creative of any kind; for a competitor\'s actual ad copy use `baker research google-ads <competitor.com> --copy` (Google) or `baker winning-ads content <adId>` (Meta/LinkedIn). Start here: `baker research advertisers "<keyword>" --location <cc> --language <code>` to size up who owns a term. If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.',
+  args: {
+    keyword: {
+      type: "string",
+      description: "Keyword to search (positional). One search term, not a brand or a domain \u2014 this is a SERP query, not an advertiser lookup",
+      required: true
+    },
+    location: {
+      type: "string",
+      description: "Country code (us, uk, es, de...) or DataForSEO location code. Defaults to us (United States) if omitted \u2014 always set this for non-US markets",
+      required: false
+    },
+    language: {
+      type: "string",
+      description: "Language code or name (en, es, spanish...). Defaults to en (English) if omitted \u2014 always set this for non-English markets",
+      required: false
+    },
+    limit: { type: "string", description: "Max results (default: 20, max: 100)", required: false },
+    "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false }
+  }
+});
+var FIELDS = {
+  domain: "Competing domain (no ad copy is returned \u2014 see hints)",
+  avg_position: "Average SERP position (1 = top)",
+  rating: "Domain relevance rating (0-100)",
+  etv: "Estimated traffic value (USD)",
+  visibility: "SERP visibility score (0-1)"
+};
+var advertisersCommand = defineCommand({
+  meta: {
+    name: "advertisers",
+    description: `Domains competing for a keyword in Google SERPs, with position, relevance, traffic value and visibility. Returns NO ad copy \u2014 for a competitor's headlines and body copy use \`baker research google-ads <competitor.com> --copy\` (Google) or \`baker winning-ads content <adId>\` (Meta/LinkedIn).
+
+Examples:
+  baker research advertisers "running shoes"
+  baker research advertisers "crm software" --location uk --limit 10
+  baker research advertisers "zapatos" --location es --language spanish`
+  },
+  args: {
+    keyword: { type: "positional", description: "Keyword to search", required: true },
+    location: { type: "string", description: "Country code or location code (default: us)", required: false },
+    language: { type: "string", description: "Language code or name (default: en)", required: false },
+    limit: { type: "string", description: "Max results (default: 20, max: 100)", 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 keyword = args.keyword;
+    const location = args.location || void 0;
+    const language = args.language || void 0;
+    const limit = args.limit ? Number(args.limit) : void 0;
+    const skipCache = args["no-cache"] ? true : void 0;
+    const queryContext = buildResearchQueryContext(location, language);
+    try {
+      const data = await apiPost("/api/research/advertisers", {
+        keyword,
+        location,
+        language,
+        limit,
+        skipCache
+      });
+      warnDefaults(queryContext);
+      const format = args.output || "json";
+      const hints = advertisersHints(data.length, queryContext);
+      if (format !== "json") {
+        writeResearchOutput(data, format);
+        writeResearchHints(hints, format);
+        return;
+      }
+      writeResearchJson({
+        ok: true,
+        data,
+        fields: FIELDS,
+        note: RESEARCH_DATA_NOTE,
+        query_context: queryContext,
+        hints
+      });
+    } catch (err) {
+      handleResearchError(err);
+    }
+  }
+});
+export {
+  advertisersCommand
+};
+//# sourceMappingURL=advertisers-RVTUZ53M.js.map

package/dist/advertisers-YTG6VA6R.js

@@ -0,0 +1,125 @@
+import {
+  reportError,
+  splitList
+} from "./chunk-VRQ5HEVU.js";
+import {
+  apiGet
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  applyFieldMask,
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/advertisers.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.advertisers",
+  description: "List brands in the shared ad-dna corpus by name or domain. Use it to find your OWN advertiser (to --exclude-advertiser on search) or a competitor (to --advertiser-id on search / winners).",
+  args: {
+    query: { type: "string", description: "Brand name or domain to match (case-insensitive)", required: false },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    limit: { type: "number", description: "Max results 1-100 (default 20)", required: false, default: 20 },
+    offset: { type: "number", description: "Skip N results (pagination)", required: false, default: 0 }
+  }
+});
+function compactAdvertiser(record) {
+  return {
+    advertiser_id: String(record.advertiser_id ?? ""),
+    label: record.label ?? null,
+    platform_count: record.platform_count ?? null,
+    family_count: record.family_count ?? null,
+    active_ad_count: record.active_ad_count ?? null,
+    total_ad_count: record.total_ad_count ?? null
+  };
+}
+function advertiserNormalizer(record, full) {
+  const compact = compactAdvertiser(record);
+  if (!full) {
+    return compact;
+  }
+  return {
+    ...compact,
+    scraped_name: record.scraped_name ?? null,
+    image_url: record.image_url ?? null,
+    platforms: Array.isArray(record.platforms) ? record.platforms : [],
+    total_reach: record.total_reach ?? null,
+    last_synced_at: record.last_synced_at ?? null
+  };
+}
+var advertisersCommand = defineCommand({
+  meta: {
+    name: "advertisers",
+    description: 'List corpus advertisers by name or domain. Find your own advertiser for --exclude-advertiser, or a competitor for --advertiser-id / winners. Example: baker winning-ads advertisers "Deel" --output md'
+  },
+  args: {
+    query: { type: "positional", description: "Brand name or domain", required: false },
+    platform: {
+      type: "string",
+      description: "Filter to a single platform: meta|linkedin|tiktok|google",
+      required: false
+    },
+    limit: { type: "string", description: "Max results (default 20)", required: false },
+    offset: { type: "string", description: "Skip N results (pagination)", 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 image, platforms, reach, last-synced",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = {};
+      const query = args.query;
+      if (query) {
+        params.q = query;
+      }
+      if (args.platform) {
+        params.platform = String(args.platform);
+      }
+      if (args.limit) {
+        params.limit = String(args.limit);
+      }
+      if (args.offset) {
+        params.offset = String(args.offset);
+      }
+      const data = await apiGet("/api/ad-library/advertisers", params);
+      const output = args.output || "json";
+      const full = args.full;
+      const rawList = Array.isArray(data?.advertisers) ? data.advertisers : [];
+      if (output === "json") {
+        const fields = splitList(args.fields);
+        const advertisers = rawList.map((a) => {
+          const row = advertiserNormalizer(a, full);
+          return fields.length > 0 ? applyFieldMask(row, fields) : row;
+        });
+        writeJson({ ok: true, data: { advertisers, total: data?.total ?? null } });
+        return;
+      }
+      writeOutput(
+        { ok: true, data: rawList },
+        output,
+        args.fields ? args.fields.split(",") : void 0,
+        full,
+        advertiserNormalizer
+      );
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  advertisersCommand
+};
+//# sourceMappingURL=advertisers-YTG6VA6R.js.map

package/dist/alerts-LZJAF4AQ.js

@@ -0,0 +1,151 @@
+import {
+  invalidArgsMessage
+} from "./chunk-UYOUNHUQ.js";
+import "./chunk-MNJT2F7H.js";
+import "./chunk-IPEQHZ5H.js";
+import "./chunk-GRQ2AXDX.js";
+import "./chunk-VJUVTMHY.js";
+import {
+  failApi
+} from "./chunk-MUU27AJF.js";
+import {
+  calendarDaySchema
+} from "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/accounts/alerts.ts
+import { z } from "zod";
+var ACCOUNTS_ALERTS_DEFAULT_LIMIT = 100;
+var ACCOUNTS_ALERTS_MAX_LIMIT = 1e3;
+var accountsAlertsRequestSchema = z.object({
+  /** Alerts on or after this day (UTC), `YYYY-MM-DD`. */
+  since: calendarDaySchema.optional(),
+  /** One company's alerts: its LinkedIn id or `urn:li:organization:` URN. */
+  orgId: z.string().transform((value) => value.replace(/^urn:li:organization:/, "")).pipe(z.string().regex(/^\d+$/, "use the LinkedIn company id or its urn:li:organization URN")).optional(),
+  limit: z.number().int().min(1).max(ACCOUNTS_ALERTS_MAX_LIMIT).default(ACCOUNTS_ALERTS_DEFAULT_LIMIT),
+  /** Each alert's Scheduled agent id, run and month too. */
+  full: z.boolean().default(false)
+});
+var accountAlertSchema = z.object({
+  /** LinkedIn organization id. */
+  orgId: z.string(),
+  name: z.string(),
+  domain: z.string(),
+  /** When the alert went out, ISO. */
+  alertedAt: z.string(),
+  isTarget: z.boolean(),
+  /** Its tier on the target list; null when none. */
+  tier: z.string().nullable(),
+  /** The Scheduled agent that was told, by name. */
+  agent: z.string(),
+  /** `--full` only. */
+  scheduledAgentId: z.string().optional(),
+  /** `--full` only: the run the alert opened; null when the agent held it (an AI check, an occurrences rule). */
+  runChatId: z.string().nullable().optional(),
+  /** `--full` only: the month it warmed in, `YYYY-MM`. */
+  month: z.string().optional()
+});
+var accountsAlertsResponseSchema = z.object({
+  ok: z.literal(true),
+  data: z.object({
+    alerts: z.array(accountAlertSchema),
+    /** More alerts match than `limit` returned. */
+    truncated: z.boolean()
+  })
+});
+
+// src/commands/accounts/alerts.ts
+import { defineCommand } from "citty";
+function alertsHints(data, request) {
+  if (data.alerts.length === 0) {
+    return [
+      "No warm-account alert has gone out in this period. Alerts come from a Scheduled agent on the account.warmed trigger (`baker scheduled-agents`)."
+    ];
+  }
+  const targets = data.alerts.filter((alert) => alert.isTarget).length;
+  const hints = [
+    `${targets} of ${data.alerts.length} alerted companies are target accounts.`,
+    "To see what came of them: `baker accounts company <domain>` for one company's deals, or `baker accounts influenced --basis open --targets <file>` for the pipeline."
+  ];
+  if (data.truncated) hints.push(`More alerts match than --limit ${request.limit}; raise it, or narrow with --since.`);
+  return hints;
+}
+var ALERTS_ARGS = {
+  since: {
+    type: "string",
+    description: "Alerts on or after this day, YYYY-MM-DD (default: all kept)",
+    required: false
+  },
+  company: {
+    type: "string",
+    description: "One company's alerts: its LinkedIn company id or urn:li:organization URN",
+    required: false
+  },
+  limit: {
+    type: "string",
+    description: `Most alerts listed, newest first (1-${ACCOUNTS_ALERTS_MAX_LIMIT}, default ${ACCOUNTS_ALERTS_DEFAULT_LIMIT})`,
+    required: false
+  },
+  full: {
+    type: "boolean",
+    description: "Each alert's Scheduled agent id, run id and month too",
+    required: false,
+    default: false
+  }
+};
+registerSchema({
+  command: "accounts.alerts",
+  description: "Start here for 'which accounts did we alert sales about' or 'did the warm-account alerts lead anywhere'. Every warming company a Scheduled agent on the account.warmed trigger was handed, newest first: {orgId, name, domain, alertedAt, isTarget, tier, agent}. Each agent hears a company at most once a month. --since YYYY-MM-DD, --company <LinkedIn id> for one company's, --full adds scheduledAgentId, runChatId and month. Then `baker accounts company <domain>` shows what happened with that company's deals.",
+  args: ALERTS_ARGS
+});
+function optionalString(raw) {
+  return typeof raw === "string" && raw.trim() !== "" ? raw.trim() : void 0;
+}
+var alertsCommand = defineCommand({
+  meta: {
+    name: "alerts",
+    description: "Every warming company a warm-account alert named, newest first. Example: baker accounts alerts --since 2026-10-01"
+  },
+  args: ALERTS_ARGS,
+  run: async ({ args }) => {
+    const limit = optionalString(args.limit);
+    const parsed = accountsAlertsRequestSchema.safeParse({
+      since: optionalString(args.since),
+      orgId: optionalString(args.company),
+      ...limit === void 0 ? {} : { limit: Number(limit) },
+      full: Boolean(args.full)
+    });
+    if (!parsed.success) {
+      writeJson({ ok: false, error: { code: "INVALID_ARGS", message: invalidArgsMessage(parsed.error.issues) } });
+      process.exit(1);
+    }
+    try {
+      const response = await apiPost("/api/accounts/alerts", parsed.data);
+      const hints = alertsHints(response.data, parsed.data);
+      writeJson({ ...response, meta: { count: response.data.alerts.length }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  alertsCommand,
+  alertsHints
+};
+//# sourceMappingURL=alerts-LZJAF4AQ.js.map

package/dist/alerts-LZJAF4AQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/accounts/alerts.ts","../src/commands/accounts/alerts.ts"],"sourcesContent":["/**\n * Wire contract for `baker accounts alerts` — every warming company a \"When a\n * company warms up on your LinkedIn ads\" Scheduled agent was handed, newest\n * first: the record that answers \"which accounts did we alert sales about\",\n * read beside `baker accounts influenced` to see what came of them.\n */\n\nimport { z } from \"zod\";\nimport { calendarDaySchema } from \"../calendarDays\";\n\nexport const ACCOUNTS_ALERTS_DEFAULT_LIMIT = 100;\nexport const ACCOUNTS_ALERTS_MAX_LIMIT = 1000;\n\nexport const accountsAlertsRequestSchema = z.object({\n  /** Alerts on or after this day (UTC), `YYYY-MM-DD`. */\n  since: calendarDaySchema.optional(),\n  /** One company's alerts: its LinkedIn id or `urn:li:organization:` URN. */\n  orgId: z\n    .string()\n    .transform((value) => value.replace(/^urn:li:organization:/, \"\"))\n    .pipe(z.string().regex(/^\\d+$/, \"use the LinkedIn company id or its urn:li:organization URN\"))\n    .optional(),\n  limit: z.number().int().min(1).max(ACCOUNTS_ALERTS_MAX_LIMIT).default(ACCOUNTS_ALERTS_DEFAULT_LIMIT),\n  /** Each alert's Scheduled agent id, run and month too. */\n  full: z.boolean().default(false),\n});\nexport type AccountsAlertsRequest = z.input<typeof accountsAlertsRequestSchema>;\n\nexport const accountAlertSchema = z.object({\n  /** LinkedIn organization id. */\n  orgId: z.string(),\n  name: z.string(),\n  domain: z.string(),\n  /** When the alert went out, ISO. */\n  alertedAt: z.string(),\n  isTarget: z.boolean(),\n  /** Its tier on the target list; null when none. */\n  tier: z.string().nullable(),\n  /** The Scheduled agent that was told, by name. */\n  agent: z.string(),\n  /** `--full` only. */\n  scheduledAgentId: z.string().optional(),\n  /** `--full` only: the run the alert opened; null when the agent held it (an AI check, an occurrences rule). */\n  runChatId: z.string().nullable().optional(),\n  /** `--full` only: the month it warmed in, `YYYY-MM`. */\n  month: z.string().optional(),\n});\nexport type AccountAlert = z.infer<typeof accountAlertSchema>;\n\nexport const accountsAlertsResponseSchema = z.object({\n  ok: z.literal(true),\n  data: z.object({\n    alerts: z.array(accountAlertSchema),\n    /** More alerts match than `limit` returned. */\n    truncated: z.boolean(),\n  }),\n});\nexport type AccountsAlertsResponse = z.infer<typeof accountsAlertsResponseSchema>;\n","import {\n  ACCOUNTS_ALERTS_DEFAULT_LIMIT,\n  ACCOUNTS_ALERTS_MAX_LIMIT,\n  type AccountsAlertsResponse,\n  accountsAlertsRequestSchema,\n} from \"@baker/api/accounts/alerts\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi } from \"../actions/shared.ts\";\nimport { invalidArgsMessage } from \"./report.ts\";\n\n/**\n * `baker accounts alerts` — every warming company a \"When a company warms up\n * on your LinkedIn ads\" Scheduled agent was told about, newest first: what\n * sales heard, and when. Read beside `baker accounts influenced` to see what\n * came of it.\n */\n\n/** What to take from the alerts beyond their rows. Pure. */\nexport function alertsHints(data: AccountsAlertsResponse[\"data\"], request: { limit: number }): string[] {\n  if (data.alerts.length === 0) {\n    return [\n      \"No warm-account alert has gone out in this period. Alerts come from a Scheduled agent on the account.warmed trigger (`baker scheduled-agents`).\",\n    ];\n  }\n  const targets = data.alerts.filter((alert) => alert.isTarget).length;\n  const hints = [\n    `${targets} of ${data.alerts.length} alerted companies are target accounts.`,\n    \"To see what came of them: `baker accounts company <domain>` for one company's deals, or `baker accounts influenced --basis open --targets <file>` for the pipeline.\",\n  ];\n  if (data.truncated) hints.push(`More alerts match than --limit ${request.limit}; raise it, or narrow with --since.`);\n  return hints;\n}\n\nconst ALERTS_ARGS = {\n  since: {\n    type: \"string\",\n    description: \"Alerts on or after this day, YYYY-MM-DD (default: all kept)\",\n    required: false,\n  },\n  company: {\n    type: \"string\",\n    description: \"One company's alerts: its LinkedIn company id or urn:li:organization URN\",\n    required: false,\n  },\n  limit: {\n    type: \"string\",\n    description: `Most alerts listed, newest first (1-${ACCOUNTS_ALERTS_MAX_LIMIT}, default ${ACCOUNTS_ALERTS_DEFAULT_LIMIT})`,\n    required: false,\n  },\n  full: {\n    type: \"boolean\",\n    description: \"Each alert's Scheduled agent id, run id and month too\",\n    required: false,\n    default: false,\n  },\n} as const;\n\nregisterSchema({\n  command: \"accounts.alerts\",\n  description:\n    \"Start here for 'which accounts did we alert sales about' or 'did the warm-account alerts lead anywhere'. Every warming company a Scheduled agent on the account.warmed trigger was handed, newest first: {orgId, name, domain, alertedAt, isTarget, tier, agent}. Each agent hears a company at most once a month. --since YYYY-MM-DD, --company <LinkedIn id> for one company's, --full adds scheduledAgentId, runChatId and month. Then `baker accounts company <domain>` shows what happened with that company's deals.\",\n  args: ALERTS_ARGS,\n});\n\nfunction optionalString(raw: unknown): string | undefined {\n  return typeof raw === \"string\" && raw.trim() !== \"\" ? raw.trim() : undefined;\n}\n\nexport const alertsCommand = defineCommand({\n  meta: {\n    name: \"alerts\",\n    description:\n      \"Every warming company a warm-account alert named, newest first. Example: baker accounts alerts --since 2026-10-01\",\n  },\n  args: ALERTS_ARGS,\n  run: async ({ args }) => {\n    const limit = optionalString(args.limit);\n    const parsed = accountsAlertsRequestSchema.safeParse({\n      since: optionalString(args.since),\n      orgId: optionalString(args.company),\n      ...(limit === undefined ? {} : { limit: Number(limit) }),\n      full: Boolean(args.full),\n    });\n    if (!parsed.success) {\n      writeJson({ ok: false, error: { code: \"INVALID_ARGS\", message: invalidArgsMessage(parsed.error.issues) } });\n      process.exit(1);\n    }\n    try {\n      const response = await apiPost<AccountsAlertsResponse>(\"/api/accounts/alerts\", parsed.data);\n      const hints = alertsHints(response.data, parsed.data);\n      writeJson({ ...response, meta: { count: response.data.alerts.length }, ...(hints.length > 0 ? { hints } : {}) });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}