agentcut 0.2.23 → 0.2.25

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 (41) hide show
  1. package/dist/studio/canvas.d.ts +3 -0
  2. package/dist/studio/canvas.js +10 -2
  3. package/dist/studio/canvas.js.map +1 -1
  4. package/dist/studio/chat.js +6 -0
  5. package/dist/studio/chat.js.map +1 -1
  6. package/dist/studio/host.d.ts +2 -0
  7. package/dist/studio/host.js +30 -5
  8. package/dist/studio/host.js.map +1 -1
  9. package/dist/studio/mcp-guides.js +22 -12
  10. package/dist/studio/mcp-guides.js.map +1 -1
  11. package/dist/studio/read-batch.d.ts +45 -0
  12. package/dist/studio/read-batch.js +25 -0
  13. package/dist/studio/read-batch.js.map +1 -0
  14. package/dist/studio/review-plan.d.ts +53 -0
  15. package/dist/studio/review-plan.js +52 -0
  16. package/dist/studio/review-plan.js.map +1 -0
  17. package/dist/studio/tools.js +14 -3
  18. package/dist/studio/tools.js.map +1 -1
  19. package/dist/studio/video-creation.d.ts +15 -0
  20. package/dist/studio/video-creation.js +90 -0
  21. package/dist/studio/video-creation.js.map +1 -0
  22. package/dist/studio/voice/kokoro-catalog.d.ts +253 -0
  23. package/dist/studio/voice/kokoro-catalog.js +285 -0
  24. package/dist/studio/voice/kokoro-catalog.js.map +1 -0
  25. package/dist/studio/voice/kokoro.d.ts +5 -0
  26. package/dist/studio/voice/kokoro.js +152 -0
  27. package/dist/studio/voice/kokoro.js.map +1 -0
  28. package/dist/studio/voice/registry.js +2 -0
  29. package/dist/studio/voice/registry.js.map +1 -1
  30. package/dist/studio/voice/types.d.ts +8 -0
  31. package/dist/studio/voice.d.ts +6 -0
  32. package/dist/studio/voice.js +10 -19
  33. package/dist/studio/voice.js.map +1 -1
  34. package/package.json +56 -54
  35. package/template/skill/SKILL.md +34 -1
  36. package/template/skill/references/efficient-review.md +71 -0
  37. package/template/skill/references/feature-launch.md +30 -0
  38. package/template/skill/references/how-to.md +161 -0
  39. package/template/skill/references/product-launch.md +131 -0
  40. package/template/skill/references/sound.md +9 -5
  41. package/template/skill/references/website-howto.md +4 -0
