@mcptoolshop/voice-soundboard-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { type VoiceInfo, DEFAULT_VOICE, VOICES, APPROVED_VOICE_IDS, getVoice, isApprovedVoice, } from "./voices.js";
+export { type PresetConfig, PRESETS, PRESET_NAMES, getPreset, } from "./presets.js";
+export { VoiceValidationError, type ResolvedVoice, assertApprovedVoice, resolveVoiceOrPreset, } from "./validate.js";
+export { type BackendInfo, type VoiceStatusResponse, type VoiceSpeakResponse, type ArtifactMode, type VoiceInterruptResponse, type VoiceStreamResponse, type VoiceErrorResponse, type VoiceErrorCode, } from "./schemas.js";
+export { LIMITS, SHIP_LIMITS, LimitError, validateText, validateSpeed, } from "./limits.js";
+export { DEFAULT_ARTIFACT_MODE, DEFAULT_OUTPUT_FORMAT, type OutputFormat, type ArtifactConfig, buildArtifactConfig, OutputDirError, defaultOutputRoot, resolveOutputDir, } from "./artifact.js";
+export { type SynthesisRequest, type SpeakInput, buildSynthesisRequest, errorResponse, } from "./request.js";
+export { type BreakEvent, type ProsodyEvent, type ProsodyEndEvent, type EmphasisEvent, type EmphasisEndEvent, type SpeechEvent, type TextSegment, type EventSegment, type PlanSegment, type SsmlWarning, type SpeechPlan, SSML_LIMITS, parseSsmlLite, looksLikeSsml, SsmlParseError, } from "./ssml/index.js";
+export { type ChunkingOptions, type ChunkResult, type ChunkWarning, CHUNK_LIMITS, chunkText, } from "./chunking/index.js";
+export { type SynthesizeFn, type ChunkArtifact, type RunPlanOptions, type SpeechResult, type OrchestratorWarning, type RunPlanInput, runPlan, type EmotionSynthesisContext, type EmotionSynthesizeFn, type RunEmotionPlanInput, runEmotionPlan, concatWavFiles, concatWavBase64, buildWavFile, } from "./orchestrator/index.js";
+export { type DialogueLine, type DialoguePause, type DialogueCue, type CueSheet, type DialogueWarning, type CastMap, parseDialogue, DialogueParseError, type ParseDialogueOptions, } from "./dialogue/index.js";
+export { PUBLIC_EMOTIONS, type Emotion, type EmotionMapEntry, type EmotionSpan, type EmotionWarning, type EmotionParseResult, EMOTION_MAP, EMOTION_NAMES, EMOTION_SPEED_MIN, EMOTION_SPEED_MAX, clampEmotionSpeed, hasEmotionTags, parseEmotionSpans, } from "./emotion/index.js";
+export { SFX_TAGS, type SfxTag, type SfxEvent, type SfxTextSegment, type SfxSegment, type SfxWarning, type SfxParseResult, type SfxGenParams, SFX_REGISTRY, SFX_MAX_EVENTS, hasSfxTags, parseSfxTags, generateSfxWav, getSfxDurationMs, type SfxStitchWarning, type SfxStitchResult, createSfxChunks, checkSfxConcatRequired, } from "./sfx/index.js";
+export { AMBIENT_CATEGORIES, type AmbientCategory, type AmbientEntry, type AmbientConfig, type AmbientWarning, type AmbientResult, type RedactResult, redactSensitive, AmbientEmitter, } from "./ambient/index.js";
+export { SAFE_FILE_PREFIX, generateSafeFilename, isSymlink, } from "./sandbox.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// @mcptoolshop/voice-soundboard-core
+// Backend-agnostic voice soundboard core library
+export { DEFAULT_VOICE, VOICES, APPROVED_VOICE_IDS, getVoice, isApprovedVoice, } from "./voices.js";
+export { PRESETS, PRESET_NAMES, getPreset, } from "./presets.js";
+export { VoiceValidationError, assertApprovedVoice, resolveVoiceOrPreset, } from "./validate.js";
+export { LIMITS, SHIP_LIMITS, LimitError, validateText, validateSpeed, } from "./limits.js";
+export { DEFAULT_ARTIFACT_MODE, DEFAULT_OUTPUT_FORMAT, buildArtifactConfig, OutputDirError, defaultOutputRoot, resolveOutputDir, } from "./artifact.js";
+export { buildSynthesisRequest, errorResponse, } from "./request.js";
+export { SSML_LIMITS, parseSsmlLite, looksLikeSsml, SsmlParseError, } from "./ssml/index.js";
+export { CHUNK_LIMITS, chunkText, } from "./chunking/index.js";
+export { runPlan, runEmotionPlan, concatWavFiles, concatWavBase64, buildWavFile, } from "./orchestrator/index.js";
+export { parseDialogue, DialogueParseError, } from "./dialogue/index.js";
+export { PUBLIC_EMOTIONS, EMOTION_MAP, EMOTION_NAMES, EMOTION_SPEED_MIN, EMOTION_SPEED_MAX, clampEmotionSpeed, hasEmotionTags, parseEmotionSpans, } from "./emotion/index.js";
+export { SFX_TAGS, SFX_REGISTRY, SFX_MAX_EVENTS, hasSfxTags, parseSfxTags, generateSfxWav, getSfxDurationMs, createSfxChunks, checkSfxConcatRequired, } from "./sfx/index.js";
+export { AMBIENT_CATEGORIES, redactSensitive, AmbientEmitter, } from "./ambient/index.js";
+export { SAFE_FILE_PREFIX, generateSafeFilename, isSymlink, } from "./sandbox.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,iDAAiD;AAEjD,OAAO,EAEL,aAAa,EACb,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,OAAO,EACP,YAAY,EACZ,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EAEpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAavB,OAAO,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EAGrB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAGL,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAYL,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAIL,YAAY,EACZ,SAAS,GACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAOL,OAAO,EAIP,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAOL,aAAa,EACb,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EAMf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,QAAQ,EAQR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAGhB,eAAe,EACf,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAOlB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,GACV,MAAM,cAAc,CAAC"}

