feat: add heartbeat toggle with live RPC control

apps/macos/Sources/Clawdis/AgentRPC.swift

@@ -85,6 +85,26 @@ actor AgentRPC {
         }
     }
 
+    func setHeartbeatsEnabled(_ enabled: Bool) async -> Bool {
+        guard process?.isRunning == true else { return false }
+        do {
+            let payload: [String: Any] = ["type": "set-heartbeats", "enabled": enabled]
+            let data = try JSONSerialization.data(withJSONObject: payload)
+            guard let stdinHandle else { throw RpcError(message: "stdin missing") }
+            stdinHandle.write(data)
+            stdinHandle.write(Data([0x0A]))
+
+            let line = try await nextLine()
+            let parsed = try JSONSerialization.jsonObject(with: Data(line.utf8)) as? [String: Any]
+            if let ok = parsed?["ok"] as? Bool, ok { return true }
+            return false
+        } catch {
+            logger.error("rpc set-heartbeats failed: \(error.localizedDescription, privacy: .public)")
+            await stop()
+            return false
+        }
+    }
+
     // MARK: - Process lifecycle
 
     func start() async throws {

apps/macos/Sources/Clawdis/AppState.swift

@@ -98,6 +98,12 @@ final class AppState: ObservableObject {
 
     @Published var isWorking: Bool = false
     @Published var earBoostActive: Bool = false
+    @Published var heartbeatsEnabled: Bool {
+        didSet {
+            UserDefaults.standard.set(self.heartbeatsEnabled, forKey: heartbeatsEnabledKey)
+            Task { _ = await AgentRPC.shared.setHeartbeatsEnabled(self.heartbeatsEnabled) }
+        }
+    }
 
     private var earBoostTask: Task<Void, Never>?
 
@@ -129,6 +135,12 @@ final class AppState: ObservableObject {
         self.voiceWakeForwardIdentity = UserDefaults.standard.string(forKey: voiceWakeForwardIdentityKey) ?? ""
         self.voiceWakeForwardCommand = UserDefaults.standard
             .string(forKey: voiceWakeForwardCommandKey) ?? defaultVoiceWakeForwardCommand
+        if let storedHeartbeats = UserDefaults.standard.object(forKey: heartbeatsEnabledKey) as? Bool {
+            self.heartbeatsEnabled = storedHeartbeats
+        } else {
+            self.heartbeatsEnabled = true
+            UserDefaults.standard.set(true, forKey: heartbeatsEnabledKey)
+        }
 
         if self.swabbleEnabled && !PermissionManager.voiceWakePermissionsGranted() {
             self.swabbleEnabled = false

apps/macos/Sources/Clawdis/Constants.swift

@@ -22,6 +22,7 @@ let voiceWakeForwardIdentityKey = "clawdis.voiceWakeForwardIdentity"
 let voiceWakeForwardCommandKey = "clawdis.voiceWakeForwardCommand"
 let modelCatalogPathKey = "clawdis.modelCatalogPath"
 let modelCatalogReloadKey = "clawdis.modelCatalogReload"
+let heartbeatsEnabledKey = "clawdis.heartbeatsEnabled"
 let voiceWakeSupported: Bool = ProcessInfo.processInfo.operatingSystemVersion.majorVersion >= 26
 let cliHelperSearchPaths = ["/usr/local/bin", "/opt/homebrew/bin"]
 let defaultVoiceWakeForwardCommand = "clawdis-mac agent --message \"${text}\" --thinking low --session main --deliver"

apps/macos/Sources/Clawdis/MenuBar.swift

@@ -62,6 +62,7 @@ private struct MenuContent: View {
             Toggle(isOn: self.activeBinding) { Text("Clawdis Active") }
             self.relayStatusRow
             self.healthStatusRow
+            Toggle(isOn: self.heartbeatsBinding) { Text("Send heartbeats") }
             Toggle(isOn: self.voiceWakeBinding) { Text("Voice Wake") }
                 .disabled(!voiceWakeSupported)
                 .opacity(voiceWakeSupported ? 1 : 0.5)
@@ -131,6 +132,10 @@ private struct MenuContent: View {
         Binding(get: { !self.state.isPaused }, set: { self.state.isPaused = !$0 })
     }
 
+    private var heartbeatsBinding: Binding<Bool> {
+        Binding(get: { self.state.heartbeatsEnabled }, set: { self.state.heartbeatsEnabled = $0 })
+    }
+
     private var voiceWakeBinding: Binding<Bool> {
         Binding(
             get: { self.state.swabbleEnabled },
@@ -451,7 +456,10 @@ final class AppDelegate: NSObject, NSApplicationDelegate, NSXPCListenerDelegate
         if let state {
             RelayProcessManager.shared.setActive(!state.isPaused)
         }
-        Task { try? await AgentRPC.shared.start() }
+        Task {
+            try? await AgentRPC.shared.start()
+            _ = await AgentRPC.shared.setHeartbeatsEnabled(AppStateStore.shared.heartbeatsEnabled)
+        }
         Task { await HealthStore.shared.refresh(onDemand: true) }
         self.startListener()
         self.scheduleFirstRunOnboardingIfNeeded()