opencode-rag-plugin 1.23.0 → 1.23.1

package/ReadMe.md

@@ -81,7 +81,7 @@ Launch with `opencode-rag ui`. See [Web UI documentation](doc/webui.md) for deta
 
 OpenCodeRAG can index image files (PNG, JPEG, WebP, etc.) by sending them to a vision-capable LLM and storing the generated text descriptions as searchable vector chunks. This makes visual assets discoverable via natural language queries (e.g., "login screen screenshot", "architecture diagram").
 
-**Supported providers:** Ollama, OpenAI, Anthropic, Google Gemini compatible providers.
+**Supported providers:** Ollama, OpenAI, Anthropic, Google Gemini, and OpenCode Zen (`opencode`/`opencode-go`) compatible providers.
 
 **Disabled by default** — enable in `opencode-rag.json` to opt in (recommended for dedicated GPUs).
 

package/dist/chunker/image.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fileoverview Image file chunking via vision provider integration (Ollama, OpenAI, Anthropic, Gemini).
+ * @fileoverview Image file chunking via vision provider integration (Ollama, OpenAI, Anthropic, Gemini, OpenCode Zen).
  */
 import type { Chunker, Chunk } from "../core/interfaces.js";
 import type { ImageDescriptionConfig } from "../core/config.js";

package/dist/chunker/image.js

@@ -1,5 +1,7 @@
 import { normalizeKeepAlive } from "../core/ollama.js";
 import { postJson } from "../embedder/http.js";
+import { getCurrentVersion } from "../core/version-check.js";
+import { isZenProvider, resolveZenBaseUrl } from "../core/zen.js";
 import { uuid } from "./uuid.js";
 const MAX_CHUNK_CHARS = 4000;
 const MIN_GROUP_CHARS = 300;
@@ -7,6 +9,15 @@ const PARAGRAPH_SPLIT = /\n\s*\n/;
 const VISION_RETRY_MAX = 2;
 const VISION_RETRY_BASE_DELAY_MS = 1000;
 const VISION_RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+/** Stable per-process session id so Zen can route and cache prompts per client. */
