@koda-sl/baker-cli 0.467.0 → 0.469.0-dev.42f26270e

package/dist/demographics-RKEEKNDS.js

@@ -0,0 +1,138 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-Y74DTGZM.js";
+import {
+  writeAdsJson
+} from "./chunk-7FNZ5BR6.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-Z3GHDRUA.js";
+import "./chunk-RPJYEJDQ.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost
+} from "./chunk-L3EIZ7OV.js";
+import "./chunk-C4A5UGTT.js";
+import "./chunk-MSCFMNJP.js";
+import "./chunk-KCA5CDCU.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-RKEEKNDS.js.map

package/dist/describe-PNYNA24Q.js

@@ -0,0 +1,97 @@
+import {
+  describeErrorFix,
+  describeFields,
+  describeHints
+} from "./chunk-ZIXHS6AM.js";
+import "./chunk-ERSX3MKH.js";
+import {
+  ApiError,
+  apiPost,
+  validateConvexId
+} from "./chunk-L3EIZ7OV.js";
+import "./chunk-C4A5UGTT.js";
+import "./chunk-MSCFMNJP.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/describe.ts
+import { defineCommand } from "citty";
+var DESCRIPTION_HELP = "What the image actually shows, in the words someone would search for it by. This is what `baker images library` retrieves on.";
+registerSchema({
+  command: "images.describe",
+  description: "Correct a library image's stored name, description or tags. Start here when an image's description is wrong \u2014 it is what semantic search reads.",
+  args: {
+    id: { type: "string", description: "Image ID", required: true },
+    description: { type: "string", description: DESCRIPTION_HELP, required: false },
+    name: { type: "string", description: "Short human label for the image", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the image \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
+  }
+});
+var describeCommand = defineCommand({
+  meta: {
+    name: "describe",
+    description: `Correct what the library says an image is. Only the fields you pass change; the rest keep their current values.
+
+Start here when a search keeps missing an image you know is there, or when the AI description got the subject wrong.
+
+Example: baker images describe j571abc123 --description "Founder speaking on stage at SaaStr, blue backdrop" --tags event,team`
+  },
+  args: {
+    id: { type: "positional", description: "Image ID", required: false },
+    "image-id": { type: "string", description: "Image ID (alternative to positional)", required: false },
+    description: { type: "string", description: DESCRIPTION_HELP, required: false },
+    name: { type: "string", description: "Short human label for the image", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the image \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row", required: false, default: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    const id = args.id || args["image-id"];
+    if (!id) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Image ID is required" } });
+      process.exit(1);
+    }
+    const fields = describeFields(args, rawArgs);
+    if (fields.name === void 0 && fields.description === void 0 && fields.tags === void 0) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Nothing to change",
+          fix: "Pass at least one of --description, --name or --tags."
+        }
+      });
+      process.exit(1);
+    }
+    try {
+      validateConvexId(id);
+      const body = { id, ...fields };
+      if (args.full) body.full = true;
+      const data = await apiPost("/api/images/describe", body);
+      writeJson({ ok: true, data, hints: describeHints("images", fields) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const fix = describeErrorFix(err.code, "images");
+        writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  describeCommand
+};
+//# sourceMappingURL=describe-PNYNA24Q.js.map

package/dist/describe-UR7JDT6A.js

@@ -0,0 +1,97 @@
+import {
+  describeErrorFix,
+  describeFields,
+  describeHints
+} from "./chunk-ZIXHS6AM.js";
+import "./chunk-ERSX3MKH.js";
+import {
+  ApiError,
+  apiPost,
+  validateConvexId
+} from "./chunk-L3EIZ7OV.js";
+import "./chunk-C4A5UGTT.js";
+import "./chunk-MSCFMNJP.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/describe.ts
+import { defineCommand } from "citty";
+var DESCRIPTION_HELP = "What the clip actually shows, in the words someone would search for it by. This is what `baker videos search` retrieves on.";
+registerSchema({
+  command: "videos.describe",
+  description: "Correct a library video's stored name, description or tags. Start here when a clip's description is wrong \u2014 it is what semantic search reads.",
+  args: {
+    id: { type: "string", description: "Video ID", required: true },
+    description: { type: "string", description: DESCRIPTION_HELP, required: false },
+    name: { type: "string", description: "Short human label for the clip", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the clip \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row, not just what changed", required: false }
+  }
+});
+var describeCommand = defineCommand({
+  meta: {
+    name: "describe",
+    description: `Correct what the library says a video is. Only the fields you pass change; the rest keep their current values.
+
+Start here when a search keeps missing a clip you know is there, or when the AI description got the subject wrong.
+
+Example: baker videos describe j571abc123 --description "Customer explaining how onboarding cut their setup from a week to a day" --tags testimonial`
+  },
+  args: {
+    id: { type: "positional", description: "Video ID", required: false },
+    "video-id": { type: "string", description: "Video ID (alternative to positional)", required: false },
+    description: { type: "string", description: DESCRIPTION_HELP, required: false },
+    name: { type: "string", description: "Short human label for the clip", required: false },
+    tags: {
+      type: "string",
+      description: "Tags for the clip \u2014 repeatable (`--tags a --tags b`) or one comma list. **Replaces** the existing set",
+      required: false
+    },
+    full: { type: "boolean", description: "Return the whole library row", required: false, default: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    const id = args.id || args["video-id"];
+    if (!id) {
+      writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "Video ID is required" } });
+      process.exit(1);
+    }
+    const fields = describeFields(args, rawArgs);
+    if (fields.name === void 0 && fields.description === void 0 && fields.tags === void 0) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Nothing to change",
+          fix: "Pass at least one of --description, --name or --tags."
+        }
+      });
+      process.exit(1);
+    }
+    try {
+      validateConvexId(id);
+      const body = { id, ...fields };
+      if (args.full) body.full = true;
+      const data = await apiPost("/api/videos/describe", body);
+      writeJson({ ok: true, data, hints: describeHints("videos", fields) });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const fix = describeErrorFix(err.code, "videos");
+        writeJson({ ok: false, error: { code: err.code, message: err.message, ...fix ? { fix } : {} } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  describeCommand
+};
+//# sourceMappingURL=describe-UR7JDT6A.js.map

package/dist/dimensions-2RKIUOFQ.js

@@ -0,0 +1,101 @@
+import {
+  isRemoteUrl,
+  readImageBuffer
+} from "./chunk-PARNHNTP.js";
+import "./chunk-MGWBII65.js";
+import "./chunk-MSCFMNJP.js";
+import {
+  registerSchema,
+  writeJson,
+  writeOutput
+} from "./chunk-KCA5CDCU.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-2RKIUOFQ.js.map

package/dist/discard-QL7CZECC.js

@@ -0,0 +1,66 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-LAYWOVXE.js";
+import "./chunk-RPJYEJDQ.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-I2DNBEV6.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-L3EIZ7OV.js";
+import "./chunk-C4A5UGTT.js";
+import {
+  requireChatId
+} from "./chunk-MSCFMNJP.js";
+import {
+  registerSchema
+} from "./chunk-KCA5CDCU.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-QL7CZECC.js.map

package/dist/discover-AOZAQTHH.js

@@ -0,0 +1,93 @@
+import {
+  reportError
+} from "./chunk-UKBVKVRG.js";
+import {
+  apiPost
+} from "./chunk-L3EIZ7OV.js";
+import "./chunk-C4A5UGTT.js";
+import "./chunk-MSCFMNJP.js";
+import {
+  adLibraryUrl,
+  brandAccountInput,
+  registerSchema,
+  writeJson
+} from "./chunk-KCA5CDCU.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/discover.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.discover",
+  description: "See every ad account one paste finds for a brand, without following anything: `accounts` (linked from its website or named by your link \u2014 `follow` tracks these) and `suggestions` (only named like the brand \u2014 another country's page, or a stranger's). Each comes with `ads_url`, its public ad library to check it really is the brand's, and `input`, what to paste into `add-accounts`. Paid lookups; use it when you need to check before following, otherwise just `follow`.",
+  args: {
+    input: {
+      type: "string",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    },
+    full: {
+      type: "boolean",
+      description: "Every field the lookup returned (logo, category, ids), beside ads_url and input",
+      required: false,
+      default: false
+    }
+  }
+});
+function accountRow(account, full) {
+  const reach = { ads_url: adLibraryUrl(account), input: brandAccountInput(account) };
+  if (full) return { ...account, ...reach };
+  return { platform: account.platform, name: account.name, followers: account.followers, ...reach };
+}
+function discoverOutput(input, discovery, { full = false } = {}) {
+  const hints = [];
+  const { accounts, suggestions } = discovery;
+  if (accounts.length > 0) {
+    hints.push(
+      `\`accounts\` are certainly this brand's; following tracks all ${accounts.length}: baker winning-ads follow ${JSON.stringify(input)}.`
+    );
+  }
+  if (suggestions.length > 0) {
+    const inputs = JSON.stringify(suggestions.map(brandAccountInput).join(","));
+    hints.push(
+      `\`suggestions\` are only named like this brand \u2014 another country's or language's page, or a stranger's. Check each one's ads_url (or hand the links to the user) before tracking it; once the brand is followed, add the ones that are its own with: baker winning-ads add-accounts <advertiser_id> ${inputs} \u2014 dropping the rest.`
+    );
+  }
+  if (hints.length === 0) {
+    hints.push("Nothing found. Paste the brand's website (finds the most), or a profile or ad-library link.");
+  }
+  const row = (account) => accountRow(account, full);
+  return { data: { accounts: accounts.map(row), suggestions: suggestions.map(row) }, hints };
+}
+var discoverCommand = defineCommand({
+  meta: {
+    name: "discover",
+    description: 'List every account a brand runs ads from, without following. Example: baker winning-ads discover "barkibu.com"'
+  },
+  args: {
+    input: {
+      type: "positional",
+      description: "Website (best), brand name, or any profile/ad-library link",
+      required: true
+    },
+    full: {
+      type: "boolean",
+      description: "Every field the lookup returned, beside ads_url and input",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const input = String(args.input);
+      const discovery = await apiPost("/api/ad-library/discover", { input });
+      writeJson({ ok: true, ...discoverOutput(input, discovery, { full: Boolean(args.full) }) });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  discoverCommand,
+  discoverOutput
+};
+//# sourceMappingURL=discover-AOZAQTHH.js.map