vocal-stack 1.0.0

package/dist/sanitizer/index.d.cts

@@ -0,0 +1,83 @@
+/**
+ * Configuration for text sanitization
+ */
+interface SanitizerConfig {
+    /**
+     * Rules to apply during sanitization
+     * @default ['markdown', 'urls', 'code-blocks', 'punctuation']
+     */
+    readonly rules?: readonly SanitizerRule[];
+    /**
+     * Custom plugins for platform-specific transformations
+     */
+    readonly plugins?: readonly SanitizerPlugin[];
+    /**
+     * Whether to preserve line breaks
+     * @default false
+     */
+    readonly preserveLineBreaks?: boolean;
+    /**
+     * Custom replacements for specific patterns
+     */
+    readonly customReplacements?: ReadonlyMap<string | RegExp, string>;
+}
+/**
+ * Built-in rule identifiers
+ */
+type SanitizerRule = 'markdown' | 'urls' | 'code-blocks' | 'punctuation';
+/**
+ * Plugin interface for custom sanitization logic
+ */
+interface SanitizerPlugin {
+    readonly name: string;
+    readonly priority: number;
+    transform(text: string): string | Promise<string>;
+}
+/**
+ * Result of sanitization operation
+ */
+interface SanitizationResult {
+    readonly original: string;
+    readonly sanitized: string;
+    readonly appliedRules: readonly string[];
+    readonly metadata: {
+        readonly removedCount: number;
+        readonly transformedCount: number;
+    };
+}
+/**
+ * Rule function type
+ */
+type RuleFunction = (text: string, config: Required<SanitizerConfig>) => string;
+
+/**
+ * Speech sanitizer that transforms text for TTS optimization
+ */
+declare class SpeechSanitizer {
+    private readonly config;
+    private readonly plugins;
+    constructor(config?: SanitizerConfig);
+    /**
+     * Sanitize a string synchronously
+     */
+    sanitize(text: string): string;
+    /**
+     * Sanitize with detailed result metadata
+     */
+    sanitizeWithMetadata(text: string): SanitizationResult;
+    /**
+     * Sanitize a stream of text chunks (AsyncIterable)
+     */
+    sanitizeStream(input: AsyncIterable<string>): AsyncIterable<string>;
+}
+/**
+ * Convenience function for one-off sanitization
+ */
+declare function sanitizeForSpeech(text: string, config?: SanitizerConfig): string;
+
+/**
+ * Registry of built-in sanitization rules
+ */
+declare const ruleRegistry: Map<string, RuleFunction>;
+
+export { type RuleFunction, type SanitizationResult, type SanitizerConfig, type SanitizerPlugin, type SanitizerRule, SpeechSanitizer, ruleRegistry, sanitizeForSpeech };

package/dist/sanitizer/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Configuration for text sanitization
+ */
+interface SanitizerConfig {
+    /**
+     * Rules to apply during sanitization
+     * @default ['markdown', 'urls', 'code-blocks', 'punctuation']
+     */
+    readonly rules?: readonly SanitizerRule[];
+    /**
+     * Custom plugins for platform-specific transformations
+     */
+    readonly plugins?: readonly SanitizerPlugin[];
+    /**
+     * Whether to preserve line breaks
+     * @default false
+     */
+    readonly preserveLineBreaks?: boolean;
+    /**
+     * Custom replacements for specific patterns
+     */
+    readonly customReplacements?: ReadonlyMap<string | RegExp, string>;
+}
+/**
+ * Built-in rule identifiers
+ */
+type SanitizerRule = 'markdown' | 'urls' | 'code-blocks' | 'punctuation';
+/**
+ * Plugin interface for custom sanitization logic
+ */
+interface SanitizerPlugin {
+    readonly name: string;
+    readonly priority: number;
+    transform(text: string): string | Promise<string>;
+}
+/**
+ * Result of sanitization operation
+ */
+interface SanitizationResult {
+    readonly original: string;
+    readonly sanitized: string;
+    readonly appliedRules: readonly string[];
+    readonly metadata: {
+        readonly removedCount: number;
+        readonly transformedCount: number;
+    };
+}
+/**
+ * Rule function type
+ */
+type RuleFunction = (text: string, config: Required<SanitizerConfig>) => string;
+
+/**
+ * Speech sanitizer that transforms text for TTS optimization
+ */
+declare class SpeechSanitizer {
+    private readonly config;
+    private readonly plugins;
+    constructor(config?: SanitizerConfig);
+    /**
+     * Sanitize a string synchronously
+     */
+    sanitize(text: string): string;
+    /**
+     * Sanitize with detailed result metadata
+     */
+    sanitizeWithMetadata(text: string): SanitizationResult;
+    /**
+     * Sanitize a stream of text chunks (AsyncIterable)
+     */
+    sanitizeStream(input: AsyncIterable<string>): AsyncIterable<string>;
+}
+/**
+ * Convenience function for one-off sanitization
+ */
+declare function sanitizeForSpeech(text: string, config?: SanitizerConfig): string;
+
+/**
+ * Registry of built-in sanitization rules
+ */
+declare const ruleRegistry: Map<string, RuleFunction>;
+
+export { type RuleFunction, type SanitizationResult, type SanitizerConfig, type SanitizerPlugin, type SanitizerRule, SpeechSanitizer, ruleRegistry, sanitizeForSpeech };

