feat(keyboard): add clipboard voice command mode

Long-press mic runs ASR as an instruction over eligible clipboard text, with host-confirm recording UI, min-record gate, and light ASR prewarm. Bump CURRENT_PROJECT_VERSION to 53.
2026-08-07 16:08:42 +08:00
parent 98ae211b3d
commit f197b68573
22 changed files with 1362 additions and 124 deletions
@@ -0,0 +1,96 @@
+// ClipboardCommandEligibility.swift
+// OSGKeyboard · Shared
+//
+// Tracks clipboard open-window eligibility (30s from first sighting of a
+// pasteboard change) for opportunity-read UI. Pure timing logic — no UIKit.
+
+import Foundation
+
+public struct ClipboardCommandEligibility: Equatable, Sendable {
+    public var changeCount: Int
+    public var snapshot: String
+    public var startedAt: TimeInterval
+
+    public init(changeCount: Int, snapshot: String, startedAt: TimeInterval = Date().timeIntervalSince1970) {
+        self.changeCount = changeCount
+        self.snapshot = snapshot
+        self.startedAt = startedAt
+    }
+
+    public func isOpen(at now: TimeInterval = Date().timeIntervalSince1970) -> Bool {
+        now - startedAt <= ClipboardMaterialFilter.eligibilityDuration
+    }
+
+    public func remaining(at now: TimeInterval = Date().timeIntervalSince1970) -> TimeInterval {
+        max(0, ClipboardMaterialFilter.eligibilityDuration - (now - startedAt))
+    }
+}
+
+public enum ClipboardCommandEligibilityTracker: Sendable {
+    /// Update eligibility from an opportunity-read sample.
+    /// - Parameters:
+    ///   - changeCount: `UIPasteboard.general.changeCount`
+    ///   - rawText: pasteboard string (may be nil)
+    ///   - previous: last known eligibility
+    ///   - now: clock
+    public static func refresh(
+        changeCount: Int,
+        rawText: String?,
+        previous: ClipboardCommandEligibility?,
+        now: TimeInterval = Date().timeIntervalSince1970
+    ) -> ClipboardCommandEligibility? {
+        guard let rawText else { return nil }
+
+        if let previous, previous.changeCount == changeCount {
+            return previous.isOpen(at: now) ? previous : nil
+        }
+
+        switch ClipboardMaterialFilter.evaluate(rawText) {
+        case .eligible(let snapshot):
+            return ClipboardCommandEligibility(
+                changeCount: changeCount,
+                snapshot: snapshot,
+                startedAt: now
+            )
+        case .rejected:
+            return nil
+        }
+    }
+}
+
+/// In-memory clipboard-command task session (plan §8 layer B). Owned by the keyboard.
+public struct ClipboardCommandTaskSession: Equatable, Sendable {
+    public var snapshot: String
+    public var previousOutput: String?
+    public var lastInsertedText: String?
+    public var expiresAt: TimeInterval
+    public var fieldFingerprint: String?
+
+    public init(
+        snapshot: String,
+        previousOutput: String? = nil,
+        lastInsertedText: String? = nil,
+        expiresAt: TimeInterval,
+        fieldFingerprint: String? = nil
+    ) {
+        self.snapshot = snapshot
+        self.previousOutput = previousOutput
+        self.lastInsertedText = lastInsertedText
+        self.expiresAt = expiresAt
+        self.fieldFingerprint = fieldFingerprint
+    }
+
+    public func isActive(at now: TimeInterval = Date().timeIntervalSince1970) -> Bool {
+        now <= expiresAt
+    }
+
+    public mutating func refreshExpiry(at now: TimeInterval = Date().timeIntervalSince1970) {
+        expiresAt = now + ClipboardMaterialFilter.sessionDuration
+    }
+
+    public mutating func noteSuccessfulInsert(_ text: String, at now: TimeInterval = Date().timeIntervalSince1970) {
+        lastInsertedText = text
+        previousOutput = text
+        refreshExpiry(at: now)
+    }
+}