deepctl 0.2.20__tar.gz → 0.2.21__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.20
+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
@@ -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.20 → deepctl-0.2.21}/README.md

@@ -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.20 → deepctl-0.2.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl"
-version = "0.2.20" # 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.20 → 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.20"  # x-release-please-version
+__version__ = "0.2.21"  # x-release-please-version
 __author__ = "Deepgram"
 __email__ = "devrel@deepgram.com"
 __license__ = "MIT"

{deepctl-0.2.20 → 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.20 → deepctl-0.2.21/src/deepctl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.20
+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
@@ -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.20 → 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