@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/audiobook/audiobook-studio.schema.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElevenLabsStudioProjectArtifactPayloadSchema = exports.ElevenLabsStudioProjectSchema = exports.ElevenLabsStudioProjectStatusSchema = exports.ElevenLabsStudioChapterStatusSchema = exports.AudiobookDistributionArtifactPayloadSchema = exports.AudiobookProductionModeArtifactPayloadSchema = exports.ElevenLabsAudiobookImportRecordSchema = exports.ElevenLabsImportedAssetSchema = exports.ElevenLabsReaderDistributionStatusSchema = exports.AudiobookStudioExportArtifactPayloadSchema = exports.ElevenLabsAudiobookExportPackageSchema = exports.ElevenLabsAudiobookExportChapterSchema = exports.ElevenLabsProductionModeSchema = exports.THE_GREAT_INVERSION_DOCUMENTARY_PRONUNCIATION_SEED = exports.THE_AGE_OF_DISTRIBUTED_INTELLIGENCE_DOCUMENTARY_PRONUNCIATION_SEED = exports.AlicePronunciationTermSchema = exports.AlicePronunciationGuideSchema = void 0;
+exports.buildElevenLabsStudioProjectDeepLink = buildElevenLabsStudioProjectDeepLink;
+const zod_1 = require("zod");
+/** Re-export Alice pronunciation SSOT for studio payloads and pipeline consumers. */
+var alice_pronunciation_schema_1 = require("./alice-pronunciation.schema");
+Object.defineProperty(exports, "AlicePronunciationGuideSchema", { enumerable: true, get: function () { return alice_pronunciation_schema_1.AlicePronunciationGuideSchema; } });
+Object.defineProperty(exports, "AlicePronunciationTermSchema", { enumerable: true, get: function () { return alice_pronunciation_schema_1.AlicePronunciationTermSchema; } });
+Object.defineProperty(exports, "THE_AGE_OF_DISTRIBUTED_INTELLIGENCE_DOCUMENTARY_PRONUNCIATION_SEED", { enumerable: true, get: function () { return alice_pronunciation_schema_1.THE_AGE_OF_DISTRIBUTED_INTELLIGENCE_DOCUMENTARY_PRONUNCIATION_SEED; } });
+Object.defineProperty(exports, "THE_GREAT_INVERSION_DOCUMENTARY_PRONUNCIATION_SEED", { enumerable: true, get: function () { return alice_pronunciation_schema_1.THE_GREAT_INVERSION_DOCUMENTARY_PRONUNCIATION_SEED; } });
+exports.ElevenLabsProductionModeSchema = zod_1.z.enum(["audiobooks_studio", "direct_api"]);
+exports.ElevenLabsAudiobookExportChapterSchema = zod_1.z
+    .object({
+    chapterId: zod_1.z.string().uuid(),
+    /** Zero-based pipeline chapter index (publication layout / imports). */
+    chapterIndex: zod_1.z.number().int().min(0),
+    number: zod_1.z.number().int().min(1),
+    title: zod_1.z.string().min(1),
+    narrationScriptText: zod_1.z.string().min(1),
+    sourceTextHash: zod_1.z.string().min(1),
+    pronunciationTerms: zod_1.z.array(zod_1.z.string()),
+    soundCueNotes: zod_1.z.array(zod_1.z.string()),
+    visualCueNotes: zod_1.z.array(zod_1.z.string()),
+})
+    .strict();
+exports.ElevenLabsAudiobookExportPackageSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    bookSlug: zod_1.z.string().min(1),
+    title: zod_1.z.string().min(1),
+    subtitle: zod_1.z.string().min(1).optional(),
+    author: zod_1.z.string().min(1),
+    narrator: zod_1.z
+        .object({
+        provider: zod_1.z.literal("elevenlabs"),
+        voiceName: zod_1.z.string().min(1),
+        voiceId: zod_1.z.string().min(1),
+    })
+        .strict(),
+    mode: zod_1.z.literal("original_audio"),
+    chapters: zod_1.z.array(exports.ElevenLabsAudiobookExportChapterSchema).min(1),
+    pronunciationGuideUrl: zod_1.z.string().url().optional(),
+    coverUrl: zod_1.z.string().url().optional(),
+    metadata: zod_1.z
+        .object({
+        sourceWorkflowRunId: zod_1.z.string().uuid().optional(),
+        generatedAt: zod_1.z.string().datetime(),
+        schemaVersion: zod_1.z.literal("1.0"),
+    })
+        .strict(),
+})
+    .strict();
+/** Payload stored on workflow artifact rows (includes storage pointers). */
+exports.AudiobookStudioExportArtifactPayloadSchema = zod_1.z
+    .object({
+    exportPackage: exports.ElevenLabsAudiobookExportPackageSchema,
+    exportJsonStoragePath: zod_1.z.string().min(1),
+    exportJsonPublicUrl: zod_1.z.string().url(),
+    pronunciationTermCount: zod_1.z.number().int().nonnegative(),
+    chapterCount: zod_1.z.number().int().positive(),
+})
+    .strict();
+exports.ElevenLabsReaderDistributionStatusSchema = zod_1.z.enum([
+    "not_submitted",
+    "submitted",
+    "under_review",
+    "live",
+    "rejected",
+]);
+exports.ElevenLabsImportedAssetSchema = zod_1.z
+    .object({
+    chapterId: zod_1.z.string().uuid(),
+    assetType: zod_1.z.enum(["mp3", "wav", "subtitle", "timeline_aaf", "timeline_json"]),
+    sourceFilename: zod_1.z.string().min(1),
+    storageUrl: zod_1.z.string().url(),
+    durationSeconds: zod_1.z.number().nonnegative().optional(),
+    sourceTextHash: zod_1.z.string().min(1).optional(),
+})
+    .strict();
+exports.ElevenLabsAudiobookImportRecordSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    bookSlug: zod_1.z.string().min(1),
+    externalProductionTool: zod_1.z.literal("elevenlabs_audiobooks"),
+    elevenLabsProjectId: zod_1.z.string().min(1).optional(),
+    importedAt: zod_1.z.string().datetime(),
+    importedAssets: zod_1.z.array(exports.ElevenLabsImportedAssetSchema).min(1),
+    distribution: zod_1.z
+        .object({
+        elevenReaderStatus: exports.ElevenLabsReaderDistributionStatusSchema.optional(),
+        partnerStatuses: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+        publicUrls: zod_1.z.array(zod_1.z.string().url()).optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+exports.AudiobookProductionModeArtifactPayloadSchema = zod_1.z
+    .object({
+    mode: exports.ElevenLabsProductionModeSchema,
+    savedAt: zod_1.z.string().datetime(),
+})
+    .strict();
+exports.AudiobookDistributionArtifactPayloadSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    bookSlug: zod_1.z.string().min(1),
+    elevenReaderStatus: exports.ElevenLabsReaderDistributionStatusSchema,
+    partnerStatuses: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+    publicUrls: zod_1.z.array(zod_1.z.string().url()).optional(),
+    updatedAt: zod_1.z.string().datetime(),
+})
+    .strict();
+exports.ElevenLabsStudioChapterStatusSchema = zod_1.z.enum([
+    "created",
+    "generating",
+    "ready",
+    "error",
+    "imported",
+]);
+exports.ElevenLabsStudioProjectStatusSchema = zod_1.z.enum([
+    "created",
+    "partial",
+    "ready",
+    "imported",
+]);
+/** Tracks ElevenLabs Studio (/v1/studio/projects) linkage for documentary audiobooks. */
+exports.ElevenLabsStudioProjectSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    elevenLabsStudioProjectId: zod_1.z.string().min(1),
+    name: zod_1.z.string().min(1),
+    defaultVoiceId: zod_1.z.string().min(1),
+    modelId: zod_1.z.string().min(1),
+    chapters: zod_1.z
+        .array(zod_1.z
+        .object({
+        chapterId: zod_1.z.string().uuid(),
+        chapterIndex: zod_1.z.number().int().min(0),
+        elevenLabsChapterId: zod_1.z.string().min(1),
+        name: zod_1.z.string().min(1),
+        status: exports.ElevenLabsStudioChapterStatusSchema,
+        sourceTextHash: zod_1.z.string().min(1),
+        snapshotId: zod_1.z.string().min(1).optional(),
+        audioUrl: zod_1.z.string().url().optional(),
+    })
+        .strict())
+        .min(1),
+    status: exports.ElevenLabsStudioProjectStatusSchema,
+    createdAt: zod_1.z.string().datetime(),
+    updatedAt: zod_1.z.string().datetime(),
+})
+    .strict();
+exports.ElevenLabsStudioProjectArtifactPayloadSchema = exports.ElevenLabsStudioProjectSchema;
+/** Product UI deep link for a Studio project (ElevenLabs web app). */
+function buildElevenLabsStudioProjectDeepLink(elevenLabsStudioProjectId) {
+    return `https://elevenlabs.io/app/studio/projects/${encodeURIComponent(elevenLabsStudioProjectId)}`;
+}

