@spotlightjs/spotlight 4.7.2 → 4.8.0

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/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":"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"}

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"];

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

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

@@ -1 +1 @@
-{"version":3,"file":"docker-compose.js","sources":["../../../src/server/utils/docker-compose.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport semver from \"semver\";\nimport { stringify as stringifyYaml } from \"yaml\";\nimport { logger } from \"../logger.ts\";\nimport {\n  findComposeFile,\n  findOverrideFile,\n  getComposeFilesFromEnv,\n  getDockerComposeServices,\n} from \"./docker-compose-parser.ts\";\n\n// minimum version of Docker required to use host.docker.internal on linux\n/// https://docs.docker.com/engine/release-notes/20.10/#bug-fixes-and-enhancements-1\nexport const DOCKER_MIN_VERSION = \"20.10.0\";\nexport const DOCKER_HOST_INTERNAL = \"host.docker.internal\";\nexport const DOCKER_HOST_GATEWAY = \"host-gateway\";\n\ninterface DockerComposeConfig {\n  composeFiles: string[]; // Array of compose files\n  command: string[];\n  serviceNames: string[];\n}\n\n/**\n * Execute a command and return the output, or null if it fails\n */\nfunction tryExec(command: string): string | null {\n  try {\n    return execSync(command, { encoding: \"utf-8\", stdio: [\"pipe\", \"pipe\", \"pipe\"] }).trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Detect if Docker is installed and check its version\n */\nexport function detectDocker(): { version: string; valid: boolean } | null {\n  const version = tryExec(\"docker --version\");\n  if (!version) {\n    return null;\n  }\n\n  const match = version.match(/Docker version ([\\d.]+)/);\n  if (!match) {\n    return null;\n  }\n\n  const versionNumber = match[1];\n  const valid = semver.gte(versionNumber, DOCKER_MIN_VERSION);\n\n  return { version: versionNumber, valid };\n}\n\n/**\n * Detect which compose command to use and its version\n * Follows the logic from sentry/self-hosted\n */\nfunction detectComposeCommand(): { command: string[]; version: string } | null {\n  const composePluginVersion = tryExec(\"docker compose version --short\");\n  const composeStandaloneVersion = tryExec(\"docker-compose version --short\");\n\n  if (!composePluginVersion && !composeStandaloneVersion) {\n    return null;\n  }\n\n  if (!composePluginVersion) {\n    return { command: [\"docker-compose\"], version: composeStandaloneVersion! };\n  }\n\n  if (!composeStandaloneVersion) {\n    return { command: [\"docker\", \"compose\"], version: composePluginVersion! };\n  }\n\n  // Use standalone if it's newer, otherwise prefer plugin\n  const pluginVer = composePluginVersion.replace(/^v/, \"\");\n  const standaloneVer = composeStandaloneVersion.replace(/^v/, \"\");\n\n  if (semver.gt(standaloneVer, pluginVer)) {\n    return { command: [\"docker-compose\"], version: composeStandaloneVersion };\n  }\n\n  return { command: [\"docker\", \"compose\"], version: composePluginVersion };\n}\n\n/**\n * Generate the override YAML for injecting Spotlight environment variables\n */\nfunction generateSpotlightOverrideYaml(serviceNames: string[]): string {\n  const services: Record<string, { environment: string[]; extra_hosts: string[] }> = {};\n  // Pass environment variables without values to inherit from parent process (run.ts)\n  // so the values set in run.ts are propagated correctly\n  for (const serviceName of serviceNames) {\n    services[serviceName] = {\n      environment: [\"SENTRY_SPOTLIGHT\", \"NEXT_PUBLIC_SENTRY_SPOTLIGHT\", \"SENTRY_TRACES_SAMPLE_RATE\"],\n      extra_hosts: [`${DOCKER_HOST_INTERNAL}:${DOCKER_HOST_GATEWAY}`],\n    };\n  }\n\n  return stringifyYaml({ services });\n}\n\n/**\n * Build the Docker Compose command with Spotlight environment injection\n */\nexport function buildDockerComposeCommand(config: DockerComposeConfig): {\n  cmdArgs: string[];\n  stdin: string;\n} {\n  const cmdArgs = [...config.command];\n\n  // Add -f for each compose file\n  for (const file of config.composeFiles) {\n    cmdArgs.push(\"-f\", file);\n  }\n\n  // Add our Spotlight override last\n  cmdArgs.push(\"-f\", \"-\");\n  cmdArgs.push(\"up\");\n\n  const stdin = generateSpotlightOverrideYaml(config.serviceNames);\n\n  return { cmdArgs, stdin };\n}\n\n/**\n * Detect and configure Docker Compose\n *\n * This function orchestrates the detection of Docker, Docker Compose,\n * compose files, and services to build a complete configuration.\n */\nexport function detectDockerCompose(): DockerComposeConfig | null {\n  const docker = detectDocker();\n  if (!docker) {\n    logger.debug(\"Docker is not installed or not in PATH\");\n    return null;\n  }\n\n  if (!docker.valid) {\n    logger.error(`Docker version ${docker.version} does not meet the minimum required version ${DOCKER_MIN_VERSION}`);\n    return null;\n  }\n\n  logger.debug(`Detected Docker version ${docker.version}`);\n\n  const compose = detectComposeCommand();\n  if (!compose) {\n    logger.debug(\"Docker Compose is not installed or not in PATH\");\n    return null;\n  }\n\n  logger.debug(`Detected Docker Compose version ${compose.version} (${compose.command.join(\" \")})`);\n\n  // First check if COMPOSE_FILE env is set\n  const composeFilesFromEnv = getComposeFilesFromEnv();\n  let composeFiles: string[];\n\n  if (composeFilesFromEnv) {\n    // Use files from COMPOSE_FILE env variable\n    composeFiles = composeFilesFromEnv;\n    logger.debug(`Using COMPOSE_FILE environment variable: ${composeFiles.join(\", \")}`);\n  } else {\n    // Use existing findComposeFile() + findOverrideFile() logic\n    const composeFile = findComposeFile();\n    if (!composeFile) {\n      logger.debug(\"No compose file found in current directory\");\n      return null;\n    }\n\n    logger.debug(`Found compose file: ${composeFile}`);\n\n    composeFiles = [composeFile];\n\n    // Check for override file (only when COMPOSE_FILE is not set)\n    const overrideFile = findOverrideFile(composeFile);\n    if (overrideFile) {\n      logger.debug(`Found override file: ${overrideFile}`);\n      composeFiles.push(overrideFile);\n    }\n  }\n\n  // Parse services from all compose files using the refactored function\n  const serviceNamesSet = new Set<string>();\n  for (const file of composeFiles) {\n    const services = getDockerComposeServices(file);\n    for (const service of services) {\n      serviceNamesSet.add(service);\n    }\n  }\n\n  const serviceNames = Array.from(serviceNamesSet);\n  if (serviceNames.length === 0) {\n    logger.debug(\"No services found in compose file(s)\");\n    return null;\n  }\n\n  logger.debug(`Found ${serviceNames.length} service(s): ${serviceNames.join(\", \")}`);\n\n  return {\n    composeFiles,\n    command: compose.command,\n    serviceNames,\n  };\n}\n"],"names":["stringifyYaml"],"mappings":"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"}
+{"version":3,"file":"docker-compose.js","sources":["../../../src/server/utils/docker-compose.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport semver from \"semver\";\nimport { stringify as stringifyYaml } from \"yaml\";\nimport { logger } from \"../logger.ts\";\nimport {\n  findComposeFile,\n  findOverrideFile,\n  getComposeFilesFromEnv,\n  getDockerComposeServices,\n} from \"./docker-compose-parser.ts\";\n\n// minimum version of Docker required to use host.docker.internal on linux\n/// https://docs.docker.com/engine/release-notes/20.10/#bug-fixes-and-enhancements-1\nexport const DOCKER_MIN_VERSION = \"20.10.0\";\nexport const DOCKER_HOST_INTERNAL = \"host.docker.internal\";\nexport const DOCKER_HOST_GATEWAY = \"host-gateway\";\n\ninterface DockerComposeConfig {\n  composeFiles: string[]; // Array of compose files\n  command: string[];\n  serviceNames: string[];\n  subcommandArgs: string[]; // Subcommand and its arguments (e.g., up -d --build, logs -f, exec web bash)\n}\n\n/**\n * Execute a command and return the output, or null if it fails\n */\nfunction tryExec(command: string): string | null {\n  try {\n    return execSync(command, { encoding: \"utf-8\", stdio: [\"pipe\", \"pipe\", \"pipe\"] }).trim();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Detect if Docker is installed and check its version\n */\nexport function detectDocker(): { version: string; valid: boolean } | null {\n  const version = tryExec(\"docker --version\");\n  if (!version) {\n    return null;\n  }\n\n  const match = version.match(/Docker version ([\\d.]+)/);\n  if (!match) {\n    return null;\n  }\n\n  const versionNumber = match[1];\n  const valid = semver.gte(versionNumber, DOCKER_MIN_VERSION);\n\n  return { version: versionNumber, valid };\n}\n\n/**\n * Validate Docker is installed and meets minimum version requirement.\n * Logs appropriate messages on failure.\n */\nfunction validateDocker(): boolean {\n  const docker = detectDocker();\n  if (!docker) {\n    logger.debug(\"Docker is not installed or not in PATH\");\n    return false;\n  }\n\n  if (!docker.valid) {\n    logger.error(`Docker version ${docker.version} does not meet the minimum required version ${DOCKER_MIN_VERSION}`);\n    return false;\n  }\n\n  logger.debug(`Detected Docker version ${docker.version}`);\n  return true;\n}\n\n/**\n * Detect which compose command to use and its version\n * Follows the logic from sentry/self-hosted\n */\nfunction detectComposeCommand(): { command: string[]; version: string } | null {\n  const composePluginVersion = tryExec(\"docker compose version --short\");\n  const composeStandaloneVersion = tryExec(\"docker-compose version --short\");\n\n  if (!composePluginVersion && !composeStandaloneVersion) {\n    return null;\n  }\n\n  if (!composePluginVersion) {\n    return { command: [\"docker-compose\"], version: composeStandaloneVersion! };\n  }\n\n  if (!composeStandaloneVersion) {\n    return { command: [\"docker\", \"compose\"], version: composePluginVersion! };\n  }\n\n  // Use standalone if it's newer, otherwise prefer plugin\n  const pluginVer = composePluginVersion.replace(/^v/, \"\");\n  const standaloneVer = composeStandaloneVersion.replace(/^v/, \"\");\n\n  if (semver.gt(standaloneVer, pluginVer)) {\n    return { command: [\"docker-compose\"], version: composeStandaloneVersion };\n  }\n\n  return { command: [\"docker\", \"compose\"], version: composePluginVersion };\n}\n\n/**\n * Generate the override YAML for injecting Spotlight environment variables\n */\nfunction generateSpotlightOverrideYaml(serviceNames: string[]): string {\n  const services: Record<string, { environment: string[]; extra_hosts: string[] }> = {};\n  // Pass environment variables without values to inherit from parent process (run.ts)\n  // so the values set in run.ts are propagated correctly\n  for (const serviceName of serviceNames) {\n    services[serviceName] = {\n      environment: [\"SENTRY_SPOTLIGHT\", \"NEXT_PUBLIC_SENTRY_SPOTLIGHT\", \"SENTRY_TRACES_SAMPLE_RATE\"],\n      extra_hosts: [`${DOCKER_HOST_INTERNAL}:${DOCKER_HOST_GATEWAY}`],\n    };\n  }\n\n  return stringifyYaml({ services });\n}\n\n/**\n * Resolve compose files to use, with the following priority:\n * 1. User-specified files (from -f flags)\n * 2. COMPOSE_FILE environment variable\n * 3. Auto-detect compose file + override file\n */\nfunction resolveComposeFiles(userSpecifiedFiles?: string[]): string[] | null {\n  if (userSpecifiedFiles && userSpecifiedFiles.length > 0) {\n    logger.debug(`Using user-specified compose files: ${userSpecifiedFiles.join(\", \")}`);\n    return userSpecifiedFiles;\n  }\n\n  const fromEnv = getComposeFilesFromEnv();\n  if (fromEnv) {\n    logger.debug(`Using COMPOSE_FILE environment variable: ${fromEnv.join(\", \")}`);\n    return fromEnv;\n  }\n\n  const composeFile = findComposeFile();\n  if (!composeFile) {\n    logger.debug(\"No compose file found\");\n    return null;\n  }\n\n  logger.debug(`Found compose file: ${composeFile}`);\n  const files = [composeFile];\n\n  const overrideFile = findOverrideFile(composeFile);\n  if (overrideFile) {\n    logger.debug(`Found override file: ${overrideFile}`);\n    files.push(overrideFile);\n  }\n\n  return files;\n}\n\n/**\n * Collect and deduplicate service names from compose files\n */\nfunction collectServices(composeFiles: string[]): string[] {\n  const serviceSet = new Set<string>();\n  for (const file of composeFiles) {\n    for (const service of getDockerComposeServices(file)) {\n      serviceSet.add(service);\n    }\n  }\n  return Array.from(serviceSet);\n}\n\nconst FILE_FLAGS = [\"-f\", \"--file\"];\n\n// Global flags that take a value (we need to skip over their values when finding the subcommand)\nconst FLAGS_WITH_VALUES = [\"-f\", \"--file\", \"-p\", \"--project-name\", \"--project-directory\", \"--env-file\", \"--profile\"];\n\n/**\n * Extract -f/--file flags from global options (before the subcommand).\n * Once we hit the first non-flag argument (the subcommand), everything passes through.\n * This prevents confusing `logs -f` (follow) with `-f file.yml` (compose file).\n */\nfunction parseComposeFlags(args: string[]): { files: string[]; remainingArgs: string[] } {\n  const files: string[] = [];\n  const remainingArgs: string[] = [];\n  let parsingGlobalFlags = true;\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (parsingGlobalFlags) {\n      // Extract -f/--file flags\n      if (FILE_FLAGS.includes(arg) && args[i + 1]) {\n        files.push(args[++i]);\n        continue;\n      }\n\n      const matchedFileFlag = FILE_FLAGS.find(flag => arg.startsWith(`${flag}=`));\n      if (matchedFileFlag) {\n        files.push(arg.slice(matchedFileFlag.length + 1));\n        continue;\n      }\n\n      // Skip other global flags that take values (e.g., -p myproject)\n      if (FLAGS_WITH_VALUES.includes(arg) && args[i + 1]) {\n        remainingArgs.push(arg, args[++i]);\n        continue;\n      }\n\n      const matchedValueFlag = FLAGS_WITH_VALUES.find(flag => arg.startsWith(`${flag}=`));\n      if (matchedValueFlag) {\n        remainingArgs.push(arg);\n        continue;\n      }\n\n      // First non-flag argument is the subcommand - stop parsing global flags\n      if (!arg.startsWith(\"-\")) {\n        parsingGlobalFlags = false;\n      }\n    }\n\n    remainingArgs.push(arg);\n  }\n\n  return { files, remainingArgs };\n}\n\n/**\n * Build the Docker Compose command with Spotlight environment injection\n */\nexport function buildDockerComposeCommand(config: DockerComposeConfig): {\n  cmdArgs: string[];\n  stdin: string;\n} {\n  const cmdArgs = [...config.command];\n\n  // Add -f for each compose file\n  for (const file of config.composeFiles) {\n    cmdArgs.push(\"-f\", file);\n  }\n\n  // Add our Spotlight override last\n  cmdArgs.push(\"-f\", \"-\");\n\n  // Add the subcommand and its arguments (e.g., up -d --build, logs -f)\n  if (config.subcommandArgs && config.subcommandArgs.length > 0) {\n    cmdArgs.push(...config.subcommandArgs);\n  }\n\n  const stdin = generateSpotlightOverrideYaml(config.serviceNames);\n\n  return { cmdArgs, stdin };\n}\n\n/**\n * Prepare Docker Compose run by configuring environment and building command\n *\n * This helper sets up the SENTRY_SPOTLIGHT URL to use host.docker.internal\n * (so containers can reach the host machine), builds the compose command,\n * and removes COMPOSE_FILE from env to avoid conflicts with explicit -f flags.\n */\nexport function prepareDockerComposeRun(\n  config: DockerComposeConfig,\n  serverPort: number,\n  env: Record<string, string | undefined>,\n): { cmdArgs: string[]; stdin: string } {\n  env.SENTRY_SPOTLIGHT = `http://${DOCKER_HOST_INTERNAL}:${serverPort}/stream`;\n  const command = buildDockerComposeCommand(config);\n  // biome-ignore lint/performance/noDelete: need to remove env var entirely\n  delete env.COMPOSE_FILE;\n  return command;\n}\n\n/**\n * Detect and configure Docker Compose\n *\n * This function orchestrates the detection of Docker, Docker Compose,\n * compose files, and services to build a complete configuration.\n */\nexport function detectDockerCompose(): DockerComposeConfig | null {\n  if (!validateDocker()) {\n    return null;\n  }\n\n  const compose = detectComposeCommand();\n  if (!compose) {\n    logger.debug(\"Docker Compose is not installed or not in PATH\");\n    return null;\n  }\n\n  logger.debug(`Detected Docker Compose version ${compose.version} (${compose.command.join(\" \")})`);\n\n  const composeFiles = resolveComposeFiles();\n  if (!composeFiles) {\n    return null;\n  }\n\n  const serviceNames = collectServices(composeFiles);\n  if (serviceNames.length === 0) {\n    logger.debug(\"No services found in compose file(s)\");\n    return null;\n  }\n\n  logger.debug(`Found ${serviceNames.length} service(s): ${serviceNames.join(\", \")}`);\n\n  return {\n    composeFiles,\n    command: compose.command,\n    serviceNames,\n    subcommandArgs: [\"up\"], // Default to 'up' when auto-detecting\n  };\n}\n\n/**\n * Parse an explicit Docker Compose command from cmdArgs\n *\n * This handles cases where the user runs:\n * - `spotlight run docker compose up -d`\n * - `spotlight run docker-compose logs -f`\n * - `spotlight run docker compose -f custom.yml exec web bash`\n *\n * Returns a DockerComposeConfig if the command is a docker compose command,\n * null otherwise.\n */\nexport function parseExplicitDockerCompose(cmdArgs: string[]): DockerComposeConfig | null {\n  if (cmdArgs.length < 2) {\n    return null;\n  }\n\n  let command: string[];\n  let argsStartIndex: number;\n\n  if (cmdArgs[0] === \"docker-compose\") {\n    command = [\"docker-compose\"];\n    argsStartIndex = 1;\n  } else if (cmdArgs[0] === \"docker\" && cmdArgs[1] === \"compose\") {\n    command = [\"docker\", \"compose\"];\n    argsStartIndex = 2;\n  } else {\n    return null;\n  }\n\n  // Validate Docker version (required for host.docker.internal on Linux)\n  if (!validateDocker()) {\n    return null;\n  }\n\n  const argsAfterCommand = cmdArgs.slice(argsStartIndex);\n  const { files: userFiles, remainingArgs: subcommandArgs } = parseComposeFlags(argsAfterCommand);\n\n  if (subcommandArgs.length === 0) {\n    logger.debug(\"No subcommand provided for docker compose\");\n    return null;\n  }\n\n  const composeFiles = resolveComposeFiles(userFiles.length > 0 ? userFiles : undefined);\n  if (!composeFiles) {\n    return null;\n  }\n\n  const serviceNames = collectServices(composeFiles);\n  if (serviceNames.length === 0) {\n    logger.debug(\"No services found in compose file(s)\");\n    return null;\n  }\n\n  logger.debug(`Found ${serviceNames.length} service(s): ${serviceNames.join(\", \")}`);\n\n  return {\n    composeFiles,\n    command,\n    serviceNames,\n    subcommandArgs,\n  };\n}\n"],"names":["stringifyYaml"],"mappings":"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"}

