@procedures/mcp-server 0.0.0-stage → 0.1.0

package/dist/procedures/mcp/list-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tools.js","sourceRoot":"","sources":["../../../src/procedures/mcp/list-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAsB,MAAM,iBAAiB,CAAC;AAE3E,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,8CAA8C;IAC9C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC/F,yCAAyC;IACzC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC1F,kDAAkD;IAClD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAClG,qDAAqD;IACrD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACtG,CAAC,CAAC;AAiBH,MAAM,wBAAwB,GAG1B;IACF,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAA0B;IACpD,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,IAAI,EAAE,IAA0B,EAAE,CAAC;CAC7F,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAiB,eAAe,CAAC;IACjE,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,uBAAuB;IAC9B,MAAM,EAAE,wBAAwB;IAChC,QAAQ,EAAE;QACR,WAAW,EAAE,sDAAsD;QACnE,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC;KAC/B;IACD,OAAO,EAAE,KAAK,EAAE,KAAwB,EAA+B,EAAE;QACvE,2CAA2C;QAC3C,MAAM,MAAM,GAAkB;YAC5B,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,CAAC;QACF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACzC,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACzC,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACvC,CAAC;QAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAE1D,MAAM,KAAK,GAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/procedures/mcp/serve.d.ts

@@ -0,0 +1,38 @@
+/**
+ * mcp.serve Procedure
+ *
+ * Start MCP server to expose procedures as tools.
+ *
+ * Which procedures are tools is a security decision. Before, `mcp.serve` exposed every
+ * procedure of the registry, `shell.exec` too (deep dive, architecture review 3.2). Now the tools
+ * come from `namespaces`/`exclude`, or from the `mcpNamespaces`/`mcpExclude` of the bundles
+ * (default: `@procedures/bundle-mcp`, resolved from the current folder). Without a list,
+ * nothing is exposed. The nested calls follow the call policy (`strictCalls`), and each tool call
+ * has a time limit.
+ */
+import { ProcedureServer, type AnyProcedure, type ProcedurePath } from "@procedures/client";
+/** The default bundle of the tool surface. */
+export declare const DEFAULT_SERVE_BUNDLE = "@procedures/bundle-mcp";
+/** The options of `prepareServe`: the tool surface and the rules of the server. */
+export interface ServeOptions {
+    autoRegister?: boolean | undefined;
+    namespaces?: readonly string[] | undefined;
+    exclude?: readonly string[] | undefined;
+    bundles?: readonly string[] | undefined;
+    strictCalls?: boolean | undefined;
+    toolTimeoutMs?: number | undefined;
+}
+/** The server of `mcp.serve`, before its transport starts. */
+export interface ServeSetup {
+    server: ProcedureServer;
+    expose: (path: ProcedurePath) => boolean;
+    /** Why the server has no tools, when it has none. */
+    warning?: string;
+}
+/**
+ * This function builds the procedure server of `mcp.serve`: its expose rule, its call policy and
+ * its interceptors. The bundles resolve from `from` (default: the current folder).
+ */
+export declare function prepareServe(input: ServeOptions, from?: string): Promise<ServeSetup>;
+export declare const mcpServeProcedure: AnyProcedure;
+//# sourceMappingURL=serve.d.ts.map

package/dist/procedures/mcp/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/procedures/mcp/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAEL,eAAe,EAGf,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAK5B,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AA+C7D,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;IACzC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BzG;AAED,eAAO,MAAM,iBAAiB,EAAE,YA0C9B,CAAC"}

package/dist/procedures/mcp/serve.js

