@nifrajs/cli 0.1.0-alpha.1

package/dist/mcp-http.js

@@ -0,0 +1,136 @@
+/**
+ * The PUBLIC nifra docs MCP — Streamable-HTTP transport exposing the project-INDEPENDENT tools
+ * (`nifra_docs` + `nifra_example`) so any remote AI agent can learn nifra without a local checkout.
+ * Both tools read the bundled corpus (llms-full.txt / examples.json shipped in this package) and ignore
+ * `cwd`, so they reuse the exact definitions from {@link projectTools} — one source, no drift.
+ *
+ * {@link handleMcpHttp} is a plain Web `fetch` handler, so it self-hosts ANYWHERE Bun runs — the
+ * simplest path is `nifra docs-mcp` on a VPS behind a reverse proxy (Caddy/nginx + TLS), where the
+ * bundled corpus reads straight from disk (`Bun.file`). `export default { port, fetch }` also lets
+ * `bun run mcp-http.ts` serve it directly, and the same handler runs on Cloudflare/Vercel edge — only
+ * there must you inline the two corpus files as string imports (a Worker has no filesystem). The
+ * dispatch is the shared, transport-agnostic {@link handleRpc}.
+ */
+import { loadDocsCorpus } from "./docs-search.js";
+import { loadExamplesCorpus } from "./examples.js";
+import { docsTools } from "./mcp-docs-tools.js";
+import { handleRpc, rpcError } from "./mcp-protocol.js";
+// Re-exported so a self-host (e.g. a Cloudflare-Pages `/mcp` worker route) gets the corpus-injectable
+// tool factory + the transport core from one entry: `import { respondMcpHttp, docsTools } from "@nifrajs/cli/mcp"`.
+export { docsTools } from "./mcp-docs-tools.js";
+const VERSION = "0.1.0-alpha.1";
+const SERVER_INFO = { name: "nifra-docs", version: VERSION };
+const CORS = {
+    "access-control-allow-origin": "*",
+    "access-control-allow-methods": "POST, GET, OPTIONS",
+    "access-control-allow-headers": "content-type",
+};
+const DEFAULT_MAX_BODY_BYTES = 1_000_000;
+const TEXT_DECODER = new TextDecoder();
+function parseContentLength(value) {
+    if (value.length === 0)
+        return undefined;
+    let length = 0;
+    for (let i = 0; i < value.length; i++) {
+        const digit = value.charCodeAt(i) - 48;
+        if (digit < 0 || digit > 9)
+            return undefined;
+        length = length * 10 + digit;
+        if (length > Number.MAX_SAFE_INTEGER)
+            return Number.POSITIVE_INFINITY;
+    }
+    return length;
+}
+async function readJsonBounded(request, maxBytes) {
+    const declared = request.headers.get("content-length");
+    if (declared !== null) {
+        const length = parseContentLength(declared);
+        if (length === undefined)
+            return { ok: false, status: 400 };
+        if (length > maxBytes)
+            return { ok: false, status: 413 };
+    }
+    const body = request.body;
+    if (body === null)
+        return { ok: false, status: 400 };
+    const reader = body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > maxBytes) {
+            await reader.cancel();
+            return { ok: false, status: 413 };
+        }
+        chunks.push(value);
+    }
+    const bytes = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    try {
+        return { ok: true, value: JSON.parse(TEXT_DECODER.decode(bytes)) };
+    }
+    catch {
+        return { ok: false, status: 400 };
+    }
+}
+/** The two project-independent tools, reading the package's bundled corpus from disk (CLI use). */
+export function publicDocsTools() {
+    return docsTools(loadDocsCorpus, loadExamplesCorpus);
+}
+/**
+ * The transport core, shared by every HTTP host (CLI `docs-mcp`, the site's edge worker): handle one
+ * MCP request against the given `tools`. POST a JSON-RPC body → JSON-RPC response; GET is a health page;
+ * OPTIONS is the CORS preflight. Never throws — a bad body becomes a JSON-RPC parse error. Pass the
+ * tools so each host supplies its own corpus source (disk vs cached fetch) behind identical defs.
+ */
+export async function respondMcpHttp(request, tools, options = {}) {
+    if (request.method === "OPTIONS")
+        return new Response(null, { status: 204, headers: CORS });
+    if (request.method === "GET") {
+        return new Response("nifra docs MCP — POST JSON-RPC 2.0 here (methods: initialize, tools/list, tools/call). Tools: nifra_docs, nifra_example.", { headers: { "content-type": "text/plain; charset=utf-8", ...CORS } });
+    }
+    if (request.method !== "POST") {
+        return new Response("method not allowed", {
+            status: 405,
+            headers: { allow: "POST, GET", ...CORS },
+        });
+    }
+    const parsed = await readJsonBounded(request, options.maxBodyBytes ?? DEFAULT_MAX_BODY_BYTES);
+    if (!parsed.ok) {
+        if (parsed.status === 413) {
+            return Response.json(rpcError(null, -32000, "payload too large"), {
+                status: 413,
+                headers: CORS,
+            });
+        }
+        return Response.json(rpcError(null, -32700, "parse error"), { status: 400, headers: CORS });
+    }
+    const message = parsed.value;
+    const response = await handleRpc(message, tools, SERVER_INFO, {}, { signal: request.signal });
+    // A notification (no id) yields null — acknowledge with 204, no body.
+    if (response === null)
+        return new Response(null, { status: 204, headers: CORS });
+    return Response.json(response, { headers: CORS });
+}
+/** The CLI HTTP handler: serves the disk-backed corpus tools. (`nifra docs-mcp` / `bun run` this file.) */
+export function handleMcpHttp(request) {
+    return respondMcpHttp(request, publicDocsTools());
+}
+/**
+ * Worker/edge + local entry. `export default { fetch }` is the universal server shape: Cloudflare /
+ * Vercel edge / Deno deploy use `fetch` (and ignore `port`); `bun run mcp-http.ts` auto-serves it on
+ * `port` (PORT env, default 8787) — Bun serves a module's default-exported server, so NO manual
+ * `Bun.serve` here (that would double-bind the port).
+ */
+export default {
+    port: typeof Bun !== "undefined" ? Number(Bun.env.PORT ?? 8787) : 8787,
+    fetch: handleMcpHttp,
+};
+//# sourceMappingURL=mcp-http.js.map

