@nodaro/sdk 2.66.0 → 2.67.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 (134) hide show
  1. package/dist/{chunk-GQU5FXYB.js → chunk-36BRX3LU.js} +4 -4
  2. package/dist/{chunk-GQU5FXYB.js.map → chunk-36BRX3LU.js.map} +1 -1
  3. package/dist/{chunk-PHBOLYRT.cjs → chunk-3G65RIZS.cjs} +4 -4
  4. package/dist/{chunk-PHBOLYRT.cjs.map → chunk-3G65RIZS.cjs.map} +1 -1
  5. package/dist/{chunk-QHCVKMSF.cjs → chunk-4AD3CBDK.cjs} +13 -11
  6. package/dist/chunk-4AD3CBDK.cjs.map +1 -0
  7. package/dist/{chunk-JOXZ4ZIF.cjs → chunk-7BMKQ36V.cjs} +2 -2
  8. package/dist/{chunk-JOXZ4ZIF.cjs.map → chunk-7BMKQ36V.cjs.map} +1 -1
  9. package/dist/{chunk-MOGPM5RM.cjs → chunk-AFIFBKCI.cjs} +24 -24
  10. package/dist/{chunk-MOGPM5RM.cjs.map → chunk-AFIFBKCI.cjs.map} +1 -1
  11. package/dist/{chunk-KAYCRIMA.cjs → chunk-BETFYVOR.cjs} +5 -5
  12. package/dist/{chunk-KAYCRIMA.cjs.map → chunk-BETFYVOR.cjs.map} +1 -1
  13. package/dist/{chunk-EBQXAOHW.js → chunk-CCXY4ZJM.js} +3 -3
  14. package/dist/{chunk-EBQXAOHW.js.map → chunk-CCXY4ZJM.js.map} +1 -1
  15. package/dist/{chunk-WSMZ3AAU.cjs → chunk-CLBLAWH3.cjs} +21 -11
  16. package/dist/chunk-CLBLAWH3.cjs.map +1 -0
  17. package/dist/{chunk-E37CVHWW.js → chunk-CNST37UF.js} +2 -2
  18. package/dist/chunk-CNST37UF.js.map +1 -0
  19. package/dist/{chunk-6T54F65Q.cjs → chunk-D3F2BWD6.cjs} +2 -2
  20. package/dist/{chunk-6T54F65Q.cjs.map → chunk-D3F2BWD6.cjs.map} +1 -1
  21. package/dist/{chunk-DQQRFBWY.cjs → chunk-EJJIA765.cjs} +5 -5
  22. package/dist/{chunk-DQQRFBWY.cjs.map → chunk-EJJIA765.cjs.map} +1 -1
  23. package/dist/{chunk-CSIPRLX3.js → chunk-FFT2YPB4.js} +3 -3
  24. package/dist/{chunk-CSIPRLX3.js.map → chunk-FFT2YPB4.js.map} +1 -1
  25. package/dist/{chunk-UBZ2XVHM.cjs → chunk-G54ORDSI.cjs} +5 -5
  26. package/dist/{chunk-UBZ2XVHM.cjs.map → chunk-G54ORDSI.cjs.map} +1 -1
  27. package/dist/{chunk-HFDTOEAL.cjs → chunk-H7Q7D4CT.cjs} +2 -2
  28. package/dist/chunk-H7Q7D4CT.cjs.map +1 -0
  29. package/dist/{chunk-RPV4QBHS.cjs → chunk-HY45ZOKW.cjs} +2 -2
  30. package/dist/chunk-HY45ZOKW.cjs.map +1 -0
  31. package/dist/{chunk-SNPDM72K.js → chunk-IJAJTVEW.js} +13 -11
  32. package/dist/chunk-IJAJTVEW.js.map +1 -0
  33. package/dist/{chunk-SS3B6PHT.cjs → chunk-ITQB5ADE.cjs} +2 -2
  34. package/dist/chunk-ITQB5ADE.cjs.map +1 -0
  35. package/dist/{chunk-LR5TGCJP.js → chunk-J3Y56MYU.js} +2 -2
  36. package/dist/chunk-J3Y56MYU.js.map +1 -0
  37. package/dist/{chunk-LTRJNCXB.js → chunk-MHJX4GJS.js} +13 -13
  38. package/dist/{chunk-LTRJNCXB.js.map → chunk-MHJX4GJS.js.map} +1 -1
  39. package/dist/{chunk-KNNSGWHO.js → chunk-NN3BPOUZ.js} +2 -2
  40. package/dist/chunk-NN3BPOUZ.js.map +1 -0
  41. package/dist/{chunk-7LODCIQK.js → chunk-OJHJBNJZ.js} +2 -2
  42. package/dist/{chunk-7LODCIQK.js.map → chunk-OJHJBNJZ.js.map} +1 -1
  43. package/dist/{chunk-KEZMNVN3.js → chunk-RBUISD4V.js} +3 -3
  44. package/dist/{chunk-KEZMNVN3.js.map → chunk-RBUISD4V.js.map} +1 -1
  45. package/dist/{chunk-UIDVH3GP.cjs → chunk-REXFEDKI.cjs} +2 -2
  46. package/dist/chunk-REXFEDKI.cjs.map +1 -0
  47. package/dist/{chunk-JC66EEFI.js → chunk-SZ67PDKE.js} +3 -3
  48. package/dist/{chunk-JC66EEFI.js.map → chunk-SZ67PDKE.js.map} +1 -1
  49. package/dist/{chunk-HADYBDBT.js → chunk-T6CKK47P.js} +2 -2
  50. package/dist/chunk-T6CKK47P.js.map +1 -0
  51. package/dist/{chunk-O6LQV6BD.cjs → chunk-TQLOD7OL.cjs} +4 -4
  52. package/dist/{chunk-O6LQV6BD.cjs.map → chunk-TQLOD7OL.cjs.map} +1 -1
  53. package/dist/{chunk-MYUJEVP6.js → chunk-VGY3WBNY.js} +15 -5
  54. package/dist/chunk-VGY3WBNY.js.map +1 -0
  55. package/dist/chunk-WFFVCGNU.js +3 -0
  56. package/dist/{chunk-UKB64254.js.map → chunk-WFFVCGNU.js.map} +1 -1
  57. package/dist/{chunk-EWVQFW5L.cjs → chunk-XRYSHC2O.cjs} +22 -22
  58. package/dist/{chunk-EWVQFW5L.cjs.map → chunk-XRYSHC2O.cjs.map} +1 -1
  59. package/dist/{chunk-Q6HMDIC4.js → chunk-YE6X5BQ2.js} +3 -3
  60. package/dist/{chunk-Q6HMDIC4.js.map → chunk-YE6X5BQ2.js.map} +1 -1
  61. package/dist/entries/apps.cjs +2 -2
  62. package/dist/entries/apps.d.cts +2 -1
  63. package/dist/entries/apps.d.ts +2 -1
  64. package/dist/entries/apps.js +1 -1
  65. package/dist/entries/characters.d.cts +1 -1
  66. package/dist/entries/characters.d.ts +1 -1
  67. package/dist/entries/client.cjs +19 -19
  68. package/dist/entries/client.d.cts +1 -1
  69. package/dist/entries/client.d.ts +1 -1
  70. package/dist/entries/client.js +14 -14
  71. package/dist/entries/copilot.cjs +4 -4
  72. package/dist/entries/copilot.js +3 -3
  73. package/dist/entries/core.cjs +6 -6
  74. package/dist/entries/core.js +2 -2
  75. package/dist/entries/creatures.d.cts +1 -1
  76. package/dist/entries/creatures.d.ts +1 -1
  77. package/dist/entries/edit.cjs +9 -9
  78. package/dist/entries/edit.d.cts +41 -6
  79. package/dist/entries/edit.d.ts +41 -6
  80. package/dist/entries/edit.js +3 -3
  81. package/dist/entries/errors.cjs +28 -28
  82. package/dist/entries/errors.d.cts +5 -3
  83. package/dist/entries/errors.d.ts +5 -3
  84. package/dist/entries/errors.js +1 -1
  85. package/dist/entries/llm.cjs +2 -2
  86. package/dist/entries/llm.d.cts +1 -1
  87. package/dist/entries/llm.d.ts +1 -1
  88. package/dist/entries/llm.js +1 -1
  89. package/dist/entries/locations.d.cts +1 -1
  90. package/dist/entries/locations.d.ts +1 -1
  91. package/dist/entries/media.cjs +4 -4
  92. package/dist/entries/media.js +3 -3
  93. package/dist/entries/models.cjs +2 -2
  94. package/dist/entries/models.d.cts +30 -0
  95. package/dist/entries/models.d.ts +30 -0
  96. package/dist/entries/models.js +1 -1
  97. package/dist/entries/nodes.cjs +3 -3
  98. package/dist/entries/nodes.d.cts +1 -1
  99. package/dist/entries/nodes.d.ts +1 -1
  100. package/dist/entries/nodes.js +2 -2
  101. package/dist/entries/objects.d.cts +1 -1
  102. package/dist/entries/objects.d.ts +1 -1
  103. package/dist/entries/scene3d.d.cts +2 -2
  104. package/dist/entries/scene3d.d.ts +2 -2
  105. package/dist/entries/studio.cjs +5 -5
  106. package/dist/entries/studio.js +2 -2
  107. package/dist/entries/surface.cjs +2 -2
  108. package/dist/entries/surface.d.cts +8 -1
  109. package/dist/entries/surface.d.ts +8 -1
  110. package/dist/entries/surface.js +1 -1
  111. package/dist/entries/user-settings.cjs +2 -2
  112. package/dist/entries/user-settings.d.cts +31 -4
  113. package/dist/entries/user-settings.d.ts +31 -4
  114. package/dist/entries/user-settings.js +1 -1
  115. package/dist/index.cjs +65 -65
  116. package/dist/index.d.cts +3 -3
  117. package/dist/index.d.ts +3 -3
  118. package/dist/index.js +15 -15
  119. package/dist/{nodes-C9O2tdGH.d.ts → nodes-CBWTkR37.d.ts} +1 -1
  120. package/dist/{nodes-WkaQjuwS.d.cts → nodes-YwzFHsJH.d.cts} +1 -1
  121. package/package.json +3 -3
  122. package/dist/chunk-E37CVHWW.js.map +0 -1
  123. package/dist/chunk-HADYBDBT.js.map +0 -1
  124. package/dist/chunk-HFDTOEAL.cjs.map +0 -1
  125. package/dist/chunk-KNNSGWHO.js.map +0 -1
  126. package/dist/chunk-LR5TGCJP.js.map +0 -1
  127. package/dist/chunk-MYUJEVP6.js.map +0 -1
  128. package/dist/chunk-QHCVKMSF.cjs.map +0 -1
  129. package/dist/chunk-RPV4QBHS.cjs.map +0 -1
  130. package/dist/chunk-SNPDM72K.js.map +0 -1
  131. package/dist/chunk-SS3B6PHT.cjs.map +0 -1
  132. package/dist/chunk-UIDVH3GP.cjs.map +0 -1
  133. package/dist/chunk-UKB64254.js +0 -3
  134. package/dist/chunk-WSMZ3AAU.cjs.map +0 -1
