[Bug] Desktop v1.17.14 Provider.list() TypeError crash - UI shows no models/providers on every startup

[shiy08166-lab]

Bug Description

OpenCode Desktop v1.17.14 (Windows) crashes in Provider.list() on every startup with:

TypeError: Cannot read properties of undefined (reading 'provider')
    at Array.<anonymous> (.../node-C-Agor8X.js:687250:25)
    at Provider.list (.../node-C-Agor8X.js:694432:43)
    at Provider.list (definition) (.../node-C-Agor8X.js:687477:34)
    at ProviderHttpApi.list (.../node-C-Agor8X.js:402604:31)
    at ProviderHttpApi.list (definition) (.../node-C-Agor8X.js:694422:34)
    at Server.listen (.../node-C-Agor8X.js:696403:52)
    at Server.listen (definition) (.../node-C-Agor8X.js:696529:33)

The UI model selector is completely empty — no providers, no models. The CLI (opencode.exe from npm global install) works perfectly with the same ~/.config/opencode/opencode.json.

The crash was first noticed after installing the oh-my-openagent plugin. However, testing confirmed the crash persists even after removing the plugin and with a completely empty config, indicating it is a bug in the Desktop sidecar itself, not caused by the plugin.

Steps to Reproduce

1. Install OpenCode Desktop v1.17.14 on Windows
2. Open the app (with any opencode.json — even an empty {"model":"opencode/big-pickle"} triggers the crash)
3. Check ~/.local/share/opencode/log/opencode.log for the TypeError
4. Open the model selector in the UI — it is empty

What I Have Tried

• Custom providers with npm field on every provider → still crashes
• Single provider config → still crashes
• Completely empty config ({"model":"opencode/big-pickle"} only) → still crashes
• Cleared ~/.cache/opencode/models.json → recreated on startup, still crashes
• Removed oh-my-openagent from plugin array → still crashes
• CLI with identical config → works perfectly

The crash persists regardless of configuration. It appears to be a bug in the Desktop sidecar's Provider.list() implementation in v1.17.14.

Environment

• OS: Windows 11
• OpenCode Desktop: v1.17.14 (Electron)
• OpenCode CLI: npm global
• Config: ~/.config/opencode/opencode.json with custom OpenAI-compatible providers
• DB: ~/.local/share/opencode/opencode.db ~485MB

Key Logs

The error repeats 200+ times per startup session:

timestamp=2026-07-07T16:09:45.138Z level=ERROR run=db8127dc message=failed ref=err_4e1cf325 error="TypeError: Cannot read properties of undefined (reading 'provider')" cause="TypeError: Cannot read properties of undefined (reading 'provider')\n    at Array.<anonymous> (.../node-C-Agor8X.js:687250:25)\n    at Provider.list (.../node-C-Agor8X.js:694432:43)\n    at Provider.list (definition) (.../node-C-Agor8X.js:687477:34)\n    at ProviderHttpApi.list (.../node-C-Agor8X.js:402604:31)\n    at ProviderHttpApi.list (definition) (.../node-C-Agor8X.js:694422:34)\n    at Server.listen (.../node-C-Agor8X.js:696403:52)\n    at Server.listen (definition) (.../node-C-Agor8X.js:696529:33)"

renderer.log contains only benign warnings (ResizeObserver, aria-hidden). main.log shows sidecar spawns and server ready normally. The crash happens silently inside the sidecar's HTTP handler.

Impact

• Desktop UI is completely unusable (no models, no providers)
• CLI is unaffected (bypasses Provider.list)
• This blocks all Desktop users who rely on the model selector UI

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• Desktop app (Windows, v1.15.12): sidecar server exits on startup — "Unexpected server error", models/providers missing #29932: Desktop Windows sidecar exits on startup — models/providers missing (same symptom: UI shows no models/providers after startup on Windows)
• Opencode Desktop on Windows does not show any models, providers, or previous chat history on startup. #23011: Desktop Windows shows no models, providers, or chat history on startup (also involves the oh-my-opencode/oh-my-openagent plugin)

If your issue is the same root cause, please add a comment there instead so discussion stays consolidated. If you believe this is a distinct regression in v1.17.14's Provider.list() specifically, please clarify what makes it different from the above.

