@koda-sl/baker-cli 0.499.0 → 0.501.0

package/dist/{setup-links-QF6FIS6N.js → setup-links-E2GARNTU.js}

@@ -4,8 +4,8 @@ import {
 import {
   failApi,
   failValidation
-} from "./chunk-G6AK5QGY.js";
-import "./chunk-RLDQDCW3.js";
+} from "./chunk-XYBSTW3P.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -139,4 +139,4 @@ export {
   createBody,
   setupLinksCommand
 };
-//# sourceMappingURL=setup-links-QF6FIS6N.js.map
+//# sourceMappingURL=setup-links-E2GARNTU.js.map

package/dist/{shopify-OXUYVDND.js → shopify-GT6PJ77M.js}

@@ -26,8 +26,8 @@ import {
 } from "./chunk-PFBQERWX.js";
 import {
   failApi
-} from "./chunk-G6AK5QGY.js";
-import "./chunk-RLDQDCW3.js";
+} from "./chunk-XYBSTW3P.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -3953,4 +3953,4 @@ Full guide: __tooling__/docs/tools/baker/shopify.md`
 export {
   shopifyCommand
 };
-//# sourceMappingURL=shopify-OXUYVDND.js.map
+//# sourceMappingURL=shopify-GT6PJ77M.js.map

package/dist/{site-YVZQSAIW.js → site-TMF2P7JR.js}

@@ -2,8 +2,8 @@ import {
   SiteArgsError,
   failSite,
   parseSetArgs
-} from "./chunk-4WGAB5K3.js";
-import "./chunk-RLDQDCW3.js";
+} from "./chunk-HNS5OURO.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -169,10 +169,10 @@ Full guide: __tooling__/docs/tools/baker/site.md`
     show: showCommand,
     set: setCommand,
     unstage: unstageCommand,
-    domain: () => import("./domain-FP3X4RPV.js").then((m) => m.domainCommand)
+    domain: () => import("./domain-ZRWUGUOO.js").then((m) => m.domainCommand)
   }
 });
 export {
   siteCommand
 };
-//# sourceMappingURL=site-YVZQSAIW.js.map
+//# sourceMappingURL=site-TMF2P7JR.js.map

package/dist/{sources-NWM6SI4P.js → sources-47LE2UCO.js}

@@ -1,17 +1,17 @@
 import {
   hubspotDefaultMapping,
   hubspotTriggerInputSchema
-} from "./chunk-YZGG5JFI.js";
+} from "./chunk-AIOICB5Q.js";
 import {
   hubspotRefusal
-} from "./chunk-OK3GNRAN.js";
-import "./chunk-DB3CF4W3.js";
+} from "./chunk-N4CHIGLO.js";
+import "./chunk-WAEWKD75.js";
 import "./chunk-GRQ2AXDX.js";
 import {
   ConversionArgsError,
   onlyOnce
-} from "./chunk-MU3Z55CT.js";
-import "./chunk-KT5HHR4A.js";
+} from "./chunk-DX46OE4U.js";
+import "./chunk-DI44SZVP.js";
 import {
   SOURCE_FIELD_NAMES,
   mappingRowProblem,
@@ -20,14 +20,14 @@ import {
 import {
   writeJsonEnvelope
 } from "./chunk-ZRP7Y2DM.js";
-import "./chunk-G6AK5QGY.js";
+import "./chunk-XYBSTW3P.js";
 import {
   HUBSPOT_DEAL_CONTACTS,
   HUBSPOT_OBJECTS,
   REJECTION_MESSAGES,
   readsAssociatedContact,
   validateEventName
-} from "./chunk-RLDQDCW3.js";
+} from "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -452,4 +452,4 @@ export {
   sourcesCommand,
   sourcesRequest
 };
-//# sourceMappingURL=sources-NWM6SI4P.js.map
+//# sourceMappingURL=sources-47LE2UCO.js.map

