@nac3/forge-cli 1.21.2 → 1.21.4

package/dist/commands/director.js

@@ -1,290 +0,0 @@
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import crypto from 'node:crypto';
-import { getAgentDefinition } from '../agents/store.js';
-import { runAgent } from '../agents/runner.js';
-import { recordIngest } from '../chat/ingest_session.js';
-import { createRuntime } from '../agents/runtime.js';
-function fileExtToFormat(filename) {
-    const ext = path.extname(filename).toLowerCase();
-    if (ext === '.md' || ext === '.markdown')
-        return 'markdown';
-    if (ext === '.txt')
-        return 'markdown'; /* parse as markdown */
-    if (ext === '.pdf')
-        return 'pdf';
-    if (ext === '.docx')
-        return 'docx';
-    return 'markdown'; /* best-effort default */
-}
-function buildDocFromText(filename, text) {
-    /* deterministic doc_id from file content -- 8-char sha1 hex slug. */
-    const hash = crypto.createHash('sha1').update(filename + ':' + text).digest('hex').slice(0, 12);
-    const slug = path.basename(filename).replace(/[^a-zA-Z0-9._-]/g, '-').slice(0, 60);
-    const id = slug + '-' + hash;
-    /* Split into sections per top-level heading. Fallback: one
-     * section with the whole text as a single paragraph block. */
-    const lines = text.split(/\r?\n/);
-    const sections = [];
-    let curHeading = '';
-    let curLevel = 0;
-    let curBlocks = [];
-    let sectionIdx = 0;
-    function flush() {
-        if (curBlocks.length === 0 && !curHeading)
-            return;
-        sections.push({
-            id: 'sec-' + sectionIdx,
-            heading: curHeading,
-            level: curLevel,
-            blocks: curBlocks.length > 0
-                ? curBlocks.map((b) => ({ kind: 'paragraph', text: b }))
-                : [],
-        });
-        sectionIdx += 1;
-        curHeading = '';
-        curLevel = 0;
-        curBlocks = [];
-    }
-    for (const l of lines) {
-        const m = /^(#{1,6})\s+(.+)$/.exec(l.trim());
-        if (m) {
-            flush();
-            curHeading = m[2].trim();
-            curLevel = m[1].length;
-            continue;
-        }
-        if (l.trim().length > 0) {
-            curBlocks.push(l.trim());
-        }
-        else if (curBlocks.length > 0) {
-            /* blank line -> next paragraph boundary; leave for next non-blank. */
-        }
-    }
-    flush();
-    if (sections.length === 0) {
-        sections.push({
-            id: 'sec-0', heading: '', level: 0,
-            blocks: [{ kind: 'paragraph', text }],
-        });
-    }
-    return {
-        id,
-        filename: path.basename(filename),
-        format: fileExtToFormat(filename),
-        bytes: Buffer.byteLength(text, 'utf-8'),
-        title: sections[0].heading || path.basename(filename),
-        sections,
-    };
-}
-export function registerDirectorCommand(program, deps = {}) {
-    program.command('director')
-        .description('Single-entry orchestrator: ingest a spec + dispatch the Director. Default is a smoke run (ingest only). Pass --real to fire the live LLM step.')
-        .argument('<spec>', 'path to a spec file (.md / .txt; pdf/docx follow-up)')
-        .option('--reason <r>', 'override the auto-generated trigger reason')
-        .option('--real', 'use the real LLM step (slice 15e factory) -- requires anthropic_api_key')
-        .option('--json', 'emit JSON instead of human-readable summary')
-        .action(async (specPath, opts) => {
-        /* Step 1: read + ingest the spec. */
-        let text;
-        try {
-            text = await fs.readFile(path.resolve(specPath), 'utf-8');
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            console.error('Failed to read spec at ' + JSON.stringify(specPath) + ': ' + msg);
-            process.exitCode = 1;
-            return;
-        }
-        const doc = buildDocFromText(specPath, text);
-        const session = recordIngest(doc);
-        /* Yuemail-dogfood fix #17: include the spec content in the
-         *  Director's trigger_reason so the LLM has the actual
-         *  requirements in its first turn. Without this, the
-         *  Director only sees "spec doc_id=..." + the CLI --reason
-         *  flag and starts asking the operator for a spec instead
-         *  of delegating. The doc_id reference is kept in the
-         *  header so the Director can quote it when delegating. */
-        const userReason = opts.reason || '';
-        const triggerReason = '## Task: orchestrate the implementation of the following spec.\n'
-            + (userReason ? ('Operator note: ' + userReason + '\n\n') : '\n')
-            + 'Spec doc_id: ' + session.doc_id + '\n'
-            + 'Spec path: ' + specPath + '\n\n'
-            + '--- BEGIN SPEC ---\n'
-            + text
-            + '\n--- END SPEC ---\n\n'
-            + 'Per your YUEMAIL-DOGFOOD MANDATE: your first tool call MUST be '
-            + 'yujin.agent.delegate({to_slug:"analyst", payload:<the spec above + "extract structured plan + tdd_first flag">, tokens_used:<n>}). '
-            + 'Do NOT ask the operator for a spec -- it is included verbatim above.';
-        /* Step 2: ensure the Director is registered. */
-        const def = await getAgentDefinition('director');
-        if (!def) {
-            console.error('Director agent is not installed. Run `yf agent install --defaults` first.');
-            process.exitCode = 1;
-            return;
-        }
-        /* Step 3: dispatch the Director. */
-        let stepFn;
-        let runtimeForDelegate;
-        if (opts.real) {
-            /* Yuemail-dogfood fix #7 + #12 + #13: construct a
-             *  Runtime up-front so yujin.agent.delegate has a
-             *  dispatcher to call. The default runner adapter inside
-             *  runtime.ts passes (slug, reason) to runAgent, which
-             *  expects (def, opts) -- so sub-agents end up running
-             *  with a broken adapter, the run fails immediately, and
-             *  the Director sees ok=false from the delegate.
-             *
-             *  Fix #12: inject a runner that, given a slug, loads
-             *  the agent definition + builds a real LLM step via
-             *  makeRealStep + runs the agent through runAgent with
-             *  the correct shape. This is what makes a delegated
-             *  Analyst / Coder / Tester / Scaffolder run with the
-             *  actual Claude API instead of a no-op stub.
-             *
-             *  Fix #13: actually CALL start() on the runtime. The
-             *  initial Fix #7 comment said "no start() needed for
-             *  one-shot CLI" which was wrong: runtime.ts:325 and
-             *  :413 throw "runtime not started -- call start() first"
-             *  inside dispatchAgent + dispatchAgentSoft if running is
-             *  false. Without start(), every delegate raises that
-             *  error and the Director falls back to inline. */
-            const projectCwd = process.cwd();
-            runtimeForDelegate = createRuntime({
-                runner: async (subSlug, subReason) => {
-                    const subDef = await getAgentDefinition(subSlug);
-                    if (!subDef) {
-                        throw new Error('delegate target agent not installed: ' + subSlug);
-                    }
-                    const { makeRealStep } = await import('../agents/cli_real.js');
-                    const subStep = await makeRealStep({
-                        def: subDef,
-                        trigger_reason: subReason,
-                        project_root: projectCwd,
-                        project_name: 'Director CLI (delegate)',
-                        forge_version: 'cli',
-                        /* The sub-agent does not own a sub-runtime; it
-                         *  is a leaf in this dispatch path. If a sub-
-                         *  agent itself invokes agent.delegate, that
-                         *  call will go through runtime.dispatchAgent
-                         *  on the SAME runtime instance -- so the
-                         *  director's runtime is sufficient for the
-                         *  whole tree. */
-                        runtime: runtimeForDelegate,
-                    });
-                    const { runAgent } = await import('../agents/runner.js');
-                    return runAgent(subDef, {
-                        trigger_kind: 'manual',
-                        trigger_reason: subReason,
-                        step: subStep,
-                        persist: true,
-                        /* Cap sub-agents at 20 iterations -- same as the
-                         *  Director itself. Prevents a single delegated
-                         *  worker from runawaying the budget. */
-                        max_iterations: 50,
-                    });
-                },
-            });
-            /* Yuemail-dogfood fix #13: start the runtime BEFORE the
-             *  director step is built. runtime.ts gates dispatchAgent
-             *  on `running` and throws "runtime not started" if it
-             *  is invoked before start(). The dispatch loop is on a
-             *  setTimeout that unrefs itself, so node will still
-             *  exit cleanly when stop() is called at the end. */
-            runtimeForDelegate.start();
-            const builder = deps.makeRealStep ?? (async (args) => {
-                const { makeRealStep } = await import('../agents/cli_real.js');
-                return makeRealStep({
-                    def: args.def,
-                    trigger_reason: args.trigger_reason,
-                    project_root: args.project_root,
-                    project_name: args.project_name,
-                    forge_version: args.forge_version,
-                    ...(args.runtime ? { runtime: args.runtime } : {}),
-                    /* Yuemail-dogfood fix #18: 8192 cap for the Director.
-                     *  The spec inlined in trigger_reason (~9 KB) + graph
-                     *  snapshot + R-strict mandate + system prompt easily
-                     *  burn the 4096 default on a single turn of textual
-                     *  acknowledgement before the LLM emits its first
-                     *  tool_use block. Sub-agents stay at the default. */
-                    max_tokens: 8192,
-                });
-            });
-            try {
-                stepFn = await builder({
-                    def, trigger_reason: triggerReason,
-                    project_root: process.cwd(), project_name: 'Director CLI', forge_version: 'cli',
-                    ...(runtimeForDelegate ? { runtime: runtimeForDelegate } : {}),
-                });
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                console.error('Failed to build real LLM step: ' + msg);
-                if (err && typeof err === 'object' && err.code === 'no_claude_key') {
-                    console.error('');
-                    console.error('Tip: run `yf keys setup --provider anthropic --key <KEY>` to load a key.');
-                }
-                process.exitCode = 1;
-                return;
-            }
-        }
-        else {
-            stepFn = async () => ({
-                text: 'cli stub: ingest of "' + session.doc_id + '" recorded. Pass --real to dispatch Claude.',
-                tokens_in: 0, tokens_out: 0, tool_calls: 0, done: true,
-            });
-        }
-        const run = await runAgent(def, {
-            trigger_kind: 'manual',
-            trigger_reason: triggerReason,
-            step: stepFn,
-            persist: true,
-            /* alpha.59z.156 E2E lesson -- the runner default
-             * max_iterations=100 lets a chatty Director burn ~200k
-             * tokens / >$5 before any human notices. Cap at 20 for
-             * the CLI single-entry path; users running through the
-             * panel keep the original 100 via runtime.dispatchAgent
-             * which doesn't override this.
-             *
-             * Yuemail-dogfood fix #19: cap raised from 20 -> 40.
-             * Sprint #10 exit-2'd at iter 20 with 27 tool calls and
-             * an in-flight scaffolder roundtrip. A full TDD cycle
-             * needs ~5 delegates per slice (analyst once + 3 slices
-             * x [coder, scaffolder, tester]) so 20 is a hair short.
-             * 40 still bounds blast radius -- at ~$0.4/iter via fix
-             * #20 loop discipline, max sprint cost is ~$16. */
-            max_iterations: 40,
-        });
-        if (opts.json) {
-            console.log(JSON.stringify({ doc_id: session.doc_id, run }, null, 2));
-            process.exitCode = run.status === 'succeeded' ? 0 : 2;
-            return;
-        }
-        console.log('Spec ingested:');
-        console.log('  Doc ID:       ' + session.doc_id);
-        console.log('  Title:        ' + doc.title);
-        console.log('  Sections:     ' + doc.sections.length);
-        console.log('  Bytes:        ' + doc.bytes);
-        console.log('');
-        console.log('Director run:');
-        console.log('  Run ID:       ' + run.id);
-        console.log('  Status:       ' + run.status + (run.kill_reason ? ' (' + run.kill_reason + ')' : ''));
-        console.log('  Trigger:      ' + run.trigger_reason);
-        console.log('  Tokens:       in=' + run.tokens_in + ' out=' + run.tokens_out);
-        console.log('  Tool calls:   ' + run.tool_calls);
-        if (run.last_reply_summary) {
-            console.log('  Last reply:   ' + run.last_reply_summary);
-        }
-        /* Yuemail-dogfood fix #13: stop the runtime we started so
-         *  node can exit cleanly without waiting for the (unref'd)
-         *  tick timer to drain. Best-effort -- never throw. */
-        if (runtimeForDelegate) {
-            try {
-                await runtimeForDelegate.stop();
-            }
-            catch { /* ignore */ }
-        }
-        process.exitCode = run.status === 'succeeded' ? 0 : 2;
-    });
-}
-//# sourceMappingURL=director.js.map

package/dist/commands/director.js.map

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

package/dist/commands/voice_setup.d.ts

@@ -1,37 +0,0 @@
-/**
- * `yf voice setup` -- interactive BYOK provider configuration.
- *
- * The user chooses one or more providers (OpenAI / Google /
- * ElevenLabs), pastes the API keys, and this command:
- *
- *   1. Reads the current local provider keys from disk
- *      (~/.yujin-forge/provider_keys.json), if any.
- *   2. Merges the new values on top.
- *   3. Encrypts the merged payload with the SERVER_API_KEY
- *      from the vault (the same secret used for HMAC signing).
- *   4. POSTs the encrypted blob to /v1/keys-sync/<handle> so
- *      the user's mobile + other paired devices pull it.
- *   5. Writes the plaintext locally so subsequent voice calls
- *      can read it without re-prompting.
- *
- * Server never sees plaintext -- only the ciphertext blob.
- *
- * Subcommands:
- *   yf voice setup                Interactive prompts.
- *   yf voice setup --show         Print current local config (keys masked).
- *   yf voice setup --pull         Pull the server copy + overwrite local.
- *   yf voice setup --provider openai --key sk-xxx
- *                                  Non-interactive single-provider set.
- *
- * ASCII-only.
- */
-import type { Command } from 'commander';
-export interface VoiceSetupOptions {
-    show?: boolean;
-    pull?: boolean;
-    provider?: string;
-    key?: string;
-}
-export declare function registerVoiceSetupCommand(parent: Command): void;
-export declare function runVoiceSetup(opts: VoiceSetupOptions): Promise<void>;
-//# sourceMappingURL=voice_setup.d.ts.map

package/dist/commands/voice_setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"voice_setup.d.ts","sourceRoot":"","sources":["../../src/commands/voice_setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8HzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAU/D;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuK1E"}

package/dist/commands/voice_setup.js

@@ -1,308 +0,0 @@
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import prompts from 'prompts';
-import { c, header } from '../ui/colors.js';
-import { Vault } from '../vault/store.js';
-import { configDir } from '../license/index.js';
-import { readLicense } from '../core/polar.js';
-import { signBearer, HITO4_BASE_URL } from '../license/hito4_client.js';
-import { encryptUserKeys, decryptUserKeys, envelopeToBlob, envelopeFromBlob, } from '../core/keys_envelope.js';
-const VAULT_SECRET_SLOT = 'yf_server_api_key';
-const LOCAL_KEYS_FILE = 'provider_keys.json';
-function localKeysPath() {
-    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
-    return path.join(home, '.yujin-forge', LOCAL_KEYS_FILE);
-}
-async function readLocalKeys() {
-    try {
-        const raw = await fs.readFile(localKeysPath(), 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (parsed && parsed.v === 1)
-            return parsed;
-    }
-    catch { /* missing or malformed -- treat as empty */ }
-    return { v: 1, updated_at: '1970-01-01T00:00:00Z' };
-}
-async function writeLocalKeys(payload) {
-    const p = localKeysPath();
-    await fs.mkdir(path.dirname(p), { recursive: true });
-    const tmp = p + '.tmp';
-    await fs.writeFile(tmp, JSON.stringify(payload, null, 2), 'utf-8');
-    await fs.rename(tmp, p);
-}
-function maskKey(k) {
-    if (!k)
-        return '(none)';
-    if (k.length <= 8)
-        return '****';
-    return k.slice(0, 4) + '...' + k.slice(-4);
-}
-async function loadServerSecret() {
-    const vault = await Vault.open({ configDir: configDir() });
-    if (!vault.has(VAULT_SECRET_SLOT)) {
-        throw new Error('voice setup: vault slot "' + VAULT_SECRET_SLOT + '" is empty. '
-            + 'Run `yf vault set ' + VAULT_SECRET_SLOT + '` with the value '
-            + 'provided at signup (or your tenant admin) before configuring '
-            + 'voice providers.');
-    }
-    return vault.get(VAULT_SECRET_SLOT);
-}
-async function loadUserHandle() {
-    const lic = await readLicense();
-    if (!lic.user_handle) {
-        throw new Error('voice setup: no user_handle on the local license cache. '
-            + 'Run `yf license activate --user-handle <you@example.com>` first.');
-    }
-    return lic.user_handle;
-}
-async function pushToServer(payload) {
-    const secret = await loadServerSecret();
-    const handle = await loadUserHandle();
-    const env = await encryptUserKeys(payload, secret);
-    const blob = envelopeToBlob(env);
-    const bearer = signBearer(secret, handle);
-    const url = HITO4_BASE_URL.replace(/\/+$/, '') + '/v1/keys-sync/' + encodeURIComponent(handle);
-    const r = await fetch(url, {
-        method: 'POST',
-        headers: {
-            Authorization: 'Bearer ' + bearer,
-            'content-type': 'application/json',
-        },
-        body: JSON.stringify({ blob, ts: payload.updated_at }),
-    });
-    if (!r.ok) {
-        let detail = '';
-        try {
-            detail = await r.text();
-        }
-        catch { /* */ }
-        throw new Error('voice setup: server push failed (HTTP ' + r.status + '): ' + detail.slice(0, 200));
-    }
-}
-async function pullFromServer() {
-    const secret = await loadServerSecret();
-    const handle = await loadUserHandle();
-    const bearer = signBearer(secret, handle);
-    const url = HITO4_BASE_URL.replace(/\/+$/, '') + '/v1/keys-sync/' + encodeURIComponent(handle);
-    const r = await fetch(url, {
-        method: 'GET',
-        headers: { Authorization: 'Bearer ' + bearer },
-    });
-    if (!r.ok) {
-        let detail = '';
-        try {
-            detail = await r.text();
-        }
-        catch { /* */ }
-        throw new Error('voice setup: server pull failed (HTTP ' + r.status + '): ' + detail.slice(0, 200));
-    }
-    const body = await r.json();
-    if (!body.blob)
-        return null;
-    const env = envelopeFromBlob(body.blob);
-    return decryptUserKeys(env, secret);
-}
-function printCurrent(p) {
-    header('Yujin Forge -- voice setup (current local)');
-    console.log('');
-    console.log('  OpenAI API key:        ' + c.dim(maskKey(p.openai_api_key)));
-    console.log('  Google STT key:        ' + c.dim(maskKey(p.google_stt_key)));
-    console.log('  Google TTS key:        ' + c.dim(maskKey(p.google_tts_key)));
-    console.log('  ElevenLabs API key:    ' + c.dim(maskKey(p.elevenlabs_api_key)));
-    console.log('');
-    console.log('  STT preference:        ' + c.brand(p.stt_provider_preference ?? '(not set)'));
-    console.log('  TTS preference:        ' + c.brand(p.tts_provider_preference ?? '(not set)'));
-    console.log('  STT language:          ' + (p.stt_language ?? c.dim('(default)')));
-    console.log('  TTS voice:             ' + (p.tts_voice ?? c.dim('(default)')));
-    console.log('  Last updated:          ' + c.dim(p.updated_at));
-}
-export function registerVoiceSetupCommand(parent) {
-    parent
-        .command('setup')
-        .description('Configure voice provider API keys (OpenAI / Google / ElevenLabs). '
-        + 'Encrypts + syncs to your other devices automatically.')
-        .option('--show', 'print current local config (keys masked)')
-        .option('--pull', 'pull the server copy + overwrite local')
-        .option('--provider <name>', 'non-interactive: set this provider')
-        .option('--key <value>', 'non-interactive: the API key value for --provider')
-        .action(async (opts) => { await runVoiceSetup(opts); });
-}
-export async function runVoiceSetup(opts) {
-    /* --show: print current + exit. */
-    if (opts.show) {
-        const current = await readLocalKeys();
-        printCurrent(current);
-        return;
-    }
-    /* --pull: server -> local. */
-    if (opts.pull) {
-        let pulled;
-        try {
-            pulled = await pullFromServer();
-        }
-        catch (err) {
-            console.error(c.error(err instanceof Error ? err.message : String(err)));
-            process.exitCode = 1;
-            return;
-        }
-        if (!pulled) {
-            console.log(c.dim('Server has no provider keys for this user yet.'));
-            return;
-        }
-        await writeLocalKeys(pulled);
-        header('Yujin Forge -- voice setup (pulled from server)');
-        console.log('');
-        printCurrent(pulled);
-        return;
-    }
-    /* --provider / --key: non-interactive single set. */
-    if (opts.provider || opts.key) {
-        if (!opts.provider || !opts.key) {
-            console.error(c.error('--provider and --key must be used together.'));
-            process.exitCode = 1;
-            return;
-        }
-        const merged = await readLocalKeys();
-        const ts = new Date().toISOString();
-        const p = opts.provider.toLowerCase();
-        if (p === 'openai')
-            merged.openai_api_key = opts.key;
-        else if (p === 'google-stt')
-            merged.google_stt_key = opts.key;
-        else if (p === 'google-tts')
-            merged.google_tts_key = opts.key;
-        else if (p === 'elevenlabs')
-            merged.elevenlabs_api_key = opts.key;
-        else {
-            console.error(c.error('--provider must be one of: openai, google-stt, google-tts, elevenlabs'));
-            process.exitCode = 1;
-            return;
-        }
-        merged.updated_at = ts;
-        try {
-            await pushToServer(merged);
-            await writeLocalKeys(merged);
-            header('Yujin Forge -- voice setup (saved)');
-            console.log('');
-            printCurrent(merged);
-        }
-        catch (err) {
-            console.error(c.error(err instanceof Error ? err.message : String(err)));
-            process.exitCode = 1;
-        }
-        return;
-    }
-    /* Interactive flow. */
-    const current = await readLocalKeys();
-    header('Yujin Forge -- voice setup');
-    console.log('');
-    console.log(c.dim('Configure the API keys for your chosen voice providers. The keys are'));
-    console.log(c.dim('encrypted with your account secret + synced to your mobile + other'));
-    console.log(c.dim('paired devices automatically. The server never sees plaintext.'));
-    console.log('');
-    console.log(c.dim('Press Enter on any field to keep its current value.'));
-    console.log('');
-    const answers = await prompts([
-        {
-            type: 'multiselect',
-            name: 'providers',
-            message: 'Which providers do you want to configure?',
-            choices: [
-                { title: 'OpenAI (Whisper for STT + tts-1 for TTS)', value: 'openai' },
-                { title: 'Google Cloud (Speech-to-Text + Text-to-Speech)', value: 'google' },
-                { title: 'ElevenLabs (TTS only -- higher quality voice)', value: 'elevenlabs' },
-            ],
-            min: 1,
-            hint: 'Space to select, Enter to confirm.',
-        },
-    ]);
-    if (!answers.providers || answers.providers.length === 0) {
-        console.log(c.dim('No providers selected. Aborting.'));
-        return;
-    }
-    const merged = { ...current };
-    if (answers.providers.includes('openai')) {
-        const r = await prompts({
-            type: 'password',
-            name: 'k',
-            message: 'OpenAI API key (sk-...). Current: ' + maskKey(current.openai_api_key),
-        });
-        if (r.k)
-            merged.openai_api_key = r.k;
-    }
-    if (answers.providers.includes('google')) {
-        const sttR = await prompts({
-            type: 'password',
-            name: 'k',
-            message: 'Google Cloud Speech-to-Text API key. Current: ' + maskKey(current.google_stt_key),
-        });
-        if (sttR.k)
-            merged.google_stt_key = sttR.k;
-        const ttsR = await prompts({
-            type: 'password',
-            name: 'k',
-            message: 'Google Cloud Text-to-Speech API key (can be same as STT). Current: ' + maskKey(current.google_tts_key),
-        });
-        if (ttsR.k)
-            merged.google_tts_key = ttsR.k;
-    }
-    if (answers.providers.includes('elevenlabs')) {
-        const r = await prompts({
-            type: 'password',
-            name: 'k',
-            message: 'ElevenLabs API key. Current: ' + maskKey(current.elevenlabs_api_key),
-        });
-        if (r.k)
-            merged.elevenlabs_api_key = r.k;
-    }
-    /* Preferences (which provider to USE for each direction). */
-    const sttCandidates = [];
-    if (merged.openai_api_key)
-        sttCandidates.push({ title: 'OpenAI (Whisper)', value: 'openai' });
-    if (merged.google_stt_key)
-        sttCandidates.push({ title: 'Google', value: 'google' });
-    if (sttCandidates.length > 0) {
-        const pref = await prompts({
-            type: 'select',
-            name: 'p',
-            message: 'Preferred STT provider',
-            choices: sttCandidates,
-            initial: 0,
-        });
-        if (pref.p)
-            merged.stt_provider_preference = pref.p;
-    }
-    const ttsCandidates = [];
-    if (merged.openai_api_key)
-        ttsCandidates.push({ title: 'OpenAI (tts-1)', value: 'openai' });
-    if (merged.google_tts_key)
-        ttsCandidates.push({ title: 'Google', value: 'google' });
-    if (merged.elevenlabs_api_key)
-        ttsCandidates.push({ title: 'ElevenLabs', value: 'elevenlabs' });
-    if (ttsCandidates.length > 0) {
-        const pref = await prompts({
-            type: 'select',
-            name: 'p',
-            message: 'Preferred TTS provider',
-            choices: ttsCandidates,
-            initial: 0,
-        });
-        if (pref.p)
-            merged.tts_provider_preference = pref.p;
-    }
-    merged.updated_at = new Date().toISOString();
-    try {
-        await pushToServer(merged);
-        await writeLocalKeys(merged);
-        console.log('');
-        console.log(c.success('Voice config saved + synced.'));
-        console.log('');
-        printCurrent(merged);
-    }
-    catch (err) {
-        console.error(c.error(err instanceof Error ? err.message : String(err)));
-        process.exitCode = 1;
-    }
-}
-//# sourceMappingURL=voice_setup.js.map