@spotlightjs/spotlight 4.7.2 → 4.9.0

package/dist/server/mcp/mcp.d.ts

@@ -1,5 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 declare const inputSchema: {
     filters: z.ZodUnion<[z.ZodObject<{
         timeWindow: z.ZodNumber;

package/dist/server/mcp/mcp.js

@@ -2,13 +2,12 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "cfc20e89-a00d-417d-82ac-ae68b723eab0", e._sentryDebugIdIdentifier = "sentry-dbid-cfc20e89-a00d-417d-82ac-ae68b723eab0");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "3c7de392-d41e-443c-bb27-4c82dc28dc16", e._sentryDebugIdIdentifier = "sentry-dbid-3c7de392-d41e-443c-bb27-4c82dc28dc16");
   } catch (e2) {
   }
 }();
-import { McpServer } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.16.0/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js";
+import { McpServer } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.24.3_zod@4.1.13/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js";
 import { wrapMcpServerWithSentry, captureException } from "@sentry/node";
-import { z } from "zod";
 import { formatErrorEnvelope } from "../formatters/md/errors.js";
 import { formatLogEnvelope } from "../formatters/md/logs.js";
 import { extractTracesFromEnvelopes, formatTraceSummary, buildSpanTree, renderSpanTree } from "../formatters/md/traces.js";
@@ -16,20 +15,22 @@ import { getBuffer } from "../utils/getBuffer.js";
 import "../parser/helpers.js";
 import "uuidv7";
 import "../../_virtual/_sentry-release-injection-file.js";
+import "node:child_process";
 import "node:http";
 import "node:dns/promises";
 import "node:net";
 import "node:os";
 import { NO_ERRORS_CONTENT, NO_LOGS_CONTENT } from "./constants.js";
