Skip to content
Source
Sign inSign up
TanStack/schemas

OpenCode: Zen and Go doc pages removed upstream (V2 console docs); polls fail on 404 #307

Send to my agent
Closedposthog[bot](GitHub profile, opens in a new tab) opened this issue 0 comments

Symptom

Since 2026-10-12 11:27 UTC, every models poll for opencode and opencode-go has failed:

  • ingest_failed · opencode · fetch failed: https://opencode.ai/docs/zen.md → 404 Not Found
  • ingest_failed · opencode-go · fetch failed: https://opencode.ai/docs/go.md → 404 Not Found

The docs load throws out of listModels, so the whole poll fails and the stored rows are kept unchanged. No stored price is lost.

Cause: an upstream docs migration, not a parser bug

  • On 2026-10-12, OpenCode commit 25053bbd ("docs: replace old Zen and Go pages with V2 console docs", anomalyco/opencode#54761) removed packages/web/src/content/docs/{zen,go}.mdx in every locale. /docs/zen, /docs/go and both .md twins now return 404.
  • The replacement pages are https://opencode.ai/v2/docs/console/models/ (formerly Zen) and https://opencode.ai/v2/docs/console/go/. They serve HTML only (/v2/docs/console/go.md → 404). The sources are MDX in GitHub: services/www/src/docs/content/console/{models,go}.mdx.
  • Zen is now "OpenCode Console", and its documented endpoints moved from https://opencode.ai/zen/v1/... to https://opencode.ai/inference/v1/... (responses, messages, chat/completions). https://opencode.ai/inference/v1/models answers 200, and the old https://opencode.ai/zen/v1/models listing still answers 200 too.
  • The Go page keeps the same Endpoint and Usage-limits tables, and its endpoints are still https://opencode.ai/zen/go/v1/....

Decision (2026-10-13)

Use https://models.dev/api.json instead of the docs pages. It is OpenCode's own catalog and both adapters already read it (opencode-catalog.ts) for context, modalities, reasoning and release date; only price, display name, activity and the bound route came from the removed pages.

Checked against the live file on 2026-10-13:

  • cost is published for all 120 opencode and all 36 opencode-go models, including the > 272K context tier. The adapters ignore it today.
  • npm is published per provider (@ai-sdk/openai-compatible) with per-model provider.npm overrides (65 Zen, 13 Go). This is the package column the docs Endpoints table had.
  • api is https://opencode.ai/inference/v1 for opencode and https://opencode.ai/inference/go/v1 for opencode-go.
  • doc already points at the v2 console pages.

What to build:

  1. Source: drop the docs/zen.md and docs/go.md fetches from listModels and fetchSpec in both adapters. No HTML or MDX parsing.
  2. Zen price: compile the card from models.dev cost, tiers included, with factSources.pricing naming models.dev.
  3. Routes: derive the route from the model's package (provider.npm, else the provider's npm) with the mapping parseDocsEndpoints used: @ai-sdk/anthropic → v1/messages, @ai-sdk/openai → v1/responses, @ai-sdk/google → v1/models/<id>, @ai-sdk/openai-compatible → v1/chat/completions. The path is now derived from the package, not stated per model, and factSources should say so.
  4. Base URL: follow models.dev api, so opencode moves to /inference/v1. This changes endpoint ids.
  5. tryDocs: not needed once the docs fetch is gone.

Still open, do not guess:

  • Go price: docs/source-silent/opencode.md says Go subscription-accounting rates are distinct from billed token prices. Whether models.dev's Go cost is a billed token price has not been checked. Leave Go pricing as it is until it has.
  • Go base URL: models.dev says /inference/go/v1, while the v2 Go page (per the findings above) still documents /zen/go/v1. Confirm which one serves before moving Go's endpoint ids.

Done when a full models-poll cycle emits no ingest_failed for opencode / opencode-go, and their routes and prices come from the chosen source.


Created with PostHog Desktop

  1. tombeckenham closed this

Sign in to join this conversation.