@opencorelabs/lucidity 0.3.0 → 0.7.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 (527) hide show
  1. package/README.md +18 -3
  2. package/dist/assets/speech/licenses/FluidAudio/LICENSE +201 -0
  3. package/dist/assets/speech/licenses/FluidAudio/ThirdPartyLicenses/fastcluster-LICENSE.md +11 -0
  4. package/dist/assets/speech/licenses/FluidAudio/ThirdPartyLicenses/vbx-LICENSE.md +201 -0
  5. package/dist/assets/speech/lucidity-speech +0 -0
  6. package/dist/automations/agent.d.ts +16 -0
  7. package/dist/automations/agent.d.ts.map +1 -0
  8. package/dist/automations/agent.js +196 -0
  9. package/dist/automations/cli.d.ts +4 -0
  10. package/dist/automations/cli.d.ts.map +1 -0
  11. package/dist/automations/cli.js +44 -0
  12. package/dist/automations/connections.d.ts +11 -0
  13. package/dist/automations/connections.d.ts.map +1 -0
  14. package/dist/automations/connections.js +74 -0
  15. package/dist/automations/designer.d.ts +39 -0
  16. package/dist/automations/designer.d.ts.map +1 -0
  17. package/dist/automations/designer.js +450 -0
  18. package/dist/automations/history.d.ts +4 -0
  19. package/dist/automations/history.d.ts.map +1 -0
  20. package/dist/automations/history.js +57 -0
  21. package/dist/automations/learning.d.ts +19 -0
  22. package/dist/automations/learning.d.ts.map +1 -0
  23. package/dist/automations/learning.js +121 -0
  24. package/dist/automations/pinterest.d.ts +21 -0
  25. package/dist/automations/pinterest.d.ts.map +1 -0
  26. package/dist/automations/pinterest.js +113 -0
  27. package/dist/automations/service.d.ts +42 -0
  28. package/dist/automations/service.d.ts.map +1 -0
  29. package/dist/automations/service.js +406 -0
  30. package/dist/automations/setup.d.ts +3 -0
  31. package/dist/automations/setup.d.ts.map +1 -0
  32. package/dist/automations/setup.js +48 -0
  33. package/dist/automations/skill.d.ts +3 -0
  34. package/dist/automations/skill.d.ts.map +1 -0
  35. package/dist/automations/skill.js +29 -0
  36. package/dist/automations/store.d.ts +13 -0
  37. package/dist/automations/store.d.ts.map +1 -0
  38. package/dist/automations/store.js +46 -0
  39. package/dist/chat/server.d.ts +2 -0
  40. package/dist/chat/server.d.ts.map +1 -1
  41. package/dist/chat/server.js +46 -2
  42. package/dist/coding/commandContext.d.ts +6 -0
  43. package/dist/coding/commandContext.d.ts.map +1 -0
  44. package/dist/coding/commandContext.js +20 -0
  45. package/dist/coding/runCodeTurn.d.ts +12 -2
  46. package/dist/coding/runCodeTurn.d.ts.map +1 -1
  47. package/dist/coding/runCodeTurn.js +49 -19
  48. package/dist/coding/worktree.d.ts +3 -4
  49. package/dist/coding/worktree.d.ts.map +1 -1
  50. package/dist/coding/worktree.js +3 -4
  51. package/dist/config.d.ts +4 -0
  52. package/dist/config.d.ts.map +1 -1
  53. package/dist/config.js +20 -3
  54. package/dist/decisions/cli.d.ts +2 -0
  55. package/dist/decisions/cli.d.ts.map +1 -0
  56. package/dist/decisions/cli.js +106 -0
  57. package/dist/decisions/client.d.ts +20 -0
  58. package/dist/decisions/client.d.ts.map +1 -0
  59. package/dist/decisions/client.js +41 -0
  60. package/dist/handoff.d.ts +11 -0
  61. package/dist/handoff.d.ts.map +1 -0
  62. package/dist/handoff.js +21 -0
  63. package/dist/index.js +185 -40
  64. package/dist/jobs/briefing.js +1 -1
  65. package/dist/jobs/extraction.d.ts.map +1 -1
  66. package/dist/jobs/extraction.js +112 -22
  67. package/dist/jobs/fastModeReview.d.ts +39 -0
  68. package/dist/jobs/fastModeReview.d.ts.map +1 -0
  69. package/dist/jobs/fastModeReview.js +192 -0
  70. package/dist/jobs/voiceReview.d.ts +24 -0
  71. package/dist/jobs/voiceReview.d.ts.map +1 -0
  72. package/dist/jobs/voiceReview.js +128 -0
  73. package/dist/mcp/clients.d.ts +5 -0
  74. package/dist/mcp/clients.d.ts.map +1 -1
  75. package/dist/mcp/clients.js +1 -1
  76. package/dist/mcp/config.d.ts +3 -1
  77. package/dist/mcp/config.d.ts.map +1 -1
  78. package/dist/mcp/config.js +48 -6
  79. package/dist/mcp/paired.js +1 -0
  80. package/dist/notesContext.d.ts.map +1 -1
  81. package/dist/notesContext.js +3 -2
  82. package/dist/room/client.d.ts +20 -7
  83. package/dist/room/client.d.ts.map +1 -1
  84. package/dist/room/client.js +266 -47
  85. package/dist/room/computer.d.ts.map +1 -1
  86. package/dist/room/computer.js +9 -0
  87. package/dist/room/context.d.ts +3 -2
  88. package/dist/room/context.d.ts.map +1 -1
  89. package/dist/room/context.js +10 -3
  90. package/dist/room/turnQueue.d.ts +40 -0
  91. package/dist/room/turnQueue.d.ts.map +1 -0
  92. package/dist/room/turnQueue.js +301 -0
  93. package/dist/skills/lucidity-automations/SKILL.md +54 -0
  94. package/dist/speech/captures.d.ts +30 -0
  95. package/dist/speech/captures.d.ts.map +1 -0
  96. package/dist/speech/captures.js +209 -0
  97. package/dist/speech/fluidAudio.d.ts +28 -0
  98. package/dist/speech/fluidAudio.d.ts.map +1 -0
  99. package/dist/speech/fluidAudio.js +182 -0
  100. package/dist/speech/service.d.ts +14 -0
  101. package/dist/speech/service.d.ts.map +1 -0
  102. package/dist/speech/service.js +88 -0
  103. package/dist/speech/types.d.ts +19 -0
  104. package/dist/speech/types.d.ts.map +1 -0
  105. package/dist/speech/types.js +1 -0
  106. package/dist/turnLog.d.ts +1 -0
  107. package/dist/turnLog.d.ts.map +1 -1
  108. package/dist/turnLog.js +3 -0
  109. package/native/speech/Package.resolved +15 -0
  110. package/native/speech/Package.swift +16 -0
  111. package/native/speech/Sources/lucidity-speech/Speech.swift +81 -0
  112. package/package.json +6 -2
  113. package/src/automations/agent.ts +239 -0
  114. package/src/automations/cli.ts +52 -0
  115. package/src/automations/connections.ts +83 -0
  116. package/src/automations/designer.ts +594 -0
  117. package/src/automations/history.ts +59 -0
  118. package/src/automations/learning.ts +180 -0
  119. package/src/automations/pinterest.ts +146 -0
  120. package/src/automations/service.ts +505 -0
  121. package/src/automations/setup.ts +71 -0
  122. package/src/automations/skill.ts +40 -0
  123. package/src/automations/store.ts +63 -0
  124. package/src/chat/server.ts +62 -3
  125. package/src/coding/commandContext.ts +29 -0
  126. package/src/coding/runCodeTurn.ts +65 -21
  127. package/src/coding/worktree.ts +3 -4
  128. package/src/config.ts +29 -2
  129. package/src/decisions/cli.ts +136 -0
  130. package/src/decisions/client.ts +62 -0
  131. package/src/handoff.ts +28 -0
  132. package/src/index.ts +202 -67
  133. package/src/jobs/briefing.ts +1 -1
  134. package/src/jobs/extraction.ts +157 -32
  135. package/src/jobs/fastModeReview.ts +221 -0
  136. package/src/jobs/voiceReview.ts +156 -0
  137. package/src/mcp/clients.ts +1 -1
  138. package/src/mcp/config.ts +56 -6
  139. package/src/mcp/paired.ts +1 -0
  140. package/src/notesContext.ts +3 -2
  141. package/src/room/client.ts +320 -54
  142. package/src/room/computer.ts +9 -0
  143. package/src/room/context.ts +12 -3
  144. package/src/room/turnQueue.ts +358 -0
  145. package/src/speech/captures.ts +265 -0
  146. package/src/speech/fluidAudio.ts +242 -0
  147. package/src/speech/service.ts +108 -0
  148. package/src/speech/types.ts +13 -0
  149. package/src/turnLog.ts +4 -0
  150. package/vendor/decisions/LICENSE +662 -0
  151. package/vendor/decisions/dist/capture.d.ts +79 -0
  152. package/vendor/decisions/dist/capture.js +183 -0
  153. package/vendor/decisions/dist/command.d.ts +202 -0
  154. package/vendor/decisions/dist/command.js +750 -0
  155. package/vendor/decisions/dist/dayPlan.d.ts +9 -0
  156. package/vendor/decisions/dist/dayPlan.js +82 -0
  157. package/vendor/decisions/dist/gate.d.ts +12 -0
  158. package/vendor/decisions/dist/gate.js +18 -0
  159. package/vendor/decisions/dist/index.d.ts +6 -0
  160. package/vendor/decisions/dist/index.js +6 -0
  161. package/vendor/decisions/dist/jev.d.ts +15 -0
  162. package/vendor/decisions/dist/jev.js +244 -0
  163. package/vendor/decisions/dist/types.d.ts +67 -0
  164. package/vendor/decisions/dist/types.js +1 -0
  165. package/vendor/decisions/package.json +22 -0
  166. package/vendor/decisions/src/capture.ts +199 -0
  167. package/vendor/decisions/src/command.ts +836 -0
  168. package/vendor/decisions/src/dayPlan.ts +80 -0
  169. package/vendor/decisions/src/gate.ts +32 -0
  170. package/vendor/decisions/src/index.ts +6 -0
  171. package/vendor/decisions/src/jev.ts +295 -0
  172. package/vendor/decisions/src/types.ts +79 -0
  173. package/vendor/mcp-server/README.md +6 -1
  174. package/vendor/mcp-server/dist/client.d.ts +1 -0
  175. package/vendor/mcp-server/dist/client.d.ts.map +1 -1
  176. package/vendor/mcp-server/dist/client.js +8 -0
  177. package/vendor/mcp-server/dist/commentProvider.d.ts +3 -0
  178. package/vendor/mcp-server/dist/commentProvider.d.ts.map +1 -0
  179. package/vendor/mcp-server/dist/commentProvider.js +10 -0
  180. package/vendor/mcp-server/dist/index.js +21 -6
  181. package/vendor/mcp-server/dist/tools/automations.d.ts +6 -0
  182. package/vendor/mcp-server/dist/tools/automations.d.ts.map +1 -0
  183. package/vendor/mcp-server/dist/tools/automations.js +163 -0
  184. package/vendor/mcp-server/dist/tools/commandEventFormat.d.ts +52 -0
  185. package/vendor/mcp-server/dist/tools/commandEventFormat.d.ts.map +1 -0
  186. package/vendor/mcp-server/dist/tools/commandEventFormat.js +83 -0
  187. package/vendor/mcp-server/dist/tools/commandEvents.d.ts +3 -0
  188. package/vendor/mcp-server/dist/tools/commandEvents.d.ts.map +1 -0
  189. package/vendor/mcp-server/dist/tools/commandEvents.js +21 -0
  190. package/vendor/mcp-server/dist/tools/comments.d.ts.map +1 -1
  191. package/vendor/mcp-server/dist/tools/comments.js +25 -4
  192. package/vendor/mcp-server/dist/tools/index.d.ts +2 -0
  193. package/vendor/mcp-server/dist/tools/index.d.ts.map +1 -1
  194. package/vendor/mcp-server/dist/tools/index.js +2 -0
  195. package/vendor/mcp-server/dist/tools/journal.d.ts +3 -0
  196. package/vendor/mcp-server/dist/tools/journal.d.ts.map +1 -0
  197. package/vendor/mcp-server/dist/tools/journal.js +131 -0
  198. package/vendor/mcp-server/dist/tools/taskActivity.d.ts +3 -0
  199. package/vendor/mcp-server/dist/tools/taskActivity.d.ts.map +1 -0
  200. package/vendor/mcp-server/dist/tools/taskActivity.js +32 -0
  201. package/vendor/mcp-server/dist/tools/taskOccurrences.d.ts +3 -0
  202. package/vendor/mcp-server/dist/tools/taskOccurrences.d.ts.map +1 -0
  203. package/vendor/mcp-server/dist/tools/taskOccurrences.js +12 -0
  204. package/vendor/mcp-server/dist/tools/taskTrash.d.ts +3 -0
  205. package/vendor/mcp-server/dist/tools/taskTrash.d.ts.map +1 -0
  206. package/vendor/mcp-server/dist/tools/taskTrash.js +21 -0
  207. package/vendor/mcp-server/dist/tools/tasks.d.ts.map +1 -1
  208. package/vendor/mcp-server/dist/tools/tasks.js +67 -27
  209. package/vendor/mcp-server/package.json +5 -1
  210. package/vendor/mcp-server/src/client.ts +10 -0
  211. package/vendor/mcp-server/src/commentProvider.ts +9 -0
  212. package/vendor/mcp-server/src/index.ts +20 -6
  213. package/vendor/mcp-server/src/tools/automations.ts +199 -0
  214. package/vendor/mcp-server/src/tools/commandEventFormat.ts +108 -0
  215. package/vendor/mcp-server/src/tools/commandEvents.ts +27 -0
  216. package/vendor/mcp-server/src/tools/comments.ts +24 -3
  217. package/vendor/mcp-server/src/tools/index.ts +2 -0
  218. package/vendor/mcp-server/src/tools/journal.ts +168 -0
  219. package/vendor/mcp-server/src/tools/taskActivity.ts +55 -0
  220. package/vendor/mcp-server/src/tools/taskOccurrences.ts +26 -0
  221. package/vendor/mcp-server/src/tools/taskTrash.ts +23 -0
  222. package/vendor/mcp-server/src/tools/tasks.ts +66 -30
  223. package/vendor/notes/dist/index.d.ts +2 -0
  224. package/vendor/notes/dist/index.d.ts.map +1 -1
  225. package/vendor/notes/dist/index.js +2 -0
  226. package/vendor/notes/dist/journal-backend.d.ts +4 -0
  227. package/vendor/notes/dist/journal-backend.d.ts.map +1 -0
  228. package/vendor/notes/dist/journal-backend.js +33 -0
  229. package/vendor/notes/dist/journal.d.ts +7 -0
  230. package/vendor/notes/dist/journal.d.ts.map +1 -0
  231. package/vendor/notes/dist/journal.js +173 -0
  232. package/vendor/notes/dist/vault.d.ts.map +1 -1
  233. package/vendor/notes/dist/vault.js +6 -1
  234. package/vendor/notes/src/index.ts +2 -0
  235. package/vendor/notes/src/journal-backend.ts +53 -0
  236. package/vendor/notes/src/journal.ts +194 -0
  237. package/vendor/notes/src/vault.ts +9 -1
  238. package/vendor/runtime/README.md +4 -0
  239. package/vendor/runtime/dist/executor/claudeAgent.d.ts +2 -0
  240. package/vendor/runtime/dist/executor/claudeAgent.d.ts.map +1 -1
  241. package/vendor/runtime/dist/executor/claudeAgent.js +117 -8
  242. package/vendor/runtime/dist/executor/claudeCode.d.ts.map +1 -1
  243. package/vendor/runtime/dist/executor/claudeCode.js +8 -4
  244. package/vendor/runtime/dist/executor/codex.d.ts +2 -0
  245. package/vendor/runtime/dist/executor/codex.d.ts.map +1 -1
  246. package/vendor/runtime/dist/executor/codex.js +214 -11
  247. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts +2 -0
  248. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts.map +1 -0
  249. package/vendor/runtime/dist/executor/codexProtocol/PlanType.js +2 -0
  250. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.d.ts +6 -0
  251. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.d.ts.map +1 -0
  252. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.js +2 -0
  253. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts +26 -0
  254. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts.map +1 -0
  255. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.js +2 -0
  256. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.d.ts +2 -0
  257. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.d.ts.map +1 -0
  258. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.js +2 -0
  259. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.d.ts +27 -0
  260. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.d.ts.map +1 -0
  261. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.js +2 -0
  262. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.d.ts +2 -0
  263. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.d.ts.map +1 -0
  264. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.js +2 -0
  265. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.d.ts +13 -0
  266. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.d.ts.map +1 -0
  267. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.js +2 -0
  268. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.d.ts +2 -0
  269. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.d.ts.map +1 -0
  270. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.js +2 -0
  271. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts +20 -0
  272. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts.map +1 -0
  273. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.js +2 -0
  274. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.d.ts +6 -0
  275. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.d.ts.map +1 -0
  276. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.js +2 -0
  277. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.d.ts +2 -0
  278. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.d.ts.map +1 -0
  279. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.js +2 -0
  280. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts +12 -0
  281. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts.map +1 -0
  282. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.js +2 -0
  283. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.d.ts +17 -0
  284. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.d.ts.map +1 -0
  285. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.js +2 -0
  286. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.d.ts +5 -0
  287. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.d.ts.map +1 -0
  288. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.js +2 -0
  289. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.d.ts +5 -0
  290. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.d.ts.map +1 -0
  291. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.js +2 -0
  292. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.d.ts +18 -0
  293. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.d.ts.map +1 -0
  294. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.js +2 -0
  295. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.d.ts +22 -0
  296. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.d.ts.map +1 -0
  297. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.js +2 -0
  298. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.d.ts +2 -0
  299. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.d.ts.map +1 -0
  300. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.js +2 -0
  301. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.d.ts +9 -0
  302. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.d.ts.map +1 -0
  303. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.js +2 -0
  304. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.d.ts +8 -0
  305. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.d.ts.map +1 -0
  306. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.js +2 -0
  307. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.d.ts +5 -0
  308. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.d.ts.map +1 -0
  309. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.js +2 -0
  310. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.d.ts +7 -0
  311. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.d.ts.map +1 -0
  312. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.js +2 -0
  313. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.d.ts +5 -0
  314. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.d.ts.map +1 -0
  315. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.js +2 -0
  316. package/vendor/runtime/dist/executor/health.d.ts +1 -0
  317. package/vendor/runtime/dist/executor/health.d.ts.map +1 -1
  318. package/vendor/runtime/dist/executor/health.js +3 -0
  319. package/vendor/runtime/dist/executor/liveTurns.d.ts.map +1 -1
  320. package/vendor/runtime/dist/executor/liveTurns.js +3 -0
  321. package/vendor/runtime/dist/executor/providerRouter.d.ts.map +1 -1
  322. package/vendor/runtime/dist/executor/providerRouter.js +2 -1
  323. package/vendor/runtime/dist/executor/types.d.ts +10 -0
  324. package/vendor/runtime/dist/executor/types.d.ts.map +1 -1
  325. package/vendor/runtime/dist/harness/index.d.ts +2 -0
  326. package/vendor/runtime/dist/harness/index.d.ts.map +1 -1
  327. package/vendor/runtime/dist/harness/index.js +46 -1
  328. package/vendor/runtime/dist/harness/types.d.ts +5 -1
  329. package/vendor/runtime/dist/harness/types.d.ts.map +1 -1
  330. package/vendor/runtime/dist/index.d.ts +2 -1
  331. package/vendor/runtime/dist/index.d.ts.map +1 -1
  332. package/vendor/runtime/dist/index.js +2 -0
  333. package/vendor/runtime/dist/journal/context.d.ts +18 -0
  334. package/vendor/runtime/dist/journal/context.d.ts.map +1 -1
  335. package/vendor/runtime/dist/journal/context.js +19 -5
  336. package/vendor/runtime/dist/prompts/briefing.d.ts +4 -7
  337. package/vendor/runtime/dist/prompts/briefing.d.ts.map +1 -1
  338. package/vendor/runtime/dist/prompts/briefing.js +61 -12
  339. package/vendor/runtime/dist/prompts/cardStatement.d.ts +7 -0
  340. package/vendor/runtime/dist/prompts/cardStatement.d.ts.map +1 -0
  341. package/vendor/runtime/dist/prompts/cardStatement.js +52 -0
  342. package/vendor/runtime/dist/prompts/chat.d.ts +1 -0
  343. package/vendor/runtime/dist/prompts/chat.d.ts.map +1 -1
  344. package/vendor/runtime/dist/prompts/chat.js +15 -1
  345. package/vendor/runtime/dist/prompts/dayPlanning.d.ts +44 -0
  346. package/vendor/runtime/dist/prompts/dayPlanning.d.ts.map +1 -0
  347. package/vendor/runtime/dist/prompts/dayPlanning.js +42 -0
  348. package/vendor/runtime/dist/prompts/projectCapture.d.ts +7 -0
  349. package/vendor/runtime/dist/prompts/projectCapture.d.ts.map +1 -0
  350. package/vendor/runtime/dist/prompts/projectCapture.js +31 -0
  351. package/vendor/runtime/src/executor/claudeAgent.ts +137 -7
  352. package/vendor/runtime/src/executor/claudeCode.ts +6 -4
  353. package/vendor/runtime/src/executor/codex.ts +281 -20
  354. package/vendor/runtime/src/executor/codexProtocol/PlanType.ts +5 -0
  355. package/vendor/runtime/src/executor/codexProtocol/v2/CreditsSnapshot.ts +5 -0
  356. package/vendor/runtime/src/executor/codexProtocol/v2/GetAccountRateLimitsResponse.ts +25 -0
  357. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitReachedType.ts +5 -0
  358. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCredit.ts +27 -0
  359. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCreditStatus.ts +5 -0
  360. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCreditsSummary.ts +14 -0
  361. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetType.ts +5 -0
  362. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitSnapshot.ts +14 -0
  363. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitWindow.ts +5 -0
  364. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewDelivery.ts +5 -0
  365. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewStartParams.ts +12 -0
  366. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewTarget.ts +9 -0
  367. package/vendor/runtime/src/executor/codexProtocol/v2/SkillDependencies.ts +6 -0
  368. package/vendor/runtime/src/executor/codexProtocol/v2/SkillErrorInfo.ts +5 -0
  369. package/vendor/runtime/src/executor/codexProtocol/v2/SkillInterface.ts +14 -0
  370. package/vendor/runtime/src/executor/codexProtocol/v2/SkillMetadata.ts +17 -0
  371. package/vendor/runtime/src/executor/codexProtocol/v2/SkillScope.ts +5 -0
  372. package/vendor/runtime/src/executor/codexProtocol/v2/SkillToolDependency.ts +5 -0
  373. package/vendor/runtime/src/executor/codexProtocol/v2/SkillsListEntry.ts +7 -0
  374. package/vendor/runtime/src/executor/codexProtocol/v2/SkillsListResponse.ts +6 -0
  375. package/vendor/runtime/src/executor/codexProtocol/v2/SpendControlLimitSnapshot.ts +5 -0
  376. package/vendor/runtime/src/executor/codexProtocol/v2/ThreadSetNameParams.ts +5 -0
  377. package/vendor/runtime/src/executor/health.ts +3 -0
  378. package/vendor/runtime/src/executor/liveTurns.ts +3 -0
  379. package/vendor/runtime/src/executor/providerRouter.ts +2 -1
  380. package/vendor/runtime/src/executor/types.ts +10 -0
  381. package/vendor/runtime/src/harness/index.ts +51 -6
  382. package/vendor/runtime/src/harness/types.ts +5 -1
  383. package/vendor/runtime/src/index.ts +4 -1
  384. package/vendor/runtime/src/journal/context.ts +40 -7
  385. package/vendor/runtime/src/prompts/briefing.ts +62 -17
  386. package/vendor/runtime/src/prompts/cardStatement.ts +64 -0
  387. package/vendor/runtime/src/prompts/chat.ts +25 -3
  388. package/vendor/runtime/src/prompts/dayPlanning.ts +46 -0
  389. package/vendor/runtime/src/prompts/projectCapture.ts +51 -0
  390. package/vendor/shared/dist/agentCommands.d.ts +22 -0
  391. package/vendor/shared/dist/agentCommands.d.ts.map +1 -0
  392. package/vendor/shared/dist/agentCommands.js +11 -0
  393. package/vendor/shared/dist/automationTemplates.d.ts +37 -0
  394. package/vendor/shared/dist/automationTemplates.d.ts.map +1 -0
  395. package/vendor/shared/dist/automationTemplates.js +48 -0
  396. package/vendor/shared/dist/automations.d.ts +1052 -0
  397. package/vendor/shared/dist/automations.d.ts.map +1 -0
  398. package/vendor/shared/dist/automations.js +300 -0
  399. package/vendor/shared/dist/cardStatement.d.ts +28 -0
  400. package/vendor/shared/dist/cardStatement.d.ts.map +1 -0
  401. package/vendor/shared/dist/cardStatement.js +37 -0
  402. package/vendor/shared/dist/cardStudio.d.ts +756 -0
  403. package/vendor/shared/dist/cardStudio.d.ts.map +1 -0
  404. package/vendor/shared/dist/cardStudio.js +297 -0
  405. package/vendor/shared/dist/commandLocal.d.ts +218 -0
  406. package/vendor/shared/dist/commandLocal.d.ts.map +1 -0
  407. package/vendor/shared/dist/commandLocal.js +664 -0
  408. package/vendor/shared/dist/commandText.d.ts +12 -0
  409. package/vendor/shared/dist/commandText.d.ts.map +1 -0
  410. package/vendor/shared/dist/commandText.js +21 -0
  411. package/vendor/shared/dist/commands.d.ts +1534 -0
  412. package/vendor/shared/dist/commands.d.ts.map +1 -0
  413. package/vendor/shared/dist/commands.js +233 -0
  414. package/vendor/shared/dist/computer.d.ts +9 -9
  415. package/vendor/shared/dist/computer.d.ts.map +1 -1
  416. package/vendor/shared/dist/computer.js +12 -2
  417. package/vendor/shared/dist/constants.d.ts +3 -3
  418. package/vendor/shared/dist/constants.d.ts.map +1 -1
  419. package/vendor/shared/dist/constants.js +9 -2
  420. package/vendor/shared/dist/dayPlan.d.ts +86 -0
  421. package/vendor/shared/dist/dayPlan.d.ts.map +1 -0
  422. package/vendor/shared/dist/dayPlan.js +46 -0
  423. package/vendor/shared/dist/dayPlanning.d.ts +139 -0
  424. package/vendor/shared/dist/dayPlanning.d.ts.map +1 -0
  425. package/vendor/shared/dist/dayPlanning.js +67 -0
  426. package/vendor/shared/dist/githubContributions.d.ts +93 -0
  427. package/vendor/shared/dist/githubContributions.d.ts.map +1 -0
  428. package/vendor/shared/dist/githubContributions.js +54 -0
  429. package/vendor/shared/dist/habitContributions.d.ts +26 -0
  430. package/vendor/shared/dist/habitContributions.d.ts.map +1 -0
  431. package/vendor/shared/dist/habitContributions.js +119 -0
  432. package/vendor/shared/dist/index.d.ts +28 -2
  433. package/vendor/shared/dist/index.d.ts.map +1 -1
  434. package/vendor/shared/dist/index.js +25 -2
  435. package/vendor/shared/dist/journal-migration.d.ts +29 -0
  436. package/vendor/shared/dist/journal-migration.d.ts.map +1 -0
  437. package/vendor/shared/dist/journal-migration.js +73 -0
  438. package/vendor/shared/dist/journal-vault.d.ts +414 -0
  439. package/vendor/shared/dist/journal-vault.d.ts.map +1 -0
  440. package/vendor/shared/dist/journal-vault.js +972 -0
  441. package/vendor/shared/dist/projectCapture.d.ts +73 -0
  442. package/vendor/shared/dist/projectCapture.d.ts.map +1 -0
  443. package/vendor/shared/dist/projectCapture.js +66 -0
  444. package/vendor/shared/dist/quickAdd.d.ts +90 -0
  445. package/vendor/shared/dist/quickAdd.d.ts.map +1 -0
  446. package/vendor/shared/dist/quickAdd.js +260 -0
  447. package/vendor/shared/dist/recurrence.d.ts +44 -0
  448. package/vendor/shared/dist/recurrence.d.ts.map +1 -0
  449. package/vendor/shared/dist/recurrence.js +37 -0
  450. package/vendor/shared/dist/reminderWords.d.ts +11 -0
  451. package/vendor/shared/dist/reminderWords.d.ts.map +1 -0
  452. package/vendor/shared/dist/reminderWords.js +63 -0
  453. package/vendor/shared/dist/schemas/comment.d.ts +13 -1
  454. package/vendor/shared/dist/schemas/comment.d.ts.map +1 -1
  455. package/vendor/shared/dist/schemas/comment.js +5 -0
  456. package/vendor/shared/dist/schemas/conversation.d.ts +3 -3
  457. package/vendor/shared/dist/schemas/harness.d.ts +976 -59
  458. package/vendor/shared/dist/schemas/harness.d.ts.map +1 -1
  459. package/vendor/shared/dist/schemas/harness.js +124 -3
  460. package/vendor/shared/dist/schemas/journal.d.ts +10 -0
  461. package/vendor/shared/dist/schemas/journal.d.ts.map +1 -1
  462. package/vendor/shared/dist/schemas/journal.js +10 -2
  463. package/vendor/shared/dist/schemas/notification.d.ts +1 -1
  464. package/vendor/shared/dist/schemas/organization.d.ts +3 -2
  465. package/vendor/shared/dist/schemas/organization.d.ts.map +1 -1
  466. package/vendor/shared/dist/schemas/organization.js +3 -2
  467. package/vendor/shared/dist/schemas/proposal.d.ts +7 -3
  468. package/vendor/shared/dist/schemas/proposal.d.ts.map +1 -1
  469. package/vendor/shared/dist/schemas/proposal.js +2 -1
  470. package/vendor/shared/dist/schemas/request.d.ts +44 -4
  471. package/vendor/shared/dist/schemas/request.d.ts.map +1 -1
  472. package/vendor/shared/dist/schemas/task.d.ts +83 -8
  473. package/vendor/shared/dist/schemas/task.d.ts.map +1 -1
  474. package/vendor/shared/dist/schemas/task.js +20 -2
  475. package/vendor/shared/dist/schemas/timeSession.d.ts +2 -2
  476. package/vendor/shared/dist/smartCapture.d.ts +60 -0
  477. package/vendor/shared/dist/smartCapture.d.ts.map +1 -0
  478. package/vendor/shared/dist/smartCapture.js +56 -0
  479. package/vendor/shared/dist/speech.d.ts +39 -0
  480. package/vendor/shared/dist/speech.d.ts.map +1 -0
  481. package/vendor/shared/dist/speech.js +36 -0
  482. package/vendor/shared/dist/spokenNames.d.ts +25 -0
  483. package/vendor/shared/dist/spokenNames.d.ts.map +1 -0
  484. package/vendor/shared/dist/spokenNames.js +120 -0
  485. package/vendor/shared/dist/taskActivity.d.ts +76 -0
  486. package/vendor/shared/dist/taskActivity.d.ts.map +1 -0
  487. package/vendor/shared/dist/taskActivity.js +27 -0
  488. package/vendor/shared/dist/vault-search.d.ts +50 -0
  489. package/vendor/shared/dist/vault-search.d.ts.map +1 -0
  490. package/vendor/shared/dist/vault-search.js +177 -0
  491. package/vendor/shared/dist/voiceCapture.d.ts +32 -0
  492. package/vendor/shared/dist/voiceCapture.d.ts.map +1 -0
  493. package/vendor/shared/dist/voiceCapture.js +29 -0
  494. package/vendor/shared/package.json +4 -0
  495. package/vendor/shared/src/agentCommands.ts +35 -0
  496. package/vendor/shared/src/automationTemplates.ts +54 -0
  497. package/vendor/shared/src/automations.ts +329 -0
  498. package/vendor/shared/src/cardStatement.ts +49 -0
  499. package/vendor/shared/src/cardStudio.ts +340 -0
  500. package/vendor/shared/src/commandLocal.ts +740 -0
  501. package/vendor/shared/src/commandText.ts +25 -0
  502. package/vendor/shared/src/commands.ts +255 -0
  503. package/vendor/shared/src/computer.ts +25 -6
  504. package/vendor/shared/src/constants.ts +9 -2
  505. package/vendor/shared/src/dayPlan.ts +81 -0
  506. package/vendor/shared/src/dayPlanning.ts +77 -0
  507. package/vendor/shared/src/githubContributions.ts +70 -0
  508. package/vendor/shared/src/habitContributions.ts +144 -0
  509. package/vendor/shared/src/index.ts +44 -1
  510. package/vendor/shared/src/journal-migration.ts +130 -0
  511. package/vendor/shared/src/journal-vault.ts +1240 -0
  512. package/vendor/shared/src/projectCapture.ts +86 -0
  513. package/vendor/shared/src/quickAdd.ts +310 -0
  514. package/vendor/shared/src/recurrence.ts +37 -0
  515. package/vendor/shared/src/reminderWords.ts +54 -0
  516. package/vendor/shared/src/schemas/comment.ts +5 -0
  517. package/vendor/shared/src/schemas/harness.ts +146 -7
  518. package/vendor/shared/src/schemas/journal.ts +15 -6
  519. package/vendor/shared/src/schemas/organization.ts +3 -2
  520. package/vendor/shared/src/schemas/proposal.ts +6 -1
  521. package/vendor/shared/src/schemas/task.ts +20 -2
  522. package/vendor/shared/src/smartCapture.ts +67 -0
  523. package/vendor/shared/src/speech.ts +44 -0
  524. package/vendor/shared/src/spokenNames.ts +128 -0
  525. package/vendor/shared/src/taskActivity.ts +34 -0
  526. package/vendor/shared/src/vault-search.ts +243 -0
  527. package/vendor/shared/src/voiceCapture.ts +34 -0
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Instruction text handling shared by the phone and the API, so both split an instruction into the
3
+ * same clauses: the phone carries out the ones it can by itself and sends the rest.
4
+ */
5
+
6
+ const clean = (s: string) => s.replace(/\s+/g, ' ').trim();
7
+
8
+ const COURTESY = /^(?:(?:hey|ok(?:ay)?|so|um+|uh+|jev|please)\b[\s,]*)*(?:(?:can|could|would|will)\s+you\s+)?(?:please\s+)?/i;
9
+ const CLAUSE_VERBS = 'go|open|show|take|navigate|add|create|make|complete|finish|mark|move|put|reschedule|push|postpone|set|start|reopen|find|list|what|which|tick|check|file|delete|repeat|recur|remind';
10
+ const CLAUSE_BREAK = new RegExp(`\\s*(?:[,;]\\s*(?:and\\s+)?(?:then\\s+)?|\\s+(?:and\\s+then|then|after\\s+that|and\\s+also|and)\\s+)(?=(?:${CLAUSE_VERBS})\\b)`, 'i');
11
+
12
+ /** Courtesy words removed, trailing punctuation dropped. Speech transcripts arrive punctuated. */
13
+ export function normalizeInstruction(text: string): string {
14
+ return clean(text).replace(COURTESY, '').replace(/[.!?]+$/, '').trim() || clean(text);
15
+ }
16
+
17
+ /**
18
+ * Where an instruction could be several. Only proposes: a clause must start with a command verb,
19
+ * so "buy bread and milk" stays whole, and Jev decides whether the proposal is right.
20
+ */
21
+ export function proposeClauses(text: string): string[] {
22
+ const sentences = text.split(/(?<=[.!?])\s+/);
23
+ const clauses = sentences.flatMap((s) => s.split(CLAUSE_BREAK)).map((s) => normalizeInstruction(s)).filter(Boolean);
24
+ return clauses.length > 1 ? clauses.slice(0, 6) : [];
25
+ }
@@ -0,0 +1,255 @@
1
+ import { z } from 'zod';
2
+ import { PRIORITY_MAX, PRIORITY_MIN, RECURRING_FREQUENCY_VALUES } from './constants.js';
3
+ import { RecurringReminderSchema } from './recurrence.js';
4
+
5
+ /**
6
+ * Jev commands: one spoken or typed instruction, interpreted by the API and carried out by the
7
+ * phone. Jev never writes anything itself. The API lists what could be meant (screens, tasks,
8
+ * projects, dates, cleaned-up titles), Jev picks from those lists, and the client executes the
9
+ * resulting step with the same mutations its own buttons use.
10
+ */
11
+
12
+ /**
13
+ * Places a command can take you. Keys match the tab catalog in `hooks/useTabSlots` where one
14
+ * exists, so the phone can reuse the tab bar's own navigation for them.
15
+ */
16
+ export const COMMAND_DESTINATIONS = [
17
+ { key: 'dash', label: 'Dashboard', description: 'The Dashboard or home screen' },
18
+ { key: 'search', label: 'Tasks', description: 'The Tasks tab: recent tasks, search and quick capture' },
19
+ { key: 'today', label: 'Today', description: 'Today: tasks due today and overdue' },
20
+ { key: 'inbox', label: 'Inbox', description: 'The Inbox: tasks not filed in any project' },
21
+ { key: 'projects', label: 'Projects', description: 'The list of all projects' },
22
+ { key: 'milestones', label: 'Milestones', description: 'The list of milestones' },
23
+ { key: 'notes', label: 'Notes', description: 'Notes' },
24
+ { key: 'journal', label: 'Journal', description: 'The voice journal' },
25
+ { key: 'habits', label: 'Habits', description: 'Habits' },
26
+ { key: 'chat', label: 'Messages', description: 'Messages: direct messages and chats with people' },
27
+ { key: 'code', label: 'Code', description: 'The Code tab for coding with Lucid' },
28
+ { key: 'team', label: 'Teams', description: 'Teams: organizations, standups and procurement' },
29
+ { key: 'standups', label: 'Standups', description: 'Standups in an organization' },
30
+ { key: 'procurement', label: 'Procurement', description: 'Procurement requests in an organization' },
31
+ { key: 'notifications', label: 'Notifications', description: 'Notifications' },
32
+ { key: 'settings', label: 'Settings', description: 'Settings' },
33
+ { key: 'voice', label: 'Voice', description: 'Settings › Voice: dictation, speech recognition and spoken replies' },
34
+ { key: 'computer', label: 'Computer', description: 'Settings › Computer: connecting your computer to Lucid' },
35
+ { key: 'computer_settings', label: 'Computer settings', description: 'Settings for Lucid on your computer' },
36
+ { key: 'automations', label: 'Automations', description: 'Settings › Automations: what Lucid runs on a schedule' },
37
+ { key: 'trash', label: 'Trash', description: 'Settings › Trash: restore deleted tasks within 30 days' },
38
+ { key: 'apple_watch', label: 'Apple Watch', description: 'Settings › Apple Watch' },
39
+ { key: 'tab_bar', label: 'Tab bar', description: 'Settings › Tab bar: which places sit on the bar' },
40
+ { key: 'organizations', label: 'Organizations', description: 'Settings › Organizations: create, join and manage them' },
41
+ { key: 'api_key', label: 'API key', description: 'Settings › API key' },
42
+ { key: 'profile', label: 'Profile', description: 'Your profile' },
43
+ { key: 'edit_profile', label: 'Edit profile', description: 'Editing your name, handle and bio' },
44
+ { key: 'connections', label: 'Connections', description: 'People you are connected with, and adding someone' },
45
+ { key: 'review', label: 'Review', description: 'What Lucid inferred from the journal and habits, waiting for a yes or no' },
46
+ { key: 'weekly_review', label: 'Week in view', description: 'A look back at the week' },
47
+ { key: 'focus', label: 'Focus', description: 'The focus timer' },
48
+ { key: 'card_studio', label: 'Card Studio', description: 'Choosing the cards on the Dashboard' },
49
+ { key: 'ask_lucid', label: 'Lucid', description: 'A conversation with Lucid on your computer' },
50
+ { key: 'plan', label: 'My day', description: 'Plan the day and review its chosen tasks and main focus' },
51
+ { key: 'deck', label: 'Deck', description: 'The cards for habits, projects and daily summaries' },
52
+ ] as const;
53
+ export type CommandDestination = (typeof COMMAND_DESTINATIONS)[number]['key'];
54
+ /**
55
+ * The place each one sits under, so "voice settings" and "settings voice" find Voice without an
56
+ * alias for every pair.
57
+ */
58
+ export const DESTINATION_PARENTS: Partial<Record<CommandDestination, CommandDestination>> = {
59
+ voice: 'settings',
60
+ computer: 'settings',
61
+ automations: 'settings',
62
+ trash: 'settings',
63
+ apple_watch: 'settings',
64
+ tab_bar: 'settings',
65
+ organizations: 'settings',
66
+ api_key: 'settings',
67
+ edit_profile: 'profile',
68
+ connections: 'chat',
69
+ };
70
+ /** Places every organization has its own of. Going to one needs to know which organization. */
71
+ export const ORGANIZATION_DESTINATIONS: readonly CommandDestination[] = ['standups', 'procurement'];
72
+ const DESTINATION_KEYS = COMMAND_DESTINATIONS.map((d) => d.key) as [CommandDestination, ...CommandDestination[]];
73
+
74
+ const ItemKind = z.enum(['task', 'project', 'milestone']);
75
+ export type CommandItemKind = z.infer<typeof ItemKind>;
76
+
77
+ /** What the screen you're looking at shows, top to bottom. What "here" and "the first one" mean. */
78
+ export const CommandScreenSchema = z.object({
79
+ /** A destination key, or a detail screen such as `project` or `milestone`. */
80
+ name: z.string().trim().min(1).max(40),
81
+ title: z.string().trim().max(200).optional(),
82
+ /** The project or milestone this screen is, so a new task said here lands here. */
83
+ projectId: z.uuid().optional(),
84
+ milestoneId: z.uuid().optional(),
85
+ items: z
86
+ .array(z.object({ kind: ItemKind, id: z.uuid(), title: z.string().max(500) }))
87
+ .max(50),
88
+ });
89
+ export type CommandScreen = z.infer<typeof CommandScreenSchema>;
90
+
91
+ export const CommandRequestSchema = z.object({
92
+ text: z.string().trim().min(1).max(500),
93
+ capturedAt: z.iso.datetime({ offset: true }),
94
+ timeZone: z
95
+ .string()
96
+ .min(1)
97
+ .max(100)
98
+ .refine((zone) => {
99
+ try {
100
+ new Intl.DateTimeFormat('en', { timeZone: zone });
101
+ return true;
102
+ } catch {
103
+ return false;
104
+ }
105
+ }, 'Use an IANA timezone'),
106
+ screen: CommandScreenSchema.optional(),
107
+ /** Tasks earlier steps in this conversation acted on, newest first: what "it" and "that" mean. */
108
+ recentTaskIds: z.array(z.uuid()).max(10).optional(),
109
+ /** Already one clause of a split instruction, so the API must not split it again. */
110
+ single: z.boolean().optional(),
111
+ /** Older phones cannot execute a recurring-reminder step. */
112
+ supportsRecurringReminders: z.boolean().optional(),
113
+ });
114
+ export type CommandRequest = z.infer<typeof CommandRequestSchema>;
115
+
116
+ const Ref = z.object({ id: z.uuid(), title: z.string() });
117
+ export type CommandRef = z.infer<typeof Ref>;
118
+ const Due = {
119
+ dueDate: z.string().nullable(),
120
+ dueDatePrecision: z.enum(['date', 'time']).nullable(),
121
+ dueTimeZone: z.string().nullable(),
122
+ /** How the date reads in a reply, "Sat, Sep 26, 2026". Null when clearing a date. */
123
+ dueLabel: z.string().nullable(),
124
+ };
125
+ const Placement = { projectId: z.uuid().nullable(), projectName: z.string().nullable() };
126
+
127
+ /** Everything a step can be. Every step except `clarify`, `lucid` and `unclear` is directly executable. */
128
+ const ExecutableStep = z.discriminatedUnion('kind', [
129
+ z.object({ kind: z.literal('navigate'), destination: z.enum(DESTINATION_KEYS), organizationId: z.uuid().optional() }),
130
+ z.object({ kind: z.literal('open'), item: Ref.extend({ kind: ItemKind }) }),
131
+ /** The previous screen, or out of the task sheet. Only the phone reads this one. */
132
+ z.object({ kind: z.literal('back') }),
133
+ z.object({
134
+ kind: z.literal('create_task'),
135
+ title: z.string().min(1).max(500),
136
+ ...Placement,
137
+ ...Due,
138
+ /** Set when the task was said on a milestone's screen. */
139
+ milestoneId: z.uuid().nullable().optional(),
140
+ }),
141
+ z.object({ kind: z.literal('create_project'), name: z.string().min(1).max(255) }),
142
+ z.object({ kind: z.literal('complete'), task: Ref }),
143
+ z.object({ kind: z.literal('reopen'), task: Ref }),
144
+ z.object({ kind: z.literal('start'), task: Ref }),
145
+ /** Undoable: the phone holds the delete back while Undo is on screen. */
146
+ z.object({ kind: z.literal('delete'), task: Ref }),
147
+ z.object({ kind: z.literal('reschedule'), task: Ref, ...Due }),
148
+ z.object({ kind: z.literal('move'), task: Ref, ...Placement }),
149
+ /** A comment on an existing task, as the task sheet's Add Comment writes one. */
150
+ z.object({ kind: z.literal('comment'), task: Ref, text: z.string().min(1).max(5000) }),
151
+ /** One or more subtasks under an existing task: "add subtasks pack, book flights and call the hotel". */
152
+ z.object({ kind: z.literal('add_subtasks'), task: Ref, titles: z.array(z.string().min(1).max(500)).min(1).max(10) }),
153
+ z.object({ kind: z.literal('rename'), task: Ref, title: z.string().min(1).max(500) }),
154
+ /** The statuses besides done and in progress, which have steps of their own. */
155
+ z.object({ kind: z.literal('set_status'), task: Ref, status: z.enum(['pending', 'blocked', 'deferred']) }),
156
+ z.object({ kind: z.literal('priority'), task: Ref, priority: z.number().int().min(PRIORITY_MIN).max(PRIORITY_MAX) }),
157
+ /** Null stops it repeating. Repeating needs a due date, as in the task sheet. */
158
+ z.object({ kind: z.literal('repeat'), task: Ref, frequency: z.enum(RECURRING_FREQUENCY_VALUES).nullable() }),
159
+ /** Null removes the reminder. `reminderLabel` is how the time reads in a reply. */
160
+ z.object({ kind: z.literal('remind'), task: Ref, reminderAt: z.string().nullable(), reminderLabel: z.string().nullable() }),
161
+ z.object({ kind: z.literal('remind_recurring'), task: Ref, rule: RecurringReminderSchema }),
162
+ /** Deletes every task in it too, so the phone asks first and offers archiving instead. */
163
+ z.object({ kind: z.literal('delete_project'), project: Ref }),
164
+ z.object({ kind: z.literal('archive_project'), project: Ref }),
165
+ z.object({ kind: z.literal('rename_project'), project: Ref, name: z.string().min(1).max(255) }),
166
+ /** Read out, with nothing changed: the reply is the words. */
167
+ z.object({ kind: z.literal('read'), task: Ref, what: z.enum(['description', 'comments', 'all']) }),
168
+ z.object({ kind: z.literal('set_milestone'), task: Ref, milestoneId: z.uuid().nullable(), milestoneName: z.string().nullable() }),
169
+ /** A new description, added to the end of the one there when `append`; null clears it. */
170
+ z.object({ kind: z.literal('describe'), task: Ref, description: z.string().min(1).max(10_000).nullable(), append: z.boolean() }),
171
+ z.object({ kind: z.literal('list'), title: z.string(), tasks: z.array(Ref.extend({ due: z.string().nullable() })) }),
172
+ ]);
173
+ export type CommandExecutableStep = z.infer<typeof ExecutableStep>;
174
+
175
+ export const CommandStepSchema = z.union([
176
+ ExecutableStep,
177
+ /** Jev was unsure which of a few things you meant. Each option is a ready step to run on tap. */
178
+ z.object({
179
+ kind: z.literal('clarify'),
180
+ question: z.string(),
181
+ options: z.array(z.object({ label: z.string(), step: ExecutableStep })).min(1).max(4),
182
+ }),
183
+ /** Needs thinking or conversation rather than an action: offer to hand it to Lucid. */
184
+ z.object({ kind: z.literal('lucid') }),
185
+ z.object({ kind: z.literal('unclear') }),
186
+ ]);
187
+ export type CommandStep = z.infer<typeof CommandStepSchema>;
188
+
189
+ /**
190
+ * What Jev made of one instruction, returned with the step so the phone can record it: each
191
+ * call's answers as "choice@confidence" per question ("edit@0.80"), or the reason a call failed.
192
+ */
193
+ export const CommandTraceSchema = z.object({
194
+ calls: z.array(z.union([z.record(z.string(), z.string()), z.string()])).max(6),
195
+ attempts: z.number().int().min(0),
196
+ gatherMs: z.number().int().min(0),
197
+ jevMs: z.number().int().min(0),
198
+ });
199
+ export type CommandTrace = z.infer<typeof CommandTraceSchema>;
200
+
201
+ export const CommandResponseSchema = z.object({
202
+ step: CommandStepSchema,
203
+ /** One short sentence describing the step, written by code rather than Jev. */
204
+ reply: z.string(),
205
+ /** The remaining clauses of a split instruction, to send one at a time after this step runs. */
206
+ rest: z.array(z.string()),
207
+ elapsedMs: z.number(),
208
+ trace: CommandTraceSchema.optional(),
209
+ });
210
+ export type CommandResponse = z.infer<typeof CommandResponseSchema>;
211
+
212
+ /**
213
+ * What happened to an instruction: carried out, a question back ("What should the task say?"), a
214
+ * choice offered, not understood, handed to Chat, failed; later undone, or a choice picked.
215
+ */
216
+ export const COMMAND_EVENT_OUTCOMES = [
217
+ 'done', 'asked', 'clarify', 'unclear', 'lucid', 'failed', 'undone', 'chose', 'handed_to_chat', 'sent', 'answered',
218
+ 'cancelled', 'blocked', 'incomplete',
219
+ ] as const;
220
+ const Outcome = z.enum(COMMAND_EVENT_OUTCOMES);
221
+
222
+ /** One instruction said to Fast mode or Chat, recorded for the Fast mode review. */
223
+ export const CommandEventSchema = z.object({
224
+ id: z.uuid(),
225
+ mode: z.enum(['fast', 'chat']),
226
+ heard: z.string().trim().min(1).max(500),
227
+ handledBy: z.enum(['phone', 'jev', 'lucid']),
228
+ did: z.string().max(32).optional(),
229
+ reply: z.string().max(500).optional(),
230
+ ms: z.number().int().min(0).max(86_400_000).optional(),
231
+ screen: z.string().max(40).optional(),
232
+ outcome: Outcome,
233
+ detail: z.string().max(2000).optional(),
234
+ /** Shared by every row one sentence led to; see command_events in @lucidity/db. */
235
+ turnId: z.uuid().optional(),
236
+ step: z.number().int().min(0).max(20).optional(),
237
+ replyTo: z.uuid().optional(),
238
+ rule: z.string().max(64).optional(),
239
+ target: z.object({ kind: z.string().max(24), id: z.string().max(64).optional(), title: z.string().max(200).optional() }).optional(),
240
+ context: z.object({
241
+ sheetTaskId: z.uuid().optional(),
242
+ sheetTaskTitle: z.string().max(200).optional(),
243
+ projectId: z.uuid().optional(),
244
+ milestoneId: z.uuid().optional(),
245
+ screenTitle: z.string().max(200).optional(),
246
+ }).optional(),
247
+ jev: CommandTraceSchema.optional(),
248
+ });
249
+ export type CommandEvent = z.infer<typeof CommandEventSchema>;
250
+ export const UpdateCommandEventSchema = z.object({
251
+ outcome: Outcome,
252
+ detail: z.string().max(2000).optional(),
253
+ ms: z.number().int().min(0).max(86_400_000).optional(),
254
+ });
255
+ export type UpdateCommandEvent = z.infer<typeof UpdateCommandEventSchema>;
@@ -49,12 +49,17 @@ export const ComputerPresenceSchema = z.object({
49
49
  });
