Bug in documentation of plugin SDK #8217

Open
opened 2026-02-16 18:09:27 -05:00 by yindo · 1 comment
Owner

Originally created by @MBanucu on GitHub (Feb 1, 2026).

Originally assigned to: @jayair on GitHub.

Description

Look at this:


[michi@nixos:~/dev/opencode-pty-branches/make-release-work/node_modules/@opencode-ai]$ tree sdk
sdk
├── dist
│   ├── client.d.ts
│   ├── client.js
│   ├── gen
│   │   ├── client
│   │   │   ├── client.gen.d.ts
│   │   │   ├── client.gen.js
│   │   │   ├── index.d.ts
│   │   │   ├── index.js
│   │   │   ├── types.gen.d.ts
│   │   │   ├── types.gen.js
│   │   │   ├── utils.gen.d.ts
│   │   │   └── utils.gen.js
│   │   ├── client.gen.d.ts
│   │   ├── client.gen.js
│   │   ├── core
│   │   │   ├── auth.gen.d.ts
│   │   │   ├── auth.gen.js
│   │   │   ├── bodySerializer.gen.d.ts
│   │   │   ├── bodySerializer.gen.js
│   │   │   ├── params.gen.d.ts
│   │   │   ├── params.gen.js
│   │   │   ├── pathSerializer.gen.d.ts
│   │   │   ├── pathSerializer.gen.js
│   │   │   ├── serverSentEvents.gen.d.ts
│   │   │   ├── serverSentEvents.gen.js
│   │   │   ├── types.gen.d.ts
│   │   │   ├── types.gen.js
│   │   │   ├── utils.gen.d.ts
│   │   │   └── utils.gen.js
│   │   ├── sdk.gen.d.ts
│   │   ├── sdk.gen.js
│   │   ├── types.gen.d.ts
│   │   └── types.gen.js
│   ├── index.d.ts
│   ├── index.js
│   ├── server.d.ts
│   ├── server.js
│   └── v2
│       ├── client.d.ts
│       ├── client.js
│       ├── gen
│       │   ├── client
│       │   │   ├── client.gen.d.ts
│       │   │   ├── client.gen.js
│       │   │   ├── index.d.ts
│       │   │   ├── index.js
│       │   │   ├── types.gen.d.ts
│       │   │   ├── types.gen.js
│       │   │   ├── utils.gen.d.ts
│       │   │   └── utils.gen.js
│       │   ├── client.gen.d.ts
│       │   ├── client.gen.js
│       │   ├── core
│       │   │   ├── auth.gen.d.ts
│       │   │   ├── auth.gen.js
│       │   │   ├── bodySerializer.gen.d.ts
│       │   │   ├── bodySerializer.gen.js
│       │   │   ├── params.gen.d.ts
│       │   │   ├── params.gen.js
│       │   │   ├── pathSerializer.gen.d.ts
│       │   │   ├── pathSerializer.gen.js
│       │   │   ├── queryKeySerializer.gen.d.ts
│       │   │   ├── queryKeySerializer.gen.js
│       │   │   ├── serverSentEvents.gen.d.ts
│       │   │   ├── serverSentEvents.gen.js
│       │   │   ├── types.gen.d.ts
│       │   │   ├── types.gen.js
│       │   │   ├── utils.gen.d.ts
│       │   │   └── utils.gen.js
│       │   ├── sdk.gen.d.ts
│       │   ├── sdk.gen.js
│       │   ├── types.gen.d.ts
│       │   └── types.gen.js
│       ├── index.d.ts
│       ├── index.js
│       ├── server.d.ts
│       └── server.js
└── package.json

9 directories, 71 files

[michi@nixos:~/dev/opencode-pty-branches/make-release-work/node_modules/@opencode-ai]$ 

There is a v2 folder but there is nothing written anything about it in the docs. This is a severe confusing bug in the documentation system. Either remove the v2 from public access or document it properly.

But this is just my thought.

Plugins

No response

OpenCode version

1.1.47

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

NixOS 25.11

Terminal

No response

