@raindrop-ai/opencode-plugin 0.2.0 → 0.3.1

package/dist/v2.d.ts

@@ -1,11 +1,19 @@
 import { Plugin } from '@opencode/plugin';
-import { I as IdentifyInput, S as SignalInput, A as AppGitOptions } from './index.d-vgBcEZbX.js';
+import { I as IdentifyInput, c as SignalInput, A as AppGitOptions, S as SelfDiagnosticsOptions, P as PromptToolsOverride } from './self-diagnostics-CLW6h4zB.js';
+export { a as SelfDiagnosticsSignalDefinition, b as SelfDiagnosticsSignalDefinitions } from './self-diagnostics-CLW6h4zB.js';
 
 interface RaindropOpencodeV2Options {
     /** Application Git identity override. false disables enrichment. */
     appGit?: AppGitOptions | false;
     /** Config directory override; defaults to the first instance's ctx.location.directory. */
     directory?: string;
+    /** Built-in self-diagnostics: injects a `__raindrop_report` tool when enabled. */
+    selfDiagnostics?: SelfDiagnosticsOptions;
+    /**
+     * Overrides the tool catalog recorded as `ai.prompt.tools` on every model
+     * span; skips the OpenCode `ctx.tool.list()` lookup entirely.
+     */
+    tools?: PromptToolsOverride;
 }
 /**
  * The Raindrop control handle exposed on the v2 plugin. Unlike v1 (where the
@@ -38,4 +46,4 @@ interface RaindropOpencodePluginV2 extends Plugin.Plugin {
  */
 declare function raindrop(opts?: RaindropOpencodeV2Options): RaindropOpencodePluginV2;
 
-export { IdentifyInput, type RaindropOpencodePluginV2, type RaindropOpencodeV2Handle, type RaindropOpencodeV2Options, SignalInput, raindrop as default };
+export { IdentifyInput, type RaindropOpencodePluginV2, type RaindropOpencodeV2Handle, type RaindropOpencodeV2Options, SelfDiagnosticsOptions, SignalInput, raindrop as default };

package/dist/v2.js

@@ -2,16 +2,22 @@ import {
   EventShipper,
   PLUGIN_NAME,
   PLUGIN_VERSION,
+  SELF_DIAGNOSTICS_ACK,
   TraceShipper,
   attrString,
   boundedStringify,
   buildLlmGenAiAttributes,
   capText,
   createAppGitContext,
+  createToolCatalog,
   generateId,
   loadConfig,
-  resolveLocalDebuggerBaseUrl
-} from "./chunk-4DAI6CYK.js";
+  normalizeSelfDiagnosticsConfig,
+  promptToolsAttributes,
+  resolveLocalDebuggerBaseUrl,
+  selfDiagnosticsInputJsonSchema,
+  trackSelfDiagnosticsSignal
+} from "./chunk-ZG47FVK7.js";
 
 // src/v2.ts
 import { Plugin } from "@opencode/plugin";
