Repository navigation
Releases
Releases · a2way-com/opencode-model-refresh
v1.1.0
opencode-model-refresh v1.1.0
This release adds account-specific provider support, OAuth credentials, a model-refresh history window, and a large reliability pass over the reconciliation engine.
Highlights
Provider variants without extra config
- Adapter and integration are now inferred from the provider definition’s
integrationID. "providers": ["opencode-go"]works directly, reusing theopencodeadapter and connection.- Explicit
adapter/integrationIDoverrides still work.
OAuth credentials
- Credentials are read as typed values: API keys and OAuth access tokens.
- OAuth
401responses are treated as inconclusive (expired token), not as model removal. - API-key
401remains a definite refusal.
Provider metadata and headers
- Provider-defined headers such as
x-opencode-org-idand billing metadata are forwarded on/modelsand probe requests. - Newly discovered models merge matching models.dev metadata: names, limits, costs, variants, capabilities, package and settings.
- The merged catalogue is persisted, so metadata survives restarts even after a model is removed.
History window
- New
/refresh-models-historycommand opens a window with recent additions, removals,no changecycles, guard events and errors. - Available in Desktop and the terminal, and from the command palette under Models.
- The RPC
history()method now has a UI.
Timeline improvements
changes.txtis always created.- No-change cycles are recorded as
no change. - A baseline inventory is shown when no change history exists.
- Stale errors from partially reloaded development builds are filtered out.
Reliability
- Fixed
ReferenceError: isGuarded is not definedby inlining the wipe-guard check. mapLimitcan no longer leave probe results partially filled./modelsrequests now time out after 30 seconds.- Storage read/write failures no longer abort reconciliation.
- Repeated identical errors are deduplicated.
- Cached probe verdicts are pruned for models that are no longer reachable.
429responses honorRetry-After, falling back to 15 minutes.- Recent rate limits take precedence over older successes.
- Catalogue storage is capped at 5,000 entries.
refreshMinutesandprobeConcurrencyare validated.
Behavior changes
- The
opencodeadapter no longer restricts probing to free models. On an API-key-only setup, paid models that return401will be removed; with OAuth/OC-Go they are probed normally. probeConcurrencyoption added (per provider or globally, default5).opencode-gocan be configured as a plain provider string.
Tooling
- Strict TypeScript configuration (
tsconfig.json,npm run typecheck). npm run checkruns typecheck, tests and bundle freshness.- Test suite expanded to 56 tests, including reconciliation integration tests, probe behavior, credentials, binding inference, history rendering and probe scheduling.
- Desktop bundle rebuilt and committed.
Upgrade
opencode plugin add opencode-model-refreshOr update the version in your plugin configuration. Runtime identifiers, state paths and the RPC contract are unchanged.
npm: opencode-model-refresh@1.1.0
Tag: v1.1.0
v1.0.0
v1.0.0
Initial release of opencode-model-refresh: a multi-provider OpenCode plugin that reconciles model pickers with live provider APIs.
Highlights
- Reconciles configured providers with their live
/modelsendpoints. - Probes model availability with minimal chat completions.
- Distinguishes definite refusals from inconclusive results such as timeouts,
429, and5xx. - Removes only definitely refused models; inconclusive probes never remove models.
- Applies a wipe guard when every live probe fails.
- Supports multiple providers with per-provider adapters, verdict caches, timers, and status reports.
- Reuses OpenCode’s existing provider credentials; the plugin has no
apiKeyoption. - Endpoints come only from provider
settings.baseURL. - Adds
/refresh-modelsand/refresh-models-forcefor Desktop and TUI. - Refresh commands run through RPC and do not create sessions or wake the model.
- Persists status reports and per-provider change timelines under
~/.local/state/opencode/com.a2way.opencode-model-refresh/.
Included adapters
nvidia: NVIDIA NIM dialect handlingopencode: OpenCode hosted inference free tier
Installation
From npm:
opencode plugin add opencode-model-refreshFrom GitHub:
opencode plugin add github:a2way-com/opencode-model-refreshNotes
- With no
providersoption, the plugin does nothing. - Built-in adapters are registered in
src/index.ts. - Desktop slash commands are provided by the prebuilt
dist/gui-experimental.cjsbundle.