Distillation

September 9, 2026

🟡 (02:23) Repository search returned exactly 100 matches with additional matches available, identifying V2 plugin integration points across packages/sdk, packages/plugin-browser, packages/server, packages/protocol, packages/desktop, packages/core, and packages/tui.

🟡 (02:23) /home/byk/Code/opencode-v2-pilot/packages/sdk/src/tool.ts:3 re-exports ToolContext as Context and Info from @opencode/plugin/promise/tool via export type { ToolContext as Context, Info } from "@opencode/plugin/promise/tool".

🟡 (02:23) /home/byk/Code/opencode-v2-pilot/packages/sdk/src/promise.ts:4 imports Plugin from @opencode/plugin; lines 44 and 56 dynamically import PluginPromise from @opencode/core/plugin/promise, using Effect-wrapped loading at line 44 and direct await import(...) at line 56.

🟡 (02:23) /home/byk/Code/opencode-v2-pilot/packages/sdk/src/internal/instances.ts:6 imports InstancePlugins from @opencode/core/plugin/instance, while /home/byk/Code/opencode-v2-pilot/packages/sdk/src/internal/host.ts:3 imports SdkPlugins from @opencode/core/plugin/sdk.

🟡 (02:23) V2 SDK tests demonstrate the Effect API import form: /home/byk/Code/opencode-v2-pilot/packages/sdk/test/instances-effect.test.ts:10 imports Plugin from @opencode/plugin/effect.

🟡 (02:23) V2 browser-plugin code uses the Effect API: /home/byk/Code/opencode-v2-pilot/packages/plugin-browser/src/index.ts:1 imports Plugin from @opencode/plugin/effect; /home/byk/Code/opencode-v2-pilot/packages/plugin-browser/src/tools.ts:3 imports type Context from @opencode/plugin/effect/plugin; /home/byk/Code/opencode-v2-pilot/packages/plugin-browser/src/connection.ts:3-4 imports type Context from @opencode/plugin/effect/plugin and RpcRegistration from @opencode/plugin/effect/rpc.

🟡 (02:23) TUI-oriented V2 plugins use a separate entrypoint: /home/byk/Code/opencode-v2-pilot/packages/latex/src/plugin.ts:1 and /home/byk/Code/opencode-v2-pilot/packages/merman/src/plugin.ts:1 both import Plugin from @opencode/plugin/tui.

🟡 (02:23) /home/byk/Code/opencode-v2-pilot/packages/server/test/fixture/worktree-delegate/index.ts:1 imports Plugin from the package root @opencode/plugin, providing a repository example of root-entrypoint plugin consumption.

🟡 (02:23) V2 plugin activation is exposed over HTTP: /home/byk/Code/opencode-v2-pilot/packages/protocol/src/groups/plugin.ts:24 defines HttpApiEndpoint.post("plugin.awaitActivation", "/api/plugin/await-activation", ...), and line 55 defines HttpApiEndpoint.post("plugin.update", "/api/plugin/update", ...).

🟡 (02:23) V2 server activation tests exercise POST /api/plugin/await-activation: /home/byk/Code/opencode-v2-pilot/packages/server/test/plugin-activation.test.ts:91 sends the request for a second server fixture, and line 155 expects status 204.

🟡 (02:23) V2 server tests including /home/byk/Code/opencode-v2-pilot/packages/server/test/vcs.test.ts, /home/byk/Code/opencode-v2-pilot/packages/server/test/rpc-handler-errors.test.ts, and /home/byk/Code/opencode-v2-pilot/packages/server/test/plugin-activation.test.ts reference SdkPlugins from @opencode/core/plugin/sdk.

🟡 (02:23) /home/byk/Code/opencode-v2-pilot/packages/server/src/routes.ts:29 imports PluginUpdate from @opencode/core/plugin/update.

🟡 (02:23) Core tests reference internal plugin systems and implementations, including PluginHooks from @opencode/core/plugin/hooks in /home/byk/Code/opencode-v2-pilot/packages/core/test/session-title.test.ts:18, VcsGitPlugin from @opencode/core/plugin/vcs/git in packages/core/test/vcs.test.ts:16, and VcsHgPlugin from @opencode/core/plugin/vcs/hg in packages/core/test/vcs-hg.test.ts:13.

🟡 (02:23) Search results also identified built-in core tool plugin imports: WriteTool from @opencode/core/tool/plugin/write in packages/core/test/tool-write.test.ts:16, WebFetchTool from @opencode/core/tool/plugin/webfetch in packages/core/test/tool-webfetch.test.ts:11, plus references to SubagentTool, ShellTool, GrepTool, and QuestionTool from their corresponding @opencode/core/tool/plugin/* modules.

🟡 (02:23) Desktop browser integration references Browser and BrowserProxy: /home/byk/Code/opencode-v2-pilot/packages/desktop/test/browser/targets.ts:3 and packages/desktop/test/browser/native.ts:7 import Browser from @opencode/plugin-browser/rpc; /home/byk/Code/opencode-v2-pilot/packages/desktop/src/main/browser/errors.ts:1 imports its type; another matched desktop source imports BrowserProxy from @opencode/plugin-browser/proxy.

🟡 (02:23) Additional search matches showed runtime plugin-support loading via import "../src/plugin/runtime-plugin-support.bun", use of host from ./plugin/host, and generated/fixture plugin source locations such as plugin/link.ts, plugin/tui.ts, and plugin/node_modules/example; the abbreviated search output did not expose all associated file paths.