@mcptoolshop/voice-soundboard-core 0.1.0

package/dist/orchestrator/runner.js

@@ -0,0 +1,106 @@
+/**
+ * Plan runner — sequentially synthesizes chunks from a SpeechPlan.
+ *
+ * Supports:
+ *   - Sequential chunk synthesis with abort support
+ *   - Path and base64 artifact modes
+ *   - Optional WAV concatenation
+ */
+import { chunkText } from "../chunking/chunker.js";
+import { concatWavFiles, concatWavBase64 } from "./concat.js";
+/**
+ * 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 async function runPlan(input) {
+    const { plan, synthesize, options, chunkingOptions } = input;
+    const warnings = [
+        ...plan.warnings,
+    ];
+    // Extract text to synthesize
+    const text = plan.plainText;
+    if (!text) {
+        return {
+            chunks: [],
+            totalDurationMs: 0,
+            chunkCount: 0,
+            interrupted: false,
+            warnings,
+        };
+    }
+    // Chunk the text
+    const chunkResult = chunkText(text, chunkingOptions);
+    warnings.push(...chunkResult.warnings);
+    if (chunkResult.chunks.length === 0) {
+        return {
+            chunks: [],
+            totalDurationMs: 0,
+            chunkCount: 0,
+            interrupted: false,
+            warnings,
+        };
+    }
+    // Synthesize each chunk sequentially
+    const artifacts = [];
+    let interrupted = false;
+    for (let i = 0; i < chunkResult.chunks.length; i++) {
+        // Check for abort
+        if (options.signal?.aborted) {
+            interrupted = true;
+            warnings.push({
+                code: "SYNTHESIS_INTERRUPTED",
+                message: `Synthesis interrupted after ${i} of ${chunkResult.chunks.length} chunks`,
+            });
+            break;
+        }
+        const chunk = chunkResult.chunks[i];
+        const artifact = await synthesize(chunk, i);
+        artifacts.push(artifact);
+    }
+    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=runner.js.map

package/dist/orchestrator/runner.js.map

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

package/dist/orchestrator/types.d.ts

@@ -0,0 +1,47 @@
+/** Orchestrator types — multi-chunk synthesis pipeline. */
+import type { SsmlWarning } from "../ssml/types.js";
+import type { ChunkWarning } from "../chunking/types.js";
+import type { ArtifactMode } from "../schemas.js";
+/** A function that synthesizes a single text chunk. */
+export type SynthesizeFn = (text: string, chunkIndex: number) => Promise<ChunkArtifact>;
+/** Result from synthesizing a single chunk. */
+export interface ChunkArtifact {
+    readonly audioPath?: string;
+    readonly audioBytesBase64?: string;
+    readonly durationMs: number;
+    readonly sampleRate: number;
+    readonly format: string;
+}
+/** Options for running a speech plan. */
+export interface RunPlanOptions {
+    /** Artifact delivery mode. */
+    readonly artifactMode: ArtifactMode;
+    /** Whether to concatenate multi-chunk audio into a single file. */
+    readonly concat?: boolean;
+    /** Output directory for path-mode artifacts. */
+    readonly outputDir?: string;
+    /** Signal to abort remaining chunks. */
+    readonly signal?: AbortSignal;
+}
+/** Full result of running a speech plan through the orchestrator. */
+export interface SpeechResult {
+    /** Individual chunk artifacts (omitted when concat=true). */
+    readonly chunks: readonly ChunkArtifact[];
+    /** Concatenated artifact (only present when concat=true and mode=path). */
+    readonly concatPath?: string;
+    /** Concatenated base64 (only present when concat=true and mode=base64). */
+    readonly concatBase64?: string;
+    /** Total duration across all chunks (ms). */
+    readonly totalDurationMs: number;
+    /** Number of chunks synthesized. */
+    readonly chunkCount: number;
+    /** Whether synthesis was interrupted. */
+    readonly interrupted: boolean;
+    /** All warnings from SSML parsing + chunking + synthesis. */
+    readonly warnings: readonly (SsmlWarning | ChunkWarning | OrchestratorWarning)[];
+}
+export interface OrchestratorWarning {
+    readonly code: string;
+    readonly message: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/orchestrator/types.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,WAAW,GAAG,YAAY,GAAG,mBAAmB,CAAC,EAAE,CAAC;CAClF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/orchestrator/types.js

@@ -0,0 +1,3 @@
+/** Orchestrator types — multi-chunk synthesis pipeline. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/orchestrator/types.js.map

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

package/dist/presets.d.ts

@@ -0,0 +1,20 @@
+/** Voice presets — named configurations mapping to approved voices. */
+export interface PresetConfig {
+    readonly name: string;
+    readonly voice: string;
+    readonly speed: number;
+    readonly description: string;
+}
+/**
+ * Built-in presets. All voices reference the approved roster.
+ *
+ * Original Python presets used af_bella (assistant), am_michael (announcer),
+ * and af_nicole (whisper) which are not in the approved 12. These are remapped
+ * to the closest approved alternatives.
+ */
+export declare const PRESETS: ReadonlyMap<string, PresetConfig>;
+/** All preset names as a set. */
+export declare const PRESET_NAMES: ReadonlySet<string>;
+/** Get a preset by name, or undefined if not found. */
+export declare function getPreset(name: string): PresetConfig | undefined;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAMpD,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAA2B,CAAC;AAEzE,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE"}

package/dist/presets.js

@@ -0,0 +1,22 @@
+/** Voice presets — named configurations mapping to approved voices. */
+/**
+ * Built-in presets. All voices reference the approved roster.
+ *
+ * Original Python presets used af_bella (assistant), am_michael (announcer),
+ * and af_nicole (whisper) which are not in the approved 12. These are remapped
+ * to the closest approved alternatives.
+ */
+export const PRESETS = new Map([
+    ["assistant", { name: "assistant", voice: "af_jessica", speed: 1.0, description: "Friendly, helpful, conversational" }],
+    ["narrator", { name: "narrator", voice: "bm_george", speed: 0.95, description: "Calm, clear, documentary style" }],
+    ["announcer", { name: "announcer", voice: "am_eric", speed: 1.1, description: "Bold, energetic, broadcast style" }],
+    ["storyteller", { name: "storyteller", voice: "bf_emma", speed: 0.9, description: "Expressive, varied pacing" }],
+    ["whisper", { name: "whisper", voice: "af_sky", speed: 0.85, description: "Soft, intimate, gentle" }],
+]);
+/** All preset names as a set. */
+export const PRESET_NAMES = new Set(PRESETS.keys());
+/** Get a preset by name, or undefined if not found. */
+export function getPreset(name) {
+    return PRESETS.get(name);
+}
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,uEAAuE;AASvE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAsC,IAAI,GAAG,CAAC;IAChE,CAAC,WAAW,EAAI,EAAE,IAAI,EAAE,WAAW,EAAI,KAAK,EAAE,YAAY,EAAG,KAAK,EAAE,GAAG,EAAG,WAAW,EAAE,mCAAmC,EAAE,CAAC;IAC7H,CAAC,UAAU,EAAK,EAAE,IAAI,EAAE,UAAU,EAAK,KAAK,EAAE,WAAW,EAAI,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;IAC1H,CAAC,WAAW,EAAI,EAAE,IAAI,EAAE,WAAW,EAAI,KAAK,EAAE,SAAS,EAAM,KAAK,EAAE,GAAG,EAAG,WAAW,EAAE,kCAAkC,EAAE,CAAC;IAC5H,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAM,KAAK,EAAE,GAAG,EAAG,WAAW,EAAE,2BAA2B,EAAE,CAAC;IACrH,CAAC,SAAS,EAAM,EAAE,IAAI,EAAE,SAAS,EAAM,KAAK,EAAE,QAAQ,EAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;CACnH,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAEzE,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/request.d.ts

@@ -0,0 +1,26 @@
+/** Synthesis request builder — transforms validated inputs into a backend call descriptor. */
+import { type ResolvedVoice } from "./validate.js";
+import { type ArtifactConfig, type OutputFormat } from "./artifact.js";
+import type { ArtifactMode, VoiceErrorResponse, VoiceErrorCode } from "./schemas.js";
+export interface SynthesisRequest {
+    readonly traceId: string;
+    readonly text: string;
+    readonly resolved: ResolvedVoice;
+    readonly artifact: ArtifactConfig;
+}
+export interface SpeakInput {
+    text: string;
+    voice?: string;
+    speed?: number;
+    artifactMode?: ArtifactMode;
+    outputDir?: string;
+    format?: OutputFormat;
+}
+/**
+ * Build a validated SynthesisRequest from raw speak input.
+ * Throws on invalid input with stable error codes.
+ */
+export declare function buildSynthesisRequest(input: SpeakInput): SynthesisRequest;
+/** Create a stable error response. */
+export declare function errorResponse(code: VoiceErrorCode, message: string, traceId?: string, context?: Record<string, unknown>): VoiceErrorResponse;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAG9F,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAuB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAErF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAazE;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,kBAAkB,CAQpB"}

package/dist/request.js

@@ -0,0 +1,33 @@
+/** Synthesis request builder — transforms validated inputs into a backend call descriptor. */
+import { randomUUID } from "node:crypto";
+import { resolveVoiceOrPreset } from "./validate.js";
+import { validateText, validateSpeed } from "./limits.js";
+import { buildArtifactConfig } from "./artifact.js";
+/**
+ * Build a validated SynthesisRequest from raw speak input.
+ * Throws on invalid input with stable error codes.
+ */
+export function buildSynthesisRequest(input) {
+    const traceId = randomUUID();
+    const text = validateText(input.text);
+    // Only pass speed override if explicitly provided (so preset speeds are preserved)
+    const speedOverride = input.speed !== undefined ? validateSpeed(input.speed) : undefined;
+    const resolved = resolveVoiceOrPreset(input.voice, speedOverride);
+    const artifact = buildArtifactConfig({
+        mode: input.artifactMode,
+        outputDir: input.outputDir,
+        format: input.format,
+    });
+    return { traceId, text, resolved, artifact };
+}
+/** Create a stable error response. */
+export function errorResponse(code, message, traceId, context) {
+    return {
+        error: true,
+        code,
+        message,
+        traceId: traceId ?? randomUUID(),
+        ...(context ? { context } : {}),
+    };
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAE9F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAsB,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAA0C,MAAM,eAAe,CAAC;AAmB5F;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiB;IACrD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,mFAAmF;IACnF,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACnC,IAAI,EAAE,KAAK,CAAC,YAAY;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,aAAa,CAC3B,IAAoB,EACpB,OAAe,EACf,OAAgB,EAChB,OAAiC;IAEjC,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE;QAChC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/sandbox.d.ts

@@ -0,0 +1,15 @@
+/** Filesystem sandbox utilities — safe filenames and symlink checks. */
+import type { OutputFormat } from "./artifact.js";
+/** File prefix used for all generated audio files. */
+export declare const SAFE_FILE_PREFIX = "vsmcp_";
+/**
+ * Generate a safe, non-guessable filename with the vsmcp_ prefix.
+ * Format: vsmcp_<uuid8>_<timestamp>.<format>
+ */
+export declare function generateSafeFilename(format?: OutputFormat): string;
+/**
+ * Check if a path is a symlink.
+ * Returns true if the path exists and is a symlink, false otherwise.
+ */
+export declare function isSymlink(path: string): Promise<boolean>;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAIxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,YAAoB,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9D"}

package/dist/sandbox.js

@@ -0,0 +1,27 @@
+/** Filesystem sandbox utilities — safe filenames and symlink checks. */
+import { lstat } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+/** File prefix used for all generated audio files. */
+export const SAFE_FILE_PREFIX = "vsmcp_";
+/**
+ * Generate a safe, non-guessable filename with the vsmcp_ prefix.
+ * Format: vsmcp_<uuid8>_<timestamp>.<format>
+ */
+export function generateSafeFilename(format = "wav") {
+    return `${SAFE_FILE_PREFIX}${randomUUID().slice(0, 8)}_${Date.now()}.${format}`;
+}
+/**
+ * Check if a path is a symlink.
+ * Returns true if the path exists and is a symlink, false otherwise.
+ */
+export async function isSymlink(path) {
+    try {
+        const stats = await lstat(path);
+        return stats.isSymbolicLink();
+    }
+    catch {
+        // Path doesn't exist — not a symlink
+        return false;
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAuB,KAAK;IAC/D,OAAO,GAAG,gBAAgB,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,49 @@
+/** Stable response schemas for MCP tool outputs. */
+import type { VoiceInfo } from "./voices.js";
+import type { PresetConfig } from "./presets.js";
+export interface BackendInfo {
+    readonly type: string;
+    readonly ready: boolean;
+    readonly model?: string;
+    readonly sampleRate?: number;
+    readonly details?: string;
+}
+export interface VoiceStatusResponse {
+    readonly voices: VoiceInfo[];
+    readonly presets: PresetConfig[];
+    readonly defaultVoice: string;
+    readonly backend: BackendInfo;
+}
+export interface VoiceSpeakResponse {
+    readonly traceId: string;
+    readonly voiceUsed: string;
+    readonly presetUsed?: string;
+    readonly speed: number;
+    readonly artifactMode: ArtifactMode;
+    readonly audioPath?: string;
+    readonly audioBytesBase64?: string;
+    readonly durationMs?: number;
+    readonly sampleRate?: number;
+    readonly format: string;
+}
+export type ArtifactMode = "path" | "base64";
+export interface VoiceInterruptResponse {
+    readonly interrupted: boolean;
+    readonly streamId?: string;
+    readonly reason: string;
+}
+export interface VoiceStreamResponse {
+    readonly streamId: string;
+    readonly voiceUsed: string;
+    readonly status: "started" | "completed" | "interrupted";
+}
+export interface VoiceErrorResponse {
+    readonly error: true;
+    readonly code: string;
+    readonly message: string;
+    readonly traceId: string;
+    readonly context?: Record<string, unknown>;
+}
+/** All possible stable error codes. */
+export type VoiceErrorCode = "VOICE_NOT_APPROVED" | "VOICE_OR_PRESET_NOT_FOUND" | "TEXT_TOO_LONG" | "TEXT_EMPTY" | "SPEED_OUT_OF_RANGE" | "SSML_PARSE_FAILED" | "BACKEND_UNAVAILABLE" | "BACKEND_TIMEOUT" | "BACKEND_BAD_RESPONSE" | "BACKEND_UNREACHABLE" | "SYNTHESIS_FAILED" | "STREAM_NOT_FOUND" | "OUTPUT_DIR_INVALID" | "INTERNAL_ERROR" | "LIMIT_EXCEEDED" | "BUSY" | "REQUEST_TIMEOUT" | "RATE_LIMITED" | "VALIDATION_FAILED";
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAI7C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;CAC1D;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,uCAAuC;AACvC,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,2BAA2B,GAC3B,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,mBAAmB,GACnB,qBAAqB,GACrB,iBAAiB,GACjB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAEhB,gBAAgB,GAChB,MAAM,GACN,iBAAiB,GACjB,cAAc,GACd,mBAAmB,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,3 @@
+/** Stable response schemas for MCP tool outputs. */
+export {};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/sfx/generator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SFX WAV generator — programmatic audio generation for sound effects.
+ *
+ * All SFX are generated as 24kHz mono 16-bit PCM to match TTS output.
+ * No external WAV assets needed.
+ */
+import type { SfxTag } from "./types.js";
+/**
+ * Generate a WAV buffer for a given SFX tag.
+ * Returns raw WAV file data (with header) as a Buffer.
+ */
+export declare function generateSfxWav(tag: SfxTag): Buffer;
+/** Get the duration in ms for a given SFX tag. */
+export declare function getSfxDurationMs(tag: SfxTag): number;
+//# sourceMappingURL=generator.d.ts.map

package/dist/sfx/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/sfx/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAOzC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBlD;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/sfx/generator.js

@@ -0,0 +1,114 @@
+/**
+ * SFX WAV generator — programmatic audio generation for sound effects.
+ *
+ * All SFX are generated as 24kHz mono 16-bit PCM to match TTS output.
+ * No external WAV assets needed.
+ */
+import { SFX_REGISTRY } from "./registry.js";
+import { buildWavFile } from "../orchestrator/concat.js";
+const SAMPLE_RATE = 24000;
+const MAX_INT16 = 32767;
+/**
+ * Generate a WAV buffer for a given SFX tag.
+ * Returns raw WAV file data (with header) as a Buffer.
+ */
+export function generateSfxWav(tag) {
+    const params = SFX_REGISTRY[tag];
+    const numSamples = Math.round((params.durationMs / 1000) * SAMPLE_RATE);
+    const pcm = Buffer.alloc(numSamples * 2); // 16-bit = 2 bytes per sample
+    switch (params.waveform) {
+        case "sine":
+            generateSine(pcm, numSamples, params.frequency, params.envelope);
+            break;
+        case "noise":
+            generateNoise(pcm, numSamples, params.envelope);
+            break;
+        case "impulse":
+            generateImpulse(pcm, numSamples);
+            break;
+        case "arpeggio":
+            generateArpeggio(pcm, numSamples, params.frequency, params.envelope);
+            break;
+    }
+    return buildWavFile(pcm, SAMPLE_RATE);
+}
+/** Get the duration in ms for a given SFX tag. */
+export function getSfxDurationMs(tag) {
+    return SFX_REGISTRY[tag].durationMs;
+}
+// ── Waveform generators ──
+function generateSine(pcm, numSamples, frequency, envelope) {
+    for (let i = 0; i < numSamples; i++) {
+        const t = i / SAMPLE_RATE;
+        const phase = 2 * Math.PI * frequency * t;
+        let sample = Math.sin(phase);
+        sample *= applyEnvelope(i, numSamples, envelope);
+        writeSample(pcm, i, sample * 0.7);
+    }
+}
+function generateNoise(pcm, numSamples, envelope) {
+    for (let i = 0; i < numSamples; i++) {
+        let sample = Math.random() * 2 - 1;
+        sample *= applyEnvelope(i, numSamples, envelope);
+        writeSample(pcm, i, sample * 0.4);
+    }
+}
+function generateImpulse(pcm, numSamples) {
+    for (let i = 0; i < numSamples; i++) {
+        const t = i / numSamples;
+        // Sharp impulse with fast exponential decay
+        const sample = Math.exp(-t * 30) * (i < 3 ? 1.0 : 0.3 * Math.exp(-t * 10));
+        writeSample(pcm, i, sample * 0.8);
+    }
+}
+function generateArpeggio(pcm, numSamples, baseFreq, envelope) {
+    // C5-E5-G5 arpeggio (major triad)
+    const freqs = [baseFreq, baseFreq * 1.26, baseFreq * 1.5]; // ~C5, E5, G5
+    const noteSamples = Math.floor(numSamples / freqs.length);
+    for (let noteIdx = 0; noteIdx < freqs.length; noteIdx++) {
+        const startSample = noteIdx * noteSamples;
+        const freq = freqs[noteIdx];
+        for (let i = 0; i < noteSamples; i++) {
+            const globalIdx = startSample + i;
+            if (globalIdx >= numSamples)
+                break;
+            const t = i / SAMPLE_RATE;
+            const phase = 2 * Math.PI * freq * t;
+            let sample = Math.sin(phase);
+            // Per-note envelope: quick attack, sustain, gentle release
+            const noteT = i / noteSamples;
+            const noteEnv = Math.min(1, noteT * 10) * (1 - Math.pow(noteT, 3));
+            // Global rising envelope
+            const globalEnv = applyEnvelope(globalIdx, numSamples, envelope);
+            sample *= noteEnv * globalEnv;
+            writeSample(pcm, globalIdx, sample * 0.6);
+        }
+    }
+}
+// ── Envelope helpers ──
+function applyEnvelope(sampleIdx, totalSamples, envelope) {
+    const t = sampleIdx / totalSamples;
+    switch (envelope) {
+        case "decay":
+            return Math.exp(-t * 5);
+        case "bell":
+            // Fast attack, slow decay with a resonant tail
+            return Math.min(1, t * 20) * Math.exp(-t * 4) * (1 + 0.3 * Math.sin(t * 30));
+        case "sweep":
+            // Bandpass-like sweep: rises then falls
+            return Math.sin(Math.PI * t) * (1 - t * 0.5);
+        case "burst":
+            // Very fast attack and decay
+            return Math.exp(-t * 15);
+        case "rising":
+            // Gradual rise with gentle taper at end
+            return Math.min(1, t * 3) * (1 - Math.pow(Math.max(0, t - 0.8) * 5, 2));
+        default:
+            return 1;
+    }
+}
+function writeSample(pcm, index, value) {
+    const clamped = Math.max(-1, Math.min(1, value));
+    pcm.writeInt16LE(Math.round(clamped * MAX_INT16), index * 2);
+}
+//# sourceMappingURL=generator.js.map

package/dist/sfx/generator.js.map

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

package/dist/sfx/index.d.ts

@@ -0,0 +1,7 @@
+/** SFX module — barrel exports. */
+export { SFX_TAGS, type SfxTag, type SfxEvent, type SfxTextSegment, type SfxSegment, type SfxWarning, type SfxParseResult, } from "./types.js";
+export { type SfxGenParams, SFX_REGISTRY, SFX_MAX_EVENTS, } from "./registry.js";
+export { hasSfxTags, parseSfxTags, } from "./parser.js";
+export { generateSfxWav, getSfxDurationMs, } from "./generator.js";
+export { type SfxStitchWarning, type SfxStitchResult, createSfxChunks, checkSfxConcatRequired, } from "./stitcher.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sfx/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EACL,QAAQ,EACR,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,eAAe,EACf,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/sfx/index.js

@@ -0,0 +1,7 @@
+/** SFX module — barrel exports. */
+export { SFX_TAGS, } from "./types.js";
+export { SFX_REGISTRY, SFX_MAX_EVENTS, } from "./registry.js";
+export { hasSfxTags, parseSfxTags, } from "./parser.js";
+export { generateSfxWav, getSfxDurationMs, } from "./generator.js";
+export { createSfxChunks, checkSfxConcatRequired, } from "./stitcher.js";
+//# sourceMappingURL=index.js.map

package/dist/sfx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sfx/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EACL,QAAQ,GAOT,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAGL,eAAe,EACf,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/sfx/parser.d.ts

@@ -0,0 +1,16 @@
+/** SFX tag parser — extracts [tag] sound effect directives from text. */
+import { type SfxParseResult } from "./types.js";
+/** Check whether text contains any potential SFX tags. */
+export declare function hasSfxTags(text: string): boolean;
+/**
+ * Parse SFX tags from text.
+ *
+ * When `enabled=false` (default), tags are left as literal text and a
+ * `SFX_DISABLED` warning is emitted. When `enabled=true`, known tags
+ * become `SfxEvent` segments interleaved with text segments.
+ *
+ * Unknown tags are always left as literal text with `SFX_UNKNOWN_TAG` warning.
+ * Exceeding `SFX_MAX_EVENTS` emits `SFX_MAX_EVENTS` warning and stops extracting.
+ */
+export declare function parseSfxTags(text: string, enabled?: boolean): SfxParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/sfx/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/sfx/parser.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAA2D,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAW1G,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAe,GACvB,cAAc,CAkFhB"}