package/dist/schemas/audiobook/audiobook-validation.d.ts

@@ -0,0 +1,227 @@
+export declare function validateNarrationScript(input: unknown): {
+    chapterIndex: number;
+    generationMeta: {
+        createdAt: string;
+        voiceId: string;
+        modelId: string;
+        provider: "elevenlabs";
+        sourceTextHash: string;
+        settingsHash: string;
+        outputFormat?: string | undefined;
+        estimatedCost?: number | undefined;
+        costBreakdown?: {
+            provider: "elevenlabs" | "openai";
+            stage: "guardian" | "adaptation" | "tts" | "sound_effect" | "mix" | "qa";
+            callCount: number;
+            billedCharacters?: number | undefined;
+            incrementalCallCount?: number | undefined;
+            reusedCallCount?: number | undefined;
+            estimatedCostUsd?: number | undefined;
+            incrementalBilledCharacters?: number | undefined;
+            reusedBilledCharacters?: number | undefined;
+        }[] | undefined;
+    };
+    scriptText: string;
+    pronunciationNotes: string[];
+    chapterTitle: string;
+    semanticAssessment?: {
+        sourceTextHash: string;
+        sourceUnitIds: string[];
+        requiredContractItemIds: string[];
+        dimensions: {
+            semanticFidelity: number;
+            factualAccuracy: number;
+            directness: number;
+            humanVoiceStorytelling: number;
+            spokenClarity: number;
+            listeningEngagement: number;
+        };
+        unsupportedAdditions: string[];
+        unresolvedContractItemIds: string[];
+        blockers: string[];
+        scriptHash: string;
+        version: "narration-semantic-v1";
+        adaptationPromptVersion: "narration-adaptation-v1";
+        guardianPromptVersion: "narration-guardian-v1";
+        chapterArtifactId: string;
+        sourcePlanArtifactId: string;
+        chapterAuthorizationHash: string;
+        sourceLength: number;
+        sourceContractHash: string;
+        scriptLength: number;
+        semanticCacheKey: string;
+        sourceUnitProofs: {
+            id: string;
+            unitKind: "sentence" | "paragraph" | "fragment";
+            scriptSourceStart: number;
+            scriptSourceEnd: number;
+            textHash: string;
+        }[];
+        batchMappings: {
+            scriptStart: number;
+            scriptEnd: number;
+            batchId: string;
+            sourceUnitIds: string[];
+            requiredContractItemIds: string[];
+            scriptHash: string;
+        }[];
+        assessedAt: string;
+        passed: boolean;
+    } | undefined;
+    sourceExcerptRatio?: number | undefined;
+};
+export declare function validateSoundCueSheet(input: unknown): {
+    chapterIndex: number;
+    generationMeta: {
+        createdAt: string;
+        voiceId: string;
+        modelId: string;
+        provider: "elevenlabs";
+        sourceTextHash: string;
+        settingsHash: string;
+        outputFormat?: string | undefined;
+        estimatedCost?: number | undefined;
+        costBreakdown?: {
+            provider: "elevenlabs" | "openai";
+            stage: "guardian" | "adaptation" | "tts" | "sound_effect" | "mix" | "qa";
+            callCount: number;
+            billedCharacters?: number | undefined;
+            incrementalCallCount?: number | undefined;
+            reusedCallCount?: number | undefined;
+            estimatedCostUsd?: number | undefined;
+            incrementalBilledCharacters?: number | undefined;
+            reusedBilledCharacters?: number | undefined;
+        }[] | undefined;
+    };
+    cues: {
+        id: string;
+        placementSec: number;
+        semanticJustification: string;
+        sfxPrompt: string;
+        relativeGainDb: number;
+    }[];
+};
+export declare function validateAudioQA(input: unknown): {
+    chapterIndex: number;
+    generationMeta: {
+        createdAt: string;
+        voiceId: string;
+        modelId: string;
+        provider: "elevenlabs";
+        sourceTextHash: string;
+        settingsHash: string;
+        outputFormat?: string | undefined;
+        estimatedCost?: number | undefined;
+        costBreakdown?: {
+            provider: "elevenlabs" | "openai";
+            stage: "guardian" | "adaptation" | "tts" | "sound_effect" | "mix" | "qa";
+            callCount: number;
+            billedCharacters?: number | undefined;
+            incrementalCallCount?: number | undefined;
+            reusedCallCount?: number | undefined;
+            estimatedCostUsd?: number | undefined;
+            incrementalBilledCharacters?: number | undefined;
+            reusedBilledCharacters?: number | undefined;
+        }[] | undefined;
+    };
+    passed: boolean;
+    voiceDisplayNameExpected: string;
+    voiceIdUsed: string;
+    findings: {
+        code: string;
+        message: string;
+        severity: "info" | "warn" | "fail";
+    }[];
+    sourceTextHash?: string | undefined;
+    fullScriptHash?: string | undefined;
+    voiceSettingsPreset?: string | undefined;
+    voiceSettingsHash?: string | undefined;
+    sourcePlanArtifactId?: string | undefined;
+    chapterAuthorizationHash?: string | undefined;
+    narrationTtsCacheKey?: string | undefined;
+    narrationScriptArtifactId?: string | undefined;
+    semanticAssessmentHash?: string | undefined;
+    narrationTimingArtifactId?: string | undefined;
+    mixedInputHash?: string | undefined;
+    mixedAudioArtifactId?: string | undefined;
+    sourceChapterArtifactId?: string | undefined;
+    mixedAudioSha256?: string | undefined;
+    mixedAudioByteLength?: number | undefined;
+    narrationChunkCount?: number | undefined;
+    chunkCoveragePassed?: boolean | undefined;
+};
+export declare function validateProductionManifest(input: unknown): {
+    chapterIndex: number;
+    generationMeta: {
+        createdAt: string;
+        voiceId: string;
+        modelId: string;
+        provider: "elevenlabs";
+        sourceTextHash: string;
+        settingsHash: string;
+        outputFormat?: string | undefined;
+        estimatedCost?: number | undefined;
+        costBreakdown?: {
+            provider: "elevenlabs" | "openai";
+            stage: "guardian" | "adaptation" | "tts" | "sound_effect" | "mix" | "qa";
+            callCount: number;
+            billedCharacters?: number | undefined;
+            incrementalCallCount?: number | undefined;
+            reusedCallCount?: number | undefined;
+            estimatedCostUsd?: number | undefined;
+            incrementalBilledCharacters?: number | undefined;
+            reusedBilledCharacters?: number | undefined;
+        }[] | undefined;
+    };
+    artifactRowIds: {
+        timeline?: string | undefined;
+        voiceProfile?: string | undefined;
+        narrationScript?: string | undefined;
+        narrationTiming?: string | undefined;
+        soundCueSheet?: string | undefined;
+        soundAssets?: string | undefined;
+        mixPlan?: string | undefined;
+        mixedAudio?: string | undefined;
+        qaReport?: string | undefined;
+        visualStoryboard?: string | undefined;
+        stillImagePrompts?: string | undefined;
+        motionCues?: string | undefined;
+    };
+    requiredComplete: boolean;
+    releaseProof?: {
+        sourceTextHash: string;
+        fullScriptHash: string;
+        sourcePlanArtifactId: string;
+        chapterAuthorizationHash: string;
+        narrationTtsCacheKey: string;
+        narrationScriptArtifactId: string;
+        semanticAssessmentHash: string;
+        narrationTimingArtifactId: string;
+        mixedAudioArtifactId: string;
+        sourceChapterArtifactId: string;
+        qaReportArtifactId: string;
+        qaPassed: true;
+        voiceSettingsPreset?: string | undefined;
+        voiceSettingsHash?: string | undefined;
+        mixedInputHash?: string | undefined;
+        mixedAudioSha256?: string | undefined;
+        mixedAudioByteLength?: number | undefined;
+    } | undefined;
+};
+export declare function defaultAudioProductionSettings(): {
+    mode: "documentary_audiobook";
+    voiceSettings: {
+        style: number;
+        stability: number;
+        similarity_boost: number;
+        use_speaker_boost: boolean;
+    };
+    voiceName: string;
+    voiceSettingsPreset: string;
+    narrationProvider: "elevenlabs";
+    soundProvider: "elevenlabs";
+    soundDesignIntensity: "none" | "subtle" | "moderate";
+    maxCuesPerChapter: number;
+    visualStoryboardEnabled: boolean;
+    elevenLabsVoiceId?: string | undefined;
+};