package/dist/{sources-3IVHGGTH.js → sources-H6XX2WBO.js}

@@ -16,15 +16,15 @@ Examples:
   baker testimonials sources remove <source-id>`
   },
   subCommands: {
-    add: () => import("./add-4ECK6KWH.js").then((m) => m.addCommand),
+    add: () => import("./add-3GL76LTP.js").then((m) => m.addCommand),
     list: () => import("./list-3HOASRXD.js").then((m) => m.listCommand),
-    sync: () => import("./sync-XKRY2D2J.js").then((m) => m.syncCommand),
-    schedule: () => import("./schedule-P3442SHR.js").then((m) => m.scheduleCommand),
-    reset: () => import("./reset-W4QDDUJ6.js").then((m) => m.resetCommand),
-    remove: () => import("./remove-2OCCFOLM.js").then((m) => m.removeCommand)
+    sync: () => import("./sync-HWTVXGOT.js").then((m) => m.syncCommand),
+    schedule: () => import("./schedule-7EQLO22N.js").then((m) => m.scheduleCommand),
+    reset: () => import("./reset-TDAMB4BO.js").then((m) => m.resetCommand),
+    remove: () => import("./remove-TY3AF5K5.js").then((m) => m.removeCommand)
   }
 });
 export {
   sourcesCommand
 };
-//# sourceMappingURL=sources-3IVHGGTH.js.map
+//# sourceMappingURL=sources-H6XX2WBO.js.map

package/dist/{stale-ZBULRUS7.js → stale-JTX5U752.js}

@@ -1,17 +1,17 @@
 import {
   staleCreatives
-} from "./chunk-5U62OLCB.js";
-import "./chunk-Y3LWPDK7.js";
-import "./chunk-ZFBIKJTV.js";
+} from "./chunk-PFGRHBQY.js";
+import "./chunk-VOAWBGRQ.js";
+import "./chunk-N7KICNZD.js";
+import "./chunk-5KDFRTMY.js";
+import "./chunk-WHBFXR6F.js";
 import "./chunk-DQVI7GCX.js";
 import "./chunk-EKX37C3T.js";
 import "./chunk-SWN6OHXG.js";
-import "./chunk-JO5R2VL6.js";
-import "./chunk-WHBFXR6F.js";
-import "./chunk-M64MKSUO.js";
+import "./chunk-VAHDJ5CK.js";
 import "./chunk-A3IQAONL.js";
-import "./chunk-6VE5U5V3.js";
-import "./chunk-O63C32SS.js";
+import "./chunk-VRP677NO.js";
+import "./chunk-QY4GBBOV.js";
 import "./chunk-3YJNSUNF.js";
 import "./chunk-QPESDKZC.js";
 import "./chunk-E44NXCTL.js";
@@ -31,7 +31,7 @@ import "./chunk-LNNTHEL7.js";
 import "./chunk-FOMFU2RX.js";
 import "./chunk-PSGIHSNC.js";
 import "./chunk-PONLPYD7.js";
-import "./chunk-RLDQDCW3.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -71,4 +71,4 @@ var staleCommand = defineCommand({
 export {
   staleCommand
 };
-//# sourceMappingURL=stale-ZBULRUS7.js.map
+//# sourceMappingURL=stale-JTX5U752.js.map

package/dist/{status-RUXOUOPA.js → status-3X3MECDY.js}

@@ -1,8 +1,8 @@
 import {
   failApi,
   failValidation
-} from "./chunk-G6AK5QGY.js";
-import "./chunk-RLDQDCW3.js";
+} from "./chunk-XYBSTW3P.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -60,4 +60,4 @@ var statusCommand = defineCommand({
 export {
   statusCommand
 };
-//# sourceMappingURL=status-RUXOUOPA.js.map
+//# sourceMappingURL=status-3X3MECDY.js.map

package/dist/{studio-LYHZFTA3.js → studio-Z4AJRIGP.js}

@@ -46,4 +46,4 @@ Full guide: __tooling__/docs/tools/baker/studio.md`
 export {
   studioCommand
 };
