@sriinnu/runic 1.0.0

package/Sources/Runic/Providers/Shared/ProviderImplementation.swift

@@ -0,0 +1,48 @@
+import RunicCore
+import Foundation
+
+/// App-side provider implementation.
+///
+/// Rules:
+/// - Provider implementations return *data/behavior descriptors*; the app owns UI.
+/// - Do not mix identity fields across providers (email/org/plan/loginMethod stays siloed).
+protocol ProviderImplementation: Sendable {
+    var id: UsageProvider { get }
+    var supportsLoginFlow: Bool { get }
+
+    /// Optional provider-specific settings toggles to render in the Providers pane.
+    ///
+    /// Important: Providers must not return custom SwiftUI views here. Only shared toggle/action descriptors.
+    @MainActor
+    func settingsToggles(context: ProviderSettingsContext) -> [ProviderSettingsToggleDescriptor]
+
+    /// Optional provider-specific settings fields to render in the Providers pane.
+    @MainActor
+    func settingsFields(context: ProviderSettingsContext) -> [ProviderSettingsFieldDescriptor]
+
+    /// Optional provider-specific login flow. Returns whether to refresh after completion.
+    @MainActor
+    func runLoginFlow(context: ProviderLoginContext) async -> Bool
+}
+
+extension ProviderImplementation {
+    var supportsLoginFlow: Bool { false }
+    @MainActor
+    func settingsToggles(context _: ProviderSettingsContext) -> [ProviderSettingsToggleDescriptor] {
+        []
+    }
+
+    @MainActor
+    func settingsFields(context _: ProviderSettingsContext) -> [ProviderSettingsFieldDescriptor] {
+        []
+    }
+
+    @MainActor
+    func runLoginFlow(context _: ProviderLoginContext) async -> Bool {
+        false
+    }
+}
+
+struct ProviderLoginContext {
+    unowned let controller: StatusItemController
+}

package/Sources/Runic/Providers/Shared/ProviderImplementationRegistry.swift

@@ -0,0 +1,66 @@
+import RunicCore
+import Foundation
+
+enum ProviderImplementationRegistry {
+    private final class Store: @unchecked Sendable {
+        var ordered: [any ProviderImplementation] = []
+        var byID: [UsageProvider: any ProviderImplementation] = [:]
+    }
+
+    private static let lock = NSLock()
+    private static let store = Store()
+    private static let bootstrap: Void = {
+        _ = ProviderImplementationRegistry.register(CodexProviderImplementation())
+        _ = ProviderImplementationRegistry.register(ClaudeProviderImplementation())
+        _ = ProviderImplementationRegistry.register(FactoryProviderImplementation())
+        _ = ProviderImplementationRegistry.register(ZaiProviderImplementation())
+        _ = ProviderImplementationRegistry.register(CursorProviderImplementation())
+        _ = ProviderImplementationRegistry.register(GeminiProviderImplementation())
+        _ = ProviderImplementationRegistry.register(AntigravityProviderImplementation())
+        _ = ProviderImplementationRegistry.register(CopilotProviderImplementation())
+        _ = ProviderImplementationRegistry.register(MiniMaxProviderImplementation())
+        _ = ProviderImplementationRegistry.register(OpenRouterProviderImplementation())
+        _ = ProviderImplementationRegistry.register(GroqProviderImplementation())
+        _ = ProviderImplementationRegistry.register(DeepSeekProviderImplementation())
+        _ = ProviderImplementationRegistry.register(FireworksProviderImplementation())
+        _ = ProviderImplementationRegistry.register(MistralProviderImplementation())
+        _ = ProviderImplementationRegistry.register(PerplexityProviderImplementation())
+        _ = ProviderImplementationRegistry.register(KimiProviderImplementation())
+        _ = ProviderImplementationRegistry.register(AuggieProviderImplementation())
+        _ = ProviderImplementationRegistry.register(TogetherProviderImplementation())
+        _ = ProviderImplementationRegistry.register(CohereProviderImplementation())
+        _ = ProviderImplementationRegistry.register(XAIProviderImplementation())
+        _ = ProviderImplementationRegistry.register(CerebrasProviderImplementation())
+        _ = ProviderImplementationRegistry.register(SambaNovaProviderImplementation())
+        _ = ProviderImplementationRegistry.register(AzureProviderImplementation())
+        _ = ProviderImplementationRegistry.register(BedrockProviderImplementation())
+    }()
+
+    private static func ensureBootstrapped() {
+        _ = self.bootstrap
+    }
+
+    @discardableResult
+    static func register(_ implementation: any ProviderImplementation) -> any ProviderImplementation {
+        self.lock.lock()
+        defer { self.lock.unlock() }
+        if self.store.byID[implementation.id] == nil {
+            self.store.ordered.append(implementation)
+        }
+        self.store.byID[implementation.id] = implementation
+        return implementation
+    }
+
+    static var all: [any ProviderImplementation] {
+        self.ensureBootstrapped()
+        self.lock.lock()
+        defer { self.lock.unlock() }
+        return self.store.ordered
+    }
+
+    static func implementation(for id: UsageProvider) -> (any ProviderImplementation)? {
+        self.ensureBootstrapped()
+        if let found = self.store.byID[id] { return found }
+        return self.all.first(where: { $0.id == id })
+    }
+}

