release: v1.0.3

- Chat template processor architecture with registry routing
- Cloud auth gate + promotional card UI
- NOVA_DIR env var support
- Downloads page view
- ThinkingParser improvements
- FusedBatchScheduler optimizations
- Auth URL static let fix (no more log spam)

Author: lucasliu

Sources/NovaMLXAPI/APIServer.swift

@@ -504,8 +504,9 @@ public final class NovaMLXAPIServer: @unchecked Sendable {
                     : result.completionTokens
 
                 var content: [AnthropicContentBlock] = []
-                // Parse thinking tags from raw output
-                let thinkingParser = ThinkingParser()
+                // Parse thinking tags from raw output — match streaming's model-aware detection
+                let isAnthropicImplicit = ModelContainer.isImplicitThinkingModel(for: anthropicReq.model)
+                let thinkingParser = ThinkingParser(expectImplicitThinking: isAnthropicImplicit)
                 _ = thinkingParser.feed(result.text)
                 let finalResult = thinkingParser.finalize()
                 if !finalResult.thinking.isEmpty {
@@ -1682,8 +1683,9 @@ public final class NovaMLXAPIServer: @unchecked Sendable {
         let finishReason: String
         let message: OpenAIChatMessage
 
-        // Parse thinking tags from raw output
-        let thinkingParser = ThinkingParser()
+        // Parse thinking tags from raw output — match streaming's model-aware detection
+        let isImplicitModel = ModelContainer.isImplicitThinkingModel(for: openAIReq.model)
+        let thinkingParser = ThinkingParser(expectImplicitThinking: isImplicitModel)
         _ = thinkingParser.feed(result.text)
         let finalResult = thinkingParser.finalize()
         let thinkingText = finalResult.thinking.isEmpty ? nil : finalResult.thinking
@@ -1794,9 +1796,8 @@ public final class NovaMLXAPIServer: @unchecked Sendable {
                 try await writer.write(ByteBuffer(string: "data: \(String(data: roleData, encoding: .utf8) ?? "")\n\n"))
 
                 var completionTokenCount = 0
-                let modelId = openAIReq.model.lowercased()
-                let isThinkingModel = ModelContainer.detectThinkingModel(for: openAIReq.model)
-                let thinkingParser = ThinkingParser(expectImplicitThinking: isThinkingModel)
+                let isImplicitModel = ModelContainer.isImplicitThinkingModel(for: openAIReq.model)
+                let thinkingParser = ThinkingParser(expectImplicitThinking: isImplicitModel)
                 for try await event in keepAliveStream {
                     switch event {
                     case .token(let token):
@@ -1816,6 +1817,15 @@ public final class NovaMLXAPIServer: @unchecked Sendable {
                             let data = try JSONEncoder().encode(chunk)
                             try await writer.write(ByteBuffer(string: "data: \(String(data: data, encoding: .utf8) ?? "")\n\n"))
                         } else if let finish = token.finishReason {
+                            // Flush ThinkingParser before emitting stop chunk
+                            let finalParsed = thinkingParser.finalize()
+                            if !finalParsed.response.isEmpty {
+                                completionTokenCount += 1
+                                let respDelta = OpenAIDelta(content: finalParsed.response)
+                                let respChunk = OpenAIStreamChunk(id: chunkId, model: openAIReq.model, choices: [OpenAIStreamChoice(index: 0, delta: respDelta)])
+                                let respData = try JSONEncoder().encode(respChunk)
+                                try await writer.write(ByteBuffer(string: "data: \(String(data: respData, encoding: .utf8) ?? "")\n\n"))
+                            }
                             let finalChunk = OpenAIStreamChunk(
                                 id: chunkId,
                                 model: openAIReq.model,
@@ -1932,9 +1942,8 @@ public final class NovaMLXAPIServer: @unchecked Sendable {
 
                 NovaMLXLog.info("[SSE:\(reqTag)] Waiting for first token from inference stream...")
 
-                let anthropicModelId = (anthropicReq.model).lowercased()
-                let isAnthropicThinkingModel = ModelContainer.detectThinkingModel(for: anthropicReq.model)
-                let thinkingParser = ThinkingParser(expectImplicitThinking: isAnthropicThinkingModel)
+                let isAnthropicImplicitModel = ModelContainer.isImplicitThinkingModel(for: anthropicReq.model)
+                let thinkingParser = ThinkingParser(expectImplicitThinking: isAnthropicImplicitModel)
                 var currentBlockIndex = 0
                 var isInThinkingBlock = false
                 var hasStartedTextBlock = false
@@ -1964,6 +1973,20 @@ public final class NovaMLXAPIServer: @unchecked Sendable {
                     switch event {
                     case .token(let token):
                         if token.finishReason != nil {
+                            // Flush ThinkingParser before closing blocks
+                            let finalParsed = thinkingParser.finalize()
+                            if !finalParsed.response.isEmpty {
+                                if isInThinkingBlock {
+                                    try await endCurrentBlock()
+                                }
+                                if !hasStartedTextBlock {
+                                    try await startTextBlock()
+                                }
+                                tokenCount += 1
+                                let deltaEvent = AnthropicStreamEvent.textDelta(finalParsed.response)
+                                let deltaData = try JSONEncoder().encode(deltaEvent)
+                                try await writer.write(ByteBuffer(string: "event: content_block_delta\ndata: \(String(data: deltaData, encoding: .utf8) ?? "{}")\n\n"))
+                            }
                             // Close current block if open
                             if isInThinkingBlock || hasStartedTextBlock {
                                 try await writer.write(ByteBuffer(string: "event: content_block_stop\ndata: {}\n\n"))

Sources/NovaMLXAPI/OCROptimizer.swift

@@ -114,7 +114,11 @@ enum OCROptimizer {
     ) -> SamplingOverrides {
         guard let ocrType = ocrType(for: modelName),
               let defaults = samplingDefaults[ocrType] else {
-            return SamplingOverrides()
+            return SamplingOverrides(
+                temperature: userTemperature,
+                maxTokens: userMaxTokens,
+                repetitionPenalty: userRepetitionPenalty
+            )
         }
         return SamplingOverrides(
             temperature: userTemperature ?? defaults.temperature,

Sources/NovaMLXApp/main.swift

@@ -63,10 +63,16 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
     let config = NovaMLXConfiguration.shared
     var mainWindow: NSWindow?
 
+    /// Path errors captured in init() BEFORE ModelManager creates any directories
+    private let pathValidationErrors: [String]
+
     override init() {
-        let homeDir = FileManager.default.homeDirectoryForCurrentUser
-        let baseDir = homeDir.appendingPathComponent(".nova", isDirectory: true)
-        let modelsDir = baseDir.appendingPathComponent("models", isDirectory: true)
+        // Validate BEFORE creating ModelManager (which auto-creates dirs)
+        let errors = NovaMLXPaths.validateConfiguredPaths()
+        self.pathValidationErrors = errors
+
+        let baseDir = NovaMLXPaths.baseDir
+        let modelsDir = NovaMLXPaths.modelsDir
 
         // Auto-migrate from old Application Support path if needed
         Self.migrateFromApplicationSupport(to: baseDir)
@@ -111,9 +117,8 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
               var json = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
         else { return }
 
-        guard let encoded = oldPrefix.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed) else { return }
-        _ = "file://" + encoded
         var changed = false
+        let newModelsPrefix = "file://" + NovaMLXPaths.modelsDir.path
 
         for (key, value) in json {
             guard var record = value as? [String: Any],
@@ -122,12 +127,11 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
             else { continue }
             record["localURL"] = localURL.replacingOccurrences(
                 of: "file:///Users/lucas/Library/Application%20Support/NovaMLX/models/",
-                with: "file:///Users/lucas/.nova/models/"
+                with: newModelsPrefix
             )
-            // Also handle non-percent-encoded variant
             record["localURL"] = (record["localURL"] as? String ?? localURL).replacingOccurrences(
                 of: "file:///Users/lucas/Library/Application Support/NovaMLX/models/",
-                with: "file:///Users/lucas/.nova/models/"
+                with: newModelsPrefix
             )
             json[key] = record
             changed = true
@@ -136,7 +140,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
         if changed {
             let newData = try? JSONSerialization.data(withJSONObject: json, options: [.prettyPrinted, .sortedKeys])
             try? newData?.write(to: registryPath, options: .atomic)
-            NovaMLXLog.info("Fixed registry paths to point to ~/.nova")
+            NovaMLXLog.info("Fixed registry paths to point to \(NovaMLXPaths.modelsDir.path)")
         }
     }
 
@@ -157,14 +161,25 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
             object: nil
         )
 
+        // Validate configured paths — fatal if configured but inaccessible
+        if !pathValidationErrors.isEmpty {
+            let alert = NSAlert()
+            alert.messageText = "NovaMLX: Configuration Error"
+            alert.informativeText = pathValidationErrors.joined(separator: "\n\n")
+            alert.alertStyle = .critical
+            alert.addButton(withTitle: "Quit")
+            NSApp.activate(ignoringOtherApps: true)
+            _ = alert.runModal()
+            NSApp.terminate(nil)
+            return
+        }
+
         Task {
             NovaMLXLog.rotateLogFile()
 
             try? await config.initializeDirectories()
 
-            let configFile = await config.modelsDirectory
-                .deletingLastPathComponent()
-                .appendingPathComponent("config.json")
+            let configFile = NovaMLXPaths.configFile
             if FileManager.default.fileExists(atPath: configFile.path) {
                 do {
                     try await config.loadFromFile(configFile)

Sources/NovaMLXCLI/CLIClient.swift

@@ -1,13 +1,12 @@
 import Foundation
+import NovaMLXCore
 
 enum CLIClient {
     private static let baseURL = "http://127.0.0.1:8080"
     private static let adminURL = "http://127.0.0.1:8081"
 
-    // Read server config from ~/.nova/config.json (same file the server uses)
     static func configFromFile() -> [String: Any]? {
-        let homeDir = FileManager.default.homeDirectoryForCurrentUser
-        let configURL = homeDir.appendingPathComponent(".nova/config.json")
+        let configURL = NovaMLXPaths.configFile
         guard let data = try? Data(contentsOf: configURL),
               let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
         else { return nil }

Sources/NovaMLXCore/AuthClient.swift

@@ -19,30 +19,26 @@ public struct AuthClient: Sendable {
         self.baseURL = baseURL
     }
 
-    public static var defaultBaseURL: String {
+    /// Cached auth URL — computed once, logs once.
+    public static let defaultBaseURL: String = {
         // 1. Environment variable (CLI or dev override)
         if let env = ProcessInfo.processInfo.environment["NOVA_AUTH_URL"], !env.isEmpty {
             authLog("Auth URL from env: \(env)")
             return env
         }
         // 2. Config file (~/.nova/config.json → auth.authURL)
         if let configData = FileManager.default.contents(atPath: NovaMLXPaths.configFile.path) {
-            authLog("Config file size: \(configData.count) bytes")
             if let json = try? JSONSerialization.jsonObject(with: configData) as? [String: Any],
                let auth = json["auth"] as? [String: Any],
                let url = auth["authURL"] as? String, !url.isEmpty {
                 authLog("Auth URL from config: \(url)")
                 return url
-            } else {
-                authLog("Config parsed but no auth.authURL found")
             }
-        } else {
-            authLog("Config file not found at \(NovaMLXPaths.configFile.path)")
         }
         // 3. Production default
         authLog("Using production default: https://novamlx.ai")
         return "https://novamlx.ai"
-    }
+    }()
 
     public func login(email: String, password: String) async throws -> LoginResponse {
         var request = URLRequest(url: URL(string: "\(baseURL)/api/v1/auth/login")!)

Sources/NovaMLXCore/Configuration.swift

@@ -4,24 +4,18 @@ public actor NovaMLXConfiguration {
     public static let shared = NovaMLXConfiguration()
 
     private var _modelsDirectory: URL
-    private var _cacheDirectory: URL
     private var _serverConfig: ServerConfig
     private var _defaultModel: String?
 
     private init() {
         _modelsDirectory = NovaMLXPaths.modelsDir
-        _cacheDirectory = NovaMLXPaths.cacheDir
         _serverConfig = ServerConfig()
     }
 
     public var modelsDirectory: URL {
         get async { _modelsDirectory }
     }
 
-    public var cacheDirectory: URL {
-        get async { _cacheDirectory }
-    }
-
     public var serverConfig: ServerConfig {
         get async { _serverConfig }
     }
@@ -34,10 +28,6 @@ public actor NovaMLXConfiguration {
         _modelsDirectory = url
     }
 
-    public func setCacheDirectory(_ url: URL) {
-        _cacheDirectory = url
-    }
-
     public func setServerConfig(_ config: ServerConfig) {
         _serverConfig = config
     }
@@ -49,7 +39,6 @@ public actor NovaMLXConfiguration {
     public func initializeDirectories() throws {
         let fm = FileManager.default
         try fm.createDirectory(at: _modelsDirectory, withIntermediateDirectories: true)
-        try fm.createDirectory(at: _cacheDirectory, withIntermediateDirectories: true)
     }
 
     public func loadFromFile(_ url: URL) throws {
@@ -73,7 +62,6 @@ public actor NovaMLXConfiguration {
         try data.write(to: url, options: .atomic)
     }
 
-    /// Update apiKeys in the server config and persist to file
     public func updateApiKeys(_ keys: [String], file url: URL) throws {
         _serverConfig = ServerConfig(
             host: _serverConfig.host,
@@ -92,9 +80,8 @@ public actor NovaMLXConfiguration {
         try saveToFile(url)
     }
 
-    /// Convenience: get the config file URL (sibling of models directory)
     public var configFileURL: URL {
-        _modelsDirectory.deletingLastPathComponent().appendingPathComponent("config.json")
+        NovaMLXPaths.configFile
     }
 }
 

Sources/NovaMLXCore/Localization.swift

@@ -85,8 +85,7 @@ public final class L10n: ObservableObject {
     // MARK: - Persistence
 
     private func persistLanguage() {
-        let home = FileManager.default.homeDirectoryForCurrentUser
-        let configURL = home.appendingPathComponent(".nova/config.json")
+        let configURL = NovaMLXPaths.configFile
 
         guard var config = Self.readJSON(at: configURL) else { return }
         config["language"] = currentLanguage.rawValue
@@ -97,8 +96,7 @@ public final class L10n: ObservableObject {
     }
 
     private static func loadSavedLanguage() -> String? {
-        let home = FileManager.default.homeDirectoryForCurrentUser
-        let configURL = home.appendingPathComponent(".nova/config.json")
+        let configURL = NovaMLXPaths.configFile
         guard let config = readJSON(at: configURL) else { return nil }
         return config["language"] as? String
     }

Sources/NovaMLXCore/LocalizationStrings.swift

@@ -20,7 +20,8 @@ enum LocalizationStrings {
         // App / Navigation
         "app.status": "Status",
         "app.models": "Models",
-        "app.chat": "Chat",
+        "app.downloads": "Downloads",
+        "app.chat": "Playground",
         "app.agents": "Agents",
         "app.settings": "Settings",
         "app.running": "Running",
@@ -272,7 +273,7 @@ enum LocalizationStrings {
     private static let zhHans: [String: String] = [
         "app.status": "状态",
         "app.models": "模型",
-        "app.chat": "聊天",
+        "app.chat": "Playground",
         "app.agents": "智能体",
         "app.settings": "设置",
         "app.running": "运行中",
@@ -516,7 +517,7 @@ enum LocalizationStrings {
     private static let zhHantHK: [String: String] = [
         "app.status": "狀態",
         "app.models": "模型",
-        "app.chat": "聊天",
+        "app.chat": "Playground",
         "app.agents": "智能體",
         "app.settings": "設定",
         "app.running": "運行中",
@@ -760,7 +761,7 @@ enum LocalizationStrings {
     private static let zhHantTW: [String: String] = [
         "app.status": "狀態",
         "app.models": "模型",
-        "app.chat": "聊天",
+        "app.chat": "Playground",
         "app.agents": "智慧代理",
         "app.settings": "設定",
         "app.running": "執行中",
@@ -1004,7 +1005,7 @@ enum LocalizationStrings {
     private static let ja: [String: String] = [
         "app.status": "ステータス",
         "app.models": "モデル",
-        "app.chat": "チャット",
+        "app.chat": "Playground",
         "app.agents": "エージェント",
         "app.settings": "設定",
         "app.running": "実行中",
@@ -1248,7 +1249,7 @@ enum LocalizationStrings {
     private static let ko: [String: String] = [
         "app.status": "상태",
         "app.models": "모델",
-        "app.chat": "채팅",
+        "app.chat": "Playground",
         "app.agents": "에이전트",
         "app.settings": "설정",
         "app.running": "실행 중",
@@ -1492,7 +1493,7 @@ enum LocalizationStrings {
     private static let fr: [String: String] = [
         "app.status": "Statut",
         "app.models": "Modèles",
-        "app.chat": "Chat",
+        "app.chat": "Playground",
         "app.agents": "Agents",
         "app.settings": "Paramètres",
         "app.running": "En cours",
@@ -1736,7 +1737,7 @@ enum LocalizationStrings {
     private static let de: [String: String] = [
         "app.status": "Status",
         "app.models": "Modelle",
-        "app.chat": "Chat",
+        "app.chat": "Playground",
         "app.agents": "Agenten",
         "app.settings": "Einstellungen",
         "app.running": "Aktiv",
@@ -1980,7 +1981,7 @@ enum LocalizationStrings {
     private static let ru: [String: String] = [
         "app.status": "Статус",
         "app.models": "Модели",
-        "app.chat": "Чат",
+        "app.chat": "Playground",
         "app.agents": "Агенты",
         "app.settings": "Настройки",
         "app.running": "Работает",