-//# sourceMappingURL=studio-LYHZFTA3.js.map
+//# sourceMappingURL=studio-Z4AJRIGP.js.map

package/dist/{sync-XKRY2D2J.js → sync-HWTVXGOT.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-EDWRTYEO.js";
 import {
   testimonialSourcesSyncRequestSchema
-} from "./chunk-RLDQDCW3.js";
+} from "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -52,4 +52,4 @@ var syncCommand = defineCommand({
 export {
   syncCommand
 };
-//# sourceMappingURL=sync-XKRY2D2J.js.map
+//# sourceMappingURL=sync-HWTVXGOT.js.map

package/dist/{sync-definition-HVHXWEDR.js → sync-definition-CAPYMYIS.js}

@@ -9,20 +9,20 @@ import {
   resolveCanvasPath,
   syncCreativeDefinitionBestEffort,
   syncDefinitionCommand
-} from "./chunk-HGWK47AD.js";
+} from "./chunk-C4I5NCMG.js";
 import "./chunk-FFG2OYVV.js";
 import "./chunk-PX3PUDK7.js";
-import "./chunk-Y3LWPDK7.js";
-import "./chunk-ZFBIKJTV.js";
+import "./chunk-VOAWBGRQ.js";
+import "./chunk-N7KICNZD.js";
+import "./chunk-5KDFRTMY.js";
+import "./chunk-WHBFXR6F.js";
 import "./chunk-DQVI7GCX.js";
 import "./chunk-EKX37C3T.js";
 import "./chunk-SWN6OHXG.js";
-import "./chunk-JO5R2VL6.js";
-import "./chunk-WHBFXR6F.js";
-import "./chunk-M64MKSUO.js";
+import "./chunk-VAHDJ5CK.js";
 import "./chunk-A3IQAONL.js";
-import "./chunk-6VE5U5V3.js";
-import "./chunk-O63C32SS.js";
+import "./chunk-VRP677NO.js";
+import "./chunk-QY4GBBOV.js";
 import "./chunk-3YJNSUNF.js";
 import "./chunk-QPESDKZC.js";
 import "./chunk-E44NXCTL.js";
@@ -41,7 +41,7 @@ import "./chunk-LNNTHEL7.js";
 import "./chunk-FOMFU2RX.js";
 import "./chunk-PSGIHSNC.js";
 import "./chunk-PONLPYD7.js";
-import "./chunk-RLDQDCW3.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -64,4 +64,4 @@ export {
   syncCreativeDefinitionBestEffort,
   syncDefinitionCommand
 };
-//# sourceMappingURL=sync-definition-HVHXWEDR.js.map
+//# sourceMappingURL=sync-definition-CAPYMYIS.js.map

package/dist/{tag-manager-F7PVTDBB.js → tag-manager-TU3FBSYO.js}

