@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,150 @@
1
+ import AppKit
2
+ import RunicCore
3
+ import SwiftUI
4
+
5
+ enum MenuContentMetrics {
6
+ /// Horizontal padding for menu content
7
+ static let horizontalPadding: CGFloat = RunicSpacing.sm // 12
8
+
9
+ /// Vertical padding for menu content
10
+ static let verticalPadding: CGFloat = RunicSpacing.xs // 8
11
+
12
+ /// Spacing between menu sections
13
+ static let sectionSpacing: CGFloat = RunicSpacing.xs // 8
14
+
15
+ /// Spacing between menu entries
16
+ static let entrySpacing: CGFloat = RunicSpacing.xxs // 4
17
+
18
+ /// Minimum menu width
19
+ static let minWidth: CGFloat = 260
20
+ }
21
+
22
+ @MainActor
23
+ struct MenuContent: View {
24
+ @Bindable var store: UsageStore
25
+ @Bindable var settings: SettingsStore
26
+ let account: AccountInfo
27
+ let updater: UpdaterProviding
28
+ let provider: UsageProvider?
29
+ let actions: MenuActions
30
+
31
+ var body: some View {
32
+ let descriptor = MenuDescriptor.build(
33
+ provider: self.provider,
34
+ store: self.store,
35
+ settings: self.settings,
36
+ account: self.account,
37
+ updateReady: self.updater.updateStatus.isUpdateReady)
38
+
39
+ VStack(alignment: .leading, spacing: MenuContentMetrics.sectionSpacing) {
40
+ ForEach(Array(descriptor.sections.enumerated()), id: \.offset) { index, section in
41
+ VStack(alignment: .leading, spacing: MenuContentMetrics.entrySpacing) {
42
+ ForEach(Array(section.entries.enumerated()), id: \.offset) { _, entry in
43
+ self.row(for: entry)
44
+ }
45
+ }
46
+ if index < descriptor.sections.count - 1 {
47
+ Divider()
48
+ .padding(.vertical, RunicSpacing.xxs)
49
+ }
50
+ }
51
+ }
52
+ .padding(.horizontal, MenuContentMetrics.horizontalPadding)
53
+ .padding(.vertical, MenuContentMetrics.verticalPadding)
54
+ .frame(minWidth: MenuContentMetrics.minWidth, alignment: .leading)
55
+ }
56
+
57
+ @ViewBuilder
58
+ private func row(for entry: MenuDescriptor.Entry) -> some View {
59
+ switch entry {
60
+ case let .text(text, style):
61
+ switch style {
62
+ case .headline:
63
+ Text(text).font(.headline)
64
+ case .primary:
65
+ Text(text)
66
+ case .secondary:
67
+ Text(text).foregroundStyle(.secondary).font(.footnote)
68
+ }
69
+ case let .action(title, action):
70
+ Button {
71
+ self.perform(action)
72
+ } label: {
73
+ if let icon = self.iconName(for: action) {
74
+ HStack(spacing: 8) {
75
+ Image(systemName: icon)
76
+ .imageScale(.medium)
77
+ .frame(width: 18, alignment: .center)
78
+ Text(title)
79
+ }
80
+ .foregroundStyle(.primary)
81
+ } else {
82
+ Text(title)
83
+ }
84
+ }
85
+ .buttonStyle(.plain)
86
+ case .divider:
87
+ Divider()
88
+ .padding(.vertical, RunicSpacing.xxs)
89
+ }
90
+ }
91
+
92
+ private func iconName(for action: MenuDescriptor.MenuAction) -> String? { action.systemImageName }
93
+
94
+ private func perform(_ action: MenuDescriptor.MenuAction) {
95
+ switch action {
96
+ case .refresh:
97
+ self.actions.refresh()
98
+ case .installUpdate:
99
+ self.actions.installUpdate()
100
+ case .dashboard:
101
+ self.actions.openDashboard()
102
+ case .statusPage:
103
+ self.actions.openStatusPage()
104
+ case let .switchAccount(provider):
105
+ self.actions.switchAccount(provider)
106
+ case .settings:
107
+ self.actions.openSettings()
108
+ case .about:
109
+ self.actions.openAbout()
110
+ case .quit:
111
+ self.actions.quit()
112
+ case let .copyError(message):
113
+ self.actions.copyError(message)
114
+ }
115
+ }
116
+ }
117
+
118
+ struct MenuActions {
119
+ let installUpdate: () -> Void
120
+ let refresh: () -> Void
121
+ let openDashboard: () -> Void
122
+ let openStatusPage: () -> Void
123
+ let switchAccount: (UsageProvider) -> Void
124
+ let openSettings: () -> Void
125
+ let openAbout: () -> Void
126
+ let quit: () -> Void
127
+ let copyError: (String) -> Void
128
+ }
129
+
130
+ @MainActor
131
+ struct StatusIconView: View {
132
+ @Bindable var store: UsageStore
133
+ let provider: UsageProvider
134
+
135
+ var body: some View {
136
+ Image(nsImage: self.icon)
137
+ .renderingMode(.template)
138
+ .interpolation(.none)
139
+ }
140
+
141
+ private var icon: NSImage {
142
+ IconRenderer.makeIcon(
143
+ primaryRemaining: self.store.snapshot(for: self.provider)?.primary.remainingPercent,
144
+ weeklyRemaining: self.store.snapshot(for: self.provider)?.secondary?.remainingPercent,
145
+ creditsRemaining: self.provider == .codex ? self.store.credits?.remaining : nil,
146
+ stale: self.store.isStale(provider: self.provider),
147
+ style: self.store.style(for: self.provider),
148
+ statusIndicator: self.store.statusIndicator(for: self.provider))
149
+ }
150
+ }
@@ -0,0 +1,369 @@
1
+ import RunicCore
2
+ import Foundation
3
+
4
+ @MainActor
5
+ struct MenuDescriptor {
6
+ struct Section {
7
+ var entries: [Entry]
8
+ }
9
+
10
+ enum Entry {
11
+ case text(String, TextStyle)
12
+ case action(String, MenuAction)
13
+ case divider
14
+ }
15
+
16
+ enum MenuActionSystemImage: String {
17
+ case refresh = "arrow.clockwise"
18
+ case dashboard = "chart.bar"
19
+ case statusPage = "waveform.path.ecg"
20
+ case switchAccount = "key"
21
+ case settings = "gearshape"
22
+ case about = "info.circle"
23
+ case quit = "xmark.rectangle"
24
+ case copyError = "doc.on.doc"
25
+ }
26
+
27
+ enum TextStyle {
28
+ case headline
29
+ case primary
30
+ case secondary
31
+ }
32
+
33
+ enum MenuAction {
34
+ case installUpdate
35
+ case refresh
36
+ case dashboard
37
+ case statusPage
38
+ case switchAccount(UsageProvider)
39
+ case settings
40
+ case about
41
+ case quit
42
+ case copyError(String)
43
+ }
44
+
45
+ var sections: [Section]
46
+
47
+ static func build(
48
+ provider: UsageProvider?,
49
+ store: UsageStore,
50
+ settings: SettingsStore,
51
+ account: AccountInfo,
52
+ updateReady: Bool) -> MenuDescriptor
53
+ {
54
+ var sections: [Section] = []
55
+
56
+ switch provider {
57
+ case .codex?:
58
+ sections.append(Self.usageSection(for: .codex, store: store, settings: settings))
59
+ if let accountSection = Self.accountSection(for: .codex, store: store, account: account) {
60
+ sections.append(accountSection)
61
+ }
62
+ case .claude?:
63
+ sections.append(Self.usageSection(for: .claude, store: store, settings: settings))
64
+ if let accountSection = Self.accountSection(for: .claude, store: store, account: account) {
65
+ sections.append(accountSection)
66
+ }
67
+ case let provider?:
68
+ sections.append(Self.usageSection(for: provider, store: store, settings: settings))
69
+ if let accountSection = Self.accountSection(for: provider, store: store, account: account) {
70
+ sections.append(accountSection)
71
+ }
72
+ case nil:
73
+ var addedUsage = false
74
+
75
+ for enabledProvider in store.enabledProviders() {
76
+ sections.append(Self.usageSection(for: enabledProvider, store: store, settings: settings))
77
+ addedUsage = true
78
+ }
79
+ if addedUsage {
80
+ if let accountProvider = Self.accountProviderForCombined(store: store),
81
+ let accountSection = Self.accountSection(for: accountProvider, store: store, account: account)
82
+ {
83
+ sections.append(accountSection)
84
+ }
85
+ } else {
86
+ sections.append(Section(entries: [.text("No usage configured.", .secondary)]))
87
+ }
88
+ }
89
+
90
+ let actions = Self.actionsSection(for: provider, store: store, settings: settings, account: account)
91
+ if !actions.entries.isEmpty {
92
+ sections.append(actions)
93
+ }
94
+ sections.append(Self.metaSection(updateReady: updateReady))
95
+
96
+ return MenuDescriptor(sections: sections)
97
+ }
98
+
99
+ private static func usageSection(
100
+ for provider: UsageProvider,
101
+ store: UsageStore,
102
+ settings: SettingsStore) -> Section
103
+ {
104
+ let meta = store.metadata(for: provider)
105
+ var entries: [Entry] = []
106
+ let headlineText: String = {
107
+ if let ver = Self.versionNumber(for: provider, store: store) { return "\(meta.displayName) \(ver)" }
108
+ return meta.displayName
109
+ }()
110
+ entries.append(.text(headlineText, .headline))
111
+
112
+ if let snap = store.snapshot(for: provider) {
113
+ Self.appendRateWindow(entries: &entries, title: meta.sessionLabel, window: snap.primary)
114
+ if let weekly = snap.secondary {
115
+ Self.appendRateWindow(entries: &entries, title: meta.weeklyLabel, window: weekly)
116
+ if let paceText = UsagePaceText.weekly(provider: provider, window: weekly) {
117
+ entries.append(.text(paceText, .secondary))
118
+ }
119
+ } else if provider == .claude {
120
+ entries.append(.text("Weekly usage unavailable for this account.", .secondary))
121
+ }
122
+ if meta.supportsOpus, let opus = snap.tertiary {
123
+ Self.appendRateWindow(entries: &entries, title: meta.opusLabel ?? "Sonnet", window: opus)
124
+ }
125
+
126
+ if settings.showOptionalCreditsAndExtraUsage,
127
+ provider == .claude,
128
+ let cost = snap.providerCost
129
+ {
130
+ let used = UsageFormatter.currencyString(cost.used, currencyCode: cost.currencyCode)
131
+ let limit = UsageFormatter.currencyString(cost.limit, currencyCode: cost.currencyCode)
132
+ entries.append(.text("Extra usage: \(used) / \(limit)", .primary))
133
+ }
134
+
135
+ if provider == .cursor, let cost = snap.providerCost {
136
+ let used = UsageFormatter.currencyString(cost.used, currencyCode: cost.currencyCode)
137
+ if cost.limit > 0 {
138
+ let limitStr = UsageFormatter.currencyString(cost.limit, currencyCode: cost.currencyCode)
139
+ entries.append(.text("On-Demand: \(used) / \(limitStr)", .primary))
140
+ } else {
141
+ entries.append(.text("On-Demand: \(used)", .primary))
142
+ }
143
+ }
144
+ } else {
145
+ entries.append(.text("No usage yet", .secondary))
146
+ }
147
+
148
+ if settings.showOptionalCreditsAndExtraUsage,
149
+ meta.supportsCredits,
150
+ provider == .codex
151
+ {
152
+ if let credits = store.credits {
153
+ entries.append(.text("Credits: \(UsageFormatter.creditsString(from: credits.remaining))", .primary))
154
+ if let latest = credits.events.first {
155
+ entries.append(.text("Last spend: \(UsageFormatter.creditEventSummary(latest))", .secondary))
156
+ }
157
+ } else {
158
+ let hint = store.lastCreditsError ?? meta.creditsHint
159
+ entries.append(.text(hint, .secondary))
160
+ }
161
+ }
162
+
163
+ return Section(entries: entries)
164
+ }
165
+
166
+ private static func accountSection(
167
+ for provider: UsageProvider,
168
+ store: UsageStore,
169
+ account: AccountInfo) -> Section?
170
+ {
171
+ let snapshot = store.snapshot(for: provider)
172
+ let metadata = store.metadata(for: provider)
173
+ let entries = Self.accountEntries(
174
+ provider: provider,
175
+ snapshot: snapshot,
176
+ metadata: metadata,
177
+ fallback: account)
178
+ guard !entries.isEmpty else { return nil }
179
+ return Section(entries: entries)
180
+ }
181
+
182
+ private static func accountEntries(
183
+ provider: UsageProvider,
184
+ snapshot: UsageSnapshot?,
185
+ metadata: ProviderMetadata,
186
+ fallback: AccountInfo) -> [Entry]
187
+ {
188
+ var entries: [Entry] = []
189
+ let emailText = snapshot?.accountEmail(for: provider)?
190
+ .trimmingCharacters(in: .whitespacesAndNewlines)
191
+ let planText = snapshot?.loginMethod(for: provider)?
192
+ .trimmingCharacters(in: .whitespacesAndNewlines)
193
+
194
+ if let emailText, !emailText.isEmpty {
195
+ entries.append(.text("Account: \(emailText)", .secondary))
196
+ }
197
+ if let planText, !planText.isEmpty {
198
+ entries.append(.text("Plan: \(AccountFormatter.plan(planText))", .secondary))
199
+ }
200
+
201
+ if metadata.usesAccountFallback {
202
+ if emailText?.isEmpty ?? true, let fallbackEmail = fallback.email, !fallbackEmail.isEmpty {
203
+ entries.append(.text("Account: \(fallbackEmail)", .secondary))
204
+ }
205
+ if planText?.isEmpty ?? true, let fallbackPlan = fallback.plan, !fallbackPlan.isEmpty {
206
+ entries.append(.text("Plan: \(AccountFormatter.plan(fallbackPlan))", .secondary))
207
+ }
208
+ }
209
+
210
+ return entries
211
+ }
212
+
213
+ private static func accountProviderForCombined(store: UsageStore) -> UsageProvider? {
214
+ for provider in store.enabledProviders() {
215
+ let metadata = store.metadata(for: provider)
216
+ if store.snapshot(for: provider)?.identity(for: provider) != nil {
217
+ return provider
218
+ }
219
+ if metadata.usesAccountFallback {
220
+ return provider
221
+ }
222
+ }
223
+ return nil
224
+ }
225
+
226
+ private static func actionsSection(
227
+ for provider: UsageProvider?,
228
+ store: UsageStore,
229
+ settings: SettingsStore,
230
+ account: AccountInfo) -> Section
231
+ {
232
+ var entries: [Entry] = []
233
+ let targetProvider = provider ?? store.enabledProviders().first
234
+ let metadata = targetProvider.map { store.metadata(for: $0) }
235
+
236
+ // Show "Add Account" if no account, "Switch Account" if logged in
237
+ if let targetProvider,
238
+ ProviderCatalog.implementation(for: targetProvider)?.supportsLoginFlow == true
239
+ {
240
+ let loginAction = self.switchAccountTarget(for: provider, store: store)
241
+ let hasAccount = self.hasAccount(for: provider, store: store, account: account)
242
+ let accountLabel = hasAccount ? "Switch Account..." : "Add Account..."
243
+ entries.append(.action(accountLabel, loginAction))
244
+ }
245
+
246
+ entries.append(.action("Ping now", .refresh))
247
+ if let refreshLine = store.autoRefreshStatusLine() {
248
+ entries.append(.text(refreshLine, .secondary))
249
+ }
250
+ if let lastRefreshLine = store.lastRefreshStatusLine() {
251
+ entries.append(.text(lastRefreshLine, .secondary))
252
+ }
253
+
254
+ if metadata?.dashboardURL != nil {
255
+ entries.append(.action("Usage Dashboard", .dashboard))
256
+ }
257
+ if metadata?.statusPageURL != nil || metadata?.statusLinkURL != nil {
258
+ entries.append(.action("Status Page", .statusPage))
259
+ }
260
+
261
+ if let statusLine = self.statusLine(for: provider, store: store) {
262
+ entries.append(.text(statusLine, .secondary))
263
+ }
264
+
265
+ return Section(entries: entries)
266
+ }
267
+
268
+ private static func metaSection(updateReady: Bool) -> Section {
269
+ var entries: [Entry] = []
270
+ if updateReady {
271
+ entries.append(.action("Update ready, restart now?", .installUpdate))
272
+ }
273
+ entries.append(contentsOf: [
274
+ .action("Settings...", .settings),
275
+ .action("About Runic", .about),
276
+ .action("Quit", .quit),
277
+ ])
278
+ return Section(entries: entries)
279
+ }
280
+
281
+ private static func statusLine(for provider: UsageProvider?, store: UsageStore) -> String? {
282
+ let target = provider ?? store.enabledProviders().first
283
+ guard let target,
284
+ let status = store.status(for: target),
285
+ status.indicator != .none else { return nil }
286
+
287
+ let description = status.description?.trimmingCharacters(in: .whitespacesAndNewlines)
288
+ let label = description?.isEmpty == false ? description! : status.indicator.label
289
+ if let updated = status.updatedAt {
290
+ let freshness = UsageFormatter.updatedString(from: updated)
291
+ return "\(label) — \(freshness)"
292
+ }
293
+ return label
294
+ }
295
+
296
+ private static func switchAccountTarget(for provider: UsageProvider?, store: UsageStore) -> MenuAction {
297
+ if let provider { return .switchAccount(provider) }
298
+ if let enabled = store.enabledProviders().first { return .switchAccount(enabled) }
299
+ return .switchAccount(.codex)
300
+ }
301
+
302
+ private static func hasAccount(for provider: UsageProvider?, store: UsageStore, account: AccountInfo) -> Bool {
303
+ let target = provider ?? store.enabledProviders().first ?? .codex
304
+ if let email = store.snapshot(for: target)?.accountEmail(for: target),
305
+ !email.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
306
+ {
307
+ return true
308
+ }
309
+ let metadata = store.metadata(for: target)
310
+ if metadata.usesAccountFallback,
311
+ let fallback = account.email?.trimmingCharacters(in: .whitespacesAndNewlines),
312
+ !fallback.isEmpty
313
+ {
314
+ return true
315
+ }
316
+ return false
317
+ }
318
+
319
+ private static func appendRateWindow(entries: inout [Entry], title: String, window: RateWindow) {
320
+ let line = UsageFormatter
321
+ .usageLine(remaining: window.remainingPercent, used: window.usedPercent)
322
+ entries.append(.text("\(title): \(line)", .primary))
323
+ if let date = window.resetsAt {
324
+ let countdown = UsageFormatter.resetCountdownDescription(from: date)
325
+ entries.append(.text("Resets \(countdown)", .secondary))
326
+ } else if let reset = window.resetDescription {
327
+ entries.append(.text(Self.resetLine(reset), .secondary))
328
+ }
329
+ }
330
+
331
+ private static func resetLine(_ reset: String) -> String {
332
+ let trimmed = reset.trimmingCharacters(in: .whitespacesAndNewlines)
333
+ if trimmed.lowercased().hasPrefix("resets") { return trimmed }
334
+ return "Resets \(trimmed)"
335
+ }
336
+
337
+ private static func versionNumber(for provider: UsageProvider, store: UsageStore) -> String? {
338
+ guard let raw = store.version(for: provider) else { return nil }
339
+ let pattern = #"[0-9]+(?:\.[0-9]+)*"#
340
+ guard let regex = try? NSRegularExpression(pattern: pattern) else { return nil }
341
+ let range = NSRange(raw.startIndex..<raw.endIndex, in: raw)
342
+ guard let match = regex.firstMatch(in: raw, options: [], range: range),
343
+ let r = Range(match.range, in: raw) else { return nil }
344
+ return String(raw[r])
345
+ }
346
+ }
347
+
348
+ private enum AccountFormatter {
349
+ static func plan(_ text: String) -> String {
350
+ let cleaned = UsageFormatter.cleanPlanName(text)
351
+ return cleaned.isEmpty ? text : cleaned
352
+ }
353
+
354
+ static func email(_ text: String) -> String { text }
355
+ }
356
+
357
+ extension MenuDescriptor.MenuAction {
358
+ var systemImageName: String? {
359
+ switch self {
360
+ case .installUpdate, .settings, .about, .quit:
361
+ nil
362
+ case .refresh: MenuDescriptor.MenuActionSystemImage.refresh.rawValue
363
+ case .dashboard: MenuDescriptor.MenuActionSystemImage.dashboard.rawValue
364
+ case .statusPage: MenuDescriptor.MenuActionSystemImage.statusPage.rawValue
365
+ case .switchAccount: MenuDescriptor.MenuActionSystemImage.switchAccount.rawValue
366
+ case .copyError: MenuDescriptor.MenuActionSystemImage.copyError.rawValue
367
+ }
368
+ }
369
+ }
@@ -0,0 +1,42 @@
1
+ import SwiftUI
2
+
3
+ private struct MenuItemHighlightedKey: EnvironmentKey {
4
+ static let defaultValue = false
5
+ }
6
+
7
+ extension EnvironmentValues {
8
+ var menuItemHighlighted: Bool {
9
+ get { self[MenuItemHighlightedKey.self] }
10
+ set { self[MenuItemHighlightedKey.self] = newValue }
11
+ }
12
+ }
13
+
14
+ enum MenuHighlightStyle {
15
+ static let selectionText = Color(nsColor: .selectedMenuItemTextColor)
16
+ static let normalPrimaryText = Color(nsColor: .controlTextColor)
17
+ static let normalSecondaryText = Color(nsColor: .secondaryLabelColor)
18
+
19
+ static func primary(_ highlighted: Bool) -> Color {
20
+ highlighted ? self.selectionText : self.normalPrimaryText
21
+ }
22
+
23
+ static func secondary(_ highlighted: Bool) -> Color {
24
+ highlighted ? self.selectionText : self.normalSecondaryText
25
+ }
26
+
27
+ static func error(_ highlighted: Bool) -> Color {
28
+ highlighted ? self.selectionText : Color(nsColor: .systemRed)
29
+ }
30
+
31
+ static func progressTrack(_ highlighted: Bool) -> Color {
32
+ highlighted ? self.selectionText.opacity(0.22) : Color(nsColor: .tertiaryLabelColor).opacity(0.22)
33
+ }
34
+
35
+ static func progressTint(_ highlighted: Bool, fallback: Color) -> Color {
36
+ highlighted ? self.selectionText : fallback
37
+ }
38
+
39
+ static func selectionBackground(_ highlighted: Bool) -> Color {
40
+ highlighted ? Color(nsColor: .selectedContentBackgroundColor) : .clear
41
+ }
42
+ }