package/dist/schemas/audiobook/audiobook-validation.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNarrationScript = validateNarrationScript;
+exports.validateSoundCueSheet = validateSoundCueSheet;
+exports.validateAudioQA = validateAudioQA;
+exports.validateProductionManifest = validateProductionManifest;
+exports.defaultAudioProductionSettings = defaultAudioProductionSettings;
+const audiobook_artifacts_schema_1 = require("./audiobook-artifacts.schema");
+function validateNarrationScript(input) {
+    return audiobook_artifacts_schema_1.NarrationScriptArtifactPayloadSchema.parse(input);
+}
+function validateSoundCueSheet(input) {
+    return audiobook_artifacts_schema_1.SoundCueSheetPayloadSchema.parse(input);
+}
+function validateAudioQA(input) {
+    return audiobook_artifacts_schema_1.AudioQAReportPayloadSchema.parse(input);
+}
+function validateProductionManifest(input) {
+    return audiobook_artifacts_schema_1.ProductionAssetManifestPayloadSchema.parse(input);
+}
+function defaultAudioProductionSettings() {
+    return audiobook_artifacts_schema_1.AudioProductionSettingsSchema.parse(audiobook_artifacts_schema_1.DEFAULT_AUDIO_PRODUCTION_SETTINGS);
+}

