@reddb-io/ui-mcp 0.1.1

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 reddb-io
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/connection.d.ts

@@ -0,0 +1,20 @@
+import { type TargetMode } from "./target-mode.js";
+export interface ResolvedConnection {
+    /** http(s) base URL the RedClient fetches. Non-secret (ADR-0005). */
+    baseUrl: string;
+    /** Auth headers for the client. Never logged, never returned to the model. */
+    headers?: Record<string, string>;
+    mode: TargetMode;
+}
+export interface ResolveConnectionOptions {
+    /** Default target when the tool call omits `connectionUrl`. */
+    defaultUrl?: string;
+    /** Auth header value applied to remote requests (never logged/returned). */
+    authHeader?: string;
+}
+/**
+ * Resolve a tool-supplied (or configured) target into a reachable endpoint.
+ * Throws for a local-file target (#48 unimplemented) and for an absent target
+ * with no configured default — the data tools need a concrete server to read.
+ */
+export declare function resolveConnection(target: string | undefined, opts?: ResolveConnectionOptions): ResolvedConnection;

package/dist/connection.js

@@ -0,0 +1,61 @@
+// Connection resolution for the MCP data tools (#49, ADR-0006).
+//
+// A data tool receives an optional `connectionUrl`; combined with the configured
+// default it resolves to a concrete reddb endpoint the server-side RedClient can
+// reach. Two modes (ADR-0006, mirrors `open_red_ui`):
+//   - REMOTE: an http(s):// or red(s):// URL. red:// is an http(s) alias
+//     (ADR-0003); we normalise it to http(s) so `fetch` can reach it.
+//   - LOCAL: a filesystem path / file:// / *.rdb. Per ADR-0006 the MCP must spawn
+//     a local `red server` in front of the file and talk to it over
+//     http://localhost — but that spawn is issue #48 and not implemented yet, so
+//     resolving a local target throws a clear "not yet" error. This is the seam
+//     #48 plugs into: it will return the spawned server's baseUrl here.
+//
+// The resolved auth header (if any) is carried in `headers` and never surfaces in
+// tool output or logs — secrets never ride the URL (ADR-0005).
+import { classifyTarget } from "./target-mode.js";
+/** Translate a `red(s)://` alias to its http(s) equivalent; pass other schemes
+ *  through. red:// → http://, reds:// → https:// (ADR-0003). */
+function normalizeRemoteUrl(target) {
+    const t = target.trim();
+    const lower = t.toLowerCase();
+    let url;
+    if (lower.startsWith("red://")) {
+        url = new URL("http://" + t.slice("red://".length));
+    }
+    else if (lower.startsWith("reds://")) {
+        url = new URL("https://" + t.slice("reds://".length));
+    }
+    else if (/^https?:\/\//i.test(t)) {
+        url = new URL(t);
+    }
+    else {
+        // Bare host:port / hostname — default to http (matches the UI's normalizer).
+        url = new URL("http://" + t);
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`Unsupported connection scheme: ${target}`);
+    }
+    url.hash = "";
+    return url.toString().replace(/\/$/, "");
+}
+/**
+ * Resolve a tool-supplied (or configured) target into a reachable endpoint.
+ * Throws for a local-file target (#48 unimplemented) and for an absent target
+ * with no configured default — the data tools need a concrete server to read.
+ */
+export function resolveConnection(target, opts = {}) {
+    const raw = (target ?? "").trim() || (opts.defaultUrl ?? "").trim();
+    if (!raw) {
+        throw new Error("No reddb connection: pass a connectionUrl (http(s):// or red://), or set RED_UI_CONNECTION_URL on the MCP server.");
+    }
+    const mode = classifyTarget(raw);
+    if (mode === "local") {
+        throw new Error(`Cannot run data tools against the local file "${raw}" yet: local-file mode (a local red server in front of the file, ADR-0006 / #48) is not implemented. Point at an http(s):// or red:// server.`);
+    }
+    const headers = opts.authHeader
+        ? { Authorization: opts.authHeader }
+        : undefined;
+    return { baseUrl: normalizeRemoteUrl(raw), headers, mode };
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,sDAAsD;AACtD,yEAAyE;AACzE,sEAAsE;AACtE,kFAAkF;AAClF,oEAAoE;AACpE,iFAAiF;AACjF,gFAAgF;AAChF,wEAAwE;AACxE,EAAE;AACF,kFAAkF;AAClF,+DAA+D;AAE/D,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAUnE;gEACgE;AAChE,SAAS,kBAAkB,CAAC,MAAc;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,GAAQ,CAAC;IACb,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,6EAA6E;QAC7E,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA0B,EAC1B,OAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,mHAAmH,CACpH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,iDAAiD,GAAG,+IAA+I,CACpM,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU;QAC7B,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE;QACpC,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7D,CAAC"}

package/dist/data-tools.d.ts

@@ -0,0 +1,51 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ReadClient } from "./red-client.js";
+import { type ResolveConnectionOptions } from "./connection.js";
+/** MCP tool result shape we build (subset of the SDK's CallToolResult). The
+ *  index signature keeps it assignable to the SDK's `CallToolResult`. */
+interface ToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: Record<string, unknown>;
+    isError?: boolean;
+    [k: string]: unknown;
+}
+/** Strip leading line/block comments + whitespace, then return the first token
+ *  lower-cased. Used to gate the `query` tool to read-shaped statements. */
+export declare function leadingVerb(sql: string): string;
+export declare function isReadOnlyQuery(sql: string): boolean;
+export declare function runQueryTool(client: ReadClient, args: {
+    query: string;
+    maxRows?: number;
+}, conn: {
+    baseUrl: string;
+    mode: string;
+}): Promise<ToolResult>;
+export declare function runListTool(client: ReadClient, args: {
+    collection?: string;
+    maxRows?: number;
+}, conn: {
+    baseUrl: string;
+    mode: string;
+}): Promise<ToolResult>;
+export declare function runGetTool(client: ReadClient, args: {
+    collection: string;
+    id: string | number;
+    idColumn?: string;
+}, conn: {
+    baseUrl: string;
+    mode: string;
+}): Promise<ToolResult>;
+export interface DataToolsConfig extends ResolveConnectionOptions {
+    /** Build a client for a resolved endpoint. Overridable in tests. */
+    createClient?: (baseUrl: string, headers?: Record<string, string>) => ReadClient;
+}
+/**
+ * Register the model-facing `query` / `list` / `get` data tools. They resolve a
+ * connection per call (tool arg `connectionUrl`, else the configured default),
+ * build a server-side RedClient, and return results as `structuredContent`.
+ */
+export declare function registerDataTools(server: McpServer, config?: DataToolsConfig): void;
+export {};

