@raindrop-ai/opencode-plugin 0.1.3 → 0.2.0

package/README.md

@@ -54,8 +54,33 @@ then send its `event_id` to [`/v1/signals`](https://docs.raindrop.ai):
 }
 ```
 
+## OpenCode v2 plugin API
+
+OpenCode's newer plugin API (`@opencode/plugin`, `@opencode/sdk` v2) is served
+by the `@raindrop-ai/opencode-plugin/v2` subpath. Use it instead of the default
+export when running against the v2 plugin host:
+
+```jsonc
+// opencode.json
+{ "plugin": ["@raindrop-ai/opencode-plugin/v2"] }
+```
+
+```bash
+npm install @raindrop-ai/opencode-plugin @opencode/plugin
+```
+
+The v2 entry exposes the plugin object plus a `raindrop` handle
+(`users.identify`, `signals.track`, `currentEventId(sessionID)`, `flush`,
+`shutdown`). Configuration, event/tracing semantics, and payload bounds are the
+same as the v1 entry. `@opencode/plugin` and `@opencode/sdk` are optional peer
+dependencies — v1 users install neither.
+
 ## Notes
 
-- `@opencode-ai/plugin` is required.
-- `@opencode-ai/sdk` is an optional peer dependency.
+- `@opencode-ai/plugin` is required for the default (v1) export; `@opencode/plugin` for `/v2`.
+- `@opencode-ai/sdk` and `@opencode/sdk` are optional peer dependencies.
 - Tests live in the nested `tests/` package and validate HTTP payloads and tracing behavior.
+
+## Application Git identity
+
+OpenCode does not treat the edited project directory or ambient deploy/CI metadata in the plugin process as the agent-under-test revision. By default the new canonical application revision is unknown. Configure an `app_git` object in `raindrop.json` using `commit_sha`, `commit_dirty`, and ordinary `branch`, set `RAINDROP_COMMIT_SHA` / `RAINDROP_COMMIT_DIRTY` / `RAINDROP_BRANCH`, or set an explicit `source_directory` (or `RAINDROP_GIT_SOURCE_DIRECTORY`) that identifies the agent-under-test checkout. Set `app_git` to `false` to opt out. Automatic canonical branch discovery is off unless `detect_branch` is true.