PyPI - deepctl - Versions diffs - 0.3.3__tar.gz → 0.4.1__tar.gz - Mend

deepctl 0.3.3tar.gz → 0.4.1tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

{deepctl-0.3.3/src/deepctl.egg-info → deepctl-0.4.1}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.3.3
+Version: 0.4.1
 Summary: Official Deepgram CLI for speech recognition and audio intelligence
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -27,35 +27,35 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click>=8.0.0
 Requires-Dist: deepgram-sdk<8,>=7.7.0
-Requires-Dist: deepctl-core>=0.2.19
-Requires-Dist: deepctl-cmd-login>=0.1.20
-Requires-Dist: deepctl-cmd-projects>=0.2.0
+Requires-Dist: deepctl-core>=0.3.1
+Requires-Dist: deepctl-cmd-login>=0.2.1
+Requires-Dist: deepctl-cmd-projects>=0.2.1
 Requires-Dist: deepctl-cmd-transcribe>=0.1.12
 Requires-Dist: deepctl-cmd-usage>=0.2.1
-Requires-Dist: deepctl-cmd-mcp>=0.1.15
-Requires-Dist: deepctl-cmd-api>=0.0.2
+Requires-Dist: deepctl-cmd-mcp>=0.1.16
+Requires-Dist: deepctl-cmd-api>=0.0.3
 Requires-Dist: deepctl-cmd-debug>=0.1.13
 Requires-Dist: deepctl-cmd-debug-browser>=0.1.12
 Requires-Dist: deepctl-cmd-debug-network>=0.1.12
-Requires-Dist: deepctl-cmd-debug-audio>=0.1.14
-Requires-Dist: deepctl-cmd-debug-probe>=0.0.2
-Requires-Dist: deepctl-cmd-debug-toolkit>=0.1.0
-Requires-Dist: deepctl-cmd-ffprobe>=0.0.3
-Requires-Dist: deepctl-cmd-update>=0.2.7
-Requires-Dist: deepctl-cmd-plugin>=0.1.14
-Requires-Dist: deepctl-cmd-skills>=0.0.9
-Requires-Dist: deepctl-cmd-init>=0.0.4
+Requires-Dist: deepctl-cmd-debug-audio>=0.1.15
+Requires-Dist: deepctl-cmd-debug-probe>=0.0.3
+Requires-Dist: deepctl-cmd-debug-toolkit>=0.2.0
+Requires-Dist: deepctl-cmd-ffprobe>=0.0.4
+Requires-Dist: deepctl-cmd-update>=0.2.8
+Requires-Dist: deepctl-cmd-plugin>=0.1.15
+Requires-Dist: deepctl-cmd-skills>=0.0.10
+Requires-Dist: deepctl-cmd-init>=0.1.1
 Requires-Dist: deepctl-cmd-models>=0.1.1
-Requires-Dist: deepctl-cmd-speak>=0.0.5
+Requires-Dist: deepctl-cmd-speak>=0.0.6
 Requires-Dist: deepctl-cmd-keys>=0.1.0
 Requires-Dist: deepctl-cmd-read>=0.1.0
-Requires-Dist: deepctl-cmd-listen>=0.0.14
+Requires-Dist: deepctl-cmd-listen>=0.0.15
 Requires-Dist: deepctl-cmd-requests>=0.1.0
 Requires-Dist: deepctl-cmd-billing>=0.1.0
 Requires-Dist: deepctl-cmd-members>=0.1.0
 Requires-Dist: deepctl-cmd-completion>=0.0.3
-Requires-Dist: deepctl-shared-utils>=0.1.13
-Requires-Dist: deepctl-telemetry>=0.0.7
+Requires-Dist: deepctl-shared-utils>=0.1.14
+Requires-Dist: deepctl-telemetry>=0.0.8
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: httpx>=0.24.0
@@ -141,13 +141,22 @@ iwr https://deepgram.com/install.ps1 -useb | iex
 pip install deepctl          # pip
 uv tool install deepctl      # uv
 pipx install deepctl         # pipx
+npm install -g @deepgram/cli # npm (installs dg and deepgram)
 ```
+The npm package is a launcher for the same Python CLI. It needs
+Node.js 20+ and either [uv](https://docs.astral.sh/uv/) or Python 3.10-3.14
+with `venv`, and sets the CLI up on first run. It installs prebuilt wheels
+only, so it (and `npx`) fails on Intel Macs and Windows on ARM64, where
+`cryptography` has none; on an Intel Mac, use Homebrew. See
+[npm/README.md](npm/README.md).
 ### Try Without Installing
 ```bash
 uvx deepctl --help
 pipx run deepctl --help
+npx @deepgram/cli --help
 ```
 ## Getting Started
@@ -242,7 +251,7 @@ dg requests --status failed --endpoint listen   # Debug failed requests
 dg api /v1/projects --jq '.projects[0].name'
 # MCP server for AI editors (Claude Code, Cursor, etc.)
-dg mcp --transport sse --port 8000
+dg mcp
 ```
 ## Features
@@ -352,11 +361,11 @@ dg debug probe --port 3100                # Live stream audio analysis
 ### MCP Server
-Connect Deepgram tools to AI coding assistants (Claude Code, Cursor, etc.).
+Give AI coding assistants (Claude Code, Cursor, etc.) Deepgram documentation
+search over stdio.
 ```bash
 dg mcp                                    # Start MCP server (stdio)
-dg mcp --transport sse --port 8000        # SSE transport
 ```
 Add to your editor's MCP config:
@@ -507,57 +516,71 @@ dg plugin remove <package>              # Remove
 Create your own — see the [plugin example](packages/deepctl-plugin-example).
-## Configuration
-**Priority:** CLI flags > environment variables > profile config > project config
+A plugin can't replace a built-in command such as `login` or `debug audio`.
+dg runs the built-in and prints a warning that names the plugin's package.
+A plugin whose entry point is named like a built-in command is skipped before
+it's imported, so none of its code runs; give the entry point a different name.
+To use a plugin's version anyway, list the command in the user config file
+at its standard location (`~/.config/deepctl/config.yaml` on Linux, or
+`$XDG_CONFIG_HOME/deepctl/config.yaml` when `XDG_CONFIG_HOME` is set;
+`~/Library/Application Support/deepctl/config.yaml` on macOS;
+`%LOCALAPPDATA%\deepgram\deepctl\config.yaml` on Windows):
-```bash
-dg login                                 # Interactive or --api-key
-dg login --profile staging --api-key SK  # Named profiles
-dg profiles --list                       # List profiles
-dg profiles --switch staging             # Switch profile
+```yaml
+plugins:
+  allow_override:
+    - login
+    - debug audio
 ```
-For structured output, use `--output json|yaml|table|csv` after leaf commands
-that do not define their own output option, or before any command as a global
-flag: `dg --output json <command>`. `dg speak --output FILE` writes audio to
-`FILE`, so use `dg --output json speak ...` for Speak's structured output.
-## Telemetry
-The CLI phones home anonymous error reports to help us catch crashes and regressions before users have to file an issue. It's **on by default** and easy to turn off.
+dg reads this setting only from that file, never from `deepgram.yaml` or a
+`--config` file. Only allow a plugin you trust: it receives everything you
+pass to that command, including API keys.
-**What's collected:** Python exceptions, stack traces, the CLI version, and the Python runtime. Request bodies, headers, cookies, API keys, email addresses, IP addresses, and usernames are scrubbed before send. No performance traces, no profiling, no replays — errors only.
+## Configuration
-**Where it goes:** the `dx-cli` Sentry project owned by the Deepgram DX team.
+**Priority:** CLI flags > environment variables > project `deepgram.yaml` > user
+config. A project `deepgram.yaml` is read after the user config, but it can set
+only `output.*` settings and a regional Deepgram `base_url` (see below).
-### Opt out
+The API key is the exception: dg uses `--api-key`, then the key `dg login` saved
+in your system keyring, then `DEEPGRAM_API_KEY`, then an `api_key` in the config
+file (where `dg login` saves it when no keyring is available).
-Persistent (recommended) — add this to your `config.yaml`
-(`~/.config/deepctl/config.yaml` on Linux,
-`~/Library/Application Support/deepctl/config.yaml` on macOS,
-`%LOCALAPPDATA%\deepgram\deepctl\config.yaml` on Windows):
+dg sends your API key only to Deepgram API hosts, to hosts you list in
+`api.allowed_hosts` in your own `config.yaml`, or to `DEEPGRAM_BASE_URL` (not in
+an AI agent session). Anything else is refused before a request is made. Hosts
+must use https: plain http works only for localhost, 127.0.0.0/8 and [::1]. For
+a proxy or self-hosted deployment, add its host (and port, to approve only that
+port):
 ```yaml
