agent-cli 0.105.2__tar.gz → 0.106.0__tar.gz

{agent_cli-0.105.2 → agent_cli-0.106.0}/.github/workflows/docker.yml

@@ -49,7 +49,7 @@ jobs:
           fetch-depth: 0  # Full history for version detection
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v4.3.0
+        uses: docker/setup-buildx-action@v4.4.1
 
       - name: Log in to Container Registry
         uses: docker/login-action@v4.5.1
@@ -79,7 +79,7 @@ jobs:
             type=sha,suffix=-${{ matrix.suffix }}
 
       - name: Build and push
-        uses: docker/build-push-action@v7.3.0
+        uses: docker/build-push-action@v7.4.0
         with:
           context: .
           file: ${{ matrix.dockerfile }}
@@ -122,7 +122,7 @@ jobs:
           fetch-depth: 0  # Full history for version detection
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v4.3.0
+        uses: docker/setup-buildx-action@v4.4.1
 
       - name: Log in to Container Registry
         uses: docker/login-action@v4.5.1
@@ -152,7 +152,7 @@ jobs:
             type=sha
 
       - name: Build and push
-        uses: docker/build-push-action@v7.3.0
+        uses: docker/build-push-action@v7.4.0
         with:
           context: .
           file: ${{ matrix.dockerfile }}

{agent_cli-0.105.2 → agent_cli-0.106.0}/.github/workflows/pytest.yml

@@ -43,6 +43,6 @@ jobs:
         run: uv run --extra audio --extra diarization --extra llm --extra rag --extra memory --extra vad --extra faster-whisper --extra piper --extra kokoro --extra server --extra speed --extra test pytest -vvv
       - name: Upload coverage reports to Codecov
         if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
-        uses: codecov/codecov-action@v7.1.0
+        uses: codecov/codecov-action@v7.1.1
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

{agent_cli-0.105.2 → agent_cli-0.106.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-cli
-Version: 0.105.2
+Version: 0.106.0
 Summary: A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.
 Project-URL: Homepage, https://github.com/basnijholt/agent-cli
 Author-email: Bas Nijholt <bas@nijho.lt>

{agent_cli-0.105.2 → agent_cli-0.106.0}/agent_cli/agents/transcribe.py

@@ -477,6 +477,9 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
                     live_preview_config=live_preview_config,
                 )
 
+        if transcript and not transcript.strip():
+            transcript = None
+
         elapsed = time.monotonic() - start_time
 
         # Apply diarization if enabled
@@ -554,6 +557,9 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
                 live=live,
                 context=combined_context,
             )
+            if general_cfg.clipboard and not (processed_transcript or "").strip():
+                # Keep the raw speech recoverable if cleanup overwrote it with blank text.
+                pyperclip.copy(transcript)
 
             # Log transcription if requested
             if transcription_log:
@@ -615,6 +621,21 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
     )
 
 
