@raindrop-ai/claude-code 0.0.5 → 0.0.6

package/README.md

@@ -24,11 +24,27 @@ This saves your write key and configures Claude Code hooks. Every session will n
 - Model name, service tier, and stop reason
 - CLAUDE.md and rules file contents
 - `--append-system-prompt` / `--append-system-prompt-file` content (best-effort)
+- Self-diagnostics — agent-reported issues via MCP tool, with customizable signal categories
 - Subagent spawns and completions
 - Permission denials and context compaction
 - Nested trace view (tools under root, subagent tools under subagent)
 - Claude's responses and errors
 
+## Custom Self-Diagnostics Signals
+
+Replace built-in signal categories with your own via config or env var:
+
+```json
+{
+  "self_diagnostics": {
+    "signals": {
+      "billing_complaint": { "description": "User billing issue.", "sentiment": "NEGATIVE" }
+    },
+    "guidance": "Only report billing if explicitly mentioned."
+  }
+}
+```
+
 ## Docs
 
 Full documentation: [docs.raindrop.ai/sdk/claude-code](https://docs.raindrop.ai/sdk/claude-code)

package/dist/cli.js

@@ -654,7 +654,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 
 // src/package-info.ts
 var PACKAGE_NAME = "@raindrop-ai/claude-code";
-var PACKAGE_VERSION = "0.0.5";
+var PACKAGE_VERSION = "0.0.6";
 
 // src/shipper.ts
 var EventShipper2 = class extends EventShipper {
@@ -1427,6 +1427,17 @@ function loadConfig() {
     } catch (e) {
     }
   }
+  let selfDiagnostics = file.self_diagnostics;
+  const envDiag = process.env["RAINDROP_SELF_DIAGNOSTICS"];
+  if (envDiag) {
+    try {
+      const parsed = JSON.parse(envDiag);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        selfDiagnostics = parsed;
+      }
+    } catch (e) {
+    }
+  }
   return {
     writeKey: (_c = (_b = process.env["RAINDROP_WRITE_KEY"]) != null ? _b : file.write_key) != null ? _c : "",
     endpoint: (_e = (_d = process.env["RAINDROP_API_URL"]) != null ? _d : file.api_url) != null ? _e : "https://api.raindrop.ai/v1",
@@ -1434,7 +1445,8 @@ function loadConfig() {
     debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_h = file.debug) != null ? _h : false,
     enabled: (_i = file.enabled) != null ? _i : true,
     eventName: (_k = (_j = process.env["RAINDROP_EVENT_NAME"]) != null ? _j : file.event_name) != null ? _k : "claude_code_session",
-    customProperties
+    customProperties,
+    selfDiagnostics
   };
 }
 function getConfigPath() {
@@ -1842,6 +1854,17 @@ async function runSetup(args2) {
   settings["hooks"] = existingHooks;
   writeFileSync4(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
   console.log(`  Updated Claude Code hooks in ${settingsPath} (${scopeLabel})`);
+  try {
+    const mcpList = execSync2("claude mcp list", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+    if (!mcpList.includes("raindrop-diagnostics")) {
+      execSync2(
+        `claude mcp add --transport stdio --scope ${scope === "project" ? "project" : "user"} raindrop-diagnostics -- raindrop-claude-code mcp-serve`,
+        { stdio: "ignore" }
+      );
+      console.log(`  Registered self-diagnostics MCP server`);
+    }
+  } catch (e) {
+  }
   const whichCmd = process.platform === "win32" ? "where" : "which";
   try {
     execSync2(`${whichCmd} raindrop-claude-code`, { stdio: "ignore" });
@@ -1871,6 +1894,289 @@ async function runSetup(args2) {
   }
 }
 
+// src/mcp-serve.ts
+import { createInterface as createInterface2 } from "readline";
+import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync7, statSync } from "fs";
+import { join as join6 } from "path";
+import { tmpdir as tmpdir4 } from "os";
+var DEFAULT_SIGNALS = {
+  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 is NOT a refusal or policy block \u2014 you tried and failed to deliver the result.",
+    sentiment: "NEGATIVE"
+  }
+};
+var NOTEWORTHY_KEY = "noteworthy";
+var NOTEWORTHY_DEFAULT_DESCRIPTION = "Only when no specific category applies: flag that this turn is noteworthy for developer review.";
+function normalizeSignals(custom) {
+  let base;
+  if (!custom || Object.keys(custom).length === 0) {
+    base = { ...DEFAULT_SIGNALS };
+  } else {
+    const validated = {};
+    for (const [key, def] of Object.entries(custom)) {
+      const k = key.trim();
+      if (!k || k === NOTEWORTHY_KEY) continue;
+      if (!def || typeof def !== "object") continue;
+      const desc = typeof def.description === "string" ? def.description.trim() : "";
+      if (!desc) continue;
+      const sentiment = def.sentiment;
+      validated[k] = {
+        description: desc,
+        ...sentiment === "POSITIVE" || sentiment === "NEGATIVE" ? { sentiment } : {}
+      };
+    }
+    base = Object.keys(validated).length > 0 ? validated : { ...DEFAULT_SIGNALS };
+  }
+  const customNoteworthy = custom == null ? void 0 : custom[NOTEWORTHY_KEY];
+  base[NOTEWORTHY_KEY] = {
+    description: typeof (customNoteworthy == null ? void 0 : customNoteworthy.description) === "string" && customNoteworthy.description.trim() ? customNoteworthy.description.trim() : NOTEWORTHY_DEFAULT_DESCRIPTION,
+    ...(customNoteworthy == null ? void 0 : customNoteworthy.sentiment) === "POSITIVE" || (customNoteworthy == null ? void 0 : customNoteworthy.sentiment) === "NEGATIVE" ? { sentiment: customNoteworthy.sentiment } : {}
+  };
+  return base;
+}
+function resolveToolConfig(diagConfig) {
+  var _a;
+  const signals = normalizeSignals(diagConfig == null ? void 0 : diagConfig.signals);
+  const categoryKeys = Object.keys(signals);
+  const toolName = ((_a = diagConfig == null ? void 0 : diagConfig.toolName) == null ? void 0 : _a.trim()) || "__raindrop_report";
+  const toolDescription = buildToolDescription(signals, categoryKeys, diagConfig == null ? void 0 : diagConfig.guidance);
+  return { signals, categoryKeys, toolName, toolDescription };
+}
+function buildToolDescription(signals, keys, guidance) {
+  const 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.";
+  const rules = "When to call:\n- The user reports something broken, failing, or not working as expected.\n- The user expresses frustration, anger, or threatens escalation.\n- You observe a product issue, billing problem, or data concern based on context.\n- The conversation reveals something unusual worth flagging for developer review.\n\nRules:\n1. Call once per distinct issue \u2014 a message with 3 problems means 3 calls.\n2. Pick the single best category per issue. Use noteworthy only when no specific category fits.\n3. Do not fabricate issues. Only report what is evident from the conversation.";
+  const categoryList = keys.map((key) => {
+    const def = signals[key];
+    const tag = def.sentiment ? ` [${def.sentiment.toLowerCase()}]` : "";
+    return `- ${key}: ${def.description}${tag}`;
+  }).join("\n");
+  const guidanceBlock = (guidance == null ? void 0 : guidance.trim()) ? `
+Additional guidance: ${guidance.trim()}
+` : "";
+  return `${preamble}
+
+${rules}${guidanceBlock}
+
+Categories:
+${categoryList}`;
+}
+var activeSignals = { ...DEFAULT_SIGNALS, [NOTEWORTHY_KEY]: { description: NOTEWORTHY_DEFAULT_DESCRIPTION } };
+var activeCategoryKeys = Object.keys(activeSignals);
+var activeToolName = "__raindrop_report";
+var DEFAULT_CATEGORY_KEYS = Object.keys(DEFAULT_SIGNALS).concat(NOTEWORTHY_KEY);
+var STATE_DIR3 = join6(tmpdir4(), "raindrop-claude-code");
+function resolveCurrentEventId() {
+  try {
+    if (!existsSync7(STATE_DIR3)) return void 0;
+    const files = readdirSync2(STATE_DIR3).filter((f) => f.startsWith("event_"));
+    if (files.length === 0) return void 0;
+    let newest;
+    for (const file of files) {
+      try {
+        const full = join6(STATE_DIR3, file);
+        const st = statSync(full);
+        if (!newest || st.mtimeMs > newest.mtime) {
+          newest = { path: full, mtime: st.mtimeMs };
+        }
+      } catch (e) {
+        continue;
+      }
+    }
+    if (!newest) return void 0;
+    return readFileSync7(newest.path, "utf-8").trim() || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+async function executeTool(args2) {
+  const category = typeof args2["category"] === "string" ? args2["category"] : "";
+  const detail = typeof args2["detail"] === "string" ? args2["detail"] : "";
+  if (!category || !activeSignals[category]) {
+    return {
+      content: [{ type: "text", text: `Invalid category: ${category}. Valid: ${activeCategoryKeys.join(", ")}` }],
+      isError: true
+    };
+  }
+  if (!detail.trim()) {
+    return {
+      content: [{ type: "text", text: "Detail is required." }],
+      isError: true
+    };
+  }
+  const config = loadConfig();
+  if (!config.enabled) {
+    return { content: [{ type: "text", text: "Signal noted (hooks disabled)." }] };
+  }
+  if (!config.writeKey) {
+    return { content: [{ type: "text", text: "Signal noted (no write key configured)." }] };
+  }
+  const eventId = resolveCurrentEventId();
+  if (!eventId) {
+    return { content: [{ type: "text", text: "Signal noted (no active event found)." }] };
+  }
+  const shipper = new EventShipper2({
+    writeKey: config.writeKey,
+    endpoint: config.endpoint,
+    debug: false,
+    enabled: true
+  });
+  try {
+    const signalDef = activeSignals[category];
+    const isNoteworthy = category === NOTEWORTHY_KEY;
+    await shipper.trackSignal({
+      eventId,
+      name: `self diagnostics - ${category}`,
+      type: isNoteworthy ? "agent_internal" : "agent",
+      ...signalDef.sentiment ? { sentiment: signalDef.sentiment } : {},
+      properties: isNoteworthy ? {
+        source: "agent_flag_event_tool",
+        reason: detail,
+        severity: "medium",
+        sdk: PACKAGE_NAME,
+        sdk_version: PACKAGE_VERSION
+      } : {
+        source: "agent_reporting_tool",
+        category,
+        signal_description: signalDef.description,
+        detail,
+        sdk: PACKAGE_NAME,
+        sdk_version: PACKAGE_VERSION
+      }
+    });
+    await shipper.shutdown();
+  } catch (e) {
+  }
+  return { content: [{ type: "text", text: "Signal recorded." }] };
+}
+function sendResponse(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: id != null ? id : null, result }) + "\n");
+}
+function sendError(id, code, message) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: id != null ? id : null, error: { code, message } }) + "\n");
+}
+function buildToolSchema(toolName, toolDescription, categoryKeys) {
+  return {
+    name: toolName,
+    description: toolDescription,
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          enum: categoryKeys,
+          description: "The category of issue detected"
+        },
+        detail: {
+          type: "string",
+          description: "A factual one-sentence description of the issue"
+        }
+      },
+      required: ["category", "detail"]
+    }
+  };
+}
+var TOOL_SCHEMA = buildToolSchema(
+  activeToolName,
+  buildToolDescription(activeSignals, activeCategoryKeys),
+  activeCategoryKeys
+);
+async function startMcpServer() {
+  globalThis.console = new console.Console(process.stderr, process.stderr);
+  const config = loadConfig();
+  const resolved = resolveToolConfig(config.selfDiagnostics);
+  activeSignals = resolved.signals;
+  activeCategoryKeys = resolved.categoryKeys;
+  activeToolName = resolved.toolName;
+  const toolSchema = buildToolSchema(resolved.toolName, resolved.toolDescription, resolved.categoryKeys);
+  const rl = createInterface2({ input: process.stdin });
+  const inflight = /* @__PURE__ */ new Set();
+  rl.on("line", (line) => {
+    const promise = handleLine(line, toolSchema);
+    inflight.add(promise);
+    promise.finally(() => inflight.delete(promise));
+  });
+  rl.on("close", async () => {
+    await Promise.allSettled(inflight);
+    process.exit(0);
+  });
+}
+async function handleLine(line, toolSchema) {
+  var _a, _b;
+  let req;
+  try {
+    const parsed = JSON.parse(line);
+    if (!parsed || typeof parsed !== "object") {
+      return;
+    }
+    if (typeof parsed.method !== "string") {
+      if (parsed.id !== void 0) {
+        sendError(parsed.id, -32600, "Invalid Request: missing or non-string method");
+      }
+      return;
+    }
+    req = parsed;
+  } catch (e) {
+    return;
+  }
+  try {
+    switch (req.method) {
+      case "initialize":
+        sendResponse(req.id, {
+          protocolVersion: "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: PACKAGE_NAME, version: PACKAGE_VERSION }
+        });
+        break;
+      case "notifications/initialized":
+        break;
+      case "tools/list":
+        sendResponse(req.id, { tools: [toolSchema] });
+        break;
+      case "tools/call": {
+        const params = (_a = req.params) != null ? _a : {};
+        const toolName = params["name"];
+        if (toolName !== activeToolName) {
+          sendResponse(req.id, {
+            content: [{ type: "text", text: `Unknown tool: ${toolName}` }],
+            isError: true
+          });
+          break;
+        }
+        const toolArgs = (_b = params["arguments"]) != null ? _b : {};
+        const result = await executeTool(toolArgs);
+        sendResponse(req.id, result);
+        break;
+      }
+      case "ping":
+        sendResponse(req.id, {});
+        break;
+      default:
+        if (req.id !== void 0) {
+          sendError(req.id, -32601, `Method not found: ${req.method}`);
+        }
+    }
+  } catch (err) {
+    try {
+      if (req.id !== void 0) {
+        sendError(req.id, -32603, err instanceof Error ? err.message : String(err));
+      }
+    } catch (e) {
+    }
+  }
+}
+
 // src/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
