feat(llm): add OpenCode Go (OpenAI-compatible) provider for ingestion

Provider-swappable LlmPort now supports AI_PROVIDER=opencode via
@ai-sdk/openai-compatible against https://opencode.ai/zen/go/v1.
- intake -> deepseek-v4-flash (tool-calling structured output)
- vision evidence parse -> qwen3.6-plus (image input)
- OpenRouter path unchanged (default); response-healing stays OpenRouter-only
- capability registry: opencode_llm available when OPENCODE_API_KEY set
- .env.example documents OPENCODE_API_KEY/OPENCODE_BASE_URL + model examples

Resolves OpenRouter free-tier rate-limit wall. Verified live end-to-end:
Telegram text -> deepseek-v4-flash -> structured facts; real Telegram
screenshot -> qwen3.6-plus vision OCR -> ParsedEvidence -> 2 evidence
claims with support levels.

infra/.env.example

@@ -14,10 +14,30 @@ API_BASE_URL=http://localhost:3001
 WEBHOOK_BASE_URL=http://localhost:3001
 
 # --- AI provider ---
+# Set AI_PROVIDER to switch between providers:
+#   openrouter (default) — uses @openrouter/ai-sdk-provider with response-healing plugin
+#   opencode | openai-compatible — uses @ai-sdk/openai-compatible pointed at OPENCODE_BASE_URL
 AI_PROVIDER=openrouter
+
+# --- OpenRouter (AI_PROVIDER=openrouter) ---
 OPENROUTER_API_KEY=
+# Example model IDs for openrouter:
+# AI_MODEL=google/gemini-2.0-flash-exp:free
+# AI_VISION_MODEL=google/gemini-2.0-flash-exp:free
 AI_MODEL=google/gemini-2.0-flash-exp:free
 AI_VISION_MODEL=google/gemini-2.0-flash-exp:free
+
+# --- OpenCode Go (AI_PROVIDER=opencode) ---
+# OpenAI-compatible gateway at https://opencode.ai/zen/go/v1
+# All listed models support tool-calling; generateObject uses tool-calling mode.
+# Text intake model (no vision): deepseek-v4-flash
+# Vision/evidence models (text+image): qwen3.6-plus, mimo-v2.5, kimi-k2.6
+OPENCODE_API_KEY=
+OPENCODE_BASE_URL=https://opencode.ai/zen/go/v1
+# Example model overrides for opencode provider:
+# AI_MODEL=deepseek-v4-flash
+# AI_VISION_MODEL=qwen3.6-plus
+
 # Legacy key kept for compatibility
 AI_PROVIDER_API_KEY=
 

packages/adapters/package.json

@@ -13,6 +13,7 @@
     "build": "tsc --noEmit"
   },
   "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.48",
     "@courtmitra/contracts": "workspace:*",
     "@courtmitra/ports": "workspace:*",
     "@courtmitra/prompts": "workspace:*",

packages/adapters/src/index.ts

