@nodaro/shared 3.55.0 → 3.56.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 (178) hide show
  1. package/dist/{chunk-3CHOZ573.js → chunk-2AR3OXAA.js} +276 -17
  2. package/dist/chunk-2AR3OXAA.js.map +1 -0
  3. package/dist/{chunk-ZKHQSG76.js → chunk-2J6NTA5I.js} +4 -4
  4. package/dist/{chunk-ZKHQSG76.js.map → chunk-2J6NTA5I.js.map} +1 -1
  5. package/dist/{chunk-AGTCHDG5.cjs → chunk-33P5FI2U.cjs} +6 -6
  6. package/dist/{chunk-AGTCHDG5.cjs.map → chunk-33P5FI2U.cjs.map} +1 -1
  7. package/dist/{chunk-HG3KKCJJ.js → chunk-4JODLC2N.js} +3 -3
  8. package/dist/{chunk-HG3KKCJJ.js.map → chunk-4JODLC2N.js.map} +1 -1
  9. package/dist/{chunk-N3WL6IOJ.js → chunk-4O5STV7N.js} +55 -5
  10. package/dist/chunk-4O5STV7N.js.map +1 -0
  11. package/dist/chunk-4ONS6QRT.js +42 -0
  12. package/dist/chunk-4ONS6QRT.js.map +1 -0
  13. package/dist/{chunk-E4YES25K.js → chunk-55FQBILM.js} +4 -4
  14. package/dist/{chunk-E4YES25K.js.map → chunk-55FQBILM.js.map} +1 -1
  15. package/dist/{chunk-ZWB3NG4M.js → chunk-62ZQQA7L.js} +3 -3
  16. package/dist/{chunk-ZWB3NG4M.js.map → chunk-62ZQQA7L.js.map} +1 -1
  17. package/dist/{chunk-HEF4BIMA.js → chunk-6GGHM33Z.js} +4 -4
  18. package/dist/{chunk-HEF4BIMA.js.map → chunk-6GGHM33Z.js.map} +1 -1
  19. package/dist/{chunk-KMSEU6FK.js → chunk-7DGJDISO.js} +3 -3
  20. package/dist/{chunk-KMSEU6FK.js.map → chunk-7DGJDISO.js.map} +1 -1
  21. package/dist/{chunk-2OYV6K7D.cjs → chunk-7JM5EZF3.cjs} +13 -13
  22. package/dist/{chunk-2OYV6K7D.cjs.map → chunk-7JM5EZF3.cjs.map} +1 -1
  23. package/dist/chunk-AKDJKMAL.cjs +48 -0
  24. package/dist/chunk-AKDJKMAL.cjs.map +1 -0
  25. package/dist/{chunk-HZL7QMXK.js → chunk-AWS4BWEC.js} +7 -3
  26. package/dist/chunk-AWS4BWEC.js.map +1 -0
  27. package/dist/{chunk-5DVDHL7Y.js → chunk-AZDVL7IM.js} +20 -6
  28. package/dist/chunk-AZDVL7IM.js.map +1 -0
  29. package/dist/{chunk-2R74OU76.cjs → chunk-CGZLENU4.cjs} +276 -16
  30. package/dist/chunk-CGZLENU4.cjs.map +1 -0
  31. package/dist/{chunk-G7IUQKRU.cjs → chunk-CLKU3ZIU.cjs} +51 -51
  32. package/dist/{chunk-G7IUQKRU.cjs.map → chunk-CLKU3ZIU.cjs.map} +1 -1
  33. package/dist/{chunk-MCIBQ5BF.js → chunk-DURFRWAW.js} +9 -9
  34. package/dist/{chunk-MCIBQ5BF.js.map → chunk-DURFRWAW.js.map} +1 -1
  35. package/dist/{chunk-C5S75476.js → chunk-EAKO7PGC.js} +8 -4
  36. package/dist/{chunk-C5S75476.js.map → chunk-EAKO7PGC.js.map} +1 -1
  37. package/dist/{chunk-IPCWYKX5.cjs → chunk-EWARI452.cjs} +60 -46
  38. package/dist/chunk-EWARI452.cjs.map +1 -0
  39. package/dist/{chunk-C6IQCKJT.cjs → chunk-FCQYMPUQ.cjs} +4 -4
  40. package/dist/{chunk-C6IQCKJT.cjs.map → chunk-FCQYMPUQ.cjs.map} +1 -1
  41. package/dist/{chunk-WVACGZYV.cjs → chunk-H7VMJBNZ.cjs} +8 -8
  42. package/dist/{chunk-WVACGZYV.cjs.map → chunk-H7VMJBNZ.cjs.map} +1 -1
  43. package/dist/{chunk-SEEQ3H22.cjs → chunk-HWJE4FNS.cjs} +59 -6
  44. package/dist/chunk-HWJE4FNS.cjs.map +1 -0
  45. package/dist/{chunk-3633VD2M.cjs → chunk-IKP4GOWZ.cjs} +8 -8
  46. package/dist/{chunk-3633VD2M.cjs.map → chunk-IKP4GOWZ.cjs.map} +1 -1
  47. package/dist/{chunk-5R6LTKE5.cjs → chunk-ILMHITHK.cjs} +5 -5
  48. package/dist/{chunk-5R6LTKE5.cjs.map → chunk-ILMHITHK.cjs.map} +1 -1
  49. package/dist/chunk-IOET54EV.js +39 -0
  50. package/dist/chunk-IOET54EV.js.map +1 -0
  51. package/dist/{chunk-ZAK276QF.js → chunk-JHTYULY2.js} +4 -4
  52. package/dist/{chunk-ZAK276QF.js.map → chunk-JHTYULY2.js.map} +1 -1
  53. package/dist/{chunk-OVIIJVXH.cjs → chunk-JO3XSUO2.cjs} +21 -21
  54. package/dist/{chunk-OVIIJVXH.cjs.map → chunk-JO3XSUO2.cjs.map} +1 -1
  55. package/dist/{chunk-UWMXMLMV.js → chunk-MROKQP4U.js} +3 -3
  56. package/dist/{chunk-UWMXMLMV.js.map → chunk-MROKQP4U.js.map} +1 -1
  57. package/dist/{chunk-J4CVGAAV.cjs → chunk-NZRG5CXQ.cjs} +7 -2
  58. package/dist/chunk-NZRG5CXQ.cjs.map +1 -0
  59. package/dist/{chunk-KM35K2M5.cjs → chunk-O7DXNX5J.cjs} +92 -25
  60. package/dist/chunk-O7DXNX5J.cjs.map +1 -0
  61. package/dist/chunk-OWNPYQSH.cjs +283 -0
  62. package/dist/chunk-OWNPYQSH.cjs.map +1 -0
  63. package/dist/{chunk-FIYVKW7F.cjs → chunk-PFXPAWPQ.cjs} +12 -12
  64. package/dist/{chunk-FIYVKW7F.cjs.map → chunk-PFXPAWPQ.cjs.map} +1 -1
  65. package/dist/chunk-QSWUSXRL.cjs +53 -0
  66. package/dist/chunk-QSWUSXRL.cjs.map +1 -0
  67. package/dist/{chunk-MGJR5OXO.js → chunk-RX7WII6I.js} +5 -5
  68. package/dist/{chunk-MGJR5OXO.js.map → chunk-RX7WII6I.js.map} +1 -1
  69. package/dist/chunk-S7FCFQ6X.js +255 -0
  70. package/dist/chunk-S7FCFQ6X.js.map +1 -0
  71. package/dist/{chunk-YBZQXZ6A.js → chunk-ST4WQ6ND.js} +68 -8
  72. package/dist/chunk-ST4WQ6ND.js.map +1 -0
  73. package/dist/{chunk-LKCPFD5X.js → chunk-SWVGHAYO.js} +5 -3
  74. package/dist/chunk-SWVGHAYO.js.map +1 -0
  75. package/dist/{chunk-MTUNORQB.cjs → chunk-TSKYEREJ.cjs} +11 -11
  76. package/dist/{chunk-MTUNORQB.cjs.map → chunk-TSKYEREJ.cjs.map} +1 -1
  77. package/dist/{chunk-LYWJAXPT.js → chunk-UMPZR56R.js} +3 -3
  78. package/dist/{chunk-LYWJAXPT.js.map → chunk-UMPZR56R.js.map} +1 -1
  79. package/dist/{chunk-6HUWQLF2.cjs → chunk-WKCFTWLO.cjs} +6 -6
  80. package/dist/{chunk-6HUWQLF2.cjs.map → chunk-WKCFTWLO.cjs.map} +1 -1
  81. package/dist/chunk-XPUGMYAJ.cjs +27 -0
  82. package/dist/{chunk-HD45Y7QU.cjs.map → chunk-XPUGMYAJ.cjs.map} +1 -1
  83. package/dist/{chunk-G5NTNQ7W.cjs → chunk-XROE3CAS.cjs} +5 -3
  84. package/dist/chunk-XROE3CAS.cjs.map +1 -0
  85. package/dist/{chunk-SZUDEFX2.cjs → chunk-ZXDH3L3P.cjs} +43 -39
  86. package/dist/{chunk-SZUDEFX2.cjs.map → chunk-ZXDH3L3P.cjs.map} +1 -1
  87. package/dist/{chunk-25KAGSPT.js → chunk-ZYITB47P.js} +3 -3
  88. package/dist/{chunk-25KAGSPT.js.map → chunk-ZYITB47P.js.map} +1 -1
  89. package/dist/entries/apps.cjs +43 -42
  90. package/dist/entries/apps.js +8 -7
  91. package/dist/entries/credits.cjs +151 -150
  92. package/dist/entries/credits.d.cts +4 -1
  93. package/dist/entries/credits.d.ts +4 -1
  94. package/dist/entries/credits.js +8 -7
  95. package/dist/entries/entities.cjs +125 -125
  96. package/dist/entries/entities.d.cts +1 -1
  97. package/dist/entries/entities.d.ts +1 -1
  98. package/dist/entries/entities.js +1 -1
  99. package/dist/entries/llm-models.d.cts +1 -1
  100. package/dist/entries/llm-models.d.ts +1 -1
  101. package/dist/entries/model-catalog.cjs +127 -66
  102. package/dist/entries/model-catalog.d.cts +61 -9
  103. package/dist/entries/model-catalog.d.ts +61 -9
  104. package/dist/entries/model-catalog.js +5 -4
  105. package/dist/entries/models.cjs +304 -276
  106. package/dist/entries/models.d.cts +3 -3
  107. package/dist/entries/models.d.ts +3 -3
  108. package/dist/entries/models.js +4 -4
  109. package/dist/entries/nodes.cjs +208 -207
  110. package/dist/entries/nodes.d.cts +1 -1
  111. package/dist/entries/nodes.d.ts +1 -1
  112. package/dist/entries/nodes.js +10 -9
  113. package/dist/entries/pipeline.cjs +161 -149
  114. package/dist/entries/pipeline.d.cts +165 -26
  115. package/dist/entries/pipeline.d.ts +165 -26
  116. package/dist/entries/pipeline.js +3 -3
  117. package/dist/entries/runtime-config.cjs +116 -0
  118. package/dist/entries/runtime-config.cjs.map +1 -0
  119. package/dist/entries/runtime-config.d.cts +308 -0
  120. package/dist/entries/runtime-config.d.ts +308 -0
  121. package/dist/entries/runtime-config.js +3 -0
  122. package/dist/entries/runtime-config.js.map +1 -0
  123. package/dist/entries/ugc.cjs +71 -71
  124. package/dist/entries/ugc.js +4 -4
  125. package/dist/entries/video.cjs +117 -117
  126. package/dist/entries/video.js +4 -4
  127. package/dist/entries/workflow.cjs +150 -146
  128. package/dist/entries/workflow.d.cts +8 -1
  129. package/dist/entries/workflow.d.ts +8 -1
  130. package/dist/entries/workflow.js +2 -2
  131. package/dist/index.cjs +3156 -2942
  132. package/dist/index.d.cts +6 -5
  133. package/dist/index.d.ts +6 -5
  134. package/dist/index.js +23 -21
  135. package/dist/{model-catalog-Dm2UiwUe.d.ts → model-catalog-vQ3NWn24.d.cts} +33 -2
  136. package/dist/{model-catalog-Dm2UiwUe.d.cts → model-catalog-vQ3NWn24.d.ts} +33 -2
  137. package/dist/{model-constants-DZUGVDOw.d.ts → model-constants-QZVHZX25.d.cts} +35 -6
  138. package/dist/{model-constants-DZUGVDOw.d.cts → model-constants-QZVHZX25.d.ts} +35 -6
  139. package/package.json +6 -1
  140. package/src/__tests__/fixtures/root-exports.baseline.json +2 -0
  141. package/src/__tests__/gpt-image-2-6.test.ts +277 -0
  142. package/src/__tests__/image-model-roles.test.ts +28 -9
  143. package/src/__tests__/runtime-config.test.ts +398 -0
  144. package/src/__tests__/voice-library-values.test.ts +24 -0
  145. package/src/credit-identifiers.ts +42 -0
  146. package/src/entries/model-catalog.ts +17 -0
  147. package/src/entries/models.ts +9 -0
  148. package/src/entries/runtime-config.ts +51 -0
  149. package/src/entries/workflow.ts +1 -1
  150. package/src/gpt-image-2-6.ts +104 -0
  151. package/src/image-model-roles.ts +31 -10
  152. package/src/index.ts +1 -0
  153. package/src/model-catalog.ts +302 -14
  154. package/src/model-constants.ts +84 -3
  155. package/src/node-default-mappings.ts +4 -0
  156. package/src/node-refs.ts +11 -0
  157. package/src/pipeline-types.ts +2 -0
  158. package/src/reference-board-templates.ts +2 -0
  159. package/src/runtime-config/contract.ts +492 -0
  160. package/src/runtime-config/worlds.ts +77 -0
  161. package/src/voices.ts +175 -2
  162. package/dist/chunk-2R74OU76.cjs.map +0 -1
  163. package/dist/chunk-3CHOZ573.js.map +0 -1
  164. package/dist/chunk-5DVDHL7Y.js.map +0 -1
  165. package/dist/chunk-ATWLKUAI.cjs +0 -34
  166. package/dist/chunk-ATWLKUAI.cjs.map +0 -1
  167. package/dist/chunk-DUL5ZLTJ.js +0 -29
  168. package/dist/chunk-DUL5ZLTJ.js.map +0 -1
  169. package/dist/chunk-G5NTNQ7W.cjs.map +0 -1
  170. package/dist/chunk-HD45Y7QU.cjs +0 -27
  171. package/dist/chunk-HZL7QMXK.js.map +0 -1
  172. package/dist/chunk-IPCWYKX5.cjs.map +0 -1
  173. package/dist/chunk-J4CVGAAV.cjs.map +0 -1
  174. package/dist/chunk-KM35K2M5.cjs.map +0 -1
  175. package/dist/chunk-LKCPFD5X.js.map +0 -1
  176. package/dist/chunk-N3WL6IOJ.js.map +0 -1
  177. package/dist/chunk-SEEQ3H22.cjs.map +0 -1
  178. package/dist/chunk-YBZQXZ6A.js.map +0 -1
