ruvnet/ruflo · error · Error

Subscriptions are disabled

Error message

Subscriptions are disabled

What it means

subscribe() was called on a ResourceRegistry built with enableSubscriptions disabled (subscriptions off in registry options). The capability check runs before any subscriber bookkeeping, so the call is rejected as unsupported rather than silently dropped.

Source

Thrown at v3/@claude-flow/mcp/src/resource-registry.ts:207

      }

      this.cache.set(uri, {
        content: contents,
        cachedAt: Date.now(),
        ttl: this.options.cacheTTL,
      });
    }

    this.emit('resource:read', { uri, contentCount: contents.length });
    return { contents };
  }

  /**
   * Subscribe to resource updates
   */
  subscribe(uri: string, callback: SubscriptionCallback): string {
    if (!this.options.enableSubscriptions) {
      throw new Error('Subscriptions are disabled');
    }

    const existingSubs = this.subscriptions.get(uri) || [];
    if (existingSubs.length >= this.options.maxSubscriptionsPerResource) {
      throw new Error(`Maximum subscriptions reached for resource: ${uri}`);
    }

    const subscriptionId = `sub-${++this.subscriptionCounter}-${Date.now()}`;
    const subscription: Subscription = {
      id: subscriptionId,
      uri,
      callback,
      createdAt: new Date(),
    };

    existingSubs.push(subscription);
    this.subscriptions.set(uri, existingSubs);

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Enable subscriptions in the resource registry configuration before subscribing.
2. Poll the resource instead of subscribing when subscriptions are disabled.

When it happens

Trigger: Thrown at v3/@claude-flow/mcp/src/resource-registry.ts:207 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/1d88987a70484eaa. Report an issue: GitHub.