opencode-ufr 0.2.3 → 0.2.5

package/README.md

@@ -23,6 +23,23 @@ opencode plugin add opencode-ufr     # registers the plugin
 
 (or add `"plugins": ["opencode-ufr"]` to your `opencode.json` manually.)
 
+## Updating
+
+opencode loads plugins inside a background server (`opencode serve --service`)
+that keeps running after you close the TUI, and it keeps using the plugin
+version it loaded when it started — a new release only arrives once that server
+restarts:
+
+```bash
+bun add -g opencode-ufr@latest          # update the `ufr` CLI
+pkill -f "opencode serve --service"     # stop opencode's background server
+```
+
+The next opencode start installs the latest plugin. If it still loads the old
+one, delete opencode's cached copy (`~/.cache/opencode/npm/opencode-ufr@latest`)
+and start opencode again. On Windows, end the `opencode` server process in Task
+Manager instead of `pkill`.
+
 ## Setup
 
 **Inside opencode — the normal way:** open `/connect`, pick **Uni Freiburg**,
@@ -66,9 +83,9 @@ ufr disconnect   # remove everything: keys, uni login, config, gateway
 Removing the **unifreiburg** integration in opencode's `/connect` panel does the
 same as `ufr disconnect`: the stored keys and uni login are wiped, the gateway
 stops, and the models disappear from the picker on the next opencode start.
-While opencode runs, the removal is noticed within a minute. If opencode was
-closed when you removed the integration, run `ufr disconnect` once to wipe what
-is left.
+While opencode runs, connecting and removing are noticed within seconds. If
+opencode was closed when you removed the integration, run `ufr disconnect` once
+to wipe what is left.
 
 ## The built-in VPN
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ufr",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Uni Freiburg (UFR) Open WebUI models in opencode — local gateway with key pool, UFR-aware rate limiting, circuit breaker and fallbacks",
   "license": "MIT",
   "type": "module",

package/src/plugin/connect.ts

@@ -13,6 +13,9 @@ import { applyKeyChange, disconnectAll } from "../cli/keys"
 
 export const UFR_INTEGRATION_ID = "unifreiburg"
 
+/** opencode has no connection events for plugins, so the watcher polls; seconds keep /connect feeling immediate. */
+export const CONNECT_POLL_MS = 5_000
+
 export type ConnectDeps = {
   ctx: any // opencode plugin context (integration + storage domains)
   paths: Paths
@@ -23,6 +26,8 @@ export type ConnectDeps = {
   register?: () => Promise<boolean | void> | boolean | void
   /** Whether setup() already registered the provider (it does when a connection exists at startup). */
   providerRegistered?: boolean
+  /** Poll interval override (tests). */
+  pollMs?: number
 }
 
 type CredentialValue = { type?: string; key?: string; configuration?: Record<string, unknown> } | undefined
@@ -131,7 +136,18 @@ export async function registerConnect(d: ConnectDeps): Promise<ConnectRegistrati
   }
 
   await applyOnce()
-  const timer = setInterval(() => void applyOnce(), 60_000)
+  // A registration can take ~40 s (gateway boot) — never start a second one while it runs.
+  let busy = false
+  const tick = async () => {
+    if (busy) return
+    busy = true
+    try {
+      await applyOnce()
+    } finally {
+      busy = false
+    }
+  }
+  const timer = setInterval(() => void tick(), d.pollMs ?? CONNECT_POLL_MS)
   ;(timer as { unref?: () => void }).unref?.()
   return {
     stop: () => clearInterval(timer),

package/src/plugin/index.ts

@@ -10,6 +10,11 @@ import { toModelInfo } from "./model-info"
 
 const DAEMON_ENTRY = fileURLToPath(new URL("../daemon/main.ts", import.meta.url))
 
+// opencode takes a request's key from the provider's integration (default: the one with the provider's
+// id), and a key credential there replaces settings.apiKey. The /connect credential on "unifreiburg"
+// holds the UFR keys, not the gateway token — so link the provider to an integration with no credential.
+const GATEWAY_INTEGRATION_ID = "opencode-ufr-gateway"
+
 function log(msg: string): void {
   console.warn(`[opencode-ufr] ${msg}`)
 }
@@ -58,6 +63,7 @@ async function registerProvider(
       info: {
         id: providerId,
         name: providerName,
+        integrationID: GATEWAY_INTEGRATION_ID,
         activation: "enabled",
         package: "@opencode/ai/providers/openai-compatible",
         settings: { baseURL: `http://127.0.0.1:${conn.port}/v1`, apiKey: conn.token },