@backbay/glia 0.2.0-alpha.1

package/dist/audio/hooks/useSpeechSynthesis.js

@@ -0,0 +1,154 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { planSpeech } from '../planner.js';
+import { validateAudioProof } from '../schema.js';
+import { useAudioPlayer } from './useAudioPlayer.js';
+import { useBargeIn } from './useBargeIn.js';
+// =============================================================================
+// Hook
+// =============================================================================
+export function useSpeechSynthesis(options) {
+    const { provider, verifier, voices, policy, signals, defaults, bargeIn, volume = 1, verificationMode, onProof, onBargeIn, onError, } = options;
+    const effectiveVerificationMode = useMemo(() => {
+        if (verificationMode)
+            return verificationMode;
+        if (policy.requireProofBeforePlayback)
+            return 'before_playback';
+        if (verifier)
+            return 'after_playback';
+        return 'never';
+    }, [verificationMode, policy.requireProofBeforePlayback, verifier]);
+    const abortRef = useRef(null);
+    const [isSynthesizing, setIsSynthesizing] = useState(false);
+    const [error, setError] = useState(null);
+    const [lastRequest, setLastRequest] = useState(null);
+    const [lastResult, setLastResult] = useState(null);
+    const [lastProof, setLastProof] = useState(null);
+    const player = useAudioPlayer({
+        volume,
+        onError: (err) => {
+            setError(err.message);
+            onError?.(err);
+        },
+    });
+    const bargeInState = useBargeIn({
+        stream: bargeIn?.stream ?? null,
+        enabled: !!bargeIn?.stream,
+        threshold: bargeIn?.threshold,
+        hangoverMs: bargeIn?.hangoverMs,
+        onBargeIn: () => {
+            onBargeIn?.();
+        },
+    });
+    const cancel = useCallback(() => {
+        abortRef.current?.abort();
+        abortRef.current = null;
+        setIsSynthesizing(false);
+        player.stop();
+    }, [player]);
+    useEffect(() => {
+        if (!bargeIn?.stream)
+            return;
+        if (!bargeInState.isUserSpeaking)
+            return;
+        cancel();
+    }, [bargeIn?.stream, bargeInState.isUserSpeaking, cancel]);
+    const speak = useCallback(async (text, speakOptions) => {
+        cancel();
+        setError(null);
+        setIsSynthesizing(true);
+        const controller = new AbortController();
+        abortRef.current = controller;
+        try {
+            const request = planSpeech({
+                text,
+                language: speakOptions?.language,
+                runId: speakOptions?.runId,
+                targetAffect: speakOptions?.targetAffect,
+                policy,
+                voices,
+                signals,
+                defaults,
+            });
+            setLastRequest(request);
+            const result = await provider.synthesizeSpeech(request, { signal: controller.signal });
+            setLastResult(result);
+            // If provider included proof, validate it before trusting it.
+            let proof = result.proof;
+            if (proof) {
+                const parsed = validateAudioProof(proof);
+                if (!parsed.success) {
+                    throw new Error('Provider returned invalid AudioProof');
+                }
+                proof = parsed.data;
+            }
+            const verifyNow = effectiveVerificationMode === 'before_playback' &&
+                (!proof || !proof.verdict?.passed) &&
+                !!verifier;
+            if (verifyNow && verifier) {
+                proof = await verifier.verifySpeech({ request, result, policy });
+                const parsed = validateAudioProof(proof);
+                if (!parsed.success) {
+                    throw new Error('Verifier returned invalid AudioProof');
+                }
+                proof = parsed.data;
+            }
+            if (policy.requireProofBeforePlayback && (!proof || proof.verdict.passed !== true)) {
+                throw new Error('Playback blocked by policy: missing or failing AudioProof');
+            }
+            // Playback
+            await player.play(result.audio);
+            // Background verification (if allowed).
+            if (effectiveVerificationMode === 'after_playback' && verifier && !proof) {
+                void (async () => {
+                    try {
+                        const p = await verifier.verifySpeech({ request, result, policy });
+                        const parsed = validateAudioProof(p);
+                        if (!parsed.success)
+                            return;
+                        setLastProof(parsed.data);
+                        onProof?.(parsed.data);
+                    }
+                    catch {
+                        // Ignore background verification errors.
+                    }
+                })();
+            }
+            if (proof) {
+                setLastProof(proof);
+                onProof?.(proof);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Speech synthesis failed';
+            setError(message);
+            onError?.(err instanceof Error ? err : new Error(message));
+            throw err instanceof Error ? err : new Error(message);
+        }
+        finally {
+            setIsSynthesizing(false);
+            abortRef.current = null;
+        }
+    }, [
+        cancel,
+        policy,
+        voices,
+        signals,
+        defaults,
+        provider,
+        verifier,
+        effectiveVerificationMode,
+        player,
+        onProof,
+        onError,
+    ]);
+    return {
+        isSynthesizing,
+        isSpeaking: player.isPlaying,
+        error,
+        lastRequest,
+        lastResult,
+        lastProof,
+        speak,
+        cancel,
+    };
+}

package/dist/audio/index.d.ts

@@ -0,0 +1,12 @@
+export type { AudioFormat, VoiceLicenseCategory, VoiceCatalogEntry, VoiceCatalog, AudioPolicy, AudioPlannerMode, SpeechControls, SpeechSynthesisRequest, AudioArtifact, SpeechSynthesisResult, SpeechSynthesisProvider, AudioVerifier, AudioGateResult, AudioGates, EvidenceRef, AudioProof, } from './types.js';
+export { clamp01, createTraceId, DEFAULT_TARGET_AVO } from './types.js';
+export { AudioProofSchema, validateAudioProof, AudioFormatSchema, VoiceLicenseCategorySchema, } from './schema.js';
+export type { AudioProofInput, AudioProofOutput, AudioProofValidationResult } from './schema.js';
+export { planSpeech, planSpeechFromCognition } from './planner.js';
+export type { AudioPlannerInput, AudioPlannerSignals, AudioPlannerCognitionInput } from './planner.js';
+export { DEFAULT_OVERLAY_PHRASES, pickOverlayPhrase } from './overlay.js';
+export type { OverlayToken, OverlayPhraseLibrary } from './overlay.js';
+export { HttpSpeechSynthesisProvider } from './providers/httpSpeechSynthesisProvider.js';
+export type { HttpSpeechSynthesisProviderOptions, HttpSynthesisResponse } from './providers/httpSpeechSynthesisProvider.js';
+export * from './hooks/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMxE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAMjG,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAMvG,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,YAAY,EAAE,kCAAkC,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAM5H,cAAc,kBAAkB,CAAC"}

package/dist/audio/index.js

@@ -0,0 +1,24 @@
+// =============================================================================
+// Types
+// =============================================================================
+export { clamp01, createTraceId, DEFAULT_TARGET_AVO } from './types.js';
+// =============================================================================
+// Schemas
+// =============================================================================
+export { AudioProofSchema, validateAudioProof, AudioFormatSchema, VoiceLicenseCategorySchema, } from './schema.js';
+// =============================================================================
+// Planning
+// =============================================================================
+export { planSpeech, planSpeechFromCognition } from './planner.js';
+// =============================================================================
+// Overlay
+// =============================================================================
+export { DEFAULT_OVERLAY_PHRASES, pickOverlayPhrase } from './overlay.js';
+// =============================================================================
+// Providers
+// =============================================================================
+export { HttpSpeechSynthesisProvider } from './providers/httpSpeechSynthesisProvider.js';
+// =============================================================================
+// Hooks
+// =============================================================================
+export * from './hooks/index.js';

package/dist/audio/overlay.d.ts

@@ -0,0 +1,9 @@
+export type OverlayToken = 'ack' | 'hold' | 'done' | 'error' | 'warning';
+export type OverlayPhraseLibrary = Record<OverlayToken, string[]>;
+export declare const DEFAULT_OVERLAY_PHRASES: OverlayPhraseLibrary;
+export declare function pickOverlayPhrase(args: {
+    token: OverlayToken;
+    library?: Partial<OverlayPhraseLibrary>;
+    index?: number;
+}): string;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/audio/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/audio/overlay.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;AAElE,eAAO,MAAM,uBAAuB,EAAE,oBAMrC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAST"}

package/dist/audio/overlay.js

@@ -0,0 +1,15 @@
+export const DEFAULT_OVERLAY_PHRASES = {
+    ack: ['Got it.', 'Okay.', 'Understood.'],
+    hold: ['One moment.', 'Give me a second.', 'Hang on.'],
+    done: ['Done.', 'All set.', 'Finished.'],
+    error: ['I hit an error.', 'Something went wrong.', 'I ran into a problem.'],
+    warning: ['Careful.', 'Heads up.', 'Just a note.'],
+};
+export function pickOverlayPhrase(args) {
+    const { token, library, index = 0 } = args;
+    const phrases = library?.[token] ?? DEFAULT_OVERLAY_PHRASES[token];
+    if (!phrases || phrases.length === 0) {
+        return DEFAULT_OVERLAY_PHRASES[token][0];
+    }
+    return phrases[index % phrases.length] ?? phrases[0];
+}

package/dist/audio/planner.d.ts

@@ -0,0 +1,51 @@
+import type { AVO } from '../emotion/types.js';
+import type { CognitionState } from '../cognition/types.js';
+import type { AudioPolicy, AudioPlannerMode, SpeechSynthesisRequest, VoiceCatalog } from './types.js';
+export interface AudioPlannerSignals {
+    mode?: AudioPlannerMode;
+    personaDriftRisk?: number;
+    confidence?: number;
+    risk?: number;
+}
+export interface AudioPlannerInput {
+    text: string;
+    language?: string;
+    runId?: string;
+    targetAffect?: AVO;
+    policy: AudioPolicy;
+    voices: VoiceCatalog;
+    signals?: AudioPlannerSignals;
+    defaults?: {
+        voiceId?: string;
+        groundedVoiceTag?: string;
+        defaultVoiceTag?: string;
+        temperature?: number;
+    };
+}
+/**
+ * Default planner for Architecture A (modular pipeline).
+ *
+ * Produces a `SpeechSynthesisRequest` that a self-hosted backend can execute.
+ */
+export declare function planSpeech(input: AudioPlannerInput): SpeechSynthesisRequest;
+export interface AudioPlannerCognitionInput {
+    text: string;
+    language?: string;
+    runId?: string;
+    targetAffect?: AVO;
+    cognition: CognitionState;
+    policy: AudioPolicy;
+    voices: VoiceCatalog;
+    defaults?: {
+        voiceId?: string;
+        groundedVoiceTag?: string;
+        defaultVoiceTag?: string;
+        temperature?: number;
+    };
+}
+/**
+ * Plan speech from full CognitionState.
+ * Extracts relevant signals and delegates to planSpeech.
+ */
+export declare function planSpeechFromCognition(input: AudioPlannerCognitionInput): SpeechSynthesisRequest;
+//# sourceMappingURL=planner.d.ts.map

package/dist/audio/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/audio/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAEhB,sBAAsB,EACtB,YAAY,EACb,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY,CAAC,EAAE,GAAG,CAAC;IAEnB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IAErB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AA4DD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,sBAAsB,CAyE3E;AAMD,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,0BAA0B,GAChC,sBAAsB,CAiBxB"}

package/dist/audio/planner.js

@@ -0,0 +1,122 @@
+import { clamp01, createTraceId, DEFAULT_TARGET_AVO } from './types.js';
+// =============================================================================
+// Planning Helpers
+// =============================================================================
+function pickFirstAllowedVoiceId(voices, allowedVoiceIds) {
+    const list = voices.list();
+    for (const entry of list) {
+        if (!allowedVoiceIds || allowedVoiceIds.includes(entry.voiceId)) {
+            return entry.voiceId;
+        }
+    }
+    return null;
+}
+function pickVoiceId(args) {
+    const { voices, allowedVoiceIds, preferredVoiceId, requiredTag } = args;
+    if (preferredVoiceId) {
+        const entry = voices.get(preferredVoiceId);
+        if (entry && (!allowedVoiceIds || allowedVoiceIds.includes(entry.voiceId))) {
+            if (!requiredTag || (entry.tags ?? []).includes(requiredTag)) {
+                return entry.voiceId;
+            }
+        }
+    }
+    for (const entry of voices.list()) {
+        if (allowedVoiceIds && !allowedVoiceIds.includes(entry.voiceId))
+            continue;
+        if (requiredTag && !(entry.tags ?? []).includes(requiredTag))
+            continue;
+        return entry.voiceId;
+    }
+    return null;
+}
+function stripExcessPunctuation(text) {
+    return (text
+        // Collapse repeated punctuation which can cause prosody weirdness.
+        .replace(/[!?]{2,}/g, (m) => m[0] ?? '!')
+        .replace(/\.{3,}/g, '…'));
+}
+function clampTextForSafetyMode(text) {
+    // Keep semantics unchanged; only reduce overly-emphatic punctuation.
+    return stripExcessPunctuation(text).replace(/!/g, '.');
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Default planner for Architecture A (modular pipeline).
+ *
+ * Produces a `SpeechSynthesisRequest` that a self-hosted backend can execute.
+ */
+export function planSpeech(input) {
+    const { text, language, runId, targetAffect, policy, voices, signals, defaults, } = input;
+    const personaDriftRisk = clamp01(signals?.personaDriftRisk ?? 0);
+    const confidence = clamp01(signals?.confidence ?? 0.8);
+    const risk = clamp01(signals?.risk ?? (1 - confidence));
+    const groundedVoiceTag = defaults?.groundedVoiceTag ?? 'grounded';
+    const defaultVoiceTag = defaults?.defaultVoiceTag ?? 'default';
+    const requireGrounded = policy.safetyMode || personaDriftRisk >= 0.6 || (risk >= 0.7 && confidence <= 0.5);
+    const voiceId = (requireGrounded
+        ? pickVoiceId({
+            voices,
+            allowedVoiceIds: policy.allowedVoiceIds,
+            preferredVoiceId: defaults?.voiceId,
+            requiredTag: groundedVoiceTag,
+        })
+        : pickVoiceId({
+            voices,
+            allowedVoiceIds: policy.allowedVoiceIds,
+            preferredVoiceId: defaults?.voiceId,
+            requiredTag: defaultVoiceTag,
+        })) ??
+        pickVoiceId({
+            voices,
+            allowedVoiceIds: policy.allowedVoiceIds,
+            preferredVoiceId: defaults?.voiceId,
+        }) ??
+        pickFirstAllowedVoiceId(voices, policy.allowedVoiceIds);
+    if (!voiceId) {
+        throw new Error('No available voices (voice catalog is empty or policy blocks all voices)');
+    }
+    const baseTemperature = clamp01(defaults?.temperature ?? 0.65);
+    const temperature = requireGrounded ? Math.min(baseTemperature, 0.25) : baseTemperature;
+    const controls = {
+        temperature,
+    };
+    const plannedText = policy.safetyMode || personaDriftRisk >= 0.7
+        ? clampTextForSafetyMode(text)
+        : stripExcessPunctuation(text);
+    return {
+        traceId: createTraceId(),
+        runId,
+        text: plannedText,
+        language,
+        voiceId,
+        targetAffect: targetAffect ?? DEFAULT_TARGET_AVO,
+        controls,
+        policy: {
+            safetyMode: policy.safetyMode,
+            trustTier: policy.trustTier,
+            voiceCloningAllowed: policy.voiceCloningAllowed,
+        },
+    };
+}
+/**
+ * Plan speech from full CognitionState.
+ * Extracts relevant signals and delegates to planSpeech.
+ */
+export function planSpeechFromCognition(input) {
+    const { cognition, ...rest } = input;
+    const signals = {
+        mode: cognition.mode,
+        personaDriftRisk: cognition.personaDriftRisk,
+        confidence: cognition.confidence,
+        risk: cognition.risk,
+    };
+    const targetAffect = rest.targetAffect ?? cognition.emotionAVO;
+    return planSpeech({
+        ...rest,
+        targetAffect,
+        signals,
+    });
+}

package/dist/audio/providers/httpSpeechSynthesisProvider.d.ts

@@ -0,0 +1,33 @@
+import type { AudioArtifact, AudioProof, SpeechSynthesisProvider, SpeechSynthesisRequest, SpeechSynthesisResult } from '../types.js';
+export interface HttpSpeechSynthesisProviderOptions {
+    baseUrl: string;
+    headers?: Record<string, string>;
+    /**
+     * Endpoint path for synthesis.
+     *
+     * Expected behavior:
+     * - Returns JSON containing:
+     *   - `audioBase64` (optional) OR `audioUrl` (optional)
+     *   - `artifact` (required): { id, format, sha256, durationMs, ... }
+     *   - `proof` (optional): AudioProof (validated if present)
+     */
+    synthPath?: string;
+}
+export interface HttpSynthesisResponse {
+    audioBase64?: string;
+    audioUrl?: string;
+    artifact: AudioArtifact;
+    proof?: AudioProof;
+}
+export declare class HttpSpeechSynthesisProvider implements SpeechSynthesisProvider {
+    readonly providerId = "http";
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly synthPath;
+    constructor(options: HttpSpeechSynthesisProviderOptions);
+    synthesizeSpeech(request: SpeechSynthesisRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<SpeechSynthesisResult>;
+    private resolveAudio;
+}
+//# sourceMappingURL=httpSpeechSynthesisProvider.d.ts.map

package/dist/audio/providers/httpSpeechSynthesisProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSpeechSynthesisProvider.d.ts","sourceRoot":"","sources":["../../../src/audio/providers/httpSpeechSynthesisProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAMrI,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAMD,qBAAa,2BAA4B,YAAW,uBAAuB;IACzE,SAAgB,UAAU,UAAU;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,kCAAkC;IAMjD,gBAAgB,CACpB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,qBAAqB,CAAC;YAiDnB,YAAY;CAiC3B"}

package/dist/audio/providers/httpSpeechSynthesisProvider.js

@@ -0,0 +1,83 @@
+import { validateAudioProof } from '../schema.js';
+// =============================================================================
+// Provider
+// =============================================================================
+export class HttpSpeechSynthesisProvider {
+    providerId = 'http';
+    baseUrl;
+    headers;
+    synthPath;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.headers = options.headers ?? {};
+        this.synthPath = options.synthPath ?? '/v1/tts';
+    }
+    async synthesizeSpeech(request, options) {
+        const response = await fetch(`${this.baseUrl}${this.synthPath}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.headers,
+            },
+            body: JSON.stringify(request),
+            signal: options?.signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`TTS request failed: HTTP ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`);
+        }
+        const contentType = response.headers.get('content-type') ?? '';
+        // Allow audio responses directly (e.g. audio/wav). Artifact/proof are then unknown.
+        if (contentType.startsWith('audio/') || contentType === 'application/octet-stream') {
+            throw new Error('TTS endpoint returned raw audio bytes; bb-ui requires a JSON response with artifact metadata for verification-first operation');
+        }
+        const payload = (await response.json());
+        if (!payload?.artifact?.id || !payload?.artifact?.sha256 || !payload?.artifact?.durationMs) {
+            throw new Error('TTS endpoint response missing required `artifact` fields');
+        }
+        const audio = await this.resolveAudio(payload);
+        let proof = payload.proof;
+        if (proof) {
+            const parsed = validateAudioProof(proof);
+            if (!parsed.success) {
+                throw new Error('Invalid AudioProof from TTS endpoint');
+            }
+            proof = parsed.data;
+        }
+        return {
+            audio,
+            artifact: payload.artifact,
+            proof,
+        };
+    }
+    async resolveAudio(payload) {
+        if (payload.audioBase64) {
+            const bytes = typeof atob !== 'undefined'
+                ? (() => {
+                    const byteString = atob(payload.audioBase64 ?? '');
+                    const arr = new Uint8Array(byteString.length);
+                    for (let i = 0; i < byteString.length; i++) {
+                        arr[i] = byteString.charCodeAt(i);
+                    }
+                    return arr;
+                })()
+                : (() => {
+                    const BufferCtor = globalThis
+                        .Buffer;
+                    if (!BufferCtor) {
+                        throw new Error('Base64 decoding is not supported in this environment');
+                    }
+                    return Uint8Array.from(BufferCtor.from(payload.audioBase64, 'base64'));
+                })();
+            return new Blob([bytes], { type: 'audio/wav' });
+        }
+        if (payload.audioUrl) {
+            const res = await fetch(payload.audioUrl);
+            if (!res.ok) {
+                throw new Error(`Failed to fetch audioUrl: HTTP ${res.status}`);
+            }
+            return await res.blob();
+        }
+        throw new Error('TTS endpoint response missing `audioBase64` or `audioUrl`');
+    }
+}