package/dist/mcp-http.js.map

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

package/dist/mcp-protocol.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The pure MCP (Model Context Protocol) JSON-RPC dispatch — no I/O, no `Bun.*`, no side effects, so it
+ * unit-tests cleanly. {@link runMcpServer} in `./mcp.ts` wires this to stdin/stdout; the tools are
+ * injected, so the protocol logic is exercised without spawning or reading streams.
+ */
+export declare const PROTOCOL_VERSION = "2024-11-05";
+type RequestId = string | number;
+type JsonRpcId = RequestId | null;
+type ProgressToken = string | number;
+export interface McpToolContext {
+    readonly signal: AbortSignal;
+    readonly requestId: JsonRpcId;
+    readonly progressToken?: ProgressToken;
+    readonly reportProgress: (progress: number, total?: number) => void;
+}
+/** A tool the agent can call. `handler` returns the text shown to the agent. */
+export interface McpTool {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly handler: (args: Record<string, unknown>, context: McpToolContext) => Promise<string>;
+}
+export interface McpResource {
+    readonly uri: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly mimeType?: string;
+    readonly read: () => Promise<{
+        readonly text: string;
+        readonly mimeType?: string;
+    }>;
+}
+export interface McpPromptMessage {
+    readonly role: "user" | "assistant";
+    readonly content: {
+        readonly type: "text";
+        readonly text: string;
+    };
+}
+export interface McpPrompt {
+    readonly name: string;
+    readonly description: string;
+    readonly arguments?: readonly {
+        readonly name: string;
+        readonly description?: string;
+        readonly required?: boolean;
+    }[];
+    readonly handler: (args: Record<string, unknown>) => Promise<readonly McpPromptMessage[]>;
+}
+export interface McpServerFeatures {
+    readonly resources?: readonly McpResource[];
+    readonly prompts?: readonly McpPrompt[];
+}
+export interface JsonRpcRequest {
+    readonly jsonrpc?: string;
+    readonly id?: JsonRpcId;
+    readonly method?: string;
+    readonly params?: Record<string, unknown>;
+}
+export interface JsonRpcNotification {
+    readonly jsonrpc: "2.0";
+    readonly method: string;
+    readonly params?: Record<string, unknown>;
+}
+export type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result: unknown;
+} | {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    error: {
+        code: number;
+        message: string;
+    };
+};
+export declare const rpcResult: (id: JsonRpcId, value: unknown) => JsonRpcResponse;
+export declare const rpcError: (id: JsonRpcId, code: number, message: string) => JsonRpcResponse;
+export interface McpProtocolState {
+    readonly activeRequests: Map<string, AbortController>;
+}
+export interface McpProtocolOptions {
+    readonly state?: McpProtocolState;
+    readonly signal?: AbortSignal;
+    readonly sendNotification?: (notification: JsonRpcNotification) => void;
+}
+export declare function createMcpProtocolState(): McpProtocolState;
+/**
+ * Dispatch one JSON-RPC message against the given tools. Returns the response, or `null` for a
+ * notification (no reply). Tool errors are reported in-band (`isError`) so the agent can react to them.
+ */
+export declare function handleRpc(message: JsonRpcRequest, tools: readonly McpTool[], serverInfo: {
+    name: string;
+    version: string;
+}, features?: McpServerFeatures, options?: McpProtocolOptions): Promise<JsonRpcResponse | null>;
+export {};
+//# sourceMappingURL=mcp-protocol.d.ts.map

