@agent-native/core 0.134.1 → 0.135.1

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 (463) hide show
  1. package/corpus/README.md +3 -3
  2. package/corpus/core/CHANGELOG.md +113 -0
  3. package/corpus/core/package.json +3 -2
  4. package/corpus/core/src/automations/service.ts +41 -4
  5. package/corpus/core/src/cli/mcp-config-writers.ts +27 -21
  6. package/corpus/core/src/client/agent-page/AgentJobsTab.tsx +187 -85
  7. package/corpus/core/src/client/agent-page/AutomationDetailsDialog.tsx +208 -0
  8. package/corpus/core/src/client/agent-page/AutomationScheduleDialog.tsx +180 -0
  9. package/corpus/core/src/client/agent-page/TimezoneSelect.tsx +241 -0
  10. package/corpus/core/src/client/agent-page/use-jobs.ts +50 -10
  11. package/corpus/core/src/client/org/OrgSwitcher.tsx +26 -0
  12. package/corpus/core/src/client/settings/AccountSettingsCard.tsx +35 -31
  13. package/corpus/core/src/client/settings/SchedulingTimezoneField.tsx +71 -0
  14. package/corpus/core/src/client/settings/SettingsRow.tsx +113 -0
  15. package/corpus/core/src/client/settings/agent-settings-search.ts +2 -1
  16. package/corpus/core/src/client/settings/index.ts +6 -0
  17. package/corpus/core/src/integrations/identity.ts +2 -12
  18. package/corpus/core/src/jobs/actions/list-automation-runs.ts +33 -0
  19. package/corpus/core/src/jobs/actions/list-recurring-jobs.ts +27 -6
  20. package/corpus/core/src/jobs/actions/manage-recurring-job.ts +41 -9
  21. package/corpus/core/src/jobs/background-automation-runner.ts +88 -0
  22. package/corpus/core/src/jobs/cron.ts +52 -6
  23. package/corpus/core/src/jobs/frontmatter.ts +20 -0
  24. package/corpus/core/src/jobs/run-history.ts +242 -0
  25. package/corpus/core/src/jobs/scheduler.ts +73 -18
  26. package/corpus/core/src/jobs/tools.ts +54 -6
  27. package/corpus/core/src/localization/actions/get-localization-preference.ts +2 -2
  28. package/corpus/core/src/localization/actions/set-localization-preference.ts +49 -11
  29. package/corpus/core/src/localization/default-messages.ts +27 -0
  30. package/corpus/core/src/localization/shared.ts +39 -6
  31. package/corpus/core/src/localization/user-timezone.ts +36 -0
  32. package/corpus/core/src/org/app-roles-handlers.ts +1 -9
  33. package/corpus/core/src/org/index.ts +2 -0
  34. package/corpus/core/src/org/membership.ts +18 -0
  35. package/corpus/core/src/review/actions/create-review-comment.ts +4 -1
  36. package/corpus/core/src/review/actions/reply-review-comment.ts +4 -1
  37. package/corpus/core/src/review/index.ts +5 -0
  38. package/corpus/core/src/review/notifications.ts +163 -0
  39. package/corpus/core/src/review/types.ts +7 -0
  40. package/corpus/core/src/server/action-discovery.ts +4 -0
  41. package/corpus/core/src/server/activity-notifications.ts +174 -0
  42. package/corpus/core/src/server/app-name.ts +31 -0
  43. package/corpus/core/src/server/better-auth-instance.ts +4 -4
  44. package/corpus/core/src/server/email-templates.ts +70 -14
  45. package/corpus/core/src/server/email.ts +66 -3
  46. package/corpus/core/src/server/index.ts +10 -0
  47. package/corpus/core/src/sharing/access.ts +44 -2
  48. package/corpus/core/src/sharing/index.ts +5 -0
  49. package/corpus/core/src/sharing/recipients.ts +67 -0
  50. package/corpus/core/src/triggers/actions/list-automations.ts +27 -8
  51. package/corpus/core/src/triggers/actions/manage-automation.ts +17 -6
  52. package/corpus/core/src/triggers/actions.ts +16 -4
  53. package/corpus/core/src/triggers/dispatcher.ts +44 -30
  54. package/corpus/core/src/triggers/routes.ts +19 -6
  55. package/corpus/core/src/vitest-config.ts +68 -0
  56. package/corpus/core/vitest.config.ts +5 -0
  57. package/corpus/templates/analytics/app/pages/Settings.tsx +37 -53
  58. package/corpus/templates/analytics/changelog/2026-08-01-new-error-alerts-now-reach-you-by-email-and-a-scheduled-dash.md +6 -0
  59. package/corpus/templates/analytics/server/jobs/dashboard-report.ts +43 -0
  60. package/corpus/templates/analytics/server/lib/error-capture.ts +5 -1
  61. package/corpus/templates/analytics/vitest.config.ts +16 -12
  62. package/corpus/templates/assets/actions/refresh-generation-run.ts +3 -0
  63. package/corpus/templates/assets/app/components/ui/switch.tsx +1 -0
  64. package/corpus/templates/assets/app/hooks/use-assets-prefs.ts +55 -0
  65. package/corpus/templates/assets/app/i18n-data.ts +30 -0
  66. package/corpus/templates/assets/app/routes/settings.tsx +58 -55
  67. package/corpus/templates/assets/changelog/2026-08-01-get-an-email-when-a-generation-you-started-finishes-or-fails.md +6 -0
  68. package/corpus/templates/assets/server/lib/generation-run-notifications.ts +89 -0
  69. package/corpus/templates/assets/server/lib/video-runs.ts +8 -1
  70. package/corpus/templates/assets/server/routes/_agent-native/assets/user-prefs.get.ts +17 -0
  71. package/corpus/templates/assets/server/routes/_agent-native/assets/user-prefs.put.ts +36 -0
  72. package/corpus/templates/assets/shared/assets-user-prefs.ts +10 -0
  73. package/corpus/templates/assets/vitest.config.ts +16 -12
  74. package/corpus/templates/brain/app/routes/settings.tsx +15 -15
  75. package/corpus/templates/brain/vitest.config.ts +16 -12
  76. package/corpus/templates/calendar/app/pages/Settings.tsx +32 -40
  77. package/corpus/templates/calendar/changelog/2026-08-01-language-and-appearance-now-sit-together-in-one-preferences-.md +6 -0
  78. package/corpus/templates/calendar/vitest.config.ts +16 -12
  79. package/corpus/templates/chat/app/routes/settings.tsx +14 -22
  80. package/corpus/templates/chat/vitest.config.ts +9 -0
  81. package/corpus/templates/clips/.agents/skills/video-editing/SKILL.md +31 -0
  82. package/corpus/templates/clips/AGENTS.md +1 -0
  83. package/corpus/templates/clips/actions/add-comment.ts +12 -1
  84. package/corpus/templates/clips/actions/create-meeting.ts +2 -2
  85. package/corpus/templates/clips/actions/create-recording.ts +2 -2
  86. package/corpus/templates/clips/actions/finalize-recording.ts +42 -6
  87. package/corpus/templates/clips/actions/generate-filmstrip.ts +154 -0
  88. package/corpus/templates/clips/actions/get-recording-player-data.ts +6 -0
  89. package/corpus/templates/clips/actions/import-loom-recording.ts +2 -2
  90. package/corpus/templates/clips/actions/lib/ensure-recording-filmstrip.ts +258 -0
  91. package/corpus/templates/clips/actions/lib/ensure-seekable-video.ts +11 -3
  92. package/corpus/templates/clips/actions/react-to-comment.ts +13 -0
  93. package/corpus/templates/clips/actions/react-to-recording.ts +10 -1
  94. package/corpus/templates/clips/actions/reply-to-comment.ts +12 -1
  95. package/corpus/templates/clips/actions/stitch-recordings.ts +2 -2
  96. package/corpus/templates/clips/app/components/editor/editor-layout.tsx +152 -23
  97. package/corpus/templates/clips/app/components/editor/waveform.tsx +237 -75
  98. package/corpus/templates/clips/app/components/recorder/recorder-engine.ts +23 -1
  99. package/corpus/templates/clips/app/components/settings/ai-setup-section.tsx +441 -0
  100. package/corpus/templates/clips/app/components/settings/slack-section.tsx +329 -0
  101. package/corpus/templates/clips/app/components/settings/types.ts +14 -0
  102. package/corpus/templates/clips/app/components/settings/video-storage-section.tsx +443 -0
  103. package/corpus/templates/clips/app/hooks/use-secret-status.ts +69 -0
  104. package/corpus/templates/clips/app/i18n/en-US.ts +9 -1
  105. package/corpus/templates/clips/app/lib/video-filmstrip.ts +262 -0
  106. package/corpus/templates/clips/app/routes/_app.settings._index.tsx +165 -1351
  107. package/corpus/templates/clips/changelog/2026-07-27-saved-clips-now-resume-from-the-last-uploaded-byte-after-an-.md +6 -0
  108. package/corpus/templates/clips/changelog/2026-07-31-editor-timeline-now-shows-video-frames-behind-the-waveform-g.md +6 -0
  109. package/corpus/templates/clips/changelog/2026-07-31-email-notifications-now-go-out-when-someone-comments-on-or-r.md +6 -0
  110. package/corpus/templates/clips/changelog/2026-07-31-you-can-now-set-a-default-visibility-for-new-recordings-in-s.md +6 -0
  111. package/corpus/templates/clips/changelog/2026-08-01-email-notifications-for-comments-and-reactions-now-actually-.md +6 -0
  112. package/corpus/templates/clips/changelog/2026-08-03-the-desktop-app-now-opens-directly-beneath-its-tray-icon-on-.md +6 -0
  113. package/corpus/templates/clips/chrome-extension/package.json +1 -0
  114. package/corpus/templates/clips/chrome-extension/vitest.config.ts +9 -0
  115. package/corpus/templates/clips/desktop/package.json +1 -0
  116. package/corpus/templates/clips/desktop/src/app.tsx +17 -1
  117. package/corpus/templates/clips/desktop/src/lib/recorder.ts +331 -36
  118. package/corpus/templates/clips/desktop/src/lib/upload-recovery.ts +129 -0
  119. package/corpus/templates/clips/desktop/src-tauri/src/native_screen.rs +815 -15
  120. package/corpus/templates/clips/desktop/src-tauri/src/tray.rs +61 -11
  121. package/corpus/templates/clips/desktop/vitest.config.ts +9 -0
  122. package/corpus/templates/clips/server/db/schema.ts +17 -0
  123. package/corpus/templates/clips/server/jobs/media-verification.ts +4 -0
  124. package/corpus/templates/clips/server/lib/activity-notifications.ts +185 -0
  125. package/corpus/templates/clips/server/lib/recording-media-cleanup.ts +2 -0
  126. package/corpus/templates/clips/server/lib/recording-upload-state.ts +46 -9
  127. package/corpus/templates/clips/server/lib/recordings.ts +24 -0
  128. package/corpus/templates/clips/server/lib/resumable-session.ts +10 -4
  129. package/corpus/templates/clips/server/lib/transactional-email-templates.ts +109 -0
  130. package/corpus/templates/clips/server/lib/upload-interruption.ts +8 -0
  131. package/corpus/templates/clips/server/lib/upload-lease.ts +50 -4
  132. package/corpus/templates/clips/server/lib/video-filmstrip-sprite.ts +207 -0
  133. package/corpus/templates/clips/server/lib/video-remux.ts +13 -4
  134. package/corpus/templates/clips/server/plugins/db.ts +16 -0
  135. package/corpus/templates/clips/server/routes/api/_agent-native-background/post-finalize-worker.post.ts +4 -0
  136. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/abort.post.ts +123 -36
  137. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/chunk.post.ts +159 -29
  138. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/interrupt.post.ts +197 -0
  139. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/reset-chunks.post.ts +193 -39
  140. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/resume.get.ts +191 -12
  141. package/corpus/templates/clips/shared/clips-ai-prefs.ts +6 -0
  142. package/corpus/templates/clips/shared/feature-flags.ts +12 -0
  143. package/corpus/templates/clips/shared/recording-core.ts +4 -0
  144. package/corpus/templates/clips/vitest.config.ts +23 -19
  145. package/corpus/templates/content/actions/_database-utils.ts +113 -4
  146. package/corpus/templates/content/actions/add-comment.ts +15 -1
  147. package/corpus/templates/content/actions/get-document.ts +84 -3
  148. package/corpus/templates/content/actions/list-documents.ts +1 -0
  149. package/corpus/templates/content/app/components/editor/BuilderBodySyncingNotice.tsx +9 -2
  150. package/corpus/templates/content/app/components/editor/DocumentEditor.tsx +34 -15
  151. package/corpus/templates/content/app/components/editor/DocumentToolbar.tsx +55 -13
  152. package/corpus/templates/content/app/components/editor/body-hydration.ts +12 -6
  153. package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx +2 -3
  154. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +5 -12
  155. package/corpus/templates/content/app/components/ui/switch.tsx +1 -0
  156. package/corpus/templates/content/app/hooks/use-content-database.ts +16 -27
  157. package/corpus/templates/content/app/hooks/use-content-prefs.ts +55 -0
  158. package/corpus/templates/content/app/hooks/use-create-page.ts +3 -6
  159. package/corpus/templates/content/app/hooks/use-document-properties.ts +9 -16
  160. package/corpus/templates/content/app/hooks/use-document-versions.ts +3 -3
  161. package/corpus/templates/content/app/hooks/use-documents.ts +85 -29
  162. package/corpus/templates/content/app/hooks/use-notion.ts +15 -13
  163. package/corpus/templates/content/app/i18n-data.ts +72 -1
  164. package/corpus/templates/content/app/lib/document-query.ts +36 -0
  165. package/corpus/templates/content/app/routes/_app.settings.tsx +47 -18
  166. package/corpus/templates/content/changelog/2026-07-30-breadcrumb-menus-now-hide-internal-system-pages.md +6 -0
  167. package/corpus/templates/content/changelog/2026-08-01-get-an-email-when-someone-comments-on-replies-in-or-mentions.md +6 -0
  168. package/corpus/templates/content/changelog/2026-08-02-pages-opened-from-a-database-now-keep-that-database-s-fields.md +6 -0
  169. package/corpus/templates/content/server/lib/comment-notifications.ts +146 -0
  170. package/corpus/templates/content/server/lib/document-context.ts +11 -6
  171. package/corpus/templates/content/server/routes/_agent-native/content/user-prefs.get.ts +17 -0
  172. package/corpus/templates/content/server/routes/_agent-native/content/user-prefs.put.ts +36 -0
  173. package/corpus/templates/content/shared/api.ts +8 -0
  174. package/corpus/templates/content/shared/content-user-prefs.ts +11 -0
  175. package/corpus/templates/content/vitest.config.ts +20 -16
  176. package/corpus/templates/crm/app/routes/settings.tsx +14 -22
  177. package/corpus/templates/crm/vitest.config.ts +8 -4
  178. package/corpus/templates/design/app/routes/settings.tsx +14 -22
  179. package/corpus/templates/design/changelog/2026-08-01-review-comments-replies-and-mentions-now-send-an-email-to-th.md +6 -0
  180. package/corpus/templates/design/vitest.config.ts +18 -12
  181. package/corpus/templates/dispatch/app/routes/settings.tsx +26 -40
  182. package/corpus/templates/dispatch/vitest.config.ts +11 -7
  183. package/corpus/templates/factory/app/routes/settings.tsx +14 -22
  184. package/corpus/templates/factory/vitest.config.ts +9 -0
  185. package/corpus/templates/forms/app/routes/_app.settings.tsx +14 -22
  186. package/corpus/templates/forms/vitest.config.ts +27 -23
  187. package/corpus/templates/macros/app/routes/settings.tsx +14 -22
  188. package/corpus/templates/macros/vitest.config.ts +16 -12
  189. package/corpus/templates/mail/app/pages/SettingsPage.tsx +14 -16
  190. package/corpus/templates/mail/vitest.config.ts +16 -12
  191. package/corpus/templates/plan/app/routes/settings.tsx +30 -44
  192. package/corpus/templates/plan/vitest.config.ts +24 -20
  193. package/corpus/templates/slides/actions/add-slide-comment.ts +12 -1
  194. package/corpus/templates/slides/app/components/ui/switch.tsx +1 -0
  195. package/corpus/templates/slides/app/hooks/use-slides-prefs.ts +55 -0
  196. package/corpus/templates/slides/app/i18n/en-US.ts +4 -0
  197. package/corpus/templates/slides/app/routes/settings.tsx +45 -22
  198. package/corpus/templates/slides/changelog/2026-08-01-get-an-email-when-someone-comments-on-or-replies-in-your-dec.md +6 -0
  199. package/corpus/templates/slides/server/lib/comment-notifications.ts +182 -0
  200. package/corpus/templates/slides/server/routes/_agent-native/slides/user-prefs.get.ts +16 -0
  201. package/corpus/templates/slides/server/routes/_agent-native/slides/user-prefs.put.ts +36 -0
  202. package/corpus/templates/slides/shared/slides-user-prefs.ts +11 -0
  203. package/corpus/templates/slides/vitest.config.ts +17 -13
  204. package/corpus/templates/tasks/app/components/layout/Sidebar.tsx +2 -0
  205. package/corpus/templates/tasks/app/routes/settings.tsx +14 -22
  206. package/corpus/templates/tasks/vitest.config.ts +17 -13
  207. package/corpus/toolkit/CHANGELOG.md +9 -0
  208. package/corpus/toolkit/package.json +1 -1
  209. package/corpus/toolkit/vitest.config.ts +3 -0
  210. package/dist/automations/service.d.ts +2 -0
  211. package/dist/automations/service.d.ts.map +1 -1
  212. package/dist/automations/service.js +29 -4
  213. package/dist/automations/service.js.map +1 -1
  214. package/dist/cli/mcp-config-writers.d.ts.map +1 -1
  215. package/dist/cli/mcp-config-writers.js +24 -23
  216. package/dist/cli/mcp-config-writers.js.map +1 -1
  217. package/dist/client/agent-page/AgentJobsTab.d.ts.map +1 -1
  218. package/dist/client/agent-page/AgentJobsTab.js +86 -29
  219. package/dist/client/agent-page/AgentJobsTab.js.map +1 -1
  220. package/dist/client/agent-page/AutomationDetailsDialog.d.ts +21 -0
  221. package/dist/client/agent-page/AutomationDetailsDialog.d.ts.map +1 -0
  222. package/dist/client/agent-page/AutomationDetailsDialog.js +33 -0
  223. package/dist/client/agent-page/AutomationDetailsDialog.js.map +1 -0
  224. package/dist/client/agent-page/AutomationScheduleDialog.d.ts +15 -0
  225. package/dist/client/agent-page/AutomationScheduleDialog.d.ts.map +1 -0
  226. package/dist/client/agent-page/AutomationScheduleDialog.js +46 -0
  227. package/dist/client/agent-page/AutomationScheduleDialog.js.map +1 -0
  228. package/dist/client/agent-page/TimezoneSelect.d.ts +17 -0
  229. package/dist/client/agent-page/TimezoneSelect.d.ts.map +1 -0
  230. package/dist/client/agent-page/TimezoneSelect.js +107 -0
  231. package/dist/client/agent-page/TimezoneSelect.js.map +1 -0
  232. package/dist/client/agent-page/use-jobs.d.ts +20 -7
  233. package/dist/client/agent-page/use-jobs.d.ts.map +1 -1
  234. package/dist/client/agent-page/use-jobs.js +24 -4
  235. package/dist/client/agent-page/use-jobs.js.map +1 -1
  236. package/dist/client/org/OrgSwitcher.d.ts +8 -1
  237. package/dist/client/org/OrgSwitcher.d.ts.map +1 -1
  238. package/dist/client/org/OrgSwitcher.js +8 -2
  239. package/dist/client/org/OrgSwitcher.js.map +1 -1
  240. package/dist/client/settings/AccountSettingsCard.d.ts.map +1 -1
  241. package/dist/client/settings/AccountSettingsCard.js +10 -9
  242. package/dist/client/settings/AccountSettingsCard.js.map +1 -1
  243. package/dist/client/settings/SchedulingTimezoneField.d.ts +10 -0
  244. package/dist/client/settings/SchedulingTimezoneField.d.ts.map +1 -0
  245. package/dist/client/settings/SchedulingTimezoneField.js +30 -0
  246. package/dist/client/settings/SchedulingTimezoneField.js.map +1 -0
  247. package/dist/client/settings/SettingsRow.d.ts +36 -0
  248. package/dist/client/settings/SettingsRow.d.ts.map +1 -0
  249. package/dist/client/settings/SettingsRow.js +15 -0
  250. package/dist/client/settings/SettingsRow.js.map +1 -0
  251. package/dist/client/settings/agent-settings-search.d.ts.map +1 -1
  252. package/dist/client/settings/agent-settings-search.js +1 -1
  253. package/dist/client/settings/agent-settings-search.js.map +1 -1
  254. package/dist/client/settings/index.d.ts +1 -0
  255. package/dist/client/settings/index.d.ts.map +1 -1
  256. package/dist/client/settings/index.js +1 -0
  257. package/dist/client/settings/index.js.map +1 -1
  258. package/dist/file-upload/actions/upload-image.d.ts +1 -1
  259. package/dist/integrations/identity.d.ts.map +1 -1
  260. package/dist/integrations/identity.js +2 -11
  261. package/dist/integrations/identity.js.map +1 -1
  262. package/dist/jobs/actions/list-automation-runs.d.ts +8 -0
  263. package/dist/jobs/actions/list-automation-runs.d.ts.map +1 -0
  264. package/dist/jobs/actions/list-automation-runs.js +29 -0
  265. package/dist/jobs/actions/list-automation-runs.js.map +1 -0
  266. package/dist/jobs/actions/list-recurring-jobs.d.ts +2 -0
  267. package/dist/jobs/actions/list-recurring-jobs.d.ts.map +1 -1
  268. package/dist/jobs/actions/list-recurring-jobs.js +20 -7
  269. package/dist/jobs/actions/list-recurring-jobs.js.map +1 -1
  270. package/dist/jobs/actions/manage-recurring-job.d.ts +2 -0
  271. package/dist/jobs/actions/manage-recurring-job.js +30 -9
  272. package/dist/jobs/actions/manage-recurring-job.js.map +1 -1
  273. package/dist/jobs/background-automation-runner.d.ts.map +1 -1
  274. package/dist/jobs/background-automation-runner.js +60 -0
  275. package/dist/jobs/background-automation-runner.js.map +1 -1
  276. package/dist/jobs/cron.d.ts +16 -2
  277. package/dist/jobs/cron.d.ts.map +1 -1
  278. package/dist/jobs/cron.js +43 -6
  279. package/dist/jobs/cron.js.map +1 -1
  280. package/dist/jobs/frontmatter.d.ts +12 -0
  281. package/dist/jobs/frontmatter.d.ts.map +1 -1
  282. package/dist/jobs/frontmatter.js +8 -0
  283. package/dist/jobs/frontmatter.js.map +1 -1
  284. package/dist/jobs/run-history.d.ts +56 -0
  285. package/dist/jobs/run-history.d.ts.map +1 -0
  286. package/dist/jobs/run-history.js +169 -0
  287. package/dist/jobs/run-history.js.map +1 -0
  288. package/dist/jobs/scheduler.d.ts.map +1 -1
  289. package/dist/jobs/scheduler.js +51 -18
  290. package/dist/jobs/scheduler.js.map +1 -1
  291. package/dist/jobs/tools.d.ts.map +1 -1
  292. package/dist/jobs/tools.js +37 -6
  293. package/dist/jobs/tools.js.map +1 -1
  294. package/dist/localization/actions/get-localization-preference.d.ts +1 -2
  295. package/dist/localization/actions/get-localization-preference.d.ts.map +1 -1
  296. package/dist/localization/actions/get-localization-preference.js.map +1 -1
  297. package/dist/localization/actions/set-localization-preference.d.ts +3 -3
  298. package/dist/localization/actions/set-localization-preference.d.ts.map +1 -1
  299. package/dist/localization/actions/set-localization-preference.js +33 -8
  300. package/dist/localization/actions/set-localization-preference.js.map +1 -1
  301. package/dist/localization/default-messages.d.ts +25 -0
  302. package/dist/localization/default-messages.d.ts.map +1 -1
  303. package/dist/localization/default-messages.js +25 -0
  304. package/dist/localization/default-messages.js.map +1 -1
  305. package/dist/localization/shared.d.ts +16 -1
  306. package/dist/localization/shared.d.ts.map +1 -1
  307. package/dist/localization/shared.js +22 -4
  308. package/dist/localization/shared.js.map +1 -1
  309. package/dist/localization/user-timezone.d.ts +11 -0
  310. package/dist/localization/user-timezone.d.ts.map +1 -0
  311. package/dist/localization/user-timezone.js +31 -0
  312. package/dist/localization/user-timezone.js.map +1 -0
  313. package/dist/notifications/routes.d.ts +4 -4
  314. package/dist/observability/routes.d.ts +3 -3
  315. package/dist/org/app-roles-handlers.d.ts.map +1 -1
  316. package/dist/org/app-roles-handlers.js +1 -8
  317. package/dist/org/app-roles-handlers.js.map +1 -1
  318. package/dist/org/index.d.ts +1 -0
  319. package/dist/org/index.d.ts.map +1 -1
  320. package/dist/org/index.js +1 -0
  321. package/dist/org/index.js.map +1 -1
  322. package/dist/org/membership.d.ts +6 -0
  323. package/dist/org/membership.d.ts.map +1 -0
  324. package/dist/org/membership.js +16 -0
  325. package/dist/org/membership.js.map +1 -0
  326. package/dist/progress/routes.d.ts +1 -1
  327. package/dist/provider-api/actions/custom-provider-registration.d.ts +13 -13
  328. package/dist/provider-api/actions/provider-api.d.ts +8 -8
  329. package/dist/provider-api/corpus-jobs.d.ts +2 -2
  330. package/dist/review/actions/create-review-comment.d.ts +32 -1
  331. package/dist/review/actions/create-review-comment.d.ts.map +1 -1
  332. package/dist/review/actions/create-review-comment.js +3 -1
  333. package/dist/review/actions/create-review-comment.js.map +1 -1
  334. package/dist/review/actions/reply-review-comment.d.ts +32 -1
  335. package/dist/review/actions/reply-review-comment.d.ts.map +1 -1
  336. package/dist/review/actions/reply-review-comment.js +3 -1
  337. package/dist/review/actions/reply-review-comment.js.map +1 -1
  338. package/dist/review/index.d.ts +1 -0
  339. package/dist/review/index.d.ts.map +1 -1
  340. package/dist/review/index.js +1 -0
  341. package/dist/review/index.js.map +1 -1
  342. package/dist/review/notifications.d.ts +24 -0
  343. package/dist/review/notifications.d.ts.map +1 -0
  344. package/dist/review/notifications.js +123 -0
  345. package/dist/review/notifications.js.map +1 -0
  346. package/dist/review/types.d.ts +5 -0
  347. package/dist/review/types.d.ts.map +1 -1
  348. package/dist/review/types.js.map +1 -1
  349. package/dist/server/action-discovery.d.ts.map +1 -1
  350. package/dist/server/action-discovery.js +4 -0
  351. package/dist/server/action-discovery.js.map +1 -1
  352. package/dist/server/activity-notifications.d.ts +61 -0
  353. package/dist/server/activity-notifications.d.ts.map +1 -0
  354. package/dist/server/activity-notifications.js +103 -0
  355. package/dist/server/activity-notifications.js.map +1 -0
  356. package/dist/server/agent-engine-api-key-route.d.ts +1 -1
  357. package/dist/server/app-name.d.ts +18 -0
  358. package/dist/server/app-name.d.ts.map +1 -1
  359. package/dist/server/app-name.js +31 -0
  360. package/dist/server/app-name.js.map +1 -1
  361. package/dist/server/better-auth-instance.js +4 -4
  362. package/dist/server/better-auth-instance.js.map +1 -1
  363. package/dist/server/email-templates.d.ts +12 -0
  364. package/dist/server/email-templates.d.ts.map +1 -1
  365. package/dist/server/email-templates.js +57 -14
  366. package/dist/server/email-templates.js.map +1 -1
  367. package/dist/server/email.d.ts +12 -0
  368. package/dist/server/email.d.ts.map +1 -1
  369. package/dist/server/email.js +52 -5
  370. package/dist/server/email.js.map +1 -1
  371. package/dist/server/index.d.ts +1 -0
  372. package/dist/server/index.d.ts.map +1 -1
  373. package/dist/server/index.js +1 -0
  374. package/dist/server/index.js.map +1 -1
  375. package/dist/server/transcribe-voice.d.ts +1 -1
  376. package/dist/sharing/access.d.ts.map +1 -1
  377. package/dist/sharing/access.js +32 -2
  378. package/dist/sharing/access.js.map +1 -1
  379. package/dist/sharing/index.d.ts +1 -0
  380. package/dist/sharing/index.d.ts.map +1 -1
  381. package/dist/sharing/index.js +1 -0
  382. package/dist/sharing/index.js.map +1 -1
  383. package/dist/sharing/recipients.d.ts +31 -0
  384. package/dist/sharing/recipients.d.ts.map +1 -0
  385. package/dist/sharing/recipients.js +40 -0
  386. package/dist/sharing/recipients.js.map +1 -0
  387. package/dist/templates/chat/app/routes/settings.tsx +14 -22
  388. package/dist/templates/chat/vitest.config.ts +9 -0
  389. package/dist/triggers/actions/list-automations.d.ts +2 -0
  390. package/dist/triggers/actions/list-automations.d.ts.map +1 -1
  391. package/dist/triggers/actions/list-automations.js +19 -8
  392. package/dist/triggers/actions/list-automations.js.map +1 -1
  393. package/dist/triggers/actions/manage-automation.d.ts +6 -0
  394. package/dist/triggers/actions/manage-automation.js +12 -6
  395. package/dist/triggers/actions/manage-automation.js.map +1 -1
  396. package/dist/triggers/actions.d.ts.map +1 -1
  397. package/dist/triggers/actions.js +15 -4
  398. package/dist/triggers/actions.js.map +1 -1
  399. package/dist/triggers/dispatcher.d.ts.map +1 -1
  400. package/dist/triggers/dispatcher.js +19 -17
  401. package/dist/triggers/dispatcher.js.map +1 -1
  402. package/dist/triggers/routes.d.ts.map +1 -1
  403. package/dist/triggers/routes.js +6 -6
  404. package/dist/triggers/routes.js.map +1 -1
  405. package/dist/vitest-config.d.ts +10 -0
  406. package/dist/vitest-config.d.ts.map +1 -0
  407. package/dist/vitest-config.js +55 -0
  408. package/dist/vitest-config.js.map +1 -0
  409. package/package.json +5 -4
  410. package/src/automations/service.ts +41 -4
  411. package/src/cli/mcp-config-writers.ts +27 -21
  412. package/src/client/agent-page/AgentJobsTab.tsx +187 -85
  413. package/src/client/agent-page/AutomationDetailsDialog.tsx +208 -0
  414. package/src/client/agent-page/AutomationScheduleDialog.tsx +180 -0
  415. package/src/client/agent-page/TimezoneSelect.tsx +241 -0
  416. package/src/client/agent-page/use-jobs.ts +50 -10
  417. package/src/client/org/OrgSwitcher.tsx +26 -0
  418. package/src/client/settings/AccountSettingsCard.tsx +35 -31
  419. package/src/client/settings/SchedulingTimezoneField.tsx +71 -0
  420. package/src/client/settings/SettingsRow.tsx +113 -0
  421. package/src/client/settings/agent-settings-search.ts +2 -1
  422. package/src/client/settings/index.ts +6 -0
  423. package/src/integrations/identity.ts +2 -12
  424. package/src/jobs/actions/list-automation-runs.ts +33 -0
  425. package/src/jobs/actions/list-recurring-jobs.ts +27 -6
  426. package/src/jobs/actions/manage-recurring-job.ts +41 -9
  427. package/src/jobs/background-automation-runner.ts +88 -0
  428. package/src/jobs/cron.ts +52 -6
  429. package/src/jobs/frontmatter.ts +20 -0
  430. package/src/jobs/run-history.ts +242 -0
  431. package/src/jobs/scheduler.ts +73 -18
  432. package/src/jobs/tools.ts +54 -6
  433. package/src/localization/actions/get-localization-preference.ts +2 -2
  434. package/src/localization/actions/set-localization-preference.ts +49 -11
  435. package/src/localization/default-messages.ts +27 -0
  436. package/src/localization/shared.ts +39 -6
  437. package/src/localization/user-timezone.ts +36 -0
  438. package/src/org/app-roles-handlers.ts +1 -9
  439. package/src/org/index.ts +2 -0
  440. package/src/org/membership.ts +18 -0
  441. package/src/review/actions/create-review-comment.ts +4 -1
  442. package/src/review/actions/reply-review-comment.ts +4 -1
  443. package/src/review/index.ts +5 -0
  444. package/src/review/notifications.ts +163 -0
  445. package/src/review/types.ts +7 -0
  446. package/src/server/action-discovery.ts +4 -0
  447. package/src/server/activity-notifications.ts +174 -0
  448. package/src/server/app-name.ts +31 -0
  449. package/src/server/better-auth-instance.ts +4 -4
  450. package/src/server/email-templates.ts +70 -14
  451. package/src/server/email.ts +66 -3
  452. package/src/server/index.ts +10 -0
  453. package/src/sharing/access.ts +44 -2
  454. package/src/sharing/index.ts +5 -0
  455. package/src/sharing/recipients.ts +67 -0
  456. package/src/templates/chat/app/routes/settings.tsx +14 -22
  457. package/src/templates/chat/vitest.config.ts +9 -0
  458. package/src/triggers/actions/list-automations.ts +27 -8
  459. package/src/triggers/actions/manage-automation.ts +17 -6
  460. package/src/triggers/actions.ts +16 -4
  461. package/src/triggers/dispatcher.ts +44 -30
  462. package/src/triggers/routes.ts +19 -6
  463. package/src/vitest-config.ts +68 -0
