@cyanmycelium/mcp-broker 0.1.0

package/dist/bin.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+/**
+ * Standalone entry-point that starts the mcp-broker WebSocket server.
+ *
+ * ## Configuration sources (highest priority first)
+ *
+ * 1. Environment variables (`MCP_BROKER_*`).
+ * 2. JSON config file. Resolved in order:
+ *    a. `MCP_BROKER_CONFIG` env var.
+ *    b. `./.mcp-broker/config.json` in the current working directory.
+ *    c. `./mcp-broker.config.json` (legacy, with a deprecation warning).
+ * 3. Built-in defaults.
+ *
+ * ## Path resolution
+ *
+ * - Env-var paths (`MCP_BROKER_*_DIR`, `MCP_BROKER_TLS_*`) are resolved
+ *   against `process.cwd()`.
+ * - Config-file paths (`tls.cert`, `www.mounts[*].dir`, `stdioUpstreams[*]`)
+ *   are resolved against the **config file's directory** — so a config in
+ *   `./.mcp-broker/config.json` referring to `"certs/cert.pem"` points at
+ *   `./.mcp-broker/certs/cert.pem`. The folder is self-contained.
+ *
+ * ## Local grammar overrides
+ *
+ * When `.mcp-broker/grammars/<userAgent>/<locale>.json` files exist next to
+ * the config file, they are merged **on top of** the packaged grammars. Lets
+ * users customize tool/resource descriptions for their organization without
+ * forking the package.
+ *
+ * ## Environment variables
+ *
+ * | Variable                       | Default  | Notes                                                  |
+ * |--------------------------------|----------|--------------------------------------------------------|
+ * | MCP_BROKER_CONFIG              | (none)   | Path to a JSON config file (see above).                |
+ * | MCP_BROKER_PORT                | 3000     |                                                        |
+ * | MCP_BROKER_HOST                | 0.0.0.0  |                                                        |
+ * | MCP_BROKER_PROVIDER_PATH       | /provider| Prefix for provider WS                                 |
+ * | MCP_BROKER_CLIENT_PATH         | /        | Prefix for raw WS clients                              |
+ * | MCP_BROKER_MCP_PATH            | /mcp     | Suffix for Streamable HTTP transport                   |
+ * | MCP_BROKER_WWW_DIR             | (none)   | Ergonomic shortcut: mount this directory at "/"        |
+ * | MCP_BROKER_BUNDLE_DIR          | (none)   | Ergonomic shortcut: mount this directory at "/bundle"  |
+ * | MCP_BROKER_OPEN                | (unset)  | "1" to auto-launch the default browser at the root URL |
+ * | MCP_BROKER_TLS_CERT            | (none)   | Path to a PEM TLS certificate                          |
+ * | MCP_BROKER_TLS_KEY             | (none)   | Path to a PEM private key                              |
+ * | MCP_BROKER_PROTOCOL            | auto     | "http" to force plain, "https" to force TLS, otherwise |
+ * |                                |          | TLS is enabled iff cert+key are both set               |
+ * | MCP_BROKER_STDIO_PROVIDER      | (none)   | When set, stdin/stdout carry JSON-RPC for the named    |
+ * |                                |          | provider (Claude Desktop bridge).                      |
+ * | MCP_BROKER_LOCALE              | en       | Locale used for tool descriptions on the `_broker`     |
+ * |                                |          | slot. ISO 639-1 base; regional variants accepted.      |
+ */
+import * as fs from "fs";
+import * as path from "path";
+import open from "open";
+import { WsTunnelBuilder } from "./index.js";
+import { loadBrokerConfig } from "./config.js";
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const { config, baseDir } = loadBrokerConfig();
+const cwd = process.cwd();
+/**
+ * Fills an env var from the config file when the env var is not already set.
+ * Used for **non-path** scalars — path-bearing fields are read directly so
+ * they can be resolved against `baseDir` (config file's directory) instead
+ * of `cwd` (deploy environment).
+ */
+function envFromConfig(envName, configValue) {
+    if (configValue === undefined || configValue === null)
+        return;
+    if (process.env[envName] !== undefined && process.env[envName] !== "")
+        return;
+    process.env[envName] = String(configValue);
+}
+envFromConfig("MCP_BROKER_PORT", config.port);
+envFromConfig("MCP_BROKER_HOST", config.host);
+envFromConfig("MCP_BROKER_PROTOCOL", config.protocol);
+envFromConfig("MCP_BROKER_LOCALE", config.locale);
+envFromConfig("MCP_BROKER_STDIO_PROVIDER", config.stdioProvider);
+envFromConfig("MCP_BROKER_PROVIDER_PATH", config.paths?.provider);
+envFromConfig("MCP_BROKER_CLIENT_PATH", config.paths?.client);
+envFromConfig("MCP_BROKER_MCP_PATH", config.paths?.mcp);
+envFromConfig("MCP_BROKER_OPEN", config.www?.open === true ? "1" : undefined);
+const stdioProvider = process.env["MCP_BROKER_STDIO_PROVIDER"];
+// In stdio mode stdout is reserved for JSON-RPC — redirect all console output to stderr.
+if (stdioProvider) {
+    const toStderr = (...args) => process.stderr.write(args.join(" ") + "\n");
+    console.log = toStderr;
+    console.info = toStderr;
+    console.warn = toStderr;
+    console.error = toStderr;
+}
+const port = parseInt(process.env["MCP_BROKER_PORT"] ?? "3000", 10);
+const host = process.env["MCP_BROKER_HOST"];
+const providerPath = process.env["MCP_BROKER_PROVIDER_PATH"] ?? "/provider";
+const clientPath = process.env["MCP_BROKER_CLIENT_PATH"] ?? "/";
+const mcpPath = process.env["MCP_BROKER_MCP_PATH"] ?? "/mcp";
+const ssePath = config.paths?.sse ?? "/sse";
+// ── TLS material ─────────────────────────────────────────────────────────────
+// Env var (relative to cwd) wins over config (relative to baseDir).
+const tlsCertPath = process.env["MCP_BROKER_TLS_CERT"] ? path.resolve(cwd, process.env["MCP_BROKER_TLS_CERT"]) : config.tls?.cert ? path.resolve(baseDir, config.tls.cert) : null;
+const tlsKeyPath = process.env["MCP_BROKER_TLS_KEY"] ? path.resolve(cwd, process.env["MCP_BROKER_TLS_KEY"]) : config.tls?.key ? path.resolve(baseDir, config.tls.key) : null;
+const protocolOverride = process.env["MCP_BROKER_PROTOCOL"]?.toLowerCase();
+if (protocolOverride !== undefined && protocolOverride !== "http" && protocolOverride !== "https") {
+    console.error(`[mcp-broker] Invalid MCP_BROKER_PROTOCOL="${protocolOverride}". Use "http" or "https".`);
+    process.exit(1);
+}
+if (protocolOverride === "https" && (!tlsCertPath || !tlsKeyPath)) {
+    console.error("[mcp-broker] MCP_BROKER_PROTOCOL=https requires TLS cert+key (via config.tls or MCP_BROKER_TLS_CERT/KEY).");
+    process.exit(1);
+}
+const useTls = protocolOverride === "http" ? false : protocolOverride === "https" ? true : !!(tlsCertPath && tlsKeyPath);
+// ── Env-var static mount shortcuts (relative to cwd) ─────────────────────────
+const envWwwDir = process.env["MCP_BROKER_WWW_DIR"] ? path.resolve(cwd, process.env["MCP_BROKER_WWW_DIR"]) : null;
+const envBundleDir = process.env["MCP_BROKER_BUNDLE_DIR"] ? path.resolve(cwd, process.env["MCP_BROKER_BUNDLE_DIR"]) : null;
+// ---------------------------------------------------------------------------
+// Server bootstrap
+// ---------------------------------------------------------------------------
+async function main() {
+    // Local grammar overrides: when `<baseDir>/grammars/` exists, the broker
+    // server merges those JSON files on top of the packaged grammars.
+    const localGrammarsDir = path.join(baseDir, "grammars");
+    const hasLocalGrammars = fs.existsSync(localGrammarsDir);
+    const builder = new WsTunnelBuilder().withPort(port).withProviderPath(providerPath).withClientPath(clientPath).withMcpPath(mcpPath);
+    if (host) {
+        builder.withHost(host);
+    }
+    if (useTls) {
+        builder.withTlsFiles(tlsCertPath, tlsKeyPath);
+    }
+    // ── Static mounts ────────────────────────────────────────────────────────
+    // First the env-var shortcuts (relative to cwd), then the config `www.mounts`
+    // (relative to baseDir). Order matters: /bundle before / so the prefix router
+    // can distinguish them. Subsequent registrations contribute additional mounts;
+    // longest-prefix match wins at runtime.
+    if (envBundleDir && fs.existsSync(envBundleDir)) {
+        builder.withStaticMount("/bundle", envBundleDir);
+    }
+    if (envWwwDir && fs.existsSync(envWwwDir)) {
+        builder.withStaticMount("/", envWwwDir);
+    }
+    if (config.www?.mounts) {
+        for (const mount of config.www.mounts) {
+            const abs = path.resolve(baseDir, mount.dir);
+            if (fs.existsSync(abs)) {
+                builder.withStaticMount(mount.urlPrefix, abs);
+            }
+            else {
+                console.warn(`[mcp-broker] www.mounts entry "${mount.urlPrefix}" → ${abs} skipped (directory not found).`);
+            }
+        }
+    }
+    // ── Stdio upstreams ──────────────────────────────────────────────────────
+    if (config.stdioUpstreams) {
+        for (const u of config.stdioUpstreams) {
+            builder.withStdioUpstream(u.name, u.command, u.args, u.env);
+        }
+    }
+    if (stdioProvider) {
+        builder.withStdioClient(stdioProvider);
+    }
+    if (hasLocalGrammars) {
+        builder.withBrokerLocalGrammarsDir(localGrammarsDir);
+    }
+    const tunnel = builder.build();
+    await tunnel.start();
+    // ── Startup banner ──────────────────────────────────────────────────────
+    const httpScheme = useTls ? "https" : "http";
+    const wsScheme = useTls ? "wss" : "ws";
+    const hr = "─".repeat(64);
+    const localhost = `${httpScheme}://localhost:${port}`;
+    const mcpSuffix = mcpPath.replace(/^\//, "");
+    const sseSuffix = ssePath.replace(/^\//, "");
+    const hasWwwRoot = !!(envWwwDir && fs.existsSync(envWwwDir)) || (config.www?.mounts ?? []).some((m) => m.urlPrefix === "/");
+    console.log();
+    console.log(`⚙️  mcp-broker started${useTls ? " (TLS)" : ""}`);
+    console.log(hr);
+    console.log(`📡  Provider WebSocket    ${wsScheme}://localhost:${port}${providerPath}/<name>`);
+    console.log(`🔌  MCP (Streamable HTTP) ${localhost}/<name>/${mcpSuffix}`);
+    console.log(`📺  Legacy SSE            ${localhost}/<name>/${sseSuffix}`);
+    if (hasLocalGrammars) {
+        console.log(`🌐  Local grammars        ${localGrammarsDir}`);
+    }
+    console.log(hr);
+    console.log(`   Press Ctrl+C to stop.`);
+    console.log();
+    // Auto-launch browser only if explicitly opted in via MCP_BROKER_OPEN=1
+    // AND a mount at "/" is configured.
+    if (hasWwwRoot && process.env["MCP_BROKER_OPEN"] === "1") {
+        const url = `${localhost}/`;
+        console.log(`🚀  Opening browser: ${url}`);
+        console.log();
+        await open(url);
+    }
+    // ── Signal handlers ─────────────────────────────────────────────────────
+    const shutdown = async (signal) => {
+        console.log(`\n⛔  ${signal} received — shutting down…`);
+        await tunnel.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+}
+main().catch((err) => {
+    console.error("[mcp-broker] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/broker/adapters/broker.adapter.info.d.ts

@@ -0,0 +1,16 @@
+import { McpAdapterBase } from "@cyanmycelium/mcp-core";
+import type { McpResourceContent, McpToolResult } from "@cyanmycelium/mcp-core";
+import type { BrokerContext } from "../broker.context.js";
+/** URI of the static resource backing the `broker_info` snapshot. */
+export declare const BROKER_INFO_URI = "broker://info";
+/**
+ * Read-only adapter that produces a snapshot of the broker's identity and
+ * configuration. Backed by the live {@link BrokerContext}.
+ */
+export declare class BrokerInfoAdapter extends McpAdapterBase {
+    private readonly _context;
+    constructor(_context: BrokerContext);
+    readResourceAsync(uri: string): Promise<McpResourceContent | undefined>;
+    executeToolAsync(_uri: string, toolName: string, _args: Record<string, unknown>): Promise<McpToolResult>;
+    private _snapshot;
+}

package/dist/broker/adapters/broker.adapter.info.js

@@ -0,0 +1,43 @@
+import { McpAdapterBase, McpToolResults } from "@cyanmycelium/mcp-core";
+/** URI of the static resource backing the `broker_info` snapshot. */
+export const BROKER_INFO_URI = "broker://info";
+/**
+ * Read-only adapter that produces a snapshot of the broker's identity and
+ * configuration. Backed by the live {@link BrokerContext}.
+ */
+export class BrokerInfoAdapter extends McpAdapterBase {
+    _context;
+    constructor(_context) {
+        super("broker");
+        this._context = _context;
+    }
+    async readResourceAsync(uri) {
+        if (uri !== BROKER_INFO_URI)
+            return undefined;
+        return {
+            uri,
+            mimeType: "application/json",
+            text: JSON.stringify(this._snapshot()),
+        };
+    }
+    async executeToolAsync(_uri, toolName, _args) {
+        if (toolName !== "broker_info") {
+            return McpToolResults.error(`Unknown tool: ${toolName}`);
+        }
+        return McpToolResults.json(this._snapshot());
+    }
+    _snapshot() {
+        const c = this._context;
+        return {
+            name: c.name,
+            version: c.version,
+            startedAt: c.startedAt?.toISOString() ?? null,
+            uptimeSeconds: c.uptimeSeconds,
+            host: c.host ?? "0.0.0.0",
+            port: c.port,
+            tls: c.tls,
+            paths: c.paths,
+        };
+    }
+}
+//# sourceMappingURL=broker.adapter.info.js.map

package/dist/broker/adapters/broker.adapter.info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.adapter.info.js","sourceRoot":"","sources":["../../../src/broker/adapters/broker.adapter.info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxE,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACpB;IAA7B,YAA6B,QAAuB;QAChD,KAAK,CAAC,QAAQ,CAAC,CAAC;QADS,aAAQ,GAAR,QAAQ,CAAe;IAEpD,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,GAAW;QACtC,IAAI,GAAG,KAAK,eAAe;YAAE,OAAO,SAAS,CAAC;QAC9C,OAAO;YACH,GAAG;YACH,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;SACzC,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,KAA8B;QACxF,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC7B,OAAO,cAAc,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACjD,CAAC;IAEO,SAAS;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,OAAO;YACH,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;YAC7C,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;YACzB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;SACjB,CAAC;IACN,CAAC;CACJ"}

package/dist/broker/adapters/broker.adapter.providers.d.ts

@@ -0,0 +1,18 @@
+import { McpAdapterBase } from "@cyanmycelium/mcp-core";
+import type { McpResourceContent, McpToolResult } from "@cyanmycelium/mcp-core";
+import type { BrokerContext } from "../broker.context.js";
+/** URI of the static resource that lists every provider slot. */
+export declare const PROVIDERS_URI = "broker://providers";
+/** RFC 6570 URI template for one specific provider slot. */
+export declare const PROVIDER_URI_TEMPLATE = "broker://providers/{name}";
+/**
+ * Adapter that exposes the broker's current provider slots, both as a list
+ * (read of `broker://providers`) and individually (`broker://providers/<name>`).
+ */
+export declare class BrokerProvidersAdapter extends McpAdapterBase {
+    private readonly _context;
+    constructor(_context: BrokerContext);
+    readResourceAsync(uri: string): Promise<McpResourceContent | undefined>;
+    executeToolAsync(_uri: string, toolName: string, args: Record<string, unknown>): Promise<McpToolResult>;
+    private _listSnapshot;
+}

package/dist/broker/adapters/broker.adapter.providers.js

@@ -0,0 +1,61 @@
+import { McpAdapterBase, McpToolResults } from "@cyanmycelium/mcp-core";
+/** URI of the static resource that lists every provider slot. */
+export const PROVIDERS_URI = "broker://providers";
+/** RFC 6570 URI template for one specific provider slot. */
+export const PROVIDER_URI_TEMPLATE = "broker://providers/{name}";
+/**
+ * Adapter that exposes the broker's current provider slots, both as a list
+ * (read of `broker://providers`) and individually (`broker://providers/<name>`).
+ */
+export class BrokerProvidersAdapter extends McpAdapterBase {
+    _context;
+    constructor(_context) {
+        super("broker");
+        this._context = _context;
+    }
+    async readResourceAsync(uri) {
+        if (uri === PROVIDERS_URI) {
+            return {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(this._listSnapshot()),
+            };
+        }
+        // broker://providers/<name>
+        const match = /^broker:\/\/providers\/([^/]+)$/.exec(uri);
+        if (match) {
+            const name = decodeURIComponent(match[1]);
+            const info = this._context.getProviderInfo(name);
+            if (!info)
+                return undefined;
+            return {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(info),
+            };
+        }
+        return undefined;
+    }
+    async executeToolAsync(_uri, toolName, args) {
+        switch (toolName) {
+            case "providers_list":
+                return McpToolResults.json(this._listSnapshot());
+            case "provider_status": {
+                const name = typeof args.name === "string" ? args.name : "";
+                if (!name)
+                    return McpToolResults.error('Missing required argument: "name" (string).');
+                const info = this._context.getProviderInfo(name);
+                if (!info)
+                    return McpToolResults.error(`Unknown provider: "${name}".`);
+                return McpToolResults.json(info);
+            }
+            default:
+                return McpToolResults.error(`Unknown tool: ${toolName}`);
+        }
+    }
+    _listSnapshot() {
+        const providers = this._context.getProvidersInfo();
+        return { count: providers.length, providers };
+    }
+}
+//# sourceMappingURL=broker.adapter.providers.js.map

package/dist/broker/adapters/broker.adapter.providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.adapter.providers.js","sourceRoot":"","sources":["../../../src/broker/adapters/broker.adapter.providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxE,iEAAiE;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAElD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AAEjE;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACzB;IAA7B,YAA6B,QAAuB;QAChD,KAAK,CAAC,QAAQ,CAAC,CAAC;QADS,aAAQ,GAAR,QAAQ,CAAe;IAEpD,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,GAAW;QACtC,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;YACxB,OAAO;gBACH,GAAG;gBACH,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;aAC7C,CAAC;QACN,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,OAAO;gBACH,GAAG;gBACH,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC7B,CAAC;QACN,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,IAA6B;QACvF,QAAQ,QAAQ,EAAE,CAAC;YACf,KAAK,gBAAgB;gBACjB,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;YAErD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACrB,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC,IAAI;oBAAE,OAAO,cAAc,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;gBACtF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,IAAI;oBAAE,OAAO,cAAc,CAAC,KAAK,CAAC,sBAAsB,IAAI,IAAI,CAAC,CAAC;gBACvE,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;YAED;gBACI,OAAO,cAAc,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAEO,aAAa;QACjB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAClD,CAAC;CACJ"}

package/dist/broker/behaviors/broker.behavior.info.d.ts

@@ -0,0 +1,15 @@
+import { McpBehavior } from "@cyanmycelium/mcp-core";
+import type { McpResource, McpTool } from "@cyanmycelium/mcp-core";
+import type { BrokerContext } from "../broker.context.js";
+/**
+ * Exposes basic broker identity (name, version, uptime, listening config) as
+ * one tool (`broker_info`) and one resource (`broker://info`).
+ *
+ * An MCP agent typically calls `broker_info` first to learn who it is talking to.
+ */
+export declare class BrokerInfoBehavior extends McpBehavior {
+    static readonly NAMESPACE = "broker";
+    constructor(context: BrokerContext);
+    protected _buildResources(): McpResource[];
+    protected _buildTools(): McpTool[];
+}

package/dist/broker/behaviors/broker.behavior.info.js

@@ -0,0 +1,41 @@
+import { McpBehavior } from "@cyanmycelium/mcp-core";
+import { BROKER_INFO_URI, BrokerInfoAdapter } from "../adapters/broker.adapter.info.js";
+import { brokerBaselineResourceDescription, brokerBaselineResourceName, brokerBaselineToolDescription } from "../broker.grammars.js";
+/**
+ * Exposes basic broker identity (name, version, uptime, listening config) as
+ * one tool (`broker_info`) and one resource (`broker://info`).
+ *
+ * An MCP agent typically calls `broker_info` first to learn who it is talking to.
+ */
+export class BrokerInfoBehavior extends McpBehavior {
+    static NAMESPACE = "broker";
+    constructor(context) {
+        super(new BrokerInfoAdapter(context), {
+            namespace: BrokerInfoBehavior.NAMESPACE,
+        });
+    }
+    _buildResources() {
+        return [
+            {
+                uri: BROKER_INFO_URI,
+                name: brokerBaselineResourceName(BROKER_INFO_URI),
+                mimeType: "application/json",
+                description: brokerBaselineResourceDescription(BROKER_INFO_URI),
+            },
+        ];
+    }
+    _buildTools() {
+        return [
+            {
+                name: "broker_info",
+                description: brokerBaselineToolDescription("broker_info"),
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    additionalProperties: false,
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=broker.behavior.info.js.map

package/dist/broker/behaviors/broker.behavior.info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.behavior.info.js","sourceRoot":"","sources":["../../../src/broker/behaviors/broker.behavior.info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,iCAAiC,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAGrI;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACxC,MAAM,CAAU,SAAS,GAAG,QAAQ,CAAC;IAE5C,YAAY,OAAsB;QAC9B,KAAK,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE;YAClC,SAAS,EAAE,kBAAkB,CAAC,SAAS;SAC1C,CAAC,CAAC;IACP,CAAC;IAEkB,eAAe;QAC9B,OAAO;YACH;gBACI,GAAG,EAAE,eAAe;gBACpB,IAAI,EAAE,0BAA0B,CAAC,eAAe,CAAC;gBACjD,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,iCAAiC,CAAC,eAAe,CAAC;aAClE;SACJ,CAAC;IACN,CAAC;IAEkB,WAAW;QAC1B,OAAO;YACH;gBACI,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,6BAA6B,CAAC,aAAa,CAAC;gBACzD,WAAW,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,oBAAoB,EAAE,KAAK;iBAC9B;aACJ;SACJ,CAAC;IACN,CAAC"}

package/dist/broker/behaviors/broker.behavior.providers.d.ts

@@ -0,0 +1,19 @@
+import { McpBehavior } from "@cyanmycelium/mcp-core";
+import type { McpResource, McpResourceTemplate, McpTool } from "@cyanmycelium/mcp-core";
+import type { BrokerContext } from "../broker.context.js";
+/**
+ * Exposes the broker's provider slots so an MCP agent can discover what is
+ * currently routable behind the broker, with two tools:
+ *
+ * - `providers_list` — every slot (including disconnected ones).
+ * - `provider_status({ name })` — detail on one slot.
+ *
+ * Plus matching resources at `broker://providers` and `broker://providers/<name>`.
+ */
+export declare class BrokerProvidersBehavior extends McpBehavior {
+    static readonly NAMESPACE = "broker_providers";
+    constructor(context: BrokerContext);
+    protected _buildResources(): McpResource[];
+    protected _buildTemplate(): McpResourceTemplate[];
+    protected _buildTools(): McpTool[];
+}

package/dist/broker/behaviors/broker.behavior.providers.js

@@ -0,0 +1,69 @@
+import { McpBehavior } from "@cyanmycelium/mcp-core";
+import { BrokerProvidersAdapter, PROVIDERS_URI, PROVIDER_URI_TEMPLATE } from "../adapters/broker.adapter.providers.js";
+import { brokerBaselinePropertyDescription, brokerBaselineResourceDescription, brokerBaselineResourceName, brokerBaselineResourceTemplateDescription, brokerBaselineResourceTemplateName, brokerBaselineToolDescription, } from "../broker.grammars.js";
+/**
+ * Exposes the broker's provider slots so an MCP agent can discover what is
+ * currently routable behind the broker, with two tools:
+ *
+ * - `providers_list` — every slot (including disconnected ones).
+ * - `provider_status({ name })` — detail on one slot.
+ *
+ * Plus matching resources at `broker://providers` and `broker://providers/<name>`.
+ */
+export class BrokerProvidersBehavior extends McpBehavior {
+    static NAMESPACE = "broker_providers";
+    constructor(context) {
+        super(new BrokerProvidersAdapter(context), {
+            namespace: BrokerProvidersBehavior.NAMESPACE,
+        });
+    }
+    _buildResources() {
+        return [
+            {
+                uri: PROVIDERS_URI,
+                name: brokerBaselineResourceName(PROVIDERS_URI),
+                mimeType: "application/json",
+                description: brokerBaselineResourceDescription(PROVIDERS_URI),
+            },
+        ];
+    }
+    _buildTemplate() {
+        return [
+            {
+                uriTemplate: PROVIDER_URI_TEMPLATE,
+                name: brokerBaselineResourceTemplateName(PROVIDER_URI_TEMPLATE),
+                mimeType: "application/json",
+                description: brokerBaselineResourceTemplateDescription(PROVIDER_URI_TEMPLATE),
+            },
+        ];
+    }
+    _buildTools() {
+        return [
+            {
+                name: "providers_list",
+                description: brokerBaselineToolDescription("providers_list"),
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    additionalProperties: false,
+                },
+            },
+            {
+                name: "provider_status",
+                description: brokerBaselineToolDescription("provider_status"),
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: brokerBaselinePropertyDescription("provider_status", "name"),
+                        },
+                    },
+                    required: ["name"],
+                    additionalProperties: false,
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=broker.behavior.providers.js.map

package/dist/broker/behaviors/broker.behavior.providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.behavior.providers.js","sourceRoot":"","sources":["../../../src/broker/behaviors/broker.behavior.providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACvH,OAAO,EACH,iCAAiC,EACjC,iCAAiC,EACjC,0BAA0B,EAC1B,yCAAyC,EACzC,kCAAkC,EAClC,6BAA6B,GAChC,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IAC7C,MAAM,CAAU,SAAS,GAAG,kBAAkB,CAAC;IAEtD,YAAY,OAAsB;QAC9B,KAAK,CAAC,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE;YACvC,SAAS,EAAE,uBAAuB,CAAC,SAAS;SAC/C,CAAC,CAAC;IACP,CAAC;IAEkB,eAAe;QAC9B,OAAO;YACH;gBACI,GAAG,EAAE,aAAa;gBAClB,IAAI,EAAE,0BAA0B,CAAC,aAAa,CAAC;gBAC/C,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,iCAAiC,CAAC,aAAa,CAAC;aAChE;SACJ,CAAC;IACN,CAAC;IAEkB,cAAc;QAC7B,OAAO;YACH;gBACI,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,kCAAkC,CAAC,qBAAqB,CAAC;gBAC/D,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,yCAAyC,CAAC,qBAAqB,CAAC;aAChF;SACJ,CAAC;IACN,CAAC;IAEkB,WAAW;QAC1B,OAAO;YACH;gBACI,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,6BAA6B,CAAC,gBAAgB,CAAC;gBAC5D,WAAW,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,oBAAoB,EAAE,KAAK;iBAC9B;aACJ;YACD;gBACI,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,6BAA6B,CAAC,iBAAiB,CAAC;gBAC7D,WAAW,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACR,IAAI,EAAE;4BACF,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iCAAiC,CAAC,iBAAiB,EAAE,MAAM,CAAC;yBAC5E;qBACJ;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;oBAClB,oBAAoB,EAAE,KAAK;iBAC9B;aACJ;SACJ,CAAC;IACN,CAAC"}

package/dist/broker/broker.context.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Read-only view of the broker's runtime state, exposed to broker behaviors.
+ *
+ * Decouples the behaviors from the concrete `WsTunnel` class, making them
+ * unit-testable and reusable (e.g. a future .NET-backed context).
+ */
+export interface BrokerContext {
+    /** Package version (from package.json). */
+    readonly version: string;
+    /** Logical broker name reported to MCP clients. */
+    readonly name: string;
+    /** Timestamp of the most recent successful `start()`, or `null` if never started. */
+    readonly startedAt: Date | null;
+    /** Seconds since `startedAt`, or `0` if not running. */
+    readonly uptimeSeconds: number;
+    /** Bind host. `undefined` means default (`0.0.0.0`). */
+    readonly host: string | undefined;
+    /** TCP port the broker is listening on. */
+    readonly port: number;
+    /** Whether TLS is active for the HTTP/WS server. */
+    readonly tls: boolean;
+    /** All configured URL paths, with defaults already substituted. */
+    readonly paths: {
+        provider: string;
+        providers: string;
+        client: string;
+        mcp: string;
+        sse: string;
+        messages: string;
+    };
+    /** Snapshot of every known provider slot, including disconnected ones. */
+    getProvidersInfo(): BrokerProviderInfo[];
+    /** Snapshot of a single provider slot, or `undefined` if the name is unknown. */
+    getProviderInfo(name: string): BrokerProviderInfo | undefined;
+}
+/**
+ * Transport kind currently feeding a provider slot.
+ *
+ * - `ws`: dedicated WebSocket provider (`/provider/<name>`).
+ * - `ws-multiplex`: multiplexed WebSocket envelope on `/providers`.
+ * - `stdio`: child process spawned at broker startup.
+ * - `loopback`: in-process transport (e.g. the broker exposing itself as `_broker`).
+ * - `none`: the slot was referenced by a client but no provider has attached yet.
+ */
+export type BrokerProviderTransport = "ws" | "ws-multiplex" | "stdio" | "loopback" | "none";
+export interface BrokerProviderInfo {
+    /** Slot name as advertised on `/<name>/...` endpoints. */
+    name: string;
+    /** Which transport is currently feeding the slot. */
+    transport: BrokerProviderTransport;
+    /** `true` iff the slot is reachable for routing right now. */
+    connected: boolean;
+    /** Number of raw-WebSocket MCP clients on this slot. */
+    clientCount: number;
+    /** Number of long-lived sessions (SSE + Streamable HTTP GET streams). */
+    sessionCount: number;
+    /** Number of in-flight JSON-RPC requests awaiting a response. */
+    pendingCount: number;
+}

package/dist/broker/broker.context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=broker.context.js.map

package/dist/broker/broker.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.context.js","sourceRoot":"","sources":["../../src/broker/broker.context.ts"],"names":[],"mappings":""}