package/src/voices.ts CHANGED
@@ -52,18 +52,108 @@ export interface SharedVoice extends Voice {
52
52
  * joins this set the release it ships.
53
53
  */
54
54
  verifiedProviders?: TtsProvider[]
55
+ /**
56
+ * The library's one-word tone for the voice (`calm`, `deep`, `cute`, …) —
57
+ * one of {@link VOICE_LIBRARY_DESCRIPTIVES}, or a word the library added
58
+ * since; `""` when it states none, like every other field here. The value
59
+ * a `descriptives` filter matches. Absent only on a server older than this
60
+ * field.
61
+ */
62
+ descriptive?: string
63
+ /**
64
+ * The voice's primary language as the library codes it (`en`, `he`, …) and
65
+ * its locale (`en-US`); `""` when unstated. For what a `language` filter
66
+ * matches see {@link SharedVoice.verifiedLanguages}. Absent only on a
67
+ * server older than these fields.
68
+ */
69
+ language?: string
70
+ locale?: string
71
+ /**
72
+ * Every language the voice is verified for, as the library codes them, the
73
+ * primary language first — the set `GET /v1/voices/library?language=`
74
+ * matches against (a voice whose primary language is English and that is
75
+ * verified for Spanish is listed under `language=es`), and what the
76
+ * `languages` facet counts. Absent only on a server older than this field.
77
+ */
78
+ verifiedLanguages?: string[]
55
79
  }
