@nodaro/sdk 2.76.0 → 2.77.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/dist/{chunk-OO4AKYUN.js → chunk-3M7AHJG5.js} +52 -10
  2. package/dist/chunk-3M7AHJG5.js.map +1 -0
  3. package/dist/{chunk-SGVJUVFD.cjs → chunk-4VKV3HW3.cjs} +3 -3
  4. package/dist/{chunk-SGVJUVFD.cjs.map → chunk-4VKV3HW3.cjs.map} +1 -1
  5. package/dist/{chunk-CSNYBGHP.js → chunk-D45ATYCE.js} +2 -2
  6. package/dist/chunk-D45ATYCE.js.map +1 -0
  7. package/dist/{chunk-U2F6IHHY.js → chunk-EKVE3DBA.js} +7 -7
  8. package/dist/{chunk-U2F6IHHY.js.map → chunk-EKVE3DBA.js.map} +1 -1
  9. package/dist/{chunk-UPWAODYT.cjs → chunk-H6ZB7WYE.cjs} +26 -2
  10. package/dist/chunk-H6ZB7WYE.cjs.map +1 -0
  11. package/dist/{chunk-FOC4VPGK.js → chunk-M5ZXVXZL.js} +3 -3
  12. package/dist/{chunk-FOC4VPGK.js.map → chunk-M5ZXVXZL.js.map} +1 -1
  13. package/dist/{chunk-IO7NEEZZ.cjs → chunk-MGVK4PJF.cjs} +15 -2
  14. package/dist/chunk-MGVK4PJF.cjs.map +1 -0
  15. package/dist/chunk-NDX4QUTI.js +3 -0
  16. package/dist/{chunk-WFFVCGNU.js.map → chunk-NDX4QUTI.js.map} +1 -1
  17. package/dist/{chunk-AOHDYZSZ.js → chunk-QV4QD6XI.js} +26 -2
  18. package/dist/chunk-QV4QD6XI.js.map +1 -0
  19. package/dist/{chunk-6NIKAVI3.cjs → chunk-STKXUHEM.cjs} +2 -2
  20. package/dist/chunk-STKXUHEM.cjs.map +1 -0
  21. package/dist/{chunk-7PMOXQEO.cjs → chunk-VKEFUXQJ.cjs} +51 -8
  22. package/dist/chunk-VKEFUXQJ.cjs.map +1 -0
  23. package/dist/{chunk-D3F2BWD6.cjs → chunk-VZCCECKW.cjs} +2 -2
  24. package/dist/{chunk-D3F2BWD6.cjs.map → chunk-VZCCECKW.cjs.map} +1 -1
  25. package/dist/{chunk-TZFZDEWI.js → chunk-WSOLDULF.js} +15 -2
  26. package/dist/chunk-WSOLDULF.js.map +1 -0
  27. package/dist/{chunk-SGVTZ2J5.cjs → chunk-XF7IDNMR.cjs} +12 -12
  28. package/dist/{chunk-SGVTZ2J5.cjs.map → chunk-XF7IDNMR.cjs.map} +1 -1
  29. package/dist/entries/cast-swap.cjs +2 -2
  30. package/dist/entries/cast-swap.d.cts +1 -1
  31. package/dist/entries/cast-swap.d.ts +1 -1
  32. package/dist/entries/cast-swap.js +1 -1
  33. package/dist/entries/client.cjs +11 -11
  34. package/dist/entries/client.d.cts +1 -1
  35. package/dist/entries/client.d.ts +1 -1
  36. package/dist/entries/client.js +6 -6
  37. package/dist/entries/core.cjs +5 -5
  38. package/dist/entries/core.js +1 -1
  39. package/dist/entries/edit.cjs +12 -8
  40. package/dist/entries/edit.d.cts +265 -71
  41. package/dist/entries/edit.d.ts +265 -71
  42. package/dist/entries/edit.js +2 -2
  43. package/dist/entries/media.cjs +2 -2
  44. package/dist/entries/media.d.cts +66 -1
  45. package/dist/entries/media.d.ts +66 -1
  46. package/dist/entries/media.js +1 -1
  47. package/dist/entries/trends.cjs +2 -2
  48. package/dist/entries/trends.d.cts +36 -17
  49. package/dist/entries/trends.d.ts +36 -17
  50. package/dist/entries/trends.js +1 -1
  51. package/dist/entries/video-remake.cjs +2 -2
  52. package/dist/entries/video-remake.d.cts +1 -1
  53. package/dist/entries/video-remake.d.ts +1 -1
  54. package/dist/entries/video-remake.js +1 -1
  55. package/dist/index.cjs +27 -23
  56. package/dist/index.d.cts +4 -4
  57. package/dist/index.d.ts +4 -4
  58. package/dist/index.js +7 -7
  59. package/dist/{video-remake-C-KR7YtT.d.ts → video-remake-BEBbUmlY.d.ts} +24 -1
  60. package/dist/{video-remake-DTuCyhd9.d.cts → video-remake-LrhEaona.d.cts} +24 -1
  61. package/package.json +3 -3
  62. package/dist/chunk-6NIKAVI3.cjs.map +0 -1
  63. package/dist/chunk-7PMOXQEO.cjs.map +0 -1
  64. package/dist/chunk-AOHDYZSZ.js.map +0 -1
  65. package/dist/chunk-CSNYBGHP.js.map +0 -1
  66. package/dist/chunk-IO7NEEZZ.cjs.map +0 -1
  67. package/dist/chunk-OO4AKYUN.js.map +0 -1
  68. package/dist/chunk-TZFZDEWI.js.map +0 -1
  69. package/dist/chunk-UPWAODYT.cjs.map +0 -1
  70. package/dist/chunk-WFFVCGNU.js +0 -3
