opencode-plugboard 0.21.1 → 0.22.0

package/README.md

@@ -43,7 +43,7 @@ export PLUGBOARD_KEY_MY_APP=choose-a-long-random-string
 {
   "plugins": [
     {
-      "package": "opencode-plugboard@0.21.1",
+      "package": "opencode-plugboard@0.22.0",
       "options": {
         "keys": { "my-app": "{env:PLUGBOARD_KEY_MY_APP}" },
         "models": ["anthropic/claude-sonnet-4-6", "github-copilot/*", "opencode-go/glm-5.3-flash"],
@@ -390,7 +390,7 @@ A server shared by a Discord bot, n8n, Open WebUI and a coding agent, with most
 {
   "plugins": [
     {
-      "package": "opencode-plugboard@0.21.1",
+      "package": "opencode-plugboard@0.22.0",
       "options": {
         // Reachable from the LAN. Non-loopback hosts refuse to start without keys.
         "listen": { "host": "10.0.1.50", "port": 4010 },
@@ -460,6 +460,17 @@ One page per client, with the config, a chat, a tool call, structured output and
 | pydantic-ai | [pydantic-ai][client-pydantic-ai] | pass with `OpenAIChatModel` |
 | Open WebUI | [open-webui][client-open-webui] | pass over its HTTP API; no browser, no structured output in its UI |
 | n8n | [n8n][client-n8n] | pass with "Use Responses API" off |
+| Claude Code | [claude-code][client-claude-code] | pass: text and a tool turn through `/v1/messages`; needs `maxTools` above 36 |
+| Codex CLI | [codex-cli][client-codex-cli] | docs only, not run yet (Responses API) |
+| Continue | [continue][client-continue] | docs only, not run yet |
+| Kilo Code | [kilo-code][client-kilo-code] | docs only, not run yet |
+| LibreChat | [librechat][client-librechat] | docs only, not run yet |
+| Zed | [zed][client-zed] | docs only, not run yet |
+| OpenAI Agents SDK (Python) | [openai-agents][client-openai-agents] | pass on Responses and Chat Completions: text, stream, tools, structured output |
+| LiteLLM (as a client) | [litellm-client][client-litellm] | pass: text, stream, tools |
+| Instructor | [instructor][client-instructor] | pass: TOOLS, JSON_SCHEMA and partial streaming modes |
+| DSPy | [dspy][client-dspy] | pass: Predict, ChainOfThought, typed output |
+| Aider | [aider][client-aider] | pass: one scripted `--message` run |
 | Anything else | [any-app][client-any-app] | base URL, key, model id |
 
 Each run drove the client's own SDK or API against a dev server at an earlier commit: a plain chat, a tool round trip, streaming, an image and structured output on `fast`, a Claude model and a ChatGPT model. A pass is not a clean sweep, and the notes say where it was not. The latest full run is in [compat/results/release-candidate.md][release-candidate].
@@ -538,4 +549,15 @@ Not affiliated with or endorsed by OpenAI, Anthropic, Google, GitHub or Microsof
 [client-pydantic-ai]: https://jjjermiah.github.io/opencode-plugboard/clients/pydantic-ai
 [client-open-webui]: https://jjjermiah.github.io/opencode-plugboard/clients/open-webui
 [client-n8n]: https://jjjermiah.github.io/opencode-plugboard/clients/n8n
+[client-claude-code]: https://jjjermiah.github.io/opencode-plugboard/clients/claude-code
+[client-codex-cli]: https://jjjermiah.github.io/opencode-plugboard/clients/codex-cli
+[client-continue]: https://jjjermiah.github.io/opencode-plugboard/clients/continue
+[client-kilo-code]: https://jjjermiah.github.io/opencode-plugboard/clients/kilo-code
+[client-librechat]: https://jjjermiah.github.io/opencode-plugboard/clients/librechat
+[client-zed]: https://jjjermiah.github.io/opencode-plugboard/clients/zed
+[client-openai-agents]: https://jjjermiah.github.io/opencode-plugboard/clients/openai-agents
+[client-litellm]: https://jjjermiah.github.io/opencode-plugboard/clients/litellm-client
+[client-instructor]: https://jjjermiah.github.io/opencode-plugboard/clients/instructor
+[client-dspy]: https://jjjermiah.github.io/opencode-plugboard/clients/dspy
+[client-aider]: https://jjjermiah.github.io/opencode-plugboard/clients/aider
 [client-any-app]: https://jjjermiah.github.io/opencode-plugboard/clients/any-app

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-plugboard",
-  "version": "0.21.1",
+  "version": "0.22.0",
   "type": "module",
   "license": "MIT",
   "description": "Use the ChatGPT, Claude, Copilot and OpenCode Go logins in your OpenCode server from any app: an OpenCode V2 plugin serving OpenAI, Anthropic and Gemini compatible APIs.",
@@ -32,6 +32,7 @@
     "flake-hunt": "bun .github/scripts/flake-hunt.ts",
     "coverage-manifest": "bun .github/scripts/coverage-manifest.ts",
     "live-matrix": "bun test/live/matrix.ts",
+    "compat:python": "uv run --project compat/py python compat/py/clients/run_all.py",
     "build:tui": "bun .github/scripts/build-tui.ts",
     "prepack": "bun run build:tui",
     "smoke:pack": "bun .github/scripts/smoke-pack.ts",

package/src/usage.ts

@@ -9,10 +9,11 @@
  * Where it lives: the live aggregate is in memory on the process runtime (`src/runtime.ts`), so it
  * survives a plugin generation, and each day is persisted to the plugin's host storage as JSON under
  * `usage/<app>/<YYYY-MM-DD>`. Every write comes from request handling (`withUsage` and the route's
- * request log point), never from plugin setup or a finalizer (docs/architecture.md, I23). A day is
- * written at most every `FLUSH_MS`: a change is persisted by the first request that finds the last
- * write that old, so the stored copy can lag a quiet period behind memory. Queries read memory first,
- * so a report is never stale.
+ * request log point), never from plugin setup or a finalizer (docs/architecture.md, I23). A change is
+ * written as it lands; while a write of that day is in flight, later changes wait for it and go out
+ * in the next write, so the stored copy keeps up with every change (#241: a debounce kept the request
+ * count of a burst in memory, and a restart dropped it). Queries read memory first, so a
+ * report is never stale.
  *
  * Retention: days older than `usage.retentionDays` are deleted from request handling, one bounded
  * page of keys at a time and at most once per `PRUNE_EVERY_MS`.
@@ -48,8 +49,6 @@ export const GENERATION_ROUTES: ReadonlySet<string> = new Set([
 
 const DAY_MS = 86_400_000
 const KEY_PREFIX = "usage/"
-/** A changed day is written at most this often. */
-const FLUSH_MS = 10_000
 /** Retention runs at most this often, and each run reads one page of keys. */
 const PRUNE_EVERY_MS = 10 * 60_000
 const PRUNE_PAGE = 200
@@ -417,7 +416,6 @@ interface Entry {
   /** Bumped by every change; `flushedVersion` is the version last persisted. */
   version: number
   flushedVersion: number
-  flushedAt: number
   flushing?: Promise<void>
 }
 
@@ -517,28 +515,31 @@ export function createUsageRecorder(deps: UsageRecorderDeps): UsageRecorder {
     // Another request may have loaded the day while this one read storage: keep the first entry.
     const current = state.entries.get(key)
     if (current) return current
-    const entry: Entry = { key, app, date, day: stored ?? emptyDay(), version: 0, flushedVersion: 0, flushedAt: 0 }
+    const entry: Entry = { key, app, date, day: stored ?? emptyDay(), version: 0, flushedVersion: 0 }
     state.entries.set(key, entry)
     return entry
   }
 
-  /** Persists a changed day when the last write is older than `FLUSH_MS`. The JSON is taken now; a later change waits for the next write. */
-  function flushIfDue(entry: Entry, at: number): void {
-    if (entry.version === entry.flushedVersion || entry.flushing !== undefined || at - entry.flushedAt < FLUSH_MS) return
+  /**
+   * Persists a changed day. The JSON is taken now. A write already in flight is not raced: when it lands,
+   * a change made meanwhile is written next. A failed write is logged and the day stays changed, so the
+   * next change tries again.
+   */
+  function flushIfDue(entry: Entry): void {
+    if (entry.version === entry.flushedVersion || entry.flushing !== undefined) return
     const version = entry.version
     const json = JSON.stringify(entry.day)
-    entry.flushedAt = at
-    entry.flushing = storage
-      .put(entry.key, json)
-      .then(
-        () => {
-          entry.flushedVersion = version
-        },
-        (error) => logError("usage.flush_failed", { app: entry.app, date: entry.date, error: errorMessage(error) }),
-      )
-      .finally(() => {
+    entry.flushing = storage.put(entry.key, json).then(
+      () => {
+        entry.flushedVersion = version
         entry.flushing = undefined
-      })
+        flushIfDue(entry)
+      },
+      (error) => {
+        entry.flushing = undefined
+        logError("usage.flush_failed", { app: entry.app, date: entry.date, error: errorMessage(error) })
+      },
+    )
   }
 
   /** Deletes the days older than the retention window: one page of keys per run, at most once per `PRUNE_EVERY_MS`. */
@@ -576,7 +577,7 @@ export function createUsageRecorder(deps: UsageRecorderDeps): UsageRecorder {
         if (!entry) return
         update(entry.day)
         entry.version++
-        flushIfDue(entry, at)
+        flushIfDue(entry)
         maybePrune(at)
       })
       .catch((error) => logError("usage.record_failed", { app, error: errorMessage(error) }))