@theone1345/smartrelay 0.2.0 → 0.3.0

package/dist/setup.js

@@ -0,0 +1,411 @@
+#!/usr/bin/env node
+/**
+ * Interactive credential setup for SmartRelay.
+ *
+ * Asks for the provider API keys in the terminal and stores them in
+ * `~/.smartrelay/.env` (mode 600), which `loadDotEnv()` reads as its
+ * lowest-priority source.
+ *
+ * This writes prompts to STDOUT, which is only safe because the wizard never
+ * runs in a process that connects `StdioServerTransport` — `src/server.ts`
+ * dispatches the `setup` subcommand and exits before any transport is created.
+ * See the note at the top of `src/logger.ts` for why stdout is otherwise
+ * off-limits.
+ */
+import { chmodSync, existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import * as readline from 'node:readline/promises';
+import { Writable } from 'node:stream';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import { formatRunnerStatusLines, maskKey, PROVIDER_KEYS, summarizeCredentials, validateKeyFormat, } from './credentials.js';
+import { RunnerRegistry } from './runners/registry.js';
+import { describeError, globalEnvPath, loadDotEnv, parseEnvText, smartrelayHome } from './util.js';
+/** How many times a required key is re-asked before offering to skip it. */
+const REQUIRED_ATTEMPTS = 3;
+// =========================================================================
+// FILE WRITING
+// =========================================================================
+/** Quote a value only when a bare one would not survive `parseEnvText`. */
+function formatEnvValue(value) {
+    return /[\s#]/.test(value) ? `"${value}"` : value;
+}
+/**
+ * Fold `updates` into existing `.env` text without disturbing anything else.
+ *
+ * Comments, blank lines, and unrelated keys survive verbatim — the file may hold
+ * values a user added by hand (`SMARTRELAY_HTTP_API_KEY`, say) that the wizard
+ * knows nothing about and must not drop.
+ */
+export function mergeEnvText(original, updates) {
+    const consumed = new Set();
+    const kept = [];
+    for (const rawLine of original.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        const splitAt = line.indexOf('=');
+        const key = !line || line.startsWith('#') || splitAt < 0 ? null : line.slice(0, splitAt).trim();
+        if (key && updates.has(key)) {
+            // Replace the first occurrence in place; drop any later duplicate so the
+            // key cannot end up defined twice with different values.
+            if (!consumed.has(key)) {
+                consumed.add(key);
+                kept.push(`${key}=${formatEnvValue(updates.get(key))}`);
+            }
+            continue;
+        }
+        kept.push(rawLine);
+    }
+    const appended = [...updates].filter(([key]) => !consumed.has(key));
+    while (kept.length && kept[kept.length - 1]?.trim() === '')
+        kept.pop();
+    if (appended.length) {
+        if (kept.length)
+            kept.push('');
+        kept.push(`# Added by smartrelay setup on ${new Date().toISOString().slice(0, 10)}`);
+        for (const [key, value] of appended)
+            kept.push(`${key}=${formatEnvValue(value)}`);
+    }
+    return `${kept.join('\n')}\n`;
+}
+/**
+ * Write the merged credential file.
+ *
+ * Written to a temp file and renamed so an interrupted run can never leave a
+ * half-written credential file behind, and chmod'd explicitly because the mode
+ * passed to `mkdir`/`writeFile` is masked by the process umask.
+ */
+export function writeGlobalEnv(updates, homeOverride) {
+    const dir = smartrelayHome(homeOverride);
+    const target = path.join(dir, '.env');
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    tryChmod(dir, 0o700);
+    const original = existsSync(target) ? readFileSync(target, 'utf-8') : '';
+    const merged = mergeEnvText(original, updates);
+    const tmp = path.join(dir, `.env.tmp-${process.pid}`);
+    try {
+        writeFileSync(tmp, merged, { mode: 0o600 });
+        tryChmod(tmp, 0o600);
+        renameSync(tmp, target);
+    }
+    catch (err) {
+        rmSync(tmp, { force: true });
+        throw err;
+    }
+    return target;
+}
+/** `chmod` is a no-op on some filesystems and throws on others — never fatal. */
+function tryChmod(target, mode) {
+    try {
+        chmodSync(target, mode);
+    }
+    catch {
+        // Permissions are advisory here; the file is still written.
+    }
+}
+/** Render a path with the home directory collapsed back to `~`. */
+function displayPath(filePath) {
+    const home = process.env['HOME'] ?? process.env['USERPROFILE'];
+    return home && filePath.startsWith(home) ? `~${filePath.slice(home.length)}` : filePath;
+}
+// =========================================================================
+// WIZARD
+// =========================================================================
+/**
+ * Open a prompt session, or return `null` when there is no terminal to prompt on.
+ *
+ * Shared by `setup` and `init` so a single run can ask for keys and then for
+ * client registration over one readline — two competing interfaces on the same
+ * stdin would race for lines.
+ */
+export function openWizardIo(options = {}) {
+    const out = options.output ?? process.stdout;
+    const input = options.input ?? process.stdin;
+    // An explicitly injected stream is always scriptable; otherwise both ends must
+    // be a real terminal or the prompts would block forever on a closed stdin.
+    const scripted = Boolean(options.input);
+    if (!scripted && (!process.stdin.isTTY || !process.stdout.isTTY))
+        return null;
+    let muted = false;
+    const muteable = new Writable({
+        write(chunk, _encoding, callback) {
+            if (!muted)
+                out.write(chunk);
+            callback();
+        },
+    });
+    const rl = readline.createInterface({ input, output: muteable, terminal: !scripted });
+    return {
+        read: createLineReader(rl),
+        write: (line = '') => void out.write(`${line}\n`),
+        setMuted: (next) => {
+            muted = next;
+        },
+        close: () => {
+            muted = false;
+            rl.close();
+        },
+    };
+}
+/** The message shown when there is no terminal and no `--non-interactive`. */
+export function noTerminalMessage(command) {
+    return (`smartrelay ${command} needs an interactive terminal.\n` +
+        'Run it directly in a shell, or use --non-interactive with ' +
+        `${PROVIDER_KEYS.filter((s) => s.required).map((s) => s.env).join(' and ')} exported.\n`);
+}
+export async function runSetup(options = {}, sharedIo) {
+    const out = options.output ?? process.stdout;
+    const write = (line = '') => void out.write(`${line}\n`);
+    const target = globalEnvPath(options.home);
+    const fileValues = existsSync(target)
+        ? parseEnvText(readFileSync(target, 'utf-8'))
+        : new Map();
+    if (options.nonInteractive) {
+        return harvestFromEnvironment(options, write);
+    }
+    const io = sharedIo ?? openWizardIo(options);
+    if (!io) {
+        process.stderr.write(noTerminalMessage('setup'));
+        return 1;
+    }
+    const read = io.read;
+    write();
+    write('SmartRelay setup');
+    write('────────────────');
+    write(`Keys are saved to ${displayPath(target)} (readable only by you).`);
+    write('Your keystrokes are not shown while you type a key.');
+    const updates = new Map();
+    try {
+        for (const spec of PROVIDER_KEYS) {
+            const existing = fileValues.get(spec.env) ?? process.env[spec.env] ?? '';
+            const source = fileValues.has(spec.env)
+                ? displayPath(target)
+                : existing
+                    ? 'environment'
+                    : null;
+            write();
+            write(`${spec.env} — ${spec.label}  [${spec.required ? 'required' : 'optional'}]`);
+            write(`  Get one at ${spec.consoleUrl}`);
+            if (existing) {
+                write(`  already set: ${maskKey(existing)} (from ${source}) — press Enter to keep`);
+                if (source === 'environment') {
+                    write(`  pressing Enter also copies it into ${displayPath(target)}`);
+                }
+            }
+            else if (!spec.required) {
+                write('  press Enter to skip');
+            }
+            const value = await promptForKey(read, spec, existing, io);
+            if (value)
+                updates.set(spec.env, value);
+        }
+    }
+    finally {
+        // Only tear down a session this call created; a shared one outlives it.
+        if (!sharedIo)
+            io.close();
+    }
+    if (!updates.size) {
+        write();
+        write('Nothing to save — no keys entered.');
+        return 0;
+    }
+    const saved = writeGlobalEnv(updates, options.home);
+    for (const [key, value] of updates)
+        process.env[key] = value;
+    write();
+    write(`Saved ${updates.size} key${updates.size === 1 ? '' : 's'} to ${displayPath(saved)} (mode 600)`);
+    printReadiness(options.configPath ?? null, write);
+    const stillMissing = PROVIDER_KEYS.filter((spec) => spec.required && !process.env[spec.env]);
+    if (stillMissing.length) {
+        write();
+        write(`Still missing: ${stillMissing.map((s) => s.env).join(', ')} — re-run setup to add them.`);
+    }
+    return 0;
+}
+/**
+ * Buffer readline's `line` events into a queue.
+ *
+ * `rl.question()` only captures input while a question is pending, so a scripted
+ * stream that delivers every line at once loses all but the first — and once the
+ * stream ends, any later `question()` rejects with "readline was closed". A queue
+ * decouples arrival from consumption and turns end-of-input into a `null` the
+ * caller can handle.
+ */
+function createLineReader(rl) {
+    const buffered = [];
+    const waiting = [];
+    let closed = false;
+    rl.on('line', (line) => {
+        const next = waiting.shift();
+        if (next)
+            next(line);
+        else
+            buffered.push(line);
+    });
+    rl.on('close', () => {
+        closed = true;
+        while (waiting.length)
+            waiting.shift()?.(null);
+    });
+    return () => {
+        if (buffered.length)
+            return Promise.resolve(buffered.shift());
+        if (closed)
+            return Promise.resolve(null);
+        return new Promise((resolve) => waiting.push(resolve));
+    };
+}
+/** Ask for one provider key, returning the value to persist (or `null` to skip). */
+async function promptForKey(read, spec, existing, io) {
+    for (let attempt = 1;; attempt++) {
+        const entered = await promptSecret(read, io);
+        // Input ended: keep whatever was already configured and stop asking, rather
+        // than spinning on the required-key retry loop forever.
+        if (entered === null)
+            return existing || null;
+        if (!entered) {
+            // Keeping an existing value still persists it — a key that only lived in
+            // the shell environment would otherwise vanish with the session.
+            if (existing)
+                return existing;
+            if (!spec.required)
+                return null;
+            if (attempt < REQUIRED_ATTEMPTS) {
+                io.write(`  ${spec.env} is required. Paste the key, or press Enter ${REQUIRED_ATTEMPTS - attempt} more time(s) to skip.`);
+                continue;
+            }
+            const skip = await confirm(read, io, `  Skip ${spec.env}? Runners that use it will fail. [y/N]`, false);
+            if (skip)
+                return null;
+            attempt = 0;
+            continue;
+        }
+        const warning = validateKeyFormat(spec, entered);
+        if (warning) {
+            io.write(`  warning: ${warning}`);
+            // Warn, never reject: providers change key formats, and refusing a valid
+            // new-style key is worse than storing a typo the user can correct.
+            const save = await confirm(read, io, '  Save anyway? [Y/n]', true);
+            if (!save)
+                continue;
+        }
+        io.write(`  stored ${maskKey(entered)}`);
+        return entered;
+    }
+}
+/** Read a line with terminal echo suppressed. `null` means input ended. */
+async function promptSecret(read, io) {
+    io.write('  key (input hidden, paste is fine):');
+    io.setMuted(true);
+    try {
+        const line = await read();
+        return line === null ? null : line.trim();
+    }
+    finally {
+        io.setMuted(false);
+    }
+}
+async function confirm(read, io, prompt, defaultYes) {
+    io.write(prompt);
+    const answer = (await read())?.trim().toLowerCase();
+    if (!answer)
+        return defaultYes;
+    return answer.startsWith('y');
+}
+// =========================================================================
+// NON-INTERACTIVE MODE
+// =========================================================================
+/** CI / Dockerfile path: persist whatever is already exported, prompt for nothing. */
+function harvestFromEnvironment(options, write) {
+    const updates = new Map();
+    for (const spec of PROVIDER_KEYS) {
+        const value = process.env[spec.env];
+        if (value)
+            updates.set(spec.env, value);
+    }
+    const missing = PROVIDER_KEYS.filter((spec) => spec.required && !process.env[spec.env]);
+    if (missing.length) {
+        process.stderr.write(`smartrelay setup --non-interactive: ${missing.map((s) => s.env).join(', ')} not set in the environment.\n`);
+        return 1;
+    }
+    const saved = writeGlobalEnv(updates, options.home);
+    write(`Saved ${updates.size} key${updates.size === 1 ? '' : 's'} to ${displayPath(saved)} (mode 600)`);
+    printReadiness(options.configPath ?? null, write);
+    return 0;
+}
+// =========================================================================
+// SUMMARY
+// =========================================================================
+/** Print how many runners the new credentials actually unlocked. */
+function printReadiness(configPath, write) {
+    let registry;
+    try {
+        registry = RunnerRegistry.fromYaml(configPath);
+    }
+    catch (err) {
+        // Never fail the wizard over this — the keys are already safely written.
+        write(`Could not load config.yaml to verify runners: ${describeError(err)}`);
+        return;
+    }
+    const metadata = registry.getRunnersMetadata();
+    const summary = summarizeCredentials(metadata);
+    write();
+    write(`${summary.ready} of ${summary.total} runners ready.`);
+    for (const line of formatRunnerStatusLines(metadata))
+        write(line);
+    if (summary.missingEnvVars.length) {
+        write();
+        write(`Not configured: ${summary.missingEnvVars.join(', ')}`);
+    }
+}
+// =========================================================================
+// CLI ENTRYPOINT
+// =========================================================================
+const USAGE = `Usage: smartrelay setup [options]
+
+Prompts for your provider API keys and saves them to ~/.smartrelay/.env (mode 600).
+
+Options:
+  -c, --config <path>    config.yaml used for the readiness summary
+      --non-interactive  save keys already present in the environment, no prompts
+  -h, --help             show this message`;
+function checkDirectExecution() {
+    const script = process.argv[1];
+    if (!script)
+        return false;
+    try {
+        if (realpathSync(script) === realpathSync(fileURLToPath(import.meta.url)))
+            return true;
+    }
+    catch {
+        // Fall back to filename checks
+    }
+    return ['setup', 'smartrelay-setup'].includes(path.basename(script, path.extname(script)));
+}
+if (checkDirectExecution()) {
+    loadDotEnv();
+    try {
+        const { values } = parseArgs({
+            options: {
+                config: { type: 'string', short: 'c' },
+                'non-interactive': { type: 'boolean', default: false },
+                help: { type: 'boolean', short: 'h', default: false },
+            },
+            allowPositionals: true,
+        });
+        if (values.help) {
+            process.stdout.write(`${USAGE}\n`);
+        }
+        else {
+            process.exitCode = await runSetup({
+                nonInteractive: values['non-interactive'],
+                configPath: values.config ?? null,
+            });
+        }
+    }
+    catch (err) {
+        process.stderr.write(`${describeError(err)}\n${USAGE}\n`);
+        process.exitCode = 2;
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/tools/dispatch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Transport-agnostic tool dispatch.
+ *
+ * Extracted from `http-api.ts` so the HTTP API, the MCPHub plugin, and tests all
+ * route through one switch instead of three drifting copies. Adding a tool here
+ * reaches every surface at once.
+ *
+ * Deliberately does NOT call `loadDotEnv()` at module scope — only the two CLI
+ * entrypoints (`server.ts`, `http-api.ts`) do. If this module loaded `.env`
+ * files, an ambient `.env` sitting in whatever directory the host process
+ * happens to run from would silently override credentials the user configured
+ * explicitly (for example in the MCPHub settings UI).
+ */
+import { BenchmarkEngine } from '../benchmark/engine.js';
+import { TaskRouter } from '../router.js';
+import { RunnerRegistry } from '../runners/registry.js';
+/** The three collaborators every tool handler needs. */
+export interface DispatchContext {
+    registry: RunnerRegistry;
+    router: TaskRouter;
+    engine: BenchmarkEngine;
+}
+export declare function getRegistry(configPath?: string | null): RunnerRegistry;
+export declare function getEngine(): BenchmarkEngine;
+export declare function getRouter(): TaskRouter;
+/**
+ * Build a standalone context that does not share the module-level singletons.
+ *
+ * Used where the process hosts more than just SmartRelay (the MCPHub plugin) and
+ * by tests that need an isolated registry.
+ */
+export declare function createDispatchContext(configPath?: string | null): DispatchContext;
+export declare function dispatchTool(toolName: string, args?: Record<string, unknown>, ctx?: DispatchContext): Promise<unknown>;