@@ -1,34 +1,34 @@
1
1
  'use strict';
2
2
 
3
- var chunk6T54F65Q_cjs = require('../chunk-6T54F65Q.cjs');
4
- var chunkWSMZ3AAU_cjs = require('../chunk-WSMZ3AAU.cjs');
5
- require('../chunk-QHCVKMSF.cjs');
3
+ var chunkD3F2BWD6_cjs = require('../chunk-D3F2BWD6.cjs');
4
+ var chunkCLBLAWH3_cjs = require('../chunk-CLBLAWH3.cjs');
5
+ require('../chunk-4AD3CBDK.cjs');
6
6
 
7
7
 
8
8
 
9
9
  Object.defineProperty(exports, "unwrapEditPlanOutput", {
10
10
  enumerable: true,
11
- get: function () { return chunk6T54F65Q_cjs.unwrapEditPlanOutput; }
11
+ get: function () { return chunkD3F2BWD6_cjs.unwrapEditPlanOutput; }
12
12
  });
13
13
  Object.defineProperty(exports, "CLIP_PACK_MAX_TARGET_SEC", {
14
14
  enumerable: true,
15
- get: function () { return chunkWSMZ3AAU_cjs.CLIP_PACK_MAX_TARGET_SEC; }
15
+ get: function () { return chunkCLBLAWH3_cjs.CLIP_PACK_MAX_TARGET_SEC; }
16
16
  });