@@ -0,0 +1,285 @@
1
+ // Labels: Kokoro upstream VOICES.md and ScreenSlick tts-constants.ts.
2
+ // Suggested uses: ScreenSlick director playbook; these are editorial defaults, not measured tone.
3
+ export const KOKORO_VOICES = [
4
+ {
5
+ id: "af_heart",
6
+ name: "Heart",
7
+ language: "en-US",
8
+ accent: "American",
9
+ gender: "female",
10
+ description: "American English, female",
11
+ previewUrl: "/voice-samples/kokoro/af_heart.wav",
12
+ suggestedUses: ["tutorial"],
13
+ },
14
+ {
15
+ id: "af_alloy",
16
+ name: "Alloy",
17
+ language: "en-US",
18
+ accent: "American",
19
+ gender: "female",
20
+ description: "American English, female",
21
+ previewUrl: "/voice-samples/kokoro/af_alloy.wav",
22
+ suggestedUses: [],
23
+ },
24
+ {
25
+ id: "af_aoede",
26
+ name: "Aoede",
27
+ language: "en-US",
28
+ accent: "American",
29
+ gender: "female",
30
+ description: "American English, female",
31
+ previewUrl: "/voice-samples/kokoro/af_aoede.wav",
32
+ suggestedUses: [],
33
+ },
34
+ {
35
+ id: "af_bella",
36
+ name: "Bella",
37
+ language: "en-US",
38
+ accent: "American",
39
+ gender: "female",
40
+ description: "American English, female",
41
+ previewUrl: "/voice-samples/kokoro/af_bella.wav",
42
+ suggestedUses: ["demo"],
43
+ },
44
+ {
45
+ id: "af_jessica",
46
+ name: "Jessica",
47
+ language: "en-US",
48
+ accent: "American",
49
+ gender: "female",
50
+ description: "American English, female",
51
+ previewUrl: "/voice-samples/kokoro/af_jessica.wav",
52
+ suggestedUses: [],
53
+ },
54
+ {
55
+ id: "af_kore",
56
+ name: "Kore",
57
+ language: "en-US",
58
+ accent: "American",
59
+ gender: "female",
60
+ description: "American English, female",
61
+ previewUrl: "/voice-samples/kokoro/af_kore.wav",
62
+ suggestedUses: [],
63
+ },
64
+ {
65
+ id: "af_nicole",
66
+ name: "Nicole",
67
+ language: "en-US",
68
+ accent: "American",
69
+ gender: "female",
70
+ description: "American English, female",
71
+ previewUrl: "/voice-samples/kokoro/af_nicole.wav",
72
+ suggestedUses: [],
73
+ },
74
+ {
75
+ id: "af_nova",
76
+ name: "Nova",
77
+ language: "en-US",
78
+ accent: "American",
79
+ gender: "female",
80
+ description: "American English, female",
81
+ previewUrl: "/voice-samples/kokoro/af_nova.wav",
82
+ suggestedUses: [],
83
+ },
84
+ {
85
+ id: "af_river",
86
+ name: "River",
87
+ language: "en-US",
88
+ accent: "American",
89
+ gender: "female",
90
+ description: "American English, female",
91
+ previewUrl: "/voice-samples/kokoro/af_river.wav",
92
+ suggestedUses: [],
93
+ },
94
+ {
95
+ id: "af_sarah",
96
+ name: "Sarah",
97
+ language: "en-US",
98
+ accent: "American",
99
+ gender: "female",
100
+ description: "American English, female",
101
+ previewUrl: "/voice-samples/kokoro/af_sarah.wav",
102
+ suggestedUses: [],
103
+ },
104
+ {
105
+ id: "af_sky",
106
+ name: "Sky",
107
+ language: "en-US",
108
+ accent: "American",
109
+ gender: "female",
110
+ description: "American English, female",
111
+ previewUrl: "/voice-samples/kokoro/af_sky.wav",
112
+ suggestedUses: [],
113
+ },
114
+ {
115
+ id: "am_adam",
116
+ name: "Adam",
117
+ language: "en-US",
118
+ accent: "American",
119
+ gender: "male",
120
+ description: "American English, male",
121
+ previewUrl: "/voice-samples/kokoro/am_adam.wav",
122
+ suggestedUses: [],
123
+ },
124
+ {
125
+ id: "am_echo",
126
+ name: "Echo",
127
+ language: "en-US",
128
+ accent: "American",
129
+ gender: "male",
130
+ description: "American English, male",
131
+ previewUrl: "/voice-samples/kokoro/am_echo.wav",
132
+ suggestedUses: [],
133
+ },
134
+ {
135
+ id: "am_eric",
136
+ name: "Eric",
137
+ language: "en-US",
138
+ accent: "American",
139
+ gender: "male",
140
+ description: "American English, male",
141
+ previewUrl: "/voice-samples/kokoro/am_eric.wav",
142
+ suggestedUses: [],
143
+ },
144
+ {
145
+ id: "am_fenrir",
146
+ name: "Fenrir",
147
+ language: "en-US",
148
+ accent: "American",
149
+ gender: "male",
150
+ description: "American English, male",
151
+ previewUrl: "/voice-samples/kokoro/am_fenrir.wav",
152
+ suggestedUses: [],
153
+ },
154
+ {
155
+ id: "am_liam",
156
+ name: "Liam",
157
+ language: "en-US",
158
+ accent: "American",
159
+ gender: "male",
160
+ description: "American English, male",
161
+ previewUrl: "/voice-samples/kokoro/am_liam.wav",
162
+ suggestedUses: [],
163
+ },
164
+ {
165
+ id: "am_michael",
166
+ name: "Michael",
167
+ language: "en-US",
168
+ accent: "American",
169
+ gender: "male",
170
+ description: "American English, male",
171
+ previewUrl: "/voice-samples/kokoro/am_michael.wav",
172
+ suggestedUses: ["sales"],
173
+ },
174
+ {
175
+ id: "am_onyx",
176
+ name: "Onyx",
177
+ language: "en-US",
178
+ accent: "American",
179
+ gender: "male",
180
+ description: "American English, male",
181
+ previewUrl: "/voice-samples/kokoro/am_onyx.wav",
182
+ suggestedUses: [],
183
+ },
184
+ {
185
+ id: "am_puck",
186
+ name: "Puck",
187
+ language: "en-US",
188
+ accent: "American",
189
+ gender: "male",
190
+ description: "American English, male",
191
+ previewUrl: "/voice-samples/kokoro/am_puck.wav",
192
+ suggestedUses: ["launch", "release"],
193
+ },
194
+ {
195
+ id: "am_santa",
196
+ name: "Santa",
197
+ language: "en-US",
198
+ accent: "American",
199
+ gender: "male",
200
+ description: "American English, male",
201
+ previewUrl: "/voice-samples/kokoro/am_santa.wav",
202
+ suggestedUses: [],
203
+ },
204
+ {
205
+ id: "bf_alice",
206
+ name: "Alice",
207
+ language: "en-GB",
208
+ accent: "British",
209
+ gender: "female",
210
+ description: "British English, female",
211
+ previewUrl: "/voice-samples/kokoro/bf_alice.wav",
212
+ suggestedUses: [],
213
+ },
214
+ {
215
+ id: "bf_emma",
216
+ name: "Emma",
217
+ language: "en-GB",
218
+ accent: "British",
219
+ gender: "female",
220
+ description: "British English, female",
221
+ previewUrl: "/voice-samples/kokoro/bf_emma.wav",
222
+ suggestedUses: ["walkthrough"],
223
+ },
224
+ {
225
+ id: "bf_isabella",
226
+ name: "Isabella",
227
+ language: "en-GB",
228
+ accent: "British",
229
+ gender: "female",
230
+ description: "British English, female",
231
+ previewUrl: "/voice-samples/kokoro/bf_isabella.wav",
232
+ suggestedUses: [],
233
+ },
234
+ {
235
+ id: "bf_lily",
236
+ name: "Lily",
237
+ language: "en-GB",
238
+ accent: "British",
239
+ gender: "female",
240
+ description: "British English, female",
241
+ previewUrl: "/voice-samples/kokoro/bf_lily.wav",
242
+ suggestedUses: [],
243
+ },
244
+ {
245
+ id: "bm_daniel",
246
+ name: "Daniel",
247
+ language: "en-GB",
248
+ accent: "British",
249
+ gender: "male",
250
+ description: "British English, male",
251
+ previewUrl: "/voice-samples/kokoro/bm_daniel.wav",
252
+ suggestedUses: [],
253
+ },
254
+ {
255
+ id: "bm_fable",
256
+ name: "Fable",
257
+ language: "en-GB",
258
+ accent: "British",
259
+ gender: "male",
260
+ description: "British English, male",
261
+ previewUrl: "/voice-samples/kokoro/bm_fable.wav",
262
+ suggestedUses: [],
263
+ },
264
+ {
265
+ id: "bm_george",
266
+ name: "George",
267
+ language: "en-GB",
268
+ accent: "British",
269
+ gender: "male",
270
+ description: "British English, male",
271
+ previewUrl: "/voice-samples/kokoro/bm_george.wav",
272
+ suggestedUses: [],
273
+ },
274
+ {
275
+ id: "bm_lewis",
276
+ name: "Lewis",
277
+ language: "en-GB",
278
+ accent: "British",
279
+ gender: "male",
280
+ description: "British English, male",
281
+ previewUrl: "/voice-samples/kokoro/bm_lewis.wav",
282
+ suggestedUses: [],
283
+ },
284
+ ];
285
+ //# sourceMappingURL=kokoro-catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kokoro-catalog.js","sourceRoot":"","sources":["../../../src/studio/voice/kokoro-catalog.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type { VoiceAdapter, GenerateVoiceInput } from "./types.js";
2
+ export declare function selectKokoroVoice(input: GenerateVoiceInput): string;
3
+ export declare function validateKokoro(input: GenerateVoiceInput, voice: string, model: string): void;
4
+ export declare function splitKokoroText(text: string): string[];
5
+ export declare const adapter: VoiceAdapter;
@@ -0,0 +1,152 @@
1
+ import { homedir } from "node:os";
2
+ import { join } from "node:path";
3
+ import { KOKORO_VOICES } from "./kokoro-catalog.js";
4
+ const MODEL = "onnx-community/Kokoro-82M-v1.0-ONNX";
5
+ let engine = null;
6
+ let queue = Promise.resolve();
7
+ export function selectKokoroVoice(input) {
8
+ const accent = input.accent ??
9
+ (/^(en[-_]gb|british english)$/i.test(input.language ?? "")
10
+ ? "British"
11
+ : /^(en[-_]us|american english)$/i.test(input.language ?? "")
12
+ ? "American"
13
+ : undefined);
14
+ const choices = KOKORO_VOICES.filter((v) => (!input.gender || input.gender === v.gender) &&
15
+ (!accent || accent === v.accent));
16
+ if (input.voice) {
17
+ if (!choices.some((v) => v.id === input.voice))
18
+ throw new Error("The selected Kokoro voice does not match the requested voice, gender or accent. Review the voice options; no other provider was called.");
19
+ return input.voice;
20
+ }
21
+ const purpose = input.purpose;
22
+ return (choices.find((v) => purpose && v.suggestedUses.includes(purpose))?.id ??
23
+ choices.find((v) => v.id === "af_heart")?.id ??
24
+ choices[0]?.id ??
25
+ (() => {
26
+ throw new Error("No Kokoro voice matches these constraints.");
27
+ })());
28
+ }
29
+ export function validateKokoro(input, voice, model) {
30
+ selectKokoroVoice({ ...input, voice });
31
+ if (model !== MODEL)
32
+ throw new Error("Choose the Kokoro-82M v1.0 model.");
33
+ if (!KOKORO_VOICES.some((item) => item.id === voice))
34
+ throw new Error("Unknown Kokoro voice. Read the voice options and select a listed voice.");
35
+ if (input.language &&
36
+ !/^(en(?:[-_](?:us|gb))?|english|american english|british english)$/i.test(input.language.trim()))
37
+ throw new Error("Local Kokoro supports English only in this version. Choose an English script, or explicitly select a paid provider that supports your language. No paid provider was called.");
38
+ if (/[^\p{Script=Latin}\p{Script=Common}\p{Script=Inherited}\s]/u.test(input.text))
39
+ throw new Error("This Kokoro runtime supports English only. Use an English script or explicitly select another provider. No paid provider was called.");
40
+ if (input.speed !== undefined &&
41
+ (!Number.isFinite(input.speed) || input.speed < 0.5 || input.speed > 2))
42
+ throw new Error("Kokoro speed must be between 0.5 and 2.");
43
+ if (input.style?.trim())
44
+ throw new Error("Kokoro does not support style instructions. Choose a listed voice and speed, or explicitly select another provider.");
45
+ }
46
+ async function getEngine() {
47
+ if (!engine)
48
+ engine = (async () => {
49
+ const { KokoroTTS } = await import("kokoro-js");
50
+ const { env } = await import("@huggingface/transformers");
51
+ env.cacheDir =
52
+ process.env.AGENTCUT_MODEL_CACHE ||
53
+ join(homedir(), ".agentcut", "models");
54
+ return KokoroTTS.from_pretrained(MODEL, { dtype: "q8", device: "cpu" });
55
+ })().catch((reason) => {
56
+ engine = null;
57
+ throw new Error(`Local Kokoro setup failed. First use needs an internet connection for the model (about 93 MB plus small support files) and a writable model cache. Retry after checking the connection and disk space. No paid provider was called. ${reason instanceof Error ? reason.message : String(reason)}`);
58
+ });
59
+ return engine;
60
+ }
61
+ export function splitKokoroText(text) {
62
+ const chunks = [];
63
+ let part = "";
64
+ for (const token of text.trim().split(/\s+/)) {
65
+ for (let start = 0; start < token.length; start += 180) {
66
+ const word = token.slice(start, start + 180);
67
+ if (part && part.length + word.length + 1 > 180) {
68
+ chunks.push(part);
69
+ part = "";
70
+ }
71
+ part += (part ? " " : "") + word;
72
+ if (/[.!?]$/.test(word)) {
73
+ chunks.push(part);
74
+ part = "";
75
+ }
76
+ }
77
+ }
78
+ if (part)
79
+ chunks.push(part);
80
+ return chunks;
81
+ }
82
+ export const adapter = {
83
+ spec: {
84
+ id: "kokoro",
85
+ name: "Kokoro (free, local)",
86
+ local: true,
87
+ keyUrl: "",
88
+ keyHint: "No key. First use downloads about 93 MB. English only.",
89
+ envVar: "",
90
+ defaultModel: MODEL,
91
+ models: [{ id: MODEL, label: "Kokoro-82M v1.0 (local CPU, q8)" }],
92
+ defaultVoice: "af_heart",
93
+ styleNote: "English, American and British voices. Pick a voice and speed; style instructions are not supported. First use downloads the model; later use reuses the cache. No paid fallback.",
94
+ },
95
+ voices: KOKORO_VOICES.map((voice) => ({
96
+ ...voice,
97
+ suggestedUses: [...voice.suggestedUses],
98
+ })),
99
+ async listVoices() {
100
+ return this.voices;
101
+ },
102
+ async verify() {
103
+ throw new Error("Kokoro does not use an API key.");
104
+ },
105
+ async synthesize(_key, input, model, voice) {
106
+ validateKokoro(input, voice, model);
107
+ const task = queue
108
+ .catch(() => undefined)
109
+ .then(async () => {
110
+ const tts = await getEngine();
111
+ const chunks = [];
112
+ let sampleRate = 24000;
113
+ // Bound English chunks before the runtime tokenizer's 510-token window.
114
+ for (const text of splitKokoroText(input.text)) {
115
+ const audio = await tts.generate(text, {
116
+ voice: voice,
117
+ speed: input.speed ?? 1,
118
+ });
119
+ chunks.push(audio.audio);
120
+ sampleRate = audio.sampling_rate;
121
+ }
122
+ const length = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
123
+ if (!length)
124
+ throw new Error("Kokoro returned no audio. No paid provider was called.");
125
+ const samples = new Float32Array(length);
126
+ let offset = 0;
127
+ for (const chunk of chunks) {
128
+ samples.set(chunk, offset);
129
+ offset += chunk.length;
130
+ }
131
+ const wav = Buffer.alloc(44 + length * 2);
132
+ wav.write("RIFF");
133
+ wav.writeUInt32LE(wav.length - 8, 4);
134
+ wav.write("WAVEfmt ", 8);
135
+ wav.writeUInt32LE(16, 16);
136
+ wav.writeUInt16LE(1, 20);
137
+ wav.writeUInt16LE(1, 22);
138
+ wav.writeUInt32LE(sampleRate, 24);
139
+ wav.writeUInt32LE(sampleRate * 2, 28);
140
+ wav.writeUInt16LE(2, 32);
141
+ wav.writeUInt16LE(16, 34);
142
+ wav.write("data", 36);
143
+ wav.writeUInt32LE(length * 2, 40);
144
+ for (let i = 0; i < length; i++)
145
+ wav.writeInt16LE(Math.round(Math.max(-1, Math.min(1, samples[i])) * 32767), 44 + i * 2);
146
+ return { data: wav, ext: "wav" };
147
+ });
148
+ queue = task.then(() => undefined, () => undefined);
149
+ return task;
150
+ },
151
+ };
152
+ //# sourceMappingURL=kokoro.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kokoro.js","sourceRoot":"","sources":["../../../src/studio/voice/kokoro.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,11 @@
1
+ import { adapter as kokoro } from "./kokoro.js";
1
2
  import { adapter as elevenlabs } from "./elevenlabs.js";