@@ -1896,6 +2202,10 @@ async function main() {
       await handleHook();
       break;
     }
+    case "mcp-serve": {
+      await startMcpServer();
+      break;
+    }
     case "status": {
       const config = loadConfig();
       const result = await detectLocalDebugger(config.debug);
@@ -1945,6 +2255,7 @@ async function main() {
       --local-only      Install hooks without a write key (local debugger only)
 
     hook                Handle a Claude Code hook event (reads JSON from stdin)
+    mcp-serve           Start the self-diagnostics MCP server (stdio)
     status              Check local debugger connectivity
     enable              Enable Raindrop hooks
     disable             Disable Raindrop hooks
@@ -1972,5 +2283,5 @@ async function main() {
 }
 main().catch((err) => {
   console.error(`[raindrop-ai/claude-code] fatal: ${err instanceof Error ? err.message : String(err)}`);
-  process.exit(command === "hook" ? 0 : 1);
+  process.exit(command === "hook" || command === "mcp-serve" ? 0 : 1);
 });

package/dist/index.cjs

@@ -20,17 +20,24 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  DEFAULT_CATEGORY_KEYS: () => DEFAULT_CATEGORY_KEYS,
   EventShipper: () => EventShipper2,
   PACKAGE_NAME: () => PACKAGE_NAME,
   PACKAGE_VERSION: () => PACKAGE_VERSION,
+  TOOL_SCHEMA: () => TOOL_SCHEMA,
   TraceShipper: () => TraceShipper2,
   detectLocalDebugger: () => detectLocalDebugger,
+  executeTool: () => executeTool,
   extractAppendSystemPrompt: () => extractAppendSystemPrompt,
   getConfigPath: () => getConfigPath,
   loadConfig: () => loadConfig,
   mapHookToRaindrop: () => mapHookToRaindrop,
   mirrorEventToLocalDebugger: () => mirrorEventToLocalDebugger,
+  normalizeSignals: () => normalizeSignals,
   parseTranscript: () => parseTranscript,
+  resolveCurrentEventId: () => resolveCurrentEventId,
+  resolveToolConfig: () => resolveToolConfig,
+  startMcpServer: () => startMcpServer,
   transcriptToProperties: () => transcriptToProperties,
   updateConfig: () => updateConfig
 });
