@nac3/forge-cli 0.2.0-alpha.1

package/dist/voice/intents.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Voice intent matcher for reader commands (V1.29 of HITO 1).
+ *
+ * Pure function. Given a STT transcript, returns a tool invocation
+ * (tool name + args) if the utterance is a recognised reader
+ * command, or null if it should fall through to the Claude
+ * chat tool-use loop.
+ *
+ * Hand-rolled matcher. No LLM round-trip for these common phrases
+ * -- low latency matters for the ADIP usability target.
+ *
+ * Patterns recognised (Spanish first, then English):
+ *
+ *   open                -> forge.reader.open
+ *   list documents      -> forge.reader.list_documents
+ *   next block          -> forge.reader.next_block
+ *   read section        -> forge.reader.read_section
+ *   search "X"          -> forge.reader.search
+ *   bookmark set "X"    -> forge.reader.bookmark_set
+ *   bookmark jump "X"   -> forge.reader.bookmark_jump
+ *   recap               -> forge.reader.recap
+ *
+ * Each pattern is intentionally permissive so that natural
+ * phrasing -- "leeme el readme.md", "que sigue", "marca aqui
+ * como inicio" -- maps cleanly. False positives degrade by
+ * falling through to Claude, which is the safe default.
+ *
+ * ASCII only. No accents in patterns (we strip diacritics from
+ * the utterance before matching, so the user CAN dictate with
+ * accents and still match).
+ */
+/**
+ * Reader tool names this matcher can resolve to. Kept local
+ * (not imported) because tools.ts does not export a union;
+ * 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 interface MatchedIntent {
+    tool: ReaderToolName;
+    args: Record<string, unknown>;
+    utterance_normalised: string;
+    pattern: string;
+}
+export interface IntentMatchContext {
+    /** doc_id of the most recently opened document, if any. Used
+     *  to default args.doc_id for commands that need a target. */
+    active_doc_id?: string;
+}
+/**
+ * Strip diacritics + lowercase + collapse whitespace. Keeps
+ * apostrophes and quotes (they survive as content markers).
+ *
+ * The NFD + combining-mark strip is safe for non-Latin scripts:
+ * Hindi (Devanagari), Arabic, Japanese, Chinese all keep their
+ * code points intact; only Latin diacritics (a-acute, n-tilde,
+ * etc) get folded. toLowerCase is also safe across these
+ * scripts (CJK ideographs have no case; Arabic + Devanagari
+ * letters are case-less).
+ */
+export declare function normaliseUtterance(text: string): string;
+/**
+ * Match a transcribed utterance against the reader-intent
+ * catalogue. Returns the first matching tool invocation, or
+ * null to fall through to the chat tool-use loop.
+ */
+export declare function matchReaderIntent(utterance: string, ctx?: IntentMatchContext): MatchedIntent | null;
+/** Internal -- exposed for unit tests so we can enumerate
+ *  the catalogue without coupling to its order. */
+export declare function _listReaderIntentPatterns(): string[];
+//# sourceMappingURL=intents.d.ts.map

package/dist/voice/intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intents.d.ts","sourceRoot":"","sources":["../../src/voice/intents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,6BAA6B,GAC7B,2BAA2B,GAC3B,yBAAyB,GACzB,qBAAqB,GACrB,2BAA2B,GAC3B,4BAA4B,GAC5B,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAG9B,oBAAoB,EAAE,MAAM,CAAC;IAG7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;kEAC8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASvD;AAiVD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,kBAAuB,GAC3B,aAAa,GAAG,IAAI,CAiBtB;AAED;mDACmD;AACnD,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD"}

package/dist/voice/intents.js.map

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

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

