dsh-llm-opencode-go

English | 中文

OpenCode Go integration for DeepSeek Harness. Chat uses the shared pi-ai adapter. Completions, Responses, or Anthropic Messages are selected per model from the official Go table. Model discovery and subscription usage stay on native Go endpoints because those capabilities are not part of the chat protocol.

The package root exposes the Cordis plugin contract and OpenCodeGoAdapter. The same artifact exports ./client, which contributes the OpenCode Go card under Settings → LLM Providers. The protocol split is recorded in ADR 0001.

Compatibility

DSH peer and development dependency ranges accept 0.1.7-alpha.2 and later releases. Cordis peers accept >=4.0.4 <5.0.0; Schemastery peers target ~3.18.4.

Compatibility metadata records verified Hosts; other Hosts still warn once and use the normal best-effort mount path. Only a reproduced failure is blocklisted.

catalogId and the unresolved unknown account state are attached at runtime. Published dsh-llm-providers-ui 0.2.8 omits those fields and treats unknown as unconnected; they only take effect on a newer Owner.

LLM Providers UI ownership

The LLM Providers Settings page (settings.section id: providers with child settings.provider.item) and the shared llm-providers order store are owned solely by dsh-llm-providers-ui.

• This plugin contributes only its keyed card (key: llm-opencode-go) and its Host llm route; it does not install the page or the shared llm-providers namespace. Load order with the owner does not matter.
• Without the owner (Headless or Web without dsh-llm-providers-ui): the Host model route opencode-go still works; in Web the Providers page and this card are omitted and the browser console warns that the owner is missing. A Web release composition test rejects a bundle graph that ships provider cards without the owner.
• The nav globe glyph is a temporary Alpha.4 DOM adapter owned only by dsh-llm-providers-ui (src/client/nav-icon.ts); this plugin does not ship that adapter.

