@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,240 @@
1
+ import Foundation
2
+ import SQLite3
3
+
4
+ /// Shared Chromium cookie reader for all platforms.
5
+ /// Platform-specific decryptors are injected via `ChromiumCookieDecrypting`.
6
+ protocol ChromiumCookieDecrypting: Sendable {
7
+ var hasKey: Bool { get }
8
+ func decrypt(data: Data) -> String?
9
+ }
10
+
11
+ /// Reads Chromium-based cookie stores and returns normalized cookie records.
12
+ struct ChromiumCookieReader {
13
+ func readCookies(
14
+ store: BrowserCookieStore,
15
+ browser: Browser,
16
+ decryptor: ChromiumCookieDecrypting,
17
+ decryptionFailurePolicy: BrowserCookieDecryptionFailurePolicy,
18
+ requireKeyForEncrypted: Bool) throws -> [BrowserCookieRecord]
19
+ {
20
+ guard let databaseURL = store.databaseURL else {
21
+ throw BrowserCookieError.notFound(
22
+ browser: browser,
23
+ details: "Missing cookie database URL.")
24
+ }
25
+
26
+ let snapshot = SQLiteSnapshot.prepare(from: databaseURL)
27
+ defer { snapshot.cleanup() }
28
+
29
+ var db: OpaquePointer?
30
+ if sqlite3_open_v2(snapshot.readURL.path, &db, SQLITE_OPEN_READONLY, nil) != SQLITE_OK {
31
+ throw BrowserCookieError.loadFailed(
32
+ browser: browser,
33
+ details: "Unable to open cookies database.")
34
+ }
35
+ defer { sqlite3_close(db) }
36
+
37
+ let availableColumns = Self.fetchColumns(db: db, table: "cookies")
38
+ let select = Self.selectColumns(available: availableColumns)
39
+ let query = "SELECT \(select.columns.joined(separator: ", ")) FROM cookies"
40
+ var statement: OpaquePointer?
41
+ guard sqlite3_prepare_v2(db, query, -1, &statement, nil) == SQLITE_OK else {
42
+ throw BrowserCookieError.loadFailed(
43
+ browser: browser,
44
+ details: "Unable to read cookies table.")
45
+ }
46
+ defer { sqlite3_finalize(statement) }
47
+
48
+ let index = select.index
49
+ let partitionKeyColumn = select.partitionKeyColumn
50
+ var records: [BrowserCookieRecord] = []
51
+ var usedEncryptedValues = false
52
+ var failedDecryptions = 0
53
+
54
+ while sqlite3_step(statement) == SQLITE_ROW {
55
+ let hostKey = columnText(statement, index["host_key"] ?? 0) ?? ""
56
+ let name = columnText(statement, index["name"] ?? 1) ?? ""
57
+ let path = columnText(statement, index["path"] ?? 2) ?? ""
58
+ let value = columnText(statement, index["value"] ?? 3) ?? ""
59
+ let encrypted = columnBlob(statement, index["encrypted_value"] ?? 4)
60
+ let encryptedLength = columnBlobLength(statement, index["encrypted_value"] ?? 4)
61
+ let expiresUtc = columnInt64(statement, index["expires_utc"] ?? 5) ?? 0
62
+ let isSecure = (columnInt(statement, index["is_secure"] ?? 6) ?? 0) != 0
63
+ let isHttpOnly = (columnInt(statement, index["is_httponly"] ?? 7) ?? 0) != 0
64
+ let sameSiteValue = columnInt(statement, index["samesite"] ?? 8) ?? 0
65
+
66
+ let decryptedValue: String
67
+ if value.isEmpty, let encrypted = encrypted, encryptedLength > 0 {
68
+ usedEncryptedValues = true
69
+ let data = Data(bytes: encrypted, count: encryptedLength)
70
+ if let decrypted = decryptor.decrypt(data: data) {
71
+ decryptedValue = decrypted
72
+ } else {
73
+ failedDecryptions += 1
74
+ continue
75
+ }
76
+ } else {
77
+ decryptedValue = value
78
+ }
79
+
80
+ if hostKey.isEmpty || name.isEmpty {
81
+ continue
82
+ }
83
+
84
+ let expires = Self.date(fromChromiumTimestamp: expiresUtc)
85
+ let sameSite = Self.sameSite(from: sameSiteValue)
86
+ let createdAt = columnInt64(statement, index["creation_utc"]).flatMap(Self.date(fromChromiumTimestamp:))
87
+ let lastAccessedAt = columnInt64(statement, index["last_access_utc"]).flatMap(Self.date(fromChromiumTimestamp:))
88
+ let priorityValue = columnInt(statement, index["priority"]).map { Int($0) }
89
+ let priority = priorityValue.map(BrowserCookiePriority.init(rawValue:))
90
+ let isSameParty = columnInt(statement, index["is_same_party"]).map { $0 != 0 }
91
+ let partitionKey = partitionKeyColumn.flatMap { columnText(statement, index[$0]) }
92
+
93
+ records.append(BrowserCookieRecord(
94
+ domain: hostKey,
95
+ name: name,
96
+ path: path.isEmpty ? "/" : path,
97
+ value: decryptedValue,
98
+ expires: expires,
99
+ createdAt: createdAt,
100
+ lastAccessedAt: lastAccessedAt,
101
+ isSecure: isSecure,
102
+ isHTTPOnly: isHttpOnly,
103
+ sameSite: sameSite,
104
+ priority: priority,
105
+ partitionKey: partitionKey,
106
+ isSameParty: isSameParty))
107
+ }
108
+
109
+ if usedEncryptedValues, requireKeyForEncrypted, !decryptor.hasKey {
110
+ throw BrowserCookieError.accessDenied(
111
+ browser: browser,
112
+ details: "Keychain access required to decrypt cookies.")
113
+ }
114
+
115
+ if failedDecryptions > 0 {
116
+ if decryptionFailurePolicy == .strict {
117
+ throw BrowserCookieError.loadFailed(
118
+ browser: browser,
119
+ details: "Failed to decrypt \(failedDecryptions) cookie value(s).")
120
+ }
121
+ if usedEncryptedValues, records.isEmpty {
122
+ throw BrowserCookieError.loadFailed(
123
+ browser: browser,
124
+ details: "Unable to decrypt cookie values.")
125
+ }
126
+ }
127
+
128
+ return records
129
+ }
130
+
131
+ static func date(fromChromiumTimestamp timestamp: Int64) -> Date? {
132
+ guard timestamp > 0 else { return nil }
133
+ let seconds = Double(timestamp) / 1_000_000
134
+ return chromiumEpoch.addingTimeInterval(seconds)
135
+ }
136
+
137
+ static func sameSite(from value: Int32) -> BrowserCookieSameSite? {
138
+ switch value {
139
+ case 1:
140
+ return .lax
141
+ case 2:
142
+ return .strict
143
+ case 3:
144
+ return BrowserCookieSameSite.none
145
+ default:
146
+ return nil
147
+ }
148
+ }
149
+
150
+ private static let chromiumEpoch: Date = {
151
+ var components = DateComponents()
152
+ components.year = 1601
153
+ components.month = 1
154
+ components.day = 1
155
+ components.calendar = Calendar(identifier: .gregorian)
156
+ components.timeZone = TimeZone(secondsFromGMT: 0)
157
+ return components.date ?? Date(timeIntervalSince1970: 0)
158
+ }()
159
+
160
+ private struct ChromiumSelect {
161
+ let columns: [String]
162
+ let index: [String: Int]
163
+ let partitionKeyColumn: String?
164
+ }
165
+
166
+ private static func fetchColumns(db: OpaquePointer?, table: String) -> Set<String> {
167
+ guard let db else { return [] }
168
+ var columns = Set<String>()
169
+ let query = "PRAGMA table_info(\(table));"
170
+ var statement: OpaquePointer?
171
+ if sqlite3_prepare_v2(db, query, -1, &statement, nil) == SQLITE_OK {
172
+ while sqlite3_step(statement) == SQLITE_ROW {
173
+ if let name = sqlite3_column_text(statement, 1) {
174
+ columns.insert(String(cString: name))
175
+ }
176
+ }
177
+ }
178
+ sqlite3_finalize(statement)
179
+ return columns
180
+ }
181
+
182
+ private static func selectColumns(available: Set<String>) -> ChromiumSelect {
183
+ var columns = [
184
+ "host_key",
185
+ "name",
186
+ "path",
187
+ "value",
188
+ "encrypted_value",
189
+ "expires_utc",
190
+ "is_secure",
191
+ "is_httponly",
192
+ "samesite",
193
+ ]
194
+
195
+ for name in ["creation_utc", "last_access_utc", "priority", "is_same_party"] {
196
+ if available.contains(name) {
197
+ columns.append(name)
198
+ }
199
+ }
200
+
201
+ var partitionKeyColumn: String?
202
+ if available.contains("partition_key") {
203
+ partitionKeyColumn = "partition_key"
204
+ columns.append("partition_key")
205
+ } else if available.contains("top_frame_site_key") {
206
+ partitionKeyColumn = "top_frame_site_key"
207
+ columns.append("top_frame_site_key")
208
+ }
209
+
210
+ let index = Dictionary(uniqueKeysWithValues: columns.enumerated().map { ($1, $0) })
211
+ return ChromiumSelect(columns: columns, index: index, partitionKeyColumn: partitionKeyColumn)
212
+ }
213
+
214
+ private func columnText(_ statement: OpaquePointer?, _ index: Int?) -> String? {
215
+ guard let index, sqlite3_column_type(statement, Int32(index)) != SQLITE_NULL,
216
+ let text = sqlite3_column_text(statement, Int32(index)) else {
217
+ return nil
218
+ }
219
+ let value = String(cString: text)
220
+ return value.isEmpty ? nil : value
221
+ }
222
+
223
+ private func columnInt(_ statement: OpaquePointer?, _ index: Int?) -> Int32? {
224
+ guard let index, sqlite3_column_type(statement, Int32(index)) != SQLITE_NULL else { return nil }
225
+ return sqlite3_column_int(statement, Int32(index))
226
+ }
227
+
228
+ private func columnInt64(_ statement: OpaquePointer?, _ index: Int?) -> Int64? {
229
+ guard let index, sqlite3_column_type(statement, Int32(index)) != SQLITE_NULL else { return nil }
230
+ return sqlite3_column_int64(statement, Int32(index))
231
+ }
232
+
233
+ private func columnBlob(_ statement: OpaquePointer?, _ index: Int) -> UnsafeRawPointer? {
234
+ sqlite3_column_blob(statement, Int32(index))
235
+ }
236
+
237
+ private func columnBlobLength(_ statement: OpaquePointer?, _ index: Int) -> Int {
238
+ Int(sqlite3_column_bytes(statement, Int32(index)))
239
+ }
240
+ }
@@ -0,0 +1,86 @@
1
+ import Foundation
2
+
3
+ #if canImport(CommonCrypto)
4
+ import CommonCrypto
5
+ #endif
6
+
7
+ #if canImport(CryptoKit)
8
+ import CryptoKit
9
+ #elseif canImport(CryptoSwift)
10
+ import CryptoSwift
11
+ #endif
12
+
13
+ enum CryptoSupport {
14
+ static func decryptAESCBC(payload: Data, key: Data, iv: Data) -> Data? {
15
+ #if canImport(CommonCrypto)
16
+ var outLength: size_t = 0
17
+ var outData = Data(count: payload.count + kCCBlockSizeAES128)
18
+ let outCapacity = outData.count
19
+ let status = outData.withUnsafeMutableBytes { outBytes in
20
+ payload.withUnsafeBytes { payloadBytes in
21
+ iv.withUnsafeBytes { ivBytes in
22
+ key.withUnsafeBytes { keyBytes in
23
+ CCCrypt(
24
+ CCOperation(kCCDecrypt),
25
+ CCAlgorithm(kCCAlgorithmAES),
26
+ CCOptions(kCCOptionPKCS7Padding),
27
+ keyBytes.baseAddress,
28
+ key.count,
29
+ ivBytes.baseAddress,
30
+ payloadBytes.baseAddress,
31
+ payload.count,
32
+ outBytes.baseAddress,
33
+ outCapacity,
34
+ &outLength)
35
+ }
36
+ }
37
+ }
38
+ }
39
+ guard status == kCCSuccess else { return nil }
40
+ outData.removeSubrange(outLength..<outData.count)
41
+ return outData
42
+ #elseif canImport(CryptoSwift)
43
+ do {
44
+ let aes = try AES(
45
+ key: Array(key),
46
+ blockMode: CBC(iv: Array(iv)),
47
+ padding: .pkcs7)
48
+ let decrypted = try aes.decrypt(Array(payload))
49
+ return Data(decrypted)
50
+ } catch {
51
+ return nil
52
+ }
53
+ #else
54
+ return nil
55
+ #endif
56
+ }
57
+
58
+ static func decryptAESGCM(payload: Data, key: Data) -> Data? {
59
+ guard payload.count >= 12 + 16 else { return nil }
60
+ let nonce = payload.prefix(12)
61
+ let cipherTag = payload.dropFirst(12)
62
+ let ciphertext = cipherTag.dropLast(16)
63
+ let tag = cipherTag.suffix(16)
64
+ #if canImport(CryptoKit)
65
+ do {
66
+ let nonce = try AES.GCM.Nonce(data: nonce)
67
+ let sealedBox = try AES.GCM.SealedBox(nonce: nonce, ciphertext: ciphertext, tag: tag)
68
+ return try AES.GCM.open(sealedBox, using: SymmetricKey(data: key))
69
+ } catch {
70
+ return nil
71
+ }
72
+ #elseif canImport(CryptoSwift)
73
+ do {
74
+ let gcm = GCM(iv: Array(nonce), mode: .combined)
75
+ let aes = try AES(key: Array(key), blockMode: gcm, padding: .noPadding)
76
+ let combined = Array(ciphertext) + Array(tag)
77
+ let decrypted = try aes.decrypt(combined)
78
+ return Data(decrypted)
79
+ } catch {
80
+ return nil
81
+ }
82
+ #else
83
+ return nil
84
+ #endif
85
+ }
86
+ }
@@ -0,0 +1,172 @@
1
+ import Foundation
2
+ import SQLite3
3
+
4
+ /// Shared Firefox cookie reader for all platforms.
5
+ struct FirefoxCookieReader {
6
+ func readCookies(store: BrowserCookieStore) throws -> [BrowserCookieRecord] {
7
+ guard let databaseURL = store.databaseURL else {
8
+ throw BrowserCookieError.notFound(
9
+ browser: store.browser,
10
+ details: "Missing cookie database URL.")
11
+ }
12
+ let snapshot = SQLiteSnapshot.prepare(from: databaseURL)
13
+ defer { snapshot.cleanup() }
14
+
15
+ var db: OpaquePointer?
16
+ if sqlite3_open_v2(snapshot.readURL.path, &db, SQLITE_OPEN_READONLY, nil) != SQLITE_OK {
17
+ throw BrowserCookieError.loadFailed(
18
+ browser: store.browser,
19
+ details: "Unable to open cookies database.")
20
+ }
21
+ defer { sqlite3_close(db) }
22
+
23
+ let availableColumns = Self.fetchColumns(db: db, table: "moz_cookies")
24
+ let hostOnlyColumn = Self.hostOnlyColumn(in: availableColumns)
25
+ let selectColumns = Self.selectColumns(hostOnlyColumn: hostOnlyColumn, available: availableColumns)
26
+ let query = "SELECT \(selectColumns.joined(separator: ", ")) FROM moz_cookies"
27
+ var statement: OpaquePointer?
28
+ guard sqlite3_prepare_v2(db, query, -1, &statement, nil) == SQLITE_OK else {
29
+ throw BrowserCookieError.loadFailed(
30
+ browser: store.browser,
31
+ details: "Unable to read cookies table.")
32
+ }
33
+ defer { sqlite3_finalize(statement) }
34
+
35
+ let index = Dictionary(uniqueKeysWithValues: selectColumns.enumerated().map { ($1, $0) })
36
+ let hostOnlyIndex = hostOnlyColumn.flatMap { index[$0] }
37
+ var records: [BrowserCookieRecord] = []
38
+ while sqlite3_step(statement) == SQLITE_ROW {
39
+ let host = columnText(statement, index["host"] ?? 0) ?? ""
40
+ let name = columnText(statement, index["name"] ?? 1) ?? ""
41
+ let path = columnText(statement, index["path"] ?? 2) ?? ""
42
+ let value = columnText(statement, index["value"] ?? 3) ?? ""
43
+ let expirySeconds = columnInt64(statement, index["expiry"] ?? 4) ?? 0
44
+ let isSecure = (columnInt(statement, index["isSecure"] ?? 5) ?? 0) != 0
45
+ let isHttpOnly = (columnInt(statement, index["isHttpOnly"] ?? 6) ?? 0) != 0
46
+ let sameSiteValue = columnInt(statement, index["sameSite"] ?? 7) ?? 0
47
+ let isHostOnlyOverride: Bool?
48
+ if hostOnlyColumn == "isHostOnly", let index = hostOnlyIndex {
49
+ isHostOnlyOverride = (columnInt(statement, index) ?? 0) != 0
50
+ } else if hostOnlyColumn == "isDomain", let index = hostOnlyIndex {
51
+ let isDomain = (columnInt(statement, index) ?? 0) != 0
52
+ isHostOnlyOverride = !isDomain
53
+ } else {
54
+ isHostOnlyOverride = nil
55
+ }
56
+
57
+ if host.isEmpty || name.isEmpty {
58
+ continue
59
+ }
60
+
61
+ let expires = expirySeconds > 0 ? Date(timeIntervalSince1970: Double(expirySeconds)) : nil
62
+ let sameSite = Self.sameSite(from: sameSiteValue)
63
+ let createdAt = columnInt64(statement, index["creationTime"]).flatMap(Self.date(fromFirefoxTimestamp:))
64
+ let lastAccessedAt = columnInt64(statement, index["lastAccessed"]).flatMap(Self.date(fromFirefoxTimestamp:))
65
+ let priorityValue = columnInt(statement, index["priority"]).map { Int($0) }
66
+ let priority = priorityValue.map(BrowserCookiePriority.init(rawValue:))
67
+ let partitionKey = columnText(statement, index["partitionKey"])
68
+ let isSameParty = columnInt(statement, index["isSameParty"]).map { $0 != 0 }
69
+
70
+ records.append(BrowserCookieRecord(
71
+ domain: host,
72
+ name: name,
73
+ path: path.isEmpty ? "/" : path,
74
+ value: value,
75
+ expires: expires,
76
+ createdAt: createdAt,
77
+ lastAccessedAt: lastAccessedAt,
78
+ isSecure: isSecure,
79
+ isHTTPOnly: isHttpOnly,
80
+ isHostOnly: isHostOnlyOverride,
81
+ sameSite: sameSite,
82
+ priority: priority,
83
+ partitionKey: partitionKey,
84
+ isSameParty: isSameParty))
85
+ }
86
+
87
+ return records
88
+ }
89
+
90
+ private static func sameSite(from value: Int32) -> BrowserCookieSameSite? {
91
+ switch value {
92
+ case 0:
93
+ return BrowserCookieSameSite.none
94
+ case 1:
95
+ return .lax
96
+ case 2:
97
+ return .strict
98
+ default:
99
+ return nil
100
+ }
101
+ }
102
+
103
+ private static func fetchColumns(db: OpaquePointer?, table: String) -> Set<String> {
104
+ guard let db else { return [] }
105
+ var columns = Set<String>()
106
+ let query = "PRAGMA table_info(\(table));"
107
+ var statement: OpaquePointer?
108
+ if sqlite3_prepare_v2(db, query, -1, &statement, nil) == SQLITE_OK {
109
+ while sqlite3_step(statement) == SQLITE_ROW {
110
+ if let name = sqlite3_column_text(statement, 1) {
111
+ columns.insert(String(cString: name))
112
+ }
113
+ }
114
+ }
115
+ sqlite3_finalize(statement)
116
+ return columns
117
+ }
118
+
119
+ private static func hostOnlyColumn(in columns: Set<String>) -> String? {
120
+ if columns.contains("isHostOnly") {
121
+ return "isHostOnly"
122
+ }
123
+ if columns.contains("isDomain") {
124
+ return "isDomain"
125
+ }
126
+ return nil
127
+ }
128
+
129
+ private static func selectColumns(hostOnlyColumn: String?, available: Set<String>) -> [String] {
130
+ var columns = [
131
+ "host",
132
+ "name",
133
+ "path",
134
+ "value",
135
+ "expiry",
136
+ "isSecure",
137
+ "isHttpOnly",
138
+ "sameSite",
139
+ ]
140
+ if let hostOnlyColumn {
141
+ columns.append(hostOnlyColumn)
142
+ }
143
+ for name in ["creationTime", "lastAccessed", "priority", "partitionKey", "isSameParty"] where available.contains(name) {
144
+ columns.append(name)
145
+ }
146
+ return columns
147
+ }
148
+
149
+ private static func date(fromFirefoxTimestamp timestamp: Int64) -> Date? {
150
+ guard timestamp > 0 else { return nil }
151
+ return Date(timeIntervalSince1970: Double(timestamp) / 1_000_000)
152
+ }
153
+
154
+ private func columnText(_ statement: OpaquePointer?, _ index: Int?) -> String? {
155
+ guard let index, sqlite3_column_type(statement, Int32(index)) != SQLITE_NULL,
156
+ let text = sqlite3_column_text(statement, Int32(index)) else {
157
+ return nil
158
+ }
159
+ let value = String(cString: text)
160
+ return value.isEmpty ? nil : value
161
+ }
162
+
163
+ private func columnInt(_ statement: OpaquePointer?, _ index: Int?) -> Int32? {
164
+ guard let index, sqlite3_column_type(statement, Int32(index)) != SQLITE_NULL else { return nil }
165
+ return sqlite3_column_int(statement, Int32(index))
166
+ }
167
+
168
+ private func columnInt64(_ statement: OpaquePointer?, _ index: Int?) -> Int64? {
169
+ guard let index, sqlite3_column_type(statement, Int32(index)) != SQLITE_NULL else { return nil }
170
+ return sqlite3_column_int64(statement, Int32(index))
171
+ }
172
+ }
@@ -0,0 +1,172 @@
1
+ #if os(Linux)
2
+ import Foundation
3
+ import SQLite3
4
+ #if canImport(CryptoSwift)
5
+ import CryptoSwift
6
+ #endif
7
+
8
+ struct LinuxChromiumCookieReader {
9
+ func readCookies(
10
+ store: BrowserCookieStore,
11
+ decryptionFailurePolicy: BrowserCookieDecryptionFailurePolicy = .bestEffort) throws -> [BrowserCookieRecord]
12
+ {
13
+ let reader = ChromiumCookieReader()
14
+ let decryptor = LinuxChromiumDecryptor(browser: store.browser, databaseURL: store.databaseURL)
15
+ return try reader.readCookies(
16
+ store: store,
17
+ browser: store.browser,
18
+ decryptor: decryptor,
19
+ decryptionFailurePolicy: decryptionFailurePolicy,
20
+ requireKeyForEncrypted: false)
21
+ }
22
+ }
23
+
24
+ private struct LinuxChromiumDecryptor: ChromiumCookieDecrypting {
25
+ private static let salt = "saltysalt".data(using: .utf8) ?? Data()
26
+ private static let iterations: Int = 1
27
+ private static let keyLength: Int = 16
28
+
29
+ let legacyKey: Data?
30
+ let gcmKey: Data?
31
+
32
+ var hasKey: Bool { legacyKey != nil || gcmKey != nil }
33
+
34
+ init(browser: Browser, databaseURL: URL?) {
35
+ let password = Self.safeStoragePassword(for: browser)
36
+ self.legacyKey = password.flatMap { Self.deriveKey(from: $0) }
37
+ if let databaseURL {
38
+ self.gcmKey = Self.readLocalStateKey(databaseURL: databaseURL, legacyKey: self.legacyKey)
39
+ } else {
40
+ self.gcmKey = nil
41
+ }
42
+ }
43
+
44
+ func decrypt(data: Data) -> String? {
45
+ guard data.count > 3 else { return nil }
46
+ let prefix = data.prefix(3)
47
+ guard let prefixString = String(data: prefix, encoding: .utf8),
48
+ prefixString == "v10" || prefixString == "v11" else {
49
+ return nil
50
+ }
51
+
52
+ let payload = Data(data.dropFirst(3))
53
+ if let gcmKey, let plaintext = Self.decryptGCM(payload: payload, key: gcmKey) {
54
+ return plaintext
55
+ }
56
+ if let legacyKey, let plaintext = Self.decryptCBC(payload: payload, key: legacyKey) {
57
+ return plaintext
58
+ }
59
+ return nil
60
+ }
61
+
62
+ private static func decryptCBC(payload: Data, key: Data) -> String? {
63
+ let iv = Data(repeating: 0x20, count: 16)
64
+ guard let data = CryptoSupport.decryptAESCBC(payload: payload, key: key, iv: iv) else { return nil }
65
+ return String(decoding: data, as: UTF8.self)
66
+ }
67
+
68
+ private static func decryptGCM(payload: Data, key: Data) -> String? {
69
+ guard let data = CryptoSupport.decryptAESGCM(payload: payload, key: key) else { return nil }
70
+ return String(decoding: data, as: UTF8.self)
71
+ }
72
+
73
+ private static func safeStoragePassword(for browser: Browser) -> String? {
74
+ if let env = ProcessInfo.processInfo.environment["SILO_CHROME_SAFE_STORAGE"], !env.isEmpty {
75
+ return env
76
+ }
77
+ let candidates = secretServiceNames(for: browser)
78
+ if let value = LinuxSecretService.lookupPassword(applications: candidates) {
79
+ return value
80
+ }
81
+ if allowInsecureFallback() {
82
+ return "peanuts"
83
+ }
84
+ return nil
85
+ }
86
+
87
+ private static func secretServiceNames(for browser: Browser) -> [String] {
88
+ switch browser {
89
+ case .chrome, .chromeBeta, .chromeCanary:
90
+ return ["chrome", "google-chrome", "Chrome"]
91
+ case .chromium:
92
+ return ["chromium", "Chromium"]
93
+ case .brave, .braveBeta, .braveNightly:
94
+ return ["brave", "Brave"]
95
+ case .edge, .edgeBeta, .edgeCanary:
96
+ return ["edge", "microsoft-edge", "Edge"]
97
+ case .vivaldi:
98
+ return ["vivaldi", "Vivaldi"]
99
+ case .helium:
100
+ return ["Helium"]
101
+ case .arc, .arcBeta, .arcCanary, .chatgptAtlas, .safari, .firefox:
102
+ return ["chromium"]
103
+ }
104
+ }
105
+
106
+ private static func allowInsecureFallback() -> Bool {
107
+ let value = ProcessInfo.processInfo.environment["SILO_ALLOW_INSECURE_CHROMIUM_FALLBACK"] ?? ""
108
+ let normalized = value.trimmingCharacters(in: .whitespacesAndNewlines).lowercased()
109
+ return ["1", "true", "yes"].contains(normalized)
110
+ }
111
+
112
+ private static func deriveKey(from password: String) -> Data? {
113
+ #if canImport(CryptoSwift)
114
+ do {
115
+ let key = try PKCS5.PBKDF2(
116
+ password: Array(password.utf8),
117
+ salt: Array(salt),
118
+ iterations: iterations,
119
+ keyLength: keyLength,
120
+ variant: .sha1).calculate()
121
+ return Data(key)
122
+ } catch {
123
+ return nil
124
+ }
125
+ #else
126
+ return nil
127
+ #endif
128
+ }
129
+
130
+ private static func readLocalStateKey(databaseURL: URL, legacyKey: Data?) -> Data? {
131
+ guard let localStateURL = localStateURL(for: databaseURL),
132
+ let data = try? Data(contentsOf: localStateURL),
133
+ let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
134
+ let osCrypt = json["os_crypt"] as? [String: Any],
135
+ let encryptedKeyBase64 = osCrypt["encrypted_key"] as? String,
136
+ let encryptedKeyData = Data(base64Encoded: encryptedKeyBase64) else {
137
+ return nil
138
+ }
139
+
140
+ var keyData = encryptedKeyData
141
+ let dpapiPrefix = "DPAPI".data(using: .utf8) ?? Data()
142
+ if keyData.starts(with: dpapiPrefix) {
143
+ keyData = Data(keyData.dropFirst(dpapiPrefix.count))
144
+ }
145
+
146
+ if keyData.count == 32 {
147
+ return keyData
148
+ }
149
+
150
+ if keyData.count >= 3,
151
+ let prefix = String(data: keyData.prefix(3), encoding: .utf8),
152
+ (prefix == "v10" || prefix == "v11"),
153
+ let legacyKey,
154
+ let decrypted = CryptoSupport.decryptAESCBC(
155
+ payload: Data(keyData.dropFirst(3)),
156
+ key: legacyKey,
157
+ iv: Data(repeating: 0x20, count: 16)) {
158
+ return decrypted.count == 32 ? decrypted : nil
159
+ }
160
+
161
+ return nil
162
+ }
163
+
164
+ private static func localStateURL(for databaseURL: URL) -> URL? {
165
+ let parent = databaseURL.deletingLastPathComponent()
166
+ let profileURL = parent.lastPathComponent == "Network" ? parent.deletingLastPathComponent() : parent
167
+ let rootURL = profileURL.deletingLastPathComponent()
168
+ let localStateURL = rootURL.appendingPathComponent("Local State")
169
+ return FileManager.default.fileExists(atPath: localStateURL.path) ? localStateURL : nil
170
+ }
171
+ }
172
+ #endif