@koda-sl/baker-cli 0.513.0 → 0.515.0

package/dist/themes-B4LCQUXB.js

@@ -1,95 +0,0 @@
-import {
-  exitWithServiceReadError
-} from "./chunk-HGUYC5K6.js";
-import {
-  failWriteValidation,
-  listFlag,
-  requireCustomerId
-} from "./chunk-KBRJSPIM.js";
-import "./chunk-ERSX3MKH.js";
-import "./chunk-SCAGMX2I.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-QPESDKZC.js";
-import "./chunk-Y2JZX6JB.js";
-import "./chunk-4GAEB6NK.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-NSBNIPIW.js";
-import "./chunk-2TOIY2WN.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-B4LCQUXB.js.map

package/dist/top-companies-DJ2XQKMW.js

@@ -1,109 +0,0 @@
-import {
-  csvOrJson,
-  daysAgoIso,
-  handleLinkedinError,
-  todayIso
-} from "./chunk-PFTYKINE.js";
-import {
-  TABLE_OUTPUT_FORMATS,
-  outputFormatRefusal,
-  writeAdsJson,
-  writeAdsOutput,
-  writeJsonEnvelope
-} from "./chunk-ZRP7Y2DM.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-AGBBTTKA.js";
-import "./chunk-ZNNQK366.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-2TOIY2WN.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-DJ2XQKMW.js.map

