fix(core): fresh standalone run rejects a model before catalog refresh completes #56119

Activity

1. opencode-agent commented on Oct 16, 2026

   

   opencode-agentBot

   on Oct 16, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the detailed report. I can reproduce this on 2.0.31, and it still happens on the latest dev (ed772f5).

   What I did: in a fresh HOME/XDG state, I served the live catalog from a local endpoint via OPENCODE_MODELS_URL with a 3-second delay, then ran opencode run --standalone --format json --model <model> ....

   • On 2.0.31, opencode/glm-5.3-flash-free fails with {"type":"provider.no-route","message":"Model unavailable: opencode/glm-5.3-flash-free"}. Without the delay, the same run succeeds.
   • Current dev already includes glm-5.3-flash-free in its bundled catalog. So for dev the script adds a synthetic model, opencode/repro-only-model, to the served catalog only. With the delay it fails the same way (provider.no-route). Without the delay, OpenCode finds the model and sends the request upstream.

   On a fresh start, OpenCode uses the bundled catalog while the first refresh runs in the background, and an explicit model that is missing is rejected straight away, without waiting for that refresh. The script below reproduces it.

   Reproduction script (repro.py)

   #!/usr/bin/env python3
   """Repro for anomalyco/opencode#56119.
   
   Serves the live models.dev catalog (plus one extra synthetic model,
   opencode/repro-only-model, which no bundled snapshot contains) from a local
   server, optionally delaying the response, and runs a fresh-state
   `opencode run --standalone --model ...`.
   
   Usage: python3 repro.py [delay_seconds] [model]
     OC env var: command to run opencode (default: "opencode"), split on spaces.
     From a source checkout: BUN_OPTIONS="--conditions=browser --preload=<repo>/packages/tui/node_modules/@opentui/solid/scripts/preload.js" \
         OC="bun <repo>/packages/cli/src/index.ts" python3 repro.py 3
   
   Expected bug: with delay>0, exit 1 and {"type": "provider.no-route", "message": "Model unavailable: opencode/repro-only-model"}.
   Control: with delay 0 the model resolves locally (the fake id is then rejected upstream with provider.invalid-request).
   """
   import copy, http.server, json, os, pathlib, shlex, shutil, subprocess, sys, tempfile, threading, time, urllib.request
   
   delay = float(sys.argv[1]) if len(sys.argv) > 1 else 3
   model = sys.argv[2] if len(sys.argv) > 2 else "opencode/repro-only-model"
   cmd = shlex.split(os.environ.get("OC", "opencode"))
   
   catalog = json.loads(urllib.request.urlopen(urllib.request.Request("https://models.opencode.ai/api.json", headers={"User-Agent": "curl/8"})).read())
   extra = copy.deepcopy(catalog["opencode"]["models"]["glm-5.3-flash-free"])
   extra["id"] = "repro-only-model"
   extra["name"] = "Repro only model"
   catalog["opencode"]["models"]["repro-only-model"] = extra
   body = json.dumps(catalog).encode()
   
   class Catalog(http.server.BaseHTTPRequestHandler):
       def do_GET(self):
           time.sleep(delay)
           try:
               self.send_response(200)
               self.send_header("content-type", "application/json")
               self.end_headers()
               self.wfile.write(body)
           except (BrokenPipeError, ConnectionResetError):
               pass
       def log_message(self, *a):
           pass
   
   server = http.server.ThreadingHTTPServer(("127.0.0.1", 0), Catalog)
   threading.Thread(target=server.serve_forever, daemon=True).start()
   work = pathlib.Path(tempfile.mkdtemp(prefix="opencode-catalog-"))
   env = {"PATH": os.environ["PATH"], **({"BUN_OPTIONS": os.environ["BUN_OPTIONS"]} if "BUN_OPTIONS" in os.environ else {}), **({"OPENCODE_PRINT_LOGS": os.environ["OPENCODE_PRINT_LOGS"]} if "OPENCODE_PRINT_LOGS" in os.environ else {}), "HOME": str(work), "OPENCODE_DISABLE_PROJECT_CONFIG": "1",
          "OPENCODE_MODELS_URL": f"http://127.0.0.1:{server.server_port}"}
   for name, suffix in [("CONFIG", ".config"), ("DATA", ".local/share"), ("CACHE", ".cache"), ("STATE", ".local/state")]:
       env["XDG_" + name + "_HOME"] = str(work / suffix)
   try:
       print("delay:", delay, "model:", model)
       r = subprocess.run(cmd + ["run", "--standalone", "--format", "json", "--title", "probe", "--model", model,
                                 "Reply exactly OK. Do not use tools."],
                          cwd=work, env=env, stdin=subprocess.DEVNULL, capture_output=True, text=True, timeout=60)
       print("exit:", r.returncode)
       for line in r.stdout.splitlines():
           try:
               ev = json.loads(line)
           except ValueError:
               print("stdout:", line); continue
           if ev.get("type") == "error":
               print("error:", json.dumps(ev["error"]))
       if r.stderr.strip():
           print("stderr:", r.stderr.strip()[-1500:])
   except subprocess.TimeoutExpired:
       print("timeout")
   finally:
       server.shutdown(); shutil.rmtree(work, ignore_errors=True)

   Run it: python3 repro.py
2. opencode-agent

   added

   reproduced

   on Oct 16, 2026
3. reynold-hu commented on Oct 19, 2026

   

   reynold-hu

   on Oct 19, 2026

   Contributor

   More actions

   Opened #57100. ModelsDev now exposes ready after the first refresh attempt; explicit model resolution waits for it (10s cap) and re-samples the catalog for up to 1s before rejecting. Bundled models resolve immediately, a failed refresh still opens the latch, and the test harnesses that build SessionContext use the offline ModelsDev fixture. Tests: ready after refresh + a real-catalog late-model retry; full core 5551 pass with only the baseline Windows/timeout failures.
4. reynold-hu commented on Oct 19, 2026

   

   reynold-hu

   on Oct 19, 2026

   Contributor

   More actions

   The clean-branch PR is #57101 (the earlier #57100 was auto-closed as a duplicate against the pre-force-push head and cannot be reopened). #57101 has the 10-file catalog change and passes all four checks.
5. wthrbtn

   added a commit that references this issue on Nov 10, 2026

   freshen(opencode-ci-harness): diagnose row for the fresh-home catalog…

   ...

   49ff415