package/dist/sanitizer/index.js

@@ -0,0 +1,186 @@
+// src/errors.ts
+var VocalStackError = class extends Error {
+  constructor(message, code, context) {
+    super(message);
+    this.code = code;
+    this.context = context;
+    this.name = "VocalStackError";
+    Error.captureStackTrace(this, this.constructor);
+  }
+};
+var SanitizerError = class extends VocalStackError {
+  constructor(message, context) {
+    super(message, "SANITIZER_ERROR", context);
+    this.name = "SanitizerError";
+  }
+};
+
+// src/sanitizer/rules/code-blocks.ts
+function codeBlocksRule(text, _config) {
+  let result = text;
+  result = result.replace(/```[\s\S]*?```/g, "");
+  result = result.replace(/^(?: {4}|\t).+$/gm, "");
+  return result;
+}
+
+// src/sanitizer/rules/markdown.ts
+function markdownRule(text, _config) {
+  let result = text;
+  result = result.replace(/^#{1,6}\s+/gm, "");
+  result = result.replace(/(\*\*|__)(.*?)\1/g, "$2");
+  result = result.replace(/(\*|_)(.*?)\1/g, "$2");
+  result = result.replace(/`([^`]+)`/g, "$1");
+  result = result.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+  result = result.replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1");
+  result = result.replace(/^>\s+/gm, "");
+  result = result.replace(/^[\-*_]{3,}$/gm, "");
+  result = result.replace(/^[\s]*[-*+]\s+/gm, "");
+  result = result.replace(/^[\s]*\d+\.\s+/gm, "");
+  result = result.replace(/~~(.*?)~~/g, "$1");
+  result = result.replace(/^[\s]*-\s+\[[ xX]\]\s+/gm, "");
+  return result;
+}
+
+// src/sanitizer/rules/punctuation.ts
+function punctuationRule(text, _config) {
+  let result = text;
+  result = result.replace(/!{2,}/g, "!");
+  result = result.replace(/\?{2,}/g, "?");
+  result = result.replace(/\.{3,}/g, ".");
+  result = result.replace(/-{2,}/g, " ");
+  result = result.replace(/[—–]/g, " ");
+  result = result.replace(/[()[\]{}]/g, "");
+  result = result.replace(/,{2,}/g, ",");
+  result = result.replace(/[;:]/g, ",");
+  result = result.replace(/["'"'`]/g, "");
+  result = result.replace(/[*_]/g, "");
+  result = result.replace(/[/\\]/g, " ");
+  result = result.replace(/[|&]/g, " ");
+  result = result.replace(/[@#$%]/g, "");
+  return result;
+}
+
+// src/sanitizer/rules/urls.ts
+function urlsRule(text, _config) {
+  let result = text;
+  const urlWithProtocol = /\b(https?:\/\/|ftp:\/\/|www\.)[^\s<>"{}|\\^`[\]]+/gi;
+  const emailPattern = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g;
+  result = result.replace(urlWithProtocol, "");
+  result = result.replace(emailPattern, "");
+  result = result.replace(/\b[a-z0-9-]+\.[a-z]{2,}\b/gi, "");
+  return result;
+}
+
+// src/sanitizer/rules/index.ts
+var ruleRegistry = /* @__PURE__ */ new Map([
+  ["markdown", markdownRule],
+  ["urls", urlsRule],
+  ["code-blocks", codeBlocksRule],
+  ["punctuation", punctuationRule]
+]);
+
+// src/sanitizer/sanitizer.ts
+var SpeechSanitizer = class {
+  config;
+  plugins;
+  constructor(config = {}) {
+    this.config = {
+      rules: config.rules ?? ["markdown", "urls", "code-blocks", "punctuation"],
+      plugins: config.plugins ?? [],
+      preserveLineBreaks: config.preserveLineBreaks ?? false,
+      customReplacements: config.customReplacements ?? /* @__PURE__ */ new Map()
+    };
+    this.plugins = [...this.config.plugins].sort((a, b) => a.priority - b.priority);
+  }
+  /**
+   * Sanitize a string synchronously
+   */
+  sanitize(text) {
+    if (!text || text.trim().length === 0) {
+      return "";
+    }
+    let result = text;
+    try {
+      for (const rule of this.config.rules) {
+        const ruleFunction = ruleRegistry.get(rule);
+        if (ruleFunction) {
+          result = ruleFunction(result, this.config);
+        }
+      }
+      for (const plugin of this.plugins) {
+        const transformed = plugin.transform(result);
+        if (transformed instanceof Promise) {
+          throw new SanitizerError(
+            `Plugin ${plugin.name} returned a Promise in sync sanitize(). Use sanitizeAsync() instead.`
+          );
+        }
+        result = transformed;
+      }
+      for (const [pattern, replacement] of this.config.customReplacements) {
+        if (typeof pattern === "string") {
+          result = result.replaceAll(pattern, replacement);
+        } else {
+          result = result.replace(pattern, replacement);
+        }
+      }
+      if (this.config.preserveLineBreaks) {
+        result = result.replace(/ +/g, " ").replace(/^\s+|\s+$/gm, "");
+      } else {
+        result = result.replace(/\s+/g, " ").trim();
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof SanitizerError) {
+        throw error;
+      }
+      throw new SanitizerError("Failed to sanitize text", {
+        originalText: text.substring(0, 100),
+        error
+      });
+    }
+  }
+  /**
+   * Sanitize with detailed result metadata
+   */
+  sanitizeWithMetadata(text) {
+    const original = text;
+    const sanitized = this.sanitize(text);
+    return {
+      original,
+      sanitized,
+      appliedRules: this.config.rules,
+      metadata: {
+        removedCount: original.length - sanitized.length,
+        transformedCount: this.config.rules.length + this.plugins.length
+      }
+    };
+  }
+  /**
+   * Sanitize a stream of text chunks (AsyncIterable)
+   */
+  async *sanitizeStream(input) {
+    let buffer = "";
+    const sentenceBoundary = /[.!?]\s+/;
+    for await (const chunk of input) {
+      buffer += chunk;
+      const sentences = buffer.split(sentenceBoundary);
+      buffer = sentences.pop() ?? "";
+      for (const sentence of sentences) {
+        if (sentence.trim()) {
+          yield `${this.sanitize(sentence)} `;
+        }
+      }
+    }
+    if (buffer.trim()) {
+      yield this.sanitize(buffer);
+    }
+  }
+};
+function sanitizeForSpeech(text, config) {
+  const sanitizer = new SpeechSanitizer(config);
+  return sanitizer.sanitize(text);
+}
+
+export { SpeechSanitizer, ruleRegistry, sanitizeForSpeech };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/sanitizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors.ts","../../src/sanitizer/rules/code-blocks.ts","../../src/sanitizer/rules/markdown.ts","../../src/sanitizer/rules/punctuation.ts","../../src/sanitizer/rules/urls.ts","../../src/sanitizer/rules/index.ts","../../src/sanitizer/sanitizer.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Base error class for all vocal-stack errors\n */\nexport class VocalStackError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'VocalStackError';\n    Error.captureStackTrace(this, this.constructor);\n  }\n}\n\n/**\n * Error thrown during text sanitization\n */\nexport class SanitizerError extends VocalStackError {\n  constructor(message: string, context?: Record<string, unknown>) {\n    super(message, 'SANITIZER_ERROR', context);\n    this.name = 'SanitizerError';\n  }\n}\n\n/**\n * Error thrown during flow control operations\n */\nexport class FlowControlError extends VocalStackError {\n  constructor(message: string, context?: Record<string, unknown>) {\n    super(message, 'FLOW_CONTROL_ERROR', context);\n    this.name = 'FlowControlError';\n  }\n}\n\n/**\n * Error thrown during monitoring operations\n */\nexport class MonitorError extends VocalStackError {\n  constructor(message: string, context?: Record<string, unknown>) {\n    super(message, 'MONITOR_ERROR', context);\n    this.name = 'MonitorError';\n  }\n}\n","import type { SanitizerConfig } from '../types';\n\n/**\n * Remove code blocks and inline code to make text speakable\n */\nexport function codeBlocksRule(text: string, _config: Required<SanitizerConfig>): string {\n  let result = text;\n\n  // Remove fenced code blocks (```code```)\n  // Match both with and without language specifier\n  result = result.replace(/```[\\s\\S]*?```/g, '');\n\n  // Remove indented code blocks (4 spaces or 1 tab at line start)\n  result = result.replace(/^(?: {4}|\\t).+$/gm, '');\n\n  // Note: Inline code (`code`) is handled by markdown rule\n\n  return result;\n}\n","import type { SanitizerConfig } from '../types';\n\n/**\n * Strip markdown syntax to make text speakable\n */\nexport function markdownRule(text: string, _config: Required<SanitizerConfig>): string {\n  let result = text;\n\n  // Remove headers (##, ###, etc.)\n  result = result.replace(/^#{1,6}\\s+/gm, '');\n\n  // Remove bold/italic (**text**, *text*, __text__, _text_)\n  result = result.replace(/(\\*\\*|__)(.*?)\\1/g, '$2');\n  result = result.replace(/(\\*|_)(.*?)\\1/g, '$2');\n\n  // Remove inline code (`code`)\n  result = result.replace(/`([^`]+)`/g, '$1');\n\n  // Remove links but keep text [text](url) -> text\n  result = result.replace(/\\[([^\\]]+)\\]\\([^)]+\\)/g, '$1');\n\n  // Remove images ![alt](url) -> alt or empty\n  result = result.replace(/!\\[([^\\]]*)\\]\\([^)]+\\)/g, '$1');\n\n  // Remove blockquotes (>)\n  result = result.replace(/^>\\s+/gm, '');\n\n  // Remove horizontal rules (---, ***, ___)\n  result = result.replace(/^[\\-*_]{3,}$/gm, '');\n\n  // Remove list markers (-, *, 1., etc.)\n  result = result.replace(/^[\\s]*[-*+]\\s+/gm, '');\n  result = result.replace(/^[\\s]*\\d+\\.\\s+/gm, '');\n\n  // Remove strikethrough (~~text~~)\n  result = result.replace(/~~(.*?)~~/g, '$1');\n\n  // Remove task list markers (- [ ], - [x])\n  result = result.replace(/^[\\s]*-\\s+\\[[ xX]\\]\\s+/gm, '');\n\n  return result;\n}\n","import type { SanitizerConfig } from '../types';\n\n/**\n * Normalize punctuation for better TTS handling\n */\nexport function punctuationRule(text: string, _config: Required<SanitizerConfig>): string {\n  let result = text;\n\n  // Replace multiple exclamation marks with single\n  result = result.replace(/!{2,}/g, '!');\n\n  // Replace multiple question marks with single\n  result = result.replace(/\\?{2,}/g, '?');\n\n  // Replace ellipsis variations with single space or period\n  result = result.replace(/\\.{3,}/g, '.');\n\n  // Remove multiple dashes/hyphens\n  result = result.replace(/-{2,}/g, ' ');\n\n  // Replace em dash and en dash with space\n  result = result.replace(/[—–]/g, ' ');\n\n  // Remove parentheses and brackets but keep content\n  result = result.replace(/[()[\\]{}]/g, '');\n\n  // Replace multiple commas with single\n  result = result.replace(/,{2,}/g, ',');\n\n  // Remove semicolons and colons (can be disruptive in speech)\n  result = result.replace(/[;:]/g, ',');\n\n  // Remove quotation marks\n  result = result.replace(/[\"'\"'`]/g, '');\n\n  // Remove asterisks and underscores (from markdown remnants)\n  result = result.replace(/[*_]/g, '');\n\n  // Remove forward slashes and backslashes\n  result = result.replace(/[/\\\\]/g, ' ');\n\n  // Remove pipes and ampersands\n  result = result.replace(/[|&]/g, ' ');\n\n  // Remove @ # $ % symbols\n  result = result.replace(/[@#$%]/g, '');\n\n  return result;\n}\n","import type { SanitizerConfig } from '../types';\n\n/**\n * Remove or replace URLs to make text speakable\n */\nexport function urlsRule(text: string, _config: Required<SanitizerConfig>): string {\n  let result = text;\n\n  // Match URLs with protocol (http://, https://, ftp://, etc.)\n  const urlWithProtocol = /\\b(https?:\\/\\/|ftp:\\/\\/|www\\.)[^\\s<>\"{}|\\\\^`[\\]]+/gi;\n\n  // Match email addresses\n  const emailPattern = /\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b/g;\n\n  // Remove URLs with protocol\n  result = result.replace(urlWithProtocol, '');\n\n  // Remove email addresses\n  result = result.replace(emailPattern, '');\n\n  // Remove standalone domain-like patterns (example.com)\n  result = result.replace(/\\b[a-z0-9-]+\\.[a-z]{2,}\\b/gi, '');\n\n  return result;\n}\n","import type { RuleFunction } from '../types';\nimport { codeBlocksRule } from './code-blocks';\nimport { markdownRule } from './markdown';\nimport { punctuationRule } from './punctuation';\nimport { urlsRule } from './urls';\n\n/**\n * Registry of built-in sanitization rules\n */\nexport const ruleRegistry = new Map<string, RuleFunction>([\n  ['markdown', markdownRule],\n  ['urls', urlsRule],\n  ['code-blocks', codeBlocksRule],\n  ['punctuation', punctuationRule],\n]);\n","import { SanitizerError } from '../errors';\nimport { ruleRegistry } from './rules';\nimport type { SanitizationResult, SanitizerConfig, SanitizerPlugin } from './types';\n\n/**\n * Speech sanitizer that transforms text for TTS optimization\n */\nexport class SpeechSanitizer {\n  private readonly config: Required<SanitizerConfig>;\n  private readonly plugins: readonly SanitizerPlugin[];\n\n  constructor(config: SanitizerConfig = {}) {\n    this.config = {\n      rules: config.rules ?? ['markdown', 'urls', 'code-blocks', 'punctuation'],\n      plugins: config.plugins ?? [],\n      preserveLineBreaks: config.preserveLineBreaks ?? false,\n      customReplacements: config.customReplacements ?? new Map(),\n    };\n    this.plugins = [...this.config.plugins].sort((a, b) => a.priority - b.priority);\n  }\n\n  /**\n   * Sanitize a string synchronously\n   */\n  sanitize(text: string): string {\n    if (!text || text.trim().length === 0) {\n      return '';\n    }\n\n    let result = text;\n\n    try {\n      // Apply built-in rules\n      for (const rule of this.config.rules) {\n        const ruleFunction = ruleRegistry.get(rule);\n        if (ruleFunction) {\n          result = ruleFunction(result, this.config);\n        }\n      }\n\n      // Apply plugins (sync only in this version)\n      for (const plugin of this.plugins) {\n        const transformed = plugin.transform(result);\n        if (transformed instanceof Promise) {\n          throw new SanitizerError(\n            `Plugin ${plugin.name} returned a Promise in sync sanitize(). Use sanitizeAsync() instead.`\n          );\n        }\n        result = transformed;\n      }\n\n      // Apply custom replacements\n      for (const [pattern, replacement] of this.config.customReplacements) {\n        if (typeof pattern === 'string') {\n          result = result.replaceAll(pattern, replacement);\n        } else {\n          result = result.replace(pattern, replacement);\n        }\n      }\n\n      // Clean up whitespace\n      if (this.config.preserveLineBreaks) {\n        // Collapse multiple spaces on same line but keep line breaks\n        result = result.replace(/ +/g, ' ').replace(/^\\s+|\\s+$/gm, '');\n      } else {\n        // Collapse all whitespace including line breaks\n        result = result.replace(/\\s+/g, ' ').trim();\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof SanitizerError) {\n        throw error;\n      }\n      throw new SanitizerError('Failed to sanitize text', {\n        originalText: text.substring(0, 100),\n        error,\n      });\n    }\n  }\n\n  /**\n   * Sanitize with detailed result metadata\n   */\n  sanitizeWithMetadata(text: string): SanitizationResult {\n    const original = text;\n    const sanitized = this.sanitize(text);\n\n    return {\n      original,\n      sanitized,\n      appliedRules: this.config.rules as string[],\n      metadata: {\n        removedCount: original.length - sanitized.length,\n        transformedCount: this.config.rules.length + this.plugins.length,\n      },\n    };\n  }\n\n  /**\n   * Sanitize a stream of text chunks (AsyncIterable)\n   */\n  async *sanitizeStream(input: AsyncIterable<string>): AsyncIterable<string> {\n    let buffer = '';\n    const sentenceBoundary = /[.!?]\\s+/;\n\n    for await (const chunk of input) {\n      buffer += chunk;\n\n      // Process complete sentences\n      const sentences = buffer.split(sentenceBoundary);\n      buffer = sentences.pop() ?? ''; // Keep incomplete sentence\n\n      for (const sentence of sentences) {\n        if (sentence.trim()) {\n          yield `${this.sanitize(sentence)} `;\n        }\n      }\n    }\n\n    // Process remaining buffer\n    if (buffer.trim()) {\n      yield this.sanitize(buffer);\n    }\n  }\n}\n\n/**\n * Convenience function for one-off sanitization\n */\nexport function sanitizeForSpeech(text: string, config?: SanitizerConfig): string {\n  const sanitizer = new SpeechSanitizer(config);\n  return sanitizer.sanitize(text);\n}\n"]}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "vocal-stack",
+  "version": "1.0.0",
+  "description": "High-performance utility library for Voice AI agents - text sanitization, flow control, and latency monitoring",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./sanitizer": {
+      "types": "./dist/sanitizer/index.d.ts",
+      "import": "./dist/sanitizer/index.mjs",
+      "require": "./dist/sanitizer/index.js"
+    },
+    "./flow": {
+      "types": "./dist/flow/index.d.ts",
+      "import": "./dist/flow/index.mjs",
+      "require": "./dist/flow/index.js"
+    },
+    "./monitor": {
+      "types": "./dist/monitor/index.d.ts",
+      "import": "./dist/monitor/index.mjs",
+      "require": "./dist/monitor/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run test && npm run typecheck",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "npm run build && changeset publish"
+  },
+  "keywords": [
+    "voice-ai",
+    "tts",
+    "llm",
+    "streaming",
+    "speech",
+    "conversational-ai",
+    "realtime",
+    "latency",
+    "voice-agents",
+    "text-to-speech",
+    "ai-agents",
+    "openai",
+    "elevenlabs"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@changesets/cli": "^2.27.10",
+    "@types/node": "^22.10.5",
+    "@vitest/coverage-v8": "^2.1.8",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "peerDependencies": {},
+  "dependencies": {}
+}