@@ -1,9 +1,9 @@
1
1
  import { Transcript, SpeakerEmphasisStyle, EdlTargetAspect, SpeakerSwitchId, EditPlanTier, Edl, SpeakerMapResult, EditPlanMode } from '@nodaro/shared/edl';
2
- export { ChapterSet, EditPlanMode, EditPlanTier, Edl, EdlClipSet, SpeakerMapResult, Transcript, unwrapEditPlanOutput } from '@nodaro/shared/edl';
2
+ export { ChapterSet, ClipPackClip, ClipPackFailedClip, ClipPackOutputData, EditPlanMode, EditPlanTier, Edl, EdlClipSet, SpeakerLayoutOutputData, SpeakerMapResult, TightenEpisodeOutputData, Transcript, UseCaseOutputData, UseCaseSourceSpan, UseCaseSpeaker, unwrapEditPlanOutput } from '@nodaro/shared/edl';
3
3
  import { N as NodaroClientCore } from '../developer-apps-D59GfAnO.cjs';
4
+ import { CaptionStyle } from '@nodaro/shared/captions';
4
5
  import { UseCaseNodeType } from '@nodaro/shared/nodes';
5
6
  export { USE_CASE_NODE_TYPES, UseCaseNodeType } from '@nodaro/shared/nodes';
6
- import { CaptionStyle } from '@nodaro/shared/captions';
7
7
  import '@nodaro/shared/apps';
8
8
  import '@nodaro/shared/organizations';
9
9
 
@@ -132,6 +132,23 @@ interface TightenEpisodeInput extends UseCaseRecordingsInput {
132
132
  styleGuide?: string;
133
133
  /** How far the music dips under the voice, 0–100 (default 75). */
134
134
  musicDuckAmount?: number;
135
+ /** See {@link UseCaseSpeakerNamesInput.speakerNames}. */
136
+ speakerNames?: UseCaseSpeakerNamesInput["speakerNames"];
137
+ }
138
+ /**
139
+ * The speakers' names a Tighten Episode or Speaker Layout run reports back.
140
+ */
141
+ interface UseCaseSpeakerNamesInput {
142
+ /**
143
+ * Speaker label (as the run's transcript names them, e.g. `"speaker_0"`) →
144
+ * the name to show (up to 80 characters; at most 32 speakers). The job keeps
145
+ * them and the finished job's `output_data.speakers[].name` carries them
146
+ * (`TightenEpisodeOutputData`, `SpeakerLayoutOutputData`); the
147
+ * run itself never reads them, so nothing is renamed in the captions, the
148
+ * transcript or the edit. A name is trimmed and a blank one dropped; a
149
+ * label nobody in the recording has is ignored. A continuation keeps them.
150
+ */
151
+ speakerNames?: Record<string, string>;
135
152
  }
