@raindrop-ai/opencode-plugin 0.2.0 → 0.3.1

package/dist/index.d.cts

@@ -1,9 +1,17 @@
-import { I as IdentifyInput, A as AppGitOptions } from './index.d-vgBcEZbX.cjs';
+import { I as IdentifyInput, A as AppGitOptions, S as SelfDiagnosticsOptions, P as PromptToolsOverride } from './self-diagnostics-CLW6h4zB.cjs';
+export { a as SelfDiagnosticsSignalDefinition, b as SelfDiagnosticsSignalDefinitions } from './self-diagnostics-CLW6h4zB.cjs';
 import { Hooks, PluginInput } from '@opencode-ai/plugin';
 
 interface RaindropOpencodeOptions {
     /** Application Git identity override. false disables enrichment. */
     appGit?: AppGitOptions | false;
+    /** 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 `client.tool.list` lookup entirely.
+     */
+    tools?: PromptToolsOverride;
 }
 /**
  * The Raindrop control handle exposed alongside the OpenCode hooks.
@@ -25,6 +33,8 @@ interface RaindropOpencodeHandle {
          */
         identify(users: IdentifyInput | IdentifyInput[]): Promise<void>;
     };
+    /** Raindrop eventId of the turn currently open for this OpenCode session, if any. */
+    currentEventId(sessionID: string): string | undefined;
     /** Drain the buffered event + trace shippers. */
     flush(): Promise<void>;
     /** Flush and tear down the shippers (also wired into session teardown). */
@@ -53,4 +63,4 @@ type RaindropOpencodeHooks = Hooks & {
  */
 declare function plugin(input: PluginInput, opts?: RaindropOpencodeOptions): Promise<RaindropOpencodeHooks>;
 
-export { IdentifyInput, type RaindropOpencodeHandle, type RaindropOpencodeHooks, type RaindropOpencodeOptions, plugin as default };
+export { IdentifyInput, type RaindropOpencodeHandle, type RaindropOpencodeHooks, type RaindropOpencodeOptions, SelfDiagnosticsOptions, plugin as default };

package/dist/index.d.ts

@@ -1,9 +1,17 @@
-import { I as IdentifyInput, A as AppGitOptions } from './index.d-vgBcEZbX.js';
+import { I as IdentifyInput, 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';
 import { Hooks, PluginInput } from '@opencode-ai/plugin';
 
 interface RaindropOpencodeOptions {
     /** Application Git identity override. false disables enrichment. */
     appGit?: AppGitOptions | false;
+    /** 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 `client.tool.list` lookup entirely.
+     */
+    tools?: PromptToolsOverride;
 }
 /**
  * The Raindrop control handle exposed alongside the OpenCode hooks.
@@ -25,6 +33,8 @@ interface RaindropOpencodeHandle {
          */
         identify(users: IdentifyInput | IdentifyInput[]): Promise<void>;
     };
+    /** Raindrop eventId of the turn currently open for this OpenCode session, if any. */
+    currentEventId(sessionID: string): string | undefined;
     /** Drain the buffered event + trace shippers. */
     flush(): Promise<void>;
     /** Flush and tear down the shippers (also wired into session teardown). */
@@ -53,4 +63,4 @@ type RaindropOpencodeHooks = Hooks & {
  */
 declare function plugin(input: PluginInput, opts?: RaindropOpencodeOptions): Promise<RaindropOpencodeHooks>;
 
-export { IdentifyInput, type RaindropOpencodeHandle, type RaindropOpencodeHooks, type RaindropOpencodeOptions, plugin as default };
+export { IdentifyInput, type RaindropOpencodeHandle, type RaindropOpencodeHooks, type RaindropOpencodeOptions, SelfDiagnosticsOptions, plugin as default };

package/dist/index.js

@@ -2,17 +2,25 @@ import {
   EventShipper,
   PLUGIN_NAME,
   PLUGIN_VERSION,
+  SELF_DIAGNOSTICS_ACK,
   TraceShipper,
   attrString,
   boundedStringify,
   buildLlmGenAiAttributes,
   capText,
   createAppGitContext,
+  createToolCatalog,
   generateId,
   loadConfig,
+  normalizeSelfDiagnosticsConfig,
   nowUnixNanoString,
-  resolveLocalDebuggerBaseUrl
-} from "./chunk-4DAI6CYK.js";
+  promptToolsAttributes,
+  resolveLocalDebuggerBaseUrl,
+  trackSelfDiagnosticsSignal
+} from "./chunk-ZG47FVK7.js";
+
+// src/index.ts
+import { tool } from "@opencode-ai/plugin";
 
 // src/tracing.ts
 import { hostname as osHostname } from "os";
@@ -129,7 +137,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 +159,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 +196,7 @@ function getHostname() {
     return h;
   }
 }
