feat: add opt-in network logging with fetch, XHR, and WebSocket capture

[regenrek]

Summary

This PR introduces optional network logging capabilities to Browser Echo MCP, allowing developers to capture and monitor network activity alongside console logs.

Changes

New Features:

• Network Logging (opt-in): Capture fetch, XMLHttpRequest, and WebSocket activity as [network] entries
• Tag-based Filtering: Added tag filtering support to get_logs() and diagnostics endpoints
• Worker Runtime: Internal worker console capture runtime (dev-only)
• MCP File Logging: Optional ingest-side file logging with split directory support

Implementation Details:

• Network capture is opt-in via networkLogs.enabled: true in configuration
• Removed protocol from network log formatting for cleaner output
• Added tag parameter to get_logs() for filtering by [browser], [network], or [worker]
• Enhanced MCP server with file logging support (BROWSER_ECHO_FILE_LOG=true)
• Updated all framework providers (Vite, Next.js, Nuxt) to support network capture

Configuration:

// Enable network logging
{
  networkLogs: {
    enabled: true,
    captureFull: false // Optional: capture additional details
  }
}

// Filter logs by tag
get_logs({ tag: '[network]' })

Testing

All existing tests pass with the changes. The implementation maintains backward compatibility while adding new capabilities.

Breaking Changes

None. All changes are additive and opt-in.

[pkg-pr-new]

Open in StackBlitz

@browser-echo/core

npm i https://pkg.pr.new/instructa/browser-echo/@browser-echo/core@5

@browser-echo/mcp

npm i https://pkg.pr.new/instructa/browser-echo/@browser-echo/mcp@5

@browser-echo/next

npm i https://pkg.pr.new/instructa/browser-echo/@browser-echo/next@5

@browser-echo/nuxt

npm i https://pkg.pr.new/instructa/browser-echo/@browser-echo/nuxt@5

@browser-echo/react

npm i https://pkg.pr.new/instructa/browser-echo/@browser-echo/react@5

@browser-echo/vite

npm i https://pkg.pr.new/instructa/browser-echo/@browser-echo/vite@5

@browser-echo/vue

npm i https://pkg.pr.new/instructa/browser-echo/@browser-echo/vue@5

commit: a16c609