@raindrop-ai/ai-sdk 0.0.11 → 0.0.13

package/dist/{chunk-MUDB4FLO.mjs → chunk-BQPXVMAV.mjs}

@@ -84,7 +84,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.11"};
+  version: "0.0.13"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -1257,21 +1257,24 @@ function attrsFromGenAiRequest(options) {
 // src/internal/wrap/wrapAISDK.ts
 var AGENT_REPORTING_TOOL_NAME_DEFAULT = "__raindrop_report";
 var AGENT_REPORTING_SIGNALS_DEFAULT = {
-  tool_failure: {
-    description: "A tool call returned an error, timed out, or produced output that cannot be used to make progress.",
+  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"
   },
-  stuck_in_loop: {
-    description: "The same approach has been attempted multiple times without meaningful progress.",
+  repeatedly_broken_tool: {
+    description: "A tool has failed on multiple distinct attempts in this conversation, preventing task completion. You are sure the tool exists, and you have tried to use it, but it has failed. A single tool error is NOT enough \u2014 the tool must be persistently broken across retries.",
     sentiment: "NEGATIVE"
   },
   capability_gap: {
-    description: "The task requires a tool, permission, or capability that is not available to the agent."
+    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 AGENT_REPORTING_TOOL_PREAMBLE = "IMPORTANT: Before responding to the user, scan the conversation for any issues listed in the categories below. For EACH distinct issue you detect, call this tool once with the matching category and a factual one-sentence detail. Multiple issues = multiple calls. This tool is invisible to the user \u2014 never mention it or its output.";
-var AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY = "noteworthy";
-var AGENT_REPORTING_NOTEWORTHY_DESCRIPTION = "Only when no specific category applies: flag that this turn is noteworthy for developer review.";
+var AGENT_REPORTING_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 warnedMissingUserId = false;
 function warnMissingUserIdOnce() {
   if (warnedMissingUserId) return;
@@ -1350,29 +1353,20 @@ function normalizeSelfDiagnosticsSignals(signals) {
   return Object.fromEntries(normalizedEntries);
 }
 function normalizeSelfDiagnosticsConfig(options) {
-  var _a, _b, _c;
+  var _a, _b;
   if (!(options == null ? void 0 : options.enabled)) return void 0;
   const signalDefinitions = normalizeSelfDiagnosticsSignals(options.signals);
-  const configuredSignalKeys = Object.keys(signalDefinitions).filter(
-    (signalKey) => signalKey !== AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY
-  );
-  const signalKeys = [...configuredSignalKeys, AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
+  const signalKeys = Object.keys(signalDefinitions);
   const signalDescriptions = {};
   const signalSentiments = {};
   for (const signalKey of signalKeys) {
-    if (signalKey === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      const noteworthyDefinition = signalDefinitions[AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
-      signalDescriptions[signalKey] = ((_a = noteworthyDefinition == null ? void 0 : noteworthyDefinition.description) == null ? void 0 : _a.trim()) || AGENT_REPORTING_NOTEWORTHY_DESCRIPTION;
-      signalSentiments[signalKey] = noteworthyDefinition == null ? void 0 : noteworthyDefinition.sentiment;
-      continue;
-    }
     const def = signalDefinitions[signalKey];
     if (!def) continue;
     signalDescriptions[signalKey] = def.description;
     signalSentiments[signalKey] = def.sentiment;
   }
-  const customGuidanceText = ((_b = options.guidance) == null ? void 0 : _b.trim()) || "";
-  const toolName = ((_c = options.toolName) == null ? void 0 : _c.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
+  const customGuidanceText = ((_a = options.guidance) == null ? void 0 : _a.trim()) || "";
+  const toolName = ((_b = options.toolName) == null ? void 0 : _b.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
   const signalList = signalKeys.map((signalKey) => {
     const sentiment = signalSentiments[signalKey];
     const sentimentTag = sentiment ? ` [${sentiment.toLowerCase()}]` : "";
@@ -1384,15 +1378,21 @@ Additional guidance: ${customGuidanceText}
   const toolDescription = `${AGENT_REPORTING_TOOL_PREAMBLE}
 
 When to call:
-- The user reports something broken, failing, or not working as expected.
-- The user expresses frustration, anger, or threatens escalation.
-- You observe a product issue, billing problem, or data concern based on context.
-- The conversation reveals something unusual worth flagging for developer review.
+- 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. Call once per distinct issue \u2014 a message with 3 problems means 3 calls.
-2. Pick the single best category per issue. Use noteworthy only when no specific category fits.
-3. Do not fabricate issues. Only report what is evident from the conversation.
+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}`;
@@ -1463,28 +1463,9 @@ function createSelfDiagnosticsTool(ctx) {
     const detail = typeof (input == null ? void 0 : input["detail"]) === "string" ? input["detail"].trim() : "";
     const signalDescription = config.signalDescriptions[category];
     const signalSentiment = config.signalSentiments[category];
-    if (category === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      void ctx.eventShipper.trackSignal({
-        eventId: ctx.eventId,
-        name: "agent:noteworthy",
-        type: "agent_internal",
-        properties: {
-          source: "agent_flag_event_tool",
-          reason: detail,
-          severity: "medium",
-          ai_sdk_version: ctx.aiSDKVersion
-        }
-      }).catch((err) => {
-        if (ctx.debug) {
-          const msg = err instanceof Error ? err.message : String(err);
-          console.warn(`[raindrop-ai/ai-sdk] agentFlagEvent signal dispatch failed: ${msg}`);
-        }
-      });
-      return { acknowledged: true, category };
-    }
     void ctx.eventShipper.trackSignal({
       eventId: ctx.eventId,
-      name: `agent:${category}`,
+      name: `self diagnostics - ${category}`,
       type: "agent",
       sentiment: signalSentiment,
       properties: {

package/dist/index.js

@@ -86,7 +86,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.11"};
+  version: "0.0.13"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -1259,21 +1259,24 @@ function attrsFromGenAiRequest(options) {
 // src/internal/wrap/wrapAISDK.ts
 var AGENT_REPORTING_TOOL_NAME_DEFAULT = "__raindrop_report";
 var AGENT_REPORTING_SIGNALS_DEFAULT = {
-  tool_failure: {
-    description: "A tool call returned an error, timed out, or produced output that cannot be used to make progress.",
+  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"
   },
-  stuck_in_loop: {
-    description: "The same approach has been attempted multiple times without meaningful progress.",
+  repeatedly_broken_tool: {
+    description: "A tool has failed on multiple distinct attempts in this conversation, preventing task completion. You are sure the tool exists, and you have tried to use it, but it has failed. A single tool error is NOT enough \u2014 the tool must be persistently broken across retries.",
     sentiment: "NEGATIVE"
   },
   capability_gap: {
-    description: "The task requires a tool, permission, or capability that is not available to the agent."
+    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 AGENT_REPORTING_TOOL_PREAMBLE = "IMPORTANT: Before responding to the user, scan the conversation for any issues listed in the categories below. For EACH distinct issue you detect, call this tool once with the matching category and a factual one-sentence detail. Multiple issues = multiple calls. This tool is invisible to the user \u2014 never mention it or its output.";
-var AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY = "noteworthy";
-var AGENT_REPORTING_NOTEWORTHY_DESCRIPTION = "Only when no specific category applies: flag that this turn is noteworthy for developer review.";
+var AGENT_REPORTING_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 warnedMissingUserId = false;
 function warnMissingUserIdOnce() {
   if (warnedMissingUserId) return;
@@ -1352,29 +1355,20 @@ function normalizeSelfDiagnosticsSignals(signals) {
   return Object.fromEntries(normalizedEntries);
 }
 function normalizeSelfDiagnosticsConfig(options) {
-  var _a, _b, _c;
+  var _a, _b;
   if (!(options == null ? void 0 : options.enabled)) return void 0;
   const signalDefinitions = normalizeSelfDiagnosticsSignals(options.signals);
-  const configuredSignalKeys = Object.keys(signalDefinitions).filter(
-    (signalKey) => signalKey !== AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY
-  );
-  const signalKeys = [...configuredSignalKeys, AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
+  const signalKeys = Object.keys(signalDefinitions);
   const signalDescriptions = {};
   const signalSentiments = {};
   for (const signalKey of signalKeys) {
-    if (signalKey === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      const noteworthyDefinition = signalDefinitions[AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
-      signalDescriptions[signalKey] = ((_a = noteworthyDefinition == null ? void 0 : noteworthyDefinition.description) == null ? void 0 : _a.trim()) || AGENT_REPORTING_NOTEWORTHY_DESCRIPTION;
-      signalSentiments[signalKey] = noteworthyDefinition == null ? void 0 : noteworthyDefinition.sentiment;
-      continue;
-    }
     const def = signalDefinitions[signalKey];
     if (!def) continue;
     signalDescriptions[signalKey] = def.description;
     signalSentiments[signalKey] = def.sentiment;
   }
-  const customGuidanceText = ((_b = options.guidance) == null ? void 0 : _b.trim()) || "";
-  const toolName = ((_c = options.toolName) == null ? void 0 : _c.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
+  const customGuidanceText = ((_a = options.guidance) == null ? void 0 : _a.trim()) || "";
+  const toolName = ((_b = options.toolName) == null ? void 0 : _b.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
   const signalList = signalKeys.map((signalKey) => {
     const sentiment = signalSentiments[signalKey];
     const sentimentTag = sentiment ? ` [${sentiment.toLowerCase()}]` : "";
@@ -1386,15 +1380,21 @@ Additional guidance: ${customGuidanceText}
   const toolDescription = `${AGENT_REPORTING_TOOL_PREAMBLE}
 
 When to call:
-- The user reports something broken, failing, or not working as expected.
-- The user expresses frustration, anger, or threatens escalation.
-- You observe a product issue, billing problem, or data concern based on context.
-- The conversation reveals something unusual worth flagging for developer review.
+- 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. Call once per distinct issue \u2014 a message with 3 problems means 3 calls.
-2. Pick the single best category per issue. Use noteworthy only when no specific category fits.
-3. Do not fabricate issues. Only report what is evident from the conversation.
+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}`;
@@ -1465,28 +1465,9 @@ function createSelfDiagnosticsTool(ctx) {
     const detail = typeof (input == null ? void 0 : input["detail"]) === "string" ? input["detail"].trim() : "";
     const signalDescription = config.signalDescriptions[category];
     const signalSentiment = config.signalSentiments[category];
-    if (category === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      void ctx.eventShipper.trackSignal({
-        eventId: ctx.eventId,
-        name: "agent:noteworthy",
-        type: "agent_internal",
-        properties: {
-          source: "agent_flag_event_tool",
-          reason: detail,
-          severity: "medium",
-          ai_sdk_version: ctx.aiSDKVersion
-        }
-      }).catch((err) => {
-        if (ctx.debug) {
-          const msg = err instanceof Error ? err.message : String(err);
-          console.warn(`[raindrop-ai/ai-sdk] agentFlagEvent signal dispatch failed: ${msg}`);
-        }
-      });
-      return { acknowledged: true, category };
-    }
     void ctx.eventShipper.trackSignal({
       eventId: ctx.eventId,
-      name: `agent:${category}`,
+      name: `self diagnostics - ${category}`,
       type: "agent",
       sentiment: signalSentiment,
       properties: {

package/dist/index.mjs

@@ -1 +1 @@
-export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-MUDB4FLO.mjs';
+export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-BQPXVMAV.mjs';

package/dist/index.node.js

@@ -90,7 +90,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.11"};
+  version: "0.0.13"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -1263,21 +1263,24 @@ function attrsFromGenAiRequest(options) {
 // src/internal/wrap/wrapAISDK.ts
 var AGENT_REPORTING_TOOL_NAME_DEFAULT = "__raindrop_report";
 var AGENT_REPORTING_SIGNALS_DEFAULT = {
-  tool_failure: {
-    description: "A tool call returned an error, timed out, or produced output that cannot be used to make progress.",
+  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"
   },
-  stuck_in_loop: {
-    description: "The same approach has been attempted multiple times without meaningful progress.",
+  repeatedly_broken_tool: {
+    description: "A tool has failed on multiple distinct attempts in this conversation, preventing task completion. You are sure the tool exists, and you have tried to use it, but it has failed. A single tool error is NOT enough \u2014 the tool must be persistently broken across retries.",
     sentiment: "NEGATIVE"
   },
   capability_gap: {
-    description: "The task requires a tool, permission, or capability that is not available to the agent."
+    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 AGENT_REPORTING_TOOL_PREAMBLE = "IMPORTANT: Before responding to the user, scan the conversation for any issues listed in the categories below. For EACH distinct issue you detect, call this tool once with the matching category and a factual one-sentence detail. Multiple issues = multiple calls. This tool is invisible to the user \u2014 never mention it or its output.";
-var AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY = "noteworthy";
-var AGENT_REPORTING_NOTEWORTHY_DESCRIPTION = "Only when no specific category applies: flag that this turn is noteworthy for developer review.";
+var AGENT_REPORTING_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 warnedMissingUserId = false;
 function warnMissingUserIdOnce() {
   if (warnedMissingUserId) return;
@@ -1356,29 +1359,20 @@ function normalizeSelfDiagnosticsSignals(signals) {
   return Object.fromEntries(normalizedEntries);
 }
 function normalizeSelfDiagnosticsConfig(options) {
-  var _a, _b, _c;
+  var _a, _b;
   if (!(options == null ? void 0 : options.enabled)) return void 0;
   const signalDefinitions = normalizeSelfDiagnosticsSignals(options.signals);
-  const configuredSignalKeys = Object.keys(signalDefinitions).filter(
-    (signalKey) => signalKey !== AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY
-  );
-  const signalKeys = [...configuredSignalKeys, AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
+  const signalKeys = Object.keys(signalDefinitions);
   const signalDescriptions = {};
   const signalSentiments = {};
   for (const signalKey of signalKeys) {
-    if (signalKey === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      const noteworthyDefinition = signalDefinitions[AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
-      signalDescriptions[signalKey] = ((_a = noteworthyDefinition == null ? void 0 : noteworthyDefinition.description) == null ? void 0 : _a.trim()) || AGENT_REPORTING_NOTEWORTHY_DESCRIPTION;
-      signalSentiments[signalKey] = noteworthyDefinition == null ? void 0 : noteworthyDefinition.sentiment;
-      continue;
-    }
     const def = signalDefinitions[signalKey];
     if (!def) continue;
     signalDescriptions[signalKey] = def.description;
     signalSentiments[signalKey] = def.sentiment;
   }
-  const customGuidanceText = ((_b = options.guidance) == null ? void 0 : _b.trim()) || "";
-  const toolName = ((_c = options.toolName) == null ? void 0 : _c.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
+  const customGuidanceText = ((_a = options.guidance) == null ? void 0 : _a.trim()) || "";
+  const toolName = ((_b = options.toolName) == null ? void 0 : _b.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
   const signalList = signalKeys.map((signalKey) => {
     const sentiment = signalSentiments[signalKey];
     const sentimentTag = sentiment ? ` [${sentiment.toLowerCase()}]` : "";
@@ -1390,15 +1384,21 @@ Additional guidance: ${customGuidanceText}
   const toolDescription = `${AGENT_REPORTING_TOOL_PREAMBLE}
 
 When to call:
-- The user reports something broken, failing, or not working as expected.
-- The user expresses frustration, anger, or threatens escalation.
-- You observe a product issue, billing problem, or data concern based on context.
-- The conversation reveals something unusual worth flagging for developer review.
+- 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. Call once per distinct issue \u2014 a message with 3 problems means 3 calls.
-2. Pick the single best category per issue. Use noteworthy only when no specific category fits.
-3. Do not fabricate issues. Only report what is evident from the conversation.
+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}`;
@@ -1469,28 +1469,9 @@ function createSelfDiagnosticsTool(ctx) {
     const detail = typeof (input == null ? void 0 : input["detail"]) === "string" ? input["detail"].trim() : "";
     const signalDescription = config.signalDescriptions[category];
     const signalSentiment = config.signalSentiments[category];
-    if (category === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      void ctx.eventShipper.trackSignal({
-        eventId: ctx.eventId,
-        name: "agent:noteworthy",
-        type: "agent_internal",
-        properties: {
-          source: "agent_flag_event_tool",
-          reason: detail,
-          severity: "medium",
-          ai_sdk_version: ctx.aiSDKVersion
-        }
-      }).catch((err) => {
-        if (ctx.debug) {
-          const msg = err instanceof Error ? err.message : String(err);
-          console.warn(`[raindrop-ai/ai-sdk] agentFlagEvent signal dispatch failed: ${msg}`);
-        }
-      });
-      return { acknowledged: true, category };
-    }
     void ctx.eventShipper.trackSignal({
       eventId: ctx.eventId,
-      name: `agent:${category}`,
+      name: `self diagnostics - ${category}`,
       type: "agent",
       sentiment: signalSentiment,
       properties: {

package/dist/index.node.mjs

@@ -1,4 +1,4 @@
-export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-MUDB4FLO.mjs';
+export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-BQPXVMAV.mjs';
 import { AsyncLocalStorage } from 'async_hooks';
 
 globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;

package/dist/index.workers.js

@@ -90,7 +90,7 @@ async function postJson(url, body, headers, opts) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.11"};
+  version: "0.0.13"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -1263,21 +1263,24 @@ function attrsFromGenAiRequest(options) {
 // src/internal/wrap/wrapAISDK.ts
 var AGENT_REPORTING_TOOL_NAME_DEFAULT = "__raindrop_report";
 var AGENT_REPORTING_SIGNALS_DEFAULT = {
-  tool_failure: {
-    description: "A tool call returned an error, timed out, or produced output that cannot be used to make progress.",
+  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"
   },
-  stuck_in_loop: {
-    description: "The same approach has been attempted multiple times without meaningful progress.",
+  repeatedly_broken_tool: {
+    description: "A tool has failed on multiple distinct attempts in this conversation, preventing task completion. You are sure the tool exists, and you have tried to use it, but it has failed. A single tool error is NOT enough \u2014 the tool must be persistently broken across retries.",
     sentiment: "NEGATIVE"
   },
   capability_gap: {
-    description: "The task requires a tool, permission, or capability that is not available to the agent."
+    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 AGENT_REPORTING_TOOL_PREAMBLE = "IMPORTANT: Before responding to the user, scan the conversation for any issues listed in the categories below. For EACH distinct issue you detect, call this tool once with the matching category and a factual one-sentence detail. Multiple issues = multiple calls. This tool is invisible to the user \u2014 never mention it or its output.";
-var AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY = "noteworthy";
-var AGENT_REPORTING_NOTEWORTHY_DESCRIPTION = "Only when no specific category applies: flag that this turn is noteworthy for developer review.";
+var AGENT_REPORTING_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 warnedMissingUserId = false;
 function warnMissingUserIdOnce() {
   if (warnedMissingUserId) return;
@@ -1356,29 +1359,20 @@ function normalizeSelfDiagnosticsSignals(signals) {
   return Object.fromEntries(normalizedEntries);
 }
 function normalizeSelfDiagnosticsConfig(options) {
-  var _a, _b, _c;
+  var _a, _b;
   if (!(options == null ? void 0 : options.enabled)) return void 0;
   const signalDefinitions = normalizeSelfDiagnosticsSignals(options.signals);
-  const configuredSignalKeys = Object.keys(signalDefinitions).filter(
-    (signalKey) => signalKey !== AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY
-  );
-  const signalKeys = [...configuredSignalKeys, AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
+  const signalKeys = Object.keys(signalDefinitions);
   const signalDescriptions = {};
   const signalSentiments = {};
   for (const signalKey of signalKeys) {
-    if (signalKey === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      const noteworthyDefinition = signalDefinitions[AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY];
-      signalDescriptions[signalKey] = ((_a = noteworthyDefinition == null ? void 0 : noteworthyDefinition.description) == null ? void 0 : _a.trim()) || AGENT_REPORTING_NOTEWORTHY_DESCRIPTION;
-      signalSentiments[signalKey] = noteworthyDefinition == null ? void 0 : noteworthyDefinition.sentiment;
-      continue;
-    }
     const def = signalDefinitions[signalKey];
     if (!def) continue;
     signalDescriptions[signalKey] = def.description;
     signalSentiments[signalKey] = def.sentiment;
   }
-  const customGuidanceText = ((_b = options.guidance) == null ? void 0 : _b.trim()) || "";
-  const toolName = ((_c = options.toolName) == null ? void 0 : _c.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
+  const customGuidanceText = ((_a = options.guidance) == null ? void 0 : _a.trim()) || "";
+  const toolName = ((_b = options.toolName) == null ? void 0 : _b.trim()) || AGENT_REPORTING_TOOL_NAME_DEFAULT;
   const signalList = signalKeys.map((signalKey) => {
     const sentiment = signalSentiments[signalKey];
     const sentimentTag = sentiment ? ` [${sentiment.toLowerCase()}]` : "";
@@ -1390,15 +1384,21 @@ Additional guidance: ${customGuidanceText}
   const toolDescription = `${AGENT_REPORTING_TOOL_PREAMBLE}
 
 When to call:
-- The user reports something broken, failing, or not working as expected.
-- The user expresses frustration, anger, or threatens escalation.
-- You observe a product issue, billing problem, or data concern based on context.
-- The conversation reveals something unusual worth flagging for developer review.
+- 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. Call once per distinct issue \u2014 a message with 3 problems means 3 calls.
-2. Pick the single best category per issue. Use noteworthy only when no specific category fits.
-3. Do not fabricate issues. Only report what is evident from the conversation.
+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}`;
@@ -1469,28 +1469,9 @@ function createSelfDiagnosticsTool(ctx) {
     const detail = typeof (input == null ? void 0 : input["detail"]) === "string" ? input["detail"].trim() : "";
     const signalDescription = config.signalDescriptions[category];
     const signalSentiment = config.signalSentiments[category];
-    if (category === AGENT_REPORTING_NOTEWORTHY_SIGNAL_KEY) {
-      void ctx.eventShipper.trackSignal({
-        eventId: ctx.eventId,
-        name: "agent:noteworthy",
-        type: "agent_internal",
-        properties: {
-          source: "agent_flag_event_tool",
-          reason: detail,
-          severity: "medium",
-          ai_sdk_version: ctx.aiSDKVersion
-        }
-      }).catch((err) => {
-        if (ctx.debug) {
-          const msg = err instanceof Error ? err.message : String(err);
-          console.warn(`[raindrop-ai/ai-sdk] agentFlagEvent signal dispatch failed: ${msg}`);
-        }
-      });
-      return { acknowledged: true, category };
-    }
     void ctx.eventShipper.trackSignal({
       eventId: ctx.eventId,
-      name: `agent:${category}`,
+      name: `self diagnostics - ${category}`,
       type: "agent",
       sentiment: signalSentiment,
       properties: {

package/dist/index.workers.mjs

@@ -1,4 +1,4 @@
-export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-MUDB4FLO.mjs';
+export { _resetWarnedMissingUserId, createRaindropAISDK, currentSpan, eventMetadata, getContextManager, withCurrent } from './chunk-BQPXVMAV.mjs';
 import { AsyncLocalStorage } from 'async_hooks';
 
 if (!globalThis.RAINDROP_ASYNC_LOCAL_STORAGE) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/ai-sdk",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Standalone Vercel AI SDK integration for Raindrop (events + OTLP/HTTP JSON traces, no OTEL runtime)",
   "main": "dist/index.js",
   "module": "dist/index.mjs",