deepctl 0.2.19__tar.gz → 0.2.21__tar.gz

{deepctl-0.2.19/src/deepctl.egg-info → deepctl-0.2.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.19
+Version: 0.2.21
 Summary: Official Deepgram CLI for speech recognition and audio intelligence
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -55,6 +55,7 @@ Requires-Dist: deepctl-cmd-billing>=0.0.1
 Requires-Dist: deepctl-cmd-members>=0.0.1
 Requires-Dist: deepctl-cmd-completion>=0.0.1
 Requires-Dist: deepctl-shared-utils>=0.1.10
+Requires-Dist: deepctl-telemetry>=0.0.1
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: httpx>=0.24.0
@@ -176,7 +177,7 @@ dg listen keynote.mp3 --diarize --model nova-3
 dg listen https://cdn.example.com/podcast.mp3
 
 # Pipe to jq for scripting
-dg listen standup.mp3 -o json \
+dg -o json listen standup.mp3 \
   | jq '.results.channels[0].alternatives[0].transcript'
 
 # Live microphone with interim (partial) results
@@ -244,8 +245,8 @@ dg mcp --transport sse --port 8000
 Transcribe audio files, URLs, or live microphone input.
 
 ```bash
-dg transcribe meeting.wav --diarize --smart-format
-dg transcribe https://example.com/audio.mp3 --model nova-3
+dg listen meeting.wav --diarize --smart-format
+dg listen https://example.com/audio.mp3 --model nova-3
 dg listen --mic --model nova-3 --language en-US
 cat audio.raw | dg listen --encoding linear16 --sample-rate 16000
 ```
@@ -361,7 +362,7 @@ export DEEPGRAM_API_KEY="your-key"
 export DEEPGRAM_PROJECT_ID="your-project-id"
 
 # Non-interactive usage
-dg transcribe recording.wav
+dg listen recording.wav
 dg speak "Deploy complete" -o notification.mp3
 dg keys --create --comment "ci-key" --scopes member
 dg keys --delete KEY_ID --yes
@@ -402,6 +403,38 @@ dg profiles --switch staging             # Switch profile
 
 Output format on any command: `--output json|yaml|table|csv`
 
+## 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.
+
+**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.
+
+**Where it goes:** the `dx-cli` Sentry project owned by the Deepgram DX team.
+
+### Opt out
+
+Persistent (recommended):
+
+```bash
+dg config set telemetry.enabled false
+```
+
+One-shot (CI, scripts, single command):
+
+```bash
+DEEPCTL_TELEMETRY_DISABLED=1 dg listen recording.wav
+```
+
+### Override the destination
+
+For forks or self-hosted Sentry, point telemetry at your own DSN:
+
+```bash
+export DEEPCTL_TELEMETRY_DSN='https://<key>@<your-sentry>/<project>'
+```
+
+`DEEPCTL_TELEMETRY_DISABLED` always wins. The default DSN is baked into the package and only used when the override is unset.
+
 ## Development
 
 ```bash
@@ -446,7 +479,8 @@ cli/
 │   ├── deepctl-cmd-usage/            # Usage command for deepctl
 │   ├── deepctl-core/                 # Core components for deepctl
 │   ├── deepctl-plugin-example/       # Example plugin for deepctl
-│   └── deepctl-shared-utils/         # Shared utilities for deepctl
+│   ├── deepctl-shared-utils/         # Shared utilities for deepctl
+│   └── deepctl-telemetry/            # Opt-out phone-home telemetry for deepctl
 ├── tests/                            # Integration tests
 └── Makefile                          # Development tasks
 ```
@@ -522,6 +556,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 |
 <!-- END:packages -->
 
 ## Release

{deepctl-0.2.19 → deepctl-0.2.21}/README.md

@@ -95,7 +95,7 @@ dg listen keynote.mp3 --diarize --model nova-3
 dg listen https://cdn.example.com/podcast.mp3
 
 # Pipe to jq for scripting
-dg listen standup.mp3 -o json \
+dg -o json listen standup.mp3 \
   | jq '.results.channels[0].alternatives[0].transcript'
 
 # Live microphone with interim (partial) results
@@ -163,8 +163,8 @@ dg mcp --transport sse --port 8000
 Transcribe audio files, URLs, or live microphone input.
 
 ```bash
-dg transcribe meeting.wav --diarize --smart-format
-dg transcribe https://example.com/audio.mp3 --model nova-3
+dg listen meeting.wav --diarize --smart-format
+dg listen https://example.com/audio.mp3 --model nova-3
 dg listen --mic --model nova-3 --language en-US
 cat audio.raw | dg listen --encoding linear16 --sample-rate 16000
 ```
@@ -280,7 +280,7 @@ export DEEPGRAM_API_KEY="your-key"
 export DEEPGRAM_PROJECT_ID="your-project-id"
 
 # Non-interactive usage
-dg transcribe recording.wav
+dg listen recording.wav
 dg speak "Deploy complete" -o notification.mp3
 dg keys --create --comment "ci-key" --scopes member
 dg keys --delete KEY_ID --yes
@@ -321,6 +321,38 @@ dg profiles --switch staging             # Switch profile
 
 Output format on any command: `--output json|yaml|table|csv`
 
+## 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.
+
+**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.
+
+**Where it goes:** the `dx-cli` Sentry project owned by the Deepgram DX team.
+
+### Opt out
+
+Persistent (recommended):
+
+```bash
+dg config set telemetry.enabled false
+```
+
+One-shot (CI, scripts, single command):
+
+```bash
+DEEPCTL_TELEMETRY_DISABLED=1 dg listen recording.wav
+```
+
+### Override the destination
+
+For forks or self-hosted Sentry, point telemetry at your own DSN:
+
+```bash
+export DEEPCTL_TELEMETRY_DSN='https://<key>@<your-sentry>/<project>'
+```
+
+`DEEPCTL_TELEMETRY_DISABLED` always wins. The default DSN is baked into the package and only used when the override is unset.
+
 ## Development
 
 ```bash
@@ -365,7 +397,8 @@ cli/
 │   ├── deepctl-cmd-usage/            # Usage command for deepctl
 │   ├── deepctl-core/                 # Core components for deepctl
 │   ├── deepctl-plugin-example/       # Example plugin for deepctl
-│   └── deepctl-shared-utils/         # Shared utilities for deepctl
+│   ├── deepctl-shared-utils/         # Shared utilities for deepctl
+│   └── deepctl-telemetry/            # Opt-out phone-home telemetry for deepctl
 ├── tests/                            # Integration tests
 └── Makefile                          # Development tasks
 ```
@@ -441,6 +474,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 |
 <!-- END:packages -->
 
 ## Release

{deepctl-0.2.19 → deepctl-0.2.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl"
-version = "0.2.19" # x-release-please-version
+version = "0.2.21" # x-release-please-version
 description = "Official Deepgram CLI for speech recognition and audio intelligence"
 readme = "README.md"
 license = "MIT"
@@ -63,6 +63,7 @@ dependencies = [
     "deepctl-cmd-members>=0.0.1",
     "deepctl-cmd-completion>=0.0.1",
     "deepctl-shared-utils>=0.1.10",
+    "deepctl-telemetry>=0.0.1",
     "pydantic>=2.0.0",
     "rich>=13.0.0",
     "httpx>=0.24.0",
@@ -213,6 +214,7 @@ deepctl-cmd-billing = { workspace = true }
 deepctl-cmd-members = { workspace = true }
 deepctl-cmd-completion = { workspace = true }
 deepctl-shared-utils = { workspace = true }
+deepctl-telemetry = { workspace = true }
 deepctl-plugin-example = { workspace = true }
 
 [tool.uv.workspace]

{deepctl-0.2.19 → deepctl-0.2.21}/src/deepctl/__init__.py

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

{deepctl-0.2.19 → deepctl-0.2.21}/src/deepctl/main.py

@@ -233,6 +233,20 @@ 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.
+        try:
+            from deepctl_telemetry import (
+                init_telemetry,
+                install_help_notice,
+            )
+
+            telemetry_config = Config()
+            init_telemetry(telemetry_config)
+            install_help_notice(telemetry_config)
+        except Exception:
+            pass
+
         # Start background update checks (non-blocking)
         try:
             from deepctl_cmd_update.startup_check import (

{deepctl-0.2.19 → deepctl-0.2.21/src/deepctl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.19
+Version: 0.2.21
 Summary: Official Deepgram CLI for speech recognition and audio intelligence
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -55,6 +55,7 @@ Requires-Dist: deepctl-cmd-billing>=0.0.1
 Requires-Dist: deepctl-cmd-members>=0.0.1
 Requires-Dist: deepctl-cmd-completion>=0.0.1
 Requires-Dist: deepctl-shared-utils>=0.1.10
+Requires-Dist: deepctl-telemetry>=0.0.1
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: httpx>=0.24.0
@@ -176,7 +177,7 @@ dg listen keynote.mp3 --diarize --model nova-3
 dg listen https://cdn.example.com/podcast.mp3
 
 # Pipe to jq for scripting
-dg listen standup.mp3 -o json \
+dg -o json listen standup.mp3 \
   | jq '.results.channels[0].alternatives[0].transcript'
 
 # Live microphone with interim (partial) results
@@ -244,8 +245,8 @@ dg mcp --transport sse --port 8000
 Transcribe audio files, URLs, or live microphone input.
 
 ```bash
-dg transcribe meeting.wav --diarize --smart-format
-dg transcribe https://example.com/audio.mp3 --model nova-3
+dg listen meeting.wav --diarize --smart-format
+dg listen https://example.com/audio.mp3 --model nova-3
 dg listen --mic --model nova-3 --language en-US
 cat audio.raw | dg listen --encoding linear16 --sample-rate 16000
 ```
@@ -361,7 +362,7 @@ export DEEPGRAM_API_KEY="your-key"
 export DEEPGRAM_PROJECT_ID="your-project-id"
 
 # Non-interactive usage
-dg transcribe recording.wav
+dg listen recording.wav
 dg speak "Deploy complete" -o notification.mp3
 dg keys --create --comment "ci-key" --scopes member
 dg keys --delete KEY_ID --yes
@@ -402,6 +403,38 @@ dg profiles --switch staging             # Switch profile
 
 Output format on any command: `--output json|yaml|table|csv`
 
+## 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.
+
+**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.
+
+**Where it goes:** the `dx-cli` Sentry project owned by the Deepgram DX team.
+
+### Opt out
+
+Persistent (recommended):
+
+```bash
+dg config set telemetry.enabled false
+```
+
+One-shot (CI, scripts, single command):
+
+```bash
+DEEPCTL_TELEMETRY_DISABLED=1 dg listen recording.wav
+```
+
+### Override the destination
+
+For forks or self-hosted Sentry, point telemetry at your own DSN:
+
+```bash
+export DEEPCTL_TELEMETRY_DSN='https://<key>@<your-sentry>/<project>'
+```
+
+`DEEPCTL_TELEMETRY_DISABLED` always wins. The default DSN is baked into the package and only used when the override is unset.
+
 ## Development
 
 ```bash
@@ -446,7 +479,8 @@ cli/
 │   ├── deepctl-cmd-usage/            # Usage command for deepctl
 │   ├── deepctl-core/                 # Core components for deepctl
 │   ├── deepctl-plugin-example/       # Example plugin for deepctl
-│   └── deepctl-shared-utils/         # Shared utilities for deepctl
+│   ├── deepctl-shared-utils/         # Shared utilities for deepctl
+│   └── deepctl-telemetry/            # Opt-out phone-home telemetry for deepctl
 ├── tests/                            # Integration tests
 └── Makefile                          # Development tasks
 ```
@@ -522,6 +556,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 |
 <!-- END:packages -->
 
 ## Release

{deepctl-0.2.19 → deepctl-0.2.21}/src/deepctl.egg-info/requires.txt

@@ -28,6 +28,7 @@ deepctl-cmd-billing>=0.0.1
 deepctl-cmd-members>=0.0.1
 deepctl-cmd-completion>=0.0.1
 deepctl-shared-utils>=0.1.10
+deepctl-telemetry>=0.0.1
 pydantic>=2.0.0
 rich>=13.0.0
 httpx>=0.24.0