@cyanmycelium/mcp-broker 1.3.0 → 1.3.1

package/dist/index.d.ts

@@ -1441,6 +1441,17 @@ declare class WsTunnel implements IBrokerContext {
     getSecurityInfo(): IBrokerSecurityInfo;
     /** Slot the stdio bridge is pinned to, or `null` when there is no bridge. */
     getStdioBridgeTarget(): string | 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(): IBrokerAggregateInfo;
     getProvidersInfo(): IBrokerProviderInfo[];
     getProviderInfo(name: string): IBrokerProviderInfo | undefined;
     private _buildProviderInfo;

package/dist/index.js

@@ -1,3 +1,3 @@
-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 } from './chunk-BZUZYXVA.js';
+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 } from './chunk-UOJRDF5R.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cyanmycelium/mcp-broker",
-    "version": "1.3.0",
+    "version": "1.3.1",
     "description": "WebSocket-based Model Context Protocol broker. Aggregates multiple MCP providers behind a single endpoint with stdio, SSE, and Streamable HTTP client transports.",
     "type": "module",
     "license": "Apache-2.0",

package/src/broker/aggregate/aggregate.server.ts

@@ -163,6 +163,16 @@ export class AggregateServer implements IMessageTransport {
         }
     }
 
+    /**
+     * 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(): readonly string[] {
+        return [...this._sessions.keys()];
+    }
+
     /** Removes a provider from the aggregate. */
     removeProvider(name: string): void {
         const session = this._sessions.get(name);

package/src/ws/ws.tunnel.ts

@@ -19,7 +19,7 @@ import type { IBrokerContext, IBrokerProviderInfo, BrokerProviderTransport } fro
 // Imported from the defining module rather than the barrel: these two are the
 // optional `IBrokerContext` extensions `broker_diagnose` reads, and the barrel
 // does not re-export them yet.
-import type { IBrokerSecurityInfo } from "../broker/broker.context";
+import type { IBrokerAggregateInfo, IBrokerSecurityInfo } from "../broker/broker.context";
 import { AggregateServer } from "../broker/aggregate/aggregate.server";
 import {
     HttpAuthGuard,
@@ -433,6 +433,23 @@ export class WsTunnel implements IBrokerContext {
         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.
+     */
+    public getAggregateInfo(): IBrokerAggregateInfo {
+        return {
+            enabled: this._options.enableAggregateProvider !== false,
+            providers: this._aggregateServer?.providerNames ?? [],
+        };
+    }
+
     public getProvidersInfo(): IBrokerProviderInfo[] {
         const out: IBrokerProviderInfo[] = [];
         for (const [name, state] of this._providers) {