Originally created by @MBanucu on GitHub (Feb 1, 2026). Originally assigned to: @jayair on GitHub. ### Description Look at this: ``` [michi@nixos:~/dev/opencode-pty-branches/make-release-work/node_modules/@opencode-ai]$ tree sdk sdk ├── dist │ ├── client.d.ts │ ├── client.js │ ├── gen │ │ ├── client │ │ │ ├── client.gen.d.ts │ │ │ ├── client.gen.js │ │ │ ├── index.d.ts │ │ │ ├── index.js │ │ │ ├── types.gen.d.ts │ │ │ ├── types.gen.js │ │ │ ├── utils.gen.d.ts │ │ │ └── utils.gen.js │ │ ├── client.gen.d.ts │ │ ├── client.gen.js │ │ ├── core │ │ │ ├── auth.gen.d.ts │ │ │ ├── auth.gen.js │ │ │ ├── bodySerializer.gen.d.ts │ │ │ ├── bodySerializer.gen.js │ │ │ ├── params.gen.d.ts │ │ │ ├── params.gen.js │ │ │ ├── pathSerializer.gen.d.ts │ │ │ ├── pathSerializer.gen.js │ │ │ ├── serverSentEvents.gen.d.ts │ │ │ ├── serverSentEvents.gen.js │ │ │ ├── types.gen.d.ts │ │ │ ├── types.gen.js │ │ │ ├── utils.gen.d.ts │ │ │ └── utils.gen.js │ │ ├── sdk.gen.d.ts │ │ ├── sdk.gen.js │ │ ├── types.gen.d.ts │ │ └── types.gen.js │ ├── index.d.ts │ ├── index.js │ ├── server.d.ts │ ├── server.js │ └── v2 │ ├── client.d.ts │ ├── client.js │ ├── gen │ │ ├── client │ │ │ ├── client.gen.d.ts │ │ │ ├── client.gen.js │ │ │ ├── index.d.ts │ │ │ ├── index.js │ │ │ ├── types.gen.d.ts │ │ │ ├── types.gen.js │ │ │ ├── utils.gen.d.ts │ │ │ └── utils.gen.js │ │ ├── client.gen.d.ts │ │ ├── client.gen.js │ │ ├── core │ │ │ ├── auth.gen.d.ts │ │ │ ├── auth.gen.js │ │ │ ├── bodySerializer.gen.d.ts │ │ │ ├── bodySerializer.gen.js │ │ │ ├── params.gen.d.ts │ │ │ ├── params.gen.js │ │ │ ├── pathSerializer.gen.d.ts │ │ │ ├── pathSerializer.gen.js │ │ │ ├── queryKeySerializer.gen.d.ts │ │ │ ├── queryKeySerializer.gen.js │ │ │ ├── serverSentEvents.gen.d.ts │ │ │ ├── serverSentEvents.gen.js │ │ │ ├── types.gen.d.ts │ │ │ ├── types.gen.js │ │ │ ├── utils.gen.d.ts │ │ │ └── utils.gen.js │ │ ├── sdk.gen.d.ts │ │ ├── sdk.gen.js │ │ ├── types.gen.d.ts │ │ └── types.gen.js │ ├── index.d.ts │ ├── index.js │ ├── server.d.ts │ └── server.js └── package.json 9 directories, 71 files [michi@nixos:~/dev/opencode-pty-branches/make-release-work/node_modules/@opencode-ai]$ ``` There is a v2 folder but there is nothing written anything about it in the [docs](https://opencode.ai/docs/sdk/). This is a severe confusing bug in the documentation system. Either remove the v2 from public access or document it properly. But this is just my thought. ### Plugins _No response_ ### OpenCode version 1.1.47 ### Steps to reproduce _No response_ ### Screenshot and/or share link _No response_ ### Operating System NixOS 25.11 ### Terminal _No response_
yindo added the bugdocs labels 2026-02-16 18:09:27 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Feb 1, 2026):

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

  • #7641: plugin hook types not aligned with runtime triggers and missing v2 sdk

Feel free to ignore if this doesn't address your specific case.

@github-actions[bot] commented on GitHub (Feb 1, 2026): This issue might be a duplicate of an existing issue. Please check: - #7641: plugin hook types not aligned with runtime triggers and missing v2 sdk Feel free to ignore if this doesn't address your specific case.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#8217