Rocky
e5a83843db
Add resilient usage analytics, OOBE gateway flows, clipboard semantic ranking, purchase recovery, style learning, and managed current-information search.
108 lines
3.8 KiB
Swift
108 lines
3.8 KiB
Swift
// FlowUtteranceRequest.swift
|
|
// OSGKeyboard · Shared
|
|
//
|
|
// One keyboard-side start contract for dictation and explicit editing.
|
|
|
|
import Foundation
|
|
|
|
public struct FlowUtteranceRequest: Equatable, Sendable {
|
|
public let mode: FlowUtteranceMode
|
|
public let editSourceText: String?
|
|
public let sourceHistoryEntryID: UUID?
|
|
public let sourceHistoryEntryRevision: Int64?
|
|
public let aiConversationID: UUID?
|
|
/// When set with `.aiQuestion`, host skips ASR and answers this text.
|
|
public let aiQuestionText: String?
|
|
/// Fine-grained managed-gateway intent. Regular questions keep the default.
|
|
public let aiTaskKind: ManagedGatewayTaskKind?
|
|
/// Optional server-audited purpose for managed gateway billing policy.
|
|
public let managedRequestPurpose: ManagedGatewayRequestPurpose?
|
|
/// Required feature discriminator when `managedRequestPurpose == .oobe`.
|
|
public let managedOOBEFeature: ManagedGatewayOOBEFeature?
|
|
/// Clipboard-skill thinking override. Nil keeps AI-mode default (on).
|
|
public let aiThinkingEnabled: Bool?
|
|
|
|
public static let dictation = FlowUtteranceRequest(mode: .dictation)
|
|
|
|
public init(
|
|
mode: FlowUtteranceMode,
|
|
editSourceText: String? = nil,
|
|
sourceHistoryEntryID: UUID? = nil,
|
|
sourceHistoryEntryRevision: Int64? = nil,
|
|
aiConversationID: UUID? = nil,
|
|
aiQuestionText: String? = nil,
|
|
aiTaskKind: ManagedGatewayTaskKind? = nil,
|
|
managedRequestPurpose: ManagedGatewayRequestPurpose? = nil,
|
|
managedOOBEFeature: ManagedGatewayOOBEFeature? = nil,
|
|
aiThinkingEnabled: Bool? = nil
|
|
) {
|
|
self.mode = mode
|
|
self.editSourceText = editSourceText
|
|
self.sourceHistoryEntryID = sourceHistoryEntryID
|
|
self.sourceHistoryEntryRevision = sourceHistoryEntryRevision
|
|
self.aiConversationID = aiConversationID
|
|
self.aiQuestionText = aiQuestionText
|
|
self.aiTaskKind = aiTaskKind
|
|
self.managedRequestPurpose = managedRequestPurpose
|
|
self.managedOOBEFeature = managedOOBEFeature
|
|
self.aiThinkingEnabled = aiThinkingEnabled
|
|
}
|
|
|
|
public static func editLastInput(
|
|
_ reference: EditableInputReference
|
|
) -> FlowUtteranceRequest {
|
|
FlowUtteranceRequest(
|
|
mode: .editLastInput,
|
|
editSourceText: reference.displayText,
|
|
sourceHistoryEntryID: reference.historyEntryID,
|
|
sourceHistoryEntryRevision: reference.historyEntryRevision
|
|
)
|
|
}
|
|
|
|
public var isEdit: Bool { mode == .editLastInput }
|
|
public var isAIQuestion: Bool { mode == .aiQuestion }
|
|
|
|
public static func aiQuestion(
|
|
conversationID: UUID,
|
|
prefilledQuestion: String? = nil,
|
|
taskKind: ManagedGatewayTaskKind = .aiQuestion,
|
|
oobeFeature: ManagedGatewayOOBEFeature? = nil,
|
|
thinkingEnabled: Bool? = nil
|
|
) -> FlowUtteranceRequest {
|
|
FlowUtteranceRequest(
|
|
mode: .aiQuestion,
|
|
aiConversationID: conversationID,
|
|
aiQuestionText: prefilledQuestion,
|
|
aiTaskKind: taskKind,
|
|
managedRequestPurpose: oobeFeature == nil ? nil : .oobe,
|
|
managedOOBEFeature: oobeFeature,
|
|
aiThinkingEnabled: thinkingEnabled
|
|
)
|
|
}
|
|
}
|
|
|
|
public enum FlowUtteranceStartRejection: Equatable, Sendable {
|
|
case pipelineBusy
|
|
case onboardingIncomplete
|
|
case missingAPIKey
|
|
case noFullAccess
|
|
case appGroupUnavailable
|
|
case hostUnavailable
|
|
}
|
|
|
|
public enum FlowUtteranceStartDisposition: Equatable, Sendable {
|
|
case issued(UUID)
|
|
case waitingForHost(UUID)
|
|
case alreadyInFlight(UUID)
|
|
case rejected(FlowUtteranceStartRejection)
|
|
|
|
public var utteranceID: UUID? {
|
|
switch self {
|
|
case .issued(let id), .waitingForHost(let id), .alreadyInFlight(let id):
|
|
return id
|
|
case .rejected:
|
|
return nil
|
|
}
|
|
}
|
|
}
|