Rocky
498f407585
Introduce optional Apple account-backed credits with scoped gateway access while preserving local and BYOK paths. Refresh assistant behavior, tests, privacy disclosures, docs, and the website for the 2.0 experience.
97 lines
3.1 KiB
Swift
97 lines
3.1 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?
|
|
/// 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,
|
|
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.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,
|
|
thinkingEnabled: Bool? = nil
|
|
) -> FlowUtteranceRequest {
|
|
FlowUtteranceRequest(
|
|
mode: .aiQuestion,
|
|
aiConversationID: conversationID,
|
|
aiQuestionText: prefilledQuestion,
|
|
aiTaskKind: taskKind,
|
|
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
|
|
}
|
|
}
|
|
}
|