@koda-sl/baker-cli 0.499.0 → 0.501.0-dev.6e96f50b9

package/dist/targeting-criteria-YHSVILGV.js

@@ -0,0 +1,113 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-7NF73SCB.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/targeting-criteria.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.targetingCriteria",
+  description: "List targeting criteria attached to line items in an X Ads account. Returns targeting_type, targeting_value, name, operator_type per criterion. Filter by line-item-ids.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var targetingCriteriaListCommand = defineCommand({
+  meta: {
+    name: "targeting-criteria",
+    description: `List targeting criteria attached to line items.
+
+Examples:
+  baker ads x targeting-criteria --account-id 18ce53xyz --line-item-ids abc`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `targeting-criteria:${accountId}:${args["line-item-ids"] ?? ""}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["line-item-ids"]) params["line-item-ids"] = args["line-item-ids"];
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/targeting-criteria", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+var targetingCriteriaCommand = defineCommand({
+  meta: {
+    name: "targeting-criteria",
+    description: `Targeting attached to ad groups \u2014 read it, or stage a change.
+
+X stores each criterion as its own entity, so one op targets one value. Look
+values up with \`baker ads x targeting-constants\` first.
+
+Examples:
+  baker ads x targeting-criteria --line-item-ids wiee9
+  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1
+  baker ads x targeting-criteria remove 1dmtken`
+  },
+  subCommands: {
+    list: targetingCriteriaListCommand,
+    create: () => import("./promoted-tweet-writes-27RR3GOV.js").then((m) => m.targetingCriteriaCreateCommand),
+    remove: () => import("./promoted-tweet-writes-27RR3GOV.js").then((m) => m.targetingCriteriaRemoveCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs" },
+    "no-cache": { type: "boolean", description: "Skip cache" },
+    output: { type: "string", description: "Format: json|csv|md", default: "json" }
+  },
+  default: "list"
+});
+export {
+  targetingCriteriaCommand
+};
+//# sourceMappingURL=targeting-criteria-YHSVILGV.js.map

package/dist/targets-4SZC7DR4.js

@@ -0,0 +1,104 @@
+import {
+  chatBody,
+  failApi,
+  failValidation
+} from "./chunk-GCGXKPZJ.js";
+import "./chunk-ASRS37QE.js";
+import {
+  TRIGGER_KIND_IDS,
+  TRIGGER_TARGET_FIELD_IDS
+} from "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/targets.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  trigger: {
+    type: "string",
+    description: "The trigger kind to point, e.g. task.claimed. `baker scheduled-agents triggers --trigger <kind>` lists its `pointAt` fields.",
+    required: true
+  },
+  field: {
+    type: "string",
+    description: `Which of its narrowings to list: ${TRIGGER_TARGET_FIELD_IDS.join(", ")}. Defaults to the kind's first.`,
+    required: false
+  },
+  search: { type: "string", description: "Only options whose name contains this.", required: false },
+  form: {
+    type: "string",
+    description: "With --field stepId: the Form (slug) whose steps to list.",
+    required: false
+  },
+  app: {
+    type: "string",
+    description: "With --trigger app.event and --field appEvent or account: the connected tool (slug) to list for.",
+    required: false
+  },
+  event: {
+    type: "string",
+    description: "With --field appEvent --app <tool>: describe ONE event whole \u2014 every setting (description, default, examples) and every field it sends. Read it before narrowing.",
+    required: false
+  }
+};
+registerSchema({
+  command: "scheduled-agents.targets",
+  description: "What a trigger can be pointed at: the open Tasks, the company's scheduled agents, its review sources, followed competitors, pages, Forms and their steps, Knowledge collections, tools. Returns each option's value (pass it to the matching flag on create/update) with its name.",
+  args: ARGS
+});
+var targetsCommand = defineCommand({
+  meta: {
+    name: "targets",
+    description: `What a trigger can be pointed at \u2014 so "when a Task is picked up" becomes "when THIS Task is picked up".
+
+Each trigger's narrowings (\`pointAt\` in \`triggers\`) are chosen from a list, the same list the user's picker shows. Pass an option's \`value\` to the flag the response names; leave the flag off to run on any.
+
+Examples:
+  baker scheduled-agents targets --trigger task.claimed --field taskId --search hero
+  baker scheduled-agents targets --trigger session.published --field agentId
+  baker scheduled-agents targets --trigger flow.step.submitted --field stepId --form quote
+  baker scheduled-agents targets --trigger advertiser.new_ads
+  baker scheduled-agents targets --trigger app.event --field toolkit
+  baker scheduled-agents targets --trigger app.event --field appEvent --app gmail
+  baker scheduled-agents targets --trigger app.event --field appEvent --app gmail --event GMAIL_NEW_GMAIL_MESSAGE
+Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const trigger = args.trigger;
+    if (!TRIGGER_KIND_IDS.some((kind) => kind === trigger)) {
+      failValidation(`--trigger must be one of: ${TRIGGER_KIND_IDS.join(", ")}.`);
+    }
+    try {
+      const response = await apiPost("/api/scheduled-agents/targets", {
+        trigger,
+        ...args.field ? { field: args.field } : {},
+        ...args.search ? { search: args.search } : {},
+        ...args.form ? { flowId: args.form } : {},
+        ...args.app ? { toolkit: args.app } : {},
+        ...args.event ? { event: args.event } : {},
+        ...chatBody()
+      });
+      writeJson(response);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  targetsCommand
+};
+//# sourceMappingURL=targets-4SZC7DR4.js.map

package/dist/testimonials-MJHMFJ5J.js

@@ -0,0 +1,32 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/testimonials/index.ts
+import { defineCommand } from "citty";
+var testimonialsCommand = defineCommand({
+  meta: {
+    name: "testimonials",
+    description: `Find and browse testimonials in Baker, and manage the review pages they come from. Subcommands: search, get, list, delete, tags, sources.
+
+Examples:
+  baker testimonials search "great customer service" --limit 5
+  baker testimonials search "value for money" --rating-min 4
+  baker testimonials get <testimonial-id>
+  baker testimonials list --source google --sentiment positive
+  baker testimonials delete <testimonial-id> --dry-run
+  baker testimonials tags
+  baker testimonials sources add https://www.yelp.com/biz/acme-bakery-madrid
+Full guide: __tooling__/docs/tools/baker/testimonials.md`
+  },
+  subCommands: {
+    get: () => import("./get-OB3UGRPN.js").then((m) => m.getCommand),
+    search: () => import("./search-OVFOPUXT.js").then((m) => m.searchCommand),
+    list: () => import("./list-CPTVS5DS.js").then((m) => m.listCommand),
+    delete: () => import("./delete-N34HCPOM.js").then((m) => m.deleteCommand),
+    tags: () => import("./tags-N3LP2WTK.js").then((m) => m.tagsCommand),
+    sources: () => import("./sources-JHPI7Q2O.js").then((m) => m.sourcesCommand)
+  }
+});
+export {
+  testimonialsCommand
+};
+//# sourceMappingURL=testimonials-MJHMFJ5J.js.map

package/dist/themes-GTWQLIX2.js

@@ -0,0 +1,95 @@
+import {
+  exitWithServiceReadError
+} from "./chunk-HGUYC5K6.js";
+import {
+  failWriteValidation,
+  listFlag,
+  requireCustomerId
+} from "./chunk-3VA52AHF.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-KJZPCLQE.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-Y2JZX6JB.js";
+import "./chunk-43PAN3L2.js";
+import {
+  getManagerIdForCustomer,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/keywords/themes.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  "customer-id": { type: "string", description: "Google Ads customer ID (10 digits, no dashes)" },
+  keywords: { type: "string", description: "Comma-separated keywords to place" },
+  "ad-groups": {
+    type: "string",
+    description: "Comma-separated existing ad group ids (or resource names) to sort them into \u2014 read them with `ad-groups list`"
+  }
+};
+registerSchema({
+  command: "ads.google.keywords.themes",
+  description: "Which existing ad group each keyword belongs in, by Google's reading of the ad groups' themes (Keyword Planner GenerateAdGroupThemes). Start here: `baker ads google keywords themes --customer-id 1234567890 --keywords \"solar panels,heat pumps\" --ad-groups 111,222`. Returns suggestions (keyword \u2192 suggested keyword, match type, ad group) and unusable_ad_groups (ones Google could not read a theme from).",
+  args: Object.fromEntries(
+    Object.entries(ARGS).map(([name, arg]) => [
+      name,
+      { type: arg.type, description: arg.description, required: false }
+    ])
+  )
+});
+var themesCommand = defineCommand({
+  meta: {
+    name: "themes",
+    description: `Sort keywords into the existing ad groups whose theme fits them (Keyword Planner).
+
+Example:
+  baker ads google keywords themes --customer-id 1234567890 --keywords "solar panels,heat pumps" --ad-groups 111,222`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    const keywords = listFlag(args.keywords);
+    const adGroups = listFlag(args["ad-groups"]);
+    if (!keywords?.length || !adGroups?.length) failWriteValidation("pass --keywords and --ad-groups");
+    const managerId = getManagerIdForCustomer(customerId);
+    try {
+      const { data } = await apiPost(
+        "/api/ads/google/keywords/themes",
+        {
+          customerId,
+          ...managerId ? { managerId } : {},
+          keywords,
+          adGroups
+        }
+      );
+      const hints = data.unusable_ad_groups.length > 0 ? [
+        `${data.unusable_ad_groups.length} ad group(s) gave Google no theme to match against (removed, empty or under a removed campaign) \u2014 they received no keywords.`
+      ] : [];
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      exitWithServiceReadError(err);
+    }
+  }
+});
+export {
+  themesCommand
+};
+//# sourceMappingURL=themes-GTWQLIX2.js.map

package/dist/top-companies-DSL2QVOH.js

@@ -0,0 +1,109 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-SGU5L5JS.js";
+import {
+  TABLE_OUTPUT_FORMATS,
+  outputFormatRefusal,
+  writeAdsJson,
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/top-companies.ts
+import { defineCommand } from "citty";
+var COMPANIES_HINT = "For whole-account reach over months (one row per company, --by month|campaign, --with-domains), use `baker ads linkedin companies`.";
+var topCompaniesCommand = defineCommand({
+  meta: {
+    name: "top-companies",
+    description: `Top companies whose employees saw / clicked / converted on a campaign.
+
+Wrapper for: analytics --pivot company. Returns rows sorted by impressions desc.
+Each row's pivot[] contains { urn, id, name } \u2014 org names are resolved automatically.
+Cross-reference names against your target account list to spot audience leakage.
+
+Demographic data is delayed 12-24h with a \u22653-event privacy floor.
+
+Examples:
+  baker ads linkedin top-companies --campaign-id 1234 --last-days 30
+  baker ads linkedin top-companies --campaign-id 1,2,3 --intent revenue --last-days 90 --top-n 50
+  baker ads linkedin top-companies --campaign-id 1234 --output csv`
+  },
+  args: {
+    "campaign-id": { type: "string", description: "Comma-separated campaign IDs (required)" },
+    intent: { type: "string", description: "baseline | revenue | funnel | engagement | lead-gen (default: baseline)" },
+    "top-n": { type: "string", description: "Top rows by impressions (default: 25)" },
+    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|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const campaignIdsRaw = args["campaign-id"];
+    const invalid = !campaignIdsRaw ? "--campaign-id is required: one campaign id, or several comma-separated. For every company the whole ad account reached, use `baker ads linkedin companies`." : outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);
+    if (invalid !== null || !campaignIdsRaw) {
+      writeAdsJson({ ok: false, error: { code: "INVALID_ARGS", message: invalid ?? "" } });
+      process.exit(1);
+    }
+    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
+    const intent = args.intent ?? "baseline";
+    const topN = args["top-n"] ? Number(args["top-n"]) : 25;
+    const start = args.start ?? daysAgoIso(args["last-days"] ? Number(args["last-days"]) : 30);
+    const end = args.end ?? todayIso();
+    try {
+      const data = await apiPost("/api/ads/linkedin/analytics", {
+        request: {
+          level: "campaign",
+          ids,
+          intent,
+          pivot: "company",
+          start,
+          end,
+          granularity: "ALL",
+          limit: 500
+        },
+        skipCache: Boolean(args["no-cache"])
+      });
+      const top = [...data.rows].sort((a, b) => Number(b.impressions ?? 0) - Number(a.impressions ?? 0)).slice(0, topN);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(top, fmt, data.fields, [COMPANIES_HINT]);
+        return;
+      }
+      writeJsonEnvelope({
+        ok: true,
+        data: {
+          query: { campaigns: ids, start, end, intent, topN },
+          rows: top,
+          warnings: data.warnings
+        },
+        hints: [COMPANIES_HINT]
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  topCompaniesCommand
+};
+//# sourceMappingURL=top-companies-DSL2QVOH.js.map

package/dist/transcript-FGLOJFU4.js

@@ -0,0 +1,163 @@
+import {
+  transcriptHints
+} from "./chunk-DNSXOUNC.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-GSKZ3ZDO.js";
+import "./chunk-MWD6JTOY.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-PTRCB7AR.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/transcript.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { defineCommand } from "citty";
+var EXCERPT_CHARS = 3e3;
+var TIMEOUT_MS = 54e4;
+registerSchema({
+  command: "research.transcript",
+  description: "The words of one long recording \u2014 a keynote, earnings call, webinar or podcast \u2014 so a leader's own phrasing can feed 1:1 ad and page messaging. A YouTube link is read from its captions; any other link must be the audio or video file itself. Nothing is added to the video library. Start here: `baker research transcript <url> --out transcript.txt`.",
+  args: {
+    url: {
+      type: "string",
+      description: "A YouTube link, or a direct link to an audio/video file (.mp3, .mp4, .m4a, \u2026) (positional)",
+      required: true
+    },
+    full: {
+      type: "boolean",
+      description: `Return the whole text instead of the first ${EXCERPT_CHARS} characters`,
+      required: false,
+      default: false
+    },
+    out: {
+      type: "string",
+      description: "Write the whole text to this file and return its path instead of the text",
+      required: false
+    }
+  }
+});
+var FIELDS = {
+  provider: "youtube \u2014 the video's captions; deepgram \u2014 the recording transcribed",
+  title: "The video's title (YouTube only), or null",
+  duration_sec: "Length of the recording in seconds, or null when unknown",
+  language: "The language spoken, as the provider names it",
+  word_count: "Words in the whole recording",
+  text_chars: "Length of the whole text available on the server",
+  excerpt: "The opening of the text (default output)",
+  text: "The whole text (--full)",
+  file: "Where the whole text was written (--out)",
+  truncated: "The recording was longer than one transcript carries, so the end is missing"
+};
+function transcriptFix(code) {
+  if (code === "VALIDATION_ERROR" || code === "BAD_REQUEST") {
+    return {
+      action: "retry_with_changes",
+      explanation: "Pass a YouTube link, or the direct link to the audio or video file \u2014 for a podcast, the episode's download link (its RSS enclosure), not the episode page."
+    };
+  }
+  if (code === "CONFLICT") {
+    return {
+      action: "continue_without",
+      explanation: "There are no words to read in this recording. Look for another recording of the same person, or write the brief from what you have."
+    };
+  }
+  if (code === "RATE_LIMITED") {
+    return {
+      action: "continue_without",
+      explanation: "The transcriber is busy. Do the rest of the job first and try this recording once more later."
+    };
+  }
+  return {
+    action: "continue_without",
+    explanation: "This recording couldn't be transcribed. Don't loop on it \u2014 finish the brief from your other sources and name this recording as a gap."
+  };
+}
+var transcriptCommand = defineCommand({
+  meta: {
+    name: "transcript",
+    description: `The words of one long recording \u2014 a keynote, earnings call, webinar or podcast \u2014 so a leader's own phrasing can feed 1:1 ad and page messaging.
+
+A YouTube link is read from its captions. Any other link must be the audio or video file itself (.mp3, .mp4, .m4a, \u2026): for a podcast, the episode's download link, not its page. Nothing is added to the video library.
+
+Default output is compact \u2014 title, length, word count and the opening of the text. Use --out to write the whole text to a file and read the parts you need.
+
+Examples:
+  baker research transcript "https://www.youtube.com/watch?v=<id>"
+  baker research transcript "https://www.youtube.com/watch?v=<id>" --out keynote.txt
+  baker research transcript "https://traffic.megaphone.fm/<episode>.mp3" --full`
+  },
+  args: {
+    url: { type: "positional", description: "A YouTube link, or a direct audio/video file link", required: false },
+    full: { type: "boolean", description: "Return the whole text", required: false },
+    out: { type: "string", description: "Write the whole text to this file", required: false }
+  },
+  run: async ({ args }) => {
+    const url = args.url;
+    if (!url) {
+      writeResearchJson({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "A recording link is required",
+          fix: transcriptFix("VALIDATION_ERROR")
+        }
+      });
+      process.exit(1);
+    }
+    const body = { url };
+    try {
+      const transcript = await apiPost("/api/research/transcript", body, {
+        timeoutMs: TIMEOUT_MS
+      });
+      const out = args.out;
+      let delivered;
+      let excerpted = false;
+      if (out) {
+        const file = resolve(out);
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, transcript.text, "utf-8");
+        delivered = { file };
+      } else if (args.full) {
+        delivered = { text: transcript.text };
+      } else {
+        excerpted = transcript.text.length > EXCERPT_CHARS;
+        delivered = { excerpt: transcript.text.slice(0, EXCERPT_CHARS) };
+      }
+      writeResearchJson({
+        ok: true,
+        data: {
+          url: transcript.url,
+          provider: transcript.provider,
+          title: transcript.title,
+          duration_sec: transcript.durationSec,
+          language: transcript.language,
+          word_count: transcript.wordCount,
+          text_chars: transcript.textChars,
+          truncated: transcript.truncated,
+          ...delivered
+        },
+        fields: FIELDS,
+        hints: transcriptHints({ excerpted, truncated: transcript.truncated })
+      });
+    } catch (err) {
+      handleResearchError(err, transcriptFix);
+    }
+  }
+});
+export {
+  transcriptCommand
+};
+//# sourceMappingURL=transcript-FGLOJFU4.js.map

package/dist/transcript-FGLOJFU4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/research/transcript.ts"],"sourcesContent":["import { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport type { ResearchTranscriptRequest, ResearchTranscriptResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { transcriptHints } from \"./hints.ts\";\nimport { handleResearchError, type ResearchFix, writeResearchJson } from \"./output.ts\";\n\n/**\n * A keynote is tens of thousands of words, more than a turn wants to carry, so\n * the default is the opening — enough to tell whether it is the right talk.\n */\nconst EXCERPT_CHARS = 3_000;\n\n/** An hour-long recording takes Deepgram well under a minute, but the default 60s leaves no margin. */\nconst TIMEOUT_MS = 540_000;\n\nregisterSchema({\n  command: \"research.transcript\",\n  description:\n    \"The words of one long recording — a keynote, earnings call, webinar or podcast — so a leader's own phrasing can feed 1:1 ad and page messaging. A YouTube link is read from its captions; any other link must be the audio or video file itself. Nothing is added to the video library. Start here: `baker research transcript <url> --out transcript.txt`.\",\n  args: {\n    url: {\n      type: \"string\",\n      description: \"A YouTube link, or a direct link to an audio/video file (.mp3, .mp4, .m4a, …) (positional)\",\n      required: true,\n    },\n    full: {\n      type: \"boolean\",\n      description: `Return the whole text instead of the first ${EXCERPT_CHARS} characters`,\n      required: false,\n      default: false,\n    },\n    out: {\n      type: \"string\",\n      description: \"Write the whole text to this file and return its path instead of the text\",\n      required: false,\n    },\n  },\n});\n\nconst FIELDS: Record<string, string> = {\n  provider: \"youtube — the video's captions; deepgram — the recording transcribed\",\n  title: \"The video's title (YouTube only), or null\",\n  duration_sec: \"Length of the recording in seconds, or null when unknown\",\n  language: \"The language spoken, as the provider names it\",\n  word_count: \"Words in the whole recording\",\n  text_chars: \"Length of the whole text available on the server\",\n  excerpt: \"The opening of the text (default output)\",\n  text: \"The whole text (--full)\",\n  file: \"Where the whole text was written (--out)\",\n  truncated: \"The recording was longer than one transcript carries, so the end is missing\",\n};\n\nfunction transcriptFix(code: string): ResearchFix {\n  if (code === \"VALIDATION_ERROR\" || code === \"BAD_REQUEST\") {\n    return {\n      action: \"retry_with_changes\",\n      explanation:\n        \"Pass a YouTube link, or the direct link to the audio or video file — for a podcast, the episode's download link (its RSS enclosure), not the episode page.\",\n    };\n  }\n  if (code === \"CONFLICT\") {\n    return {\n      action: \"continue_without\",\n      explanation:\n        \"There are no words to read in this recording. Look for another recording of the same person, or write the brief from what you have.\",\n    };\n  }\n  if (code === \"RATE_LIMITED\") {\n    return {\n      action: \"continue_without\",\n      explanation: \"The transcriber is busy. Do the rest of the job first and try this recording once more later.\",\n    };\n  }\n  return {\n    action: \"continue_without\",\n    explanation:\n      \"This recording couldn't be transcribed. Don't loop on it — finish the brief from your other sources and name this recording as a gap.\",\n  };\n}\n\nexport const transcriptCommand = defineCommand({\n  meta: {\n    name: \"transcript\",\n    description: `The words of one long recording — a keynote, earnings call, webinar or podcast — so a leader's own phrasing can feed 1:1 ad and page messaging.\n\nA YouTube link is read from its captions. Any other link must be the audio or video file itself (.mp3, .mp4, .m4a, …): for a podcast, the episode's download link, not its page. Nothing is added to the video library.\n\nDefault output is compact — title, length, word count and the opening of the text. Use --out to write the whole text to a file and read the parts you need.\n\nExamples:\n  baker research transcript \"https://www.youtube.com/watch?v=<id>\"\n  baker research transcript \"https://www.youtube.com/watch?v=<id>\" --out keynote.txt\n  baker research transcript \"https://traffic.megaphone.fm/<episode>.mp3\" --full`,\n  },\n  args: {\n    url: { type: \"positional\", description: \"A YouTube link, or a direct audio/video file link\", required: false },\n    full: { type: \"boolean\", description: \"Return the whole text\", required: false },\n    out: { type: \"string\", description: \"Write the whole text to this file\", required: false },\n  },\n  run: async ({ args }) => {\n    const url = args.url as string | undefined;\n    if (!url) {\n      writeResearchJson({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message: \"A recording link is required\",\n          fix: transcriptFix(\"VALIDATION_ERROR\"),\n        },\n      });\n      process.exit(1);\n    }\n\n    const body: ResearchTranscriptRequest = { url };\n\n    try {\n      const transcript = await apiPost<ResearchTranscriptResponse>(\"/api/research/transcript\", body, {\n        timeoutMs: TIMEOUT_MS,\n      });\n      const out = args.out as string | undefined;\n      let delivered: Record<string, string>;\n      let excerpted = false;\n      if (out) {\n        const file = resolve(out);\n        mkdirSync(dirname(file), { recursive: true });\n        writeFileSync(file, transcript.text, \"utf-8\");\n        delivered = { file };\n      } else if (args.full) {\n        delivered = { text: transcript.text };\n      } else {\n        excerpted = transcript.text.length > EXCERPT_CHARS;\n        delivered = { excerpt: transcript.text.slice(0, EXCERPT_CHARS) };\n      }\n\n      writeResearchJson({\n        ok: true,\n        data: {\n          url: transcript.url,\n          provider: transcript.provider,\n          title: transcript.title,\n          duration_sec: transcript.durationSec,\n          language: transcript.language,\n          word_count: transcript.wordCount,\n          text_chars: transcript.textChars,\n          truncated: transcript.truncated,\n          ...delivered,\n        },\n        fields: FIELDS,\n        hints: transcriptHints({ excerpted, truncated: transcript.truncated }),\n      });\n    } catch (err) {\n      handleResearchError(err, transcriptFix);\n    }\n  },\n});\n"],"mappings":"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","names":[]}