-function createHooks(config, worktree, directory, eventShipper, traceShipper) {
+function createTracing(config, worktree, directory, eventShipper, traceShipper, toolCatalog) {
   function log(msg, data) {
     if (!config.debug) return;
     const prefix = `[raindrop-ai/opencode-plugin] [info] ${msg}`;
@@ -214,7 +222,15 @@ function createHooks(config, worktree, directory, eventShipper, traceShipper) {
     callKey,
     log
   });
-  return {
+  const hooks = {
+    // Fires before each model call with the model already resolved: start the
+    // catalog lookup now so the span attributes rarely wait on it later.
+    "chat.params": async (input) => {
+      void (toolCatalog == null ? void 0 : toolCatalog.resolve(input.sessionID, {
+        provider: input.model.providerID,
+        model: input.model.id
+      }));
+    },
     // ------------------------------------------------------------------
     // event — session lifecycle + streaming parts
     // ------------------------------------------------------------------
@@ -259,14 +275,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 +307,11 @@ function createHooks(config, worktree, directory, eventShipper, traceShipper) {
               if (endPendingToolSpanWithError(
                 state,
                 callID,
-                tool,
+                tool2,
                 toolCallArgs,
                 errorMessage,
                 traceShipper
-              ) && tool === "task") {
+              ) && tool2 === "task") {
                 markTaskCallFinished(partSessionID, callID);
               }
             }
@@ -339,6 +355,9 @@ function createHooks(config, worktree, directory, eventShipper, traceShipper) {
               "message.updated: providerID and modelID are required non-empty strings"
             );
           const modelName = `${providerID}/${modelID}`;
+          const promptTools = promptToolsAttributes(
+            await (toolCatalog == null ? void 0 : toolCatalog.resolve(String(msgSessionID), { provider: providerID, model: modelID }))
+          );
           const finishReason = info2["finish"];
           const outputText = state.outputParts.get(messageId);
           const reasoningText = state.reasoningParts.get(messageId);
@@ -364,7 +383,8 @@ type: ${name != null ? name : "UnknownError"}`;
             const llmAttrs = [
               attrString("ai.operationId", "generateText"),
               attrString("ai.response.text", responseText),
-              ...buildLlmGenAiAttributes({ providerID, modelID, tokens: tokensObj })
+              ...buildLlmGenAiAttributes({ providerID, modelID, tokens: tokensObj }),
+              ...promptTools
             ];
             if (state.currentSystemPrompt) {
               llmAttrs.push(
@@ -400,7 +420,8 @@ type: ${name != null ? name : "UnknownError"}`;
                 buildPromptMessages(state.currentSystemPrompt, state.currentInput)
               ),
               attrString("ai.response.text", turnOutputText),
-              ...buildLlmGenAiAttributes({ providerID, modelID, tokens: tokensObj })
+              ...buildLlmGenAiAttributes({ providerID, modelID, tokens: tokensObj }),
+              ...promptTools
             ];
             if (state.currentSystemPrompt) {
               llmAttrs.push(
@@ -445,7 +466,8 @@ type: ${name != null ? name : "UnknownError"}`;
                 buildPromptMessages(state.currentSystemPrompt, state.currentInput)
               ),
               attrString("ai.response.text", turnOutputText),
-              ...buildLlmGenAiAttributes({ providerID, modelID, tokens: tokensObj })
+              ...buildLlmGenAiAttributes({ providerID, modelID, tokens: tokensObj }),
+              ...promptTools
             ];
             if (isCompaction) {
               rootAttrs.push(attrString("is_compaction", "true"));
@@ -511,6 +533,7 @@ type: ${name != null ? name : "UnknownError"}`;
           if (state.parentId) {
             cleanupSessionParentMap(String(sessionID));
             sessions.delete(String(sessionID));
+            toolCatalog == null ? void 0 : toolCatalog.forget(String(sessionID));
           } else {
           }
         } else if (event.type === "session.deleted") {
@@ -527,6 +550,7 @@ type: ${name != null ? name : "UnknownError"}`;
           cleanupSessionParentMap(String(sessionID));
           await Promise.all([eventShipper.flush(), traceShipper.flush()]);
           sessions.delete(String(sessionID));
+          toolCatalog == null ? void 0 : toolCatalog.forget(String(sessionID));
         } else if (event.type === "session.error") {
           const errorSessionID = (_h = props["sessionID"]) != null ? _h : sessionID;
           if (errorSessionID === void 0 || errorSessionID === "")
@@ -552,6 +576,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
           cleanupSessionParentMap(String(errorSessionID));
           await Promise.all([eventShipper.flush(), traceShipper.flush()]);
           sessions.delete(String(errorSessionID));
+          toolCatalog == null ? void 0 : toolCatalog.forget(String(errorSessionID));
         }
       } catch (err) {
         rateLimitedErrorLog(
@@ -672,20 +697,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 +735,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
             startTimeUnixNano,
             parent: spanParent,
             eventId: state.currentEventId,
-            name: tool,
+            name: tool2,
             liveSpan: liveTaskSpan
           });
         } else {
@@ -718,7 +743,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
             startTimeUnixNano,
             parent: spanParent,
             eventId: state.currentEventId,
-            name: tool
+            name: tool2
           });
         }
       } catch (err) {
@@ -733,7 +758,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 +768,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 +793,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 +801,7 @@ type: ${errorName != null ? errorName : "UnknownError"}`;
             });
           }
         }