@@ -683,7 +690,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = import_async_hooks.AsyncLocalStorage;
 
 // src/package-info.ts
 var PACKAGE_NAME = "@raindrop-ai/claude-code";
-var PACKAGE_VERSION = "0.0.5";
+var PACKAGE_VERSION = "0.0.6";
 
 // src/shipper.ts
 var EventShipper2 = class extends EventShipper {
@@ -752,6 +759,17 @@ function loadConfig() {
     } catch (e) {
     }
   }
+  let selfDiagnostics = file.self_diagnostics;
+  const envDiag = process.env["RAINDROP_SELF_DIAGNOSTICS"];
+  if (envDiag) {
+    try {
+      const parsed = JSON.parse(envDiag);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        selfDiagnostics = parsed;
+      }
+    } catch (e) {
+    }
+  }
   return {
     writeKey: (_c = (_b = process.env["RAINDROP_WRITE_KEY"]) != null ? _b : file.write_key) != null ? _c : "",
     endpoint: (_e = (_d = process.env["RAINDROP_API_URL"]) != null ? _d : file.api_url) != null ? _e : "https://api.raindrop.ai/v1",
@@ -759,7 +777,8 @@ function loadConfig() {
     debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_h = file.debug) != null ? _h : false,
     enabled: (_i = file.enabled) != null ? _i : true,
     eventName: (_k = (_j = process.env["RAINDROP_EVENT_NAME"]) != null ? _j : file.event_name) != null ? _k : "claude_code_session",
-    customProperties
+    customProperties,
+    selfDiagnostics
   };
 }
 function getConfigPath() {
@@ -1569,19 +1588,309 @@ function mirrorEventToLocalDebugger(baseUrl, payload, debug) {
   }).catch(() => {
   });
 }