package/dist/server/utils/extras.d.ts

@@ -1,5 +1,7 @@
 export declare const withTracing: (fn: CallableFunction, spanArgs?: {}) => (...args: unknown[]) => any;
 export declare const getSpotlightURL: (port: number, host?: string) => string;
+export declare function getSpotlightWebUrl(port: number): string;
 export declare function logSpotlightUrl(port: number): void;
+export declare function openInBrowser(port: number): void;
 export declare const isValidPort: (...args: unknown[]) => any;
 export declare const isSidecarRunning: (...args: unknown[]) => any;

package/dist/server/utils/extras.js

@@ -2,10 +2,11 @@
 !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] = "7395028c-d1eb-42b4-a00d-6217acb41881", e._sentryDebugIdIdentifier = "sentry-dbid-7395028c-d1eb-42b4-a00d-6217acb41881");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "31184761-c651-48ef-9588-a8b09ee4f592", e._sentryDebugIdIdentifier = "sentry-dbid-31184761-c651-48ef-9588-a8b09ee4f592");
   } catch (e2) {
   }
 }();
+import { spawn } from "node:child_process";
 import { get } from "node:http";
 import { startSpan } from "@sentry/node";
 import { SERVER_IDENTIFIER } from "../constants.js";
@@ -13,8 +14,32 @@ import { logger } from "../logger.js";
 import "../../_virtual/_sentry-release-injection-file.js";
 const withTracing = (fn, spanArgs = {}) => (...args) => startSpan({ name: fn.name, ...spanArgs }, () => fn(...args));
 const getSpotlightURL = (port, host = "localhost") => `http://${host}:${port}/stream`;