-telemetry:
-  enabled: false
+api:
+  allowed_hosts:
+    - my-proxy.example.com
+    - localhost:8080
 ```
-One-shot (CI, scripts, single command):
+A project's `deepgram.yaml` can't set credentials, a project ID, a profile or a
+non-Deepgram `base_url`, and can't approve hosts.
 ```bash
-DEEPCTL_TELEMETRY_DISABLED=1 dg listen recording.wav
+dg login                                 # Interactive or --api-key
+dg login --profile staging --api-key SK  # Named profiles
+dg profiles --list                       # List profiles
+dg profiles --switch staging             # Switch profile
 ```
-### Override the destination
+For structured output, use `--output json|yaml|table|csv` after leaf commands
+that do not define their own output option, or before any command as a global
+flag: `dg --output json <command>`. `dg speak --output FILE` writes audio to
+`FILE`, so use `dg --output json speak ...` for Speak's structured output.
-For forks or self-hosted Sentry, point telemetry at your own DSN:
+## Telemetry
-```bash
-export DEEPCTL_TELEMETRY_DSN='https://<key>@<your-sentry>/<project>'
-```
+This version of dg sends no telemetry: no error reports, usage data or other telemetry, whether a command succeeds or fails. dg still contacts the Deepgram API for the commands you run, and pypi.org to check for updates.
-`DEEPCTL_TELEMETRY_DISABLED` always wins. The default DSN is baked into the package and only used when the override is unset.
+The `DEEPCTL_TELEMETRY_DISABLED` environment variable and the `telemetry.enabled` setting in `config.yaml` are still accepted, and the new `--no-telemetry` flag is accepted too, but none of them has an effect in this version. `DEEPCTL_TELEMETRY_DSN` is now ignored unless it points at the local machine, which is for tests. The last line of `dg --help` says that dg sends no telemetry.
 ## Development
@@ -589,7 +612,7 @@ cli/
 │   ├── deepctl-cmd-keys/             # API keys management command for deepctl
 │   ├── deepctl-cmd-listen/           # Listen (live speech-to-text) command for deepctl
 │   ├── deepctl-cmd-login/            # Login command for deepctl
-│   ├── deepctl-cmd-mcp/              # MCP proxy command for deepctl — connects to Deepgram's developer API
+│   ├── deepctl-cmd-mcp/              # MCP server for deepctl: Deepgram documentation search over stdio
 │   ├── deepctl-cmd-members/          # Members management command for deepctl
 │   ├── deepctl-cmd-models/           # Models command for deepctl
 │   ├── deepctl-cmd-plugin/           # Plugin management command for deepctl
@@ -604,7 +627,7 @@ cli/
 │   ├── deepctl-core/                 # Core components for deepctl
 │   ├── deepctl-plugin-example/       # Example plugin for deepctl
 │   ├── deepctl-shared-utils/         # Shared utilities for deepctl
-│   └── deepctl-telemetry/            # Opt-out phone-home telemetry for deepctl
+│   └── deepctl-telemetry/            # Error reporting for deepctl; this version sends no telemetry
 ├── tests/                            # Integration tests
 └── Makefile                          # Development tasks
 ```
@@ -630,7 +653,7 @@ cli/
 | `deepctl listen` | Listen (live speech-to-text) command for deepctl |
 | `deepctl login` | Login command for deepctl |
 | `deepctl logout` | Login command for deepctl |
-| `deepctl mcp` | MCP proxy command for deepctl — connects to Deepgram's developer API |
+| `deepctl mcp` | MCP server for deepctl: Deepgram documentation search over stdio |
 | `deepctl members` | Members management command for deepctl |
 | `deepctl models` | Models command for deepctl |
 | `deepctl plugin` | Plugin management command for deepctl |
@@ -665,7 +688,7 @@ cli/
 | [`deepctl-cmd-keys`](packages/deepctl-cmd-keys) | API keys management command for deepctl |
 | [`deepctl-cmd-listen`](packages/deepctl-cmd-listen) | Listen (live speech-to-text) command for deepctl |
 | [`deepctl-cmd-login`](packages/deepctl-cmd-login) | Login command for deepctl |
-| [`deepctl-cmd-mcp`](packages/deepctl-cmd-mcp) | MCP proxy command for deepctl — connects to Deepgram's developer API |
+| [`deepctl-cmd-mcp`](packages/deepctl-cmd-mcp) | MCP server for deepctl: Deepgram documentation search over stdio |
 | [`deepctl-cmd-members`](packages/deepctl-cmd-members) | Members management command for deepctl |
 | [`deepctl-cmd-models`](packages/deepctl-cmd-models) | Models command for deepctl |
 | [`deepctl-cmd-plugin`](packages/deepctl-cmd-plugin) | Plugin management command for deepctl |
@@ -680,7 +703,7 @@ cli/
 | [`deepctl-core`](packages/deepctl-core) | Core components for deepctl |
 | [`deepctl-plugin-example`](packages/deepctl-plugin-example) | Example plugin for deepctl |
 | [`deepctl-shared-utils`](packages/deepctl-shared-utils) | Shared utilities for deepctl |
-| [`deepctl-telemetry`](packages/deepctl-telemetry) | Opt-out phone-home telemetry for deepctl |
+| [`deepctl-telemetry`](packages/deepctl-telemetry) | Error reporting for deepctl; this version sends no telemetry |
 <!-- END:packages -->
 ## Release

{deepctl-0.3.3 → deepctl-0.4.1}/README.md RENAMED Viewed

@@ -57,13 +57,22 @@ iwr https://deepgram.com/install.ps1 -useb | iex
 pip install deepctl          # pip
 uv tool install deepctl      # uv
 pipx install deepctl         # pipx
+npm install -g @deepgram/cli # npm (installs dg and deepgram)
 ```
+The npm package is a launcher for the same Python CLI. It needs
+Node.js 20+ and either [uv](https://docs.astral.sh/uv/) or Python 3.10-3.14
+with `venv`, and sets the CLI up on first run. It installs prebuilt wheels
+only, so it (and `npx`) fails on Intel Macs and Windows on ARM64, where
+`cryptography` has none; on an Intel Mac, use Homebrew. See
+[npm/README.md](npm/README.md).
 ### Try Without Installing
 ```bash
 uvx deepctl --help
 pipx run deepctl --help
