@sriinnu/runic 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (584) hide show
  1. package/.swiftformat +50 -0
  2. package/.swiftlint.yml +160 -0
  3. package/CHANGELOG.md +307 -0
  4. package/CONTRIBUTING.md +456 -0
  5. package/Icon.icns +0 -0
  6. package/Icon.icon/Assets/runic.png +0 -0
  7. package/Icon.icon/icon.json +36 -0
  8. package/LICENSE +21 -0
  9. package/Package.resolved +51 -0
  10. package/Package.swift +136 -0
  11. package/Packages/Helix/LICENSE +21 -0
  12. package/Packages/Helix/Package.swift +29 -0
  13. package/Packages/Helix/README.md +976 -0
  14. package/Packages/Helix/Sources/Helix/Binding.swift +111 -0
  15. package/Packages/Helix/Sources/Helix/CommandParser.swift +160 -0
  16. package/Packages/Helix/Sources/Helix/CommandSignature.swift +117 -0
  17. package/Packages/Helix/Sources/Helix/ExpressibleFromArgument.swift +72 -0
  18. package/Packages/Helix/Sources/Helix/HelpGenerator.swift +175 -0
  19. package/Packages/Helix/Sources/Helix/NameSpecification.swift +98 -0
  20. package/Packages/Helix/Sources/Helix/ParsableCommand.swift +204 -0
  21. package/Packages/Helix/Sources/Helix/Platform/DarwinPlatformContext.swift +44 -0
  22. package/Packages/Helix/Sources/Helix/Platform/LinuxPlatformContext.swift +34 -0
  23. package/Packages/Helix/Sources/Helix/Platform/PlatformContext+Default.swift +91 -0
  24. package/Packages/Helix/Sources/Helix/Platform/PlatformContext.swift +94 -0
  25. package/Packages/Helix/Sources/Helix/Platform/PlatformPath.swift +167 -0
  26. package/Packages/Helix/Sources/Helix/Platform/Stdio.swift +99 -0
  27. package/Packages/Helix/Sources/Helix/Platform/WebPlatformContext.swift +146 -0
  28. package/Packages/Helix/Sources/Helix/Platform/WindowsPlatformContext.swift +97 -0
  29. package/Packages/Helix/Sources/Helix/Program.swift +204 -0
  30. package/Packages/Helix/Sources/Helix/PropertyWrappers.swift +367 -0
  31. package/Packages/Silo/LICENSE +21 -0
  32. package/Packages/Silo/Package.swift +34 -0
  33. package/Packages/Silo/README.md +466 -0
  34. package/Packages/Silo/Sources/Silo/BinaryCookiesReader.swift +169 -0
  35. package/Packages/Silo/Sources/Silo/BrowserCookieAnalytics.swift +365 -0
  36. package/Packages/Silo/Sources/Silo/BrowserCookieBackends.swift +594 -0
  37. package/Packages/Silo/Sources/Silo/BrowserCookieClient.swift +326 -0
  38. package/Packages/Silo/Sources/Silo/BrowserCookieExport.swift +154 -0
  39. package/Packages/Silo/Sources/Silo/BrowserCookieImport.swift +119 -0
  40. package/Packages/Silo/Sources/Silo/BrowserCookieMockStore.swift +121 -0
  41. package/Packages/Silo/Sources/Silo/BrowserCookieModels.swift +391 -0
  42. package/Packages/Silo/Sources/Silo/ChromiumCookieReader.swift +240 -0
  43. package/Packages/Silo/Sources/Silo/CryptoSupport.swift +86 -0
  44. package/Packages/Silo/Sources/Silo/FirefoxCookieReader.swift +172 -0
  45. package/Packages/Silo/Sources/Silo/LinuxChromiumCookieReader.swift +172 -0
  46. package/Packages/Silo/Sources/Silo/LinuxSecretService.swift +105 -0
  47. package/Packages/Silo/Sources/Silo/MacOSChromiumCookieReader.swift +191 -0
  48. package/Packages/Silo/Sources/Silo/SQLiteSnapshot.swift +41 -0
  49. package/Packages/Silo/Sources/Silo/WindowsChromiumCookieReader.swift +110 -0
  50. package/README.md +109 -0
  51. package/RuniciOS/App/RuniciOSApp.swift +105 -0
  52. package/RuniciOS/Core/iOSUsageStore.swift +192 -0
  53. package/RuniciOS/Views/ProviderDetailView.swift +312 -0
  54. package/RuniciOS/Views/ProviderListView.swift +228 -0
  55. package/RuniciOS/Widgets/LargeWidget.swift +367 -0
  56. package/RuniciOS/Widgets/LiveActivity.swift +342 -0
  57. package/RuniciOS/Widgets/LockScreenWidget.swift +273 -0
  58. package/RuniciOS/Widgets/MediumWidget.swift +370 -0
  59. package/RuniciOS/Widgets/RunicWidget.swift +274 -0
  60. package/RuniciOS/Widgets/SmallWidget.swift +281 -0
  61. package/RuniciOS/Widgets/WidgetModels.swift +285 -0
  62. package/RuniciOS/Widgets/WidgetTimeline.swift +270 -0
  63. package/Scripts/CREATION-SUMMARY.md +367 -0
  64. package/Scripts/DIRECTORY-STRUCTURE.md +358 -0
  65. package/Scripts/GETTING-STARTED-CHECKLIST.md +364 -0
  66. package/Scripts/INDEX.md +365 -0
  67. package/Scripts/QUICK-REFERENCE.md +164 -0
  68. package/Scripts/README-SCRIPTS.md +926 -0
  69. package/Scripts/build-android.sh +526 -0
  70. package/Scripts/build-ios.sh +529 -0
  71. package/Scripts/build-macos.sh +603 -0
  72. package/Scripts/build-windows.sh +504 -0
  73. package/Scripts/build_icon.sh +49 -0
  74. package/Scripts/changelog-to-html.sh +89 -0
  75. package/Scripts/check-release-assets.sh +10 -0
  76. package/Scripts/ci-config.yml +474 -0
  77. package/Scripts/compile_and_run.sh +219 -0
  78. package/Scripts/compile_and_run_adhoc.sh +4 -0
  79. package/Scripts/docs-list.mjs +119 -0
  80. package/Scripts/make_appcast.sh +58 -0
  81. package/Scripts/package_app.sh +409 -0
  82. package/Scripts/release-lib.sh +214 -0
  83. package/Scripts/release.sh +76 -0
  84. package/Scripts/setup-all.sh +387 -0
  85. package/Scripts/setup-ios.sh +404 -0
  86. package/Scripts/setup-react-native.sh +523 -0
  87. package/Scripts/sign-and-notarize.sh +122 -0
  88. package/Scripts/test_live_update.sh +38 -0
  89. package/Scripts/validate_changelog.sh +23 -0
  90. package/Scripts/verify_appcast.sh +92 -0
  91. package/Sources/Runic/About.swift +93 -0
  92. package/Sources/Runic/AppNotifications.swift +115 -0
  93. package/Sources/Runic/Controllers/StatusItemController+Actions.swift +657 -0
  94. package/Sources/Runic/Controllers/StatusItemController+Animation.swift +518 -0
  95. package/Sources/Runic/Controllers/StatusItemController+ChartSubmenus.swift +810 -0
  96. package/Sources/Runic/Controllers/StatusItemController+CustomProviders.swift +87 -0
  97. package/Sources/Runic/Controllers/StatusItemController+Menu.swift +1379 -0
  98. package/Sources/Runic/Controllers/StatusItemController+MenuCards.swift +337 -0
  99. package/Sources/Runic/Controllers/StatusItemController+MenuHelpers.swift +395 -0
  100. package/Sources/Runic/Controllers/StatusItemController.swift +360 -0
  101. package/Sources/Runic/Core/BudgetNotificationManager.swift +80 -0
  102. package/Sources/Runic/Core/Login/ClaudeLoginRunner.swift +103 -0
  103. package/Sources/Runic/Core/Login/CodexLoginRunner.swift +154 -0
  104. package/Sources/Runic/Core/Login/CursorLoginRunner.swift +206 -0
  105. package/Sources/Runic/Core/Login/GeminiLoginRunner.swift +95 -0
  106. package/Sources/Runic/Core/Rendering/IconRenderer.swift +1216 -0
  107. package/Sources/Runic/Core/Rendering/IconView.swift +120 -0
  108. package/Sources/Runic/Core/Rendering/ProviderBrandIcon.swift +71 -0
  109. package/Sources/Runic/Core/RunicAnimation.swift +53 -0
  110. package/Sources/Runic/Core/RunicColors.swift +73 -0
  111. package/Sources/Runic/Core/RunicCornerRadius.swift +15 -0
  112. package/Sources/Runic/Core/RunicSpacing.swift +68 -0
  113. package/Sources/Runic/Core/Stores/AuggieTokenStore.swift +143 -0
  114. package/Sources/Runic/Core/Stores/AzureOpenAITokenStore.swift +143 -0
  115. package/Sources/Runic/Core/Stores/CerebrasTokenStore.swift +143 -0
  116. package/Sources/Runic/Core/Stores/CohereTokenStore.swift +143 -0
  117. package/Sources/Runic/Core/Stores/CopilotTokenStore.swift +143 -0
  118. package/Sources/Runic/Core/Stores/CustomProviderStore.swift +158 -0
  119. package/Sources/Runic/Core/Stores/DeepSeekTokenStore.swift +143 -0
  120. package/Sources/Runic/Core/Stores/FireworksTokenStore.swift +143 -0
  121. package/Sources/Runic/Core/Stores/GroqTokenStore.swift +143 -0
  122. package/Sources/Runic/Core/Stores/KimiTokenStore.swift +143 -0
  123. package/Sources/Runic/Core/Stores/MiniMaxCookieHeaderStore.swift +143 -0
  124. package/Sources/Runic/Core/Stores/MiniMaxGroupIDStore.swift +143 -0
  125. package/Sources/Runic/Core/Stores/MiniMaxTokenStore.swift +143 -0
  126. package/Sources/Runic/Core/Stores/MistralTokenStore.swift +143 -0
  127. package/Sources/Runic/Core/Stores/OpenRouterTokenStore.swift +143 -0
  128. package/Sources/Runic/Core/Stores/PerplexityTokenStore.swift +143 -0
  129. package/Sources/Runic/Core/Stores/ProviderToggleStore.swift +30 -0
  130. package/Sources/Runic/Core/Stores/QwenTokenStore.swift +143 -0
  131. package/Sources/Runic/Core/Stores/SambaNovaTokenStore.swift +143 -0
  132. package/Sources/Runic/Core/Stores/SettingsStore.swift +1702 -0
  133. package/Sources/Runic/Core/Stores/TogetherTokenStore.swift +143 -0
  134. package/Sources/Runic/Core/Stores/UsageStore+Accessors.swift +20 -0
  135. package/Sources/Runic/Core/Stores/UsageStore+Status.swift +189 -0
  136. package/Sources/Runic/Core/Stores/UsageStore+TokenCost.swift +33 -0
  137. package/Sources/Runic/Core/Stores/UsageStore+WidgetSnapshot.swift +67 -0
  138. package/Sources/Runic/Core/Stores/UsageStore.swift +3564 -0
  139. package/Sources/Runic/Core/Stores/XAITokenStore.swift +143 -0
  140. package/Sources/Runic/Core/Stores/ZaiTokenStore.swift +143 -0
  141. package/Sources/Runic/Core/UsageExporter.swift +193 -0
  142. package/Sources/Runic/Date+RelativeDescription.swift +21 -0
  143. package/Sources/Runic/HiddenWindowView.swift +32 -0
  144. package/Sources/Runic/InstallOrigin.swift +9 -0
  145. package/Sources/Runic/KeyboardShortcuts+Names.swift +6 -0
  146. package/Sources/Runic/MouseLocationReader.swift +65 -0
  147. package/Sources/Runic/Notifications+Runic.swift +6 -0
  148. package/Sources/Runic/OpenAICreditsPurchaseWindowController.swift +503 -0
  149. package/Sources/Runic/ProviderRegistry.swift +100 -0
  150. package/Sources/Runic/ProviderSwitcherButtons.swift +267 -0
  151. package/Sources/Runic/Providers/Antigravity/AntigravityLoginFlow.swift +11 -0
  152. package/Sources/Runic/Providers/Antigravity/AntigravityProviderImplementation.swift +14 -0
  153. package/Sources/Runic/Providers/Auggie/AuggieProviderImplementation.swift +24 -0
  154. package/Sources/Runic/Providers/Azure/AzureProviderImplementation.swift +52 -0
  155. package/Sources/Runic/Providers/Bedrock/BedrockProviderImplementation.swift +42 -0
  156. package/Sources/Runic/Providers/Cerebras/CerebrasProviderImplementation.swift +24 -0
  157. package/Sources/Runic/Providers/Claude/ClaudeLoginFlow.swift +26 -0
  158. package/Sources/Runic/Providers/Claude/ClaudeProviderImplementation.swift +14 -0
  159. package/Sources/Runic/Providers/Codex/CodexLoginFlow.swift +18 -0
  160. package/Sources/Runic/Providers/Codex/CodexProviderImplementation.swift +15 -0
  161. package/Sources/Runic/Providers/Cohere/CohereProviderImplementation.swift +24 -0
  162. package/Sources/Runic/Providers/Copilot/CopilotLoginFlow.swift +193 -0
  163. package/Sources/Runic/Providers/Copilot/CopilotProviderImplementation.swift +110 -0
  164. package/Sources/Runic/Providers/Cursor/CursorLoginFlow.swift +28 -0
  165. package/Sources/Runic/Providers/Cursor/CursorProviderImplementation.swift +15 -0
  166. package/Sources/Runic/Providers/DeepSeek/DeepSeekProviderImplementation.swift +24 -0
  167. package/Sources/Runic/Providers/Factory/FactoryLoginFlow.swift +12 -0
  168. package/Sources/Runic/Providers/Factory/FactoryProviderImplementation.swift +15 -0
  169. package/Sources/Runic/Providers/Fireworks/FireworksProviderImplementation.swift +24 -0
  170. package/Sources/Runic/Providers/Gemini/GeminiLoginFlow.swift +20 -0
  171. package/Sources/Runic/Providers/Gemini/GeminiProviderImplementation.swift +15 -0
  172. package/Sources/Runic/Providers/Groq/GroqProviderImplementation.swift +24 -0
  173. package/Sources/Runic/Providers/Kimi/KimiProviderImplementation.swift +24 -0
  174. package/Sources/Runic/Providers/MiniMax/MiniMaxProviderImplementation.swift +32 -0
  175. package/Sources/Runic/Providers/Mistral/MistralProviderImplementation.swift +24 -0
  176. package/Sources/Runic/Providers/OpenRouter/OpenRouterProviderImplementation.swift +24 -0
  177. package/Sources/Runic/Providers/Perplexity/PerplexityProviderImplementation.swift +24 -0
  178. package/Sources/Runic/Providers/SambaNova/SambaNovaProviderImplementation.swift +24 -0
  179. package/Sources/Runic/Providers/Shared/ProviderCatalog.swift +15 -0
  180. package/Sources/Runic/Providers/Shared/ProviderImplementation.swift +48 -0
  181. package/Sources/Runic/Providers/Shared/ProviderImplementationRegistry.swift +66 -0
  182. package/Sources/Runic/Providers/Shared/ProviderLoginFlow.swift +12 -0
  183. package/Sources/Runic/Providers/Shared/ProviderSettingsDescriptors.swift +99 -0
  184. package/Sources/Runic/Providers/Shared/SystemSettingsLinks.swift +18 -0
  185. package/Sources/Runic/Providers/Together/TogetherProviderImplementation.swift +24 -0
  186. package/Sources/Runic/Providers/XAI/XAIProviderImplementation.swift +24 -0
  187. package/Sources/Runic/Providers/Zai/ZaiProviderImplementation.swift +24 -0
  188. package/Sources/Runic/Resources/ProviderIcon-antigravity.svg +2 -0
  189. package/Sources/Runic/Resources/ProviderIcon-auggie.svg +3 -0
  190. package/Sources/Runic/Resources/ProviderIcon-azure.svg +5 -0
  191. package/Sources/Runic/Resources/ProviderIcon-bedrock.svg +7 -0
  192. package/Sources/Runic/Resources/ProviderIcon-cerebras.svg +3 -0
  193. package/Sources/Runic/Resources/ProviderIcon-claude.svg +1 -0
  194. package/Sources/Runic/Resources/ProviderIcon-codex.svg +1 -0
  195. package/Sources/Runic/Resources/ProviderIcon-cohere.svg +3 -0
  196. package/Sources/Runic/Resources/ProviderIcon-copilot.svg +1 -0
  197. package/Sources/Runic/Resources/ProviderIcon-cursor.svg +3 -0
  198. package/Sources/Runic/Resources/ProviderIcon-deepseek.svg +4 -0
  199. package/Sources/Runic/Resources/ProviderIcon-factory.svg +3 -0
  200. package/Sources/Runic/Resources/ProviderIcon-fireworks.svg +3 -0
  201. package/Sources/Runic/Resources/ProviderIcon-gemini.svg +1 -0
  202. package/Sources/Runic/Resources/ProviderIcon-groq.svg +1 -0
  203. package/Sources/Runic/Resources/ProviderIcon-kimi.svg +4 -0
  204. package/Sources/Runic/Resources/ProviderIcon-minimax.svg +1 -0
  205. package/Sources/Runic/Resources/ProviderIcon-mistral.svg +5 -0
  206. package/Sources/Runic/Resources/ProviderIcon-openrouter.svg +7 -0
  207. package/Sources/Runic/Resources/ProviderIcon-perplexity.svg +4 -0
  208. package/Sources/Runic/Resources/ProviderIcon-qwen.svg +9 -0
  209. package/Sources/Runic/Resources/ProviderIcon-sambanova.svg +4 -0
  210. package/Sources/Runic/Resources/ProviderIcon-together.svg +5 -0
  211. package/Sources/Runic/Resources/ProviderIcon-vertexai.svg +17 -0
  212. package/Sources/Runic/Resources/ProviderIcon-xai.svg +3 -0
  213. package/Sources/Runic/Resources/ProviderIcon-zai.svg +5 -0
  214. package/Sources/Runic/Resources/RunicMenubarIcon.svg +7 -0
  215. package/Sources/Runic/RunicApp.swift +357 -0
  216. package/Sources/Runic/SessionQuotaNotifications.swift +58 -0
  217. package/Sources/Runic/UsagePaceText.swift +52 -0
  218. package/Sources/Runic/UsageProgressBar.swift +224 -0
  219. package/Sources/Runic/Utilities/DisplayLink.swift +96 -0
  220. package/Sources/Runic/Utilities/LoadingPattern.swift +60 -0
  221. package/Sources/Runic/Utilities/PerformanceConstants.swift +85 -0
  222. package/Sources/Runic/Views/Menu/AlertsMenuView.swift +256 -0
  223. package/Sources/Runic/Views/Menu/ChartPanelStyle.swift +22 -0
  224. package/Sources/Runic/Views/Menu/CostComparativeChartMenuView.swift +275 -0
  225. package/Sources/Runic/Views/Menu/CostHistoryChartMenuView.swift +377 -0
  226. package/Sources/Runic/Views/Menu/CreditsHistoryChartMenuView.swift +312 -0
  227. package/Sources/Runic/Views/Menu/EfficiencyMetricsMenuView.swift +312 -0
  228. package/Sources/Runic/Views/Menu/HeroStatCardsMenuView.swift +228 -0
  229. package/Sources/Runic/Views/Menu/HourlyActivityChartMenuView.swift +228 -0
  230. package/Sources/Runic/Views/Menu/InlineUsageChartView.swift +162 -0
  231. package/Sources/Runic/Views/Menu/MenuCardEntranceModifier.swift +64 -0
  232. package/Sources/Runic/Views/Menu/MenuCardSidebarView.swift +268 -0
  233. package/Sources/Runic/Views/Menu/MenuCardSkeletonView.swift +104 -0
  234. package/Sources/Runic/Views/Menu/MenuCardView.swift +1900 -0
  235. package/Sources/Runic/Views/Menu/MenuContent.swift +150 -0
  236. package/Sources/Runic/Views/Menu/MenuDescriptor.swift +369 -0
  237. package/Sources/Runic/Views/Menu/MenuHighlightStyle.swift +42 -0
  238. package/Sources/Runic/Views/Menu/ModelBreakdownMenuView.swift +235 -0
  239. package/Sources/Runic/Views/Menu/OverviewMenuView.swift +141 -0
  240. package/Sources/Runic/Views/Menu/ProjectBreakdownMenuView.swift +209 -0
  241. package/Sources/Runic/Views/Menu/ProjectBudgetMenuView.swift +220 -0
  242. package/Sources/Runic/Views/Menu/ProviderTabBarView.swift +88 -0
  243. package/Sources/Runic/Views/Menu/SubscriptionUtilizationChartMenuView.swift +201 -0
  244. package/Sources/Runic/Views/Menu/UsageBreakdownChartMenuView.swift +398 -0
  245. package/Sources/Runic/Views/Menu/UsageHeatmapMenuView.swift +232 -0
  246. package/Sources/Runic/Views/Menu/UsageTimelineChartMenuView.swift +417 -0
  247. package/Sources/Runic/Views/Menu/UsageWindowComparisonChartMenuView.swift +190 -0
  248. package/Sources/Runic/Views/Menu/WeeklyActivityChartMenuView.swift +132 -0
  249. package/Sources/Runic/Views/Performance/PerformanceDashboardView.swift +618 -0
  250. package/Sources/Runic/Views/Preferences/LiquidComponents.swift +305 -0
  251. package/Sources/Runic/Views/Preferences/PreferencesAboutPane.swift +271 -0
  252. package/Sources/Runic/Views/Preferences/PreferencesAdvancedPane.swift +268 -0
  253. package/Sources/Runic/Views/Preferences/PreferencesAlertsPane.swift +422 -0
  254. package/Sources/Runic/Views/Preferences/PreferencesAnalyticsPane.swift +641 -0
  255. package/Sources/Runic/Views/Preferences/PreferencesBudgetsPane.swift +344 -0
  256. package/Sources/Runic/Views/Preferences/PreferencesComponents.swift +230 -0
  257. package/Sources/Runic/Views/Preferences/PreferencesCustomProvidersPane.swift +322 -0
  258. package/Sources/Runic/Views/Preferences/PreferencesDebugPane.swift +469 -0
  259. package/Sources/Runic/Views/Preferences/PreferencesGeneralPane.swift +231 -0
  260. package/Sources/Runic/Views/Preferences/PreferencesHelpPane.swift +50 -0
  261. package/Sources/Runic/Views/Preferences/PreferencesIntegrationsPane.swift +497 -0
  262. package/Sources/Runic/Views/Preferences/PreferencesPerformancePane.swift +288 -0
  263. package/Sources/Runic/Views/Preferences/PreferencesProvidersPane.swift +3435 -0
  264. package/Sources/Runic/Views/Preferences/PreferencesSelection.swift +25 -0
  265. package/Sources/Runic/Views/Preferences/PreferencesSyncPane.swift +59 -0
  266. package/Sources/Runic/Views/Preferences/PreferencesView.swift +206 -0
  267. package/Sources/Runic/Views/Rating/QualityRatingView.swift +238 -0
  268. package/Sources/Runic/Views/Team/TeamDashboardView.swift +371 -0
  269. package/Sources/Runic/Views/Team/TeamInviteSheet.swift +175 -0
  270. package/Sources/Runic/Views/Team/TeamManagementView.swift +761 -0
  271. package/Sources/Runic/Views/Team/TeamMemberRow.swift +181 -0
  272. package/Sources/RunicCLI/CLIEntry.swift +942 -0
  273. package/Sources/RunicCLI/CLIRenderer.swift +87 -0
  274. package/Sources/RunicCLI/Commands/EnhancedUsageCommand.swift +588 -0
  275. package/Sources/RunicCLI/Commands/ModelsCommand.swift +362 -0
  276. package/Sources/RunicCLI/Commands/ProjectsCommand.swift +439 -0
  277. package/Sources/RunicCLI/Commands/ResetCommand.swift +429 -0
  278. package/Sources/RunicCLI/Commands/UsageLedgerSourceFactory.swift +168 -0
  279. package/Sources/RunicClaudeWatchdog/main.swift +122 -0
  280. package/Sources/RunicClaudeWebProbe/main.swift +62 -0
  281. package/Sources/RunicCore/AlertRuleStore.swift +187 -0
  282. package/Sources/RunicCore/BrowserCookieImportOrder.swift +25 -0
  283. package/Sources/RunicCore/CopilotUsageModels.swift +84 -0
  284. package/Sources/RunicCore/CostUsageFetcher.swift +119 -0
  285. package/Sources/RunicCore/CostUsageModels.swift +479 -0
  286. package/Sources/RunicCore/CreditsModels.swift +50 -0
  287. package/Sources/RunicCore/CustomProviders/CustomProviderModels.swift +269 -0
  288. package/Sources/RunicCore/CustomProviders/GenericProviderFetcher.swift +622 -0
  289. package/Sources/RunicCore/CustomProviders/ProviderTemplates.swift +500 -0
  290. package/Sources/RunicCore/Host/PTY/TTYCommandRunner.swift +679 -0
  291. package/Sources/RunicCore/Host/Process/SubprocessRunner.swift +135 -0
  292. package/Sources/RunicCore/Integrations/GitHubIntegration.swift +173 -0
  293. package/Sources/RunicCore/Logging/JSONStderrLogHandler.swift +79 -0
  294. package/Sources/RunicCore/Logging/OSLogLogHandler.swift +86 -0
  295. package/Sources/RunicCore/Logging/RunicLog.swift +123 -0
  296. package/Sources/RunicCore/Models/EnhancedUsageModels.swift +371 -0
  297. package/Sources/RunicCore/OpenAIDashboardModels.swift +210 -0
  298. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardBrowserCookieImporter.swift +676 -0
  299. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardFetcher.swift +492 -0
  300. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardNavigationDelegate.swift +51 -0
  301. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardParser.swift +483 -0
  302. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardScrapeScript.swift +558 -0
  303. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardWebViewCache.swift +204 -0
  304. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardWebsiteDataStore.swift +78 -0
  305. package/Sources/RunicCore/PathEnvironment.swift +482 -0
  306. package/Sources/RunicCore/Performance/PerformanceModels.swift +371 -0
  307. package/Sources/RunicCore/Performance/PerformanceStorageImpl.swift +409 -0
  308. package/Sources/RunicCore/Policy/UsagePolicyEngine.swift +178 -0
  309. package/Sources/RunicCore/ProjectBudgetStore.swift +99 -0
  310. package/Sources/RunicCore/ProviderCostSnapshot.swift +29 -0
  311. package/Sources/RunicCore/Providers/Antigravity/AntigravityProviderDescriptor.swift +66 -0
  312. package/Sources/RunicCore/Providers/Antigravity/AntigravityStatusProbe.swift +685 -0
  313. package/Sources/RunicCore/Providers/Auggie/AuggieProviderDescriptor.swift +83 -0
  314. package/Sources/RunicCore/Providers/Auggie/AuggieUsageFetcher.swift +142 -0
  315. package/Sources/RunicCore/Providers/Azure/AzureProviderDescriptor.swift +141 -0
  316. package/Sources/RunicCore/Providers/Azure/AzureUsageFetcher.swift +186 -0
  317. package/Sources/RunicCore/Providers/Bedrock/BedrockProviderDescriptor.swift +126 -0
  318. package/Sources/RunicCore/Providers/Bedrock/BedrockUsageFetcher.swift +168 -0
  319. package/Sources/RunicCore/Providers/Cerebras/CerebrasProviderDescriptor.swift +84 -0
  320. package/Sources/RunicCore/Providers/Cerebras/CerebrasUsageFetcher.swift +75 -0
  321. package/Sources/RunicCore/Providers/Claude/ClaudeCLISession.swift +332 -0
  322. package/Sources/RunicCore/Providers/Claude/ClaudeOAuth/ClaudeOAuthCredentials.swift +180 -0
  323. package/Sources/RunicCore/Providers/Claude/ClaudeOAuth/ClaudeOAuthUsageFetcher.swift +137 -0
  324. package/Sources/RunicCore/Providers/Claude/ClaudeProviderDescriptor.swift +207 -0
  325. package/Sources/RunicCore/Providers/Claude/ClaudeStatusProbe.swift +654 -0
  326. package/Sources/RunicCore/Providers/Claude/ClaudeUsageDataSource.swift +28 -0
  327. package/Sources/RunicCore/Providers/Claude/ClaudeUsageFetcher.swift +480 -0
  328. package/Sources/RunicCore/Providers/Claude/ClaudeWeb/ClaudeWebAPIFetcher.swift +780 -0
  329. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexOAuthCredentials.swift +146 -0
  330. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexOAuthUsageFetcher.swift +269 -0
  331. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexTokenRefresher.swift +100 -0
  332. package/Sources/RunicCore/Providers/Codex/CodexProviderDescriptor.swift +243 -0
  333. package/Sources/RunicCore/Providers/Codex/CodexStatusProbe.swift +125 -0
  334. package/Sources/RunicCore/Providers/Codex/CodexUsageDataSource.swift +24 -0
  335. package/Sources/RunicCore/Providers/Codex/CodexWebDashboardStrategy.swift +181 -0
  336. package/Sources/RunicCore/Providers/Cohere/CohereProviderDescriptor.swift +83 -0
  337. package/Sources/RunicCore/Providers/Cohere/CohereUsageFetcher.swift +85 -0
  338. package/Sources/RunicCore/Providers/Copilot/CopilotDeviceFlow.swift +123 -0
  339. package/Sources/RunicCore/Providers/Copilot/CopilotGitHubCLITokenReader.swift +114 -0
  340. package/Sources/RunicCore/Providers/Copilot/CopilotProviderDescriptor.swift +100 -0
  341. package/Sources/RunicCore/Providers/Copilot/CopilotUsageFetcher.swift +291 -0
  342. package/Sources/RunicCore/Providers/Copilot/CopilotVSCodeTokenReader.swift +386 -0
  343. package/Sources/RunicCore/Providers/Cursor/CursorProviderDescriptor.swift +65 -0
  344. package/Sources/RunicCore/Providers/Cursor/CursorStatusProbe.swift +594 -0
  345. package/Sources/RunicCore/Providers/DeepSeek/DeepSeekProviderDescriptor.swift +85 -0
  346. package/Sources/RunicCore/Providers/DeepSeek/DeepSeekUsageFetcher.swift +108 -0
  347. package/Sources/RunicCore/Providers/Factory/FactoryLocalStorageImporter.swift +398 -0
  348. package/Sources/RunicCore/Providers/Factory/FactoryProviderDescriptor.swift +65 -0
  349. package/Sources/RunicCore/Providers/Factory/FactoryStatusProbe.swift +1275 -0
  350. package/Sources/RunicCore/Providers/Fireworks/FireworksProviderDescriptor.swift +84 -0
  351. package/Sources/RunicCore/Providers/Fireworks/FireworksUsageFetcher.swift +75 -0
  352. package/Sources/RunicCore/Providers/Gemini/GeminiProviderDescriptor.swift +65 -0
  353. package/Sources/RunicCore/Providers/Gemini/GeminiStatusProbe.swift +835 -0
  354. package/Sources/RunicCore/Providers/Groq/GroqProviderDescriptor.swift +83 -0
  355. package/Sources/RunicCore/Providers/Groq/GroqUsageFetcher.swift +71 -0
  356. package/Sources/RunicCore/Providers/Kimi/KimiProviderDescriptor.swift +83 -0
  357. package/Sources/RunicCore/Providers/Kimi/KimiUsageFetcher.swift +77 -0
  358. package/Sources/RunicCore/Providers/MiniMax/MiniMaxProviderDescriptor.swift +92 -0
  359. package/Sources/RunicCore/Providers/MiniMax/MiniMaxSettingsReader.swift +54 -0
  360. package/Sources/RunicCore/Providers/MiniMax/MiniMaxUsageFetcher.swift +171 -0
  361. package/Sources/RunicCore/Providers/MiniMax/MiniMaxWebUsageFetcher.swift +911 -0
  362. package/Sources/RunicCore/Providers/Mistral/MistralProviderDescriptor.swift +84 -0
  363. package/Sources/RunicCore/Providers/Mistral/MistralUsageFetcher.swift +75 -0
  364. package/Sources/RunicCore/Providers/OpenRouter/OpenRouterProviderDescriptor.swift +87 -0
  365. package/Sources/RunicCore/Providers/OpenRouter/OpenRouterUsageFetcher.swift +207 -0
  366. package/Sources/RunicCore/Providers/Perplexity/PerplexityProviderDescriptor.swift +84 -0
  367. package/Sources/RunicCore/Providers/Perplexity/PerplexityUsageFetcher.swift +75 -0
  368. package/Sources/RunicCore/Providers/ProviderBranding.swift +25 -0
  369. package/Sources/RunicCore/Providers/ProviderCLIConfig.swift +17 -0
  370. package/Sources/RunicCore/Providers/ProviderDescriptor.swift +129 -0
  371. package/Sources/RunicCore/Providers/ProviderFetchPlan.swift +263 -0
  372. package/Sources/RunicCore/Providers/ProviderSettingsSnapshot.swift +98 -0
  373. package/Sources/RunicCore/Providers/ProviderTokenResolver.swift +501 -0
  374. package/Sources/RunicCore/Providers/ProviderVersionDetector.swift +68 -0
  375. package/Sources/RunicCore/Providers/Providers.swift +184 -0
  376. package/Sources/RunicCore/Providers/Qwen/QwenProviderDescriptor.swift +84 -0
  377. package/Sources/RunicCore/Providers/Qwen/QwenSettingsReader.swift +30 -0
  378. package/Sources/RunicCore/Providers/Qwen/QwenUsageStats.swift +317 -0
  379. package/Sources/RunicCore/Providers/SambaNova/SambaNovaProviderDescriptor.swift +84 -0
  380. package/Sources/RunicCore/Providers/SambaNova/SambaNovaUsageFetcher.swift +75 -0
  381. package/Sources/RunicCore/Providers/Together/TogetherProviderDescriptor.swift +83 -0
  382. package/Sources/RunicCore/Providers/Together/TogetherUsageFetcher.swift +75 -0
  383. package/Sources/RunicCore/Providers/VertexAI/VertexAIProviderDescriptor.swift +123 -0
  384. package/Sources/RunicCore/Providers/VertexAI/VertexAISettingsReader.swift +48 -0
  385. package/Sources/RunicCore/Providers/VertexAI/VertexAIUsageFetcher.swift +144 -0
  386. package/Sources/RunicCore/Providers/XAI/XAIProviderDescriptor.swift +83 -0
  387. package/Sources/RunicCore/Providers/XAI/XAIUsageFetcher.swift +75 -0
  388. package/Sources/RunicCore/Providers/Zai/ZaiProviderDescriptor.swift +72 -0
  389. package/Sources/RunicCore/Providers/Zai/ZaiSettingsReader.swift +41 -0
  390. package/Sources/RunicCore/Providers/Zai/ZaiUsageStats.swift +724 -0
  391. package/Sources/RunicCore/Sync/BackgroundSyncManager.swift +385 -0
  392. package/Sources/RunicCore/Sync/SyncConflictResolver.swift +310 -0
  393. package/Sources/RunicCore/Sync/SyncProtocol.swift +288 -0
  394. package/Sources/RunicCore/Sync/SyncRecord.swift +405 -0
  395. package/Sources/RunicCore/Sync/SyncUsageExample.swift +294 -0
  396. package/Sources/RunicCore/Sync/TeamSyncRecords.swift +775 -0
  397. package/Sources/RunicCore/Sync/iCloudSyncEngine.swift +333 -0
  398. package/Sources/RunicCore/Team/TeamModels.swift +583 -0
  399. package/Sources/RunicCore/Team/TeamShowbackExporter.swift +495 -0
  400. package/Sources/RunicCore/Team/TeamStore.swift +792 -0
  401. package/Sources/RunicCore/TextParsing.swift +55 -0
  402. package/Sources/RunicCore/UsageFetcher.swift +694 -0
  403. package/Sources/RunicCore/UsageFormatter.swift +410 -0
  404. package/Sources/RunicCore/UsageLedger/ClaudeUsageLogSource.swift +329 -0
  405. package/Sources/RunicCore/UsageLedger/CodexUsageLogSource.swift +448 -0
  406. package/Sources/RunicCore/UsageLedger/OTelGenAILedgerAdapter.swift +550 -0
  407. package/Sources/RunicCore/UsageLedger/UsageLedger.swift +29 -0
  408. package/Sources/RunicCore/UsageLedger/UsageLedgerAggregator.swift +660 -0
  409. package/Sources/RunicCore/UsageLedger/UsageLedgerInsightsAdvisor.swift +209 -0
  410. package/Sources/RunicCore/UsageLedger/UsageLedgerModels.swift +417 -0
  411. package/Sources/RunicCore/UsageLedger/UsageLedgerProjectIdentity.swift +245 -0
  412. package/Sources/RunicCore/UsagePace.swift +81 -0
  413. package/Sources/RunicCore/Vendored/CostUsage/CostUsageCache.swift +73 -0
  414. package/Sources/RunicCore/Vendored/CostUsage/CostUsageJsonl.swift +74 -0
  415. package/Sources/RunicCore/Vendored/CostUsage/CostUsagePricing.swift +208 -0
  416. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner+Claude.swift +455 -0
  417. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner+Timestamp.swift +132 -0
  418. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner.swift +589 -0
  419. package/Sources/RunicCore/WidgetSnapshot.swift +183 -0
  420. package/Sources/RunicMacroSupport/ProviderRegistrationMacros.swift +14 -0
  421. package/Sources/RunicMacros/ProviderRegistrationMacros.swift +216 -0
  422. package/Sources/RunicWidget/RunicWidgetBundle.swift +79 -0
  423. package/Sources/RunicWidget/RunicWidgetProvider.swift +283 -0
  424. package/Sources/RunicWidget/RunicWidgetViews.swift +680 -0
  425. package/Tests/RunicTests/AntigravityStatusProbeTests.swift +50 -0
  426. package/Tests/RunicTests/AppDelegateTests.swift +43 -0
  427. package/Tests/RunicTests/BrowserCookieOrderLabelTests.swift +22 -0
  428. package/Tests/RunicTests/CLIArgumentParsingTests.swift +70 -0
  429. package/Tests/RunicTests/CLICostTests.swift +65 -0
  430. package/Tests/RunicTests/CLIProviderSelectionTests.swift +22 -0
  431. package/Tests/RunicTests/CLISnapshotTests.swift +72 -0
  432. package/Tests/RunicTests/CLIWebFallbackTests.swift +58 -0
  433. package/Tests/RunicTests/ClaudeOAuthTests.swift +164 -0
  434. package/Tests/RunicTests/ClaudeResilienceTests.swift +30 -0
  435. package/Tests/RunicTests/ClaudeUsageTests.swift +370 -0
  436. package/Tests/RunicTests/CodexOAuthTests.swift +122 -0
  437. package/Tests/RunicTests/CodexUsageLogSourceTests.swift +82 -0
  438. package/Tests/RunicTests/CopilotTokenResolverTests.swift +75 -0
  439. package/Tests/RunicTests/CopilotVSCodeTokenReaderTests.swift +75 -0
  440. package/Tests/RunicTests/CostUsageDecodingTests.swift +394 -0
  441. package/Tests/RunicTests/CostUsagePricingTests.swift +50 -0
  442. package/Tests/RunicTests/CostUsageScannerTests.swift +700 -0
  443. package/Tests/RunicTests/CursorStatusProbeTests.swift +323 -0
  444. package/Tests/RunicTests/FactoryStatusProbeTests.swift +69 -0
  445. package/Tests/RunicTests/GeminiAPITestHelpers.swift +94 -0
  446. package/Tests/RunicTests/GeminiLoginAlertTests.swift +28 -0
  447. package/Tests/RunicTests/GeminiStatusProbeAPITests.swift +283 -0
  448. package/Tests/RunicTests/GeminiStatusProbePlanTests.swift +279 -0
  449. package/Tests/RunicTests/GeminiStatusProbeTests.swift +233 -0
  450. package/Tests/RunicTests/GeminiTestEnvironment.swift +87 -0
  451. package/Tests/RunicTests/GoogleWorkspaceStatusTests.swift +73 -0
  452. package/Tests/RunicTests/InstallOriginTests.swift +18 -0
  453. package/Tests/RunicTests/KeyboardShortcutsBundleTests.swift +9 -0
  454. package/Tests/RunicTests/LiveAccountTests.swift +24 -0
  455. package/Tests/RunicTests/LoadingPatternTests.swift +35 -0
  456. package/Tests/RunicTests/MenuCardModelTests.swift +545 -0
  457. package/Tests/RunicTests/MiniMaxCookieHeaderStoreTestSupport.swift +8 -0
  458. package/Tests/RunicTests/MiniMaxGroupIDStoreTestSupport.swift +8 -0
  459. package/Tests/RunicTests/MiniMaxParsingTests.swift +68 -0
  460. package/Tests/RunicTests/MiniMaxTokenStoreTestSupport.swift +8 -0
  461. package/Tests/RunicTests/OTelGenAILedgerAdapterTests.swift +112 -0
  462. package/Tests/RunicTests/OpenAIDashboardBrowserCookieImporterTests.swift +17 -0
  463. package/Tests/RunicTests/OpenAIDashboardFetcherCreditsWaitTests.swift +75 -0
  464. package/Tests/RunicTests/OpenAIDashboardOffscreenHostTests.swift +27 -0
  465. package/Tests/RunicTests/OpenAIDashboardParserTests.swift +134 -0
  466. package/Tests/RunicTests/OpenAIWebAccountSwitchTests.swift +53 -0
  467. package/Tests/RunicTests/OpenRouterTokenStoreTestSupport.swift +92 -0
  468. package/Tests/RunicTests/PathBuilderTests.swift +237 -0
  469. package/Tests/RunicTests/ProviderFetchPipelineTests.swift +160 -0
  470. package/Tests/RunicTests/ProviderIconResourcesTests.swift +38 -0
  471. package/Tests/RunicTests/ProviderMetadataStatusLinkTests.swift +16 -0
  472. package/Tests/RunicTests/ProviderRegistryTests.swift +29 -0
  473. package/Tests/RunicTests/ProviderSettingsDescriptorTests.swift +202 -0
  474. package/Tests/RunicTests/ProviderToggleStoreTests.swift +51 -0
  475. package/Tests/RunicTests/RunicTests.swift +120 -0
  476. package/Tests/RunicTests/SessionQuotaNotificationLogicTests.swift +36 -0
  477. package/Tests/RunicTests/SettingsStoreTests.swift +161 -0
  478. package/Tests/RunicTests/StatusItemAnimationTests.swift +49 -0
  479. package/Tests/RunicTests/StatusMenuTests.swift +434 -0
  480. package/Tests/RunicTests/StatusProbeTests.swift +377 -0
  481. package/Tests/RunicTests/SubprocessRunnerTests.swift +20 -0
  482. package/Tests/RunicTests/SubscriptionDetectionTests.swift +65 -0
  483. package/Tests/RunicTests/TTYCommandRunnerTests.swift +148 -0
  484. package/Tests/RunicTests/TTYIntegrationTests.swift +41 -0
  485. package/Tests/RunicTests/TeamShowbackExporterTests.swift +159 -0
  486. package/Tests/RunicTests/TextParsingTests.swift +12 -0
  487. package/Tests/RunicTests/UsageFormatterTests.swift +112 -0
  488. package/Tests/RunicTests/UsageLedgerAnomalyDetectionTests.swift +172 -0
  489. package/Tests/RunicTests/UsageLedgerForecastTests.swift +213 -0
  490. package/Tests/RunicTests/UsageLedgerInsightsAdvisorTests.swift +83 -0
  491. package/Tests/RunicTests/UsageLedgerProjectNameTests.swift +170 -0
  492. package/Tests/RunicTests/UsagePaceTests.swift +77 -0
  493. package/Tests/RunicTests/UsagePaceTextTests.swift +109 -0
  494. package/Tests/RunicTests/UsagePolicyEngineTests.swift +91 -0
  495. package/Tests/RunicTests/WidgetSnapshotTests.swift +45 -0
  496. package/Tests/RunicTests/ZaiProviderTests.swift +61 -0
  497. package/Tests/RunicTests/ZaiTokenStoreTestSupport.swift +6 -0
  498. package/TestsLinux/PlatformGatingTests.swift +46 -0
  499. package/appcast.xml +105 -0
  500. package/assets/logo-concept-stack.svg +24 -0
  501. package/assets/logo-minimal-bars.svg +15 -0
  502. package/assets/logo.svg +20 -0
  503. package/assets/logo2.svg +43 -0
  504. package/bin/docs-list +5 -0
  505. package/bin/install-runic-cli.sh +32 -0
  506. package/build-and-run.sh +369 -0
  507. package/docs/.nojekyll +1 -0
  508. package/docs/CNAME +1 -0
  509. package/docs/antigravity.md +75 -0
  510. package/docs/architecture.md +32 -0
  511. package/docs/claude.md +93 -0
  512. package/docs/cli-commands/integration_guide.md +371 -0
  513. package/docs/cli-commands/quick_reference.md +362 -0
  514. package/docs/cli-commands/readme.md +361 -0
  515. package/docs/cli.md +156 -0
  516. package/docs/cloudkit_sync_guide.md +495 -0
  517. package/docs/codebase_review.md +288 -0
  518. package/docs/codex-oauth.md +635 -0
  519. package/docs/codex.md +104 -0
  520. package/docs/codexbar.png +0 -0
  521. package/docs/copilot.md +44 -0
  522. package/docs/cursor.md +46 -0
  523. package/docs/design/designcomparisonchart.md +510 -0
  524. package/docs/design/implementationguide.md +792 -0
  525. package/docs/design/menubaricondesignconcepts.md +796 -0
  526. package/docs/design/mockups/hybridiconconcept.svg +62 -0
  527. package/docs/design/mockups/infinityiconconcept.svg +41 -0
  528. package/docs/design/mockups/infinityiconstates.svg +129 -0
  529. package/docs/design/mockups/wavelogorefined.svg +48 -0
  530. package/docs/design/quick_summary.md +426 -0
  531. package/docs/design/readme.md +478 -0
  532. package/docs/design/sizespecifications.md +575 -0
  533. package/docs/design-system.md +836 -0
  534. package/docs/factory.md +103 -0
  535. package/docs/gemini.md +73 -0
  536. package/docs/icon.md +37 -0
  537. package/docs/icon.png +0 -0
  538. package/docs/index.html +175 -0
  539. package/docs/keychain_fix.md +274 -0
  540. package/docs/minimax.md +71 -0
  541. package/docs/packaging.md +25 -0
  542. package/docs/progress-bar-improvements.md +240 -0
  543. package/docs/progress-bar-quick-reference.md +283 -0
  544. package/docs/progress-bar-technical-details.md +432 -0
  545. package/docs/progress-bar-visual-test.swift +375 -0
  546. package/docs/provider.md +202 -0
  547. package/docs/providers.md +86 -0
  548. package/docs/refactor/macros.md +35 -0
  549. package/docs/refresh-loop.md +22 -0
  550. package/docs/releasing-homebrew.md +35 -0
  551. package/docs/releasing.md +121 -0
  552. package/docs/research/concrete_todo_2026-02-22.md +47 -0
  553. package/docs/research/core-feature-research.md +248 -0
  554. package/docs/research/feature_uiux_roadmap_2026-02-22.md +202 -0
  555. package/docs/research/parity_matrix.md +49 -0
  556. package/docs/research/provider_expansion_candidates_2026-02-22.md +80 -0
  557. package/docs/research/provider_model_token_project_matrix_2026-02-23.md +46 -0
  558. package/docs/research/release_gate_checklist.md +57 -0
  559. package/docs/site.css +505 -0
  560. package/docs/sparkle.md +28 -0
  561. package/docs/status.md +28 -0
  562. package/docs/sync/implementation.md +393 -0
  563. package/docs/sync/readme.md +317 -0
  564. package/docs/sync_files_summary.md +391 -0
  565. package/docs/sync_quick_reference.md +225 -0
  566. package/docs/todo.md +11 -0
  567. package/docs/ui.md +29 -0
  568. package/docs/web-integration.md +9 -0
  569. package/docs/widgets.md +85 -0
  570. package/docs/workflows/error-handling-improvements.md +434 -0
  571. package/docs/workflows/folder_structure.md +299 -0
  572. package/docs/workflows/loading_states.md +446 -0
  573. package/docs/workflows/loading_states_examples.md +565 -0
  574. package/docs/workflows/loading_states_flow.md +430 -0
  575. package/docs/workflows/performance_optimizations.md +457 -0
  576. package/docs/workflows/phase1-cli-testing-report.md +313 -0
  577. package/docs/workflows/quick_reference.md +228 -0
  578. package/docs/workflows/readme.md +59 -0
  579. package/docs/workflows/recent_improvements.md +275 -0
  580. package/docs/workflows/sync_enablement_summary.md +400 -0
  581. package/docs/zai.md +43 -0
  582. package/package.json +36 -0
  583. package/runic.png +0 -0
  584. package/version.env +2 -0