package/dist/limits.d.ts

@@ -0,0 +1,44 @@
+/** Conservative limits for synthesis requests. */
+export declare const LIMITS: {
+    /** Maximum text length in characters. */
+    readonly maxTextLength: 12000;
+    /** Maximum speed multiplier. */
+    readonly maxSpeed: 2;
+    /** Minimum speed multiplier. */
+    readonly minSpeed: 0.5;
+    /** Default speed multiplier. */
+    readonly defaultSpeed: 1;
+};
+/** Consolidated ship-ready limits for the entire stack. */
+export declare const SHIP_LIMITS: {
+    /** Maximum total characters across all inputs. */
+    readonly maxTotalChars: 12000;
+    /** Maximum chunks per request. */
+    readonly maxChunks: 50;
+    /** Maximum emotion spans per request. */
+    readonly maxSpans: 100;
+    /** Maximum SSML element nodes. */
+    readonly maxSsmlNodes: 400;
+    /** Maximum SFX events per text. */
+    readonly maxSfxEvents: 30;
+    /** Maximum break duration in ms. */
+    readonly maxBreakMs: 2000;
+    /** Maximum concurrent synthesis requests. */
+    readonly maxConcurrentSynth: 1;
+    /** Per-request timeout in ms. */
+    readonly requestTimeoutMs: 20000;
+    /** Per-chunk timeout in ms. */
+    readonly chunkTimeoutMs: 10000;
+    /** Health check timeout in ms. */
+    readonly healthTimeoutMs: 2000;
+};
+export declare class LimitError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown> | undefined);
+}
+/** Validate text is non-empty and within length limits. */
+export declare function validateText(text: string): string;
+/** Validate speed is within allowed range. */
+export declare function validateSpeed(speed: number | undefined): number;
+//# sourceMappingURL=limits.d.ts.map

