SPB Git

Repository Public

AgentDetailStore.swift 11.5 KB 211 lines swift

1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Features/TradingAgents/AgentDetailStore.swift3// Description: Everything one agent's detail screen reads and does. Reads are mode-scoped (one answer never mixes research, paper and real; the Core refuses an answer of another mode) and each read fails on its own, so a failed source shows as unavailable instead of empty. Life-cycle actions (start, pause, resume, stop, revoke, flatten) never need a passkey and never add authority; going real is a separate, passkey-approved flow.4import Foundation5import SPWalletCore67@MainActor @Observable final class AgentDetailStore {8    let model: AppModel9    let api: AgentsAPI10    let id: String1112    private(set) var detail: AgentDetail?13    private(set) var overview: AgentOverview?14    private(set) var loadedAt: Date?15    /// Which mode the mode-scoped lists and figures are shown for.16    var viewMode: AgentMode = .paper { didSet { if oldValue != viewMode { Task { await loadScoped() } } } }17    private(set) var signals: [AgentMode: [AgentSignal]] = [:]18    private(set) var journal: [AgentMode: [AgentJournalEntry]] = [:]19    private(set) var orders: [AgentMode: [AgentOrder]] = [:]20    private(set) var timeline: [AgentMode: [AgentTimelineItem]] = [:]21    private(set) var performance: [AgentMode: AgentPerformance] = [:]22    private(set) var configVersions: [AgentConfigVersion]?23    private(set) var elsewhere: FundsElsewhere?24    private(set) var returns: VaultReturns?25    private(set) var mandateDraft: MandateDraft?26    private(set) var library: [LibraryStrategy]?27    private(set) var job: AgentJob?28    /// Read failures by source ("detail", "orders.paper", "performance.live"…): shown where the data would have been.29    private(set) var errors: [String: String] = [:]3031    private(set) var busy: String?32    var actionError: String?33    var notice: String?34    private var modeChosen = false35    private var returnKeys: [String: String] = [:]3637    init(model: AppModel, id: String) { self.model = model; self.id = id; api = AgentsAPI(model.client) }3839    var agent: Agent? { detail?.agent }40    var summary: AgentSummary? { overview?.summary }41    var isMarketMaking: Bool { (summary?.family ?? agent?.family) == "market_making" }42    var kind: ModeKind { agent.map { ModeKind(agent: $0) } ?? ModeKind(summary?.mode ?? .unknown) }43    /// The modes the server allows for this agent's family; nil = unknown.44    var allowedModes: [AgentMode]? { overview?.familyModes?.modes }45    var hasOpenWork: Bool { (returns?.withdrawals.contains { $0.state.isOpen } ?? false) || (job.map { !$0.status.isFinished } ?? false) || summary?.isWindingDown == true }4647    func error(_ key: String) -> String? { errors[key] }48    private func note<T: Sendable>(_ key: String, _ r: Result<T, Error>) -> T? {49        switch r { case .success(let v): errors[key] = nil; return v; case .failure(let e): errors[key] = model.describe(e); return nil }50    }5152    // MARK: reads5354    func refresh() async {55        guard model.phase == .signedIn else { return }56        let api = api, id = id57        async let d = Result.catching { try await api.detail(id) }58        async let o = Result.catching { try await api.overview(id) }59        if let v = note("detail", await d) { detail = v; loadedAt = Date() }60        if let v = note("overview", await o) { overview = v }61        if !modeChosen, let m = agent?.mode ?? summary?.mode { modeChosen = true; viewMode = m == .unknown ? .paper : m }62        await loadScoped()63        if agent?.hasVault == true { await loadVault() }64        if let j = job, !j.status.isFinished, let v = try? await api.job(j.id) { job = v; if v.status.isFinished { notice = v.status == .done ? "Backtest terminé (simulation sur données historiques). Le rapport est dans l’onglet Stratégie." : "Backtest \(v.status.rawValue)\(v.error.map { " : \($0)" } ?? "")." } }65    }6667    func loadScoped() async {68        let api = api, id = id, m = viewMode69        guard m != .unknown else { return }70        async let s = Result.catching { try await api.signals(id, mode: m, limit: 200).value }71        async let j = Result.catching { try await api.journal(id, mode: m, limit: 300).value }72        async let o = Result.catching { try await api.orders(id, mode: m, limit: 300).value }73        async let t = Result.catching { try await api.timeline(id, mode: m, limit: 200).value }74        if let v = note("signals.\(m.rawValue)", await s) { signals[m] = v }75        if let v = note("journal.\(m.rawValue)", await j) { journal[m] = v }76        if let v = note("orders.\(m.rawValue)", await o) { orders[m] = v }77        if let v = note("timeline.\(m.rawValue)", await t) { timeline[m] = v }78    }7980    /// Performance of paper and of real, each read alone. Research has no performance: its figures are backtest reports.81    func loadPerformance() async {82        let api = api, id = id83        for m in [AgentMode.paper, .live] {84            if let v = note("performance.\(m.rawValue)", await Result.catching { try await api.performance(id, mode: m) }) { performance[m] = v }85        }86    }8788    func loadVault() async {89        let api = api, id = id90        async let e = Result.catching { try await api.fundsElsewhere(id) }91        async let r = Result.catching { try await api.vaultReturns(id) }92        if let v = note("elsewhere", await e) { elsewhere = v }93        if let v = note("returns", await r) { returns = v }94    }9596    func loadConfig() async {97        let api = api, id = id98        if let v = note("configVersions", await Result.catching { try await api.configVersions(id) }) { configVersions = v }99        if let v = note("mandateDraft", await Result.catching { try await api.mandateDraft(id, locale: "fr") }) { mandateDraft = v }100    }101102    func loadLibrary() async {103        let api = api, perp = agent?.resolvedKind == .perp104        if let v = note("library", await Result.catching { perp ? try await api.perpStrategyLibrary() : try await api.strategyLibrary() }) { library = v }105    }106107    /// Polls while the screen is visible: faster while something is in flight (a vault return, a backtest, a wind-down).108    func poll() async {109        await refresh()110        while !Task.isCancelled {111            try? await Task.sleep(for: .seconds(hasOpenWork ? 4 : 20))112            guard !Task.isCancelled else { return }113            if AppActivity.isActive, !model.isOffline, busy == nil { await refresh() }114        }115    }116117    // MARK: operations (none needs a passkey; none adds authority)118119    private func run(_ name: String, _ body: () async throws -> String?) async {120        guard busy == nil, model.canOperate else { return }121        busy = name; actionError = nil; notice = nil122        do { notice = try await body() } catch { actionError = model.describe(error) }123        busy = nil124        await refresh()125    }126127    /// Research and paper only. Real is reached by approving a mandate, or by starting under a mandate already in force (see `startLive`).128    func start(_ mode: AgentMode) async {129        guard mode == .research || mode == .paper else { return }130        let api = api, id = id131        await run("start") { let s = try await api.start(id, mode: mode); return "Agent démarré — état du serveur : \(AgentText.phase(s.phase)), mode \(ModeKind(s.mode).short)." }132    }133134    /// Starts in real under a mandate ALREADY approved by the owner and in force. It can never create or approve one: without it the server answers `mandate_required`.135    func startLive() async {136        let api = api, id = id137        await run("startLive") { let s = try await api.start(id, mode: .live); return "État du serveur : \(AgentText.phase(s.phase)), mode \(ModeKind(s.mode).short)." }138    }139140    func pause() async {141        let api = api, id = id142        await run("pause") { let s = try await api.pause(id); return "Agent en pause — état du serveur : \(AgentText.phase(s.phase))." }143    }144145    func resume() async {146        let api = api, id = id147        await run("resume") { let s = try await api.resume(id); return "Agent relancé — état du serveur : \(AgentText.phase(s.phase)), mode \(ModeKind(s.mode).short)." }148    }149150    func stop() async {151        let api = api, id = id152        await run("stop") {153            let s = try await api.stop(id)154            return s.isWindingDown ? "Arrêt demandé : le mandat est révoqué et les positions sont en cours de fermeture (ordres réducteurs seulement). L’agent reste « arrêt en cours » jusqu’à la fin." : "Agent arrêté — état du serveur : \(AgentText.phase(s.phase))."155        }156    }157158    /// Spot: revokes the mandate at the signer and stops the agent. Final; a new mandate needs the passkey again.159    func revokeSpotMandate() async {160        let api = api, id = id161        await run("revoke") { let a = try await api.revokeMandate(id); return "Mandat révoqué au signataire — état du serveur : \(AgentText.phase(a.state))." }162    }163164    func flattenPaper() async {165        let api = api, id = id166        await run("flatten") { let r = try await api.flattenPerpPaper(id); return "Compte PAPIER : \(r.orders.count) ordre(s) réducteur(s) simulé(s), \(r.positionsLeft) position(s) restante(s)." }167    }168169    func register(_ s: LibraryStrategy) async {170        let api = api, id = id171        await run("register") { let r = try await api.registerStrategy(id, s); return "Version \(s.meta.name) \(s.meta.version) rattachée (état : \(r.status)). Son backtest démarre ; rien n’est approuvé." }172    }173174    func approveVersion(_ v: StrategyVersion) async {175        let api = api, id = id176        await run("approveVersion") { _ = try await api.approveStrategyVersion(agentId: id, versionId: v.id); return "Version \(v.name) \(v.version) approuvée pour le papier. Cela ne donne aucune autorité sur des fonds." }177    }178179    func backtest(versionId: String?) async {180        let api = api, id = id181        guard busy == nil, model.canOperate else { return }182        busy = "backtest"; actionError = nil; notice = nil183        do { let r = try await api.requestBacktest(id, versionId: versionId); job = r.job; notice = "Backtest en file (\(r.label)) : simulation sur données historiques." } catch { actionError = model.describe(error) }184        busy = nil185    }186187    /// The WHOLE balance of one asset of the vault, to the owner's own address — the only destination the signer signs for a vault.188    func returnToOwner(asset: String, network: String?) async {189        let api = api, id = id, k = "\(network ?? "")|\(asset)"190        let key = returnKeys[k] ?? UUID().uuidString.lowercased(); returnKeys[k] = key191        await run("return") {192            let r = try await api.returnToOwner(id, asset: asset, network: network, idempotencyKey: key)193            return (r.duplicate == true ? "Ce retour existait déjà (rien de nouveau n’a été signé). " : "") + "Retour de \(Fmt.amount(r.amount)) \(r.symbol) : \(AgentText.returnState(r.state)). Suivez-le ci-dessous jusqu’à la confirmation de la chaîne."194        }195        if actionError == nil { returnKeys[k] = nil }196    }197198    func updateConfig(config: [String: JSONValue]?, risk: [String: JSONValue]?) async -> Bool {199        let api = api, id = id200        await run("config") { let r = try await api.updateConfig(id, config: config, risk: risk); return "Configuration enregistrée : version \(r.configVersion)." }201        if actionError == nil { await loadConfig() }202        return actionError == nil203    }204205    func setPerpRisk(_ risk: PerpAgentRisk, liftHalt: Bool) async -> Bool {206        let api = api, id = id207        await run("perpRisk") { _ = try await api.setPerpRisk(id, risk: risk, liftHalt: liftHalt); return "Limites de la simulation enregistrées." }208        return actionError == nil209    }210}211
Files main
Menu

Theme