SPB Git

Repository Public

RsJobsModel.swift 10.2 KB 203 lines swift

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
Files main
Menu

Theme