+def _require_transcript(result: TranscriptResult, provider: str) -> None:
+    """Do not report successful dictation when the backend produced no text."""
+    if not (result.get("transcript") or "").strip():
+        if result.get("raw_transcript"):
+            message = "LLM cleanup returned no text. Retry with --no-llm to use the raw transcript."
+        else:
+            message = f"No transcript returned by {provider}. Check the microphone and ASR server."
+        typer.echo(
+            f"{message} "
+            "If a recording was saved, retry with agent-cli transcribe --last-recording.",
+            err=True,
+        )
+        raise typer.Exit(1)
+
+
 @app.command("transcribe", rich_help_panel="Voice Commands")
 @requires_extras("audio", "llm", process_name="transcribe")
 def transcribe(  # noqa: PLR0912, PLR0911, PLR0915, C901
@@ -896,6 +917,7 @@ def transcribe(  # noqa: PLR0912, PLR0911, PLR0915, C901
             LOGGER.exception("Diarization failed")
             _print_diarization_error(exc)
             raise typer.Exit(1) from None
+        _require_transcript(result, asr_provider)
         if json_output:
             print(json.dumps(result))
         return
@@ -937,6 +959,7 @@ def transcribe(  # noqa: PLR0912, PLR0911, PLR0915, C901
     ):
         return
 
+    result = TranscriptResult(raw_transcript=None, transcript=None, llm_enabled=False)
     # Use context manager before audio setup so --stop can target startup reliably.
     try:
         with process.pid_file_context(process_name), suppress(KeyboardInterrupt):
@@ -992,5 +1015,6 @@ def transcribe(  # noqa: PLR0912, PLR0911, PLR0915, C901
         LOGGER.exception("Diarization failed")
         _print_diarization_error(exc)
         raise typer.Exit(1) from None
+    _require_transcript(result, asr_provider)
     if json_output:
         print(json.dumps(result))

{agent_cli-0.105.2 → agent_cli-0.106.0}/macos/AgentCLI/Sources/AgentCLI/AgentCommandRunner.swift

@@ -252,7 +252,12 @@ final class AgentCommandRunner: ObservableObject {
                 }
             }
 
-            let result = AgentRuntime.shared.runAgentCLI(arguments: commandArguments)
+            let commandResult = AgentRuntime.shared.runAgentCLI(arguments: commandArguments)
+            // A stop acknowledgement may be empty; a completed recording must contain text.
+            // Validate here too because user-installed CLIs can predate the CLI-side check.
+            let result = shouldStartRecording && command.identifier == AgentCommand.toggleTranscription.identifier
+                ? commandResult.requiringTranscript()
+                : commandResult
             let message = Self.statusMessage(for: command, result: result)
             let notificationTitle = Self.notificationTitle(for: command, result: result)
             let notificationBody = Self.notificationBody(for: command, result: result, statusMessage: message)

agent_cli-0.106.0/macos/AgentCLI/Sources/AgentCLI/CommandResult.swift

@@ -0,0 +1,17 @@
+import Foundation
+
+struct CommandResult {
+    let exitCode: Int32
+    let output: String
+
+    func requiringTranscript() -> CommandResult {
+        guard exitCode == 0, output.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {
+            return self
+        }
+        return CommandResult(
+            exitCode: 1,
+            output: "No transcript returned. Check the microphone and ASR server, then try again. "
+                + "If a recording was saved, recover it with agent-cli transcribe --last-recording."
+        )
+    }
+}

{agent_cli-0.105.2 → agent_cli-0.106.0}/macos/AgentCLI/Sources/AgentCLI/VoiceLevelOverlay.swift

@@ -3,7 +3,7 @@ import Foundation
 import SwiftUI
 
 enum VoiceLevelOverlayLayout {
-    static let pillSize = CGSize(width: 147, height: 38)
+    static let pillSize = CGSize(width: 190, height: 38)
     static let textWidth = CGFloat(420)
     static let textHeight = CGFloat(86)
     static let shadowRadius = CGFloat(13)
@@ -72,41 +72,57 @@ struct VoiceLevelOverlayView: View {
             height: VoiceLevelOverlayLayout.panelSize(showsPreviewSpace: showsPreviewSpace).height,
             alignment: .bottom
         )
-        .accessibilityLabel(Text("Voice level"))
+        .accessibilityElement(children: .ignore)
+        .accessibilityLabel(Text(meter.captureState == .recording
+            ? "Recording \(meter.recordingDuration)"
+            : meter.captureState.label))
+        .accessibilityValue(Text(showsPreviewSpace ? preview.text : ""))
     }
 
     private var levelMeter: some View {
-        HStack(alignment: .center, spacing: 3.5) {
+        HStack(spacing: 8) {
+            if meter.captureState == .recording {
+                Text(meter.recordingDuration)
+                    .font(.system(size: 12, weight: .semibold))
+                    .monospacedDigit()
+                waveform
+            } else {
+                ProgressView()
+                    .controlSize(.small)
+                Text(meter.captureState.label)
+                    .font(.system(size: 12, weight: .semibold))
+            }
+        }
+        .foregroundStyle(statusColor)
+        .frame(width: VoiceLevelOverlayLayout.pillSize.width, height: VoiceLevelOverlayLayout.pillSize.height)
+        .background(Capsule().fill(statusColor.opacity(isLightMode ? 0.10 : 0.14)))
+        .background(Capsule().fill(backgroundColor))
+        .overlay(Capsule().stroke(statusColor.opacity(0.55), lineWidth: 1))
+        .shadow(
+            color: shadowColor,
+            radius: VoiceLevelOverlayLayout.shadowRadius,
+            y: VoiceLevelOverlayLayout.shadowYOffset
+        )
+    }
+
+    private var waveform: some View {
+        HStack(alignment: .center, spacing: 2) {
             ForEach(Array(meter.amplitudes.enumerated()), id: \.offset) { _, amplitude in
                 Capsule()
                     .fill(
                         LinearGradient(
                             colors: [
-                                barGradientStart,
-                                barGradientEnd
+                                statusColor.opacity(0.65),
+                                statusColor
                             ],
                             startPoint: .bottom,
                             endPoint: .top
                         )
                     )
-                    .frame(width: 3.5, height: max(5, 25 * amplitude))
+                    .frame(width: 2, height: max(5, 25 * amplitude))
                     .animation(.easeOut(duration: 0.11), value: amplitude)
             }
         }
-        .frame(width: VoiceLevelOverlayLayout.pillSize.width, height: VoiceLevelOverlayLayout.pillSize.height)
-        .background(
-            Capsule()
-                .fill(backgroundColor)
-        )
-        .overlay(
-            Capsule()
-                .stroke(borderColor, lineWidth: 1)
-        )
-        .shadow(
-            color: shadowColor,
-            radius: VoiceLevelOverlayLayout.shadowRadius,
-            y: VoiceLevelOverlayLayout.shadowYOffset
-        )
     }
 
     private var isLightMode: Bool {
@@ -133,12 +149,15 @@ struct VoiceLevelOverlayView: View {
         Color.black.opacity(isLightMode ? 0.16 : 0.24)
     }
 
-    private var barGradientStart: Color {
-        isLightMode ? Color(red: 0.04, green: 0.45, blue: 0.95) : Color(red: 0.18, green: 0.82, blue: 0.92)
-    }
-
-    private var barGradientEnd: Color {
-        isLightMode ? Color(red: 0.07, green: 0.72, blue: 0.68) : Color(red: 0.64, green: 0.96, blue: 0.58)
+    private var statusColor: Color {
+        if meter.captureState == .recording {
+            return isLightMode
+                ? Color(red: 0.04, green: 0.40, blue: 0.18)
+                : Color(red: 0.42, green: 0.91, blue: 0.58)
+        }
+        return isLightMode
+            ? Color(red: 0.62, green: 0.34, blue: 0.0)
+            : Color(red: 1.0, green: 0.74, blue: 0.25)
     }
 }
 
@@ -306,10 +325,28 @@ enum VoiceLevelLog {
     }()
 }
 
+enum VoiceCaptureState {
+    case idle
+    case connecting
+    case recording
+    case waitingForAudio
+
+    var label: String {
+        switch self {
+        case .idle: return "Ready"
+        case .connecting: return "Connecting…"
+        case .recording: return "Recording"
+        case .waitingForAudio: return "Waiting for audio…"
+        }
+    }
+}
+
 final class VoiceLevelMeter: ObservableObject {
     static let shared = VoiceLevelMeter()
 
     @Published private(set) var amplitudes = VoiceLevelMeter.idleAmplitudes
+    @Published private(set) var captureState = VoiceCaptureState.idle
+    @Published private(set) var recordingDuration = "00:00"
 
     private static let barCount = 16
     private static let idleAmplitudes = Array(repeating: CGFloat(0.16), count: barCount)
@@ -319,6 +356,7 @@ final class VoiceLevelMeter: ObservableObject {
     private let levelLogURL: URL
     private let now: () -> Date
     private var timer: Timer?
+    private var recordingStartedAt: Date?
     private var phase = 0.0
     private var smoothedLevel = CGFloat(0.16)
 
@@ -330,6 +368,9 @@ final class VoiceLevelMeter: ObservableObject {
     func start() {
         guard timer == nil else { return }
         VoiceLevelLog.reset(levelLogURL)
+        captureState = .connecting
+        recordingStartedAt = nil
+        recordingDuration = "00:00"
         phase = 0
         smoothedLevel = Self.idleLevel
         amplitudes = Self.idleAmplitudes
@@ -345,13 +386,29 @@ final class VoiceLevelMeter: ObservableObject {
     func stop() {
         timer?.invalidate()
         timer = nil
+        captureState = .idle
+        recordingStartedAt = nil
+        recordingDuration = "00:00"
         phase = 0
         smoothedLevel = Self.idleLevel
         amplitudes = Self.idleAmplitudes
     }
 
-    private func pollLevel() {
-        let level = VoiceLevelLog.latestLevel(from: levelLogURL, now: now()) ?? Self.idleLevel
+    func pollLevel() {
+        guard timer != nil else { return }
+        let now = now()
+        guard let level = VoiceLevelLog.latestLevel(from: levelLogURL, now: now) else {
+            if captureState == .recording {
+                captureState = .waitingForAudio
+            }
+            amplitudes = Self.idleAmplitudes
+            return
+        }
+        captureState = .recording
+        let startedAt = recordingStartedAt ?? now
+        recordingStartedAt = startedAt
+        let elapsedSeconds = max(0, Int(now.timeIntervalSince(startedAt)))
+        recordingDuration = String(format: "%02d:%02d", elapsedSeconds / 60, elapsedSeconds % 60)
         updateDisplay(level: level)
     }
 

agent_cli-0.106.0/macos/AgentCLI/Tests/AgentCLITests/TranscriptionResultTests.swift

@@ -0,0 +1,23 @@
+#if canImport(XCTest)
+import XCTest
+@testable import AgentCLI
+
+final class TranscriptionResultTests: XCTestCase {
+    func testEmptySuccessfulRecordingBecomesFailure() {
+        for output in ["", " \n\t"] {
+            let result = CommandResult(exitCode: 0, output: output).requiringTranscript()
+            XCTAssertNotEqual(result.exitCode, 0)
+            XCTAssertTrue(result.output.contains("No transcript"))
+        }
+    }
+
+    func testTranscriptAndBackendFailureArePreserved() {
+        let success = CommandResult(exitCode: 0, output: "Hello world").requiringTranscript()
+        XCTAssertEqual(success.exitCode, 0)
+        XCTAssertEqual(success.output, "Hello world")
+        let failure = CommandResult(exitCode: 7, output: "Connection lost").requiringTranscript()
+        XCTAssertEqual(failure.exitCode, 7)
+        XCTAssertEqual(failure.output, "Connection lost")
+    }
+}
+#endif

{agent_cli-0.105.2 → agent_cli-0.106.0}/macos/AgentCLI/Tests/AgentCLITests/VoiceLevelMeterTests.swift

@@ -4,6 +4,95 @@ import XCTest
 @testable import AgentCLI
 
 final class VoiceLevelMeterTests: XCTestCase {
+    func testRecordingTimerExcludesStartupAndResetsBetweenRecordings() throws {
+        let logURL = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
+        var now = try XCTUnwrap(Self.iso8601.date(from: "2026-06-04T12:00:00Z"))
+        let meter = VoiceLevelMeter(levelLogURL: logURL, now: { now })
+        defer {
+            meter.stop()
+            try? FileManager.default.removeItem(at: logURL)
+        }
+        meter.start()
+        now = now.addingTimeInterval(10)
+        meter.pollLevel()
+        XCTAssertEqual(meter.recordingDuration, "00:00")
+
+        func publishAudio() throws {
+            try "{\"timestamp\":\"\(Self.iso8601.string(from: now))\",\"level\":0}"
+                .write(to: logURL, atomically: true, encoding: .utf8)
+            meter.pollLevel()
+        }
+        try publishAudio()
+        XCTAssertEqual(meter.recordingDuration, "00:00")
+        now = now.addingTimeInterval(9)
+        try publishAudio()
+        XCTAssertEqual(meter.recordingDuration, "00:09")
+        now = now.addingTimeInterval(56)
+        try publishAudio()
+        XCTAssertEqual(meter.recordingDuration, "01:05")
+        now = now.addingTimeInterval(3600)
+        try publishAudio()
+        XCTAssertEqual(meter.recordingDuration, "61:05")
+
+        meter.stop()
+        XCTAssertEqual(meter.recordingDuration, "00:00")
+        meter.start()
+        try publishAudio()
+        XCTAssertEqual(meter.recordingDuration, "00:00")
+    }
+
+    func testRecordingReadinessFollowsFreshAudioIncludingSilence() throws {
+        let logURL = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
+        var now = try XCTUnwrap(Self.iso8601.date(from: "2026-06-04T12:00:00Z"))
+        let meter = VoiceLevelMeter(levelLogURL: logURL, now: { now })
+        defer {
+            meter.stop()
+            try? FileManager.default.removeItem(at: logURL)
+        }
+
+        // A previous recording must not make a new request look ready.
+        try #"{"timestamp":"2026-06-04T12:00:00Z","level":0.9}"#
+            .write(to: logURL, atomically: true, encoding: .utf8)
+        meter.start()
+        XCTAssertEqual(meter.captureState, .connecting)
+
+        try #"{"timestamp":"2026-06-04T12:00:00Z","level":0}"#
+            .write(to: logURL, atomically: true, encoding: .utf8)
+        meter.pollLevel()
+        XCTAssertEqual(meter.captureState, .recording, "Silent audio still proves capture is running.")
+
+        now = now.addingTimeInterval(2)
+        meter.pollLevel()
+        XCTAssertEqual(meter.captureState, .waitingForAudio)
+
+        try #"{"timestamp":"2026-06-04T12:00:02Z","level":0.6}"#
+            .write(to: logURL, atomically: true, encoding: .utf8)
+        meter.pollLevel()
+        XCTAssertEqual(meter.captureState, .recording)
+
+        meter.stop()
+        meter.pollLevel()
+        XCTAssertEqual(meter.captureState, .idle, "Late polling must not revive a released overlay.")
+        meter.start()
+        XCTAssertEqual(meter.captureState, .connecting)
+    }
+
+    func testConnectingDoesNotAnimateFakeMicrophoneActivity() throws {
+        let logURL = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
+        let meter = VoiceLevelMeter(levelLogURL: logURL)
+        defer {
+            meter.stop()
+            try? FileManager.default.removeItem(at: logURL)
+        }
+        meter.start()
+        let initialAmplitudes = meter.amplitudes
+        meter.pollLevel()
+        XCTAssertEqual(meter.captureState, .connecting)
+        XCTAssertEqual(meter.amplitudes, initialAmplitudes)
+        meter.stop()
+        XCTAssertEqual(meter.captureState, .idle)
+    }
+
     func testDisplayAmplitudesUseSineWaveShape() {
         let amplitudes = VoiceLevelMeter.displayAmplitudes(level: 0.6, phase: 0.22)
 

{agent_cli-0.105.2 → agent_cli-0.106.0}/macos/appcast.xml

@@ -4,6 +4,25 @@
         <title>Agent CLI Updates</title>
         <link>https://github.com/basnijholt/agent-cli</link>
         <description>Signed Agent CLI macOS app updates.</description>
+        <item>
+            <title>0.105.2</title>
+            <pubDate>Tue, 15 Sep 2026 07:58:55 +0000</pubDate>
+            <link>https://github.com/basnijholt/agent-cli</link>
+            <sparkle:version>206</sparkle:version>
+            <sparkle:shortVersionString>0.105.2</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
+            <sparkle:hardwareRequirements>arm64</sparkle:hardwareRequirements>
+            <description sparkle:format="markdown"><![CDATA[## Bug fixes
+
+- Accept M4A, OGG, MP3, and other FFmpeg-supported uploads in the Transformers ASR backend. Transformers and NeMo now share audio preparation, with invalid input reported as HTTP 400. (#644)
+- Normalize stereo, non-16-bit, and non-16 kHz WAV uploads before WAV-only ASR backends read them, preventing incorrect sample interpretation. Standard 16 kHz mono 16-bit WAV uploads pass through unchanged. (#644)
+- Stop FFmpeg conversions when requests are cancelled or conversion times out, then clean up temporary files. Faster-whisper retains native compressed-audio decoding without a system FFmpeg dependency. (#644)
+
+**Full changelog:** https://github.com/basnijholt/agent-cli/compare/v0.105.1...v0.105.2
+
+]]></description>
+            <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.105.2/AgentCLI.zip" length="18490908" type="application/octet-stream" sparkle:edSignature="DQiGmgOiPGeI4S/4tQdoA7mgsAlgN3qHh2Z4SyLpN70Tv/qr7MjBNM1r+FPn6gYdRYhaaK/XcKfWaX01H8F0Bw=="/>
+        </item>
         <item>
             <title>0.105.1</title>
             <pubDate>Tue, 08 Sep 2026 13:10:30 +0000</pubDate>
@@ -193,20 +212,5 @@
 ]]></description>
             <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.102.0/AgentCLI.zip" length="24388215" type="application/octet-stream" sparkle:edSignature="1b3tpgDf/VolJ9MLr0R5N9gPmOkYG7Uf6ZyXQTNLPTfiMeo2malwMj5kzTFcCp7xQr/jijUB7/nRNoSzZiBnCg=="/>
         </item>
-        <item>
-            <title>0.101.0</title>
-            <pubDate>Wed, 10 Jun 2026 18:21:45 +0000</pubDate>
-            <link>https://github.com/basnijholt/agent-cli</link>
-            <sparkle:version>196</sparkle:version>
-            <sparkle:shortVersionString>0.101.0</sparkle:shortVersionString>
-            <sparkle:minimumSystemVersion>13.0</sparkle:minimumSystemVersion>
-            <sparkle:hardwareRequirements>arm64</sparkle:hardwareRequirements>
-            <description sparkle:format="markdown"><![CDATA[## What’s Changed
-
-* Add zellij multiplexer support to agent-cli dev (#590) @basnijholt
-
-]]></description>
-            <enclosure url="https://github.com/basnijholt/agent-cli/releases/download/v0.101.0/AgentCLI.zip" length="22912290" type="application/octet-stream" sparkle:edSignature="9re7kqubAoQgSpsmDvAT/LCWy8/tI1RzR2uGkb+BCwGJbtfvuzDU2ETm/JD+lpQt3Ayik6ULAOv+/5S6JSmdBA=="/>
-        </item>
     </channel>
 </rss>

{agent_cli-0.105.2 → agent_cli-0.106.0}/tests/agents/test_transcribe.py

@@ -36,6 +36,7 @@ async def test_transcribe_main_llm_enabled(
     caplog: pytest.LogCaptureFixture,
 ) -> None:
     """Test the main function of the transcribe agent with LLM enabled."""
+    mock_process_and_update_clipboard.return_value = "Hello world."
     # Mock audio stream
     mock_stream = MagicMock()
     mock_stream.read.return_value = (MagicMock(tobytes=lambda: b"\0" * 1024), False)
@@ -515,6 +516,7 @@ async def test_transcribe_includes_clipboard_context(
     mock_signal_handling_context: MagicMock,
 ) -> None:
     """Ensure clipboard content is forwarded to the LLM context."""
+    mock_process_and_update_clipboard.return_value = "Hello world."
     # Mock audio stream
     mock_stream = MagicMock()
     mock_stream.read.return_value = (MagicMock(tobytes=lambda: b"\0" * 1024), False)

{agent_cli-0.105.2 → agent_cli-0.106.0}/tests/agents/test_transcribe_agent.py

@@ -213,3 +213,64 @@ def test_transcribe_stop_json_cleans_stale_pid(
     assert payload["was_running"] is False
     assert payload["stale_cleaned"] is True
     assert not pid_file.exists()
+
+
+def test_quiet_empty_transcription_fails_without_touching_clipboard() -> None:
+    """An empty ASR result must not look like successful dictation to the app."""
+    with (
+        patch("agent_cli.agents.transcribe.asr.create_transcriber") as create_transcriber,
+        patch("agent_cli.agents.transcribe.process.pid_file_context"),
+        patch("agent_cli.agents.transcribe.setup_devices", return_value=(0, "mic", None)),
+        patch("pyperclip.copy") as copy,
+    ):
+        create_transcriber.return_value = AsyncMock(return_value=None)
+        result = runner.invoke(app, ["transcribe", "--quiet", "--no-llm", "--no-clipboard"])
+    assert result.exit_code != 0
+    assert "No transcript" in result.output
+    copy.assert_not_called()
+
+
+def test_quiet_whitespace_transcription_preserves_clipboard() -> None:
+    """Whitespace from ASR is not dictation and must not erase clipboard text."""
+    with (
+        patch("agent_cli.agents.transcribe.asr.create_transcriber") as create_transcriber,
+        patch("agent_cli.agents.transcribe.process.pid_file_context"),
+        patch("agent_cli.agents.transcribe.setup_devices", return_value=(0, "mic", None)),
+        patch("pyperclip.copy") as copy,
+    ):
+        create_transcriber.return_value = AsyncMock(return_value=" \n\t")
+        result = runner.invoke(app, ["transcribe", "--quiet", "--no-llm", "--clipboard"])
+    assert result.exit_code != 0
+    assert "No transcript" in result.output
+    copy.assert_not_called()
+
+
+def test_empty_file_transcription_fails(tmp_path: Path) -> None:
+    """Recovery must fail visibly too when a saved recording yields no text."""
+    recording = tmp_path / "recording.wav"
+    recording.touch()
+    with patch("agent_cli.agents.transcribe._async_main", new_callable=AsyncMock) as transcribe:
+        transcribe.return_value = {"raw_transcript": None, "transcript": None, "llm_enabled": False}
+        result = runner.invoke(app, ["transcribe", "--from-file", str(recording), "--quiet"])
+    assert result.exit_code != 0
+    assert "No transcript" in result.output
+
+
+def test_empty_llm_cleanup_retains_raw_transcript() -> None:
+    """Failed cleanup must leave recoverable speech, not blank the clipboard."""
+    clipboard = ["previous clipboard"]
+    agent = MagicMock()
+    agent.run = AsyncMock(return_value=MagicMock(output=" \n"))
+    with (
+        patch("agent_cli.agents.transcribe.asr.create_transcriber") as create_transcriber,
+        patch("agent_cli.agents.transcribe.process.pid_file_context"),
+        patch("agent_cli.agents.transcribe.setup_devices", return_value=(0, "mic", None)),
+        patch("agent_cli.services.llm.create_llm_agent", return_value=agent),
+        patch("pyperclip.paste", side_effect=lambda: clipboard[0]),
+        patch("pyperclip.copy", side_effect=lambda text: clipboard.__setitem__(0, text)),
+    ):
+        create_transcriber.return_value = AsyncMock(return_value="recognized speech")
+        result = runner.invoke(app, ["transcribe", "--quiet", "--llm", "--clipboard"])
+    assert result.exit_code != 0
+    assert "LLM" in result.output
+    assert clipboard[0] == "recognized speech"

{agent_cli-0.105.2 → agent_cli-0.106.0}/tests/agents/test_transcribe_recovery.py

@@ -751,7 +751,11 @@ def test_transcribe_command_last_recording_disabled(
         patch("agent_cli.agents.transcribe._async_main", new_callable=AsyncMock) as mock_async_main,
         patch("agent_cli.core.process.pid_file_context") as mock_pid_context,
     ):
-        mock_async_main.return_value = {}
+        mock_async_main.return_value = {
+            "raw_transcript": "hello",
+            "transcript": "hello",
+            "llm_enabled": False,
+        }
 
         # Call transcribe with --last-recording disabled (0)
         transcribe.transcribe(

agent_cli-0.105.2/macos/AgentCLI/Sources/AgentCLI/CommandResult.swift

@@ -1,6 +0,0 @@
-import Foundation
-
-struct CommandResult {
-    let exitCode: Int32
-    let output: String
-}