@harperfast/harper 5.0.30 → 5.1.0-beta.2

package/dist/bin/mcp/client.js

@@ -0,0 +1,395 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBridge = runBridge;
+exports.resolveConnection = resolveConnection;
+/**
+ * Streamable HTTP MCP client over stdio. Implements the MCP rev 2025-06-18
+ * transport from the client side: each line on stdin is a JSON-RPC frame,
+ * POSTed to the server's `/mcp` endpoint; the response (JSON or SSE) is
+ * parsed and emitted to stdout as line-delimited JSON-RPC. After the
+ * `initialize` handshake completes, a long-lived GET request opens the
+ * server-push SSE channel and forwards each notification to stdout.
+ *
+ * Sits between an MCP host (Claude Desktop, Cursor, Zed) and a running
+ * Harper instance. The host treats this as a stdio-transport MCP server;
+ * Harper sees a Streamable HTTP client. v1 keeps it simple — no
+ * `Last-Event-ID` resumability, no multi-process session coordination.
+ */
+const http = __importStar(require("node:http"));
+const https = __importStar(require("node:https"));
+const readline = __importStar(require("node:readline"));
+const node_string_decoder_1 = require("node:string_decoder");
+const node_url_1 = require("node:url");
+const cliCredentials_ts_1 = require("../cliCredentials.js");
+function isJwtish(token) {
+    return typeof token === 'string' && token.split('.').length === 3;
+}
+const SESSION_HEADER = 'mcp-session-id';
+const PROTOCOL_HEADER = 'mcp-protocol-version';
+/**
+ * Run the bridge until stdin closes (host disconnects) or the GET stream
+ * errors. Returns a promise that resolves on graceful shutdown.
+ */
+async function runBridge(opts) {
+    const stdin = opts.stdin ?? process.stdin;
+    const stdout = opts.stdout ?? process.stdout;
+    const stderr = opts.stderr ?? process.stderr;
+    const log = (msg) => {
+        stderr.write(`harper mcp: ${msg}\n`);
+    };
+    let sessionId;
+    let protocolVersion;
+    let getController;
+    const rl = readline.createInterface({ input: stdin, crlfDelay: Infinity });
+    const writeFrame = (frame) => {
+        stdout.write(JSON.stringify(frame) + '\n');
+    };
+    // stdin lines → POST /mcp
+    const stdinDone = (async () => {
+        for await (const line of rl) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let message;
+            try {
+                message = JSON.parse(trimmed);
+            }
+            catch (err) {
+                log(`stdin line is not valid JSON, ignoring: ${err.message}`);
+                continue;
+            }
+            try {
+                const result = await postMessage(opts.connection, opts.mountPath, message, sessionId, protocolVersion);
+                // Capture session id from initialize response.
+                const newSid = headerString(result.headers, SESSION_HEADER);
+                if (newSid && !sessionId) {
+                    sessionId = newSid;
+                    // If this is an initialize response, capture the protocol version
+                    // the server picked, then open the GET stream.
+                    const parsed = safeParse(result.bodyText);
+                    if (parsed && typeof parsed === 'object' && 'result' in parsed) {
+                        const r = parsed.result;
+                        if (r && typeof r.protocolVersion === 'string')
+                            protocolVersion = r.protocolVersion;
+                    }
+                    getController = openGetStream(opts.connection, opts.mountPath, sessionId, protocolVersion, writeFrame, log);
+                }
+                if (result.sse) {
+                    // Streaming POST response: each `message` event maps to a JSON-RPC frame.
+                    for await (const frame of result.sse) {
+                        if (frame.event && frame.event !== 'message')
+                            continue;
+                        const parsed = safeParse(frame.data);
+                        if (parsed)
+                            writeFrame(parsed);
+                    }
+                }
+                else if (result.bodyText) {
+                    const parsed = safeParse(result.bodyText);
+                    if (parsed)
+                        writeFrame(parsed);
+                }
+            }
+            catch (err) {
+                log(`POST failed: ${err.message}`);
+                // Best-effort: emit a JSON-RPC error keyed to the original id so the
+                // host doesn't hang waiting for a response.
+                const id = message?.id ?? null;
+                writeFrame({
+                    jsonrpc: '2.0',
+                    id,
+                    error: { code: -32603, message: err.message },
+                });
+            }
+        }
+    })();
+    try {
+        await stdinDone;
+    }
+    finally {
+        getController?.abort();
+    }
+}
+function openGetStream(connection, mountPath, sessionId, protocolVersion, writeFrame, log) {
+    const controller = new AbortController();
+    (async () => {
+        try {
+            // Pass `signal` straight into the underlying http.request so an
+            // abort fired before/during connect-handshake terminates cleanly —
+            // adding the listener post-await would miss that race.
+            const { res } = await openRequest(connection, mountPath, 'GET', {
+                accept: 'text/event-stream',
+                [SESSION_HEADER]: sessionId,
+                ...(protocolVersion ? { [PROTOCOL_HEADER]: protocolVersion } : {}),
+            }, undefined, controller.signal);
+            if (res.statusCode !== 200) {
+                log(`GET /mcp returned ${res.statusCode}; server-push notifications will not arrive`);
+                res.resume();
+                return;
+            }
+            for await (const frame of parseSseStream(res)) {
+                if (frame.event && frame.event !== 'message')
+                    continue;
+                const parsed = safeParse(frame.data);
+                if (parsed)
+                    writeFrame(parsed);
+            }
+        }
+        catch (err) {
+            if (err.code === 'ABORT_ERR')
+                return;
+            log(`GET stream error: ${err.message}`);
+        }
+    })();
+    return controller;
+}
+async function postMessage(connection, mountPath, body, sessionId, protocolVersion) {
+    const headers = {
+        'content-type': 'application/json',
+        'accept': 'application/json, text/event-stream',
+    };
+    if (sessionId)
+        headers[SESSION_HEADER] = sessionId;
+    if (protocolVersion)
+        headers[PROTOCOL_HEADER] = protocolVersion;
+    const { req, res } = await openRequest(connection, mountPath, 'POST', headers, JSON.stringify(body));
+    const contentType = (res.headers['content-type'] ?? '').toString();
+    if (contentType.startsWith('text/event-stream')) {
+        return {
+            statusCode: res.statusCode ?? 0,
+            contentType,
+            headers: res.headers,
+            bodyText: '',
+            sse: parseSseStream(res),
+        };
+    }
+    const bodyText = await collectBody(res);
+    req.destroy();
+    return { statusCode: res.statusCode ?? 0, contentType, headers: res.headers, bodyText };
+}
+function openRequest(connection, mountPath, method, headers, body, signal) {
+    return new Promise((resolve, reject) => {
+        const isHttps = connection.protocol === 'https:';
+        const lib = isHttps ? https : http;
+        const reqHeaders = { ...headers };
+        if (connection.authHeader)
+            reqHeaders.authorization = connection.authHeader;
+        const reqOptions = {
+            method,
+            path: mountPath,
+            headers: reqHeaders,
+            signal,
+        };
+        if (connection.socketPath) {
+            reqOptions.socketPath = connection.socketPath;
+        }
+        else {
+            reqOptions.hostname = connection.hostname;
+            reqOptions.port = connection.port;
+        }
+        if (isHttps) {
+            reqOptions.rejectUnauthorized = connection.rejectUnauthorized;
+        }
+        const req = lib.request(reqOptions, (res) => {
+            resolve({ req, res });
+        });
+        req.on('error', (err) => reject(err));
+        if (body !== undefined)
+            req.write(body);
+        req.end();
+    });
+}
+async function collectBody(res) {
+    const chunks = [];
+    for await (const chunk of res) {
+        chunks.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf8') : chunk);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+/**
+ * Minimal SSE stream parser per WHATWG (server-sent events). MCP uses only
+ * the `event`, `data`, and `id` fields; we ignore `retry` and comments.
+ * Multi-line `data:` blocks are joined with `\n`.
+ *
+ * Two correctness details:
+ *   - `StringDecoder` preserves multi-byte UTF-8 sequences that straddle
+ *     chunk boundaries — naive `chunk.toString('utf8')` would corrupt
+ *     them.
+ *   - Strip `\r` so the `\n\n` event delimiter matches whether the server
+ *     emits LF or CRLF line endings (HTTP/SSE often uses CRLF).
+ */
+async function* parseSseStream(stream) {
+    let buffer = '';
+    const decoder = new node_string_decoder_1.StringDecoder('utf8');
+    for await (const chunk of stream) {
+        const text = typeof chunk === 'string' ? chunk : decoder.write(chunk);
+        buffer += text.replace(/\r/g, '');
+        let idx;
+        while ((idx = buffer.indexOf('\n\n')) !== -1) {
+            const raw = buffer.slice(0, idx);
+            buffer = buffer.slice(idx + 2);
+            const frame = parseSseFrame(raw);
+            if (frame)
+                yield frame;
+        }
+    }
+    const tail = decoder.end();
+    if (tail)
+        buffer += tail.replace(/\r/g, '');
+    if (buffer.trim().length > 0) {
+        const frame = parseSseFrame(buffer);
+        if (frame)
+            yield frame;
+    }
+}
+function parseSseFrame(raw) {
+    const lines = raw.split(/\r?\n/);
+    let event;
+    let dataLines = [];
+    let id;
+    for (const line of lines) {
+        if (!line || line.startsWith(':'))
+            continue;
+        const colon = line.indexOf(':');
+        const field = colon === -1 ? line : line.slice(0, colon);
+        let value = colon === -1 ? '' : line.slice(colon + 1);
+        if (value.startsWith(' '))
+            value = value.slice(1);
+        if (field === 'event')
+            event = value;
+        else if (field === 'data')
+            dataLines.push(value);
+        else if (field === 'id')
+            id = value;
+    }
+    if (dataLines.length === 0)
+        return null;
+    return { event, data: dataLines.join('\n'), id };
+}
+function headerString(headers, key) {
+    const v = headers[key.toLowerCase()];
+    if (Array.isArray(v))
+        return v[0];
+    return v;
+}
+function safeParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve `--target` / UDS path + creds → HttpOptions.
+ *
+ * UDS-mode caveat: only the **operations** profile is reachable via the
+ * local Unix Domain Socket. The application profile is mounted on the
+ * application HTTP server (the same listener that serves your REST
+ * endpoints), which doesn't expose a UDS in v1. Selecting
+ * `--profile application` without `--target` is a user error — we throw
+ * here rather than silently routing to the operations UDS (which would
+ * misleadingly return the operations tool list under super_user auth).
+ */
+function resolveConnection(opts) {
+    if (opts.target) {
+        let parsed;
+        try {
+            parsed = new node_url_1.URL(opts.target);
+        }
+        catch {
+            parsed = new node_url_1.URL(`https://${opts.target}`);
+        }
+        const proto = parsed.protocol === 'http:' ? 'http:' : 'https:';
+        const authHeader = computeAuthHeader(opts, parsed);
+        return {
+            protocol: proto,
+            hostname: parsed.hostname,
+            port: parsed.port || (proto === 'https:' ? 443 : 80),
+            rejectUnauthorized: opts.rejectUnauthorized,
+            authHeader,
+        };
+    }
+    if (opts.profile === 'application') {
+        throw new Error('harper mcp: --profile application requires --target https://<host>:<port>. ' +
+            'The application MCP endpoint is mounted on the application HTTP server, which ' +
+            'does not expose a local UDS in v1.');
+    }
+    // UDS path resolution mirrors bin/cliOperations.ts:150.
+    const { getConfigPath } = require('../../config/configUtils');
+    const terms = require('../../utility/hdbTerms');
+    const socketPath = getConfigPath(terms.CONFIG_PARAMS.OPERATIONSAPI_NETWORK_DOMAINSOCKET);
+    return {
+        protocol: 'http:',
+        socketPath,
+        rejectUnauthorized: true,
+        authHeader: undefined,
+    };
+}
+/**
+ * Precedence (highest first):
+ *   1. --bearer <token>
+ *   2. --username + --password
+ *   3. URL embedded user/pass (https://user:pw@host)
+ *   4. Saved JWT from `~/.harperdb/credentials.json` for the resolved target
+ *      (populated by `harper login` — same flow `bin/cliOperations.ts` uses).
+ *
+ * Returning undefined here means "no creds in scope"; the request goes out
+ * unauthenticated and the server gates accordingly.
+ */
+function computeAuthHeader(opts, parsed) {
+    if (opts.bearer)
+        return `Bearer ${opts.bearer}`;
+    const u = opts.username ?? parsed.username;
+    const p = opts.password ?? parsed.password;
+    if (u)
+        return `Basic ${Buffer.from(`${u}:${p ?? ''}`).toString('base64')}`;
+    try {
+        const all = (0, cliCredentials_ts_1.loadCredentials)();
+        // Same lookup key shape `harper login` / cliOperations writes/reads:
+        // `normalizeTarget(<user-supplied URL>)`.
+        const lookup = (0, cliCredentials_ts_1.normalizeTarget)(opts.target);
+        const tokens = all.targets?.[lookup];
+        if (tokens?.operation_token && isJwtish(tokens.operation_token)) {
+            return `Bearer ${tokens.operation_token}`;
+        }
+    }
+    catch {
+        // Missing / unreadable credentials file is non-fatal — fall through to anonymous.
+    }
+    return undefined;
+}
+//# sourceMappingURL=client.js.map

package/dist/bin/mcp/client.js.map

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

package/dist/bin/mcp/doctor.d.ts

@@ -0,0 +1,11 @@
+import type { McpCliOptions } from './options.ts';
+export interface DoctorResult {
+    ok: boolean;
+    steps: ReadonlyArray<{
+        name: string;
+        ok: boolean;
+        detail?: string;
+    }>;
+}
+export declare function runDoctor(opts: McpCliOptions): Promise<DoctorResult>;
+export declare function formatDoctorReport(result: DoctorResult, stdout?: NodeJS.WritableStream): void;

package/dist/bin/mcp/doctor.js

@@ -0,0 +1,193 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+exports.formatDoctorReport = formatDoctorReport;
+/**
+ * `harper mcp doctor` — quick connectivity + handshake smoke check.
+ *
+ * Steps:
+ *   1. Resolve connection (UDS or network).
+ *   2. POST an `initialize` request.
+ *   3. Read the response, capture Mcp-Session-Id.
+ *   4. POST a `tools/list` and confirm a JSON-RPC result comes back.
+ *   5. DELETE the session (if allowed) for cleanup.
+ *
+ * Each step prints a line to stdout (one line = one OK/FAIL). Exit code
+ * is 0 on full success, 1 if any step fails.
+ */
+const http = __importStar(require("node:http"));
+const https = __importStar(require("node:https"));
+const client_ts_1 = require("./client.js");
+const SESSION_HEADER = 'mcp-session-id';
+const PROTOCOL_VERSION = '2025-06-18';
+async function runDoctor(opts) {
+    const connection = (0, client_ts_1.resolveConnection)(opts);
+    const steps = [];
+    // Step 1: initialize.
+    let sessionId;
+    let protocolVersion = PROTOCOL_VERSION;
+    try {
+        const res = await postJson(connection, opts.mountPath, {
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'initialize',
+            params: {
+                protocolVersion: PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: { name: 'harper-mcp-doctor', version: '1.0.0' },
+            },
+        });
+        if (res.statusCode !== 200) {
+            steps.push({ name: 'initialize', ok: false, detail: `HTTP ${res.statusCode}: ${res.body.slice(0, 200)}` });
+            return finalize(steps);
+        }
+        const sid = res.headers[SESSION_HEADER];
+        sessionId = Array.isArray(sid) ? sid[0] : sid;
+        const parsed = JSON.parse(res.body);
+        if (parsed?.error) {
+            steps.push({ name: 'initialize', ok: false, detail: `JSON-RPC error: ${parsed.error.message}` });
+            return finalize(steps);
+        }
+        if (typeof parsed?.result?.protocolVersion === 'string')
+            protocolVersion = parsed.result.protocolVersion;
+        steps.push({ name: 'initialize', ok: true, detail: `session=${sessionId} protocol=${protocolVersion}` });
+    }
+    catch (err) {
+        steps.push({ name: 'initialize', ok: false, detail: err.message });
+        return finalize(steps);
+    }
+    // Step 2: tools/list (validates the session works for real dispatch).
+    try {
+        const res = await postJson(connection, opts.mountPath, { jsonrpc: '2.0', id: 2, method: 'tools/list' }, sessionId, protocolVersion);
+        if (res.statusCode !== 200) {
+            steps.push({ name: 'tools/list', ok: false, detail: `HTTP ${res.statusCode}` });
+            return finalize(steps);
+        }
+        const parsed = JSON.parse(res.body);
+        if (parsed?.error) {
+            steps.push({ name: 'tools/list', ok: false, detail: `JSON-RPC error: ${parsed.error.message}` });
+            return finalize(steps);
+        }
+        const count = Array.isArray(parsed?.result?.tools) ? parsed.result.tools.length : 0;
+        steps.push({ name: 'tools/list', ok: true, detail: `${count} tool(s) visible` });
+    }
+    catch (err) {
+        steps.push({ name: 'tools/list', ok: false, detail: err.message });
+        return finalize(steps);
+    }
+    // Step 3: DELETE the session. Tolerated to fail (some configs disable it
+    // with allowClientDelete=false → 405). Either way the doctor overall is
+    // still OK if initialize + tools/list passed.
+    try {
+        const del = await sendDelete(connection, opts.mountPath, sessionId, protocolVersion);
+        if (del.statusCode >= 200 && del.statusCode < 300) {
+            steps.push({ name: 'session cleanup', ok: true });
+        }
+        else {
+            steps.push({ name: 'session cleanup', ok: false, detail: `HTTP ${del.statusCode}` });
+        }
+    }
+    catch (err) {
+        steps.push({ name: 'session cleanup', ok: false, detail: err.message });
+    }
+    return finalize(steps);
+}
+function finalize(steps) {
+    const ok = steps.every((s) => s.ok || s.name === 'session cleanup');
+    return { ok, steps };
+}
+function postJson(connection, mountPath, body, sessionId, protocolVersion) {
+    const headers = {
+        'content-type': 'application/json',
+        'accept': 'application/json, text/event-stream',
+    };
+    if (sessionId)
+        headers[SESSION_HEADER] = sessionId;
+    if (protocolVersion)
+        headers['mcp-protocol-version'] = protocolVersion;
+    return rawRequest(connection, mountPath, 'POST', headers, JSON.stringify(body));
+}
+function sendDelete(connection, mountPath, sessionId, protocolVersion) {
+    return rawRequest(connection, mountPath, 'DELETE', {
+        [SESSION_HEADER]: sessionId,
+        'mcp-protocol-version': protocolVersion,
+    });
+}
+function rawRequest(connection, mountPath, method, headers, body) {
+    return new Promise((resolve, reject) => {
+        const isHttps = connection.protocol === 'https:';
+        const lib = isHttps ? https : http;
+        const reqHeaders = { ...headers };
+        if (connection.authHeader)
+            reqHeaders.authorization = connection.authHeader;
+        const reqOpts = {
+            method,
+            path: mountPath,
+            headers: reqHeaders,
+        };
+        if (connection.socketPath) {
+            reqOpts.socketPath = connection.socketPath;
+        }
+        else {
+            reqOpts.hostname = connection.hostname;
+            reqOpts.port = connection.port;
+        }
+        if (isHttps)
+            reqOpts.rejectUnauthorized = connection.rejectUnauthorized;
+        const req = lib.request(reqOpts, async (res) => {
+            const chunks = [];
+            for await (const chunk of res)
+                chunks.push(typeof chunk === 'string' ? Buffer.from(chunk, 'utf8') : chunk);
+            resolve({
+                statusCode: res.statusCode ?? 0,
+                headers: res.headers,
+                body: Buffer.concat(chunks).toString('utf8'),
+            });
+        });
+        req.on('error', reject);
+        if (body !== undefined)
+            req.write(body);
+        req.end();
+    });
+}
+function formatDoctorReport(result, stdout = process.stdout) {
+    for (const s of result.steps) {
+        const tag = s.ok ? 'OK  ' : 'FAIL';
+        stdout.write(`[${tag}] ${s.name}${s.detail ? ' — ' + s.detail : ''}\n`);
+    }
+    stdout.write(result.ok ? '\nAll checks passed.\n' : '\nDoctor reported failures; see above.\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/bin/mcp/doctor.js.map

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

package/dist/bin/mcp/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `harper mcp` — stdio CLI for connecting an MCP host (Claude Desktop,
+ * Cursor, Zed) to a running Harper instance. Dispatches to one of three
+ * subcommands (bridge, print-config, doctor). With no subcommand the
+ * bridge runs and stays alive until stdin closes.
+ */
+import { parseArgs, type McpCliOptions } from './options.ts';
+export declare function runMcpCli(argv: readonly string[]): Promise<number>;
+export { parseArgs };
+export type { McpCliOptions };