+npx @deepgram/cli --help
 ```
 ## Getting Started
@@ -158,7 +167,7 @@ dg requests --status failed --endpoint listen   # Debug failed requests
 dg api /v1/projects --jq '.projects[0].name'
 # MCP server for AI editors (Claude Code, Cursor, etc.)
-dg mcp --transport sse --port 8000
+dg mcp
 ```
 ## Features
@@ -268,11 +277,11 @@ dg debug probe --port 3100                # Live stream audio analysis
 ### MCP Server
-Connect Deepgram tools to AI coding assistants (Claude Code, Cursor, etc.).
+Give AI coding assistants (Claude Code, Cursor, etc.) Deepgram documentation
+search over stdio.
 ```bash
 dg mcp                                    # Start MCP server (stdio)
-dg mcp --transport sse --port 8000        # SSE transport
 ```
 Add to your editor's MCP config:
@@ -423,57 +432,71 @@ dg plugin remove <package>              # Remove
 Create your own — see the [plugin example](packages/deepctl-plugin-example).
-## Configuration
-**Priority:** CLI flags > environment variables > profile config > project config
+A plugin can't replace a built-in command such as `login` or `debug audio`.
+dg runs the built-in and prints a warning that names the plugin's package.
+A plugin whose entry point is named like a built-in command is skipped before
+it's imported, so none of its code runs; give the entry point a different name.
+To use a plugin's version anyway, list the command in the user config file
+at its standard location (`~/.config/deepctl/config.yaml` on Linux, or
+`$XDG_CONFIG_HOME/deepctl/config.yaml` when `XDG_CONFIG_HOME` is set;
+`~/Library/Application Support/deepctl/config.yaml` on macOS;
+`%LOCALAPPDATA%\deepgram\deepctl\config.yaml` on Windows):
-```bash
-dg login                                 # Interactive or --api-key
-dg login --profile staging --api-key SK  # Named profiles
-dg profiles --list                       # List profiles
-dg profiles --switch staging             # Switch profile
+```yaml
+plugins:
+  allow_override:
+    - login
+    - debug audio
 ```
-For structured output, use `--output json|yaml|table|csv` after leaf commands
-that do not define their own output option, or before any command as a global
-flag: `dg --output json <command>`. `dg speak --output FILE` writes audio to
-`FILE`, so use `dg --output json speak ...` for Speak's structured output.
-## Telemetry
-The CLI phones home anonymous error reports to help us catch crashes and regressions before users have to file an issue. It's **on by default** and easy to turn off.
+dg reads this setting only from that file, never from `deepgram.yaml` or a
+`--config` file. Only allow a plugin you trust: it receives everything you
+pass to that command, including API keys.
-**What's collected:** Python exceptions, stack traces, the CLI version, and the Python runtime. Request bodies, headers, cookies, API keys, email addresses, IP addresses, and usernames are scrubbed before send. No performance traces, no profiling, no replays — errors only.
+## Configuration
-**Where it goes:** the `dx-cli` Sentry project owned by the Deepgram DX team.
+**Priority:** CLI flags > environment variables > project `deepgram.yaml` > user
+config. A project `deepgram.yaml` is read after the user config, but it can set
+only `output.*` settings and a regional Deepgram `base_url` (see below).
-### Opt out
+The API key is the exception: dg uses `--api-key`, then the key `dg login` saved
+in your system keyring, then `DEEPGRAM_API_KEY`, then an `api_key` in the config
+file (where `dg login` saves it when no keyring is available).
-Persistent (recommended) — add this to your `config.yaml`
-(`~/.config/deepctl/config.yaml` on Linux,
-`~/Library/Application Support/deepctl/config.yaml` on macOS,
-`%LOCALAPPDATA%\deepgram\deepctl\config.yaml` on Windows):
+dg sends your API key only to Deepgram API hosts, to hosts you list in
+`api.allowed_hosts` in your own `config.yaml`, or to `DEEPGRAM_BASE_URL` (not in
+an AI agent session). Anything else is refused before a request is made. Hosts
+must use https: plain http works only for localhost, 127.0.0.0/8 and [::1]. For
+a proxy or self-hosted deployment, add its host (and port, to approve only that
+port):
 ```yaml
-telemetry:
-  enabled: false
+api:
+  allowed_hosts:
+    - my-proxy.example.com
+    - localhost:8080
 ```
-One-shot (CI, scripts, single command):
+A project's `deepgram.yaml` can't set credentials, a project ID, a profile or a
+non-Deepgram `base_url`, and can't approve hosts.
 ```bash
-DEEPCTL_TELEMETRY_DISABLED=1 dg listen recording.wav
+dg login                                 # Interactive or --api-key
+dg login --profile staging --api-key SK  # Named profiles
+dg profiles --list                       # List profiles
+dg profiles --switch staging             # Switch profile
 ```
-### Override the destination
+For structured output, use `--output json|yaml|table|csv` after leaf commands
+that do not define their own output option, or before any command as a global
+flag: `dg --output json <command>`. `dg speak --output FILE` writes audio to
+`FILE`, so use `dg --output json speak ...` for Speak's structured output.
-For forks or self-hosted Sentry, point telemetry at your own DSN:
+## Telemetry
-```bash
-export DEEPCTL_TELEMETRY_DSN='https://<key>@<your-sentry>/<project>'
-```
+This version of dg sends no telemetry: no error reports, usage data or other telemetry, whether a command succeeds or fails. dg still contacts the Deepgram API for the commands you run, and pypi.org to check for updates.
-`DEEPCTL_TELEMETRY_DISABLED` always wins. The default DSN is baked into the package and only used when the override is unset.
+The `DEEPCTL_TELEMETRY_DISABLED` environment variable and the `telemetry.enabled` setting in `config.yaml` are still accepted, and the new `--no-telemetry` flag is accepted too, but none of them has an effect in this version. `DEEPCTL_TELEMETRY_DSN` is now ignored unless it points at the local machine, which is for tests. The last line of `dg --help` says that dg sends no telemetry.
 ## Development
@@ -505,7 +528,7 @@ cli/
 │   ├── deepctl-cmd-keys/             # API keys management command for deepctl
 │   ├── deepctl-cmd-listen/           # Listen (live speech-to-text) command for deepctl
 │   ├── deepctl-cmd-login/            # Login command for deepctl
-│   ├── deepctl-cmd-mcp/              # MCP proxy command for deepctl — connects to Deepgram's developer API
+│   ├── deepctl-cmd-mcp/              # MCP server for deepctl: Deepgram documentation search over stdio
 │   ├── deepctl-cmd-members/          # Members management command for deepctl
 │   ├── deepctl-cmd-models/           # Models command for deepctl
 │   ├── deepctl-cmd-plugin/           # Plugin management command for deepctl
@@ -520,7 +543,7 @@ cli/
 │   ├── deepctl-core/                 # Core components for deepctl
 │   ├── deepctl-plugin-example/       # Example plugin for deepctl
 │   ├── deepctl-shared-utils/         # Shared utilities for deepctl
-│   └── deepctl-telemetry/            # Opt-out phone-home telemetry for deepctl
+│   └── deepctl-telemetry/            # Error reporting for deepctl; this version sends no telemetry
 ├── tests/                            # Integration tests
 └── Makefile                          # Development tasks
 ```
@@ -546,7 +569,7 @@ cli/
 | `deepctl listen` | Listen (live speech-to-text) command for deepctl |
 | `deepctl login` | Login command for deepctl |
 | `deepctl logout` | Login command for deepctl |
