@plurnk/plurnk-mcp 1.4.0

package/.env.defaults

@@ -0,0 +1,19 @@
+# --- @plurnk/plurnk-mcp : current MCP host module ---
+
+# Bound only connection and protocol discovery. Individual MCP operations use
+# the request timeout below and remain cancellable through their Plurnk run.
+PLURNK_MCP_CONNECT_TIMEOUT=30000
+PLURNK_MCP_REQUEST_TIMEOUT=86400000
+
+# Each configured server becomes EXEC[<server>] and <server>://.
+#
+# Streamable HTTP:
+# PLURNK_MCP_github=https://example.test/mcp
+# PLURNK_MCP_github_HEADERS={"Authorization":"Bearer ${GITHUB_TOKEN}"}
+#
+# stdio: the target is one executable. Arguments are a JSON array so Plurnk
+# does not invent or interpret a shell command language.
+# PLURNK_MCP_atlas=node
+# PLURNK_MCP_atlas_ARGS=["/absolute/path/to/atlas-server.mjs"]
+# PLURNK_MCP_atlas_CWD=/absolute/working/directory
+# PLURNK_MCP_atlas_ENV={"TOKEN":"${ATLAS_TOKEN}"}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# @plurnk/plurnk-mcp
+
+The current [Model Context Protocol](https://modelcontextprotocol.io/) host
+module for [Plurnk](https://github.com/plurnk/plurnk-service).
+
+Each configured MCP server becomes a model-facing executor and resource
+authority:
+
+```text
+<<READ(github:///):READ
+<<EXEC[github](create_issue):{"title":"Bug"}:EXEC
+<<FIND(github:///resources/**)::FIND
+<<READ(github:///resources/https%3A%2F%2Fexample.test%2Fdocument)::READ
+```
+
+The module requires protocol revision `2026-07-28`. It does not negotiate or
+fall back to a legacy revision.
+
+## Configuration
+
+Configuration is daemon-owned. One `PLURNK_MCP_<server>` variable declares
+each server; the suffix case-folds to the executor and URI authority name.
+
+Streamable HTTP:
+
+```text
+PLURNK_MCP_github=https://example.test/mcp
+PLURNK_MCP_github_HEADERS={"Authorization":"Bearer ${GITHUB_TOKEN}"}
+```
+
+Stdio:
+
+```text
+PLURNK_MCP_local=/absolute/path/to/executable
+PLURNK_MCP_local_ARGS=["--stdio"]
+PLURNK_MCP_local_CWD=/absolute/working/directory
+PLURNK_MCP_local_ENV={"TOKEN":"${LOCAL_TOKEN}"}
+```
+
+The stdio target is exactly one executable. Arguments are a JSON array; the
+module never parses or invokes a shell command. `${NAME}` references read the
+daemon's inherited environment at startup, so secrets do not need to be copied
+into Plurnk environment files.
+
+Portable timeout defaults and complete examples live in
+[`.env.defaults`](./.env.defaults).
+
+## Current surface
+
+- `READ(server:///)` returns the live tools, resources, resource templates, and
+  prompts catalog.
+- `EXEC[server](tool)` calls a tool with one JSON object in the body.
+- `server:///resources` exposes the resource catalog through ordinary Plurnk
+  `FIND` and `READ`.
+- `server:///resources/<encoded-uri>` reads a concrete MCP resource and stores
+  it as an ordinary entry, after which normal projection and slicing apply.
+- A tool's `readOnlyHint` selects Plurnk's read effect. Unknown or mutating
+  tools retain the host effect.
+
+Prompt retrieval, resource subscriptions, current multi-round-trip input,
+current task methods, and OAuth/OIDC authorization are not part of this
+vertical slice. They will use the same module and connection seams; no legacy
+protocol surface is retained as a fallback.
+
+## Verification
+
+`npm test` type-checks the module and exercises exact current-version
+negotiation, configuration, tool calls, resource reads, runtime registration,
+and rejection of ambiguous shell and secret configuration.

package/SPEC.md

@@ -0,0 +1,48 @@
+# Plurnk MCP host specification
+
+## Current protocol boundary
+
+- The only accepted MCP revision is `2026-07-28`.
+- Every client connection pins that revision and verifies a modern
+  `server/discover` result before registration.
+- Stdio servers are invoked as an executable plus an explicit argument array.
+  Shell command parsing is not part of the contract.
+- HTTP uses Streamable HTTP. There is no legacy SSE fallback.
+- A connection or discovery failure leaves no registered runtime.
+- Shutdown waits for every connection attempt to settle, then closes every
+  acquired connection and reports all close failures.
+
+## Configuration
+
+| Variable | Contract |
+|---|---|
+| `PLURNK_MCP_<server>` | HTTP(S) URL or exact stdio executable |
+| `PLURNK_MCP_<server>_ARGS` | JSON string array for stdio |
+| `PLURNK_MCP_<server>_CWD` | Working directory for stdio |
+| `PLURNK_MCP_<server>_ENV` | JSON string map for stdio |
+| `PLURNK_MCP_<server>_HEADERS` | JSON string map for HTTP |
+| `PLURNK_MCP_CONNECT_TIMEOUT` | Positive integer milliseconds |
+| `PLURNK_MCP_REQUEST_TIMEOUT` | Positive integer milliseconds |
+
+Server names case-fold. Duplicate names, orphan companions, transport-specific
+companions on the wrong transport, missing environment references, and invalid
+JSON fail startup.
+
+## Model-facing mapping
+
+| MCP surface | Plurnk surface |
+|---|---|
+| Server | `EXEC[server]` and `server://` |
+| Tool catalog | `server:///` |
+| Tool call | `EXEC[server](tool)` with a JSON object body |
+| Resource catalog | `server:///resources` |
+| Resource read | `server:///resources/<encoded-uri>` |
+
+The executor manifest remains the owner of ordinary result coordinates. The
+MCP resource facet claims only `/`, `/resources`, and descendants. Every other
+path uses the standard executor-output scheme.
+
+Tools and resources are current in this vertical slice. Cataloged prompts are
+descriptive only. Prompt retrieval, subscriptions, multi-round-trip input,
+tasks, and authorization remain unavailable until their current contracts are
+implemented and covered; they do not fall back to legacy behavior.

package/dist/McpExecutor.d.ts

@@ -0,0 +1,16 @@
+import { BaseExecutor } from "@plurnk/plurnk-execs";
+import type { ChannelDecl, Effect, ExecArgs, ExecResult, RuntimeAvailability, RuntimeDecl } from "@plurnk/plurnk-execs";
+import ServerConnection from "./client.ts";
+export declare const runtimeDecl: (name: string) => RuntimeDecl;
+export default class McpExecutor extends BaseExecutor {
+    #private;
+    constructor(metadata: {
+        runtime: string;
+        glyph: string;
+    }, connection: ServerConnection);
+    get channels(): Readonly<Record<string, ChannelDecl>>;
+    effect(target: string | null): Effect;
+    probe(signal?: AbortSignal): Promise<RuntimeAvailability>;
+    run({ runtime, command, target, signal, write, setState, }: ExecArgs): Promise<ExecResult>;
+}
+//# sourceMappingURL=McpExecutor.d.ts.map

package/dist/McpExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpExecutor.d.ts","sourceRoot":"","sources":["../src/McpExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EAIf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACR,WAAW,EACX,MAAM,EACN,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,WAAW,EACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAI3C,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,WAiBzC,CAAC;AAKH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,YAAY;;IAGjD,YACI,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAC5C,UAAU,EAAE,gBAAgB,EAI/B;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAMpD;IAEQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAG7C;IAEc,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyBvE;IAEK,GAAG,CAAC,EACN,OAAO,EACP,OAAO,EACP,MAAM,EACN,MAAM,EACN,KAAK,EACL,QAAQ,GACX,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA0FhC;CACJ"}

package/dist/McpExecutor.js

@@ -0,0 +1,127 @@
+import { BaseExecutor, ErrorDetail, ERROR_DETAIL_LIMIT, Results, } from "@plurnk/plurnk-execs";
+const CHANNEL = "body";
+export const runtimeDecl = (name) => ({
+    name,
+    glyph: "🔌",
+    example: `<<EXEC[${name}](tool_name):{"argument":"value"}:EXEC`,
+    documentation: `# ${name}
+
+This configured MCP server is available as an executable tool family and an
+addressable resource family.
+
+\`\`\`plurnk
+<<READ(${name}:///):READ
+<<EXEC[${name}](tool_name):{"argument":"value"}:EXEC
+\`\`\`
+
+READ returns the live catalog. Tool arguments are one JSON object. Tool results
+are written to the operation's \`body\` channel.
+`,
+});
+const message = (error) => error instanceof Error ? error.message : String(error);
+export default class McpExecutor extends BaseExecutor {
+    #connection;
+    constructor(metadata, connection) {
+        super(metadata);
+        this.#connection = connection;
+    }
+    get channels() {
+        return {
+            [CHANNEL]: {
+                mimetype: "application/json",
+            },
+        };
+    }
+    effect(target) {
+        if (target === null || target.length === 0)
+            return "read";
+        return this.#connection.readOnly(target) ? "read" : "host";
+    }
+    async probe(signal) {
+        const detailLimit = ErrorDetail.configuredLimit();
+        if (detailLimit === null) {
+            return {
+                available: false,
+                detail: `${ERROR_DETAIL_LIMIT} must be set to a non-negative integer.`,
+            };
+        }
+        try {
+            const catalog = await this.#connection.catalog(signal);
+            return {
+                available: true,
+                detail: [
+                    `MCP ${catalog.protocolVersion}`,
+                    `${catalog.tools.length} tools`,
+                    `${catalog.resources.length} resources`,
+                    `${catalog.prompts.length} prompts`,
+                ].join("; "),
+            };
+        }
+        catch (error) {
+            return {
+                available: false,
+                detail: ErrorDetail.preview(message(error), detailLimit),
+            };
+        }
+    }
+    async run({ runtime, command, target, signal, write, setState, }) {
+        const fail = (code, status, detail, extensions) => {
+            setState(CHANNEL, "errored");
+            return Results.failure("executor:mcp", code, status, detail, {}, {
+                runtime,
+                stage: "mcp",
+                ...extensions,
+            });
+        };
+        const detailLimit = ErrorDetail.configuredLimit();
+        if (detailLimit === null) {
+            setState(CHANNEL, "errored");
+            return ErrorDetail.invalidConfiguration("executor:mcp");
+        }
+        const body = command.trim();
+        if (target === null || target.length === 0) {
+            return fail("tool-required", 400, `MCP executor '${runtime}' requires a tool target.`, {
+                recovery: `READ ${runtime}:/// for the live catalog, then target one listed tool.`,
+                retryable: false,
+            });
+        }
+        let args = {};
+        if (body.length > 0) {
+            try {
+                const parsed = JSON.parse(body);
+                if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                    throw new TypeError("tool arguments must be an object");
+                }
+                args = parsed;
+            }
+            catch (cause) {
+                return fail("invalid-tool-arguments", 400, `Arguments for MCP tool '${target}' must be one JSON object.`, {
+                    tool: target,
+                    retryable: false,
+                    diagnostic: ErrorDetail.preview(message(cause), detailLimit),
+                });
+            }
+        }
+        try {
+            const result = await this.#connection.callTool(target, args, signal);
+            write(CHANNEL, JSON.stringify(result), "application/json");
+            if (result.isError === true) {
+                return fail("tool-reported-error", 502, `MCP tool '${target}' on '${runtime}' reported an error.`, {
+                    tool: target,
+                    retryable: false,
+                });
+            }
+            setState(CHANNEL, "closed");
+            return { status: 200 };
+        }
+        catch (error) {
+            return fail(signal.aborted ? "cancelled" : "tool-call-failed", signal.aborted ? 499 : 502, signal.aborted
+                ? `MCP tool '${target}' on '${runtime}' was cancelled.`
+                : `MCP tool '${target}' on '${runtime}' failed: ${ErrorDetail.preview(message(error), detailLimit)}.`, {
+                tool: target,
+                retryable: !signal.aborted,
+            });
+        }
+    }
+}
+//# sourceMappingURL=McpExecutor.js.map

package/dist/McpExecutor.js.map

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

package/dist/McpResources.d.ts

@@ -0,0 +1,10 @@
+import { type EntryReadResult, type EntryFindResult, type FindStatement, type ReadStatement, type SchemeCtx } from "@plurnk/plurnk-schemes";
+import ServerConnection from "./client.ts";
+export default class McpResources {
+    #private;
+    constructor(server: string, connection: ServerConnection);
+    claims(pathname: string): boolean;
+    read(statement: ReadStatement, ctx: SchemeCtx): Promise<EntryReadResult>;
+    find(statement: FindStatement, ctx: SchemeCtx): Promise<EntryFindResult>;
+}
+//# sourceMappingURL=McpResources.d.ts.map

package/dist/McpResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpResources.d.ts","sourceRoot":"","sources":["../src/McpResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAyF3C,MAAM,CAAC,OAAO,OAAO,YAAY;;IAI7B,YAAY,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAGvD;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIhC;IAgEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CA4B7E;IAEK,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB7E;CACJ"}

package/dist/McpResources.js

@@ -0,0 +1,153 @@
+import { Results, } from "@plurnk/plurnk-schemes";
+const ROOT = "/";
+const RESOURCES = "/resources";
+const RESOURCE_PREFIX = `${RESOURCES}/`;
+const RESOURCE_TAG = "mcp-resource";
+const CATALOG_TAG = "mcp-resource-catalog";
+class ResourceAddressError extends Error {
+}
+const resourcePath = (uri) => `${RESOURCE_PREFIX}${encodeURIComponent(uri)}`;
+const readFailure = (server, code, status, detail, extensions) => Results.failure("scheme:mcp", code, status, detail, {
+    content: null,
+    mimetype: null,
+    channel: null,
+}, {
+    server,
+    stage: "mcp-resource",
+    ...extensions,
+});
+const findFailure = (server, code, status, detail, extensions) => Results.failure("scheme:mcp", code, status, detail, {
+    content: null,
+    mimetype: null,
+    results: [],
+    itemsTokenTotal: 0,
+    pathnames: [],
+    matches: [],
+}, {
+    server,
+    stage: "mcp-resource",
+    ...extensions,
+});
+const resourceBody = (result) => {
+    if (result.contents.length === 1 && "text" in result.contents[0]) {
+        const value = result.contents[0];
+        return {
+            content: value.text,
+            mimetype: value.mimeType ?? "text/plain",
+        };
+    }
+    return {
+        content: JSON.stringify(result),
+        mimetype: "application/json",
+    };
+};
+const catalogEntry = (content, tags) => ({
+    channels: {
+        body: {
+            content,
+            mimetype: "application/json",
+        },
+    },
+    tags,
+});
+export default class McpResources {
+    #server;
+    #connection;
+    constructor(server, connection) {
+        this.#server = server;
+        this.#connection = connection;
+    }
+    claims(pathname) {
+        return pathname === ROOT
+            || pathname === RESOURCES
+            || pathname.startsWith(RESOURCE_PREFIX);
+    }
+    async #materializeCatalog(ctx) {
+        const catalog = await this.#connection.catalog(ctx.signal);
+        await ctx.entries.write(ROOT, catalogEntry(JSON.stringify({
+            ...catalog,
+            resources: catalog.resources.map((resource) => ({
+                ...resource,
+                address: `${this.#server}://${resourcePath(resource.uri)}`,
+            })),
+        }), ["mcp-catalog"]));
+        await ctx.entries.write(RESOURCES, catalogEntry(JSON.stringify({
+            resources: catalog.resources.map((resource) => ({
+                ...resource,
+                address: `${this.#server}://${resourcePath(resource.uri)}`,
+            })),
+            resourceTemplates: catalog.resourceTemplates,
+        }), ["mcp-resource-index"]));
+        await Promise.all(catalog.resources.map(async (resource) => {
+            const pathname = resourcePath(resource.uri);
+            const existing = await ctx.entries.read(pathname);
+            if (existing.entry?.tags.includes(RESOURCE_TAG) === true)
+                return;
+            await ctx.entries.write(pathname, catalogEntry(JSON.stringify({
+                ...resource,
+                address: `${this.#server}://${pathname}`,
+            }), [CATALOG_TAG]));
+        }));
+    }
+    async #materializeResource(pathname, ctx) {
+        const encoded = pathname.slice(RESOURCE_PREFIX.length);
+        if (encoded.length === 0 || encoded.includes("/")) {
+            throw new ResourceAddressError(`Invalid MCP resource address '${pathname}'.`);
+        }
+        let uri;
+        try {
+            uri = decodeURIComponent(encoded);
+        }
+        catch (cause) {
+            throw new ResourceAddressError(`Invalid encoded MCP resource address '${pathname}'.`, { cause });
+        }
+        const body = resourceBody(await this.#connection.readResource(uri, ctx.signal));
+        await ctx.entries.write(pathname, {
+            channels: {
+                body: {
+                    content: body.content,
+                    mimetype: body.mimetype,
+                },
+            },
+            tags: [RESOURCE_TAG],
+        });
+    }
+    async read(statement, ctx) {
+        const pathname = statement.target?.kind === "url"
+            ? statement.target.pathname ?? ROOT
+            : ROOT;
+        try {
+            const exactResource = pathname.startsWith(RESOURCE_PREFIX)
+                && !/[*?[\]{}]/.test(pathname);
+            if (exactResource) {
+                await this.#materializeResource(pathname, ctx);
+            }
+            else {
+                await this.#materializeCatalog(ctx);
+            }
+            return await ctx.entries.operations.read(statement);
+        }
+        catch (error) {
+            const invalidAddress = error instanceof ResourceAddressError;
+            return readFailure(this.#server, invalidAddress ? "resource-address-invalid" : "resource-read-failed", invalidAddress ? 400 : 502, invalidAddress
+                ? `The requested MCP resource address for '${this.#server}' is invalid.`
+                : `MCP server '${this.#server}' could not read the requested resource.`, {
+                diagnostic: error instanceof Error ? error.message : String(error),
+                retryable: !invalidAddress,
+            });
+        }
+    }
+    async find(statement, ctx) {
+        try {
+            await this.#materializeCatalog(ctx);
+            return await ctx.entries.operations.find(statement);
+        }
+        catch (error) {
+            return findFailure(this.#server, "resource-find-failed", 502, `MCP server '${this.#server}' could not list its resources.`, {
+                diagnostic: error instanceof Error ? error.message : String(error),
+                retryable: true,
+            });
+        }
+    }
+}
+//# sourceMappingURL=McpResources.js.map

