OpenCode: Zen and Go doc pages removed upstream (V2 console docs); polls fail on 404 #307
Send to my agentSymptom#
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 Foundingest_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) removedpackages/web/src/content/docs/{zen,go}.mdxin every locale./docs/zen,/docs/goand both.mdtwins 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/...tohttps://opencode.ai/inference/v1/...(responses, messages, chat/completions).https://opencode.ai/inference/v1/modelsanswers 200, and the oldhttps://opencode.ai/zen/v1/modelslisting 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:
costis published for all 120opencodeand all 36opencode-gomodels, including the> 272Kcontext tier. The adapters ignore it today.npmis published per provider (@ai-sdk/openai-compatible) with per-modelprovider.npmoverrides (65 Zen, 13 Go). This is the package column the docs Endpoints table had.apiishttps://opencode.ai/inference/v1foropencodeandhttps://opencode.ai/inference/go/v1foropencode-go.docalready points at the v2 console pages.
What to build:
- Source: drop the
docs/zen.mdanddocs/go.mdfetches fromlistModelsandfetchSpecin both adapters. No HTML or MDX parsing. - Zen price: compile the card from models.dev
cost, tiers included, withfactSources.pricingnaming models.dev. - Routes: derive the route from the model's package (
provider.npm, else the provider'snpm) with the mappingparseDocsEndpointsused:@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, andfactSourcesshould say so. - Base URL: follow models.dev
api, soopencodemoves to/inference/v1. This changes endpoint ids. tryDocs: not needed once the docs fetch is gone.
Still open, do not guess:
- Go price:
docs/source-silent/opencode.mdsays Go subscription-accounting rates are distinct from billed token prices. Whether models.dev's Gocostis 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
tombeckenham closed this
Sign in to join this conversation.