+const ZEN_SESSION_ID = uuid();
+/** Headers sent with every OpenCode Zen vision request. */
+function zenRequestHeaders() {
+    return {
+        "x-opencode-session": ZEN_SESSION_ID,
+        "User-Agent": `opencode-rag/${getCurrentVersion()}`,
+    };
+}
 function visionSleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -106,12 +117,14 @@ class OpenAIImageVisionProvider {
     model;
     apiKey;
     timeoutMs;
+    extraHeaders;
     proxy;
-    constructor(config) {
+    constructor(config, extraHeaders) {
         this.baseUrl = config.baseUrl.replace(/\/+$/, "");
         this.model = config.model;
         this.apiKey = config.apiKey ?? "";
         this.timeoutMs = config.timeoutMs;
+        this.extraHeaders = extraHeaders ?? {};
         this.proxy = config.proxy;
     }
     async describeImage(imageBase64, mimeType, prompt, systemPrompt, abort) {
@@ -136,6 +149,7 @@ class OpenAIImageVisionProvider {
             max_tokens: 2048,
         };
         const headers = {
+            ...this.extraHeaders,
             "Content-Type": "application/json",
         };
         if (this.apiKey) {
@@ -250,7 +264,7 @@ class GeminiImageVisionProvider {
     constructor(config) {
         this.baseUrl = config.baseUrl.replace(/\/+$/, "");
         this.model = config.model;
-        this.apiKey = config.apiKey;
+        this.apiKey = config.apiKey ?? "";
         this.timeoutMs = config.timeoutMs;
         this.proxy = config.proxy;
     }
@@ -355,6 +369,13 @@ export function createImageVisionProvider(config) {
         }
         return new OpenAIImageVisionProvider(config);
     }
+    if (isZenProvider(config.provider)) {
+        if (!config.apiKey) {
+            throw new Error(`${config.provider} image provider requires an apiKey — log in with OpenCode (auth.json) or set it in the config`);
+        }
+        const baseUrl = resolveZenBaseUrl(config.baseUrl, config.provider);
+        return new OpenAIImageVisionProvider({ ...config, baseUrl }, zenRequestHeaders());
+    }
     return new OllamaImageVisionProvider(config);
 }
 /**

package/dist/core/resolve-api-key.js

@@ -28,12 +28,13 @@ function resolveForSection(provider, section, worktree) {
     if (section.apiKey && !isPlaceholder(section.apiKey))
         return;
     const defaults = getProviderDefault(provider);
-    if (!defaults || !defaults.apiKeyEnvVar)
-        return;
-    const envKey = process.env[defaults.apiKeyEnvVar];
-    if (envKey) {
-        section.apiKey = envKey;
-        return;
+    const envVar = defaults?.apiKeyEnvVar;
+    if (envVar) {
+        const envKey = process.env[envVar];
+        if (envKey) {
+            section.apiKey = envKey;
+            return;
+        }
     }
     if (worktree) {
         const key = readOpenCodeProviderKey(worktree, provider);
@@ -42,9 +43,38 @@ function resolveForSection(provider, section, worktree) {
             return;
         }
     }
+    const authKey = readOpenCodeAuthKey(provider);
+    if (authKey) {
+        section.apiKey = authKey;
+        return;
+    }
     // If we had a placeholder but couldn't resolve a real key, keep the placeholder
     // so createEmbedder can throw a clear error about the missing key
 }
+/**
+ * Read an API key from OpenCode's auth store (`$XDG_DATA_HOME/opencode/auth.json`
+ * or `~/.local/share/opencode/auth.json`). This is where `/connect` stores keys
+ * for providers such as OpenCode Zen (`opencode`, `opencode-go`).
+ */
+function readOpenCodeAuthKey(providerId) {
+    const homeDir = process.env.USERPROFILE || process.env.HOME;
+    const dataHome = process.env.XDG_DATA_HOME?.trim() || (homeDir ? path.join(homeDir, ".local", "share") : undefined);
+    if (!dataHome)
+        return undefined;
+    const authPath = path.join(dataHome, "opencode", "auth.json");
+    try {
+        if (!existsSync(authPath))
+            return undefined;
+        const auth = JSON.parse(readFileSync(authPath, "utf-8"));
+        const entry = auth[providerId];
+        if (entry && entry.type === "api" && entry.key)
+            return entry.key;
+    }
+    catch {
+        // skip unreadable or unparseable auth stores
+    }
+    return undefined;
+}
 function stripJsoncComments(text) {
     return text.replace(/("[^"\\]*(?:\\.[^"\\]*)*")|(\/\/[^\n]*|\/\*[\s\S]*?\*\/)/g, (_, string) => string ?? "");
 }

package/dist/core/zen.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview OpenCode Zen provider helpers — provider detection, chat-completion
+ * base URLs, and base-URL resolution for the OpenAI-compatible Zen endpoints.
+ */
+/** OpenCode Zen chat-completion base URLs by provider id. */
+export declare const ZEN_PROVIDER_BASE_URLS: Record<string, string>;
+/** Whether the provider id refers to an OpenCode Zen endpoint. */
+export declare function isZenProvider(provider: string): boolean;
+/**
+ * Pick the Zen base URL for a Zen provider. Configured URLs that point at an
+ * `opencode.ai` host are kept (alternate Zen endpoints); anything else — e.g.
+ * the Ollama/llama.cpp base inherited from the indexing section — is replaced
+ * by the provider default.
+ */
+export declare function resolveZenBaseUrl(configuredBaseUrl: string | undefined, provider: string): string;

package/dist/core/zen.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview OpenCode Zen provider helpers — provider detection, chat-completion
+ * base URLs, and base-URL resolution for the OpenAI-compatible Zen endpoints.
+ */
+/** OpenCode Zen chat-completion base URLs by provider id. */
+export const ZEN_PROVIDER_BASE_URLS = {
+    opencode: "https://opencode.ai/zen/v1",
+    "opencode-go": "https://opencode.ai/zen/go/v1",
+};
+/** Whether the provider id refers to an OpenCode Zen endpoint. */
+export function isZenProvider(provider) {
+    return provider in ZEN_PROVIDER_BASE_URLS;
+}
+/**
+ * Pick the Zen base URL for a Zen provider. Configured URLs that point at an
+ * `opencode.ai` host are kept (alternate Zen endpoints); anything else — e.g.
+ * the Ollama/llama.cpp base inherited from the indexing section — is replaced
+ * by the provider default.
+ */
+export function resolveZenBaseUrl(configuredBaseUrl, provider) {
+    const configured = (configuredBaseUrl ?? "").trim();
+    if (configured.includes("opencode.ai"))
+        return configured;
+    return ZEN_PROVIDER_BASE_URLS[provider] ?? configured;
+}
+//# sourceMappingURL=zen.js.map

package/dist/embedder/health.js

@@ -1,4 +1,5 @@
 import { resolveOnDemandImageConfig } from "../chunker/image.js";
+import { isZenProvider, resolveZenBaseUrl } from "../core/zen.js";
 import { fetchWithProxy, postJson } from "./http.js";
 /**
  * Check connectivity and model availability for all configured providers.
@@ -80,8 +81,10 @@ async function checkVisionModel(img, type) {
     if (provider === "google") {
         return checkGoogleChat(baseUrl, model, apiKey, imgTimeout, img.proxy, type);
     }
-    // OpenAI-compatible chat endpoint
-    return checkOpenAiChat(baseUrl, model, apiKey, imgTimeout, img.proxy, type);
+    // OpenAI-compatible chat endpoint (OpenCode Zen providers default to their
+    // own base URL when the config still carries the indexing section's URL)
+    const openAiBaseUrl = isZenProvider(provider) ? resolveZenBaseUrl(baseUrl, provider) : baseUrl;
+    return checkOpenAiChat(openAiBaseUrl, model, apiKey, imgTimeout, img.proxy, type);
 }
 /** Check whether a provider name matches a known OpenAI-compatible provider. */
 function isOpenAiCompatible(provider) {

package/dist/mcp/handlers.d.ts

@@ -97,7 +97,7 @@ export interface DescribeImageResult {
     /** Human-readable formatted output with metadata. */
     formatted: string;
 }
-/** Describe an image file using the configured vision provider (Ollama, OpenAI, Anthropic, or Gemini). Honors `imageDescription.onDemand` overrides. */
+/** Describe an image file using the configured vision provider (Ollama, OpenAI, Anthropic, Gemini, or OpenCode Zen). Honors `imageDescription.onDemand` overrides. */
 export declare function handleDescribeImage(params: DescribeImageParams, cfg: RagConfig, worktree: string, visionProvider?: ImageVisionProvider): Promise<DescribeImageResult>;
 /** Find usages and references of a symbol across the indexed codebase using hybrid (keyword + vector) search. */
 export declare function handleFindUsages(params: FindUsagesParams, embedder: EmbeddingProvider, store: VectorStore, cfg: RagConfig, keywordIndex?: KeywordIndex, retrieveFn?: typeof retrieve): Promise<FindUsagesResult>;

package/dist/mcp/handlers.js

@@ -227,7 +227,7 @@ export async function handleFileSkeleton(params, worktree) {
     const formatted = `${skeleton.length} structural elements (${summary || "—"})\n\n${formatSkeleton(skeleton)}`;
     return { elements: skeleton, formatted, summary };
 }
-/** Describe an image file using the configured vision provider (Ollama, OpenAI, Anthropic, or Gemini). Honors `imageDescription.onDemand` overrides. */
+/** Describe an image file using the configured vision provider (Ollama, OpenAI, Anthropic, Gemini, or OpenCode Zen). Honors `imageDescription.onDemand` overrides. */
 export async function handleDescribeImage(params, cfg, worktree, visionProvider) {
     const { existsSync, readFileSync } = await import("node:fs");
     const path = await import("node:path");

package/dist/mcp/server.js

@@ -74,7 +74,7 @@ export async function createMcpServer(options) {
             };
         }
     });
-    server.tool("describe_image", "Describe an image file using a vision model. Reads the file from disk, sends it to the configured vision provider (Ollama, OpenAI, Anthropic, or Google Gemini), and returns a text description of the image contents. Optionally accepts a systemPrompt to steer the description toward specific features.", {
+    server.tool("describe_image", "Describe an image file using a vision model. Reads the file from disk, sends it to the configured vision provider (Ollama, OpenAI, Anthropic, Google Gemini, or OpenCode Zen), and returns a text description of the image contents. Optionally accepts a systemPrompt to steer the description toward specific features.", {
         filePath: z.string().min(1, "An image file path is required."),
         systemPrompt: z.string().optional(),
     }, async (args) => {

package/dist/opencode/tools.d.ts

@@ -48,8 +48,8 @@ export interface DescribeImageToolOptions {
  * Create the `describe_image` tool.
  *
  * Reads an image file from disk and sends it to the configured vision provider
- * for natural-language description. Supports Ollama, OpenAI, Anthropic, and
- * Google Gemini providers with automatic resizing.
+ * for natural-language description. Supports Ollama, OpenAI, Anthropic,
+ * Google Gemini, and OpenCode Zen providers with automatic resizing.
  *
  * On-demand calls honor the optional `imageDescription.onDemand` overrides
  * (a different provider/model than the indexing pipeline).

package/dist/opencode/tools.js

@@ -244,8 +244,8 @@ export function createFileSkeletonTool(options) {
  * Create the `describe_image` tool.
  *
  * Reads an image file from disk and sends it to the configured vision provider
- * for natural-language description. Supports Ollama, OpenAI, Anthropic, and
- * Google Gemini providers with automatic resizing.
+ * for natural-language description. Supports Ollama, OpenAI, Anthropic,
+ * Google Gemini, and OpenCode Zen providers with automatic resizing.
  *
  * On-demand calls honor the optional `imageDescription.onDemand` overrides
  * (a different provider/model than the indexing pipeline).
@@ -257,7 +257,7 @@ export function createDescribeImageTool(options) {
     const { worktree, config, visionProvider } = options;
     return tool({
         description: "Describe an image file using a vision model. " +
-            "Reads the file from disk, sends it to the configured vision provider (Ollama, OpenAI, Anthropic, or Google Gemini), " +
+            "Reads the file from disk, sends it to the configured vision provider (Ollama, OpenAI, Anthropic, Google Gemini, or OpenCode Zen), " +
             "and returns a natural language description of what the image shows. " +
             "Optionally accepts a `systemPrompt` to steer the description toward specific features or details you care about " +
             "(e.g. colors, layout, accessibility, text content, specific UI elements). " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-rag-plugin",
-  "version": "1.23.0",
+  "version": "1.23.1",
   "description": "OpenCode plugin for local-first RAG-based semantic code search",
   "type": "module",
   "main": "./dist/plugin-entry.js",