@mcptoolshop/voice-soundboard-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/ambient/emitter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AmbientEmitter — manages ephemeral inner-monologue entries.
+ *
+ * Features:
+ * - Global rate limiting (min interval between emissions)
+ * - Per-category cooldowns
+ * - FIFO buffer with max size
+ * - TTL-based expiry
+ * - Sensitive content redaction
+ */
+import type { AmbientCategory, AmbientConfig, AmbientEntry, AmbientResult } from "./types.js";
+export declare class AmbientEmitter {
+    private readonly config;
+    private readonly buffer;
+    private lastEmitTime;
+    private readonly categoryCooldowns;
+    constructor(config?: Partial<AmbientConfig>);
+    /** Whether the ambient system is enabled. */
+    get enabled(): boolean;
+    /** Current buffer contents (expired entries are pruned). */
+    get entries(): readonly AmbientEntry[];
+    /** Number of entries in the buffer. */
+    get size(): number;
+    /**
+     * Submit a thought for emission.
+     * Returns accepted entry or rejection reason.
+     */
+    emitThought(text: string, category?: AmbientCategory): AmbientResult;
+    /** Remove expired entries from the buffer. */
+    private pruneExpired;
+    /** Clear all entries and reset cooldowns. */
+    clear(): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/ambient/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/ambient/emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAYpB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;gBAE5D,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAI3C,6CAA6C;IAC7C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,4DAA4D;IAC5D,IAAI,OAAO,IAAI,SAAS,YAAY,EAAE,CAGrC;IAED,uCAAuC;IACvC,IAAI,IAAI,IAAI,MAAM,CAGjB;IAED;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,eAA2B,GAAG,aAAa;IAoE/E,8CAA8C;IAC9C,OAAO,CAAC,YAAY;IAYpB,6CAA6C;IAC7C,KAAK,IAAI,IAAI;CAKd"}

package/dist/ambient/emitter.js

@@ -0,0 +1,125 @@
+/**
+ * AmbientEmitter — manages ephemeral inner-monologue entries.
+ *
+ * Features:
+ * - Global rate limiting (min interval between emissions)
+ * - Per-category cooldowns
+ * - FIFO buffer with max size
+ * - TTL-based expiry
+ * - Sensitive content redaction
+ */
+import { randomUUID } from "node:crypto";
+import { redactSensitive } from "./redact.js";
+const DEFAULT_CONFIG = {
+    enabled: false,
+    globalCooldownMs: 10_000,
+    categoryCooldownMs: 15_000,
+    maxBufferSize: 5,
+    ttlMs: 60_000,
+    maxTextLength: 500,
+};
+export class AmbientEmitter {
+    config;
+    buffer = [];
+    lastEmitTime = 0;
+    categoryCooldowns = new Map();
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /** Whether the ambient system is enabled. */
+    get enabled() {
+        return this.config.enabled;
+    }
+    /** Current buffer contents (expired entries are pruned). */
+    get entries() {
+        this.pruneExpired();
+        return [...this.buffer];
+    }
+    /** Number of entries in the buffer. */
+    get size() {
+        this.pruneExpired();
+        return this.buffer.length;
+    }
+    /**
+     * Submit a thought for emission.
+     * Returns accepted entry or rejection reason.
+     */
+    emitThought(text, category = "general") {
+        if (!this.config.enabled) {
+            return { accepted: false, reason: "Ambient system is disabled", code: "AMBIENT_DISABLED" };
+        }
+        if (!text || !text.trim()) {
+            return { accepted: false, reason: "Empty text", code: "AMBIENT_EMPTY" };
+        }
+        // Enforce text length limit
+        const trimmed = text.trim();
+        if (trimmed.length > this.config.maxTextLength) {
+            return {
+                accepted: false,
+                reason: `Text exceeds max length (${this.config.maxTextLength} chars)`,
+                code: "AMBIENT_TOO_LONG",
+            };
+        }
+        // Check global rate limit
+        const now = Date.now();
+        if (now - this.lastEmitTime < this.config.globalCooldownMs) {
+            const waitMs = this.config.globalCooldownMs - (now - this.lastEmitTime);
+            return {
+                accepted: false,
+                reason: `Rate limited (global cooldown, ${Math.ceil(waitMs / 1000)}s remaining)`,
+                code: "AMBIENT_RATE_LIMITED",
+            };
+        }
+        // Check per-category cooldown
+        const lastCategorySend = this.categoryCooldowns.get(category) ?? 0;
+        if (now - lastCategorySend < this.config.categoryCooldownMs) {
+            const waitMs = this.config.categoryCooldownMs - (now - lastCategorySend);
+            return {
+                accepted: false,
+                reason: `Rate limited (${category} cooldown, ${Math.ceil(waitMs / 1000)}s remaining)`,
+                code: "AMBIENT_CATEGORY_COOLDOWN",
+            };
+        }
+        // Redact sensitive content
+        const { text: redactedText, redacted } = redactSensitive(trimmed);
+        // Create entry
+        const entry = {
+            id: randomUUID().slice(0, 8),
+            text: redactedText,
+            category,
+            createdAt: now,
+            expiresAt: now + this.config.ttlMs,
+            redacted,
+        };
+        // Add to buffer (FIFO eviction if full)
+        this.pruneExpired();
+        while (this.buffer.length >= this.config.maxBufferSize) {
+            this.buffer.shift();
+        }
+        this.buffer.push(entry);
+        // Update cooldowns
+        this.lastEmitTime = now;
+        this.categoryCooldowns.set(category, now);
+        return { accepted: true, entry };
+    }
+    /** Remove expired entries from the buffer. */
+    pruneExpired() {
+        const now = Date.now();
+        let i = 0;
+        while (i < this.buffer.length) {
+            if (this.buffer[i].expiresAt <= now) {
+                this.buffer.splice(i, 1);
+            }
+            else {
+                i++;
+            }
+        }
+    }
+    /** Clear all entries and reset cooldowns. */
+    clear() {
+        this.buffer.length = 0;
+        this.lastEmitTime = 0;
+        this.categoryCooldowns.clear();
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/ambient/emitter.js.map

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

package/dist/ambient/index.d.ts

@@ -0,0 +1,5 @@
+/** Ambient module — barrel exports. */
+export { AMBIENT_CATEGORIES, type AmbientCategory, type AmbientEntry, type AmbientConfig, type AmbientWarning, type AmbientResult, } from "./types.js";
+export { type RedactResult, redactSensitive, } from "./redact.js";
+export { AmbientEmitter } from "./emitter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ambient/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,YAAY,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/ambient/index.js

@@ -0,0 +1,5 @@
+/** Ambient module — barrel exports. */
+export { AMBIENT_CATEGORIES, } from "./types.js";
+export { redactSensitive, } from "./redact.js";
+export { AmbientEmitter } from "./emitter.js";
+//# sourceMappingURL=index.js.map

package/dist/ambient/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ambient/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EACL,kBAAkB,GAMnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/ambient/redact.d.ts

@@ -0,0 +1,11 @@
+/** Ambient redaction — strip sensitive patterns from monologue text. */
+export interface RedactResult {
+    readonly text: string;
+    readonly redacted: boolean;
+}
+/**
+ * Redact sensitive patterns from text.
+ * Returns the redacted text and whether any redaction occurred.
+ */
+export declare function redactSensitive(text: string): RedactResult;
+//# sourceMappingURL=redact.d.ts.map

package/dist/ambient/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/ambient/redact.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAuBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAe1D"}

package/dist/ambient/redact.js

@@ -0,0 +1,40 @@
+/** Ambient redaction — strip sensitive patterns from monologue text. */
+/**
+ * Patterns that indicate sensitive content.
+ * Each regex is applied globally; matched content is replaced with [REDACTED].
+ */
+const SENSITIVE_PATTERNS = [
+    // API keys and tokens (common formats: sk_live_xxx, pk_test_xxx, api_key_xxx, etc.)
+    /\b(?:sk|pk|api|key|token|secret|bearer)[_-][a-zA-Z0-9_-]{16,}\b/gi,
+    // AWS-style keys
+    /\bAKIA[A-Z0-9]{16}\b/g,
+    // JWT tokens
+    /\beyJ[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\b/g,
+    // Passwords in common formats
+    /(?:password|passwd|pwd)\s*[:=]\s*\S+/gi,
+    // File paths with sensitive names
+    /(?:\/|\\)(?:\.env|credentials|secrets?|private[_-]?key|id_rsa)[^\s]*/gi,
+    // Email addresses (potential PII)
+    /\b[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\b/g,
+    // IP addresses
+    /\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g,
+];
+/**
+ * Redact sensitive patterns from text.
+ * Returns the redacted text and whether any redaction occurred.
+ */
+export function redactSensitive(text) {
+    let result = text;
+    let redacted = false;
+    for (const pattern of SENSITIVE_PATTERNS) {
+        // Reset lastIndex for global regexps
+        pattern.lastIndex = 0;
+        if (pattern.test(result)) {
+            redacted = true;
+            pattern.lastIndex = 0;
+            result = result.replace(pattern, "[REDACTED]");
+        }
+    }
+    return { text: result, redacted };
+}
+//# sourceMappingURL=redact.js.map

package/dist/ambient/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/ambient/redact.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAOxE;;;GAGG;AACH,MAAM,kBAAkB,GAAsB;IAC5C,oFAAoF;IACpF,mEAAmE;IACnE,iBAAiB;IACjB,uBAAuB;IACvB,aAAa;IACb,oEAAoE;IACpE,8BAA8B;IAC9B,wCAAwC;IACxC,kCAAkC;IAClC,wEAAwE;IACxE,kCAAkC;IAClC,qDAAqD;IACrD,eAAe;IACf,yCAAyC;CAC1C,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,qCAAqC;QACrC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;QACtB,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;YACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC"}

package/dist/ambient/types.d.ts

@@ -0,0 +1,38 @@
+/** Ambient types — inner monologue and ephemeral events. */
+export declare const AMBIENT_CATEGORIES: readonly ["general", "thinking", "observation", "debug"];
+export type AmbientCategory = (typeof AMBIENT_CATEGORIES)[number];
+export interface AmbientEntry {
+    readonly id: string;
+    readonly text: string;
+    readonly category: AmbientCategory;
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly redacted: boolean;
+}
+export interface AmbientConfig {
+    /** Whether ambient system is enabled. Default: false. */
+    readonly enabled: boolean;
+    /** Global rate limit: minimum ms between emissions. Default: 10000 (10s). */
+    readonly globalCooldownMs: number;
+    /** Per-category cooldown in ms. Default: 15000 (15s). */
+    readonly categoryCooldownMs: number;
+    /** Max entries in buffer. Default: 5. */
+    readonly maxBufferSize: number;
+    /** Entry TTL in ms. Default: 60000 (60s). */
+    readonly ttlMs: number;
+    /** Max text length per entry. Default: 500. */
+    readonly maxTextLength: number;
+}
+export interface AmbientWarning {
+    readonly code: string;
+    readonly message: string;
+}
+export type AmbientResult = {
+    readonly accepted: true;
+    readonly entry: AmbientEntry;
+} | {
+    readonly accepted: false;
+    readonly reason: string;
+    readonly code: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ambient/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,eAAO,MAAM,kBAAkB,0DAKrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/ambient/types.js

@@ -0,0 +1,8 @@
+/** Ambient types — inner monologue and ephemeral events. */
+export const AMBIENT_CATEGORIES = [
+    "general",
+    "thinking",
+    "observation",
+    "debug",
+];
+//# sourceMappingURL=types.js.map

package/dist/ambient/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ambient/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS;IACT,UAAU;IACV,aAAa;IACb,OAAO;CACC,CAAC"}

package/dist/artifact.d.ts

@@ -0,0 +1,37 @@
+/** Artifact mode — how synthesized audio is delivered. */
+import type { ArtifactMode } from "./schemas.js";
+export { type ArtifactMode };
+/** Default artifact mode: write to disk, return path. */
+export declare const DEFAULT_ARTIFACT_MODE: ArtifactMode;
+/** Supported output audio formats. */
+export type OutputFormat = "wav" | "mp3" | "ogg" | "raw";
+export declare const DEFAULT_OUTPUT_FORMAT: OutputFormat;
+export interface ArtifactConfig {
+    /** How to deliver audio: "path" writes to disk, "base64" returns inline. */
+    readonly mode: ArtifactMode;
+    /** Output directory for "path" mode (resolved and validated). */
+    readonly outputDir?: string;
+    /** Audio format. Defaults to "wav". */
+    readonly format: OutputFormat;
+}
+/** Build an artifact config with defaults applied. */
+export declare function buildArtifactConfig(opts?: {
+    mode?: ArtifactMode;
+    outputDir?: string;
+    format?: OutputFormat;
+}): ArtifactConfig;
+export declare class OutputDirError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/** Default sandboxed output root: <tmpdir>/voice-soundboard/ */
+export declare function defaultOutputRoot(): string;
+/**
+ * Resolve and validate an output directory within the sandbox root.
+ *
+ * - If outputDir is undefined, returns `<root>/` (the sandbox root).
+ * - If outputDir is provided, it must resolve inside the root (no traversal).
+ * - Ensures the directory exists and is writable.
+ */
+export declare function resolveOutputDir(outputDir: string | undefined, root: string): Promise<string>;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAK1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,KAAK,YAAY,EAAE,CAAC;AAE7B,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,EAAE,YAAqB,CAAC;AAE1D,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AACzD,eAAO,MAAM,qBAAqB,EAAE,YAAoB,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE;IACzC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,cAAc,CAMjB;AAID,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,GAAE,MAA6B;CAKtD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/dist/artifact.js

@@ -0,0 +1,61 @@
+/** Artifact mode — how synthesized audio is delivered. */
+import { tmpdir } from "node:os";
+import { resolve, relative, isAbsolute } from "node:path";
+import { mkdir, access, constants } from "node:fs/promises";
+import { isSymlink } from "./sandbox.js";
+/** Default artifact mode: write to disk, return path. */
+export const DEFAULT_ARTIFACT_MODE = "path";
+export const DEFAULT_OUTPUT_FORMAT = "wav";
+/** Build an artifact config with defaults applied. */
+export function buildArtifactConfig(opts) {
+    return {
+        mode: opts?.mode ?? DEFAULT_ARTIFACT_MODE,
+        outputDir: opts?.outputDir,
+        format: opts?.format ?? DEFAULT_OUTPUT_FORMAT,
+    };
+}
+// ── Output dir sandboxing ──
+export class OutputDirError extends Error {
+    code;
+    constructor(message, code = "OUTPUT_DIR_INVALID") {
+        super(message);
+        this.code = code;
+        this.name = "OutputDirError";
+    }
+}
+/** Default sandboxed output root: <tmpdir>/voice-soundboard/ */
+export function defaultOutputRoot() {
+    return resolve(tmpdir(), "voice-soundboard");
+}
+/**
+ * Resolve and validate an output directory within the sandbox root.
+ *
+ * - If outputDir is undefined, returns `<root>/` (the sandbox root).
+ * - If outputDir is provided, it must resolve inside the root (no traversal).
+ * - Ensures the directory exists and is writable.
+ */
+export async function resolveOutputDir(outputDir, root) {
+    const resolved = outputDir
+        ? resolve(root, outputDir)
+        : root;
+    // Traversal check: resolved path must be inside root
+    const rel = relative(root, resolved);
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        throw new OutputDirError(`Output directory "${outputDir}" escapes sandbox root "${root}"`);
+    }
+    // Symlink check: reject if target is a symlink (prevents escape via symlink)
+    if (await isSymlink(resolved)) {
+        throw new OutputDirError(`Output directory "${resolved}" is a symlink — not allowed`);
+    }
+    // Ensure it exists
+    await mkdir(resolved, { recursive: true });
+    // Ensure it's writable
+    try {
+        await access(resolved, constants.W_OK);
+    }
+    catch {
+        throw new OutputDirError(`Output directory "${resolved}" is not writable`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=artifact.js.map

package/dist/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,yDAAyD;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAiB,MAAM,CAAC;AAI1D,MAAM,CAAC,MAAM,qBAAqB,GAAiB,KAAK,CAAC;AAWzD,sDAAsD;AACtD,MAAM,UAAU,mBAAmB,CAAC,IAInC;IACC,OAAO;QACL,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,qBAAqB;QACzC,SAAS,EAAE,IAAI,EAAE,SAAS;QAC1B,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,qBAAqB;KAC9C,CAAC;AACJ,CAAC;AAED,8BAA8B;AAE9B,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IAFlB,YACE,OAAe,EACC,OAAe,oBAAoB;QAEnD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAA+B;QAGnD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAA6B,EAC7B,IAAY;IAEZ,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;QAC1B,CAAC,CAAC,IAAI,CAAC;IAET,qDAAqD;IACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,cAAc,CACtB,qBAAqB,SAAS,2BAA2B,IAAI,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,IAAI,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,cAAc,CACtB,qBAAqB,QAAQ,8BAA8B,CAC5D,CAAC;IACJ,CAAC;IAED,mBAAmB;IACnB,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,uBAAuB;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CACtB,qBAAqB,QAAQ,mBAAmB,CACjD,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/chunking/chunker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Smart text chunker — splits long text for sequential synthesis.
+ *
+ * Split cascade:
+ *   1. Paragraphs (double newline)
+ *   2. Sentences (period/exclamation/question followed by space or EOL)
+ *   3. Punctuation (comma, semicolon, colon, dash followed by space)
+ *   4. Hard split at maxChunkChars boundary (last resort)
+ *
+ * Tiny chunks (< minChunkChars) are merged with the previous chunk.
+ */
+import type { ChunkResult, ChunkingOptions } from "./types.js";
+/** Split text into synthesis-friendly chunks. */
+export declare function chunkText(text: string, options?: ChunkingOptions): ChunkResult;
+//# sourceMappingURL=chunker.d.ts.map

package/dist/chunking/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/chunking/chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAgB,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7E,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,WAAW,CA6D9E"}

package/dist/chunking/chunker.js

@@ -0,0 +1,156 @@
+/**
+ * Smart text chunker — splits long text for sequential synthesis.
+ *
+ * Split cascade:
+ *   1. Paragraphs (double newline)
+ *   2. Sentences (period/exclamation/question followed by space or EOL)
+ *   3. Punctuation (comma, semicolon, colon, dash followed by space)
+ *   4. Hard split at maxChunkChars boundary (last resort)
+ *
+ * Tiny chunks (< minChunkChars) are merged with the previous chunk.
+ */
+import { CHUNK_LIMITS } from "./limits.js";
+/** Split text into synthesis-friendly chunks. */
+export function chunkText(text, options) {
+    const maxChunkChars = options?.maxChunkChars ?? CHUNK_LIMITS.maxChunkChars;
+    const minChunkChars = options?.minChunkChars ?? CHUNK_LIMITS.minChunkChars;
+    const maxTotalChars = options?.maxTotalChars ?? CHUNK_LIMITS.maxTotalChars;
+    const maxChunks = options?.maxChunks ?? CHUNK_LIMITS.maxChunks;
+    const warnings = [];
+    let input = text.trim();
+    if (!input) {
+        return { chunks: [], wasChunked: false, wasTruncated: false, warnings };
+    }
+    // Enforce total chars limit
+    let wasTruncated = false;
+    if (input.length > maxTotalChars) {
+        input = truncateAtBoundary(input, maxTotalChars);
+        wasTruncated = true;
+        warnings.push({
+            code: "TRUNCATED",
+            message: `Text truncated from ${text.trim().length} to ${input.length} characters (limit: ${maxTotalChars})`,
+        });
+    }
+    // If short enough, return as single chunk
+    if (input.length <= maxChunkChars) {
+        return { chunks: [input], wasChunked: false, wasTruncated, warnings };
+    }
+    // Split cascade
+    let rawChunks = splitByParagraphs(input);
+    rawChunks = refineSplits(rawChunks, maxChunkChars, splitBySentences);
+    rawChunks = refineSplits(rawChunks, maxChunkChars, splitByPunctuation);
+    rawChunks = refineSplits(rawChunks, maxChunkChars, hardSplit);
+    // Merge tiny chunks
+    rawChunks = mergeTiny(rawChunks, minChunkChars, maxChunkChars);
+    // Enforce max chunks
+    if (rawChunks.length > maxChunks) {
+        rawChunks = rawChunks.slice(0, maxChunks);
+        wasTruncated = true;
+        warnings.push({
+            code: "TRUNCATED",
+            message: `Chunk count reduced to ${maxChunks} (limit)`,
+        });
+    }
+    if (rawChunks.length > 1) {
+        warnings.push({
+            code: "CHUNKED_TEXT",
+            message: `Text split into ${rawChunks.length} chunks`,
+        });
+    }
+    return {
+        chunks: rawChunks,
+        wasChunked: rawChunks.length > 1,
+        wasTruncated,
+        warnings,
+    };
+}
+// ── Split strategies ──
+/** Split on paragraph boundaries (double newline). */
+function splitByParagraphs(text) {
+    return text
+        .split(/\n\s*\n/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/** Split on sentence boundaries. */
+function splitBySentences(text) {
+    // Split after sentence-ending punctuation followed by space or EOL
+    const parts = text.split(/(?<=[.!?])\s+/);
+    return parts.map((s) => s.trim()).filter(Boolean);
+}
+/** Split on clause-level punctuation. */
+function splitByPunctuation(text) {
+    const parts = text.split(/(?<=[,;:\u2014])\s+/);
+    return parts.map((s) => s.trim()).filter(Boolean);
+}
+/** Hard split at character boundary (last resort). */
+function hardSplit(text, maxChars) {
+    const limit = maxChars ?? CHUNK_LIMITS.maxChunkChars;
+    const result = [];
+    let remaining = text;
+    while (remaining.length > limit) {
+        // Try to split at a word boundary
+        let splitIdx = remaining.lastIndexOf(" ", limit);
+        if (splitIdx <= 0) {
+            splitIdx = limit;
+        }
+        result.push(remaining.slice(0, splitIdx).trim());
+        remaining = remaining.slice(splitIdx).trim();
+    }
+    if (remaining) {
+        result.push(remaining);
+    }
+    return result;
+}
+/**
+ * For any chunk still over maxChunkChars, apply a finer split strategy.
+ */
+function refineSplits(chunks, maxChunkChars, splitter) {
+    const result = [];
+    for (const chunk of chunks) {
+        if (chunk.length <= maxChunkChars) {
+            result.push(chunk);
+        }
+        else {
+            result.push(...splitter(chunk, maxChunkChars));
+        }
+    }
+    return result;
+}
+/** Merge tiny chunks with their neighbor. */
+function mergeTiny(chunks, minChars, maxChars) {
+    if (chunks.length <= 1)
+        return chunks;
+    const result = [chunks[0]];
+    for (let i = 1; i < chunks.length; i++) {
+        const current = chunks[i];
+        const prev = result[result.length - 1];
+        if (current.length < minChars && (prev.length + current.length + 1) <= maxChars) {
+            // Merge with previous
+            result[result.length - 1] = prev + " " + current;
+        }
+        else {
+            result.push(current);
+        }
+    }
+    return result;
+}
+/** Truncate text at a natural boundary near maxChars. */
+function truncateAtBoundary(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    // Try sentence boundary
+    const sub = text.slice(0, maxChars);
+    const sentEnd = Math.max(sub.lastIndexOf(". "), sub.lastIndexOf("! "), sub.lastIndexOf("? "));
+    if (sentEnd > maxChars * 0.5) {
+        return text.slice(0, sentEnd + 1).trim();
+    }
+    // Try word boundary
+    const wordEnd = sub.lastIndexOf(" ");
+    if (wordEnd > maxChars * 0.5) {
+        return text.slice(0, wordEnd).trim();
+    }
+    // Hard cut
+    return sub.trim();
+}
+//# sourceMappingURL=chunker.js.map

package/dist/chunking/chunker.js.map

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

package/dist/chunking/index.d.ts

@@ -0,0 +1,5 @@
+/** Chunking module — split long text for sequential synthesis. */
+export { type ChunkingOptions, type ChunkResult, type ChunkWarning, } from "./types.js";
+export { CHUNK_LIMITS } from "./limits.js";
+export { chunkText } from "./chunker.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chunking/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/chunking/index.js

@@ -0,0 +1,4 @@
+/** Chunking module — split long text for sequential synthesis. */
+export { CHUNK_LIMITS } from "./limits.js";
+export { chunkText } from "./chunker.js";
+//# sourceMappingURL=index.js.map