opencode-agy-bridge 0.2.1 → 0.2.3

package/README.md

@@ -23,133 +23,81 @@ opencode TUI
 
 ## Installation
 
-### 1. Automatic Installation (Recommended)
+### Automatic (hands-free)
 
-If you are using OpenCode's built-in plugin manager, **you do not need to run any commands** in your terminal. OpenCode can automatically fetch and install the package from npm if you specify the package name with its version in your `opencode.json` configuration file.
+Add the package with its version to `~/.config/opencode/opencode.json`. OpenCode will download and resolve it from npm automatically — no terminal commands needed.
 
-See the [Configuration](#configuration) section below for details.
-
-### 2. Manual Global Installation
-
-If you prefer to install it globally yourself using a package manager:
+### Manual global install
 
 ```bash
-# Using npm
 npm install -g opencode-agy-bridge
-
-# Using Bun
-bun install -g opencode-agy-bridge
-
-# Using pnpm
-pnpm add -g opencode-agy-bridge
+# or: bun install -g opencode-agy-bridge
+# or: pnpm add -g opencode-agy-bridge
 ```
 
-### 3. Local Development Installation
-
-If you prefer to build from source:
+### Build from source
 
 ```bash
 git clone https://github.com/raultov/opencode-agy-bridge.git
 cd opencode-agy-bridge
-
-# Using Bun (recommended)
-bun install
-bun run build
-bun test       # verify all tests pass
-
-# Or using pnpm/npm
-pnpm install && pnpm run build && pnpm test
+bun install && bun run build && bun test
 ```
 
-## Features
-
-- **Robust Delta Extraction:** Automatically normalizes `\r\n` (CRLF) and `\n` (LF) line endings, tolerates trailing whitespace/newline differences, and implements suffix-based alignment to support seamless recovery during context window truncation.
-
 ## Configuration
 
-Add the plugin and provider to your `~/.config/opencode/opencode.json` configuration file:
+Add the plugin and provider to `~/.config/opencode/opencode.json`.
 
-### For Automatic Installation (Hands-free)
+> The **node.js** path represents a **package** (directory or npm package name), not a `.js` file. Pointing `"npm"` at a `.js` file will cause a `ProviderInitError` because opencode internally appends `/provider` to resolve the exports map.
 
-Just add the package directly with the desired version tag. OpenCode will download and resolve it automatically from npm:
+### Recommended: automatic from npm
 
 ```jsonc
 {
   "plugin": [
-    // ...your existing plugins...
-    "opencode-agy-bridge@0.2.1"
+    "opencode-agy-bridge@0.2.3"
   ],
   "provider": {
-    // ...your existing providers...
     "agy": {
-      "npm": "opencode-agy-bridge/provider",
+      "npm": "opencode-agy-bridge",
       "name": "Google Antigravity (via agy CLI)",
-      "options": {
-        "binary": "agy",
-        "timeoutMs": 300000
-      },
-      "models": {
-        "antigravity": {
-          "name": "Antigravity (server-selected Gemini)"
-        }
-      }
+      "options": { "binary": "agy", "timeoutMs": 300000 },
+      "models": { "antigravity": { "name": "Antigravity (server-selected Gemini)" } }
     }
   }
 }
 ```
 
-### For Manual Global Installation
+### Using npm global install path
 
 ```jsonc
 {
   "plugin": [
-    // ...your existing plugins...
     "opencode-agy-bridge"
   ],
   "provider": {
-    // ...your existing providers...
     "agy": {
-      "npm": "opencode-agy-bridge/provider",
+      "npm": "opencode-agy-bridge",
       "name": "Google Antigravity (via agy CLI)",
-      "options": {
-        "binary": "agy",
-        "timeoutMs": 300000
-      },
-      "models": {
-        "antigravity": {
-          "name": "Antigravity (server-selected Gemini)"
-        }
-      }
+      "options": { "binary": "agy", "timeoutMs": 300000 },
+      "models": { "antigravity": { "name": "Antigravity (server-selected Gemini)" } }
     }
   }
 }
 ```
 
-> [!NOTE]
-> If OpenCode has trouble resolving the global module name directly, you can replace the module names with their absolute paths pointing to your global `node_modules` folder (e.g., `"/usr/local/lib/node_modules/opencode-agy-bridge/dist/plugin.js"` for the plugin and `"/usr/local/lib/node_modules/opencode-agy-bridge/dist/provider.js"` for the provider).
-
-### For Local Development / Manual Installation
+### Local development (absolute paths)
 
 ```jsonc
 {
   "plugin": [
-    // ...your existing plugins...
     "/home/USER/workspace/opencode-agy-bridge/dist/plugin.js"
   ],
   "provider": {
-    // ...your existing providers...
     "agy": {
       "npm": "/home/USER/workspace/opencode-agy-bridge",
       "name": "Google Antigravity (via agy CLI)",
-      "options": {
-        "binary": "agy",
-        "timeoutMs": 300000
-      },
-      "models": {
-        "antigravity": {
-          "name": "Antigravity (server-selected Gemini)"
-        }
-      }
+      "options": { "binary": "agy", "timeoutMs": 300000 },
+      "models": { "antigravity": { "name": "Antigravity (server-selected Gemini)" } }
     }
   }
 }
@@ -157,6 +105,10 @@ Just add the package directly with the desired version tag. OpenCode will downlo
 
 Then restart OpenCode and run `/model` → select `agy/antigravity`.
 
+## Features
+
+- **Robust Delta Extraction:** Automatically normalizes `\r\n` (CRLF) and `\n` (LF) line endings, tolerates trailing whitespace/newline differences, and implements suffix-based alignment to support seamless recovery during context window truncation.
+
 ## Known limitations
 
 | Limitation | Detail |
@@ -183,35 +135,17 @@ src/
 
 ## Development
 
-Using **Bun**:
-```bash
-bun run build
-bun test
-```
-
-Using **pnpm**:
-```bash
-pnpm run build
-pnpm test
-```
-
-Using **npm**:
 ```bash
-npm run build
-npm test
+bun run build   # compile TypeScript
+bun test        # run test suite
 ```
 
 ## CI/CD (GitHub Actions)
 
-The project includes two GitHub Actions workflows:
-
-- **CI (`ci.yml`):** Runs on push and pull requests to `main` or `master` to compile the project and execute all unit tests using Bun.
-- **Release (`release.yml`):** Runs automatically when a new version tag matching `v*` (e.g., `v0.2.1`) is pushed to the repository. It automatically installs dependencies, builds, tests, and publishes the package to the public npm registry.
-
-Note that both `npm` and `pnpm` share the same public registry (`registry.npmjs.org`), so a single publish step makes the package installable by both package managers.
+- **CI (`ci.yml`):** Runs on push and pull requests to `main` — compiles and runs all tests.
+- **Release (`release.yml`):** Runs on `v*` tags — builds, tests, and publishes to npm.
 
 ### Setup
 
-To enable automated releases:
-1. Generate an Access Token with publish permissions on [npmjs.com](https://www.npmjs.com/).
-2. Add the token as a repository secret named `NPM_TOKEN` in your GitHub repository settings under **Settings** → **Secrets and variables** → **Actions**.
+1. Generate a Granular Access Token on [npmjs.com](https://www.npmjs.com/) with **Bypass 2FA** enabled.
+2. Add it as repository secret `NPM_TOKEN` in GitHub **Settings → Secrets and variables → Actions**.

package/dist/plugin.js

@@ -1,9 +1,9 @@
 const plugin = async () => ({
     "chat.headers": async (incoming, output) => {
-        // Only inject for our own provider
-        if (incoming.model.providerID !== "agy")
+        if (incoming?.model?.providerID !== "agy")
+            return;
+        if (!output?.headers)
             return;
-        // Pass the stable OpenCode session ID so agy can reuse conversations
         output.headers["x-agy-session-id"] = incoming.sessionID;
     },
 });

package/dist/provider.js

@@ -1,7 +1,7 @@
-import { runAgy } from "./agy-runner";
-import { snapshot, findNewConversation, defaultConversationsDir } from "./conversation-tracker";
-import { SessionStore } from "./session-store";
-import { flattenPrompt } from "./prompt-mapper";
+import { runAgy } from "./agy-runner.js";
+import { snapshot, findNewConversation, defaultConversationsDir } from "./conversation-tracker.js";
+import { SessionStore } from "./session-store.js";
+import { flattenPrompt } from "./prompt-mapper.js";
 import { randomUUID } from "node:crypto";
 const prevOutputs = new Map();
 export function extractDelta(prevOutput, fullText, conversationBound) {
@@ -49,8 +49,6 @@ function buildLanguageModel(modelId, opts) {
     const store = new SessionStore(opts.stateFile);
     const conversationsDir = opts.conversationsDir ?? defaultConversationsDir();
     const doGenerate = async (callOpts) => {
-        // Use the stable OpenCode session ID injected via plugin chat.headers hook.
-        // Falls back to providerMetadata or a random UUID for standalone/testing.
         const sessionId = callOpts.headers?.["x-agy-session-id"] ??
             callOpts.providerOptions?.agy
                 ?.sessionId ??
@@ -68,13 +66,11 @@ function buildLanguageModel(modelId, opts) {
         let before = null;
         try {
             before = conversationId ? null : await snapshot(conversationsDir);
-            // Only send new messages when conversation is already bound.
-            // agy preserves context internally via --conversation, so sending
-            // the full history each turn confuses it and causes hallucination.
             const newMessages = conversationId
                 ? callOpts.prompt.slice(processedMessages)
                 : callOpts.prompt;
             const prompt = flattenPrompt(newMessages);
+            console.error("[agy-bridge] doGenerate session=%s conv=%s msgs=%d/%d", sessionId.slice(0, 8), conversationId?.slice(0, 8) ?? "-", newMessages.length, callOpts.prompt.length);
             const result = await runAgy({
                 prompt,
                 cwd: process.cwd(),
@@ -195,19 +191,47 @@ function buildLanguageModel(modelId, opts) {
         doStream,
     };
 }
-export function createAgyProvider(opts) {
-    const resolvedOpts = opts ?? {};
-    const languageModel = (modelId) => buildLanguageModel(modelId, resolvedOpts);
+let factoryInitWarned = false;
+function unsupportedEmbeddingModel(modelId) {
     return {
-        languageModel,
-        textEmbeddingModel() {
+        specificationVersion: "v2",
+        provider: "agy",
+        modelId,
+        maxEmbeddingsPerCall: 0,
+        supportsParallelCalls: false,
+        doEmbed: async () => {
             throw new Error("agy bridge does not support text embeddings");
         },
-        imageModel() {
+    };
+}
+function unsupportedImageModel(modelId) {
+    return {
+        specificationVersion: "v2",
+        provider: "agy",
+        modelId,
+        maxImagesPerCall: 0,
+        doGenerate: async () => {
             throw new Error("agy bridge does not support image generation");
         },
     };
 }
+export function createAgyProvider(opts) {
+    const resolvedOpts = opts ?? {};
+    if (!factoryInitWarned) {
+        factoryInitWarned = true;
+        console.error("[agy-bridge] createAgyProvider called");
+    }
+    const languageModel = (modelId) => {
+        console.error("[agy-bridge] languageModel called for modelId=%s", modelId);
+        return buildLanguageModel(modelId, resolvedOpts);
+    };
+    return {
+        languageModel,
+        textEmbeddingModel: (modelId) => unsupportedEmbeddingModel(modelId),
+        imageModel: (modelId) => unsupportedImageModel(modelId),
+    };
+}
 export default function defaultFactory(opts) {
+    console.error("[agy-bridge] defaultFactory called");
     return createAgyProvider(opts);
 }

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "opencode-agy-bridge",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
-  "main": "./plugin.js",
+  "main": "./dist/provider.js",
   "license": "MIT",
   "description": "OpenCode plugin + provider that routes LLM prompts to agy (Google Antigravity CLI)",
   "exports": {
-    ".": "./dist/plugin.js",
-    "./provider": "./dist/provider.js"
+    ".": "./dist/provider.js",
+    "./provider": "./dist/provider.js",
+    "./plugin": "./dist/plugin.js"
   },
   "files": [
     "dist",
@@ -18,10 +19,16 @@
     "build": "tsc",
     "test": "bun test"
   },
-  "dependencies": {
+  "peerDependencies": {
     "@ai-sdk/provider": "^3.0.0"
   },
+  "peerDependenciesMeta": {
+    "@ai-sdk/provider": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@ai-sdk/provider": "^3.0.0",
     "@opencode-ai/plugin": "^1.15.12",
     "@types/bun": "latest",
     "typescript": "^5.8.0"