@leiboss/dsh-tts 0.0.0-stage → 0.2.1

package/dist/chunked-tts.js

@@ -0,0 +1,121 @@
+/**
+ * Serial chunked synthesis for long texts.
+ *
+ * Every chunk goes through the existing Edge-TTS path into a private temp
+ * directory, in order, one subprocess at a time. The finished MP3 files are
+ * concatenated byte-for-byte (MP3 frame streams allow this) and the result is
+ * published atomically at the normal cache path, so the cache key remains the
+ * hash of the full original text.
+ */
+import { mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { AUDIO_FORMAT, outputFilePath } from "./cache.js";
+import { DEFAULT_TOTAL_TIMEOUT_MS } from "./config.js";
+import { splitText } from "./chunker.js";
+import { synthesize, } from "./edge-tts.js";
+import { ErrorCode, TtsError } from "./errors.js";
+/** Pause between chunk subprocesses so Edge-TTS is not rate-limited. */
+export const DEFAULT_INTER_CHUNK_DELAY_MS = 200;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function chunkFailure(index, total, error) {
+    if (error instanceof TtsError) {
+        return new TtsError(error.code, `Chunk ${index + 1}/${total} failed: ${error.detail}`, error.suggestion, { cause: error });
+    }
+    const detail = error instanceof Error ? error.message : String(error);
+    return new TtsError(ErrorCode.EdgeTtsFailed, `Chunk ${index + 1}/${total} failed: ${detail}`, 'Retry the call; if it persists, run `tts_self_check` and inspect Edge-TTS output.', { cause: error });
+}
+function publishFailure(target, error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return new TtsError(ErrorCode.OutputDirNotWritable, `Cannot write the concatenated audio file ${target}: ${detail}`, 'Check the DSH sandbox file policy and the output directory permissions.', { cause: error });
+}
+function overallTimeout(totalTimeoutMs, index, total) {
+    return new TtsError(ErrorCode.SynthesisTimeout, `Overall synthesis deadline of ${totalTimeoutMs} ms was exceeded before chunk ${index + 1}/${total}.`, 'Increase `totalTimeoutMs`, shorten the text, or raise `chunkSize`.');
+}
+/**
+ * Synthesize `text` chunk by chunk and return one concatenated MP3. Callers
+ * only use this above the chunk threshold; calling it with one chunk simply
+ * delegates to the one-shot path.
+ */
+export async function synthesizeChunked(text, options) {
+    const chunks = splitText(text, options.chunkSize);
+    const base = {
+        voice: options.voice,
+        rate: options.rate,
+        pitch: options.pitch,
+        volume: options.volume,
+        proxy: options.proxy,
+        binary: options.binary,
+        timeoutMs: options.timeoutMs,
+        signal: options.signal,
+        spawnImpl: options.spawnImpl,
+    };
+    if (chunks.length <= 1) {
+        return synthesize(text, {
+            ...base,
+            outputDir: options.outputDir,
+            hash: options.hash,
+            now: options.now,
+        });
+    }
+    const delayMs = options.interChunkDelayMs ?? DEFAULT_INTER_CHUNK_DELAY_MS;
+    const delay = options.delay ?? sleep;
+    const tempDir = await mkdtemp(join(tmpdir(), 'dsh-tts-chunks-'));
+    const baseTime = (options.now ?? new Date()).getTime();
+    const totalTimeoutMs = options.totalTimeoutMs ?? DEFAULT_TOTAL_TIMEOUT_MS;
+    const deadline = Date.now() + totalTimeoutMs;
+    try {
+        const buffers = [];
+        for (let index = 0; index < chunks.length; index += 1) {
+            if (options.signal?.aborted) {
+                throw new TtsError(ErrorCode.Aborted, 'Chunked synthesis was aborted.');
+            }
+            if (Date.now() >= deadline) {
+                throw overallTimeout(totalTimeoutMs, index, chunks.length);
+            }
+            if (index > 0 && delayMs > 0)
+                await delay(delayMs);
+            if (Date.now() >= deadline) {
+                throw overallTimeout(totalTimeoutMs, index, chunks.length);
+            }
+            const remaining = deadline - Date.now();
+            try {
+                const part = await synthesize(chunks[index] ?? '', {
+                    ...base,
+                    timeoutMs: Math.max(1, Math.min(options.timeoutMs, remaining)),
+                    outputDir: tempDir,
+                    hash: `part-${index}`,
+                    now: new Date(baseTime + index),
+                });
+                buffers.push(await readFile(part.filePath));
+            }
+            catch (error) {
+                if (Date.now() >= deadline) {
+                    throw overallTimeout(totalTimeoutMs, index, chunks.length);
+                }
+                throw chunkFailure(index, chunks.length, error);
+            }
+        }
+        const bytes = Buffer.concat(buffers);
+        if (bytes.length === 0) {
+            throw new TtsError(ErrorCode.EmptyAudio, 'Chunked synthesis produced no audio bytes.', 'Retry the call; if it persists, run `tts_self_check`.');
+        }
+        const target = outputFilePath(options.outputDir, options.hash, options.now);
+        try {
+            await mkdir(dirname(target), { recursive: true });
+            const partial = `${target}.partial`;
+            await writeFile(partial, bytes);
+            await rename(partial, target);
+        }
+        catch (error) {
+            throw publishFailure(target, error);
+        }
+        return { filePath: target, format: AUDIO_FORMAT };
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true }).catch(() => { });
+    }
+}
+//# sourceMappingURL=chunked-tts.js.map