17
17
  Object.defineProperty(exports, "CLIP_PACK_MIN_TARGET_SEC", {
18
18
  enumerable: true,
19
- get: function () { return chunkWSMZ3AAU_cjs.CLIP_PACK_MIN_TARGET_SEC; }
19
+ get: function () { return chunkCLBLAWH3_cjs.CLIP_PACK_MIN_TARGET_SEC; }
20
20
  });
21
21
  Object.defineProperty(exports, "EditResource", {
22
22
  enumerable: true,
23
- get: function () { return chunkWSMZ3AAU_cjs.EditResource; }
23
+ get: function () { return chunkCLBLAWH3_cjs.EditResource; }
24
24
  });
25
25
  Object.defineProperty(exports, "TRAILER_FORMATS", {
26
26
  enumerable: true,
27
- get: function () { return chunkWSMZ3AAU_cjs.TRAILER_FORMATS; }
27
+ get: function () { return chunkCLBLAWH3_cjs.TRAILER_FORMATS; }
28
28
  });
29
29
  Object.defineProperty(exports, "USE_CASE_NODE_TYPES", {
30
30
  enumerable: true,
31
- get: function () { return chunkWSMZ3AAU_cjs.USE_CASE_NODE_TYPES; }
31
+ get: function () { return chunkCLBLAWH3_cjs.USE_CASE_NODE_TYPES; }
32
32
  });
33
33
  //# sourceMappingURL=edit.cjs.map
34
34
  //# sourceMappingURL=edit.cjs.map
