[docs] Plugin package.json example's peer ranges cause ERESOLVE #58807

Activity

1. opencode-agent commented on Oct 24, 2026

   

   opencode-agentBot

   on Oct 24, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the detailed report. I can confirm this. With @opencode/[email protected] as a dependency and the docs' peerDependencies copied exactly, npm install @opentui/[email protected] fails with the ERESOLVE you quoted (Conflicting peer dependency: @opentui/[email protected] … peerOptional @opentui/core@">=0.6.8" from @opencode/[email protected]). The script below reproduces it.

   It's still the same on the latest dev (13a615b). The "Publish and load" example still says >=0.6.6 and still has no @opencode/theme peer, while @opencode/plugin requires >=0.6.8. The minimum was probably raised in the OpenTUI 0.6.8 upgrade (#58380), and the docs example wasn't updated with it.

   Your other two points are also noted:

   • The docs don't say that a local-path directory with no index/server entry is skipped without any warning. The behaviour itself is tracked in plugins: local plugin directory ignores package.json main and is silently skipped without a root entrypoint #52300, Plugin directory without an entrypoint is dropped silently (V2) #58574 and plugin: configured local plugin file paths silently dropped since #46105 #46551.
   • tui.tsx isn't mentioned alongside tui.ts.

   Reproduction script (repro.sh)

   #!/usr/bin/env bash
   # Reproduces #58807: the docs' plugin package.json peer ranges allow @opentui/* 0.6.6,
   # but @opencode/[email protected] requires >=0.6.8, so pinning 0.6.6 fails with ERESOLVE.
   set -u
   VERSION="${1:-2.1.4}"
   DIR=$(mktemp -d)
   cd "$DIR"
   cat > package.json <<JSON
   {
     "name": "opencode-acme-plugin",
     "type": "module",
     "exports": { ".": "./src/index.ts", "./tui": "./src/tui.tsx" },
     "dependencies": { "@opencode/plugin": "$VERSION" },
     "peerDependencies": {
       "@opentui/core": ">=0.6.6",
       "@opentui/solid": ">=0.6.6",
       "solid-js": ">=1.9.0"
     }
   }
   JSON
   echo "--- @opencode/plugin@$VERSION peerDependencies:"
   npm view "@opencode/plugin@$VERSION" peerDependencies
   echo "--- npm install @opentui/[email protected] (allowed by the docs' range):"
   npm install --no-audit --no-fund @opentui/[email protected] 2>&1 | tail -15
   echo "exit: ${PIPESTATUS[0]}"

   Run it: bash repro.sh
2. opencode-agent

   added

   reproduced

   on Oct 24, 2026
3. renjianguojinqianfan commented on Oct 25, 2026

   

   renjianguojinqianfan

   on Oct 25, 2026

   More actions

   I'd like to take this one. Preparing a docs PR that aligns the peer ranges with what @opencode/plugin declares (>=0.6.8, plus the missing @opencode/theme peer), mentions tui.tsx alongside tui.ts, and states that a configured directory without a root index or server module is skipped without a warning.
4. renjianguojinqianfan

   added 2 commits that reference this issue on Oct 25, 2026

   docs(plugins): align package.json peers with @opencode/plugin

   ...

   This issue will close once commit 161b388 is merged into the 'dev' branch.

   161b388

   docs(plugins): align package.json peers with @opencode/plugin

   ...

   This issue will close once commit 020b05f is merged into the 'dev' branch.

   020b05f