@raindrop-ai/opencode-plugin 0.2.0 → 0.3.0

package/dist/index.js

@@ -2,6 +2,7 @@ import {
   EventShipper,
   PLUGIN_NAME,
   PLUGIN_VERSION,
+  SELF_DIAGNOSTICS_ACK,
   TraceShipper,
   attrString,
   boundedStringify,
@@ -10,9 +11,14 @@ import {
   createAppGitContext,
   generateId,
   loadConfig,
+  normalizeSelfDiagnosticsConfig,
   nowUnixNanoString,
-  resolveLocalDebuggerBaseUrl
-} from "./chunk-4DAI6CYK.js";
+  resolveLocalDebuggerBaseUrl,
+  trackSelfDiagnosticsSignal
+} from "./chunk-FCORH4YS.js";
+
+// src/index.ts
+import { tool } from "@opencode-ai/plugin";
 
 // src/tracing.ts
 import { hostname as osHostname } from "os";
@@ -129,7 +135,7 @@ function markTaskCallFinished(sessionID, callID) {
   running.delete(callID);
   if (running.size === 0) runningTaskCallsBySession.delete(sessionID);
 }
-function endPendingToolSpanWithError(state, callID, tool, toolCallArgs, errorMessage, traceShipper) {
+function endPendingToolSpanWithError(state, callID, tool2, toolCallArgs, errorMessage, traceShipper) {
   const startInfo = state.toolSpanStarts.get(callID);
   if (!startInfo) return false;
   state.toolSpanStarts.delete(callID);
@@ -151,7 +157,7 @@ function endPendingToolSpanWithError(state, callID, tool, toolCallArgs, errorMes
       startTimeUnixNano: startInfo.startTimeUnixNano,
       attributes: [
         attrString("ai.operationId", "ai.toolCall"),
-        attrString("ai.toolCall.name", tool),
+        attrString("ai.toolCall.name", tool2),
         attrString("ai.toolCall.id", callID)
       ]
     });
@@ -188,7 +194,7 @@ function getHostname() {
     return h;
   }
 }
