@leiboss/dsh-tts 0.0.0-stage → 0.3.0

package/dist/fallback.js

@@ -0,0 +1,89 @@
+import { ErrorCode, TtsError } from "./errors.js";
+import { isSapiSupported, synthesizeSapi, } from "./sapi-tts.js";
+/** Codes that mean "the engine failed", not "the request is invalid". */
+const FALLBACK_ELIGIBLE = new Set([
+    ErrorCode.EdgeTtsNotFound,
+    ErrorCode.SpawnEperm,
+    ErrorCode.SpawnFailed,
+    ErrorCode.EdgeTtsFailed,
+    ErrorCode.SynthesisTimeout,
+    ErrorCode.EmptyAudio,
+]);
+/** Whether a failed Edge-TTS attempt is worth retrying with another engine. */
+export function isFallbackEligible(error) {
+    return error instanceof TtsError && FALLBACK_ELIGIBLE.has(error.code);
+}
+/** Reason recorded when the health circuit skips an engine. */
+export const SKIPPED_BY_HEALTH = 'skipped: circuit open (cooldown)';
+function describe(error) {
+    if (error instanceof TtsError)
+        return `${error.code}: ${error.detail}`;
+    return error instanceof Error ? error.message : String(error);
+}
+function allFailed(order, attempts, primaryError) {
+    const reasons = attempts
+        .map((attempt) => `${attempt.engine} (${attempt.reason})`)
+        .join('; ');
+    return new TtsError(ErrorCode.AllFallbacksFailed, `All configured TTS fallbacks failed. Chain: ${order.join(' -> ')}. Tried: ${reasons}. Engines: ${JSON.stringify(order)}.`, 'Install edge-tts and restore network access, or include `speechSynthesis` in `fallbackOrder`.', { cause: primaryError });
+}
+/**
+ * Run the configured engines after Edge-TTS already failed. `edge-tts` in
+ * `fallbackOrder` marks the primary attempt rather than a retry.
+ */
+export async function runFallback(options, deps = {}) {
+    const platform = deps.platform ?? process.platform;
+    const sapiImpl = deps.synthesizeSapiImpl ?? synthesizeSapi;
+    const attempts = [
+        {
+            engine: 'edge-tts',
+            reason: options.primaryReason ??
+                `primary engine failed: ${describe(options.primaryError)}`,
+        },
+    ];
+    // Local array narrowing keeps the literal union readable in the loop.
+    const order = options.fallbackOrder;
+    for (const engine of order) {
+        if (engine === 'edge-tts')
+            continue;
+        if (options.skip?.has(engine)) {
+            attempts.push({ engine, reason: SKIPPED_BY_HEALTH });
+            continue;
+        }
+        if (engine === 'sapi') {
+            if (!isSapiSupported(platform)) {
+                attempts.push({ engine, reason: `skipped: SAPI is Windows-only (${platform})` });
+                continue;
+            }
+            try {
+                const audio = await sapiImpl(options.text, {
+                    rate: options.rate,
+                    outputDir: options.outputDir,
+                    hash: options.hash,
+                    timeoutMs: options.timeoutMs,
+                    signal: options.signal,
+                    spawnImpl: deps.spawnImpl,
+                    now: options.now,
+                    platform,
+                    powershellBinary: deps.powershellBinary,
+                    ffmpegBinary: deps.ffmpegBinary,
+                });
+                const engineState = deps.health?.stateOf(engine) ?? 'healthy';
+                deps.health?.recordSuccess(engine);
+                attempts.push({ engine, reason: 'succeeded' });
+                return { kind: 'audio', audio, engine, engineState, attempts };
+            }
+            catch (error) {
+                if (error instanceof TtsError && error.code === ErrorCode.Aborted)
+                    throw error;
+                deps.health?.recordFailure(engine, error);
+                attempts.push({ engine, reason: describe(error) });
+                continue;
+            }
+        }
+        if (engine === 'speechSynthesis') {
+            return { kind: 'speechSynthesis', engine: 'speechSynthesis', attempts };
+        }
+    }
+    throw allFailed(order, attempts, options.primaryError);
+}
+//# sourceMappingURL=fallback.js.map