package/dist/chunked-tts.js.map

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

package/dist/chunker.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure text chunking for long synthesis requests.
+ *
+ * Splitting happens on code points, so a surrogate pair is never cut in half,
+ * and the cut point prefers sentence punctuation, then newlines, then softer
+ * separators such as commas and spaces. The module has no I/O and no
+ * subprocess dependency, which keeps it directly testable.
+ */
+/** Target characters per chunk; also the one-shot threshold. */
+export declare const DEFAULT_CHUNK_SIZE = 1200;
+/** Count Unicode code points rather than UTF-16 code units. */
+export declare function countCharacters(text: string): number;
+/**
+ * Split `text` into chunks of at most `chunkSize` characters, cutting at the
+ * latest sentence boundary in each window when one exists. Whitespace at a
+ * chunk edge is trimmed; otherwise every character is preserved.
+ */
+export declare function splitText(text: string, chunkSize?: number): string[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,OAAQ,CAAA;AAiBvC,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAeD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAA2B,GACrC,MAAM,EAAE,CAgDV"}

package/dist/chunker.js

@@ -0,0 +1,98 @@
+/**
+ * Pure text chunking for long synthesis requests.
+ *
+ * Splitting happens on code points, so a surrogate pair is never cut in half,
+ * and the cut point prefers sentence punctuation, then newlines, then softer
+ * separators such as commas and spaces. The module has no I/O and no
+ * subprocess dependency, which keeps it directly testable.
+ */
+/** Target characters per chunk; also the one-shot threshold. */
+export const DEFAULT_CHUNK_SIZE = 1_200;
+/** A cut is only taken before this fraction of the window when possible. */
+const MIN_FILL_RATIO = 0.5;
+const HARD_SENTENCE = new Set(['。', '！', '？', '；', '!', '?', ';']);
+const SOFT_BREAK = new Set([
+    '，',
+    '、',
+    '：',
+    ',',
+    ':',
+    ' ',
+    '\t',
+    '\u3000',
+]);
+/** Count Unicode code points rather than UTF-16 code units. */
+export function countCharacters(text) {
+    return Array.from(text).length;
+}
+function isSentenceBreak(chars, index) {
+    const char = chars[index];
+    if (char === undefined)
+        return false;
+    if (char === '\n' || HARD_SENTENCE.has(char))
+        return true;
+    // A full stop only ends a sentence when followed by whitespace or the end;
+    // this keeps `3.14` and file names together.
+    if (char === '.') {
+        const next = chars[index + 1];
+        return next === undefined || /\s/.test(next);
+    }
+    return false;
+}
+/**
+ * Split `text` into chunks of at most `chunkSize` characters, cutting at the
+ * latest sentence boundary in each window when one exists. Whitespace at a
+ * chunk edge is trimmed; otherwise every character is preserved.
+ */
+export function splitText(text, chunkSize = DEFAULT_CHUNK_SIZE) {
+    if (!Number.isInteger(chunkSize) || chunkSize <= 0) {
+        throw new RangeError(`chunkSize must be a positive integer, got ${chunkSize}`);
+    }
+    const chars = Array.from(text);
+    if (chars.length === 0)
+        return [];
+    if (chars.length <= chunkSize)
+        return [text];
+    const minFill = Math.max(1, Math.floor(chunkSize * MIN_FILL_RATIO));
+    const chunks = [];
+    let start = 0;
+    while (start < chars.length) {
+        if (chars.length - start <= chunkSize) {
+            const tail = chars.slice(start).join('').trim();
+            if (tail.length > 0)
+                chunks.push(tail);
+            break;
+        }
+        const limit = start + chunkSize;
+        let sentence = -1;
+        let soft = -1;
+        for (let index = start; index < limit; index += 1) {
+            if (isSentenceBreak(chars, index))
+                sentence = index + 1;
+            else if (SOFT_BREAK.has(chars[index] ?? ''))
+                soft = index + 1;
+        }
+        let cut;
+        if (sentence >= start + minFill) {
+            cut = sentence;
+        }
+        else if (soft >= start + minFill) {
+            cut = soft;
+        }
+        else if (sentence > start) {
+            cut = sentence;
+        }
+        else if (soft > start) {
+            cut = soft;
+        }
+        else {
+            cut = limit;
+        }
+        const piece = chars.slice(start, cut).join('').trim();
+        if (piece.length > 0)
+            chunks.push(piece);
+        start = cut;
+    }
+    return chunks;
+}
+//# sourceMappingURL=chunker.js.map

package/dist/chunker.js.map

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

package/dist/client.js

@@ -0,0 +1,90 @@
+/**
+ * Browser half of the plugin: a keyed `tool.call.toolview` for `tts_generate`.
+ *
+ * The Host serves this file as the `exports["./client"]` bundle, so it must stay
+ * in the lazy-CJS module-loader format: executing the script only registers the
+ * factory, and the factory runs (with the shared `require`) on first import.
+ *
+ * `block` is either the running call node or the settled `ToolResultNode`. The
+ * result node exposes the model-facing `content` blocks and an optional host
+ * `meta`, not the structured tool return value, so the playback URL is taken
+ * from the rendered text that `tts_generate` always emits.
+ */
+
+window.__ModuleLoader__.load({
+  id: '@leiboss/dsh-tts',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+
+    const react = require('react')
+    const h = react.createElement
+
+    /** Same-origin playback path; stops at markup, quotes and whitespace. */
+    const AUDIO_URL = /\/dsh-tts\/audio\/[^\s)"'<>`\]]+/g
+
+    /**
+     * Collect the playback URLs rendered into one tool result.
+     * @param {readonly { text?: string }[] | undefined} blocks
+     * @returns {string[]}
+     */
+    function extractAudioUrls(blocks) {
+      /** @type {string[]} */
+      const urls = []
+      for (const block of blocks ?? []) {
+        if (typeof block !== 'object' || block === null) continue
+        if (typeof block.text !== 'string') continue
+        const matches = block.text.match(AUDIO_URL)
+        if (matches === null) continue
+        for (const url of matches) if (!urls.includes(url)) urls.push(url)
+      }
+      return urls
+    }
+
+    /**
+     * Inline player for the settled result; renders nothing while the call is
+     * still running or when no playback URL was produced (non-Web hosts,
+     * speechSynthesis fallback, route registration skipped).
+     * @param {{ block?: unknown }} props
+     */
+    function TtsAudioView(props) {
+      const block = props?.block
+      if (typeof block !== 'object' || block === null) return null
+      if ('name' in block) return null
+      const urls = extractAudioUrls(
+        /** @type {{ content?: { text?: string }[] }} */ (block).content,
+      )
+      if (urls.length === 0) return null
+      return h(
+        'div',
+        { style: { width: '100%' } },
+        urls.map((url) =>
+          h('audio', {
+            key: url,
+            controls: true,
+            preload: 'none',
+            src: url,
+            'aria-label': '播放',
+            style: { width: '100%' },
+          }),
+        ),
+      )
+    }
+
+    function apply(ctx) {
+      ctx.slots.inject('tool.call.toolview', function* () {
+        yield ctx.slots.register(
+          { name: 'tool.call.toolview', key: 'tts_generate' },
+          TtsAudioView,
+        )
+      })
+    }
+
+    exports.apply = apply
+    exports.inject = ['slots']
+    exports.extractAudioUrls = extractAudioUrls
+    exports.TtsAudioView = TtsAudioView
+    return module.exports
+  },
+})