package/dist/McpResources.js.map

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

package/dist/Module.d.ts

@@ -0,0 +1,29 @@
+import type { RuntimeAvailability, RuntimeDecl } from "@plurnk/plurnk-execs";
+import type { FindStatement, ReadStatement, SchemeCtx, SchemeResult } from "@plurnk/plurnk-schemes";
+import McpExecutor from "./McpExecutor.ts";
+interface RuntimeSchemeFacet {
+    claims(pathname: string): boolean;
+    read?(statement: ReadStatement, ctx: SchemeCtx): Promise<SchemeResult>;
+    find?(statement: FindStatement, ctx: SchemeCtx): Promise<SchemeResult>;
+}
+interface ModuleSetupSeam {
+    registerRuntime(registration: {
+        readonly namespaceOwner: string;
+        readonly decl: RuntimeDecl;
+        readonly executor: McpExecutor;
+        readonly availability: RuntimeAvailability;
+        readonly scheme?: RuntimeSchemeFacet;
+    }): Promise<void>;
+}
+export interface ModuleOptions {
+    readonly env?: NodeJS.ProcessEnv;
+}
+export default class Module {
+    #private;
+    static init(options?: ModuleOptions): Module;
+    private constructor();
+    setup(seam: ModuleSetupSeam): Promise<void>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=Module.d.ts.map

package/dist/Module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Module.d.ts","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,mBAAmB,EACnB,WAAW,EACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACR,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,WAA4B,MAAM,kBAAkB,CAAC;AAG5D,UAAU,kBAAkB;IACxB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACvE,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1E;AAED,UAAU,eAAe;IACrB,eAAe,CAAC,YAAY,EAAE;QAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC/B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;QAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;KACxC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACpC;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;IAIvB,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAE/C;IAED,OAAO,eAEN;IAEK,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;CACJ"}

package/dist/Module.js

@@ -0,0 +1,55 @@
+import ServerConnection from "./client.js";
+import { serverConfig, serverNames } from "./config.js";
+import McpExecutor, { runtimeDecl } from "./McpExecutor.js";
+import McpResources from "./McpResources.js";
+export default class Module {
+    #env;
+    #connections = new Map();
+    static init(options = {}) {
+        return new Module(options.env ?? process.env);
+    }
+    constructor(environ) {
+        this.#env = environ;
+    }
+    async setup(seam) {
+        const results = await Promise.allSettled(serverNames(this.#env).map(async (name) => {
+            const config = serverConfig(name, this.#env);
+            if (config === null)
+                throw new Error(`MCP server '${name}' disappeared during configuration.`);
+            const connection = new ServerConnection(config, this.#env);
+            this.#connections.set(name, connection);
+            const decl = runtimeDecl(name);
+            const executor = new McpExecutor({
+                runtime: name,
+                glyph: decl.glyph ?? "",
+            }, connection);
+            return {
+                namespaceOwner: "@plurnk/plurnk-mcp",
+                decl,
+                executor,
+                availability: await executor.probe(),
+                scheme: new McpResources(name, connection),
+            };
+        }));
+        const errors = results
+            .filter((result) => result.status === "rejected")
+            .map((result) => result.reason);
+        if (errors.length > 0)
+            throw new AggregateError(errors, "MCP module setup failed");
+        const registrations = results.flatMap((result) => result.status === "fulfilled" ? [result.value] : []);
+        for (const registration of registrations) {
+            await seam.registerRuntime(registration);
+        }
+    }
+    async close() {
+        const connections = [...this.#connections.values()];
+        this.#connections.clear();
+        const results = await Promise.allSettled(connections.map((connection) => connection.close()));
+        const errors = results
+            .filter((result) => result.status === "rejected")
+            .map((result) => result.reason);
+        if (errors.length > 0)
+            throw new AggregateError(errors, "MCP connection shutdown failed");
+    }
+}
+//# sourceMappingURL=Module.js.map

package/dist/Module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Module.js","sourceRoot":"","sources":["../src/Module.ts"],"names":[],"mappings":"AAUA,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAsB7C,MAAM,CAAC,OAAO,OAAO,MAAM;IACd,IAAI,CAAoB;IACxB,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE5D,MAAM,CAAC,IAAI,CAAC,OAAO,GAAkB,EAAE;QACnC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,YAAoB,OAA0B;QAC1C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAqB;QAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACpC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,qCAAqC,CAAC,CAAC;YAC/F,MAAM,UAAU,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,WAAW,CAC5B;gBACI,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;aAC1B,EACD,UAAU,CACb,CAAC;YACF,OAAO;gBACH,cAAc,EAAE,oBAAoB;gBACpC,IAAI;gBACJ,QAAQ;gBACR,YAAY,EAAE,MAAM,QAAQ,CAAC,KAAK,EAAE;gBACpC,MAAM,EAAE,IAAI,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC;aAC7C,CAAC;QACN,CAAC,CAAC,CACL,CAAC;QACF,MAAM,MAAM,GAAG,OAAO;aACjB,MAAM,CAAC,CAAC,MAAM,EAAmC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC;aACjF,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACnF,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAC7C,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACvC,MAAM,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACpC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CACtD,CAAC;QACF,MAAM,MAAM,GAAG,OAAO;aACjB,MAAM,CAAC,CAAC,MAAM,EAAmC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC;aACjF,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IAC9F,CAAC;CACJ"}

package/dist/client.d.ts

@@ -0,0 +1,28 @@
+import { Client, type CallToolResult, type DiscoverResult, type ReadResourceResult, type Tool } from "@modelcontextprotocol/client";
+import { type ServerConfig } from "./config.ts";
+export declare const MCP_PROTOCOL_VERSION = "2026-07-28";
+export interface ServerCatalog {
+    readonly protocolVersion: typeof MCP_PROTOCOL_VERSION;
+    readonly server: ReturnType<Client["getServerVersion"]>;
+    readonly capabilities: DiscoverResult["capabilities"];
+    readonly tools: Awaited<ReturnType<Client["listTools"]>>["tools"];
+    readonly resources: Awaited<ReturnType<Client["listResources"]>>["resources"];
+    readonly resourceTemplates: Awaited<ReturnType<Client["listResourceTemplates"]>>["resourceTemplates"];
+    readonly prompts: Awaited<ReturnType<Client["listPrompts"]>>["prompts"];
+}
+export default class ServerConnection {
+    #private;
+    constructor(config: ServerConfig, environ?: NodeJS.ProcessEnv);
+    connect(): Promise<Client>;
+    readOnly(tool: string): boolean;
+    tools(signal?: AbortSignal): Promise<Tool[]>;
+    catalog(signal?: AbortSignal): Promise<ServerCatalog>;
+    resources(signal?: AbortSignal): Promise<{
+        resources: ServerCatalog["resources"];
+        resourceTemplates: ServerCatalog["resourceTemplates"];
+    }>;
+    callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<CallToolResult>;
+    readResource(uri: string, signal?: AbortSignal): Promise<ReadResourceResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,MAAM,EAEN,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,IAAI,EACZ,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EAGH,KAAK,YAAY,EACpB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,eAAe,EAAE,OAAO,oBAAoB,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC9E,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACtG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CAC3E;AAkED,MAAM,CAAC,OAAO,OAAO,gBAAgB;;IAMjC,YAAY,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,MAAM,CAAC,UAAwB,EAGzE;IAED,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAQzB;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9B;IAEK,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAOjD;IAEK,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA2B1D;IAEK,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAC3C,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;QACtC,iBAAiB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;KACzD,CAAC,CAmBD;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAKzG;IAEK,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAKjF;IASK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;CACJ"}

package/dist/client.js

@@ -0,0 +1,153 @@
+import { Client, StreamableHTTPClientTransport, } from "@modelcontextprotocol/client";
+import { StdioClientTransport, getDefaultEnvironment, } from "@modelcontextprotocol/client/stdio";
+import packageJson from "../package.json" with { type: "json" };
+import { connectTimeoutMs, requestTimeoutMs, } from "./config.js";
+export const MCP_PROTOCOL_VERSION = "2026-07-28";
+const openTransport = (config) => {
+    if (config.transport === "http") {
+        return new StreamableHTTPClientTransport(new URL(config.url), config.headers === undefined
+            ? undefined
+            : { requestInit: { headers: config.headers } });
+    }
+    return new StdioClientTransport({
+        command: config.command,
+        args: config.args,
+        cwd: config.cwd,
+        env: {
+            ...getDefaultEnvironment(),
+            ...config.env,
+        },
+    });
+};
+const openClient = async (config, environ) => {
+    const client = new Client({
+        name: packageJson.name,
+        version: packageJson.version,
+    }, {
+        versionNegotiation: {
+            mode: { pin: MCP_PROTOCOL_VERSION },
+        },
+        inputRequired: {
+            autoFulfill: false,
+        },
+    });
+    try {
+        await client.connect(openTransport(config), {
+            timeout: connectTimeoutMs(environ),
+        });
+    }
+    catch (cause) {
+        try {
+            await client.close();
+        }
+        catch (closeCause) {
+            throw new AggregateError([cause, closeCause], `MCP ${MCP_PROTOCOL_VERSION} connection and cleanup failed.`);
+        }
+        throw new Error(`MCP ${MCP_PROTOCOL_VERSION} connection failed.`, { cause });
+    }
+    if (client.getProtocolEra() !== "modern"
+        || client.getNegotiatedProtocolVersion() !== MCP_PROTOCOL_VERSION
+        || client.getDiscoverResult() === undefined) {
+        await client.close();
+        throw new Error(`MCP server did not negotiate required revision ${MCP_PROTOCOL_VERSION}.`);
+    }
+    return client;
+};
+export default class ServerConnection {
+    #config;
+    #environ;
+    #client;
+    #toolHints = new Map();
+    constructor(config, environ = process.env) {
+        this.#config = config;
+        this.#environ = environ;
+    }
+    connect() {
+        if (this.#client !== undefined)
+            return this.#client;
+        const pending = openClient(this.#config, this.#environ).catch((cause) => {
+            if (this.#client === pending)
+                this.#client = undefined;
+            throw cause;
+        });
+        this.#client = pending;
+        return pending;
+    }
+    readOnly(tool) {
+        return this.#toolHints.get(tool) === true;
+    }
+    async tools(signal) {
+        const client = await this.connect();
+        const { tools } = await client.listTools(undefined, this.#requestOptions(signal));
+        this.#toolHints = new Map(tools.map((tool) => [tool.name, tool.annotations?.readOnlyHint === true]));
+        return tools;
+    }
+    async catalog(signal) {
+        const client = await this.connect();
+        const discover = client.getDiscoverResult();
+        if (discover === undefined)
+            throw new Error("Modern MCP connection omitted its discovery result.");
+        const [tools, resources, resourceTemplates, prompts] = await Promise.all([
+            discover.capabilities.tools === undefined
+                ? Promise.resolve([])
+                : this.tools(signal),
+            discover.capabilities.resources === undefined
+                ? Promise.resolve([])
+                : client.listResources(undefined, this.#requestOptions(signal)).then((result) => result.resources),
+            discover.capabilities.resources === undefined
+                ? Promise.resolve([])
+                : client.listResourceTemplates(undefined, this.#requestOptions(signal)).then((result) => result.resourceTemplates),
+            discover.capabilities.prompts === undefined
+                ? Promise.resolve([])
+                : client.listPrompts(undefined, this.#requestOptions(signal)).then((result) => result.prompts),
+        ]);
+        return {
+            protocolVersion: MCP_PROTOCOL_VERSION,
+            server: client.getServerVersion(),
+            capabilities: discover.capabilities,
+            tools,
+            resources,
+            resourceTemplates,
+            prompts,
+        };
+    }
+    async resources(signal) {
+        const client = await this.connect();
+        const discover = client.getDiscoverResult();
+        if (discover?.capabilities.resources === undefined) {
+            return {
+                resources: [],
+                resourceTemplates: [],
+            };
+        }
+        const [resources, resourceTemplates] = await Promise.all([
+            client.listResources(undefined, this.#requestOptions(signal))
+                .then((result) => result.resources),
+            client.listResourceTemplates(undefined, this.#requestOptions(signal))
+                .then((result) => result.resourceTemplates),
+        ]);
+        return {
+            resources,
+            resourceTemplates,
+        };
+    }
+    async callTool(name, args, signal) {
+        return (await this.connect()).callTool({ name, arguments: args }, this.#requestOptions(signal));
+    }
+    async readResource(uri, signal) {
+        return (await this.connect()).readResource({ uri }, this.#requestOptions(signal));
+    }
+    #requestOptions(signal) {
+        return {
+            signal,
+            timeout: requestTimeoutMs(this.#environ),
+        };
+    }
+    async close() {
+        const client = this.#client;
+        this.#client = undefined;
+        if (client !== undefined)
+            await (await client).close();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+export interface StdioServerConfig {
+    readonly transport: "stdio";
+    readonly command: string;
+    readonly args: string[];
+    readonly cwd?: string;
+    readonly env?: Record<string, string>;
+}
+export interface HttpServerConfig {
+    readonly transport: "http";
+    readonly url: string;
+    readonly headers?: Record<string, string>;
+}
+export type ServerConfig = StdioServerConfig | HttpServerConfig;
+export declare const serverNames: (environ?: NodeJS.ProcessEnv) => string[];
+export declare const serverConfig: (name: string, environ?: NodeJS.ProcessEnv) => ServerConfig | null;
+export declare const connectTimeoutMs: (environ?: NodeJS.ProcessEnv) => number;
+export declare const requestTimeoutMs: (environ?: NodeJS.ProcessEnv) => number;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AA2FhE,eAAO,MAAM,WAAW,aAAa,MAAM,CAAC,UAAU,KAAiB,MAAM,EACjB,CAAC;AAE7D,eAAO,MAAM,YAAY,SACf,MAAM,YACH,MAAM,CAAC,UAAU,KAC3B,YAAY,GAAG,IAiCjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,aAAa,MAAM,CAAC,UAAU,KAAiB,MAO3E,CAAC;AAEF,eAAO,MAAM,gBAAgB,aAAa,MAAM,CAAC,UAAU,KAAiB,MAO3E,CAAC"}

package/dist/config.js

@@ -0,0 +1,134 @@
+const PREFIX = "PLURNK_MCP_";
+const COMPANION_SUFFIXES = ["_args", "_cwd", "_env", "_headers"];
+const CONTROL_KEYS = new Set(["connect_timeout", "request_timeout"]);
+const ENV_REFERENCE = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+const parseEnvironment = (environ) => {
+    const targets = new Map();
+    const companions = new Map();
+    for (const [key, value] of Object.entries(environ)) {
+        if (value === undefined || !key.startsWith(PREFIX))
+            continue;
+        const suffix = key.slice(PREFIX.length);
+        if (suffix.length === 0)
+            continue;
+        const folded = suffix.toLowerCase();
+        if (CONTROL_KEYS.has(folded))
+            continue;
+        const companion = COMPANION_SUFFIXES.find((candidate) => folded.endsWith(candidate));
+        if (companion !== undefined) {
+            const name = folded.slice(0, -companion.length);
+            const bySuffix = companions.get(name) ?? new Map();
+            if (bySuffix.has(companion)) {
+                throw new Error(`Duplicate MCP server companion for '${name}${companion}'.`);
+            }
+            bySuffix.set(companion, value);
+            companions.set(name, bySuffix);
+            continue;
+        }
+        if (targets.has(folded)) {
+            throw new Error(`Duplicate MCP server '${folded}': multiple ${PREFIX}* keys case-fold to the same name.`);
+        }
+        targets.set(folded, value);
+    }
+    for (const name of companions.keys()) {
+        if (!targets.has(name))
+            throw new Error(`MCP server companion '${name}' has no ${PREFIX}<server> target.`);
+    }
+    return { targets, companions };
+};
+const expandReferences = (value, environ, field) => value.replaceAll(ENV_REFERENCE, (_match, name) => {
+    const resolved = environ[name];
+    if (resolved === undefined)
+        throw new Error(`${field} references missing environment variable ${name}.`);
+    return resolved;
+});
+const jsonStrings = (raw, field, environ) => {
+    if (raw === undefined || raw.length === 0)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        throw new Error(`${field} must be a JSON array of strings.`, { cause });
+    }
+    if (!Array.isArray(parsed) || !parsed.every((value) => typeof value === "string")) {
+        throw new Error(`${field} must be a JSON array of strings.`);
+    }
+    return parsed.map((value) => expandReferences(value, environ, field));
+};
+const jsonRecord = (raw, field, environ) => {
+    if (raw === undefined || raw.length === 0)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        throw new Error(`${field} must be a JSON object with string values.`, { cause });
+    }
+    if (typeof parsed !== "object"
+        || parsed === null
+        || Array.isArray(parsed)
+        || !Object.values(parsed).every((value) => typeof value === "string")) {
+        throw new Error(`${field} must be a JSON object with string values.`);
+    }
+    return Object.fromEntries(Object.entries(parsed).map(([key, value]) => [
+        key,
+        expandReferences(value, environ, field),
+    ]));
+};
+export const serverNames = (environ = process.env) => [...parseEnvironment(environ).targets.keys()].toSorted();
+export const serverConfig = (name, environ = process.env) => {
+    const { targets, companions } = parseEnvironment(environ);
+    const folded = name.toLowerCase();
+    const target = targets.get(folded);
+    if (target === undefined)
+        return null;
+    if (target.length === 0)
+        throw new Error(`${PREFIX}${folded} must not be empty.`);
+    const fields = companions.get(folded);
+    const fieldName = (suffix) => `${PREFIX}${folded.toUpperCase()}${suffix.toUpperCase()}`;
+    if (/^https?:\/\//i.test(target)) {
+        if (fields?.has("_args") || fields?.has("_cwd") || fields?.has("_env")) {
+            throw new Error(`HTTP MCP server '${folded}' may declare only a _HEADERS companion.`);
+        }
+        return {
+            transport: "http",
+            url: target,
+            headers: jsonRecord(fields?.get("_headers"), fieldName("_headers"), environ),
+        };
+    }
+    if (/\s/.test(target)) {
+        throw new Error(`${PREFIX}${folded} must contain one executable; put arguments in ${fieldName("_args")}.`);
+    }
+    if (fields?.has("_headers")) {
+        throw new Error(`stdio MCP server '${folded}' may not declare a _HEADERS companion.`);
+    }
+    return {
+        transport: "stdio",
+        command: target,
+        args: jsonStrings(fields?.get("_args"), fieldName("_args"), environ),
+        cwd: fields?.has("_cwd")
+            ? expandReferences(fields.get("_cwd"), environ, fieldName("_cwd"))
+            : undefined,
+        env: jsonRecord(fields?.get("_env"), fieldName("_env"), environ),
+    };
+};
+export const connectTimeoutMs = (environ = process.env) => {
+    const raw = environ.PLURNK_MCP_CONNECT_TIMEOUT;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 1) {
+        throw new Error(`PLURNK_MCP_CONNECT_TIMEOUT must be a positive integer; got ${JSON.stringify(raw)}.`);
+    }
+    return value;
+};
+export const requestTimeoutMs = (environ = process.env) => {
+    const raw = environ.PLURNK_MCP_REQUEST_TIMEOUT;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 1) {
+        throw new Error(`PLURNK_MCP_REQUEST_TIMEOUT must be a positive integer; got ${JSON.stringify(raw)}.`);
+    }
+    return value;
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { default as Module } from "./Module.ts";
+export { default } from "./Module.ts";
+export { MCP_PROTOCOL_VERSION } from "./client.ts";
+export { connectTimeoutMs, requestTimeoutMs, serverConfig, serverNames, } from "./config.ts";
+export type { HttpServerConfig, ServerConfig, StdioServerConfig, } from "./config.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACR,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GACpB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { default as Module } from "./Module.js";
+export { default } from "./Module.js";
+export { MCP_PROTOCOL_VERSION } from "./client.js";
+export { connectTimeoutMs, requestTimeoutMs, serverConfig, serverNames, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACd,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+    "name": "@plurnk/plurnk-mcp",
+    "version": "1.4.0",
+    "description": "Current Model Context Protocol host module for Plurnk.",
+    "keywords": [
+        "plurnk",
+        "exec",
+        "runtime",
+        "executor",
+        "mcp",
+        "model-context-protocol"
+    ],
+    "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-mcp#readme",
+    "bugs": {
+        "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-service.git",
+        "directory": "plurnk-mcp"
+    },
+    "engines": {
+        "node": ">=26"
+    },
+    "license": "MIT",
+    "author": "@wikitopian",
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": {
+        ".": {
+            "plurnk-dev": "./src/index.ts",
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        "SPEC.md",
+        "docs/**/*",
+        ".env.defaults"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --conditions=plurnk-dev --env-file-if-exists=../plurnk-execs/.env.defaults --test \"src/**/*.test.ts\"",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:clean": "rm -rf dist",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:clean && npm run build:dist",
+        "prepack": "npm run build",
+        "prepublishOnly": "npm audit --audit-level=moderate && npm test"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/client": "2.0.0"
+    },
+    "devDependencies": {
+        "@modelcontextprotocol/server": "2.0.0"
+    },
+    "peerDependencies": {
+        "@plurnk/plurnk-execs": "^1.4.0",
+        "@plurnk/plurnk-schemes": "^1.4.0"
+    }
+}