56
80
 
81
+ /**
82
+ * The `use_cases` values the Voice Library groups its voices by
83
+ * (`GET /v1/voices/library?use_cases=<one>`): what a picker shows as its
84
+ * categories. The route passes the value through verbatim, so a value the
85
+ * library adds later works before it is listed here.
86
+ */
87
+ export const VOICE_LIBRARY_USE_CASES = [
88
+ "advertisement",
89
+ "characters_animation",
90
+ "conversational",
91
+ "entertainment_tv",
92
+ "informative_educational",
93
+ "narrative_story",
94
+ "social_media",
95
+ ] as const
96
+ export type VoiceLibraryUseCase = (typeof VOICE_LIBRARY_USE_CASES)[number]
97
+
98
+ /**
99
+ * The tones (`descriptives`) the Voice Library labels its voices with
100
+ * (`GET /v1/voices/library?descriptives=<one>`), alphabetical — what a picker
101
+ * shows as a category's sub-groups. Every voice carries at most one. The
102
+ * library adds and drops words over time: this is the list it used when it
103
+ * was last read (2026-11); `GET /v1/voices/library/facets` says which exist
104
+ * now, with how many voices each, and the route passes any value through.
105
+ */
106
+ export const VOICE_LIBRARY_DESCRIPTIVES = [
107
+ "anxious",
108
+ "calm",
109
+ "casual",
110
+ "childish",
111
+ "chill",
112
+ "classy",
113
+ "confident",
114
+ "crisp",
115
+ "cute",
116
+ "deep",
117
+ "excited",
118
+ "formal",
119
+ "gentle",
120
+ "grumpy",
121
+ "husky",
122
+ "hyped",
123
+ "intense",
124
+ "mature",
125
+ "meditative",
126
+ "modulated",
127
+ "neutral",
128
+ "pleasant",
129
+ "professional",
130
+ "raspy",
131
+ "relaxed",
132
+ "robotic",
133
+ "rough",
134
+ "sad",
135
+ "sassy",
136
+ "serious",
137
+ "soft",
138
+ "upbeat",
139
+ "whispery",
140
+ "wise",
141
+ ] as const
142
+ export type VoiceLibraryDescriptive = (typeof VOICE_LIBRARY_DESCRIPTIVES)[number]
143
+
57
144
  /** Query params for `GET /v1/voices/library`. All optional; sent as a querystring. */
