WIP - Feat: Vulti Agent Chat Integration

VultisigApp/VultisigApp/ContentView.swift

@@ -53,6 +53,7 @@ struct ContentView: View {
             .navigationDestination(for: SettingsRoute.self) { router.settingsRouter.build($0) }
             .navigationDestination(for: CircleRoute.self) { router.circleRouter.build($0) }
             .navigationDestination(for: TronRoute.self) { router.tronRouter.build($0) }
+            .navigationDestination(for: AgentRoute.self) { router.agentRouter.build($0) }
         }
         .environment(\.router, router.navigationRouter)
         .colorScheme(.dark)

VultisigApp/VultisigApp/Features/Agent/Navigation/AgentRoute.swift

@@ -0,0 +1,13 @@
+//
+//  AgentRoute.swift
+//  VultisigApp
+//
+//  Created by Enrique Souza on 2026-02-25.
+//
+
+import Foundation
+
+enum AgentRoute: Hashable {
+    case conversations
+    case chat(conversationId: String?)
+}

VultisigApp/VultisigApp/Features/Agent/Navigation/AgentRouter.swift

@@ -0,0 +1,21 @@
+//
+//  AgentRouter.swift
+//  VultisigApp
+//
+//  Created by Enrique Souza on 2026-02-25.
+//
+
+import SwiftUI
+
+struct AgentRouter {
+
+    @ViewBuilder
+    func build(_ route: AgentRoute) -> some View {
+        switch route {
+        case .conversations:
+            AgentConversationsView()
+        case .chat(let conversationId):
+            AgentChatView(conversationId: conversationId)
+        }
+    }
+}

VultisigApp/VultisigApp/Features/Home/HomeScreen.swift

@@ -41,8 +41,16 @@ struct HomeScreen: View {
     @EnvironmentObject var vultExtensionViewModel: VultExtensionViewModel
     @EnvironmentObject var appViewModel: AppViewModel
     @Environment(\.modelContext) private var modelContext
+
     var tabs: [HomeTab] {
-        !(appViewModel.selectedVault?.availableDefiChains.isEmpty ?? true) ? [.wallet, .defi] : [.wallet]
+        var baseTabs: [HomeTab] = [.wallet]
+        if !(appViewModel.selectedVault?.availableDefiChains.isEmpty ?? true) {
+            baseTabs.append(.defi)
+        }
+        if SettingsViewModel.shared.agentEnabled {
+            baseTabs.append(.agent)
+        }
+        return baseTabs
     }
 
     init(showingVaultSelector: Bool = false) {
@@ -137,6 +145,8 @@ struct HomeScreen: View {
                             vault: selectedVault,
                             showBalanceInHeader: $defiShowPortfolioHeader
                         )
+                    case .agent:
+                        AgentConversationsView()
                     case .camera:
                         EmptyView()
                     }
@@ -149,6 +159,7 @@ struct HomeScreen: View {
             }
 
             header(vault: selectedVault)
+                .showIf(selectedTab != .agent)
         }
     }
 
@@ -318,6 +329,8 @@ extension HomeScreen {
             showOpaqueHeader = defiShowPortfolioHeader
         case .wallet:
             showOpaqueHeader = walletShowPortfolioHeader
+        case .agent:
+            showOpaqueHeader = false
         case .camera:
             return
         }

VultisigApp/VultisigApp/Features/Home/Model/HomeTab.swift

@@ -8,6 +8,7 @@
 enum HomeTab: TabBarItem, CaseIterable {
     case wallet
     case defi
+    case agent
     // Only used to fake `camera` button for liquid glass
     case camera
 
@@ -17,6 +18,8 @@ enum HomeTab: TabBarItem, CaseIterable {
             "Wallet"
         case .defi:
             "DeFi"
+        case .agent:
+            "Agent"
         case .camera:
             ""
         }
@@ -28,6 +31,8 @@ enum HomeTab: TabBarItem, CaseIterable {
             "wallet"
         case .defi:
             "coins-add"
+        case .agent:
+            "stars"
         case .camera:
             "camera-2"
         }

VultisigApp/VultisigApp/Features/Wallet/ChainDetail/ChainDetailScreenContainer.swift

@@ -23,7 +23,14 @@ struct ChainDetailScreenContainer: View {
         self.group = group
         self.vault = vault
         let supportsDefiTab = vault.availableDefiChains.contains(group.chain)
-        tabs = supportsDefiTab ? [.wallet, .defi] : [.wallet]
+        var newTabs: [HomeTab] = [.wallet]
+        if supportsDefiTab {
+            newTabs.append(.defi)
+        }
+        if SettingsViewModel.shared.agentEnabled {
+            newTabs.append(.agent)
+        }
+        self.tabs = newTabs
     }
 
     var body: some View {
@@ -58,6 +65,8 @@ struct ChainDetailScreenContainer: View {
                     default:
                         DefiChainMainScreen(vault: vault, group: group)
                     }
+                case .agent:
+                    AgentConversationsView()
                 case .camera:
                     EmptyView()
                 }

VultisigApp/VultisigApp/Model/Chain.swift

@@ -48,6 +48,34 @@ enum Chain: String, Codable, Hashable, CaseIterable {
     case hyperliquid
     case sei
 
+    /// Maps removed chain raw values to their replacement chain.
+    /// This prevents SwiftData from crashing when decoding legacy persisted data.
+    private static let removedChainMigrations: [String: Chain] = [
+        "thorChainStagenet2": .thorChainStagenet,
+        "thorChainChainnet": .thorChain,
+        "polygon": .polygonV2
+    ]
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        let rawValue = try container.decode(String.self)
+        if let chain = Chain(rawValue: rawValue) {
+            self = chain
+        } else if let migrated = Chain.removedChainMigrations[rawValue] {
+            self = migrated
+        } else {
+            throw DecodingError.dataCorruptedError(
+                in: container,
+                debugDescription: "Cannot initialize Chain from invalid String value \(rawValue)"
+            )
+        }
+    }
+
+    func encode(to encoder: Encoder) throws {
+        var container = encoder.singleValueContainer()
+        try container.encode(self.rawValue)
+    }
+
     enum MigrationKeys: String, CodingKey {
         case ticker
     }

VultisigApp/VultisigApp/Navigation/VultisigRouter.swift

@@ -19,6 +19,7 @@ final class VultisigRouter: ObservableObject {
     let homeRouter: HomeRouter
     let circleRouter: CircleRouter
     let tronRouter: TronRouter
+    let agentRouter: AgentRouter
 
     init(navigationRouter: NavigationRouter) {
         self.navigationRouter = navigationRouter
@@ -32,5 +33,6 @@ final class VultisigRouter: ObservableObject {
         self.homeRouter = HomeRouter()
         self.circleRouter = CircleRouter()
         self.tronRouter = TronRouter()
+        self.agentRouter = AgentRouter()
     }
 }