deepctl-cmd-debug-browser 0.1.10__tar.gz → 0.1.11__tar.gz

{deepctl_cmd_debug_browser-0.1.10 → deepctl_cmd_debug_browser-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-cmd-debug-browser
-Version: 0.1.10
+Version: 0.1.11
 Summary: Browser debug subcommand for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -26,4 +26,47 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 
 # deepctl-cmd-debug-browser
 
-Browser debug subcommand for the Deepgram CLI (deepctl). This package provides the `browser` subcommand under the `debug` command group, allowing users to debug browser-related issues when using Deepgram's web-based features
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Browser debug subcommand for deepctl
+
+This is a subcommand of `deepctl debug`.
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl debug browser` | `deepctl_cmd_debug_browser.command:BrowserCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+- `httpx>=0.24.0`
+- `aiohttp>=3.9.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_debug_browser-0.1.11/README.md

@@ -0,0 +1,46 @@
+# deepctl-cmd-debug-browser
+
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Browser debug subcommand for deepctl
+
+This is a subcommand of `deepctl debug`.
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl debug browser` | `deepctl_cmd_debug_browser.command:BrowserCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+- `httpx>=0.24.0`
+- `aiohttp>=3.9.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

{deepctl_cmd_debug_browser-0.1.10 → deepctl_cmd_debug_browser-0.1.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl-cmd-debug-browser"
-version = "0.1.10"
+version = "0.1.11" # x-release-please-version
 description = "Browser debug subcommand for deepctl"
 readme = "README.md"
 license = "MIT"

{deepctl_cmd_debug_browser-0.1.10 → deepctl_cmd_debug_browser-0.1.11}/src/deepctl_cmd_debug_browser/command.py

@@ -36,6 +36,16 @@ class BrowserCommand(BaseCommand):
 
     # Browser debug doesn't require auth
     requires_auth = False
+
+    examples = [
+        "dg debug browser",
+        "dg debug browser --port 8080",
+    ]
+    agent_help = (
+        "Launch a local web page that tests browser capabilities for "
+        "Deepgram services — WebSocket support, microphone access, "
+        "audio encoding, and WebRTC. Opens a browser automatically."
+    )
     requires_project = False
     ci_friendly = False  # This command opens a browser
 
@@ -68,13 +78,18 @@ class BrowserCommand(BaseCommand):
             {
                 "names": ["--timeout"],
                 "help": (
-                    "Timeout in seconds to wait for browser connection "
-                    "(default: 60)"
+                    "Timeout in seconds to wait for browser connection (default: 60)"
                 ),
                 "type": int,
                 "default": 60,
                 "is_option": True,
             },
+            {
+                "names": ["--save-report"],
+                "help": "Save debug report to a JSON file",
+                "type": str,
+                "is_option": True,
+            },
         ]
 
     def find_available_port(self, start_port: int = 3000) -> int:
@@ -87,9 +102,7 @@ class BrowserCommand(BaseCommand):
                 return port
             except OSError:
                 continue
-        raise RuntimeError(
-            f"Could not find available port starting from {start_port}"
-        )
+        raise RuntimeError(f"Could not find available port starting from {start_port}")
 
     async def websocket_handler(self, request: Any) -> Any:
         """Handle WebSocket connections from the browser."""
@@ -113,8 +126,8 @@ class BrowserCommand(BaseCommand):
                         cap_data = ws_msg.data.get("result", {})
                         cap_key = ws_msg.data.get("capability")
                         if cap_key and cap_data:
-                            self.capabilities_data[cap_key] = (
-                                BrowserCapability(**cap_data)
+                            self.capabilities_data[cap_key] = BrowserCapability(
+                                **cap_data
                             )
 
                     elif ws_msg.type == MessageType.COMPLETE:
@@ -134,29 +147,25 @@ class BrowserCommand(BaseCommand):
                                 "console_api",
                                 "timer_apis",
                                 "secure_context",
+                                "microphone_access",
+                                "websocket_deepgram",
                             ]:
                                 if key in caps:
-                                    cap_dict[key] = BrowserCapability(
-                                        **caps[key]
-                                    )
+                                    cap_dict[key] = BrowserCapability(**caps[key])
                                 elif key in self.capabilities_data:
                                     cap_dict[key] = self.capabilities_data[key]
 
                             # Store complete capabilities
                             self.capabilities_data = {
                                 **cap_dict,
-                                "user_agent": caps.get(
-                                    "user_agent", "Unknown"
-                                ),
+                                "user_agent": caps.get("user_agent", "Unknown"),
                                 "overall_compatible": caps.get(
                                     "overall_compatible", False
                                 ),
                             }
                         self.debug_complete = True
                 elif msg.type == WSMsgType.ERROR:
-                    console.print(
-                        f"[red]WebSocket error: {ws.exception()}[/red]"
-                    )
+                    console.print(f"[red]WebSocket error: {ws.exception()}[/red]")
         finally:
             self.ws_clients.discard(ws)
             await ws.close()
@@ -192,8 +201,7 @@ class BrowserCommand(BaseCommand):
         await site.start()
 
         console.print(
-            f"\n[green]✓[/green] Debug server started on port "
-            f"[cyan]{port}[/cyan]"
+            f"\n[green]✓[/green] Debug server started on port [cyan]{port}[/cyan]"
         )
 
         # Wait for debug to complete or timeout
@@ -271,6 +279,8 @@ class BrowserCommand(BaseCommand):
                 ("console_api", "Console API"),
                 ("timer_apis", "Timer APIs"),
                 ("secure_context", "Secure Context"),
+                ("microphone_access", "Microphone Access"),
+                ("websocket_deepgram", "WebSocket to Deepgram"),
             ]
 
             for field, display_name in capability_fields:
@@ -280,17 +290,14 @@ class BrowserCommand(BaseCommand):
                     status_color = "green" if cap.supported else "red"
                     cap_table.add_row(
                         display_name,
-                        f"[{status_color}]{status_icon} "
-                        f"{cap.details}[/{status_color}]",
+                        f"[{status_color}]{status_icon} {cap.details}[/{status_color}]",
                         cap.version or "",
                     )
 
             console.print(cap_table)
 
             # Overall compatibility
-            console.print(
-                f"\n[bold]User Agent:[/bold] {capabilities.user_agent}"
-            )
+            console.print(f"\n[bold]User Agent:[/bold] {capabilities.user_agent}")
             if capabilities.overall_compatible:
                 console.print(
                     "[bold green]✓ Browser is fully compatible with "
@@ -302,6 +309,22 @@ class BrowserCommand(BaseCommand):
                     "with some Deepgram features[/bold red]"
                 )
 
+    def _save_report(self, result: BrowserDebugResult, filename: str) -> None:
+        """Save debug report to a JSON file."""
+        import json
+        from datetime import datetime
+
+        try:
+            report = {
+                "timestamp": datetime.now().isoformat(),
+                "result": result.model_dump(),
+            }
+            with open(filename, "w") as f:
+                json.dump(report, f, indent=2, default=str)
+            console.print(f"\n[green]Report saved to: {filename}[/green]")
+        except Exception as e:
+            console.print(f"\n[red]Failed to save report: {e!s}[/red]")
+
     def handle(
         self,
         config: Config,
@@ -313,6 +336,7 @@ class BrowserCommand(BaseCommand):
         port = kwargs.get("port")
         no_browser = kwargs.get("no_browser", False)
         timeout = kwargs.get("timeout", 60)
+        save_report = kwargs.get("save_report")
 
         self.start_time = time.time()
 
@@ -335,8 +359,7 @@ class BrowserCommand(BaseCommand):
         # Prompt user to open browser
         if not no_browser:
             console.print(
-                "\n[yellow]Press Enter to open the debugger in your "
-                "browser...[/yellow]"
+                "\n[yellow]Press Enter to open the debugger in your browser...[/yellow]"
             )
             input()
             webbrowser.open(url)
@@ -355,18 +378,14 @@ class BrowserCommand(BaseCommand):
             console=console,
             transient=True,
         ) as progress:
-            task = progress.add_task(
-                "Waiting for browser connection...", total=None
-            )
+            task = progress.add_task("Waiting for browser connection...", total=None)
 
             # Run servers
             loop = asyncio.new_event_loop()
             asyncio.set_event_loop(loop)
 
             try:
-                result = loop.run_until_complete(
-                    self.run_servers(port, timeout)
-                )
+                result = loop.run_until_complete(self.run_servers(port, timeout))
             finally:
                 loop.close()
 
@@ -374,10 +393,7 @@ class BrowserCommand(BaseCommand):
 
         # Process results
         capabilities = None