package/dist/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,eAAO,MAAM,MAAM;IACjB,yCAAyC;;IAEzC,gCAAgC;;IAEhC,gCAAgC;;IAEhC,gCAAgC;;CAExB,CAAC;AAEX,2DAA2D;AAC3D,eAAO,MAAM,WAAW;IACtB,kDAAkD;;IAElD,kCAAkC;;IAElC,yCAAyC;;IAEzC,kCAAkC;;IAElC,mCAAmC;;IAEnC,oCAAoC;;IAEpC,6CAA6C;;IAE7C,iCAAiC;;IAEjC,+BAA+B;;IAE/B,kCAAkC;;CAE1B,CAAC;AAEX,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAajD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAU/D"}

package/dist/limits.js

@@ -0,0 +1,65 @@
+/** Conservative limits for synthesis requests. */
+export const LIMITS = {
+    /** Maximum text length in characters. */
+    maxTextLength: 12_000,
+    /** Maximum speed multiplier. */
+    maxSpeed: 2.0,
+    /** Minimum speed multiplier. */
+    minSpeed: 0.5,
+    /** Default speed multiplier. */
+    defaultSpeed: 1.0,
+};
+/** Consolidated ship-ready limits for the entire stack. */
+export const SHIP_LIMITS = {
+    /** Maximum total characters across all inputs. */
+    maxTotalChars: 12_000,
+    /** Maximum chunks per request. */
+    maxChunks: 50,
+    /** Maximum emotion spans per request. */
+    maxSpans: 100,
+    /** Maximum SSML element nodes. */
+    maxSsmlNodes: 400,
+    /** Maximum SFX events per text. */
+    maxSfxEvents: 30,
+    /** Maximum break duration in ms. */
+    maxBreakMs: 2_000,
+    /** Maximum concurrent synthesis requests. */
+    maxConcurrentSynth: 1,
+    /** Per-request timeout in ms. */
+    requestTimeoutMs: 20_000,
+    /** Per-chunk timeout in ms. */
+    chunkTimeoutMs: 10_000,
+    /** Health check timeout in ms. */
+    healthTimeoutMs: 2_000,
+};
+export class LimitError extends Error {
+    code;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "LimitError";
+    }
+}
+/** Validate text is non-empty and within length limits. */
+export function validateText(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0) {
+        throw new LimitError("Text must not be empty", "TEXT_EMPTY");
+    }
+    if (trimmed.length > LIMITS.maxTextLength) {
+        throw new LimitError(`Text exceeds maximum length of ${LIMITS.maxTextLength} characters (got ${trimmed.length})`, "TEXT_TOO_LONG", { maxLength: LIMITS.maxTextLength, actualLength: trimmed.length });
+    }
+    return trimmed;
+}
+/** Validate speed is within allowed range. */
+export function validateSpeed(speed) {
+    if (speed === undefined)
+        return LIMITS.defaultSpeed;
+    if (speed < LIMITS.minSpeed || speed > LIMITS.maxSpeed) {
+        throw new LimitError(`Speed must be between ${LIMITS.minSpeed} and ${LIMITS.maxSpeed} (got ${speed})`, "SPEED_OUT_OF_RANGE", { min: LIMITS.minSpeed, max: LIMITS.maxSpeed, actual: speed });
+    }
+    return speed;
+}
+//# sourceMappingURL=limits.js.map

