deepctl 0.2.20__tar.gz → 0.2.22__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.20
+Version: 0.2.22
 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
@@ -376,6 +377,25 @@ dg usage --last-week -o yaml
 When running in a non-TTY environment (pipes, CI, or AI coding tools), the CLI
 automatically switches to structured JSON output with plain-text status messages.
 
+### Forcing non-interactive mode
+
+Three explicit ways to skip every prompt and run with defaults — useful from a
+real terminal where auto-detection wouldn't otherwise trigger:
+
+```bash
+# Global flag (works at any position)
+dg --non-interactive listen recording.wav
+dg listen --non-interactive recording.wav
+
+# Environment variable (good for whole scripts)
+CI=1 dg listen recording.wav
+```
+
+Also recognised: `--agent-friendly` (alias intended for AI coding tools — same
+effect plus JSON metadata output), and the auto-detected env vars
+`CLAUDECODE`, `CLAUDE_CODE_ENTRYPOINT`, `CODEX_SANDBOX`, and Aider's
+`OR_APP_NAME` / `OR_SITE_URL`.
+
 ## Plugins
 
 Extend the CLI with custom commands.
@@ -402,6 +422,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 +498,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 +575,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.22}/README.md

@@ -295,6 +295,25 @@ dg usage --last-week -o yaml
 When running in a non-TTY environment (pipes, CI, or AI coding tools), the CLI
 automatically switches to structured JSON output with plain-text status messages.
 
+### Forcing non-interactive mode
+
+Three explicit ways to skip every prompt and run with defaults — useful from a
+real terminal where auto-detection wouldn't otherwise trigger:
+
+```bash
+# Global flag (works at any position)
+dg --non-interactive listen recording.wav
+dg listen --non-interactive recording.wav
+
+# Environment variable (good for whole scripts)
+CI=1 dg listen recording.wav
+```
+
+Also recognised: `--agent-friendly` (alias intended for AI coding tools — same
+effect plus JSON metadata output), and the auto-detected env vars
+`CLAUDECODE`, `CLAUDE_CODE_ENTRYPOINT`, `CODEX_SANDBOX`, and Aider's
+`OR_APP_NAME` / `OR_SITE_URL`.
+
 ## Plugins
 
 Extend the CLI with custom commands.
@@ -321,6 +340,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 +416,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 +493,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.22}/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.22" # 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.22}/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.22"  # x-release-please-version
 __author__ = "Deepgram"
 __email__ = "devrel@deepgram.com"
 __license__ = "MIT"

{deepctl-0.2.20 → deepctl-0.2.22}/src/deepctl/main.py

@@ -151,6 +151,13 @@ def preprocess_hyphenated_commands(args: list[str]) -> list[str]:
     is_flag=True,
     help="Show detailed performance timing information",
 )
+@click.option(
+    "--non-interactive",
+    is_flag=True,
+    is_eager=True,
+    expose_value=False,
+    help="Skip interactive prompts; use defaults for any optional features.",
+)
 @click.option(
     "--record-install-method",
     is_eager=True,
@@ -233,6 +240,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.22/src/deepctl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.20
+Version: 0.2.22
 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
@@ -376,6 +377,25 @@ dg usage --last-week -o yaml
 When running in a non-TTY environment (pipes, CI, or AI coding tools), the CLI
 automatically switches to structured JSON output with plain-text status messages.
 
+### Forcing non-interactive mode
+
+Three explicit ways to skip every prompt and run with defaults — useful from a
+real terminal where auto-detection wouldn't otherwise trigger:
+
+```bash
+# Global flag (works at any position)
+dg --non-interactive listen recording.wav
+dg listen --non-interactive recording.wav
+
+# Environment variable (good for whole scripts)
+CI=1 dg listen recording.wav
+```
+
+Also recognised: `--agent-friendly` (alias intended for AI coding tools — same
+effect plus JSON metadata output), and the auto-detected env vars
+`CLAUDECODE`, `CLAUDE_CODE_ENTRYPOINT`, `CODEX_SANDBOX`, and Aider's
+`OR_APP_NAME` / `OR_SITE_URL`.
+
 ## Plugins
 
 Extend the CLI with custom commands.
@@ -402,6 +422,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 +498,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 +575,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.22}/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