@@ -35,6 +35,7 @@ export function getCapabilities(): AdapterCapability[] {
   const waToken = process.env["WHATSAPP_ACCESS_TOKEN"];
   const waPhoneId = process.env["WHATSAPP_PHONE_NUMBER_ID"];
   const openrouterKey = process.env["OPENROUTER_API_KEY"];
+  const opencodeKey = process.env["OPENCODE_API_KEY"];
 
   const CAPABILITY_REGISTRY: AdapterCapability[] = [
     {
@@ -61,6 +62,14 @@ export function getCapabilities(): AdapterCapability[] {
       requiredEnv: ["OPENROUTER_API_KEY"],
       fallbackAction: "draft",
     },
+    {
+      adapter: "opencode_llm",
+      action: "generate_structured",
+      status: opencodeKey ? "available" : "blocked",
+      reason: opencodeKey ? undefined : "OPENCODE_API_KEY not set.",
+      requiredEnv: ["OPENCODE_API_KEY"],
+      fallbackAction: "draft",
+    },
     {
       adapter: "resend_email",
       action: "send_email",

packages/adapters/src/llm/vercel-ai.ts

@@ -1,15 +1,29 @@
 /**
- * LlmPort implementation backed by Vercel AI SDK 6 + OpenRouter.
+ * LlmPort implementation backed by Vercel AI SDK 6 + pluggable provider.
+ *
+ * Supported providers (AI_PROVIDER env var):
+ *   - "openrouter" (default): @openrouter/ai-sdk-provider with response-healing plugin.
+ *   - "opencode" | "openai-compatible": @ai-sdk/openai-compatible pointed at
+ *       OPENCODE_BASE_URL (default: https://opencode.ai/zen/go/v1).
+ *       Object generation uses tool-calling mode (supportsStructuredOutputs: false,
+ *       which is the default) — all confirmed OpenCode Go models support tool-calling.
  *
  * Doc sources confirmed:
  * - generateObject: /openrouterteam/ai-sdk-provider — uses `generateObject` from `ai`
  *   with `schema` (Zod) and `model = openrouter(modelId, { plugins: [{ id: 'response-healing' }] })`.
+ * - @ai-sdk/openai-compatible v2.0.48: `createOpenAICompatible({ name, baseURL, apiKey })`
+ *   returns a provider; call `provider(modelId)` for a chat model. `supportsStructuredOutputs`
+ *   defaults to false → generateObject falls back to tool-calling mode, which works with
+ *   deepseek-v4-flash / qwen3.6-plus / mimo-v2.5 / kimi-k2.6.
+ *   Source: /websites/ai-sdk_dev + @ai-sdk/openai-compatible dist/index.d.ts (v2.0.48).
  * - Image parts: /vercel/ai — user message content uses `{ type: 'image', image: DataContent | URL, mediaType?: string }`.
- * - generateObject still exported in ai@6.x (verified from node_modules).
+ * - generateObject still exported in ai@6.x (verified from node_modules ai@6.0.191).
  * - Response metadata: `result.response.modelId`, usage: `result.usage.inputTokens` / `outputTokens`.
  */
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 import { generateObject } from "ai";
+import type { LanguageModel } from "ai";
 import type { LlmPort, LlmStructuredRequest, LlmStructuredResult } from "@courtmitra/ports";
 import { renderPrompt } from "@courtmitra/prompts";
 import type { ZodType } from "zod";
@@ -33,6 +47,35 @@ export class VercelAiLlmAdapter implements LlmPort {
     return this._attempt(req, modelId, renderedPrompt, true);
   }
 
+  /**
+   * Build the language model instance based on AI_PROVIDER env var.
+   * - "openrouter" (default): OpenRouter with response-healing plugin.
+   * - "opencode" | "openai-compatible": @ai-sdk/openai-compatible pointed at
+   *   OPENCODE_BASE_URL. supportsStructuredOutputs defaults to false so
+   *   generateObject falls back to tool-calling mode (all OpenCode Go models
+   *   support tool-calling).
+   */
+  private _buildModel(modelId: string): LanguageModel {
+    const provider = process.env["AI_PROVIDER"] ?? "openrouter";
+
+    if (provider === "opencode" || provider === "openai-compatible") {
+      const oc = createOpenAICompatible({
+        name: "opencode-go",
+        baseURL: process.env["OPENCODE_BASE_URL"] ?? "https://opencode.ai/zen/go/v1",
+        apiKey: process.env["OPENCODE_API_KEY"],
+        // supportsStructuredOutputs intentionally left as false (default) so
+        // generateObject uses tool-calling mode, which all listed OpenCode Go
+        // models support (deepseek-v4-flash, qwen3.6-plus, mimo-v2.5, kimi-k2.6).
+      });
+      return oc(modelId);
+    }
+
+    // Default: OpenRouter with response-healing plugin
+    return this.openrouter(modelId, {
+      plugins: [{ id: "response-healing" }],
+    });
+  }
+
   private async _attempt<T>(
     req: LlmStructuredRequest<T>,
     modelId: string,
@@ -67,9 +110,7 @@ export class VercelAiLlmAdapter implements LlmPort {
     // Cast to ZodType for generateObject which expects ZodType at runtime
     const zodSchema = req.schema as unknown as ZodType<T>;
 
-    const model = this.openrouter(modelId, {
-      plugins: [{ id: "response-healing" }],
-    });
+    const model = this._buildModel(modelId);
 
     try {
       const result = await generateObject({

pnpm-lock.yaml

@@ -152,6 +152,9 @@ importers:
 
   packages/adapters:
     dependencies:
+      '@ai-sdk/openai-compatible':
+        specifier: ^2.0.48
+        version: 2.0.48(zod@4.4.3)
       '@courtmitra/contracts':
         specifier: workspace:*
         version: link:../contracts
@@ -250,6 +253,12 @@ packages:
     peerDependencies:
       zod: ^3.25.76 || ^4.1.8
 
+  '@ai-sdk/openai-compatible@2.0.48':
+    resolution: {integrity: sha512-z9MC6M4Oh/yUY/F/eszOtO8wc2nMz99XmZQKd2gWTtyIfe716xTfrKe3aYZKg20NZDtyjqPPKPSR+wqz7q1T7Q==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      zod: ^3.25.76 || ^4.1.8
+
   '@ai-sdk/provider-utils@4.0.27':
     resolution: {integrity: sha512-ubkAJ+xODouwtmN1tYlvTPphH1hPOBfZaEQe8U7skGvFAnIRs9PPpsq57bC2+Ky/MB4yzhd6YOsxTAx9sGpazw==}
     engines: {node: '>=18'}
@@ -3198,6 +3207,12 @@ snapshots:
       '@vercel/oidc': 3.2.0
       zod: 4.4.3
 
+  '@ai-sdk/openai-compatible@2.0.48(zod@4.4.3)':
+    dependencies:
+      '@ai-sdk/provider': 3.0.10
+      '@ai-sdk/provider-utils': 4.0.27(zod@4.4.3)
+      zod: 4.4.3
+
   '@ai-sdk/provider-utils@4.0.27(zod@4.4.3)':
     dependencies:
       '@ai-sdk/provider': 3.0.10