@gopersonal/advisor 1.0.1 → 1.0.3

package/README.md

@@ -65,6 +65,11 @@ claude mcp add advisor -- npx -y @gopersonal/advisor
 | `ADVISOR_MODEL` | Model name | `gpt-4o`, `claude-sonnet-4-5` |
 | `ADVISOR_API_KEY` | API key for the provider | `sk-...` |
 | `ADVISOR_BASE_URL` | Custom base URL (optional) | `https://proxy.example.com` |
+| `ADVISOR_DIRECTORY` | Project directory for opencode context (optional) | `/Users/me/myproject` |
+| `ADVISOR_INSTRUCTIONS` | Path to instructions/AGENTS.md file (optional) | `/Users/me/myproject/AGENTS.md` |
+
+`ADVISOR_DIRECTORY` gives the advisor context about your project (file structure, code, etc.).
+`ADVISOR_INSTRUCTIONS` loads a custom instructions file (like AGENTS.md) so the advisor knows your project conventions.
 
 If no env vars are set, the advisor connects to a running opencode instance or starts one using your default opencode config.
 

package/build/index.js

@@ -7,35 +7,46 @@ import { createOpencode, createOpencodeClient } from "@opencode-ai/sdk/v2";
 //
 // Pass these via the "env" field in the MCP config JSON.
 //
-// Option A: OpenAI-compatible endpoint
+// Option A: OpenAI-compatible endpoint (most providers, proxies, etc.)
 //   ADVISOR_PROVIDER  = "openai"
-//   ADVISOR_MODEL     = "gpt-4o" (just the model name)
+//   ADVISOR_MODEL     = "gpt-4o"
 //   ADVISOR_API_KEY   = "sk-..."
-//   ADVISOR_BASE_URL  = "https://api.openai.com/v1" (optional, default OpenAI)
+//   ADVISOR_BASE_URL  = "https://api.openai.com/v1"
 //
 // Option B: Anthropic-compatible endpoint
 //   ADVISOR_PROVIDER  = "anthropic"
-//   ADVISOR_MODEL     = "claude-sonnet-4-5" (just the model name)
+//   ADVISOR_MODEL     = "claude-sonnet-4-5"
 //   ADVISOR_API_KEY   = "sk-ant-..."
-//   ADVISOR_BASE_URL  = "https://api.anthropic.com" (optional, default Anthropic)
+//   ADVISOR_BASE_URL  = "https://api.anthropic.com"
 //
-// Legacy format (still works):
-//   ADVISOR_MODEL     = "anthropic/claude-sonnet-4-5" (provider/model combined)
+// Optional:
+//   ADVISOR_DIRECTORY    = project directory for opencode context (e.g. "/Users/me/myproject")
+//   ADVISOR_INSTRUCTIONS = path to instructions file (e.g. "/Users/me/myproject/AGENTS.md")
 //
 function resolveProviderAndModel() {
     const explicitProvider = process.env.ADVISOR_PROVIDER?.toLowerCase();
     const rawModel = process.env.ADVISOR_MODEL;
     if (!rawModel)
         return undefined;
-    // Option 1: explicit ADVISOR_PROVIDER + ADVISOR_MODEL (recommended)
     if (explicitProvider) {
+        // "openai" provider in opencode uses OpenAI's Responses API which most
+        // compatible endpoints don't support. Use @ai-sdk/openai-compatible instead,
+        // which calls the standard /v1/chat/completions endpoint.
+        if (explicitProvider === "openai") {
+            return {
+                provider: "openai-compat",
+                model: rawModel,
+                fullModel: `openai-compat/${rawModel}`,
+                npm: "@ai-sdk/openai-compatible",
+            };
+        }
         return {
             provider: explicitProvider,
             model: rawModel,
             fullModel: `${explicitProvider}/${rawModel}`,
         };
     }
-    // Option 2: legacy "provider/model" format in ADVISOR_MODEL
+    // Legacy "provider/model" format in ADVISOR_MODEL
     if (rawModel.includes("/")) {
         const [provider, ...rest] = rawModel.split("/");
         return {
@@ -44,22 +55,28 @@ function resolveProviderAndModel() {
             fullModel: rawModel,
         };
     }
-    // Just a model name with no provider — default to openai
+    // Just a model name with no provider — use openai-compatible
     return {
-        provider: "openai",
+        provider: "openai-compat",
         model: rawModel,
-        fullModel: `openai/${rawModel}`,
+        fullModel: `openai-compat/${rawModel}`,
+        npm: "@ai-sdk/openai-compatible",
     };
 }
 function buildOpencodeConfig() {
     const resolved = resolveProviderAndModel();
     const apiKey = process.env.ADVISOR_API_KEY;
     const baseURL = process.env.ADVISOR_BASE_URL;
-    const npm = process.env.ADVISOR_NPM;
+    const npm = process.env.ADVISOR_NPM || resolved?.npm;
+    const instructions = process.env.ADVISOR_INSTRUCTIONS;
     const config = {
         // Disable title generation (it uses small_model which may not work with custom providers)
         small_model: resolved?.fullModel || undefined,
+        // Additional instruction files (e.g. AGENTS.md)
+        ...(instructions ? { instructions: [instructions] } : {}),
     };
+    if (instructions)
+        console.error(`[advisor] Instructions: ${instructions}`);
     if (resolved) {
         config.model = resolved.fullModel;
         console.error(`[advisor] Provider: ${resolved.provider}, Model: ${resolved.model}`);
@@ -151,8 +168,10 @@ function sleep(ms) {
 }
 async function askOpencode(prompt, systemPrompt) {
     const client = await getOpencodeClient();
+    const directory = process.env.ADVISOR_DIRECTORY;
     const sessionResult = await client.session.create({
         title: "Advisor Query",
+        ...(directory ? { directory } : {}),
     });
     if (!sessionResult.data) {
         throw new Error("Failed to create opencode session");
@@ -166,6 +185,7 @@ async function askOpencode(prompt, systemPrompt) {
                 sessionID: sessionId,
                 system: systemPrompt,
                 ...(modelOverride ? { model: modelOverride } : {}),
+                ...(directory ? { directory } : {}),
                 parts: [{ type: "text", text: prompt }],
             });
             console.error(`[advisor] Prompt submitted async`);
@@ -381,7 +401,8 @@ server.registerTool("get_second_opinion", {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("[advisor] MCP Advisor server running on stdio");
+    const dir = process.env.ADVISOR_DIRECTORY;
+    console.error(`[advisor] MCP Advisor server running on stdio${dir ? ` (directory: ${dir})` : ""}`);
 }
 main().catch((error) => {
     console.error("[advisor] Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gopersonal/advisor",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "main": "./build/index.js",
   "bin": {