frely-cli 0.9.5 → 0.9.7

package/dist/runtime/local-mcp.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Device-local MCP servers (plan mcp/本机MCP转发-方案.md §9).
+ *
+ * The Relay never learns how a local server is reached: it only knows the
+ * names the owner enabled on the web console. Everything here stays on the
+ * device: discovery of loopback HTTP servers, the manual list (HTTP or stdio),
+ * the MCP clients, and the policy that only enabled names are callable.
+ */
+export declare const LOCAL_MCP_NAME: RegExp;
+export declare const LOCAL_MCP_CAPABILITY_LIMIT = 24;
+export declare const LOCAL_MCP_DEFAULT_TIMEOUT_MS = 60000;
+export declare const LOCAL_MCP_MAX_TIMEOUT_MS = 120000;
+export declare const LOCAL_MCP_TEXT_LIMIT: number;
+export declare const LOCAL_MCP_BINARY_LIMIT: number;
+export type HttpFlavor = "streamable" | "sse";
+export interface LocalMcpHttpEntry {
+    name: string;
+    source: "discovered" | "manual";
+    transport: "http";
+    url: string;
+    flavor?: HttpFlavor;
+    headers?: Record<string, string>;
+}
+export interface LocalMcpStdioEntry {
+    name: string;
+    source: "manual";
+    transport: "stdio";
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    /** PATH captured when the entry was added, so a background service finds the same binaries. */
+    path?: string;
+}
+export type LocalMcpEntry = LocalMcpHttpEntry | LocalMcpStdioEntry;
+export type ManualLocalMcpEntry = Omit<LocalMcpHttpEntry, "source"> | Omit<LocalMcpStdioEntry, "source">;
+export interface LocalMcpToolResult {
+    content: unknown[];
+    isError?: boolean;
+}
+export declare function localMcpRegistryPath(): string;
+export declare function loadManualEntries(path?: string): Promise<LocalMcpEntry[]>;
+export declare function addManualEntry(entry: ManualLocalMcpEntry, path?: string): Promise<void>;
+export declare function removeManualEntry(name: string, path?: string): Promise<void>;
+/** Only loopback HTTP(S) targets are ever contacted (plan F5). */
+export declare function assertLoopbackUrl(value: string): URL;
+export declare function parseLoopbackListeners(platform: NodeJS.Platform, outputs: readonly string[]): number[];
+/** TCP ports that only accept loopback connections, found without extra dependencies. */
+export declare function listLoopbackPorts(platform?: NodeJS.Platform): Promise<number[]>;
+export interface ProbeHit {
+    url: string;
+    flavor: HttpFlavor;
+    serverName?: string;
+}
+/** One standard `initialize` (or SSE handshake) per port; nothing is sent beyond that and redirects are never followed. */
+export declare function probeHttpMcp(port: number, timeoutMs?: number): Promise<ProbeHit | null>;
+export interface DiscoveryDeps {
+    listPorts?: () => Promise<number[]>;
+    probe?: (port: number) => Promise<ProbeHit | null>;
+}
+export declare function discoverLoopbackMcps(deps?: DiscoveryDeps, skipPorts?: ReadonlySet<number>): Promise<Array<ProbeHit & {
+    port: number;
+}>>;
+export declare function slugName(value: string | undefined): string;
+/** Stable names: manual entries keep theirs, discovered ones use the server's own name and get a numeric suffix on clashes. */
+export declare function nameDiscovered(hits: Array<ProbeHit & {
+    port: number;
+}>, taken: Iterable<string>): LocalMcpHttpEntry[];
+export interface LocalMcpHubOptions {
+    discovery?: DiscoveryDeps;
+    loadManual?: () => Promise<LocalMcpEntry[]>;
+    idleMs?: number;
+    refreshMs?: number;
+    log?: (message: string) => void;
+}
+export declare class LocalMcpHub {
+    private readonly options;
+    private entries;
+    private refreshedAt;
+    private refreshing;
+    private timer;
+    private readonly pool;
+    private readonly connecting;
+    constructor(options?: LocalMcpHubOptions);
+    /** Begin periodic discovery and idle cleanup; both timers are unref'd. */
+    start(): void;
+    close(): Promise<void>;
+    refresh(): Promise<void>;
+    private scan;
+    ensureFresh(maxAgeMs?: number): Promise<void>;
+    snapshot(): readonly LocalMcpEntry[];
+    /** Names and transports for the web console; commands, URLs and secrets never leave the device. */
+    capabilities(): Array<{
+        name: string;
+        transport: "http" | "stdio";
+    }>;
+    /** `local_mcp_list`: enabled servers, or one enabled server's tool definitions. */
+    list(enabled: readonly string[], server?: string, signal?: AbortSignal): Promise<unknown>;
+    /** `local_mcp_call`: forwards one tools/call to an enabled server and bounds the result. */
+    call(enabled: readonly string[], server: string, tool: string, args: Record<string, unknown>, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<LocalMcpToolResult>;
+    private requireEnabled;
+    private client;
+    private connect;
+    private closeIdle;
+}
+/** Resolve a bare command against PATH so a background service with a different PATH still finds it. */
+export declare function resolveCommand(command: string, pathValue?: string): Promise<string>;
+/** Bounds what one local MCP call can put on the relay: 1 MiB of text, 6 MiB of binary content. */
+export declare function shapeToolResult(result: {
+    content?: unknown;
+    isError?: unknown;
+}): LocalMcpToolResult;

package/dist/runtime/local-mcp.js

@@ -0,0 +1,448 @@
+import { execFile } from "node:child_process";
+import { access, constants, readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { delimiter, dirname, isAbsolute, join } from "node:path";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { ensureCredentialDirectory, readPrivateFile, writePrivateFile } from "../credential-file.js";
+import { VERSION } from "../version.js";
+import { safeEnv } from "./workspace.js";
+/**
+ * Device-local MCP servers (plan mcp/本机MCP转发-方案.md §9).
+ *
+ * The Relay never learns how a local server is reached: it only knows the
+ * names the owner enabled on the web console. Everything here stays on the
+ * device: discovery of loopback HTTP servers, the manual list (HTTP or stdio),
+ * the MCP clients, and the policy that only enabled names are callable.
+ */
+export const LOCAL_MCP_NAME = /^[a-z0-9][a-z0-9-]{0,31}$/u;
+export const LOCAL_MCP_CAPABILITY_LIMIT = 24;
+export const LOCAL_MCP_DEFAULT_TIMEOUT_MS = 60_000;
+export const LOCAL_MCP_MAX_TIMEOUT_MS = 120_000;
+export const LOCAL_MCP_TEXT_LIMIT = 1024 * 1024;
+export const LOCAL_MCP_BINARY_LIMIT = 6 * 1024 * 1024;
+const PROBE_TIMEOUT_MS = 1_000;
+const CONNECT_TIMEOUT_MS = 10_000;
+const MAX_PROBED_PORTS = 64;
+const PROBE_CONCURRENCY = 8;
+const MAX_LIST_PAGES = 5;
+const HTTP_PATHS = [{ path: "/mcp", flavor: "streamable" }, { path: "/sse", flavor: "sse" }];
+// ---------------------------------------------------------------- manual list
+export function localMcpRegistryPath() {
+    return join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "frely", "mcp-v1", "local-mcps.json");
+}
+export async function loadManualEntries(path = localMcpRegistryPath()) {
+    const raw = await readPrivateFile(path);
+    if (!raw)
+        return [];
+    const value = JSON.parse(raw);
+    if (value.version !== 1 || !Array.isArray(value.servers))
+        throw new Error("Local MCP list is corrupted.");
+    return value.servers.map((item) => normalizeManual(item));
+}
+export async function addManualEntry(entry, path = localMcpRegistryPath()) {
+    const next = normalizeManual(entry);
+    const current = await loadManualEntries(path);
+    if (current.some((item) => item.name === next.name))
+        throw new Error(`A local MCP named ${next.name} already exists. Remove it first.`);
+    await writeManual([...current, next], path);
+}
+export async function removeManualEntry(name, path = localMcpRegistryPath()) {
+    const current = await loadManualEntries(path);
+    if (!current.some((item) => item.name === name))
+        throw new Error(`No manually added local MCP named ${name}.`);
+    await writeManual(current.filter((item) => item.name !== name), path);
+}
+async function writeManual(entries, path) {
+    await ensureCredentialDirectory(dirname(path), true);
+    const servers = entries.map((entry) => { const { source: _source, ...rest } = entry; return rest; });
+    await writePrivateFile(path, JSON.stringify({ version: 1, servers }) + "\n");
+}
+function normalizeManual(entry) {
+    if (!entry || typeof entry !== "object" || !LOCAL_MCP_NAME.test(entry.name))
+        throw new Error("Local MCP names use 1-32 lowercase letters, digits or hyphens and start with a letter or digit.");
+    if (entry.transport === "http") {
+        assertLoopbackUrl(entry.url);
+        return { ...entry, source: "manual" };
+    }
+    if (entry.transport === "stdio") {
+        if (typeof entry.command !== "string" || entry.command.length === 0 || !Array.isArray(entry.args) || !entry.args.every((arg) => typeof arg === "string"))
+            throw new Error("A stdio local MCP needs a command and string arguments.");
+        return { ...entry, source: "manual" };
+    }
+    throw new Error("Local MCP transport must be http or stdio.");
+}
+// ------------------------------------------------------------------ loopback
+/** Only loopback HTTP(S) targets are ever contacted (plan F5). */
+export function assertLoopbackUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error("Local MCP URL is not valid.");
+    }
+    const host = url.hostname.replace(/^\[|\]$/gu, "");
+    const loopback = host === "localhost" || host === "::1" || /^127(?:\.\d{1,3}){3}$/u.test(host);
+    if ((url.protocol !== "http:" && url.protocol !== "https:") || !loopback || url.username || url.password) {
+        throw new Error("Local MCP URLs must be http(s) on 127.0.0.1, ::1 or localhost without credentials.");
+    }
+    return url;
+}
+const loopbackFetch = async (input, init) => {
+    assertLoopbackUrl(String(input));
+    const response = await fetch(input, { ...init, redirect: "manual" });
+    if (response.status >= 300 && response.status < 400)
+        throw new Error("The local MCP server redirected; redirects are not followed.");
+    return response;
+};
+export function parseLoopbackListeners(platform, outputs) {
+    const ports = new Set();
+    const add = (value) => { const port = Number(value); if (Number.isInteger(port) && port > 0 && port < 65536)
+        ports.add(port); };
+    for (const output of outputs) {
+        for (const line of output.split(/\r?\n/u)) {
+            if (platform === "linux") {
+                const fields = line.trim().split(/\s+/u);
+                const [address, port] = (fields[1] ?? "").split(":");
+                if (fields[3] !== "0A" || !address || !port)
+                    continue;
+                if (/^[0-9A-F]{6}7F$/u.test(address) || address === "00000000000000000000000001000000" || /^0000000000000000FFFF0000[0-9A-F]{6}7F$/u.test(address))
+                    add(String(Number.parseInt(port, 16)));
+            }
+            else if (platform === "win32") {
+                const match = /^\s*TCP\s+(?:127(?:\.\d+){3}|\[::1\]):(\d+)\s+\S+\s+LISTENING/u.exec(line);
+                if (match)
+                    add(match[1]);
+            }
+            else {
+                const match = /^n(?:127(?:\.\d+){3}|\[::1\]|localhost):(\d+)$/u.exec(line.trim());
+                if (match)
+                    add(match[1]);
+            }
+        }
+    }
+    return [...ports].sort((a, b) => a - b);
+}
+/** TCP ports that only accept loopback connections, found without extra dependencies. */
+export async function listLoopbackPorts(platform = process.platform) {
+    try {
+        if (platform === "linux") {
+            const files = await Promise.all(["/proc/net/tcp", "/proc/net/tcp6"].map((file) => readFile(file, "utf8").catch(() => "")));
+            return parseLoopbackListeners(platform, files);
+        }
+        const [command, args] = platform === "win32" ? ["netstat", ["-ano", "-p", "tcp"]] : ["lsof", ["-nP", "-iTCP", "-sTCP:LISTEN", "-Fn"]];
+        const output = await new Promise((resolve) => {
+            execFile(command, [...args], { timeout: 5_000, maxBuffer: 4 * 1024 * 1024, windowsHide: true }, (_error, stdout) => resolve(stdout ?? ""));
+        });
+        return parseLoopbackListeners(platform, [output]);
+    }
+    catch {
+        return [];
+    }
+}
+/** One standard `initialize` (or SSE handshake) per port; nothing is sent beyond that and redirects are never followed. */
+export async function probeHttpMcp(port, timeoutMs = PROBE_TIMEOUT_MS) {
+    for (const { path, flavor } of HTTP_PATHS) {
+        const url = `http://127.0.0.1:${port}${path}`;
+        try {
+            const hit = flavor === "streamable" ? await probeStreamable(url, timeoutMs) : await probeSse(url, timeoutMs);
+            if (hit)
+                return hit;
+        }
+        catch { /* Not an MCP endpoint on this path. */ }
+    }
+    return null;
+}
+async function probeStreamable(url, timeoutMs) {
+    const response = await fetch(url, {
+        method: "POST",
+        redirect: "manual",
+        signal: AbortSignal.timeout(timeoutMs),
+        headers: { "content-type": "application/json", accept: "application/json, text/event-stream" },
+        body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2025-06-18", capabilities: {}, clientInfo: { name: "frely-discovery", version: VERSION } } }),
+    });
+    const session = response.headers.get("mcp-session-id");
+    try {
+        if (!response.ok)
+            return null;
+        const type = response.headers.get("content-type") ?? "";
+        const text = (await response.text()).slice(0, 65_536);
+        const body = type.includes("text/event-stream") ? text.split(/\r?\n/u).filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trim())[0] : text;
+        const message = JSON.parse(body ?? "");
+        if (typeof message.result?.protocolVersion !== "string")
+            return null;
+        const serverName = typeof message.result.serverInfo?.name === "string" ? message.result.serverInfo.name : undefined;
+        return { url, flavor: "streamable", ...(serverName ? { serverName } : {}) };
+    }
+    finally {
+        if (session)
+            void fetch(url, { method: "DELETE", redirect: "manual", signal: AbortSignal.timeout(timeoutMs), headers: { "mcp-session-id": session } }).catch(() => undefined);
+    }
+}
+async function probeSse(url, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { redirect: "manual", signal: controller.signal, headers: { accept: "text/event-stream" } });
+        if (!response.ok || !(response.headers.get("content-type") ?? "").includes("text/event-stream") || !response.body)
+            return null;
+        const reader = response.body.getReader();
+        let seen = "";
+        while (seen.length < 4096 && !/^event:\s*endpoint\s*$/mu.test(seen)) {
+            const chunk = await reader.read();
+            if (chunk.done)
+                break;
+            seen += Buffer.from(chunk.value).toString("utf8");
+        }
+        void reader.cancel().catch(() => undefined);
+        return /^event:\s*endpoint\s*$/mu.test(seen) ? { url, flavor: "sse" } : null;
+    }
+    finally {
+        clearTimeout(timer);
+        controller.abort();
+    }
+}
+export async function discoverLoopbackMcps(deps = {}, skipPorts = new Set()) {
+    const ports = (await (deps.listPorts ?? listLoopbackPorts)()).filter((port) => !skipPorts.has(port)).slice(0, MAX_PROBED_PORTS);
+    const probe = deps.probe ?? probeHttpMcp;
+    const found = [];
+    let next = 0;
+    await Promise.all(Array.from({ length: Math.min(PROBE_CONCURRENCY, ports.length) }, async () => {
+        while (next < ports.length) {
+            const port = ports[next++];
+            const hit = await probe(port).catch(() => null);
+            if (hit)
+                found.push({ ...hit, port });
+        }
+    }));
+    return found.sort((a, b) => a.port - b.port);
+}
+export function slugName(value) {
+    const slug = (value ?? "").toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-+|-+$/gu, "").slice(0, 32).replace(/-+$/u, "");
+    return slug || "mcp";
+}
+/** Stable names: manual entries keep theirs, discovered ones use the server's own name and get a numeric suffix on clashes. */
+export function nameDiscovered(hits, taken) {
+    const used = new Set(taken);
+    return hits.map((hit) => {
+        const base = slugName(hit.serverName ?? `local-${hit.port}`);
+        let name = base;
+        for (let n = 2; used.has(name); n++)
+            name = `${base.slice(0, 32 - String(n).length - 1)}-${n}`;
+        used.add(name);
+        return { name, source: "discovered", transport: "http", url: hit.url, flavor: hit.flavor };
+    });
+}
+export class LocalMcpHub {
+    options;
+    entries = [];
+    refreshedAt = 0;
+    refreshing;
+    timer;
+    pool = new Map();
+    connecting = new Map();
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /** Begin periodic discovery and idle cleanup; both timers are unref'd. */
+    start() {
+        if (this.timer)
+            return;
+        void this.refresh().catch(() => undefined);
+        this.timer = setInterval(() => { void this.refresh().catch(() => undefined); void this.closeIdle(); }, this.options.refreshMs ?? 5 * 60_000);
+        this.timer.unref?.();
+    }
+    async close() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        await Promise.allSettled([...this.pool.values()].map((item) => item.client.close()));
+        this.pool.clear();
+    }
+    refresh() {
+        this.refreshing ??= this.scan().finally(() => { this.refreshing = undefined; });
+        return this.refreshing;
+    }
+    async scan() {
+        const manual = await (this.options.loadManual ?? (() => loadManualEntries()))().catch((error) => {
+            this.options.log?.(`local MCP list unreadable: ${error instanceof Error ? error.message : String(error)}`);
+            return [];
+        });
+        const covered = new Set(manual.flatMap((entry) => entry.transport === "http" ? [Number(new URL(entry.url).port)] : []));
+        const hits = await discoverLoopbackMcps(this.options.discovery, covered);
+        this.entries = [...manual, ...nameDiscovered(hits, manual.map((entry) => entry.name))];
+        this.refreshedAt = Date.now();
+        const live = new Map(this.entries.map((entry) => [entry.name, connectionKey(entry)]));
+        for (const [name, item] of [...this.pool])
+            if (live.get(name) !== item.key) {
+                this.pool.delete(name);
+                void item.client.close().catch(() => undefined);
+            }
+    }
+    async ensureFresh(maxAgeMs = 30_000) {
+        if (Date.now() - this.refreshedAt > maxAgeMs)
+            await this.refresh();
+    }
+    snapshot() { return this.entries; }
+    /** Names and transports for the web console; commands, URLs and secrets never leave the device. */
+    capabilities() {
+        return this.entries.slice(0, LOCAL_MCP_CAPABILITY_LIMIT).map((entry) => ({ name: entry.name, transport: entry.transport }));
+    }
+    /** `local_mcp_list`: enabled servers, or one enabled server's tool definitions. */
+    async list(enabled, server, signal) {
+        await this.ensureFresh();
+        if (server === undefined) {
+            const present = new Map(this.entries.map((entry) => [entry.name, entry]));
+            return { servers: enabled.map((name) => ({ name, transport: present.get(name)?.transport ?? null, available: present.has(name) })) };
+        }
+        const entry = this.requireEnabled(enabled, server);
+        const client = await this.client(entry);
+        const tools = [];
+        let cursor;
+        for (let page = 0; page < MAX_LIST_PAGES; page++) {
+            const result = await client.client.listTools(cursor ? { cursor } : {}, { timeout: LOCAL_MCP_DEFAULT_TIMEOUT_MS, ...(signal ? { signal } : {}) });
+            tools.push(...result.tools);
+            cursor = result.nextCursor;
+            if (!cursor)
+                break;
+        }
+        client.lastUsed = Date.now();
+        return { server, tools };
+    }
+    /** `local_mcp_call`: forwards one tools/call to an enabled server and bounds the result. */
+    async call(enabled, server, tool, args, options = {}) {
+        await this.ensureFresh();
+        const entry = this.requireEnabled(enabled, server);
+        const timeout = Math.min(Math.max(options.timeoutMs ?? LOCAL_MCP_DEFAULT_TIMEOUT_MS, 100), LOCAL_MCP_MAX_TIMEOUT_MS);
+        const pooled = await this.client(entry);
+        try {
+            const result = await pooled.client.callTool({ name: tool, arguments: args }, undefined, { timeout, ...(options.signal ? { signal: options.signal } : {}) });
+            pooled.lastUsed = Date.now();
+            return shapeToolResult(result);
+        }
+        catch (error) {
+            pooled.lastUsed = Date.now();
+            throw error;
+        }
+    }
+    requireEnabled(enabled, name) {
+        if (!enabled.includes(name)) {
+            throw new Error(`Local MCP ${JSON.stringify(name)} is not enabled on this device. Enabled: ${enabled.length > 0 ? enabled.join(", ") : "none"}. Enable it on the Frely connections page.`);
+        }
+        const entry = this.entries.find((item) => item.name === name);
+        if (!entry)
+            throw new Error(`Local MCP ${JSON.stringify(name)} is enabled but not running on this device right now.`);
+        return entry;
+    }
+    async client(entry) {
+        const key = connectionKey(entry);
+        const existing = this.pool.get(entry.name);
+        if (existing?.key === key)
+            return existing;
+        const pending = this.connecting.get(entry.name);
+        if (pending)
+            return pending;
+        const created = this.connect(entry, key).finally(() => this.connecting.delete(entry.name));
+        this.connecting.set(entry.name, created);
+        return created;
+    }
+    async connect(entry, key) {
+        const stale = this.pool.get(entry.name);
+        if (stale) {
+            this.pool.delete(entry.name);
+            void stale.client.close().catch(() => undefined);
+        }
+        const attempts = entry.transport === "stdio"
+            ? [() => stdioTransport(entry)]
+            : entry.flavor === "sse" ? [() => sseTransport(entry)] : entry.flavor === "streamable" ? [() => httpTransport(entry)] : [() => httpTransport(entry), () => sseTransport(entry)];
+        let lastError;
+        for (const make of attempts) {
+            const client = new Client({ name: "frely-cli", version: VERSION }, { capabilities: {} });
+            try {
+                await client.connect(make(), { timeout: CONNECT_TIMEOUT_MS });
+                const pooled = { key, client, lastUsed: Date.now() };
+                client.onclose = () => { if (this.pool.get(entry.name) === pooled)
+                    this.pool.delete(entry.name); };
+                this.pool.set(entry.name, pooled);
+                return pooled;
+            }
+            catch (error) {
+                lastError = error;
+                await client.close().catch(() => undefined);
+            }
+        }
+        throw new Error(`Could not connect to local MCP ${JSON.stringify(entry.name)}: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+    }
+    async closeIdle() {
+        const limit = Date.now() - (this.options.idleMs ?? 10 * 60_000);
+        for (const [name, item] of [...this.pool]) {
+            if (item.lastUsed < limit) {
+                this.pool.delete(name);
+                await item.client.close().catch(() => undefined);
+            }
+        }
+    }
+}
+function connectionKey(entry) {
+    return entry.transport === "http" ? JSON.stringify([entry.url, entry.flavor ?? null, entry.headers ?? null]) : JSON.stringify([entry.command, entry.args, entry.env ?? null, entry.path ?? null]);
+}
+function httpTransport(entry) {
+    const url = assertLoopbackUrl(entry.url);
+    return new StreamableHTTPClientTransport(url, { fetch: loopbackFetch, ...(entry.headers ? { requestInit: { headers: entry.headers } } : {}) });
+}
+function sseTransport(entry) {
+    const url = assertLoopbackUrl(entry.url);
+    return new SSEClientTransport(url, { fetch: loopbackFetch, eventSourceInit: { fetch: loopbackFetch }, ...(entry.headers ? { requestInit: { headers: entry.headers } } : {}) });
+}
+function stdioTransport(entry) {
+    const env = { ...safeEnv(), ...entry.env };
+    if (entry.path)
+        env.PATH = entry.path;
+    const transport = new StdioClientTransport({ command: entry.command, args: entry.args, env, cwd: homedir(), stderr: "pipe" });
+    // An undrained stderr pipe can stall the child; its output is not forwarded.
+    transport.stderr?.on("data", () => undefined);
+    return transport;
+}
+/** Resolve a bare command against PATH so a background service with a different PATH still finds it. */
+export async function resolveCommand(command, pathValue = process.env.PATH ?? "") {
+    if (isAbsolute(command))
+        return command;
+    const extensions = process.platform === "win32" ? ["", ...(process.env.PATHEXT ?? ".EXE;.CMD;.BAT").split(";")] : [""];
+    for (const directory of pathValue.split(delimiter).filter(Boolean)) {
+        for (const extension of extensions) {
+            const candidate = join(directory, command + extension);
+            if (await access(candidate, process.platform === "win32" ? constants.F_OK : constants.X_OK).then(() => true, () => false))
+                return candidate;
+        }
+    }
+    throw new Error(`Command not found on PATH: ${command}`);
+}
+/** Bounds what one local MCP call can put on the relay: 1 MiB of text, 6 MiB of binary content. */
+export function shapeToolResult(result) {
+    const content = [];
+    let text = 0;
+    let binary = 0;
+    for (const block of Array.isArray(result.content) ? result.content : []) {
+        const item = block;
+        if (item.type === "text" && typeof item.text === "string") {
+            const room = LOCAL_MCP_TEXT_LIMIT - text;
+            if (room <= 0)
+                continue;
+            const clipped = Buffer.byteLength(item.text) > room ? Buffer.from(item.text).subarray(0, room).toString("utf8") + "\n[truncated]" : item.text;
+            text += Buffer.byteLength(item.text);
+            content.push({ ...item, text: clipped });
+        }
+        else if (typeof item.data === "string") {
+            binary += item.data.length;
+            content.push(binary > LOCAL_MCP_BINARY_LIMIT ? { type: "text", text: `[${String(item.type)} content omitted: larger than ${LOCAL_MCP_BINARY_LIMIT / (1024 * 1024)} MiB relay budget]` } : item);
+        }
+        else {
+            content.push(item);
+        }
+    }
+    return { content, ...(result.isError === true ? { isError: true } : {}) };
+}
+//# sourceMappingURL=local-mcp.js.map

package/dist/runtime/local-mcp.js.map

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

package/dist/runtime/mcp.d.ts

@@ -1,5 +1,6 @@
 import type { MaintenanceGate } from "../upgrade/maintenance.js";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { LocalMcpHub } from "./local-mcp.js";
 export interface McpRuntimeOptions {
     maintenance?: MaintenanceGate;
     assertAuthorized?: () => void | Promise<void>;
@@ -10,6 +11,10 @@ export interface McpRuntimeOptions {
     getToolsets?: () => string[];
     /** Bridge for agent_* tools (frely-app toolset). Without it agent tools stay hidden. */
     callAgent?: (op: string, args: Record<string, unknown>) => Promise<unknown>;
+    /** Device-local MCP servers (plan mcp/本机MCP转发-方案.md). Without a hub the local_mcp_* tools stay hidden. */
+    localMcp?: LocalMcpHub;
+    /** Names the owner enabled on the current MCP authorization; absent or empty hides the local_mcp_* tools. */
+    getLocalMcps?: () => string[];
 }
 /** agent_* MCP tools exposed when the frely-app toolset is enabled (plan §5). */
 export declare const AGENT_TOOLS: readonly [{
@@ -146,5 +151,20 @@ export declare const AGENT_TOOLS: readonly [{
     };
     readonly required: readonly ["taskId"];
 }];
+/** Gateway tools for device-local MCP servers (plan F1): one pair, whatever number of servers or transports sit behind them. */
+export declare const LOCAL_MCP_TOOLS: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        additionalProperties: boolean;
+        properties: Record<string, unknown>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+    };
+}[];
 export declare function createMcpServer(workspaceInput: string, options?: McpRuntimeOptions): Promise<Server>;
 export declare function startStdioMcp(workspaceInput: string, options?: McpRuntimeOptions): Promise<void>;