fix(longcat): surface invalid-session and drop unused today-token path

Addresses Codex review on #1697:
- user-current now propagates envelope auth failures (HTTP 200 + code
  401/403 -> .invalidSession) instead of swallowing them with try?, so
  expired cookies prompt re-auth rather than reporting an empty snapshot.
- Remove the never-assigned todayTokens / freeQuota fields and the
  unreachable tertiary 'Today' window; LongCat's tokenUsage is a quota
  snapshot with no per-day figure.
- Add envelope unit tests (invalid-session + success unwrap).

Author: LeoLin990405

Sources/CodexBarCore/Providers/LongCat/LongCatUsageFetcher.swift

@@ -14,10 +14,13 @@ public struct LongCatUsageFetcher: Sendable {
 
     public static func fetchUsage(cookieHeader: String, now: Date = Date()) async throws -> LongCatUsageSnapshot {
         // Account name. The user-current payload also carries a session token and
-        // phone number, so its body is never logged. Failure here is non-fatal.
+        // phone number, so its body is never logged. This is the required probe:
+        // a Meituan envelope with HTTP 200 but code 401/403 surfaces as
+        // `.invalidSession` here (via unwrap) so expired cookies are reported
+        // rather than masked by an empty snapshot.
         var account: [String: Any]?
         if let data = try await self.get(self.userCurrentPath, cookieHeader: cookieHeader, required: true) {
-            account = (try? LongCatEnvelope.unwrap(self.json(data))) as? [String: Any]
+            account = try LongCatEnvelope.unwrap(self.json(data)) as? [String: Any]
         }
 
         var usage: [String: Any]?
@@ -56,7 +59,6 @@ public struct LongCatUsageFetcher: Sendable {
             snapshot.totalQuota = LongCatJSON.double(usage["totalToken"])
             snapshot.usedQuota = LongCatJSON.double(usage["usedToken"])
             snapshot.remainingQuota = LongCatJSON.double(usage["availableToken"])
-            snapshot.freeQuota = LongCatJSON.double(usage["freeAvailableToken"])
         }
 
         if let pendingFuel {

Sources/CodexBarCore/Providers/LongCat/LongCatUsageSnapshot.swift

@@ -1,39 +1,32 @@
 import Foundation
 
 /// Parsed, Sendable view of the LongCat console quota model:
-/// 总额度 (total) = 初始额度 (free, refreshed daily) + 加油包额度 (fuel packs, expiring),
-/// plus today's token usage from `tokenUsage`.
+/// 总额度 (total token quota) plus 加油包额度 (fuel packs, which expire).
 public struct LongCatUsageSnapshot: Sendable {
     public var totalQuota: Double?
-    public var freeQuota: Double?
-    public var fuelPackTotal: Double?
-    public var fuelPackRemaining: Double?
     public var usedQuota: Double?
     public var remainingQuota: Double?
-    public var todayTokens: Double?
+    public var fuelPackTotal: Double?
+    public var fuelPackRemaining: Double?
     public var nearestFuelExpiry: Date?
     public var accountName: String?
     public var updatedAt: Date
 
     public init(
         totalQuota: Double? = nil,
-        freeQuota: Double? = nil,
-        fuelPackTotal: Double? = nil,
-        fuelPackRemaining: Double? = nil,
         usedQuota: Double? = nil,
         remainingQuota: Double? = nil,
-        todayTokens: Double? = nil,
+        fuelPackTotal: Double? = nil,
+        fuelPackRemaining: Double? = nil,
         nearestFuelExpiry: Date? = nil,
         accountName: String? = nil,
         updatedAt: Date = Date())
     {
         self.totalQuota = totalQuota
-        self.freeQuota = freeQuota
-        self.fuelPackTotal = fuelPackTotal
-        self.fuelPackRemaining = fuelPackRemaining
         self.usedQuota = usedQuota
         self.remainingQuota = remainingQuota
-        self.todayTokens = todayTokens
+        self.fuelPackTotal = fuelPackTotal
+        self.fuelPackRemaining = fuelPackRemaining
         self.nearestFuelExpiry = nearestFuelExpiry
         self.accountName = accountName
         self.updatedAt = updatedAt
@@ -48,7 +41,7 @@ extension LongCatUsageSnapshot {
     }
 
     public func toUsageSnapshot() -> UsageSnapshot {
-        // Primary: overall quota consumption (总额度).
+        // Primary: overall token quota consumption (总额度).
         var primary = RateWindow(
             usedPercent: 0,
             windowMinutes: nil,
@@ -75,16 +68,6 @@ extension LongCatUsageSnapshot {
                 resetDescription: "Fuel pack: \(Int(remaining))/\(Int(total))")
         }
 
-        // Tertiary: informational today-token count.
-        var tertiary: RateWindow?
-        if let today = todayTokens {
-            tertiary = RateWindow(
-                usedPercent: 0,
-                windowMinutes: 1440,
-                resetsAt: nil,
-                resetDescription: "Today: \(Int(today)) tokens")
-        }
-
         let identity = ProviderIdentitySnapshot(
             providerID: .longcat,
             accountEmail: nil,
@@ -94,7 +77,7 @@ extension LongCatUsageSnapshot {
         return UsageSnapshot(
             primary: primary,
             secondary: secondary,
-            tertiary: tertiary,
+            tertiary: nil,
             providerCost: nil,
             updatedAt: self.updatedAt,
             identity: identity)

Tests/CodexBarTests/LongCatProviderTests.swift

@@ -67,12 +67,6 @@ struct LongCatProviderTests {
         #expect(abs((usage.secondary?.usedPercent ?? 0) - 60) < 0.001)
     }
 
-    @Test
-    func `today tokens populate tertiary window`() {
-        let usage = LongCatUsageSnapshot(todayTokens: 12345).toUsageSnapshot()
-        #expect(usage.tertiary != nil)
-    }
-
     // MARK: - buildSnapshot against captured live response shapes
 
     private func object(_ json: String) throws -> [String: Any] {
@@ -113,4 +107,19 @@ struct LongCatProviderTests {
         #expect(snapshot.fuelPackRemaining == 750)
         #expect(snapshot.nearestFuelExpiry != nil)
     }
+
+    // MARK: - Envelope
+
+    @Test
+    func `envelope surfaces invalid session on auth code`() {
+        #expect(throws: LongCatAPIError.invalidSession) {
+            try LongCatEnvelope.unwrap(["code": 401, "message": "unauthorized"])
+        }
+    }
+
+    @Test
+    func `envelope unwraps data on success`() throws {
+        let data = try LongCatEnvelope.unwrap(["code": 0, "data": ["x": 1]]) as? [String: Any]
+        #expect(data?["x"] as? Int == 1)
+    }
 }