@@ -0,0 +1,545 @@
1
+ import RunicCore
2
+ import Foundation
3
+ import SwiftUI
4
+ import Testing
5
+ @testable import Runic
6
+
7
+ private extension UsageMenuCardView.Model.Input {
8
+ init(
9
+ provider: UsageProvider,
10
+ metadata: ProviderMetadata,
11
+ snapshot: UsageSnapshot?,
12
+ credits: CreditsSnapshot?,
13
+ creditsError: String?,
14
+ dashboard: OpenAIDashboardSnapshot?,
15
+ dashboardError: String?,
16
+ tokenSnapshot: CostUsageTokenSnapshot?,
17
+ tokenError: String?,
18
+ ledgerDaily: UsageLedgerDailySummary? = nil,
19
+ ledgerActiveBlock: UsageLedgerBlockSummary? = nil,
20
+ ledgerTopModel: UsageLedgerModelSummary? = nil,
21
+ ledgerTopProject: UsageLedgerProjectSummary? = nil,
22
+ ledgerSpendForecast: UsageLedgerSpendForecast? = nil,
23
+ ledgerTopProjectSpendForecast: UsageLedgerSpendForecast? = nil,
24
+ ledgerAnomaly: UsageLedgerAnomalySummary? = nil,
25
+ ledgerReliability: UsageLedgerReliabilityScore? = nil,
26
+ ledgerRouting: UsageLedgerRoutingRecommendation? = nil,
27
+ ledgerError: String? = nil,
28
+ ledgerUpdatedAt: Date? = nil,
29
+ account: AccountInfo,
30
+ isRefreshing: Bool,
31
+ lastError: String?,
32
+ usageBarsShowUsed: Bool,
33
+ menuMode: MenuMode = .`operator`,
34
+ tokenCostUsageEnabled: Bool,
35
+ showOptionalCreditsAndExtraUsage: Bool,
36
+ now: Date)
37
+ {
38
+ self.init(
39
+ provider: provider,
40
+ metadata: metadata,
41
+ snapshot: snapshot,
42
+ credits: credits,
43
+ creditsError: creditsError,
44
+ dashboard: dashboard,
45
+ dashboardError: dashboardError,
46
+ tokenSnapshot: tokenSnapshot,
47
+ tokenError: tokenError,
48
+ ledgerDaily: ledgerDaily,
49
+ ledgerActiveBlock: ledgerActiveBlock,
50
+ ledgerTopModel: ledgerTopModel,
51
+ ledgerTopProject: ledgerTopProject,
52
+ ledgerSpendForecast: ledgerSpendForecast,
53
+ ledgerTopProjectSpendForecast: ledgerTopProjectSpendForecast,
54
+ ledgerAnomaly: ledgerAnomaly,
55
+ ledgerReliability: ledgerReliability,
56
+ ledgerRouting: ledgerRouting,
57
+ ledgerError: ledgerError,
58
+ ledgerUpdatedAt: ledgerUpdatedAt,
59
+ account: account,
60
+ isRefreshing: isRefreshing,
61
+ lastError: lastError,
62
+ usageBarsShowUsed: usageBarsShowUsed,
63
+ usageMetricDisplayMode: .barsAndPercent,
64
+ menuMode: menuMode,
65
+ tokenCostUsageEnabled: tokenCostUsageEnabled,
66
+ showOptionalCreditsAndExtraUsage: showOptionalCreditsAndExtraUsage,
67
+ now: now)
68
+ }
69
+ }
70
+
71
+ @Suite
72
+ struct MenuCardModelTests {
73
+ @Test
74
+ func buildsMetricsUsingRemainingPercent() {
75
+ let now = Date()
76
+ let identity = ProviderIdentitySnapshot(
77
+ providerID: .codex,
78
+ accountEmail: "codex@example.com",
79
+ accountOrganization: nil,
80
+ loginMethod: "Plus Plan")
81
+ let snapshot = UsageSnapshot(
82
+ primary: RateWindow(
83
+ usedPercent: 22,
84
+ windowMinutes: 300,
85
+ resetsAt: now.addingTimeInterval(3000),
86
+ resetDescription: nil),
87
+ secondary: RateWindow(
88
+ usedPercent: 40,
89
+ windowMinutes: 10080,
90
+ resetsAt: now.addingTimeInterval(6000),
91
+ resetDescription: nil),
92
+ updatedAt: now,
93
+ identity: identity)
94
+ let metadata = ProviderDefaults.metadata[.codex]!
95
+ let updatedSnap = UsageSnapshot(
96
+ primary: snapshot.primary,
97
+ secondary: RateWindow(
98
+ usedPercent: snapshot.secondary!.usedPercent,
99
+ windowMinutes: snapshot.secondary!.windowMinutes,
100
+ resetsAt: now.addingTimeInterval(3600),
101
+ resetDescription: nil),
102
+ tertiary: snapshot.tertiary,
103
+ updatedAt: now,
104
+ identity: identity)
105
+
106
+ let model = UsageMenuCardView.Model.make(.init(
107
+ provider: .codex,
108
+ metadata: metadata,
109
+ snapshot: updatedSnap,
110
+ credits: CreditsSnapshot(remaining: 12, events: [], updatedAt: now),
111
+ creditsError: nil,
112
+ dashboard: nil,
113
+ dashboardError: nil,
114
+ tokenSnapshot: nil,
115
+ tokenError: nil,
116
+ account: AccountInfo(email: "codex@example.com", plan: "Plus Plan"),
117
+ isRefreshing: false,
118
+ lastError: nil,
119
+ usageBarsShowUsed: false,
120
+ tokenCostUsageEnabled: false,
121
+ showOptionalCreditsAndExtraUsage: true,
122
+ now: now))
123
+
124
+ #expect(model.providerName == "Codex")
125
+ #expect(model.metrics.count == 2)
126
+ #expect(model.metrics.first?.percent == 78)
127
+ #expect(model.planText == "Plus")
128
+ #expect(model.subtitleText.hasPrefix("Updated"))
129
+ #expect(model.progressColor != Color.clear)
130
+ #expect(model.metrics[1].resetText?.isEmpty == false)
131
+ }
132
+
133
+ @Test
134
+ func buildsMetricsUsingUsedPercentWhenEnabled() {
135
+ let now = Date()
136
+ let identity = ProviderIdentitySnapshot(
137
+ providerID: .codex,
138
+ accountEmail: "codex@example.com",
139
+ accountOrganization: nil,
140
+ loginMethod: "Plus Plan")
141
+ let snapshot = UsageSnapshot(
142
+ primary: RateWindow(
143
+ usedPercent: 22,
144
+ windowMinutes: 300,
145
+ resetsAt: now.addingTimeInterval(3000),
146
+ resetDescription: nil),
147
+ secondary: RateWindow(
148
+ usedPercent: 40,
149
+ windowMinutes: 10080,
150
+ resetsAt: now.addingTimeInterval(6000),
151
+ resetDescription: nil),
152
+ updatedAt: now,
153
+ identity: identity)
154
+ let metadata = ProviderDefaults.metadata[.codex]!
155
+
156
+ let dashboard = OpenAIDashboardSnapshot(
157
+ signedInEmail: "codex@example.com",
158
+ codeReviewRemainingPercent: 73,
159
+ creditEvents: [],
160
+ dailyBreakdown: [],
161
+ usageBreakdown: [],
162
+ creditsPurchaseURL: nil,
163
+ updatedAt: now)
164
+
165
+ let model = UsageMenuCardView.Model.make(.init(
166
+ provider: .codex,
167
+ metadata: metadata,
168
+ snapshot: snapshot,
169
+ credits: nil,
170
+ creditsError: nil,
171
+ dashboard: dashboard,
172
+ dashboardError: nil,
173
+ tokenSnapshot: nil,
174
+ tokenError: nil,
175
+ account: AccountInfo(email: "codex@example.com", plan: "Plus Plan"),
176
+ isRefreshing: false,
177
+ lastError: nil,
178
+ usageBarsShowUsed: true,
179
+ tokenCostUsageEnabled: false,
180
+ showOptionalCreditsAndExtraUsage: true,
181
+ now: now))
182
+
183
+ #expect(model.metrics.first?.title == "Session")
184
+ #expect(model.metrics.first?.percent == 22)
185
+ #expect(model.metrics.first?.percentLabel.contains("used") == true)
186
+ #expect(model.metrics.contains { $0.title == "Code review" && $0.percent == 27 })
187
+ }
188
+
189
+ @Test
190
+ func showsCodeReviewMetricWhenDashboardPresent() {
191
+ let now = Date()
192
+ let identity = ProviderIdentitySnapshot(
193
+ providerID: .codex,
194
+ accountEmail: "codex@example.com",
195
+ accountOrganization: nil,
196
+ loginMethod: nil)
197
+ let snapshot = UsageSnapshot(
198
+ primary: RateWindow(usedPercent: 0, windowMinutes: 300, resetsAt: nil, resetDescription: nil),
199
+ secondary: nil,
200
+ tertiary: nil,
201
+ updatedAt: now,
202
+ identity: identity)
203
+ let metadata = ProviderDefaults.metadata[.codex]!
204
+
205
+ let dashboard = OpenAIDashboardSnapshot(
206
+ signedInEmail: "codex@example.com",
207
+ codeReviewRemainingPercent: 73,
208
+ creditEvents: [],
209
+ dailyBreakdown: [],
210
+ usageBreakdown: [],
211
+ creditsPurchaseURL: nil,
212
+ updatedAt: now)
213
+ let model = UsageMenuCardView.Model.make(.init(
214
+ provider: .codex,
215
+ metadata: metadata,
216
+ snapshot: snapshot,
217
+ credits: nil,
218
+ creditsError: nil,
219
+ dashboard: dashboard,
220
+ dashboardError: nil,
221
+ tokenSnapshot: nil,
222
+ tokenError: nil,
223
+ account: AccountInfo(email: "codex@example.com", plan: nil),
224
+ isRefreshing: false,
225
+ lastError: nil,
226
+ usageBarsShowUsed: false,
227
+ tokenCostUsageEnabled: false,
228
+ showOptionalCreditsAndExtraUsage: true,
229
+ now: now))
230
+
231
+ #expect(model.metrics.contains { $0.title == "Code review" && $0.percent == 73 })
232
+ }
233
+
234
+ @Test
235
+ func claudeModelHidesWeeklyWhenUnavailable() {
236
+ let now = Date()
237
+ let identity = ProviderIdentitySnapshot(
238
+ providerID: .claude,
239
+ accountEmail: nil,
240
+ accountOrganization: nil,
241
+ loginMethod: "Max")
242
+ let snapshot = UsageSnapshot(
243
+ primary: RateWindow(
244
+ usedPercent: 2,
245
+ windowMinutes: nil,
246
+ resetsAt: now.addingTimeInterval(3600),
247
+ resetDescription: nil),
248
+ secondary: nil,
249
+ tertiary: nil,
250
+ updatedAt: now,
251
+ identity: identity)
252
+ let metadata = ProviderDefaults.metadata[.claude]!
253
+ let model = UsageMenuCardView.Model.make(.init(
254
+ provider: .claude,
255
+ metadata: metadata,
256
+ snapshot: snapshot,
257
+ credits: nil,
258
+ creditsError: nil,
259
+ dashboard: nil,
260
+ dashboardError: nil,
261
+ tokenSnapshot: nil,
262
+ tokenError: nil,
263
+ account: AccountInfo(email: "codex@example.com", plan: "plus"),
264
+ isRefreshing: false,
265
+ lastError: nil,
266
+ usageBarsShowUsed: false,
267
+ tokenCostUsageEnabled: false,
268
+ showOptionalCreditsAndExtraUsage: true,
269
+ now: now))
270
+
271
+ #expect(model.metrics.count == 1)
272
+ #expect(model.metrics.first?.title == "Session")
273
+ #expect(model.planText == "Max")
274
+ }
275
+
276
+ @Test
277
+ func showsErrorSubtitleWhenPresent() {
278
+ let metadata = ProviderDefaults.metadata[.codex]!
279
+ let model = UsageMenuCardView.Model.make(.init(
280
+ provider: .codex,
281
+ metadata: metadata,
282
+ snapshot: nil,
283
+ credits: nil,
284
+ creditsError: nil,
285
+ dashboard: nil,
286
+ dashboardError: nil,
287
+ tokenSnapshot: nil,
288
+ tokenError: nil,
289
+ account: AccountInfo(email: nil, plan: nil),
290
+ isRefreshing: false,
291
+ lastError: "Probe failed for Codex",
292
+ usageBarsShowUsed: false,
293
+ tokenCostUsageEnabled: false,
294
+ showOptionalCreditsAndExtraUsage: true,
295
+ now: Date()))
296
+
297
+ #expect(model.subtitleStyle == .error)
298
+ #expect(model.subtitleText.contains("Probe failed"))
299
+ #expect(model.placeholder == nil)
300
+ }
301
+
302
+ @Test
303
+ func costSectionIncludesLast30DaysTokens() {
304
+ let now = Date()
305
+ let metadata = ProviderDefaults.metadata[.codex]!
306
+ let snapshot = UsageSnapshot(
307
+ primary: RateWindow(usedPercent: 0, windowMinutes: 300, resetsAt: nil, resetDescription: nil),
308
+ secondary: nil,
309
+ tertiary: nil,
310
+ updatedAt: now)
311
+ let tokenSnapshot = CostUsageTokenSnapshot(
312
+ sessionTokens: 123,
313
+ sessionCostUSD: 1.23,
314
+ last30DaysTokens: 456,
315
+ last30DaysCostUSD: 78.9,
316
+ daily: [],
317
+ updatedAt: now)
318
+ let model = UsageMenuCardView.Model.make(.init(
319
+ provider: .codex,
320
+ metadata: metadata,
321
+ snapshot: snapshot,
322
+ credits: nil,
323
+ creditsError: nil,
324
+ dashboard: nil,
325
+ dashboardError: nil,
326
+ tokenSnapshot: tokenSnapshot,
327
+ tokenError: nil,
328
+ account: AccountInfo(email: nil, plan: nil),
329
+ isRefreshing: false,
330
+ lastError: nil,
331
+ usageBarsShowUsed: false,
332
+ tokenCostUsageEnabled: true,
333
+ showOptionalCreditsAndExtraUsage: true,
334
+ now: now))
335
+
336
+ #expect(model.tokenUsage?.monthLine.contains("456") == true)
337
+ #expect(model.tokenUsage?.monthLine.contains("tokens") == true)
338
+ }
339
+
340
+ @Test
341
+ func claudeModelDoesNotLeakCodexPlan() {
342
+ let metadata = ProviderDefaults.metadata[.claude]!
343
+ let model = UsageMenuCardView.Model.make(.init(
344
+ provider: .claude,
345
+ metadata: metadata,
346
+ snapshot: nil,
347
+ credits: nil,
348
+ creditsError: nil,
349
+ dashboard: nil,
350
+ dashboardError: nil,
351
+ tokenSnapshot: nil,
352
+ tokenError: nil,
353
+ account: AccountInfo(email: "codex@example.com", plan: "plus"),
354
+ isRefreshing: false,
355
+ lastError: nil,
356
+ usageBarsShowUsed: false,
357
+ tokenCostUsageEnabled: false,
358
+ showOptionalCreditsAndExtraUsage: true,
359
+ now: Date()))
360
+
361
+ #expect(model.planText == nil)
362
+ #expect(model.email.isEmpty)
363
+ }
364
+
365
+ @Test
366
+ func hidesCodexCreditsWhenDisabled() {
367
+ let now = Date()
368
+ let identity = ProviderIdentitySnapshot(
369
+ providerID: .codex,
370
+ accountEmail: "codex@example.com",
371
+ accountOrganization: nil,
372
+ loginMethod: nil)
373
+ let snapshot = UsageSnapshot(
374
+ primary: RateWindow(usedPercent: 0, windowMinutes: 300, resetsAt: nil, resetDescription: nil),
375
+ secondary: nil,
376
+ tertiary: nil,
377
+ updatedAt: now,
378
+ identity: identity)
379
+ let metadata = ProviderDefaults.metadata[.codex]!
380
+
381
+ let model = UsageMenuCardView.Model.make(.init(
382
+ provider: .codex,
383
+ metadata: metadata,
384
+ snapshot: snapshot,
385
+ credits: CreditsSnapshot(remaining: 12, events: [], updatedAt: now),
386
+ creditsError: nil,
387
+ dashboard: nil,
388
+ dashboardError: nil,
389
+ tokenSnapshot: nil,
390
+ tokenError: nil,
391
+ account: AccountInfo(email: "codex@example.com", plan: nil),
392
+ isRefreshing: false,
393
+ lastError: nil,
394
+ usageBarsShowUsed: false,
395
+ tokenCostUsageEnabled: false,
396
+ showOptionalCreditsAndExtraUsage: false,
397
+ now: now))
398
+
399
+ #expect(model.creditsText == nil)
400
+ }
401
+
402
+ @Test
403
+ func hidesClaudeExtraUsageWhenDisabled() {
404
+ let now = Date()
405
+ let identity = ProviderIdentitySnapshot(
406
+ providerID: .claude,
407
+ accountEmail: "claude@example.com",
408
+ accountOrganization: nil,
409
+ loginMethod: nil)
410
+ let snapshot = UsageSnapshot(
411
+ primary: RateWindow(usedPercent: 0, windowMinutes: nil, resetsAt: nil, resetDescription: nil),
412
+ secondary: nil,
413
+ tertiary: nil,
414
+ providerCost: ProviderCostSnapshot(used: 12, limit: 200, currencyCode: "USD", updatedAt: now),
415
+ updatedAt: now,
416
+ identity: identity)
417
+ let metadata = ProviderDefaults.metadata[.claude]!
418
+
419
+ let model = UsageMenuCardView.Model.make(.init(
420
+ provider: .claude,
421
+ metadata: metadata,
422
+ snapshot: snapshot,
423
+ credits: nil,
424
+ creditsError: nil,
425
+ dashboard: nil,
426
+ dashboardError: nil,
427
+ tokenSnapshot: nil,
428
+ tokenError: nil,
429
+ account: AccountInfo(email: nil, plan: nil),
430
+ isRefreshing: false,
431
+ lastError: nil,
432
+ usageBarsShowUsed: false,
433
+ tokenCostUsageEnabled: false,
434
+ showOptionalCreditsAndExtraUsage: false,
435
+ now: now))
436
+
437
+ #expect(model.providerCost == nil)
438
+ }
439
+
440
+ @Test
441
+ func insightsShowForecastAndBudgetETAForTopProject() {
442
+ let now = Date()
443
+ let metadata = ProviderDefaults.metadata[.codex]!
444
+ let topProject = UsageLedgerProjectSummary(
445
+ provider: .codex,
446
+ projectKey: "id:proj-runic",
447
+ projectID: "proj-runic",
448
+ projectName: "Runic",
449
+ entryCount: 5,
450
+ totals: UsageLedgerTotals(
451
+ inputTokens: 2_000,
452
+ outputTokens: 1_000,
453
+ cacheCreationTokens: 0,
454
+ cacheReadTokens: 0,
455
+ costUSD: 12.5),
456
+ modelsUsed: ["gpt-5"])
457
+ let providerForecast = UsageLedgerSpendForecast(
458
+ provider: .codex,
459
+ observedDays: 3,
460
+ observedCostUSD: 36,
461
+ averageDailyCostUSD: 12,
462
+ projected30DayCostUSD: 360,
463
+ projectedCostP50USD: 330,
464
+ projectedCostP80USD: 420,
465
+ projectedCostP95USD: 510)
466
+ let projectForecast = UsageLedgerSpendForecast(
467
+ provider: .codex,
468
+ projectKey: "id:proj-runic",
469
+ projectID: "proj-runic",
470
+ projectName: "Runic",
471
+ observedDays: 3,
472
+ observedCostUSD: 36,
473
+ averageDailyCostUSD: 12,
474
+ projected30DayCostUSD: 360)
475
+ .applyingBudget(monthlyLimitUSD: 60)
476
+
477
+ let model = UsageMenuCardView.Model.make(.init(
478
+ provider: .codex,
479
+ metadata: metadata,
480
+ snapshot: nil,
481
+ credits: nil,
482
+ creditsError: nil,
483
+ dashboard: nil,
484
+ dashboardError: nil,
485
+ tokenSnapshot: nil,
486
+ tokenError: nil,
487
+ ledgerTopProject: topProject,
488
+ ledgerSpendForecast: providerForecast,
489
+ ledgerTopProjectSpendForecast: projectForecast,
490
+ account: AccountInfo(email: nil, plan: nil),
491
+ isRefreshing: false,
492
+ lastError: nil,
493
+ usageBarsShowUsed: false,
494
+ tokenCostUsageEnabled: false,
495
+ showOptionalCreditsAndExtraUsage: true,
496
+ now: now))
497
+
498
+ #expect(model.insights?.forecastLine?.contains("Month-end forecast") == true)
499
+ #expect(model.insights?.forecastLine?.contains("p80") == true)
500
+ #expect(model.insights?.forecastLine?.contains("p95") == true)
501
+ #expect(model.insights?.projectDetail?.contains("Budget") == true)
502
+ #expect(model.insights?.projectDetail?.contains("Breach") == true)
503
+ }
504
+
505
+ @Test
506
+ func insightsSurfaceAnomalySeverityLine() {
507
+ let metadata = ProviderDefaults.metadata[.codex]!
508
+ let anomaly = UsageLedgerAnomalySummary(
509
+ provider: .codex,
510
+ baselineDays: 7,
511
+ tokenAnomaly: UsageLedgerAnomalySummary.MetricAnomaly(
512
+ metric: .tokens,
513
+ severity: .high,
514
+ todayValue: 4_200,
515
+ baselineAverage: 1_500,
516
+ percentIncrease: 1.8),
517
+ spendAnomaly: UsageLedgerAnomalySummary.MetricAnomaly(
518
+ metric: .spend,
519
+ severity: .elevated,
520
+ todayValue: 17.5,
521
+ baselineAverage: 9.0,
522
+ percentIncrease: 0.94))
523
+ let model = UsageMenuCardView.Model.make(.init(
524
+ provider: .codex,
525
+ metadata: metadata,
526
+ snapshot: nil,
527
+ credits: nil,
528
+ creditsError: nil,
529
+ dashboard: nil,
530
+ dashboardError: nil,
531
+ tokenSnapshot: nil,
532
+ tokenError: nil,
533
+ ledgerAnomaly: anomaly,
534
+ account: AccountInfo(email: nil, plan: nil),
535
+ isRefreshing: false,
536
+ lastError: nil,
537
+ usageBarsShowUsed: false,
538
+ tokenCostUsageEnabled: false,
539
+ showOptionalCreditsAndExtraUsage: true,
540
+ now: Date()))
541
+
542
+ #expect(model.insights?.anomalyLine == "Anomaly: High tokens spike")
543
+ #expect(model.insights?.anomalyDetail?.contains("+180%") == true)
544
+ }
545
+ }
@@ -0,0 +1,8 @@
1
+ @testable import Runic
2
+
3
+ struct NoopMiniMaxCookieHeaderStore: MiniMaxCookieHeaderStoring {
4
+ func loadHeader() throws -> String? { nil }
5
+ func storeHeader(_ header: String?) throws {
6
+ _ = header
7
+ }
8
+ }
@@ -0,0 +1,8 @@
1
+ @testable import Runic
2
+
3
+ struct NoopMiniMaxGroupIDStore: MiniMaxGroupIDStoring {
4
+ func loadGroupID() throws -> String? { nil }
5
+ func storeGroupID(_ groupID: String?) throws {
6
+ _ = groupID
7
+ }
8
+ }
@@ -0,0 +1,68 @@
1
+ import Foundation
2
+ import Testing
3
+ @testable import RunicCore
4
+
5
+ @Suite
6
+ struct MiniMaxParsingTests {
7
+ @Test
8
+ func parseManualInputCookieHeader() {
9
+ let input = "Cookie: foo=bar; baz=qux"
10
+ let parsed = MiniMaxWebParsing.parseManualInput(input)
11
+ #expect(parsed?.cookieHeader == "foo=bar; baz=qux")
12
+ #expect(parsed?.accessToken == nil)
13
+ }
14
+
15
+ @Test
16
+ func parseManualInputCurlExtractsBearerAndGroupID() {
17
+ let curl = """
18
+ curl 'https://platform.minimax.io/v1/api/openplatform/coding_plan/remains?GroupId=group_123' \
19
+ -H 'Cookie: session=abc; foo=bar' \
20
+ -H 'Authorization: Bearer header.token.value'
21
+ """
22
+ let parsed = MiniMaxWebParsing.parseManualInput(curl)
23
+ #expect(parsed?.cookieHeader == "session=abc; foo=bar")
24
+ #expect(parsed?.accessToken == "header.token.value")
25
+ #expect(parsed?.groupID == "group_123")
26
+ }
27
+
28
+ @Test
29
+ func parseHTMLUsageWithPercentAndReset() {
30
+ let html = """
31
+ <html>
32
+ <head><title>MiniMax Pro</title></head>
33
+ <body>
34
+ <div>Available usage: 40%</div>
35
+ <div>Resets in 2d 3h</div>
36
+ </body>
37
+ </html>
38
+ """
39
+ let now = Date(timeIntervalSince1970: 0)
40
+ let parsed = MiniMaxWebParsing.parseHTMLUsage(html, now: now)
41
+ #expect(parsed?.usedPercent == 60)
42
+ #expect(parsed?.planName == "MiniMax Pro")
43
+ #expect(parsed?.resetDescription == "Resets in 2d 3h")
44
+ #expect(parsed?.resetsAt == now.addingTimeInterval(TimeInterval((2 * 24 * 60 + 3 * 60) * 60)))
45
+ }
46
+
47
+ @Test
48
+ func parseRemainsResponseUsesModelRemains() throws {
49
+ let json = """
50
+ {
51
+ "base_resp": { "retcode": 0, "msg": "ok", "success": true },
52
+ "data": {
53
+ "model_remains": { "used": 20, "total": 100 },
54
+ "start_time": 1700000000,
55
+ "end_time": 1700003600,
56
+ "remains_time": 600,
57
+ "plan_name": "MiniMax Pro"
58
+ }
59
+ }
60
+ """
61
+ let now = Date(timeIntervalSince1970: 0)
62
+ let parsed = try MiniMaxWebParsing.parseRemainsResponse(Data(json.utf8), now: now)
63
+ #expect(parsed.usedPercent == 20)
64
+ #expect(parsed.windowMinutes == 60)
65
+ #expect(parsed.resetsAt == now.addingTimeInterval(600))
66
+ #expect(parsed.planName == "MiniMax Pro")
67
+ }
68
+ }
@@ -0,0 +1,8 @@
1
+ @testable import Runic
2
+
3
+ struct NoopMiniMaxTokenStore: MiniMaxTokenStoring {
4
+ func loadToken() throws -> String? { nil }
5
+ func storeToken(_ token: String?) throws {
6
+ _ = token
7
+ }
8
+ }