package/dist/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,yCAAyC;IACzC,aAAa,EAAE,MAAM;IACrB,gCAAgC;IAChC,QAAQ,EAAE,GAAG;IACb,gCAAgC;IAChC,QAAQ,EAAE,GAAG;IACb,gCAAgC;IAChC,YAAY,EAAE,GAAG;CACT,CAAC;AAEX,2DAA2D;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kDAAkD;IAClD,aAAa,EAAE,MAAM;IACrB,kCAAkC;IAClC,SAAS,EAAE,EAAE;IACb,yCAAyC;IACzC,QAAQ,EAAE,GAAG;IACb,kCAAkC;IAClC,YAAY,EAAE,GAAG;IACjB,mCAAmC;IACnC,YAAY,EAAE,EAAE;IAChB,oCAAoC;IACpC,UAAU,EAAE,KAAK;IACjB,6CAA6C;IAC7C,kBAAkB,EAAE,CAAC;IACrB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM;IACxB,+BAA+B;IAC/B,cAAc,EAAE,MAAM;IACtB,kCAAkC;IAClC,eAAe,EAAE,KAAK;CACd,CAAC;AAEX,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1C,MAAM,IAAI,UAAU,CAClB,kCAAkC,MAAM,CAAC,aAAa,oBAAoB,OAAO,CAAC,MAAM,GAAG,EAC3F,eAAe,EACf,EAAE,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAClE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,YAAY,CAAC;IACpD,IAAI,KAAK,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvD,MAAM,IAAI,UAAU,CAClB,yBAAyB,MAAM,CAAC,QAAQ,QAAQ,MAAM,CAAC,QAAQ,SAAS,KAAK,GAAG,EAChF,oBAAoB,EACpB,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/orchestrator/concat.d.ts

@@ -0,0 +1,20 @@
+/** WAV concatenation — merge multiple WAV files into one. */
+import type { ChunkArtifact } from "./types.js";
+/**
+ * Concatenate multiple WAV chunk artifacts into a single WAV file.
+ * All chunks must be the same sample rate and format (16-bit PCM mono).
+ * Returns the path to the concatenated file.
+ */
+export declare function concatWavFiles(chunks: readonly ChunkArtifact[], outputDir: string): Promise<{
+    path: string;
+    durationMs: number;
+}>;
+/**
+ * Concatenate multiple WAV chunk artifacts into a single base64 string.
+ */
+export declare function concatWavBase64(chunks: readonly ChunkArtifact[]): Promise<{
+    base64: string;
+    durationMs: number;
+}>;
+export declare function buildWavFile(pcmData: Buffer, sampleRate: number): Buffer;
+//# sourceMappingURL=concat.d.ts.map

package/dist/orchestrator/concat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.d.ts","sourceRoot":"","sources":["../../src/orchestrator/concat.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAK7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAyC/C;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCjD;AAkCD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyBxE"}

package/dist/orchestrator/concat.js