@@ -0,0 +1,123 @@
+/**
+ * mcp.serve Procedure
+ *
+ * Start MCP server to expose procedures as tools.
+ *
+ * Which procedures are tools is a security decision. Before, `mcp.serve` exposed every
+ * procedure of the registry, `shell.exec` too (deep dive, architecture review 3.2). Now the tools
+ * come from `namespaces`/`exclude`, or from the `mcpNamespaces`/`mcpExclude` of the bundles
+ * (default: `@procedures/bundle-mcp`, resolved from the current folder). Without a list,
+ * nothing is exposed. The nested calls follow the call policy (`strictCalls`), and each tool call
+ * has a time limit.
+ */
+import { z } from "zod";
+import { defineProcedure, ProcedureServer, PROCEDURE_REGISTRY, timeoutInterceptor, } from "@procedures/client";
+import { McpServerTransport } from "../../transport/mcp-transport.js";
+import { exposeRule, importBundles, mergeSurfaces } from "../../surface.js";
+/** The default bundle of the tool surface. */
+export const DEFAULT_SERVE_BUNDLE = "@procedures/bundle-mcp";
+const McpServeInputSchema = z.object({
+    /**
+     * Transport type (default: "stdio"). Only stdio is implemented: the SSE transport needs an
+     * HTTP server integration, and accepting "sse" here only led to an error (BUGS-2026-07 L28).
+     */
+    transport: z.enum(["stdio"]).default("stdio").describe("Transport type (default: \"stdio\"). Only stdio is implemented: the SSE transport needs an HTTP server integration, and accepting \"sse\" here only led to an error (BUGS-2026-07 L28)."),
+    /** Server name for MCP (default: "procedure-server") */
+    name: z.string().optional().describe("Server name for MCP (default: \"procedure-server\")"),
+    /** Server version for MCP (default: "1.0.0") */
+    version: z.string().optional().describe("Server version for MCP (default: \"1.0.0\")"),
+    /** Whether to auto-register all procedures (default: true) */
+    autoRegister: z.boolean().default(true).describe("Whether to auto-register all procedures (default: true)"),
+    /** Enable debug logging */
+    debug: z.boolean().default(false).describe("Enable debug logging"),
+    /** The namespaces (first path segments) of the tools. With this list, the bundles give no tools. */
+    namespaces: z.array(z.string()).optional().describe("The namespaces (first path segments) of the tools. With this list, the bundles give no tools."),
+    /** Procedure keys of the tool namespaces that are not tools. */
+    exclude: z.array(z.string()).optional().describe("Procedure keys of the tool namespaces that are not tools."),
+    /** The bundles whose mcpNamespaces and mcpExclude give the tools, when `namespaces` is not given. */
+    bundles: z.array(z.string()).optional().describe("The bundles whose mcpNamespaces and mcpExclude give the tools, when `namespaces` is not given."),
+    /** True (the default): a procedure of code without metadata.calls can call only tools. */
+    strictCalls: z.boolean().default(true).describe("True (the default): a procedure of code without metadata.calls can call only tools."),
+    /** The time limit of each tool call, in milliseconds (default: 600000). 0: no limit. */
+    toolTimeoutMs: z.number().int().min(0).default(600_000).describe("The time limit of each tool call, in milliseconds (default: 600000). 0: no limit."),
+});
+const McpServeOutputSchema = {
+    parse: (data) => data,
+    safeParse: (data) => ({ success: true, data: data }),
+};
+/**
+ * This function builds the procedure server of `mcp.serve`: its expose rule, its call policy and
+ * its interceptors. The bundles resolve from `from` (default: the current folder).
+ */
+export async function prepareServe(input, from = process.cwd()) {
+    let expose = () => false;
+    let warning;
+    if (input.namespaces) {
+        expose = exposeRule({ namespaces: input.namespaces, exclude: input.exclude });
+    }
+    else {
+        const bundles = input.bundles ?? [DEFAULT_SERVE_BUNDLE];
+        try {
+            const surface = mergeSurfaces(await importBundles(bundles, from));
+            if (surface) {
+                expose = exposeRule({ namespaces: surface.namespaces, exclude: [...(surface.exclude ?? []), ...(input.exclude ?? [])] });
+            }
+            else {
+                warning = `The bundles ${bundles.join(", ")} give no mcpNamespaces, so no procedure is a tool. Give namespaces.`;
+            }
+        }
+        catch (error) {
+            warning =
+                `The bundles ${bundles.join(", ")} cannot be loaded from ${from} (${error.message}), ` +
+                    `so no procedure is a tool. Give namespaces, or run in a project that has the bundles.`;
+        }
+    }
+    const server = new ProcedureServer({
+        autoRegister: input.autoRegister ?? true,
+        registry: PROCEDURE_REGISTRY,
+        expose,
+        strictCalls: input.strictCalls ?? true,
+        interceptors: [timeoutInterceptor({ ms: input.toolTimeoutMs ?? 600_000 })],
+    });
+    return warning === undefined ? { server, expose } : { server, expose, warning };
+}
+export const mcpServeProcedure = defineProcedure({
+    path: ["mcp", "serve"],
+    input: McpServeInputSchema,
+    output: McpServeOutputSchema,
+    metadata: {
+        description: "Start MCP server to expose procedures as tools",
+        tags: ["mcp", "server"],
+    },
+    handler: async (input) => {
+        const serverName = input.name ?? "procedure-server";
+        const serverVersion = input.version ?? "1.0.0";
+        const { server, expose, warning } = await prepareServe(input);
+        // Build transport options
+        const options = {
+            transport: input.transport,
+            serverInfo: {
+                name: serverName,
+                version: serverVersion,
+            },
+            debug: input.debug,
+            toolFilter: { include: expose },
+        };
+        // Create MCP transport
+        const mcpTransport = new McpServerTransport(server, options);
+        // Add transport and start
+        server.addTransport(mcpTransport);
+        await server.start();
+        const state = mcpTransport.getState();
+        if (warning)
+            console.error(`[mcp.serve] ${warning}`);
+        return {
+            success: true,
+            transport: input.transport,
+            toolCount: state.toolCount,
+            serverName,
+            ...(warning ? { warning } : {}),
+        };
+    },
+});
+//# sourceMappingURL=serve.js.map