-| `deepctl mcp` | MCP proxy command for deepctl — connects to Deepgram's developer API |
+| `deepctl mcp` | MCP server for deepctl: Deepgram documentation search over stdio |
 | `deepctl members` | Members management command for deepctl |
 | `deepctl models` | Models command for deepctl |
 | `deepctl plugin` | Plugin management command for deepctl |
@@ -581,7 +604,7 @@ cli/
 | [`deepctl-cmd-keys`](packages/deepctl-cmd-keys) | API keys management command for deepctl |
 | [`deepctl-cmd-listen`](packages/deepctl-cmd-listen) | Listen (live speech-to-text) command for deepctl |
 | [`deepctl-cmd-login`](packages/deepctl-cmd-login) | Login command for deepctl |
-| [`deepctl-cmd-mcp`](packages/deepctl-cmd-mcp) | MCP proxy command for deepctl — connects to Deepgram's developer API |
+| [`deepctl-cmd-mcp`](packages/deepctl-cmd-mcp) | MCP server for deepctl: Deepgram documentation search over stdio |
 | [`deepctl-cmd-members`](packages/deepctl-cmd-members) | Members management command for deepctl |
 | [`deepctl-cmd-models`](packages/deepctl-cmd-models) | Models command for deepctl |
 | [`deepctl-cmd-plugin`](packages/deepctl-cmd-plugin) | Plugin management command for deepctl |
@@ -596,7 +619,7 @@ cli/
 | [`deepctl-core`](packages/deepctl-core) | Core components for deepctl |
 | [`deepctl-plugin-example`](packages/deepctl-plugin-example) | Example plugin for deepctl |
 | [`deepctl-shared-utils`](packages/deepctl-shared-utils) | Shared utilities for deepctl |
-| [`deepctl-telemetry`](packages/deepctl-telemetry) | Opt-out phone-home telemetry for deepctl |
+| [`deepctl-telemetry`](packages/deepctl-telemetry) | Error reporting for deepctl; this version sends no telemetry |
 <!-- END:packages -->
 ## Release

{deepctl-0.3.3 → deepctl-0.4.1}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "deepctl"
-version = "0.3.3" # x-release-please-version
+version = "0.4.1" # x-release-please-version
 description = "Official Deepgram CLI for speech recognition and audio intelligence"
 readme = "README.md"
 license = "MIT"
