@reddb-io/ui-mcp 0.1.1

package/dist/local-server.js

@@ -0,0 +1,356 @@
+// Local-file mode for the MCP App (#48, #50, ADR-0006).
+//
+// A browser Surface cannot reach a filesystem `.rdb`, and the MCP process (Node)
+// cannot open it either — reddb's embedded mode is Rust-only. So for a local
+// target we spawn ONE `red server --http --http-bind 127.0.0.1:<ephemeral>
+// --path <file>` child that owns the file, wait for `/stats` to report healthy,
+// and hand the UI `?cs=http://127.0.0.1:<port>`. The child is torn down on MCP
+// exit/disconnect — no orphan servers. We never reimplement the reddb HTTP API;
+// we shell out to the `red` binary.
+//
+// Lock-aware open (#50): reddb takes a single-writer `flock` on the file. The
+// trigger case is inspecting an agent's live memory `.rdb` while the agent is
+// writing it — a read-write open would fail on the lock. So when the caller does
+// not pin `readOnly`, we open read-write first and, if reddb dies on the lock,
+// transparently retry with `--read-only`. reddb then reports `read_only` in
+// `/stats` and the UI renders the existing read-only badge (#23).
+import { spawn } from "node:child_process";
+import { accessSync, constants as fsConstants } from "node:fs";
+import { createServer } from "node:net";
+import { homedir } from "node:os";
+import { delimiter, isAbsolute, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+// Modules that may expose reddb's binary resolver. `@reddb-io/sdk` is the
+// canonical name in ADR-0006; `reddb-cli` is the package that currently ships
+// `resolveBinary`. Either is optional — neither is a hard dependency of this
+// package, so resolution falls through to a PATH `red` when absent.
+const SDK_CANDIDATES = ["@reddb-io/sdk", "reddb-cli"];
+/**
+ * Resolve a fuzzy local target into an absolute filesystem path the `red`
+ * binary can `--path`. Handles `file://` URLs, `~`/`~/…` home expansion, and
+ * relative paths (resolved against the MCP process cwd).
+ */
+export function resolveLocalFilePath(target) {
+    const t = target.trim();
+    if (/^file:\/\//i.test(t))
+        return fileURLToPath(t);
+    if (t === "~")
+        return homedir();
+    if (t.startsWith("~/"))
+        return join(homedir(), t.slice(2));
+    if (isAbsolute(t))
+        return t;
+    return resolve(process.cwd(), t);
+}
+function isExecutable(file) {
+    try {
+        accessSync(file, fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Find an executable by name on PATH (mirrors `which`). */
+function findOnPath(name) {
+    const paths = (process.env.PATH ?? "").split(delimiter).filter(Boolean);
+    const names = process.platform === "win32" ? [name, `${name}.exe`] : [name];
+    for (const dir of paths) {
+        for (const candidate of names) {
+            const full = join(dir, candidate);
+            if (process.platform === "win32" ? true : isExecutable(full)) {
+                // On win32 PATHEXT handling is approximate; accept the first match.
+                if (process.platform === "win32" && !isFile(full))
+                    continue;
+                return full;
+            }
+        }
+    }
+    return null;
+}
+function isFile(file) {
+    try {
+        accessSync(file, fsConstants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve the `red` binary: explicit `RED_BINARY` env → `@reddb-io/sdk`'s
+ * subprocess binary (or `reddb-cli`'s) → a PATH `red`. Throws an actionable
+ * error when none is found.
+ */
+export async function resolveRedBinary() {
+    const envBin = process.env.RED_BINARY?.trim();
+    if (envBin)
+        return { binaryPath: envBin, source: "env" };
+    for (const name of SDK_CANDIDATES) {
+        try {
+            const mod = await import(name);
+            const resolveBinary = (mod.resolveBinary ??
+                mod.default?.resolveBinary);
+            if (typeof resolveBinary === "function") {
+                const binaryPath = await resolveBinary();
+                if (binaryPath && isFile(binaryPath)) {
+                    return { binaryPath, source: name };
+                }
+            }
+        }
+        catch {
+            // Not installed or resolution failed; try the next strategy.
+        }
+    }
+    const onPath = findOnPath("red");
+    if (onPath)
+        return { binaryPath: onPath, source: "path" };
+    throw new Error("Cannot open a local .rdb file: no reddb `red` binary found. " +
+        "Install the reddb SDK (`pnpm add @reddb-io/sdk`) so its bundled binary " +
+        "can be used, put `red` on your PATH, or set RED_BINARY to its absolute path. " +
+        "See ADR-0006.");
+}
+/** Reserve a free TCP port on the loopback interface, then release it. */
+function pickEphemeralPort() {
+    return new Promise((resolvePort, reject) => {
+        const srv = createServer();
+        srv.unref();
+        srv.once("error", reject);
+        srv.listen(0, "127.0.0.1", () => {
+            const addr = srv.address();
+            const port = addr && typeof addr === "object" ? addr.port : 0;
+            srv.close(() => {
+                if (port)
+                    resolvePort(port);
+                else
+                    reject(new Error("Could not reserve an ephemeral port."));
+            });
+        });
+    });
+}
+function delay(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/**
+ * Poll `${baseUrl}/stats` until it answers 200, the child exits, the timeout
+ * elapses, or the signal aborts. `/stats` is reddb's canonical proof-of-life
+ * (CLAUDE.md: `/health` returns 503 by design).
+ */
+async function waitForHealthy(baseUrl, child, timeoutMs, getStderr, signal) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        if (signal?.aborted)
+            throw new Error("Local server startup aborted.");
+        if (child.exitCode !== null || child.signalCode !== null) {
+            throw new Error(`red server exited (code ${child.exitCode}, signal ${child.signalCode}) ` +
+                `before /stats became healthy.${getStderr() ? `\n${getStderr()}` : ""}`);
+        }
+        try {
+            const res = await fetch(`${baseUrl}/stats`, {
+                signal: AbortSignal.timeout(1500),
+            });
+            if (res.ok)
+                return;
+        }
+        catch {
+            // Not accepting connections yet — keep polling.
+        }
+        if (Date.now() > deadline) {
+            throw new Error(`red server did not report healthy at ${baseUrl}/stats within ` +
+                `${timeoutMs}ms.${getStderr() ? `\n${getStderr()}` : ""}`);
+        }
+        await delay(150);
+    }
+}
+/**
+ * Raised when `red server` dies trying to acquire the single-writer `flock` on
+ * the target — the signal to retry the open with `--read-only` (#50).
+ */
+export class LockContentionError extends Error {
+    detail;
+    constructor(detail) {
+        super("The .rdb is already held by another writer (reddb single-writer flock)." +
+            (detail ? `\n${detail}` : ""));
+        this.detail = detail;
+        this.name = "LockContentionError";
+    }
+}
+// Signatures of reddb failing to take the single-writer `flock` on the file,
+// across platforms and wordings. Deliberately broad: a false positive only costs
+// one extra `--read-only` retry, while a miss leaves the trigger case (a live
+// agent memory `.rdb`) unopenable. We cannot import reddb's exact message —
+// it is a separate Rust binary — so we match the family of lock-contention text.
+const LOCK_CONTENTION_PATTERNS = [
+    /flock/i,
+    /\block(ed|ing)?\b/i,
+    /would.?block/i,
+    /resource temporarily unavailable/i,
+    /\bE?WOULDBLOCK\b|\bEAGAIN\b/i,
+    /another (process|writer|instance)/i,
+    /already (open|held|locked|running)/i,
+    /single.?writer/i,
+    /in use by/i,
+    /read[-_ ]?only/i,
+];
+/** True when `text` (a `red server` stderr) looks like single-writer lock
+ *  contention — used to decide whether to retry the open as `--read-only`. */
+export function looksLikeLockContention(text) {
+    return Boolean(text) && LOCK_CONTENTION_PATTERNS.some((re) => re.test(text));
+}
+/**
+ * Spawn one `red server` for a single open mode and wait for `/stats` healthy.
+ * Resolves to a tracked-elsewhere handle, or rejects: with `LockContentionError`
+ * when the child died on the flock (caller may retry `--read-only`), otherwise
+ * with the raw startup error.
+ */
+async function attemptSpawn(opts) {
+    const port = opts.port ?? (await pickEphemeralPort());
+    const baseUrl = `http://127.0.0.1:${port}`;
+    const args = [
+        "server",
+        "--http",
+        "--http-bind",
+        `127.0.0.1:${port}`,
+        "--path",
+        opts.filePath,
+    ];
+    if (opts.readOnly)
+        args.push("--read-only");
+    const child = spawn(opts.binaryPath, args, {
+        stdio: ["ignore", "ignore", "pipe"],
+    });
+    let stderr = "";
+    child.stderr?.on("data", (chunk) => {
+        stderr += chunk.toString();
+        if (stderr.length > 4000)
+            stderr = stderr.slice(-4000);
+    });
+    const handle = {
+        baseUrl,
+        port,
+        filePath: opts.filePath,
+        readOnly: opts.readOnly,
+        child,
+        stop: makeStop(child),
+    };
+    try {
+        await waitForHealthy(baseUrl, child, opts.healthTimeoutMs, () => stderr.trim(), opts.signal);
+    }
+    catch (error) {
+        await handle.stop();
+        // Did the child die on the single-writer flock? If so, let the caller decide
+        // to retry --read-only rather than surfacing a raw "exited" error.
+        const exited = child.exitCode !== null || child.signalCode !== null;
+        if (!opts.readOnly && exited && looksLikeLockContention(stderr)) {
+            throw new LockContentionError(stderr.trim());
+        }
+        throw error;
+    }
+    return handle;
+}
+/**
+ * Spawn one `red server` that owns `target`, wait for `/stats` to report
+ * healthy, and return a handle whose `stop()` tears the child down.
+ *
+ * Open mode (#50): an explicit `readOnly` is honoured verbatim. When it is
+ * unspecified, the file opens read-write but transparently falls back to
+ * `--read-only` if reddb dies acquiring the single-writer `flock` — the trigger
+ * case being a second viewer of a live agent memory `.rdb` (ADR-0006).
+ */
+export async function spawnLocalServer(options) {
+    const { target, healthTimeoutMs = 10_000, signal } = options;
+    const filePath = resolveLocalFilePath(target);
+    const binaryPath = options.binaryPath ?? (await resolveRedBinary()).binaryPath;
+    const attempt = (readOnly) => attemptSpawn({
+        binaryPath,
+        filePath,
+        readOnly,
+        port: options.port,
+        healthTimeoutMs,
+        signal,
+    });
+    let handle;
+    if (options.readOnly !== undefined) {
+        handle = await attempt(options.readOnly);
+    }
+    else {
+        try {
+            handle = await attempt(false);
+        }
+        catch (error) {
+            if (!(error instanceof LockContentionError))
+                throw error;
+            // The file is flock-held by another writer — reopen read-only (#50).
+            handle = await attempt(true);
+        }
+    }
+    trackServer(handle);
+    return handle;
+}
+function makeStop(child) {
+    let stopping = null;
+    return () => {
+        if (stopping)
+            return stopping;
+        stopping = new Promise((resolveStop) => {
+            if (child.exitCode !== null || child.signalCode !== null) {
+                resolveStop();
+                return;
+            }
+            const onExit = () => {
+                clearTimeout(killTimer);
+                resolveStop();
+            };
+            child.once("exit", onExit);
+            const killTimer = setTimeout(() => {
+                child.kill("SIGKILL");
+            }, 3000);
+            killTimer.unref?.();
+            child.kill("SIGTERM");
+        });
+        return stopping;
+    };
+}
+// --- lifecycle registry: guarantee no orphan servers on MCP exit/disconnect ---
+const liveServers = new Set();
+let exitHooksInstalled = false;
+function installExitHooks() {
+    if (exitHooksInstalled)
+        return;
+    exitHooksInstalled = true;
+    // Synchronous best-effort kill on hard exit — handlers can't await.
+    process.on("exit", () => {
+        for (const handle of liveServers) {
+            try {
+                handle.child.kill("SIGKILL");
+            }
+            catch {
+                // already gone
+            }
+        }
+    });
+    for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+        process.on(sig, () => {
+            for (const handle of liveServers) {
+                try {
+                    handle.child.kill("SIGKILL");
+                }
+                catch {
+                    // already gone
+                }
+            }
+            process.exit(0);
+        });
+    }
+}
+function trackServer(handle) {
+    installExitHooks();
+    liveServers.add(handle);
+    handle.child.once("exit", () => liveServers.delete(handle));
+}
+/** Stop every tracked local server (MCP transport close / shutdown). */
+export async function stopAllLocalServers() {
+    const handles = [...liveServers];
+    await Promise.all(handles.map((h) => h.stop()));
+}
+//# sourceMappingURL=local-server.js.map

package/dist/local-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-server.js","sourceRoot":"","sources":["../src/local-server.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,2EAA2E;AAC3E,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,iFAAiF;AACjF,+EAA+E;AAC/E,4EAA4E;AAC5E,kEAAkE;AAElE,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,0EAA0E;AAC1E,8EAA8E;AAC9E,6EAA6E;AAC7E,oEAAoE;AACpE,MAAM,cAAc,GAAG,CAAC,eAAe,EAAE,WAAW,CAAU,CAAC;AA+B/D;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5E,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAClC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,oEAAoE;gBACpE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC5D,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,MAAM;QAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAEzD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAA4B,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,aAAa;gBACrC,GAAG,CAAC,OAA+C,EAAE,aAAa,CAExD,CAAC;YACd,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;gBACzC,IAAI,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM;QAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAE1D,MAAM,IAAI,KAAK,CACb,8DAA8D;QAC5D,yEAAyE;QACzE,+EAA+E;QAC/E,eAAe,CAClB,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,iBAAiB;IACxB,OAAO,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE;QACzC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;gBACb,IAAI,IAAI;oBAAE,WAAW,CAAC,IAAI,CAAC,CAAC;;oBACvB,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,cAAc,CAC3B,OAAe,EACf,KAAmB,EACnB,SAAiB,EACjB,SAAuB,EACvB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,SAAS,CAAC;QACR,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,CAAC,QAAQ,YAAY,KAAK,CAAC,UAAU,IAAI;gBACvE,gCAAgC,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE;gBAC1C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,EAAE;gBAAE,OAAO;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,wCAAwC,OAAO,gBAAgB;gBAC7D,GAAG,SAAS,MAAM,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5D,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAChB;IAA5B,YAA4B,MAAc;QACxC,KAAK,CACH,yEAAyE;YACvE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAChC,CAAC;QAJwB,WAAM,GAAN,MAAM,CAAQ;QAKxC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,6EAA6E;AAC7E,iFAAiF;AACjF,8EAA8E;AAC9E,4EAA4E;AAC5E,iFAAiF;AACjF,MAAM,wBAAwB,GAAG;IAC/B,QAAQ;IACR,oBAAoB;IACpB,eAAe;IACf,mCAAmC;IACnC,8BAA8B;IAC9B,oCAAoC;IACpC,qCAAqC;IACrC,iBAAiB;IACjB,YAAY;IACZ,iBAAiB;CAClB,CAAC;AAEF;8EAC8E;AAC9E,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAWD;;;;;GAKG;AACH,KAAK,UAAU,YAAY,CAAC,IAAoB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,oBAAoB,IAAI,EAAE,CAAC;IAE3C,MAAM,IAAI,GAAG;QACX,QAAQ;QACR,QAAQ;QACR,aAAa;QACb,aAAa,IAAI,EAAE;QACnB,QAAQ;QACR,IAAI,CAAC,QAAQ;KACd,CAAC;IACF,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE;QACzC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACzC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI;YAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAsB;QAChC,OAAO;QACP,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK;QACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC;KACtB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,cAAc,CAClB,OAAO,EACP,KAAK,EACL,IAAI,CAAC,eAAe,EACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EACnB,IAAI,CAAC,MAAM,CACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,6EAA6E;QAC7E,mEAAmE;QACnE,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;QACpE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgC;IAEhC,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC7D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,IAAI,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAAC;IAE9D,MAAM,OAAO,GAAG,CAAC,QAAiB,EAA8B,EAAE,CAChE,YAAY,CAAC;QACX,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,eAAe;QACf,MAAM;KACP,CAAC,CAAC;IAEL,IAAI,MAAyB,CAAC;IAC9B,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,mBAAmB,CAAC;gBAAE,MAAM,KAAK,CAAC;YACzD,qEAAqE;YACrE,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,WAAW,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAmB;IACnC,IAAI,QAAQ,GAAyB,IAAI,CAAC;IAC1C,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,QAAQ,GAAG,IAAI,OAAO,CAAO,CAAC,WAAW,EAAE,EAAE;YAC3C,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBACzD,WAAW,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,WAAW,EAAE,CAAC;YAChB,CAAC,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAqB,CAAC;AACjD,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B,SAAS,gBAAgB;IACvB,IAAI,kBAAkB;QAAE,OAAO;IAC/B,kBAAkB,GAAG,IAAI,CAAC;IAE1B,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,EAAE,CAAC;QAC3D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;YACnB,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe;gBACjB,CAAC;YACH,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAyB;IAC5C,gBAAgB,EAAE,CAAC;IACnB,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,OAAO,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IACjC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/red-client.d.ts

@@ -0,0 +1,72 @@
+export interface QueryRow {
+    values: Record<string, unknown>;
+    edges?: Record<string, unknown>;
+    nodes?: Record<string, unknown>;
+    paths?: unknown[];
+}
+export interface QueryResult {
+    ok: boolean;
+    query: string;
+    capability?: string;
+    engine?: string;
+    mode?: string;
+    record_count: number;
+    result: {
+        columns: string[];
+        records: QueryRow[];
+    };
+    error?: string;
+    /** True when assembled from the NDJSON stream rather than buffered `/query`. */
+    streamed?: boolean;
+    /** True when streaming stopped at `maxRows` with more rows on the server. */
+    truncated?: boolean;
+}
+/** Result of collecting a read-only SELECT over the NDJSON streaming endpoint. */
+export interface StreamedQueryResult {
+    columns: string[];
+    schemaFingerprint?: string;
+    rows: Array<Record<string, unknown>>;
+    rowCount: number;
+    truncated: boolean;
+    cursor?: string;
+}
+export interface RedClientOptions {
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+}
+export declare class RedClient {
+    readonly baseUrl: string;
+    private readonly headers;
+    private readonly fetcher;
+    constructor(baseUrl: string, opts?: RedClientOptions);
+    private json;
+    /** Buffered query (`POST /query`). */
+    query(query: string): Promise<QueryResult>;
+    collections(): Promise<string[]>;
+    /**
+     * Stream a read-only SELECT through `POST /query/stream` (NDJSON, chunked),
+     * collecting up to `maxRows` before cancelling the server cursor. Throws for a
+     * non-SELECT (server `400`) and for an absent route on an older server (`404`)
+     * — callers fall back to {@link query}.
+     */
+    queryStreamCollect(query: string, opts?: {
+        maxRows?: number;
+        signal?: AbortSignal;
+    }): Promise<StreamedQueryResult>;
+    /** Cancel a streaming-query cursor server-side (`POST /query/stream/cancel`). */
+    cancelQueryStream(cursor: string): Promise<void>;
+}
+/** A read-only client surface — the only methods the data tools depend on. So
+ *  tests can pass a mock, and #48's local-spawn path can supply its own. */
+export type ReadClient = Pick<RedClient, "query" | "collections" | "queryStreamCollect">;
+/**
+ * Run a read SELECT preferring the bounded-memory NDJSON stream, falling back to
+ * the buffered `POST /query` for everything the stream can't take — a non-SELECT
+ * statement, a network error, or an older server with no `/query/stream` route.
+ * Honest streaming negotiation (#22): identical to {@link RedClient.query}
+ * unless the server supports streaming AND the statement is a SELECT.
+ */
+export declare function runQueryPreferStream(client: ReadClient, sql: string, opts?: {
+    maxRows?: number;
+    signal?: AbortSignal;
+}): Promise<QueryResult>;

package/dist/red-client.js

@@ -0,0 +1,171 @@
+// Server-side reddb HTTP client for the MCP process (#49, ADR-0006).
+//
+// The MCP App's data tools (`query`/`list`/`get`) answer the *model* directly —
+// they run here in the Node process against the resolved connection, rather than
+// driving the visual iframe. This is a focused port of the browser client in
+// `packages/ui/src/lib/reddb/client.ts`: it covers only the read endpoints the
+// data tools need (`/query`, `/query/stream`, `/collections`) and reuses Node's
+// global `fetch` (Node >= 20). It is NOT @reddb-io/client — endpoints mirror the
+// hand-rolled UI client, verified against reddb's routing.rs.
+//
+// Auth lives entirely in the `headers` passed to the constructor; it is never
+// logged and never returned in tool output (acceptance: no secret/token leaks).
+/**
+ * Parse a chunked `application/x-ndjson` body into one frame per line. Buffers
+ * across chunk boundaries and flushes a trailing newline-less line at EOF.
+ */
+async function* parseNdjsonFrames(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buf = "";
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let nl;
+            while ((nl = buf.indexOf("\n")) !== -1) {
+                const line = buf.slice(0, nl).trim();
+                buf = buf.slice(nl + 1);
+                if (line)
+                    yield JSON.parse(line);
+            }
+        }
+        const tail = buf.trim();
+        if (tail)
+            yield JSON.parse(tail);
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+const SELECT_RE = /^\s*select\b/i;
+export class RedClient {
+    baseUrl;
+    headers;
+    fetcher;
+    constructor(baseUrl, opts = {}) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.headers = opts.headers;
+        this.fetcher = opts.fetch ?? fetch;
+    }
+    async json(path, init) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+            ...this.headers,
+            ...init?.headers,
+        };
+        const res = await this.fetcher(url, { ...init, headers });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            // The error body is the server's response, not our request — it never
+            // contains the auth header we sent. Truncated to keep tool output terse.
+            throw new Error(`${init?.method ?? "GET"} ${path} → ${res.status} ${body.slice(0, 200)}`);
+        }
+        return res.json();
+    }
+    /** Buffered query (`POST /query`). */
+    async query(query) {
+        return this.json("/query", {
+            method: "POST",
+            body: JSON.stringify({ query }),
+        });
+    }
+    async collections() {
+        const r = await this.json("/collections");
+        return r.collections ?? [];
+    }
+    /**
+     * Stream a read-only SELECT through `POST /query/stream` (NDJSON, chunked),
+     * collecting up to `maxRows` before cancelling the server cursor. Throws for a
+     * non-SELECT (server `400`) and for an absent route on an older server (`404`)
+     * — callers fall back to {@link query}.
+     */
+    async queryStreamCollect(query, opts = {}) {
+        const maxRows = opts.maxRows ?? 10_000;
+        const res = await this.fetcher(`${this.baseUrl}/query/stream`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/x-ndjson",
+                ...this.headers,
+            },
+            body: JSON.stringify({ query }),
+            signal: opts.signal,
+        });
+        if (!res.ok || !res.body) {
+            const body = res.body ? await res.text().catch(() => "") : "";
+            throw new Error(`POST /query/stream → ${res.status} ${body.slice(0, 200)}`);
+        }
+        const out = {
+            columns: [],
+            rows: [],
+            rowCount: 0,
+            truncated: false,
+        };
+        for await (const frame of parseNdjsonFrames(res.body)) {
+            if ("descriptor" in frame) {
+                out.columns = frame.descriptor.columns ?? [];
+                out.schemaFingerprint = frame.descriptor.schema_fingerprint;
+            }
+            else if ("cursor" in frame) {
+                out.cursor = frame.cursor.token;
+            }
+            else if ("row" in frame) {
+                if (out.rows.length >= maxRows) {
+                    out.truncated = true;
+                    break;
+                }
+                out.rows.push(frame.row);
+                out.rowCount = out.rows.length;
+            }
+            else if ("end" in frame || "cancelled" in frame) {
+                break;
+            }
+        }
+        if (out.truncated && out.cursor) {
+            await this.cancelQueryStream(out.cursor).catch(() => {
+                // best-effort: the cursor TTL reclaims it anyway.
+            });
+        }
+        return out;
+    }
+    /** Cancel a streaming-query cursor server-side (`POST /query/stream/cancel`). */
+    async cancelQueryStream(cursor) {
+        await this.json("/query/stream/cancel", {
+            method: "POST",
+            body: JSON.stringify({ cursor }),
+        }).catch(() => undefined);
+    }
+}
+/**
+ * Run a read SELECT preferring the bounded-memory NDJSON stream, falling back to
+ * the buffered `POST /query` for everything the stream can't take — a non-SELECT
+ * statement, a network error, or an older server with no `/query/stream` route.
+ * Honest streaming negotiation (#22): identical to {@link RedClient.query}
+ * unless the server supports streaming AND the statement is a SELECT.
+ */
+export async function runQueryPreferStream(client, sql, opts = {}) {
+    if (!SELECT_RE.test(sql))
+        return client.query(sql);
+    try {
+        const s = await client.queryStreamCollect(sql, opts);
+        return {
+            ok: true,
+            query: sql,
+            record_count: s.rowCount,
+            result: {
+                columns: s.columns,
+                records: s.rows.map((values) => ({ values })),
+            },
+            streamed: true,
+            truncated: s.truncated,
+        };
+    }
+    catch {
+        return client.query(sql);
+    }
+}
+//# sourceMappingURL=red-client.js.map

package/dist/red-client.js.map

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

package/dist/target-mode.d.ts

@@ -0,0 +1,10 @@
+export type TargetMode = "remote" | "local";
+/**
+ * Classify a connection target. An empty/absent target is `remote` (a cold
+ * open / Connect screen — there is nothing local to serve). `file://` and
+ * filesystem paths (including a bare `*.rdb`) are `local`; every other URL
+ * scheme — `http(s)://`, `red(s)://`, `grpc://` — and a bare `host:port` are
+ * `remote`. `red://` is remote on purpose: it is browser-reachable as an
+ * http(s) alias (ADR-0003), not a local file.
+ */
+export declare function classifyTarget(target: string | undefined | null): TargetMode;