+function getSpotlightWebUrl(port) {
+  return `http://localhost:${port}`;
+}
 function logSpotlightUrl(port) {
-  logger.info(`Open http://localhost:${port} to see the Spotlight UI`);
+  logger.info(`Open ${getSpotlightWebUrl(port)} to see the Spotlight UI`);
+}
+function openInBrowser(port) {
+  const url = getSpotlightWebUrl(port);
+  const platform = process.platform;
+  let cmd;
+  let args;
+  if (platform === "darwin") {
+    cmd = "open";
+    args = [url];
+  } else if (platform === "win32") {
+    cmd = "cmd";
+    args = ["/c", "start", "", url];
+  } else {
+    cmd = "xdg-open";
+    args = [url];
+  }
+  const child = spawn(cmd, args, { detached: true, stdio: "ignore" });
+  child.on("error", (err) => {
+    logger.debug(`Failed to open browser: ${err.message}`);
+  });
+  child.unref();
 }
 const isValidPort = withTracing(
   (value) => {
@@ -64,9 +89,11 @@ const isSidecarRunning = withTracing(
 );
 export {
   getSpotlightURL,
+  getSpotlightWebUrl,
   isSidecarRunning,
   isValidPort,
   logSpotlightUrl,
+  openInBrowser,
   withTracing
 };
 //# sourceMappingURL=extras.js.map

package/dist/server/utils/extras.js.map

@@ -1 +1 @@
-{"version":3,"file":"extras.js","sources":["../../../src/server/utils/extras.ts"],"sourcesContent":["import { get } from \"node:http\";\nimport { startSpan } from \"@sentry/node\";\nimport { SERVER_IDENTIFIER } from \"../constants.ts\";\nimport { logger } from \"../logger.ts\";\n\nexport const withTracing =\n  (fn: CallableFunction, spanArgs = {}) =>\n  (...args: unknown[]) =>\n    startSpan({ name: fn.name, ...spanArgs }, () => fn(...args));\n\nexport const getSpotlightURL = (port: number, host = \"localhost\") => `http://${host}:${port}/stream`;\n\nexport function logSpotlightUrl(port: number): void {\n  logger.info(`Open http://localhost:${port} to see the Spotlight UI`);\n}\n\nexport const isValidPort = withTracing(\n  (value: string | number) => {\n    if (typeof value === \"string\") {\n      const portNumber = Number(value);\n      return /^\\d+$/.test(value) && portNumber > 0 && portNumber <= 65535;\n    }\n    return value > 0 && value <= 65535;\n  },\n  { name: \"isValidPort\", op: \"sidecar.server.portCheck\" },\n);\n\nexport const isSidecarRunning = withTracing(\n  (port: string | number | undefined) =>\n    new Promise(_resolve => {\n      logger.debug(`Checking if we are already running on port ${port}`);\n      const options = {\n        hostname: \"localhost\",\n        port: port,\n        path: \"/health\",\n        method: \"GET\",\n        // This is only the socket timeout so set up\n        // a connection timeout below manually\n        timeout: 1000,\n        headers: { Connection: \"close\" },\n      };\n\n      let timeoutId: NodeJS.Timeout | null = null;\n      const healthReq = get(options, res => {\n        const serverIdentifier = res.headers[\"x-powered-by\"];\n        resolve(serverIdentifier === SERVER_IDENTIFIER);\n      });\n      const destroyHealthReq = () => !healthReq.destroyed && healthReq.destroy(new Error(\"Request timed out.\"));\n      function resolve(value: boolean) {\n        process.off(\"SIGINT\", destroyHealthReq);\n        if (timeoutId) {\n          clearTimeout(timeoutId);\n        }\n        _resolve(value);\n      }\n      process.on(\"SIGINT\", destroyHealthReq);\n      timeoutId = setTimeout(destroyHealthReq, 2000);\n      timeoutId.unref();\n      healthReq.on(\"error\", () => {\n        resolve(false);\n      });\n      healthReq.end();\n    }),\n  { name: \"isSidecarRunning\", op: \"sidecar.server.collideCheck\" },\n);\n"],"names":[],"mappings":";;;;;;;;;;;;;AAKO,MAAM,cACX,CAAC,IAAsB,WAAW,CAAA,MAClC,IAAI,SACF,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAA,GAAY,MAAM,GAAG,GAAG,IAAI,CAAC;AAExD,MAAM,kBAAkB,CAAC,MAAc,OAAO,gBAAgB,UAAU,IAAI,IAAI,IAAI;AAEpF,SAAS,gBAAgB,MAAoB;AAClD,SAAO,KAAK,yBAAyB,IAAI,0BAA0B;AACrE;AAEO,MAAM,cAAc;AAAA,EACzB,CAAC,UAA2B;AAC1B,QAAI,OAAO,UAAU,UAAU;AAC7B,YAAM,aAAa,OAAO,KAAK;AAC/B,aAAO,QAAQ,KAAK,KAAK,KAAK,aAAa,KAAK,cAAc;AAAA,IAChE;AACA,WAAO,QAAQ,KAAK,SAAS;AAAA,EAC/B;AAAA,EACA,EAAE,MAAM,eAAe,IAAI,2BAAA;AAC7B;AAEO,MAAM,mBAAmB;AAAA,EAC9B,CAAC,SACC,IAAI,QAAQ,CAAA,aAAY;AACtB,WAAO,MAAM,8CAA8C,IAAI,EAAE;AACjE,UAAM,UAAU;AAAA,MACd,UAAU;AAAA,MACV;AAAA,MACA,MAAM;AAAA,MACN,QAAQ;AAAA;AAAA;AAAA,MAGR,SAAS;AAAA,MACT,SAAS,EAAE,YAAY,QAAA;AAAA,IAAQ;AAGjC,QAAI,YAAmC;AACvC,UAAM,YAAY,IAAI,SAAS,CAAA,QAAO;AACpC,YAAM,mBAAmB,IAAI,QAAQ,cAAc;AACnD,cAAQ,qBAAqB,iBAAiB;AAAA,IAChD,CAAC;AACD,UAAM,mBAAmB,MAAM,CAAC,UAAU,aAAa,UAAU,QAAQ,IAAI,MAAM,oBAAoB,CAAC;AACxG,aAAS,QAAQ,OAAgB;AAC/B,cAAQ,IAAI,UAAU,gBAAgB;AACtC,UAAI,WAAW;AACb,qBAAa,SAAS;AAAA,MACxB;AACA,eAAS,KAAK;AAAA,IAChB;AACA,YAAQ,GAAG,UAAU,gBAAgB;AACrC,gBAAY,WAAW,kBAAkB,GAAI;AAC7C,cAAU,MAAA;AACV,cAAU,GAAG,SAAS,MAAM;AAC1B,cAAQ,KAAK;AAAA,IACf,CAAC;AACD,cAAU,IAAA;AAAA,EACZ,CAAC;AAAA,EACH,EAAE,MAAM,oBAAoB,IAAI,8BAAA;AAClC;"}
+{"version":3,"file":"extras.js","sources":["../../../src/server/utils/extras.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { get } from \"node:http\";\nimport { startSpan } from \"@sentry/node\";\nimport { SERVER_IDENTIFIER } from \"../constants.ts\";\nimport { logger } from \"../logger.ts\";\n\nexport const withTracing =\n  (fn: CallableFunction, spanArgs = {}) =>\n  (...args: unknown[]) =>\n    startSpan({ name: fn.name, ...spanArgs }, () => fn(...args));\n\nexport const getSpotlightURL = (port: number, host = \"localhost\") => `http://${host}:${port}/stream`;\n\nexport function getSpotlightWebUrl(port: number): string {\n  return `http://localhost:${port}`;\n}\n\nexport function logSpotlightUrl(port: number): void {\n  logger.info(`Open ${getSpotlightWebUrl(port)} to see the Spotlight UI`);\n}\n\nexport function openInBrowser(port: number): void {\n  const url = getSpotlightWebUrl(port);\n  const platform = process.platform;\n\n  let cmd: string;\n  let args: string[];\n\n  if (platform === \"darwin\") {\n    cmd = \"open\";\n    args = [url];\n  } else if (platform === \"win32\") {\n    cmd = \"cmd\";\n    args = [\"/c\", \"start\", \"\", url];\n  } else {\n    cmd = \"xdg-open\";\n    args = [url];\n  }\n\n  const child = spawn(cmd, args, { detached: true, stdio: \"ignore\" });\n  // Handle spawn errors gracefully (e.g., command not found in minimal environments)\n  child.on(\"error\", err => {\n    logger.debug(`Failed to open browser: ${err.message}`);\n  });\n  child.unref();\n}\n\nexport const isValidPort = withTracing(\n  (value: string | number) => {\n    if (typeof value === \"string\") {\n      const portNumber = Number(value);\n      return /^\\d+$/.test(value) && portNumber > 0 && portNumber <= 65535;\n    }\n    return value > 0 && value <= 65535;\n  },\n  { name: \"isValidPort\", op: \"sidecar.server.portCheck\" },\n);\n\nexport const isSidecarRunning = withTracing(\n  (port: string | number | undefined) =>\n    new Promise(_resolve => {\n      logger.debug(`Checking if we are already running on port ${port}`);\n      const options = {\n        hostname: \"localhost\",\n        port: port,\n        path: \"/health\",\n        method: \"GET\",\n        // This is only the socket timeout so set up\n        // a connection timeout below manually\n        timeout: 1000,\n        headers: { Connection: \"close\" },\n      };\n\n      let timeoutId: NodeJS.Timeout | null = null;\n      const healthReq = get(options, res => {\n        const serverIdentifier = res.headers[\"x-powered-by\"];\n        resolve(serverIdentifier === SERVER_IDENTIFIER);\n      });\n      const destroyHealthReq = () => !healthReq.destroyed && healthReq.destroy(new Error(\"Request timed out.\"));\n      function resolve(value: boolean) {\n        process.off(\"SIGINT\", destroyHealthReq);\n        if (timeoutId) {\n          clearTimeout(timeoutId);\n        }\n        _resolve(value);\n      }\n      process.on(\"SIGINT\", destroyHealthReq);\n      timeoutId = setTimeout(destroyHealthReq, 2000);\n      timeoutId.unref();\n      healthReq.on(\"error\", () => {\n        resolve(false);\n      });\n      healthReq.end();\n    }),\n  { name: \"isSidecarRunning\", op: \"sidecar.server.collideCheck\" },\n);\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAMO,MAAM,cACX,CAAC,IAAsB,WAAW,CAAA,MAClC,IAAI,SACF,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAA,GAAY,MAAM,GAAG,GAAG,IAAI,CAAC;AAExD,MAAM,kBAAkB,CAAC,MAAc,OAAO,gBAAgB,UAAU,IAAI,IAAI,IAAI;AAEpF,SAAS,mBAAmB,MAAsB;AACvD,SAAO,oBAAoB,IAAI;AACjC;AAEO,SAAS,gBAAgB,MAAoB;AAClD,SAAO,KAAK,QAAQ,mBAAmB,IAAI,CAAC,0BAA0B;AACxE;AAEO,SAAS,cAAc,MAAoB;AAChD,QAAM,MAAM,mBAAmB,IAAI;AACnC,QAAM,WAAW,QAAQ;AAEzB,MAAI;AACJ,MAAI;AAEJ,MAAI,aAAa,UAAU;AACzB,UAAM;AACN,WAAO,CAAC,GAAG;AAAA,EACb,WAAW,aAAa,SAAS;AAC/B,UAAM;AACN,WAAO,CAAC,MAAM,SAAS,IAAI,GAAG;AAAA,EAChC,OAAO;AACL,UAAM;AACN,WAAO,CAAC,GAAG;AAAA,EACb;AAEA,QAAM,QAAQ,MAAM,KAAK,MAAM,EAAE,UAAU,MAAM,OAAO,UAAU;AAElE,QAAM,GAAG,SAAS,CAAA,QAAO;AACvB,WAAO,MAAM,2BAA2B,IAAI,OAAO,EAAE;AAAA,EACvD,CAAC;AACD,QAAM,MAAA;AACR;AAEO,MAAM,cAAc;AAAA,EACzB,CAAC,UAA2B;AAC1B,QAAI,OAAO,UAAU,UAAU;AAC7B,YAAM,aAAa,OAAO,KAAK;AAC/B,aAAO,QAAQ,KAAK,KAAK,KAAK,aAAa,KAAK,cAAc;AAAA,IAChE;AACA,WAAO,QAAQ,KAAK,SAAS;AAAA,EAC/B;AAAA,EACA,EAAE,MAAM,eAAe,IAAI,2BAAA;AAC7B;AAEO,MAAM,mBAAmB;AAAA,EAC9B,CAAC,SACC,IAAI,QAAQ,CAAA,aAAY;AACtB,WAAO,MAAM,8CAA8C,IAAI,EAAE;AACjE,UAAM,UAAU;AAAA,MACd,UAAU;AAAA,MACV;AAAA,MACA,MAAM;AAAA,MACN,QAAQ;AAAA;AAAA;AAAA,MAGR,SAAS;AAAA,MACT,SAAS,EAAE,YAAY,QAAA;AAAA,IAAQ;AAGjC,QAAI,YAAmC;AACvC,UAAM,YAAY,IAAI,SAAS,CAAA,QAAO;AACpC,YAAM,mBAAmB,IAAI,QAAQ,cAAc;AACnD,cAAQ,qBAAqB,iBAAiB;AAAA,IAChD,CAAC;AACD,UAAM,mBAAmB,MAAM,CAAC,UAAU,aAAa,UAAU,QAAQ,IAAI,MAAM,oBAAoB,CAAC;AACxG,aAAS,QAAQ,OAAgB;AAC/B,cAAQ,IAAI,UAAU,gBAAgB;AACtC,UAAI,WAAW;AACb,qBAAa,SAAS;AAAA,MACxB;AACA,eAAS,KAAK;AAAA,IAChB;AACA,YAAQ,GAAG,UAAU,gBAAgB;AACrC,gBAAY,WAAW,kBAAkB,GAAI;AAC7C,cAAU,MAAA;AACV,cAAU,GAAG,SAAS,MAAM;AAC1B,cAAQ,KAAK;AAAA,IACf,CAAC;AACD,cAAU,IAAA;AAAA,EACZ,CAAC;AAAA,EACH,EAAE,MAAM,oBAAoB,IAAI,8BAAA;AAClC;"}