@opencorelabs/lucidity 0.2.0 → 0.6.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 (551) hide show
  1. package/README.md +36 -34
  2. package/bin/lucidity.js +2 -0
  3. package/dist/assets/speech/licenses/FluidAudio/LICENSE +201 -0
  4. package/dist/assets/speech/licenses/FluidAudio/ThirdPartyLicenses/fastcluster-LICENSE.md +11 -0
  5. package/dist/assets/speech/licenses/FluidAudio/ThirdPartyLicenses/vbx-LICENSE.md +201 -0
  6. package/dist/assets/speech/lucidity-speech +0 -0
  7. package/dist/automations/agent.d.ts +16 -0
  8. package/dist/automations/agent.d.ts.map +1 -0
  9. package/dist/automations/agent.js +196 -0
  10. package/dist/automations/cli.d.ts +4 -0
  11. package/dist/automations/cli.d.ts.map +1 -0
  12. package/dist/automations/cli.js +44 -0
  13. package/dist/automations/connections.d.ts +11 -0
  14. package/dist/automations/connections.d.ts.map +1 -0
  15. package/dist/automations/connections.js +74 -0
  16. package/dist/automations/designer.d.ts +39 -0
  17. package/dist/automations/designer.d.ts.map +1 -0
  18. package/dist/automations/designer.js +450 -0
  19. package/dist/automations/history.d.ts +4 -0
  20. package/dist/automations/history.d.ts.map +1 -0
  21. package/dist/automations/history.js +57 -0
  22. package/dist/automations/learning.d.ts +19 -0
  23. package/dist/automations/learning.d.ts.map +1 -0
  24. package/dist/automations/learning.js +121 -0
  25. package/dist/automations/pinterest.d.ts +21 -0
  26. package/dist/automations/pinterest.d.ts.map +1 -0
  27. package/dist/automations/pinterest.js +113 -0
  28. package/dist/automations/service.d.ts +42 -0
  29. package/dist/automations/service.d.ts.map +1 -0
  30. package/dist/automations/service.js +406 -0
  31. package/dist/automations/setup.d.ts +3 -0
  32. package/dist/automations/setup.d.ts.map +1 -0
  33. package/dist/automations/setup.js +48 -0
  34. package/dist/automations/skill.d.ts +3 -0
  35. package/dist/automations/skill.d.ts.map +1 -0
  36. package/dist/automations/skill.js +29 -0
  37. package/dist/automations/store.d.ts +13 -0
  38. package/dist/automations/store.d.ts.map +1 -0
  39. package/dist/automations/store.js +46 -0
  40. package/dist/chat/server.d.ts +2 -0
  41. package/dist/chat/server.d.ts.map +1 -1
  42. package/dist/chat/server.js +46 -2
  43. package/dist/coding/commandContext.d.ts +6 -0
  44. package/dist/coding/commandContext.d.ts.map +1 -0
  45. package/dist/coding/commandContext.js +20 -0
  46. package/dist/coding/runCodeTurn.d.ts +12 -2
  47. package/dist/coding/runCodeTurn.d.ts.map +1 -1
  48. package/dist/coding/runCodeTurn.js +49 -19
  49. package/dist/coding/worktree.d.ts +3 -4
  50. package/dist/coding/worktree.d.ts.map +1 -1
  51. package/dist/coding/worktree.js +3 -4
  52. package/dist/config.d.ts +6 -0
  53. package/dist/config.d.ts.map +1 -1
  54. package/dist/config.js +21 -3
  55. package/dist/decisions/cli.d.ts +2 -0
  56. package/dist/decisions/cli.d.ts.map +1 -0
  57. package/dist/decisions/cli.js +106 -0
  58. package/dist/decisions/client.d.ts +20 -0
  59. package/dist/decisions/client.d.ts.map +1 -0
  60. package/dist/decisions/client.js +41 -0
  61. package/dist/handoff.d.ts +11 -0
  62. package/dist/handoff.d.ts.map +1 -0
  63. package/dist/handoff.js +21 -0
  64. package/dist/index.js +190 -34
  65. package/dist/jobs/briefing.js +1 -1
  66. package/dist/jobs/extraction.d.ts.map +1 -1
  67. package/dist/jobs/extraction.js +112 -22
  68. package/dist/jobs/fastModeReview.d.ts +39 -0
  69. package/dist/jobs/fastModeReview.d.ts.map +1 -0
  70. package/dist/jobs/fastModeReview.js +192 -0
  71. package/dist/jobs/voiceReview.d.ts +24 -0
  72. package/dist/jobs/voiceReview.d.ts.map +1 -0
  73. package/dist/jobs/voiceReview.js +128 -0
  74. package/dist/mcp/clients.d.ts +26 -0
  75. package/dist/mcp/clients.d.ts.map +1 -0
  76. package/dist/mcp/clients.js +193 -0
  77. package/dist/mcp/config.d.ts +5 -2
  78. package/dist/mcp/config.d.ts.map +1 -1
  79. package/dist/mcp/config.js +48 -6
  80. package/dist/mcp/paired.d.ts +2 -0
  81. package/dist/mcp/paired.d.ts.map +1 -0
  82. package/dist/mcp/paired.js +21 -0
  83. package/dist/mcp/pairedConfig.d.ts +3 -0
  84. package/dist/mcp/pairedConfig.d.ts.map +1 -0
  85. package/dist/mcp/pairedConfig.js +33 -0
  86. package/dist/notesContext.d.ts.map +1 -1
  87. package/dist/notesContext.js +3 -2
  88. package/dist/room/client.d.ts +20 -7
  89. package/dist/room/client.d.ts.map +1 -1
  90. package/dist/room/client.js +262 -45
  91. package/dist/room/computer.d.ts.map +1 -1
  92. package/dist/room/computer.js +8 -0
  93. package/dist/room/context.d.ts +3 -2
  94. package/dist/room/context.d.ts.map +1 -1
  95. package/dist/room/context.js +10 -3
  96. package/dist/room/turnQueue.d.ts +40 -0
  97. package/dist/room/turnQueue.d.ts.map +1 -0
  98. package/dist/room/turnQueue.js +301 -0
  99. package/dist/setup/page.d.ts +3 -0
  100. package/dist/setup/page.d.ts.map +1 -0
  101. package/dist/setup/page.js +120 -0
  102. package/dist/setup/server.d.ts +26 -0
  103. package/dist/setup/server.d.ts.map +1 -0
  104. package/dist/setup/server.js +398 -0
  105. package/dist/skills/lucidity-automations/SKILL.md +54 -0
  106. package/dist/speech/captures.d.ts +30 -0
  107. package/dist/speech/captures.d.ts.map +1 -0
  108. package/dist/speech/captures.js +209 -0
  109. package/dist/speech/fluidAudio.d.ts +28 -0
  110. package/dist/speech/fluidAudio.d.ts.map +1 -0
  111. package/dist/speech/fluidAudio.js +182 -0
  112. package/dist/speech/service.d.ts +14 -0
  113. package/dist/speech/service.d.ts.map +1 -0
  114. package/dist/speech/service.js +88 -0
  115. package/dist/speech/types.d.ts +19 -0
  116. package/dist/speech/types.d.ts.map +1 -0
  117. package/dist/speech/types.js +1 -0
  118. package/dist/turnLog.d.ts +1 -0
  119. package/dist/turnLog.d.ts.map +1 -1
  120. package/dist/turnLog.js +3 -0
  121. package/native/speech/Package.resolved +15 -0
  122. package/native/speech/Package.swift +16 -0
  123. package/native/speech/Sources/lucidity-speech/Speech.swift +81 -0
  124. package/package.json +6 -2
  125. package/src/automations/agent.ts +239 -0
  126. package/src/automations/cli.ts +52 -0
  127. package/src/automations/connections.ts +83 -0
  128. package/src/automations/designer.ts +594 -0
  129. package/src/automations/history.ts +59 -0
  130. package/src/automations/learning.ts +180 -0
  131. package/src/automations/pinterest.ts +146 -0
  132. package/src/automations/service.ts +505 -0
  133. package/src/automations/setup.ts +71 -0
  134. package/src/automations/skill.ts +40 -0
  135. package/src/automations/store.ts +63 -0
  136. package/src/chat/server.ts +62 -3
  137. package/src/coding/commandContext.ts +29 -0
  138. package/src/coding/runCodeTurn.ts +65 -21
  139. package/src/coding/worktree.ts +3 -4
  140. package/src/config.ts +32 -2
  141. package/src/decisions/cli.ts +136 -0
  142. package/src/decisions/client.ts +62 -0
  143. package/src/handoff.ts +28 -0
  144. package/src/index.ts +204 -58
  145. package/src/jobs/briefing.ts +1 -1
  146. package/src/jobs/extraction.ts +157 -32
  147. package/src/jobs/fastModeReview.ts +221 -0
  148. package/src/jobs/voiceReview.ts +156 -0
  149. package/src/mcp/clients.ts +269 -0
  150. package/src/mcp/config.ts +58 -7
  151. package/src/mcp/paired.ts +23 -0
  152. package/src/mcp/pairedConfig.ts +44 -0
  153. package/src/notesContext.ts +3 -2
  154. package/src/room/client.ts +316 -52
  155. package/src/room/computer.ts +8 -0
  156. package/src/room/context.ts +12 -3
  157. package/src/room/turnQueue.ts +358 -0
  158. package/src/setup/page.ts +122 -0
  159. package/src/setup/server.ts +483 -0
  160. package/src/speech/captures.ts +265 -0
  161. package/src/speech/fluidAudio.ts +242 -0
  162. package/src/speech/service.ts +108 -0
  163. package/src/speech/types.ts +13 -0
  164. package/src/turnLog.ts +4 -0
  165. package/vendor/decisions/LICENSE +662 -0
  166. package/vendor/decisions/dist/capture.d.ts +79 -0
  167. package/vendor/decisions/dist/capture.js +183 -0
  168. package/vendor/decisions/dist/command.d.ts +202 -0
  169. package/vendor/decisions/dist/command.js +750 -0
  170. package/vendor/decisions/dist/gate.d.ts +12 -0
  171. package/vendor/decisions/dist/gate.js +18 -0
  172. package/vendor/decisions/dist/index.d.ts +5 -0
  173. package/vendor/decisions/dist/index.js +5 -0
  174. package/vendor/decisions/dist/jev.d.ts +15 -0
  175. package/vendor/decisions/dist/jev.js +242 -0
  176. package/vendor/decisions/dist/types.d.ts +67 -0
  177. package/vendor/decisions/dist/types.js +1 -0
  178. package/vendor/decisions/package.json +22 -0
  179. package/vendor/decisions/src/capture.ts +199 -0
  180. package/vendor/decisions/src/command.ts +836 -0
  181. package/vendor/decisions/src/gate.ts +32 -0
  182. package/vendor/decisions/src/index.ts +5 -0
  183. package/vendor/decisions/src/jev.ts +293 -0
  184. package/vendor/decisions/src/types.ts +79 -0
  185. package/vendor/mcp-server/README.md +130 -48
  186. package/vendor/mcp-server/dist/client.d.ts +1 -0
  187. package/vendor/mcp-server/dist/client.d.ts.map +1 -1
  188. package/vendor/mcp-server/dist/client.js +8 -0
  189. package/vendor/mcp-server/dist/commentProvider.d.ts +3 -0
  190. package/vendor/mcp-server/dist/commentProvider.d.ts.map +1 -0
  191. package/vendor/mcp-server/dist/commentProvider.js +10 -0
  192. package/vendor/mcp-server/dist/index.js +26 -5
  193. package/vendor/mcp-server/dist/tools/automations.d.ts +6 -0
  194. package/vendor/mcp-server/dist/tools/automations.d.ts.map +1 -0
  195. package/vendor/mcp-server/dist/tools/automations.js +163 -0
  196. package/vendor/mcp-server/dist/tools/commandEventFormat.d.ts +52 -0
  197. package/vendor/mcp-server/dist/tools/commandEventFormat.d.ts.map +1 -0
  198. package/vendor/mcp-server/dist/tools/commandEventFormat.js +83 -0
  199. package/vendor/mcp-server/dist/tools/commandEvents.d.ts +3 -0
  200. package/vendor/mcp-server/dist/tools/commandEvents.d.ts.map +1 -0
  201. package/vendor/mcp-server/dist/tools/commandEvents.js +21 -0
  202. package/vendor/mcp-server/dist/tools/comments.d.ts.map +1 -1
  203. package/vendor/mcp-server/dist/tools/comments.js +41 -5
  204. package/vendor/mcp-server/dist/tools/index.d.ts +2 -0
  205. package/vendor/mcp-server/dist/tools/index.d.ts.map +1 -1
  206. package/vendor/mcp-server/dist/tools/index.js +2 -0
  207. package/vendor/mcp-server/dist/tools/journal.d.ts +3 -0
  208. package/vendor/mcp-server/dist/tools/journal.d.ts.map +1 -0
  209. package/vendor/mcp-server/dist/tools/journal.js +131 -0
  210. package/vendor/mcp-server/dist/tools/memory.d.ts +2 -2
  211. package/vendor/mcp-server/dist/tools/memory.d.ts.map +1 -1
  212. package/vendor/mcp-server/dist/tools/memory.js +24 -14
  213. package/vendor/mcp-server/dist/tools/milestones.d.ts.map +1 -1
  214. package/vendor/mcp-server/dist/tools/milestones.js +30 -0
  215. package/vendor/mcp-server/dist/tools/notes.d.ts.map +1 -1
  216. package/vendor/mcp-server/dist/tools/notes.js +30 -5
  217. package/vendor/mcp-server/dist/tools/projects.d.ts.map +1 -1
  218. package/vendor/mcp-server/dist/tools/projects.js +15 -0
  219. package/vendor/mcp-server/dist/tools/queries.d.ts.map +1 -1
  220. package/vendor/mcp-server/dist/tools/queries.js +27 -2
  221. package/vendor/mcp-server/dist/tools/taskActivity.d.ts +3 -0
  222. package/vendor/mcp-server/dist/tools/taskActivity.d.ts.map +1 -0
  223. package/vendor/mcp-server/dist/tools/taskActivity.js +32 -0
  224. package/vendor/mcp-server/dist/tools/taskOccurrences.d.ts +3 -0
  225. package/vendor/mcp-server/dist/tools/taskOccurrences.d.ts.map +1 -0
  226. package/vendor/mcp-server/dist/tools/taskOccurrences.js +12 -0
  227. package/vendor/mcp-server/dist/tools/taskTrash.d.ts +3 -0
  228. package/vendor/mcp-server/dist/tools/taskTrash.d.ts.map +1 -0
  229. package/vendor/mcp-server/dist/tools/taskTrash.js +21 -0
  230. package/vendor/mcp-server/dist/tools/tasks.d.ts.map +1 -1
  231. package/vendor/mcp-server/dist/tools/tasks.js +99 -22
  232. package/vendor/mcp-server/package.json +5 -1
  233. package/vendor/mcp-server/src/client.ts +10 -0
  234. package/vendor/mcp-server/src/commentProvider.ts +9 -0
  235. package/vendor/mcp-server/src/index.ts +33 -6
  236. package/vendor/mcp-server/src/tools/automations.ts +199 -0
  237. package/vendor/mcp-server/src/tools/commandEventFormat.ts +108 -0
  238. package/vendor/mcp-server/src/tools/commandEvents.ts +27 -0
  239. package/vendor/mcp-server/src/tools/comments.ts +43 -4
  240. package/vendor/mcp-server/src/tools/index.ts +2 -0
  241. package/vendor/mcp-server/src/tools/journal.ts +168 -0
  242. package/vendor/mcp-server/src/tools/memory.ts +26 -12
  243. package/vendor/mcp-server/src/tools/milestones.ts +36 -0
  244. package/vendor/mcp-server/src/tools/notes.ts +35 -4
  245. package/vendor/mcp-server/src/tools/projects.ts +18 -0
  246. package/vendor/mcp-server/src/tools/queries.ts +30 -0
  247. package/vendor/mcp-server/src/tools/taskActivity.ts +55 -0
  248. package/vendor/mcp-server/src/tools/taskOccurrences.ts +26 -0
  249. package/vendor/mcp-server/src/tools/taskTrash.ts +23 -0
  250. package/vendor/mcp-server/src/tools/tasks.ts +104 -24
  251. package/vendor/notes/dist/index.d.ts +2 -0
  252. package/vendor/notes/dist/index.d.ts.map +1 -1
  253. package/vendor/notes/dist/index.js +2 -0
  254. package/vendor/notes/dist/journal-backend.d.ts +4 -0
  255. package/vendor/notes/dist/journal-backend.d.ts.map +1 -0
  256. package/vendor/notes/dist/journal-backend.js +33 -0
  257. package/vendor/notes/dist/journal.d.ts +7 -0
  258. package/vendor/notes/dist/journal.d.ts.map +1 -0
  259. package/vendor/notes/dist/journal.js +173 -0
  260. package/vendor/notes/dist/vault.d.ts.map +1 -1
  261. package/vendor/notes/dist/vault.js +6 -1
  262. package/vendor/notes/src/index.ts +2 -0
  263. package/vendor/notes/src/journal-backend.ts +53 -0
  264. package/vendor/notes/src/journal.ts +194 -0
  265. package/vendor/notes/src/vault.ts +9 -1
  266. package/vendor/runtime/README.md +4 -0
  267. package/vendor/runtime/dist/executor/claudeAgent.d.ts +2 -0
  268. package/vendor/runtime/dist/executor/claudeAgent.d.ts.map +1 -1
  269. package/vendor/runtime/dist/executor/claudeAgent.js +113 -8
  270. package/vendor/runtime/dist/executor/claudeCode.d.ts.map +1 -1
  271. package/vendor/runtime/dist/executor/claudeCode.js +8 -4
  272. package/vendor/runtime/dist/executor/codex.d.ts +2 -0
  273. package/vendor/runtime/dist/executor/codex.d.ts.map +1 -1
  274. package/vendor/runtime/dist/executor/codex.js +213 -11
  275. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts +2 -0
  276. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts.map +1 -0
  277. package/vendor/runtime/dist/executor/codexProtocol/PlanType.js +2 -0
  278. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.d.ts +6 -0
  279. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.d.ts.map +1 -0
  280. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.js +2 -0
  281. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts +26 -0
  282. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts.map +1 -0
  283. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.js +2 -0
  284. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.d.ts +2 -0
  285. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.d.ts.map +1 -0
  286. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.js +2 -0
  287. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.d.ts +27 -0
  288. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.d.ts.map +1 -0
  289. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.js +2 -0
  290. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.d.ts +2 -0
  291. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.d.ts.map +1 -0
  292. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.js +2 -0
  293. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.d.ts +13 -0
  294. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.d.ts.map +1 -0
  295. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.js +2 -0
  296. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.d.ts +2 -0
  297. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.d.ts.map +1 -0
  298. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.js +2 -0
  299. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts +20 -0
  300. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts.map +1 -0
  301. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.js +2 -0
  302. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.d.ts +6 -0
  303. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.d.ts.map +1 -0
  304. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.js +2 -0
  305. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.d.ts +2 -0
  306. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.d.ts.map +1 -0
  307. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.js +2 -0
  308. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts +12 -0
  309. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts.map +1 -0
  310. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.js +2 -0
  311. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.d.ts +17 -0
  312. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.d.ts.map +1 -0
  313. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.js +2 -0
  314. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.d.ts +5 -0
  315. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.d.ts.map +1 -0
  316. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.js +2 -0
  317. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.d.ts +5 -0
  318. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.d.ts.map +1 -0
  319. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.js +2 -0
  320. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.d.ts +18 -0
  321. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.d.ts.map +1 -0
  322. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.js +2 -0
  323. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.d.ts +22 -0
  324. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.d.ts.map +1 -0
  325. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.js +2 -0
  326. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.d.ts +2 -0
  327. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.d.ts.map +1 -0
  328. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.js +2 -0
  329. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.d.ts +9 -0
  330. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.d.ts.map +1 -0
  331. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.js +2 -0
  332. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.d.ts +8 -0
  333. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.d.ts.map +1 -0
  334. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.js +2 -0
  335. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.d.ts +5 -0
  336. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.d.ts.map +1 -0
  337. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.js +2 -0
  338. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.d.ts +7 -0
  339. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.d.ts.map +1 -0
  340. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.js +2 -0
  341. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.d.ts +5 -0
  342. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.d.ts.map +1 -0
  343. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.js +2 -0
  344. package/vendor/runtime/dist/executor/health.d.ts +1 -0
  345. package/vendor/runtime/dist/executor/health.d.ts.map +1 -1
  346. package/vendor/runtime/dist/executor/health.js +3 -0
  347. package/vendor/runtime/dist/executor/liveTurns.d.ts.map +1 -1
  348. package/vendor/runtime/dist/executor/liveTurns.js +3 -0
  349. package/vendor/runtime/dist/executor/providerRouter.d.ts.map +1 -1
  350. package/vendor/runtime/dist/executor/providerRouter.js +2 -1
  351. package/vendor/runtime/dist/executor/types.d.ts +8 -0
  352. package/vendor/runtime/dist/executor/types.d.ts.map +1 -1
  353. package/vendor/runtime/dist/harness/index.d.ts +1 -0
  354. package/vendor/runtime/dist/harness/index.d.ts.map +1 -1
  355. package/vendor/runtime/dist/harness/index.js +35 -1
  356. package/vendor/runtime/dist/harness/types.d.ts +4 -1
  357. package/vendor/runtime/dist/harness/types.d.ts.map +1 -1
  358. package/vendor/runtime/dist/index.d.ts +2 -1
  359. package/vendor/runtime/dist/index.d.ts.map +1 -1
  360. package/vendor/runtime/dist/index.js +2 -0
  361. package/vendor/runtime/dist/journal/context.d.ts +18 -0
  362. package/vendor/runtime/dist/journal/context.d.ts.map +1 -1
  363. package/vendor/runtime/dist/journal/context.js +19 -5
  364. package/vendor/runtime/dist/prompts/briefing.d.ts +4 -7
  365. package/vendor/runtime/dist/prompts/briefing.d.ts.map +1 -1
  366. package/vendor/runtime/dist/prompts/briefing.js +61 -12
  367. package/vendor/runtime/dist/prompts/cardStatement.d.ts +7 -0
  368. package/vendor/runtime/dist/prompts/cardStatement.d.ts.map +1 -0
  369. package/vendor/runtime/dist/prompts/cardStatement.js +52 -0
  370. package/vendor/runtime/dist/prompts/chat.d.ts +1 -0
  371. package/vendor/runtime/dist/prompts/chat.d.ts.map +1 -1
  372. package/vendor/runtime/dist/prompts/chat.js +15 -1
  373. package/vendor/runtime/dist/prompts/projectCapture.d.ts +7 -0
  374. package/vendor/runtime/dist/prompts/projectCapture.d.ts.map +1 -0
  375. package/vendor/runtime/dist/prompts/projectCapture.js +31 -0
  376. package/vendor/runtime/src/executor/claudeAgent.ts +133 -7
  377. package/vendor/runtime/src/executor/claudeCode.ts +6 -4
  378. package/vendor/runtime/src/executor/codex.ts +280 -20
  379. package/vendor/runtime/src/executor/codexProtocol/PlanType.ts +5 -0
  380. package/vendor/runtime/src/executor/codexProtocol/v2/CreditsSnapshot.ts +5 -0
  381. package/vendor/runtime/src/executor/codexProtocol/v2/GetAccountRateLimitsResponse.ts +25 -0
  382. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitReachedType.ts +5 -0
  383. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCredit.ts +27 -0
  384. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCreditStatus.ts +5 -0
  385. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCreditsSummary.ts +14 -0
  386. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetType.ts +5 -0
  387. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitSnapshot.ts +14 -0
  388. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitWindow.ts +5 -0
  389. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewDelivery.ts +5 -0
  390. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewStartParams.ts +12 -0
  391. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewTarget.ts +9 -0
  392. package/vendor/runtime/src/executor/codexProtocol/v2/SkillDependencies.ts +6 -0
  393. package/vendor/runtime/src/executor/codexProtocol/v2/SkillErrorInfo.ts +5 -0
  394. package/vendor/runtime/src/executor/codexProtocol/v2/SkillInterface.ts +14 -0
  395. package/vendor/runtime/src/executor/codexProtocol/v2/SkillMetadata.ts +17 -0
  396. package/vendor/runtime/src/executor/codexProtocol/v2/SkillScope.ts +5 -0
  397. package/vendor/runtime/src/executor/codexProtocol/v2/SkillToolDependency.ts +5 -0
  398. package/vendor/runtime/src/executor/codexProtocol/v2/SkillsListEntry.ts +7 -0
  399. package/vendor/runtime/src/executor/codexProtocol/v2/SkillsListResponse.ts +6 -0
  400. package/vendor/runtime/src/executor/codexProtocol/v2/SpendControlLimitSnapshot.ts +5 -0
  401. package/vendor/runtime/src/executor/codexProtocol/v2/ThreadSetNameParams.ts +5 -0
  402. package/vendor/runtime/src/executor/health.ts +3 -0
  403. package/vendor/runtime/src/executor/liveTurns.ts +3 -0
  404. package/vendor/runtime/src/executor/providerRouter.ts +2 -1
  405. package/vendor/runtime/src/executor/types.ts +8 -0
  406. package/vendor/runtime/src/harness/index.ts +40 -6
  407. package/vendor/runtime/src/harness/types.ts +4 -1
  408. package/vendor/runtime/src/index.ts +4 -1
  409. package/vendor/runtime/src/journal/context.ts +40 -7
  410. package/vendor/runtime/src/prompts/briefing.ts +62 -17
  411. package/vendor/runtime/src/prompts/cardStatement.ts +64 -0
  412. package/vendor/runtime/src/prompts/chat.ts +25 -3
  413. package/vendor/runtime/src/prompts/projectCapture.ts +51 -0
  414. package/vendor/shared/dist/agentCommands.d.ts +22 -0
  415. package/vendor/shared/dist/agentCommands.d.ts.map +1 -0
  416. package/vendor/shared/dist/agentCommands.js +11 -0
  417. package/vendor/shared/dist/automationTemplates.d.ts +37 -0
  418. package/vendor/shared/dist/automationTemplates.d.ts.map +1 -0
  419. package/vendor/shared/dist/automationTemplates.js +48 -0
  420. package/vendor/shared/dist/automations.d.ts +1052 -0
  421. package/vendor/shared/dist/automations.d.ts.map +1 -0
  422. package/vendor/shared/dist/automations.js +300 -0
  423. package/vendor/shared/dist/brandArtwork.d.ts +4 -0
  424. package/vendor/shared/dist/brandArtwork.d.ts.map +1 -0
  425. package/vendor/shared/dist/brandArtwork.js +7 -0
  426. package/vendor/shared/dist/cardStatement.d.ts +28 -0
  427. package/vendor/shared/dist/cardStatement.d.ts.map +1 -0
  428. package/vendor/shared/dist/cardStatement.js +37 -0
  429. package/vendor/shared/dist/cardStudio.d.ts +756 -0
  430. package/vendor/shared/dist/cardStudio.d.ts.map +1 -0
  431. package/vendor/shared/dist/cardStudio.js +297 -0
  432. package/vendor/shared/dist/commandLocal.d.ts +218 -0
  433. package/vendor/shared/dist/commandLocal.d.ts.map +1 -0
  434. package/vendor/shared/dist/commandLocal.js +662 -0
  435. package/vendor/shared/dist/commandText.d.ts +12 -0
  436. package/vendor/shared/dist/commandText.d.ts.map +1 -0
  437. package/vendor/shared/dist/commandText.js +21 -0
  438. package/vendor/shared/dist/commands.d.ts +1516 -0
  439. package/vendor/shared/dist/commands.d.ts.map +1 -0
  440. package/vendor/shared/dist/commands.js +231 -0
  441. package/vendor/shared/dist/computer.d.ts +9 -9
  442. package/vendor/shared/dist/computer.d.ts.map +1 -1
  443. package/vendor/shared/dist/computer.js +11 -2
  444. package/vendor/shared/dist/constants.d.ts +3 -3
  445. package/vendor/shared/dist/constants.d.ts.map +1 -1
  446. package/vendor/shared/dist/constants.js +9 -2
  447. package/vendor/shared/dist/githubContributions.d.ts +93 -0
  448. package/vendor/shared/dist/githubContributions.d.ts.map +1 -0
  449. package/vendor/shared/dist/githubContributions.js +54 -0
  450. package/vendor/shared/dist/habitContributions.d.ts +26 -0
  451. package/vendor/shared/dist/habitContributions.d.ts.map +1 -0
  452. package/vendor/shared/dist/habitContributions.js +119 -0
  453. package/vendor/shared/dist/index.d.ts +26 -1
  454. package/vendor/shared/dist/index.d.ts.map +1 -1
  455. package/vendor/shared/dist/index.js +23 -1
  456. package/vendor/shared/dist/journal-migration.d.ts +29 -0
  457. package/vendor/shared/dist/journal-migration.d.ts.map +1 -0
  458. package/vendor/shared/dist/journal-migration.js +73 -0
  459. package/vendor/shared/dist/journal-vault.d.ts +414 -0
  460. package/vendor/shared/dist/journal-vault.d.ts.map +1 -0
  461. package/vendor/shared/dist/journal-vault.js +972 -0
  462. package/vendor/shared/dist/projectCapture.d.ts +73 -0
  463. package/vendor/shared/dist/projectCapture.d.ts.map +1 -0
  464. package/vendor/shared/dist/projectCapture.js +66 -0
  465. package/vendor/shared/dist/quickAdd.d.ts +90 -0
  466. package/vendor/shared/dist/quickAdd.d.ts.map +1 -0
  467. package/vendor/shared/dist/quickAdd.js +260 -0
  468. package/vendor/shared/dist/recurrence.d.ts +44 -0
  469. package/vendor/shared/dist/recurrence.d.ts.map +1 -0
  470. package/vendor/shared/dist/recurrence.js +37 -0
  471. package/vendor/shared/dist/reminderWords.d.ts +11 -0
  472. package/vendor/shared/dist/reminderWords.d.ts.map +1 -0
  473. package/vendor/shared/dist/reminderWords.js +63 -0
  474. package/vendor/shared/dist/schemas/comment.d.ts +13 -1
  475. package/vendor/shared/dist/schemas/comment.d.ts.map +1 -1
  476. package/vendor/shared/dist/schemas/comment.js +5 -0
  477. package/vendor/shared/dist/schemas/conversation.d.ts +3 -3
  478. package/vendor/shared/dist/schemas/harness.d.ts +922 -59
  479. package/vendor/shared/dist/schemas/harness.d.ts.map +1 -1
  480. package/vendor/shared/dist/schemas/harness.js +122 -3
  481. package/vendor/shared/dist/schemas/journal.d.ts +10 -0
  482. package/vendor/shared/dist/schemas/journal.d.ts.map +1 -1
  483. package/vendor/shared/dist/schemas/journal.js +10 -2
  484. package/vendor/shared/dist/schemas/notification.d.ts +1 -1
  485. package/vendor/shared/dist/schemas/organization.d.ts +3 -2
  486. package/vendor/shared/dist/schemas/organization.d.ts.map +1 -1
  487. package/vendor/shared/dist/schemas/organization.js +3 -2
  488. package/vendor/shared/dist/schemas/proposal.d.ts +7 -3
  489. package/vendor/shared/dist/schemas/proposal.d.ts.map +1 -1
  490. package/vendor/shared/dist/schemas/proposal.js +2 -1
  491. package/vendor/shared/dist/schemas/request.d.ts +44 -4
  492. package/vendor/shared/dist/schemas/request.d.ts.map +1 -1
  493. package/vendor/shared/dist/schemas/task.d.ts +83 -8
  494. package/vendor/shared/dist/schemas/task.d.ts.map +1 -1
  495. package/vendor/shared/dist/schemas/task.js +20 -2
  496. package/vendor/shared/dist/schemas/timeSession.d.ts +2 -2
  497. package/vendor/shared/dist/setupAppearance.d.ts +6 -0
  498. package/vendor/shared/dist/setupAppearance.d.ts.map +1 -0
  499. package/vendor/shared/dist/setupAppearance.js +17 -0
  500. package/vendor/shared/dist/smartCapture.d.ts +60 -0
  501. package/vendor/shared/dist/smartCapture.d.ts.map +1 -0
  502. package/vendor/shared/dist/smartCapture.js +56 -0
  503. package/vendor/shared/dist/speech.d.ts +39 -0
  504. package/vendor/shared/dist/speech.d.ts.map +1 -0
  505. package/vendor/shared/dist/speech.js +36 -0
  506. package/vendor/shared/dist/spokenNames.d.ts +25 -0
  507. package/vendor/shared/dist/spokenNames.d.ts.map +1 -0
  508. package/vendor/shared/dist/spokenNames.js +120 -0
  509. package/vendor/shared/dist/taskActivity.d.ts +76 -0
  510. package/vendor/shared/dist/taskActivity.d.ts.map +1 -0
  511. package/vendor/shared/dist/taskActivity.js +27 -0
  512. package/vendor/shared/dist/vault-search.d.ts +50 -0
  513. package/vendor/shared/dist/vault-search.d.ts.map +1 -0
  514. package/vendor/shared/dist/vault-search.js +177 -0
  515. package/vendor/shared/dist/voiceCapture.d.ts +32 -0
  516. package/vendor/shared/dist/voiceCapture.d.ts.map +1 -0
  517. package/vendor/shared/dist/voiceCapture.js +29 -0
  518. package/vendor/shared/package.json +4 -0
  519. package/vendor/shared/src/agentCommands.ts +35 -0
  520. package/vendor/shared/src/automationTemplates.ts +54 -0
  521. package/vendor/shared/src/automations.ts +329 -0
  522. package/vendor/shared/src/brandArtwork.ts +7 -0
  523. package/vendor/shared/src/cardStatement.ts +49 -0
  524. package/vendor/shared/src/cardStudio.ts +340 -0
  525. package/vendor/shared/src/commandLocal.ts +738 -0
  526. package/vendor/shared/src/commandText.ts +25 -0
  527. package/vendor/shared/src/commands.ts +253 -0
  528. package/vendor/shared/src/computer.ts +23 -6
  529. package/vendor/shared/src/constants.ts +9 -2
  530. package/vendor/shared/src/githubContributions.ts +70 -0
  531. package/vendor/shared/src/habitContributions.ts +144 -0
  532. package/vendor/shared/src/index.ts +42 -0
  533. package/vendor/shared/src/journal-migration.ts +130 -0
  534. package/vendor/shared/src/journal-vault.ts +1240 -0
  535. package/vendor/shared/src/projectCapture.ts +86 -0
  536. package/vendor/shared/src/quickAdd.ts +310 -0
  537. package/vendor/shared/src/recurrence.ts +37 -0
  538. package/vendor/shared/src/reminderWords.ts +54 -0
  539. package/vendor/shared/src/schemas/comment.ts +5 -0
  540. package/vendor/shared/src/schemas/harness.ts +144 -7
  541. package/vendor/shared/src/schemas/journal.ts +15 -6
  542. package/vendor/shared/src/schemas/organization.ts +3 -2
  543. package/vendor/shared/src/schemas/proposal.ts +6 -1
  544. package/vendor/shared/src/schemas/task.ts +20 -2
  545. package/vendor/shared/src/setupAppearance.ts +32 -0
  546. package/vendor/shared/src/smartCapture.ts +67 -0
  547. package/vendor/shared/src/speech.ts +44 -0
  548. package/vendor/shared/src/spokenNames.ts +128 -0
  549. package/vendor/shared/src/taskActivity.ts +34 -0
  550. package/vendor/shared/src/vault-search.ts +243 -0
  551. package/vendor/shared/src/voiceCapture.ts +34 -0