package/dist/concurrency.d.ts

@@ -0,0 +1,33 @@
+/** Limits resolved from plugin config. */
+export interface ConcurrencyLimits {
+    maxConcurrent: number;
+    queueSize: number;
+    queueTimeoutMs: number;
+}
+/** Observable capacity, surfaced in TTS_BUSY messages. */
+export interface LimiterStats {
+    running: number;
+    queued: number;
+}
+/**
+ * Counting semaphore with a bounded FIFO wait queue. Every mutation happens
+ * synchronously, so slot hand-off cannot leak capacity between tasks.
+ */
+export declare class ConcurrencyLimiter {
+    private running;
+    private readonly waiters;
+    private readonly limits;
+    constructor(limits: ConcurrencyLimits);
+    /** Current capacity snapshot. */
+    get stats(): LimiterStats;
+    /** Run `task` in a slot, waiting for capacity up to `queueTimeoutMs`. */
+    run<T>(task: () => Promise<T>, signal?: AbortSignal): Promise<T>;
+    private acquire;
+    /** Remove a waiter and release its timer/listener; safe to call twice. */
+    private remove;
+    /** Free a slot and hand it directly to the oldest waiter. */
+    private release;
+    /** Structured capacity error; never includes call arguments. */
+    private busy;
+}
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../src/concurrency.ts"],"names":[],"mappings":"AAUA,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAUD;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,EAAE,iBAAiB;IAIrC,iCAAiC;IACjC,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,yEAAyE;IACnE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAStE,OAAO,CAAC,OAAO;IA8Cf,0EAA0E;IAC1E,OAAO,CAAC,MAAM;IASd,6DAA6D;IAC7D,OAAO,CAAC,OAAO;IAYf,gEAAgE;IAChE,OAAO,CAAC,IAAI;CAQb"}