@@ -58,7 +58,7 @@ interface SpeakerMapInput {
58
58
  * `mediaUrls`, not both.
59
59
  *
60
60
  * Several recordings or a Master audio need Speaker Map, which tells who is on
61
- * which camera: where it is not available to you (not yet on nodaro.ai) the
61
+ * which camera: where it is not available to you the
62
62
  * request is refused `403 node_not_available` — send one recording.
63
63
  */
64
64
  interface UseCaseRecordingsInput {
@@ -164,7 +164,7 @@ interface EpisodeTrailerInput extends UseCaseRecordingsInput {
164
164
  mediaUrl?: string;
165
165
  /** An optional intro card: a short video (15 s at most) played before the trailer. */
166
166
  introCardUrl?: string;
167
- /** The formats to deliver, padded, never cropped (default `["9:16", "1:1", "4:5"]`; an empty list is refused). */
167
+ /** The formats to deliver, padded, never cropped (default `["9:16", "1:1", "4:5"]`; an empty list, or one that names a format twice, is refused `400 validation_error`). */
168
168
  formats?: TrailerFormat[];
169
169
  /** Stop at a preview of the trailer; render every format with {@link EditResource.continueUseCase} (`mode: "render-final"`). */
170
170
  reviewBeforeRender?: boolean;
@@ -495,6 +495,31 @@ interface EditPlanInput {
495
495
  /** Optionally associate this run with a workflow execution (display only). */
496
496
  workflowId?: string;
497
497
  }
498
+ /**
499
+ * What {@link EditResource.editPlanCapabilities} answers: the Edit Plan modes
500
+ * this server can plan, who answered, and how Edit Plan is priced here.
501
+ */
502
+ interface EditPlanCapabilities {
503
+ /**
504
+ * The modes this server plans. `tighten`, `clips` and `chapters` are always
505
+ * listed; `trailer` once the server can plan a trailer. A mode not listed is
506
+ * refused before anything is charged (`400 mode_not_available`).
507
+ */
508
+ modes: EditPlanMode[];
509
+ /**
510
+ * Who answered: `"server"` (nodaro.ai, or a self-hosted install that is not
511
+ * connected), `"nodaro.ai"` (a connected self-hosted install, with
512
+ * nodaro.ai's answer), or `"nodaro.ai-unreachable"` (a connected self-hosted
513
+ * install that could not reach nodaro.ai; only the three original modes are
514
+ * listed then). A newer server may add a value.
515
+ */
516
+ source: "server" | "nodaro.ai" | "nodaro.ai-unreachable" | (string & {});
517
+ /**
518
+ * `true` when Edit Plan is charged per started minute of the recording,
519
+ * `false` when at the 15/30/60/90/120/180-minute step its length rounds up to.
520
+ */
521
+ perMinute: boolean;
522
+ }
498
523
  /** Input for {@link EditResource.cameraSwitch} (podcast B5). */
499
524
  interface CameraSwitchInput {
500
525
  /** One EDL — an `editPlan` result (`unwrapEditPlanOutput`), not a clip set. */
@@ -514,6 +539,8 @@ interface CameraSwitchInput {
514
539
  minShotMs?: number;
515
540
  /** Cut this long before the new speaker starts, ms (default 200). */
516
541
  leadMs?: number;
542
+ /** Delay each cut by this long, ms (0–5 000, default 0): `leadMs`'s counterpart. */
543
+ lagMs?: number;
517
544
  /** With a `wide` source: break to it after this long on one camera, ms (default 20 000). */
518
545
  maxShotMs?: number;
519
546
  /** With a `wide` source: every N-th cut goes to the wide (default 0 = off). */
@@ -616,7 +643,8 @@ interface UseCaseRequestOptions {
616
643
  *
617
644
  * Every request method except the estimates ({@link estimateTightenEpisode},
618
645
  * {@link estimateEpisodeChapters}, {@link estimateEpisodeTrailer},
619
- * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`) returns
646
+ * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`)
647
+ * and {@link editPlanCapabilities} (a read: {@link EditPlanCapabilities}) returns
620
648
  * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}); poll the
621
649
  * `jobId` with `client.jobs.getStatus(jobId)`.
622
650
  */
@@ -796,10 +824,17 @@ declare class EditResource {
796
824
  * on nodaro.ai it runs directly.
797
825
  */
798
826
  editPlan(input: EditPlanInput): Promise<EditJobResult>;
827
+ /**
828
+ * The Edit Plan modes this server can plan (`GET /v1/edit-plan/capabilities`),
829
+ * who answered, and whether Edit Plan is charged per started minute. Ask it
830
+ * before offering a mode: one it does not list is refused by
831
+ * {@link editPlan} before anything is charged. Nothing is created or charged.
832
+ */
833
+ editPlanCapabilities(): Promise<EditPlanCapabilities>;
799
834
  /**
800
835
  * Camera Switch (podcast B5): choose which camera shows each cut of `edl`
801
- * by who is speaking — the sound never changes. Cloud edition; a flat
802
- * price. The finished job's `output_data.json` is the switched EDL (feed it
836
+ * by who is speaking — the sound never changes. Runs on nodaro.ai (a
837
+ * connected self-hosted install relays it); a flat price. The finished job's `output_data.json` is the switched EDL (feed it
803
838
  * to {@link applyEdl}) and `output_data.transcript` the transcript with
804
839
  * `speakerNames` applied. A transcript with no speaker labels rejects with
805
840
  * a {@link NodaroError} (`code: "no_speakers"`) before any request or charge.
@@ -815,4 +850,4 @@ declare class EditResource {
815
850
  remapTranscript(edl: Edl, transcript: Transcript): Transcript;
816
851
  }
817
852
 
818
- 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 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 };
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 };
@@ -58,7 +58,7 @@ interface SpeakerMapInput {
58
58
  * `mediaUrls`, not both.
59
59
  *
60
60
  * Several recordings or a Master audio need Speaker Map, which tells who is on
61
- * which camera: where it is not available to you (not yet on nodaro.ai) the
61
+ * which camera: where it is not available to you the
62
62
  * request is refused `403 node_not_available` — send one recording.
63
63
  */
64
64
  interface UseCaseRecordingsInput {
@@ -164,7 +164,7 @@ interface EpisodeTrailerInput extends UseCaseRecordingsInput {
164
164
  mediaUrl?: string;
165
165
  /** An optional intro card: a short video (15 s at most) played before the trailer. */
166
166
  introCardUrl?: string;
167
- /** The formats to deliver, padded, never cropped (default `["9:16", "1:1", "4:5"]`; an empty list is refused). */
167
+ /** The formats to deliver, padded, never cropped (default `["9:16", "1:1", "4:5"]`; an empty list, or one that names a format twice, is refused `400 validation_error`). */
168
168
  formats?: TrailerFormat[];
169
169
  /** Stop at a preview of the trailer; render every format with {@link EditResource.continueUseCase} (`mode: "render-final"`). */
170
170
  reviewBeforeRender?: boolean;
@@ -495,6 +495,31 @@ interface EditPlanInput {
495
495
  /** Optionally associate this run with a workflow execution (display only). */
496
496
  workflowId?: string;
497
497
  }
498
+ /**
499
+ * What {@link EditResource.editPlanCapabilities} answers: the Edit Plan modes
500
+ * this server can plan, who answered, and how Edit Plan is priced here.
501
+ */
502
+ interface EditPlanCapabilities {
503
+ /**
504
+ * The modes this server plans. `tighten`, `clips` and `chapters` are always
505
+ * listed; `trailer` once the server can plan a trailer. A mode not listed is
506
+ * refused before anything is charged (`400 mode_not_available`).
507
+ */
508
+ modes: EditPlanMode[];
509
+ /**
510
+ * Who answered: `"server"` (nodaro.ai, or a self-hosted install that is not
511
+ * connected), `"nodaro.ai"` (a connected self-hosted install, with
512
+ * nodaro.ai's answer), or `"nodaro.ai-unreachable"` (a connected self-hosted
513
+ * install that could not reach nodaro.ai; only the three original modes are
514
+ * listed then). A newer server may add a value.
515
+ */
516
+ source: "server" | "nodaro.ai" | "nodaro.ai-unreachable" | (string & {});
517
+ /**
518
+ * `true` when Edit Plan is charged per started minute of the recording,
519
+ * `false` when at the 15/30/60/90/120/180-minute step its length rounds up to.
520
+ */
521
+ perMinute: boolean;
522
+ }
498
523
  /** Input for {@link EditResource.cameraSwitch} (podcast B5). */
499
524
  interface CameraSwitchInput {
500
525
  /** One EDL — an `editPlan` result (`unwrapEditPlanOutput`), not a clip set. */
@@ -514,6 +539,8 @@ interface CameraSwitchInput {
514
539
  minShotMs?: number;
515
540
  /** Cut this long before the new speaker starts, ms (default 200). */
516
541
  leadMs?: number;
542
+ /** Delay each cut by this long, ms (0–5 000, default 0): `leadMs`'s counterpart. */
543
+ lagMs?: number;
517
544
  /** With a `wide` source: break to it after this long on one camera, ms (default 20 000). */
518
545
  maxShotMs?: number;
519
546
  /** With a `wide` source: every N-th cut goes to the wide (default 0 = off). */
@@ -616,7 +643,8 @@ interface UseCaseRequestOptions {
616
643
  *
617
644
  * Every request method except the estimates ({@link estimateTightenEpisode},
618
645
  * {@link estimateEpisodeChapters}, {@link estimateEpisodeTrailer},
619
- * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`) returns
646
+ * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`)
647
+ * and {@link editPlanCapabilities} (a read: {@link EditPlanCapabilities}) returns
620
648
  * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}); poll the
621
649
  * `jobId` with `client.jobs.getStatus(jobId)`.
622
650
  */
@@ -796,10 +824,17 @@ declare class EditResource {
796
824
  * on nodaro.ai it runs directly.
797
825
  */
798
826
  editPlan(input: EditPlanInput): Promise<EditJobResult>;
827
+ /**
828
+ * The Edit Plan modes this server can plan (`GET /v1/edit-plan/capabilities`),
829
+ * who answered, and whether Edit Plan is charged per started minute. Ask it
830
+ * before offering a mode: one it does not list is refused by
831
+ * {@link editPlan} before anything is charged. Nothing is created or charged.
832
+ */
833
+ editPlanCapabilities(): Promise<EditPlanCapabilities>;
799
834
  /**
800
835
  * Camera Switch (podcast B5): choose which camera shows each cut of `edl`
801
- * by who is speaking — the sound never changes. Cloud edition; a flat
802
- * price. The finished job's `output_data.json` is the switched EDL (feed it
836
+ * by who is speaking — the sound never changes. Runs on nodaro.ai (a
837
+ * connected self-hosted install relays it); a flat price. The finished job's `output_data.json` is the switched EDL (feed it
803
838
  * to {@link applyEdl}) and `output_data.transcript` the transcript with
804
839
  * `speakerNames` applied. A transcript with no speaker labels rejects with
805
840
  * a {@link NodaroError} (`code: "no_speakers"`) before any request or charge.
@@ -815,4 +850,4 @@ declare class EditResource {
815
850
  remapTranscript(edl: Edl, transcript: Transcript): Transcript;
816
851
  }
817
852
 
818
- 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 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 };
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 };
@@ -1,5 +1,5 @@
1
- export { unwrapEditPlanOutput } from '../chunk-UKB64254.js';
2
- export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from '../chunk-MYUJEVP6.js';
3
- import '../chunk-SNPDM72K.js';
1
+ export { unwrapEditPlanOutput } from '../chunk-WFFVCGNU.js';
2
+ export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from '../chunk-VGY3WBNY.js';
3
+ import '../chunk-IJAJTVEW.js';
4
4
  //# sourceMappingURL=edit.js.map
5
5
  //# sourceMappingURL=edit.js.map
@@ -1,117 +1,117 @@
1
1
  'use strict';
2
2
 
3
3
  require('../chunk-A2ZAFAWC.cjs');
4
- var chunkQHCVKMSF_cjs = require('../chunk-QHCVKMSF.cjs');
4
+ var chunk4AD3CBDK_cjs = require('../chunk-4AD3CBDK.cjs');
5
5
 
6
6
 
7
7
 
8
8
  Object.defineProperty(exports, "AlreadyRunningError", {
9
9
  enumerable: true,
10
- get: function () { return chunkQHCVKMSF_cjs.AlreadyRunningError; }
10
+ get: function () { return chunk4AD3CBDK_cjs.AlreadyRunningError; }
11
11
  });
12
12
  Object.defineProperty(exports, "AppRunVersionChangedError", {
13
13
  enumerable: true,
14
- get: function () { return chunkQHCVKMSF_cjs.AppRunVersionChangedError; }
14
+ get: function () { return chunk4AD3CBDK_cjs.AppRunVersionChangedError; }
15
15
  });
16
16
  Object.defineProperty(exports, "CREDIT_CAP_CODES", {
17
17
  enumerable: true,
18
- get: function () { return chunkQHCVKMSF_cjs.CREDIT_CAP_CODES; }
18
+ get: function () { return chunk4AD3CBDK_cjs.CREDIT_CAP_CODES; }
19
19
  });
20
20
  Object.defineProperty(exports, "ContinuationPreviewPendingError", {
21
21
  enumerable: true,
22
- get: function () { return chunkQHCVKMSF_cjs.ContinuationPreviewPendingError; }
22
+ get: function () { return chunk4AD3CBDK_cjs.ContinuationPreviewPendingError; }
23
23
  });
24
24
  Object.defineProperty(exports, "ContinuationRefusedError", {
25
25
  enumerable: true,
26
- get: function () { return chunkQHCVKMSF_cjs.ContinuationRefusedError; }
26
+ get: function () { return chunk4AD3CBDK_cjs.ContinuationRefusedError; }
27
27
  });
28
28
  Object.defineProperty(exports, "CreditCapExceededError", {
29
29
  enumerable: true,
30
- get: function () { return chunkQHCVKMSF_cjs.CreditCapExceededError; }
30
+ get: function () { return chunk4AD3CBDK_cjs.CreditCapExceededError; }
31
31
  });
32
32
  Object.defineProperty(exports, "ForbiddenError", {
33
33
  enumerable: true,
34
- get: function () { return chunkQHCVKMSF_cjs.ForbiddenError; }
34
+ get: function () { return chunk4AD3CBDK_cjs.ForbiddenError; }
35
35
  });
36
36
  Object.defineProperty(exports, "IMPORT_REFUSAL_CODES", {
37
37
  enumerable: true,
38
- get: function () { return chunkQHCVKMSF_cjs.IMPORT_REFUSAL_CODES; }
38
+ get: function () { return chunk4AD3CBDK_cjs.IMPORT_REFUSAL_CODES; }
39
39
  });
40
40
  Object.defineProperty(exports, "ImportRefusedError", {
41
41
  enumerable: true,
42
- get: function () { return chunkQHCVKMSF_cjs.ImportRefusedError; }
42
+ get: function () { return chunk4AD3CBDK_cjs.ImportRefusedError; }
43
43
  });
44
44
  Object.defineProperty(exports, "InsufficientCreditsError", {
45
45
  enumerable: true,
46
- get: function () { return chunkQHCVKMSF_cjs.InsufficientCreditsError; }
46
+ get: function () { return chunk4AD3CBDK_cjs.InsufficientCreditsError; }
47
47
  });
48
48
  Object.defineProperty(exports, "JobAbortedError", {
49
49
  enumerable: true,
50
- get: function () { return chunkQHCVKMSF_cjs.JobAbortedError; }
50
+ get: function () { return chunk4AD3CBDK_cjs.JobAbortedError; }
51
51
  });
52
52
  Object.defineProperty(exports, "JobBlockedError", {
53
53
  enumerable: true,
54
- get: function () { return chunkQHCVKMSF_cjs.JobBlockedError; }
54
+ get: function () { return chunk4AD3CBDK_cjs.JobBlockedError; }
55
55
  });
56
56
  Object.defineProperty(exports, "JobFailedError", {
57
57
  enumerable: true,
58
- get: function () { return chunkQHCVKMSF_cjs.JobFailedError; }
58
+ get: function () { return chunk4AD3CBDK_cjs.JobFailedError; }
59
59
  });
60
60
  Object.defineProperty(exports, "JobHeldError", {
61
61
  enumerable: true,
62
- get: function () { return chunkQHCVKMSF_cjs.JobHeldError; }
62
+ get: function () { return chunk4AD3CBDK_cjs.JobHeldError; }
63
63
  });
64
64
  Object.defineProperty(exports, "JobTimeoutError", {
65
65
  enumerable: true,
66
- get: function () { return chunkQHCVKMSF_cjs.JobTimeoutError; }
66
+ get: function () { return chunk4AD3CBDK_cjs.JobTimeoutError; }
67
67
  });
68
68
  Object.defineProperty(exports, "MODEL_UNAVAILABLE_CODES", {
69
69
  enumerable: true,
70
- get: function () { return chunkQHCVKMSF_cjs.MODEL_UNAVAILABLE_CODES; }
70
+ get: function () { return chunk4AD3CBDK_cjs.MODEL_UNAVAILABLE_CODES; }
71
71
  });
72
72
  Object.defineProperty(exports, "ModelUnavailableError", {
73
73
  enumerable: true,
74
- get: function () { return chunkQHCVKMSF_cjs.ModelUnavailableError; }
74
+ get: function () { return chunk4AD3CBDK_cjs.ModelUnavailableError; }
75
75
  });
76
76
  Object.defineProperty(exports, "NodaroError", {
77
77
  enumerable: true,
78
- get: function () { return chunkQHCVKMSF_cjs.NodaroError; }
78
+ get: function () { return chunk4AD3CBDK_cjs.NodaroError; }
79
79
  });
80
80
  Object.defineProperty(exports, "NotFoundError", {
81
81
  enumerable: true,
82
- get: function () { return chunkQHCVKMSF_cjs.NotFoundError; }
82
+ get: function () { return chunk4AD3CBDK_cjs.NotFoundError; }
83
83
  });
84
84
  Object.defineProperty(exports, "RateLimitedError", {
85
85
  enumerable: true,
86
- get: function () { return chunkQHCVKMSF_cjs.RateLimitedError; }
86
+ get: function () { return chunk4AD3CBDK_cjs.RateLimitedError; }
87
87
  });
88
88
  Object.defineProperty(exports, "StorageExceededError", {
89
89
  enumerable: true,
90
- get: function () { return chunkQHCVKMSF_cjs.StorageExceededError; }
90
+ get: function () { return chunk4AD3CBDK_cjs.StorageExceededError; }
91
91
  });
92
92
  Object.defineProperty(exports, "StudioOpError", {
93
93
  enumerable: true,
94
- get: function () { return chunkQHCVKMSF_cjs.StudioOpError; }
94
+ get: function () { return chunk4AD3CBDK_cjs.StudioOpError; }
95
95
  });
96
96
  Object.defineProperty(exports, "StudioPreviewAppliedError", {
97
97
  enumerable: true,
98
- get: function () { return chunkQHCVKMSF_cjs.StudioPreviewAppliedError; }
98
+ get: function () { return chunk4AD3CBDK_cjs.StudioPreviewAppliedError; }
99
99
  });
100
100
  Object.defineProperty(exports, "StudioPreviewUnavailable", {
101
101
  enumerable: true,
102
- get: function () { return chunkQHCVKMSF_cjs.StudioPreviewUnavailable; }
102
+ get: function () { return chunk4AD3CBDK_cjs.StudioPreviewUnavailable; }
103
103
  });
104
104
  Object.defineProperty(exports, "UnauthorizedError", {
105
105
  enumerable: true,
106
- get: function () { return chunkQHCVKMSF_cjs.UnauthorizedError; }
106
+ get: function () { return chunk4AD3CBDK_cjs.UnauthorizedError; }
107
107
  });
108
108
  Object.defineProperty(exports, "WorkflowConflictError", {
109
109
  enumerable: true,
110
- get: function () { return chunkQHCVKMSF_cjs.WorkflowConflictError; }
110
+ get: function () { return chunk4AD3CBDK_cjs.WorkflowConflictError; }
111
111
  });
112
112
  Object.defineProperty(exports, "throwFromResponse", {
113
113
  enumerable: true,
114
- get: function () { return chunkQHCVKMSF_cjs.throwFromResponse; }
114
+ get: function () { return chunk4AD3CBDK_cjs.throwFromResponse; }
115
115
  });
116
116
  //# sourceMappingURL=errors.cjs.map
117
117
  //# sourceMappingURL=errors.cjs.map
@@ -21,7 +21,7 @@ declare class UnauthorizedError extends NodaroError {
21
21
  }
22
22
  declare class ForbiddenError extends NodaroError {
23
23
  readonly missingScope?: string | undefined;
24
- /** `code` defaults to `"forbidden"`; {@link ModelUnavailableError} passes its own. */
24
+ /** `code` is the server's own (`node_not_available`, `insufficient_scope`, …), `"forbidden"` when it sent none. */
25
25
  constructor(message?: string, missingScope?: string | undefined, code?: string);
26
26
  }
27
27
  type ModelUnavailableCode = "model_not_available" | "model_disabled";
@@ -82,10 +82,12 @@ declare class ImportRefusedError extends ForbiddenError {
82
82
  constructor(code: ImportRefusalCode, message?: string);
83
83
  }
84
84
  declare class NotFoundError extends NodaroError {
85
- constructor(message?: string);
85
+ /** `code` is the server's own (`continuation_not_found`, …), `"not_found"` when it sent none. */
86
+ constructor(message?: string, code?: string);
86
87
  }
87
88
  declare class RateLimitedError extends NodaroError {
88
- constructor(message?: string);
89
+ /** `code` is the server's own (`rate_limit_exceeded`, …), `"rate_limited"` when it sent none. */
90
+ constructor(message?: string, code?: string);
89
91
  }
90
92
  /**
91
93
  * HTTP 402: the run costs more than the caller may spend. `code` is the
@@ -21,7 +21,7 @@ declare class UnauthorizedError extends NodaroError {
21
21
  }
22
22
  declare class ForbiddenError extends NodaroError {
23
23
  readonly missingScope?: string | undefined;
24
- /** `code` defaults to `"forbidden"`; {@link ModelUnavailableError} passes its own. */
24
+ /** `code` is the server's own (`node_not_available`, `insufficient_scope`, …), `"forbidden"` when it sent none. */
25
25
  constructor(message?: string, missingScope?: string | undefined, code?: string);
26
26
  }
27
27
  type ModelUnavailableCode = "model_not_available" | "model_disabled";
@@ -82,10 +82,12 @@ declare class ImportRefusedError extends ForbiddenError {
82
82
  constructor(code: ImportRefusalCode, message?: string);
83
83
  }
84
84
  declare class NotFoundError extends NodaroError {
85
- constructor(message?: string);
85
+ /** `code` is the server's own (`continuation_not_found`, …), `"not_found"` when it sent none. */
86
+ constructor(message?: string, code?: string);
86
87
  }
87
88
  declare class RateLimitedError extends NodaroError {
88
- constructor(message?: string);
89
+ /** `code` is the server's own (`rate_limit_exceeded`, …), `"rate_limited"` when it sent none. */
90
+ constructor(message?: string, code?: string);
89
91
  }
90
92
  /**
91
93
  * HTTP 402: the run costs more than the caller may spend. `code` is the
@@ -1,4 +1,4 @@
1
1
  import '../chunk-CJFIOVBA.js';
2
- export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapExceededError, ForbiddenError, IMPORT_REFUSAL_CODES, ImportRefusedError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, MODEL_UNAVAILABLE_CODES, ModelUnavailableError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from '../chunk-SNPDM72K.js';
2
+ export { AlreadyRunningError, AppRunVersionChangedError, CREDIT_CAP_CODES, ContinuationPreviewPendingError, ContinuationRefusedError, CreditCapExceededError, ForbiddenError, IMPORT_REFUSAL_CODES, ImportRefusedError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, MODEL_UNAVAILABLE_CODES, ModelUnavailableError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from '../chunk-IJAJTVEW.js';
3
3
  //# sourceMappingURL=errors.js.map
4
4
  //# sourceMappingURL=errors.js.map
@@ -1,13 +1,13 @@
1
1
  'use strict';
2
2
 
3
3
  require('../chunk-TRCENAIY.cjs');
4
- var chunkSS3B6PHT_cjs = require('../chunk-SS3B6PHT.cjs');
4
+ var chunkITQB5ADE_cjs = require('../chunk-ITQB5ADE.cjs');
5
5
 
6
6
 
7
7
 
8
8
  Object.defineProperty(exports, "LlmResource", {
9
9
  enumerable: true,
10
- get: function () { return chunkSS3B6PHT_cjs.LlmResource; }
10
+ get: function () { return chunkITQB5ADE_cjs.LlmResource; }
11
11
  });
12
12
  //# sourceMappingURL=llm.cjs.map
13
13
  //# sourceMappingURL=llm.cjs.map
@@ -10,7 +10,7 @@ import '@nodaro/shared/organizations';
10
10
  * the platform cannot know — Nodaro Studio's production plan is the first).
11
11
  */
12
12
  interface LlmStructuredInput {
13
- /** The system prompt (≤ 100,000 chars). */
13
+ /** The system prompt (≤ 200,000 chars, `LLM_STRUCTURED_SYSTEM_MAX` in `@nodaro/shared`). */
14
14
  system: string;
15
15
  /** The user turn (1–100,000 chars). */
16
16
  input: string;
@@ -10,7 +10,7 @@ import '@nodaro/shared/organizations';
10
10
  * the platform cannot know — Nodaro Studio's production plan is the first).
11
11
  */
12
12
  interface LlmStructuredInput {
13
- /** The system prompt (≤ 100,000 chars). */
13
+ /** The system prompt (≤ 200,000 chars, `LLM_STRUCTURED_SYSTEM_MAX` in `@nodaro/shared`). */
14
14
  system: string;
15
15
  /** The user turn (1–100,000 chars). */
16
16
  input: string;
@@ -1,4 +1,4 @@
1
1
  import '../chunk-UIFFNTUX.js';
2
- export { LlmResource } from '../chunk-E37CVHWW.js';
2
+ export { LlmResource } from '../chunk-CNST37UF.js';
3
3
  //# sourceMappingURL=llm.js.map
4
4
  //# sourceMappingURL=llm.js.map
@@ -2,7 +2,7 @@ import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, Surround
2
2
  export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
3
3
  import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.cjs';
4
4
  import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.cjs';
5
- import { l as GenerationSessionParams } from '../nodes-WkaQjuwS.cjs';
5
+ import { l as GenerationSessionParams } from '../nodes-YwzFHsJH.cjs';
6
6
  import '@nodaro/shared/apps';
7
7
  import '@nodaro/shared/organizations';
8
8
  import '@nodaro/shared/types';
@@ -2,7 +2,7 @@ import { LocationAssetType, CharacterAspectRatio, LocationAttachColumn, Surround
2
2
  export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
3
3
  import { N as NodaroClientCore } from '../developer-apps-CMUzKpE9.js';
4
4
  import { SetKeeperCatalogInput, SetKeeperCatalogResult } from './keepers.js';
5
- import { l as GenerationSessionParams } from '../nodes-C9O2tdGH.js';
5
+ import { l as GenerationSessionParams } from '../nodes-CBWTkR37.js';
6
6
  import '@nodaro/shared/apps';
7
7
  import '@nodaro/shared/organizations';
8
8
  import '@nodaro/shared/types';
@@ -1,15 +1,15 @@
1
1
  'use strict';
2
2
 
3
3
  require('../chunk-RHETJOUM.cjs');
4
- var chunkPHBOLYRT_cjs = require('../chunk-PHBOLYRT.cjs');
5
- require('../chunk-DQQRFBWY.cjs');
6
- require('../chunk-QHCVKMSF.cjs');
4
+ var chunk3G65RIZS_cjs = require('../chunk-3G65RIZS.cjs');
5
+ require('../chunk-EJJIA765.cjs');
6
+ require('../chunk-4AD3CBDK.cjs');
7
7
 
8
8
 
9
9
 
10
10
  Object.defineProperty(exports, "MediaResource", {
11
11
  enumerable: true,
12
- get: function () { return chunkPHBOLYRT_cjs.MediaResource; }
12
+ get: function () { return chunk3G65RIZS_cjs.MediaResource; }
13
13
  });
14
14
  //# sourceMappingURL=media.cjs.map
15
15
  //# sourceMappingURL=media.cjs.map
@@ -1,6 +1,6 @@
1
1
  import '../chunk-ES2E65HT.js';
2
- export { MediaResource } from '../chunk-CSIPRLX3.js';
3
- import '../chunk-JC66EEFI.js';
4
- import '../chunk-SNPDM72K.js';
2
+ export { MediaResource } from '../chunk-FFT2YPB4.js';
3
+ import '../chunk-SZ67PDKE.js';
4
+ import '../chunk-IJAJTVEW.js';
5
5
  //# sourceMappingURL=media.js.map
6
6
  //# sourceMappingURL=media.js.map
@@ -1,13 +1,13 @@
1
1
  'use strict';
2
2
 
3
3
  require('../chunk-QUFU5RJ7.cjs');
4
- var chunkRPV4QBHS_cjs = require('../chunk-RPV4QBHS.cjs');
4
+ var chunkHY45ZOKW_cjs = require('../chunk-HY45ZOKW.cjs');
5
5
 
6
6
 
7
7
 
8
8
  Object.defineProperty(exports, "ModelsResource", {
9
9
  enumerable: true,
10
- get: function () { return chunkRPV4QBHS_cjs.ModelsResource; }
10
+ get: function () { return chunkHY45ZOKW_cjs.ModelsResource; }
11
11
  });
12
12
  //# sourceMappingURL=models.cjs.map
13
13
  //# sourceMappingURL=models.cjs.map
@@ -46,10 +46,40 @@ interface ModelSummary {
46
46
  features?: string[];
47
47
  aspectRatios?: string[];
48
48
  resolutions?: string[];
49
+ /**
50
+ * The aspect ratios at which the model renders fewer sizes than
51
+ * `resolutions`, each with the sizes it renders there, in the spelling of
52
+ * `resolutions` — e.g. GPT Image 2.5 `{ "27:16": ["1K"], "16:27": ["1K"],
53
+ * "9:8": ["1K"], "8:9": ["1K"] }`. A ratio not listed renders every entry of
54
+ * `resolutions`. Absent when every ratio renders every size (and on an
55
+ * older server). A request for a size its ratio does not render runs, and
56
+ * is charged, at the largest size the ratio renders at or below it; the
57
+ * response's `adjustments` say so. A size menu offers, at the chosen ratio,
58
+ * `resolutionsByAspectRatio?.[ratio] ?? resolutions`.
59
+ */
60
+ resolutionsByAspectRatio?: Record<string, string[]>;
49
61
  qualities?: string[];
50
62
  /** The image background settings the model takes (`auto`, `opaque`, `transparent`). */
51
63
  backgrounds?: string[];
64
+ /**
65
+ * The one size a transparent background renders at, where the model limits
66
+ * it (`"1K"` on GPT Image 2.5, and 2.6 Flare and Sunburst). A transparent
67
+ * request at another size runs, and is charged, at this one. Absent when
68
+ * the model sets no such limit (and on an older server).
69
+ */
70
+ transparentResolution?: string;
71
+ /**
72
+ * `true` when the model takes a background setting only at
73
+ * `transparentResolution` (GPT Image 2.5): at any other size the setting is
74
+ * not sent, so `opaque` there renders as `auto`. Absent otherwise.
75
+ */
76
+ backgroundOnlyAtTransparentResolution?: true;
52
77
  durations?: number[];
78
+ /** The length (seconds) a request that names no `duration` renders and is
79
+ * charged at, where the model has one. */
80
+ defaultDuration?: number;
81
+ /** `true` when the model accepts `duration: -1`: it picks the length itself. */
82
+ autoDuration?: true;
53
83
  /** Compact per-model prompting tips (present when a doctrine exists). */
54
84
  promptTips?: string[];
55
85
  /** TRUE only when a sourced per-family prompt doctrine exists for this