58
145
  export interface VoiceLibraryParams {
59
146
  search?: string
60
147
  gender?: string
61
148
  age?: string
62
149
  accent?: string
150
+ /** A language code as the library uses them (`en`, `he`); matches a voice's VERIFIED languages, not only its primary one. */
63
151
  language?: string
64
152
  category?: string
65
- use_cases?: string
66
- descriptives?: string
153
+ /** One of `VOICE_LIBRARY_USE_CASES` (any other string is passed through as sent). */
154
+ use_cases?: VoiceLibraryUseCase | (string & {})
155
+ /** One of `VOICE_LIBRARY_DESCRIPTIVES` (any other string is passed through as sent); one value per call. */
156
+ descriptives?: VoiceLibraryDescriptive | (string & {})
67
157
  featured?: boolean
68
158
  /** e.g. "trending" — passed through to the route. */
69
159
  sort?: string
@@ -79,6 +169,59 @@ export interface VoiceLibraryResponse {
79
169
  hasMore: boolean
80
170
  }
81
171
 
172
+ /**
173
+ * Query params for `GET /v1/voices/library/facets`: the listing's filters,
174
+ * without paging and sort. All optional.
175
+ */
176
+ export type VoiceLibraryFacetsParams = Pick<
177
+ VoiceLibraryParams,
178
+ "search" | "gender" | "age" | "accent" | "language" | "category" | "use_cases" | "descriptives" | "featured"
179
+ >
180
+
181
+ /** One value of a facet and how many voices carry it. */
182
+ export interface VoiceLibraryFacetCount {
183
+ value: string
184
+ count: number
185
+ }
186
+
187
+ /**
188
+ * `GET /v1/voices/library/facets` response: for the filters sent, how many
189
+ * library voices match (`total`) and that number broken down by every facet,
190
+ * so one call fills a whole picker screen. Each facet's counts apply every
191
+ * filter EXCEPT its own (a client shows every category's count while one is
192
+ * chosen); values with no voices are left out; lists are sorted by count,
193
+ * then by value. The values are the library's own spellings — the same
194
+ * strings the listing's filters take.
195
+ *
196
+ * Counted over the platform's copy of the library, refreshed on a schedule
197
+ * (`updatedAt` is when it was read), not over the live listing: a count may
198
+ * trail the listing by a few voices. `languages` counts a voice under every
199
+ * language it is verified for (what the listing's `language` filter matches),
200
+ * so those counts add up to more than `total`.
201
+ */
202
+ export interface VoiceLibraryFacets {
203
+ /** Voices matching every filter sent. */
204
+ total: number
205
+ use_cases: VoiceLibraryFacetCount[]
206
+ languages: VoiceLibraryFacetCount[]
207
+ descriptives: VoiceLibraryFacetCount[]
208
+ genders: VoiceLibraryFacetCount[]
209
+ ages: VoiceLibraryFacetCount[]
210
+ accents: VoiceLibraryFacetCount[]
211
+ categories: VoiceLibraryFacetCount[]
212
+ /**
213
+ * True when `search` was sent: the library's own search is fuzzy (it stems
214
+ * and tolerates a typo), which the counts cannot reproduce — under `search`
215
+ * they match the name and description as written and are a lower estimate.
216
+ */
217
+ approximate: boolean
218
+ /** When the copy these counts come from was read (ISO 8601); null when there is none (no speech key). */
219
+ updatedAt: string | null
220
+ /** Present (true) when the deployment has no speech key: nothing to count. */
221
+ keyMissing?: boolean
222
+ hint?: string
223
+ }
224
+
82
225
  /**
83
226
  * A user voice clone. `GET /v1/voice-clones` returns the full shape; the create
84
227
  * response (`POST /v1/voice-clones/from-url`) returns only `id, name,
@@ -101,3 +244,33 @@ export interface VoiceClone {
101
244
  /** Only on the create response (credit-tracking); never on the list. */
102
245
  jobId?: string
103
246
  }
