ruvnet/ruflo · error

Unknown provider: ${provider}

Error message

Unknown provider: ${provider}

What it means

The async createPrimary() switch hit its default case: the configured provider string is not one of agentic-flow, transformers, openai, rvf, or mock. The offending provider value is interpolated into the message so the misconfiguration is immediately visible.

Source

Thrown at v3/@claude-flow/embeddings/src/embedding-service.ts:1039

        return new OpenAIEmbeddingService({
          provider: 'openai',
          apiKey: rest.apiKey,
          dimensions: rest.dimensions,
          cacheSize: rest.cacheSize,
        });
      case 'rvf':
        return new RvfEmbeddingService({
          provider: 'rvf',
          dimensions: rest.dimensions ?? 384,
          cacheSize: rest.cacheSize,
        });
      case 'mock':
        return new MockEmbeddingService({
          dimensions: rest.dimensions ?? 384,
          cacheSize: rest.cacheSize,
        });
      default:
        throw new Error(`Unknown provider: ${provider}`);
    }
  };

  const primary = createPrimary();

  // Try to validate primary provider
  try {
    await primary.embed('test');
    return primary;
  } catch (error) {
    if (!fallback) {
      throw error;
    }

    // Try fallback
    console.warn(`[embeddings] Primary provider '${provider}' failed, using fallback '${fallback}'`);
    const fallbackConfig: AutoEmbeddingConfig = { ...rest, provider: fallback };
    return createEmbeddingServiceAsync(fallbackConfig);

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Use a supported provider name; check the factory's accepted provider list.
2. Register a custom provider implementation before requesting it.

When it happens

Trigger: Thrown at v3/@claude-flow/embeddings/src/embedding-service.ts:1039 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/326377c8b65b5f8b. Report an issue: GitHub.