package/Sources/Runic/Providers/Shared/ProviderLoginFlow.swift

@@ -0,0 +1,12 @@
+import AppKit
+import RunicCore
+
+@MainActor
+extension StatusItemController {
+    /// Runs the provider-specific login flow.
+    /// - Returns: Whether Runic should refresh after the flow completes.
+    func runLoginFlow(provider: UsageProvider) async -> Bool {
+        guard let impl = ProviderCatalog.implementation(for: provider) else { return false }
+        return await impl.runLoginFlow(context: ProviderLoginContext(controller: self))
+    }
+}

package/Sources/Runic/Providers/Shared/ProviderSettingsDescriptors.swift

@@ -0,0 +1,99 @@
+import RunicCore
+import Foundation
+import SwiftUI
+
+/// Settings UI context passed to provider implementations.
+///
+/// Providers use this to:
+/// - bind to `SettingsStore` values
+/// - read current provider state from `UsageStore`
+/// - surface transient status text (e.g. "Importing cookies…")
+/// - request a shared confirmation alert (no provider-specific UI)
+@MainActor
+struct ProviderSettingsContext {
+    let provider: UsageProvider
+    let settings: SettingsStore
+    let store: UsageStore
+
+    let boolBinding: (ReferenceWritableKeyPath<SettingsStore, Bool>) -> Binding<Bool>
+    let stringBinding: (ReferenceWritableKeyPath<SettingsStore, String>) -> Binding<String>
+
+    let statusText: (String) -> String?
+    let setStatusText: (String, String?) -> Void
+
+    let lastAppActiveRunAt: (String) -> Date?
+    let setLastAppActiveRunAt: (String, Date?) -> Void
+
+    let requestConfirmation: (ProviderSettingsConfirmation) -> Void
+}
+
+/// Shared confirmation alert descriptor.
+///
+/// Providers can request confirmations (e.g. permission prompts) without supplying custom UI.
+@MainActor
+struct ProviderSettingsConfirmation {
+    let title: String
+    let message: String
+    let confirmTitle: String
+    let onConfirm: () -> Void
+}
+
+/// Shared toggle descriptor rendered in the Providers settings pane.
+@MainActor
+struct ProviderSettingsToggleDescriptor: Identifiable {
+    let id: String
+    let title: String
+    let subtitle: String
+    let binding: Binding<Bool>
+
+    /// Optional short status text shown under the toggle when enabled.
+    let statusText: (() -> String?)?
+
+    /// Optional actions shown under the toggle when enabled.
+    let actions: [ProviderSettingsActionDescriptor]
+
+    /// Optional runtime visibility gate.
+    let isVisible: (() -> Bool)?
+
+    /// Called whenever the toggle changes.
+    let onChange: ((_ enabled: Bool) async -> Void)?
+
+    /// Called when the app becomes active (used for "retry after permission grant" flows).
+    let onAppDidBecomeActive: (() async -> Void)?
+
+    /// Called when the view appears while the toggle is enabled.
+    let onAppearWhenEnabled: (() async -> Void)?
+}
+
+/// Shared text field descriptor rendered in the Providers settings pane.
+@MainActor
+struct ProviderSettingsFieldDescriptor: Identifiable {
+    enum Kind {
+        case plain
+        case secure
+    }
+
+    let id: String
+    let title: String
+    let subtitle: String
+    let kind: Kind
+    let placeholder: String?
+    let binding: Binding<String>
+    let actions: [ProviderSettingsActionDescriptor]
+    let isVisible: (() -> Bool)?
+}
+
+/// Shared action descriptor rendered under a settings toggle.
+@MainActor
+struct ProviderSettingsActionDescriptor: Identifiable {
+    enum Style {
+        case bordered
+        case link
+    }
+
+    let id: String
+    let title: String
+    let style: Style
+    let isVisible: (() -> Bool)?
+    let perform: () async -> Void
+}