package/dist/data-tools.js

@@ -0,0 +1,285 @@
+// Server-side data tools for the MCP App (#49, ADR-0006).
+//
+// `query` / `list` / `get` run a server-side RedClient against the resolved
+// connection and return reddb results to the *model* as `structuredContent` —
+// the model reads data directly without driving the visual iframe. Read-shaped
+// only: `query` rejects any statement that is not a read (default-deny), and
+// `list`/`get` build SELECTs. No secret/token is logged or returned.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod/v4";
+import { RedClient, runQueryPreferStream, } from "./red-client.js";
+import { resolveConnection, } from "./connection.js";
+/** Leading verbs we accept as read-shaped. Everything else is denied — a
+ *  default-deny allowlist keeps write/DDL statements out of read tools even as
+ *  reddb's query surface grows. */
+const READ_VERBS = new Set([
+    "select",
+    "with",
+    "show",
+    "explain",
+    "describe",
+    "desc",
+    "match", // graph traversal read
+]);
+/** Strip leading line/block comments + whitespace, then return the first token
+ *  lower-cased. Used to gate the `query` tool to read-shaped statements. */
+export function leadingVerb(sql) {
+    let s = sql.trim();
+    // Drop leading -- line comments and /* */ block comments.
+    for (;;) {
+        if (s.startsWith("--")) {
+            const nl = s.indexOf("\n");
+            s = nl === -1 ? "" : s.slice(nl + 1).trim();
+        }
+        else if (s.startsWith("/*")) {
+            const end = s.indexOf("*/");
+            s = end === -1 ? "" : s.slice(end + 2).trim();
+        }
+        else {
+            break;
+        }
+    }
+    const m = /^[a-z]+/i.exec(s);
+    return m ? m[0].toLowerCase() : "";
+}
+export function isReadOnlyQuery(sql) {
+    return READ_VERBS.has(leadingVerb(sql));
+}
+const IDENT_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Reject anything that is not a bare SQL identifier (collection / column). */
+function assertIdentifier(value, label) {
+    if (!IDENT_RE.test(value)) {
+        throw new Error(`Invalid ${label} "${value}": expected a bare identifier (letters, digits, underscore).`);
+    }
+    return value;
+}
+/** Render an id literal for a WHERE clause: numbers inline, strings single-quoted
+ *  with embedded quotes doubled. */
+function idLiteral(id) {
+    if (typeof id === "number") {
+        if (!Number.isFinite(id))
+            throw new Error(`Invalid numeric id: ${id}`);
+        return String(id);
+    }
+    return `'${id.replaceAll("'", "''")}'`;
+}
+function ok(text, structured) {
+    return { content: [{ type: "text", text }], structuredContent: structured };
+}
+function fail(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        structuredContent: { ok: false, error: message },
+        isError: true,
+    };
+}
+function shapeQueryResult(r, baseUrl, mode) {
+    const records = r.result?.records?.map((rec) => rec.values) ?? [];
+    return {
+        ok: r.ok !== false,
+        query: r.query,
+        columns: r.result?.columns ?? [],
+        records,
+        recordCount: r.record_count ?? records.length,
+        streamed: r.streamed ?? false,
+        truncated: r.truncated ?? false,
+        baseUrl,
+        mode,
+    };
+}
+// ---- Pure handlers (injectable client) — the unit-testable core. ----------
+export async function runQueryTool(client, args, conn) {
+    if (!isReadOnlyQuery(args.query)) {
+        return fail(`Refused: "${leadingVerb(args.query) || "(empty)"}" is not a read statement. The query tool runs read-shaped statements only (SELECT/WITH/SHOW/EXPLAIN/DESCRIBE/MATCH).`);
+    }
+    try {
+        const r = await runQueryPreferStream(client, args.query, {
+            maxRows: args.maxRows,
+        });
+        const structured = shapeQueryResult(r, conn.baseUrl, conn.mode);
+        return ok(`${structured.recordCount} row(s) from ${conn.baseUrl}${structured.truncated ? " (truncated)" : ""}.`, structured);
+    }
+    catch (e) {
+        return fail(e instanceof Error ? e.message : String(e));
+    }
+}
+export async function runListTool(client, args, conn) {
+    try {
+        // No collection → list collection names. With one → list its rows (a read).
+        if (!args.collection) {
+            const collections = await client.collections();
+            return ok(`${collections.length} collection(s) on ${conn.baseUrl}.`, {
+                ok: true,
+                collections,
+                count: collections.length,
+                baseUrl: conn.baseUrl,
+                mode: conn.mode,
+            });
+        }
+        const name = assertIdentifier(args.collection, "collection");
+        const limit = args.maxRows ?? 100;
+        const r = await runQueryPreferStream(client, `SELECT * FROM ${name} LIMIT ${limit}`, { maxRows: limit });
+        const structured = shapeQueryResult(r, conn.baseUrl, conn.mode);
+        structured.collection = name;
+        return ok(`${structured.recordCount} row(s) from ${name} on ${conn.baseUrl}${structured.truncated ? " (truncated)" : ""}.`, structured);
+    }
+    catch (e) {
+        return fail(e instanceof Error ? e.message : String(e));
+    }
+}
+export async function runGetTool(client, args, conn) {
+    try {
+        const name = assertIdentifier(args.collection, "collection");
+        const idColumn = assertIdentifier(args.idColumn ?? "id", "idColumn");
+        const sql = `SELECT * FROM ${name} WHERE ${idColumn} = ${idLiteral(args.id)} LIMIT 1`;
+        const r = await runQueryPreferStream(client, sql, { maxRows: 1 });
+        const records = r.result?.records?.map((rec) => rec.values) ?? [];
+        const record = records[0] ?? null;
+        return ok(record
+            ? `Found ${name}/${args.id} on ${conn.baseUrl}.`
+            : `No ${name} where ${idColumn} = ${args.id} on ${conn.baseUrl}.`, {
+            ok: true,
+            found: record !== null,
+            collection: name,
+            id: args.id,
+            record,
+            baseUrl: conn.baseUrl,
+            mode: conn.mode,
+        });
+    }
+    catch (e) {
+        return fail(e instanceof Error ? e.message : String(e));
+    }
+}
+const MODEL_ONLY_META = { ui: { visibility: ["model"] } };
+/**
+ * Register the model-facing `query` / `list` / `get` data tools. They resolve a
+ * connection per call (tool arg `connectionUrl`, else the configured default),
+ * build a server-side RedClient, and return results as `structuredContent`.
+ */
+export function registerDataTools(server, config = {}) {
+    const createClient = config.createClient ??
+        ((baseUrl, headers) => new RedClient(baseUrl, { headers }));
+    const resolveOpts = {
+        defaultUrl: config.defaultUrl,
+        authHeader: config.authHeader,
+    };
+    function resolve(connectionUrl) {
+        const conn = resolveConnection(connectionUrl, resolveOpts);
+        return { conn, client: createClient(conn.baseUrl, conn.headers) };
+    }
+    const connectionUrlSchema = z
+        .string()
+        .optional()
+        .describe("reddb endpoint to read from (http(s):// or red://). Defaults to the MCP server's configured connection. Local file paths are not yet supported (#48).");
+    server.registerTool("query", {
+        title: "Query reddb",
+        description: "Run a read-only reddb query (SELECT/WITH/SHOW/EXPLAIN/DESCRIBE/MATCH) and return rows as structured data. Write/DDL statements are refused.",
+        inputSchema: {
+            query: z.string().describe("A read-only reddb SQL/graph statement."),
+            connectionUrl: connectionUrlSchema,
+            maxRows: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Maximum rows to collect (default 10000)."),
+        },
+        outputSchema: {
+            ok: z.boolean(),
+            error: z.string().optional(),
+            query: z.string().optional(),
+            columns: z.array(z.string()).optional(),
+            records: z.array(z.record(z.string(), z.unknown())).optional(),
+            recordCount: z.number().optional(),
+            streamed: z.boolean().optional(),
+            truncated: z.boolean().optional(),
+            baseUrl: z.string().optional(),
+            mode: z.string().optional(),
+        },
+        _meta: MODEL_ONLY_META,
+    }, async ({ query, connectionUrl, maxRows }) => {
+        let resolved;
+        try {
+            resolved = resolve(connectionUrl);
+        }
+        catch (e) {
+            return fail(e instanceof Error ? e.message : String(e));
+        }
+        return runQueryTool(resolved.client, { query, maxRows }, resolved.conn);
+    });
+    server.registerTool("list", {
+        title: "List reddb collections or rows",
+        description: "List collection names, or — when a collection is given — the first rows of that collection. Read-only.",
+        inputSchema: {
+            collection: z
+                .string()
+                .optional()
+                .describe("Collection to list rows from. Omit to list collections."),
+            connectionUrl: connectionUrlSchema,
+            maxRows: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Maximum rows when listing a collection (default 100)."),
+        },
+        outputSchema: {
+            ok: z.boolean(),
+            error: z.string().optional(),
+            collections: z.array(z.string()).optional(),
+            count: z.number().optional(),
+            collection: z.string().optional(),
+            columns: z.array(z.string()).optional(),
+            records: z.array(z.record(z.string(), z.unknown())).optional(),
+            recordCount: z.number().optional(),
+            truncated: z.boolean().optional(),
+            baseUrl: z.string().optional(),
+            mode: z.string().optional(),
+        },
+        _meta: MODEL_ONLY_META,
+    }, async ({ collection, connectionUrl, maxRows }) => {
+        let resolved;
+        try {
+            resolved = resolve(connectionUrl);
+        }
+        catch (e) {
+            return fail(e instanceof Error ? e.message : String(e));
+        }
+        return runListTool(resolved.client, { collection, maxRows }, resolved.conn);
+    });
+    server.registerTool("get", {
+        title: "Get a reddb record",
+        description: "Fetch a single record from a collection by id. Read-only; returns the record or null.",
+        inputSchema: {
+            collection: z.string().describe("Collection name."),
+            id: z.union([z.string(), z.number()]).describe("Record id to look up."),
+            idColumn: z
+                .string()
+                .optional()
+                .describe("Column to match the id against (default 'id')."),
+            connectionUrl: connectionUrlSchema,
+        },
+        outputSchema: {
+            ok: z.boolean(),
+            error: z.string().optional(),
+            found: z.boolean().optional(),
+            collection: z.string().optional(),
+            id: z.union([z.string(), z.number()]).optional(),
+            record: z.record(z.string(), z.unknown()).nullable().optional(),
+            baseUrl: z.string().optional(),
+            mode: z.string().optional(),
+        },
+        _meta: MODEL_ONLY_META,
+    }, async ({ collection, id, idColumn, connectionUrl }) => {
+        let resolved;
+        try {
+            resolved = resolve(connectionUrl);
+        }
+        catch (e) {
+            return fail(e instanceof Error ? e.message : String(e));
+        }
+        return runGetTool(resolved.client, { collection, id, idColumn }, resolved.conn);
+    });
+}
+//# sourceMappingURL=data-tools.js.map