136
153
  /**
137
154
  * Input for {@link EditResource.episodeChapters} and
@@ -271,6 +288,205 @@ interface SpeakerLayoutInput extends UseCaseRecordingsInput {
271
288
  * (`mode: "render-final"`, no `editedEdl`: the layout has no cut to change).
272
289
  */
273
290
  reviewBeforeRender?: boolean;
291
+ /** See {@link UseCaseSpeakerNamesInput.speakerNames}. */
292
+ speakerNames?: UseCaseSpeakerNamesInput["speakerNames"];
293
+ }
294
+
295
+ /**
296
+ * What the podcast use-case runs on the `edit` resource answer (the run's job
297
+ * to poll, an estimate) and the options and continuation input they take.
298
+ * Split from `edit.ts`, which holds the methods; every name here is
299
+ * re-exported from there.
300
+ */
301
+
302
+ /** What a use-case run (`tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack`, `speakerLayout`) and `continueUseCase` answer: the run's job to poll. */
303
+ interface UseCaseJobResult extends EditJobResult {
304
+ /** The run's execution (absent on a deduplicated retry). */
305
+ executionId?: string;
306
+ /** `true` when an `Idempotency-Key` retry found the run already started: `jobId` is that run. */
307
+ deduped?: boolean;
308
+ }
309
+ /** What `tightenEpisode` answers (a {@link UseCaseJobResult}). */
310
+ type TightenEpisodeJobResult = UseCaseJobResult;
311
+ /**
312
+ * What a use-case run is estimated at (`data`). Every credit amount is 0
313
+ * on an edition without credits; `durationSec` is `null` when the recording's
314
+ * length could not be read.
315
+ */
316
+ interface UseCaseEstimate {
317
+ /** The whole run: its steps plus the fee. */
318
+ totalCredits: number;
319
+ /** The steps at their own rates. */
320
+ stepsCredits: number;
321
+ /** The per-run fee. */
322
+ feeCredits: number;
323
+ /** A step is a metered LLM call's ESTIMATE (charged its actual usage), so the
324
+ * total is one: show it `≈N`. Absent for a fixed figure. */
325
+ estimate?: true;
326
+ /** The recording's length, in seconds. */
327
+ durationSec: number | null;
328
+ }
329
+ /** What a Tighten Episode run is estimated at (a {@link UseCaseEstimate}). */
330
+ type TightenEpisodeEstimate = UseCaseEstimate;
331
+ /** Input for `EditResource.continueUseCase`. */
332
+ interface UseCaseContinueInput {
333
+ /** The run to continue: the job `tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack` or `speakerLayout` (or an earlier continuation) answered. */
334
+ jobId: string;
335
+ /**
336
+ * `"from-failed"` re-runs what did not finish of a failed run;
337
+ * `"render-final"` renders the full-quality result after a review-on preview
338
+ * (a Chapters run has no preview: it is refused `render_final_not_preview`;
339
+ * a Clip Pack edit that drops every clip is refused `use_case_nothing_kept`).
340
+ */
341
+ mode: "from-failed" | "render-final";
342
+ /** Render final only: the reviewer's edit of the plan (an EDL). A Speaker Layout run has no plan: an edit is refused `400 use_case_no_plan`. */
343
+ editedEdl?: unknown;
344
+ /**
345
+ * The run's node type: its continuation goes to `POST /v1/<nodeType>/continue`.
346
+ * Optional: when absent the job is read first (`GET /v1/jobs/:id`, which
347
+ * needs the `jobs:read` scope on an app token) for the type the run records.
348
+ * Required when that read cannot answer: a key without `jobs:read`, or a job
349
+ * that records no use-case type (the call rejects with `use_case_type_unknown`).
350
+ */
351
+ nodeType?: UseCaseNodeType;
352
+ }
353
+ /** Per-call options for the use-case requests (Tighten Episode, Chapters, Trailer, Clip Pack, Speaker Layout, and their continuations). */
354
+ interface UseCaseRequestOptions {
355
+ /**
356
+ * Sent as the `Idempotency-Key` header. Reuse the same value when retrying
357
+ * the same request and the server answers the run it already started
358
+ * (`deduped: true`) instead of starting a second one.
359
+ */
360
+ idempotencyKey?: string;
361
+ }
362
+
363
+ /**
364
+ * The podcast pack on the `edit` resource (`POST /v1/podcast-pack`): several
365
+ * podcast tools on one recording, for one price. Its input (the recording
366
+ * once, and each tool's own settings), the body it sends and what it answers.
367
+ * Split from `edit.ts`, which holds the methods; every name here is
368
+ * re-exported from there.
369
+ */
370
+
371
+ /** The tools a podcast pack can run, in the order the pack starts them. */
372
+ declare const PODCAST_PACK_TOOLS: readonly UseCaseNodeType[];
373
+ /** One tool a podcast pack can run (see {@link PODCAST_PACK_TOOLS}). */
374
+ type PodcastPackTool = (typeof PODCAST_PACK_TOOLS)[number];
375
+ /**
376
+ * The fields a tool's settings leave out in a pack: the recording and the
377
+ * speakers' names belong to the pack, sent once for every tool.
378
+ */
379
+ type PodcastPackRecordingField = keyof UseCaseRecordingsInput | keyof UseCaseSpeakerNamesInput;
380
+ /** A tool's type spelled as its method's name: `tighten-episode` → `tightenEpisode`. */
381
+ type MethodNameOf<S extends string> = S extends `${infer Head}-${infer Tail}` ? `${Head}${Capitalize<MethodNameOf<Tail>>}` : S;
382
+ /**
383
+ * Each tool's settings in a pack: what its own method takes (`tightenEpisode`,
384
+ * `episodeChapters`, …), without the recording fields — read from the method
385
+ * itself, so a tool and its settings never drift (a tool with no method of its
386
+ * own fails to type here).
387
+ */
388
+ type PodcastPackToolSettings = EveryPackToolHasAMethod extends true ? {
389
+ [T in PodcastPackTool]: Omit<ToolInputOf<T>, PodcastPackRecordingField>;
390
+ } : never;
391
+ /** What a tool's own method takes as its input. */
392
+ type ToolInputOf<T extends PodcastPackTool> = EditResource[MethodNameOf<T> & keyof EditResource] extends (input: infer I, ...rest: never[]) => unknown ? I : never;
393
+ /** Every tool has a method of its own: a type with none fails to compile here. */
394
+ type AssertTrue<T extends true> = T;
395
+ type EveryPackToolHasAMethod = AssertTrue<{
396
+ [T in PodcastPackTool]: MethodNameOf<T> extends keyof EditResource ? true : false;
397
+ }[PodcastPackTool]>;
398
+ /** The tools a pack runs, each with its settings (`{}` takes the tool's defaults). */
399
+ type PodcastPackTools = {
400
+ [T in PodcastPackTool]?: PodcastPackToolSettings[T];
401
+ };
402
+ /**
403
+ * Input for {@link EditResource.podcastPack} and
404
+ * {@link EditResource.estimatePodcastPack}: the recording (or the recordings
405
+ * of one conversation, see {@link UseCaseRecordingsInput}) once, and the tools
406
+ * to run on it. Each tool refuses in a pack what it refuses on its own (Chapters
407
+ * takes one recording, Trailer and Speaker Layout need a picture).
408
+ */
409
+ interface PodcastPackInput extends UseCaseRecordingsInput {
410
+ /**
411
+ * The tools to run, at least one (an empty object is refused `400
412
+ * validation_error`). A tool's settings are what its own method takes,
413
+ * without the recording.
414
+ */
415
+ tools: PodcastPackTools;
416
+ /**
417
+ * Speaker label → the name to show (see
418
+ * {@link UseCaseSpeakerNamesInput.speakerNames}); passed only to the tools
419
+ * that take it (Tighten Episode, Speaker Layout).
420
+ */
421
+ speakerNames?: UseCaseSpeakerNamesInput["speakerNames"];
422
+ /** A workflow (its id) to tie the pack's job and its tools' runs to. */
423
+ workflowId?: string;
424
+ /** With `workflowId`: the node on it. */
425
+ nodeId?: string;
426
+ }
427
+ /** One tool of a pack that started: its own run, followed by its own job. */
428
+ interface PodcastPackToolRun {
429
+ tool: PodcastPackTool;
430
+ /** The tool's job: the same job its own method answers. Follow it with `client.jobs.getStatus(jobId)`. */
431
+ jobId: string;
432
+ /** The tool's run. */
433
+ executionId: string | null;
434
+ }
435
+ /** One tool of a pack that did not start, and why. */
436
+ interface PodcastPackNotStarted {
437
+ tool: PodcastPackTool;
438
+ error: {
439
+ code: string;
440
+ message: string;
441
+ tool?: PodcastPackTool;
442
+ };
443
+ }
444
+ /**
445
+ * What a pack's job holds once its tools have started (its `output_data`),
446
+ * and what {@link EditResource.podcastPack} answers beside the pack's `jobId`.
447
+ */
448
+ interface PodcastPackOutputData {
449
+ /** The tools that started, in the pack's order. */
450
+ tools: PodcastPackToolRun[];
451
+ /** The tools that did not start (absent when every tool started). */
452
+ notStarted?: PodcastPackNotStarted[];
453
+ /** The recording's length, in seconds. */
454
+ durationSec: number;
455
+ /** The units the pack is charged: every started 15 seconds of the recording. */
456
+ units: number;
457
+ }
458
+ /** A pack started by this request: its job, and each tool's. */
459
+ interface PodcastPackStarted extends EditJobResult, PodcastPackOutputData {
460
+ deduped?: false;
461
+ }
462
+ /**
463
+ * An `Idempotency-Key` retry that found the pack already started: `jobId` is
464
+ * that pack's job, whose `output_data` lists its tools
465
+ * ({@link PodcastPackOutputData}).
466
+ */
467
+ interface PodcastPackDeduped extends EditJobResult {
468
+ deduped: true;
469
+ }
470
+ /** What {@link EditResource.podcastPack} answers (`202`). */
471
+ type PodcastPackJobResult = PodcastPackStarted | PodcastPackDeduped;
472
+ /** What {@link EditResource.startPodcastPackTool} answers (`202`): the tool's run, followed like any run. */
473
+ interface PodcastPackToolStarted {
474
+ /** The tool's run: its job, to follow with `jobs.get` (and to continue free if it fails). */
475
+ jobId: string;
476
+ /** The run's execution, when it started one. */
477
+ executionId: string | null;
478
+ tool: PodcastPackTool;
479
+ }
480
+ /** What a pack is estimated at (`data`). Nothing is created or charged. */
481
+ interface PodcastPackEstimate {
482
+ /** The tools the pack would run, in the pack's order. */
483
+ tools: PodcastPackTool[];
484
+ /** The recording's length, in seconds. */
485
+ durationSec: number;
486
+ /** Every started 15 seconds of the recording. */
487
+ units: number;
488
+ /** The pack's price, every tool included: 0 on an edition without credits, `null` when this server has no price for it. */
489
+ credits: number | null;
274
490
  }