@@ -0,0 +1,53 @@
+/**
+ * ElevenLabs TTS provider.
+ *
+ * Premium TTS quality, multilingual model. TTS-only -- ElevenLabs
+ * does not offer STT.
+ *
+ * Endpoint: POST https://api.elevenlabs.io/v1/text-to-speech/<voice_id>
+ * Auth:     xi-api-key header.
+ * Body:     { text, model_id, voice_settings: { stability,
+ *                                               similarity_boost,
+ *                                               style,
+ *                                               use_speaker_boost } }
+ * Response: raw audio bytes (NOT JSON).
+ *
+ * Vault slot: `elevenlabs`.
+ *
+ * Loud failures (per ROADMAP sec 12.2):
+ *   - Empty text -> hard error.
+ *   - Missing vault slot -> hard error with the slot name +
+ *     the `yf vault set elevenlabs` command.
+ *   - HTTP non-2xx -> hard error with status + body snippet.
+ *   - Empty response body -> hard error.
+ *
+ * ASCII-only.
+ */
+import { Vault } from '../../vault/store.js';
+import type { TtsProvider, TtsRequest, TtsResponse, TtsAudioFormat } from '../types.js';
+declare const VAULT_SLOT = "elevenlabs";
+/** "Rachel" -- ElevenLabs's stock English voice, used as a sensible
+ *  baseline when the caller does not specify a voice. */
+declare const DEFAULT_VOICE = "21m00Tcm4TlvDq8ikWAM";
+declare const DEFAULT_MODEL = "eleven_multilingual_v2";
+/** Map our format enum to ElevenLabs's `output_format` query param. */
+declare function ttsFormatToElevenOutput(format: TtsAudioFormat): string;
+/** When the API returns an opaque MIME other than the format we
+ *  expected, label what we actually got. ElevenLabs returns
+ *  audio/mpeg for mp3_* / audio/wav for pcm_* / audio/basic for
+ *  ulaw_* per its docs. */
+declare function detectFormatFromMime(mime: string | null): TtsAudioFormat;
+export interface ElevenLabsProviderOptions {
+    fetchImpl?: typeof fetch;
+    vaultOpener?: () => Promise<Vault>;
+}
+export declare class ElevenLabsProvider implements TtsProvider {
+    readonly id = "elevenlabs";
+    private readonly fetchImpl;
+    private readonly vaultOpener;
+    constructor(opts?: ElevenLabsProviderOptions);
+    readyToRun(): Promise<boolean>;
+    synthesize(req: TtsRequest): Promise<TtsResponse>;
+}
+export { ttsFormatToElevenOutput, detectFormatFromMime, VAULT_SLOT, DEFAULT_VOICE, DEFAULT_MODEL, };
+//# sourceMappingURL=elevenlabs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs.d.ts","sourceRoot":"","sources":["../../../src/voice/providers/elevenlabs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,QAAA,MAAM,UAAU,eAAe,CAAC;AAEhC;yDACyD;AACzD,QAAA,MAAM,aAAa,yBAAyB,CAAC;AAC7C,QAAA,MAAM,aAAa,2BAA2B,CAAC;AAG/C,uEAAuE;AACvE,iBAAS,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAQ/D;AAED;;;2BAG2B;AAC3B,iBAAS,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAMjE;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;CACpC;AAMD,qBAAa,kBAAmB,YAAW,WAAW;IACpD,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,IAAI,GAAE,yBAA8B;IAK1C,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAS9B,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CAuFxD;AAGD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,aAAa,GACd,CAAC"}

package/dist/voice/providers/elevenlabs.js

