[maxmad64bis]

⚠️ base-red inherited: #17219

Summary

The served catalog stayed frozen on an earlier calculation even though config and gateway had moved, so new branches stayed missing until a service restart. The plugin published the catalog once at install and never refreshed it, so the configured cache TTL had no effect. Now the catalog refreshes in the background on that TTL, and the served catalog follows the gateway without a restart.

Related Issues

• No linked issue — reproduced on the release base

Target Branch

• Base is the active release/v3.8.x branch (the highest open release/v*), not main
• New feature? From 3.8.55 on it is held with the v4-feature label for the v4 channel

Validation

• Change type: provider
• Focused tests and category gates from the golden path
• npm run lint
• Reconciled with the current active release base; focused checks rerun afterward
• Production-code changes include a new or updated automated test in this PR

Tests Added Or Updated

• @omniroute/opencode-plugin-v2/tests/catalog-freshness.test.ts — background refresh serves new gateway entries, unchanged catalogs skip reload, refreshes never overlap, one loop per provider id, 60 second floor, a failed refresh keeps the last known catalog, and the stale memory entry is dropped on credential change, plus gateway change, snapshot coherence and branch reactivation without a restart.

Coverage Notes

N/A — no file under the repository's src/, open-sse/, electron/, or bin/ is changed; the plugin lives under @omniroute/opencode-plugin-v2/.

Reviewer Notes

• Behavior: the served catalog goes from frozen after install to following the gateway within modelCacheTtlMs (five minutes by default), plus one fetch; a failed refresh keeps the last known catalog, and a change that only touches enrichment (names or prices) may not trigger a host reload.
• Follow-up: the cast on the global loop registry stays confined to one line and could be replaced by a typed guard later; the branch-name charset comes from the worktree and is not addressed here.
• Merge: after feat(plugin): rework picker names to Provider - Model format #18230.