2
3
  import { adapter as gemini } from "./gemini.js";
3
4
  import { adapter as openai } from "./openai.js";
4
5
  import { adapter as xai } from "./xai.js";
5
6
  /** One registration point for synthesis metadata, validation, voices and generation. */
6
7
  export const VOICE_ADAPTERS = {
8
+ kokoro,
7
9
  elevenlabs,
8
10
  gemini,
9
11
  openai,
@@ -1 +1 @@
1
- {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/studio/voice/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AAE1C,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,UAAU;IACV,MAAM;IACN,MAAM;IACN,GAAG;CACJ,CAAC;AACF,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/studio/voice/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AAE1C,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,MAAM;IACN,UAAU;IACV,MAAM;IACN,MAAM;IACN,GAAG;CACJ,CAAC;AACF,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO;QACV,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -3,8 +3,13 @@ export interface VoiceInfo {
3
3
  name: string;
4
4
  description?: string;
5
5
  previewUrl?: string;
6
+ language?: string;
7
+ accent?: string;
8
+ gender?: string;
9
+ suggestedUses?: string[];
6
10
  }
7
11
  export interface ProviderSpec {
12
+ local?: boolean;
8
13
  id: string;
9
14
  name: string;
10
15
  keyUrl: string;
@@ -20,6 +25,9 @@ export interface ProviderSpec {
20
25
  }
21
26
  export interface GenerateVoiceInput {
22
27
  provider?: string;
28
+ purpose?: "tutorial" | "walkthrough" | "demo" | "launch" | "sales";
29
+ gender?: "female" | "male";
30
+ accent?: "American" | "British";
23
31
  model?: string;
24
32
  voice?: string;
25
33
  text: string;
@@ -13,6 +13,7 @@ export declare function voiceSettings(): {
13
13
  providers: {
14
14
  configured: boolean;
15
15
  source: "saved" | "environment" | null;
16
+ local?: boolean;
16
17
  id: string;
17
18
  name: string;
18
19
  keyUrl: string;
@@ -34,6 +35,7 @@ export declare function saveKey(providerId: unknown, rawKey: unknown, makeDefaul
34
35
  providers: {
35
36
  configured: boolean;
36
37
  source: "saved" | "environment" | null;
38
+ local?: boolean;
37
39
  id: string;
38
40
  name: string;
39
41
  keyUrl: string;
@@ -53,6 +55,7 @@ export declare function removeKey(providerId: unknown): {
53
55
  providers: {
54
56
  configured: boolean;
55
57
  source: "saved" | "environment" | null;
58
+ local?: boolean;
56
59
  id: string;
57
60
  name: string;
58
61
  keyUrl: string;
@@ -72,6 +75,7 @@ export declare function setDefaultProvider(providerId: unknown): {
72
75
  providers: {
73
76
  configured: boolean;
74
77
  source: "saved" | "environment" | null;
78
+ local?: boolean;
75
79
  id: string;
76
80
  name: string;
77
81
  keyUrl: string;
@@ -113,12 +117,14 @@ export declare function voiceOptions(): {
113
117
  id: string;
114
118
  name: string;
115
119
  configured: boolean;
120
+ local: boolean;
116
121
  defaultModel: string;
117
122
  models: string[];
118
123
  defaultVoice: string | undefined;
119
124
  style: string;
120
125
  voices: string | string[];
121
126
  }[];
127
+ localVoices: VoiceInfo[] | null;
122
128
  note: string;
123
129
  };
124
130
  export declare function hasKeyFile(): boolean;
@@ -1,3 +1,4 @@
1
+ import { selectKokoroVoice } from "./voice/kokoro.js";
1
2
  // Voice-over generation for Agentcut, with the user's own API keys.
2
3
  //
3
4
  // Keys live in a file in the user's home folder (outside the workspace, so Claude's file
@@ -28,20 +29,10 @@ export function keyFor(id) {
28
29
  return store.key(id);
29
30
  }
30
31
  /** Env vars that hold provider keys: removed from Claude's environment. */
31
- export const VOICE_KEY_ENV_VARS = VOICE_PROVIDERS.map((p) => p.envVar);
32
+ export const VOICE_KEY_ENV_VARS = VOICE_PROVIDERS.map((p) => p.envVar).filter(Boolean);
32
33
  export function voiceSettings() {
33
- const providers = VOICE_PROVIDERS.map((p) => ({
34
- ...p,
35
- ...store.status(p.id),
36
- }));
37
- const configured = providers.filter((p) => p.configured).map((p) => p.id);
38
- const preferred = store.preferred();
39
- return {
40
- providers,
41
- defaultProvider: preferred && configured.includes(preferred)
42
- ? preferred
43
- : (configured[0] ?? null),
44
- };
34
+ const providers = VOICE_PROVIDERS.map(p => ({ ...p, ...(p.local ? { configured: true, source: null } : store.status(p.id)) }));
35
+ return { providers, defaultProvider: "kokoro" };
45
36
  }
46
37
  // ---------------------------------------------------------------------------
47
38
  // Provider calls
@@ -115,10 +106,10 @@ export async function generateVoice(paths, slug, input) {
115
106
  }
116
107
  const provider = spec(providerId);
117
108
  const key = keyFor(provider.id);
118
- if (!key)
109
+ if (!key && !provider.local)
119
110
  throw new Error(`No ${provider.name} key yet. Ask the user to add one under Voice-over in the studio header.`);
120
111
  const model = input.model?.trim() || provider.defaultModel;
121
- const voice = input.voice?.trim() || provider.defaultVoice;
112
+ const voice = provider.id === "kokoro" ? selectKokoroVoice(input) : input.voice?.trim() || provider.defaultVoice;
122
113
  const takes = Math.max(1, Math.min(4, Math.round(input.takes ?? 1)));
123
114
  const base = slugName(input.name ||
124
115
  `${voice || provider.id}-${text.split(/\s+/).slice(0, 4).join(" ")}`) || "voice";
@@ -126,7 +117,7 @@ export async function generateVoice(paths, slug, input) {
126
117
  mkdirSync(dir, { recursive: true });
127
118
  const results = await Promise.all(Array.from({ length: takes }, async (_, index) => {
128
119
  try {
129
- const audio = await getVoiceAdapter(provider.id).synthesize(key, { ...input, text }, model, voice);
120
+ const audio = await getVoiceAdapter(provider.id).synthesize(key ?? "", { ...input, text }, model, voice);
130
121
  const target = uniquePath(safeJoin(projectDir(paths, slug), `assets/voice/${base}${takes > 1 ? `-take${index + 1}` : ""}.${audio.ext}`));
131
122
  atomicWrite(target, audio.data);
132
123
  const rel = `assets/voice/${target.split(/[\\/]/).pop()}`;
@@ -160,6 +151,7 @@ export function voiceOptions() {
160
151
  id: p.id,
161
152
  name: p.name,
162
153
  configured: p.configured,
154
+ local: Boolean(p.local),
163
155
  defaultModel: p.defaultModel,
164
156
  models: p.models.map((m) => m.id),
165
157
  defaultVoice: p.defaultVoice || undefined,
@@ -167,9 +159,8 @@ export function voiceOptions() {
167
159
  voices: getVoiceAdapter(p.id).voices?.map((v) => v.description ? v.id + " (" + v.description + ")" : v.id) ??
168
160
  "Call agentcut_voice_options with this provider to list account voices.",
169
161
  })),
170
- note: settings.defaultProvider
171
- ? "Use the user's default provider unless they name another. Never ask for or mention API keys; the helper adds them."
172
- : "No provider is set up yet: ask the user to open Voice-over in the studio header and add a key.",
162
+ localVoices: getVoiceAdapter("kokoro").voices,
163
+ note: "Use local Kokoro for generic voice-over requests, even when paid keys exist. Use a paid provider only when the user explicitly requests or selects it. Honor explicit voice, language, accent and gender preferences; do not silently substitute. Kokoro is English only. Its suggested uses are ScreenSlick editorial defaults, not measured tone. For unknown tone, audition a sample. Local failures never call a paid provider.",
173
164
  };
174
165
  }
175
166
  export function hasKeyFile() {