package/dist/fallback.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * DSH tool plugin: text in, a durable audio file out.
+ *
+ * The plugin owns exactly one capability — Edge-TTS synthesis into
+ * `$DSH_HOME/tts-output` — and exposes it through `tts_generate` plus a
+ * side-effect-free `tts_self_check`. It deliberately implements no playback,
+ * transcription, voice cloning, or multi-provider routing.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
+import { type AudioUrlProvider } from './audio-route.ts';
+import { ConcurrencyLimiter } from './concurrency.ts';
+import { type ResolvedConfig, type TtsConfig } from './config.ts';
+import { type SpawnFunction, type SynthesizedAudio } from './edge-tts.ts';
+import type { SapiOptions } from './sapi-tts.ts';
+import { type ProbeConnector } from './probe.ts';
+export { Config } from './config.ts';
+export type { TtsConfig } from './config.ts';
+export { resolveConfig, DEFAULT_ENGINE, type TtsEngineKind } from './config.ts';
+export { TtsService } from './service.ts';
+export type { TtsAudioResult, TtsCapabilities, TtsDoctorReport, TtsProbeReport, TtsRequest, TtsResult, TtsServiceDeps, TtsSpeechResult, } from './service.ts';
+export type { TTSProvider, SynthesizeOptions, SynthesizeResult, } from './provider.ts';
+export { ErrorCode, TtsError } from './errors.ts';
+export { cacheKey, findCachedFile } from './cache.ts';
+export { runProcess, synthesize } from './edge-tts.ts';
+export { selfCheck } from './self-check.ts';
+export { AUDIO_ROUTE_PREFIX, AudioRoute } from './audio-route.ts';
+export { DEFAULT_CHUNK_SIZE, splitText } from './chunker.ts';
+export { synthesizeChunked } from './chunked-tts.ts';
+export { ConcurrencyLimiter, type ConcurrencyLimits } from './concurrency.ts';
+export { isFallbackEligible, runFallback } from './fallback.ts';
+export { isSapiSupported, sapiRate, synthesizeSapi } from './sapi-tts.ts';
+export { AVAILABLE_VOICES, VOICES, type VoiceInfo } from './voices.ts';
+export declare const name = "dsh-tts";
+/** The registry must exist before `apply` runs. */
+export declare const inject: string[];
+/** Pitch Edge-TTS uses when the call omits one. */
+export declare const DEFAULT_PITCH = "+0Hz";
+/** Volume Edge-TTS uses when the call omits one. */
+export declare const DEFAULT_VOLUME = "+0%";
+/** Injection points used by tests; production always uses the defaults. */
+export interface TtsDependencies {
+    spawnImpl?: SpawnFunction;
+    now?: () => Date;
+    /** Present when a web route was registered; enables `browserUrl`. */
+    audioRoute?: AudioUrlProvider;
+    /** Override the pause between chunk subprocesses (tests use 0). */
+    chunkDelayMs?: number;
+    /** Platform override, so non-Windows tests can exercise the SAPI branch. */
+    platform?: NodeJS.Platform;
+    /** Injected SAPI implementation; defaults to the real PowerShell path. */
+    sapiSynthesize?: (text: string, options: SapiOptions) => Promise<SynthesizedAudio>;
+    powershellBinary?: string;
+    ffmpegBinary?: string;
+    /** Inject a limiter to share one capacity pool across tool instances. */
+    limiter?: ConcurrencyLimiter;
+    /** Debug sink for fallback timing; never receives call arguments. */
+    log?: (message: string) => void;
+    /** Injected TCP connector for `tts_probe_network`; tests use a local server. */
+    probeConnect?: ProbeConnector;
+}
+/**
+ * Build both tool definitions from one resolved config. Exported so tests can
+ * exercise the real `execute` bodies with an injected spawn implementation.
+ */
+export declare function createTtsTools(config: ResolvedConfig, deps?: TtsDependencies): ToolDefinition[];
+/**
+ * Mount both tools. Registration is fiber-owned, so unloading the plugin
+ * unregisters them without explicit cleanup.
+ */
+export declare function apply(ctx: Context, config?: Partial<TtsConfig>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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