@raindrop-ai/claude-code 0.0.20 → 0.0.21

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "raindrop",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "Observability for Claude Code \u2014 automatic session, tool call, and prompt tracing",
   "author": {
     "name": "Raindrop AI",

package/README.md

@@ -45,6 +45,28 @@ Tag events with product names or custom metadata via `.claude/settings.json`:
 }
 ```
 
+## Tool catalog capture (`ai.prompt.tools`)
+
+Claude Code hooks and transcripts never expose the request Claude Code sends to the model, so this
+integration cannot observe the tool catalog and records nothing by default (the attribute stays
+absent, meaning "unknown"). Supply the catalog yourself with `tools` — an array of tool
+declarations in any shape `@raindrop-ai/core` recognizes (`{ name, description?, parameters }`,
+`{ type: "function", name, inputSchema }`, OpenAI/Anthropic wrappers, ...):
+
+```json
+{
+  "tools": [
+    { "name": "read_file", "description": "Read a file", "parameters": { "type": "object", "properties": { "path": { "type": "string" } }, "required": ["path"] } }
+  ]
+}
+```
+
+Set it in `~/.config/raindrop/config.json` (`tools`) or as JSON in the `RAINDROP_TOOLS` environment
+variable (the variable wins). The override is recorded verbatim as `ai.prompt.tools` on every LLM
+span reconstructed from the transcript (`gen_ai.response.model` spans), never on tool-call,
+subagent, or permission spans, and `tools: []` records an explicitly empty catalog. Nothing is
+inferred from hook payloads: implicit capture is not possible here.
+
 ## Custom Self-Diagnostics Signals
 
 Replace the built-in signal categories with your own via `~/.config/raindrop/config.json`:

package/dist/cli.js

@@ -69,7 +69,7 @@ function evalScopeAttributes() {
   return { [EVAL_CORRELATION_ID_ATTRIBUTE]: scope.correlationId };
 }
 
-// ../core/dist/chunk-WJOR6M7H.js
+// ../core/dist/chunk-I6TVJQEC.js
 var STATE_KEY = /* @__PURE__ */ Symbol.for("raindrop.tracing.replayTraceRoutingState");
 function state() {
   const holder = globalThis;
@@ -2056,6 +2056,158 @@ var TraceShipper = class {
     }
   }
 };
+var PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var JSON_SCHEMA_KEYS = [
+  "type",
+  "properties",
+  "$schema",
+  "$ref",
+  "anyOf",
+  "oneOf",
+  "allOf",
+  "enum",
+  "const",
+  "items",
+  "additionalProperties",
+  "required"
+];
+function isJsonSchema(value) {
+  if (!isRecord(value)) return false;
+  if (typeof value["~standard"] === "object") return false;
+  if (isRecord(value._def) || isRecord(value._zod)) return false;
+  if (Object.keys(value).length === 0) return true;
+  return JSON_SCHEMA_KEYS.some((key) => key in value);
+}
+function toJsonSchema(value, options) {
+  if (value === void 0 || value === null) return void 0;
+  if (isJsonSchema(value)) return value;
+  if (isRecord(value) && isJsonSchema(value.jsonSchema)) return value.jsonSchema;
+  if (isRecord(value) && isJsonSchema(value.json)) return value.json;
+  if (options == null ? void 0 : options.schema) {
+    try {
+      return options.schema(value);
+    } catch (e) {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function pickString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function functionTool(name, description, schema, options) {
+  const tool = { type: "function", name };
+  const desc = pickString(description);
+  if (desc !== void 0) tool.description = desc;
+  const inputSchema = toJsonSchema(schema, options);
+  if (inputSchema !== void 0) tool.inputSchema = inputSchema;
+  return tool;
+}
+function normalizeToolDeclaration(tool, options, fallbackName) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  if (!isRecord(tool)) return void 0;
+  if (tool.type === "provider-defined" || tool.type === "provider") {
+    const name2 = (_b = (_a = pickString(tool.name)) != null ? _a : pickString(tool.id)) != null ? _b : fallbackName;
+    if (name2 === void 0) return void 0;
+    const declaration = { type: "provider-defined", name: name2 };
+    const id = pickString(tool.id);
+    if (id !== void 0) declaration.id = id;
+    if (isRecord(tool.args)) declaration.args = tool.args;
+    return declaration;
+  }
+  if (isRecord(tool.toolSpec)) {
+    const spec = tool.toolSpec;
+    const name2 = (_c = pickString(spec.name)) != null ? _c : fallbackName;
+    if (name2 === void 0) return void 0;
+    return functionTool(name2, spec.description, spec.inputSchema, options);
+  }
+  if (isRecord(tool.function)) {
+    const fn = tool.function;
+    const name2 = (_d = pickString(fn.name)) != null ? _d : fallbackName;
+    if (name2 === void 0) return void 0;
+    return functionTool(name2, fn.description, (_e = fn.parameters) != null ? _e : fn.input_schema, options);
+  }
+  const name = (_g = (_f = pickString(tool.name)) != null ? _f : pickString(tool.id)) != null ? _g : fallbackName;
+  if (name === void 0) return void 0;
+  const type = pickString(tool.type);
+  if (type !== void 0 && type !== "function" && type !== "dynamic" && type !== "custom") {
+    if (!("input_schema" in tool) && !("inputSchema" in tool) && !("parameters" in tool)) {
+      return { type: "provider-defined", id: type, name };
+    }
+  }
+  return functionTool(
+    name,
+    tool.description,
+    (_j = (_i = (_h = tool.inputSchema) != null ? _h : tool.input_schema) != null ? _i : tool.parameters) != null ? _j : tool.schema,
+    options
+  );
+}
+var NOT_A_GEMINI_GROUP_KEYS = ["name", "id", "type", "function", "toolSpec", "cachePoint"];
+function isGeminiToolGroup(tool) {
+  if (Array.isArray(tool.functionDeclarations)) return true;
+  const keys = Object.keys(tool);
+  if (keys.length === 0 || NOT_A_GEMINI_GROUP_KEYS.some((key) => key in tool)) return false;
+  return keys.every((key) => isRecord(tool[key]));
+}
+function expandGeminiTool(tool, options) {
+  const declarations = [];
+  for (const [key, value] of Object.entries(tool)) {
+    if (key === "functionDeclarations" && Array.isArray(value)) {
+      for (const declaration of value) {
+        const normalized = normalizeToolDeclaration(declaration, options);
+        if (normalized) declarations.push(normalized);
+      }
+    } else if (isRecord(value)) {
+      declarations.push({ type: "provider-defined", id: key, name: key, args: value });
+    }
+  }
+  return declarations;
+}
+function normalizeToolDeclarations(tools, options) {
+  if (tools === void 0 || tools === null) return void 0;
+  if (Array.isArray(tools)) {
+    return tools.flatMap((tool) => {
+      if (isRecord(tool) && isGeminiToolGroup(tool)) {
+        return expandGeminiTool(tool, options);
+      }
+      const declaration = normalizeToolDeclaration(tool, options);
+      return declaration ? [declaration] : [];
+    });
+  }
+  if (!isRecord(tools)) return void 0;
+  return Object.entries(tools).flatMap(([key, tool]) => {
+    const declaration = normalizeToolDeclaration(tool, options, key);
+    return declaration ? [declaration] : [];
+  });
+}
+function resolvePromptTools(args2) {
+  var _a;
+  if (args2.override !== void 0) {
+    return (_a = normalizeToolDeclarations(args2.override, args2.options)) != null ? _a : [];
+  }
+  return normalizeToolDeclarations(args2.inferred, args2.options);
+}
+function promptToolsAttribute(tools) {
+  const values = promptToolsAttributeValue(tools);
+  if (values === void 0) return void 0;
+  return {
+    key: PROMPT_TOOLS_ATTRIBUTE,
+    value: { arrayValue: { values: values.map((stringValue) => ({ stringValue })) } }
+  };
+}
+function promptToolsAttributeValue(tools) {
+  if (tools === void 0) return void 0;
+  return tools.map((tool) => {
+    try {
+      return JSON.stringify(tool);
+    } catch (e) {
+      return JSON.stringify({ type: tool.type, name: tool.name });
+    }
+  });
+}
 
 // ../core/dist/index.node.js
 import { AsyncLocalStorage } from "async_hooks";
@@ -2234,7 +2386,7 @@ installTracingSuppressionHook();
 // package.json
 var package_default = {
   name: "@raindrop-ai/claude-code",
-  version: "0.0.20",
+  version: "0.0.21",
   description: "Raindrop observability for Claude Code CLI \u2014 automatic session, tool call, and prompt tracing via hooks",
   license: "MIT",
   homepage: "https://www.raindrop.ai/docs/integrations/claude-code/",
@@ -3143,7 +3295,7 @@ function isoToNanoString(iso, fallback) {
     return fallback;
   }
 }
-function enrichFromTranscript(payload, eventId, traceShipper) {
+function enrichFromTranscript(payload, eventId, traceShipper, promptTools) {
   var _a, _b, _c, _d;
   if (!payload.transcript_path) {
     return { summary: void 0, props: {} };
@@ -3182,7 +3334,8 @@ function enrichFromTranscript(payload, eventId, traceShipper) {
             attrString("ai.response.text", truncate(outputText)),
             ...toolCallNames ? [attrString("ai.toolCall.names", toolCallNames)] : [],
             ...phase.hasThinking ? [attrString("ai.has_thinking", "true")] : [],
-            attrInt("ai.llm_call.index", emittedPhaseIndex)
+            attrInt("ai.llm_call.index", emittedPhaseIndex),
+            promptTools
           ]
         });
         emittedPhaseIndex++;
@@ -3204,7 +3357,8 @@ function enrichFromTranscript(payload, eventId, traceShipper) {
             attrString("gen_ai.system", "anthropic"),
             attrInt("gen_ai.usage.prompt_tokens", spanInputTokens),
             attrInt("gen_ai.usage.completion_tokens", spanOutputTokens),
-            ...summary.lastTurnCacheReadTokens != null && summary.lastTurnCacheReadTokens > 0 ? [attrInt("gen_ai.usage.cache_read_tokens", summary.lastTurnCacheReadTokens)] : []
+            ...summary.lastTurnCacheReadTokens != null && summary.lastTurnCacheReadTokens > 0 ? [attrInt("gen_ai.usage.cache_read_tokens", summary.lastTurnCacheReadTokens)] : [],
+            promptTools
           ]
         });
       }
@@ -3230,7 +3384,12 @@ function buildStopOutput(summary, lastAssistantMessage) {
   return finalMessage;
 }
 async function handleStopOrFailure(payload, eventId, convoId, config, properties, eventShipper, traceShipper, extraProperties) {
-  const { summary, props: transcriptProps } = enrichFromTranscript(payload, eventId, traceShipper);
+  const { summary, props: transcriptProps } = enrichFromTranscript(
+    payload,
+    eventId,
+    traceShipper,
+    promptToolsAttribute(resolvePromptTools({ override: config.tools }))
+  );
   const instructions = gatherInstructions(payload.session_id);
   const appendSysPrompt = readAppendSystemPrompt(payload.session_id);
   const output = buildStopOutput(summary, payload.last_assistant_message);
@@ -3295,6 +3454,15 @@ function loadConfig() {
     } catch (e) {
     }
   }
+  let tools = Array.isArray(file.tools) ? file.tools : void 0;
+  const envTools = process.env["RAINDROP_TOOLS"];
+  if (envTools) {
+    try {
+      const parsed = JSON.parse(envTools);
+      if (Array.isArray(parsed)) tools = parsed;
+    } catch (e) {
+    }
+  }
   let selfDiagnostics = file.self_diagnostics;
   const envDiag = process.env["RAINDROP_SELF_DIAGNOSTICS"];
   if (envDiag) {
@@ -3323,7 +3491,8 @@ function loadConfig() {
     eventName: (_l = (_k = process.env["RAINDROP_EVENT_NAME"]) != null ? _k : file.event_name) != null ? _l : "claude_code_session",
     customProperties,
     selfDiagnostics,
-    appGit: mapAppGit(file.app_git)
+    appGit: mapAppGit(file.app_git),
+    tools
   };
 }
 function mapAppGit(value) {
@@ -3545,7 +3714,8 @@ async function handleHook() {
     convoId: config.convoId,
     debug: config.debug,
     eventName: config.eventName,
-    customProperties: config.customProperties
+    customProperties: config.customProperties,
+    tools: config.tools
   };
   const appGitContext = createAppGitContext2(
     ((_a = config.writeKey) == null ? void 0 : _a.trim()) || hasDebugger ? config.appGit : false,

package/dist/index.cjs

@@ -106,7 +106,7 @@ function evalScopeAttributes() {
   return { [EVAL_CORRELATION_ID_ATTRIBUTE]: scope.correlationId };
 }
 
-// ../core/dist/chunk-WJOR6M7H.js
+// ../core/dist/chunk-I6TVJQEC.js
 var STATE_KEY = /* @__PURE__ */ Symbol.for("raindrop.tracing.replayTraceRoutingState");
 function state() {
   const holder = globalThis;
@@ -2093,6 +2093,158 @@ var TraceShipper = class {
     }
   }
 };
+var PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var JSON_SCHEMA_KEYS = [
+  "type",
+  "properties",
+  "$schema",
+  "$ref",
+  "anyOf",
+  "oneOf",
+  "allOf",
+  "enum",
+  "const",
+  "items",
+  "additionalProperties",
+  "required"
+];
+function isJsonSchema(value) {
+  if (!isRecord(value)) return false;
+  if (typeof value["~standard"] === "object") return false;
+  if (isRecord(value._def) || isRecord(value._zod)) return false;
+  if (Object.keys(value).length === 0) return true;
+  return JSON_SCHEMA_KEYS.some((key) => key in value);
+}
+function toJsonSchema(value, options) {
+  if (value === void 0 || value === null) return void 0;
+  if (isJsonSchema(value)) return value;
+  if (isRecord(value) && isJsonSchema(value.jsonSchema)) return value.jsonSchema;
+  if (isRecord(value) && isJsonSchema(value.json)) return value.json;
+  if (options == null ? void 0 : options.schema) {
+    try {
+      return options.schema(value);
+    } catch (e) {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function pickString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function functionTool(name, description, schema, options) {
+  const tool = { type: "function", name };
+  const desc = pickString(description);
+  if (desc !== void 0) tool.description = desc;
+  const inputSchema = toJsonSchema(schema, options);
+  if (inputSchema !== void 0) tool.inputSchema = inputSchema;
+  return tool;
+}
+function normalizeToolDeclaration(tool, options, fallbackName) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  if (!isRecord(tool)) return void 0;
+  if (tool.type === "provider-defined" || tool.type === "provider") {
+    const name2 = (_b = (_a = pickString(tool.name)) != null ? _a : pickString(tool.id)) != null ? _b : fallbackName;
+    if (name2 === void 0) return void 0;
+    const declaration = { type: "provider-defined", name: name2 };
+    const id = pickString(tool.id);
+    if (id !== void 0) declaration.id = id;
+    if (isRecord(tool.args)) declaration.args = tool.args;
+    return declaration;
+  }
+  if (isRecord(tool.toolSpec)) {
+    const spec = tool.toolSpec;
+    const name2 = (_c = pickString(spec.name)) != null ? _c : fallbackName;
+    if (name2 === void 0) return void 0;
+    return functionTool(name2, spec.description, spec.inputSchema, options);
+  }
+  if (isRecord(tool.function)) {
+    const fn = tool.function;
+    const name2 = (_d = pickString(fn.name)) != null ? _d : fallbackName;
+    if (name2 === void 0) return void 0;
+    return functionTool(name2, fn.description, (_e = fn.parameters) != null ? _e : fn.input_schema, options);
+  }
+  const name = (_g = (_f = pickString(tool.name)) != null ? _f : pickString(tool.id)) != null ? _g : fallbackName;
+  if (name === void 0) return void 0;
+  const type = pickString(tool.type);
+  if (type !== void 0 && type !== "function" && type !== "dynamic" && type !== "custom") {
+    if (!("input_schema" in tool) && !("inputSchema" in tool) && !("parameters" in tool)) {
+      return { type: "provider-defined", id: type, name };
+    }
+  }
+  return functionTool(
+    name,
+    tool.description,
+    (_j = (_i = (_h = tool.inputSchema) != null ? _h : tool.input_schema) != null ? _i : tool.parameters) != null ? _j : tool.schema,
+    options
+  );
+}
+var NOT_A_GEMINI_GROUP_KEYS = ["name", "id", "type", "function", "toolSpec", "cachePoint"];
+function isGeminiToolGroup(tool) {
+  if (Array.isArray(tool.functionDeclarations)) return true;
+  const keys = Object.keys(tool);
+  if (keys.length === 0 || NOT_A_GEMINI_GROUP_KEYS.some((key) => key in tool)) return false;
+  return keys.every((key) => isRecord(tool[key]));
+}
+function expandGeminiTool(tool, options) {
+  const declarations = [];
+  for (const [key, value] of Object.entries(tool)) {
+    if (key === "functionDeclarations" && Array.isArray(value)) {
+      for (const declaration of value) {
+        const normalized = normalizeToolDeclaration(declaration, options);
+        if (normalized) declarations.push(normalized);
+      }
+    } else if (isRecord(value)) {
+      declarations.push({ type: "provider-defined", id: key, name: key, args: value });
+    }
+  }
+  return declarations;
+}
+function normalizeToolDeclarations(tools, options) {
+  if (tools === void 0 || tools === null) return void 0;
+  if (Array.isArray(tools)) {
+    return tools.flatMap((tool) => {
+      if (isRecord(tool) && isGeminiToolGroup(tool)) {
+        return expandGeminiTool(tool, options);
+      }
+      const declaration = normalizeToolDeclaration(tool, options);
+      return declaration ? [declaration] : [];
+    });
+  }
+  if (!isRecord(tools)) return void 0;
+  return Object.entries(tools).flatMap(([key, tool]) => {
+    const declaration = normalizeToolDeclaration(tool, options, key);
+    return declaration ? [declaration] : [];
+  });
+}
+function resolvePromptTools(args) {
+  var _a;
+  if (args.override !== void 0) {
+    return (_a = normalizeToolDeclarations(args.override, args.options)) != null ? _a : [];
+  }
+  return normalizeToolDeclarations(args.inferred, args.options);
+}
+function promptToolsAttribute(tools) {
+  const values = promptToolsAttributeValue(tools);
+  if (values === void 0) return void 0;
+  return {
+    key: PROMPT_TOOLS_ATTRIBUTE,
+    value: { arrayValue: { values: values.map((stringValue) => ({ stringValue })) } }
+  };
+}
+function promptToolsAttributeValue(tools) {
+  if (tools === void 0) return void 0;
+  return tools.map((tool) => {
+    try {
+      return JSON.stringify(tool);
+    } catch (e) {
+      return JSON.stringify({ type: tool.type, name: tool.name });
+    }
+  });
+}
 
 // ../core/dist/index.node.js
 var import_async_hooks = require("async_hooks");
@@ -2271,7 +2423,7 @@ installTracingSuppressionHook();
 // package.json
 var package_default = {
   name: "@raindrop-ai/claude-code",
-  version: "0.0.20",
+  version: "0.0.21",
   description: "Raindrop observability for Claude Code CLI \u2014 automatic session, tool call, and prompt tracing via hooks",
   license: "MIT",
   homepage: "https://www.raindrop.ai/docs/integrations/claude-code/",
@@ -2411,6 +2563,15 @@ function loadConfig() {
     } catch (e) {
     }
   }
+  let tools = Array.isArray(file.tools) ? file.tools : void 0;
+  const envTools = process.env["RAINDROP_TOOLS"];
+  if (envTools) {
+    try {
+      const parsed = JSON.parse(envTools);
+      if (Array.isArray(parsed)) tools = parsed;
+    } catch (e) {
+    }
+  }
   let selfDiagnostics = file.self_diagnostics;
   const envDiag = process.env["RAINDROP_SELF_DIAGNOSTICS"];
   if (envDiag) {
@@ -2439,7 +2600,8 @@ function loadConfig() {
     eventName: (_l = (_k = process.env["RAINDROP_EVENT_NAME"]) != null ? _k : file.event_name) != null ? _l : "claude_code_session",
     customProperties,
     selfDiagnostics,
-    appGit: mapAppGit(file.app_git)
+    appGit: mapAppGit(file.app_git),
+    tools
   };
 }
 function mapAppGit(value) {
@@ -3278,7 +3440,7 @@ function isoToNanoString(iso, fallback) {
     return fallback;
   }
 }
-function enrichFromTranscript(payload, eventId, traceShipper) {
+function enrichFromTranscript(payload, eventId, traceShipper, promptTools) {
   var _a, _b, _c, _d;
   if (!payload.transcript_path) {
     return { summary: void 0, props: {} };
@@ -3317,7 +3479,8 @@ function enrichFromTranscript(payload, eventId, traceShipper) {
             attrString("ai.response.text", truncate(outputText)),
             ...toolCallNames ? [attrString("ai.toolCall.names", toolCallNames)] : [],
             ...phase.hasThinking ? [attrString("ai.has_thinking", "true")] : [],
-            attrInt("ai.llm_call.index", emittedPhaseIndex)
+            attrInt("ai.llm_call.index", emittedPhaseIndex),
+            promptTools
           ]
         });
         emittedPhaseIndex++;
@@ -3339,7 +3502,8 @@ function enrichFromTranscript(payload, eventId, traceShipper) {
             attrString("gen_ai.system", "anthropic"),
             attrInt("gen_ai.usage.prompt_tokens", spanInputTokens),
             attrInt("gen_ai.usage.completion_tokens", spanOutputTokens),
-            ...summary.lastTurnCacheReadTokens != null && summary.lastTurnCacheReadTokens > 0 ? [attrInt("gen_ai.usage.cache_read_tokens", summary.lastTurnCacheReadTokens)] : []
+            ...summary.lastTurnCacheReadTokens != null && summary.lastTurnCacheReadTokens > 0 ? [attrInt("gen_ai.usage.cache_read_tokens", summary.lastTurnCacheReadTokens)] : [],
+            promptTools
           ]
         });
       }
@@ -3365,7 +3529,12 @@ function buildStopOutput(summary, lastAssistantMessage) {
   return finalMessage;
 }
 async function handleStopOrFailure(payload, eventId, convoId, config, properties, eventShipper, traceShipper, extraProperties) {
-  const { summary, props: transcriptProps } = enrichFromTranscript(payload, eventId, traceShipper);
+  const { summary, props: transcriptProps } = enrichFromTranscript(
+    payload,
+    eventId,
+    traceShipper,
+    promptToolsAttribute(resolvePromptTools({ override: config.tools }))
+  );
   const instructions = gatherInstructions(payload.session_id);
   const appendSysPrompt = readAppendSystemPrompt(payload.session_id);
   const output = buildStopOutput(summary, payload.last_assistant_message);

package/dist/index.d.cts

@@ -506,6 +506,32 @@ declare global {
     var RAINDROP_CONTEXT_MANAGER: (new () => ContextManager) | undefined;
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => AsyncLocalStorageLike<T>) | undefined;
 }
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
 
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
@@ -543,6 +569,7 @@ interface ConfigFile {
     custom_properties?: Record<string, unknown>;
     self_diagnostics?: SelfDiagnosticsConfig;
     app_git?: AppGitFileOptions | false;
+    tools?: unknown[];
 }
 interface RaindropConfig {
     writeKey: string;
@@ -563,6 +590,11 @@ interface RaindropConfig {
     selfDiagnostics?: SelfDiagnosticsConfig;
     /** Application Git identity override. false disables enrichment. */
     appGit?: AppGitOptions | false;
+    /**
+     * Tool catalog recorded as `ai.prompt.tools` on every LLM span. Hooks never
+     * see the model request, so this is the only way to record it.
+     */
+    tools?: PromptToolsOverride;
 }
 /**
  * Load config with precedence (low -> high):
@@ -610,6 +642,7 @@ interface MapperConfig {
     debug: boolean;
     eventName: string;
     customProperties: Record<string, unknown>;
+    tools?: PromptToolsOverride;
 }
 declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, eventShipper: EventShipper, traceShipper: TraceShipper): Promise<void>;
 /**

package/dist/index.d.ts

@@ -506,6 +506,32 @@ declare global {
     var RAINDROP_CONTEXT_MANAGER: (new () => ContextManager) | undefined;
     var RAINDROP_ASYNC_LOCAL_STORAGE: (new <T>() => AsyncLocalStorageLike<T>) | undefined;
 }
+type JsonSchema = Record<string, unknown>;
+type FunctionToolDeclaration = {
+    type: "function";
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+};
+type ProviderDefinedToolDeclaration = {
+    type: "provider-defined";
+    id?: string;
+    name: string;
+    args?: Record<string, unknown>;
+};
+type ToolDeclaration = FunctionToolDeclaration | ProviderDefinedToolDeclaration;
+/**
+ * What callers hand to a `tools` override. The canonical `ToolDeclaration`
+ * shape is accepted as-is; so is any framework shape `normalizeToolDeclarations`
+ * recognizes (OpenAI, Anthropic, Bedrock, LangChain, Pi, Mastra, AI SDK).
+ */
+type ToolDeclarationInput = ToolDeclaration | {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    parameters?: JsonSchema;
+};
+type PromptToolsOverride = ReadonlyArray<ToolDeclarationInput | unknown>;
 
 declare class EventShipper extends EventShipper$1 {
     constructor(opts: ConstructorParameters<typeof EventShipper$1>[0]);
@@ -543,6 +569,7 @@ interface ConfigFile {
     custom_properties?: Record<string, unknown>;
     self_diagnostics?: SelfDiagnosticsConfig;
     app_git?: AppGitFileOptions | false;
+    tools?: unknown[];
 }
 interface RaindropConfig {
     writeKey: string;
@@ -563,6 +590,11 @@ interface RaindropConfig {
     selfDiagnostics?: SelfDiagnosticsConfig;
     /** Application Git identity override. false disables enrichment. */
     appGit?: AppGitOptions | false;
+    /**
+     * Tool catalog recorded as `ai.prompt.tools` on every LLM span. Hooks never
+     * see the model request, so this is the only way to record it.
+     */
+    tools?: PromptToolsOverride;
 }
 /**
  * Load config with precedence (low -> high):
@@ -610,6 +642,7 @@ interface MapperConfig {
     debug: boolean;
     eventName: string;
     customProperties: Record<string, unknown>;
+    tools?: PromptToolsOverride;
 }
 declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, eventShipper: EventShipper, traceShipper: TraceShipper): Promise<void>;
 /**

package/dist/index.js

@@ -60,7 +60,7 @@ function evalScopeAttributes() {
   return { [EVAL_CORRELATION_ID_ATTRIBUTE]: scope.correlationId };
 }
 
-// ../core/dist/chunk-WJOR6M7H.js
+// ../core/dist/chunk-I6TVJQEC.js
 var STATE_KEY = /* @__PURE__ */ Symbol.for("raindrop.tracing.replayTraceRoutingState");
 function state() {
   const holder = globalThis;
@@ -2047,6 +2047,158 @@ var TraceShipper = class {
     }
   }
 };
+var PROMPT_TOOLS_ATTRIBUTE = "ai.prompt.tools";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var JSON_SCHEMA_KEYS = [
+  "type",
+  "properties",
+  "$schema",
+  "$ref",
+  "anyOf",
+  "oneOf",
+  "allOf",
+  "enum",
+  "const",
+  "items",
+  "additionalProperties",
+  "required"
+];
+function isJsonSchema(value) {
+  if (!isRecord(value)) return false;
+  if (typeof value["~standard"] === "object") return false;
+  if (isRecord(value._def) || isRecord(value._zod)) return false;
+  if (Object.keys(value).length === 0) return true;
+  return JSON_SCHEMA_KEYS.some((key) => key in value);
+}
+function toJsonSchema(value, options) {
+  if (value === void 0 || value === null) return void 0;
+  if (isJsonSchema(value)) return value;
+  if (isRecord(value) && isJsonSchema(value.jsonSchema)) return value.jsonSchema;
+  if (isRecord(value) && isJsonSchema(value.json)) return value.json;
+  if (options == null ? void 0 : options.schema) {
+    try {
+      return options.schema(value);
+    } catch (e) {
+      return void 0;
+    }
+  }
+  return void 0;
+}
+function pickString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function functionTool(name, description, schema, options) {
+  const tool = { type: "function", name };
+  const desc = pickString(description);
+  if (desc !== void 0) tool.description = desc;
+  const inputSchema = toJsonSchema(schema, options);
+  if (inputSchema !== void 0) tool.inputSchema = inputSchema;
+  return tool;
+}
+function normalizeToolDeclaration(tool, options, fallbackName) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  if (!isRecord(tool)) return void 0;
+  if (tool.type === "provider-defined" || tool.type === "provider") {
+    const name2 = (_b = (_a = pickString(tool.name)) != null ? _a : pickString(tool.id)) != null ? _b : fallbackName;
+    if (name2 === void 0) return void 0;
+    const declaration = { type: "provider-defined", name: name2 };
+    const id = pickString(tool.id);
+    if (id !== void 0) declaration.id = id;
+    if (isRecord(tool.args)) declaration.args = tool.args;
+    return declaration;
+  }
+  if (isRecord(tool.toolSpec)) {
+    const spec = tool.toolSpec;
+    const name2 = (_c = pickString(spec.name)) != null ? _c : fallbackName;
+    if (name2 === void 0) return void 0;
+    return functionTool(name2, spec.description, spec.inputSchema, options);
+  }
+  if (isRecord(tool.function)) {
+    const fn = tool.function;
+    const name2 = (_d = pickString(fn.name)) != null ? _d : fallbackName;
+    if (name2 === void 0) return void 0;
+    return functionTool(name2, fn.description, (_e = fn.parameters) != null ? _e : fn.input_schema, options);
+  }
+  const name = (_g = (_f = pickString(tool.name)) != null ? _f : pickString(tool.id)) != null ? _g : fallbackName;
+  if (name === void 0) return void 0;
+  const type = pickString(tool.type);
+  if (type !== void 0 && type !== "function" && type !== "dynamic" && type !== "custom") {
+    if (!("input_schema" in tool) && !("inputSchema" in tool) && !("parameters" in tool)) {
+      return { type: "provider-defined", id: type, name };
+    }
+  }
+  return functionTool(
+    name,
+    tool.description,
+    (_j = (_i = (_h = tool.inputSchema) != null ? _h : tool.input_schema) != null ? _i : tool.parameters) != null ? _j : tool.schema,
+    options
+  );
+}
+var NOT_A_GEMINI_GROUP_KEYS = ["name", "id", "type", "function", "toolSpec", "cachePoint"];
+function isGeminiToolGroup(tool) {
+  if (Array.isArray(tool.functionDeclarations)) return true;
+  const keys = Object.keys(tool);
+  if (keys.length === 0 || NOT_A_GEMINI_GROUP_KEYS.some((key) => key in tool)) return false;
+  return keys.every((key) => isRecord(tool[key]));
+}
+function expandGeminiTool(tool, options) {
+  const declarations = [];
+  for (const [key, value] of Object.entries(tool)) {
+    if (key === "functionDeclarations" && Array.isArray(value)) {
+      for (const declaration of value) {
+        const normalized = normalizeToolDeclaration(declaration, options);
+        if (normalized) declarations.push(normalized);
+      }
+    } else if (isRecord(value)) {
+      declarations.push({ type: "provider-defined", id: key, name: key, args: value });
+    }
+  }
+  return declarations;
+}
+function normalizeToolDeclarations(tools, options) {
+  if (tools === void 0 || tools === null) return void 0;
+  if (Array.isArray(tools)) {
+    return tools.flatMap((tool) => {
+      if (isRecord(tool) && isGeminiToolGroup(tool)) {
+        return expandGeminiTool(tool, options);
+      }
+      const declaration = normalizeToolDeclaration(tool, options);
+      return declaration ? [declaration] : [];
+    });
+  }
+  if (!isRecord(tools)) return void 0;
+  return Object.entries(tools).flatMap(([key, tool]) => {
+    const declaration = normalizeToolDeclaration(tool, options, key);
+    return declaration ? [declaration] : [];
+  });
+}
+function resolvePromptTools(args) {
+  var _a;
+  if (args.override !== void 0) {
+    return (_a = normalizeToolDeclarations(args.override, args.options)) != null ? _a : [];
+  }
+  return normalizeToolDeclarations(args.inferred, args.options);
+}
+function promptToolsAttribute(tools) {
+  const values = promptToolsAttributeValue(tools);
+  if (values === void 0) return void 0;
+  return {
+    key: PROMPT_TOOLS_ATTRIBUTE,
+    value: { arrayValue: { values: values.map((stringValue) => ({ stringValue })) } }
+  };
+}
+function promptToolsAttributeValue(tools) {
+  if (tools === void 0) return void 0;
+  return tools.map((tool) => {
+    try {
+      return JSON.stringify(tool);
+    } catch (e) {
+      return JSON.stringify({ type: tool.type, name: tool.name });
+    }
+  });
+}
 
 // ../core/dist/index.node.js
 import { AsyncLocalStorage } from "async_hooks";
@@ -2225,7 +2377,7 @@ installTracingSuppressionHook();
 // package.json
 var package_default = {
   name: "@raindrop-ai/claude-code",
-  version: "0.0.20",
+  version: "0.0.21",
   description: "Raindrop observability for Claude Code CLI \u2014 automatic session, tool call, and prompt tracing via hooks",
   license: "MIT",
   homepage: "https://www.raindrop.ai/docs/integrations/claude-code/",
@@ -2365,6 +2517,15 @@ function loadConfig() {
     } catch (e) {
     }
   }
+  let tools = Array.isArray(file.tools) ? file.tools : void 0;
+  const envTools = process.env["RAINDROP_TOOLS"];
+  if (envTools) {
+    try {
+      const parsed = JSON.parse(envTools);
+      if (Array.isArray(parsed)) tools = parsed;
+    } catch (e) {
+    }
+  }
   let selfDiagnostics = file.self_diagnostics;
   const envDiag = process.env["RAINDROP_SELF_DIAGNOSTICS"];
   if (envDiag) {
@@ -2393,7 +2554,8 @@ function loadConfig() {
     eventName: (_l = (_k = process.env["RAINDROP_EVENT_NAME"]) != null ? _k : file.event_name) != null ? _l : "claude_code_session",
     customProperties,
     selfDiagnostics,
-    appGit: mapAppGit(file.app_git)
+    appGit: mapAppGit(file.app_git),
+    tools
   };
 }
 function mapAppGit(value) {
@@ -3232,7 +3394,7 @@ function isoToNanoString(iso, fallback) {
     return fallback;
   }
 }
-function enrichFromTranscript(payload, eventId, traceShipper) {
+function enrichFromTranscript(payload, eventId, traceShipper, promptTools) {
   var _a, _b, _c, _d;
   if (!payload.transcript_path) {
     return { summary: void 0, props: {} };
@@ -3271,7 +3433,8 @@ function enrichFromTranscript(payload, eventId, traceShipper) {
             attrString("ai.response.text", truncate(outputText)),
             ...toolCallNames ? [attrString("ai.toolCall.names", toolCallNames)] : [],
             ...phase.hasThinking ? [attrString("ai.has_thinking", "true")] : [],
-            attrInt("ai.llm_call.index", emittedPhaseIndex)
+            attrInt("ai.llm_call.index", emittedPhaseIndex),
+            promptTools
           ]
         });
         emittedPhaseIndex++;
@@ -3293,7 +3456,8 @@ function enrichFromTranscript(payload, eventId, traceShipper) {
             attrString("gen_ai.system", "anthropic"),
             attrInt("gen_ai.usage.prompt_tokens", spanInputTokens),
             attrInt("gen_ai.usage.completion_tokens", spanOutputTokens),
-            ...summary.lastTurnCacheReadTokens != null && summary.lastTurnCacheReadTokens > 0 ? [attrInt("gen_ai.usage.cache_read_tokens", summary.lastTurnCacheReadTokens)] : []
+            ...summary.lastTurnCacheReadTokens != null && summary.lastTurnCacheReadTokens > 0 ? [attrInt("gen_ai.usage.cache_read_tokens", summary.lastTurnCacheReadTokens)] : [],
+            promptTools
           ]
         });
       }
@@ -3319,7 +3483,12 @@ function buildStopOutput(summary, lastAssistantMessage) {
   return finalMessage;
 }
 async function handleStopOrFailure(payload, eventId, convoId, config, properties, eventShipper, traceShipper, extraProperties) {
-  const { summary, props: transcriptProps } = enrichFromTranscript(payload, eventId, traceShipper);
+  const { summary, props: transcriptProps } = enrichFromTranscript(
+    payload,
+    eventId,
+    traceShipper,
+    promptToolsAttribute(resolvePromptTools({ override: config.tools }))
+  );
   const instructions = gatherInstructions(payload.session_id);
   const appendSysPrompt = readAppendSystemPrompt(payload.session_id);
   const output = buildStopOutput(summary, payload.last_assistant_message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/claude-code",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "description": "Raindrop observability for Claude Code CLI — automatic session, tool call, and prompt tracing via hooks",
   "license": "MIT",
   "homepage": "https://www.raindrop.ai/docs/integrations/claude-code/",
@@ -53,7 +53,7 @@
     "tsup": "^8.4.0",
     "typescript": "^5.3.3",
     "vitest": "^2.1.0",
-    "@raindrop-ai/core": "0.3.0"
+    "@raindrop-ai/core": "0.3.1"
   },
   "publishConfig": {
     "access": "public"