275
491
 
276
492
  /**
@@ -551,66 +767,6 @@ interface CameraSwitchInput {
551
767
  workflowId?: string;
552
768
  }
553
769
 
554
- /** What a use-case run (`tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack`, `speakerLayout`) and `continueUseCase` answer: the run's job to poll. */
555
- interface UseCaseJobResult extends EditJobResult {
556
- /** The run's execution (absent on a deduplicated retry). */
557
- executionId?: string;
558
- /** `true` when an `Idempotency-Key` retry found the run already started: `jobId` is that run. */
559
- deduped?: boolean;
560
- }
561
- /** What `tightenEpisode` answers (a {@link UseCaseJobResult}). */
562
- type TightenEpisodeJobResult = UseCaseJobResult;
563
- /**
564
- * What a use-case run is estimated at (`data`). Every credit amount is 0
565
- * on an edition without credits; `durationSec` is `null` when the recording's
566
- * length could not be read.
567
- */
568
- interface UseCaseEstimate {
569
- /** The whole run: its steps plus the fee. */
570
- totalCredits: number;
571
- /** The steps at their own rates. */
572
- stepsCredits: number;
573
- /** The per-run fee. */
574
- feeCredits: number;
575
- /** A step is a metered LLM call's ESTIMATE (charged its actual usage), so the
576
- * total is one: show it `≈N`. Absent for a fixed figure. */
577
- estimate?: true;
578
- /** The recording's length, in seconds. */
579
- durationSec: number | null;
580
- }
581
- /** What a Tighten Episode run is estimated at (a {@link UseCaseEstimate}). */
582
- type TightenEpisodeEstimate = UseCaseEstimate;
583
- /** Input for {@link EditResource.continueUseCase}. */
584
- interface UseCaseContinueInput {
585
- /** The run to continue: the job `tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack` or `speakerLayout` (or an earlier continuation) answered. */
586
- jobId: string;
587
- /**
588
- * `"from-failed"` re-runs what did not finish of a failed run;
589
- * `"render-final"` renders the full-quality result after a review-on preview
590
- * (a Chapters run has no preview: it is refused `render_final_not_preview`;
591
- * a Clip Pack edit that drops every clip is refused `use_case_nothing_kept`).
592
- */
593
- mode: "from-failed" | "render-final";
594
- /** Render final only: the reviewer's edit of the plan (an EDL). A Speaker Layout run has no plan: an edit is refused `400 use_case_no_plan`. */
595
- editedEdl?: unknown;
596
- /**
597
- * The run's node type: its continuation goes to `POST /v1/<nodeType>/continue`.
598
- * Optional: when absent the job is read first (`GET /v1/jobs/:id`, which
599
- * needs the `jobs:read` scope on an app token) for the type the run records.
600
- * Required when that read cannot answer: a key without `jobs:read`, or a job
601
- * that records no use-case type (the call rejects with `use_case_type_unknown`).
602
- */
603
- nodeType?: UseCaseNodeType;
604
- }
605
- /** Per-call options for the use-case requests (Tighten Episode, Chapters, Trailer, Clip Pack, Speaker Layout, and their continuations). */
606
- interface UseCaseRequestOptions {
607
- /**
608
- * Sent as the `Idempotency-Key` header. Reuse the same value when retrying
609
- * the same request and the server answers the run it already started
610
- * (`deduped: true`) instead of starting a second one.
611
- */
612
- idempotencyKey?: string;
613
- }
614
770
  /**
615
771
  * Editorial primitives for podcast / long-form video editing, single-camera
616
772
  * and multicam: measure the cameras' offsets ({@link audioSync}), plan the cut
@@ -637,16 +793,20 @@ interface UseCaseRequestOptions {
637
793
  * captioned by default) in one call; the same connection applies.
638
794
  * - {@link speakerLayout} frames a whole recording by speaker (the same
639
795
  * length, nothing cut) in one call; the same connection applies.
796
+ * - {@link podcastPack} runs several of those tools on one recording, for one
797
+ * price by its length; each tool runs as its own run, with its own job.
640
798
  * - {@link remapTranscript} is a PURE local transform (no request) — the same
641
799
  * remap `applyEdl` performs on its `transcript`, exposed for callers that hold
642
800
  * an EDL and a transcript and only want the re-timed transcript.
643
801
  *
644
802
  * Every request method except the estimates ({@link estimateTightenEpisode},
645
803
  * {@link estimateEpisodeChapters}, {@link estimateEpisodeTrailer},
646
- * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`)
804
+ * {@link estimateClipPack}, {@link estimateSpeakerLayout},
805
+ * {@link estimatePodcastPack}: a quote, `{ data }`)
647
806
  * and {@link editPlanCapabilities} (a read: {@link EditPlanCapabilities}) returns
648
- * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}); poll the
649
- * `jobId` with `client.jobs.getStatus(jobId)`.
807
+ * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}, the
808
+ * pack a {@link PodcastPackJobResult}); poll the `jobId` with
809
+ * `client.jobs.getStatus(jobId)`.
650
810
  */