@@ -0,0 +1,139 @@
+/** WAV concatenation — merge multiple WAV files into one. */
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+/**
+ * Concatenate multiple WAV chunk artifacts into a single WAV file.
+ * All chunks must be the same sample rate and format (16-bit PCM mono).
+ * Returns the path to the concatenated file.
+ */
+export async function concatWavFiles(chunks, outputDir) {
+    const buffers = [];
+    let totalDataSize = 0;
+    let sampleRate = 24000;
+    for (const chunk of chunks) {
+        let wav;
+        if (chunk.audioPath) {
+            wav = await readFile(chunk.audioPath);
+        }
+        else if (chunk.audioBytesBase64) {
+            wav = Buffer.from(chunk.audioBytesBase64, "base64");
+        }
+        else {
+            continue;
+        }
+        // Parse WAV header to extract data portion
+        const parsed = parseWavData(wav);
+        if (parsed) {
+            buffers.push(parsed.data);
+            totalDataSize += parsed.data.length;
+            sampleRate = parsed.sampleRate;
+        }
+    }
+    if (buffers.length === 0) {
+        throw new Error("No valid WAV data to concatenate");
+    }
+    // Build new WAV file
+    const dataChunk = Buffer.concat(buffers);
+    const wavFile = buildWavFile(dataChunk, sampleRate);
+    const filename = `vsmcp_concat_${randomUUID().slice(0, 8)}.wav`;
+    const outPath = join(outputDir, filename);
+    await writeFile(outPath, wavFile);
+    const bytesPerSample = 2; // 16-bit
+    const numSamples = dataChunk.length / bytesPerSample;
+    const durationMs = Math.round((numSamples / sampleRate) * 1000);
+    return { path: outPath, durationMs };
+}
+/**
+ * Concatenate multiple WAV chunk artifacts into a single base64 string.
+ */
+export async function concatWavBase64(chunks) {
+    const buffers = [];
+    let totalDataSize = 0;
+    let sampleRate = 24000;
+    for (const chunk of chunks) {
+        let wav;
+        if (chunk.audioPath) {
+            wav = await readFile(chunk.audioPath);
+        }
+        else if (chunk.audioBytesBase64) {
+            wav = Buffer.from(chunk.audioBytesBase64, "base64");
+        }
+        else {
+            continue;
+        }
+        const parsed = parseWavData(wav);
+        if (parsed) {
+            buffers.push(parsed.data);
+            totalDataSize += parsed.data.length;
+            sampleRate = parsed.sampleRate;
+        }
+    }
+    if (buffers.length === 0) {
+        throw new Error("No valid WAV data to concatenate");
+    }
+    const dataChunk = Buffer.concat(buffers);
+    const wavFile = buildWavFile(dataChunk, sampleRate);
+    const bytesPerSample = 2;
+    const numSamples = dataChunk.length / bytesPerSample;
+    const durationMs = Math.round((numSamples / sampleRate) * 1000);
+    return { base64: wavFile.toString("base64"), durationMs };
+}
+function parseWavData(wav) {
+    if (wav.length < 44)
+        return null;
+    if (wav.toString("ascii", 0, 4) !== "RIFF")
+        return null;
+    if (wav.toString("ascii", 8, 12) !== "WAVE")
+        return null;
+    const sampleRate = wav.readUInt32LE(24);
+    // Find data chunk
+    let offset = 12;
+    while (offset < wav.length - 8) {
+        const chunkId = wav.toString("ascii", offset, offset + 4);
+        const chunkSize = wav.readUInt32LE(offset + 4);
+        if (chunkId === "data") {
+            const dataStart = offset + 8;
+            const dataEnd = Math.min(dataStart + chunkSize, wav.length);
+            return { sampleRate, data: wav.subarray(dataStart, dataEnd) };
+        }
+        offset += 8 + chunkSize;
+    }
+    return null;
+}
+export function buildWavFile(pcmData, sampleRate) {
+    const bytesPerSample = 2;
+    const channels = 1;
+    const fileSize = 44 + pcmData.length;
+    const buf = Buffer.alloc(fileSize);
+    let o = 0;
+    buf.write("RIFF", o);
+    o += 4;
+    buf.writeUInt32LE(fileSize - 8, o);
+    o += 4;
+    buf.write("WAVE", o);
+    o += 4;
+    buf.write("fmt ", o);
+    o += 4;
+    buf.writeUInt32LE(16, o);
+    o += 4;
+    buf.writeUInt16LE(1, o);
+    o += 2; // PCM
+    buf.writeUInt16LE(channels, o);
+    o += 2;
+    buf.writeUInt32LE(sampleRate, o);
+    o += 4;
+    buf.writeUInt32LE(sampleRate * bytesPerSample * channels, o);
+    o += 4;
+    buf.writeUInt16LE(bytesPerSample * channels, o);
+    o += 2;
+    buf.writeUInt16LE(bytesPerSample * 8, o);
+    o += 2;
+    buf.write("data", o);
+    o += 4;
+    buf.writeUInt32LE(pcmData.length, o);
+    o += 4;
+    pcmData.copy(buf, o);
+    return buf;
+}
+//# sourceMappingURL=concat.js.map

