@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,589 @@
1
+ import Foundation
2
+
3
+ enum CostUsageScanner {
4
+ struct Options: Sendable {
5
+ var codexSessionsRoot: URL?
6
+ var claudeProjectsRoots: [URL]?
7
+ var cacheRoot: URL?
8
+ var refreshMinIntervalSeconds: TimeInterval = 60
9
+ // Force a full rescan, ignoring per-file cache and incremental offsets.
10
+ var forceRescan: Bool = false
11
+
12
+ init(
13
+ codexSessionsRoot: URL? = nil,
14
+ claudeProjectsRoots: [URL]? = nil,
15
+ cacheRoot: URL? = nil,
16
+ forceRescan: Bool = false)
17
+ {
18
+ self.codexSessionsRoot = codexSessionsRoot
19
+ self.claudeProjectsRoots = claudeProjectsRoots
20
+ self.cacheRoot = cacheRoot
21
+ self.forceRescan = forceRescan
22
+ }
23
+ }
24
+
25
+ struct CodexParseResult: Sendable {
26
+ let days: [String: [String: [Int]]]
27
+ let parsedBytes: Int64
28
+ let lastModel: String?
29
+ let lastTotals: CostUsageCodexTotals?
30
+ }
31
+
32
+ struct ClaudeParseResult: Sendable {
33
+ let days: [String: [String: [Int]]]
34
+ let parsedBytes: Int64
35
+ }
36
+
37
+ static func loadDailyReport(
38
+ provider: UsageProvider,
39
+ since: Date,
40
+ until: Date,
41
+ now: Date = Date(),
42
+ options: Options = Options()) -> CostUsageDailyReport
43
+ {
44
+ let range = CostUsageDayRange(since: since, until: until)
45
+
46
+ switch provider {
47
+ case .codex:
48
+ return self.loadCodexDaily(range: range, now: now, options: options)
49
+ case .claude:
50
+ return self.loadClaudeDaily(range: range, now: now, options: options)
51
+ case .zai:
52
+ return CostUsageDailyReport(data: [], summary: nil)
53
+ case .gemini:
54
+ return CostUsageDailyReport(data: [], summary: nil)
55
+ case .antigravity:
56
+ return CostUsageDailyReport(data: [], summary: nil)
57
+ case .cursor:
58
+ return CostUsageDailyReport(data: [], summary: nil)
59
+ case .factory:
60
+ return CostUsageDailyReport(data: [], summary: nil)
61
+ case .copilot:
62
+ return CostUsageDailyReport(data: [], summary: nil)
63
+ case .minimax:
64
+ return CostUsageDailyReport(data: [], summary: nil)
65
+ case .openrouter:
66
+ return CostUsageDailyReport(data: [], summary: nil)
67
+ case .groq:
68
+ return CostUsageDailyReport(data: [], summary: nil)
69
+ case .deepseek:
70
+ return CostUsageDailyReport(data: [], summary: nil)
71
+ case .fireworks:
72
+ return CostUsageDailyReport(data: [], summary: nil)
73
+ case .mistral:
74
+ return CostUsageDailyReport(data: [], summary: nil)
75
+ case .perplexity:
76
+ return CostUsageDailyReport(data: [], summary: nil)
77
+ case .kimi:
78
+ return CostUsageDailyReport(data: [], summary: nil)
79
+ case .auggie:
80
+ return CostUsageDailyReport(data: [], summary: nil)
81
+ case .together:
82
+ return CostUsageDailyReport(data: [], summary: nil)
83
+ case .cohere:
84
+ return CostUsageDailyReport(data: [], summary: nil)
85
+ case .xai:
86
+ return CostUsageDailyReport(data: [], summary: nil)
87
+ case .cerebras:
88
+ return CostUsageDailyReport(data: [], summary: nil)
89
+ case .sambanova:
90
+ return CostUsageDailyReport(data: [], summary: nil)
91
+ case .azure:
92
+ return CostUsageDailyReport(data: [], summary: nil)
93
+ case .bedrock:
94
+ return CostUsageDailyReport(data: [], summary: nil)
95
+ case .vertexai:
96
+ return CostUsageDailyReport(data: [], summary: nil)
97
+ case .qwen:
98
+ return CostUsageDailyReport(data: [], summary: nil)
99
+ }
100
+ }
101
+
102
+ // MARK: - Day keys
103
+
104
+ struct CostUsageDayRange: Sendable {
105
+ let sinceKey: String
106
+ let untilKey: String
107
+ let scanSinceKey: String
108
+ let scanUntilKey: String
109
+
110
+ init(since: Date, until: Date) {
111
+ self.sinceKey = Self.dayKey(from: since)
112
+ self.untilKey = Self.dayKey(from: until)
113
+ self.scanSinceKey = Self.dayKey(from: Calendar.current.date(byAdding: .day, value: -1, to: since) ?? since)
114
+ self.scanUntilKey = Self.dayKey(from: Calendar.current.date(byAdding: .day, value: 1, to: until) ?? until)
115
+ }
116
+
117
+ static func dayKey(from date: Date) -> String {
118
+ let cal = Calendar.current
119
+ let comps = cal.dateComponents([.year, .month, .day], from: date)
120
+ let y = comps.year ?? 1970
121
+ let m = comps.month ?? 1
122
+ let d = comps.day ?? 1
123
+ return String(format: "%04d-%02d-%02d", y, m, d)
124
+ }
125
+
126
+ static func isInRange(dayKey: String, since: String, until: String) -> Bool {
127
+ if dayKey < since { return false }
128
+ if dayKey > until { return false }
129
+ return true
130
+ }
131
+ }
132
+
133
+ // MARK: - Codex
134
+
135
+ private static func defaultCodexSessionsRoot(options: Options) -> URL {
136
+ if let override = options.codexSessionsRoot { return override }
137
+ let env = ProcessInfo.processInfo.environment["CODEX_HOME"]?.trimmingCharacters(in: .whitespacesAndNewlines)
138
+ if let env, !env.isEmpty {
139
+ return URL(fileURLWithPath: env).appendingPathComponent("sessions", isDirectory: true)
140
+ }
141
+ return FileManager.default.homeDirectoryForCurrentUser
142
+ .appendingPathComponent(".codex", isDirectory: true)
143
+ .appendingPathComponent("sessions", isDirectory: true)
144
+ }
145
+
146
+ private static func listCodexSessionFiles(root: URL, scanSinceKey: String, scanUntilKey: String) -> [URL] {
147
+ var out: [URL] = []
148
+ var date = Self.parseDayKey(scanSinceKey) ?? Date()
149
+ let untilDate = Self.parseDayKey(scanUntilKey) ?? date
150
+
151
+ while date <= untilDate {
152
+ let comps = Calendar.current.dateComponents([.year, .month, .day], from: date)
153
+ let y = String(format: "%04d", comps.year ?? 1970)
154
+ let m = String(format: "%02d", comps.month ?? 1)
155
+ let d = String(format: "%02d", comps.day ?? 1)
156
+
157
+ let dayDir = root.appendingPathComponent(y, isDirectory: true)
158
+ .appendingPathComponent(m, isDirectory: true)
159
+ .appendingPathComponent(d, isDirectory: true)
160
+
161
+ if let items = try? FileManager.default.contentsOfDirectory(
162
+ at: dayDir,
163
+ includingPropertiesForKeys: [.isRegularFileKey],
164
+ options: [.skipsHiddenFiles])
165
+ {
166
+ for item in items where item.pathExtension.lowercased() == "jsonl" {
167
+ out.append(item)
168
+ }
169
+ }
170
+
171
+ date = Calendar.current.date(byAdding: .day, value: 1, to: date) ?? untilDate.addingTimeInterval(1)
172
+ }
173
+
174
+ return out
175
+ }
176
+
177
+ static func parseCodexFile(
178
+ fileURL: URL,
179
+ range: CostUsageDayRange,
180
+ startOffset: Int64 = 0,
181
+ initialModel: String? = nil,
182
+ initialTotals: CostUsageCodexTotals? = nil) -> CodexParseResult
183
+ {
184
+ var currentModel = initialModel
185
+ var previousTotals = initialTotals
186
+
187
+ var days: [String: [String: [Int]]] = [:]
188
+
189
+ func add(dayKey: String, model: String, input: Int, cached: Int, output: Int) {
190
+ guard CostUsageDayRange.isInRange(dayKey: dayKey, since: range.scanSinceKey, until: range.scanUntilKey)
191
+ else { return }
192
+ let normModel = CostUsagePricing.normalizeCodexModel(model)
193
+
194
+ var dayModels = days[dayKey] ?? [:]
195
+ var packed = dayModels[normModel] ?? [0, 0, 0]
196
+ packed[0] = (packed[safe: 0] ?? 0) + input
197
+ packed[1] = (packed[safe: 1] ?? 0) + cached
198
+ packed[2] = (packed[safe: 2] ?? 0) + output
199
+ dayModels[normModel] = packed
200
+ days[dayKey] = dayModels
201
+ }
202
+
203
+ let maxLineBytes = 256 * 1024
204
+ let prefixBytes = 32 * 1024
205
+
206
+ let parsedBytes = (try? CostUsageJsonl.scan(
207
+ fileURL: fileURL,
208
+ offset: startOffset,
209
+ maxLineBytes: maxLineBytes,
210
+ prefixBytes: prefixBytes,
211
+ onLine: { line in
212
+ guard !line.bytes.isEmpty else { return }
213
+ guard !line.wasTruncated else { return }
214
+
215
+ guard
216
+ line.bytes.containsAscii(#""type":"event_msg""#)
217
+ || line.bytes.containsAscii(#""type":"turn_context""#)
218
+ else { return }
219
+
220
+ if line.bytes.containsAscii(#""type":"event_msg""#), !line.bytes.containsAscii(#""token_count""#) {
221
+ return
222
+ }
223
+
224
+ guard
225
+ let obj = (try? JSONSerialization.jsonObject(with: line.bytes)) as? [String: Any],
226
+ let type = obj["type"] as? String
227
+ else { return }
228
+
229
+ guard let tsText = obj["timestamp"] as? String else { return }
230
+ guard let dayKey = Self.dayKeyFromTimestamp(tsText) ?? Self.dayKeyFromParsedISO(tsText) else { return }
231
+
232
+ if type == "turn_context" {
233
+ if let payload = obj["payload"] as? [String: Any] {
234
+ if let model = payload["model"] as? String {
235
+ currentModel = model
236
+ } else if let info = payload["info"] as? [String: Any], let model = info["model"] as? String {
237
+ currentModel = model
238
+ }
239
+ }
240
+ return
241
+ }
242
+
243
+ guard type == "event_msg" else { return }
244
+ guard let payload = obj["payload"] as? [String: Any] else { return }
245
+ guard (payload["type"] as? String) == "token_count" else { return }
246
+
247
+ let info = payload["info"] as? [String: Any]
248
+ let modelFromInfo = info?["model"] as? String
249
+ ?? info?["model_name"] as? String
250
+ ?? payload["model"] as? String
251
+ ?? obj["model"] as? String
252
+ let model = modelFromInfo ?? currentModel ?? "gpt-5"
253
+
254
+ func toInt(_ v: Any?) -> Int {
255
+ if let n = v as? NSNumber { return n.intValue }
256
+ return 0
257
+ }
258
+
259
+ let total = (info?["total_token_usage"] as? [String: Any])
260
+ let last = (info?["last_token_usage"] as? [String: Any])
261
+
262
+ var deltaInput = 0
263
+ var deltaCached = 0
264
+ var deltaOutput = 0
265
+
266
+ if let total {
267
+ let input = toInt(total["input_tokens"])
268
+ let cached = toInt(total["cached_input_tokens"] ?? total["cache_read_input_tokens"])
269
+ let output = toInt(total["output_tokens"])
270
+
271
+ let prev = previousTotals
272
+ deltaInput = max(0, input - (prev?.input ?? 0))
273
+ deltaCached = max(0, cached - (prev?.cached ?? 0))
274
+ deltaOutput = max(0, output - (prev?.output ?? 0))
275
+ previousTotals = CostUsageCodexTotals(input: input, cached: cached, output: output)
276
+ } else if let last {
277
+ deltaInput = max(0, toInt(last["input_tokens"]))
278
+ deltaCached = max(0, toInt(last["cached_input_tokens"] ?? last["cache_read_input_tokens"]))
279
+ deltaOutput = max(0, toInt(last["output_tokens"]))
280
+ } else {
281
+ return
282
+ }
283
+
284
+ if deltaInput == 0, deltaCached == 0, deltaOutput == 0 { return }
285
+ let cachedClamp = min(deltaCached, deltaInput)
286
+ add(dayKey: dayKey, model: model, input: deltaInput, cached: cachedClamp, output: deltaOutput)
287
+ })) ?? startOffset
288
+
289
+ return CodexParseResult(
290
+ days: days,
291
+ parsedBytes: parsedBytes,
292
+ lastModel: currentModel,
293
+ lastTotals: previousTotals)
294
+ }
295
+
296
+ private static func loadCodexDaily(range: CostUsageDayRange, now: Date, options: Options) -> CostUsageDailyReport {
297
+ var cache = CostUsageCacheIO.load(provider: .codex, cacheRoot: options.cacheRoot)
298
+ let nowMs = Int64(now.timeIntervalSince1970 * 1000)
299
+
300
+ let refreshMs = Int64(max(0, options.refreshMinIntervalSeconds) * 1000)
301
+ let shouldRefresh = refreshMs == 0 || cache.lastScanUnixMs == 0 || nowMs - cache.lastScanUnixMs > refreshMs
302
+
303
+ let root = self.defaultCodexSessionsRoot(options: options)
304
+ let files = Self.listCodexSessionFiles(
305
+ root: root,
306
+ scanSinceKey: range.scanSinceKey,
307
+ scanUntilKey: range.scanUntilKey)
308
+ let filePathsInScan = Set(files.map(\.path))
309
+
310
+ if shouldRefresh {
311
+ if options.forceRescan {
312
+ cache = CostUsageCache()
313
+ }
314
+ for fileURL in files {
315
+ let path = fileURL.path
316
+ let attrs = (try? FileManager.default.attributesOfItem(atPath: path)) ?? [:]
317
+ let mtime = (attrs[.modificationDate] as? Date)?.timeIntervalSince1970 ?? 0
318
+ let size = (attrs[.size] as? NSNumber)?.int64Value ?? 0
319
+ let mtimeMs = Int64(mtime * 1000)
320
+
321
+ if let cached = cache.files[path],
322
+ cached.mtimeUnixMs == mtimeMs,
323
+ cached.size == size
324
+ {
325
+ continue
326
+ }
327
+
328
+ if let cached = cache.files[path] {
329
+ let startOffset = cached.parsedBytes ?? cached.size
330
+ let canIncremental = size > cached.size && startOffset > 0 && startOffset <= size
331
+ && cached.lastTotals != nil
332
+ if canIncremental {
333
+ let delta = Self.parseCodexFile(
334
+ fileURL: fileURL,
335
+ range: range,
336
+ startOffset: startOffset,
337
+ initialModel: cached.lastModel,
338
+ initialTotals: cached.lastTotals)
339
+ if !delta.days.isEmpty {
340
+ Self.applyFileDays(cache: &cache, fileDays: delta.days, sign: 1)
341
+ }
342
+
343
+ var mergedDays = cached.days
344
+ Self.mergeFileDays(existing: &mergedDays, delta: delta.days)
345
+ cache.files[path] = Self.makeFileUsage(
346
+ mtimeUnixMs: mtimeMs,
347
+ size: size,
348
+ days: mergedDays,
349
+ parsedBytes: delta.parsedBytes,
350
+ lastModel: delta.lastModel,
351
+ lastTotals: delta.lastTotals)
352
+ continue
353
+ }
354
+
355
+ Self.applyFileDays(cache: &cache, fileDays: cached.days, sign: -1)
356
+ }
357
+
358
+ let parsed = Self.parseCodexFile(fileURL: fileURL, range: range)
359
+ let usage = Self.makeFileUsage(
360
+ mtimeUnixMs: mtimeMs,
361
+ size: size,
362
+ days: parsed.days,
363
+ parsedBytes: parsed.parsedBytes,
364
+ lastModel: parsed.lastModel,
365
+ lastTotals: parsed.lastTotals)
366
+ cache.files[path] = usage
367
+ Self.applyFileDays(cache: &cache, fileDays: usage.days, sign: 1)
368
+ }
369
+
370
+ for key in cache.files.keys where !filePathsInScan.contains(key) {
371
+ if let old = cache.files[key] {
372
+ Self.applyFileDays(cache: &cache, fileDays: old.days, sign: -1)
373
+ }
374
+ cache.files.removeValue(forKey: key)
375
+ }
376
+
377
+ Self.pruneDays(cache: &cache, sinceKey: range.scanSinceKey, untilKey: range.scanUntilKey)
378
+ cache.lastScanUnixMs = nowMs
379
+ CostUsageCacheIO.save(provider: .codex, cache: cache, cacheRoot: options.cacheRoot)
380
+ }
381
+
382
+ return Self.buildCodexReportFromCache(cache: cache, range: range)
383
+ }
384
+
385
+ private static func buildCodexReportFromCache(
386
+ cache: CostUsageCache,
387
+ range: CostUsageDayRange) -> CostUsageDailyReport
388
+ {
389
+ var entries: [CostUsageDailyReport.Entry] = []
390
+ var totalInput = 0
391
+ var totalOutput = 0
392
+ var totalTokens = 0
393
+ var totalCost: Double = 0
394
+ var costSeen = false
395
+
396
+ let dayKeys = cache.days.keys.sorted().filter {
397
+ CostUsageDayRange.isInRange(dayKey: $0, since: range.sinceKey, until: range.untilKey)
398
+ }
399
+
400
+ for day in dayKeys {
401
+ guard let models = cache.days[day] else { continue }
402
+ let modelNames = models.keys.sorted()
403
+
404
+ var dayInput = 0
405
+ var dayOutput = 0
406
+
407
+ var breakdown: [CostUsageDailyReport.ModelBreakdown] = []
408
+ var dayCost: Double = 0
409
+ var dayCostSeen = false
410
+
411
+ for model in modelNames {
412
+ let packed = models[model] ?? [0, 0, 0]
413
+ let input = packed[safe: 0] ?? 0
414
+ let cached = packed[safe: 1] ?? 0
415
+ let output = packed[safe: 2] ?? 0
416
+
417
+ dayInput += input
418
+ dayOutput += output
419
+
420
+ let cost = CostUsagePricing.codexCostUSD(
421
+ model: model,
422
+ inputTokens: input,
423
+ cachedInputTokens: cached,
424
+ outputTokens: output)
425
+ breakdown.append(CostUsageDailyReport.ModelBreakdown(modelName: model, costUSD: cost))
426
+ if let cost {
427
+ dayCost += cost
428
+ dayCostSeen = true
429
+ }
430
+ }
431
+
432
+ breakdown.sort { lhs, rhs in (rhs.costUSD ?? -1) < (lhs.costUSD ?? -1) }
433
+ let top = Array(breakdown.prefix(3))
434
+
435
+ let dayTotal = dayInput + dayOutput
436
+ let entryCost = dayCostSeen ? dayCost : nil
437
+ entries.append(CostUsageDailyReport.Entry(
438
+ date: day,
439
+ inputTokens: dayInput,
440
+ outputTokens: dayOutput,
441
+ totalTokens: dayTotal,
442
+ costUSD: entryCost,
443
+ modelsUsed: modelNames,
444
+ modelBreakdowns: top))
445
+
446
+ totalInput += dayInput
447
+ totalOutput += dayOutput
448
+ totalTokens += dayTotal
449
+ if let entryCost {
450
+ totalCost += entryCost
451
+ costSeen = true
452
+ }
453
+ }
454
+
455
+ let summary: CostUsageDailyReport.Summary? = entries.isEmpty
456
+ ? nil
457
+ : CostUsageDailyReport.Summary(
458
+ totalInputTokens: totalInput,
459
+ totalOutputTokens: totalOutput,
460
+ totalTokens: totalTokens,
461
+ totalCostUSD: costSeen ? totalCost : nil)
462
+
463
+ return CostUsageDailyReport(data: entries, summary: summary)
464
+ }
465
+
466
+ // MARK: - Shared cache mutations
467
+
468
+ static func makeFileUsage(
469
+ mtimeUnixMs: Int64,
470
+ size: Int64,
471
+ days: [String: [String: [Int]]],
472
+ parsedBytes: Int64?,
473
+ lastModel: String? = nil,
474
+ lastTotals: CostUsageCodexTotals? = nil) -> CostUsageFileUsage
475
+ {
476
+ CostUsageFileUsage(
477
+ mtimeUnixMs: mtimeUnixMs,
478
+ size: size,
479
+ days: days,
480
+ parsedBytes: parsedBytes,
481
+ lastModel: lastModel,
482
+ lastTotals: lastTotals)
483
+ }
484
+
485
+ static func mergeFileDays(
486
+ existing: inout [String: [String: [Int]]],
487
+ delta: [String: [String: [Int]]])
488
+ {
489
+ for (day, models) in delta {
490
+ var dayModels = existing[day] ?? [:]
491
+ for (model, packed) in models {
492
+ let existingPacked = dayModels[model] ?? []
493
+ let merged = Self.addPacked(a: existingPacked, b: packed, sign: 1)
494
+ if merged.allSatisfy({ $0 == 0 }) {
495
+ dayModels.removeValue(forKey: model)
496
+ } else {
497
+ dayModels[model] = merged
498
+ }
499
+ }
500
+
501
+ if dayModels.isEmpty {
502
+ existing.removeValue(forKey: day)
503
+ } else {
504
+ existing[day] = dayModels
505
+ }
506
+ }
507
+ }
508
+
509
+ static func applyFileDays(cache: inout CostUsageCache, fileDays: [String: [String: [Int]]], sign: Int) {
510
+ for (day, models) in fileDays {
511
+ var dayModels = cache.days[day] ?? [:]
512
+ for (model, packed) in models {
513
+ let existing = dayModels[model] ?? []
514
+ let merged = Self.addPacked(a: existing, b: packed, sign: sign)
515
+ if merged.allSatisfy({ $0 == 0 }) {
516
+ dayModels.removeValue(forKey: model)
517
+ } else {
518
+ dayModels[model] = merged
519
+ }
520
+ }
521
+
522
+ if dayModels.isEmpty {
523
+ cache.days.removeValue(forKey: day)
524
+ } else {
525
+ cache.days[day] = dayModels
526
+ }
527
+ }
528
+ }
529
+
530
+ static func pruneDays(cache: inout CostUsageCache, sinceKey: String, untilKey: String) {
531
+ for key in cache.days.keys where !CostUsageDayRange.isInRange(dayKey: key, since: sinceKey, until: untilKey) {
532
+ cache.days.removeValue(forKey: key)
533
+ }
534
+ }
535
+
536
+ static func addPacked(a: [Int], b: [Int], sign: Int) -> [Int] {
537
+ let len = max(a.count, b.count)
538
+ var out: [Int] = Array(repeating: 0, count: len)
539
+ for idx in 0..<len {
540
+ let next = (a[safe: idx] ?? 0) + sign * (b[safe: idx] ?? 0)
541
+ out[idx] = max(0, next)
542
+ }
543
+ return out
544
+ }
545
+
546
+ // MARK: - Date parsing
547
+
548
+ private static func parseDayKey(_ key: String) -> Date? {
549
+ let parts = key.split(separator: "-")
550
+ guard parts.count == 3 else { return nil }
551
+ guard
552
+ let y = Int(parts[0]),
553
+ let m = Int(parts[1]),
554
+ let d = Int(parts[2])
555
+ else { return nil }
556
+
557
+ var comps = DateComponents()
558
+ comps.calendar = Calendar.current
559
+ comps.timeZone = TimeZone.current
560
+ comps.year = y
561
+ comps.month = m
562
+ comps.day = d
563
+ comps.hour = 12
564
+ return comps.date
565
+ }
566
+ }
567
+
568
+ extension Data {
569
+ func containsAscii(_ needle: String) -> Bool {
570
+ guard let n = needle.data(using: .utf8) else { return false }
571
+ return self.range(of: n) != nil
572
+ }
573
+ }
574
+
575
+ extension [Int] {
576
+ subscript(safe index: Int) -> Int? {
577
+ if index < 0 { return nil }
578
+ if index >= self.count { return nil }
579
+ return self[index]
580
+ }
581
+ }
582
+
583
+ extension [UInt8] {
584
+ subscript(safe index: Int) -> UInt8? {
585
+ if index < 0 { return nil }
586
+ if index >= self.count { return nil }
587
+ return self[index]
588
+ }
589
+ }