package/dist/concurrency.js

@@ -0,0 +1,95 @@
+/**
+ * Lightweight bulkhead for synthesis tasks.
+ *
+ * A slot wraps one complete request: cache lookup, chunked serial synthesis,
+ * and any fallback engine. Chunks share their caller's slot, so a long text
+ * never consumes more than one slot. Cache hits are filtered before `run`, so
+ * they never queue.
+ */
+import { ErrorCode, TtsError } from "./errors.js";
+/**
+ * Counting semaphore with a bounded FIFO wait queue. Every mutation happens
+ * synchronously, so slot hand-off cannot leak capacity between tasks.
+ */
+export class ConcurrencyLimiter {
+    running = 0;
+    waiters = [];
+    limits;
+    constructor(limits) {
+        this.limits = limits;
+    }
+    /** Current capacity snapshot. */
+    get stats() {
+        return { running: this.running, queued: this.waiters.length };
+    }
+    /** Run `task` in a slot, waiting for capacity up to `queueTimeoutMs`. */
+    async run(task, signal) {
+        await this.acquire(signal);
+        try {
+            return await task();
+        }
+        finally {
+            this.release();
+        }
+    }
+    acquire(signal) {
+        if (signal?.aborted) {
+            return Promise.reject(new TtsError(ErrorCode.Aborted, 'Synthesis was aborted before it started.'));
+        }
+        if (this.running < this.limits.maxConcurrent) {
+            this.running += 1;
+            return Promise.resolve();
+        }
+        if (this.waiters.length >= this.limits.queueSize) {
+            return Promise.reject(this.busy('the wait queue is full'));
+        }
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    this.remove(waiter);
+                    reject(this.busy('the queue wait timed out'));
+                }, this.limits.queueTimeoutMs),
+            };
+            if (signal) {
+                waiter.signal = signal;
+                waiter.onAbort = () => {
+                    this.remove(waiter);
+                    reject(new TtsError(ErrorCode.Aborted, 'Synthesis was aborted while waiting for a slot.'));
+                };
+                signal.addEventListener('abort', waiter.onAbort, { once: true });
+            }
+            this.waiters.push(waiter);
+        });
+    }
+    /** Remove a waiter and release its timer/listener; safe to call twice. */
+    remove(waiter) {
+        clearTimeout(waiter.timer);
+        if (waiter.onAbort) {
+            waiter.signal?.removeEventListener('abort', waiter.onAbort);
+        }
+        const index = this.waiters.indexOf(waiter);
+        if (index !== -1)
+            this.waiters.splice(index, 1);
+    }
+    /** Free a slot and hand it directly to the oldest waiter. */
+    release() {
+        this.running -= 1;
+        const next = this.waiters.shift();
+        if (!next)
+            return;
+        clearTimeout(next.timer);
+        if (next.onAbort) {
+            next.signal?.removeEventListener('abort', next.onAbort);
+        }
+        this.running += 1;
+        next.resolve();
+    }
+    /** Structured capacity error; never includes call arguments. */
+    busy(detail) {
+        const { running, queued } = this.stats;
+        return new TtsError(ErrorCode.TtsBusy, `TTS synthesis is busy: running=${running}, queued=${queued}, maxConcurrent=${this.limits.maxConcurrent}, queueSize=${this.limits.queueSize} (${detail}).`, 'Retry after the current syntheses finish, or raise `maxConcurrent` / `queueSize` in the plugin config.');
+    }
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/concurrency.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,133 @@
+import z from '@deepseek-ai/schemastery';
+/** Voice Edge-TTS uses when neither config nor the call specifies one. */
+export declare const DEFAULT_VOICE = "zh-CN-XiaoxiaoNeural";
+/** Rate Edge-TTS uses when the call omits one. */
+export declare const DEFAULT_RATE = "+0%";
+/** Per-synthesis subprocess deadline. */
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+/** CLI name resolved through PATH unless overridden. */
+export declare const DEFAULT_EDGE_TTS_BINARY = "edge-tts";
+/** Subdirectory of `DSH_HOME` that owns every generated audio file. */
+export declare const OUTPUT_SUBDIR = "tts-output";
+/** Target characters per chunk, and the one-shot threshold. */
+export declare const DEFAULT_CHUNK_SIZE = 1200;
+/** Long texts are chunked by default. */
+export declare const DEFAULT_CHUNKING_ENABLED = true;
+/** Engines the fallback chain understands, in default priority order. */
+export declare const DEFAULT_FALLBACK_ORDER: readonly ["edge-tts", "sapi", "speechSynthesis"];
+/** Fallback is enabled unless configured otherwise. */
+export declare const DEFAULT_FALLBACK_ENABLED = true;
+/** Syntheses allowed to run at the same time. */
+export declare const DEFAULT_MAX_CONCURRENT = 2;
+/** Callers allowed to wait for a synthesis slot. */
+export declare const DEFAULT_QUEUE_SIZE = 4;
+/** How long a caller may wait for a slot before TTS_BUSY. */
+export declare const DEFAULT_QUEUE_TIMEOUT_MS = 10000;
+/** Upper bound for one complete `tts_generate` call, across all chunks. */
+export declare const DEFAULT_TOTAL_TIMEOUT_MS = 180000;
+/** Extra Host names accepted by the audio route (reverse proxies). */
+export declare const DEFAULT_TRUSTED_HOSTS: readonly string[];
+/** One engine in the fallback chain. */
+export type TtsEngine = (typeof DEFAULT_FALLBACK_ORDER)[number];
+/** Narrow an arbitrary config string to a known engine. */
+export declare function isTtsEngine(value: string): value is TtsEngine;
+/**
+ * Config schema exposed to the DSH configuration layer. Defaults live here (not
+ * in call sites) so the settings surface and runtime behaviour agree.
+ */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    outputDir: z<string, string, "plain">;
+    defaultVoice: z<string, string, "defined">;
+    timeoutMs: z<number, number, "defined">;
+    edgeTtsBinary: z<string, string, "defined">;
+    chunkSize: z<number, number, "defined">;
+    chunkingEnabled: z<boolean, boolean, "defined">;
+    fallbackEnabled: z<boolean, boolean, "defined">;
+    fallbackOrder: z<string[], string[], "defined">;
+    maxConcurrent: z<number, number, "defined">;
+    queueSize: z<number, number, "defined">;
+    queueTimeoutMs: z<number, number, "defined">;
+    totalTimeoutMs: z<number, number, "defined">;
+    trustedHosts: z<string[], string[], "defined">;
+    proxy: z<string, string, "plain">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    outputDir: z<string, string, "plain">;
+    defaultVoice: z<string, string, "defined">;
+    timeoutMs: z<number, number, "defined">;
+    edgeTtsBinary: z<string, string, "defined">;
+    chunkSize: z<number, number, "defined">;
+    chunkingEnabled: z<boolean, boolean, "defined">;
+    fallbackEnabled: z<boolean, boolean, "defined">;
+    fallbackOrder: z<string[], string[], "defined">;
+    maxConcurrent: z<number, number, "defined">;
+    queueSize: z<number, number, "defined">;
+    queueTimeoutMs: z<number, number, "defined">;
+    totalTimeoutMs: z<number, number, "defined">;
+    trustedHosts: z<string[], string[], "defined">;
+    proxy: z<string, string, "plain">;
+}>>, "plain">;
+/** Config accepted by {@link apply}; every field is optional and defaulted. */
+export interface TtsConfig {
+    outputDir?: string;
+    defaultVoice?: string;
+    timeoutMs?: number;
+    edgeTtsBinary?: string;
+    chunkSize?: number;
+    chunkingEnabled?: boolean;
+    fallbackEnabled?: boolean;
+    fallbackOrder?: string[];
+    maxConcurrent?: number;
+    queueSize?: number;
+    queueTimeoutMs?: number;
+    totalTimeoutMs?: number;
+    trustedHosts?: string[];
+    /** HTTP proxy forwarded to edge-tts as `--proxy`; no env fallback. */
+    proxy?: string;
+}
+/** Effective, path-resolved plugin settings. */
+export interface ResolvedConfig {
+    /** Harness home from `DSH_HOME`; empty when unset. */
+    dshHome: string;
+    /** Absolute output root; falls back to `~/.dsh/tts-output`. */
+    outputDir: string;
+    defaultVoice: string;
+    timeoutMs: number;
+    edgeTtsBinary: string;
+    chunkSize: number;
+    chunkingEnabled: boolean;
+    fallbackEnabled: boolean;
+    /** Unknown engine names are dropped; order is preserved. */
+    fallbackOrder: TtsEngine[];
+    maxConcurrent: number;
+    queueSize: number;
+    queueTimeoutMs: number;
+    totalTimeoutMs: number;
+    trustedHosts: string[];
+    /** Undefined when unset; deliberately never read from the environment. */
+    proxy?: string;
+}
+/**
+ * Resolve config defaults without touching the filesystem. A missing
+ * `DSH_HOME` is not fatal here: explicit `outputDir` still works, and the
+ * self-check needs to report the missing value instead of failing to load.
+ */
+export declare function resolveConfig(raw?: Partial<TtsConfig>, env?: NodeJS.ProcessEnv): ResolvedConfig;
+/**
+ * Validate the settings a synthesis actually needs. Kept separate from
+ * {@link resolveConfig} so loading the plugin never fails at mount time.
+ */
+export declare function requireSynthesisConfig(config: ResolvedConfig): {
+    outputDir: string;
+    timeoutMs: number;
+    chunkSize: number;
+    chunkingEnabled: boolean;
+    fallbackEnabled: boolean;
+    fallbackOrder: TtsEngine[];
+    maxConcurrent: number;
+    queueSize: number;
+    queueTimeoutMs: number;
+    totalTimeoutMs: number;
+    trustedHosts: string[];
+    proxy?: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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