@nac3/forge-cli 0.2.0-alpha.3 → 0.2.0-alpha.31

package/dist/support/reports.js

@@ -0,0 +1,162 @@
+/**
+ * Support report sink. Captures runtime errors from the chat
+ * panel (window.onerror, unhandled promise rejection, fetch
+ * failures) and persists them to a local JSONL log so we have
+ * a reproducible trail when a user reports "no me escucha" or
+ * "nada anda".
+ *
+ * Per SQ Sec 15: this surface exists so the user does NOT
+ * have to open DevTools + copy logs. Forge sees what the
+ * browser saw, from the server side.
+ *
+ * Where: ~/.yujin-forge/support_reports.jsonl
+ *
+ * Rotation: when the file exceeds 5 MB, the existing file is
+ * renamed to support_reports.jsonl.1 (previous .1 deleted) and
+ * a fresh file starts. One generation of history kept.
+ *
+ * PII scrubbing: emails + bearer tokens + sk-* keys + 32+ hex
+ * blobs are replaced with <redacted>.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { configDir } from '../license/index.js';
+const MAX_FILE_BYTES = 5 * 1024 * 1024;
+const PII_REGEXES = [
+    { re: /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g, replace: '<redacted-email>' },
+    { re: /sk-ant-[A-Za-z0-9_-]{20,}/g, replace: '<redacted-anthropic-key>' },
+    { re: /sk-[A-Za-z0-9_-]{20,}/g, replace: '<redacted-api-key>' },
+    { re: /Bearer\s+[A-Za-z0-9._-]{20,}/g, replace: 'Bearer <redacted>' },
+    { re: /\b[a-f0-9]{40,}\b/g, replace: '<redacted-hex>' },
+];
+/** Replace PII patterns in any string field of the report. */
+export function scrubPii(report) {
+    const out = { ...report };
+    const passFields = ['message', 'stack', 'url', 'user_agent', 'view'];
+    for (const f of passFields) {
+        const v = out[f];
+        if (typeof v === 'string') {
+            let scrubbed = v;
+            for (const { re, replace } of PII_REGEXES) {
+                scrubbed = scrubbed.replace(re, replace);
+            }
+            out[f] = scrubbed;
+        }
+    }
+    /* Also scrub request_trail URLs (could contain tokens in
+     * query strings). */
+    if (Array.isArray(out.request_trail)) {
+        out.request_trail = out.request_trail.map((r) => {
+            let u = r.url;
+            for (const { re, replace } of PII_REGEXES)
+                u = u.replace(re, replace);
+            return { ...r, url: u };
+        });
+    }
+    return out;
+}
+function reportsFile() {
+    return path.join(configDir(), 'support_reports.jsonl');
+}
+function rotatedFile() {
+    return path.join(configDir(), 'support_reports.jsonl.1');
+}
+async function ensureDir() {
+    try {
+        await fs.mkdir(configDir(), { recursive: true });
+    }
+    catch { /* ok */ }
+}
+async function rotateIfBig() {
+    try {
+        const st = await fs.stat(reportsFile());
+        if (st.size > MAX_FILE_BYTES) {
+            try {
+                await fs.unlink(rotatedFile());
+            }
+            catch { /* ok */ }
+            await fs.rename(reportsFile(), rotatedFile());
+        }
+    }
+    catch { /* file does not exist yet, nothing to rotate */ }
+}
+/** Append a single report. Never throws. */
+export async function recordReport(report) {
+    try {
+        await ensureDir();
+        await rotateIfBig();
+        const scrubbed = scrubPii(report);
+        await fs.appendFile(reportsFile(), JSON.stringify(scrubbed) + '\n', 'utf-8');
+    }
+    catch {
+        /* swallow */
+    }
+}
+/** Read all reports (current + rotated). Tolerates malformed lines. */
+export async function readReports() {
+    const all = [];
+    for (const fp of [rotatedFile(), reportsFile()]) {
+        try {
+            const raw = await fs.readFile(fp, 'utf-8');
+            for (const line of raw.split('\n')) {
+                if (line.trim() === '')
+                    continue;
+                try {
+                    all.push(JSON.parse(line));
+                }
+                catch { /* skip */ }
+            }
+        }
+        catch { /* file may not exist */ }
+    }
+    return all;
+}
+/** Validate + normalize an inbound payload from the panel.
+ *  Returns null when the payload shape is unacceptable. */
+export function validateInbound(body, defaults = {}) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return null;
+    const b = body;
+    const level = b.level;
+    if (level !== 'error' && level !== 'warn' && level !== 'info')
+        return null;
+    const source = typeof b.source === 'string' ? b.source : 'panel';
+    const message = typeof b.message === 'string' ? b.message : '';
+    if (message === '')
+        return null;
+    const report = {
+        ts: new Date().toISOString(),
+        level,
+        source,
+        message: message.slice(0, 2000),
+    };
+    if (typeof b.stack === 'string')
+        report.stack = b.stack.slice(0, 8000);
+    if (typeof b.url === 'string')
+        report.url = b.url.slice(0, 500);
+    if (typeof b.line === 'number')
+        report.line = b.line;
+    if (typeof b.col === 'number')
+        report.col = b.col;
+    if (typeof b.view === 'string')
+        report.view = b.view.slice(0, 100);
+    if (typeof b.client_ts === 'string')
+        report.client_ts = b.client_ts.slice(0, 64);
+    if (defaults.user_agent)
+        report.user_agent = defaults.user_agent.slice(0, 200);
+    if (Array.isArray(b.request_trail)) {
+        report.request_trail = b.request_trail
+            .slice(-10)
+            .filter((r) => r && typeof r === 'object'
+            && typeof r.method === 'string' && typeof r.url === 'string')
+            .map((r) => ({
+            method: String(r.method).slice(0, 10),
+            url: String(r.url).slice(0, 500),
+            ...(typeof r.status === 'number' ? { status: r.status } : {}),
+        }));
+    }
+    return report;
+}
+//# sourceMappingURL=reports.js.map

