core: all models.dev providers disappear when the catalog fetch fails #57458

Summary

When the models.dev catalog fetch fails, OpenCode ends up with an empty provider registry: every catalog provider disappears — including github-copilot, even though its credential is valid and the Copilot API answers HTTP 200 in 0.65s. Only the providers advertised by the OpenCode Console config (opencode-go) survive, because they are registered through a different code path.

GitHub Copilot has a second, independent gate: its plugin registers the provider only if the model sync succeeded, and that sync has a hard-coded 5s timeout. One timeout removes the provider, and nothing ever retries it.

Environment

• opencode version: 2.1.1
• OS: Ubuntu, Linux x64
• Terminal: xterm-256color, COLORTERM=truecolor
• Shell: /bin/bash
• Install/channel: latest
• Active plugins: none provider-related (local guardrail plugins and MCP servers only; none of them touch the provider layer)

Reproduction

Deterministic repro that does not involve GitHub Copilot at all:

1. Start a server with the network to models.opencode.ai blocked:

   HTTPS_PROXY=http://127.0.0.1:9 HTTP_PROXY=http://127.0.0.1:9 opencode serve --port 46003
   

2. opencode api --server http://127.0.0.1:46003 provider.list → {"data":[]} — zero providers, even though the local catalog cache holds 231 providers.
3. Unblock the network, restart, run the same command → the providers are back.

On the normal (networked) install:

1. ANTHROPIC_API_KEY=dummy opencode models | grep -c '^anthropic/' → 0
2. GITHUB_TOKEN=dummy opencode models | grep -c '^github-copilot/' → 0
3. opencode models | grep -c '^opencode-go/' → 29 — only the console-provided provider survives.

Copilot-specific path:

1. opencode auth login github-copilot (device code) → credential stored, active: true
2. curl -sS -m 10 -H "Authorization: Bearer $TOKEN" https://api.individual.githubcopilot.com/models → HTTP 200 in 0.65s
3. opencode models | grep -c '^github-copilot/' → 0
4. server log: WARN ... "failed to sync GitHub Copilot models" cause="TimeoutError: The operation timed out."

Expected Behavior

• A failed models.dev fetch should not empty the provider registry: the cached catalog should be used, or the previously loaded registry should be kept.
• A provider whose credential is valid should stay registered even when the model sync fails, and the sync should be retried.

Actual Behavior

• The provider registry is populated from a live fetch of https://models.opencode.ai/api.json. The cache written by the same service (models-dev:catalog in the kv table, 231 providers, freshly written) did not seed the registry, so a failed fetch leaves zero providers.
• The GitHub Copilot plugin only registers the provider on sync success:

  if (l.models) { h.add({ info: S.provider, models: ..., sourceConnection: l.connection }); return }
  for (let F of S.models.keys()) h.models.update(...)   // else: rewrites packages, never adds the provider

  and it also bails out earlier with if (!S) return when github-copilot is not already in the registry.
• The sync uses AbortSignal.timeout(5000). The endpoint answers in 0.65s via curl, but the log shows the timeout.
• The plugin re-syncs only on integration.Switched (new login / credential switch) or server start. opencode api POST /api/location/reload does not re-trigger it, so the state is sticky.
• Provider availability is non-deterministic: a freshly started server first listed github-copilot, anthropic, opencode, and a few minutes later the same server listed only opencode-go.

Additional Context

• Failed to fetch models.dev appears 42 times in ~/.local/share/opencode/log/opencode.log between 2026-09-30 and now, with getaddrinfo ETIMEOUT models.opencode.ai and TimeoutError: Operation timed out after '10s'. The refresh runs every 5 minutes.
• failed to sync GitHub Copilot models appears 6 times in the same log.
• opencode.provider.opencode is unaffected because it takes its providers from the Console config (GET /api/v2/config → providers.opencode-go), not from models.dev.
• Please see OpenAI models disappear when OpenCode Zen or Go is connected #52363 (already suspects that models.dev records never reach provider state), Github Copilot models disappear when a Go/Zen API key is also stored #55082 (same symptom with a Go/Zen credential stored) and GitHub Copilot model sync times out on 2.0.32 (manual API works) #57264 (the Copilot sync timeout).
• No workaround found: Github Copilot models disappear when a Go/Zen API key is also stored #55082 suggests deleting the console credential rows from the DB, which just trades one provider for another.