package/Sources/Runic/Providers/Shared/SystemSettingsLinks.swift

@@ -0,0 +1,18 @@
+import AppKit
+import Foundation
+
+enum SystemSettingsLinks {
+    /// Opens System Settings → Privacy & Security → Full Disk Access (best effort).
+    static func openFullDiskAccess() {
+        // Best-effort deep link. On older betas it sometimes opened the wrong pane; on modern macOS this is stable.
+        let urls: [URL] = [
+            URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"),
+            URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy"),
+            URL(string: "x-apple.systempreferences:com.apple.preference.security"),
+        ].compactMap(\.self)
+
+        for url in urls where NSWorkspace.shared.open(url) {
+            return
+        }
+    }
+}

package/Sources/Runic/Providers/Together/TogetherProviderImplementation.swift

@@ -0,0 +1,24 @@
+import AppKit
+import RunicCore
+import RunicMacroSupport
+import Foundation
+
+@ProviderImplementationRegistration
+struct TogetherProviderImplementation: ProviderImplementation {
+    let id: UsageProvider = .together
+
+    @MainActor
+    func settingsFields(context: ProviderSettingsContext) -> [ProviderSettingsFieldDescriptor] {
+        [
+            ProviderSettingsFieldDescriptor(
+                id: "together-api-token",
+                title: "API key",
+                subtitle: "Stored in Keychain (encrypted). Press Return to save.",
+                kind: .secure,
+                placeholder: "Paste key…",
+                binding: context.stringBinding(\.togetherAPIToken),
+                actions: [],
+                isVisible: nil),
+        ]
+    }
+}

package/Sources/Runic/Providers/XAI/XAIProviderImplementation.swift

@@ -0,0 +1,24 @@
+import AppKit
+import RunicCore
+import RunicMacroSupport
+import Foundation
+
+@ProviderImplementationRegistration
+struct XAIProviderImplementation: ProviderImplementation {
+    let id: UsageProvider = .xai
+
+    @MainActor
+    func settingsFields(context: ProviderSettingsContext) -> [ProviderSettingsFieldDescriptor] {
+        [
+            ProviderSettingsFieldDescriptor(
+                id: "xai-api-token",
+                title: "API key",
+                subtitle: "Stored in Keychain (encrypted). Press Return to save.",
+                kind: .secure,
+                placeholder: "Paste key…",
+                binding: context.stringBinding(\.xaiAPIToken),
+                actions: [],
+                isVisible: nil),
+        ]
+    }
+}

package/Sources/Runic/Providers/Zai/ZaiProviderImplementation.swift

@@ -0,0 +1,24 @@
+import AppKit
+import RunicCore
+import RunicMacroSupport
+import Foundation
+
+@ProviderImplementationRegistration
+struct ZaiProviderImplementation: ProviderImplementation {
+    let id: UsageProvider = .zai
+
+    @MainActor
+    func settingsFields(context: ProviderSettingsContext) -> [ProviderSettingsFieldDescriptor] {
+        [
+            ProviderSettingsFieldDescriptor(
+                id: "zai-api-token",
+                title: "API token",
+                subtitle: "Stored in Keychain (encrypted). Press Return to save.",
+                kind: .secure,
+                placeholder: "Paste token…",
+                binding: context.stringBinding(\.zaiAPIToken),
+                actions: [],
+                isVisible: nil),
+        ]
+    }
+}