@@ -0,0 +1,159 @@
+/**
+ * ElevenLabs TTS provider.
+ *
+ * Premium TTS quality, multilingual model. TTS-only -- ElevenLabs
+ * does not offer STT.
+ *
+ * Endpoint: POST https://api.elevenlabs.io/v1/text-to-speech/<voice_id>
+ * Auth:     xi-api-key header.
+ * Body:     { text, model_id, voice_settings: { stability,
+ *                                               similarity_boost,
+ *                                               style,
+ *                                               use_speaker_boost } }
+ * Response: raw audio bytes (NOT JSON).
+ *
+ * Vault slot: `elevenlabs`.
+ *
+ * Loud failures (per ROADMAP sec 12.2):
+ *   - Empty text -> hard error.
+ *   - Missing vault slot -> hard error with the slot name +
+ *     the `yf vault set elevenlabs` command.
+ *   - HTTP non-2xx -> hard error with status + body snippet.
+ *   - Empty response body -> hard error.
+ *
+ * ASCII-only.
+ */
+import { Vault } from '../../vault/store.js';
+import { configDir } from '../../license/index.js';
+const VAULT_SLOT = 'elevenlabs';
+const ENDPOINT_BASE = 'https://api.elevenlabs.io/v1/text-to-speech/';
+/** "Rachel" -- ElevenLabs's stock English voice, used as a sensible
+ *  baseline when the caller does not specify a voice. */
+const DEFAULT_VOICE = '21m00Tcm4TlvDq8ikWAM';
+const DEFAULT_MODEL = 'eleven_multilingual_v2';
+const DEFAULT_FORMAT = 'mp3';
+/** Map our format enum to ElevenLabs's `output_format` query param. */
+function ttsFormatToElevenOutput(format) {
+    switch (format) {
+        case 'mp3': return 'mp3_44100_128';
+        case 'wav': return 'pcm_44100';
+        case 'ogg':
+        case 'opus': return 'ulaw_8000'; /* closest open-codec available */
+        default: return 'mp3_44100_128';
+    }
+}
+/** When the API returns an opaque MIME other than the format we
+ *  expected, label what we actually got. ElevenLabs returns
+ *  audio/mpeg for mp3_* / audio/wav for pcm_* / audio/basic for
+ *  ulaw_* per its docs. */
+function detectFormatFromMime(mime) {
+    if (!mime)
+        return 'mp3';
+    if (mime.includes('mpeg'))
+        return 'mp3';
+    if (mime.includes('wav') || mime.includes('x-wav'))
+        return 'wav';
+    if (mime.includes('basic') || mime.includes('mulaw'))
+        return 'opus';
+    return 'mp3';
+}
+async function safeText(r) {
+    try {
+        return await r.text();
+    }
+    catch {
+        return '(no body)';
+    }
+}
+export class ElevenLabsProvider {
+    id = 'elevenlabs';
+    fetchImpl;
+    vaultOpener;
+    constructor(opts = {}) {
+        this.fetchImpl = opts.fetchImpl ?? ((u, init) => globalThis.fetch(u, init));
+        this.vaultOpener = opts.vaultOpener ?? (() => Vault.open({ configDir: configDir() }));
+    }
+    async readyToRun() {
+        try {
+            const vault = await this.vaultOpener();
+            return vault.has(VAULT_SLOT);
+        }
+        catch {
+            return false;
+        }
+    }
+    async synthesize(req) {
+        if (!req.text || req.text.trim() === '') {
+            throw new Error('elevenlabs TTS: text is empty');
+        }
+        /* ElevenLabs charges per character + caps at 5000 per request
+           on most plans. Refuse loudly above that so the cost is
+           visible at the call site, not buried in an API rejection. */
+        if (req.text.length > 5000) {
+            throw new Error('elevenlabs TTS: text exceeds 5000 characters ('
+                + req.text.length + '). Split into multiple calls or '
+                + 'use a different provider for long-form content.');
+        }
+        const vault = await this.vaultOpener();
+        if (!vault.has(VAULT_SLOT)) {
+            throw new Error('elevenlabs: vault slot "' + VAULT_SLOT + '" not set. '
+                + 'Run `yf vault set ' + VAULT_SLOT + '` to configure your ElevenLabs key.');
+        }
+        const apiKey = vault.get(VAULT_SLOT);
+        const voiceId = req.voice ?? DEFAULT_VOICE;
+        const format = req.format ?? DEFAULT_FORMAT;
+        const outputFormat = ttsFormatToElevenOutput(format);
+        /* ElevenLabs ignores SSML in v1; we surface the text as-is.
+           The caller can document what works in voice tests. */
+        const body = {
+            text: req.text,
+            model_id: DEFAULT_MODEL,
+            voice_settings: {
+                stability: 0.5,
+                similarity_boost: 0.75,
+                style: 0.0,
+                use_speaker_boost: true,
+            },
+        };
+        const t0 = Date.now();
+        const resp = await this.fetchImpl(ENDPOINT_BASE + encodeURIComponent(voiceId) + '?output_format=' + outputFormat, {
+            method: 'POST',
+            headers: {
+                'xi-api-key': apiKey,
+                'Content-Type': 'application/json',
+                'Accept': 'audio/mpeg, audio/wav, audio/basic, application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        const latency_ms = Date.now() - t0;
+        if (!resp.ok) {
+            const detail = await safeText(resp);
+            throw new Error('elevenlabs TTS API ' + resp.status + ' ' + resp.statusText + ': '
+                + detail.slice(0, 400));
+        }
+        /* The body is binary audio, NOT JSON. Read as ArrayBuffer + Buffer. */
+        let audioBuf;
+        try {
+            const ab = await resp.arrayBuffer();
+            audioBuf = Buffer.from(ab);
+        }
+        catch (err) {
+            throw new Error('elevenlabs TTS: failed to read audio body: ' + (err instanceof Error ? err.message : String(err)));
+        }
+        if (audioBuf.length === 0) {
+            throw new Error('elevenlabs TTS: response body is empty');
+        }
+        const observedMime = typeof resp.headers?.get === 'function' ? resp.headers.get('content-type') : null;
+        const observedFormat = detectFormatFromMime(observedMime);
+        return {
+            audio: audioBuf,
+            format: observedFormat,
+            latency_ms,
+            provider: this.id,
+            voice: voiceId,
+        };
+    }
+}
+/* Exported for tests + the host registry. */
+export { ttsFormatToElevenOutput, detectFormatFromMime, VAULT_SLOT, DEFAULT_VOICE, DEFAULT_MODEL, };
+//# sourceMappingURL=elevenlabs.js.map

package/dist/voice/providers/elevenlabs.js.map

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

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

@@ -0,0 +1,56 @@
+/**
+ * Google Cloud Speech-to-Text + Text-to-Speech providers.
+ *
+ * Both consume the same vault slot `google_voice` (a Google
+ * Cloud API key restricted to the Speech and TextToSpeech APIs).
+ * The key is passed as the `?key=` query parameter on each
+ * request -- the simplest cloud-auth flow Google supports and
+ * the one most adopters will use for personal accounts.
+ *
+ * Endpoints:
+ *   STT:  POST https://speech.googleapis.com/v1/speech:recognize
+ *   TTS:  POST https://texttospeech.googleapis.com/v1/text:synthesize
+ *
+ * Loud failures (per ROADMAP sec 12.2):
+ *   - Missing vault slot -> readyToRun=false, transcribe/
+ *     synthesize throw with the slot name.
+ *   - HTTP non-2xx -> throw with status + body snippet.
+ *   - Contract mismatch in response -> throw with what was
+ *     expected.
+ *
+ * ASCII-only.
+ */
+import { Vault } from '../../vault/store.js';
+import type { SttProvider, SttRequest, SttResponse, SttAudioFormat, TtsProvider, TtsRequest, TtsResponse, TtsAudioFormat } from '../types.js';
+declare const VAULT_SLOT = "google_voice";
+export interface GoogleProviderOptions {
+    fetchImpl?: typeof fetch;
+    vaultOpener?: () => Promise<Vault>;
+}
+/** Map our SttAudioFormat to Google's encoding enum. */
+declare function sttFormatToGoogleEncoding(format: SttAudioFormat): string;
+/** Map our TtsAudioFormat to Google's audio encoding enum. */
+declare function ttsFormatToGoogleEncoding(format: TtsAudioFormat): string;
+export declare class GoogleSttProvider implements SttProvider {
+    readonly id = "google";
+    private readonly fetchImpl;
+    private readonly vaultOpener;
+    constructor(opts?: GoogleProviderOptions);
+    readyToRun(): Promise<boolean>;
+    transcribe(req: SttRequest): Promise<SttResponse>;
+}
+export declare class GoogleTtsProvider implements TtsProvider {
+    readonly id = "google";
+    private readonly fetchImpl;
+    private readonly vaultOpener;
+    constructor(opts?: GoogleProviderOptions);
+    readyToRun(): Promise<boolean>;
+    synthesize(req: TtsRequest): Promise<TtsResponse>;
+    /** Voice names are shaped like "es-AR-Neural2-A" -- the first
+     *  two segments are the BCP-47 language code. */
+    private inferLanguageFromVoice;
+    /** Google TTS accepts 0.25..4.0 for speakingRate. */
+    private clampSpeed;
+}
+export { sttFormatToGoogleEncoding, ttsFormatToGoogleEncoding, VAULT_SLOT };
+//# sourceMappingURL=google.d.ts.map

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

@@ -0,0 +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"}

package/dist/voice/providers/google.js

@@ -0,0 +1,253 @@
+/**
+ * Google Cloud Speech-to-Text + Text-to-Speech providers.
+ *
+ * Both consume the same vault slot `google_voice` (a Google
+ * Cloud API key restricted to the Speech and TextToSpeech APIs).
+ * The key is passed as the `?key=` query parameter on each
+ * request -- the simplest cloud-auth flow Google supports and
+ * the one most adopters will use for personal accounts.
+ *
+ * Endpoints:
+ *   STT:  POST https://speech.googleapis.com/v1/speech:recognize
+ *   TTS:  POST https://texttospeech.googleapis.com/v1/text:synthesize
+ *
+ * Loud failures (per ROADMAP sec 12.2):
+ *   - Missing vault slot -> readyToRun=false, transcribe/
+ *     synthesize throw with the slot name.
+ *   - HTTP non-2xx -> throw with status + body snippet.
+ *   - Contract mismatch in response -> throw with what was
+ *     expected.
+ *
+ * ASCII-only.
+ */
+import { Vault } from '../../vault/store.js';
+import { configDir } from '../../license/index.js';
+const STT_ENDPOINT = 'https://speech.googleapis.com/v1/speech:recognize';
+const TTS_ENDPOINT = 'https://texttospeech.googleapis.com/v1/text:synthesize';
+const DEFAULT_STT_LANGUAGE = 'en-US';
+const DEFAULT_TTS_LANGUAGE = 'en-US';
+const DEFAULT_TTS_VOICE = 'en-US-Neural2-C';
+const DEFAULT_TTS_FORMAT = 'mp3';
+const VAULT_SLOT = 'google_voice';
+/** Map our SttAudioFormat to Google's encoding enum. */
+function sttFormatToGoogleEncoding(format) {
+    switch (format) {
+        case 'webm': return 'WEBM_OPUS';
+        case 'ogg': return 'OGG_OPUS';
+        case 'wav': return 'LINEAR16';
+        case 'mp3': return 'MP3';
+        case 'flac': return 'FLAC';
+        case 'mp4': return 'MP4_AAC';
+        default: return 'ENCODING_UNSPECIFIED';
+    }
+}
+/** Map our TtsAudioFormat to Google's audio encoding enum. */
+function ttsFormatToGoogleEncoding(format) {
+    switch (format) {
+        case 'mp3': return 'MP3';
+        case 'wav': return 'LINEAR16';
+        case 'ogg': return 'OGG_OPUS';
+        case 'opus': return 'OGG_OPUS';
+        default: return 'MP3';
+    }
+}
+async function readKey(opener) {
+    const vault = await opener();
+    if (!vault.has(VAULT_SLOT)) {
+        throw new Error('google voice: vault slot "' + VAULT_SLOT + '" not set. '
+            + 'Run `yf vault set ' + VAULT_SLOT + '` to configure your Google Cloud API key.');
+    }
+    return vault.get(VAULT_SLOT);
+}
+async function safeText(r) {
+    try {
+        return await r.text();
+    }
+    catch {
+        return '(no body)';
+    }
+}
+/* ============================================================
+ * GoogleSttProvider
+ * ============================================================ */
+export class GoogleSttProvider {
+    id = 'google';
+    fetchImpl;
+    vaultOpener;
+    constructor(opts = {}) {
+        this.fetchImpl = opts.fetchImpl ?? ((u, init) => globalThis.fetch(u, init));
+        this.vaultOpener = opts.vaultOpener ?? (() => Vault.open({ configDir: configDir() }));
+    }
+    async readyToRun() {
+        try {
+            const vault = await this.vaultOpener();
+            return vault.has(VAULT_SLOT);
+        }
+        catch {
+            return false;
+        }
+    }
+    async transcribe(req) {
+        if (!req.audio || req.audio.length === 0) {
+            throw new Error('google STT: audio buffer is empty');
+        }
+        let apiKey;
+        try {
+            apiKey = await readKey(this.vaultOpener);
+        }
+        catch (err) {
+            throw err;
+        }
+        const language = req.languageHint || DEFAULT_STT_LANGUAGE;
+        const encoding = sttFormatToGoogleEncoding(req.format);
+        const model = req.model ?? 'latest_short';
+        const body = {
+            config: {
+                encoding,
+                languageCode: language,
+                model,
+                enableAutomaticPunctuation: true,
+            },
+            audio: {
+                content: req.audio.toString('base64'),
+            },
+        };
+        const t0 = Date.now();
+        const resp = await this.fetchImpl(STT_ENDPOINT + '?key=' + encodeURIComponent(apiKey), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        const latency_ms = Date.now() - t0;
+        if (!resp.ok) {
+            const detail = await safeText(resp);
+            throw new Error('google STT API ' + resp.status + ' ' + resp.statusText + ': '
+                + detail.slice(0, 400));
+        }
+        let parsed;
+        try {
+            parsed = await resp.json();
+        }
+        catch (err) {
+            throw new Error('google STT: response body is not JSON: ' + (err instanceof Error ? err.message : String(err)));
+        }
+        /* Google returns { results: [{ alternatives: [{ transcript,
+           confidence }], languageCode }] } -- or an empty `results`
+           array on silence. */
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error('google STT: response is not an object');
+        }
+        const results = Array.isArray(parsed.results) ? parsed.results : [];
+        const first = results[0];
+        const alt = first && Array.isArray(first.alternatives) ? first.alternatives[0] : undefined;
+        const text = (alt && typeof alt.transcript === 'string') ? alt.transcript.trim() : '';
+        const confidence = (alt && typeof alt.confidence === 'number') ? alt.confidence : undefined;
+        const detectedLang = (first && typeof first.languageCode === 'string') ? first.languageCode : undefined;
+        return {
+            text,
+            latency_ms,
+            provider: this.id,
+            model,
+            ...(confidence !== undefined ? { confidence } : {}),
+            ...(detectedLang ? { language: detectedLang } : {}),
+        };
+    }
+}
+/* ============================================================
+ * GoogleTtsProvider
+ * ============================================================ */
+export class GoogleTtsProvider {
+    id = 'google';
+    fetchImpl;
+    vaultOpener;
+    constructor(opts = {}) {
+        this.fetchImpl = opts.fetchImpl ?? ((u, init) => globalThis.fetch(u, init));
+        this.vaultOpener = opts.vaultOpener ?? (() => Vault.open({ configDir: configDir() }));
+    }
+    async readyToRun() {
+        try {
+            const vault = await this.vaultOpener();
+            return vault.has(VAULT_SLOT);
+        }
+        catch {
+            return false;
+        }
+    }
+    async synthesize(req) {
+        if (!req.text || req.text.trim() === '') {
+            throw new Error('google TTS: text is empty');
+        }
+        const apiKey = await readKey(this.vaultOpener);
+        const voice = req.voice ?? DEFAULT_TTS_VOICE;
+        const language = req.language ?? this.inferLanguageFromVoice(voice) ?? DEFAULT_TTS_LANGUAGE;
+        const format = req.format ?? DEFAULT_TTS_FORMAT;
+        const encoding = ttsFormatToGoogleEncoding(format);
+        const speakingRate = this.clampSpeed(req.speed);
+        const body = {
+            input: req.ssml ? { ssml: req.text } : { text: req.text },
+            voice: {
+                languageCode: language,
+                name: voice,
+            },
+            audioConfig: {
+                audioEncoding: encoding,
+                speakingRate,
+            },
+        };
+        const t0 = Date.now();
+        const resp = await this.fetchImpl(TTS_ENDPOINT + '?key=' + encodeURIComponent(apiKey), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        const latency_ms = Date.now() - t0;
+        if (!resp.ok) {
+            const detail = await safeText(resp);
+            throw new Error('google TTS API ' + resp.status + ' ' + resp.statusText + ': '
+                + detail.slice(0, 400));
+        }
+        let parsed;
+        try {
+            parsed = await resp.json();
+        }
+        catch (err) {
+            throw new Error('google TTS: response body is not JSON: ' + (err instanceof Error ? err.message : String(err)));
+        }
+        if (!parsed || typeof parsed !== 'object' || typeof parsed.audioContent !== 'string') {
+            throw new Error('google TTS: response missing audioContent (got: ' + JSON.stringify(parsed).slice(0, 200) + ')');
+        }
+        const audio = Buffer.from(parsed.audioContent, 'base64');
+        if (audio.length === 0) {
+            throw new Error('google TTS: decoded audio is empty');
+        }
+        return {
+            audio,
+            format,
+            latency_ms,
+            provider: this.id,
+            voice,
+        };
+    }
+    /** Voice names are shaped like "es-AR-Neural2-A" -- the first
+     *  two segments are the BCP-47 language code. */
+    inferLanguageFromVoice(voice) {
+        const parts = voice.split('-');
+        if (parts.length >= 2 && parts[0].length === 2 && parts[1].length === 2) {
+            return parts[0] + '-' + parts[1];
+        }
+        return undefined;
+    }
+    /** Google TTS accepts 0.25..4.0 for speakingRate. */
+    clampSpeed(speed) {
+        if (typeof speed !== 'number' || !Number.isFinite(speed))
+            return 1.0;
+        if (speed < 0.25)
+            return 0.25;
+        if (speed > 4.0)
+            return 4.0;
+        return speed;
+    }
+}
+/* Exported for tests + the host registry. */
+export { sttFormatToGoogleEncoding, ttsFormatToGoogleEncoding, VAULT_SLOT };
+//# sourceMappingURL=google.js.map