package/dist/procedures/mcp/serve.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Importing this file registers the MCP procedures in the global registry (DECISIONS-2026-10,
+ * "Every package root registers its procedures"). The procedures as data are in `module.ts`,
+ * which registers nothing: a host with its own registry uses that one.
+ */
+export * from "./module.js";
+/**
+ * Register all MCP procedures.
+ */
+export declare function registerMcpProcedures(): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C"}

package/dist/register.js

@@ -0,0 +1,21 @@
+/**
+ * Importing this file registers the MCP procedures in the global registry (DECISIONS-2026-10,
+ * "Every package root registers its procedures"). The procedures as data are in `module.ts`,
+ * which registers nothing: a host with its own registry uses that one.
+ */
+import { PROCEDURE_REGISTRY } from "@procedures/client";
+import { mcpModule } from "./module.js";
+export * from "./module.js";
+/**
+ * Register all MCP procedures.
+ */
+export function registerMcpProcedures() {
+    for (const proc of mcpModule.procedures) {
+        if (!PROCEDURE_REGISTRY.has(proc.path)) {
+            PROCEDURE_REGISTRY.register(proc);
+        }
+    }
+}
+// Auto-register when this module is imported
+registerMcpProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,cAAc,aAAa,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,qBAAqB,EAAE,CAAC"}

package/dist/surface.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The tool surface of an MCP server: which procedures are tools.
+ *
+ * A bundle (for example `@procedures/bundle-mcp`) registers procedures when it is imported.
+ * Its `register.js` exports `mcpNamespaces` (the first path segments of the tools) and
+ * `mcpExclude` (procedure keys of those namespaces that are not tools). The dev-tools server
+ * (`impl-mcp-dev`) and `mcp.serve` build their expose rule from these lists.
+ */
+import { type ProcedurePath, type ToolSurface } from "@procedures/client";
+/** The tools of a server: the namespaces, less the excluded procedure keys (the core type). */
+export type { ToolSurface };
+/** The exports of a bundle's `register.js` that describe its tools. */
+export interface BundleSurfaceModule {
+    mcpNamespaces?: readonly string[];
+    mcpExclude?: readonly string[];
+}
+/** The expose rule of a tool surface: `surfaceRule()` of the core host policy (roadmap 2.3). */
+export declare function exposeRule(surface: ToolSurface): (path: ProcedurePath) => boolean;
+/**
+ * The union of the surfaces of some bundles. Undefined when no bundle has `mcpNamespaces`: such
+ * bundles say nothing about their tools.
+ */
+export declare function mergeSurfaces(modules: readonly BundleSurfaceModule[]): ToolSurface | undefined;
+/**
+ * The file URL of a bundle's `register.js`, found in the `node_modules` folders from `from`
+ * upward. The bundle's `exports` map gives the file. (`require.resolve` cannot do it: a bundle
+ * exports `register.js` for `import` only.)
+ */
+export declare function resolveBundleRegister(bundle: string, from: string): string;
+/**
+ * This function imports the `register.js` of each bundle, which registers its procedures, and
+ * returns the modules. With `from`, a bundle resolves from that folder (a project), not from
+ * this package.
+ */
+export declare function importBundles(bundles: readonly string[], from?: string): Promise<BundleSurfaceModule[]>;
+//# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvF,+FAA+F;AAC/F,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAEjF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GAAG,WAAW,GAAG,SAAS,CAW9F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAO7G"}