+
+// src/mcp-serve.ts
+var import_node_readline = require("readline");
+var import_node_fs5 = require("fs");
+var import_node_path4 = require("path");
+var import_node_os4 = require("os");
+var DEFAULT_SIGNALS = {
+  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 is NOT a refusal or policy block \u2014 you tried and failed to deliver the result.",
+    sentiment: "NEGATIVE"
+  }
+};
+var NOTEWORTHY_KEY = "noteworthy";
+var NOTEWORTHY_DEFAULT_DESCRIPTION = "Only when no specific category applies: flag that this turn is noteworthy for developer review.";
+function normalizeSignals(custom) {
+  let base;
+  if (!custom || Object.keys(custom).length === 0) {
+    base = { ...DEFAULT_SIGNALS };
+  } else {
+    const validated = {};
+    for (const [key, def] of Object.entries(custom)) {
+      const k = key.trim();
+      if (!k || k === NOTEWORTHY_KEY) continue;
+      if (!def || typeof def !== "object") continue;
+      const desc = typeof def.description === "string" ? def.description.trim() : "";
+      if (!desc) continue;
+      const sentiment = def.sentiment;
+      validated[k] = {
+        description: desc,
+        ...sentiment === "POSITIVE" || sentiment === "NEGATIVE" ? { sentiment } : {}
+      };
+    }
+    base = Object.keys(validated).length > 0 ? validated : { ...DEFAULT_SIGNALS };
+  }
+  const customNoteworthy = custom == null ? void 0 : custom[NOTEWORTHY_KEY];
+  base[NOTEWORTHY_KEY] = {
+    description: typeof (customNoteworthy == null ? void 0 : customNoteworthy.description) === "string" && customNoteworthy.description.trim() ? customNoteworthy.description.trim() : NOTEWORTHY_DEFAULT_DESCRIPTION,
+    ...(customNoteworthy == null ? void 0 : customNoteworthy.sentiment) === "POSITIVE" || (customNoteworthy == null ? void 0 : customNoteworthy.sentiment) === "NEGATIVE" ? { sentiment: customNoteworthy.sentiment } : {}
+  };
+  return base;
+}
+function resolveToolConfig(diagConfig) {
+  var _a;
+  const signals = normalizeSignals(diagConfig == null ? void 0 : diagConfig.signals);
+  const categoryKeys = Object.keys(signals);
+  const toolName = ((_a = diagConfig == null ? void 0 : diagConfig.toolName) == null ? void 0 : _a.trim()) || "__raindrop_report";
+  const toolDescription = buildToolDescription(signals, categoryKeys, diagConfig == null ? void 0 : diagConfig.guidance);
+  return { signals, categoryKeys, toolName, toolDescription };
+}
+function buildToolDescription(signals, keys, guidance) {
+  const 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.";
+  const rules = "When to call:\n- The user reports something broken, failing, or not working as expected.\n- The user expresses frustration, anger, or threatens escalation.\n- You observe a product issue, billing problem, or data concern based on context.\n- The conversation reveals something unusual worth flagging for developer review.\n\nRules:\n1. Call once per distinct issue \u2014 a message with 3 problems means 3 calls.\n2. Pick the single best category per issue. Use noteworthy only when no specific category fits.\n3. Do not fabricate issues. Only report what is evident from the conversation.";
+  const categoryList = keys.map((key) => {
+    const def = signals[key];
+    const tag = def.sentiment ? ` [${def.sentiment.toLowerCase()}]` : "";
+    return `- ${key}: ${def.description}${tag}`;
+  }).join("\n");
+  const guidanceBlock = (guidance == null ? void 0 : guidance.trim()) ? `
+Additional guidance: ${guidance.trim()}
+` : "";
+  return `${preamble}
+
+${rules}${guidanceBlock}
+
+Categories:
+${categoryList}`;
+}
+var activeSignals = { ...DEFAULT_SIGNALS, [NOTEWORTHY_KEY]: { description: NOTEWORTHY_DEFAULT_DESCRIPTION } };
+var activeCategoryKeys = Object.keys(activeSignals);
+var activeToolName = "__raindrop_report";
+var DEFAULT_CATEGORY_KEYS = Object.keys(DEFAULT_SIGNALS).concat(NOTEWORTHY_KEY);
+var STATE_DIR2 = (0, import_node_path4.join)((0, import_node_os4.tmpdir)(), "raindrop-claude-code");
+function resolveCurrentEventId() {
+  try {
+    if (!(0, import_node_fs5.existsSync)(STATE_DIR2)) return void 0;
+    const files = (0, import_node_fs5.readdirSync)(STATE_DIR2).filter((f) => f.startsWith("event_"));
+    if (files.length === 0) return void 0;
+    let newest;
+    for (const file of files) {
+      try {
+        const full = (0, import_node_path4.join)(STATE_DIR2, file);
+        const st = (0, import_node_fs5.statSync)(full);
+        if (!newest || st.mtimeMs > newest.mtime) {
+          newest = { path: full, mtime: st.mtimeMs };
+        }
+      } catch (e) {
+        continue;
+      }
+    }
+    if (!newest) return void 0;
+    return (0, import_node_fs5.readFileSync)(newest.path, "utf-8").trim() || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+async function executeTool(args) {
+  const category = typeof args["category"] === "string" ? args["category"] : "";
+  const detail = typeof args["detail"] === "string" ? args["detail"] : "";
+  if (!category || !activeSignals[category]) {
+    return {
+      content: [{ type: "text", text: `Invalid category: ${category}. Valid: ${activeCategoryKeys.join(", ")}` }],
+      isError: true
+    };
+  }
+  if (!detail.trim()) {
+    return {
+      content: [{ type: "text", text: "Detail is required." }],
+      isError: true
+    };
+  }
+  const config = loadConfig();
+  if (!config.enabled) {
+    return { content: [{ type: "text", text: "Signal noted (hooks disabled)." }] };
+  }
+  if (!config.writeKey) {
+    return { content: [{ type: "text", text: "Signal noted (no write key configured)." }] };
+  }
+  const eventId = resolveCurrentEventId();
+  if (!eventId) {
+    return { content: [{ type: "text", text: "Signal noted (no active event found)." }] };
+  }
+  const shipper = new EventShipper2({
+    writeKey: config.writeKey,
+    endpoint: config.endpoint,
+    debug: false,
+    enabled: true
+  });
+  try {
+    const signalDef = activeSignals[category];
+    const isNoteworthy = category === NOTEWORTHY_KEY;
+    await shipper.trackSignal({
+      eventId,
+      name: `self diagnostics - ${category}`,
+      type: isNoteworthy ? "agent_internal" : "agent",
+      ...signalDef.sentiment ? { sentiment: signalDef.sentiment } : {},
+      properties: isNoteworthy ? {
+        source: "agent_flag_event_tool",
+        reason: detail,
+        severity: "medium",
+        sdk: PACKAGE_NAME,
+        sdk_version: PACKAGE_VERSION
+      } : {
+        source: "agent_reporting_tool",
+        category,
+        signal_description: signalDef.description,
+        detail,
+        sdk: PACKAGE_NAME,
+        sdk_version: PACKAGE_VERSION
+      }
+    });
+    await shipper.shutdown();
+  } catch (e) {
+  }
+  return { content: [{ type: "text", text: "Signal recorded." }] };
+}
+function sendResponse(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: id != null ? id : null, result }) + "\n");
+}
+function sendError(id, code, message) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: id != null ? id : null, error: { code, message } }) + "\n");
+}
+function buildToolSchema(toolName, toolDescription, categoryKeys) {
+  return {
+    name: toolName,
+    description: toolDescription,
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          enum: categoryKeys,
+          description: "The category of issue detected"
+        },
+        detail: {
+          type: "string",
+          description: "A factual one-sentence description of the issue"
+        }
+      },
+      required: ["category", "detail"]
+    }
+  };
+}
+var TOOL_SCHEMA = buildToolSchema(
+  activeToolName,
+  buildToolDescription(activeSignals, activeCategoryKeys),
+  activeCategoryKeys
+);
+async function startMcpServer() {
+  globalThis.console = new console.Console(process.stderr, process.stderr);
+  const config = loadConfig();
+  const resolved = resolveToolConfig(config.selfDiagnostics);
+  activeSignals = resolved.signals;
+  activeCategoryKeys = resolved.categoryKeys;
+  activeToolName = resolved.toolName;
+  const toolSchema = buildToolSchema(resolved.toolName, resolved.toolDescription, resolved.categoryKeys);
+  const rl = (0, import_node_readline.createInterface)({ input: process.stdin });
+  const inflight = /* @__PURE__ */ new Set();
+  rl.on("line", (line) => {
+    const promise = handleLine(line, toolSchema);
+    inflight.add(promise);
+    promise.finally(() => inflight.delete(promise));
+  });
+  rl.on("close", async () => {
+    await Promise.allSettled(inflight);
+    process.exit(0);
+  });
+}
+async function handleLine(line, toolSchema) {
+  var _a, _b;
+  let req;
+  try {
+    const parsed = JSON.parse(line);
+    if (!parsed || typeof parsed !== "object") {
+      return;
+    }
+    if (typeof parsed.method !== "string") {
+      if (parsed.id !== void 0) {
+        sendError(parsed.id, -32600, "Invalid Request: missing or non-string method");
+      }
+      return;
+    }
+    req = parsed;
+  } catch (e) {
+    return;
+  }
+  try {
+    switch (req.method) {
+      case "initialize":
+        sendResponse(req.id, {
+          protocolVersion: "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: PACKAGE_NAME, version: PACKAGE_VERSION }
+        });
+        break;
+      case "notifications/initialized":
+        break;
+      case "tools/list":
+        sendResponse(req.id, { tools: [toolSchema] });
+        break;
+      case "tools/call": {
+        const params = (_a = req.params) != null ? _a : {};
+        const toolName = params["name"];
+        if (toolName !== activeToolName) {
+          sendResponse(req.id, {
+            content: [{ type: "text", text: `Unknown tool: ${toolName}` }],
+            isError: true
+          });
+          break;
+        }
+        const toolArgs = (_b = params["arguments"]) != null ? _b : {};
+        const result = await executeTool(toolArgs);
+        sendResponse(req.id, result);
+        break;
+      }
+      case "ping":
+        sendResponse(req.id, {});
+        break;
+      default:
+        if (req.id !== void 0) {
+          sendError(req.id, -32601, `Method not found: ${req.method}`);
+        }
+    }
+  } catch (err) {
+    try {
+      if (req.id !== void 0) {
+        sendError(req.id, -32603, err instanceof Error ? err.message : String(err));
+      }
+    } catch (e) {
+    }
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_CATEGORY_KEYS,
   EventShipper,
   PACKAGE_NAME,
   PACKAGE_VERSION,
+  TOOL_SCHEMA,
   TraceShipper,
   detectLocalDebugger,
+  executeTool,
   extractAppendSystemPrompt,
   getConfigPath,
   loadConfig,
   mapHookToRaindrop,
   mirrorEventToLocalDebugger,
+  normalizeSignals,
   parseTranscript,
+  resolveCurrentEventId,
+  resolveToolConfig,
+  startMcpServer,
   transcriptToProperties,
   updateConfig
 });

