vocal-stack 1.0.0

package/dist/monitor/index.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Configuration for voice auditor
+ */
+interface AuditorConfig {
+    /**
+     * Whether to enable real-time monitoring
+     * @default false
+     */
+    readonly enableRealtime?: boolean;
+    /**
+     * Callback for real-time metrics
+     */
+    readonly onMetric?: (metric: VoiceMetric) => void;
+    /**
+     * Custom tags to attach to metrics
+     */
+    readonly tags?: Record<string, string>;
+}
+/**
+ * Voice latency metric
+ */
+interface VoiceMetric {
+    readonly id: string;
+    readonly timestamp: number;
+    readonly startTime: number;
+    readonly firstTokenReceivedTime: number | null;
+    readonly lastTokenReceivedTime: number | null;
+    readonly completed: boolean;
+    readonly metrics: {
+        readonly timeToFirstToken: number | null;
+        readonly totalDuration: number | null;
+        readonly tokenCount: number;
+        readonly averageTokenLatency: number | null;
+    };
+    readonly tags: Record<string, string>;
+}
+/**
+ * Summary statistics
+ */
+interface MetricsSummary {
+    readonly count: number;
+    readonly avgTimeToFirstToken: number;
+    readonly avgTotalDuration: number;
+    readonly p50TimeToFirstToken: number;
+    readonly p95TimeToFirstToken: number;
+    readonly p99TimeToFirstToken: number;
+    readonly minTimeToFirstToken: number;
+    readonly maxTimeToFirstToken: number;
+}
+/**
+ * Export format options
+ */
+type ExportFormat = 'json' | 'csv';
+
+/**
+ * Voice latency auditor and profiler
+ */
+declare class VoiceAuditor {
+    private readonly config;
+    private readonly collector;
+    private activeMetrics;
+    constructor(config?: AuditorConfig);
+    /**
+     * Start tracking a new voice interaction
+     */
+    startTracking(id: string, tags?: Record<string, string>): VoiceMetric;
+    /**
+     * Record first token received
+     */
+    recordFirstToken(id: string): void;
+    /**
+     * Record token received
+     */
+    recordToken(id: string): void;
+    /**
+     * Complete tracking for a voice interaction
+     */
+    completeTracking(id: string): VoiceMetric;
+    /**
+     * Wrap an async iterable with automatic tracking
+     */
+    track(id: string, input: AsyncIterable<string>, tags?: Record<string, string>): AsyncIterable<string>;
+    /**
+     * Get all collected metrics
+     */
+    getMetrics(): readonly VoiceMetric[];
+    /**
+     * Get summary statistics
+     */
+    getSummary(): MetricsSummary;
+    /**
+     * Export metrics in specified format
+     */
+    export(format: ExportFormat): string;
+    /**
+     * Clear all collected metrics
+     */
+    clear(): void;
+}
+
+/**
+ * Export metrics to CSV format
+ */
+declare function exportToCsv(metrics: readonly VoiceMetric[]): string;
+
+/**
+ * Export metrics to JSON format
+ */
+declare function exportToJson(metrics: readonly VoiceMetric[]): string;
+
+/**
+ * Collects and aggregates metrics
+ */
+declare class MetricsCollector {
+    private metrics;
+    addMetric(metric: VoiceMetric): void;
+    getMetrics(): readonly VoiceMetric[];
+    getSummary(): MetricsSummary;
+    clear(): void;
+}
+
+export { type AuditorConfig, type ExportFormat, MetricsCollector, type MetricsSummary, VoiceAuditor, type VoiceMetric, exportToCsv, exportToJson };

package/dist/monitor/index.js