package/dist/mcp-protocol.d.ts.map

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

package/dist/mcp-protocol.js

@@ -0,0 +1,248 @@
+/**
+ * The pure MCP (Model Context Protocol) JSON-RPC dispatch — no I/O, no `Bun.*`, no side effects, so it
+ * unit-tests cleanly. {@link runMcpServer} in `./mcp.ts` wires this to stdin/stdout; the tools are
+ * injected, so the protocol logic is exercised without spawning or reading streams.
+ */
+export const PROTOCOL_VERSION = "2024-11-05";
+export const rpcResult = (id, value) => ({
+    jsonrpc: "2.0",
+    id,
+    result: value,
+});
+export const rpcError = (id, code, message) => ({
+    jsonrpc: "2.0",
+    id,
+    error: { code, message },
+});
+export function createMcpProtocolState() {
+    return { activeRequests: new Map() };
+}
+function requestKey(id) {
+    if (typeof id === "string")
+        return `s:${id}`;
+    return typeof id === "number" && Number.isFinite(id) ? `n:${id}` : undefined;
+}
+function progressTokenOf(params) {
+    const meta = params?._meta;
+    if (typeof meta !== "object" || meta === null || Array.isArray(meta))
+        return undefined;
+    const token = meta.progressToken;
+    return typeof token === "string" || (typeof token === "number" && Number.isFinite(token))
+        ? token
+        : undefined;
+}
+function cancellationReason(params) {
+    const reason = params?.reason;
+    return typeof reason === "string" && reason.length > 0 ? reason : undefined;
+}
+function linkAbortSignal(parent, child) {
+    if (parent === undefined)
+        return () => { };
+    if (parent.aborted) {
+        child.abort(parent.reason);
+        return () => { };
+    }
+    const abort = () => child.abort(parent.reason);
+    parent.addEventListener("abort", abort, { once: true });
+    return () => parent.removeEventListener("abort", abort);
+}
+function abortMessage(signal) {
+    const reason = signal.reason;
+    if (typeof reason === "string" && reason.length > 0)
+        return `Cancelled: ${reason}`;
+    return "Cancelled";
+}
+function compactDescription(description) {
+    const text = description.replace(/\s+/g, " ").trim();
+    const sentenceEnd = text.search(/[.!?](?:\s|$)/);
+    const sentence = sentenceEnd === -1 ? text : text.slice(0, sentenceEnd + 1);
+    if (sentence.length <= 120)
+        return sentence;
+    return `${sentence.slice(0, 117).trimEnd()}...`;
+}
+/**
+ * Dispatch one JSON-RPC message against the given tools. Returns the response, or `null` for a
+ * notification (no reply). Tool errors are reported in-band (`isError`) so the agent can react to them.
+ */
+export async function handleRpc(message, tools, serverInfo, features = {}, options = {}) {
+    const { id, method, params } = message;
+    const isNotification = id === undefined;
+    const rid = id ?? null;
+    const resources = features.resources ?? [];
+    const prompts = features.prompts ?? [];
+    const state = options.state ?? createMcpProtocolState();
+    switch (method) {
+        case "initialize":
+            return rpcResult(rid, {
+                protocolVersion: PROTOCOL_VERSION,
+                capabilities: {
+                    tools: {},
+                    ...(resources.length > 0 ? { resources: {} } : {}),
+                    ...(prompts.length > 0 ? { prompts: {} } : {}),
+                },
+                serverInfo,
+            });
+        case "notifications/initialized":
+            return null;
+        case "notifications/cancelled": {
+            const key = requestKey(params?.requestId);
+            if (key !== undefined)
+                state.activeRequests.get(key)?.abort(cancellationReason(params));
+            return null;
+        }
+        case "ping":
+            return rpcResult(rid, {});
+        case "tools/list":
+            return rpcResult(rid, params?.compact === true
+                ? {
+                    tools: tools.map((t) => ({
+                        name: t.name,
+                        description: compactDescription(t.description),
+                    })),
+                }
+                : {
+                    tools: tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        inputSchema: t.inputSchema,
+                    })),
+                });
+        case "tools/describe": {
+            const name = params?.name;
+            const tool = tools.find((t) => t.name === name);
+            if (!tool)
+                return rpcError(rid, -32602, `unknown tool: ${String(name)}`);
+            return rpcResult(rid, {
+                tool: {
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                },
+            });
+        }
+        case "tools/call": {
+            const name = params?.name;
+            const tool = tools.find((t) => t.name === name);
+            if (!tool)
+                return rpcError(rid, -32602, `unknown tool: ${String(name)}`);
+            const args = params?.arguments ?? {};
+            const controller = new AbortController();
+            const key = requestKey(id);
+            const cleanupAbort = linkAbortSignal(options.signal, controller);
+            if (key !== undefined)
+                state.activeRequests.set(key, controller);
+            const progressToken = progressTokenOf(params);
+            let lastProgress = Number.NEGATIVE_INFINITY;
+            const reportProgress = (progress, total) => {
+                if (progressToken === undefined ||
+                    !Number.isFinite(progress) ||
+                    progress <= lastProgress ||
+                    (total !== undefined && !Number.isFinite(total))) {
+                    return;
+                }
+                lastProgress = progress;
+                options.sendNotification?.({
+                    jsonrpc: "2.0",
+                    method: "notifications/progress",
+                    params: {
+                        progressToken,
+                        progress,
+                        ...(total !== undefined ? { total } : {}),
+                    },
+                });
+            };
+            try {
+                reportProgress(0, 1);
+                if (controller.signal.aborted)
+                    throw new DOMException("cancelled", "AbortError");
+                const text = await tool.handler(args, {
+                    signal: controller.signal,
+                    requestId: rid,
+                    ...(progressToken !== undefined ? { progressToken } : {}),
+                    reportProgress,
+                });
+                if (controller.signal.aborted)
+                    throw new DOMException("cancelled", "AbortError");
+                reportProgress(1, 1);
+                return rpcResult(rid, { content: [{ type: "text", text }] });
+            }
+            catch (err) {
+                if (controller.signal.aborted) {
+                    return rpcResult(rid, {
+                        content: [{ type: "text", text: abortMessage(controller.signal) }],
+                        isError: true,
+                    });
+                }
+                const msg = err instanceof Error ? err.message : String(err);
+                return rpcResult(rid, { content: [{ type: "text", text: `Error: ${msg}` }], isError: true });
+            }
+            finally {
+                cleanupAbort();
+                if (key !== undefined && state.activeRequests.get(key) === controller) {
+                    state.activeRequests.delete(key);
+                }
+            }
+        }
+        case "resources/list":
+            return rpcResult(rid, {
+                resources: resources.map((r) => ({
+                    uri: r.uri,
+                    name: r.name,
+                    ...(r.description !== undefined ? { description: r.description } : {}),
+                    ...(r.mimeType !== undefined ? { mimeType: r.mimeType } : {}),
+                })),
+            });
+        case "resources/read": {
+            const uri = params?.uri;
+            const resource = resources.find((r) => r.uri === uri);
+            if (!resource)
+                return rpcError(rid, -32602, `unknown resource: ${String(uri)}`);
+            try {
+                const content = await resource.read();
+                return rpcResult(rid, {
+                    contents: [
+                        {
+                            uri: resource.uri,
+                            mimeType: content.mimeType ?? resource.mimeType ?? "text/plain",
+                            text: content.text,
+                        },
+                    ],
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return rpcError(rid, -32000, msg);
+            }
+        }
+        case "prompts/list":
+            return rpcResult(rid, {
+                prompts: prompts.map((p) => ({
+                    name: p.name,
+                    description: p.description,
+                    ...(p.arguments !== undefined ? { arguments: p.arguments } : {}),
+                })),
+            });
+        case "prompts/get": {
+            const name = params?.name;
+            const prompt = prompts.find((p) => p.name === name);
+            if (!prompt)
+                return rpcError(rid, -32602, `unknown prompt: ${String(name)}`);
+            const args = params?.arguments ?? {};
+            try {
+                return rpcResult(rid, {
+                    description: prompt.description,
+                    messages: await prompt.handler(args),
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return rpcError(rid, -32000, msg);
+            }
+        }
+        default:
+            if (isNotification)
+                return null;
+            return rpcError(rid, -32601, `method not found: ${String(method)}`);
+    }
+}
+//# sourceMappingURL=mcp-protocol.js.map

package/dist/mcp-protocol.js.map

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

package/dist/mcp-render.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The `nifra_render` engine + its child-process entry — the page half of `nifra_run`. Where `nifra_run`
+ * runs requests through the BACKEND, this SSRs page routes through the WEB app (`createWebApp`), so an
+ * agent can verify a page renders and its loader ran after an edit. Spawned fresh per call (`bun
+ * mcp-render.ts <cwd>`) so the project's CURRENT route/loader code is loaded.
+ *
+ * No build required: a placeholder `clientEntry` is injected (the SSR HTML renders regardless — the
+ * client bundle only matters for hydration in the browser, not for "did this page render server-side").
+ * {@link renderPages} never throws — every failure (no config, a loader error, a render throw) becomes
+ * `{ error }` so the agent gets the actionable message.
+ */
+export declare function renderPages(cwd: string, requests: unknown): Promise<{
+    results: unknown;
+} | {
+    error: string;
+}>;
+//# sourceMappingURL=mcp-render.d.ts.map

package/dist/mcp-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-render.d.ts","sourceRoot":"","sources":["../src/mcp-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuCnD"}

package/dist/mcp-render.js

@@ -0,0 +1,73 @@
+/**
+ * The `nifra_render` engine + its child-process entry — the page half of `nifra_run`. Where `nifra_run`
+ * runs requests through the BACKEND, this SSRs page routes through the WEB app (`createWebApp`), so an
+ * agent can verify a page renders and its loader ran after an edit. Spawned fresh per call (`bun
+ * mcp-render.ts <cwd>`) so the project's CURRENT route/loader code is loaded.
+ *
+ * No build required: a placeholder `clientEntry` is injected (the SSR HTML renders regardless — the
+ * client bundle only matters for hydration in the browser, not for "did this page render server-side").
+ * {@link renderPages} never throws — every failure (no config, a loader error, a render throw) becomes
+ * `{ error }` so the agent gets the actionable message.
+ */
+import { inProcessClient } from "@nifrajs/client";
+import { runApp } from "@nifrajs/runner";
+import { createWebApp } from "@nifrajs/web";
+import { discoverRoutes } from "@nifrajs/web/fs";
+import { loadApp, resolvePlugins } from "./load.js";
+const errString = (err) => err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+export async function renderPages(cwd, requests) {
+    if (!Array.isArray(requests))
+        return { error: "expected { requests: [...] }" };
+    let app;
+    try {
+        app = await loadApp(cwd, "dist");
+    }
+    catch (err) {
+        return { error: errString(err) };
+    }
+    // Register the framework's SSR Bun plugins so `.vue`/`.svelte`/Solid route files compile on import
+    // (React/Preact JSX is Bun-native → none). Mirrors `nifra start`.
+    try {
+        const { plugin } = await import("bun");
+        for (const p of await resolvePlugins(app.framework.serverPlugins)) {
+            plugin(p);
+        }
+    }
+    catch (err) {
+        return { error: errString(err) };
+    }
+    let webApp;
+    try {
+        webApp = createWebApp({
+            // The adapter is validated by loadApp; cast at the seam (same as the CLI's `asAdapter`).
+            adapter: app.framework.adapter,
+            manifest: discoverRoutes(app.routesDir),
+            clientEntry: "/_nifra-render-only.js", // placeholder; SSR HTML does not need the built client
+            ...(app.backend !== undefined ? { api: inProcessClient(app.backend) } : {}),
+        });
+    }
+    catch (err) {
+        return { error: errString(err) };
+    }
+    try {
+        return { results: await runApp(webApp, requests) };
+    }
+    catch (err) {
+        return { error: errString(err) };
+    }
+}
+// Child-process entry: read `{ requests }` from stdin, SSR, print JSON. Guarded so importing this
+// module in a test does not execute it.
+if (import.meta.main) {
+    const cwd = process.argv[2] ?? process.cwd();
+    let output;
+    try {
+        const { requests } = JSON.parse(await Bun.stdin.text());
+        output = await renderPages(cwd, requests);
+    }
+    catch {
+        output = { error: "invalid input: expected JSON { requests: [...] }" };
+    }
+    process.stdout.write(JSON.stringify(output, null, 2));
+}
+//# sourceMappingURL=mcp-render.js.map

package/dist/mcp-render.js.map

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

package/dist/mcp-run.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `nifra_run` engine + its child-process entry. The MCP server spawns this file fresh on every
+ * `nifra_run` call (`bun mcp-run.ts <cwd>`) so the project's CURRENT backend code is loaded — picking
+ * up the agent's latest edits. {@link runBackend} is the pure-ish core (resolve entry → import → run),
+ * exported so it's unit-testable in-process; the entry below wires it to stdin/stdout.
+ */
+import { type AppLike } from "@nifrajs/runner";
+export declare function loadBackend(cwd: string, entry?: string): Promise<{
+    app: AppLike;
+} | {
+    error: string;
+}>;
+/**
+ * Resolve the backend entry under `cwd`, import it, and run `requests` through its exported app. Never
+ * throws — every failure (missing/invalid entry, import/compile/runtime error) becomes `{ error }`, so
+ * the caller (and the agent) always gets actionable output. An import error here IS the failure the
+ * agent needs to see and fix.
+ */
+export declare function runBackend(cwd: string, requests: unknown, entry?: string): Promise<{
+    results: unknown;
+} | {
+    error: string;
+}>;
+//# sourceMappingURL=mcp-run.d.ts.map

package/dist/mcp-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-run.d.ts","sourceRoot":"","sources":["../src/mcp-run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,iBAAiB,CAAA;AAOtD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB/C;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWnD"}