Skip to content

Pin the plugin API to OpenCode 2.2.1 - #393

Merged
ivopogace merged 2 commits into
mainfrom
bump-opencode-2.2.1
Oct 29, 2026
Merged

ivopogace merged 2 commits into
mainfrom
bump-opencode-2.2.1

Conversation

@ivopogace

Copy link
Copy Markdown
Owner

Issue

No issue: OpenCode 2.2.1 came out today, before latest.yml opened one.

Type of change

  • Bug fix
  • New feature or behaviour
  • Refactor
  • Documentation
  • OpenCode pin bump or release

What does this PR do?

Moves the pin to OpenCode 2.2.1, following docs/maintainers/releasing.md:

  • @opencode/plugin (peer and devDependency), @opencode/cli in the docs and @opencode/theme to 2.2.1; solid-js to 1.9.17, OpenCode's catalog at v2.2.1. effect (4.0.1) and @opentui/* (0.7.0) are unchanged.
  • The version README.md names (Quickstart, the Install section's "tested on" line and command, the terminal part's line), docs/reference.md's terminal part line, CLAUDE.md and the maintainer docs. The version tables are left to script/compat-table.ts at release.
  • docs/maintainers/plugin-api-notes.md: every trap re-checked against the OpenCode files they cite that changed between v2.2.0 and v2.2.1; none moves, and the HTTP routes the e2e scripts call are unchanged. The keyed session instructions trap now says that since 2.2.1 the plugin API types session.instructions from the client's ExperimentalSessionApi (refactor(client): group experimental SDK methods under client.experimental anomalyco/opencode#59072), with the SDK's non-experimental path a deprecated alias removed in the next minor.
  • CLAUDE.md gains a rule: no experimental OpenCode API (hooks, config keys, client paths, tools or commands), with the keyed session instructions as the one exception, kept on purpose. So nothing new in 2.2.1 that is experimental (experimental.idle, experimental.schedules, /goal) is adopted.

No source change: the plugin compiles and behaves the same against 2.2.1.

How did you verify it?

  • bun run typecheck, bun run build, bun test (1257 pass) and bun script/compat-table.ts --check.
  • npm run test:e2e against @opencode/cli@2.2.1, running locally; CI runs both live suites on 2.2.1.

Screenshots / recordings

None: no change to the terminal part.

Checklist

  • bun run typecheck and bun test pass
  • A behaviour change comes with unit tests and an e2e/run.sh scenario (no behaviour change)
  • README.md and docs/reference.md are updated where behaviour changed
  • A change to a model-facing string updates test/__snapshots__/ (none changed)
  • No unrelated changes

Generated by Claude Code

Moves @opencode/plugin, @opencode/cli and @opencode/theme to 2.2.1 and
solid-js to 1.9.17, the version in OpenCode's catalog at v2.2.1; effect
and @opentui/* are unchanged. Updates the version README.md and the
maintainer docs name, and the keyed session instructions trap: since
2.2.1 the plugin API types `session.instructions` and `session.wait`
from the client's experimental session API, and the SDK's
non-experimental path is a deprecated alias removed in the next minor.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0138xCuAkvqGimCN48BLvVb9
The keyed session instructions stay, as the one exception kept on
purpose; any other experimental hook, config key, client path, tool or
command is left alone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0138xCuAkvqGimCN48BLvVb9
@socket-security

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Updated@​opencode/​theme@​2.2.0 ⏵ 2.2.1100 +2210073 +196100
Updated@​opencode/​plugin@​2.2.0 ⏵ 2.2.199 +110079 +196100
Updatedsolid-js@​1.9.15 ⏵ 1.9.17100 +110010096 +1100

View full report

@sonarqubecloud

Copy link
Copy Markdown

@ivopogace
ivopogace marked this pull request as ready for review October 29, 2026 08:41
@ivopogace
ivopogace merged commit be9f917 into main Oct 29, 2026
16 checks passed
@ivopogace
ivopogace deleted the bump-opencode-2.2.1 branch October 29, 2026 08:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants