import CoreGraphics import Darwin import Foundation import RealityDriverSupport import Synchronization final class DriverKeyBalance: Sendable { private struct State { var ledger = DriverKeyLedger() var targets: [UInt16: DriverInputTarget] = [:] var interrupted = false var registered: [DriverInputTarget] = [] } private let state = Mutex(State()) func interrupt() { state.withLock { $0.interrupted = true } } func register(pid: Int32, windowID: UInt32) { state.withLock { $0.registered.append(DriverInputTarget(pid: pid, windowID: windowID)) } } func requireRunning() throws { guard !state.withLock({ $0.interrupted }) else { throw DriverError("Safety stop: interrupted; input withheld") } } func down(_ key: UInt16, target: DriverInputTarget) { state.withLock { $0.ledger.keyDown(key, target: target) $0.targets[key] = target } } func up(_ key: UInt16, target: DriverInputTarget) { state.withLock { $0.ledger.keyUp(key, target: target) } } func release() throws { guard !state.withLock({ $0.targets.isEmpty }) else { return } try DriverInput.requireAccess() let deadline = ContinuousClock.now.advanced(by: .seconds(1)) var failures: [String] = [] var sent: Set = [] var neutralSamples = 0 let targets = state.withLock { $0.targets } repeat { let releases = state.withLock { $0.ledger.releases } for release in releases { do { try postUp(key: release.key, target: release.target) up(release.key, target: release.target) sent.insert(release.key) } catch { failures.append("key \(release.key): \(error)") } } let held = Set(targets.keys.filter { CGEventSource.keyState(.combinedSessionState, key: $0) }) // Also cover re-posts consumed upstream of the tail fence, which have no native receipt. for (key, target) in targets.sorted(by: { $0.key < $1.key }) where held.contains(key) && !sent.contains(key) { do { try postUp(key: key, target: target) sent.insert(key) } catch { failures.append("key \(key): \(error)") } } sent.formIntersection(held) let balanced = state.withLock { $0.ledger.releases.isEmpty } neutralSamples = held.isEmpty && balanced ? neutralSamples + 1 : 0 if neutralSamples == 3 || !failures.isEmpty { break } Thread.sleep(forTimeInterval: 0.01) } while ContinuousClock.now < deadline let held = targets.keys.filter { CGEventSource.keyState(.combinedSessionState, key: $0) }.sorted() if !held.isEmpty { failures.append("combined session still holds keys \(held)") } if neutralSamples < 3 { failures.append("combined session key release did not settle") } do { try state.withLock { try $0.ledger.requireBalanced() } } catch { failures.append(String(describing: error)) } guard failures.isEmpty else { throw DriverError("Safety stop: key balance failed: \(failures.joined(separator: "; "))") } } static func recover(key: UInt16, target: DriverInputTarget) throws { try DriverInput.requireAccess() guard target.fixture, !target.panel, !CGEventSource.keyState(.hidSystemState, key: key), CGEventSource.keyState(.combinedSessionState, key: key) else { throw DriverError( "Safety stop: recovery key \(key) must be virtually held, physically up, and target an owned fixture") } try postUp(key: key, target: target) let deadline = ContinuousClock.now.advanced(by: .seconds(1)) while CGEventSource.keyState(.combinedSessionState, key: key), ContinuousClock.now < deadline { Thread.sleep(forTimeInterval: 0.01) } guard !CGEventSource.keyState(.combinedSessionState, key: key) else { throw DriverError("Safety stop: recovery key-up did not release key \(key)") } } private func postUp(key: UInt16, target: DriverInputTarget) throws { do { try Self.postUp(key: key, target: target) } catch { let originalError = error guard target.panel else { throw originalError } // Escape can close the owned panel before a screen reader's balancing up arrives. for candidate in state.withLock({ $0.registered }) { do { try DriverWindowMetadata.requireOwner(pid: candidate.pid, windowID: candidate.windowID) } catch { continue } try Self.postUp(key: key, target: candidate) try FileHandle.standardError.write( contentsOf: Data( "Balanced key \(key) through registered window \(candidate.windowID) after panel \(target.windowID) closed\n" .utf8)) return } throw originalError } } private static func postUp(key: UInt16, target: DriverInputTarget) throws { guard !CGEventSource.keyState(.hidSystemState, key: key) else { throw DriverError("Safety stop: physical key \(key) is held; refusing to release external input") } try DriverWindowMetadata.requireOwner(pid: target.pid, windowID: target.windowID) guard let source = CGEventSource(stateID: .combinedSessionState), let up = CGEvent(keyboardEventSource: source, virtualKey: key, keyDown: false) else { throw DriverError("Could not create balancing key-up for key \(key)") } let held = Set( DriverModifierSequence.modifierKeys.filter { $0 != key && CGEventSource.keyState(.combinedSessionState, key: $0) }) up.flags = CGEventFlags( rawValue: DriverModifierSequence.releasingFlags( key: key, flags: CGEventSource.flagsState(.combinedSessionState).rawValue, heldKeys: held)) up.timestamp = clock_gettime_nsec_np(CLOCK_UPTIME_RAW) // Bypass a screen reader's re-posting tap; never deliver recovery input to the owner's foreground app. up.postToPid(target.pid) } }