package/dist/orchestrator/concat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.js","sourceRoot":"","sources":["../../src/orchestrator/concat.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/emotionRunner.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Emotion-aware plan runner — synthesizes emotion spans with per-span voice/speed.
+ *
+ * Each emotion span is chunked independently and synthesized with the
+ * span's mapped voice and speed. Results are collected sequentially
+ * and optionally concatenated.
+ */
+import type { ChunkingOptions } from "../chunking/types.js";
+import type { ChunkArtifact, RunPlanOptions, SpeechResult } from "./types.js";
+/** Context passed to the emotion-aware synthesize function. */
+export interface EmotionSynthesisContext {
+    readonly emotion: string;
+    readonly voiceId: string;
+    readonly speed: number;
+    readonly spanIndex: number;
+}
+/** A synthesize function that receives emotion context. */
+export type EmotionSynthesizeFn = (text: string, chunkIndex: number, context: EmotionSynthesisContext) => Promise<ChunkArtifact>;
+export interface RunEmotionPlanInput {
+    /** Raw text with emotion tags. */
+    text: string;
+    /** Function to synthesize a single text chunk with emotion context. */
+    synthesize: EmotionSynthesizeFn;
+    /** Orchestrator options. */
+    options: RunPlanOptions;
+    /** Chunking options (optional overrides). */
+    chunkingOptions?: ChunkingOptions;
+}
+/**
+ * Run emotion-tagged text through the synthesis pipeline.
+ *
+ * 1. Parse emotion spans from text
+ * 2. For each span: chunk text → synthesize with span's voice/speed
+ * 3. Collect all artifacts in order
+ * 4. Optionally concatenate
+ */
+export declare function runEmotionPlan(input: RunEmotionPlanInput): Promise<SpeechResult>;
+//# sourceMappingURL=emotionRunner.d.ts.map

package/dist/orchestrator/emotionRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotionRunner.d.ts","sourceRoot":"","sources":["../../src/orchestrator/emotionRunner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EAEb,MAAM,YAAY,CAAC;AAGpB,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,2DAA2D;AAC3D,MAAM,MAAM,mBAAmB,GAAG,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,UAAU,EAAE,mBAAmB,CAAC;IAChC,4BAA4B;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAwGtF"}

package/dist/orchestrator/emotionRunner.js

