Skip to content

Fastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows, iOS testflight! Android, Linux waitlist open! A local Wispr Flow alternative. Follow https://x.com/fluidvoiceapp for more

Measure analytics for edits with AI post processing

grohith32716b6dfae023e
diff --git a/Sources/Fluid/Analytics/AnalyticsEvent.swift b/Sources/Fluid/Analytics/AnalyticsEvent.swift
index 81b3a22f..b362f149 100644
--- a/Sources/Fluid/Analytics/AnalyticsEvent.swift
+++ b/Sources/Fluid/Analytics/AnalyticsEvent.swift
@@ -12,6 +12,7 @@ enum AnalyticsEvent: String {
// Dictation
case transcriptionCompleted = "transcription_completed"
case outputDelivered = "output_delivered"
+ case postTranscriptionEdit = "post_transcription_edit"
// Command mode
case commandModeRunCompleted = "command_mode_run_completed"
diff --git a/Sources/Fluid/Analytics/PostTranscriptionEditTracker.swift b/Sources/Fluid/Analytics/PostTranscriptionEditTracker.swift
new file mode 100644
index 00000000..e1574633
--- /dev/null
+++ b/Sources/Fluid/Analytics/PostTranscriptionEditTracker.swift
@@ -0,0 +1,112 @@
+import AppKit
+import Foundation
+
+/// Tracks whether the user immediately edits freshly-typed dictation output (Backspace / Cmd+A).
+/// Privacy: stores only low-cardinality metadata; never stores transcript content.
+actor PostTranscriptionEditTracker {
+ static let shared = PostTranscriptionEditTracker()
+
+ private init() {}
+
+ // MARK: - State
+
+ private struct ActiveWindow {
+ let completedAt: Date
+ let wordsBucket: String
+ let xSeconds: Int
+ let aiUsed: Bool
+ let aiModel: String?
+ let aiProvider: String?
+ let mode: String
+ let outputMethod: String
+ }
+
+ private var active: ActiveWindow?
+
+ // MARK: - Public API
+
+ func markTranscriptionCompleted(
+ mode: String,
+ outputMethod: String,
+ wordsBucket: String,
+ aiUsed: Bool,
+ aiModel: String?,
+ aiProvider: String?
+ ) {
+ let x = Self.xSeconds(forWordsBucket: wordsBucket)
+ guard x > 0 else {
+ self.active = nil
+ return
+ }
+
+ self.active = ActiveWindow(
+ completedAt: Date(),
+ wordsBucket: wordsBucket,
+ xSeconds: x,
+ aiUsed: aiUsed,
+ aiModel: aiUsed ? aiModel : nil,
+ aiProvider: aiUsed ? aiProvider : nil,
+ mode: mode,
+ outputMethod: outputMethod
+ )
+ }
+
+ func handleKeyDown(keyCode: UInt16, modifiers: NSEvent.ModifierFlags) {
+ guard let active else { return }
+
+ let elapsed = Date().timeIntervalSince(active.completedAt)
+ if elapsed < 0 || elapsed > Double(active.xSeconds) {
+ self.active = nil
+ return
+ }
+
+ let action: String?
+ if keyCode == 51 { // Backspace (delete)
+ action = "backspace"
+ } else if keyCode == 0, modifiers.contains(.command) { // Cmd + A
+ action = "cmd_a"
+ } else {
+ action = nil
+ }
+
+ guard let action else { return }
+
+ var props: [String: Any] = [
+ "mode": active.mode,
+ "edit_action": action,
+ "words_bucket": active.wordsBucket,
+ "x_seconds": active.xSeconds,
+ "time_since_completion_bucket": AnalyticsBuckets.bucketSeconds(elapsed),
+ "ai_used": active.aiUsed,
+ "output_method": active.outputMethod,
+ ]
+
+ if let model = active.aiModel {
+ props["ai_model"] = model
+ }
+ if let provider = active.aiProvider {
+ props["ai_provider"] = provider
+ }
+
+ AnalyticsService.shared.capture(.postTranscriptionEdit, properties: props)
+
+ // Single-fire per transcription window.
+ self.active = nil
+ }
+
+ // MARK: - Window mapping
+
+ private static func xSeconds(forWordsBucket bucket: String) -> Int {
+ switch bucket {
+ case "0": return 0
+ case "1-5": return 2
+ case "6-20": return 3
+ case "21-50": return 5
+ case "51-100": return 8
+ case "101-300": return 12
+ case "301+": return 15
+ default: return 5
+ }
+ }
+}
+
diff --git a/Sources/Fluid/ContentView.swift b/Sources/Fluid/ContentView.swift
index 8e265ecf..adbea93c 100644
--- a/Sources/Fluid/ContentView.swift
+++ b/Sources/Fluid/ContentView.swift
@@ -602,6 +602,40 @@ struct ContentView: View {
}
}
+ // MARK: - Analytics helpers
+
+ private func currentDictationAIModelInfo() -> (provider: String?, model: String?) {
+ let providerID = SettingsStore.shared.selectedProviderID
+
+ if providerID == "apple-intelligence" {
+ return (provider: "apple-intelligence", model: "apple-intelligence")
+ }
+
+ let storedSelectedModelByProvider = SettingsStore.shared.selectedModelByProvider
+ let storedSavedProviders = SettingsStore.shared.savedProviders
+
+ let derivedProvider: String
+ let derivedModel: String
+
+ if let saved = storedSavedProviders.first(where: { $0.id == providerID }) {
+ derivedProvider = "custom:\(saved.id)"
+ derivedModel = storedSelectedModelByProvider[derivedProvider] ?? saved.models.first ?? ""
+ } else if providerID == "openai" {
+ derivedProvider = "openai"
+ derivedModel = storedSelectedModelByProvider["openai"] ?? "gpt-4.1"
+ } else if providerID == "groq" {
+ derivedProvider = "groq"
+ derivedModel = storedSelectedModelByProvider["groq"] ?? "llama-3.3-70b-versatile"
+ } else {
+ derivedProvider = providerID
+ derivedModel = storedSelectedModelByProvider[providerID] ?? ""
+ }
+
+ let providerOut = derivedProvider.isEmpty ? nil : derivedProvider
+ let modelOut = derivedModel.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty ? nil : derivedModel
+ return (provider: providerOut, model: modelOut)
+ }
+
// MARK: - Mode Transition Handler
/// Centralized handler for sidebar mode transitions to ensure proper cleanup and state management
@@ -1519,6 +1553,19 @@ struct ContentView: View {
"method": AnalyticsOutputMethod.typed.rawValue,
]
)
+
+ let wordsBucket = AnalyticsBuckets.bucketWords(AnalyticsBuckets.wordCount(in: finalText))
+ let modelInfo = self.currentDictationAIModelInfo()
+ Task {
+ await PostTranscriptionEditTracker.shared.markTranscriptionCompleted(
+ mode: AnalyticsMode.dictation.rawValue,
+ outputMethod: AnalyticsOutputMethod.typed.rawValue,
+ wordsBucket: wordsBucket,
+ aiUsed: shouldUseAI,
+ aiModel: modelInfo.model,
+ aiProvider: modelInfo.provider
+ )
+ }
} else if SettingsStore.shared.copyTranscriptionToClipboard == false,
SettingsStore.shared.saveTranscriptionHistory
{
diff --git a/Sources/Fluid/Services/GlobalHotkeyManager.swift b/Sources/Fluid/Services/GlobalHotkeyManager.swift
index bc9823ba..946c9cd2 100644
--- a/Sources/Fluid/Services/GlobalHotkeyManager.swift
+++ b/Sources/Fluid/Services/GlobalHotkeyManager.swift
@@ -249,6 +249,11 @@ final class GlobalHotkeyManager: NSObject {
switch type {
case .keyDown:
+ // Observe post-transcription edits (do not consume the event).
+ Task {
+ await PostTranscriptionEditTracker.shared.handleKeyDown(keyCode: keyCode, modifiers: eventModifiers)
+ }
+
// Check Escape key first (keyCode 53) - cancels recording and closes mode views
if keyCode == 53, eventModifiers.isEmpty {
var handled = false