@reproapp/mcp 0.0.8 → 0.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reproapp/mcp",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "Repro MCP server for AI-assisted debugging and privacy policy workflows",
   "license": "MIT",
   "type": "commonjs",

package/src/index.js

@@ -16,6 +16,8 @@ const SERVER_INSTRUCTIONS = [
   'For Repro-scoped questions about sessions, requests, traces, privacy policies, apps, or configuration, use the Repro MCP tools only.',
   'Do not create local scripts, read cached Repro auth files, or call Repro HTTP APIs directly for Repro data or policy workflows.',
   'For privacy policy writes, inspect first and then use exact statementSid(s) or blockerSetId. Broad natural-language policy update queries are read-only.',
+  'For factual debugging questions, use exact evidence tools first and answer from their structured output. Use investigate only after exact evidence is gathered, or when the user explicitly asks for synthesis/root cause.',
+  'Never answer that captured client data is absent because code appears to omit it. Verify with request, DB, trace, function-call, and message payload tools, then say exactly what Repro captured or did not capture.',
 ].join(' ');
 const DEFAULT_REPRO_AI_BASE_URL = 'https://repro-ai-u8lhw.ondigitalocean.app';
 const DEFAULT_REPRO_API_BASE_URL = 'https://repro-api-d7288.ondigitalocean.app/api';
@@ -193,6 +195,31 @@ const LOCAL_TOOL_DEFINITIONS = [
   },
 ];
 
+const TOOL_DESCRIPTION_OVERRIDES = {
+  investigate:
+    'Synthesize a root-cause hypothesis from Repro evidence after exact telemetry tools have been checked. Do not use this as the first or only tool for factual inventory questions about requests, DB changes, traces, function args/returns, emails, Kafka/RabbitMQ/messages, or payload contents; call the exact evidence tool first and cite that output.',
+  list_requests:
+    'Exact evidence tool: list captured HTTP and backend transport requests in scope. Use this before investigate whenever the user asks what request happened, which endpoint ran, request timing/status, or which request RID anchors later DB/trace/message evidence.',
+  get_request:
+    'Exact evidence tool: fetch one captured request by RID, including request/response bodies and captured value refs when present. Use this before answering factual questions about a specific request payload, response, endpoint, or transport message wrapper.',
+  get_requests_relative_to_anchor:
+    'Exact evidence tool: list captured requests before or after an action/request/DB anchor. Use for ordering questions and localizing the request sequence around a UI action or backend event.',
+  get_db_changes:
+    'Exact evidence tool: fetch captured DB/Redis changes. Use this before answering what collections, documents, fields, queries, mutations, or result metadata changed. Set includeQueryDetails when the user needs query/update/body details.',
+  get_trace:
+    'Exact evidence tool: fetch captured trace batches for a request RID. Use this before answering which functions ran, trace timing, thrown errors, or trace event details for a request.',
+  get_action_path:
+    'Exact evidence tool: fetch the correlated action path with requests, DB changes, and emails/messages when available. Use this to connect a UI action to backend evidence before giving a narrative answer.',
+  get_function_candidates:
+    'Exact evidence tool: find likely captured functions for an action/request/function search. Use this before get_function_calls when the exact function anchor is unclear.',
+  get_function_calls:
+    'Exact evidence tool: fetch concrete captured function calls, arguments, return values, errors, and value refs. Use this before answering what function handled something or what args/returns were captured.',
+  get_kafka_messages:
+    'Exact evidence tool: fetch captured Kafka publish/consume payloads. Use this for messaging questions and payload contents; for exact single-message lookups, the MCP server expands captured large values automatically.',
+  get_captured_value:
+    'Exact evidence tool: fetch the full masked value behind a captured valueId. Use this whenever another tool reports a captured value reference or large_value_available before claiming the payload is unavailable.',
+};
+
 function loadConfig(env = process.env) {
   const baseUrl = normalizeBaseUrl(env.REPRO_AI_BASE_URL || DEFAULT_REPRO_AI_BASE_URL);
   const apiBaseUrl = normalizeOptionalBaseUrl(env.REPRO_API_BASE_URL, DEFAULT_REPRO_API_BASE_URL);
@@ -1141,11 +1168,20 @@ async function handleRpcMessage(message, config, client, getTools) {
 function publicToolDefinition(tool) {
   return {
     name: tool.name,
-    description: tool.description,
+    description: publicToolDescription(tool),
     inputSchema: tool.inputSchema,
   };
 }
 
+function publicToolDescription(tool) {
+  const base = typeof tool?.description === 'string' ? tool.description.trim() : '';
+  const override = TOOL_DESCRIPTION_OVERRIDES[tool?.name];
+  if (!override) {
+    return base;
+  }
+  return base ? `${override} ${base}` : override;
+}
+
 function normalizeToolCatalog(catalog) {
   if (!catalog || typeof catalog !== 'object' || !Array.isArray(catalog.tools)) {
     throw new Error('repro-ai returned an invalid tool catalog');