@@ -0,0 +1,208 @@
1
+ import { IconAlertTriangle, IconLoader2 } from "@tabler/icons-react";
2
+
3
+ import {
4
+ Dialog,
5
+ DialogContent,
6
+ DialogDescription,
7
+ DialogHeader,
8
+ DialogTitle,
9
+ } from "../components/ui/dialog.js";
10
+ import { useT } from "../i18n.js";
11
+ import { useAutomationRuns, type JobsScope } from "./use-jobs.js";
12
+
13
+ export interface AutomationDetailsField {
14
+ label: string;
15
+ value: string;
16
+ mono?: boolean;
17
+ }
18
+
19
+ export interface AutomationDetailsDialogProps {
20
+ open: boolean;
21
+ name: string;
22
+ triggerSummary: string;
23
+ fields: AutomationDetailsField[];
24
+ condition: string | null;
25
+ instructions: string;
26
+ mcpTools: string[];
27
+ lastError: string | null;
28
+ scope: JobsScope;
29
+ formatTimestamp: (value: number) => string;
30
+ onClose: () => void;
31
+ }
32
+
33
+ function RunStatusDot({ status }: { status: string }) {
34
+ const tone =
35
+ status === "success"
36
+ ? "bg-emerald-500"
37
+ : status === "error"
38
+ ? "bg-destructive"
39
+ : // An interrupted run never reported an outcome, so it reads as
40
+ // unknown rather than as still making progress.
41
+ status === "interrupted"
42
+ ? "bg-muted-foreground"
43
+ : "bg-amber-500";
44
+ return <span className={`size-1.5 shrink-0 rounded-full ${tone}`} />;
45
+ }
46
+
47
+ export function AutomationDetailsDialog({
48
+ open,
49
+ name,
50
+ triggerSummary,
51
+ fields,
52
+ condition,
53
+ instructions,
54
+ mcpTools,
55
+ lastError,
56
+ scope,
57
+ formatTimestamp,
58
+ onClose,
59
+ }: AutomationDetailsDialogProps) {
60
+ const t = useT();
61
+ const runsQuery = useAutomationRuns(scope, open ? name : null, open);
62
+ const runs = runsQuery.data ?? [];
63
+
64
+ return (
65
+ <Dialog
66
+ open={open}
67
+ onOpenChange={(next) => {
68
+ if (!next) onClose();
69
+ }}
70
+ >
71
+ <DialogContent className="max-h-[85vh] max-w-2xl overflow-y-auto">
72
+ <DialogHeader>
73
+ <DialogTitle>{name.replace(/-/g, " ")}</DialogTitle>
74
+ <DialogDescription>{triggerSummary}</DialogDescription>
75
+ </DialogHeader>
76
+
77
+ <div className="space-y-4">
78
+ {lastError ? (
79
+ <div className="flex items-start gap-2 rounded-md border border-destructive/30 bg-destructive/5 p-2.5">
80
+ <IconAlertTriangle className="mt-0.5 size-4 shrink-0 text-destructive" />
81
+ <div className="min-w-0">
82
+ <p className="text-xs font-medium text-destructive">
83
+ {t("jobs.blockedTitle", {
84
+ defaultValue: "This automation is not running",
85
+ })}
86
+ </p>
87
+ <p className="mt-0.5 break-words text-xs text-muted-foreground">
88
+ {lastError}
89
+ </p>
90
+ </div>
91
+ </div>
92
+ ) : null}
93
+
94
+ <dl className="grid grid-cols-2 gap-x-4 gap-y-2">
95
+ {fields.map((field) => (
96
+ <div key={field.label} className="min-w-0">
97
+ <dt className="text-[11px] uppercase tracking-wide text-muted-foreground/70">
98
+ {field.label}
99
+ </dt>
100
+ <dd
101
+ className={`mt-0.5 break-words text-sm ${
102
+ field.mono ? "font-mono text-xs" : ""
103
+ }`}
104
+ >
105
+ {field.value}
106
+ </dd>
107
+ </div>
108
+ ))}
109
+ </dl>
110
+
111
+ {condition ? (
112
+ <div>
113
+ <p className="text-xs font-medium text-foreground">
114
+ {t("jobs.condition", { defaultValue: "Condition" })}
115
+ </p>
116
+ <p className="mt-1 text-sm text-muted-foreground">{condition}</p>
117
+ </div>
118
+ ) : null}
119
+
120
+ <div>
121
+ <p className="text-xs font-medium text-foreground">
122
+ {t("jobs.instructions", { defaultValue: "Instructions" })}
123
+ </p>
124
+ <p className="mt-1 max-h-56 overflow-y-auto whitespace-pre-wrap rounded-md bg-muted/50 p-2.5 text-sm text-muted-foreground">
125
+ {instructions}
126
+ </p>
127
+ </div>
128
+
129
+ {mcpTools.length > 0 ? (
130
+ <div>
131
+ <p className="text-xs font-medium text-foreground">
132
+ {t("jobs.mcpTools", { defaultValue: "Connected MCP tools" })}
133
+ </p>
134
+ <div className="mt-1 flex flex-wrap gap-1.5">
135
+ {mcpTools.map((toolName) => (
136
+ <code
137
+ key={toolName}
138
+ className="rounded bg-muted px-1.5 py-0.5 text-[11px] text-muted-foreground"
139
+ >
140
+ {toolName}
141
+ </code>
142
+ ))}
143
+ </div>
144
+ </div>
145
+ ) : null}
146
+
147
+ <div>
148
+ <p className="text-xs font-medium text-foreground">
149
+ {t("jobs.pastRuns", { defaultValue: "Past runs" })}
150
+ </p>
151
+ {runsQuery.isLoading ? (
152
+ <div
153
+ className="mt-2 flex items-center gap-2 text-xs text-muted-foreground"
154
+ aria-busy="true"
155
+ >
156
+ <IconLoader2 className="size-3.5 animate-spin" />
157
+ {t("jobs.loading", { defaultValue: "Loading…" })}
158
+ </div>
159
+ ) : runsQuery.error ? (
160
+ <p className="mt-1 text-xs text-destructive">
161
+ {t("jobs.runsLoadError", {
162
+ defaultValue: "Could not load run history.",
163
+ })}
164
+ </p>
165
+ ) : runs.length === 0 ? (
166
+ <p className="mt-1 text-xs text-muted-foreground">
167
+ {t("jobs.noRuns", {
168
+ defaultValue:
169
+ "This automation has not executed yet. Only real executions are recorded here.",
170
+ })}
171
+ </p>
172
+ ) : (
173
+ <ul className="mt-2 divide-y divide-border/60 border-y border-border/60">
174
+ {runs.map((run) => (
175
+ <li
176
+ key={run.id}
177
+ className="flex items-center gap-2 py-1.5 text-xs"
178
+ >
179
+ <RunStatusDot status={run.status} />
180
+ <span className="shrink-0 text-muted-foreground">
181
+ {formatTimestamp(run.startedAt)}
182
+ </span>
183
+ <span className="shrink-0 font-medium">{run.status}</span>
184
+ {run.error ? (
185
+ <span
186
+ className="min-w-0 flex-1 truncate text-muted-foreground"
187
+ title={run.error}
188
+ >
189
+ {run.error}
190
+ </span>
191
+ ) : (
192
+ <span className="min-w-0 flex-1" />
193
+ )}
194
+ {run.finishedAt ? (
195
+ <span className="shrink-0 tabular-nums text-muted-foreground">
196
+ {Math.round((run.finishedAt - run.startedAt) / 1000)}s
197
+ </span>
198
+ ) : null}
199
+ </li>
200
+ ))}
201
+ </ul>
202
+ )}
203
+ </div>
204
+ </div>
205
+ </DialogContent>
206
+ </Dialog>
207
+ );
208
+ }
@@ -0,0 +1,180 @@
1
+ import { Button } from "@agent-native/toolkit/ui/button";
2
+ import { Input } from "@agent-native/toolkit/ui/input";
3
+ import { IconLoader2 } from "@tabler/icons-react";
4
+ import { useEffect, useState } from "react";
5
+
6
+ import {
7
+ Dialog,
8
+ DialogContent,
9
+ DialogDescription,
10
+ DialogFooter,
11
+ DialogHeader,
12
+ DialogTitle,
13
+ } from "../components/ui/dialog.js";
14
+ import { useT } from "../i18n.js";
15
+ import { TimezoneSelect, browserTimezone } from "./TimezoneSelect.js";
16
+
17
+ const PRESETS: { label: string; cron: string }[] = [
18
+ { label: "Every hour", cron: "0 * * * *" },
19
+ { label: "Every day at 8:00", cron: "0 8 * * *" },
20
+ { label: "Every weekday at 9:00", cron: "0 9 * * 1-5" },
21
+ { label: "Every Monday at 8:00", cron: "0 8 * * 1" },
22
+ ];
23
+
24
+ const CRON_FIELD_COUNT = 5;
25
+
26
+ function looksLikeCron(value: string): boolean {
27
+ return value.trim().split(/\s+/).length === CRON_FIELD_COUNT;
28
+ }
29
+
30
+ export interface AutomationScheduleDialogProps {
31
+ open: boolean;
32
+ name: string;
33
+ schedule: string;
34
+ timezone: string | null;
35
+ saving: boolean;
36
+ error?: string | null;
37
+ onCancel: () => void;
38
+ onSave: (next: { schedule: string; timezone: string }) => void;
39
+ }
40
+
41
+ export function AutomationScheduleDialog({
42
+ open,
43
+ name,
44
+ schedule,
45
+ timezone,
46
+ saving,
47
+ error,
48
+ onCancel,
49
+ onSave,
50
+ }: AutomationScheduleDialogProps) {
51
+ const t = useT();
52
+ const [value, setValue] = useState(schedule);
53
+ const [zone, setZone] = useState(timezone || browserTimezone());
54
+
55
+ useEffect(() => {
56
+ if (!open) return;
57
+ setValue(schedule);
58
+ setZone(timezone || browserTimezone());
59
+ }, [open, schedule, timezone]);
60
+
61
+ const trimmed = value.trim();
62
+ const valid = looksLikeCron(trimmed);
63
+ const changed =
64
+ trimmed !== schedule.trim() || zone !== (timezone || browserTimezone());
65
+
66
+ return (
67
+ <Dialog
68
+ open={open}
69
+ onOpenChange={(next) => {
70
+ if (!next && !saving) onCancel();
71
+ }}
72
+ >
73
+ <DialogContent>
74
+ <DialogHeader>
75
+ <DialogTitle>
76
+ {t("jobs.editScheduleTitle", {
77
+ defaultValue: "Edit schedule — {{name}}",
78
+ name: name.replace(/-/g, " "),
79
+ })}
80
+ </DialogTitle>
81
+ <DialogDescription>
82
+ {t("jobs.editScheduleDescription", {
83
+ defaultValue:
84
+ "The clock time below is read in the timezone you pick, so 8:00 means 8:00 there.",
85
+ })}
86
+ </DialogDescription>
87
+ </DialogHeader>
88
+
89
+ <div className="space-y-3">
90
+ <div>
91
+ <label
92
+ className="text-xs font-medium text-foreground"
93
+ htmlFor="automation-schedule"
94
+ >
95
+ {t("jobs.cronExpression", { defaultValue: "Cron expression" })}
96
+ </label>
97
+ <Input
98
+ id="automation-schedule"
99
+ className="mt-1 font-mono text-sm"
100
+ value={value}
101
+ spellCheck={false}
102
+ autoComplete="off"
103
+ disabled={saving}
104
+ onChange={(event) => setValue(event.target.value)}
105
+ />
106
+ <p className="mt-1 text-[11px] text-muted-foreground">
107
+ {t("jobs.cronFormatHint", {
108
+ defaultValue: "minute hour day-of-month month day-of-week",
109
+ })}
110
+ </p>
111
+ </div>
112
+
113
+ <div className="flex flex-wrap gap-1.5">
114
+ {PRESETS.map((preset) => (
115
+ <Button
116
+ key={preset.cron}
117
+ type="button"
118
+ variant="outline"
119
+ size="sm"
120
+ className="h-7 cursor-pointer text-[11px]"
121
+ disabled={saving}
122
+ onClick={() => setValue(preset.cron)}
123
+ >
124
+ {preset.label}
125
+ </Button>
126
+ ))}
127
+ </div>
128
+
129
+ <div>
130
+ <label
131
+ className="text-xs font-medium text-foreground"
132
+ htmlFor="automation-timezone"
133
+ >
134
+ {t("jobs.timezone", { defaultValue: "Timezone" })}
135
+ </label>
136
+ <div className="mt-1">
137
+ <TimezoneSelect
138
+ id="automation-timezone"
139
+ value={zone}
140
+ disabled={saving}
141
+ onChange={setZone}
142
+ suggested={[browserTimezone()]}
143
+ />
144
+ </div>
145
+ </div>
146
+
147
+ {trimmed && !valid ? (
148
+ <p className="text-xs text-destructive">
149
+ {t("jobs.cronFieldCount", {
150
+ defaultValue: "A cron expression needs exactly 5 fields.",
151
+ })}
152
+ </p>
153
+ ) : null}
154
+ {error ? <p className="text-xs text-destructive">{error}</p> : null}
155
+ </div>
156
+
157
+ <DialogFooter>
158
+ <Button
159
+ type="button"
160
+ variant="outline"
161
+ className="cursor-pointer"
162
+ disabled={saving}
163
+ onClick={onCancel}
164
+ >
165
+ {t("jobs.cancel", { defaultValue: "Cancel" })}
166
+ </Button>
167
+ <Button
168
+ type="button"
169
+ className="cursor-pointer"
170
+ disabled={saving || !valid || !changed}
171
+ onClick={() => onSave({ schedule: trimmed, timezone: zone })}
172
+ >
173
+ {saving ? <IconLoader2 className="size-4 animate-spin" /> : null}
174
+ {t("jobs.saveSchedule", { defaultValue: "Save schedule" })}
175
+ </Button>
176
+ </DialogFooter>
177
+ </DialogContent>
178
+ </Dialog>
179
+ );
180
+ }
@@ -0,0 +1,241 @@
1
+ import {
2
+ Command,
3
+ CommandEmpty,
4
+ CommandGroup,
5
+ CommandInput,
6
+ CommandItem,
7
+ CommandList,
8
+ CommandSeparator,
9
+ } from "@agent-native/toolkit/ui/command";
10
+ import {
11
+ Popover,
12
+ PopoverContent,
13
+ PopoverTrigger,
14
+ } from "@agent-native/toolkit/ui/popover";
15
+ import { IconCheck, IconChevronDown } from "@tabler/icons-react";
16
+ import { useMemo, useState } from "react";
17
+
18
+ const SYSTEM_VALUE = "system";
19
+
20
+ /** The browser's IANA zone, or UTC when the runtime cannot report one. */
21
+ export function browserTimezone(): string {
22
+ try {
23
+ return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
24
+ } catch {
25
+ return "UTC";
26
+ }
27
+ }
28
+
29
+ function supportedTimezones(): string[] {
30
+ const supported = (
31
+ Intl as unknown as { supportedValuesOf?: (key: string) => string[] }
32
+ ).supportedValuesOf;
33
+ const zones = supported ? supported("timeZone") : [];
34
+ // Older runtimes omit supportedValuesOf; the browser zone plus UTC still
35
+ // covers the common case rather than leaving an empty, unusable menu.
36
+ const base = zones.length ? zones : [browserTimezone()];
37
+ return [...new Set(["UTC", ...base])];
38
+ }
39
+
40
+ interface ZoneOption {
41
+ zone: string;
42
+ /** Minutes east of GMT, used to order the list the way a map reads. */
43
+ offsetMinutes: number;
44
+ offsetLabel: string;
45
+ timeLabel: string;
46
+ placeLabel: string;
47
+ }
48
+
49
+ function describeZone(zone: string, now: Date): ZoneOption | null {
50
+ let parts: Intl.DateTimeFormatPart[];
51
+ try {
52
+ parts = new Intl.DateTimeFormat("en-US", {
53
+ timeZone: zone,
54
+ hour: "numeric",
55
+ minute: "2-digit",
56
+ hour12: true,
57
+ timeZoneName: "longOffset",
58
+ }).formatToParts(now);
59
+ } catch {
60
+ // A zone this runtime cannot resolve would otherwise throw during render.
61
+ return null;
62
+ }
63
+
64
+ const part = (type: Intl.DateTimeFormatPartTypes) =>
65
+ parts.find((p) => p.type === type)?.value ?? "";
66
+
67
+ // `longOffset` collapses to a bare "GMT" at zero rather than "GMT+00:00".
68
+ const raw = part("timeZoneName");
69
+ const offsetLabel = raw === "GMT" ? "GMT+00:00" : raw;
70
+ const match = /^GMT([+-])(\d{2}):(\d{2})$/.exec(offsetLabel);
71
+ const offsetMinutes = match
72
+ ? (match[1] === "-" ? -1 : 1) * (Number(match[2]) * 60 + Number(match[3]))
73
+ : 0;
74
+
75
+ return {
76
+ zone,
77
+ offsetMinutes,
78
+ offsetLabel,
79
+ timeLabel: `${part("hour")}:${part("minute")}${part("dayPeriod").toLowerCase()}`,
80
+ placeLabel: zone.replace(/_/g, " "),
81
+ };
82
+ }
83
+
84
+ function zoneOptions(extra: string[], now: Date): ZoneOption[] {
85
+ const zones = [...new Set([...extra, ...supportedTimezones()])];
86
+ return zones
87
+ .map((zone) => describeZone(zone, now))
88
+ .filter((option): option is ZoneOption => option !== null)
89
+ .sort(
90
+ (a, b) =>
91
+ a.offsetMinutes - b.offsetMinutes ||
92
+ a.placeLabel.localeCompare(b.placeLabel),
93
+ );
94
+ }
95
+
96
+ export interface TimezoneSelectProps {
97
+ value: string;
98
+ disabled?: boolean;
99
+ onChange: (timezone: string) => void;
100
+ /** Zones to surface above the full list, e.g. the currently stored one. */
101
+ suggested?: string[];
102
+ /**
103
+ * Label for a leading `system` choice. Settings offer it so the preference
104
+ * stays revertible; a schedule must name a concrete zone and omits it.
105
+ */
106
+ systemLabel?: string;
107
+ id?: string;
108
+ }
109
+
110
+ export function TimezoneSelect({
111
+ value,
112
+ disabled,
113
+ onChange,
114
+ suggested = [],
115
+ systemLabel,
116
+ id,
117
+ }: TimezoneSelectProps) {
118
+ const [open, setOpen] = useState(false);
119
+ const detected = browserTimezone();
120
+
121
+ // 418 zones each need their own formatter, so only pay for that once the
122
+ // list is actually on screen. Reopening re-reads the clock.
123
+ const options = useMemo(() => {
124
+ if (!open) return [];
125
+ const pinned = [...suggested, value].filter(
126
+ (zone) => zone && zone !== SYSTEM_VALUE,
127
+ );
128
+ return zoneOptions(pinned, new Date());
129
+ }, [open, suggested, value]);
130
+
131
+ const selected = useMemo(
132
+ () => (value === SYSTEM_VALUE ? null : describeZone(value, new Date())),
133
+ [value],
134
+ );
135
+
136
+ const triggerLabel =
137
+ value === SYSTEM_VALUE
138
+ ? (systemLabel ?? SYSTEM_VALUE)
139
+ : selected
140
+ ? `(${selected.offsetLabel}) ${selected.placeLabel}`
141
+ : value;
142
+
143
+ function choose(zone: string) {
144
+ setOpen(false);
145
+ if (zone !== value) onChange(zone);
146
+ }
147
+
148
+ function renderZone(option: ZoneOption, key: string) {
149
+ return (
150
+ <CommandItem
151
+ key={key}
152
+ // Searched text: place and offset both need to match what users type.
153
+ // The key is folded in because the detected zone is listed twice, and
154
+ // cmdk treats two items with the same value as the same item.
155
+ value={`${option.placeLabel} ${option.offsetLabel} ${option.zone} ${key}`}
156
+ onSelect={() => choose(option.zone)}
157
+ className="gap-2"
158
+ >
159
+ <IconCheck
160
+ className={`size-4 shrink-0 ${
161
+ option.zone === value ? "opacity-100" : "opacity-0"
162
+ }`}
163
+ />
164
+ <span className="w-24 shrink-0 tabular-nums text-muted-foreground">
165
+ ({option.offsetLabel})
166
+ </span>
167
+ <span className="truncate">{option.placeLabel}</span>
168
+ <span className="ms-auto shrink-0 tabular-nums text-muted-foreground">
169
+ {option.timeLabel}
170
+ </span>
171
+ </CommandItem>
172
+ );
173
+ }
174
+
175
+ const detectedOption = options.find((option) => option.zone === detected);
176
+
177
+ return (
178
+ <Popover open={open} onOpenChange={setOpen}>
179
+ <PopoverTrigger asChild>
180
+ <button
181
+ id={id}
182
+ type="button"
183
+ role="combobox"
184
+ aria-expanded={open}
185
+ disabled={disabled}
186
+ // Matches the text inputs it sits beside, not a button.
187
+ className="flex h-10 w-full items-center justify-between gap-2 rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50"
188
+ >
189
+ <span className="truncate">{triggerLabel}</span>
190
+ <IconChevronDown className="size-4 shrink-0 opacity-50" />
191
+ </button>
192
+ </PopoverTrigger>
193
+ <PopoverContent
194
+ align="start"
195
+ className="w-[--radix-popover-trigger-width] p-0"
196
+ >
197
+ <Command
198
+ // cmdk's default scorer matches loose subsequences, so "Perth" would
199
+ // otherwise surface most of the list.
200
+ filter={(itemValue, search) =>
201
+ itemValue.toLowerCase().includes(search.toLowerCase().trim())
202
+ ? 1
203
+ : 0
204
+ }
205
+ >
206
+ <CommandInput placeholder="Search a city or region…" />
207
+ <CommandList className="max-h-72">
208
+ <CommandEmpty>No matching timezone.</CommandEmpty>
209
+ {systemLabel || detectedOption ? (
210
+ <>
211
+ <CommandGroup>
212
+ {systemLabel ? (
213
+ <CommandItem
214
+ value={`${systemLabel} follow browser automatic`}
215
+ onSelect={() => choose(SYSTEM_VALUE)}
216
+ className="gap-2"
217
+ >
218
+ <IconCheck
219
+ className={`size-4 shrink-0 ${
220
+ value === SYSTEM_VALUE ? "opacity-100" : "opacity-0"
221
+ }`}
222
+ />
223
+ <span className="truncate">{systemLabel}</span>
224
+ </CommandItem>
225
+ ) : null}
226
+ {detectedOption
227
+ ? renderZone(detectedOption, "detected")
228
+ : null}
229
+ </CommandGroup>
230
+ <CommandSeparator />
231
+ </>
232
+ ) : null}
233
+ <CommandGroup>
234
+ {options.map((option) => renderZone(option, option.zone))}
235
+ </CommandGroup>
236
+ </CommandList>
237
+ </Command>
238
+ </PopoverContent>
239
+ </Popover>
240
+ );
241
+ }