[shiy08166-lab]

Thanks for the duplicate check. I reviewed #29932 and #23011 — similar symptoms (no models/providers on Windows Desktop), but there is a key difference:

• Desktop app (Windows, v1.15.12): sidecar server exits on startup — "Unexpected server error", models/providers missing #29932 / Opencode Desktop on Windows does not show any models, providers, or previous chat history on startup. #23011: sidecar server exits on startup (process crash)
• This issue ([Bug] Desktop v1.17.14 Provider.list() TypeError crash - UI shows no models/providers on every startup #35772): sidecar stays running (server ready in main.log, sidecar process alive), but Provider.list() throws TypeError: Cannot read properties of undefined (reading '"'"'provider'"'"') silently inside the HTTP handler. The UI gets an error response, not a connection failure.

Additional context that may differentiate:

• I tested with a completely empty config ({"model":"opencode/big-pickle"} only, no custom providers, no plugins) — the crash still happens. This rules out provider config as the cause.
• The error is reproducible on every startup (200+ identical TypeErrors per session).
• CLI works perfectly with the same config (bypasses ProviderHttpApi.list).
• Desktop version: v1.17.14 (the other issues may be older versions).

If the maintainers determine this is the same root cause, happy to consolidate. But the stack trace (Provider.list at node-C-Agor8X.js:687250:25) and the fact that the sidecar stays alive suggest this might be a distinct regression in v1.17.14'"'"'s provider listing logic.

[shiy08166-lab]

⚠️ WARNING: Do not download opencode_patch.zip from @romeragakera43

This account was created today and is not a member of the OpenCode project. The linked zip file asks you to patch app.asar internals — this is a common supply-chain attack pattern. Do not download, extract, or run it.

Only trust responses from accounts with Member or Collaborator badges. Official fixes will come as version updates through the normal update channel, not as third-party zip patches.

I have reported the account to GitHub.

[CryptArchy]

Ran into the same Provider.list TypeError while debugging a plugin and can
offer a root-cause hypothesis plus a way to check it.

The only dereference in the Provider.list path that can produce
undefined is not an object (evaluating '….provider') is the plugin hooks
loop in the Provider state build (provider/provider.ts:1372, const p = hook.provider): the guard if (!p || !models) continue sits one line after
the deref, so it protects against a hook without a provider, but not against a
falsy hooks-array entry. Such entries can get in because applyPlugin
(plugin/index.ts) pushes plugin results unchecked — e.g. any function
export on a legacy-shaped plugin module is called as a plugin, and a helper
export's undefined return lands in the hooks array. The plugin config hook failed … (evaluating '….config') line that tends to precede the 500 is the
same phantom entry hitting the config-notify loop.

On "happens with all plugins removed": OpenCode also auto-discovers file-based
plugins — config/plugin.ts globs {plugin,plugins}/*.{ts,js} in every
config directory (project .opencode/, global config dir, etc.) — so plugins
can load even with an empty plugin array. Could you check:

1. the contents of ~/.config/opencode/plugin/ and plugins/ (and any
   project-local .opencode/plugin*/ dirs in the workspace you had open), and
