Swift SDK types

public enum ReactorStatus: String, Sendable, CaseIterable {
    case disconnected   // no session, or the last one ended
    case connecting     // the session is being created or adopted
    case waiting        // the session exists; waiting for the runtime, negotiating transport
    case ready          // transport is up: commands can be sent and tracks flow
}

public struct ReactorError: Error, Sendable, Hashable {
    public let code: Code
    public let message: String
    public let recoverable: Bool
    public let status: Int?
    public let operation: String?
    public let retryAfterMS: Double?
    public let timestampMS: Double?
}

do {
    try await reactor.connect()
} catch ReactorError.unauthorized {
    token = try await refresh()          // a specific, actionable failure
} catch let error as ReactorError where error.recoverable {
    try await reactor.reconnect()        // a class of failures, by property
}

public final class Subscription: Sendable {
    public func cancel()
}

do {
    let status = reactor.onStatus { log($0) }
    // handler live
}   // and cancelled here, once `status` goes out of scope

public struct FileRef: Sendable, Hashable, Codable {
    public let uploadID: String
    public let name: String
    public let mimeType: String
    public let size: Int
}

public struct Clip: Sendable, Hashable {
    public let playlistURL: String
    public let sessionID: String?
    public let kind: String?           // "snap" or "recording"
    public let predictedReadyAtMS: Double?
    public let raw: JSONValue
}

public struct DownloadResult: Sendable, Hashable {
    public let path: URL
    public let bytes: Int
    public let segments: Int
}

public struct DownloadProgress: Sendable, Hashable {
    public let done: Int
    public let total: Int
    public var fraction: Double { get }   // done / total, or 0 when total is not known yet
}

public struct CommandReply: Sendable, Hashable {
    public let type: String?
    public let data: JSONValue?

    public func decode<T: Decodable>(_ type: T.Type) throws -> T
}

public struct TokenOptions: Sendable, Hashable, Encodable {
    public var models: [String]?
    public var maxSessions: Int?
    public var expiresAfter: Int?
}

public enum JSONValue: Sendable, Hashable, Codable {
    case string(String)
    case number(Double)
    case bool(Bool)
    case object([String: JSONValue])
    case array([JSONValue])
    case null
}

let args: JSONValue = ["prompt": "a red bicycle", "steps": 20, "tags": ["outdoor", "day"]]