package/dist/schemas/audiobook/chunk-narration-script.d.ts

@@ -0,0 +1,17 @@
+/** Exact, offset-addressed slice of a narration script. */
+export type NarrationScriptChunk = {
+    chunkIndex: number;
+    chunkCount: number;
+    scriptStart: number;
+    scriptEnd: number;
+    text: string;
+};
+/**
+ * Splits a script without deleting, trimming, duplicating, or moving a character.
+ * Paragraph and sentence boundaries are preferred; a huge unbroken token is cut
+ * only at the hard provider ceiling. The returned offsets cover `[0, text.length)`
+ * exactly and make the punctuation associated with a sentence stay in that chunk.
+ */
+export declare function chunkNarrationScriptWithOffsets(text: string, maxCharsBeforeFlush?: number, hardMaxChars?: number): NarrationScriptChunk[];
+/** Compatibility wrapper for provider callers that only need exact chunk text. */
+export declare function chunkNarrationScript(text: string, maxCharsBeforeFlush?: number, hardMaxChars?: number): string[];

package/dist/schemas/audiobook/chunk-narration-script.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunkNarrationScriptWithOffsets = chunkNarrationScriptWithOffsets;
+exports.chunkNarrationScript = chunkNarrationScript;
+function firstBoundaryAtOrAfter(text, pattern, start, desiredEnd, hardEnd) {
+    pattern.lastIndex = start;
+    let match = pattern.exec(text);
+    while (match !== null) {
+        const end = match.index + match[0].length;
+        if (end > hardEnd) {
+            return null;
+        }
+        if (end >= desiredEnd && end > start) {
+            return end;
+        }
+        match = pattern.exec(text);
+    }
+    return null;
+}
+function lastBoundaryAtOrBefore(text, pattern, start, desiredEnd) {
+    pattern.lastIndex = start;
+    let selected = null;
+    let match = pattern.exec(text);
+    while (match !== null) {
+        const end = match.index + match[0].length;
+        if (end > desiredEnd) {
+            break;
+        }
+        if (end > start) {
+            selected = end;
+        }
+        match = pattern.exec(text);
+    }
+    return selected;
+}
+function selectChunkEnd(text, start, softMaxChars, hardMaxChars) {
+    const hardEnd = Math.min(text.length, start + hardMaxChars);
+    if (hardEnd === text.length) {
+        return hardEnd;
+    }
+    const desiredEnd = Math.min(hardEnd, start + softMaxChars);
+    const boundaryPatterns = [
+        /\n\s*\n+/gu,
+        /[.!?]+["'\u201d\u2019)\]]*(?:\s+|$)/gu,
+        /\s+/gu,
+    ];
+    for (const pattern of boundaryPatterns) {
+        const after = firstBoundaryAtOrAfter(text, pattern, start, desiredEnd, hardEnd);
+        if (after !== null) {
+            return after;
+        }
+        const before = lastBoundaryAtOrBefore(text, pattern, start, desiredEnd);
+        if (before !== null && before - start >= Math.floor(softMaxChars / 2)) {
+            return before;
+        }
+    }
+    return hardEnd;
+}
+/**
+ * Splits a script without deleting, trimming, duplicating, or moving a character.
+ * Paragraph and sentence boundaries are preferred; a huge unbroken token is cut
+ * only at the hard provider ceiling. The returned offsets cover `[0, text.length)`
+ * exactly and make the punctuation associated with a sentence stay in that chunk.
+ */
+function chunkNarrationScriptWithOffsets(text, maxCharsBeforeFlush = 10_000, hardMaxChars = 12_000) {
+    if (text.length === 0) {
+        return [];
+    }
+    if (!Number.isSafeInteger(maxCharsBeforeFlush) || maxCharsBeforeFlush < 1) {
+        throw new Error('maxCharsBeforeFlush must be a positive safe integer');
+    }
+    if (!Number.isSafeInteger(hardMaxChars) || hardMaxChars < maxCharsBeforeFlush) {
+        throw new Error('hardMaxChars must be a safe integer at least maxCharsBeforeFlush');
+    }
+    const boundaries = [];
+    let scriptStart = 0;
+    while (scriptStart < text.length) {
+        const scriptEnd = selectChunkEnd(text, scriptStart, maxCharsBeforeFlush, hardMaxChars);
+        if (scriptEnd <= scriptStart) {
+            throw new Error('Narration chunker failed to advance');
+        }
+        boundaries.push({
+            scriptStart,
+            scriptEnd,
+            text: text.slice(scriptStart, scriptEnd),
+        });
+        scriptStart = scriptEnd;
+    }
+    const chunkCount = boundaries.length;
+    return boundaries.map((chunk, chunkIndex) => ({ ...chunk, chunkIndex, chunkCount }));
+}
+/** Compatibility wrapper for provider callers that only need exact chunk text. */
+function chunkNarrationScript(text, maxCharsBeforeFlush = 10_000, hardMaxChars = 12_000) {
+    return chunkNarrationScriptWithOffsets(text, maxCharsBeforeFlush, hardMaxChars)
+        .map((chunk) => chunk.text);
+}

package/dist/schemas/audiobook/elevenlabs-provider.schema.d.ts

@@ -0,0 +1,167 @@
+import { z } from "zod";
+/** ElevenLabs `voice_settings` payload (REST body shape). */
+export declare const ElevenLabsVoiceSettingsSchema: z.ZodObject<{
+    stability: z.ZodNumber;
+    similarity_boost: z.ZodNumber;
+    style: z.ZodNumber;
+    use_speaker_boost: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    style: number;
+    stability: number;
+    similarity_boost: number;
+    use_speaker_boost: boolean;
+}, {
+    style: number;
+    stability: number;
+    similarity_boost: number;
+    use_speaker_boost: boolean;
+}>;
+export type ElevenLabsVoiceSettings = z.infer<typeof ElevenLabsVoiceSettingsSchema>;
+/** Canonical ElevenLabs voice lab ID for documentary narrator Alice (Young British Woman). */
+export declare const DOCUMENTARY_ALICE_ELEVENLABS_VOICE_ID: "ZEt85AU1ui8Rr8FxNslW";
+/** Display label matching ElevenLabs voice listing (SSOT for settings + narration chunks). */
+export declare const DOCUMENTARY_ALICE_VOICE_NAME: "Alice - Young British Woman";
+/** Documentary narration model (Alice production). */
+export declare const DOCUMENTARY_ALICE_MODEL_ID: "eleven_turbo_v2_5";
+/** Alice publication output format — 192 kbps stereo MP3. */
+export declare const DOCUMENTARY_ALICE_OUTPUT_FORMAT: "mp3_44100_192";
+/** Preset A — stable audiobook. */
+export declare const ALICE_VOICE_SETTINGS_A: {
+    style: number;
+    stability: number;
+    similarity_boost: number;
+    use_speaker_boost: boolean;
+};
+/** Preset B — documentary balanced (DEFAULT production). */
+export declare const ALICE_VOICE_SETTINGS_B_DEFAULT: {
+    style: number;
+    stability: number;
+    similarity_boost: number;
+    use_speaker_boost: boolean;
+};
+/** Preset C — expressive (trailer-style only). */
+export declare const ALICE_VOICE_SETTINGS_C: {
+    style: number;
+    stability: number;
+    similarity_boost: number;
+    use_speaker_boost: boolean;
+};
+/** SSOT narration profile for documentary audiobook pipelines. */
+export declare const DOCUMENTARY_ALICE_VOICE_SETTINGS: {
+    style: number;
+    stability: number;
+    similarity_boost: number;
+    use_speaker_boost: boolean;
+};
+/** Normalized voice row from ElevenLabs list voices. */
+export declare const ElevenLabsVoiceSchema: z.ZodObject<{
+    voiceId: z.ZodString;
+    name: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    voiceId: string;
+    category?: string | undefined;
+}, {
+    name: string;
+    voiceId: string;
+    category?: string | undefined;
+}>;
+export type ElevenLabsVoice = z.infer<typeof ElevenLabsVoiceSchema>;
+/**
+ * Offline-safe fallback when GET /v1/voices fails (network / transient ElevenLabs outage).
+ * Product-approved static voice reference — not a secret; narration/TTS still requires `ELEVENLABS_API_KEY`.
+ */
+export declare const DOCUMENTARY_ALICE_FALLBACK_VOICE: ElevenLabsVoice;
+export declare const GenerateNarrationInputSchema: z.ZodObject<{
+    voiceId: z.ZodString;
+    text: z.ZodString;
+    modelId: z.ZodString;
+    voiceSettings: z.ZodOptional<z.ZodObject<{
+        stability: z.ZodNumber;
+        similarity_boost: z.ZodNumber;
+        style: z.ZodNumber;
+        use_speaker_boost: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        style: number;
+        stability: number;
+        similarity_boost: number;
+        use_speaker_boost: boolean;
+    }, {
+        style: number;
+        stability: number;
+        similarity_boost: number;
+        use_speaker_boost: boolean;
+    }>>;
+    /** Query `output_format` for TTS; defaults to DOCUMENTARY_ALICE_OUTPUT_FORMAT in provider when omitted in pipeline. */
+    outputFormat: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    voiceId: string;
+    text: string;
+    modelId: string;
+    voiceSettings?: {
+        style: number;
+        stability: number;
+        similarity_boost: number;
+        use_speaker_boost: boolean;
+    } | undefined;
+    outputFormat?: string | undefined;
+}, {
+    voiceId: string;
+    text: string;
+    modelId: string;
+    voiceSettings?: {
+        style: number;
+        stability: number;
+        similarity_boost: number;
+        use_speaker_boost: boolean;
+    } | undefined;
+    outputFormat?: string | undefined;
+}>;
+export type GenerateNarrationInput = z.infer<typeof GenerateNarrationInputSchema>;
+/** Binary narration result (caller may persist to storage). */
+export declare const GenerateNarrationOutputSchema: z.ZodObject<{
+    audioBase64: z.ZodString;
+    mimeType: z.ZodString;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+    alignmentJson: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    audioBase64: string;
+    mimeType: string;
+    durationSec?: number | undefined;
+    alignmentJson?: Record<string, unknown> | undefined;
+}, {
+    audioBase64: string;
+    mimeType: string;
+    durationSec?: number | undefined;
+    alignmentJson?: Record<string, unknown> | undefined;
+}>;
+export type GenerateNarrationOutput = z.infer<typeof GenerateNarrationOutputSchema>;
+export declare const GenerateSoundEffectInputSchema: z.ZodObject<{
+    text: z.ZodString;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+    promptInfluence: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    text: string;
+    durationSec?: number | undefined;
+    promptInfluence?: number | undefined;
+}, {
+    text: string;
+    durationSec?: number | undefined;
+    promptInfluence?: number | undefined;
+}>;
+export type GenerateSoundEffectInput = z.infer<typeof GenerateSoundEffectInputSchema>;
+export declare const GenerateSoundEffectOutputSchema: z.ZodObject<{
+    audioBase64: z.ZodString;
+    mimeType: z.ZodString;
+    durationSec: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    audioBase64: string;
+    mimeType: string;
+    durationSec?: number | undefined;
+}, {
+    audioBase64: string;
+    mimeType: string;
+    durationSec?: number | undefined;
+}>;
+export type GenerateSoundEffectOutput = z.infer<typeof GenerateSoundEffectOutputSchema>;