ruvnet/ruflo · error

[embeddings] Primary provider '${provider}' failed, using fa

Error message

[embeddings] Primary provider '${provider}' failed, using fallback '${fallback}'

What it means

Log warning in the auto provider factory: validating the primary embedding provider (embed('test')) failed, so the service is re-created with the configured fallback provider instead of throwing.

Source

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

        });
      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);
  }
}

/**
 * Convenience function for quick embeddings
 */
export async function getEmbedding(
  text: string,
  config?: Partial<EmbeddingConfig>
): Promise<Float32Array | number[]> {
  const service = createEmbeddingService({
    provider: 'mock',
    dimensions: 384,
    ...config,
  } as EmbeddingConfig);

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the primary provider's error and credentials; fix it or reorder providers if the fallback is preferred.

When it happens

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