package/dist/top-companies-DJ2XQKMW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/ads/linkedin/top-companies.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport {\n  outputFormatRefusal,\n  TABLE_OUTPUT_FORMATS,\n  writeAdsJson,\n  writeAdsOutput,\n  writeJsonEnvelope,\n} from \"../output.ts\";\nimport { csvOrJson, daysAgoIso, handleLinkedinError, todayIso } from \"./shared.ts\";\n\nconst COMPANIES_HINT =\n  \"For whole-account reach over months (one row per company, --by month|campaign, --with-domains), use `baker ads linkedin companies`.\";\n\ninterface AnalyticsResponse {\n  rows: Array<Record<string, unknown>>;\n  fields: string[];\n  warnings: Array<{ code: string; message: string }>;\n}\n\n/**\n * Top-companies — pivot=MEMBER_COMPANY shortcut. The single highest-leverage\n * LinkedIn-native query for ABM.\n *\n * pivotValues come back as [\"urn:li:organization:1234567\"]. The backend resolves\n * these org URNs to company names automatically (one batched, cached call), so\n * each row's pivot[] carries a `name`. URNs LinkedIn can't resolve stay unnamed —\n * use `baker ads linkedin resolve` to probe them individually.\n */\nexport const topCompaniesCommand = defineCommand({\n  meta: {\n    name: \"top-companies\",\n    description: `Top companies whose employees saw / clicked / converted on a campaign.\n\nWrapper for: analytics --pivot company. Returns rows sorted by impressions desc.\nEach row's pivot[] contains { urn, id, name } — org names are resolved automatically.\nCross-reference names against your target account list to spot audience leakage.\n\nDemographic data is delayed 12-24h with a ≥3-event privacy floor.\n\nExamples:\n  baker ads linkedin top-companies --campaign-id 1234 --last-days 30\n  baker ads linkedin top-companies --campaign-id 1,2,3 --intent revenue --last-days 90 --top-n 50\n  baker ads linkedin top-companies --campaign-id 1234 --output csv`,\n  },\n  args: {\n    \"campaign-id\": { type: \"string\", description: \"Comma-separated campaign IDs (required)\" },\n    intent: { type: \"string\", description: \"baseline | revenue | funnel | engagement | lead-gen (default: baseline)\" },\n    \"top-n\": { type: \"string\", description: \"Top rows by impressions (default: 25)\" },\n    start: { type: \"string\", description: \"Start date YYYY-MM-DD\" },\n    end: { type: \"string\", description: \"End date YYYY-MM-DD\" },\n    \"last-days\": { type: \"string\", description: \"Window relative to today (default: 30)\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const campaignIdsRaw = args[\"campaign-id\"] as string | undefined;\n    const invalid = !campaignIdsRaw\n      ? \"--campaign-id is required: one campaign id, or several comma-separated. For every company the whole ad account reached, use `baker ads linkedin companies`.\"\n      : outputFormatRefusal(csvOrJson(args), TABLE_OUTPUT_FORMATS);\n    if (invalid !== null || !campaignIdsRaw) {\n      writeAdsJson({ ok: false, error: { code: \"INVALID_ARGS\", message: invalid ?? \"\" } });\n      process.exit(1);\n    }\n    const ids = campaignIdsRaw\n      .split(\",\")\n      .map((s) => s.trim())\n      .filter(Boolean);\n    const intent = (args.intent as string | undefined) ?? \"baseline\";\n    const topN = args[\"top-n\"] ? Number(args[\"top-n\"]) : 25;\n\n    const start = (args.start as string | undefined) ?? daysAgoIso(args[\"last-days\"] ? Number(args[\"last-days\"]) : 30);\n    const end = (args.end as string | undefined) ?? todayIso();\n\n    try {\n      const data = await apiPost<AnalyticsResponse>(\"/api/ads/linkedin/analytics\", {\n        request: {\n          level: \"campaign\",\n          ids,\n          intent,\n          pivot: \"company\",\n          start,\n          end,\n          granularity: \"ALL\",\n          limit: 500,\n        },\n        skipCache: Boolean(args[\"no-cache\"]),\n      });\n\n      const top = [...data.rows].sort((a, b) => Number(b.impressions ?? 0) - Number(a.impressions ?? 0)).slice(0, topN);\n\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(top, fmt, data.fields, [COMPANIES_HINT]);\n        return;\n      }\n      writeJsonEnvelope({\n        ok: true,\n        data: {\n          query: { campaigns: ids, start, end, intent, topN },\n          rows: top,\n          warnings: data.warnings,\n        },\n        hints: [COMPANIES_HINT],\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAY9B,IAAM,iBACJ;AAiBK,IAAM,sBAAsB,cAAc;AAAA,EAC/C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYf;AAAA,EACA,MAAM;AAAA,IACJ,eAAe,EAAE,MAAM,UAAU,aAAa,0CAA0C;AAAA,IACxF,QAAQ,EAAE,MAAM,UAAU,aAAa,0EAA0E;AAAA,IACjH,SAAS,EAAE,MAAM,UAAU,aAAa,wCAAwC;AAAA,IAChF,OAAO,EAAE,MAAM,UAAU,aAAa,wBAAwB;AAAA,IAC9D,KAAK,EAAE,MAAM,UAAU,aAAa,sBAAsB;AAAA,IAC1D,aAAa,EAAE,MAAM,UAAU,aAAa,yCAAyC;AAAA,IACrF,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,qBAAqB,SAAS,OAAO;AAAA,EAC9E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,iBAAiB,KAAK,aAAa;AACzC,UAAM,UAAU,CAAC,iBACb,gKACA,oBAAoB,UAAU,IAAI,GAAG,oBAAoB;AAC7D,QAAI,YAAY,QAAQ,CAAC,gBAAgB;AACvC,mBAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,gBAAgB,SAAS,WAAW,GAAG,EAAE,CAAC;AACnF,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM,MAAM,eACT,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACjB,UAAM,SAAU,KAAK,UAAiC;AACtD,UAAM,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI;AAErD,UAAM,QAAS,KAAK,SAAgC,WAAW,KAAK,WAAW,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI,EAAE;AACjH,UAAM,MAAO,KAAK,OAA8B,SAAS;AAEzD,QAAI;AACF,YAAM,OAAO,MAAM,QAA2B,+BAA+B;AAAA,QAC3E,SAAS;AAAA,UACP,OAAO;AAAA,UACP;AAAA,UACA;AAAA,UACA,OAAO;AAAA,UACP;AAAA,UACA;AAAA,UACA,aAAa;AAAA,UACb,OAAO;AAAA,QACT;AAAA,QACA,WAAW,QAAQ,KAAK,UAAU,CAAC;AAAA,MACrC,CAAC;AAED,YAAM,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,EAAE,eAAe,CAAC,IAAI,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;AAEhH,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,KAAK,KAAK,KAAK,QAAQ,CAAC,cAAc,CAAC;AACtD;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB,IAAI;AAAA,QACJ,MAAM;AAAA,UACJ,OAAO,EAAE,WAAW,KAAK,OAAO,KAAK,QAAQ,KAAK;AAAA,UAClD,MAAM;AAAA,UACN,UAAU,KAAK;AAAA,QACjB;AAAA,QACA,OAAO,CAAC,cAAc;AAAA,MACxB,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/transcript-J3LGOHCM.js

@@ -1,163 +0,0 @@
-import {
-  transcriptHints
-} from "./chunk-TTLD66NI.js";
-import {
-  handleResearchError,
-  writeResearchJson
-} from "./chunk-GSKZ3ZDO.js";
-import "./chunk-ZNNQK366.js";
-import "./chunk-CAZGM2NX.js";
-import "./chunk-NZS3KEQ2.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-NSBNIPIW.js";
-import "./chunk-2TOIY2WN.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-J3LGOHCM.js.map

package/dist/transcript-J3LGOHCM.js.map

@@ -1 +0,0 @@
-{"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":[]}