@@ -0,0 +1,286 @@
+// 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 MonitorError = class extends VocalStackError {
+  constructor(message, context) {
+    super(message, "MONITOR_ERROR", context);
+    this.name = "MonitorError";
+  }
+};
+
+// src/monitor/exporters/csv.ts
+function exportToCsv(metrics) {
+  const headers = [
+    "id",
+    "timestamp",
+    "completed",
+    "timeToFirstToken",
+    "totalDuration",
+    "tokenCount",
+    "averageTokenLatency",
+    "tags"
+  ];
+  const rows = metrics.map((m) => [
+    m.id,
+    m.timestamp.toString(),
+    m.completed.toString(),
+    m.metrics.timeToFirstToken?.toString() ?? "",
+    m.metrics.totalDuration?.toString() ?? "",
+    m.metrics.tokenCount.toString(),
+    m.metrics.averageTokenLatency?.toString() ?? "",
+    JSON.stringify(m.tags)
+  ]);
+  const csvLines = [
+    headers.join(","),
+    ...rows.map(
+      (row) => row.map((cell) => {
+        if (cell.includes(",") || cell.includes('"') || cell.includes("\n")) {
+          return `"${cell.replace(/"/g, '""')}"`;
+        }
+        return cell;
+      }).join(",")
+    )
+  ];
+  return csvLines.join("\n");
+}
+
+// src/monitor/exporters/json.ts
+function exportToJson(metrics) {
+  return JSON.stringify(
+    {
+      exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      count: metrics.length,
+      metrics: metrics.map((m) => ({
+        id: m.id,
+        timestamp: m.timestamp,
+        completed: m.completed,
+        timeToFirstToken: m.metrics.timeToFirstToken,
+        totalDuration: m.metrics.totalDuration,
+        tokenCount: m.metrics.tokenCount,
+        averageTokenLatency: m.metrics.averageTokenLatency,
+        tags: m.tags
+      }))
+    },
+    null,
+    2
+  );
+}
+
+// src/monitor/metrics-collector.ts
+var MetricsCollector = class {
+  metrics = [];
+  addMetric(metric) {
+    this.metrics.push(metric);
+  }
+  getMetrics() {
+    return [...this.metrics];
+  }
+  getSummary() {
+    if (this.metrics.length === 0) {
+      return {
+        count: 0,
+        avgTimeToFirstToken: 0,
+        avgTotalDuration: 0,
+        p50TimeToFirstToken: 0,
+        p95TimeToFirstToken: 0,
+        p99TimeToFirstToken: 0,
+        minTimeToFirstToken: 0,
+        maxTimeToFirstToken: 0
+      };
+    }
+    const ttfts = this.metrics.map((m) => m.metrics.timeToFirstToken).filter((t) => t !== null).sort((a, b) => a - b);
+    const durations = this.metrics.map((m) => m.metrics.totalDuration).filter((d) => d !== null);
+    const percentile = (arr, p) => {
+      if (arr.length === 0) return 0;
+      const index = Math.ceil(arr.length * p) - 1;
+      return arr[index] ?? 0;
+    };
+    return {
+      count: this.metrics.length,
+      avgTimeToFirstToken: ttfts.reduce((a, b) => a + b, 0) / ttfts.length || 0,
+      avgTotalDuration: durations.reduce((a, b) => a + b, 0) / durations.length || 0,
+      p50TimeToFirstToken: percentile(ttfts, 0.5),
+      p95TimeToFirstToken: percentile(ttfts, 0.95),
+      p99TimeToFirstToken: percentile(ttfts, 0.99),
+      minTimeToFirstToken: ttfts.length > 0 ? Math.min(...ttfts) : 0,
+      maxTimeToFirstToken: ttfts.length > 0 ? Math.max(...ttfts) : 0
+    };
+  }
+  clear() {
+    this.metrics = [];
+  }
+};
+
+// src/monitor/voice-auditor.ts
+var VoiceAuditor = class {
+  config;
+  collector;
+  activeMetrics = /* @__PURE__ */ new Map();
+  constructor(config = {}) {
+    this.config = {
+      enableRealtime: config.enableRealtime ?? false,
+      onMetric: config.onMetric ?? (() => {
+      }),
+      tags: config.tags ?? {}
+    };
+    this.collector = new MetricsCollector();
+  }
+  /**
+   * Start tracking a new voice interaction
+   */
+  startTracking(id, tags) {
+    if (this.activeMetrics.has(id)) {
+      throw new MonitorError(`Metric with id ${id} is already being tracked`);
+    }
+    const metric = {
+      id,
+      timestamp: Date.now(),
+      startTime: Date.now(),
+      firstTokenReceivedTime: null,
+      lastTokenReceivedTime: null,
+      completed: false,
+      metrics: {
+        timeToFirstToken: null,
+        totalDuration: null,
+        tokenCount: 0,
+        averageTokenLatency: null
+      },
+      tags: { ...this.config.tags, ...tags }
+    };
+    this.activeMetrics.set(id, metric);
+    return metric;
+  }
+  /**
+   * Record first token received
+   */
+  recordFirstToken(id) {
+    const metric = this.activeMetrics.get(id);
+    if (!metric) {
+      throw new MonitorError(`No active metric found for id ${id}`);
+    }
+    if (metric.firstTokenReceivedTime === null) {
+      const updated = {
+        ...metric,
+        firstTokenReceivedTime: Date.now(),
+        metrics: {
+          ...metric.metrics,
+          timeToFirstToken: Date.now() - metric.startTime,
+          tokenCount: 1
+        }
+      };
+      this.activeMetrics.set(id, updated);
+      if (this.config.enableRealtime) {
+        this.config.onMetric(updated);
+      }
+    }
+  }
+  /**
+   * Record token received
+   */
+  recordToken(id) {
+    const metric = this.activeMetrics.get(id);
+    if (!metric) {
+      throw new MonitorError(`No active metric found for id ${id}`);
+    }
+    const updated = {
+      ...metric,
+      lastTokenReceivedTime: Date.now(),
+      metrics: {
+        ...metric.metrics,
+        tokenCount: metric.metrics.tokenCount + 1
+      }
+    };
+    this.activeMetrics.set(id, updated);
+  }
+  /**
+   * Complete tracking for a voice interaction
+   */
+  completeTracking(id) {
+    const metric = this.activeMetrics.get(id);
+    if (!metric) {
+      throw new MonitorError(`No active metric found for id ${id}`);
+    }
+    const lastTime = metric.lastTokenReceivedTime ?? Date.now();
+    const totalDuration = lastTime - metric.startTime;
+    const avgLatency = metric.metrics.tokenCount > 0 ? totalDuration / metric.metrics.tokenCount : null;
+    const completed = {
+      ...metric,
+      completed: true,
+      metrics: {
+        ...metric.metrics,
+        totalDuration,
+        averageTokenLatency: avgLatency
+      }
+    };
+    this.activeMetrics.delete(id);
+    this.collector.addMetric(completed);
+    if (this.config.enableRealtime) {
+      this.config.onMetric(completed);
+    }
+    return completed;
+  }
+  /**
+   * Wrap an async iterable with automatic tracking
+   */
+  async *track(id, input, tags) {
+    this.startTracking(id, tags);
+    let firstToken = true;
+    try {
+      for await (const chunk of input) {
+        if (firstToken) {
+          this.recordFirstToken(id);
+          firstToken = false;
+        } else {
+          this.recordToken(id);
+        }
+        yield chunk;
+      }
+    } finally {
+      this.completeTracking(id);
+    }
+  }
+  /**
+   * Get all collected metrics
+   */
+  getMetrics() {
+    return this.collector.getMetrics();
+  }
+  /**
+   * Get summary statistics
+   */
+  getSummary() {
+    return this.collector.getSummary();
+  }
+  /**
+   * Export metrics in specified format
+   */
+  export(format) {
+    const metrics = this.collector.getMetrics();
+    switch (format) {
+      case "json":
+        return exportToJson(metrics);
+      case "csv":
+        return exportToCsv(metrics);
+      default:
+        throw new MonitorError(`Unsupported export format: ${format}`);
+    }
+  }
+  /**
+   * Clear all collected metrics
+   */
+  clear() {
+    this.activeMetrics.clear();
+    this.collector.clear();
+  }
+};
+
+export { MetricsCollector, VoiceAuditor, exportToCsv, exportToJson };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/monitor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors.ts","../../src/monitor/exporters/csv.ts","../../src/monitor/exporters/json.ts","../../src/monitor/metrics-collector.ts","../../src/monitor/voice-auditor.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 { VoiceMetric } from '../types';\n\n/**\n * Export metrics to CSV format\n */\nexport function exportToCsv(metrics: readonly VoiceMetric[]): string {\n  const headers = [\n    'id',\n    'timestamp',\n    'completed',\n    'timeToFirstToken',\n    'totalDuration',\n    'tokenCount',\n    'averageTokenLatency',\n    'tags',\n  ];\n\n  const rows = metrics.map((m) => [\n    m.id,\n    m.timestamp.toString(),\n    m.completed.toString(),\n    m.metrics.timeToFirstToken?.toString() ?? '',\n    m.metrics.totalDuration?.toString() ?? '',\n    m.metrics.tokenCount.toString(),\n    m.metrics.averageTokenLatency?.toString() ?? '',\n    JSON.stringify(m.tags),\n  ]);\n\n  const csvLines = [\n    headers.join(','),\n    ...rows.map((row) =>\n      row\n        .map((cell) => {\n          // Escape commas and quotes in cell values\n          if (cell.includes(',') || cell.includes('\"') || cell.includes('\\n')) {\n            return `\"${cell.replace(/\"/g, '\"\"')}\"`;\n          }\n          return cell;\n        })\n        .join(',')\n    ),\n  ];\n\n  return csvLines.join('\\n');\n}\n","import type { VoiceMetric } from '../types';\n\n/**\n * Export metrics to JSON format\n */\nexport function exportToJson(metrics: readonly VoiceMetric[]): string {\n  return JSON.stringify(\n    {\n      exportedAt: new Date().toISOString(),\n      count: metrics.length,\n      metrics: metrics.map((m) => ({\n        id: m.id,\n        timestamp: m.timestamp,\n        completed: m.completed,\n        timeToFirstToken: m.metrics.timeToFirstToken,\n        totalDuration: m.metrics.totalDuration,\n        tokenCount: m.metrics.tokenCount,\n        averageTokenLatency: m.metrics.averageTokenLatency,\n        tags: m.tags,\n      })),\n    },\n    null,\n    2\n  );\n}\n","import type { MetricsSummary, VoiceMetric } from './types';\n\n/**\n * Collects and aggregates metrics\n */\nexport class MetricsCollector {\n  private metrics: VoiceMetric[] = [];\n\n  addMetric(metric: VoiceMetric): void {\n    this.metrics.push(metric);\n  }\n\n  getMetrics(): readonly VoiceMetric[] {\n    return [...this.metrics];\n  }\n\n  getSummary(): MetricsSummary {\n    if (this.metrics.length === 0) {\n      return {\n        count: 0,\n        avgTimeToFirstToken: 0,\n        avgTotalDuration: 0,\n        p50TimeToFirstToken: 0,\n        p95TimeToFirstToken: 0,\n        p99TimeToFirstToken: 0,\n        minTimeToFirstToken: 0,\n        maxTimeToFirstToken: 0,\n      };\n    }\n\n    const ttfts = this.metrics\n      .map((m) => m.metrics.timeToFirstToken)\n      .filter((t): t is number => t !== null)\n      .sort((a, b) => a - b);\n\n    const durations = this.metrics\n      .map((m) => m.metrics.totalDuration)\n      .filter((d): d is number => d !== null);\n\n    const percentile = (arr: number[], p: number): number => {\n      if (arr.length === 0) return 0;\n      const index = Math.ceil(arr.length * p) - 1;\n      return arr[index] ?? 0;\n    };\n\n    return {\n      count: this.metrics.length,\n      avgTimeToFirstToken: ttfts.reduce((a, b) => a + b, 0) / ttfts.length || 0,\n      avgTotalDuration: durations.reduce((a, b) => a + b, 0) / durations.length || 0,\n      p50TimeToFirstToken: percentile(ttfts, 0.5),\n      p95TimeToFirstToken: percentile(ttfts, 0.95),\n      p99TimeToFirstToken: percentile(ttfts, 0.99),\n      minTimeToFirstToken: ttfts.length > 0 ? Math.min(...ttfts) : 0,\n      maxTimeToFirstToken: ttfts.length > 0 ? Math.max(...ttfts) : 0,\n    };\n  }\n\n  clear(): void {\n    this.metrics = [];\n  }\n}\n","import { MonitorError } from '../errors';\nimport { exportToCsv, exportToJson } from './exporters';\nimport { MetricsCollector } from './metrics-collector';\nimport type { AuditorConfig, ExportFormat, MetricsSummary, VoiceMetric } from './types';\n\n/**\n * Voice latency auditor and profiler\n */\nexport class VoiceAuditor {\n  private readonly config: Required<AuditorConfig>;\n  private readonly collector: MetricsCollector;\n  private activeMetrics = new Map<string, VoiceMetric>();\n\n  constructor(config: AuditorConfig = {}) {\n    this.config = {\n      enableRealtime: config.enableRealtime ?? false,\n      onMetric: config.onMetric ?? (() => {}),\n      tags: config.tags ?? {},\n    };\n    this.collector = new MetricsCollector();\n  }\n\n  /**\n   * Start tracking a new voice interaction\n   */\n  startTracking(id: string, tags?: Record<string, string>): VoiceMetric {\n    if (this.activeMetrics.has(id)) {\n      throw new MonitorError(`Metric with id ${id} is already being tracked`);\n    }\n\n    const metric: VoiceMetric = {\n      id,\n      timestamp: Date.now(),\n      startTime: Date.now(),\n      firstTokenReceivedTime: null,\n      lastTokenReceivedTime: null,\n      completed: false,\n      metrics: {\n        timeToFirstToken: null,\n        totalDuration: null,\n        tokenCount: 0,\n        averageTokenLatency: null,\n      },\n      tags: { ...this.config.tags, ...tags },\n    };\n\n    this.activeMetrics.set(id, metric);\n    return metric;\n  }\n\n  /**\n   * Record first token received\n   */\n  recordFirstToken(id: string): void {\n    const metric = this.activeMetrics.get(id);\n    if (!metric) {\n      throw new MonitorError(`No active metric found for id ${id}`);\n    }\n\n    if (metric.firstTokenReceivedTime === null) {\n      const updated: VoiceMetric = {\n        ...metric,\n        firstTokenReceivedTime: Date.now(),\n        metrics: {\n          ...metric.metrics,\n          timeToFirstToken: Date.now() - metric.startTime,\n          tokenCount: 1,\n        },\n      };\n      this.activeMetrics.set(id, updated);\n\n      if (this.config.enableRealtime) {\n        this.config.onMetric(updated);\n      }\n    }\n  }\n\n  /**\n   * Record token received\n   */\n  recordToken(id: string): void {\n    const metric = this.activeMetrics.get(id);\n    if (!metric) {\n      throw new MonitorError(`No active metric found for id ${id}`);\n    }\n\n    const updated: VoiceMetric = {\n      ...metric,\n      lastTokenReceivedTime: Date.now(),\n      metrics: {\n        ...metric.metrics,\n        tokenCount: metric.metrics.tokenCount + 1,\n      },\n    };\n    this.activeMetrics.set(id, updated);\n  }\n\n  /**\n   * Complete tracking for a voice interaction\n   */\n  completeTracking(id: string): VoiceMetric {\n    const metric = this.activeMetrics.get(id);\n    if (!metric) {\n      throw new MonitorError(`No active metric found for id ${id}`);\n    }\n\n    const lastTime = metric.lastTokenReceivedTime ?? Date.now();\n    const totalDuration = lastTime - metric.startTime;\n    const avgLatency =\n      metric.metrics.tokenCount > 0 ? totalDuration / metric.metrics.tokenCount : null;\n\n    const completed: VoiceMetric = {\n      ...metric,\n      completed: true,\n      metrics: {\n        ...metric.metrics,\n        totalDuration,\n        averageTokenLatency: avgLatency,\n      },\n    };\n\n    this.activeMetrics.delete(id);\n    this.collector.addMetric(completed);\n\n    if (this.config.enableRealtime) {\n      this.config.onMetric(completed);\n    }\n\n    return completed;\n  }\n\n  /**\n   * Wrap an async iterable with automatic tracking\n   */\n  async *track(\n    id: string,\n    input: AsyncIterable<string>,\n    tags?: Record<string, string>\n  ): AsyncIterable<string> {\n    this.startTracking(id, tags);\n\n    let firstToken = true;\n    try {\n      for await (const chunk of input) {\n        if (firstToken) {\n          this.recordFirstToken(id);\n          firstToken = false;\n        } else {\n          this.recordToken(id);\n        }\n        yield chunk;\n      }\n    } finally {\n      this.completeTracking(id);\n    }\n  }\n\n  /**\n   * Get all collected metrics\n   */\n  getMetrics(): readonly VoiceMetric[] {\n    return this.collector.getMetrics();\n  }\n\n  /**\n   * Get summary statistics\n   */\n  getSummary(): MetricsSummary {\n    return this.collector.getSummary();\n  }\n\n  /**\n   * Export metrics in specified format\n   */\n  export(format: ExportFormat): string {\n    const metrics = this.collector.getMetrics();\n\n    switch (format) {\n      case 'json':\n        return exportToJson(metrics);\n      case 'csv':\n        return exportToCsv(metrics);\n      default:\n        throw new MonitorError(`Unsupported export format: ${format}`);\n    }\n  }\n\n  /**\n   * Clear all collected metrics\n   */\n  clear(): void {\n    this.activeMetrics.clear();\n    this.collector.clear();\n  }\n}\n"]}

package/dist/sanitizer/index.cjs

@@ -0,0 +1,190 @@
+'use strict';
+
+// 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);
+}
+
+exports.SpeechSanitizer = SpeechSanitizer;
+exports.ruleRegistry = ruleRegistry;
+exports.sanitizeForSpeech = sanitizeForSpeech;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/sanitizer/index.cjs.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.cjs","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"]}