@mcptoolshop/voice-soundboard-core 0.1.0

package/dist/ssml/parser.js

@@ -0,0 +1,348 @@
+/**
+ * SSML-lite parser — converts a subset of SSML into a SpeechPlan.
+ *
+ * Tag allowlist:
+ *   <speak>         — root wrapper (optional)
+ *   <break>         — pause (time="250ms" or strength="medium")
+ *   <prosody>       — rate modifier (rate="slow"|"fast"|"x-slow"|"x-fast"|"1.2")
+ *   <emphasis>      — emphasis level (level="strong"|"moderate"|"reduced"|"none")
+ *   <sub>           — substitution (alias="replacement text")
+ *   <say-as>        — interpret-as hint (stripped; text passed through)
+ *
+ * Everything else is stripped with a warning. The parser produces a flat
+ * list of text/event segments plus a fallback plain-text string.
+ */
+import { SSML_LIMITS } from "./limits.js";
+// ── Public API ──
+export class SsmlParseError extends Error {
+    code;
+    constructor(message, code = "SSML_PARSE_FAILED") {
+        super(message);
+        this.code = code;
+        this.name = "SsmlParseError";
+    }
+}
+/**
+ * Parse SSML-lite input into a SpeechPlan.
+ * If input doesn't look like SSML, wraps it as plain text.
+ * On parse errors, falls back to plain text with an SSML_PARSE_FAILED warning.
+ */
+export function parseSsmlLite(input) {
+    const trimmed = input.trim();
+    if (!looksLikeSsml(trimmed)) {
+        return plainTextPlan(trimmed);
+    }
+    try {
+        return doParse(trimmed);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return plainTextFallback(trimmed, message);
+    }
+}
+/** Check if input looks like it might be SSML. */
+export function looksLikeSsml(input) {
+    return /<\s*(speak|break|prosody|emphasis|sub|say-as)\b/i.test(input);
+}
+// ── Allowed tags ──
+const ALLOWED_TAGS = new Set(["speak", "break", "prosody", "emphasis", "sub", "say-as"]);
+// ── Core parser ──
+/**
+ * Regex that matches SSML tags (open, close, self-closing).
+ * Groups: 1=closing-slash, 2=tag-name, 3=attributes, 4=self-closing-slash
+ */
+const TAG_RE = /<(\/?)(\w[\w-]*)((?:\s+[^>]*?)?)(\/?)\s*>/g;
+function doParse(input) {
+    let body = input;
+    const speakMatch = body.match(/^\s*<speak\b[^>]*>([\s\S]*)<\/speak>\s*$/i);
+    if (speakMatch) {
+        body = speakMatch[1];
+    }
+    const state = {
+        body,
+        segments: [],
+        warnings: [],
+        nodeCount: 0,
+        totalChars: 0,
+        openStack: [],
+    };
+    const re = new RegExp(TAG_RE.source, TAG_RE.flags);
+    let lastIndex = 0;
+    let match;
+    while ((match = re.exec(body)) !== null) {
+        const textBefore = body.slice(lastIndex, match.index);
+        if (textBefore) {
+            addText(state, textBefore);
+        }
+        lastIndex = match.index + match[0].length;
+        const isClosing = match[1] === "/";
+        const tagName = match[2].toLowerCase();
+        const attrsStr = match[3];
+        const isSelfClosing = match[4] === "/";
+        state.nodeCount++;
+        if (state.nodeCount > SSML_LIMITS.maxNodes) {
+            throw new SsmlParseError(`Too many SSML nodes (max ${SSML_LIMITS.maxNodes})`);
+        }
+        if (!ALLOWED_TAGS.has(tagName)) {
+            state.warnings.push({
+                code: "SSML_TAG_STRIPPED",
+                message: `Unsupported tag <${tagName}> stripped`,
+            });
+            continue;
+        }
+        if (tagName === "speak") {
+            continue;
+        }
+        if (isClosing) {
+            handleClosingTag(state, tagName);
+        }
+        else if (isSelfClosing) {
+            handleSelfClosingTag(state, tagName, attrsStr);
+        }
+        else {
+            const skip = handleOpeningTag(state, tagName, attrsStr, re);
+            if (skip !== undefined) {
+                lastIndex = skip;
+                re.lastIndex = skip;
+            }
+        }
+    }
+    const tail = body.slice(lastIndex);
+    if (tail) {
+        addText(state, tail);
+    }
+    // Auto-close unclosed tags
+    while (state.openStack.length > 0) {
+        const unclosed = state.openStack.pop();
+        if (unclosed === "prosody") {
+            pushEvent(state, { type: "prosody_end" });
+        }
+        else if (unclosed === "emphasis") {
+            pushEvent(state, { type: "emphasis_end" });
+        }
+        state.warnings.push({
+            code: "SSML_UNCLOSED_TAG",
+            message: `Unclosed <${unclosed}> auto-closed`,
+        });
+    }
+    const plainText = extractPlainText(state.segments);
+    return {
+        segments: state.segments,
+        plainText,
+        wasSSML: true,
+        warnings: state.warnings,
+    };
+}
+// ── Tag handlers ──
+function handleSelfClosingTag(state, tagName, attrsStr) {
+    if (tagName === "break") {
+        const timeMs = parseBreakTime(attrsStr);
+        pushEvent(state, { type: "break", timeMs });
+    }
+}
+/**
+ * Handle an opening tag. Returns a new lastIndex if content was consumed
+ * (for <sub> alias replacement), or undefined otherwise.
+ */
+function handleOpeningTag(state, tagName, attrsStr, re) {
+    switch (tagName) {
+        case "break": {
+            const timeMs = parseBreakTime(attrsStr);
+            pushEvent(state, { type: "break", timeMs });
+            return undefined;
+        }
+        case "prosody": {
+            const rate = parseProsodyRate(attrsStr);
+            if (rate !== undefined) {
+                pushEvent(state, { type: "prosody", rate });
+                state.openStack.push("prosody");
+            }
+            return undefined;
+        }
+        case "emphasis": {
+            const level = parseEmphasisLevel(attrsStr);
+            pushEvent(state, { type: "emphasis", level });
+            state.openStack.push("emphasis");
+            return undefined;
+        }
+        case "sub": {
+            const alias = parseAttr(attrsStr, "alias");
+            if (alias) {
+                const closeEnd = findCloseTagEnd(state.body, "sub", re.lastIndex);
+                if (closeEnd !== -1) {
+                    addText(state, alias);
+                    return closeEnd;
+                }
+            }
+            return undefined;
+        }
+        case "say-as": {
+            // Passthrough — inner text is handled naturally
+            return undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+function handleClosingTag(state, tagName) {
+    if (tagName === "prosody") {
+        const idx = state.openStack.lastIndexOf("prosody");
+        if (idx !== -1) {
+            state.openStack.splice(idx, 1);
+            pushEvent(state, { type: "prosody_end" });
+        }
+    }
+    else if (tagName === "emphasis") {
+        const idx = state.openStack.lastIndexOf("emphasis");
+        if (idx !== -1) {
+            state.openStack.splice(idx, 1);
+            pushEvent(state, { type: "emphasis_end" });
+        }
+    }
+}
+// ── Attribute parsers ──
+function parseBreakTime(attrsStr) {
+    const timeVal = parseAttr(attrsStr, "time");
+    if (timeVal) {
+        const ms = parseDurationMs(timeVal);
+        return Math.min(ms, SSML_LIMITS.maxBreakMs);
+    }
+    const strength = parseAttr(attrsStr, "strength");
+    if (strength) {
+        return strengthToMs(strength);
+    }
+    return 250;
+}
+function parseProsodyRate(attrsStr) {
+    const rate = parseAttr(attrsStr, "rate");
+    if (!rate)
+        return undefined;
+    const numeric = parseFloat(rate);
+    if (!isNaN(numeric)) {
+        return clampRate(numeric);
+    }
+    switch (rate.toLowerCase()) {
+        case "x-slow": return clampRate(0.5);
+        case "slow": return clampRate(0.75);
+        case "medium": return 1.0;
+        case "fast": return clampRate(1.25);
+        case "x-fast": return clampRate(1.5);
+        default: return undefined;
+    }
+}
+function parseEmphasisLevel(attrsStr) {
+    const level = parseAttr(attrsStr, "level");
+    if (!level)
+        return "moderate";
+    switch (level.toLowerCase()) {
+        case "strong": return "strong";
+        case "moderate": return "moderate";
+        case "reduced": return "reduced";
+        case "none": return "none";
+        default: return "moderate";
+    }
+}
+// ── Utility ──
+function parseAttr(attrsStr, name) {
+    const re = new RegExp(`${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`, "i");
+    const m = attrsStr.match(re);
+    return m ? (m[1] ?? m[2]) : undefined;
+}
+function parseDurationMs(value) {
+    const trimmed = value.trim().toLowerCase();
+    if (trimmed.endsWith("ms")) {
+        return Math.max(0, parseInt(trimmed, 10));
+    }
+    if (trimmed.endsWith("s")) {
+        return Math.max(0, parseFloat(trimmed) * 1000);
+    }
+    const num = parseInt(trimmed, 10);
+    return isNaN(num) ? 250 : Math.max(0, num);
+}
+function strengthToMs(strength) {
+    switch (strength.toLowerCase()) {
+        case "none": return 0;
+        case "x-weak": return 100;
+        case "weak": return 200;
+        case "medium": return 400;
+        case "strong": return 750;
+        case "x-strong": return 1000;
+        default: return 250;
+    }
+}
+function clampRate(rate) {
+    return Math.max(SSML_LIMITS.minProsodyRate, Math.min(SSML_LIMITS.maxProsodyRate, rate));
+}
+function addText(state, raw) {
+    const text = decodeEntities(raw);
+    if (!text.trim())
+        return;
+    state.totalChars += text.length;
+    if (state.totalChars > SSML_LIMITS.maxTotalChars) {
+        throw new SsmlParseError(`SSML text content exceeds ${SSML_LIMITS.maxTotalChars} characters`);
+    }
+    const last = state.segments[state.segments.length - 1];
+    if (last && last.type === "text") {
+        state.segments[state.segments.length - 1] = { type: "text", value: last.value + text };
+    }
+    else {
+        state.segments.push({ type: "text", value: text });
+    }
+}
+function pushEvent(state, event) {
+    state.segments.push({ type: "event", event });
+}
+function decodeEntities(text) {
+    return text
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'");
+}
+function extractPlainText(segments) {
+    return segments
+        .filter((s) => s.type === "text")
+        .map((s) => s.value)
+        .join(" ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Find the end index (past the closing tag) of </tagName> starting from fromIndex. */
+function findCloseTagEnd(body, tagName, fromIndex) {
+    const closeTag = `</${tagName}>`;
+    const idx = body.toLowerCase().indexOf(closeTag.toLowerCase(), fromIndex);
+    if (idx === -1)
+        return -1;
+    return idx + closeTag.length;
+}
+// ── Plain text plans ──
+function plainTextPlan(text) {
+    if (!text) {
+        return { segments: [], plainText: "", wasSSML: false, warnings: [] };
+    }
+    return {
+        segments: [{ type: "text", value: text }],
+        plainText: text,
+        wasSSML: false,
+        warnings: [],
+    };
+}
+function plainTextFallback(input, errorMessage) {
+    const stripped = stripAllTags(input);
+    return {
+        segments: stripped ? [{ type: "text", value: stripped }] : [],
+        plainText: stripped,
+        wasSSML: true,
+        warnings: [{
+                code: "SSML_PARSE_FAILED",
+                message: `SSML parse failed, using plain text fallback: ${errorMessage}`,
+            }],
+    };
+}
+function stripAllTags(input) {
+    return decodeEntities(input.replace(/<[^>]*>/g, ""))
+        .replace(/\s+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=parser.js.map

package/dist/ssml/parser.js.map

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

package/dist/ssml/types.d.ts

@@ -0,0 +1,46 @@
+/** SSML-lite types — backend-agnostic speech plan representation. */
+export interface BreakEvent {
+    readonly type: "break";
+    /** Duration in milliseconds. */
+    readonly timeMs: number;
+}
+export interface ProsodyEvent {
+    readonly type: "prosody";
+    /** Speed multiplier (e.g. 0.8 for slow, 1.2 for fast). */
+    readonly rate: number;
+}
+export interface ProsodyEndEvent {
+    readonly type: "prosody_end";
+}
+export interface EmphasisEvent {
+    readonly type: "emphasis";
+    readonly level: "strong" | "moderate" | "reduced" | "none";
+}
+export interface EmphasisEndEvent {
+    readonly type: "emphasis_end";
+}
+export type SpeechEvent = BreakEvent | ProsodyEvent | ProsodyEndEvent | EmphasisEvent | EmphasisEndEvent;
+export interface TextSegment {
+    readonly type: "text";
+    readonly value: string;
+}
+export interface EventSegment {
+    readonly type: "event";
+    readonly event: SpeechEvent;
+}
+export type PlanSegment = TextSegment | EventSegment;
+export interface SsmlWarning {
+    readonly code: string;
+    readonly message: string;
+}
+export interface SpeechPlan {
+    /** Ordered segments: text and events interleaved. */
+    readonly segments: readonly PlanSegment[];
+    /** Plain text with SSML stripped (for backends that don't support events). */
+    readonly plainText: string;
+    /** Whether the input was SSML (even if fallback occurred). */
+    readonly wasSSML: boolean;
+    /** Non-fatal warnings (e.g. SSML_PARSE_FAILED for fallback). */
+    readonly warnings: readonly SsmlWarning[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ssml/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ssml/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAIrE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;CAC5D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B;AAED,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,YAAY,GACZ,eAAe,GACf,aAAa,GACb,gBAAgB,CAAC;AAIrB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAIrD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C"}

package/dist/ssml/types.js

@@ -0,0 +1,3 @@
+/** SSML-lite types — backend-agnostic speech plan representation. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ssml/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ssml/types.ts"],"names":[],"mappings":"AAAA,qEAAqE"}

package/dist/validate.d.ts

@@ -0,0 +1,29 @@
+/** Input validation — voice and preset resolution. */
+import { type VoiceInfo } from "./voices.js";
+export declare class VoiceValidationError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Assert that a voice ID is in the approved roster.
+ * Throws VoiceValidationError with the roster if not.
+ */
+export declare function assertApprovedVoice(voiceId: string): VoiceInfo;
+export interface ResolvedVoice {
+    readonly voice: VoiceInfo;
+    readonly speed: number;
+    readonly source: "voice" | "preset" | "default";
+    readonly presetName?: string;
+}
+/**
+ * Resolve a voice or preset name to a concrete voice + speed.
+ *
+ * Resolution order:
+ * 1. If input matches a preset name → use preset's voice + speed
+ * 2. If input matches an approved voice ID → use that voice, speed = 1.0
+ * 3. If input is undefined/empty → use DEFAULT_VOICE, speed = 1.0
+ * 4. Otherwise → throw VoiceValidationError
+ */
+export declare function resolveVoiceOrPreset(input: string | undefined, speedOverride?: number): ResolvedVoice;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAG1F,qBAAa,oBAAqB,SAAQ,KAAK;aAG3B,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;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAU9D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,aAAa,CAiCf"}

package/dist/validate.js

@@ -0,0 +1,60 @@
+/** Input validation — voice and preset resolution. */
+import { APPROVED_VOICE_IDS, DEFAULT_VOICE, getVoice } from "./voices.js";
+import { getPreset } from "./presets.js";
+export class VoiceValidationError extends Error {
+    code;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = "VoiceValidationError";
+    }
+}
+/**
+ * Assert that a voice ID is in the approved roster.
+ * Throws VoiceValidationError with the roster if not.
+ */
+export function assertApprovedVoice(voiceId) {
+    const voice = getVoice(voiceId);
+    if (!voice) {
+        throw new VoiceValidationError(`Voice "${voiceId}" is not in the approved roster`, "VOICE_NOT_APPROVED", { requested: voiceId, approved: [...APPROVED_VOICE_IDS] });
+    }
+    return voice;
+}
+/**
+ * Resolve a voice or preset name to a concrete voice + speed.
+ *
+ * Resolution order:
+ * 1. If input matches a preset name → use preset's voice + speed
+ * 2. If input matches an approved voice ID → use that voice, speed = 1.0
+ * 3. If input is undefined/empty → use DEFAULT_VOICE, speed = 1.0
+ * 4. Otherwise → throw VoiceValidationError
+ */
+export function resolveVoiceOrPreset(input, speedOverride) {
+    // Default
+    if (!input || input.trim() === "") {
+        const voice = getVoice(DEFAULT_VOICE);
+        return { voice, speed: speedOverride ?? 1.0, source: "default" };
+    }
+    const trimmed = input.trim().toLowerCase();
+    // Try preset first
+    const preset = getPreset(trimmed);
+    if (preset) {
+        const voice = getVoice(preset.voice);
+        return {
+            voice,
+            speed: speedOverride ?? preset.speed,
+            source: "preset",
+            presetName: preset.name,
+        };
+    }
+    // Try direct voice ID
+    const voice = getVoice(trimmed);
+    if (voice) {
+        return { voice, speed: speedOverride ?? 1.0, source: "voice" };
+    }
+    // Not found
+    throw new VoiceValidationError(`"${input}" is not a recognized voice or preset`, "VOICE_OR_PRESET_NOT_FOUND", { requested: input, approved: [...APPROVED_VOICE_IDS], presets: [...getPreset("assistant") ? ["assistant", "narrator", "announcer", "storyteller", "whisper"] : []] });
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAqB,MAAM,cAAc,CAAC;AAE5D,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAG3B;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,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,oBAAoB,CAC5B,UAAU,OAAO,iCAAiC,EAClD,oBAAoB,EACpB,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAyB,EACzB,aAAsB;IAEtB,UAAU;IACV,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAE,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,IAAI,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,mBAAmB;IACnB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC;QACtC,OAAO;YACL,KAAK;YACL,KAAK,EAAE,aAAa,IAAI,MAAM,CAAC,KAAK;YACpC,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,MAAM,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,IAAI,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACjE,CAAC;IAED,YAAY;IACZ,MAAM,IAAI,oBAAoB,CAC5B,IAAI,KAAK,uCAAuC,EAChD,2BAA2B,EAC3B,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CACtK,CAAC;AACJ,CAAC"}

package/dist/voices.d.ts

@@ -0,0 +1,22 @@
+/** Approved voice roster — single source of truth. */
+export interface VoiceInfo {
+    readonly id: string;
+    readonly name: string;
+    readonly gender: "male" | "female";
+    readonly accent: "american" | "british";
+    readonly style: string;
+    readonly language: string;
+}
+export declare const DEFAULT_VOICE: "bm_george";
+/**
+ * Approved voice roster (12 voices).
+ * All voices are Kokoro-compatible, English-only.
+ */
+export declare const VOICES: ReadonlyMap<string, VoiceInfo>;
+/** All approved voice IDs as a set for O(1) lookup. */
+export declare const APPROVED_VOICE_IDS: ReadonlySet<string>;
+/** Get a voice by ID, or undefined if not in the approved roster. */
+export declare function getVoice(id: string): VoiceInfo | undefined;
+/** Check if a voice ID is in the approved roster. */
+export declare function isApprovedVoice(id: string): boolean;
+//# sourceMappingURL=voices.d.ts.map

package/dist/voices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voices.d.ts","sourceRoot":"","sources":["../src/voices.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,aAAa,EAAG,WAAoB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAahD,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAA0B,CAAC;AAE9E,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE1D;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/voices.js

@@ -0,0 +1,31 @@
+/** Approved voice roster — single source of truth. */
+export const DEFAULT_VOICE = "bm_george";
+/**
+ * Approved voice roster (12 voices).
+ * All voices are Kokoro-compatible, English-only.
+ */
+export const VOICES = new Map([
+    ["af_aoede", { id: "af_aoede", name: "Aoede", gender: "female", accent: "american", style: "musical", language: "en" }],
+    ["af_jessica", { id: "af_jessica", name: "Jessica", gender: "female", accent: "american", style: "professional", language: "en" }],
+    ["af_sky", { id: "af_sky", name: "Sky", gender: "female", accent: "american", style: "airy", language: "en" }],
+    ["am_eric", { id: "am_eric", name: "Eric", gender: "male", accent: "american", style: "confident", language: "en" }],
+    ["am_fenrir", { id: "am_fenrir", name: "Fenrir", gender: "male", accent: "american", style: "powerful", language: "en" }],
+    ["am_liam", { id: "am_liam", name: "Liam", gender: "male", accent: "american", style: "friendly", language: "en" }],
+    ["am_onyx", { id: "am_onyx", name: "Onyx", gender: "male", accent: "american", style: "smooth", language: "en" }],
+    ["bf_alice", { id: "bf_alice", name: "Alice", gender: "female", accent: "british", style: "proper", language: "en" }],
+    ["bf_emma", { id: "bf_emma", name: "Emma", gender: "female", accent: "british", style: "refined", language: "en" }],
+    ["bf_isabella", { id: "bf_isabella", name: "Isabella", gender: "female", accent: "british", style: "warm", language: "en" }],
+    ["bm_george", { id: "bm_george", name: "George", gender: "male", accent: "british", style: "authoritative", language: "en" }],
+    ["bm_lewis", { id: "bm_lewis", name: "Lewis", gender: "male", accent: "british", style: "friendly", language: "en" }],
+]);
+/** All approved voice IDs as a set for O(1) lookup. */
+export const APPROVED_VOICE_IDS = new Set(VOICES.keys());
+/** Get a voice by ID, or undefined if not in the approved roster. */
+export function getVoice(id) {
+    return VOICES.get(id);
+}
+/** Check if a voice ID is in the approved roster. */
+export function isApprovedVoice(id) {
+    return APPROVED_VOICE_IDS.has(id);
+}
+//# sourceMappingURL=voices.js.map

package/dist/voices.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@mcptoolshop/voice-soundboard-core",
+  "version": "0.1.0",
+  "description": "Backend-agnostic core library for MCP Voice Soundboard — validation, SSML-lite, chunking, emotion spans, SFX tags, and schemas.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "author": "mcp-tool-shop <64996768+mcp-tool-shop@users.noreply.github.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcp-tool-shop-org/mcp-voice-soundboard.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/mcp-tool-shop-org/mcp-voice-soundboard/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/mcp-tool-shop-org/mcp-voice-soundboard/issues"
+  },
+  "keywords": [
+    "mcp",
+    "voice",
+    "tts",
+    "text-to-speech",
+    "soundboard",
+    "ssml",
+    "speech-synthesis",
+    "ai-agent",
+    "model-context-protocol"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}