-        if (
-            self.capabilities_data
-            and "overall_compatible" in self.capabilities_data
-        ):
+        if self.capabilities_data and "overall_compatible" in self.capabilities_data:
             # Build BrowserCapabilities object
             cap_dict = {}
             for key in [
@@ -398,9 +414,7 @@ class BrowserCommand(BaseCommand):
             if all(key in cap_dict for key in cap_dict):
                 capabilities = BrowserCapabilities(
                     **cap_dict,
-                    user_agent=self.capabilities_data.get(
-                        "user_agent", "Unknown"
-                    ),
+                    user_agent=self.capabilities_data.get("user_agent", "Unknown"),
                     overall_compatible=self.capabilities_data.get(
                         "overall_compatible", False
                     ),
@@ -408,14 +422,11 @@ class BrowserCommand(BaseCommand):
 
         # Display results
         if result["completed"]:
-            console.print(
-                "\n[green]✓ Debug session completed successfully![/green]"
-            )
+            console.print("\n[green]✓ Debug session completed successfully![/green]")
             self.display_results(capabilities, self.messages)
         elif result["timed_out"]:
             console.print(
-                f"\n[red]✗ Debug session timed out after {timeout} "
-                f"seconds[/red]"
+                f"\n[red]✗ Debug session timed out after {timeout} seconds[/red]"
             )
             console.print("[dim]No browser connection was established.[/dim]")
         else:
@@ -433,7 +444,7 @@ class BrowserCommand(BaseCommand):
             if msg.type == MessageType.WARNING and msg.message
         ]
 
-        return BrowserDebugResult(
+        debug_result = BrowserDebugResult(
             status="success" if result["completed"] else "timeout",
             port=port,
             capabilities=capabilities,
@@ -443,3 +454,9 @@ class BrowserCommand(BaseCommand):
             duration_seconds=result["duration"],
             browser_opened=browser_opened,
         )
+
+        # Save report if requested
+        if save_report:
+            self._save_report(debug_result, save_report)
+
+        return debug_result

{deepctl_cmd_debug_browser-0.1.10 → deepctl_cmd_debug_browser-0.1.11}/src/deepctl_cmd_debug_browser/models.py

@@ -41,6 +41,8 @@ class BrowserCapabilities(BaseModel):
     console_api: BrowserCapability
     timer_apis: BrowserCapability
     secure_context: BrowserCapability
+    microphone_access: BrowserCapability | None = None
+    websocket_deepgram: BrowserCapability | None = None
     user_agent: str
     overall_compatible: bool
 

{deepctl_cmd_debug_browser-0.1.10 → deepctl_cmd_debug_browser-0.1.11}/src/deepctl_cmd_debug_browser/static/debug.html

@@ -390,6 +390,54 @@
                     name: 'Secure Context (HTTPS/localhost)',
                     key: 'secure_context',
                     check: () => window.isSecureContext === true
+                },
+                {
+                    name: 'Microphone Access',
+                    key: 'microphone_access',
+                    check: async () => {
+                        try {
+                            if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) {
+                                return false;
+                            }
+                            const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+                            stream.getTracks().forEach(t => t.stop());
+                            return true;
+                        } catch (e) {
+                            return false;
+                        }
+                    }
+                },
+                {
+                    name: 'WebSocket to Deepgram',
+                    key: 'websocket_deepgram',
+                    check: async () => {
+                        return new Promise((resolve) => {
+                            try {
+                                const testWs = new WebSocket('wss://api.deepgram.com/v1/listen');
+                                const timer = setTimeout(() => {
+                                    testWs.close();
+                                    resolve(false);
+                                }, 5000);
+                                testWs.onopen = () => {
+                                    clearTimeout(timer);
+                                    testWs.close();
+                                    resolve(true);
+                                };
+                                testWs.onerror = () => {
+                                    clearTimeout(timer);
+                                    resolve(true); // 401 still means reachable
+                                };
+                                testWs.onclose = (e) => {
+                                    clearTimeout(timer);
+                                    // Code 1006 with no open = network blocked
+                                    // Code 1008/4xx = auth error = reachable
+                                    resolve(e.code !== 1006 || testWs.readyState !== WebSocket.CONNECTING);
+                                };
+                            } catch (e) {
+                                resolve(false);
+                            }
+                        });
+                    }
                 }
             ];
 

{deepctl_cmd_debug_browser-0.1.10 → deepctl_cmd_debug_browser-0.1.11}/src/deepctl_cmd_debug_browser.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl-cmd-debug-browser
-Version: 0.1.10
+Version: 0.1.11
 Summary: Browser debug subcommand for deepctl
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -26,4 +26,47 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 
 # deepctl-cmd-debug-browser
 
-Browser debug subcommand for the Deepgram CLI (deepctl). This package provides the `browser` subcommand under the `debug` command group, allowing users to debug browser-related issues when using Deepgram's web-based features
+> Part of [deepctl](https://github.com/deepgram/cli) — Official Deepgram CLI
+
+Browser debug subcommand for deepctl
+
+This is a subcommand of `deepctl debug`.
+
+## Installation
+
+This package is included with deepctl and does not need to be installed separately.
+
+### Install deepctl
+
+```bash
+# Install with pip
+pip install deepctl
+
+# Or install with uv
+uv tool install deepctl
+
+# Or install with pipx
+pipx install deepctl
+
+# Or run without installing
+uvx deepctl --help
+pipx run deepctl --help
+```
+
+## Commands
+
+| Command | Entry Point |
+|---------|-------------|
+| `deepctl debug browser` | `deepctl_cmd_debug_browser.command:BrowserCommand` |
+
+## Dependencies
+
+- `click>=8.0.0`
+- `rich>=13.0.0`
+- `pydantic>=2.0.0`
+- `httpx>=0.24.0`
+- `aiohttp>=3.9.0`
+
+## License
+
+MIT — see [LICENSE](../../LICENSE)

deepctl_cmd_debug_browser-0.1.10/README.md

@@ -1,3 +0,0 @@
-# deepctl-cmd-debug-browser
-
-Browser debug subcommand for the Deepgram CLI (deepctl). This package provides the `browser` subcommand under the `debug` command group, allowing users to debug browser-related issues when using Deepgram's web-based features