@@ -40,4 +40,4 @@ Full guide: __tooling__/docs/tools/baker/tag-manager.md`
 export {
   tagManagerCommand
 };
-//# sourceMappingURL=tag-manager-F7PVTDBB.js.map
+//# sourceMappingURL=tag-manager-TU3FBSYO.js.map

package/dist/{tags-K5FVDHPH.js → tags-75QCVBQB.js}

@@ -15,12 +15,12 @@ Examples:
   },
   subCommands: {
     list: () => import("./list-MMRU3ZLP.js").then((m) => m.tagsListCommand),
-    create: () => import("./create-TAYW7GJG.js").then((m) => m.tagsCreateCommand),
-    update: () => import("./update-ITHM3F2E.js").then((m) => m.tagsUpdateCommand),
-    delete: () => import("./delete-MHLZD4IH.js").then((m) => m.tagsDeleteCommand)
+    create: () => import("./create-BZWX5KLI.js").then((m) => m.tagsCreateCommand),
+    update: () => import("./update-G2KB3RIW.js").then((m) => m.tagsUpdateCommand),
+    delete: () => import("./delete-E575BF73.js").then((m) => m.tagsDeleteCommand)
   }
 });
 export {
   tagsCommand
 };
-//# sourceMappingURL=tags-K5FVDHPH.js.map
+//# sourceMappingURL=tags-75QCVBQB.js.map

package/dist/{tags-WPPGJN2C.js → tags-7BT63PUE.js}

@@ -1,7 +1,7 @@
 import {
   makeTagsCommand
-} from "./chunk-MVE26PWE.js";
-import "./chunk-RLDQDCW3.js";
+} from "./chunk-6QBSUYQZ.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -18,4 +18,4 @@ var tagsCommand = makeTagsCommand("videos", "video", "/api/videos/tags");
 export {
   tagsCommand
 };
-//# sourceMappingURL=tags-WPPGJN2C.js.map
+//# sourceMappingURL=tags-7BT63PUE.js.map

package/dist/{tags-PBUZJQHN.js → tags-7K5RSCHI.js}

@@ -1,7 +1,7 @@
 import {
   makeTagsCommand
-} from "./chunk-MVE26PWE.js";
-import "./chunk-RLDQDCW3.js";
+} from "./chunk-6QBSUYQZ.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -18,4 +18,4 @@ var tagsCommand = makeTagsCommand("testimonials", "testimonial", "/api/testimoni
 export {
   tagsCommand
 };
-//# sourceMappingURL=tags-PBUZJQHN.js.map
+//# sourceMappingURL=tags-7K5RSCHI.js.map

package/dist/{tags-6PQ37XO5.js → tags-IELH7YAY.js}

@@ -1,7 +1,7 @@
 import {
   makeTagsCommand
-} from "./chunk-MVE26PWE.js";
-import "./chunk-RLDQDCW3.js";
+} from "./chunk-6QBSUYQZ.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -18,4 +18,4 @@ var tagsCommand = makeTagsCommand("images", "image", "/api/images/tags");
 export {
   tagsCommand
 };
-//# sourceMappingURL=tags-6PQ37XO5.js.map
+//# sourceMappingURL=tags-IELH7YAY.js.map

package/dist/{tags-3U5K3EVI.js → tags-UPA4KKQZ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-PFBQERWX.js";
 import {
   TAG_IDENTIFYING_FIELD
-} from "./chunk-RLDQDCW3.js";
+} from "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -222,4 +222,4 @@ export {
   tagsCommand,
   unstageBody
 };
-//# sourceMappingURL=tags-3U5K3EVI.js.map
+//# sourceMappingURL=tags-UPA4KKQZ.js.map

package/dist/{targeting-criteria-OZ74V2DC.js → targeting-criteria-HJQ2FW6E.js}

@@ -96,8 +96,8 @@ Examples:
   },
   subCommands: {
     list: targetingCriteriaListCommand,
-    create: () => import("./promoted-tweet-writes-FDTWY3QV.js").then((m) => m.targetingCriteriaCreateCommand),
-    remove: () => import("./promoted-tweet-writes-FDTWY3QV.js").then((m) => m.targetingCriteriaRemoveCommand)
+    create: () => import("./promoted-tweet-writes-E4EJZM76.js").then((m) => m.targetingCriteriaCreateCommand),
+    remove: () => import("./promoted-tweet-writes-E4EJZM76.js").then((m) => m.targetingCriteriaRemoveCommand)
   },
   args: {
     "account-id": { type: "string", description: "X Ads account ID" },
@@ -110,4 +110,4 @@ Examples:
 export {
   targetingCriteriaCommand
 };
-//# sourceMappingURL=targeting-criteria-OZ74V2DC.js.map
+//# sourceMappingURL=targeting-criteria-HJQ2FW6E.js.map

package/dist/{targets-Y4I65HD2.js → targets-CBZ37ALP.js}

@@ -2,12 +2,12 @@ import {
   chatBody,
   failApi,
   failValidation
-} from "./chunk-CUFS24JZ.js";
-import "./chunk-7GK32PCR.js";
+} from "./chunk-3LFPQSSC.js";
+import "./chunk-ASRS37QE.js";
 import {
   TRIGGER_KIND_IDS,
   TRIGGER_TARGET_FIELD_IDS
-} from "./chunk-RLDQDCW3.js";
+} from "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -101,4 +101,4 @@ Full guide: __tooling__/docs/tools/baker/scheduled-agents.md`
 export {
   targetsCommand
 };