651
811
  declare class EditResource {
652
812
  private client;
@@ -685,7 +845,10 @@ declare class EditResource {
685
845
  * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording
686
846
  * in one call — transcribe, cut the silences and filler, render, with
687
847
  * optional captions, music and framing. Answers the run's job to poll; its
688
- * `output_data` holds the episode. The run is priced as its steps at their own
848
+ * `output_data` holds the episode, and `output_data.speakers` each speaker's
849
+ * label, the name `speakerNames` gave it and how long they talk across the
850
+ * recording (`{ label, name?, talkMs }[]`, `TightenEpisodeOutputData`).
851
+ * The run is priced as its steps at their own
689
852
  * rates plus the listed per-run fee. Quote it first with
690
853
  * {@link estimateTightenEpisode}.
691
854
  */
@@ -747,10 +910,12 @@ declare class EditResource {
747
910
  * with the speakers stacked by default; `framing: null` keeps the
748
911
  * recording's shape) and captioned. An audio recording makes audio clips.
749
912
  * The finished job's `output_data.clips` is `{ url, title?, hook?, clipKey,
750
- * thumbnailUrl?, captionsFailed? }[]` in plan order, the first also
913
+ * thumbnailUrl?, captionsFailed?, sourceStartMs?, sourceEndMs?,
914
+ * sourceSpans? }[]` in plan order (`ClipPackClip`: where each clip is
915
+ * in the recording, on its clock), the first also
751
916
  * `output_data.videoUrl` (`audioUrl` for audio clips). Every clip is tried:
752
- * one that cannot be rendered is skipped, not charged and counted on
753
- * `failedClips` (the pack keeps the others and its fee); a clip whose
917
+ * one that cannot be rendered is skipped, not charged, counted on
918
+ * `failedClips` and named on `failedClipList` (the pack keeps the others and its fee); a clip whose
754
919
  * captions failed comes uncaptioned (`captionsFailed`, counted on
755
920
  * `failedCaptions`). When no clip renders the run fails and its fee is
756
921
  * refunded. With `reviewBeforeRender` the run stops at previews; Render
@@ -774,7 +939,9 @@ declare class EditResource {
774
939
  * speaker framed in turn; several recordings of one conversation: lined up,
775
940
  * each speaker shown on their own camera. The finished job's
776
941
  * `output_data.videoUrl` is the framed video, `output_data.json` the edit
777
- * Speaker View drew. With `reviewBeforeRender` the run stops at a preview;
942
+ * Speaker View drew, and `output_data.speakers` each speaker's label, the
943
+ * name `speakerNames` gave it and how long they talk (`{ label, name?,
944
+ * talkMs }[]`, `SpeakerLayoutOutputData`). With `reviewBeforeRender` the run stops at a preview;
778
945
  * {@link continueUseCase} (`mode: "render-final"`, no `editedEdl`) renders
779
946
  * it at full quality. Priced as its steps at their own rates plus the listed
780
947
  * per-run fee; quote it first with {@link estimateSpeakerLayout}.
@@ -789,6 +956,33 @@ declare class EditResource {
789
956
  estimateSpeakerLayout(input: SpeakerLayoutInput): Promise<{
790
957
  data: UseCaseEstimate;
791
958
  }>;
959
+ /**
960
+ * Podcast pack (`POST /v1/podcast-pack`): run several of the podcast tools
961
+ * on one recording for one price, every started 15 seconds of the
962
+ * recording with every chosen tool included. Every tool's own refusals come
963
+ * first (a refusal's `details.tool` names the tool), before anything is
964
+ * charged. Answers the pack's job and each tool's (`tools`: the same job
965
+ * its own method answers), plus the tools that did not start. A tool that
966
+ * fails is continued free with {@link continueUseCase} (`"from-failed"`).
967
+ * Quote it first with {@link estimatePodcastPack}.
968
+ */
969
+ podcastPack(input: PodcastPackInput, options?: UseCaseRequestOptions): Promise<PodcastPackJobResult>;
970
+ /**
971
+ * What a podcast pack is charged (`POST /v1/podcast-pack/estimate`): the
972
+ * same refusals, then the recording's length, its units and the price.
973
+ * Nothing is created or charged.
974
+ */
975
+ estimatePodcastPack(input: PodcastPackInput): Promise<{
976
+ data: PodcastPackEstimate;
977
+ }>;
978
+ /**
979
+ * Start, free, a tool a podcast pack paid for that did not start (`POST
980
+ * /v1/podcast-pack/:id/start`, the pack's `notStarted`): on the recording and
981
+ * the settings the pack kept. Once per tool — a tool that already has a run
982
+ * in its pack is refused (a failed run is continued with `continueUseCase`,
983
+ * free too); a pack held for review is refused (`pack_under_review`).
984
+ */
985
+ startPodcastPackTool(packJobId: string, tool: PodcastPackTool): Promise<PodcastPackToolStarted>;
792
986
  /**
793
987
  * Continue a use-case run as a new job (`POST /v1/<type>/continue`, the
794
988
  * run's own type: `input.nodeType`, else the type the job records, read with
@@ -850,4 +1044,4 @@ declare class EditResource {
850
1044
  remapTranscript(edl: Edl, transcript: Transcript): Transcript;
851
1045
  }
852
1046
 
853
- export { type ApplyEdlInput, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, type CameraSwitchInput, type ClipPackEmphasis, type ClipPackInput, type EditJobResult, type EditPlanCapabilities, type EditPlanInput, type EditPlanSource, EditResource, type EpisodeChaptersInput, type EpisodeTrailerInput, type SilenceDetectInput, type SilenceRanges, type SpeakerLayoutInput, type SpeakerMapInput, type SpeakerMapSource, TRAILER_FORMATS, type TightenEpisodeEstimate, type TightenEpisodeInput, type TightenEpisodeJobResult, type TrailerFormat, type UseCaseContinueInput, type UseCaseEstimate, type UseCaseJobResult, type UseCaseRecordingsInput, type UseCaseRequestOptions };
1047
+ export { type ApplyEdlInput, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, type CameraSwitchInput, type ClipPackEmphasis, type ClipPackInput, type EditJobResult, type EditPlanCapabilities, type EditPlanInput, type EditPlanSource, EditResource, type EpisodeChaptersInput, type EpisodeTrailerInput, PODCAST_PACK_TOOLS, type PodcastPackDeduped, type PodcastPackEstimate, type PodcastPackInput, type PodcastPackJobResult, type PodcastPackNotStarted, type PodcastPackOutputData, type PodcastPackRecordingField, type PodcastPackStarted, type PodcastPackTool, type PodcastPackToolRun, type PodcastPackToolSettings, type PodcastPackToolStarted, type PodcastPackTools, type SilenceDetectInput, type SilenceRanges, type SpeakerLayoutInput, type SpeakerMapInput, type SpeakerMapSource, TRAILER_FORMATS, type TightenEpisodeEstimate, type TightenEpisodeInput, type TightenEpisodeJobResult, type TrailerFormat, type UseCaseContinueInput, type UseCaseEstimate, type UseCaseJobResult, type UseCaseRecordingsInput, type UseCaseRequestOptions, type UseCaseSpeakerNamesInput };