deepctl 0.2.26__tar.gz → 0.3.0__tar.gz

{deepctl-0.2.26/src/deepctl.egg-info → deepctl-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.26
+Version: 0.3.0
 Summary: Official Deepgram CLI for speech recognition and audio intelligence
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -26,13 +26,13 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click>=8.0.0
-Requires-Dist: deepgram-sdk>=7.5.0
-Requires-Dist: deepctl-core>=0.1.10
-Requires-Dist: deepctl-cmd-login>=0.1.10
-Requires-Dist: deepctl-cmd-projects>=0.1.10
+Requires-Dist: deepgram-sdk<8,>=7.7.0
+Requires-Dist: deepctl-core>=0.2.16
+Requires-Dist: deepctl-cmd-login>=0.1.17
+Requires-Dist: deepctl-cmd-projects>=0.2.0
 Requires-Dist: deepctl-cmd-transcribe>=0.1.10
-Requires-Dist: deepctl-cmd-usage>=0.1.10
-Requires-Dist: deepctl-cmd-mcp>=0.1.10
+Requires-Dist: deepctl-cmd-usage>=0.2.0
+Requires-Dist: deepctl-cmd-mcp>=0.1.15
 Requires-Dist: deepctl-cmd-api>=0.0.1
 Requires-Dist: deepctl-cmd-debug>=0.1.10
 Requires-Dist: deepctl-cmd-debug-browser>=0.1.10
@@ -41,21 +41,21 @@ Requires-Dist: deepctl-cmd-debug-audio>=0.1.10
 Requires-Dist: deepctl-cmd-debug-probe>=0.0.1
 Requires-Dist: deepctl-cmd-debug-toolkit>=0.0.1
 Requires-Dist: deepctl-cmd-ffprobe>=0.0.1
-Requires-Dist: deepctl-cmd-update>=0.1.10
+Requires-Dist: deepctl-cmd-update>=0.2.6
 Requires-Dist: deepctl-cmd-plugin>=0.1.10
-Requires-Dist: deepctl-cmd-skills>=0.0.1
+Requires-Dist: deepctl-cmd-skills>=0.0.7
 Requires-Dist: deepctl-cmd-init>=0.0.1
-Requires-Dist: deepctl-cmd-models>=0.0.1
-Requires-Dist: deepctl-cmd-speak>=0.0.1
-Requires-Dist: deepctl-cmd-keys>=0.0.1
-Requires-Dist: deepctl-cmd-read>=0.0.1
-Requires-Dist: deepctl-cmd-listen>=0.0.1
-Requires-Dist: deepctl-cmd-requests>=0.0.1
-Requires-Dist: deepctl-cmd-billing>=0.0.1
-Requires-Dist: deepctl-cmd-members>=0.0.1
+Requires-Dist: deepctl-cmd-models>=0.1.0
+Requires-Dist: deepctl-cmd-speak>=0.0.4
+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-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.1
 Requires-Dist: deepctl-shared-utils>=0.1.10
-Requires-Dist: deepctl-telemetry>=0.0.1
+Requires-Dist: deepctl-telemetry>=0.0.6
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: httpx>=0.24.0
@@ -70,13 +70,14 @@ Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-timeout<3,>=2.3.1; extra == "dev"
 Requires-Dist: responses>=0.23.0; extra == "dev"
 Requires-Dist: ruff>=0.8.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
 Requires-Dist: types-requests>=2.31.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0.0; extra == "dev"
-Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: twine>=7.0.0; extra == "dev"
 Requires-Dist: build>=0.10.0; extra == "dev"
 Dynamic: license-file
 
@@ -157,8 +158,8 @@ dg login
 # Transcribe an audio file
 dg listen recording.wav
 
-# Text-to-speech
-dg speak "Hello from Deepgram" -o hello.mp3
+# Text-to-speech (Flux TTS by default)
+dg speak "Hello from Deepgram" -o hello.wav
 
 # Live microphone transcription
 dg listen --mic
@@ -183,6 +184,10 @@ dg -o json listen standup.mp3 \
 # Live microphone with interim (partial) results
 dg listen --mic --model nova-3 --interim
 
+# Redact sensitive numbers and spell numbers as digits (files or live)
+# Flux STT (v2) accepts --redact numbers|aggressive_numbers; v1 also pci, ssn, …
+dg listen call.wav --redact numbers --numerals
+
 # Raw audio stream from ffmpeg
 ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
   | dg listen --encoding linear16
@@ -214,8 +219,9 @@ dg read earnings.txt --sentiment --summarize --topics
 ### Text-to-speech
 
 ```bash
-# Stream directly to a player
-dg speak "Hello from Deepgram" | ffplay -nodisp -autoexit -
+# Stream directly to a player (Flux TTS streams a WAV; -loglevel error hides
+# ffmpeg's cosmetic end-of-stream notice)
+dg speak "Hello from Deepgram" | ffplay -loglevel error -nodisp -autoexit -
 ```
 
 ### Account & project management
@@ -255,22 +261,30 @@ cat audio.raw | dg listen --encoding linear16 --sample-rate 16000
 
 Convert text to natural speech. Supports file output and piping.
 
-`aura-*` models use the Speak v1 batch REST API. `flux-*` (Flux TTS) models use
-the Speak v2 WebSocket API and stream by default; their raw `linear16` output is
-wrapped in a WAV container so it is directly playable.
+By default `dg speak` uses Flux TTS (`flux-alexis-en`) — the Speak v2 WebSocket
+API, which streams and emits raw audio; its `linear16` output is wrapped in a WAV
+container so it is directly playable. Pass an `aura-*` model to use the Speak v1
+batch REST API instead, which supports containerized formats like MP3.
 
 ```bash
-# Aura (v1, batch REST)
-dg speak "Welcome to Deepgram" -o welcome.mp3
-dg speak --file script.txt -o output.mp3 -m aura-2-luna-en
-echo "Hello" | dg speak -o greeting.mp3
-dg speak "Stream me" | ffplay -nodisp -            # pipe to audio player
-
-# Flux TTS (v2, WebSocket streaming)
-dg speak "Hello from Flux" -m flux-alexis-en -o hello.wav
+# Flux TTS (v2, WebSocket streaming) — the default
+dg speak "Hello from Flux" -o hello.wav
 # Piped audio is a streaming WAV; -loglevel error hides ffmpeg's cosmetic
 # end-of-stream notice (the audio is complete).
-dg speak "Hello from Flux" -m flux-alexis-en | ffplay -loglevel error -nodisp -autoexit -
+dg speak "Hello from Flux" | ffplay -loglevel error -nodisp -autoexit -
+
+# Flux TTS streaming controls (flux-* only): --speed 0.85–1.15 (0.05 steps).
+# --expressivity -2..2 is beta; its default 0 is nominal delivery.
+dg speak "A little slower" --speed 0.9 --expressivity 1 -o slow.wav
+
+# Aura (v1, batch REST) — opt in with -m aura-*; needed for MP3 output
+dg speak "Welcome to Deepgram" -o welcome.mp3 -m aura-2-asteria-en
+dg speak --file script.txt -o output.mp3 -m aura-2-luna-en
+echo "Hello" | dg speak -o greeting.mp3 -m aura-2-asteria-en
+
+# Aura-2 also has Spanish voices (e.g. aura-2-selena-es); run `dg models`
+# for the full, current list.
+dg speak "Hola, bienvenido a Deepgram" -o hola.mp3 -m aura-2-selena-es
 ```
 
 ### Text Intelligence
@@ -374,7 +388,7 @@ export DEEPGRAM_PROJECT_ID="your-project-id"
 
 # Non-interactive usage
 dg listen recording.wav
-dg speak "Deploy complete" -o notification.mp3
+dg speak "Deploy complete" -o notification.mp3 -m aura-2-asteria-en
 dg keys --create --comment "ci-key" --scopes member
 dg keys --delete KEY_ID --yes
 dg read --file report.txt --summarize

{deepctl-0.2.26 → deepctl-0.3.0}/README.md

@@ -75,8 +75,8 @@ dg login
 # Transcribe an audio file
 dg listen recording.wav
 
-# Text-to-speech
-dg speak "Hello from Deepgram" -o hello.mp3
+# Text-to-speech (Flux TTS by default)
+dg speak "Hello from Deepgram" -o hello.wav
 
 # Live microphone transcription
 dg listen --mic
@@ -101,6 +101,10 @@ dg -o json listen standup.mp3 \
 # Live microphone with interim (partial) results
 dg listen --mic --model nova-3 --interim
 
+# Redact sensitive numbers and spell numbers as digits (files or live)
+# Flux STT (v2) accepts --redact numbers|aggressive_numbers; v1 also pci, ssn, …
+dg listen call.wav --redact numbers --numerals
+
 # Raw audio stream from ffmpeg
 ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
   | dg listen --encoding linear16
@@ -132,8 +136,9 @@ dg read earnings.txt --sentiment --summarize --topics
 ### Text-to-speech
 
 ```bash
-# Stream directly to a player
-dg speak "Hello from Deepgram" | ffplay -nodisp -autoexit -
+# Stream directly to a player (Flux TTS streams a WAV; -loglevel error hides
+# ffmpeg's cosmetic end-of-stream notice)
+dg speak "Hello from Deepgram" | ffplay -loglevel error -nodisp -autoexit -
 ```
 
 ### Account & project management
@@ -173,22 +178,30 @@ cat audio.raw | dg listen --encoding linear16 --sample-rate 16000
 
 Convert text to natural speech. Supports file output and piping.
 
-`aura-*` models use the Speak v1 batch REST API. `flux-*` (Flux TTS) models use
-the Speak v2 WebSocket API and stream by default; their raw `linear16` output is
-wrapped in a WAV container so it is directly playable.
+By default `dg speak` uses Flux TTS (`flux-alexis-en`) — the Speak v2 WebSocket
+API, which streams and emits raw audio; its `linear16` output is wrapped in a WAV
+container so it is directly playable. Pass an `aura-*` model to use the Speak v1
+batch REST API instead, which supports containerized formats like MP3.
 
 ```bash
-# Aura (v1, batch REST)
-dg speak "Welcome to Deepgram" -o welcome.mp3
-dg speak --file script.txt -o output.mp3 -m aura-2-luna-en
-echo "Hello" | dg speak -o greeting.mp3
-dg speak "Stream me" | ffplay -nodisp -            # pipe to audio player
-
-# Flux TTS (v2, WebSocket streaming)
-dg speak "Hello from Flux" -m flux-alexis-en -o hello.wav
+# Flux TTS (v2, WebSocket streaming) — the default
+dg speak "Hello from Flux" -o hello.wav
 # Piped audio is a streaming WAV; -loglevel error hides ffmpeg's cosmetic
 # end-of-stream notice (the audio is complete).
-dg speak "Hello from Flux" -m flux-alexis-en | ffplay -loglevel error -nodisp -autoexit -
+dg speak "Hello from Flux" | ffplay -loglevel error -nodisp -autoexit -
+
+# Flux TTS streaming controls (flux-* only): --speed 0.85–1.15 (0.05 steps).
+# --expressivity -2..2 is beta; its default 0 is nominal delivery.
+dg speak "A little slower" --speed 0.9 --expressivity 1 -o slow.wav
+
+# Aura (v1, batch REST) — opt in with -m aura-*; needed for MP3 output
+dg speak "Welcome to Deepgram" -o welcome.mp3 -m aura-2-asteria-en
+dg speak --file script.txt -o output.mp3 -m aura-2-luna-en
+echo "Hello" | dg speak -o greeting.mp3 -m aura-2-asteria-en
+
+# Aura-2 also has Spanish voices (e.g. aura-2-selena-es); run `dg models`
+# for the full, current list.
+dg speak "Hola, bienvenido a Deepgram" -o hola.mp3 -m aura-2-selena-es
 ```
 
 ### Text Intelligence
@@ -292,7 +305,7 @@ export DEEPGRAM_PROJECT_ID="your-project-id"
 
 # Non-interactive usage
 dg listen recording.wav
-dg speak "Deploy complete" -o notification.mp3
+dg speak "Deploy complete" -o notification.mp3 -m aura-2-asteria-en
 dg keys --create --comment "ci-key" --scopes member
 dg keys --delete KEY_ID --yes
 dg read --file report.txt --summarize

{deepctl-0.2.26 → deepctl-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepctl"
-version = "0.2.26" # x-release-please-version
+version = "0.3.0" # x-release-please-version
 description = "Official Deepgram CLI for speech recognition and audio intelligence"
 readme = "README.md"
 license = "MIT"
@@ -34,13 +34,13 @@ keywords = [
 requires-python = ">=3.10"
 dependencies = [
     "click>=8.0.0",
-    "deepgram-sdk>=7.5.0",
-    "deepctl-core>=0.1.10",
-    "deepctl-cmd-login>=0.1.10",
-    "deepctl-cmd-projects>=0.1.10",
+    "deepgram-sdk>=7.7.0,<8",
+    "deepctl-core>=0.2.16",
+    "deepctl-cmd-login>=0.1.17",
+    "deepctl-cmd-projects>=0.2.0",
     "deepctl-cmd-transcribe>=0.1.10",
-    "deepctl-cmd-usage>=0.1.10",
-    "deepctl-cmd-mcp>=0.1.10",
+    "deepctl-cmd-usage>=0.2.0",
+    "deepctl-cmd-mcp>=0.1.15",
     "deepctl-cmd-api>=0.0.1",
     "deepctl-cmd-debug>=0.1.10",
     "deepctl-cmd-debug-browser>=0.1.10",
@@ -49,21 +49,21 @@ dependencies = [
     "deepctl-cmd-debug-probe>=0.0.1",
     "deepctl-cmd-debug-toolkit>=0.0.1",
     "deepctl-cmd-ffprobe>=0.0.1",
-    "deepctl-cmd-update>=0.1.10",
+    "deepctl-cmd-update>=0.2.6",
     "deepctl-cmd-plugin>=0.1.10",
-    "deepctl-cmd-skills>=0.0.1",
+    "deepctl-cmd-skills>=0.0.7",
     "deepctl-cmd-init>=0.0.1",
-    "deepctl-cmd-models>=0.0.1",
-    "deepctl-cmd-speak>=0.0.1",
-    "deepctl-cmd-keys>=0.0.1",
-    "deepctl-cmd-read>=0.0.1",
-    "deepctl-cmd-listen>=0.0.1",
-    "deepctl-cmd-requests>=0.0.1",
-    "deepctl-cmd-billing>=0.0.1",
-    "deepctl-cmd-members>=0.0.1",
+    "deepctl-cmd-models>=0.1.0",
+    "deepctl-cmd-speak>=0.0.4",
+    "deepctl-cmd-keys>=0.1.0",
+    "deepctl-cmd-read>=0.1.0",
+    "deepctl-cmd-listen>=0.0.14",
+    "deepctl-cmd-requests>=0.1.0",
+    "deepctl-cmd-billing>=0.1.0",
+    "deepctl-cmd-members>=0.1.0",
     "deepctl-cmd-completion>=0.0.1",
     "deepctl-shared-utils>=0.1.10",
-    "deepctl-telemetry>=0.0.1",
+    "deepctl-telemetry>=0.0.6",
     "pydantic>=2.0.0",
     "rich>=13.0.0",
     "httpx>=0.24.0",
@@ -82,6 +82,7 @@ dev = [
     "pytest-asyncio>=0.21.0",
     "pytest-cov>=4.0.0",
     "pytest-mock>=3.10.0",
+    "pytest-timeout>=2.3.1,<3",
     "responses>=0.23.0",
     # Code Quality
     "ruff>=0.8.0",
@@ -92,7 +93,9 @@ dev = [
     # Development Tools
     "pre-commit>=3.0.0",
     # Publishing
-    "twine>=4.0.0",
+    # twine <7 rejects Metadata-Version 2.5 (emitted by hatchling), which
+    # silently broke the 0.2.27 publish. Keep local verify == what publishes.
+    "twine>=7.0.0",
     "build>=0.10.0",
 ]
 
@@ -232,6 +235,7 @@ testing = [
     "pytest-asyncio>=0.21.0",
     "pytest-cov>=4.0.0",
     "pytest-mock>=3.10.0",
+    "pytest-timeout>=2.3.1,<3",
     "responses>=0.23.0",
     "deepctl-plugin-example",
 ]
@@ -246,7 +250,9 @@ dev = [
     # Development Tools
     "pre-commit>=3.0.0",
     # Publishing
-    "twine>=4.0.0",
+    # twine <7 rejects Metadata-Version 2.5 (emitted by hatchling), which
+    # silently broke the 0.2.27 publish. Keep local verify == what publishes.
+    "twine>=7.0.0",
     "build>=0.10.0",
 ]
 

{deepctl-0.2.26 → deepctl-0.3.0}/src/deepctl/__init__.py

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

{deepctl-0.2.26 → deepctl-0.3.0}/src/deepctl/main.py

@@ -19,12 +19,18 @@ from deepctl_core import (
     print_timing_summary,
     setup_output,
 )
-from rich.console import Console
+from deepctl_core.output import stderr_console
 from rich.traceback import install
 
 # Install rich traceback for better error messages
 install(show_locals=True)
-console = Console()
+
+# 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
+# stdout into jq. Same console the command layer uses via print_error(), so
+# root-level and command-level diagnostics format identically (including the
+# no-color handling for agentic/CI callers).
+console = stderr_console
 
 
 def _record_install_method_cb(
@@ -281,6 +287,20 @@ def _telemetry_transaction() -> Iterator[None]:
         yield
 
 
+def _safe_console_print(message: str) -> None:
+    """Print a diagnostic to stderr, tolerating a closed/broken stream.
+
+    When `dg` runs as an MCP server, the host can close stdio before the
+    process finishes. A write to the closed stream raises ``BrokenPipeError``
+    (or rich's ``ValueError: I/O operation on closed file``); there is nowhere
+    left to report the message, so swallow it rather than crash on exit.
+    """
+    try:
+        console.print(message)
+    except (BrokenPipeError, OSError, ValueError):
+        pass
+
+
 def main() -> None:
     """Main entry point for the CLI."""
     try:
@@ -347,12 +367,18 @@ def main() -> None:
                 # Preprocess arguments to handle hyphenated commands
                 processed_args = preprocess_hyphenated_commands(args)
 
+            exit_code = 0
             with TimingContext("cli_execution"), _telemetry_transaction():
                 try:
                     cli(args=processed_args, standalone_mode=False)
-                except SystemExit:
-                    # Click calls sys.exit() even in non-standalone mode
-                    pass
+                except SystemExit as exc:
+                    # Click calls sys.exit() even in non-standalone mode, so we
+                    # cannot let this propagate — the notifications and timing
+                    # summary below still need to run. But swallowing the code
+                    # outright made every failure exit 0, which is what broke
+                    # `if dg -o json keys; then ...` in scripts and CI. Carry it
+                    # and re-raise at the end instead.
+                    exit_code = exc.code if isinstance(exc.code, int) else 0
 
         # Print update notifications if available (before timing summary)
         if print_pending_notification is not None:
@@ -366,12 +392,18 @@ def main() -> None:
         if timing_requested:
             print_timing_summary(detailed_timing)
 
-    except KeyboardInterrupt:
-        console.print("\n[yellow]Operation cancelled by user[/yellow]")
+        if exit_code:
+            sys.exit(exit_code)
+
+    except (KeyboardInterrupt, click.exceptions.Abort):
+        # Click wraps a Ctrl-C/Ctrl-D raised inside cli() in Abort when
+        # standalone_mode=False, so a mid-command interrupt arrives here as
+        # Abort, not KeyboardInterrupt. Both are user cancellation: exit 2.
+        _safe_console_print("\n[yellow]Operation cancelled by user[/yellow]")
         sys.exit(2)
     except Exception as e:
-        console.print(f"[red]Error: {e}[/red]")
-        sys.exit(2)
+        _safe_console_print(f"[red]Error: {e}[/red]")
+        sys.exit(1)  # 1 = error; 2 is reserved for user interrupt
 
 
 if __name__ == "__main__":

{deepctl-0.2.26 → deepctl-0.3.0/src/deepctl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepctl
-Version: 0.2.26
+Version: 0.3.0
 Summary: Official Deepgram CLI for speech recognition and audio intelligence
 Author-email: Deepgram <devrel@deepgram.com>
 Maintainer-email: Deepgram <devrel@deepgram.com>
@@ -26,13 +26,13 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: click>=8.0.0
-Requires-Dist: deepgram-sdk>=7.5.0
-Requires-Dist: deepctl-core>=0.1.10
-Requires-Dist: deepctl-cmd-login>=0.1.10
-Requires-Dist: deepctl-cmd-projects>=0.1.10
+Requires-Dist: deepgram-sdk<8,>=7.7.0
+Requires-Dist: deepctl-core>=0.2.16
+Requires-Dist: deepctl-cmd-login>=0.1.17
+Requires-Dist: deepctl-cmd-projects>=0.2.0
 Requires-Dist: deepctl-cmd-transcribe>=0.1.10
-Requires-Dist: deepctl-cmd-usage>=0.1.10
-Requires-Dist: deepctl-cmd-mcp>=0.1.10
+Requires-Dist: deepctl-cmd-usage>=0.2.0
+Requires-Dist: deepctl-cmd-mcp>=0.1.15
 Requires-Dist: deepctl-cmd-api>=0.0.1
 Requires-Dist: deepctl-cmd-debug>=0.1.10
 Requires-Dist: deepctl-cmd-debug-browser>=0.1.10
@@ -41,21 +41,21 @@ Requires-Dist: deepctl-cmd-debug-audio>=0.1.10
 Requires-Dist: deepctl-cmd-debug-probe>=0.0.1
 Requires-Dist: deepctl-cmd-debug-toolkit>=0.0.1
 Requires-Dist: deepctl-cmd-ffprobe>=0.0.1
-Requires-Dist: deepctl-cmd-update>=0.1.10
+Requires-Dist: deepctl-cmd-update>=0.2.6
 Requires-Dist: deepctl-cmd-plugin>=0.1.10
-Requires-Dist: deepctl-cmd-skills>=0.0.1
+Requires-Dist: deepctl-cmd-skills>=0.0.7
 Requires-Dist: deepctl-cmd-init>=0.0.1
-Requires-Dist: deepctl-cmd-models>=0.0.1
-Requires-Dist: deepctl-cmd-speak>=0.0.1
-Requires-Dist: deepctl-cmd-keys>=0.0.1
-Requires-Dist: deepctl-cmd-read>=0.0.1
-Requires-Dist: deepctl-cmd-listen>=0.0.1
-Requires-Dist: deepctl-cmd-requests>=0.0.1
-Requires-Dist: deepctl-cmd-billing>=0.0.1
-Requires-Dist: deepctl-cmd-members>=0.0.1
+Requires-Dist: deepctl-cmd-models>=0.1.0
+Requires-Dist: deepctl-cmd-speak>=0.0.4
+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-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.1
 Requires-Dist: deepctl-shared-utils>=0.1.10
-Requires-Dist: deepctl-telemetry>=0.0.1
+Requires-Dist: deepctl-telemetry>=0.0.6
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: httpx>=0.24.0
@@ -70,13 +70,14 @@ Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-timeout<3,>=2.3.1; extra == "dev"
 Requires-Dist: responses>=0.23.0; extra == "dev"
 Requires-Dist: ruff>=0.8.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
 Requires-Dist: types-requests>=2.31.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0.0; extra == "dev"
-Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: twine>=7.0.0; extra == "dev"
 Requires-Dist: build>=0.10.0; extra == "dev"
 Dynamic: license-file
 
@@ -157,8 +158,8 @@ dg login
 # Transcribe an audio file
 dg listen recording.wav
 
-# Text-to-speech
-dg speak "Hello from Deepgram" -o hello.mp3
+# Text-to-speech (Flux TTS by default)
+dg speak "Hello from Deepgram" -o hello.wav
 
 # Live microphone transcription
 dg listen --mic
@@ -183,6 +184,10 @@ dg -o json listen standup.mp3 \
 # Live microphone with interim (partial) results
 dg listen --mic --model nova-3 --interim
 
+# Redact sensitive numbers and spell numbers as digits (files or live)
+# Flux STT (v2) accepts --redact numbers|aggressive_numbers; v1 also pci, ssn, …
+dg listen call.wav --redact numbers --numerals
+
 # Raw audio stream from ffmpeg
 ffmpeg -i video.mp4 -f s16le -ar 16000 -ac 1 - \
   | dg listen --encoding linear16
@@ -214,8 +219,9 @@ dg read earnings.txt --sentiment --summarize --topics
 ### Text-to-speech
 
 ```bash
-# Stream directly to a player
-dg speak "Hello from Deepgram" | ffplay -nodisp -autoexit -
+# Stream directly to a player (Flux TTS streams a WAV; -loglevel error hides
+# ffmpeg's cosmetic end-of-stream notice)
+dg speak "Hello from Deepgram" | ffplay -loglevel error -nodisp -autoexit -
 ```
 
 ### Account & project management
@@ -255,22 +261,30 @@ cat audio.raw | dg listen --encoding linear16 --sample-rate 16000
 
 Convert text to natural speech. Supports file output and piping.
 
-`aura-*` models use the Speak v1 batch REST API. `flux-*` (Flux TTS) models use
-the Speak v2 WebSocket API and stream by default; their raw `linear16` output is
-wrapped in a WAV container so it is directly playable.
+By default `dg speak` uses Flux TTS (`flux-alexis-en`) — the Speak v2 WebSocket
+API, which streams and emits raw audio; its `linear16` output is wrapped in a WAV
+container so it is directly playable. Pass an `aura-*` model to use the Speak v1
+batch REST API instead, which supports containerized formats like MP3.
 
 ```bash
-# Aura (v1, batch REST)
-dg speak "Welcome to Deepgram" -o welcome.mp3
-dg speak --file script.txt -o output.mp3 -m aura-2-luna-en
-echo "Hello" | dg speak -o greeting.mp3
-dg speak "Stream me" | ffplay -nodisp -            # pipe to audio player
-
-# Flux TTS (v2, WebSocket streaming)
-dg speak "Hello from Flux" -m flux-alexis-en -o hello.wav
+# Flux TTS (v2, WebSocket streaming) — the default
+dg speak "Hello from Flux" -o hello.wav
 # Piped audio is a streaming WAV; -loglevel error hides ffmpeg's cosmetic
 # end-of-stream notice (the audio is complete).
-dg speak "Hello from Flux" -m flux-alexis-en | ffplay -loglevel error -nodisp -autoexit -
+dg speak "Hello from Flux" | ffplay -loglevel error -nodisp -autoexit -
+
+# Flux TTS streaming controls (flux-* only): --speed 0.85–1.15 (0.05 steps).
+# --expressivity -2..2 is beta; its default 0 is nominal delivery.
+dg speak "A little slower" --speed 0.9 --expressivity 1 -o slow.wav
+
+# Aura (v1, batch REST) — opt in with -m aura-*; needed for MP3 output
+dg speak "Welcome to Deepgram" -o welcome.mp3 -m aura-2-asteria-en
+dg speak --file script.txt -o output.mp3 -m aura-2-luna-en
+echo "Hello" | dg speak -o greeting.mp3 -m aura-2-asteria-en
+
+# Aura-2 also has Spanish voices (e.g. aura-2-selena-es); run `dg models`
+# for the full, current list.
+dg speak "Hola, bienvenido a Deepgram" -o hola.mp3 -m aura-2-selena-es
 ```
 
 ### Text Intelligence
@@ -374,7 +388,7 @@ export DEEPGRAM_PROJECT_ID="your-project-id"
 
 # Non-interactive usage
 dg listen recording.wav
-dg speak "Deploy complete" -o notification.mp3
+dg speak "Deploy complete" -o notification.mp3 -m aura-2-asteria-en
 dg keys --create --comment "ci-key" --scopes member
 dg keys --delete KEY_ID --yes
 dg read --file report.txt --summarize

{deepctl-0.2.26 → deepctl-0.3.0}/src/deepctl.egg-info/requires.txt

@@ -1,11 +1,11 @@
 click>=8.0.0
-deepgram-sdk>=7.5.0
-deepctl-core>=0.1.10
-deepctl-cmd-login>=0.1.10
-deepctl-cmd-projects>=0.1.10
+deepgram-sdk<8,>=7.7.0
+deepctl-core>=0.2.16
+deepctl-cmd-login>=0.1.17
+deepctl-cmd-projects>=0.2.0
 deepctl-cmd-transcribe>=0.1.10
-deepctl-cmd-usage>=0.1.10
-deepctl-cmd-mcp>=0.1.10
+deepctl-cmd-usage>=0.2.0
+deepctl-cmd-mcp>=0.1.15
 deepctl-cmd-api>=0.0.1
 deepctl-cmd-debug>=0.1.10
 deepctl-cmd-debug-browser>=0.1.10
@@ -14,21 +14,21 @@ deepctl-cmd-debug-audio>=0.1.10
 deepctl-cmd-debug-probe>=0.0.1
 deepctl-cmd-debug-toolkit>=0.0.1
 deepctl-cmd-ffprobe>=0.0.1
-deepctl-cmd-update>=0.1.10
+deepctl-cmd-update>=0.2.6
 deepctl-cmd-plugin>=0.1.10
-deepctl-cmd-skills>=0.0.1
+deepctl-cmd-skills>=0.0.7
 deepctl-cmd-init>=0.0.1
-deepctl-cmd-models>=0.0.1
-deepctl-cmd-speak>=0.0.1
-deepctl-cmd-keys>=0.0.1
-deepctl-cmd-read>=0.0.1
-deepctl-cmd-listen>=0.0.1
-deepctl-cmd-requests>=0.0.1
-deepctl-cmd-billing>=0.0.1
-deepctl-cmd-members>=0.0.1
+deepctl-cmd-models>=0.1.0
+deepctl-cmd-speak>=0.0.4
+deepctl-cmd-keys>=0.1.0
+deepctl-cmd-read>=0.1.0
+deepctl-cmd-listen>=0.0.14
+deepctl-cmd-requests>=0.1.0
+deepctl-cmd-billing>=0.1.0
+deepctl-cmd-members>=0.1.0
 deepctl-cmd-completion>=0.0.1
 deepctl-shared-utils>=0.1.10
-deepctl-telemetry>=0.0.1
+deepctl-telemetry>=0.0.6
 pydantic>=2.0.0
 rich>=13.0.0
 httpx>=0.24.0
@@ -44,11 +44,12 @@ pytest>=7.0.0
 pytest-asyncio>=0.21.0
 pytest-cov>=4.0.0
 pytest-mock>=3.10.0
+pytest-timeout<3,>=2.3.1
 responses>=0.23.0
 ruff>=0.8.0
 mypy>=1.0.0
 types-PyYAML>=6.0.0
 types-requests>=2.31.0
 pre-commit>=3.0.0
-twine>=4.0.0
+twine>=7.0.0
 build>=0.10.0