raindrop-ai 0.0.84 → 0.0.85

package/dist/{chunk-UEKYAG7S.mjs → chunk-EVQT43DR.mjs}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.84",
+  version: "0.0.85",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",

package/dist/index.d.mts

@@ -72,6 +72,20 @@ type AgentSignal = BasicSignal & {
     type: "agent" | "agent_internal";
 };
 type SignalEvent = DefaultSignal | FeedbackSignal | EditSignal | AgentSignal;
+type SelfDiagnoseOptions = {
+    /** The interaction/event ID this diagnostic belongs to. */
+    eventId: string;
+    /** A human-readable description of the issue. */
+    description: string;
+    /** Optional category to group the diagnostic under (e.g. "missing_context", "capability_gap"). Defaults to "general". */
+    category?: string;
+    /** Optional source identifier (e.g. your agent or service name). */
+    source?: string;
+    /** Signal sentiment. Defaults to "NEGATIVE". */
+    sentiment?: "POSITIVE" | "NEGATIVE";
+    /** Additional custom properties to attach to the signal. */
+    properties?: Record<string, unknown>;
+};
 type SelfDiagnosticsSignalDefinition = {
     description: string;
     sentiment?: "POSITIVE" | "NEGATIVE";
@@ -847,6 +861,28 @@ declare class Raindrop {
      */
     trackAi(event: AiTrackEvent | AiTrackEvent[]): string | Array<string | undefined> | undefined;
     setUserDetails(event: IdentifyEvent): void;
+    /**
+     * Report a self-diagnostic signal. This is a convenient shorthand for sending
+     * signals that appear in the Self Diagnostics tab of the Raindrop dashboard.
+     *
+     * @param options - The diagnostic details.
+     * @param options.eventId - The interaction/event ID this diagnostic belongs to.
+     * @param options.description - A human-readable description of the issue.
+     * @param options.category - Optional category (e.g. "missing_context"). Defaults to "general".
+     * @param options.source - Optional source identifier. Defaults to "selfDiagnose".
+     * @param options.sentiment - Signal sentiment. Defaults to "NEGATIVE".
+     * @param options.properties - Additional custom properties.
+     *
+     * @example
+     * ```typescript
+     * raindrop.selfDiagnose({
+     *   eventId: "evt_123",
+     *   description: "User asked for production DB access but no credentials were provided.",
+     *   category: "missing_context",
+     * });
+     * ```
+     */
+    selfDiagnose(options: SelfDiagnoseOptions): void;
     trackSignal(signal: SignalEvent | SignalEvent[]): void | void[];
     private getSize;
     private saveToBuffer;
@@ -884,4 +920,4 @@ declare class Raindrop {
     close(): Promise<void>;
 }
 
-export { type AiTrackEvent, type Attachment, type AttachmentType, type BeginInteractionOptions, type FinishInteractionOptions, type IdentifyEvent, type Interaction, MAX_INGEST_SIZE_BYTES, type PartialAiTrackEvent, Raindrop, type RaindropSpanProcessor, type SelfDiagnosticsExecuteContext, type SelfDiagnosticsExecuteResult, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInputSchema, type SelfDiagnosticsToolOptions, type SignalEvent, type SpanParams, type ToolParams, type ToolSpan, type TraceContext, type Tracer, type TrackToolParams, type WorkflowParams, Raindrop as default };
+export { type AiTrackEvent, type Attachment, type AttachmentType, type BeginInteractionOptions, type FinishInteractionOptions, type IdentifyEvent, type Interaction, MAX_INGEST_SIZE_BYTES, type PartialAiTrackEvent, Raindrop, type RaindropSpanProcessor, type SelfDiagnoseOptions, type SelfDiagnosticsExecuteContext, type SelfDiagnosticsExecuteResult, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInputSchema, type SelfDiagnosticsToolOptions, type SignalEvent, type SpanParams, type ToolParams, type ToolSpan, type TraceContext, type Tracer, type TrackToolParams, type WorkflowParams, Raindrop as default };

package/dist/index.d.ts

@@ -72,6 +72,20 @@ type AgentSignal = BasicSignal & {
     type: "agent" | "agent_internal";
 };
 type SignalEvent = DefaultSignal | FeedbackSignal | EditSignal | AgentSignal;
+type SelfDiagnoseOptions = {
+    /** The interaction/event ID this diagnostic belongs to. */
+    eventId: string;
+    /** A human-readable description of the issue. */
+    description: string;
+    /** Optional category to group the diagnostic under (e.g. "missing_context", "capability_gap"). Defaults to "general". */
+    category?: string;
+    /** Optional source identifier (e.g. your agent or service name). */
+    source?: string;
+    /** Signal sentiment. Defaults to "NEGATIVE". */
+    sentiment?: "POSITIVE" | "NEGATIVE";
+    /** Additional custom properties to attach to the signal. */
+    properties?: Record<string, unknown>;
+};
 type SelfDiagnosticsSignalDefinition = {
     description: string;
     sentiment?: "POSITIVE" | "NEGATIVE";
@@ -847,6 +861,28 @@ declare class Raindrop {
      */
     trackAi(event: AiTrackEvent | AiTrackEvent[]): string | Array<string | undefined> | undefined;
     setUserDetails(event: IdentifyEvent): void;
+    /**
+     * Report a self-diagnostic signal. This is a convenient shorthand for sending
+     * signals that appear in the Self Diagnostics tab of the Raindrop dashboard.
+     *
+     * @param options - The diagnostic details.
+     * @param options.eventId - The interaction/event ID this diagnostic belongs to.
+     * @param options.description - A human-readable description of the issue.
+     * @param options.category - Optional category (e.g. "missing_context"). Defaults to "general".
+     * @param options.source - Optional source identifier. Defaults to "selfDiagnose".
+     * @param options.sentiment - Signal sentiment. Defaults to "NEGATIVE".
+     * @param options.properties - Additional custom properties.
+     *
+     * @example
+     * ```typescript
+     * raindrop.selfDiagnose({
+     *   eventId: "evt_123",
+     *   description: "User asked for production DB access but no credentials were provided.",
+     *   category: "missing_context",
+     * });
+     * ```
+     */
+    selfDiagnose(options: SelfDiagnoseOptions): void;
     trackSignal(signal: SignalEvent | SignalEvent[]): void | void[];
     private getSize;
     private saveToBuffer;
@@ -884,4 +920,4 @@ declare class Raindrop {
     close(): Promise<void>;
 }
 
-export { type AiTrackEvent, type Attachment, type AttachmentType, type BeginInteractionOptions, type FinishInteractionOptions, type IdentifyEvent, type Interaction, MAX_INGEST_SIZE_BYTES, type PartialAiTrackEvent, Raindrop, type RaindropSpanProcessor, type SelfDiagnosticsExecuteContext, type SelfDiagnosticsExecuteResult, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInputSchema, type SelfDiagnosticsToolOptions, type SignalEvent, type SpanParams, type ToolParams, type ToolSpan, type TraceContext, type Tracer, type TrackToolParams, type WorkflowParams, Raindrop as default };
+export { type AiTrackEvent, type Attachment, type AttachmentType, type BeginInteractionOptions, type FinishInteractionOptions, type IdentifyEvent, type Interaction, MAX_INGEST_SIZE_BYTES, type PartialAiTrackEvent, Raindrop, type RaindropSpanProcessor, type SelfDiagnoseOptions, type SelfDiagnosticsExecuteContext, type SelfDiagnosticsExecuteResult, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInputSchema, type SelfDiagnosticsToolOptions, type SignalEvent, type SpanParams, type ToolParams, type ToolSpan, type TraceContext, type Tracer, type TrackToolParams, type WorkflowParams, Raindrop as default };

package/dist/index.js

@@ -138,7 +138,7 @@ var CategorizationRequestSchema = import_zod.z.object({
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.84",
+  version: "0.0.85",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -1880,6 +1880,49 @@ var Raindrop = class {
       ...parsed.data
     });
   }
+  /**
+   * Report a self-diagnostic signal. This is a convenient shorthand for sending
+   * signals that appear in the Self Diagnostics tab of the Raindrop dashboard.
+   *
+   * @param options - The diagnostic details.
+   * @param options.eventId - The interaction/event ID this diagnostic belongs to.
+   * @param options.description - A human-readable description of the issue.
+   * @param options.category - Optional category (e.g. "missing_context"). Defaults to "general".
+   * @param options.source - Optional source identifier. Defaults to "selfDiagnose".
+   * @param options.sentiment - Signal sentiment. Defaults to "NEGATIVE".
+   * @param options.properties - Additional custom properties.
+   *
+   * @example
+   * ```typescript
+   * raindrop.selfDiagnose({
+   *   eventId: "evt_123",
+   *   description: "User asked for production DB access but no credentials were provided.",
+   *   category: "missing_context",
+   * });
+   * ```
+   */
+  selfDiagnose(options) {
+    var _a, _b, _c;
+    if (this.disabled) {
+      return;
+    }
+    const category = ((_a = options.category) == null ? void 0 : _a.trim()) || "general";
+    const source = ((_b = options.source) == null ? void 0 : _b.trim()) || "selfDiagnose";
+    const sentiment = (_c = options.sentiment) != null ? _c : "NEGATIVE";
+    this.trackSignal({
+      eventId: options.eventId,
+      name: `self diagnostics - ${category}`,
+      type: "agent",
+      sentiment,
+      properties: {
+        ...options.properties,
+        source,
+        category,
+        detail: options.description,
+        signal_description: options.description
+      }
+    });
+  }
   trackSignal(signal) {
     if (this.disabled) {
       return;

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   package_default,
   tracing
-} from "./chunk-UEKYAG7S.mjs";
+} from "./chunk-EVQT43DR.mjs";
 
 // ../schemas/src/ingest/index.ts
 import { z } from "zod";
@@ -679,6 +679,49 @@ var Raindrop = class {
       ...parsed.data
     });
   }
+  /**
+   * Report a self-diagnostic signal. This is a convenient shorthand for sending
+   * signals that appear in the Self Diagnostics tab of the Raindrop dashboard.
+   *
+   * @param options - The diagnostic details.
+   * @param options.eventId - The interaction/event ID this diagnostic belongs to.
+   * @param options.description - A human-readable description of the issue.
+   * @param options.category - Optional category (e.g. "missing_context"). Defaults to "general".
+   * @param options.source - Optional source identifier. Defaults to "selfDiagnose".
+   * @param options.sentiment - Signal sentiment. Defaults to "NEGATIVE".
+   * @param options.properties - Additional custom properties.
+   *
+   * @example
+   * ```typescript
+   * raindrop.selfDiagnose({
+   *   eventId: "evt_123",
+   *   description: "User asked for production DB access but no credentials were provided.",
+   *   category: "missing_context",
+   * });
+   * ```
+   */
+  selfDiagnose(options) {
+    var _a, _b, _c;
+    if (this.disabled) {
+      return;
+    }
+    const category = ((_a = options.category) == null ? void 0 : _a.trim()) || "general";
+    const source = ((_b = options.source) == null ? void 0 : _b.trim()) || "selfDiagnose";
+    const sentiment = (_c = options.sentiment) != null ? _c : "NEGATIVE";
+    this.trackSignal({
+      eventId: options.eventId,
+      name: `self diagnostics - ${category}`,
+      type: "agent",
+      sentiment,
+      properties: {
+        ...options.properties,
+        source,
+        category,
+        detail: options.description,
+        signal_description: options.description
+      }
+    });
+  }
   trackSignal(signal) {
     if (this.disabled) {
       return;

package/dist/tracing/index.js

@@ -184,7 +184,7 @@ function base64Encode(bytes) {
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.84",
+  version: "0.0.85",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",

package/dist/tracing/index.mjs

@@ -1,6 +1,6 @@
 import {
   tracing
-} from "../chunk-UEKYAG7S.mjs";
+} from "../chunk-EVQT43DR.mjs";
 
 // src/tracing/index.ts
 function initTracing() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raindrop-ai",
-  "version": "0.0.84",
+  "version": "0.0.85",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",