Install dsh-llm-providers-ui explicitly in the profile alongside provider plugins (see that package's cordis.patch.yml).

Installation

Install the published package through the profile manager:

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.13/dsh-llm-providers-ui-0.2.13.tgz
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-opencode-go/releases/download/v0.1.34/dsh-llm-opencode-go-0.1.34.tgz
dsh web

The package contains release-ready lib artifacts. Install dsh-llm-providers-ui alongside this plugin to provide the shared LLM Providers page.

The client RPC uses the authenticated /api/plugin-rpc/opencode-go Fetch route. The physical /api carrier checks Host/Origin and cookie authentication and enforces its body cap before dispatching to the plugin route.

Put this plugin in the profile bundle with dsh-llm-providers-ui; the owner enumerates every installed provider card.

Web configuration

Open Settings → LLM Providers → OpenCode Go. Configuration is read through the alpha2 ConfigForm for Loader entry llm-opencode-go; before a revision-fenced mutation of the volatile baseURL and models fields, the authenticated Host route validates the URL and model catalog. Credential status and writes use the same authenticated plugin RPC; API keys are write-only and never echoed or logged.

The card saves the public base URL and model catalog together with one revision-fenced ConfigForm.mutate. Fetch available models opens the picker immediately. The Host reads GET /zen/go/v1/models (OpenAI-shaped ids only) and fills name, context, vision, thinking, and protocol from a local snapshot, then from a live models.dev opencode-go overlay so newly published ids such as omen-alpha are not blank after Fetch.

When a key is stored, the card loads account quota while collapsed (and again on Fetch/Refresh). The Host reads GET <baseURL>/usage; remaining 5-hour, weekly, and monthly windows paint from a local cache on first open, then refresh in the background. The credential never crosses to the browser.

The model catalog starts collapsed and lists one row per model: a drag handle reorders rows (the order persists with the catalog), the chevron opens that row's context and capability flags, and the trash button removes it.

Plugin configuration

The Models page lists saved opencode-go models and can select them. Current Harness releases do not expose a third-party editor slot inside that page, so this package owns its editor under LLM Providers.

Capability and protocol split

Chat uses one opencode-go route. The adapter does not re-register that route as a configurable provider (the pi-ai catalog already owns the directory entry). Per-model api selects:

openai-completions   POST {baseURL}/chat/completions
openai-responses     POST {baseURL}/responses
anthropic-messages   POST {baseURL minus trailing /v1}/v1/messages

Native independent capabilities remain Host-only:

model discovery   GET /zen/go/v1/models
subscription usage   GET /zen/go/v1/usage

Official provider documentation: https://opencode.ai/docs/zh-cn/go/

Config

- id: llm-opencode-go
  name: dsh-llm-opencode-go
  config:
    apiKeyEnv: OPENCODE_API_KEY
    baseURL: https://opencode.ai/zen/go/v1
    defaultContextWindow: 262144
    streamIdleTimeoutMs: 300000
    models:
      - id: muse-spark-1.2-contributor
        name: Muse Spark 1.2 Contributor
        contextWindow: 1048576
        maxTokens: 131072
        vision: true
        thinking: true
        defaultEffort: medium
        api: openai-responses
      - id: glm-5.3-flash
        name: GLM-5.3-Flash
        contextWindow: 1000000
        thinking: true
        defaultEffort: high
        api: openai-completions

The provider route remains opencode-go; the Loader entry id is llm-opencode-go. Only configured catalog models are accepted for chat. Per-row contextWindow is the DSH compaction budget. The fallback context window is 262,144 tokens.

Model capabilities

vision controls text/image input modalities. thinking enables selectable reasoning efforts. Known Go families pin a plugin defaultEffort when the session has not picked one. api is required for dispatch; unknown ids fall back to the documented family table.

Muse Spark requires the OpenCode workspace toggle for training-data models. DeepSeek V4 Flash and V4.1 Flash (deepseek-flash) require the toggle for models hosted in China. Those are account flags on https://opencode.ai, not plugin settings. The forward max option for Muse Spark 1.3 Contributor is intentionally shown, but the current OpenCode Go upstream rejects that value with HTTP 400; select xhigh until the upstream enum is expanded.

Model experience

The system prompt and provider-neutral messages are translated by PiAiAdapter into Completions, Responses, or Messages. Tool calls retain provider-issued ids. Images are encoded as base64 data URLs only for vision models.

Usage maps to Harness input/output counts. maxTokens is clamped against the configured context capacity by pi-ai.

Known limitations

• A leftover ~/.dsh/.credentials.yaml.lock written by CodexHub (codexhub-atomic-lock=1) blocks every DSH credentials.set until the sidecar is deleted. See CodexHub docs/tasks/dsh-credentials-lock-interop.md.
• This package does not call registerConfigurableProviders for opencode-go (duplicate directory with llm-pi-ai).
• GenerateOptions.stop is not supported by the shared PiAiAdapter.

Release installation (Latest)

This release targets official DeepSeek Harness 0.1.7-rc.1; use the matching published Provider UI 0.2.13 release on Web.

The dsh-llm-providers-ui package owns the LLM Providers page, navigation, and shared order store. This package owns only its provider card, models, credentials, and Host route. Install the Owner first for Web; headless Host routing works without the Owner.

Latest (Owner + this plugin; required together on Web):

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-providers-ui/releases/latest/download/dsh-llm-providers-ui-0.2.13.tgz
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-opencode-go/releases/latest/download/dsh-llm-opencode-go-0.1.34.tgz

Fixed versions (reproducible):

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.13/dsh-llm-providers-ui-0.2.13.tgz
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-opencode-go/releases/download/v0.1.34/dsh-llm-opencode-go-0.1.34.tgz

Update, uninstall, and verify:

# Update Owner + this plugin to Latest
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-providers-ui/releases/latest/download/dsh-llm-providers-ui-0.2.13.tgz
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-opencode-go/releases/latest/download/dsh-llm-opencode-go-0.1.34.tgz
# Verify the loaded version
dsh plugin --profile web list
dsh plugin --profile web doctor
# Uninstall only this plugin
dsh plugin --profile web remove dsh-llm-opencode-go

Configuration: use the plugin section in Settings for Web UI plugins, or the profile dsh.profile.bundles entry for Host-only plugins. Start with this README's minimal YAML/JSON example and provide credentials/backend addresses explicitly.

Rollback: restore the previous Host release and matching profile together; older OpenCode Go releases are not compatible with this Alpha.2 Host. Inspect journalctl --user -u dsh-web.service and dsh plugin --profile web doctor; never put a source checkout in the production profile.

Release and integrity: v0.1.34 · SHA256.