package/dist/support/reports.js.map

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

package/dist/telemetry/usage.d.ts

@@ -0,0 +1,67 @@
+export type UsageKind = 'claude.chat' | 'claude.spec' | 'claude.clarify' | 'claude.triage' | 'voice.tts' | 'voice.stt' | 'misc';
+export interface UsageEvent {
+    ts: string;
+    kind: UsageKind;
+    model?: string;
+    tokens_in?: number;
+    tokens_out?: number;
+    units?: number;
+    label?: string;
+    project_root?: string;
+}
+export interface PricingTable {
+    models?: Record<string, {
+        in_per_mtok: number;
+        out_per_mtok: number;
+    }>;
+    voice?: {
+        tts_per_million_chars?: number;
+        stt_per_minute?: number;
+    };
+}
+export declare const DEFAULT_PRICING: PricingTable;
+/**
+ * Append a usage event. Never throws -- failures swallowed.
+ */
+export declare function recordUsage(ev: Omit<UsageEvent, 'ts'> & {
+    ts?: string;
+}): Promise<void>;
+/**
+ * Load pricing table (defaults overlaid with user overrides).
+ */
+export declare function loadPricing(): Promise<PricingTable>;
+/**
+ * Read all usage events. Tolerates malformed lines.
+ */
+export declare function readUsage(): Promise<UsageEvent[]>;
+export interface CostBreakdown {
+    total_usd: number;
+    by_kind: Record<string, {
+        count: number;
+        usd: number;
+    }>;
+    by_model: Record<string, {
+        count: number;
+        tokens_in: number;
+        tokens_out: number;
+        usd: number;
+    }>;
+    by_day: Record<string, {
+        count: number;
+        usd: number;
+    }>;
+    events_total: number;
+    events_window: number;
+    window_label: string;
+}
+/**
+ * Compute cost breakdown over a time window. `sinceDays` defaults
+ * to 30. Pass 0 to mean "all-time".
+ */
+export declare function computeCosts(sinceDays?: number): Promise<CostBreakdown>;
+/**
+ * Pretty-format a CostBreakdown for terminal output. Returns
+ * lines; caller does the printing.
+ */
+export declare function formatCosts(b: CostBreakdown): string[];
+//# sourceMappingURL=usage.d.ts.map