@@ -35,35 +35,35 @@ requires-python = ">=3.10"
 dependencies = [
     "click>=8.0.0",
     "deepgram-sdk>=7.7.0,<8",
-    "deepctl-core>=0.2.19",
-    "deepctl-cmd-login>=0.1.20",
-    "deepctl-cmd-projects>=0.2.0",
+    "deepctl-core>=0.3.1",
+    "deepctl-cmd-login>=0.2.1",
+    "deepctl-cmd-projects>=0.2.1",
     "deepctl-cmd-transcribe>=0.1.12",
     "deepctl-cmd-usage>=0.2.1",
-    "deepctl-cmd-mcp>=0.1.15",
-    "deepctl-cmd-api>=0.0.2",
+    "deepctl-cmd-mcp>=0.1.16",
+    "deepctl-cmd-api>=0.0.3",
     "deepctl-cmd-debug>=0.1.13",
     "deepctl-cmd-debug-browser>=0.1.12",
     "deepctl-cmd-debug-network>=0.1.12",
-    "deepctl-cmd-debug-audio>=0.1.14",
-    "deepctl-cmd-debug-probe>=0.0.2",
-    "deepctl-cmd-debug-toolkit>=0.1.0",
-    "deepctl-cmd-ffprobe>=0.0.3",
-    "deepctl-cmd-update>=0.2.7",
-    "deepctl-cmd-plugin>=0.1.14",
-    "deepctl-cmd-skills>=0.0.9",
-    "deepctl-cmd-init>=0.0.4",
+    "deepctl-cmd-debug-audio>=0.1.15",
+    "deepctl-cmd-debug-probe>=0.0.3",
+    "deepctl-cmd-debug-toolkit>=0.2.0",
+    "deepctl-cmd-ffprobe>=0.0.4",
+    "deepctl-cmd-update>=0.2.8",
+    "deepctl-cmd-plugin>=0.1.15",
+    "deepctl-cmd-skills>=0.0.10",
+    "deepctl-cmd-init>=0.1.1",
     "deepctl-cmd-models>=0.1.1",
-    "deepctl-cmd-speak>=0.0.5",
+    "deepctl-cmd-speak>=0.0.6",
     "deepctl-cmd-keys>=0.1.0",
     "deepctl-cmd-read>=0.1.0",
-    "deepctl-cmd-listen>=0.0.14",
+    "deepctl-cmd-listen>=0.0.15",
     "deepctl-cmd-requests>=0.1.0",
     "deepctl-cmd-billing>=0.1.0",
     "deepctl-cmd-members>=0.1.0",
     "deepctl-cmd-completion>=0.0.3",
-    "deepctl-shared-utils>=0.1.13",
-    "deepctl-telemetry>=0.0.7",
+    "deepctl-shared-utils>=0.1.14",
+    "deepctl-telemetry>=0.0.8",
     "pydantic>=2.0.0",
     "rich>=13.0.0",
     "httpx>=0.24.0",
@@ -148,11 +148,9 @@ module = [
     "sounddevice.*",
     "numpy",
     "numpy.*",
-    "deepgram_mcp",
-    "deepgram_mcp.*",
 ]
-# Optional microphone dependencies (sounddevice, numpy) and the MCP SDK
-# (deepgram_mcp) ship without type stubs.
+# Optional microphone dependencies (sounddevice, numpy) ship without type
+# stubs.
 ignore_missing_imports = true
 # numpy>=2.2 ships PEP 695 `type` aliases in its stubs, which mypy rejects
 # under python_version = "3.10" (aborting before our code is checked). Skip

{deepctl-0.3.3 → deepctl-0.4.1}/src/deepctl/__init__.py RENAMED Viewed

@@ -1,7 +1,7 @@
 """deepctl - Official command-line interface for Deepgram's speech
 recognition API."""
-__version__ = "0.3.3"  # x-release-please-version
+__version__ = "0.4.1"  # x-release-please-version
 __author__ = "Deepgram"
 __email__ = "devrel@deepgram.com"
 __license__ = "MIT"

{deepctl-0.3.3 → deepctl-0.4.1}/src/deepctl/main.py RENAMED Viewed

@@ -3,15 +3,9 @@
 from __future__ import annotations
 import importlib.metadata
-import os
 import sys
-from contextlib import contextmanager
-from typing import TYPE_CHECKING
 import click
-if TYPE_CHECKING:
-    from collections.abc import Iterator
 from deepctl_core import (
     Config,
     TimingContext,
@@ -19,11 +13,16 @@ from deepctl_core import (
     print_timing_summary,
     setup_output,
 )
+from deepctl_core._launcher import capture_launcher
 from deepctl_core.output import stderr_console
 from rich.traceback import install
-# Install rich traceback for better error messages
-install(show_locals=True)
+# Read DEEPCTL_LAUNCHER (set by the @deepgram/cli npm package) once and drop it
+# from the environment, so processes deepctl starts do not inherit it.
+LAUNCHER = capture_launcher()
+# Install rich traceback for better error messages, without frame locals.
+install(show_locals=False)
 # Diagnostics go to stderr so stdout carries only the requested payload -- a
 # crash or usage error must not corrupt `dg -o json ...` for a script piping
@@ -42,12 +41,49 @@ def _record_install_method_cb(
     try:
         config = Config()
         config._set_config_value("update.installation_method", value)
-        config.save()
+        config.save(implicit=True)
+    except OSError as exc:
+        # A failed write must not look like success to the install script.
+        console.print(f"[red]Error:[/red] could not save the config file: {exc}")
+        # sys.exit, not ctx.exit: main() runs Click with standalone_mode=False,
+        # where ctx.exit(1) would only become an ignored return value.
+        sys.exit(1)
     except Exception:
         pass
     ctx.exit()
+def _root_flag_opts() -> set[str]:
+    """Root options that take no value: flags, plus `--help`."""
+    opts = {"--help"}
+    for param in cli.params:
+        if isinstance(param, click.Option) and param.is_flag:
+            opts.update(param.opts)
+            opts.update(param.secondary_opts)
+    return opts
+def _takes_next_token(arg: str, flag_opts: set[str]) -> bool:
+    """Whether root option `arg` takes the following token as its value.
+    Mirrors click: flags take nothing, `--opt=value` and `-Xvalue` carry
+    their value, and a short cluster such as `-qv` or `-qpprod` is read
+    letter by letter until the first option that takes a value.
+    """
+    if arg in flag_opts or "=" in arg:
+        return False
+    if arg.startswith("--") or len(arg) <= 2:
+        return True
+    letters = arg[1:]
+    for index, letter in enumerate(letters):
+        if f"-{letter}" in flag_opts:
+            continue
+        # The first option that takes a value: anything after it is the
+        # attached value; nothing after it means the next token is.
+        return index == len(letters) - 1
+    return False
 def preprocess_hyphenated_commands(args: list[str]) -> list[str]:
     """Convert hyphenated commands to nested commands.
@@ -85,40 +121,121 @@ def preprocess_hyphenated_commands(args: list[str]) -> list[str]:
     except Exception:
         pass
-    # Process arguments
-    new_args = []
-    i = 0
+    flag_opts = _root_flag_opts()
+    # Walk the root options to find the command token. Only that token is
+    # expanded; everything after it belongs to the command and is kept
+    # verbatim (`dg listen debug-call.wav` must not be split).
+    new_args: list[str] = []
+    i = 0
     while i < len(args):
         arg = args[i]
-        # Skip if it's an option (starts with -)
+        if arg == "--":
+            break
         if arg.startswith("-"):
             new_args.append(arg)
             i += 1
-            # If it's an option with a value, include the next arg too
-            if i < len(args) and not args[i].startswith("-"):
+            # An option that takes a value consumes the next token too,
+            # unless the value is attached (`--opt=value`, `-Xvalue`).
+            if (
+                _takes_next_token(arg, flag_opts)
+                and i < len(args)
+                and not args[i].startswith("-")
+            ):
                 new_args.append(args[i])
                 i += 1
             continue
-        # Check if this could be a hyphenated command
-        if "-" in arg and not arg.startswith("-"):
-            parts = arg.split("-", 1)
-            if len(parts) == 2:
-                group_name, subcommand = parts
+        group_name, sep, subcommand = arg.partition("-")
+        if sep and group_name in group_commands:
+            new_args.extend([group_name, subcommand])
+            i += 1
+        break
+    return new_args + args[i:]
-                # If the first part is a known group command, convert it
-                if group_name in group_commands:
-                    new_args.extend([group_name, subcommand])
-                    i += 1
-                    continue
-        # Otherwise, keep the argument as-is
-        new_args.append(arg)
+def _root_option_tokens(args: list[str]) -> list[str]:
+    """The option tokens before the subcommand (values skipped)."""
+    flag_opts = _root_flag_opts()
+    tokens: list[str] = []
+    i = 0
+    while i < len(args) and args[i].startswith("-"):
+        arg = args[i]
+        tokens.append(arg)
         i += 1
+        if _takes_next_token(arg, flag_opts):
+            i += 1  # skip the option's value
+    return tokens
-    return new_args
+def _no_telemetry_cb(ctx: click.Context, param: click.Parameter, value: bool) -> None:
+    """Turn telemetry off for this run. Eager, so root `--help` reflects it."""
+    if not value or ctx.resilient_parsing:
+        return
+    try:
+        from deepctl_telemetry import disable_for_run
+        disable_for_run()
+    except Exception:
+        pass
+def _init_telemetry(config: Config) -> None:
+    """Decide telemetry from the resolved Config. Never loads the SDK."""
+    try:
+        from deepctl_telemetry import init_telemetry
+        init_telemetry(config)
+    except Exception:
+        pass
+def _report_error(exc: BaseException) -> None:
+    """Send an error report if telemetry is on (the SDK loads only here).
+    A Ctrl-C while the report is sent is still a user cancellation: exit 2.
+    """
+    try:
+        from deepctl_telemetry import report_exception
+        report_exception(exc)
+    except KeyboardInterrupt:
+        _safe_console_print("\n[yellow]Stopped sending the error report.[/yellow]")
+        sys.exit(2)
+    except Exception:
+        pass
+def _argv_config_path(args: list[str]) -> str | None:
+    """`--config` from the root arguments, only for the notice on root `--help`.
+    Root `--help` is eager and fires before the root callback resolves
+    `--config`; every other path uses the parsed value. Accepts
+    `--config X`, `--config=X`, `-c X`, `-cX` and clusters such as `-qcX`.
+    When the option repeats, the last value wins, as in click.
+    """
+    flag_opts = _root_flag_opts()
+    found: str | None = None
+    i = 0
+    while i < len(args) and args[i].startswith("-"):
+        arg = args[i]
+        i += 1
+        if arg.startswith("--config="):
+            found = arg.split("=", 1)[1]
+        elif arg == "--config":
+            found = args[i] if i < len(args) else None
+        elif not arg.startswith("--"):
+            for index, letter in enumerate(arg[1:]):
+                if f"-{letter}" in flag_opts:
+                    continue
+                if letter == "c":
+                    rest = arg[index + 2 :]
+                    found = rest or (args[i] if i < len(args) else None)
+                break
+        if _takes_next_token(arg, flag_opts):
+            i += 1
+    return found
 # Create CLI group
@@ -140,7 +257,9 @@ def preprocess_hyphenated_commands(args: list[str]) -> list[str]:
 @click.option(
     "--base-url",
     help=(
-        "Override the API base URL (e.g. https://api.staging.deepgram.com). "
+        "Override the API base URL (e.g. https://api.eu.deepgram.com). "
+        "Hosts other than Deepgram API hosts must be listed in "
+        "api.allowed_hosts. "
         "REST and WebSocket endpoints are derived from this host. "
         "Also settable via the DEEPGRAM_BASE_URL environment variable."
     ),
@@ -180,6 +299,14 @@ def preprocess_hyphenated_commands(args: list[str]) -> list[str]:
     is_flag=True,
     help="Show detailed performance timing information",
 )
+@click.option(
+    "--no-telemetry",
+    is_flag=True,
+    is_eager=True,
+    expose_value=False,
+    callback=_no_telemetry_cb,
+    help="No effect: this version of dg sends no telemetry",
+)
 @click.option(
     "--non-interactive",
     is_flag=True,
@@ -230,14 +357,14 @@ def cli(
         enable_timing()
     with TimingContext("cli_initialization"):
-        # A --base-url flag overrides the configured/env base URL (flag wins).
-        # Config reads DEEPGRAM_BASE_URL at init, so set it before constructing.
-        if base_url:
-            os.environ["DEEPGRAM_BASE_URL"] = base_url
-        # Initialize configuration
+        # Initialize configuration. A --base-url flag overrides the
+        # configured/env base URL for this run only; Config records that it
+        # came from the command line, so it is never saved and gets
+        # credentials only if the host is trusted.
         ctx.ensure_object(dict)
-        ctx.obj["config"] = Config(config_path=config, profile=profile)
+        ctx.obj["config"] = Config(
+            config_path=config, profile=profile, base_url=base_url
+        )
         # Global --api-key passthrough (highest-precedence explicit credential).
         ctx.obj["api_key"] = api_key
         ctx.obj["timing"] = timing or timing_detailed
@@ -250,6 +377,10 @@ def cli(
             verbose=verbose,
         )
+        # Telemetry is decided here, after option parsing, so --config and
+        # --no-telemetry are honored.
+        _init_telemetry(ctx.obj["config"])
 # Load commands from entry points
 def load_commands() -> None:
@@ -266,27 +397,6 @@ def load_commands() -> None:
 load_commands()
-@contextmanager
-def _telemetry_transaction() -> Iterator[None]:
-    """Wrap CLI dispatch in a Sentry transaction (no-op when telemetry is off).
-    The transaction is named generically ('cli') here. BaseCommand.execute
-    renames it to the full Click command path (e.g. 'deepctl debug audio')
-    once Click has dispatched — which is the single source of truth for
-    the name. Trying to extract a command name from raw sys.argv is unsafe
-    because flag values can look like command names ('--output json' makes
-    'json' look like a command).
-    """
-    try:
-        import sentry_sdk
-    except ImportError:
-        yield
-        return
-    with sentry_sdk.start_transaction(op="cli.command", name="cli"):
-        yield
 def _global_option_hint(message: str) -> str | None:
     """Build a placement hint when a 'No such option' names a global option.
@@ -333,8 +443,40 @@ def _safe_console_print(message: str) -> None:
         pass
+# Error handlers that never raise on a character the encoding lacks.
+# "strict" and "surrogateescape" (a C locale) both raise.
+_SAFE_ERRORS = frozenset(
+    {"backslashreplace", "replace", "ignore", "namereplace", "xmlcharrefreplace"}
+)
+def safe_output_streams() -> None:
+    """Have stdout and stderr escape what their encoding can't write.
+    A redirected stream on Windows uses the ANSI code page (cp1252, say),
+    which has no block art: writing the --help banner raised
+    UnicodeEncodeError and ended the command. Such a stream now writes
+    ``\\u2588`` instead. A UTF-8 stream is left as it is, and the encoding
+    never changes, so a real console keeps what Python chose for it.
+    """
+    import codecs
+    import io
+    for stream in (sys.stdout, sys.stderr):
+        if not isinstance(stream, io.TextIOWrapper):
+            continue  # None, or a stream that can't be reconfigured
+        try:
+            encoding = codecs.lookup(stream.encoding or "").name
+            if encoding == "utf-8" or stream.errors in _SAFE_ERRORS:
+                continue
+            stream.reconfigure(errors="backslashreplace")
+        except (LookupError, OSError, ValueError):
+            continue  # an unknown encoding, or a closed stream
 def main() -> None:
     """Main entry point for the CLI."""
+    safe_output_streams()
     try:
         # Check if timing was requested and enable it early
         args = sys.argv[1:]  # Skip the program name
@@ -345,17 +487,15 @@ def main() -> None:
         if timing_requested:
             enable_timing()
-        # Initialize phone-home telemetry and install the --help footer.
-        # Both are no-ops when the user has opted out via config or env.
+        # Install the --help telemetry footer. Telemetry itself is decided in
+        # the root callback, after option parsing. `--no-telemetry` is also
+        # applied here so it holds even after an eager `--help` before it.
         try:
-            from deepctl_telemetry import (
-                init_telemetry,
-                install_help_notice,
-            )
+            from deepctl_telemetry import disable_for_run, install_help_notice
-            telemetry_config = Config()
-            init_telemetry(telemetry_config)
-            install_help_notice(telemetry_config)
+            if "--no-telemetry" in _root_option_tokens(args):
+                disable_for_run()
+            install_help_notice(lambda: Config(config_path=_argv_config_path(args)))
         except Exception:
             pass
@@ -400,7 +540,7 @@ def main() -> None:
                 processed_args = preprocess_hyphenated_commands(args)
             exit_code = 0
-            with TimingContext("cli_execution"), _telemetry_transaction():
+            with TimingContext("cli_execution"):
                 try:
                     cli(args=processed_args, standalone_mode=False)
                 except SystemExit as exc:
@@ -446,6 +586,7 @@ def main() -> None:
         sys.exit(1)
     except Exception as e:
         _safe_console_print(f"[red]Error: {e}[/red]")
+        _report_error(e)
         sys.exit(1)  # 1 = error; 2 is reserved for user interrupt

{deepctl-0.3.3 → deepctl-0.4.1/src/deepctl.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.3.3
+Version: 0.4.1
 Summary: Official Deepgram CLI for speech recognition and audio intelligence
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -27,35 +27,35 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click>=8.0.0
 Requires-Dist: deepgram-sdk<8,>=7.7.0
-Requires-Dist: deepctl-core>=0.2.19
-Requires-Dist: deepctl-cmd-login>=0.1.20
-Requires-Dist: deepctl-cmd-projects>=0.2.0
+Requires-Dist: deepctl-core>=0.3.1
+Requires-Dist: deepctl-cmd-login>=0.2.1
+Requires-Dist: deepctl-cmd-projects>=0.2.1
 Requires-Dist: deepctl-cmd-transcribe>=0.1.12
 Requires-Dist: deepctl-cmd-usage>=0.2.1
-Requires-Dist: deepctl-cmd-mcp>=0.1.15
-Requires-Dist: deepctl-cmd-api>=0.0.2
+Requires-Dist: deepctl-cmd-mcp>=0.1.16
+Requires-Dist: deepctl-cmd-api>=0.0.3
 Requires-Dist: deepctl-cmd-debug>=0.1.13
 Requires-Dist: deepctl-cmd-debug-browser>=0.1.12
 Requires-Dist: deepctl-cmd-debug-network>=0.1.12
-Requires-Dist: deepctl-cmd-debug-audio>=0.1.14
-Requires-Dist: deepctl-cmd-debug-probe>=0.0.2
-Requires-Dist: deepctl-cmd-debug-toolkit>=0.1.0
-Requires-Dist: deepctl-cmd-ffprobe>=0.0.3
-Requires-Dist: deepctl-cmd-update>=0.2.7
-Requires-Dist: deepctl-cmd-plugin>=0.1.14
-Requires-Dist: deepctl-cmd-skills>=0.0.9
-Requires-Dist: deepctl-cmd-init>=0.0.4
+Requires-Dist: deepctl-cmd-debug-audio>=0.1.15
+Requires-Dist: deepctl-cmd-debug-probe>=0.0.3
+Requires-Dist: deepctl-cmd-debug-toolkit>=0.2.0
+Requires-Dist: deepctl-cmd-ffprobe>=0.0.4
+Requires-Dist: deepctl-cmd-update>=0.2.8
+Requires-Dist: deepctl-cmd-plugin>=0.1.15
+Requires-Dist: deepctl-cmd-skills>=0.0.10
+Requires-Dist: deepctl-cmd-init>=0.1.1
 Requires-Dist: deepctl-cmd-models>=0.1.1
-Requires-Dist: deepctl-cmd-speak>=0.0.5
+Requires-Dist: deepctl-cmd-speak>=0.0.6
 Requires-Dist: deepctl-cmd-keys>=0.1.0
 Requires-Dist: deepctl-cmd-read>=0.1.0
-Requires-Dist: deepctl-cmd-listen>=0.0.14
+Requires-Dist: deepctl-cmd-listen>=0.0.15
 Requires-Dist: deepctl-cmd-requests>=0.1.0
 Requires-Dist: deepctl-cmd-billing>=0.1.0
 Requires-Dist: deepctl-cmd-members>=0.1.0
 Requires-Dist: deepctl-cmd-completion>=0.0.3
-Requires-Dist: deepctl-shared-utils>=0.1.13
-Requires-Dist: deepctl-telemetry>=0.0.7
+Requires-Dist: deepctl-shared-utils>=0.1.14
+Requires-Dist: deepctl-telemetry>=0.0.8
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: httpx>=0.24.0
@@ -141,13 +141,22 @@ iwr https://deepgram.com/install.ps1 -useb | iex
 pip install deepctl          # pip
 uv tool install deepctl      # uv
 pipx install deepctl         # pipx
+npm install -g @deepgram/cli # npm (installs dg and deepgram)
 ```
+The npm package is a launcher for the same Python CLI. It needs
+Node.js 20+ and either [uv](https://docs.astral.sh/uv/) or Python 3.10-3.14
+with `venv`, and sets the CLI up on first run. It installs prebuilt wheels
+only, so it (and `npx`) fails on Intel Macs and Windows on ARM64, where
+`cryptography` has none; on an Intel Mac, use Homebrew. See
+[npm/README.md](npm/README.md).
 ### Try Without Installing
 ```bash
 uvx deepctl --help
 pipx run deepctl --help
+npx @deepgram/cli --help
 ```
 ## Getting Started
@@ -242,7 +251,7 @@ dg requests --status failed --endpoint listen   # Debug failed requests
 dg api /v1/projects --jq '.projects[0].name'
 # MCP server for AI editors (Claude Code, Cursor, etc.)
-dg mcp --transport sse --port 8000
+dg mcp
 ```
 ## Features
@@ -352,11 +361,11 @@ dg debug probe --port 3100                # Live stream audio analysis
 ### MCP Server
-Connect Deepgram tools to AI coding assistants (Claude Code, Cursor, etc.).
+Give AI coding assistants (Claude Code, Cursor, etc.) Deepgram documentation
+search over stdio.
 ```bash
 dg mcp                                    # Start MCP server (stdio)
-dg mcp --transport sse --port 8000        # SSE transport
 ```
 Add to your editor's MCP config:
@@ -507,57 +516,71 @@ dg plugin remove <package>              # Remove
 Create your own — see the [plugin example](packages/deepctl-plugin-example).
-## Configuration
-**Priority:** CLI flags > environment variables > profile config > project config
+A plugin can't replace a built-in command such as `login` or `debug audio`.
+dg runs the built-in and prints a warning that names the plugin's package.
+A plugin whose entry point is named like a built-in command is skipped before
+it's imported, so none of its code runs; give the entry point a different name.
+To use a plugin's version anyway, list the command in the user config file
+at its standard location (`~/.config/deepctl/config.yaml` on Linux, or
+`$XDG_CONFIG_HOME/deepctl/config.yaml` when `XDG_CONFIG_HOME` is set;
+`~/Library/Application Support/deepctl/config.yaml` on macOS;
+`%LOCALAPPDATA%\deepgram\deepctl\config.yaml` on Windows):
-```bash
-dg login                                 # Interactive or --api-key
-dg login --profile staging --api-key SK  # Named profiles
-dg profiles --list                       # List profiles
-dg profiles --switch staging             # Switch profile
+```yaml
+plugins:
+  allow_override:
+    - login
+    - debug audio
 ```
-For structured output, use `--output json|yaml|table|csv` after leaf commands
-that do not define their own output option, or before any command as a global
-flag: `dg --output json <command>`. `dg speak --output FILE` writes audio to
-`FILE`, so use `dg --output json speak ...` for Speak's structured output.
-## Telemetry
-The CLI phones home anonymous error reports to help us catch crashes and regressions before users have to file an issue. It's **on by default** and easy to turn off.
+dg reads this setting only from that file, never from `deepgram.yaml` or a
+`--config` file. Only allow a plugin you trust: it receives everything you
+pass to that command, including API keys.
-**What's collected:** Python exceptions, stack traces, the CLI version, and the Python runtime. Request bodies, headers, cookies, API keys, email addresses, IP addresses, and usernames are scrubbed before send. No performance traces, no profiling, no replays — errors only.
+## Configuration
-**Where it goes:** the `dx-cli` Sentry project owned by the Deepgram DX team.
+**Priority:** CLI flags > environment variables > project `deepgram.yaml` > user
+config. A project `deepgram.yaml` is read after the user config, but it can set
+only `output.*` settings and a regional Deepgram `base_url` (see below).
-### Opt out
+The API key is the exception: dg uses `--api-key`, then the key `dg login` saved
+in your system keyring, then `DEEPGRAM_API_KEY`, then an `api_key` in the config
+file (where `dg login` saves it when no keyring is available).
-Persistent (recommended) — add this to your `config.yaml`
-(`~/.config/deepctl/config.yaml` on Linux,
-`~/Library/Application Support/deepctl/config.yaml` on macOS,
-`%LOCALAPPDATA%\deepgram\deepctl\config.yaml` on Windows):
+dg sends your API key only to Deepgram API hosts, to hosts you list in
+`api.allowed_hosts` in your own `config.yaml`, or to `DEEPGRAM_BASE_URL` (not in
+an AI agent session). Anything else is refused before a request is made. Hosts
+must use https: plain http works only for localhost, 127.0.0.0/8 and [::1]. For
+a proxy or self-hosted deployment, add its host (and port, to approve only that
+port):
 ```yaml
-telemetry:
-  enabled: false
+api:
+  allowed_hosts:
+    - my-proxy.example.com
+    - localhost:8080
 ```
-One-shot (CI, scripts, single command):
+A project's `deepgram.yaml` can't set credentials, a project ID, a profile or a
+non-Deepgram `base_url`, and can't approve hosts.
 ```bash
-DEEPCTL_TELEMETRY_DISABLED=1 dg listen recording.wav
+dg login                                 # Interactive or --api-key
+dg login --profile staging --api-key SK  # Named profiles
+dg profiles --list                       # List profiles
+dg profiles --switch staging             # Switch profile
 ```
-### Override the destination
+For structured output, use `--output json|yaml|table|csv` after leaf commands
+that do not define their own output option, or before any command as a global
+flag: `dg --output json <command>`. `dg speak --output FILE` writes audio to
+`FILE`, so use `dg --output json speak ...` for Speak's structured output.
-For forks or self-hosted Sentry, point telemetry at your own DSN:
+## Telemetry
-```bash
-export DEEPCTL_TELEMETRY_DSN='https://<key>@<your-sentry>/<project>'
-```
+This version of dg sends no telemetry: no error reports, usage data or other telemetry, whether a command succeeds or fails. dg still contacts the Deepgram API for the commands you run, and pypi.org to check for updates.
-`DEEPCTL_TELEMETRY_DISABLED` always wins. The default DSN is baked into the package and only used when the override is unset.
+The `DEEPCTL_TELEMETRY_DISABLED` environment variable and the `telemetry.enabled` setting in `config.yaml` are still accepted, and the new `--no-telemetry` flag is accepted too, but none of them has an effect in this version. `DEEPCTL_TELEMETRY_DSN` is now ignored unless it points at the local machine, which is for tests. The last line of `dg --help` says that dg sends no telemetry.
 ## Development
@@ -589,7 +612,7 @@ cli/
 │   ├── deepctl-cmd-keys/             # API keys management command for deepctl
 │   ├── deepctl-cmd-listen/           # Listen (live speech-to-text) command for deepctl
 │   ├── deepctl-cmd-login/            # Login command for deepctl
-│   ├── deepctl-cmd-mcp/              # MCP proxy command for deepctl — connects to Deepgram's developer API
+│   ├── deepctl-cmd-mcp/              # MCP server for deepctl: Deepgram documentation search over stdio
 │   ├── deepctl-cmd-members/          # Members management command for deepctl
 │   ├── deepctl-cmd-models/           # Models command for deepctl
 │   ├── deepctl-cmd-plugin/           # Plugin management command for deepctl
@@ -604,7 +627,7 @@ cli/
 │   ├── deepctl-core/                 # Core components for deepctl
 │   ├── deepctl-plugin-example/       # Example plugin for deepctl
 │   ├── deepctl-shared-utils/         # Shared utilities for deepctl
-│   └── deepctl-telemetry/            # Opt-out phone-home telemetry for deepctl
+│   └── deepctl-telemetry/            # Error reporting for deepctl; this version sends no telemetry
 ├── tests/                            # Integration tests
 └── Makefile                          # Development tasks
 ```
@@ -630,7 +653,7 @@ cli/
 | `deepctl listen` | Listen (live speech-to-text) command for deepctl |
 | `deepctl login` | Login command for deepctl |
 | `deepctl logout` | Login command for deepctl |
-| `deepctl mcp` | MCP proxy command for deepctl — connects to Deepgram's developer API |
+| `deepctl mcp` | MCP server for deepctl: Deepgram documentation search over stdio |
 | `deepctl members` | Members management command for deepctl |
 | `deepctl models` | Models command for deepctl |
 | `deepctl plugin` | Plugin management command for deepctl |
@@ -665,7 +688,7 @@ cli/
 | [`deepctl-cmd-keys`](packages/deepctl-cmd-keys) | API keys management command for deepctl |
 | [`deepctl-cmd-listen`](packages/deepctl-cmd-listen) | Listen (live speech-to-text) command for deepctl |
 | [`deepctl-cmd-login`](packages/deepctl-cmd-login) | Login command for deepctl |
-| [`deepctl-cmd-mcp`](packages/deepctl-cmd-mcp) | MCP proxy command for deepctl — connects to Deepgram's developer API |
+| [`deepctl-cmd-mcp`](packages/deepctl-cmd-mcp) | MCP server for deepctl: Deepgram documentation search over stdio |
 | [`deepctl-cmd-members`](packages/deepctl-cmd-members) | Members management command for deepctl |
 | [`deepctl-cmd-models`](packages/deepctl-cmd-models) | Models command for deepctl |
 | [`deepctl-cmd-plugin`](packages/deepctl-cmd-plugin) | Plugin management command for deepctl |
@@ -680,7 +703,7 @@ cli/
 | [`deepctl-core`](packages/deepctl-core) | Core components for deepctl |
 | [`deepctl-plugin-example`](packages/deepctl-plugin-example) | Example plugin for deepctl |
 | [`deepctl-shared-utils`](packages/deepctl-shared-utils) | Shared utilities for deepctl |
-| [`deepctl-telemetry`](packages/deepctl-telemetry) | Opt-out phone-home telemetry for deepctl |
+| [`deepctl-telemetry`](packages/deepctl-telemetry) | Error reporting for deepctl; this version sends no telemetry |
 <!-- END:packages -->
 ## Release

{deepctl-0.3.3 → deepctl-0.4.1}/src/deepctl.egg-info/requires.txt RENAMED Viewed

@@ -1,34 +1,34 @@
 click>=8.0.0
 deepgram-sdk<8,>=7.7.0
-deepctl-core>=0.2.19
-deepctl-cmd-login>=0.1.20
-deepctl-cmd-projects>=0.2.0
+deepctl-core>=0.3.1
+deepctl-cmd-login>=0.2.1
+deepctl-cmd-projects>=0.2.1
 deepctl-cmd-transcribe>=0.1.12
 deepctl-cmd-usage>=0.2.1
-deepctl-cmd-mcp>=0.1.15
-deepctl-cmd-api>=0.0.2
+deepctl-cmd-mcp>=0.1.16
+deepctl-cmd-api>=0.0.3
 deepctl-cmd-debug>=0.1.13
 deepctl-cmd-debug-browser>=0.1.12
 deepctl-cmd-debug-network>=0.1.12
-deepctl-cmd-debug-audio>=0.1.14
-deepctl-cmd-debug-probe>=0.0.2
-deepctl-cmd-debug-toolkit>=0.1.0
-deepctl-cmd-ffprobe>=0.0.3
-deepctl-cmd-update>=0.2.7
-deepctl-cmd-plugin>=0.1.14
-deepctl-cmd-skills>=0.0.9
-deepctl-cmd-init>=0.0.4
+deepctl-cmd-debug-audio>=0.1.15
+deepctl-cmd-debug-probe>=0.0.3
+deepctl-cmd-debug-toolkit>=0.2.0
+deepctl-cmd-ffprobe>=0.0.4
+deepctl-cmd-update>=0.2.8
+deepctl-cmd-plugin>=0.1.15
+deepctl-cmd-skills>=0.0.10
+deepctl-cmd-init>=0.1.1
 deepctl-cmd-models>=0.1.1
-deepctl-cmd-speak>=0.0.5
+deepctl-cmd-speak>=0.0.6
 deepctl-cmd-keys>=0.1.0
 deepctl-cmd-read>=0.1.0
-deepctl-cmd-listen>=0.0.14
+deepctl-cmd-listen>=0.0.15
 deepctl-cmd-requests>=0.1.0
 deepctl-cmd-billing>=0.1.0
 deepctl-cmd-members>=0.1.0
 deepctl-cmd-completion>=0.0.3
-deepctl-shared-utils>=0.1.13
-deepctl-telemetry>=0.0.7
+deepctl-shared-utils>=0.1.14
+deepctl-telemetry>=0.0.8
 pydantic>=2.0.0
 rich>=13.0.0
 httpx>=0.24.0

{deepctl-0.3.3 → deepctl-0.4.1}/LICENSE RENAMED Viewed

File without changes

{deepctl-0.3.3 → deepctl-0.4.1}/setup.cfg RENAMED Viewed

File without changes

{deepctl-0.3.3 → deepctl-0.4.1}/src/deepctl.egg-info/SOURCES.txt RENAMED Viewed

File without changes

{deepctl-0.3.3 → deepctl-0.4.1}/src/deepctl.egg-info/dependency_links.txt RENAMED Viewed

File without changes

{deepctl-0.3.3 → deepctl-0.4.1}/src/deepctl.egg-info/entry_points.txt RENAMED Viewed

File without changes

{deepctl-0.3.3 → deepctl-0.4.1}/src/deepctl.egg-info/top_level.txt RENAMED Viewed

File without changes

deepctl 0.3.3__tar.gz → 0.4.1__tar.gz

deepctl 0.3.3tar.gz → 0.4.1tar.gz