Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: SPChat/Features/Settings/ProvidersSettings.swift3// Description: Settings → Fournisseurs: state, health and model counts of each provider, key test, and set / rotate / revoke of the manageable keys (OpenRouter, Tavily). A key is typed once, sent once, never stored, shown or logged by the app.4import SwiftUI5import SPChatCore67/// State of the Providers pane. A provider key only ever transits through `setKey(_:key:)`, as an argument.8@Observable final class ProvidersModel {9 private(set) var overview: ProvidersOverview?10 private(set) var loadError: String?11 private(set) var loading = false12 /// Providers with a request in flight (test, key change).13 private(set) var busy: Set<String> = []14 /// Result of the last « Tester » of each provider, kept for this window only.15 private(set) var tests: [String: TestOutcome] = [:]16 /// Message of the provider when it refused a key (`422`), shown in the key sheet.17 private(set) var keyError: String?18 @ObservationIgnored private let api: APIClient19 @ObservationIgnored private let catalog: CatalogStore20 @ObservationIgnored private let toasts: ToastCenter2122 /// Answer of `POST /api/providers/{id}/test`, or the error that prevented it.23 struct TestOutcome: Equatable { let ok: Bool; let message: String; let info: JSONValue? }2425 init(env: AppEnvironment) { api = env.api; catalog = env.catalog; toasts = env.toasts }2627 func load() async {28 loading = true; defer { loading = false }29 do { overview = try await api.providers(); loadError = nil }30 catch {31 if Task.isCancelled { return }32 if let e = error as? APIError, e.kind == .cancelled { return }33 loadError = Self.message(error)34 }35 }3637 func test(_ id: String) async {38 busy.insert(id); defer { busy.remove(id) }39 do { let r = try await api.testProvider(id); tests[id] = TestOutcome(ok: r.ok, message: r.message, info: r.info) }40 catch { tests[id] = TestOutcome(ok: false, message: Self.message(error), info: nil) }41 }4243 func clearKeyError() { keyError = nil }4445 /// Sends the key once. Returns true when the provider accepted it; a refusal keeps its message in `keyError`.46 /// A `403 reauth_required` is handled by the client (passkey confirmation, then the request is replayed).47 func setKey(_ id: String, key: String) async -> Bool {48 busy.insert(id); defer { busy.remove(id) }49 keyError = nil50 do {51 try await api.setProviderKey(id, key: key)52 tests[id] = nil53 await refreshAfterKeyChange()54 toasts.show("Clé \(overview?.provider(id)?.name ?? id) enregistrée sur le serveur")55 return true56 } catch {57 keyError = Self.message(error)58 return false59 }60 }6162 func removeKey(_ id: String) async {63 busy.insert(id); defer { busy.remove(id) }64 let name = overview?.provider(id)?.name ?? id65 do {66 let r = try await api.removeProviderKey(id)67 tests[id] = nil68 await refreshAfterKeyChange()69 toasts.show(r.fallback ? "Clé \(name) révoquée — la clé de l'environnement du serveur prend le relais." : "Clé \(name) révoquée — \(name) n'est plus configuré.")70 } catch { toasts.error(error) }71 }7273 func refreshCatalog() async {74 do { try await catalog.refreshCatalog(); await load(); toasts.show("Catalogue actualisé") } catch { toasts.error(error) }75 }7677 private func refreshAfterKeyChange() async {78 await load()79 await catalog.reloadModels()80 await catalog.reloadSettings()81 }8283 private static func message(_ error: Error) -> String { (error as? LocalizedError)?.errorDescription ?? String(describing: error) }84}8586/// Facts of a « Tester » answer that may be shown. `label` (a masked form of the key) is deliberately left out:87/// the only trace of a key ever displayed is the server's `keyHint`.88enum ProviderTestInfo {89 static func facts(_ info: JSONValue?) -> [Fact] {90 guard let o = info?.objectValue else { return [] }91 var out: [Fact] = []92 func usd(_ key: String, _ label: String) { if let v = o[key]?.doubleValue { out.append(Fact(label, Format.usd(v))) } }93 usd("usage", "Consommation totale"); usd("usageDaily", "Aujourd'hui"); usd("usageMonthly", "Ce mois-ci"); usd("limit", "Plafond de la clé"); usd("limitRemaining", "Reste du plafond")94 if let free = o["isFreeTier"]?.boolValue { out.append(Fact("Palier gratuit", free ? "oui" : "non")) }95 if let e = o["expiresAt"]?.stringValue, let d = ServerDate.parse(e) { out.append(Fact("Expiration de la clé", ExplorerText.date(d))) }96 if let c = o["checkedAt"]?.stringValue, let d = ServerDate.parse(c) { out.append(Fact("Vérifié le", ExplorerText.dateTime(d))) }97 return out98 }99}100101struct ProvidersSettings: View {102 @Environment(AppEnvironment.self) private var env103 @State private var model: ProvidersModel?104 @State private var keySheet: ProviderInfo?105 @State private var revoking: ProviderInfo?106107 var body: some View {108 if env.session.phase != .signedIn {109 EmptyStateView(systemImage: "lock", title: "Connexion requise", message: "Connecte-toi avec ta clé d'accès pour voir ces réglages.")110 } else {111 Group {112 if let model { ProvidersPane(model: model, isRefreshing: env.catalog.isRefreshingCatalog, setKey: { keySheet = $0 }, revoke: { revoking = $0 }) }113 else { ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity) }114 }115 .task {116 if model == nil { model = ProvidersModel(env: env) }117 await model?.load()118 }119 .onSync({ $0.providers }) { Task { await model?.load() } }120 .sheet(item: $keySheet) { p in121 if let model { ProviderKeySheet(provider: p, model: model) { keySheet = nil } }122 }123 .confirmationDialog(revoking.map { "Révoquer la clé \($0.name) ?" } ?? "", isPresented: Binding(get: { revoking != nil }, set: { if !$0 { revoking = nil } }), presenting: revoking) { p in124 Button("Révoquer la clé", role: .destructive) { Task { await model?.removeKey(p.id) } }125 Button("Annuler", role: .cancel) {}126 } message: { p in127 Text("La clé enregistrée sur le serveur est effacée. Si une clé existe dans l'environnement du serveur, elle prend le relais ; sinon \(p.name) n'est plus disponible dans les trois apps. Une confirmation par clé d'accès peut être demandée.")128 }129 }130 }131}132133/// The pane itself (no sheet, no dialog): rendered as-is by the snapshot tests.134struct ProvidersPane: View {135 let model: ProvidersModel136 var isRefreshing = false137 let setKey: (ProviderInfo) -> Void138 let revoke: (ProviderInfo) -> Void139140 var body: some View {141 ScrollView {142 VStack(alignment: .leading, spacing: 14) {143 HStack(alignment: .firstTextBaseline) {144 VStack(alignment: .leading, spacing: 3) {145 Text("Fournisseurs").font(DS.F.title).foregroundStyle(DS.C.text)146 Text("Les clés restent sur le serveur : l'app n'en affiche et n'en conserve aucune.").font(DS.F.caption).foregroundStyle(DS.C.muted)147 }148 Spacer()149 if isRefreshing { ProgressView().controlSize(.small) }150 Button { Task { await model.refreshCatalog() } } label: { Label("Actualiser le catalogue", systemImage: "arrow.triangle.2.circlepath") }151 .disabled(isRefreshing).help("Le serveur relit la liste de chaque fournisseur et le catalogue OpenRouter (jusqu'à 2 minutes).")152 }153 if let error = model.loadError { Banner(kind: .error, text: error, actionTitle: "Réessayer") { Task { await model.load() } } }154 if let overview = model.overview {155 ForEach(overview.providers) { p in156 ProviderCard(provider: p, test: model.tests[p.id], busy: model.busy.contains(p.id),157 onTest: { Task { await model.test(p.id) } }, onSetKey: { setKey(p) }, onRevoke: { revoke(p) })158 }159 if let logos = overview.logos, logos.source != nil || logos.license != nil {160 Text("Logos : " + [logos.source, logos.license].compactMap { $0 }.joined(separator: " · "))161 .font(.system(size: 10.5)).foregroundStyle(DS.C.muted).textSelection(.enabled).fixedSize(horizontal: false, vertical: true)162 }163 } else if model.loading {164 ProgressView("Chargement des fournisseurs…").frame(maxWidth: .infinity).padding(.vertical, 40)165 }166 }167 .padding(20).frame(maxWidth: .infinity, alignment: .leading)168 }169 .background(DS.C.bg)170 }171}172173struct ProviderCard: View {174 let provider: ProviderInfo175 let test: ProvidersModel.TestOutcome?176 let busy: Bool177 let onTest: () -> Void178 let onSetKey: () -> Void179 let onRevoke: () -> Void180181 var body: some View {182 VStack(alignment: .leading, spacing: 10) {183 HStack(alignment: .top, spacing: 12) {184 ModelMark(logo: provider.logo ?? provider.id, name: provider.name, size: 24)185 VStack(alignment: .leading, spacing: 3) {186 HStack(spacing: 7) {187 Text(provider.name).font(DS.F.heading).foregroundStyle(DS.C.text)188 Tag(text: provider.kind == "tool" ? "outil" : (provider.kind == "models" ? "modèles" : provider.kind))189 if let r = provider.route { if r == "openrouter" || r == "local" { RouteBadge(route: r) } else { Tag(text: ExplorerText.route(r).lowercased()) } }190 }191 HStack(spacing: 6) {192 Circle().fill(provider.configured ? DS.C.ok : DS.C.muted).frame(width: 6, height: 6).accessibilityHidden(true)193 Text(provider.configured ? "Configuré" : "Non configuré").font(DS.F.caption).foregroundStyle(provider.configured ? DS.C.text2 : DS.C.muted)194 if provider.route == "local" { Text("· Inférence locale MacLustr").font(DS.F.caption).foregroundStyle(DS.C.muted) }195 if let h = provider.health { healthLabel(h) }196 }197 }198 Spacer(minLength: 8)199 if busy { ProgressView().controlSize(.small) }200 Button("Tester", action: onTest).disabled(busy || !provider.configured).help("Vérifie la clé auprès de \(provider.name)")201 .accessibilityLabel("Tester la clé \(provider.name)")202 if provider.manageable {203 Menu {204 Button(provider.keySource == "stored" ? "Remplacer la clé…" : "Définir une clé…", action: onSetKey)205 if provider.keySource == "stored" { Button("Révoquer la clé…", role: .destructive, action: onRevoke) }206 } label: { Text("Clé") }207 .fixedSize().disabled(busy).accessibilityLabel("Gérer la clé \(provider.name)")208 }209 }210 .controlSize(.small)211 FactGrid(rows: facts, columns: 1)212 if let t = test {213 HStack(alignment: .firstTextBaseline, spacing: 6) {214 Image(systemName: t.ok ? "checkmark.circle.fill" : "xmark.octagon.fill").foregroundStyle(t.ok ? DS.C.ok : DS.C.danger)215 Text(t.message.isEmpty ? (t.ok ? "Clé acceptée." : "Le test a échoué.") : t.message).font(DS.F.caption).foregroundStyle(DS.C.text2).textSelection(.enabled).fixedSize(horizontal: false, vertical: true)216 }217 .accessibilityElement(children: .combine)218 let info = ProviderTestInfo.facts(t.info)219 if !info.isEmpty { FactGrid(rows: info, columns: 1) }220 }221 }222 .card(padding: 14)223 }224225 private var facts: [Fact] {226 var rows = [Fact("Clé", provider.keySourceLabel + (provider.keyHint.map { " · \($0)" } ?? ""))]227 if let d = provider.validatedAt { rows.append(Fact("Validée le", ExplorerText.dateTime(d))) }228 if let m = provider.models { rows.append(Fact("Modèles", "\(m.total) au registre · \(m.chat) de chat")) }229 if let s = provider.catalog?["syncedAt"]?.stringValue, let d = ServerDate.parse(s) { rows.append(Fact("Catalogue synchronisé", ExplorerText.dateTime(d))) }230 if provider.manageable { rows.append(Fact("Gestion", "Clé modifiable depuis les apps")) }231 return rows232 }233234 private func healthLabel(_ h: ProviderInfo.Health) -> some View {235 let (text, color): (String, Color) = switch h.state {236 case "ok": ("Service en état", DS.C.ok)237 case "open": ("Suspendu après des échecs" + (h.retryInSec > 0 ? " · nouvel essai dans \(h.retryInSec) s" : ""), DS.C.danger)238 case "degraded", "half-open", "half_open": ("Dégradé", DS.C.warn)239 default: ("État : \(h.state)", DS.C.muted)240 }241 return HStack(spacing: 6) {242 Text("·").foregroundStyle(DS.C.muted)243 Text(text + (h.recentFailures > 0 ? " · \(h.recentFailures) échec\(h.recentFailures > 1 ? "s" : "") récent\(h.recentFailures > 1 ? "s" : "")" : "") + (h.active > 0 ? " · \(h.active) en cours" : ""))244 .font(DS.F.caption).foregroundStyle(color)245 }246 }247}248249/// Key entry: a `SecureField` whose content is cleared from the view state the moment it is sent.250struct ProviderKeySheet: View {251 let provider: ProviderInfo252 let model: ProvidersModel253 let close: () -> Void254 @State private var key = ""255 @State private var sending = false256 @FocusState private var focused: Bool257258 private var isRotation: Bool { provider.keySource == "stored" }259260 var body: some View {261 VStack(alignment: .leading, spacing: 14) {262 HStack(spacing: 10) {263 ModelMark(logo: provider.logo ?? provider.id, name: provider.name, size: 24)264 Text(isRotation ? "Remplacer la clé \(provider.name)" : "Définir la clé \(provider.name)").font(DS.F.heading)265 }266 Text("La clé est vérifiée auprès de \(provider.name), puis enregistrée chiffrée sur le serveur. Elle n'est ni conservée ni affichée par cette app ; une confirmation par clé d'accès peut être demandée.")267 .font(DS.F.caption).foregroundStyle(DS.C.muted).fixedSize(horizontal: false, vertical: true)268 SecureField(provider.id == "local" ? "mlx_sk_…" : "Clé d'API \(provider.name)", text: $key).textFieldStyle(.roundedBorder).focused($focused).disabled(sending).onSubmit(send)269 .accessibilityLabel("Clé d'API \(provider.name)").accessibilityIdentifier("provider-key-field")270 if let error = model.keyError { Banner(kind: .error, text: error) }271 HStack {272 if sending { ProgressView().controlSize(.small); Text("Vérification auprès de \(provider.name)…").font(DS.F.caption).foregroundStyle(DS.C.muted) }273 Spacer()274 Button("Annuler") { key = ""; close() }.keyboardShortcut(.cancelAction)275 Button(isRotation ? "Remplacer" : "Enregistrer", action: send).keyboardShortcut(.defaultAction).buttonStyle(.borderedProminent).tint(DS.C.accent)276 .disabled(sending || key.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty)277 }278 }279 .padding(20).frame(width: 460)280 .onAppear { model.clearKeyError(); focused = true }281 .onDisappear { key = "" }282 }283284 private func send() {285 let value = key.trimmingCharacters(in: .whitespacesAndNewlines)286 guard !value.isEmpty, !sending else { return }287 key = "" // the field no longer holds the key once it is on its way288 sending = true289 Task {290 let ok = await model.setKey(provider.id, key: value)291 sending = false292 if ok { close() } else { focused = true }293 }294 }295}296