fix: prefer OPENAI_EMBEDDING_API_KEY over OPENAI_API_KEY for embeddings

.env.example

@@ -74,8 +74,11 @@
 # COHERE_API_KEY=...                             # General-purpose embeddings
 
 # Reuses OPENAI_API_KEY / OPENAI_BASE_URL above when EMBEDDING_PROVIDER=openai.
-# OPENAI_EMBEDDING_MODEL=text-embedding-3-small  # Embedding model when EMBEDDING_PROVIDER=openai
-# OPENAI_EMBEDDING_DIMENSIONS=1536               # Required when the model is not in the known-models table
+# Set OPENAI_EMBEDDING_API_KEY to use a different key for embeddings than for LLM.
+# OPENAI_EMBEDDING_API_KEY=sk-...                  # Dedicated embedding key (falls back to OPENAI_API_KEY)
+# OPENAI_EMBEDDING_BASE_URL=https://api.openai.com # Override for embedding API base URL (falls back to OPENAI_BASE_URL)
+# OPENAI_EMBEDDING_MODEL=text-embedding-3-small    # Embedding model when EMBEDDING_PROVIDER=openai
+# OPENAI_EMBEDDING_DIMENSIONS=1536                 # Required when the model is not in the known-models table
 
 # OPENROUTER_EMBEDDING_MODEL=openai/text-embedding-3-small  # When EMBEDDING_PROVIDER=openrouter
 

src/cli.ts

@@ -1687,7 +1687,7 @@ async function passiveServerChecks(): Promise<DoctorCheck[]> {
       ok: hasEmbed,
       hint: hasEmbed
         ? undefined
-        : "Running BM25-only. Add OPENAI_API_KEY / VOYAGE_API_KEY / COHERE_API_KEY / OLLAMA_HOST",
+        : "Running BM25-only. Add OPENAI_API_KEY / OPENAI_EMBEDDING_API_KEY / VOYAGE_API_KEY / COHERE_API_KEY / OLLAMA_HOST",
     },
   );
 

src/config.ts

@@ -241,7 +241,7 @@ export function detectEmbeddingProvider(
   if (forced) return forced;
 
   if (source["GEMINI_API_KEY"]) return "gemini";
-  if (source["OPENAI_API_KEY"]) return "openai";
+  if (source["OPENAI_EMBEDDING_API_KEY"] || source["OPENAI_API_KEY"]) return "openai";
   if (source["VOYAGE_API_KEY"]) return "voyage";
   if (source["COHERE_API_KEY"]) return "cohere";
   if (source["OPENROUTER_API_KEY"]) return "openrouter";

src/providers/embedding/index.ts

@@ -35,7 +35,7 @@ export function createEmbeddingProvider(): EmbeddingProvider | null {
     case "gemini":
       return withDimensionGuard(new GeminiEmbeddingProvider(getEnvVar("GEMINI_API_KEY")!));
     case "openai":
-      return withDimensionGuard(new OpenAIEmbeddingProvider(getEnvVar("OPENAI_API_KEY")!));
+      return withDimensionGuard(new OpenAIEmbeddingProvider());
     case "voyage":
       return withDimensionGuard(new VoyageEmbeddingProvider(getEnvVar("VOYAGE_API_KEY")!));
     case "cohere":