Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Features/Research/RsJobsModel.swift3// Description: State of the automated research jobs (an AI coding agent on another machine develops a strategy within budgets the owner sets): runner availability, the list, creation, one job's detail and results, cancellation, and the live log through the Core's SSE stream with reconnection. Every state shown is the server's; creating a job is never retried blindly because the server's route is not idempotent.4import Foundation5import SPWalletCore67@MainActor @Observable final class RsJobsModel {8 let model: AppModel9 private let api: ResearchAPI1011 private(set) var status: ResearchStatus?12 private(set) var statusError: String?13 /// The server's own sentence for the `research_runner` capability (why it is off, when it is).14 private(set) var runnerCapability: ServerCapability?15 private(set) var jobs: [ResearchJob] = []16 private(set) var jobsAt: Date?17 private(set) var jobsError: String?18 private(set) var loading = false1920 var selectedId: String? { didSet { if selectedId != oldValue { selectionChanged() } } }21 private(set) var detail: ResearchJobDetail?22 private(set) var detailAt: Date?23 private(set) var detailError: String?24 private(set) var cancelling = false25 var actionError: String?2627 // log of the selected job28 enum LogLive: Equatable { case idle, connecting, streaming, reconnecting(String), ended }29 private(set) var logLines: [ResearchLogLine] = []30 private(set) var logLive: LogLive = .idle31 private(set) var logTruncated = false32 private var logTask: Task<Void, Never>?33 private static let maxLogLines = 50003435 init(model: AppModel) { self.model = model; api = ResearchAPI(model.client) }3637 var selectedJob: ResearchJob? { detail?.job.id == selectedId ? detail?.job : jobs.first { $0.id == selectedId } }38 var hasOpenJobs: Bool { jobs.contains { !$0.state.isFinal } }39 var canCreate: Bool { model.canOperate && (status.map { $0.openJobs < $0.maxOpenJobs } ?? false) }4041 // MARK: reads4243 func refresh() async {44 guard !loading else { return }45 loading = true; defer { loading = false }46 async let s: Void = loadStatus()47 async let j: Void = loadJobs()48 _ = await (s, j)49 if selectedId != nil { await loadDetail() }50 }5152 private func loadStatus() async {53 do { status = try await api.status(); statusError = nil } catch { statusError = model.describe(error) }54 if let h = try? await MonitorAPI(model.client).health() { runnerCapability = h.capability("research_runner") }55 }5657 private func loadJobs() async {58 do { jobs = try await api.jobs(limit: 100); jobsAt = Date(); jobsError = nil } catch { jobsError = model.describe(error) }59 }6061 func loadDetail() async {62 guard let id = selectedId else { return }63 do {64 let d = try await api.job(id)65 guard id == selectedId else { return }66 detail = d; detailAt = Date(); detailError = nil67 } catch { guard id == selectedId else { return }; detailError = model.describe(error) }68 }6970 private func selectionChanged() {71 logTask?.cancel(); logTask = nil72 detail = nil; detailError = nil; detailAt = nil; logLines = []; logLive = .idle; logTruncated = false; actionError = nil73 guard selectedId != nil else { return }74 Task { await loadDetail() }75 }7677 // MARK: operations7879 /// Creates a job. The server's route has no idempotency key: when the answer is lost, the list is read again and the caller is told to check it before sending anything a second time.80 func create(_ request: ResearchJobRequest) async -> String? {81 guard model.canOperate else { return "Création impossible hors ligne ou sans session." }82 do {83 let job = try await api.create(request)84 await refresh()85 selectedId = job.id86 return nil87 } catch let e as APIError where e.isOffline {88 await loadJobs()89 return "La réponse du serveur a été perdue : la recherche a peut-être été créée. La liste vient d’être relue — vérifiez-la avant de relancer, pour ne pas payer deux fois."90 } catch { return model.describe(error) }91 }9293 func cancel() async {94 guard let id = selectedId, model.canOperate, !cancelling else { return }95 cancelling = true; defer { cancelling = false }96 do {97 let job = try await api.cancel(id)98 if let i = jobs.firstIndex(where: { $0.id == job.id }) { jobs[i] = job }99 actionError = nil100 await loadDetail()101 } catch { actionError = model.describe(error); await loadDetail() }102 }103104 // MARK: live log105106 /// Follows the log of the selected job while its tab is on screen. Call from a `.task`; cancellation stops it.107 func followLog() async {108 guard let id = selectedId else { return }109 var backoff = OpsBackoff()110 var lastEventId: String?111 // what the job has already written, then the stream from there112 if logLines.isEmpty { await readLogPages(id) }113 while !Task.isCancelled, id == selectedId {114 if let s = selectedJob?.state, s.isFinal { await readLogPages(id); logLive = .ended; return }115 guard AppActivity.isActive, model.canOperate else { logLive = .idle; try? await Task.sleep(for: .seconds(3)); continue }116 guard let request = await api.logStreamRequest(id, after: logLines.last?.id ?? 0, lastEventId: lastEventId) else { logLive = .reconnecting("Session absente."); return }117 logLive = .connecting118 var ended = false, delivered = false, failure: String?119 do {120 for try await event in OpsEventStream.events(request, while: { AppActivity.isActive }) {121 if Task.isCancelled || id != selectedId { return }122 if let eid = event.id { lastEventId = eid }123 delivered = true; logLive = .streaming124 switch ResearchLogStreamEvent(event) {125 case .log(let line)?: append([line])126 case .state?: await loadDetail(); await loadJobs()127 case .end?: ended = true128 case nil: break129 }130 if ended { break }131 }132 } catch { failure = model.describe(error) }133 if Task.isCancelled || id != selectedId { return }134 if ended { await loadDetail(); await loadJobs(); logLive = .ended; return }135 if delivered { backoff.reset() }136 await loadDetail()137 let wait = failure == nil && delivered ? Duration.seconds(1) : backoff.next()138 logLive = .reconnecting(failure ?? "Flux terminé par le serveur (dix minutes au plus) ; reprise à la dernière ligne reçue.")139 try? await Task.sleep(for: wait)140 }141 }142143 private func readLogPages(_ id: String) async {144 var after = logLines.last?.id ?? 0145 for _ in 0..<20 { // at most 20 000 lines per catch-up; the view keeps the most recent ones146 guard let page = try? await api.log(id, after: after, limit: 1000), id == selectedId else { return }147 append(page.lines)148 guard page.lines.count == 1000, let last = page.lastId else { return }149 after = last150 }151 }152153 private func append(_ lines: [ResearchLogLine]) {154 let lastId = logLines.last?.id ?? 0155 logLines.append(contentsOf: lines.filter { $0.id > lastId })156 if logLines.count > Self.maxLogLines { logLines.removeFirst(logLines.count - Self.maxLogLines); logTruncated = true }157 }158}159160enum RsJobText {161 static func state(_ s: ResearchState) -> String {162 switch s {163 case .queued: "En file d’attente"164 case .preparing: "Préparation par l’exécuteur"165 case .running: "Agent IA au travail"166 case .evaluating: "Évaluation par le serveur"167 case .submitted: "Stratégie soumise — en attente de votre décision"168 case .failed: "Échouée"169 case .cancelled: "Annulée"170 case .overBudget: "Arrêtée : budget dépassé"171 case .unknown(let r): r172 }173 }174 static func stateNote(_ s: ResearchState) -> String {175 switch s {176 case .queued: "Aucun exécuteur n’a encore pris cette recherche."177 case .preparing, .running: "L’agent n’a accès qu’aux données d’entraînement et de validation ; le serveur garde la période de test."178 case .evaluating: "L’agent a terminé. Le serveur rejoue lui-même la stratégie sur des données que l’agent n’a jamais vues."179 case .submitted: "« Soumise » ne veut dire ni approuvée ni rentable : un brouillon de stratégie attend votre décision, prise ailleurs avec votre passkey."180 case .failed, .cancelled, .overBudget: "État final : rien d’autre ne se produira pour cette recherche."181 case .unknown: "État inconnu de cette version de l’app, affiché tel que servi."182 }183 }184 static func provenance(_ p: ResearchProvenance) -> (Provenance, String) {185 let who = switch p.author { case .agent: "agent IA, non vérifié"; case .server: "serveur"; case .runner: "exécuteur, hors du contrôle de l’agent" }186 return switch p.nature {187 case .observedData: (.verified, "Donnée observée · \(who)")188 case .estimate: (.estimate, "Estimation statistique · \(who)")189 case .simulation: (.simulated, "Simulation (backtest) · \(who)")190 case .generatedAnalysis: (.ai, "Analyse générée par IA · \(who)")191 }192 }193 static func split(_ s: String) -> String {194 switch s { case "train": "Entraînement"; case "validation": "Validation"; case "test": "Test (hors échantillon)"; case "inner_test": "Test interne de l’agent"; default: s }195 }196 static func metric(_ m: String) -> String {197 switch m { case "total_return": "Rendement total"; case "sharpe": "Ratio de Sharpe"; case "max_drawdown": "Repli maximal"; case "trades": "Transactions simulées"; default: m }198 }199 static func stream(_ s: String) -> String {200 switch s { case "out": "agent"; case "err": "agent (erreur)"; case "sys": "exécuteur"; case "api": "serveur"; default: s }201 }202}203