@@ -0,0 +1,398 @@
1
+ import { createServer, } from 'node:http';
2
+ import { randomBytes, createHash, timingSafeEqual } from 'node:crypto';
3
+ import { hostname } from 'node:os';
4
+ import { mkdirSync, readFileSync, writeFileSync, existsSync, unlinkSync, linkSync, chmodSync, } from 'node:fs';
5
+ import { join } from 'node:path';
6
+ import { spawn } from 'node:child_process';
7
+ import { z } from 'zod';
8
+ import { ClaudeAgentExecutor, CodexExecutor, providerFailure, } from '@lucidity/runtime';
9
+ import { CONFIG_DIR } from '../config.js';
10
+ import { localSetupPage } from './page.js';
11
+ import { createClientSetup, CLIENT_IDS, } from '../mcp/clients.js';
12
+ const clientChoices = z.array(z.enum(CLIENT_IDS)).max(2).default([]);
13
+ const sha = (s) => createHash('sha256').update(s).digest('hex');
14
+ const pendingSchema = z.object({
15
+ id: z.string().uuid(),
16
+ code: z.string().regex(/^[A-F0-9]{24}$/),
17
+ expiresAt: z.string().datetime(),
18
+ secret: z.string().regex(/^[a-f0-9]{64}$/),
19
+ key: z.string().regex(/^luc_pc_[a-f0-9]{64}$/),
20
+ apiUrl: z.string().url(),
21
+ name: z.string().min(1).max(120),
22
+ });
23
+ export function setupApiUrl(value) {
24
+ const url = new URL(value);
25
+ if (url.username ||
26
+ url.password ||
27
+ url.search ||
28
+ url.hash ||
29
+ (url.pathname !== '/' && url.pathname !== ''))
30
+ throw new Error('Use the API origin without a path or credentials.');
31
+ if (url.protocol !== 'https:' &&
32
+ !(url.protocol === 'http:' &&
33
+ ['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname)))
34
+ throw new Error('Setup requires HTTPS, except for a local development API.');
35
+ return url.origin;
36
+ }
37
+ export function writeNewSetupConfig(dir, config) {
38
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
39
+ const temporary = join(dir, `.setup-${randomBytes(8).toString('hex')}.json`);
40
+ writeFileSync(temporary, JSON.stringify(config, null, 2) + '\n', {
41
+ flag: 'wx',
42
+ mode: 0o600,
43
+ });
44
+ try {
45
+ linkSync(temporary, join(dir, 'config.json'));
46
+ }
47
+ finally {
48
+ unlinkSync(temporary);
49
+ }
50
+ }
51
+ function acquireSetupLock(dir) {
52
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
53
+ const path = join(dir, 'setup.lock');
54
+ if (existsSync(path)) {
55
+ const pid = Number(readFileSync(path, 'utf8'));
56
+ if (!Number.isInteger(pid) || pid < 1)
57
+ throw new Error('The saved setup lock is invalid. Your configuration has not been changed.');
58
+ let alive = true;
59
+ try {
60
+ process.kill(pid, 0);
61
+ }
62
+ catch (e) {
63
+ if (e.code === 'ESRCH')
64
+ alive = false;
65
+ }
66
+ if (alive)
67
+ throw new Error('Setup is already open for this computer. Return to its browser window.');
68
+ unlinkSync(path);
69
+ }
70
+ writeFileSync(path, String(process.pid), { flag: 'wx', mode: 0o600 });
71
+ return () => {
72
+ if (existsSync(path) && readFileSync(path, 'utf8') === String(process.pid))
73
+ unlinkSync(path);
74
+ };
75
+ }
76
+ export async function checkSetupProviders() {
77
+ return Promise.all(['claude', 'codex'].map(async (id) => {
78
+ const executor = id === 'claude' ? new ClaudeAgentExecutor() : new CodexExecutor();
79
+ try {
80
+ await executor.models();
81
+ return {
82
+ id,
83
+ label: id === 'claude' ? 'Claude' : 'Codex',
84
+ auth: 'authenticated',
85
+ message: '',
86
+ };
87
+ }
88
+ catch (e) {
89
+ const health = providerFailure(e);
90
+ return {
91
+ id,
92
+ label: id === 'claude' ? 'Claude' : 'Codex',
93
+ auth: health.auth === 'authenticated' ? 'unknown' : health.auth,
94
+ message: health.problem === 'login'
95
+ ? id === 'claude'
96
+ ? 'Sign in with Claude Code on this computer, then check again.'
97
+ : 'Run codex login on this computer, then check again.'
98
+ : 'Could not check this provider. Confirm it is installed and your network is available, then check again.',
99
+ };
100
+ }
101
+ finally {
102
+ await executor.dispose();
103
+ }
104
+ }));
105
+ }
106
+ export async function createSetupServer(options = {}) {
107
+ const apiUrl = setupApiUrl(options.apiUrl ?? process.env.LUCIDITY_API_URL ?? 'https://api.lucidity.my');
108
+ const dir = options.directory ?? CONFIG_DIR;
109
+ const pendingPath = join(dir, 'setup-pending.json');
110
+ const configPath = join(dir, 'config.json');
111
+ const clients = options.clients ?? createClientSetup({ configPath });
112
+ const token = randomBytes(32).toString('hex');
113
+ const nonce = randomBytes(18).toString('base64');
114
+ let pending;
115
+ let finished = false;
116
+ let mutation = false;
117
+ let providerCheck;
118
+ if (!existsSync(configPath) && existsSync(pendingPath)) {
119
+ const parsed = pendingSchema.safeParse(JSON.parse(readFileSync(pendingPath, 'utf8')));
120
+ if (!parsed.success)
121
+ throw new Error('Saved setup is invalid. Your existing configuration has not been changed.');
122
+ if (parsed.data.apiUrl !== apiUrl)
123
+ throw new Error('A connection is pending for a different Lucidity server. Finish or cancel it using that server before starting again.');
124
+ pending = parsed.data;
125
+ }
126
+ const api = async (path, body) => {
127
+ const response = await (options.fetch ?? fetch)(apiUrl + '/api/auth/computers/' + path, {
128
+ method: 'POST',
129
+ headers: { 'Content-Type': 'application/json' },
130
+ body: JSON.stringify(body),
131
+ signal: AbortSignal.timeout(15000),
132
+ redirect: 'error',
133
+ });
134
+ const value = await response.json().catch(() => ({}));
135
+ if (!response.ok)
136
+ throw new Error(response.status === 404
137
+ ? 'This Lucidity server does not support guided setup yet. Update the server before trying again.'
138
+ : typeof value.error === 'string'
139
+ ? value.error
140
+ : 'Lucidity could not be reached. Check your connection and try again.');
141
+ return value;
142
+ };
143
+ const publicState = () => pending
144
+ ? {
145
+ name: pending.name,
146
+ code: pending.code,
147
+ approvalUrl: (apiUrl === 'https://api.lucidity.my'
148
+ ? 'https://lucidity.my'
149
+ : apiUrl) +
150
+ '/connect-computer#code=' +
151
+ pending.code,
152
+ }
153
+ : {};
154
+ const removePending = () => {
155
+ if (existsSync(pendingPath))
156
+ unlinkSync(pendingPath);
157
+ pending = undefined;
158
+ };
159
+ async function body(req) {
160
+ const chunks = [];
161
+ let size = 0;
162
+ for await (const chunk of req) {
163
+ size += chunk.length;
164
+ if (size > 2048)
165
+ throw new Error('Request too large.');
166
+ chunks.push(chunk);
167
+ }
168
+ return JSON.parse(Buffer.concat(chunks).toString('utf8'));
169
+ }
170
+ const send = (res, status, value) => {
171
+ res.writeHead(status, { 'Content-Type': 'application/json' });
172
+ res.end(JSON.stringify(value));
173
+ };
174
+ let origin = '';
175
+ const releaseLock = acquireSetupLock(dir);
176
+ const server = createServer(async (req, res) => {
177
+ res.setHeader('Cache-Control', 'no-store');
178
+ res.setHeader('Referrer-Policy', 'no-referrer');
179
+ res.setHeader('X-Content-Type-Options', 'nosniff');
180
+ res.setHeader('Content-Security-Policy', `default-src 'none'; script-src 'nonce-${nonce}'; style-src 'unsafe-inline'; img-src data:; connect-src 'self'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'`);
181
+ if (req.headers.host !== new URL(origin).host)
182
+ return send(res, 403, { error: 'Unrecognized setup host.' });
183
+ if (req.method === 'GET' && req.url === '/') {
184
+ res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
185
+ res.end(localSetupPage(nonce));
186
+ return;
187
+ }
188
+ const provided = req.headers['x-setup-token'];
189
+ if (req.method !== 'POST' ||
190
+ req.headers.origin !== origin ||
191
+ req.headers['content-type'] !== 'application/json' ||
192
+ typeof provided !== 'string' ||
193
+ !/^[a-f0-9]{64}$/.test(provided) ||
194
+ !timingSafeEqual(Buffer.from(provided), Buffer.from(token)))
195
+ return send(res, 403, {
196
+ error: 'This setup session is unavailable. Run lucidity setup again.',
197
+ });
198
+ try {
199
+ const input = await body(req);
200
+ if (finished)
201
+ return send(res, 409, { error: 'Setup has finished.' });
202
+ if (req.url === '/api/state')
203
+ return send(res, 200, {
204
+ existing: existsSync(configPath),
205
+ ...publicState(),
206
+ });
207
+ if (req.url === '/api/poll') {
208
+ if (!pending)
209
+ throw new Error('Start a connection first.');
210
+ return send(res, 200, await api('poll', { id: pending.id, secret: pending.secret }));
211
+ }
212
+ if (req.url === '/api/providers') {
213
+ providerCheck ??= (options.providers ?? checkSetupProviders)().finally(() => {
214
+ providerCheck = undefined;
215
+ });
216
+ return send(res, 200, { providers: await providerCheck });
217
+ }
218
+ if (req.url === '/api/clients')
219
+ return send(res, 200, { clients: await clients.inspect() });
220
+ if (mutation)
221
+ return send(res, 409, { error: 'A setup step is already running.' });
222
+ mutation = true;
223
+ try {
224
+ if (req.url === '/api/configure-clients') {
225
+ if (!existsSync(configPath))
226
+ throw new Error('Finish connecting your account first.');
227
+ const selected = z
228
+ .object({ clients: clientChoices })
229
+ .parse(input).clients;
230
+ return send(res, 200, { clients: await clients.configure(selected) });
231
+ }
232
+ if (req.url === '/api/begin') {
233
+ if (existsSync(configPath))
234
+ throw new Error('This computer is already configured. Your settings have been kept.');
235
+ const restart = z
236
+ .object({ restart: z.boolean().optional() })
237
+ .parse(input).restart;
238
+ if (pending &&
239
+ !restart &&
240
+ new Date(pending.expiresAt).getTime() > Date.now())
241
+ return send(res, 200, publicState());
242
+ if (pending) {
243
+ await api('cancel', { id: pending.id, secret: pending.secret });
244
+ removePending();
245
+ }
246
+ const secret = randomBytes(32).toString('hex');
247
+ const key = 'luc_pc_' + randomBytes(32).toString('hex');
248
+ const name = hostname().slice(0, 120) || 'My computer';
249
+ const created = await api('begin', {
250
+ name,
251
+ secretHash: sha(secret),
252
+ keyHash: sha(key),
253
+ });
254
+ pending = pendingSchema.parse({
255
+ ...created,
256
+ secret,
257
+ key,
258
+ apiUrl,
259
+ name,
260
+ });
261
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
262
+ writeFileSync(pendingPath, JSON.stringify(pending), { mode: 0o600 });
263
+ chmodSync(pendingPath, 0o600);
264
+ return send(res, 200, publicState());
265
+ }
266
+ if (req.url === '/api/finish') {
267
+ const preferences = z
268
+ .object({
269
+ provider: z.enum(['claude', 'codex']),
270
+ tasks: z.boolean(),
271
+ scheduledWork: z.boolean(),
272
+ clients: clientChoices,
273
+ })
274
+ .parse(input);
275
+ if (!pending)
276
+ throw new Error('Connect your account first.');
277
+ const approved = await api('poll', {
278
+ id: pending.id,
279
+ secret: pending.secret,
280
+ });
281
+ if (approved.status !== 'approved')
282
+ throw new Error('Approve this computer in your Lucidity account first.');
283
+ const health = await (options.providers ?? checkSetupProviders)();
284
+ if (!health.some((p) => p.id === preferences.provider && p.auth === 'authenticated'))
285
+ throw new Error('Sign in to your selected provider and check again.');
286
+ writeNewSetupConfig(dir, {
287
+ apiKey: pending.key,
288
+ apiUrl,
289
+ machineName: pending.name,
290
+ chatProvider: preferences.provider,
291
+ codeProvider: preferences.provider,
292
+ chatModel: 'default',
293
+ codeModel: 'default',
294
+ delivery: 'stdout',
295
+ scheduledWork: preferences.scheduledWork,
296
+ reflect: false,
297
+ weeklyReview: preferences.scheduledWork,
298
+ capabilities: {
299
+ tasks: preferences.tasks,
300
+ memory: false,
301
+ connected: false,
302
+ },
303
+ repos: [],
304
+ });
305
+ removePending();
306
+ let clientResults = [];
307
+ if (preferences.clients.length) {
308
+ try {
309
+ clientResults = await clients.configure(preferences.clients);
310
+ }
311
+ catch {
312
+ // Pairing has succeeded. A client-config failure must not send the
313
+ // user back through pairing or revoke the saved credential.
314
+ clientResults = preferences.clients.map((id) => ({
315
+ id,
316
+ label: id === 'claude' ? 'Claude Code' : 'Codex',
317
+ status: 'error',
318
+ message: 'Your account is connected. Run lucidity setup-mcp to finish adding your tools.',
319
+ }));
320
+ }
321
+ }
322
+ finished = true;
323
+ send(res, 200, { ok: true, clients: clientResults });
324
+ setTimeout(() => {
325
+ server.close();
326
+ options.onFinish?.(true);
327
+ }, 500);
328
+ return;
329
+ }
330
+ if (req.url === '/api/cancel') {
331
+ if (pending)
332
+ await api('cancel', { id: pending.id, secret: pending.secret });
333
+ removePending();
334
+ finished = true;
335
+ send(res, 200, { ok: true });
336
+ setTimeout(() => {
337
+ server.close();
338
+ options.onFinish?.(false);
339
+ }, 500);
340
+ return;
341
+ }
342
+ send(res, 404, { error: 'Unknown setup action.' });
343
+ }
344
+ finally {
345
+ mutation = false;
346
+ }
347
+ }
348
+ catch (e) {
349
+ send(res, 400, {
350
+ error: e instanceof z.ZodError
351
+ ? 'Invalid setup choice.'
352
+ : e instanceof Error
353
+ ? e.message
354
+ : 'Setup could not finish.',
355
+ });
356
+ }
357
+ });
358
+ server.once('close', releaseLock);
359
+ server.once('error', releaseLock);
360
+ server.requestTimeout = 20000;
361
+ await new Promise((resolve, reject) => {
362
+ server.once('error', reject);
363
+ server.listen(0, '127.0.0.1', resolve);
364
+ });
365
+ const address = server.address();
366
+ if (!address || typeof address === 'string')
367
+ throw new Error('Could not open setup.');
368
+ origin = 'http://127.0.0.1:' + address.port;
369
+ const expires = setTimeout(() => {
370
+ server.closeAllConnections();
371
+ server.close();
372
+ options.onFinish?.(false);
373
+ }, 30 * 60 * 1000);
374
+ expires.unref();
375
+ server.on('close', () => clearTimeout(expires));
376
+ return { server, url: origin + '/#session=' + token, token, origin };
377
+ }
378
+ export async function runSetup() {
379
+ return new Promise((resolve, reject) => {
380
+ void createSetupServer({ onFinish: resolve }).then(({ url }) => {
381
+ console.error('Open this private setup link on this computer:\n' + url);
382
+ const command = process.platform === 'darwin'
383
+ ? 'open'
384
+ : process.platform === 'win32'
385
+ ? 'rundll32'
386
+ : 'xdg-open';
387
+ const args = process.platform === 'win32'
388
+ ? ['url.dll,FileProtocolHandler', url]
389
+ : [url];
390
+ const child = spawn(command, args, {
391
+ stdio: 'ignore',
392
+ windowsHide: true,
393
+ });
394
+ child.on('error', () => { });
395
+ child.unref();
396
+ }, reject);
397
+ });
398
+ }
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: lucidity-automations
3
+ description: Create, trial, schedule, review, revise, and troubleshoot Lucidity automations shared with the mobile app. Use when someone wants recurring work on their paired computer, asks about Lucidity jobs or run history, or wants a UI designer, briefing, notes review, or custom research automation.
4
+ ---
5
+
6
+ # Lucidity automations
7
+
8
+ Use Lucidity's `get_automations`, `get_automation_run`, and `manage_automation` MCP tools. They operate on the same jobs shown in the app's Automations screen. This skill supplies a workflow; it does not add permissions or start a separate scheduler.
9
+
10
+ ## Establish the job
11
+
12
+ 1. Read `get_automations`. Identify the computer, existing jobs, supported sources, connection configuration, and any relevant failures. Reuse the intended job instead of creating a duplicate. Connection flags indicate configuration, not verified authentication.
13
+ 2. Turn the user's idea into a concise name and instructions describing the goal, sources, and useful output. Ask only for missing details that affect execution: source/destination links, project when needed, or schedule/timezone. Honor decisions and authorization already provided.
14
+ 3. Choose the workflow:
15
+ - `agent`: read selected `tasks`, `journal`, `notes`, `repository`, or `web` sources and save a Markdown result. Templates are `custom`, `daily-briefing`, `weekly-plan`, `notes-review`. Notes needs a connected folder; repository needs an available `repoId`. This workflow proposes changes; it cannot apply external writes.
16
+ - `ui-designer`: create reviewable native Figma proposals from a product brief and destination `figmaUrl`. `pinterestUrl` and `repoId` are optional. Derive product rules from the brief and saved guidance; do not assume Lucidity cards, dimensions, or a particular aesthetic for other users.
17
+ 4. Save using `manage_automation` with `action=save`. New drafts use `enabled=false`; use `frequency=manual` when no recurring schedule was requested. Include an IANA timezone. Supported schedules: manual, daily, weekdays, weekly, or intervals of 1/2/3/4/6/8/12 hours. Explain that jobs run on the named computer while it is awake and connected. `catchUp=skip` is the default; `once` coalesces missed work into one run.
18
+
19
+ Minimal general input (inside `command: {action: "save", input: ...}`):
20
+
21
+ ```json
22
+ {
23
+ "workflow": "agent",
24
+ "template": "daily-briefing",
25
+ "name": "Morning priorities",
26
+ "brief": "Review my tasks and prepare a concise morning plan with source task links. Propose changes without modifying tasks.",
27
+ "sources": ["tasks"],
28
+ "reviewRequired": true,
29
+ "enabled": false,
30
+ "schedule": {"frequency": "daily", "time": "09:00", "timezone": "Asia/Kolkata"}
31
+ }
32
+ ```
33
+
34
+ Use the user's timezone rather than copying the example. Save provider/model and sensible `timeoutMinutes` / `maxToolCalls` limits. These bounds are not guaranteed spending caps.
35
+
36
+ ## Trial, review, and schedule
37
+
38
+ - `run` starts asynchronously and returns a durable run ID. Inspect `get_automation_run` until it finishes, using bounded polling. Report **started** while it is running; report success only from the completed record.
39
+ - The UI designer automatically studies available Pinterest images in small vision batches before generation. It keeps per-image observations in private per-job memory, reuses unchanged image analysis, and groups distinct visual families. `referenceStudy` reports the current feed coverage, observations and source links. Inferred visual evidence is used automatically; it is not a claim that the user approved every property in every pin. Explicit preferences and product rules take precedence. A public feed is a bounded recent sample, never proof that the whole board was studied.
40
+ - `stage=taste` additionally proposes human-readable guidance without writing designs. Review drafts and use `save-guidance` when the user accepts them. This saves explicit project/automation guidance; the automatic reference-memory step does not depend on manually accepting a taste draft. Guidance is saved in the job, or `docs/taste.md` and `docs/design.md` when a repo is selected. Repo guidance should be reviewed and committed for other worktrees to receive it.
41
+ - `stage=design` creates Figma proposals, then a separate read-only reviewer inspects screenshots against learned references and the brief. One bounded repair and re-review are allowed. Inspect `critiques` along with node links and the saved summary. A failed review stays failed and retains created artifacts. `revise` records user feedback and starts a linked revision; previous output remains available.
42
+ - General reports and failures can be `acknowledge`d to clear attention while preserving their status/history. Do not hide a failure by calling it completed.
43
+ - Enable the agreed recurring schedule with `enable`. Do not require a second confirmation if the user already authorized it. Pause with `enabled=false`, or `enabled=true` plus a future `pausedUntil` for a temporary pause.
44
+ - A design `review` approval requires a real `directionId`. `implement` additionally needs a selected repository and creates a dedicated coding branch, requesting a draft PR. Only do this when implementation is in the user's scope. Design approval alone does not authorize merging or deployment.
45
+
46
+ ## Recover and explain
47
+
48
+ Read saved jobs/runs after an uncertain mutation before retrying. Runs cannot overlap within one job. Restarts mark unfinished work interrupted, and cancellation preserves existing external edits. Inspect those edits before repeating a write.
49
+
50
+ If tools are absent, run `lucidity setup-mcp` on the computer, then reconnect the coding client. The daemon must be running locally for these MCP tools. Lucid's companion chat needs the separate **Automations** capability; task access alone does not grant it. Code chat supplies the tools directly. Figma setup for Codex is `lucidity setup-design`; other authenticated transports are configured locally, never by committing credentials.
51
+
52
+ CLI fallback: `lucidity automations list`, `get <run-id>`, or `command <json-file>` use the same service. An OS crontab, GitHub workflow, or client-local scheduled task is not a Lucidity automation and will not appear in the app.
53
+
54
+ Finish with the saved name/ID, actual result or blocker, schedule state and next run, and where to review it. Never claim a job exists, a source was read, or a design was created without tool evidence.
@@ -0,0 +1,30 @@
1
+ import { type VoiceCaptureInput, type VoiceCaptureReceipt, type SpeechAudio, type SpeechTranscript } from '@lucidity/shared';
2
+ type Options = {
3
+ directory: string;
4
+ transcribe: (audio: SpeechAudio, signal: AbortSignal) => Promise<SpeechTranscript>;
5
+ act: (transcript: string, signal: AbortSignal) => Promise<string>;
6
+ logger?: (message: string) => void;
7
+ };
8
+ /** Durable acceptance precedes the HTTP acknowledgement. Never repeat an action
9
+ * whose outcome may have been committed before a crash or lost provider reply. */
10
+ export declare class VoiceCaptureService {
11
+ private readonly opts;
12
+ private readonly records;
13
+ private readonly controller;
14
+ private running;
15
+ private faulted;
16
+ constructor(opts: Options);
17
+ private key;
18
+ private terminal;
19
+ private atomic;
20
+ private save;
21
+ private removeAudio;
22
+ status(credentialId: string, captureId: string): VoiceCaptureReceipt | null;
23
+ submit(credentialId: string, input: VoiceCaptureInput): VoiceCaptureReceipt;
24
+ wake(): void;
25
+ private update;
26
+ private drain;
27
+ stop(): void;
28
+ }
29
+ export {};
30
+ //# sourceMappingURL=captures.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"captures.d.ts","sourceRoot":"","sources":["../../src/speech/captures.ts"],"names":[],"mappings":"AAeA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAQ1B,KAAK,OAAO,GAAG;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,CACV,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF;kFACkF;AAClF,qBAAa,mBAAmB;IAKlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBACK,IAAI,EAAE,OAAO;IAoC1C,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,MAAM;IAiBd,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,WAAW;IAInB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAM3E,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,mBAAmB;IAiD3E,IAAI;IAsBJ,OAAO,CAAC,MAAM;YAiBA,KAAK;IAiDnB,IAAI;CAGL"}