@cyanmycelium/mcp-broker 1.3.0 → 1.3.2

package/README.md

@@ -232,12 +232,22 @@ Each provider entry from `providers_list` / `provider_status`:
     "name": "weather",
     "transport": "ws",
     "connected": true,
+    "aggregate": true,
+    "connectedSince": "2026-09-14T08:12:03.417Z",
+    "connectedForMs": 184211,
     "clientCount": 0,
     "sessionCount": 1,
     "pendingCount": 0
 }
 ```
 
+- The first six fields are about the **provider**: whether something serves
+  the slot, over what, whether it is in `_all`, and since when. A
+  `connectedSince` that is always a few seconds old is a provider that keeps
+  reconnecting.
+- The three counts are about the slot's **callers**. A connected provider that
+  nobody is calling right now reads `clientCount: 0, sessionCount: 0,
+  pendingCount: 0`; that is not a fault.
 - `transport` is `ws` (dedicated socket), `ws-multiplex` (shared socket),
   `stdio` (**any** configured upstream: a child process from `stdioUpstreams`,
   a `.mcpb` bundle, *or* a remote URL from `mcpServers`), `loopback`
@@ -720,6 +730,30 @@ npm start          # node dist/bin.js
 
 Requires Node 20.11+.
 
+### Running the broker of this checkout
+
+`npm start` runs `dist/bin.js`, the code of the working tree once `npm run
+build` has been run (from `node/`, which builds the provider package first).
+It reads `.mcp-broker/config.json` next to `package.json` when there is one;
+that folder is gitignored, so each checkout keeps its own. A config that makes
+the broker reachable from a device on the LAN and serves this package's `web/`
+(the broker explorer at `/demos/broker-explorer/`) from the same port:
+
+```json
+{
+    "port": 3000,
+    "host": "0.0.0.0",
+    "www": { "open": false, "mounts": [{ "urlPrefix": "/", "dir": "../web" }] },
+    "allowedOrigins": ["http://localhost:3000", "http://127.0.0.1:3000"]
+}
+```
+
+Paths in the file resolve against the file's own directory, hence `../web`.
+Keep the terminal open: the process lives as long as it does. Without the
+file the defaults apply, `0.0.0.0:3000` and no static mount. Every C sample,
+the roundtrip and the soak in [`c/`](https://github.com/pandaGaume/mcp-broker/tree/main/c)
+target this broker, not an installed one.
+
 ## Releasing
 
 The package is published to npm by [`.github/workflows/release-node.yml`](https://github.com/pandaGaume/mcp-broker/blob/main/.github/workflows/release-node.yml), triggered by tags of the form `node-v*`.

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { PACKAGE_NAME, VERSION, loadBrokerConfig, WsTunnelBuilder, loadMcpbBundle, BROKER_AGGREGATE_NAME, BROKER_PROVIDER_NAME, resolveOpenTarget } from './chunk-BZUZYXVA.js';
+import { PACKAGE_NAME, VERSION, loadBrokerConfig, WsTunnelBuilder, loadMcpbBundle, BROKER_AGGREGATE_NAME, BROKER_PROVIDER_NAME, resolveOpenTarget } from './chunk-J5TN5RYU.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import open from 'open';

package/dist/{chunk-BZUZYXVA.js → chunk-J5TN5RYU.js}

@@ -3002,6 +3002,15 @@ var AggregateServer = class _AggregateServer {
       this.removeProvider(name);
     }
   }
+  /**
+   * Slot names currently contributing to the aggregate, in registration
+   * order. A provider whose handshake failed is not in it: `addProvider`
+   * removed it. This is what `broker_diagnose` reads through
+   * `IBrokerContext.getAggregateInfo()`.
+   */
+  get providerNames() {
+    return [...this._sessions.keys()];
+  }
   /** Removes a provider from the aggregate. */
   removeProvider(name) {
     const session = this._sessions.get(name);
@@ -3700,6 +3709,22 @@ var WsTunnel = class {
   getStdioBridgeTarget() {
     return this._options.stdioClient?.providerName ?? null;
   }
+  /**
+   * Membership of the `_all` aggregate, for `broker_diagnose`.
+   *
+   * Before `start()` the aggregate server does not exist yet, so an enabled
+   * aggregate reports no provider rather than `undefined`: "cannot be read"
+   * is for a host that has no aggregate at all, not for one that has not
+   * started. Without this accessor the CLI's own broker skipped the
+   * `aggregate-empty` check and told the operator to call tools/list on
+   * `_all` by hand.
+   */
+  getAggregateInfo() {
+    return {
+      enabled: this._options.enableAggregateProvider !== false,
+      providers: this._aggregateServer?.providerNames ?? []
+    };
+  }
   getProvidersInfo() {
     const out = [];
     for (const [name, state] of this._providers) {
@@ -3728,10 +3753,14 @@ var WsTunnel = class {
       transport = "none";
       connected = false;
     }
+    const since = connected ? state.connectedSinceMs : null;
     return {
       name,
       transport,
       connected,
+      aggregate: this._aggregateServer?.providerNames.includes(name) ?? false,
+      connectedSince: since !== null ? new Date(since).toISOString() : null,
+      connectedForMs: since !== null ? Math.max(0, Date.now() - since) : null,
       clientCount: state.wsClients.size,
       sessionCount: state.sseSessions.size + state.httpSessions.size,
       pendingCount: state.pending.size
@@ -3756,6 +3785,7 @@ var WsTunnel = class {
     }
     const state = this._getOrCreateProviderState(name);
     this._loopbackProviders.set(name, transport);
+    state.connectedSinceMs = Date.now();
     transport.onMessage = (data) => this._routeFromProvider(state, name, data);
     transport.onClose = () => {
       this._loopbackProviders.delete(name);
@@ -3890,9 +3920,10 @@ var WsTunnel = class {
             const state = this._providers.get(cfg.name);
             if (state) this._failProviderDisconnected(state, cfg.name);
           };
-          if (cfg.aggregate) {
-            upstream.onOpen = () => void this._aggregateServer?.addProvider(cfg.name);
-          }
+          upstream.onOpen = () => {
+            this._getOrCreateProviderState(cfg.name).connectedSinceMs = Date.now();
+            if (cfg.aggregate) void this._aggregateServer?.addProvider(cfg.name);
+          };
           this._upstreams.set(cfg.name, upstream);
           upstream.connect();
         };
@@ -4880,6 +4911,7 @@ data: ${data}
     }
     const state = this._getOrCreateProviderState(name);
     state.ws = ws;
+    state.connectedSinceMs = Date.now();
     this._watchProviderSocket(ws);
     if (providerPrincipal) {
       this._logProviderRegistration(providerPrincipal, name, this._slotResourceResolver.resolve(name), true);
@@ -5088,6 +5120,7 @@ data: ${data}
         providerNames.add(name);
         const state2 = this._getOrCreateProviderState(name);
         state2.ws = ws;
+        state2.connectedSinceMs = Date.now();
         if (providerPrincipal) {
           this._logProviderRegistration(providerPrincipal, name, this._slotResourceResolver.resolve(name), true);
         }
@@ -5267,6 +5300,7 @@ data: ${data}
    * close handlers (dedicated WS, multiplexed WS, loopback).
    */
   _failProviderDisconnected(state, name) {
+    state.connectedSinceMs = null;
     for (const entry of state.pending.values()) {
       const error = JSON.stringify({
         jsonrpc: "2.0",
@@ -5297,6 +5331,7 @@ data: ${data}
     if (!state) {
       state = {
         ws: null,
+        connectedSinceMs: null,
         pending: /* @__PURE__ */ new Map(),
         sseSessions: /* @__PURE__ */ new Map(),
         httpSessions: /* @__PURE__ */ new Map(),
@@ -5951,5 +5986,5 @@ function resolveOpenTarget(raw, baseUrl) {
 }
 
 export { AuthError, BROKER_AGGREGATE_NAME, BROKER_GUIDES, BROKER_GUIDE_MIME_TYPE, BROKER_GUIDE_TOPICS, BROKER_GUIDE_URI_PREFIX, BROKER_GUIDE_URI_TEMPLATE, BROKER_PROVIDER_NAME, BROKER_RESERVED_SLOTS, BrokerDiagnoseAdapter, BrokerDiagnoseBehavior, BrokerGuideAdapter, BrokerGuideBehavior, BrokerInfoBehavior, BrokerProvidersBehavior, ConfigPolicyEngine, ConfiguredCapabilityClassifier, DEFAULT_CONFIG_FILENAME, DefaultSlotResourceResolver, HttpAuthGuard, JwtSubjectMapper, JwtTokenValidator, PACKAGE_NAME, RemoteUpstream, ResourcePath, ResourcePathPattern, SharedSecretProviderAuthenticator, StdioUpstream, SubjectMappingError, VERSION, WsTunnel, WsTunnelBuilder, authorizationWithEngine, brokerGrammarKey, brokerGuide, brokerGuideIndex, brokerGuideTopicFromUri, brokerGuideUri, buildJwtAuth, buildResourceMetadata, compileAuthorizationPolicy, compileProviderAllowedResources, diagnoseBroker, hasAuthorizationPolicies, isReservedBrokerSlot, iterAvailableBrokerGrammars, iterBrokerGrammarsFrom, loadBrokerConfig, loadBrokerGrammar, loadMcpbBundle, normalizeProviderAuthentication, providerMayPublish, providerPublishDecision, resolveOpenTarget, scopesOf, startBrokerServer, unzipMcpb, validateCapability };
-//# sourceMappingURL=chunk-BZUZYXVA.js.map
-//# sourceMappingURL=chunk-BZUZYXVA.js.map
+//# sourceMappingURL=chunk-J5TN5RYU.js.map
+//# sourceMappingURL=chunk-J5TN5RYU.js.map