package/dist/telemetry/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/telemetry/usage.ts"],"names":[],"mappings":"AAiCA,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,UAAU;IACzB,EAAE,EAAY,MAAM,CAAC;IACrB,IAAI,EAAU,SAAS,CAAC;IACxB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,SAAS,CAAC,EAAI,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,YAAY,CAAC,EAAC,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,KAAK,CAAC,EAAG;QACP,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,cAAc,CAAC,EAAS,MAAM,CAAC;KAChC,CAAC;CACH;AAID,eAAO,MAAM,eAAe,EAAE,YAe7B,CAAC;AAaF;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAWzD;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvD;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAO,MAAM,CAAC;IACvB,OAAO,EAAS,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,QAAQ,EAAQ,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,MAAM,EAAU,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,YAAY,EAAI,MAAM,CAAC;IACvB,aAAa,EAAG,MAAM,CAAC;IACvB,YAAY,EAAI,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,SAAS,SAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAsDzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAiCtD"}

package/dist/telemetry/usage.js

@@ -0,0 +1,208 @@
+/**
+ * Yujin Forge -- usage + cost telemetry.
+ *
+ * Append-only event log at ~/.yujin-forge/usage.jsonl. Every
+ * Claude API call (or other priced operation) records one JSONL
+ * line with { ts, kind, model?, tokens_in?, tokens_out?, units?,
+ * label?, project_root? }.
+ *
+ * The reader (`yf operate costs`) aggregates by day + by kind +
+ * by model and applies a pricing table to produce a cost report.
+ *
+ * Append is best-effort: telemetry failures NEVER throw to the
+ * caller -- a broken usage file should not break user work.
+ *
+ * Pricing is hard-coded for the 2026 model lineup. Users can
+ * override via ~/.yujin-forge/pricing.json:
+ *   {
+ *     "models": {
+ *        "claude-opus-4-7":  { "in_per_mtok": 15, "out_per_mtok": 75 },
+ *        "claude-sonnet-4-6": { "in_per_mtok":  3, "out_per_mtok": 15 }
+ *     },
+ *     "voice": {
+ *        "tts_per_million_chars": 16,
+ *        "stt_per_minute":        0.006
+ *     }
+ *   }
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { configDir } from '../license/index.js';
+/* Defaults reflect early-2026 Anthropic + Google Cloud pricing.
+ * Users can override via ~/.yujin-forge/pricing.json. */
+export const DEFAULT_PRICING = {
+    models: {
+        'claude-opus-4-7': { in_per_mtok: 15, out_per_mtok: 75 },
+        'claude-opus-4': { in_per_mtok: 15, out_per_mtok: 75 },
+        'claude-sonnet-4-6': { in_per_mtok: 3, out_per_mtok: 15 },
+        'claude-sonnet-4': { in_per_mtok: 3, out_per_mtok: 15 },
+        'claude-haiku-4-5': { in_per_mtok: 1, out_per_mtok: 5 },
+        /* Older lineup kept for back-compat. */
+        'claude-3-5-sonnet': { in_per_mtok: 3, out_per_mtok: 15 },
+        'claude-3-5-haiku': { in_per_mtok: 0.8, out_per_mtok: 4 },
+    },
+    voice: {
+        tts_per_million_chars: 16, /* Google Cloud TTS Neural2 */
+        stt_per_minute: 0.006, /* Google Cloud STT enhanced */
+    },
+};
+function usageFile() {
+    return path.join(configDir(), 'usage.jsonl');
+}
+function pricingFile() {
+    return path.join(configDir(), 'pricing.json');
+}
+async function ensureDir() {
+    try {
+        await fs.mkdir(configDir(), { recursive: true });
+    }
+    catch { /* best effort */ }
+}
+/**
+ * Append a usage event. Never throws -- failures swallowed.
+ */
+export async function recordUsage(ev) {
+    try {
+        await ensureDir();
+        const line = { ts: ev.ts ?? new Date().toISOString(), ...ev };
+        await fs.appendFile(usageFile(), JSON.stringify(line) + '\n', 'utf-8');
+    }
+    catch {
+        /* swallow -- telemetry must never break user flow */
+    }
+}
+/**
+ * Load pricing table (defaults overlaid with user overrides).
+ */
+export async function loadPricing() {
+    try {
+        const raw = await fs.readFile(pricingFile(), 'utf-8');
+        const override = JSON.parse(raw);
+        return {
+            models: { ...(DEFAULT_PRICING.models ?? {}), ...(override.models ?? {}) },
+            voice: { ...(DEFAULT_PRICING.voice ?? {}), ...(override.voice ?? {}) },
+        };
+    }
+    catch {
+        return DEFAULT_PRICING;
+    }
+}
+/**
+ * Read all usage events. Tolerates malformed lines.
+ */
+export async function readUsage() {
+    try {
+        const raw = await fs.readFile(usageFile(), 'utf-8');
+        return raw.split('\n')
+            .filter((l) => l.trim().length > 0)
+            .map((l) => {
+            try {
+                return JSON.parse(l);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((x) => x !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Compute cost breakdown over a time window. `sinceDays` defaults
+ * to 30. Pass 0 to mean "all-time".
+ */
+export async function computeCosts(sinceDays = 30) {
+    const events = await readUsage();
+    const pricing = await loadPricing();
+    const now = Date.now();
+    const cutoffMs = sinceDays > 0 ? now - sinceDays * 24 * 60 * 60 * 1000 : 0;
+    const inWindow = events.filter((e) => Date.parse(e.ts) >= cutoffMs);
+    const breakdown = {
+        total_usd: 0,
+        by_kind: {},
+        by_model: {},
+        by_day: {},
+        events_total: events.length,
+        events_window: inWindow.length,
+        window_label: sinceDays === 0 ? 'all-time' : 'last ' + sinceDays + ' days',
+    };
+    for (const ev of inWindow) {
+        let usd = 0;
+        if (ev.kind.startsWith('claude.')) {
+            const m = ev.model ?? 'unknown';
+            const p = pricing.models?.[m];
+            if (p) {
+                usd = ((ev.tokens_in ?? 0) / 1_000_000) * p.in_per_mtok
+                    + ((ev.tokens_out ?? 0) / 1_000_000) * p.out_per_mtok;
+            }
+            if (!breakdown.by_model[m]) {
+                breakdown.by_model[m] = { count: 0, tokens_in: 0, tokens_out: 0, usd: 0 };
+            }
+            const slot = breakdown.by_model[m];
+            slot.count++;
+            slot.tokens_in += ev.tokens_in ?? 0;
+            slot.tokens_out += ev.tokens_out ?? 0;
+            slot.usd += usd;
+        }
+        else if (ev.kind === 'voice.tts') {
+            usd = ((ev.units ?? 0) / 1_000_000) * (pricing.voice?.tts_per_million_chars ?? 0);
+        }
+        else if (ev.kind === 'voice.stt') {
+            usd = (ev.units ?? 0) * (pricing.voice?.stt_per_minute ?? 0);
+        }
+        breakdown.total_usd += usd;
+        if (!breakdown.by_kind[ev.kind])
+            breakdown.by_kind[ev.kind] = { count: 0, usd: 0 };
+        breakdown.by_kind[ev.kind].count++;
+        breakdown.by_kind[ev.kind].usd += usd;
+        const day = ev.ts.slice(0, 10);
+        if (!breakdown.by_day[day])
+            breakdown.by_day[day] = { count: 0, usd: 0 };
+        breakdown.by_day[day].count++;
+        breakdown.by_day[day].usd += usd;
+    }
+    return breakdown;
+}
+/**
+ * Pretty-format a CostBreakdown for terminal output. Returns
+ * lines; caller does the printing.
+ */
+export function formatCosts(b) {
+    const lines = [];
+    lines.push('Window:          ' + b.window_label);
+    lines.push('Events total:    ' + b.events_total);
+    lines.push('Events in window:' + b.events_window);
+    lines.push('Total USD:       $' + b.total_usd.toFixed(4));
+    lines.push('');
+    lines.push('By kind:');
+    const kinds = Object.entries(b.by_kind).sort((a, c) => c[1].usd - a[1].usd);
+    for (const [k, v] of kinds) {
+        lines.push('  ' + k.padEnd(18) + 'count=' + String(v.count).padStart(5) + '  usd=$' + v.usd.toFixed(4));
+    }
+    if (Object.keys(b.by_model).length > 0) {
+        lines.push('');
+        lines.push('By model:');
+        const models = Object.entries(b.by_model).sort((a, c) => c[1].usd - a[1].usd);
+        for (const [m, v] of models) {
+            lines.push('  ' + m.padEnd(24)
+                + 'count=' + String(v.count).padStart(5)
+                + '  in=' + String(v.tokens_in).padStart(8)
+                + '  out=' + String(v.tokens_out).padStart(7)
+                + '  usd=$' + v.usd.toFixed(4));
+        }
+    }
+    if (Object.keys(b.by_day).length > 0) {
+        lines.push('');
+        lines.push('By day:');
+        const days = Object.entries(b.by_day).sort((a, c) => (a[0] < c[0] ? 1 : -1)).slice(0, 14);
+        for (const [d, v] of days) {
+            lines.push('  ' + d + '  count=' + String(v.count).padStart(5) + '  usd=$' + v.usd.toFixed(4));
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=usage.js.map

package/dist/telemetry/usage.js.map

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

package/dist/version.d.ts

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export declare const VERSION = "0.2.0-alpha.3";
+export declare const VERSION = "0.2.0-alpha.31";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,mBAAmB,CAAC"}

package/dist/version.js

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export const VERSION = '0.2.0-alpha.3';
+export const VERSION = '0.2.0-alpha.31';
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC"}

package/dist/voice/intents.d.ts

@@ -35,7 +35,7 @@
  * the contract is the literal string the chat dispatcher
  * accepts. If a tool is renamed there, this list must follow.
  */
-export type ReaderToolName = 'forge.reader.open' | 'forge.reader.list_documents' | 'forge.reader.read_section' | 'forge.reader.next_block' | 'forge.reader.search' | 'forge.reader.bookmark_set' | 'forge.reader.bookmark_jump' | 'forge.reader.recap' | 'forge.manual.open';
+export type ReaderToolName = 'forge_reader_open' | 'forge_reader_list_documents' | 'forge_reader_read_section' | 'forge_reader_next_block' | 'forge_reader_search' | 'forge_reader_bookmark_set' | 'forge_reader_bookmark_jump' | 'forge_reader_recap' | 'forge_manual_open';
 export interface MatchedIntent {
     tool: ReaderToolName;
     args: Record<string, unknown>;

package/dist/voice/providers/google.d.ts

@@ -27,6 +27,15 @@ export interface GoogleProviderOptions {
     fetchImpl?: typeof fetch;
     vaultOpener?: () => Promise<Vault>;
 }
+/** Google STT enhanced models only certify a subset of Spanish
+ *  locale codes. Map any specifically-regional Latin-Spanish
+ *  locale (es-AR, es-CL, es-PE, es-CO, es-VE, etc) to es-US
+ *  (Latin American Spanish neutral). Pass through:
+ *    es-ES (Spain), es-US (Latin neutral), es-419 (Latin
+ *    generic) -- all supported directly by latest_long +
+ *    useEnhanced. Bare 'es' also routes to es-US.
+ *  Exported for tests. */
+export declare function normaliseSpanishLocale(locale: string): string;
 /** Map our SttAudioFormat to Google's encoding enum. */
 declare function sttFormatToGoogleEncoding(format: SttAudioFormat): string;
 /** Map our TtsAudioFormat to Google's audio encoding enum. */

package/dist/voice/providers/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/voice/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAQrB,QAAA,MAAM,UAAU,iBAAiB,CAAC;AAElC,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;CACpC;AAED,wDAAwD;AACxD,iBAAS,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAUjE;AAED,8DAA8D;AAC9D,iBAAS,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQjE;AAqBD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,EAAE,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,IAAI,GAAE,qBAA0B;IAKtC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAS9B,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CAwExD;AAMD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,EAAE,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,IAAI,GAAE,qBAA0B;IAKtC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAS9B,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAiEvD;qDACiD;IACjD,OAAO,CAAC,sBAAsB;IAQ9B,qDAAqD;IACrD,OAAO,CAAC,UAAU;CAMnB;AAGD,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../../src/voice/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAuErB,QAAA,MAAM,UAAU,iBAAiB,CAAC;AAElC,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;CACpC;AAED;;;;;;;0BAO0B;AAC1B,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED,wDAAwD;AACxD,iBAAS,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAUjE;AAED,8DAA8D;AAC9D,iBAAS,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQjE;AA4ED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,EAAE,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,IAAI,GAAE,qBAA0B;IAKtC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CAgGxD;AAMD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,EAAE,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,IAAI,GAAE,qBAA0B;IAKtC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoGvD;qDACiD;IACjD,OAAO,CAAC,sBAAsB;IAQ9B,qDAAqD;IACrD,OAAO,CAAC,UAAU;CAMnB;AAGD,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,UAAU,EAAE,CAAC"}