247
+
248
+ /**
249
+ * What a favorite voice is — the `voiceType` a text-to-speech run takes for it:
250
+ * a premade voice, a Voice Library voice, or one of the user's own clones
251
+ * (`custom`). The one list the route, the MCP tool and the CLI validate against.
252
+ */
253
+ export const VOICE_FAVORITE_TYPES = ["premade", "library", "custom"] as const
254
+ export type VoiceFavoriteType = (typeof VOICE_FAVORITE_TYPES)[number]
255
+
256
+ /**
257
+ * One of the signed-in user's favorite voices (`GET /v1/voices/favorites`), newest
258
+ * first. `voiceId` is what a text-to-speech request takes as `voice` with
259
+ * `voiceType`; `name` and `previewUrl` are the snapshot the client sent when it
260
+ * starred the voice, so a favorites list renders with no second lookup.
261
+ */
262
+ export interface VoiceFavorite {
263
+ voiceId: string
264
+ voiceType: VoiceFavoriteType
265
+ name: string
266
+ previewUrl: string | null
267
+ createdAt: string
268
+ }
269
+
270
+ /** Body of `PUT /v1/voices/favorites/:voiceId`: the voice's kind and the snapshot to show it by. */
271
+ export interface VoiceFavoriteInput {
272
+ voiceId: string
273
+ voiceType: VoiceFavoriteType
274
+ name: string
275
+ previewUrl?: string | null
276
+ }