Repository Public
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