ruvnet/ruflo · error · Error

WASM module '${name}' not registered

Error message

WASM module '${name}' not registered

What it means

ensureInitialized() looked up an entry in this.modules for the requested bridge name and found none. get() was called for a WASM module that was never registered via the registry's register call — typically a typo'd module name or a missing registration step, not an initialization failure.

Source

Thrown at v3/plugins/ruvector-upstream/src/registry.ts:75

    entry.lastUsed = new Date();
    entry.useCount++;

    return entry.bridge as WasmBridge<T>;
  }

  /**
   * Ensure a module is initialized (with deduplication)
   */
  private async ensureInitialized(name: string): Promise<void> {
    // Check if already initializing
    const existing = this.initPromises.get(name);
    if (existing) {
      return existing;
    }

    const entry = this.modules.get(name);
    if (!entry) {
      throw new Error(`WASM module '${name}' not registered`);
    }

    // Start initialization
    const promise = entry.bridge.init().then(() => {
      entry.loadedAt = new Date();
      this.initPromises.delete(name);
    }).catch((error) => {
      this.initPromises.delete(name);
      throw error;
    });

    this.initPromises.set(name, promise);
    return promise;
  }

  /**
   * Check if a module is registered
   */

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Register the WASM module under this name before requesting it, or correct the module name.

When it happens

Trigger: Thrown at v3/plugins/ruvector-upstream/src/registry.ts:75 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/46224c0996b455ef. Report an issue: GitHub.