-//# sourceMappingURL=targets-Y4I65HD2.js.map
+//# sourceMappingURL=targets-CBZ37ALP.js.map

package/dist/{testimonials-XNBDJHEN.js → testimonials-4W6HI2PQ.js}

@@ -19,14 +19,14 @@ Full guide: __tooling__/docs/tools/baker/testimonials.md`
   },
   subCommands: {
     get: () => import("./get-OB3UGRPN.js").then((m) => m.getCommand),
-    search: () => import("./search-FZUJCC5F.js").then((m) => m.searchCommand),
-    list: () => import("./list-BQ5SNHNQ.js").then((m) => m.listCommand),
-    delete: () => import("./delete-GL4OMCDS.js").then((m) => m.deleteCommand),
-    tags: () => import("./tags-PBUZJQHN.js").then((m) => m.tagsCommand),
-    sources: () => import("./sources-3IVHGGTH.js").then((m) => m.sourcesCommand)
+    search: () => import("./search-YEYQDDLA.js").then((m) => m.searchCommand),
+    list: () => import("./list-Y4V276ND.js").then((m) => m.listCommand),
+    delete: () => import("./delete-37IIUYQU.js").then((m) => m.deleteCommand),
+    tags: () => import("./tags-7K5RSCHI.js").then((m) => m.tagsCommand),
+    sources: () => import("./sources-H6XX2WBO.js").then((m) => m.sourcesCommand)
   }
 });
 export {
   testimonialsCommand
 };
-//# sourceMappingURL=testimonials-XNBDJHEN.js.map
+//# sourceMappingURL=testimonials-4W6HI2PQ.js.map

package/dist/{top-companies-KMY4LVNU.js → top-companies-CW77UVK3.js}

@@ -3,7 +3,7 @@ import {
   daysAgoIso,
   handleLinkedinError,
   todayIso
-} from "./chunk-XFDHZJ3O.js";
+} from "./chunk-I46D7YXI.js";
 import {
   TABLE_OUTPUT_FORMATS,
   outputFormatRefusal,
@@ -14,7 +14,7 @@ import {
 import {
   NO_CACHE_ARG
 } from "./chunk-AGBBTTKA.js";
-import "./chunk-RLDQDCW3.js";
+import "./chunk-5MSRVAUZ.js";
 import "./chunk-CAZGM2NX.js";
 import "./chunk-NZS3KEQ2.js";
 import "./chunk-GIWHHCD6.js";
@@ -106,4 +106,4 @@ Examples:
 export {
   topCompaniesCommand
 };
-//# sourceMappingURL=top-companies-KMY4LVNU.js.map
+//# sourceMappingURL=top-companies-CW77UVK3.js.map

package/dist/transcript-FA2TOVPP.js

@@ -0,0 +1,163 @@
+import {
+  transcriptHints
+} from "./chunk-TESOYFMQ.js";
+import {
+  handleResearchError,
+  writeResearchJson
+} from "./chunk-GSKZ3ZDO.js";
+import "./chunk-5MSRVAUZ.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-ERSL4WZT.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-FA2TOVPP.js.map

package/dist/transcript-FA2TOVPP.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":[]}