-function createHooks(config, worktree, directory, eventShipper, traceShipper) {
+function createTracing(config, worktree, directory, eventShipper, traceShipper) {
   function log(msg, data) {
     if (!config.debug) return;
     const prefix = `[raindrop-ai/opencode-plugin] [info] ${msg}`;
@@ -214,7 +220,7 @@ function createHooks(config, worktree, directory, eventShipper, traceShipper) {
     callKey,
     log
   });
-  return {
+  const hooks = {
     // ------------------------------------------------------------------
     // event — session lifecycle + streaming parts
     // ------------------------------------------------------------------
@@ -259,14 +265,14 @@ function createHooks(config, worktree, directory, eventShipper, traceShipper) {
           if (partObj["type"] === "text" && typeof partObj["text"] === "string") {
             state.outputParts.set(messageId, capText(partObj["text"]));
           } else if (partObj["type"] === "tool" && messageId) {
-            const tool = partObj["tool"];
+            const tool2 = partObj["tool"];
             const callID = partObj["callID"];
             const partState = partObj["state"];
             if (callID == null || callID === "")
               throw new Error("message.part.updated: part.callID is required for tool part");
             if (partState == null || typeof partState !== "object")
               throw new Error("message.part.updated: part.state is required for tool part");
-            if (tool === "task") {
+            if (tool2 === "task") {
               const metadata = partState["metadata"];
               const childSessionId = metadata != null && typeof metadata === "object" ? metadata["sessionId"] : void 0;
               if (childSessionId != null && childSessionId !== "") {
@@ -291,11 +297,11 @@ function createHooks(config, worktree, directory, eventShipper, traceShipper) {
               if (endPendingToolSpanWithError(
                 state,
                 callID,
-                tool,
+                tool2,
                 toolCallArgs,
                 errorMessage,
                 traceShipper
-              ) && tool === "task") {
+              ) && tool2 === "task") {
                 markTaskCallFinished(partSessionID, callID);
               }
             }
@@ -672,20 +678,20 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
     "tool.execute.before": async (toolInput, _output) => {
       var _a, _b, _c;
       try {
-        const { tool, sessionID, callID } = toolInput;
+        const { tool: tool2, sessionID, callID } = toolInput;
         const state = sessions.get(sessionID);
         if (!state || !state.currentEventId) return;
         const spanParent = state.parentId && state.parentTaskSpanIds ? state.parentTaskSpanIds : (_a = state.currentRootSpan) == null ? void 0 : _a.ids;
         if (!spanParent) return;
         const startTimeUnixNano = nowUnixNanoString();
-        if (tool === "task") {
+        if (tool2 === "task") {
           const liveTaskSpan = traceShipper.startSpan({
             name: "ai.toolCall",
             parent: spanParent,
             eventId: state.currentEventId,
             attributes: [
               attrString("ai.operationId", "ai.toolCall"),
-              attrString("ai.toolCall.name", tool),
+              attrString("ai.toolCall.name", tool2),
               attrString("ai.toolCall.id", callID)
             ]
           });
@@ -710,7 +716,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
             startTimeUnixNano,
             parent: spanParent,
             eventId: state.currentEventId,
-            name: tool,
+            name: tool2,
             liveSpan: liveTaskSpan
           });
         } else {
@@ -718,7 +724,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
             startTimeUnixNano,
             parent: spanParent,
             eventId: state.currentEventId,
-            name: tool
+            name: tool2
           });
         }
       } catch (err) {
@@ -733,7 +739,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
     // ------------------------------------------------------------------
     "tool.execute.after": async (toolInput, result) => {
       try {
-        const { tool, sessionID, callID, args } = toolInput;
+        const { tool: tool2, sessionID, callID, args } = toolInput;
         const state = sessions.get(sessionID);
         if (!state || !state.currentEventId) return;
         if (args === void 0 || args === null)
@@ -743,7 +749,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
         state.toolSpanStarts.delete(callID);
         const resultMetadata = result.metadata;
         const childSessionId = resultMetadata == null ? void 0 : resultMetadata["sessionId"];
-        if (tool === "task" && childSessionId) {
+        if (tool2 === "task" && childSessionId) {
           mapChildSessionToParent.set(childSessionId, { parentId: sessionID });
           attachChildSessionToParentTask(childSessionId, sessionID, callID, "tool.execute.after");
         }
@@ -768,7 +774,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
               endTimeUnixNano,
               attributes: [
                 attrString("ai.operationId", "ai.toolCall"),
-                attrString("ai.toolCall.name", tool),
+                attrString("ai.toolCall.name", tool2),
                 attrString("ai.toolCall.id", callID),
                 attrString("ai.toolCall.args", toolCallArgs),
                 attrString("ai.toolCall.result", toolResult)
@@ -776,7 +782,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
             });
           }
         }
-        if (tool === "task") {
+        if (tool2 === "task") {
           markTaskCallFinished(sessionID, callID);
         }
       } catch (err) {
@@ -829,16 +835,24 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
       }
     }
   };
+  return {
+    hooks,
+    currentEventId(sessionID) {
+      var _a;
+      return (_a = sessions.get(sessionID)) == null ? void 0 : _a.currentEventId;
+    }
+  };
 }
 
 // src/index.ts
-function createRaindropHandle(eventShipper, traceShipper, appGitContext) {
+function createRaindropHandle(eventShipper, traceShipper, appGitContext, currentEventId) {
   return {
     users: {
       async identify(users) {
         await eventShipper.identify(users);
       }
     },
+    currentEventId,
     async flush() {
       await Promise.all([eventShipper.flush(), traceShipper.flush()]);
     },
@@ -855,7 +869,7 @@ function createRaindropHandle(eventShipper, traceShipper, appGitContext) {
   };
 }
 async function plugin(input, opts = {}) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const config = loadConfig(input.directory);
   function appLog(level, message) {
     console.log(`[raindrop-ai/opencode-plugin] [${level}] ${message}`);
@@ -899,14 +913,55 @@ async function plugin(input, opts = {}) {
     appGitContext
   });
   const worktree = (_c = input.worktree) != null ? _c : input.directory;
-  const hooks = createHooks(
+  const tracing = createTracing(
     config,
     worktree,
     input.directory,
     eventShipper,
     traceShipper
   );
-  return { ...hooks, raindrop: createRaindropHandle(eventShipper, traceShipper, appGitContext) };
+  const hooks = tracing.hooks;
+  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 [firstSignalKey, ...restSignalKeys] = config.writeKey.trim() && selfDiagnostics ? selfDiagnostics.signalKeys : [];
+  if (selfDiagnostics && firstSignalKey !== void 0) {
+    const cfg = selfDiagnostics;
+    hooks.tool = {
+      [cfg.toolName]: tool({
+        description: cfg.toolDescription,
+        args: {
+          category: tool.schema.enum([firstSignalKey, ...restSignalKeys]),
+          detail: tool.schema.string()
+        },
+        async execute(args, ctx) {
+          await trackSelfDiagnosticsSignal(
+            args,
+            cfg,
+            eventShipper,
+            tracing.currentEventId(ctx.sessionID),
+            config.debug
+          );
+          return SELF_DIAGNOSTICS_ACK;
+        }
+      })
+    };
+  }
+  return {
+    ...hooks,
+    raindrop: createRaindropHandle(
+      eventShipper,
+      traceShipper,
+      appGitContext,
+      tracing.currentEventId
+    )
+  };
 }
 export {
   plugin as default

package/dist/{index.d-vgBcEZbX.d.cts → self-diagnostics-NiAq-SZ8.d.cts}

@@ -86,4 +86,37 @@ declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => AsyncLocalStorageLike<T>) | undefined;
 }
 
-export type { AppGitOptions as A, IdentifyInput as I, SignalInput as S };
+type SelfDiagnosticsSignalDefinition = {
+    /**
+     * Human-readable meaning of this signal.
+     * Used in the injected tool schema and stored in signal properties.
+     */
+    description: string;
+    /**
+     * Optional default sentiment for this signal key.
+     * This can help dashboards classify negative/positive programmatic signals.
+     */
+    sentiment?: "POSITIVE" | "NEGATIVE";
+};
+type SelfDiagnosticsSignalDefinitions = Record<string, SelfDiagnosticsSignalDefinition>;
+type SelfDiagnosticsOptions = {
+    /** Enable automatic injection of the self diagnostics tool. Default: false */
+    enabled?: boolean;
+    /**
+     * Signal keys and descriptions exposed to the model.
+     * Defaults to a built-in set when omitted.
+     */
+    signals?: SelfDiagnosticsSignalDefinitions;
+    /**
+     * Optional extra guidance for when the model should emit self diagnostics.
+     * The SDK still generates a full tool prompt from `signals`.
+     */
+    guidance?: string;
+    /**
+     * Optional tool name override for the injected self diagnostics tool.
+     * Defaults to "__raindrop_report".
+     */
+    toolName?: string;
+};
+
+export type { AppGitOptions as A, IdentifyInput as I, SelfDiagnosticsOptions as S, SelfDiagnosticsSignalDefinition as a, SelfDiagnosticsSignalDefinitions as b, SignalInput as c };

package/dist/{index.d-vgBcEZbX.d.ts → self-diagnostics-NiAq-SZ8.d.ts}

@@ -86,4 +86,37 @@ declare global {
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => AsyncLocalStorageLike<T>) | undefined;
 }
 
-export type { AppGitOptions as A, IdentifyInput as I, SignalInput as S };
+type SelfDiagnosticsSignalDefinition = {
+    /**
+     * Human-readable meaning of this signal.
+     * Used in the injected tool schema and stored in signal properties.
+     */
+    description: string;
+    /**
+     * Optional default sentiment for this signal key.
+     * This can help dashboards classify negative/positive programmatic signals.
+     */
+    sentiment?: "POSITIVE" | "NEGATIVE";
+};
+type SelfDiagnosticsSignalDefinitions = Record<string, SelfDiagnosticsSignalDefinition>;
+type SelfDiagnosticsOptions = {
+    /** Enable automatic injection of the self diagnostics tool. Default: false */
+    enabled?: boolean;
+    /**
+     * Signal keys and descriptions exposed to the model.
+     * Defaults to a built-in set when omitted.
+     */
+    signals?: SelfDiagnosticsSignalDefinitions;
+    /**
+     * Optional extra guidance for when the model should emit self diagnostics.
+     * The SDK still generates a full tool prompt from `signals`.
+     */
+    guidance?: string;
+    /**
+     * Optional tool name override for the injected self diagnostics tool.
+     * Defaults to "__raindrop_report".
+     */
+    toolName?: string;
+};
+
+export type { AppGitOptions as A, IdentifyInput as I, SelfDiagnosticsOptions as S, SelfDiagnosticsSignalDefinition as a, SelfDiagnosticsSignalDefinitions as b, SignalInput as c };

package/dist/v2.cjs

@@ -2309,9 +2309,41 @@ function loadConfig(projectDirectory) {
     captureSystemPrompt: process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] !== void 0 ? process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] === "true" : (_h = merged.capture_system_prompt) != null ? _h : false,
     eventMetadata,
     localWorkshopUrl: resolveLocalWorkshopUrl(merged.local_workshop_url),
-    appGit: mapAppGit(merged.app_git)
+    appGit: mapAppGit(merged.app_git),
+    selfDiagnostics: mapSelfDiagnostics(merged.self_diagnostics)
   };
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function mapSelfDiagnostics(value) {
+  const env = process.env["RAINDROP_SELF_DIAGNOSTICS"];
+  const record = isRecord(value) ? value : {};
+  const enabled = env !== void 0 ? env === "true" : typeof record["enabled"] === "boolean" ? record["enabled"] : void 0;
+  const signals = mapSelfDiagnosticsSignals(record["signals"]);
+  const options = {
+    ...enabled !== void 0 ? { enabled } : {},
+    ...signals ? { signals } : {},
+    ...typeof record["guidance"] === "string" ? { guidance: record["guidance"] } : {},
+    ...typeof record["tool_name"] === "string" ? { toolName: record["tool_name"] } : {}
+  };
+  return Object.keys(options).length > 0 ? options : void 0;
+}
+function mapSelfDiagnosticsSignals(value) {
+  if (!isRecord(value)) return void 0;
+  const out = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (!isRecord(entry)) continue;
+    const definition = entry;
+    if (typeof definition["description"] !== "string") continue;
+    const sentiment = definition["sentiment"];
+    out[key] = {
+      description: definition["description"],
+      ...sentiment === "POSITIVE" || sentiment === "NEGATIVE" ? { sentiment } : {}
+    };
+  }
+  return Object.keys(out).length > 0 ? out : void 0;
+}
 function mapAppGit(value) {
   if (value === false) return false;
   if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
@@ -2338,7 +2370,7 @@ function resolveLocalWorkshopUrl(fileValue) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/opencode-plugin",
-  version: "0.2.0",
+  version: "0.3.0",
   description: "Raindrop observability plugin for OpenCode \u2014 automatic session/event/span tracing",
   type: "module",
   main: "dist/index.js",
@@ -2427,6 +2459,185 @@ var package_default = {
 var PLUGIN_NAME = package_default.name;
 var PLUGIN_VERSION = package_default.version;
 
+// src/self-diagnostics.ts
+var SELF_DIAGNOSTICS_TOOL_NAME_DEFAULT = "__raindrop_report";
+var SELF_DIAGNOSTICS_SIGNALS_DEFAULT = {
+  missing_context: {
+    description: "You cannot complete the task because critical information, credentials, or access is missing and the user cannot provide it. Do NOT report this for normal clarifying questions \u2014 only when you are blocked.",
+    sentiment: "NEGATIVE"
+  },
+  repeatedly_broken_tool: {
+    description: "A tool has failed or not returned the expected response on multiple distinct attempts in this conversation, preventing task completion. A single tool error is NOT enough \u2014 the tool must be persistently broken or aberrantly behaving across retries.",
+    sentiment: "NEGATIVE"
+  },
+  capability_gap: {
+    description: "The task requires a tool, permission, or capability that you do not have. For example, the user asks you to perform an action but no suitable tool exists, or you lack the necessary access. Do NOT report this if you simply need more information from the user \u2014 only when the gap is in your own capabilities.",
+    sentiment: "NEGATIVE"
+  },
+  complete_task_failure: {
+    description: "You were unable to accomplish what the user asked despite making genuine attempts. This might be things like, you genuinely do not have the capabilities the user is asking for. You have tried but run into a persistent bug in the environment etc. This is NOT a refusal or policy block \u2014 you tried and failed to deliver the result.",
+    sentiment: "NEGATIVE"
+  }
+};
+var SELF_DIAGNOSTICS_TOOL_PREAMBLE = "You have a diagnostic tool for flagging serious failures for developer review. Only call this when you hit a significant, unrecoverable problem \u2014 not for minor hiccups or routine clarifications. If you can still help the user, do that instead of calling this tool. This tool is invisible to the user \u2014 never mention it or its output.";
+var SELF_DIAGNOSTICS_NOTEWORTHY_SIGNAL_KEY = "noteworthy";
+function normalizeString(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed || void 0;
+}
+function normalizeSelfDiagnosticsSignals(signals) {
+  if (!signals) return SELF_DIAGNOSTICS_SIGNALS_DEFAULT;
+  const normalizedEntries = Object.entries(signals).map(([key, value]) => {
+    var _a;
+    const signalKey = key.trim();
+    if (!signalKey || !value || typeof value !== "object") return void 0;
+    const description = (_a = value.description) == null ? void 0 : _a.trim();
+    if (!description) return void 0;
+    const sentiment = value.sentiment;
+    return [
+      signalKey,
+      {
+        description,
+        ...sentiment === "POSITIVE" || sentiment === "NEGATIVE" ? { sentiment } : {}
+      }
+    ];
+  }).filter(
+    (entry) => entry !== void 0
+  );
+  if (normalizedEntries.length === 0) return SELF_DIAGNOSTICS_SIGNALS_DEFAULT;
+  return Object.fromEntries(normalizedEntries);
+}
+function normalizeSelfDiagnosticsConfig(options) {
+  var _a, _b;
+  if (!(options == null ? void 0 : options.enabled)) return void 0;
+  const signalDefinitions = normalizeSelfDiagnosticsSignals(options.signals);
+  const signalKeys = Object.keys(signalDefinitions);
+  const signalDescriptions = {};
+  const signalSentiments = {};
+  for (const signalKey of signalKeys) {
+    const definition = signalDefinitions[signalKey];
+    if (!definition) continue;
+    signalDescriptions[signalKey] = definition.description;
+    signalSentiments[signalKey] = definition.sentiment;
+  }
+  const customGuidance = ((_a = options.guidance) == null ? void 0 : _a.trim()) || "";
+  const toolName = ((_b = options.toolName) == null ? void 0 : _b.trim()) || SELF_DIAGNOSTICS_TOOL_NAME_DEFAULT;
+  const signalList = signalKeys.map((signalKey) => {
+    const sentiment = signalSentiments[signalKey];
+    const sentimentTag = sentiment ? ` [${sentiment.toLowerCase()}]` : "";
+    return `- ${signalKey}: ${signalDescriptions[signalKey]}${sentimentTag}`;
+  }).join("\n");
+  const guidanceBlock = customGuidance ? `
+Additional guidance: ${customGuidance}
+` : "";
+  const toolDescription = `${SELF_DIAGNOSTICS_TOOL_PREAMBLE}
+
+When to call:
+- You are blocked from completing the task due to missing information or access that the user cannot provide.
+- A tool is persistently failing across multiple attempts, not just a single transient error.
+- The task requires a tool, permission, or capability you do not have.
+- You genuinely cannot deliver what the user asked for despite trying.
+
+When NOT to call:
+- Normal clarifying questions or back-and-forth with the user.
+- A single tool error that you can recover from or retry.
+- You successfully completed the task, even if it was difficult.
+- Policy refusals or content filtering \u2014 those are working as intended.
+
+Rules:
+1. Pick the single best category.
+2. Do not fabricate issues. Only report what is evident from the conversation.
+3. Err on the side of NOT calling this tool. When in doubt, help the user instead.
+${guidanceBlock}
+Categories:
+` + signalList;
+  return {
+    toolName,
+    toolDescription,
+    signalKeys,
+    signalKeySet: new Set(signalKeys),
+    signalDescriptions,
+    signalSentiments
+  };
+}
+var SELF_DIAGNOSTICS_ACK = '{"acknowledged":true}';
+function selfDiagnosticsInputJsonSchema(config) {
+  return {
+    type: "object",
+    properties: {
+      category: {
+        type: "string",
+        enum: config.signalKeys,
+        description: "The single best-matching category from the list above."
+      },
+      detail: {
+        type: "string",
+        description: "One sentence of factual context: what happened and why it matters. Do not include PII or secrets."
+      }
+    },
+    required: ["category", "detail"],
+    additionalProperties: false
+  };
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function trackSelfDiagnosticsSignal(toolInput, config, eventShipper, eventId, debug) {
+  var _a, _b;
+  try {
+    const input = isRecord2(toolInput) ? toolInput : void 0;
+    const fallbackCategory = (_a = config.signalKeys[0]) != null ? _a : "unknown";
+    const categoryCandidate = normalizeString(input == null ? void 0 : input["category"]);
+    const category = categoryCandidate && config.signalKeySet.has(categoryCandidate) ? categoryCandidate : fallbackCategory;
+    const detail = (_b = normalizeString(input == null ? void 0 : input["detail"])) != null ? _b : "";
+    if (!eventId) {
+      if (debug) {
+        console.warn(
+          "[raindrop-ai/opencode-plugin] self diagnostics signal skipped: no open event for this session."
+        );
+      }
+      return;
+    }
+    if (category === SELF_DIAGNOSTICS_NOTEWORTHY_SIGNAL_KEY) {
+      await eventShipper.trackSignal({
+        eventId,
+        name: "self diagnostics - noteworthy",
+        type: "agent_internal",
+        properties: {
+          source: "agent_flag_event_tool",
+          reason: detail,
+          severity: "medium",
+          sdk: "opencode-plugin",
+          sdk_version: PLUGIN_VERSION
+        }
+      });
+      return;
+    }
+    await eventShipper.trackSignal({
+      eventId,
+      name: `self diagnostics - ${category}`,
+      type: "agent",
+      sentiment: config.signalSentiments[category],
+      properties: {
+        source: "agent_reporting_tool",
+        category,
+        signal_description: config.signalDescriptions[category],
+        sdk: "opencode-plugin",
+        sdk_version: PLUGIN_VERSION,
+        ...detail ? { detail } : {}
+      }
+    });
+  } catch (err) {
+    if (debug) {
+      const message = err instanceof Error ? err.message : String(err);
+      console.warn(
+        `[raindrop-ai/opencode-plugin] selfDiagnostics signal dispatch failed: ${message}`
+      );
+    }
+  }
+}
+
 // src/shipper.ts
 var EventShipper3 = class extends EventShipper2 {
   constructor(opts) {
@@ -3223,7 +3434,7 @@ function raindrop(opts = {}) {
     }
   }
   function createShared(ctx) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const config = loadConfig((_a = opts.directory) != null ? _a : ctx.location.directory);
     const resolvedLocalUrl = resolveLocalDebuggerBaseUrl(config.localWorkshopUrl);
     const hasLocalDestination = resolvedLocalUrl !== null;
@@ -3256,9 +3467,20 @@ function raindrop(opts = {}) {
     };
     const eventShipper = new EventShipper3(shipperOptions);
     const traceShipper = new TraceShipper3(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(),
@@ -3310,6 +3532,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/dist/v2.d.cts

@@ -1,11 +1,14 @@
 import { Plugin } from '@opencode/plugin';
-import { I as IdentifyInput, S as SignalInput, A as AppGitOptions } from './index.d-vgBcEZbX.cjs';
+import { I as IdentifyInput, c as SignalInput, A as AppGitOptions, S as SelfDiagnosticsOptions } from './self-diagnostics-NiAq-SZ8.cjs';
+export { a as SelfDiagnosticsSignalDefinition, b as SelfDiagnosticsSignalDefinitions } from './self-diagnostics-NiAq-SZ8.cjs';
 
 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;
 }
 /**
  * The Raindrop control handle exposed on the v2 plugin. Unlike v1 (where the
@@ -38,4 +41,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.d.ts

@@ -1,11 +1,14 @@
 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 } from './self-diagnostics-NiAq-SZ8.js';
+export { a as SelfDiagnosticsSignalDefinition, b as SelfDiagnosticsSignalDefinitions } from './self-diagnostics-NiAq-SZ8.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;
 }
 /**
  * The Raindrop control handle exposed on the v2 plugin. Unlike v1 (where the
@@ -38,4 +41,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 };