ruvnet/ruflo · error · Error

Failed to initialize HyperbolicBridge: ${error instanceof Er

Error message

Failed to initialize HyperbolicBridge: ${error instanceof Error ? error.message : String(error)}

What it means

HyperbolicBridge.initialize() hit an unexpected exception while importing the hyperbolic-HNsw WASM module (an actual throw — a missing package is tolerated and mocked). The status flips to 'error' and the original message is embedded in this wrapper.

Source

Thrown at v3/plugins/hyperbolic-reasoning/src/bridges/hyperbolic-bridge.ts:125

    if (this._status === 'ready') return;
    if (this._status === 'loading') return;

    this._status = 'loading';

    try {
      // Dynamic import - module may not be installed
      const wasmModule = await import(/* webpackIgnore: true */ '@ruvector/hyperbolic-hnsw-wasm' as string).catch(() => null);

      if (wasmModule) {
        this._module = wasmModule as unknown as HyperbolicWasmModule;
      } else {
        this._module = this.createMockModule();
      }

      this._status = 'ready';
    } catch (error) {
      this._status = 'error';
      throw new Error(`Failed to initialize HyperbolicBridge: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

  /**
   * Dispose of resources
   */
  async dispose(): Promise<void> {
    this._indices.clear();
    this._module = null;
    this._status = 'unloaded';
  }

  /**
   * Embed a hierarchy into hyperbolic space
   */
  async embedHierarchy(
    hierarchy: Hierarchy,
    config: Partial<EmbedHierarchyInput['parameters']> = {}

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the underlying initialization error; verify the WASM asset exists, is compatible, and required dependencies are loaded.
2. Retry initialization after fixing the root cause; make the failure surface the original error message.

When it happens

Trigger: Thrown at v3/plugins/hyperbolic-reasoning/src/bridges/hyperbolic-bridge.ts:125 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/3f18a9c5f05554ff. Report an issue: GitHub.