@@ -66,7 +72,7 @@ function errorString(error) {
 
 type: ${error.type}`;
 }
-function createV2Tracing(config, eventShipper, traceShipper, sessionLookup) {
+function createV2Tracing(config, eventShipper, traceShipper, sessionLookup, toolCatalog) {
   const sessions = /* @__PURE__ */ new Map();
   const admittedPrompts = /* @__PURE__ */ new Map();
   const subagentLinks = /* @__PURE__ */ new Map();
@@ -106,7 +112,7 @@ function createV2Tracing(config, eventShipper, traceShipper, sessionLookup) {
   async function finalizeTurn(state, error) {
     var _a, _b, _c;
     for (const step of state.stepSpans.values()) {
-      traceShipper.endSpan(step.span);
+      traceShipper.endSpan(step.span, { attributes: promptToolsAttributes(await step.promptTools) });
     }
     state.stepSpans.clear();
     if (state.compactionSpan) {
@@ -361,7 +367,13 @@ function createV2Tracing(config, eventShipper, traceShipper, sessionLookup) {
         state.stepSpans.set(data.assistantMessageID, {
           span,
           providerID: data.model.providerID,
-          modelID: data.model.id
+          modelID: data.model.id,
+          // Kicked off here, awaited when the step closes: the lookup (bounded
+          // by its timeout) never delays the events streamed during the step.
+          promptTools: toolCatalog ? toolCatalog.resolve(data.sessionID, {
+            provider: data.model.providerID,
+            model: data.model.id
+          }) : Promise.resolve(void 0)
         });
         break;
       }
@@ -392,6 +404,7 @@ function createV2Tracing(config, eventShipper, traceShipper, sessionLookup) {
         if (reasoning !== void 0) {
           attrs.push(attrString("ai.reasoning.text", reasoning));
         }
+        attrs.push(...promptToolsAttributes(await step.promptTools));
         traceShipper.endSpan(step.span, { attributes: attrs });
         break;
       }
@@ -401,7 +414,10 @@ function createV2Tracing(config, eventShipper, traceShipper, sessionLookup) {
         const step = state == null ? void 0 : state.stepSpans.get(data.assistantMessageID);
         if (!state || !step) return;
         state.stepSpans.delete(data.assistantMessageID);
-        traceShipper.endSpan(step.span, { error: errorString(data.error) });
+        traceShipper.endSpan(step.span, {
+          error: errorString(data.error),
+          attributes: promptToolsAttributes(await step.promptTools)
+        });
         break;
       }
       case "session.text.ended": {
@@ -577,6 +593,7 @@ function createV2Tracing(config, eventShipper, traceShipper, sessionLookup) {
           }
         }
         sessions.delete(event.data.sessionID);
+        toolCatalog == null ? void 0 : toolCatalog.forget(event.data.sessionID);
         break;
       }
     }
@@ -654,7 +671,7 @@ function raindrop(opts = {}) {
     }
   }
   function createShared(ctx) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     const config = loadConfig((_a = opts.directory) != null ? _a : ctx.location.directory);
     const resolvedLocalUrl = resolveLocalDebuggerBaseUrl(config.localWorkshopUrl);
     const hasLocalDestination = resolvedLocalUrl !== null;
@@ -687,18 +704,41 @@ function raindrop(opts = {}) {
     };
     const eventShipper = new EventShipper(shipperOptions);
     const traceShipper = new TraceShipper(shipperOptions);
+    const selfDiagnostics = normalizeSelfDiagnosticsConfig(
+      (_d = opts.selfDiagnostics) != null ? _d : config.selfDiagnostics
+    );
+    if (selfDiagnostics && !config.writeKey.trim()) {
+      appLog(
+        "warn",
+        `selfDiagnostics enabled but RAINDROP_WRITE_KEY is not set \u2014 the ${selfDiagnostics.toolName} tool is not registered (signals require the cloud destination).`
+      );
+    }
     const s = {
       eventShipper,
       traceShipper,
+      config,
+      selfDiagnostics: config.writeKey.trim() ? selfDiagnostics : void 0,
       appGitContext,
       abort: new AbortController(),
       instances: /* @__PURE__ */ new Set(),
-      runtime: createV2Tracing(config, eventShipper, traceShipper, async (sessionID) => {
-        const instance = firstInstance(s);
-        if (!instance) return void 0;
-        const info = await instance.ctx.session.get({ sessionID });
-        return { parentID: info.parentID };
-      })
+      runtime: createV2Tracing(
+        config,
+        eventShipper,
+        traceShipper,
+        async (sessionID) => {
+          const instance = firstInstance(s);
+          if (!instance) return void 0;
+          const info = await instance.ctx.session.get({ sessionID });
+          return { parentID: info.parentID };
+        },
+        createToolCatalog({
+          override: (_e = opts.tools) != null ? _e : config.tools,
+          // v2 exposes no per-model catalog endpoint; the registered tool list
+          // (after every plugin transform) is the closest observable catalog.
+          fetch: () => ctx.tool.list(),
+          debug: config.debug
+        })
+      )
     };
     return s;
   }
@@ -741,6 +781,34 @@ function raindrop(opts = {}) {
         const directory = ctx.location.directory;
         instance.disposables.push(await ctx.session.hook("prompt", (e) => runtime.onPrompt(e, directory)));
         instance.disposables.push(await ctx.session.hook("context", (e) => runtime.onContext(e)));
+        const selfDiagnostics = s.selfDiagnostics;
+        if (selfDiagnostics) {
+          const cfg = selfDiagnostics;
+          const eventShipper = s.eventShipper;
+          const debug = s.config.debug;
+          instance.disposables.push(
+            await ctx.tool.transform(
+              (editor) => editor.add({
+                name: cfg.toolName,
+                description: cfg.toolDescription,
+                input: selfDiagnosticsInputJsonSchema(cfg),
+                // Direct tool — the host routes everything else through the
+                // codemode `execute` wrapper, where this name isn't callable.
+                options: { codemode: false },
+                async execute(input, context) {
+                  await trackSelfDiagnosticsSignal(
+                    input,
+                    cfg,
+                    eventShipper,
+                    runtime.currentEventId(context.sessionID),
+                    debug
+                  );
+                  return { content: SELF_DIAGNOSTICS_ACK };
+                }
+              })
+            )
+          );
+        }
         if (isFirst) void runEventLoop(s);
         const owner = s;
         return async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/opencode-plugin",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Raindrop observability plugin for OpenCode — automatic session/event/span tracing",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,7 @@
     "@types/node": "^20.11.17",
     "tsup": "^8.4.0",
     "typescript": "^5.3.3",
-    "@raindrop-ai/core": "0.3.0"
+    "@raindrop-ai/core": "0.3.1"
   },
   "tsup": {
     "entry": [