-        if (tool === "task") {
+        if (tool2 === "task") {
           markTaskCallFinished(sessionID, callID);
         }
       } catch (err) {
@@ -829,16 +854,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 +888,7 @@ function createRaindropHandle(eventShipper, traceShipper, appGitContext) {
   };
 }
 async function plugin(input, opts = {}) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d, _e;
   const config = loadConfig(input.directory);
   function appLog(level, message) {
     console.log(`[raindrop-ai/opencode-plugin] [${level}] ${message}`);
@@ -899,14 +932,61 @@ async function plugin(input, opts = {}) {
     appGitContext
   });
   const worktree = (_c = input.worktree) != null ? _c : input.directory;
-  const hooks = createHooks(
+  const toolCatalog = createToolCatalog({
+    override: (_d = opts.tools) != null ? _d : config.tools,
+    fetch: (query) => input.client.tool.list({ query }),
+    debug: config.debug
+  });
+  const tracing = createTracing(
     config,
     worktree,
     input.directory,
     eventShipper,
-    traceShipper
+    traceShipper,
+    toolCatalog
+  );
+  const hooks = tracing.hooks;
+  const selfDiagnostics = normalizeSelfDiagnosticsConfig(
+    (_e = opts.selfDiagnostics) != null ? _e : config.selfDiagnostics
   );
-  return { ...hooks, raindrop: createRaindropHandle(eventShipper, traceShipper, appGitContext) };
+  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-CLW6h4zB.d.cts}

@@ -85,5 +85,64 @@ declare global {
     var RAINDROP_CONTEXT_MANAGER: (new () => ContextManager) | undefined;
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => AsyncLocalStorageLike<T>) | undefined;
 }
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
+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, SignalInput as S };
+export type { AppGitOptions as A, IdentifyInput as I, PromptToolsOverride as P, SelfDiagnosticsOptions as S, SelfDiagnosticsSignalDefinition as a, SelfDiagnosticsSignalDefinitions as b, SignalInput as c };

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

@@ -85,5 +85,64 @@ declare global {
     var RAINDROP_CONTEXT_MANAGER: (new () => ContextManager) | undefined;
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => AsyncLocalStorageLike<T>) | undefined;
 }
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
+
+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, SignalInput as S };
+export type { AppGitOptions as A, IdentifyInput as I, PromptToolsOverride as P, SelfDiagnosticsOptions as S, SelfDiagnosticsSignalDefinition as a, SelfDiagnosticsSignalDefinitions as b, SignalInput as c };