package/dist/index.d.cts

@@ -221,6 +221,15 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+interface SelfDiagnosticsSignalDef {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+interface SelfDiagnosticsConfig {
+    signals?: Record<string, SelfDiagnosticsSignalDef>;
+    guidance?: string;
+    toolName?: string;
+}
 interface ConfigFile {
     write_key?: string;
     api_url?: string;
@@ -229,6 +238,7 @@ interface ConfigFile {
     enabled?: boolean;
     event_name?: string;
     custom_properties?: Record<string, unknown>;
+    self_diagnostics?: SelfDiagnosticsConfig;
 }
 interface RaindropConfig {
     writeKey: string;
@@ -238,6 +248,7 @@ interface RaindropConfig {
     enabled: boolean;
     eventName: string;
     customProperties: Record<string, unknown>;
+    selfDiagnostics?: SelfDiagnosticsConfig;
 }
 /**
  * Load config with precedence (low -> high):
@@ -297,7 +308,7 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.5";
+declare const PACKAGE_VERSION = "0.0.6";
 
 interface TranscriptSummary {
     /** Aggregated token usage across all turns */
@@ -360,4 +371,58 @@ declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResul
  */
 declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
 
-export { EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, type TranscriptSummary, detectLocalDebugger, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, parseTranscript, transcriptToProperties, updateConfig };
+interface ResolvedSignal {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+/**
+ * Normalize and validate user-provided signal definitions.
+ * Returns the default set if input is empty or all entries are invalid.
+ * Always appends `noteworthy` as the last category.
+ */
+declare function normalizeSignals(custom?: Record<string, SelfDiagnosticsSignalDef>): Record<string, ResolvedSignal>;
+/**
+ * Resolve the full MCP tool configuration from optional user config.
+ */
+declare function resolveToolConfig(diagConfig?: SelfDiagnosticsConfig): {
+    signals: Record<string, ResolvedSignal>;
+    categoryKeys: string[];
+    toolName: string;
+    toolDescription: string;
+};
+/** Default category keys (before custom signal config is applied). */
+declare const DEFAULT_CATEGORY_KEYS: string[];
+/**
+ * Find the most recently modified event_* file in the state dir.
+ * Returns the eventId stored in that file, or undefined.
+ */
+declare function resolveCurrentEventId(): string | undefined;
+declare function executeTool(args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+declare const TOOL_SCHEMA: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            detail: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+declare function startMcpServer(): Promise<void>;
+
+export { DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };

package/dist/index.d.ts

@@ -221,6 +221,15 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+interface SelfDiagnosticsSignalDef {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+interface SelfDiagnosticsConfig {
+    signals?: Record<string, SelfDiagnosticsSignalDef>;
+    guidance?: string;
+    toolName?: string;
+}
 interface ConfigFile {
     write_key?: string;
     api_url?: string;
@@ -229,6 +238,7 @@ interface ConfigFile {
     enabled?: boolean;
     event_name?: string;
     custom_properties?: Record<string, unknown>;
+    self_diagnostics?: SelfDiagnosticsConfig;
 }
 interface RaindropConfig {
     writeKey: string;
@@ -238,6 +248,7 @@ interface RaindropConfig {
     enabled: boolean;
     eventName: string;
     customProperties: Record<string, unknown>;
+    selfDiagnostics?: SelfDiagnosticsConfig;
 }
 /**
  * Load config with precedence (low -> high):
@@ -297,7 +308,7 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare function extractAppendSystemPrompt(args: string[]): string | undefined;
 
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
-declare const PACKAGE_VERSION = "0.0.5";
+declare const PACKAGE_VERSION = "0.0.6";
 
 interface TranscriptSummary {
     /** Aggregated token usage across all turns */
@@ -360,4 +371,58 @@ declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResul
  */
 declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
 
-export { EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, type TranscriptSummary, detectLocalDebugger, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, parseTranscript, transcriptToProperties, updateConfig };
+interface ResolvedSignal {
+    description: string;
+    sentiment?: "POSITIVE" | "NEGATIVE";
+}
+/**
+ * Normalize and validate user-provided signal definitions.
+ * Returns the default set if input is empty or all entries are invalid.
+ * Always appends `noteworthy` as the last category.
+ */
+declare function normalizeSignals(custom?: Record<string, SelfDiagnosticsSignalDef>): Record<string, ResolvedSignal>;
+/**
+ * Resolve the full MCP tool configuration from optional user config.
+ */
+declare function resolveToolConfig(diagConfig?: SelfDiagnosticsConfig): {
+    signals: Record<string, ResolvedSignal>;
+    categoryKeys: string[];
+    toolName: string;
+    toolDescription: string;
+};
+/** Default category keys (before custom signal config is applied). */
+declare const DEFAULT_CATEGORY_KEYS: string[];
+/**
+ * Find the most recently modified event_* file in the state dir.
+ * Returns the eventId stored in that file, or undefined.
+ */
+declare function resolveCurrentEventId(): string | undefined;
+declare function executeTool(args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+declare const TOOL_SCHEMA: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: "string";
+                enum: string[];
+                description: string;
+            };
+            detail: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+declare function startMcpServer(): Promise<void>;
+
+export { DEFAULT_CATEGORY_KEYS, EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SelfDiagnosticsConfig, type SelfDiagnosticsSignalDef, type SetupScope, TOOL_SCHEMA, TraceShipper, type TranscriptSummary, detectLocalDebugger, executeTool, extractAppendSystemPrompt, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, normalizeSignals, parseTranscript, resolveCurrentEventId, resolveToolConfig, startMcpServer, transcriptToProperties, updateConfig };

package/dist/index.js

@@ -645,7 +645,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 
 // src/package-info.ts
 var PACKAGE_NAME = "@raindrop-ai/claude-code";
-var PACKAGE_VERSION = "0.0.5";
+var PACKAGE_VERSION = "0.0.6";
 
 // src/shipper.ts
 var EventShipper2 = class extends EventShipper {
@@ -714,6 +714,17 @@ function loadConfig() {
     } catch (e) {
     }
   }
+  let selfDiagnostics = file.self_diagnostics;
+  const envDiag = process.env["RAINDROP_SELF_DIAGNOSTICS"];
+  if (envDiag) {
+    try {
+      const parsed = JSON.parse(envDiag);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        selfDiagnostics = parsed;
+      }
+    } catch (e) {
+    }
+  }
   return {
     writeKey: (_c = (_b = process.env["RAINDROP_WRITE_KEY"]) != null ? _b : file.write_key) != null ? _c : "",
     endpoint: (_e = (_d = process.env["RAINDROP_API_URL"]) != null ? _d : file.api_url) != null ? _e : "https://api.raindrop.ai/v1",
@@ -721,7 +732,8 @@ function loadConfig() {
     debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_h = file.debug) != null ? _h : false,
     enabled: (_i = file.enabled) != null ? _i : true,
     eventName: (_k = (_j = process.env["RAINDROP_EVENT_NAME"]) != null ? _j : file.event_name) != null ? _k : "claude_code_session",
-    customProperties
+    customProperties,
+    selfDiagnostics
   };
 }
 function getConfigPath() {
@@ -1531,18 +1543,308 @@ function mirrorEventToLocalDebugger(baseUrl, payload, debug) {
   }).catch(() => {
   });
 }
+
+// src/mcp-serve.ts
+import { createInterface } from "readline";
+import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync5, statSync } from "fs";
+import { join as join4 } from "path";
+import { tmpdir as tmpdir3 } from "os";
+var DEFAULT_SIGNALS = {
+  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 is NOT a refusal or policy block \u2014 you tried and failed to deliver the result.",
+    sentiment: "NEGATIVE"
+  }
+};
+var NOTEWORTHY_KEY = "noteworthy";
+var NOTEWORTHY_DEFAULT_DESCRIPTION = "Only when no specific category applies: flag that this turn is noteworthy for developer review.";
+function normalizeSignals(custom) {
+  let base;
+  if (!custom || Object.keys(custom).length === 0) {
+    base = { ...DEFAULT_SIGNALS };
+  } else {
+    const validated = {};
+    for (const [key, def] of Object.entries(custom)) {
+      const k = key.trim();
+      if (!k || k === NOTEWORTHY_KEY) continue;
+      if (!def || typeof def !== "object") continue;
+      const desc = typeof def.description === "string" ? def.description.trim() : "";
+      if (!desc) continue;
+      const sentiment = def.sentiment;
+      validated[k] = {
+        description: desc,
+        ...sentiment === "POSITIVE" || sentiment === "NEGATIVE" ? { sentiment } : {}
+      };
+    }
+    base = Object.keys(validated).length > 0 ? validated : { ...DEFAULT_SIGNALS };
+  }
+  const customNoteworthy = custom == null ? void 0 : custom[NOTEWORTHY_KEY];
+  base[NOTEWORTHY_KEY] = {
+    description: typeof (customNoteworthy == null ? void 0 : customNoteworthy.description) === "string" && customNoteworthy.description.trim() ? customNoteworthy.description.trim() : NOTEWORTHY_DEFAULT_DESCRIPTION,
+    ...(customNoteworthy == null ? void 0 : customNoteworthy.sentiment) === "POSITIVE" || (customNoteworthy == null ? void 0 : customNoteworthy.sentiment) === "NEGATIVE" ? { sentiment: customNoteworthy.sentiment } : {}
+  };
+  return base;
+}
+function resolveToolConfig(diagConfig) {
+  var _a;
+  const signals = normalizeSignals(diagConfig == null ? void 0 : diagConfig.signals);
+  const categoryKeys = Object.keys(signals);
+  const toolName = ((_a = diagConfig == null ? void 0 : diagConfig.toolName) == null ? void 0 : _a.trim()) || "__raindrop_report";
+  const toolDescription = buildToolDescription(signals, categoryKeys, diagConfig == null ? void 0 : diagConfig.guidance);
+  return { signals, categoryKeys, toolName, toolDescription };
+}
+function buildToolDescription(signals, keys, guidance) {
+  const 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.";
+  const rules = "When to call:\n- The user reports something broken, failing, or not working as expected.\n- The user expresses frustration, anger, or threatens escalation.\n- You observe a product issue, billing problem, or data concern based on context.\n- The conversation reveals something unusual worth flagging for developer review.\n\nRules:\n1. Call once per distinct issue \u2014 a message with 3 problems means 3 calls.\n2. Pick the single best category per issue. Use noteworthy only when no specific category fits.\n3. Do not fabricate issues. Only report what is evident from the conversation.";
+  const categoryList = keys.map((key) => {
+    const def = signals[key];
+    const tag = def.sentiment ? ` [${def.sentiment.toLowerCase()}]` : "";
+    return `- ${key}: ${def.description}${tag}`;
+  }).join("\n");
+  const guidanceBlock = (guidance == null ? void 0 : guidance.trim()) ? `
+Additional guidance: ${guidance.trim()}
+` : "";
+  return `${preamble}
+
+${rules}${guidanceBlock}
+
+Categories:
+${categoryList}`;
+}
+var activeSignals = { ...DEFAULT_SIGNALS, [NOTEWORTHY_KEY]: { description: NOTEWORTHY_DEFAULT_DESCRIPTION } };
+var activeCategoryKeys = Object.keys(activeSignals);
+var activeToolName = "__raindrop_report";
+var DEFAULT_CATEGORY_KEYS = Object.keys(DEFAULT_SIGNALS).concat(NOTEWORTHY_KEY);
+var STATE_DIR2 = join4(tmpdir3(), "raindrop-claude-code");
+function resolveCurrentEventId() {
+  try {
+    if (!existsSync5(STATE_DIR2)) return void 0;
+    const files = readdirSync2(STATE_DIR2).filter((f) => f.startsWith("event_"));
+    if (files.length === 0) return void 0;
+    let newest;
+    for (const file of files) {
+      try {
+        const full = join4(STATE_DIR2, file);
+        const st = statSync(full);
+        if (!newest || st.mtimeMs > newest.mtime) {
+          newest = { path: full, mtime: st.mtimeMs };
+        }
+      } catch (e) {
+        continue;
+      }
+    }
+    if (!newest) return void 0;
+    return readFileSync5(newest.path, "utf-8").trim() || void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+async function executeTool(args) {
+  const category = typeof args["category"] === "string" ? args["category"] : "";
+  const detail = typeof args["detail"] === "string" ? args["detail"] : "";
+  if (!category || !activeSignals[category]) {
+    return {
+      content: [{ type: "text", text: `Invalid category: ${category}. Valid: ${activeCategoryKeys.join(", ")}` }],
+      isError: true
+    };
+  }
+  if (!detail.trim()) {
+    return {
+      content: [{ type: "text", text: "Detail is required." }],
+      isError: true
+    };
+  }
+  const config = loadConfig();
+  if (!config.enabled) {
+    return { content: [{ type: "text", text: "Signal noted (hooks disabled)." }] };
+  }
+  if (!config.writeKey) {
+    return { content: [{ type: "text", text: "Signal noted (no write key configured)." }] };
+  }
+  const eventId = resolveCurrentEventId();
+  if (!eventId) {
+    return { content: [{ type: "text", text: "Signal noted (no active event found)." }] };
+  }
+  const shipper = new EventShipper2({
+    writeKey: config.writeKey,
+    endpoint: config.endpoint,
+    debug: false,
+    enabled: true
+  });
+  try {
+    const signalDef = activeSignals[category];
+    const isNoteworthy = category === NOTEWORTHY_KEY;
+    await shipper.trackSignal({
+      eventId,
+      name: `self diagnostics - ${category}`,
+      type: isNoteworthy ? "agent_internal" : "agent",
+      ...signalDef.sentiment ? { sentiment: signalDef.sentiment } : {},
+      properties: isNoteworthy ? {
+        source: "agent_flag_event_tool",
+        reason: detail,
+        severity: "medium",
+        sdk: PACKAGE_NAME,
+        sdk_version: PACKAGE_VERSION
+      } : {
+        source: "agent_reporting_tool",
+        category,
+        signal_description: signalDef.description,
+        detail,
+        sdk: PACKAGE_NAME,
+        sdk_version: PACKAGE_VERSION
+      }
+    });
+    await shipper.shutdown();
+  } catch (e) {
+  }
+  return { content: [{ type: "text", text: "Signal recorded." }] };
+}
+function sendResponse(id, result) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: id != null ? id : null, result }) + "\n");
+}
+function sendError(id, code, message) {
+  process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: id != null ? id : null, error: { code, message } }) + "\n");
+}
+function buildToolSchema(toolName, toolDescription, categoryKeys) {
+  return {
+    name: toolName,
+    description: toolDescription,
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          enum: categoryKeys,
+          description: "The category of issue detected"
+        },
+        detail: {
+          type: "string",
+          description: "A factual one-sentence description of the issue"
+        }
+      },
+      required: ["category", "detail"]
+    }
+  };
+}
+var TOOL_SCHEMA = buildToolSchema(
+  activeToolName,
+  buildToolDescription(activeSignals, activeCategoryKeys),
+  activeCategoryKeys
+);
+async function startMcpServer() {
+  globalThis.console = new console.Console(process.stderr, process.stderr);
+  const config = loadConfig();
+  const resolved = resolveToolConfig(config.selfDiagnostics);
+  activeSignals = resolved.signals;
+  activeCategoryKeys = resolved.categoryKeys;
+  activeToolName = resolved.toolName;
+  const toolSchema = buildToolSchema(resolved.toolName, resolved.toolDescription, resolved.categoryKeys);
+  const rl = createInterface({ input: process.stdin });
+  const inflight = /* @__PURE__ */ new Set();
+  rl.on("line", (line) => {
+    const promise = handleLine(line, toolSchema);
+    inflight.add(promise);
+    promise.finally(() => inflight.delete(promise));
+  });
+  rl.on("close", async () => {
+    await Promise.allSettled(inflight);
+    process.exit(0);
+  });
+}
+async function handleLine(line, toolSchema) {
+  var _a, _b;
+  let req;
+  try {
+    const parsed = JSON.parse(line);
+    if (!parsed || typeof parsed !== "object") {
+      return;
+    }
+    if (typeof parsed.method !== "string") {
+      if (parsed.id !== void 0) {
+        sendError(parsed.id, -32600, "Invalid Request: missing or non-string method");
+      }
+      return;
+    }
+    req = parsed;
+  } catch (e) {
+    return;
+  }
+  try {
+    switch (req.method) {
+      case "initialize":
+        sendResponse(req.id, {
+          protocolVersion: "2024-11-05",
+          capabilities: { tools: {} },
+          serverInfo: { name: PACKAGE_NAME, version: PACKAGE_VERSION }
+        });
+        break;
+      case "notifications/initialized":
+        break;
+      case "tools/list":
+        sendResponse(req.id, { tools: [toolSchema] });
+        break;
+      case "tools/call": {
+        const params = (_a = req.params) != null ? _a : {};
+        const toolName = params["name"];
+        if (toolName !== activeToolName) {
+          sendResponse(req.id, {
+            content: [{ type: "text", text: `Unknown tool: ${toolName}` }],
+            isError: true
+          });
+          break;
+        }
+        const toolArgs = (_b = params["arguments"]) != null ? _b : {};
+        const result = await executeTool(toolArgs);
+        sendResponse(req.id, result);
+        break;
+      }
+      case "ping":
+        sendResponse(req.id, {});
+        break;
+      default:
+        if (req.id !== void 0) {
+          sendError(req.id, -32601, `Method not found: ${req.method}`);
+        }
+    }
+  } catch (err) {
+    try {
+      if (req.id !== void 0) {
+        sendError(req.id, -32603, err instanceof Error ? err.message : String(err));
+      }
+    } catch (e) {
+    }
+  }
+}
 export {
+  DEFAULT_CATEGORY_KEYS,
   EventShipper2 as EventShipper,
   PACKAGE_NAME,
   PACKAGE_VERSION,
+  TOOL_SCHEMA,
   TraceShipper2 as TraceShipper,
   detectLocalDebugger,
+  executeTool,
   extractAppendSystemPrompt,
   getConfigPath,
   loadConfig,
   mapHookToRaindrop,
   mirrorEventToLocalDebugger,
+  normalizeSignals,
   parseTranscript,
+  resolveCurrentEventId,
+  resolveToolConfig,
+  startMcpServer,
   transcriptToProperties,
   updateConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/claude-code",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Raindrop observability for Claude Code CLI — automatic session, tool call, and prompt tracing via hooks",
   "license": "MIT",
   "type": "module",