+import { union as unionType, object as objectType, number as numberType, string as stringType } from "../../node_modules/.pnpm/zod@4.1.13/node_modules/zod/v3/types.js";
 const inputSchema = {
-  filters: z.union([
-    z.object({
-      timeWindow: z.number().describe(
+  filters: unionType([
+    objectType({
+      timeWindow: numberType().describe(
         "Number of seconds to look back from now. Examples: 60 = last minute, 300 = last 5 minutes, 3600 = last hour. Default: 60"
       )
     }),
-    z.object({
-      filename: z.string().describe(
+    objectType({
+      filename: stringType().describe(
         "Exact filename to search in stack traces or logs. Examples: 'Button.tsx', 'auth.js', 'api/routes.ts'. Case-sensitive."
       )
     }),
@@ -40,9 +41,9 @@ const inputSchema = {
      *
      * https://github.com/getsentry/spotlight/pull/968#discussion_r2391587907
      */
-    z.object({
-      limit: z.number().describe("Maximum number of results to return. Examples: 10, 20, 50. Default: no limit"),
-      offset: z.number().default(0).describe(
+    objectType({
+      limit: numberType().describe("Maximum number of results to return. Examples: 10, 20, 50. Default: no limit"),
+      offset: numberType().default(0).describe(
         "Number of results to skip from the beginning. Examples: 0 = start from first, 10 = skip first 10. Default: 0"
       )
     }).optional().describe("Pagination: Use when timeWindow doesn't work or for browsing through many results")
@@ -58,7 +59,7 @@ function createMCPInstance() {
   const mcp = wrapMcpServerWithSentry(
     new McpServer({
       name: "spotlight-mcp",
-      version: String("4.7.2")
+      version: String("4.9.0")
     })
   );
   mcp.registerTool(
@@ -357,7 +358,7 @@ get_traces({ traceId: "71a8c5e41ae1044dee67f50a07538fe7" })
   - Or full 32-character hex string
   - Case-insensitive`,
       inputSchema: {
-        traceId: z.string().describe(
+        traceId: stringType().describe(
           "Trace ID to retrieve. Format: 8 or 32 hex characters. Examples: '71a8c5e4' or '71a8c5e41ae1044dee67f50a07538fe7'"
         )
       }

package/dist/server/mcp/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sources":["../../../src/server/mcp/mcp.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { TextContent } from \"@modelcontextprotocol/sdk/types.js\";\nimport { captureException, wrapMcpServerWithSentry } from \"@sentry/node\";\nimport { z } from \"zod\";\nimport { formatErrorEnvelope } from \"../formatters/md/errors.ts\";\nimport { formatLogEnvelope } from \"../formatters/md/logs.ts\";\nimport {\n  buildSpanTree,\n  extractTracesFromEnvelopes,\n  formatTraceSummary,\n  renderSpanTree,\n} from \"../formatters/md/traces.ts\";\nimport { getBuffer } from \"../utils/index.ts\";\nimport { NO_ERRORS_CONTENT, NO_LOGS_CONTENT } from \"./constants.ts\";\n\nconst inputSchema = {\n  filters: z.union([\n    z.object({\n      timeWindow: z\n        .number()\n        .describe(\n          \"Number of seconds to look back from now. Examples: 60 = last minute, 300 = last 5 minutes, 3600 = last hour. Default: 60\",\n        ),\n    }),\n    z.object({\n      filename: z\n        .string()\n        .describe(\n          \"Exact filename to search in stack traces or logs. Examples: 'Button.tsx', 'auth.js', 'api/routes.ts'. Case-sensitive.\",\n        ),\n    }),\n    /**\n     * TODO: Need to check, if this approach is better then a cursor based approach,\n     * where the user can pass `events since [event_id]` as \"last N events\" is a\n     * moving target as events keep coming in.\n     *\n     * https://github.com/getsentry/spotlight/pull/968#discussion_r2391587907\n     */\n    z\n      .object({\n        limit: z.number().describe(\"Maximum number of results to return. Examples: 10, 20, 50. Default: no limit\"),\n        offset: z\n          .number()\n          .default(0)\n          .describe(\n            \"Number of results to skip from the beginning. Examples: 0 = start from first, 10 = skip first 10. Default: 0\",\n          ),\n      })\n      .optional()\n      .describe(\"Pagination: Use when timeWindow doesn't work or for browsing through many results\"),\n  ]),\n};\n\nexport type InputSchema = { [K in keyof typeof inputSchema]: z.infer<(typeof inputSchema)[K]> };\n\nfunction applyPagination<T>(envelopes: T[], pagination: InputSchema[\"filters\"]) {\n  if (pagination == null || !(\"limit\" in pagination)) {\n    return envelopes;\n  }\n\n  return envelopes.slice(pagination.offset, pagination.offset + pagination.limit);\n}\n\nexport function createMCPInstance() {\n  const mcp = wrapMcpServerWithSentry(\n    new McpServer({\n      name: \"spotlight-mcp\",\n      version: String(process.env.npm_package_version),\n    }),\n  );\n\n  mcp.registerTool(\n    \"search_errors\",\n    {\n      title: \"Search Application Errors\",\n      description: `**Purpose:** Search for runtime errors, exceptions, and crashes captured by Spotlight across your entire application stack.\n\n**CRITICAL: Call this tool IMMEDIATELY when:**\n- User says \"error\", \"broken\", \"not working\", \"failing\", \"crash\", \"bug\", \"issue\"\n- You encounter errors during testing or code execution\n- Before and after making code changes to verify no regressions\n- Investigating any unexpected behavior or performance problems\n- Error messages and exception details\n- Request/response context for API failures\n- Browser/device info when available\n\n**Returns:**\n• Full stack traces with exact file:line locations\n\n**When to use:**\n- User reports \"error\", \"broken\", \"not working\", \"crash\", \"bug\"\n- After code changes to verify no regressions\n- Investigating unexpected behavior or failures\n- Debugging specific file errors\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Check last minute for any errors\nsearch_errors({ filters: { timeWindow: 60 } })\n\n// Example 2: Find errors in specific file\nsearch_errors({ filters: { filename: \"auth.tsx\" } })\n\n// Example 3: Get last 10 errors with pagination\nsearch_errors({ filters: { limit: 10, offset: 0 } })\n\\`\\`\\`\n\n**Parameter hints:**\n• filters.timeWindow: Seconds to look back (60 = 1 min, 300 = 5 min, 3600 = 1 hour)\n• filters.filename: Exact filename in stack trace (e.g., \"Button.tsx\", \"api.js\")\n• filters.limit/offset: For pagination through many errors`,\n      inputSchema,\n    },\n    async args => {\n      const envelopes = getBuffer().read(args.filters);\n\n      if (envelopes.length === 0) {\n        return NO_ERRORS_CONTENT;\n      }\n\n      const content: TextContent[] = [];\n      for (const envelope of envelopes) {\n        try {\n          const events = await formatErrorEnvelope(envelope);\n\n          if (events?.length) {\n            for (const event of events) {\n              content.push({\n                type: \"text\",\n                text: event,\n              });\n            }\n          }\n        } catch (err) {\n          captureException(err, { extra: { context: \"Error formatting error envelope in MCP\" } });\n        }\n      }\n\n      if (content.length === 0) {\n        return NO_ERRORS_CONTENT;\n      }\n\n      return {\n        content: applyPagination(content, args.filters),\n      };\n    },\n  );\n\n  mcp.registerTool(\n    \"search_logs\",\n    {\n      title: \"Search Application Logs\",\n      description: `**Purpose:** Search for application logs to understand behavior, debug issues, and trace execution flow across your stack.\n\n**NOT for:** Error diagnostics (use search_errors for exceptions/crashes). This tool is for info, warn, debug, and trace messages.\n\n**Returns:**\n• Timestamped log entries with severity levels (info, warn, debug)\n• Custom application messages and debug output\n• API request/response logs with timing\n• Database query logs and performance metrics\n\n**When to use:**\n- Understanding application flow and behavior\n- User mentions \"logs\", \"debugging\", \"trace\"\n- Checking what the app is doing internally\n- Performance investigation and timing analysis\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Check last 5 minutes of logs\nsearch_logs({ filters: { timeWindow: 300 } })\n\n// Example 2: Find logs from specific file\nsearch_logs({ filters: { filename: \"auth.ts\" } })\n\n// Example 3: Get recent 20 log entries\nsearch_logs({ filters: { limit: 20, offset: 0 } })\n\\`\\`\\`\n\n## Workflow Pattern:\n1. User reports behavior question → **Call search_logs** \n2. User tests new feature → **Check logs for expected output**\n3. Performance concerns → **Look for timing patterns in logs**\n4. Debugging complex flows → **Trace execution through log timeline**\n5. **Use with search_errors** for complete debugging picture\n\n**Key trigger phrases:**\n- \"How does X work?\" → See runtime execution flow\n- \"Is the app doing Y?\" → Check for specific log patterns  \n- \"Performance seems off\" → Look for timing/resource logs\n- \"Debug this feature\" → Follow execution path through logs\n- \"What's happening when...\" → Real-time application behavior\n\n**Log Levels Available:**\n- **INFO**: General application flow and significant events\n- **WARN**: Potential issues that don't break functionality  \n- **DEBUG**: Detailed execution information for troubleshooting\n- **ERROR**: Actual failures (also available via search_errors)\n\n**Remember:** Logs show you what your application is actually doing, not just what the code says it should do. Use this for understanding real runtime behavior, performance patterns, and verifying that features work as intended.\n\n**Parameter hints:**\n• filters.timeWindow: Seconds to look back (60 = 1 min, 300 = 5 min, 3600 = 1 hour) \n• filters.filename: Exact filename generating logs (e.g., \"api.ts\", \"database.js\")\n• filters.limit/offset: For pagination through many log entries`,\n      inputSchema,\n    },\n    async args => {\n      const envelopes = getBuffer().read(args.filters);\n\n      if (envelopes.length === 0) {\n        return NO_LOGS_CONTENT;\n      }\n\n      const content: TextContent[] = [];\n      for (const envelope of envelopes) {\n        try {\n          const events = await formatLogEnvelope(envelope);\n\n          if (events?.length) {\n            for (const event of events) {\n              content.push({\n                type: \"text\",\n                text: event,\n              });\n            }\n          }\n        } catch (err) {\n          captureException(err, { extra: { context: \"Error formatting log envelope in MCP\" } });\n        }\n      }\n\n      if (content.length === 0) {\n        return NO_LOGS_CONTENT;\n      }\n\n      return {\n        content: applyPagination(content, args.filters),\n      };\n    },\n  );\n\n  mcp.registerTool(\n    \"search_traces\",\n    {\n      title: \"Search Performance Traces\",\n      description: `**Purpose:** Search for performance traces to identify slow requests, bottlenecks, and transaction patterns across your application.\n\n**USE THIS TOOL WHEN:**\n- Investigating application performance and request flows\n- User mentions \"traces\", \"performance\", \"slow requests\", \"tracing\"\n- Looking for distributed tracing data or transaction flows\n- Need to see high-level trace patterns before diving into details\n\n**Returns:**\n• List of traces with IDs, durations, and span counts\n• Root transaction names and total execution time\n• Error counts per trace for quick identification\n• Trace start timestamps for timeline analysis\n\n**When to use:**\n- Investigating performance issues or slow requests\n- User mentions \"traces\", \"performance\", \"slow\"\n- Finding specific transactions or requests\n- Overview of recent application activity\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Get traces from last 5 minutes\nsearch_traces({ filters: { timeWindow: 300 } })\n\n// Example 2: Get 10 most recent traces\nsearch_traces({ filters: { limit: 10, offset: 0 } })\n\n// Example 3: Find traces involving specific file\nsearch_traces({ filters: { filename: \"api.ts\" } })\n\\`\\`\\`\n\n**Parameter hints:**\n• filters.timeWindow: Seconds to look back (60 = 1 min, 300 = 5 min)\n• filters.limit: Number of traces to return (e.g., 10, 20)\n• filters.offset: Skip first N traces for pagination\n**Key trigger phrases:**\n- \"Show me recent traces\" → Get trace overview\n- \"Performance issues\" → Look for slow traces\n- \"Request flows\" → See transaction patterns\n- \"Distributed tracing\" → View trace summaries\n\n**Next step:** Use get_traces with a trace ID to see detailed span breakdown`,\n      inputSchema,\n    },\n    async args => {\n      const envelopes = getBuffer().read(args.filters);\n\n      if (envelopes.length === 0) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: \"No traces found in the specified time period. Make sure your application is instrumented with Sentry performance monitoring and try triggering some requests or transactions.\",\n            },\n          ],\n        };\n      }\n\n      const traces = extractTracesFromEnvelopes(envelopes);\n\n      if (traces.size === 0) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: \"No traces with trace context found. Ensure your Sentry SDK has performance monitoring enabled and is generating transaction events.\",\n            },\n          ],\n        };\n      }\n\n      let content: TextContent[] = [];\n\n      // Sort traces by start time (most recent first)\n      const sortedTraces = Array.from(traces.values()).sort(\n        (a, b) => (b.start_timestamp || 0) - (a.start_timestamp || 0),\n      );\n\n      content.push({\n        type: \"text\",\n        text: `# Local Traces (${sortedTraces.length} found)\\n\\nRecent traces from your application:\\n`,\n      });\n\n      for (const trace of sortedTraces.slice(0, 20)) {\n        // Limit to 20 most recent\n        content.push({\n          type: \"text\",\n          text: formatTraceSummary(trace),\n        });\n      }\n\n      content = applyPagination(content, args.filters);\n\n      content.push({\n        type: \"text\",\n        text: \"\\n**Next Steps:**\\nUse `get_traces` with a trace ID (e.g., first 8 characters shown above) to see the full span tree and detailed timing breakdown for any specific trace.\",\n      });\n\n      return { content };\n    },\n  );\n\n  mcp.registerTool(\n    \"get_traces\",\n    {\n      title: \"Get Trace Details\",\n      description: `**Purpose:** Get the complete span tree and timing breakdown for a specific trace ID to analyze performance bottlenecks.\n\n**USE THIS TOOL WHEN:**\n- User provides a specific trace ID from \\`search_traces\\`\n- Want to see detailed span hierarchy and timing for a trace\n- Investigating performance bottlenecks within a specific request flow\n- Need to understand the complete execution path of a transaction\n\n**Returns:**\n• Hierarchical span tree with parent-child relationships\n• Individual span durations and operation names\n• Database queries, API calls, and render timings\n• Error details if spans failed\n\n**When to use:**\n- After finding a trace ID with search_traces\n- Investigating specific slow request or transaction\n- Understanding detailed execution flow\n- Finding performance bottlenecks in a trace\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Get trace using short ID (first 8 chars)\nget_traces({ traceId: \"71a8c5e4\" })\n\n// Example 2: Get trace using full 32-char ID\nget_traces({ traceId: \"71a8c5e41ae1044dee67f50a07538fe7\" })\n\\`\\`\\`\n\n**Parameter hints:**\n• traceId: Trace identifier from search_traces\n  - Can use first 8 characters (e.g., \"71a8c5e4\")\n  - Or full 32-character hex string\n  - Case-insensitive`,\n      inputSchema: {\n        traceId: z\n          .string()\n          .describe(\n            \"Trace ID to retrieve. Format: 8 or 32 hex characters. Examples: '71a8c5e4' or '71a8c5e41ae1044dee67f50a07538fe7'\",\n          ),\n      },\n    },\n    async args => {\n      // Getting all the envelopes\n      const envelopes = getBuffer().read({ all: true });\n      const traces = extractTracesFromEnvelopes(envelopes);\n\n      // Find trace by full ID or partial ID match\n      let targetTrace = traces.get(args.traceId);\n\n      if (!targetTrace && args.traceId.length < 32) {\n        // Try to find by partial ID\n        for (const [traceId, trace] of traces) {\n          if (traceId.startsWith(args.traceId)) {\n            targetTrace = trace;\n            break;\n          }\n        }\n      }\n\n      if (!targetTrace) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `Trace \\`${args.traceId}\\` not found. Use \\`search_traces\\` to see available traces, or try expanding the time window if the trace is older.`,\n            },\n          ],\n        };\n      }\n\n      const spanTree = buildSpanTree(targetTrace);\n\n      // Just render the full span tree\n      const treeLines = renderSpanTree(spanTree);\n\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: treeLines.join(\"\\n\"),\n          },\n        ],\n      };\n    },\n  );\n\n  return mcp;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sources":["../../../src/server/mcp/mcp.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { TextContent } from \"@modelcontextprotocol/sdk/types.js\";\nimport { captureException, wrapMcpServerWithSentry } from \"@sentry/node\";\nimport { z } from \"zod/v3\";\nimport { formatErrorEnvelope } from \"../formatters/md/errors.ts\";\nimport { formatLogEnvelope } from \"../formatters/md/logs.ts\";\nimport {\n  buildSpanTree,\n  extractTracesFromEnvelopes,\n  formatTraceSummary,\n  renderSpanTree,\n} from \"../formatters/md/traces.ts\";\nimport { getBuffer } from \"../utils/index.ts\";\nimport { NO_ERRORS_CONTENT, NO_LOGS_CONTENT } from \"./constants.ts\";\n\nconst inputSchema = {\n  filters: z.union([\n    z.object({\n      timeWindow: z\n        .number()\n        .describe(\n          \"Number of seconds to look back from now. Examples: 60 = last minute, 300 = last 5 minutes, 3600 = last hour. Default: 60\",\n        ),\n    }),\n    z.object({\n      filename: z\n        .string()\n        .describe(\n          \"Exact filename to search in stack traces or logs. Examples: 'Button.tsx', 'auth.js', 'api/routes.ts'. Case-sensitive.\",\n        ),\n    }),\n    /**\n     * TODO: Need to check, if this approach is better then a cursor based approach,\n     * where the user can pass `events since [event_id]` as \"last N events\" is a\n     * moving target as events keep coming in.\n     *\n     * https://github.com/getsentry/spotlight/pull/968#discussion_r2391587907\n     */\n    z\n      .object({\n        limit: z.number().describe(\"Maximum number of results to return. Examples: 10, 20, 50. Default: no limit\"),\n        offset: z\n          .number()\n          .default(0)\n          .describe(\n            \"Number of results to skip from the beginning. Examples: 0 = start from first, 10 = skip first 10. Default: 0\",\n          ),\n      })\n      .optional()\n      .describe(\"Pagination: Use when timeWindow doesn't work or for browsing through many results\"),\n  ]),\n};\n\nexport type InputSchema = { [K in keyof typeof inputSchema]: z.infer<(typeof inputSchema)[K]> };\n\nfunction applyPagination<T>(envelopes: T[], pagination: InputSchema[\"filters\"]) {\n  if (pagination == null || !(\"limit\" in pagination)) {\n    return envelopes;\n  }\n\n  return envelopes.slice(pagination.offset, pagination.offset + pagination.limit);\n}\n\nexport function createMCPInstance() {\n  const mcp = wrapMcpServerWithSentry(\n    new McpServer({\n      name: \"spotlight-mcp\",\n      version: String(process.env.npm_package_version),\n    }),\n  );\n\n  mcp.registerTool(\n    \"search_errors\",\n    {\n      title: \"Search Application Errors\",\n      description: `**Purpose:** Search for runtime errors, exceptions, and crashes captured by Spotlight across your entire application stack.\n\n**CRITICAL: Call this tool IMMEDIATELY when:**\n- User says \"error\", \"broken\", \"not working\", \"failing\", \"crash\", \"bug\", \"issue\"\n- You encounter errors during testing or code execution\n- Before and after making code changes to verify no regressions\n- Investigating any unexpected behavior or performance problems\n- Error messages and exception details\n- Request/response context for API failures\n- Browser/device info when available\n\n**Returns:**\n• Full stack traces with exact file:line locations\n\n**When to use:**\n- User reports \"error\", \"broken\", \"not working\", \"crash\", \"bug\"\n- After code changes to verify no regressions\n- Investigating unexpected behavior or failures\n- Debugging specific file errors\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Check last minute for any errors\nsearch_errors({ filters: { timeWindow: 60 } })\n\n// Example 2: Find errors in specific file\nsearch_errors({ filters: { filename: \"auth.tsx\" } })\n\n// Example 3: Get last 10 errors with pagination\nsearch_errors({ filters: { limit: 10, offset: 0 } })\n\\`\\`\\`\n\n**Parameter hints:**\n• filters.timeWindow: Seconds to look back (60 = 1 min, 300 = 5 min, 3600 = 1 hour)\n• filters.filename: Exact filename in stack trace (e.g., \"Button.tsx\", \"api.js\")\n• filters.limit/offset: For pagination through many errors`,\n      inputSchema,\n    },\n    async args => {\n      const envelopes = getBuffer().read(args.filters);\n\n      if (envelopes.length === 0) {\n        return NO_ERRORS_CONTENT;\n      }\n\n      const content: TextContent[] = [];\n      for (const envelope of envelopes) {\n        try {\n          const events = await formatErrorEnvelope(envelope);\n\n          if (events?.length) {\n            for (const event of events) {\n              content.push({\n                type: \"text\",\n                text: event,\n              });\n            }\n          }\n        } catch (err) {\n          captureException(err, { extra: { context: \"Error formatting error envelope in MCP\" } });\n        }\n      }\n\n      if (content.length === 0) {\n        return NO_ERRORS_CONTENT;\n      }\n\n      return {\n        content: applyPagination(content, args.filters),\n      };\n    },\n  );\n\n  mcp.registerTool(\n    \"search_logs\",\n    {\n      title: \"Search Application Logs\",\n      description: `**Purpose:** Search for application logs to understand behavior, debug issues, and trace execution flow across your stack.\n\n**NOT for:** Error diagnostics (use search_errors for exceptions/crashes). This tool is for info, warn, debug, and trace messages.\n\n**Returns:**\n• Timestamped log entries with severity levels (info, warn, debug)\n• Custom application messages and debug output\n• API request/response logs with timing\n• Database query logs and performance metrics\n\n**When to use:**\n- Understanding application flow and behavior\n- User mentions \"logs\", \"debugging\", \"trace\"\n- Checking what the app is doing internally\n- Performance investigation and timing analysis\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Check last 5 minutes of logs\nsearch_logs({ filters: { timeWindow: 300 } })\n\n// Example 2: Find logs from specific file\nsearch_logs({ filters: { filename: \"auth.ts\" } })\n\n// Example 3: Get recent 20 log entries\nsearch_logs({ filters: { limit: 20, offset: 0 } })\n\\`\\`\\`\n\n## Workflow Pattern:\n1. User reports behavior question → **Call search_logs** \n2. User tests new feature → **Check logs for expected output**\n3. Performance concerns → **Look for timing patterns in logs**\n4. Debugging complex flows → **Trace execution through log timeline**\n5. **Use with search_errors** for complete debugging picture\n\n**Key trigger phrases:**\n- \"How does X work?\" → See runtime execution flow\n- \"Is the app doing Y?\" → Check for specific log patterns  \n- \"Performance seems off\" → Look for timing/resource logs\n- \"Debug this feature\" → Follow execution path through logs\n- \"What's happening when...\" → Real-time application behavior\n\n**Log Levels Available:**\n- **INFO**: General application flow and significant events\n- **WARN**: Potential issues that don't break functionality  \n- **DEBUG**: Detailed execution information for troubleshooting\n- **ERROR**: Actual failures (also available via search_errors)\n\n**Remember:** Logs show you what your application is actually doing, not just what the code says it should do. Use this for understanding real runtime behavior, performance patterns, and verifying that features work as intended.\n\n**Parameter hints:**\n• filters.timeWindow: Seconds to look back (60 = 1 min, 300 = 5 min, 3600 = 1 hour) \n• filters.filename: Exact filename generating logs (e.g., \"api.ts\", \"database.js\")\n• filters.limit/offset: For pagination through many log entries`,\n      inputSchema,\n    },\n    async args => {\n      const envelopes = getBuffer().read(args.filters);\n\n      if (envelopes.length === 0) {\n        return NO_LOGS_CONTENT;\n      }\n\n      const content: TextContent[] = [];\n      for (const envelope of envelopes) {\n        try {\n          const events = await formatLogEnvelope(envelope);\n\n          if (events?.length) {\n            for (const event of events) {\n              content.push({\n                type: \"text\",\n                text: event,\n              });\n            }\n          }\n        } catch (err) {\n          captureException(err, { extra: { context: \"Error formatting log envelope in MCP\" } });\n        }\n      }\n\n      if (content.length === 0) {\n        return NO_LOGS_CONTENT;\n      }\n\n      return {\n        content: applyPagination(content, args.filters),\n      };\n    },\n  );\n\n  mcp.registerTool(\n    \"search_traces\",\n    {\n      title: \"Search Performance Traces\",\n      description: `**Purpose:** Search for performance traces to identify slow requests, bottlenecks, and transaction patterns across your application.\n\n**USE THIS TOOL WHEN:**\n- Investigating application performance and request flows\n- User mentions \"traces\", \"performance\", \"slow requests\", \"tracing\"\n- Looking for distributed tracing data or transaction flows\n- Need to see high-level trace patterns before diving into details\n\n**Returns:**\n• List of traces with IDs, durations, and span counts\n• Root transaction names and total execution time\n• Error counts per trace for quick identification\n• Trace start timestamps for timeline analysis\n\n**When to use:**\n- Investigating performance issues or slow requests\n- User mentions \"traces\", \"performance\", \"slow\"\n- Finding specific transactions or requests\n- Overview of recent application activity\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Get traces from last 5 minutes\nsearch_traces({ filters: { timeWindow: 300 } })\n\n// Example 2: Get 10 most recent traces\nsearch_traces({ filters: { limit: 10, offset: 0 } })\n\n// Example 3: Find traces involving specific file\nsearch_traces({ filters: { filename: \"api.ts\" } })\n\\`\\`\\`\n\n**Parameter hints:**\n• filters.timeWindow: Seconds to look back (60 = 1 min, 300 = 5 min)\n• filters.limit: Number of traces to return (e.g., 10, 20)\n• filters.offset: Skip first N traces for pagination\n**Key trigger phrases:**\n- \"Show me recent traces\" → Get trace overview\n- \"Performance issues\" → Look for slow traces\n- \"Request flows\" → See transaction patterns\n- \"Distributed tracing\" → View trace summaries\n\n**Next step:** Use get_traces with a trace ID to see detailed span breakdown`,\n      inputSchema,\n    },\n    async args => {\n      const envelopes = getBuffer().read(args.filters);\n\n      if (envelopes.length === 0) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: \"No traces found in the specified time period. Make sure your application is instrumented with Sentry performance monitoring and try triggering some requests or transactions.\",\n            },\n          ],\n        };\n      }\n\n      const traces = extractTracesFromEnvelopes(envelopes);\n\n      if (traces.size === 0) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: \"No traces with trace context found. Ensure your Sentry SDK has performance monitoring enabled and is generating transaction events.\",\n            },\n          ],\n        };\n      }\n\n      let content: TextContent[] = [];\n\n      // Sort traces by start time (most recent first)\n      const sortedTraces = Array.from(traces.values()).sort(\n        (a, b) => (b.start_timestamp || 0) - (a.start_timestamp || 0),\n      );\n\n      content.push({\n        type: \"text\",\n        text: `# Local Traces (${sortedTraces.length} found)\\n\\nRecent traces from your application:\\n`,\n      });\n\n      for (const trace of sortedTraces.slice(0, 20)) {\n        // Limit to 20 most recent\n        content.push({\n          type: \"text\",\n          text: formatTraceSummary(trace),\n        });\n      }\n\n      content = applyPagination(content, args.filters);\n\n      content.push({\n        type: \"text\",\n        text: \"\\n**Next Steps:**\\nUse `get_traces` with a trace ID (e.g., first 8 characters shown above) to see the full span tree and detailed timing breakdown for any specific trace.\",\n      });\n\n      return { content };\n    },\n  );\n\n  mcp.registerTool(\n    \"get_traces\",\n    {\n      title: \"Get Trace Details\",\n      description: `**Purpose:** Get the complete span tree and timing breakdown for a specific trace ID to analyze performance bottlenecks.\n\n**USE THIS TOOL WHEN:**\n- User provides a specific trace ID from \\`search_traces\\`\n- Want to see detailed span hierarchy and timing for a trace\n- Investigating performance bottlenecks within a specific request flow\n- Need to understand the complete execution path of a transaction\n\n**Returns:**\n• Hierarchical span tree with parent-child relationships\n• Individual span durations and operation names\n• Database queries, API calls, and render timings\n• Error details if spans failed\n\n**When to use:**\n- After finding a trace ID with search_traces\n- Investigating specific slow request or transaction\n- Understanding detailed execution flow\n- Finding performance bottlenecks in a trace\n\n**Example calls:**\n\\`\\`\\`json\n// Example 1: Get trace using short ID (first 8 chars)\nget_traces({ traceId: \"71a8c5e4\" })\n\n// Example 2: Get trace using full 32-char ID\nget_traces({ traceId: \"71a8c5e41ae1044dee67f50a07538fe7\" })\n\\`\\`\\`\n\n**Parameter hints:**\n• traceId: Trace identifier from search_traces\n  - Can use first 8 characters (e.g., \"71a8c5e4\")\n  - Or full 32-character hex string\n  - Case-insensitive`,\n      inputSchema: {\n        traceId: z\n          .string()\n          .describe(\n            \"Trace ID to retrieve. Format: 8 or 32 hex characters. Examples: '71a8c5e4' or '71a8c5e41ae1044dee67f50a07538fe7'\",\n          ),\n      },\n    },\n    async args => {\n      // Getting all the envelopes\n      const envelopes = getBuffer().read({ all: true });\n      const traces = extractTracesFromEnvelopes(envelopes);\n\n      // Find trace by full ID or partial ID match\n      let targetTrace = traces.get(args.traceId);\n\n      if (!targetTrace && args.traceId.length < 32) {\n        // Try to find by partial ID\n        for (const [traceId, trace] of traces) {\n          if (traceId.startsWith(args.traceId)) {\n            targetTrace = trace;\n            break;\n          }\n        }\n      }\n\n      if (!targetTrace) {\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: `Trace \\`${args.traceId}\\` not found. Use \\`search_traces\\` to see available traces, or try expanding the time window if the trace is older.`,\n            },\n          ],\n        };\n      }\n\n      const spanTree = buildSpanTree(targetTrace);\n\n      // Just render the full span tree\n      const treeLines = renderSpanTree(spanTree);\n\n      return {\n        content: [\n          {\n            type: \"text\",\n            text: treeLines.join(\"\\n\"),\n          },\n        ],\n      };\n    },\n  );\n\n  return mcp;\n}\n"],"names":["z.union","z.object","z.number","z.string"],"mappings":"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"}

package/dist/server/parser/types.d.ts

@@ -185,6 +185,52 @@ export type SentryProfileV1Event = CommonEventAttrs & {
     version: "1";
     profile: SentryProfile;
 };
+export type ProfileV2Sample = {
+    timestamp: number;
+    stack_id: number;
+    thread_id: string;
+};
+export type ProfileV2MeasurementValue = {
+    timestamp: number;
+    value: number;
+};
+export type ProfileV2Measurement = {
+    unit: string;
+    values: ProfileV2MeasurementValue[];
+};
+export type SentryProfileV2 = {
+    samples: ProfileV2Sample[];
+    stacks: number[][];
+    frames: EventFrame[];
+    thread_metadata: Record<string, {
+        name?: string;
+        priority?: number;
+    }>;
+};
+export type SentryProfileV2ChunkEvent = {
+    type: "profile_chunk";
+    version: "2";
+    profiler_id: string;
+    chunk_id: string;
+    platform: string;
+    release?: string;
+    environment?: string;
+    client_sdk?: {
+        name: string;
+        version: string;
+    };
+    debug_meta?: {
+        images?: Array<{
+            debug_id?: string;
+            image_addr?: string;
+            type?: string;
+            image_size?: number;
+            code_file?: string;
+        }>;
+    };
+    measurements?: Record<string, ProfileV2Measurement>;
+    profile: SentryProfileV2;
+};
 export type SentryLogEventItem = SerializedLog & {
     id: string;
     severity_number: number;
@@ -194,5 +240,5 @@ export type SentryLogEvent = CommonEventAttrs & {
     type: "log";
     items: Array<SentryLogEventItem>;
 };
-export type SentryEvent = SentryErrorEvent | SentryTransactionEvent | SentryProfileV1Event | SentryLogEvent;
+export type SentryEvent = SentryErrorEvent | SentryTransactionEvent | SentryProfileV1Event | SentryProfileV2ChunkEvent | SentryLogEvent;
 export {};

package/dist/server/routes/clear.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "df2b59d9-0e2c-4abe-8147-c0e94d351512", e._sentryDebugIdIdentifier = "sentry-dbid-df2b59d9-0e2c-4abe-8147-c0e94d351512");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "7d53e322-d26b-40ad-870a-31ce2368a1b1", e._sentryDebugIdIdentifier = "sentry-dbid-7d53e322-d26b-40ad-870a-31ce2368a1b1");
   } catch (e2) {
   }
 }();
@@ -11,6 +11,7 @@ import { getBuffer } from "../utils/getBuffer.js";
 import "../parser/helpers.js";
 import "uuidv7";
 import "../../_virtual/_sentry-release-injection-file.js";
+import "node:child_process";
 import "node:http";
 import "@sentry/node";
 import "node:dns/promises";

package/dist/server/routes/clear.js.map

@@ -1 +1 @@
-{"version":3,"file":"clear.js","sources":["../../../src/server/routes/clear.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport { getBuffer } from \"../utils/index.ts\";\n\nconst router = new Hono();\n\nrouter.delete(\"/\", ctx => {\n  getBuffer().clear();\n  return ctx.text(\"Cleared\");\n});\n\nexport default router;\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAGA,MAAM,SAAS,IAAI,KAAA;AAEnB,OAAO,OAAO,KAAK,CAAA,QAAO;AACxB,YAAA,EAAY,MAAA;AACZ,SAAO,IAAI,KAAK,SAAS;AAC3B,CAAC;"}
+{"version":3,"file":"clear.js","sources":["../../../src/server/routes/clear.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport { getBuffer } from \"../utils/index.ts\";\n\nconst router = new Hono();\n\nrouter.delete(\"/\", ctx => {\n  getBuffer().clear();\n  return ctx.text(\"Cleared\");\n});\n\nexport default router;\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAGA,MAAM,SAAS,IAAI,KAAA;AAEnB,OAAO,OAAO,KAAK,CAAA,QAAO;AACxB,YAAA,EAAY,MAAA;AACZ,SAAO,IAAI,KAAK,SAAS;AAC3B,CAAC;"}

package/dist/server/routes/stream/index.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c8123de6-5e77-41da-8100-10d99b558d5f", e._sentryDebugIdIdentifier = "sentry-dbid-c8123de6-5e77-41da-8100-10d99b558d5f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "2e7449de-b7a2-4372-aa0d-d7b00927a5fa", e._sentryDebugIdIdentifier = "sentry-dbid-2e7449de-b7a2-4372-aa0d-d7b00927a5fa");
   } catch (e2) {
   }
 }();
@@ -15,6 +15,7 @@ import { getBuffer } from "../../utils/getBuffer.js";
 import "../../parser/helpers.js";
 import "uuidv7";
 import "../../../_virtual/_sentry-release-injection-file.js";
+import "node:child_process";
 import "node:http";
 import "@sentry/node";
 import "node:dns/promises";
@@ -64,7 +65,7 @@ const router = new Hono().get("/stream", (ctx) => {
     "Content-Disposition": `attachment; filename="${envelopeId}.bin"`,
     Connection: "keep-alive"
   });
-}).on("POST", ["/stream", "/api/:id/envelope"], async (ctx) => {
+}).on("POST", ["/stream", "/api/:id/envelope", "/api/:id/envelope/"], async (ctx) => {
   let contentType = ctx.req.header("content-type")?.split(";")[0].toLocaleLowerCase();
   if (ctx.req.query("sentry_client")?.startsWith("sentry.javascript.browser") && ctx.req.header("Origin")) {
     contentType = SENTRY_CONTENT_TYPE;

package/dist/server/routes/stream/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/server/routes/stream/index.ts"],"sourcesContent":["import { createWriteStream } from \"node:fs\";\nimport { Hono } from \"hono\";\nimport { SENTRY_CONTENT_TYPE } from \"../../../shared/constants.ts\";\nimport { logger } from \"../../logger.ts\";\nimport { decompressBody, pushToSpotlightBuffer } from \"../../sdk.ts\";\nimport type { ContentEncoding } from \"../../sdk.ts\";\nimport type { HonoEnv } from \"../../types/env.ts\";\nimport { getBuffer } from \"../../utils/index.ts\";\nimport { logIncomingEvent, logOutgoingEvent } from \"./debugLogging.ts\";\nimport { streamSSE } from \"./streaming.ts\";\nimport { parseBrowserFromUserAgent } from \"./userAgent.ts\";\n\nconst router = new Hono<HonoEnv>()\n  .get(\"/stream\", ctx => {\n    const buffer = getBuffer();\n\n    const useBase64 = ctx.req.query(\"base64\") != null;\n    const base64Indicator = useBase64 ? \";base64\" : \"\";\n\n    // Capture client information for debug logging\n    let clientId = ctx.req.query(\"client\");\n    if (!clientId) {\n      // Fallback to parsing User-Agent if no client param\n      const userAgent = ctx.req.header(\"User-Agent\") || \"unknown\";\n      clientId = parseBrowserFromUserAgent(userAgent);\n    }\n    // Sanitize to prevent log injection - keep only safe printable characters\n    // Allow alphanumeric, spaces, dots, dashes, underscores, slashes, parentheses\n    clientId = clientId.replace(/[^\\w\\s.\\-/()]/g, \"\");\n    // Ensure we always have a non-empty clientId\n    if (!clientId) clientId = \"unknown\";\n\n    return streamSSE(ctx, async stream => {\n      // Check for Last-Event-ID header to support reconnection\n      const lastEventId = ctx.req.header(\"Last-Event-ID\");\n\n      // Subscribe to events, optionally starting from after the lastEventId\n      const sub = buffer.subscribe(container => {\n        logOutgoingEvent(container, clientId);\n\n        const parsedEnvelope = container.getParsedEnvelope();\n        if (parsedEnvelope) {\n          stream.writeSSE({\n            id: parsedEnvelope.envelope[0].__spotlight_envelope_id.toString(),\n            event: `${container.getContentType()}${base64Indicator}`,\n            data: JSON.stringify(parsedEnvelope.envelope),\n          });\n        }\n      }, lastEventId);\n\n      stream.onAbort(() => {\n        buffer.unsubscribe(sub);\n      });\n    });\n  })\n  .get(\"/envelope/:id\", ctx => {\n    const buffer = getBuffer();\n\n    const envelopeId = ctx.req.param(\"id\");\n    const container = buffer.read({ envelopeId });\n\n    if (container.length === 0) {\n      return ctx.notFound();\n    }\n\n    return ctx.body(new Uint8Array(container[0].getData()), 200, {\n      \"Content-Type\": container[0].getContentType(),\n      \"Cache-Control\": \"no-cache\",\n      \"Content-Disposition\": `attachment; filename=\"${envelopeId}.bin\"`,\n      Connection: \"keep-alive\",\n    });\n  })\n  .on(\"POST\", [\"/stream\", \"/api/:id/envelope\"], async ctx => {\n    let contentType = ctx.req.header(\"content-type\")?.split(\";\")[0].toLocaleLowerCase();\n    if (ctx.req.query(\"sentry_client\")?.startsWith(\"sentry.javascript.browser\") && ctx.req.header(\"Origin\")) {\n      // This is a correction we make as Sentry Browser SDK may send messages with text/plain to avoid CORS issues\n      contentType = SENTRY_CONTENT_TYPE;\n    }\n\n    // manually decompress body to use it below without another decompression\n    const body = decompressBody(\n      Buffer.from(await ctx.req.arrayBuffer()),\n      ctx.req.header(\"Content-Encoding\") as ContentEncoding,\n    );\n\n    const container = pushToSpotlightBuffer({\n      body,\n      spotlightBuffer: getBuffer(),\n      contentType,\n      userAgent: ctx.req.header(\"User-Agent\"),\n    });\n\n    if (container) {\n      // Log incoming event details when debug is enabled\n      logIncomingEvent(container);\n    } else {\n      logger.warn(\"No content type, skipping payload...\");\n    }\n\n    const incomingPayload = ctx.get(\"incomingPayload\");\n\n    if (process.env.SPOTLIGHT_CAPTURE || incomingPayload) {\n      const contentType = container?.getContentType();\n      const timestamp = BigInt(Date.now()) * 1_000_000n + (process.hrtime.bigint() % 1_000_000n);\n      const filename = `${contentType?.replace(/[^a-z0-9]/gi, \"_\") || \"no_content_type\"}-${timestamp}.txt`;\n\n      if (incomingPayload) {\n        incomingPayload(body.toString(\"binary\"));\n      } else {\n        const stream = createWriteStream(filename);\n        stream.on(\"error\", err => {\n          logger.error(`Failed to save data to ${filename}: ${err}`);\n          stream.destroy();\n        });\n        stream.end(body, () => {\n          logger.info(`🗃️ Saved data to ${filename}`);\n        });\n      }\n    }\n\n    // 204 would be more appropriate but returning 200 to match what /envelope returns\n    return ctx.body(null, 200, {\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    });\n  });\n\nexport default router;\n"],"names":["contentType"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../src/server/routes/stream/index.ts"],"sourcesContent":["import { createWriteStream } from \"node:fs\";\nimport { Hono } from \"hono\";\nimport { SENTRY_CONTENT_TYPE } from \"../../../shared/constants.ts\";\nimport { logger } from \"../../logger.ts\";\nimport { decompressBody, pushToSpotlightBuffer } from \"../../sdk.ts\";\nimport type { ContentEncoding } from \"../../sdk.ts\";\nimport type { HonoEnv } from \"../../types/env.ts\";\nimport { getBuffer } from \"../../utils/index.ts\";\nimport { logIncomingEvent, logOutgoingEvent } from \"./debugLogging.ts\";\nimport { streamSSE } from \"./streaming.ts\";\nimport { parseBrowserFromUserAgent } from \"./userAgent.ts\";\n\nconst router = new Hono<HonoEnv>()\n  .get(\"/stream\", ctx => {\n    const buffer = getBuffer();\n\n    const useBase64 = ctx.req.query(\"base64\") != null;\n    const base64Indicator = useBase64 ? \";base64\" : \"\";\n\n    // Capture client information for debug logging\n    let clientId = ctx.req.query(\"client\");\n    if (!clientId) {\n      // Fallback to parsing User-Agent if no client param\n      const userAgent = ctx.req.header(\"User-Agent\") || \"unknown\";\n      clientId = parseBrowserFromUserAgent(userAgent);\n    }\n    // Sanitize to prevent log injection - keep only safe printable characters\n    // Allow alphanumeric, spaces, dots, dashes, underscores, slashes, parentheses\n    clientId = clientId.replace(/[^\\w\\s.\\-/()]/g, \"\");\n    // Ensure we always have a non-empty clientId\n    if (!clientId) clientId = \"unknown\";\n\n    return streamSSE(ctx, async stream => {\n      // Check for Last-Event-ID header to support reconnection\n      const lastEventId = ctx.req.header(\"Last-Event-ID\");\n\n      // Subscribe to events, optionally starting from after the lastEventId\n      const sub = buffer.subscribe(container => {\n        logOutgoingEvent(container, clientId);\n\n        const parsedEnvelope = container.getParsedEnvelope();\n        if (parsedEnvelope) {\n          stream.writeSSE({\n            id: parsedEnvelope.envelope[0].__spotlight_envelope_id.toString(),\n            event: `${container.getContentType()}${base64Indicator}`,\n            data: JSON.stringify(parsedEnvelope.envelope),\n          });\n        }\n      }, lastEventId);\n\n      stream.onAbort(() => {\n        buffer.unsubscribe(sub);\n      });\n    });\n  })\n  .get(\"/envelope/:id\", ctx => {\n    const buffer = getBuffer();\n\n    const envelopeId = ctx.req.param(\"id\");\n    const container = buffer.read({ envelopeId });\n\n    if (container.length === 0) {\n      return ctx.notFound();\n    }\n\n    return ctx.body(new Uint8Array(container[0].getData()), 200, {\n      \"Content-Type\": container[0].getContentType(),\n      \"Cache-Control\": \"no-cache\",\n      \"Content-Disposition\": `attachment; filename=\"${envelopeId}.bin\"`,\n      Connection: \"keep-alive\",\n    });\n  })\n  .on(\"POST\", [\"/stream\", \"/api/:id/envelope\", \"/api/:id/envelope/\"], async ctx => {\n    let contentType = ctx.req.header(\"content-type\")?.split(\";\")[0].toLocaleLowerCase();\n    if (ctx.req.query(\"sentry_client\")?.startsWith(\"sentry.javascript.browser\") && ctx.req.header(\"Origin\")) {\n      // This is a correction we make as Sentry Browser SDK may send messages with text/plain to avoid CORS issues\n      contentType = SENTRY_CONTENT_TYPE;\n    }\n\n    // manually decompress body to use it below without another decompression\n    const body = decompressBody(\n      Buffer.from(await ctx.req.arrayBuffer()),\n      ctx.req.header(\"Content-Encoding\") as ContentEncoding,\n    );\n\n    const container = pushToSpotlightBuffer({\n      body,\n      spotlightBuffer: getBuffer(),\n      contentType,\n      userAgent: ctx.req.header(\"User-Agent\"),\n    });\n\n    if (container) {\n      // Log incoming event details when debug is enabled\n      logIncomingEvent(container);\n    } else {\n      logger.warn(\"No content type, skipping payload...\");\n    }\n\n    const incomingPayload = ctx.get(\"incomingPayload\");\n\n    if (process.env.SPOTLIGHT_CAPTURE || incomingPayload) {\n      const contentType = container?.getContentType();\n      const timestamp = BigInt(Date.now()) * 1_000_000n + (process.hrtime.bigint() % 1_000_000n);\n      const filename = `${contentType?.replace(/[^a-z0-9]/gi, \"_\") || \"no_content_type\"}-${timestamp}.txt`;\n\n      if (incomingPayload) {\n        incomingPayload(body.toString(\"binary\"));\n      } else {\n        const stream = createWriteStream(filename);\n        stream.on(\"error\", err => {\n          logger.error(`Failed to save data to ${filename}: ${err}`);\n          stream.destroy();\n        });\n        stream.end(body, () => {\n          logger.info(`🗃️ Saved data to ${filename}`);\n        });\n      }\n    }\n\n    // 204 would be more appropriate but returning 200 to match what /envelope returns\n    return ctx.body(null, 200, {\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    });\n  });\n\nexport default router;\n"],"names":["contentType"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,MAAM,SAAS,IAAI,KAAA,EAChB,IAAI,WAAW,CAAA,QAAO;AACrB,QAAM,SAAS,UAAA;AAEf,QAAM,YAAY,IAAI,IAAI,MAAM,QAAQ,KAAK;AAC7C,QAAM,kBAAkB,YAAY,YAAY;AAGhD,MAAI,WAAW,IAAI,IAAI,MAAM,QAAQ;AACrC,MAAI,CAAC,UAAU;AAEb,UAAM,YAAY,IAAI,IAAI,OAAO,YAAY,KAAK;AAClD,eAAW,0BAA0B,SAAS;AAAA,EAChD;AAGA,aAAW,SAAS,QAAQ,kBAAkB,EAAE;AAEhD,MAAI,CAAC,SAAU,YAAW;AAE1B,SAAO,UAAU,KAAK,OAAM,WAAU;AAEpC,UAAM,cAAc,IAAI,IAAI,OAAO,eAAe;AAGlD,UAAM,MAAM,OAAO,UAAU,CAAA,cAAa;AACxC,uBAAiB,WAAW,QAAQ;AAEpC,YAAM,iBAAiB,UAAU,kBAAA;AACjC,UAAI,gBAAgB;AAClB,eAAO,SAAS;AAAA,UACd,IAAI,eAAe,SAAS,CAAC,EAAE,wBAAwB,SAAA;AAAA,UACvD,OAAO,GAAG,UAAU,eAAA,CAAgB,GAAG,eAAe;AAAA,UACtD,MAAM,KAAK,UAAU,eAAe,QAAQ;AAAA,QAAA,CAC7C;AAAA,MACH;AAAA,IACF,GAAG,WAAW;AAEd,WAAO,QAAQ,MAAM;AACnB,aAAO,YAAY,GAAG;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACH,CAAC,EACA,IAAI,iBAAiB,CAAA,QAAO;AAC3B,QAAM,SAAS,UAAA;AAEf,QAAM,aAAa,IAAI,IAAI,MAAM,IAAI;AACrC,QAAM,YAAY,OAAO,KAAK,EAAE,YAAY;AAE5C,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO,IAAI,SAAA;AAAA,EACb;AAEA,SAAO,IAAI,KAAK,IAAI,WAAW,UAAU,CAAC,EAAE,SAAS,GAAG,KAAK;AAAA,IAC3D,gBAAgB,UAAU,CAAC,EAAE,eAAA;AAAA,IAC7B,iBAAiB;AAAA,IACjB,uBAAuB,yBAAyB,UAAU;AAAA,IAC1D,YAAY;AAAA,EAAA,CACb;AACH,CAAC,EACA,GAAG,QAAQ,CAAC,WAAW,qBAAqB,oBAAoB,GAAG,OAAM,QAAO;AAC/E,MAAI,cAAc,IAAI,IAAI,OAAO,cAAc,GAAG,MAAM,GAAG,EAAE,CAAC,EAAE,kBAAA;AAChE,MAAI,IAAI,IAAI,MAAM,eAAe,GAAG,WAAW,2BAA2B,KAAK,IAAI,IAAI,OAAO,QAAQ,GAAG;AAEvG,kBAAc;AAAA,EAChB;AAGA,QAAM,OAAO;AAAA,IACX,OAAO,KAAK,MAAM,IAAI,IAAI,aAAa;AAAA,IACvC,IAAI,IAAI,OAAO,kBAAkB;AAAA,EAAA;AAGnC,QAAM,YAAY,sBAAsB;AAAA,IACtC;AAAA,IACA,iBAAiB,UAAA;AAAA,IACjB;AAAA,IACA,WAAW,IAAI,IAAI,OAAO,YAAY;AAAA,EAAA,CACvC;AAED,MAAI,WAAW;AAEb,qBAAiB,SAAS;AAAA,EAC5B,OAAO;AACL,WAAO,KAAK,sCAAsC;AAAA,EACpD;AAEA,QAAM,kBAAkB,IAAI,IAAI,iBAAiB;AAEjD,MAAI,QAAQ,IAAI,qBAAqB,iBAAiB;AACpD,UAAMA,eAAc,WAAW,eAAA;AAC/B,UAAM,YAAY,OAAO,KAAK,IAAA,CAAK,IAAI,WAAc,QAAQ,OAAO,OAAA,IAAW;AAC/E,UAAM,WAAW,GAAGA,cAAa,QAAQ,eAAe,GAAG,KAAK,iBAAiB,IAAI,SAAS;AAE9F,QAAI,iBAAiB;AACnB,sBAAgB,KAAK,SAAS,QAAQ,CAAC;AAAA,IACzC,OAAO;AACL,YAAM,SAAS,kBAAkB,QAAQ;AACzC,aAAO,GAAG,SAAS,CAAA,QAAO;AACxB,eAAO,MAAM,0BAA0B,QAAQ,KAAK,GAAG,EAAE;AACzD,eAAO,QAAA;AAAA,MACT,CAAC;AACD,aAAO,IAAI,MAAM,MAAM;AACrB,eAAO,KAAK,qBAAqB,QAAQ,EAAE;AAAA,MAC7C,CAAC;AAAA,IACH;AAAA,EACF;AAGA,SAAO,IAAI,KAAK,MAAM,KAAK;AAAA,IACzB,iBAAiB;AAAA,IACjB,YAAY;AAAA,EAAA,CACb;AACH,CAAC;"}

package/dist/server/types/cli.d.ts

@@ -6,6 +6,7 @@ export type CLIHandlerOptions = {
     port: SideCarOptions["port"];
     help?: boolean;
     debug?: boolean;
+    open?: boolean;
     format?: FormatterType;
     basePath?: SideCarOptions["basePath"];
     filesToServe?: SideCarOptions["filesToServe"];
@@ -13,3 +14,14 @@ export type CLIHandlerOptions = {
 };
 export type CLIHandlerReturnType = Promise<any> | any;
 export type CLIHandler = ((options: CLIHandlerOptions) => CLIHandlerReturnType) | (() => CLIHandlerReturnType);
+export type CommandMeta = {
+    name: string;
+    short: string;
+    usage?: string;
+    long?: string;
+    examples?: string[];
+};
+export type Command = {
+    meta: CommandMeta;
+    handler: CLIHandler;
+};

package/dist/server/utils/docker-compose.d.ts

@@ -5,6 +5,7 @@ interface DockerComposeConfig {
     composeFiles: string[];
     command: string[];
     serviceNames: string[];
+    subcommandArgs: string[];
 }
 /**
  * Detect if Docker is installed and check its version
@@ -20,6 +21,17 @@ export declare function buildDockerComposeCommand(config: DockerComposeConfig):
     cmdArgs: string[];
     stdin: string;
 };
+/**
+ * Prepare Docker Compose run by configuring environment and building command
+ *
+ * This helper sets up the SENTRY_SPOTLIGHT URL to use host.docker.internal
+ * (so containers can reach the host machine), builds the compose command,
+ * and removes COMPOSE_FILE from env to avoid conflicts with explicit -f flags.
+ */
+export declare function prepareDockerComposeRun(config: DockerComposeConfig, serverPort: number, env: Record<string, string | undefined>): {
+    cmdArgs: string[];
+    stdin: string;
+};
 /**
  * Detect and configure Docker Compose
  *
@@ -27,4 +39,16 @@ export declare function buildDockerComposeCommand(config: DockerComposeConfig):
  * compose files, and services to build a complete configuration.
  */
 export declare function detectDockerCompose(): DockerComposeConfig | null;
+/**
+ * Parse an explicit Docker Compose command from cmdArgs
+ *
+ * This handles cases where the user runs:
+ * - `spotlight run docker compose up -d`
+ * - `spotlight run docker-compose logs -f`
+ * - `spotlight run docker compose -f custom.yml exec web bash`
+ *
+ * Returns a DockerComposeConfig if the command is a docker compose command,
+ * null otherwise.
+ */
+export declare function parseExplicitDockerCompose(cmdArgs: string[]): DockerComposeConfig | null;
 export {};

package/dist/server/utils/docker-compose.js

@@ -2,7 +2,7 @@
 !function() {
   try {
     var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "30f1ede9-afbf-41ac-af87-60295da846a2", e._sentryDebugIdIdentifier = "sentry-dbid-30f1ede9-afbf-41ac-af87-60295da846a2");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "98a6bb80-8229-4a49-9bab-86d71ebccc94", e._sentryDebugIdIdentifier = "sentry-dbid-98a6bb80-8229-4a49-9bab-86d71ebccc94");
   } catch (e2) {
   }
 }();
@@ -35,6 +35,19 @@ function detectDocker() {
   const valid = semver.gte(versionNumber, DOCKER_MIN_VERSION);
   return { version: versionNumber, valid };
 }
+function validateDocker() {
+  const docker = detectDocker();
+  if (!docker) {
+    logger.debug("Docker is not installed or not in PATH");
+    return false;
+  }
+  if (!docker.valid) {
+    logger.error(`Docker version ${docker.version} does not meet the minimum required version ${DOCKER_MIN_VERSION}`);
+    return false;
+  }
+  logger.debug(`Detected Docker version ${docker.version}`);
+  return true;
+}
 function detectComposeCommand() {
   const composePluginVersion = tryExec("docker compose version --short");
   const composeStandaloneVersion = tryExec("docker-compose version --short");
@@ -64,60 +77,149 @@ function generateSpotlightOverrideYaml(serviceNames) {
   }
   return stringify({ services });
 }
+function resolveComposeFiles(userSpecifiedFiles) {
+  if (userSpecifiedFiles && userSpecifiedFiles.length > 0) {
+    logger.debug(`Using user-specified compose files: ${userSpecifiedFiles.join(", ")}`);
+    return userSpecifiedFiles;
+  }
+  const fromEnv = getComposeFilesFromEnv();
+  if (fromEnv) {
+    logger.debug(`Using COMPOSE_FILE environment variable: ${fromEnv.join(", ")}`);
+    return fromEnv;
+  }
+  const composeFile = findComposeFile();
+  if (!composeFile) {
+    logger.debug("No compose file found");
+    return null;
+  }
+  logger.debug(`Found compose file: ${composeFile}`);
+  const files = [composeFile];
+  const overrideFile = findOverrideFile(composeFile);
+  if (overrideFile) {
+    logger.debug(`Found override file: ${overrideFile}`);
+    files.push(overrideFile);
+  }
+  return files;
+}
+function collectServices(composeFiles) {
+  const serviceSet = /* @__PURE__ */ new Set();
+  for (const file of composeFiles) {
+    for (const service of getDockerComposeServices(file)) {
+      serviceSet.add(service);
+    }
+  }
+  return Array.from(serviceSet);
+}
+const FILE_FLAGS = ["-f", "--file"];
+const FLAGS_WITH_VALUES = ["-f", "--file", "-p", "--project-name", "--project-directory", "--env-file", "--profile"];
+function parseComposeFlags(args) {
+  const files = [];
+  const remainingArgs = [];
+  let parsingGlobalFlags = true;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (parsingGlobalFlags) {
+      if (FILE_FLAGS.includes(arg) && args[i + 1]) {
+        files.push(args[++i]);
+        continue;
+      }
+      const matchedFileFlag = FILE_FLAGS.find((flag) => arg.startsWith(`${flag}=`));
+      if (matchedFileFlag) {
+        files.push(arg.slice(matchedFileFlag.length + 1));
+        continue;
+      }
+      if (FLAGS_WITH_VALUES.includes(arg) && args[i + 1]) {
+        remainingArgs.push(arg, args[++i]);
+        continue;
+      }
+      const matchedValueFlag = FLAGS_WITH_VALUES.find((flag) => arg.startsWith(`${flag}=`));
+      if (matchedValueFlag) {
+        remainingArgs.push(arg);
+        continue;
+      }
+      if (!arg.startsWith("-")) {
+        parsingGlobalFlags = false;
+      }
+    }
+    remainingArgs.push(arg);
+  }
+  return { files, remainingArgs };
+}
 function buildDockerComposeCommand(config) {
   const cmdArgs = [...config.command];
   for (const file of config.composeFiles) {
     cmdArgs.push("-f", file);
   }
   cmdArgs.push("-f", "-");
-  cmdArgs.push("up");
+  if (config.subcommandArgs && config.subcommandArgs.length > 0) {
+    cmdArgs.push(...config.subcommandArgs);
+  }
   const stdin = generateSpotlightOverrideYaml(config.serviceNames);
   return { cmdArgs, stdin };
 }
+function prepareDockerComposeRun(config, serverPort, env) {
+  env.SENTRY_SPOTLIGHT = `http://${DOCKER_HOST_INTERNAL}:${serverPort}/stream`;
+  const command = buildDockerComposeCommand(config);
+  delete env.COMPOSE_FILE;
+  return command;
+}
 function detectDockerCompose() {
-  const docker = detectDocker();
-  if (!docker) {
-    logger.debug("Docker is not installed or not in PATH");
+  if (!validateDocker()) {
     return null;
   }
-  if (!docker.valid) {
-    logger.error(`Docker version ${docker.version} does not meet the minimum required version ${DOCKER_MIN_VERSION}`);
-    return null;
-  }
-  logger.debug(`Detected Docker version ${docker.version}`);
   const compose = detectComposeCommand();
   if (!compose) {
     logger.debug("Docker Compose is not installed or not in PATH");
     return null;
   }
   logger.debug(`Detected Docker Compose version ${compose.version} (${compose.command.join(" ")})`);
-  const composeFilesFromEnv = getComposeFilesFromEnv();
-  let composeFiles;
-  if (composeFilesFromEnv) {
-    composeFiles = composeFilesFromEnv;
-    logger.debug(`Using COMPOSE_FILE environment variable: ${composeFiles.join(", ")}`);
+  const composeFiles = resolveComposeFiles();
+  if (!composeFiles) {
+    return null;
+  }
+  const serviceNames = collectServices(composeFiles);
+  if (serviceNames.length === 0) {
+    logger.debug("No services found in compose file(s)");
+    return null;
+  }
+  logger.debug(`Found ${serviceNames.length} service(s): ${serviceNames.join(", ")}`);
+  return {
+    composeFiles,
+    command: compose.command,
+    serviceNames,
+    subcommandArgs: ["up"]
+    // Default to 'up' when auto-detecting
+  };
+}
+function parseExplicitDockerCompose(cmdArgs) {
+  if (cmdArgs.length < 2) {
+    return null;
+  }
+  let command;
+  let argsStartIndex;
+  if (cmdArgs[0] === "docker-compose") {
+    command = ["docker-compose"];
+    argsStartIndex = 1;
+  } else if (cmdArgs[0] === "docker" && cmdArgs[1] === "compose") {
+    command = ["docker", "compose"];
+    argsStartIndex = 2;
   } else {
-    const composeFile = findComposeFile();
-    if (!composeFile) {
-      logger.debug("No compose file found in current directory");
-      return null;
-    }
-    logger.debug(`Found compose file: ${composeFile}`);
-    composeFiles = [composeFile];
-    const overrideFile = findOverrideFile(composeFile);
-    if (overrideFile) {
-      logger.debug(`Found override file: ${overrideFile}`);
-      composeFiles.push(overrideFile);
-    }
+    return null;
   }
-  const serviceNamesSet = /* @__PURE__ */ new Set();
-  for (const file of composeFiles) {
-    const services = getDockerComposeServices(file);
-    for (const service of services) {
-      serviceNamesSet.add(service);
-    }
+  if (!validateDocker()) {
+    return null;
+  }
+  const argsAfterCommand = cmdArgs.slice(argsStartIndex);
+  const { files: userFiles, remainingArgs: subcommandArgs } = parseComposeFlags(argsAfterCommand);
+  if (subcommandArgs.length === 0) {
+    logger.debug("No subcommand provided for docker compose");
+    return null;
   }
-  const serviceNames = Array.from(serviceNamesSet);
+  const composeFiles = resolveComposeFiles(userFiles.length > 0 ? userFiles : void 0);
+  if (!composeFiles) {
+    return null;
+  }
+  const serviceNames = collectServices(composeFiles);
   if (serviceNames.length === 0) {
     logger.debug("No services found in compose file(s)");
     return null;
@@ -125,8 +227,9 @@ function detectDockerCompose() {
   logger.debug(`Found ${serviceNames.length} service(s): ${serviceNames.join(", ")}`);
   return {
     composeFiles,
-    command: compose.command,
-    serviceNames
+    command,
+    serviceNames,
+    subcommandArgs
   };
 }
 export {
@@ -135,6 +238,8 @@ export {
   DOCKER_MIN_VERSION,
   buildDockerComposeCommand,
   detectDocker,
-  detectDockerCompose
+  detectDockerCompose,
+  parseExplicitDockerCompose,
+  prepareDockerComposeRun
 };
 //# sourceMappingURL=docker-compose.js.map