@@ -0,0 +1,115 @@
+/**
+ * Emotion-aware plan runner — synthesizes emotion spans with per-span voice/speed.
+ *
+ * Each emotion span is chunked independently and synthesized with the
+ * span's mapped voice and speed. Results are collected sequentially
+ * and optionally concatenated.
+ */
+import { parseEmotionSpans } from "../emotion/parser.js";
+import { chunkText } from "../chunking/chunker.js";
+import { concatWavFiles, concatWavBase64 } from "./concat.js";
+/**
+ * Run emotion-tagged text through the synthesis pipeline.
+ *
+ * 1. Parse emotion spans from text
+ * 2. For each span: chunk text → synthesize with span's voice/speed
+ * 3. Collect all artifacts in order
+ * 4. Optionally concatenate
+ */
+export async function runEmotionPlan(input) {
+    const { text, synthesize, options, chunkingOptions } = input;
+    const warnings = [];
+    // Parse emotion spans
+    const parseResult = parseEmotionSpans(text);
+    warnings.push(...parseResult.warnings);
+    if (parseResult.spans.length === 0) {
+        return {
+            chunks: [],
+            totalDurationMs: 0,
+            chunkCount: 0,
+            interrupted: false,
+            warnings,
+        };
+    }
+    // Synthesize each span
+    const artifacts = [];
+    let interrupted = false;
+    let globalChunkIndex = 0;
+    for (let spanIdx = 0; spanIdx < parseResult.spans.length; spanIdx++) {
+        if (options.signal?.aborted) {
+            interrupted = true;
+            warnings.push({
+                code: "SYNTHESIS_INTERRUPTED",
+                message: `Synthesis interrupted at span ${spanIdx} of ${parseResult.spans.length}`,
+            });
+            break;
+        }
+        const span = parseResult.spans[spanIdx];
+        const context = {
+            emotion: span.emotion,
+            voiceId: span.voiceId,
+            speed: span.speed,
+            spanIndex: spanIdx,
+        };
+        // Chunk the span text
+        const chunkResult = chunkText(span.text, chunkingOptions);
+        warnings.push(...chunkResult.warnings);
+        for (const chunk of chunkResult.chunks) {
+            if (options.signal?.aborted) {
+                interrupted = true;
+                warnings.push({
+                    code: "SYNTHESIS_INTERRUPTED",
+                    message: `Synthesis interrupted at chunk ${globalChunkIndex}`,
+                });
+                break;
+            }
+            const artifact = await synthesize(chunk, globalChunkIndex, context);
+            artifacts.push(artifact);
+            globalChunkIndex++;
+        }
+        if (interrupted)
+            break;
+    }
+    const totalDurationMs = artifacts.reduce((sum, a) => sum + a.durationMs, 0);
+    // Concatenate if requested
+    if (options.concat && artifacts.length > 1 && !interrupted) {
+        try {
+            if (options.artifactMode === "base64") {
+                const { base64, durationMs } = await concatWavBase64(artifacts);
+                return {
+                    chunks: artifacts,
+                    concatBase64: base64,
+                    totalDurationMs: durationMs,
+                    chunkCount: artifacts.length,
+                    interrupted,
+                    warnings,
+                };
+            }
+            else if (options.outputDir) {
+                const { path, durationMs } = await concatWavFiles(artifacts, options.outputDir);
+                return {
+                    chunks: artifacts,
+                    concatPath: path,
+                    totalDurationMs: durationMs,
+                    chunkCount: artifacts.length,
+                    interrupted,
+                    warnings,
+                };
+            }
+        }
+        catch (err) {
+            warnings.push({
+                code: "CONCAT_FAILED",
+                message: `WAV concatenation failed: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
+    return {
+        chunks: artifacts,
+        totalDurationMs,
+        chunkCount: artifacts.length,
+        interrupted,
+        warnings,
+    };
+}
+//# sourceMappingURL=emotionRunner.js.map

package/dist/orchestrator/emotionRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotionRunner.js","sourceRoot":"","sources":["../../src/orchestrator/emotionRunner.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,6 @@
+/** Orchestrator module — multi-chunk synthesis pipeline. */
+export { type SynthesizeFn, type ChunkArtifact, type RunPlanOptions, type SpeechResult, type OrchestratorWarning, } from "./types.js";
+export { type RunPlanInput, runPlan, } from "./runner.js";
+export { type EmotionSynthesisContext, type EmotionSynthesizeFn, type RunEmotionPlanInput, runEmotionPlan, } from "./emotionRunner.js";
+export { concatWavFiles, concatWavBase64, buildWavFile } from "./concat.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,YAAY,EACjB,OAAO,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/orchestrator/index.js

@@ -0,0 +1,5 @@
+/** Orchestrator module — multi-chunk synthesis pipeline. */
+export { runPlan, } from "./runner.js";
+export { runEmotionPlan, } from "./emotionRunner.js";
+export { concatWavFiles, concatWavBase64, buildWavFile } from "./concat.js";
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAU5D,OAAO,EAEL,OAAO,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EAIL,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/orchestrator/runner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Plan runner — sequentially synthesizes chunks from a SpeechPlan.
+ *
+ * Supports:
+ *   - Sequential chunk synthesis with abort support
+ *   - Path and base64 artifact modes
+ *   - Optional WAV concatenation
+ */
+import type { SpeechPlan } from "../ssml/types.js";
+import type { ChunkingOptions } from "../chunking/types.js";
+import type { SynthesizeFn, RunPlanOptions, SpeechResult } from "./types.js";
+export interface RunPlanInput {
+    /** The speech plan (from SSML parser or plain text). */
+    plan: SpeechPlan;
+    /** Function to synthesize a single text chunk. */
+    synthesize: SynthesizeFn;
+    /** Orchestrator options. */
+    options: RunPlanOptions;
+    /** Chunking options (optional overrides). */
+    chunkingOptions?: ChunkingOptions;
+}
+/**
+ * Run a speech plan through the synthesis pipeline.
+ *
+ * 1. Extract plain text from plan
+ * 2. Chunk the text
+ * 3. Synthesize each chunk sequentially
+ * 4. Optionally concatenate results
+ */
+export declare function runPlan(input: RunPlanInput): Promise<SpeechResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/orchestrator/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/orchestrator/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EAGb,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,UAAU,CAAC;IACjB,kDAAkD;IAClD,UAAU,EAAE,YAAY,CAAC;IACzB,4BAA4B;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA6FxE"}