50
50
  export type ComputerPresence = z.infer<typeof ComputerPresenceSchema>;
51
51
  export type ComputerFeature =
52
+ | 'turn-queue'
53
+ | 'provider-handoff'
54
+ | 'queue-control'
55
+ | 'day-plan'
52
56
  | 'ask'
53
57
  | 'code'
54
58
  | 'conduct'
55
59
  | 'briefing'
56
60
  | 'attention'
57
61
  | 'models'
62
+ | 'commands'
58
63
  | 'steer'
59
64
  | 'permission'
60
65
  | 'pull'
@@ -62,10 +67,15 @@ export type ComputerFeature =
62
67
  | 'prs'
63
68
  | 'clone'
64
69
  | 'getConfig'
70
+ | 'getAutomations'
71
+ | 'automation'
65
72
  | 'setConfig'
66
73
  | 'journal'
67
74
  | 'incident'
68
75
  | 'voice-diag'
76
+ | 'transcribe'
77
+ | 'voice-capture'
78
+ | 'voice-capture-status'
69
79
  | 'cancel';
70
80
  export type Availability = {
71
81
  state:
@@ -75,6 +85,7 @@ export type Availability = {
75
85
  | 'offline'
76
86
  | 'update'
77
87
  | 'permission'
88
+ | 'other_device'
78
89
  | 'provider'
79
90
  | 'ready';
80
91
  title: string;
@@ -83,6 +94,7 @@ export type Availability = {
83
94
  };
84
95
  export const INFERENCE_FEATURES = new Set<string>([
85
96
  'ask',
97
+ 'day-plan',
86
98
  'code',
87
99
  'conduct',
88
100
  'briefing',
@@ -132,14 +144,21 @@ export function computerAvailability(
132
144
  }
133
145
  if (
134
146
  presence.readOnly &&
135
- !['pull', 'getConfig', 'models', 'repos', 'prs', 'journal'].includes(
136
- feature,
137
- )
147
+ ![
148
+ 'pull',
149
+ 'getConfig',
150
+ 'getAutomations',
151
+ 'models',
152
+ 'commands',
153
+ 'repos',
154
+ 'prs',
155
+ 'journal',
156
+ ].includes(feature)
138
157
  )
139
158
  return blocked(
140
- 'permission',
141
- 'Observing another device',
142
- 'Saved and live output are available here. Choose Use here before sending requests or approval decisions.',
159
+ 'other_device',
160
+ 'Another device is in control',
161
+ 'Only one device can send messages or approve actions at a time. Choose “Use on this device” to switch control here.',
143
162
  );
144
163
  const runtime = presence.runtime;
145
164
  if (
@@ -379,6 +379,9 @@ export function normalizeBio(input: string): string | null {
379
379
  // re-fetches an interrupted turn's frames from the daemon's durable turn log
380
380
  // (`sinceSeq` onward) so a dropped reply is recovered, never re-run.
381
381
  export const HARNESS_REQUEST_KINDS = [
382
+ 'getAutomations',
383
+ 'automation',
384
+ 'queue-control',
382
385
  'ask',
383
386
  'briefing',
384
387
  'journal',
@@ -401,9 +404,13 @@ export const HARNESS_REQUEST_KINDS = [
401
404
  // Phone ships a per-utterance capture of the Kokoro TTS pipeline so a Claude session can
402
405
  // localize where it drops words / collapses pauses (voice diagnostics).
403
406
  'voice-diag',
407
+ 'transcribe',
408
+ 'voice-capture',
409
+ 'voice-capture-status',
404
410
  'steer',
405
411
  'permission',
406
412
  'models',
413
+ 'commands',
407
414
  ] as const;
408
415
 
409
416
  // Union of provider effort levels. Model pickers filter this list by provider capabilities.
@@ -418,7 +425,7 @@ export const EFFORT_LEVELS = [
418
425
  ] as const;
419
426
 
420
427
  // Reasoning-effort levels with display labels/blurbs for the phone's picker (values are
421
- // `EFFORT_LEVELS`). `auto` leaves the choice to the provider. "Extra" is the friendly name for `xhigh`.
428
+ // `EFFORT_LEVELS`). `auto` leaves the choice to the provider; keep XHigh recognizable in the UI.
422
429
  export const EFFORT_OPTIONS = [
423
430
  {
424
431
  value: 'auto',
@@ -428,7 +435,7 @@ export const EFFORT_OPTIONS = [
428
435
  { value: 'low', label: 'Low', blurb: 'Fastest, least thorough' },
429
436
  { value: 'medium', label: 'Medium', blurb: 'Quick, some reasoning' },
430
437
  { value: 'high', label: 'High', blurb: 'Thorough reasoning' },
431
- { value: 'xhigh', label: 'Extra', blurb: 'Deeper reasoning' },
438
+ { value: 'xhigh', label: 'XHigh', blurb: 'Extra-high reasoning' },
432
439
  { value: 'max', label: 'Max', blurb: 'Very thorough reasoning' },
433
440
  {
434
441
  value: 'ultra',
@@ -0,0 +1,81 @@
1
+ import { z } from 'zod';
2
+
3
+ export const PlanDateSchema = z.iso.date();
4
+ export const PlanTimeZoneSchema = z.string().min(1).max(100).refine((zone) => {
5
+ try { new Intl.DateTimeFormat('en', { timeZone: zone }); return true; } catch { return false; }
6
+ }, 'Choose a valid time zone.');
7
+
8
+ export const PlanTaskLinkSchema = z.object({
9
+ kind: z.literal('task'),
10
+ taskId: z.uuid(),
11
+ occurrenceId: z.uuid().nullable(),
12
+ focus: z.boolean(),
13
+ });
14
+ export const PlanNewTaskSchema = z.object({
15
+ kind: z.literal('new'),
16
+ taskId: z.uuidv7(),
17
+ title: z.string().trim().min(1).max(500),
18
+ focus: z.boolean(),
19
+ });
20
+ export const PlanInputItemSchema = z.discriminatedUnion('kind', [PlanTaskLinkSchema, PlanNewTaskSchema]);
21
+ export const SaveDayPlanSchema = z.object({
22
+ timeZone: PlanTimeZoneSchema,
23
+ revision: z.number().int().min(0),
24
+ mutationId: z.uuidv7(),
25
+ items: z.array(PlanInputItemSchema).max(30),
26
+ }).superRefine(({ items }, context) => {
27
+ if (items.filter((item) => item.focus).length > 1)
28
+ context.addIssue({ code: 'custom', message: 'Choose one main focus.', path: ['items'] });
29
+ const links = items.map((item) => `${item.taskId}:${item.kind === 'task' ? item.occurrenceId ?? '' : ''}`);
30
+ if (new Set(links).size !== links.length)
31
+ context.addIssue({ code: 'custom', message: 'A task can appear only once in a plan.', path: ['items'] });
32
+ const newIds = items.filter((item) => item.kind === 'new').map((item) => item.taskId);
33
+ if (newIds.some((id) => items.filter((item) => item.taskId === id).length > 1))
34
+ context.addIssue({ code: 'custom', message: 'New tasks need separate identities.', path: ['items'] });
35
+ });
36
+
37
+ export type PlanTaskLink = z.infer<typeof PlanTaskLinkSchema>;
38
+ export type PlanInputItem = z.infer<typeof PlanInputItemSchema>;
39
+ export type SaveDayPlan = z.infer<typeof SaveDayPlanSchema>;
40
+
41
+ /** A task becoming private or deleted leaves a placeholder, never a cached title. */
42
+ export interface PlanTask {
43
+ id: string;
44
+ title: string;
45
+ projectName: string | null;
46
+ projectKey: string | null;
47
+ taskNumber: number | null;
48
+ occurrenceId: string | null;
49
+ completed: boolean;
50
+ canComplete: boolean;
51
+ }
52
+ export interface DayPlanItem extends PlanTaskLink { task: PlanTask | null }
53
+ export interface DayPlan {
54
+ date: string;
55
+ timeZone: string;
56
+ revision: number;
57
+ updatedAt: string;
58
+ items: DayPlanItem[];
59
+ }
60
+ export interface DayPlanResponse { plan: DayPlan | null; previous: DayPlan | null }
61
+
62
+ export const InterpretDayPlanSchema = z.object({ text: z.string().trim().min(1).max(4000) });
63
+ export interface PlanSuggestion {
64
+ words: string;
65
+ title: string;
66
+ task: PlanTask | null;
67
+ focus: boolean;
68
+ }
69
+ export interface PlanInterpretation {
70
+ suggestions: PlanSuggestion[];
71
+ unresolved: string[];
72
+ }
73
+
74
+ export function localPlanDate(now: Date, timeZone: string): string {
75
+ const parts = new Intl.DateTimeFormat('en', { timeZone, year: 'numeric', month: '2-digit', day: '2-digit' }).formatToParts(now);
76
+ const value = (name: string) => parts.find((part) => part.type === name)!.value;
77
+ return `${value('year')}-${value('month')}-${value('day')}`;
78
+ }
79
+
80
+ export const planItemKey = (item: Pick<PlanTaskLink, 'taskId' | 'occurrenceId'>): string =>
81
+ `${item.taskId}:${item.occurrenceId ?? ''}`;
@@ -0,0 +1,77 @@
1
+ import { z } from 'zod';
2
+
3
+ const words = z.string().trim().min(1).max(4000);
4
+ const title = z.string().trim().min(1).max(300);
5
+ export const DayPlanningProjectSchema = z.object({
6
+ id: z.uuid(), name: z.string().max(255), key: z.string().nullable(),
7
+ });
8
+ export const DayPlanningActionSchema = z.strictObject({
9
+ words, title, projectId: z.uuid().nullable(),
10
+ taskNumber: z.number().int().positive().nullable(), focus: z.boolean(),
11
+ });
12
+ export const DayPlanningExtractionSchema = z.strictObject({
13
+ actions: z.array(DayPlanningActionSchema).max(30),
14
+ questions: z.array(z.strictObject({ words, question: title })).max(12),
15
+ });
16
+ export const DayPlanningCandidateSchema = z.object({
17
+ id: z.uuid(), title: z.string().max(500), projectId: z.uuid().nullable(),
18
+ projectName: z.string().nullable(), taskNumber: z.number().int().nullable(),
19
+ });
20
+ export const DayPlanningMatchesSchema = z.strictObject({
21
+ matches: z.array(z.strictObject({
22
+ actionIndex: z.number().int().min(0).max(29),
23
+ taskId: z.uuid().nullable(), question: title.nullable(),
24
+ })).max(30),
25
+ });
26
+ export const DayPlanningContextSchema = z.discriminatedUnion('phase', [
27
+ z.object({ phase: z.literal('extract'), projects: z.array(DayPlanningProjectSchema).max(200) }),
28
+ z.object({ phase: z.literal('match'), actions: z.array(DayPlanningActionSchema).max(30),
29
+ candidates: z.array(z.object({ actionIndex: z.number().int().min(0).max(29),
30
+ tasks: z.array(DayPlanningCandidateSchema).max(10) })).max(30) }),
31
+ ]);
32
+ export const DayPlanningReviewSchema = z.object({
33
+ text: words, extraction: DayPlanningExtractionSchema, matching: DayPlanningMatchesSchema,
34
+ });
35
+ export type DayPlanningAction = z.infer<typeof DayPlanningActionSchema>;
36
+ export type DayPlanningExtraction = z.infer<typeof DayPlanningExtractionSchema>;
37
+ export type DayPlanningMatches = z.infer<typeof DayPlanningMatchesSchema>;
38
+ export type DayPlanningContext = z.infer<typeof DayPlanningContextSchema>;
39
+ export type DayPlanningProject = z.infer<typeof DayPlanningProjectSchema>;
40
+ export type DayPlanningCandidate = z.infer<typeof DayPlanningCandidateSchema>;
41
+ export type DayPlanningReview = z.infer<typeof DayPlanningReviewSchema>;
42
+
43
+ export const dayPlanningOutputSchema = (phase: DayPlanningContext['phase']) =>
44
+ z.toJSONSchema(phase === 'extract' ? DayPlanningExtractionSchema : DayPlanningMatchesSchema, { target: 'draft-7' });
45
+
46
+ const normalized = (value: string) => value.toLowerCase().replace(/\s+/g, ' ').trim();
47
+ export function validateDayPlanningExtraction(text: string, result: DayPlanningExtraction, projects: DayPlanningProject[]) {
48
+ if (result.actions.filter((action) => action.focus).length > 1)
49
+ throw new Error('The plan needs one main focus. Please review again.');
50
+ for (const item of [...result.actions, ...result.questions]) {
51
+ if (!normalized(text).includes(normalized(item.words)))
52
+ throw new Error('The plan could not be checked against your words. Please review again.');
53
+ }
54
+ for (const action of result.actions) {
55
+ if (/^(?:and|i|then|also|so|but|today|okay|ok)[.!?]*$/i.test(action.title) ||
56
+ !/\p{L}/u.test(action.title))
57
+ throw new Error('The plan contains an unfinished thought. Please review again.');
58
+ if (action.projectId && !projects.some((project) => project.id === action.projectId))
59
+ throw new Error('A project in this plan is unavailable. Please review again.');
60
+ }
61
+ return result;
62
+ }
63
+ export function validateDayPlanningMatches(context: Extract<DayPlanningContext, { phase: 'match' }>, result: DayPlanningMatches) {
64
+ const indexes = result.matches.map((match) => match.actionIndex);
65
+ if (indexes.length !== context.actions.length || new Set(indexes).size !== indexes.length ||
66
+ indexes.some((index) => !context.actions[index]))
67
+ throw new Error('The task matches are incomplete. Please review again.');
68
+ for (const match of result.matches) {
69
+ if (!match.taskId) continue;
70
+ const action = context.actions[match.actionIndex]!;
71
+ const task = context.candidates.find((group) => group.actionIndex === match.actionIndex)?.tasks.find((item) => item.id === match.taskId);
72
+ if (!task || (action.projectId && action.projectId !== task.projectId) ||
73
+ (action.taskNumber !== null && (!action.projectId || action.taskNumber !== task.taskNumber)) || match.question)
74
+ throw new Error('A suggested task could not be verified. Please review again.');
75
+ }
76
+ return result;
77
+ }
@@ -0,0 +1,70 @@
1
+ import { z } from 'zod';
2
+
3
+ export const GITHUB_REFRESH_MS = 12 * 60 * 60 * 1000;
4
+ export const GITHUB_RETRY_MS = 15 * 60 * 1000;
5
+
6
+ export const GITHUB_CONNECT_REDIRECT = 'lucidity://github-connect';
7
+ export const GitHubConnectionSchema = z.object({
8
+ id: z.string().min(1),
9
+ login: z.string().nullable(),
10
+ source: z.enum(['github', 'clerk']),
11
+ });
12
+ export const GitHubConnectionStatusSchema = z.object({
13
+ available: z.boolean(),
14
+ connection: GitHubConnectionSchema.nullable(),
15
+ });
16
+ export const GitHubConnectStartSchema = z.object({
17
+ authorizationUrl: z.url(),
18
+ redirectUrl: z.literal(GITHUB_CONNECT_REDIRECT),
19
+ });
20
+ export const GitHubConnectCompleteSchema = z.object({
21
+ code: z.string().min(1).max(512),
22
+ state: z.string().regex(/^[A-Za-z0-9_-]{43}$/),
23
+ });
24
+ export type GitHubConnection = z.infer<typeof GitHubConnectionSchema>;
25
+
26
+ export const GitHubContributionDaySchema = z.object({
27
+ date: z.iso.date(),
28
+ contributionCount: z.number().int().nonnegative(),
29
+ contributionLevel: z.enum([
30
+ 'NONE',
31
+ 'FIRST_QUARTILE',
32
+ 'SECOND_QUARTILE',
33
+ 'THIRD_QUARTILE',
34
+ 'FOURTH_QUARTILE',
35
+ ]),
36
+ });
37
+
38
+ export const GitHubContributionSnapshotSchema = z.object({
39
+ login: z.string().regex(/^[a-z\d](?:[a-z\d-]{0,37}[a-z\d])?$/i),
40
+ fetchedAt: z.number().int().positive(),
41
+ totalContributions: z.number().int().nonnegative(),
42
+ weeks: z
43
+ .array(
44
+ z.object({
45
+ contributionDays: z.array(GitHubContributionDaySchema).min(1).max(7),
46
+ }),
47
+ )
48
+ .min(1)
49
+ .max(54),
50
+ });
51
+
52
+ export const GitHubContributionsResponseSchema = z.object({
53
+ status: z.enum([
54
+ 'ready',
55
+ 'refreshing',
56
+ 'unavailable',
57
+ 'reconnect',
58
+ 'disconnected',
59
+ ]),
60
+ snapshot: GitHubContributionSnapshotSchema.nullable(),
61
+ retryAt: z.number().int().nonnegative(),
62
+ });
63
+
64
+ export type GitHubContributionDay = z.infer<typeof GitHubContributionDaySchema>;
65
+ export type GitHubContributionSnapshot = z.infer<
66
+ typeof GitHubContributionSnapshotSchema
67
+ >;
68
+ export type GitHubContributionsResponse = z.infer<
69
+ typeof GitHubContributionsResponseSchema
70
+ >;