package/dist/data-tools.js.map

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

package/dist/embed-server.d.ts

@@ -0,0 +1,40 @@
+import type { Server } from "node:http";
+export interface EmbedServerHandle {
+    baseUrl: string;
+    port: number;
+    /** Absolute path of the served embed bundle directory. */
+    embedDir: string;
+    server: Server;
+    /** Idempotent teardown; resolves once the HTTP server has closed. */
+    stop(): Promise<void>;
+}
+export interface StartEmbedServerOptions {
+    /** Override the embed bundle directory (tests, explicit config). */
+    embedDir?: string;
+    /** Override the ephemeral port (tests). */
+    port?: number;
+}
+/**
+ * Locate the built Embeddable Lib bundle directory (`@reddb-io/ui/dist/embed`),
+ * the one containing `index.js`. Resolution order: explicit `RED_UI_EMBED_DIR`
+ * → the published `@reddb-io/ui/embed` export → the monorepo sibling
+ * (`packages/ui/dist/embed`) → the published dependency layout (the MCP lives in
+ * `<ui>/node_modules/@reddb-io/ui-mcp`). Throws an actionable error when none of
+ * these holds the bundle.
+ */
+export declare function resolveEmbedDir(override?: string): string;
+/**
+ * The host page. It imports the embed bundle from the same origin, builds a
+ * single-connection InjectedClientProvider from the `?cs=` endpoint the MCP
+ * seeded (the spawned `red server`), and mounts red-ui into a full-document
+ * host element. `?to=` selects the initial route. No secret rides the URL
+ * (ADR-0005); the local server is loopback-only and unauthenticated.
+ */
+export declare function renderHostHtml(): string;
+/**
+ * Start one loopback HTTP server that serves the host page at `/` and the embed
+ * bundle under `/embed/`. The returned handle's `stop()` closes it.
+ */
+export declare function startEmbedServer(options?: StartEmbedServerOptions): Promise<EmbedServerHandle>;
+/** Stop every tracked embed server (MCP transport close / shutdown). */
+export declare function stopAllEmbedServers(): Promise<void>;