2. which config files OpenCode is merging for you (any leftover file-based
   plugin in a directory you'd forgotten counts)?

If a .ts/.js file shows up there, its module shape (specifically: extra
function exports, or a server() that can resolve undefined) would explain
the crash exactly. I've opened #36102 which makes the loader skip falsy
hook returns and log a warning naming the offending plugin spec — with that
patch this failure mode becomes a log line instead of a dead instance.

[shiy08166-lab]

@CryptArchy You were exactly right. Thank you for the root-cause analysis.

I found a leftover file-based plugin at ~/.config/opencode/plugins/superpowers/.opencode/plugins/superpowers.js. This was a git clone of the superpowers repo that I had forgotten about - it was being auto-discovered by OpenCode'"'"'s plugin glob even though my opencode.json plugin array references superpowers@git+https://github.com/obra/superpowers.git (which loads via the package cache instead).

The superpowers.js file exports SuperpowersPlugin which returns hooks with config and 'experimental.chat.messages.transform' keys but no provider field - exactly the phantom entry you described. When Provider.list() iterated the hooks array and hit this entry, hook.provider was undefined, causing the TypeError: Cannot read properties of undefined (reading 'provider').

After removing the leftover plugins/superpowers/ directory, the crash no longer appears in opencode.log and the UI model selector loads correctly.

This also explains why the crash persisted with an empty config and after removing oh-my-openagent from the plugin array - the file-based plugin was still being auto-discovered from the config directory.

Your PR #36102 (skip falsy hook returns + log warning) would have caught this immediately. Thanks again for the detailed analysis.

[shiy08166-lab]

@CryptArchy Sorry for the late reply - it took me a week to come back and check this issue.

I wanted to sincerely thank you for your detailed root-cause analysis. Your hypothesis was spot-on: the crash was caused by a leftover file-based plugin (superpowers.js from a forgotten git clone of the superpowers repo) that was being auto-discovered by OpenCode'"'"'s plugin glob. Its hooks returned entries without a provider field, and Provider.list() dereferenced undefined.provider before the guard clause could skip it.

After removing the leftover plugins/superpowers/ directory, the TypeError is gone and the Desktop UI loads models correctly.

Your PR #36102 would have caught this immediately with a clear log line. Really appreciate you taking the time to debug this for a stranger'"'"'s issue.

[shiy08166-lab]

@CryptArchy

Patch applied successfully! I manually applied the changes from #36102 to the v1.18.2 bundled app.asar (patched the 3 hooks.push() calls in applyPlugin to skip falsy returns).

The crash TypeError: Cannot read properties of undefined (reading 'provider') is now fixed — the Desktop UI loads correctly, Provider.list no longer 500s, and the UI renders normally.

Huge thanks for the detailed root-cause analysis in #35772 and the fix in #36102. Your hypothesis about falsy hook returns from internal plugins was exactly right — the crash was happening even with no user plugins loaded, due to an internal plugin returning undefined.

Thanks for the clean, minimal fix with tests. This saves the Desktop experience for everyone on v1.18.2 until the official merge.

[shiy08166-lab]

@CryptArchy Huge thanks for PR #36102! The fix worked perfectly.

I was hitting the exact Provider.list() TypeError crash on OpenCode Desktop v1.18.2 (Windows) — the TypeError: Cannot read properties of undefined (reading 'provider') error was repeating 600+ times in the logs, making the Desktop UI completely unusable.

Your PR #36102 identified the exact root cause: an internal plugin returning undefined from its init function, which got pushed into the hooks array and later dereferenced in Provider.list() when reading hook.provider. The 3 falsy checks you added (v1 plugin, legacy plugin, internal plugin paths) are exactly what was needed.

I manually applied the 3 falsy checks to the bundled app.asar (v1.18.2 on Windows) and the Desktop is now fully functional again — Provider.list() no longer crashes, UI renders correctly, and the Desktop is fully usable again. CLI continues to work perfectly with oh-my-openagent.

Thank you for the detailed root cause analysis and the clean, well-tested fix. Really appreciate the thorough test coverage too.

Now I can use both CLI (with oh-my-openagent) and Desktop (without oh-my-openagent) side by side without issues.

[shiy08166-lab]

@CryptArchy

Just wanted to leave a final consolidated thank you. Your PR #36102 and root-cause analysis in #35772 were the key to fixing this.

What happened:

• OpenCode Desktop v1.18.2 (Windows) was crashing with TypeError: Cannot read properties of undefined (reading 'provider') 600+ times per session
• The crash made the Desktop UI completely unusable (no models/providers visible)
• CLI was unaffected (bypasses ProviderHttpApi.list)

What your PR fixed:

• An internal plugin was returning undefined from its init function, getting pushed into the hooks array, and later dereferenced in Provider.list() when reading hook.provider
• The 3 falsy checks (v1 plugin, legacy plugin, internal plugin paths) are exactly what was needed

Result:

• I manually applied the 3 falsy checks from your PR to the bundled app.asar
• Desktop is now fully functional - Provider.list no longer crashes, UI renders correctly
• CLI continues to work perfectly with oh-my-openagent

Thank you for the clean, minimal, well-tested fix. This saves the Desktop experience for everyone on v1.18.2 until the official merge. Really appreciate you taking the time to debug and fix this for the community.