package/dist/surface.js

@@ -0,0 +1,74 @@
+/**
+ * The tool surface of an MCP server: which procedures are tools.
+ *
+ * A bundle (for example `@procedures/bundle-mcp`) registers procedures when it is imported.
+ * Its `register.js` exports `mcpNamespaces` (the first path segments of the tools) and
+ * `mcpExclude` (procedure keys of those namespaces that are not tools). The dev-tools server
+ * (`impl-mcp-dev`) and `mcp.serve` build their expose rule from these lists.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { surfaceRule } from "@procedures/client";
+/** The expose rule of a tool surface: `surfaceRule()` of the core host policy (roadmap 2.3). */
+export function exposeRule(surface) {
+    return surfaceRule(surface);
+}
+/**
+ * The union of the surfaces of some bundles. Undefined when no bundle has `mcpNamespaces`: such
+ * bundles say nothing about their tools.
+ */
+export function mergeSurfaces(modules) {
+    let namespaces;
+    const exclude = new Set();
+    for (const module of modules) {
+        if (Array.isArray(module.mcpNamespaces)) {
+            namespaces ??= new Set();
+            for (const namespace of module.mcpNamespaces)
+                namespaces.add(namespace);
+        }
+        for (const key of module.mcpExclude ?? [])
+            exclude.add(key);
+    }
+    return namespaces ? { namespaces: [...namespaces].sort(), exclude: [...exclude].sort() } : undefined;
+}
+/**
+ * The file URL of a bundle's `register.js`, found in the `node_modules` folders from `from`
+ * upward. The bundle's `exports` map gives the file. (`require.resolve` cannot do it: a bundle
+ * exports `register.js` for `import` only.)
+ */
+export function resolveBundleRegister(bundle, from) {
+    let dir = resolve(from);
+    for (;;) {
+        const folder = join(dir, "node_modules", ...bundle.split("/"));
+        const manifestPath = join(folder, "package.json");
+        if (existsSync(manifestPath)) {
+            const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+            const entry = manifest.exports?.["./register.js"];
+            const target = typeof entry === "string"
+                ? entry
+                : (entry?.import ??
+                    entry?.default ??
+                    "./dist/register.js");
+            return pathToFileURL(join(folder, target)).href;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            throw new Error(`Cannot find ${bundle} from ${from}`);
+        dir = parent;
+    }
+}
+/**
+ * This function imports the `register.js` of each bundle, which registers its procedures, and
+ * returns the modules. With `from`, a bundle resolves from that folder (a project), not from
+ * this package.
+ */
+export async function importBundles(bundles, from) {
+    const modules = [];
+    for (const bundle of bundles) {
+        const target = from ? resolveBundleRegister(bundle, from) : `${bundle}/register.js`;
+        modules.push((await import(target)));
+    }
+    return modules;
+}
+//# sourceMappingURL=surface.js.map

package/dist/surface.js.map

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

package/dist/transport/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Transport exports.
+ */
+export { McpServerTransport } from "./mcp-transport.js";
+export { createStdioTransport } from "./stdio.js";
+export { createSseTransport } from "./sse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,7 @@
+/**
+ * Transport exports.
+ */
+export { McpServerTransport } from "./mcp-transport.js";
+export { createStdioTransport } from "./stdio.js";
+export { createSseTransport } from "./sse.js";
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/transport/mcp-transport.d.ts

@@ -0,0 +1,94 @@
+/**
+ * MCP Server Transport
+ *
+ * Implements ServerTransport interface for MCP protocol.
+ * Maps PROCEDURE_REGISTRY to MCP tools.
+ */
+import type { ServerTransport, Server } from "@procedures/client";
+import { type McpTool } from "@procedures/mcp";
+import type { McpServerTransportOptions, McpServerTransportState } from "../types.js";
+/**
+ * MCP Server Transport
+ *
+ * Implements the ServerTransport interface for MCP (Model Context Protocol).
+ * Maps procedures from PROCEDURE_REGISTRY to MCP tools, handling:
+ * - ListToolsRequest: Returns all registered procedures as tools
+ * - CallToolRequest: Executes the corresponding procedure
+ *
+ * @example
+ * ```typescript
+ * const server = new ProcedureServer({ autoRegister: true });
+ * const mcpTransport = new McpServerTransport(server, {
+ *   transport: "stdio",
+ *   serverInfo: { name: "my-server", version: "1.0.0" }
+ * });
+ * server.addTransport(mcpTransport);
+ * await server.start();
+ * ```
+ */
+export declare class McpServerTransport implements ServerTransport {
+    readonly name = "mcp";
+    private mcpServer;
+    private server;
+    private registry;
+    private options;
+    private running;
+    private tools;
+    private registerListener;
+    private unregisterListener;
+    /** A pending list_changed notification: a burst of registrations sends one */
+    private listChangedTimer;
+    constructor(server: Server, options?: McpServerTransportOptions);
+    /**
+     * Setup MCP request handlers.
+     */
+    private setupHandlers;
+    /**
+     * Setup registry event listeners for dynamic tool updates.
+     */
+    /**
+     * The result of a streaming procedure. An MCP tool result is one message, so the transport
+     * reads the whole stream. Each item becomes a text block (the last MAX_STREAM_BLOCKS items),
+     * and a progress notification when the caller sent a progress token, so a client can show
+     * the items while the stream runs.
+     */
+    private streamResult;
+    private setupRegistryListeners;
+    /**
+     * Remove the registry event listeners, if attached.
+     */
+    private removeRegistryListeners;
+    /**
+     * Refresh the tool list from the registry.
+     */
+    private refreshTools;
+    /** The tool names and descriptions: a change of this text is a change of the tool list. */
+    private toolSignature;
+    /** Send one notifications/tools/list_changed for a burst of registry events. */
+    private scheduleListChanged;
+    /**
+     * Log a debug message if debug mode is enabled.
+     */
+    private log;
+    /**
+     * Start the MCP transport.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP transport.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the transport is running.
+     */
+    isRunning(): boolean;
+    /**
+     * Get current transport state.
+     */
+    getState(): McpServerTransportState;
+    /**
+     * Get the list of available tools.
+     */
+    getTools(): McpTool[];
+}
+//# sourceMappingURL=mcp-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-transport.d.ts","sourceRoot":"","sources":["../../src/transport/mcp-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAiCtF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,IAAI,SAAS;IAEtB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,OAAO,CACa;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,gBAAgB,CAA6C;IACrE,OAAO,CAAC,kBAAkB,CAA6C;IACvE,8EAA8E;IAC9E,OAAO,CAAC,gBAAgB,CAA4C;IAEpE,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,EA8BlE;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IAsFrB;;OAEG;IACH;;;;;OAKG;YACW,YAAY;IAoC1B,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB,2FAA2F;IAC3F,OAAO,CAAC,aAAa;IAKrB,gFAAgF;IAChF,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,GAAG;IAQX;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC3B;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAe1B;IAED;;OAEG;IACH,SAAS,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,QAAQ,IAAI,uBAAuB,CAMlC;IAED;;OAEG;IACH,QAAQ,IAAI,OAAO,EAAE,CAEpB;CACF"}