@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,483 @@
1
+ import {
2
+ createServer,
3
+ type IncomingMessage,
4
+ type ServerResponse,
5
+ } from 'node:http';
6
+ import { randomBytes, createHash, timingSafeEqual } from 'node:crypto';
7
+ import { hostname } from 'node:os';
8
+ import {
9
+ mkdirSync,
10
+ readFileSync,
11
+ writeFileSync,
12
+ existsSync,
13
+ unlinkSync,
14
+ linkSync,
15
+ chmodSync,
16
+ } from 'node:fs';
17
+ import { join } from 'node:path';
18
+ import { spawn } from 'node:child_process';
19
+ import { z } from 'zod';
20
+ import {
21
+ ClaudeAgentExecutor,
22
+ CodexExecutor,
23
+ providerFailure,
24
+ } from '@lucidity/runtime';
25
+ import { CONFIG_DIR } from '../config.js';
26
+ import { localSetupPage } from './page.js';
27
+ import {
28
+ createClientSetup,
29
+ CLIENT_IDS,
30
+ type ClientStatus,
31
+ } from '../mcp/clients.js';
32
+
33
+ const clientChoices = z.array(z.enum(CLIENT_IDS)).max(2).default([]);
34
+
35
+ const sha = (s: string) => createHash('sha256').update(s).digest('hex');
36
+ const pendingSchema = z.object({
37
+ id: z.string().uuid(),
38
+ code: z.string().regex(/^[A-F0-9]{24}$/),
39
+ expiresAt: z.string().datetime(),
40
+ secret: z.string().regex(/^[a-f0-9]{64}$/),
41
+ key: z.string().regex(/^luc_pc_[a-f0-9]{64}$/),
42
+ apiUrl: z.string().url(),
43
+ name: z.string().min(1).max(120),
44
+ });
45
+ type Pending = z.infer<typeof pendingSchema>;
46
+ export function setupApiUrl(value: string) {
47
+ const url = new URL(value);
48
+ if (
49
+ url.username ||
50
+ url.password ||
51
+ url.search ||
52
+ url.hash ||
53
+ (url.pathname !== '/' && url.pathname !== '')
54
+ )
55
+ throw new Error('Use the API origin without a path or credentials.');
56
+ if (
57
+ url.protocol !== 'https:' &&
58
+ !(
59
+ url.protocol === 'http:' &&
60
+ ['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname)
61
+ )
62
+ )
63
+ throw new Error(
64
+ 'Setup requires HTTPS, except for a local development API.',
65
+ );
66
+ return url.origin;
67
+ }
68
+ export function writeNewSetupConfig(
69
+ dir: string,
70
+ config: Record<string, unknown>,
71
+ ) {
72
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
73
+ const temporary = join(dir, `.setup-${randomBytes(8).toString('hex')}.json`);
74
+ writeFileSync(temporary, JSON.stringify(config, null, 2) + '\n', {
75
+ flag: 'wx',
76
+ mode: 0o600,
77
+ });
78
+ try {
79
+ linkSync(temporary, join(dir, 'config.json'));
80
+ } finally {
81
+ unlinkSync(temporary);
82
+ }
83
+ }
84
+ function acquireSetupLock(dir: string) {
85
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
86
+ const path = join(dir, 'setup.lock');
87
+ if (existsSync(path)) {
88
+ const pid = Number(readFileSync(path, 'utf8'));
89
+ if (!Number.isInteger(pid) || pid < 1)
90
+ throw new Error(
91
+ 'The saved setup lock is invalid. Your configuration has not been changed.',
92
+ );
93
+ let alive = true;
94
+ try {
95
+ process.kill(pid, 0);
96
+ } catch (e) {
97
+ if ((e as NodeJS.ErrnoException).code === 'ESRCH') alive = false;
98
+ }
99
+ if (alive)
100
+ throw new Error(
101
+ 'Setup is already open for this computer. Return to its browser window.',
102
+ );
103
+ unlinkSync(path);
104
+ }
105
+ writeFileSync(path, String(process.pid), { flag: 'wx', mode: 0o600 });
106
+ return () => {
107
+ if (existsSync(path) && readFileSync(path, 'utf8') === String(process.pid))
108
+ unlinkSync(path);
109
+ };
110
+ }
111
+ export async function checkSetupProviders() {
112
+ return Promise.all(
113
+ (['claude', 'codex'] as const).map(async (id) => {
114
+ const executor =
115
+ id === 'claude' ? new ClaudeAgentExecutor() : new CodexExecutor();
116
+ try {
117
+ await executor.models();
118
+ return {
119
+ id,
120
+ label: id === 'claude' ? 'Claude' : 'Codex',
121
+ auth: 'authenticated',
122
+ message: '',
123
+ };
124
+ } catch (e) {
125
+ const health = providerFailure(e);
126
+ return {
127
+ id,
128
+ label: id === 'claude' ? 'Claude' : 'Codex',
129
+ auth: health.auth === 'authenticated' ? 'unknown' : health.auth,
130
+ message:
131
+ health.problem === 'login'
132
+ ? id === 'claude'
133
+ ? 'Sign in with Claude Code on this computer, then check again.'
134
+ : 'Run codex login on this computer, then check again.'
135
+ : 'Could not check this provider. Confirm it is installed and your network is available, then check again.',
136
+ };
137
+ } finally {
138
+ await executor.dispose();
139
+ }
140
+ }),
141
+ );
142
+ }
143
+
144
+ export interface SetupOptions {
145
+ apiUrl?: string;
146
+ directory?: string;
147
+ fetch?: typeof globalThis.fetch;
148
+ providers?: typeof checkSetupProviders;
149
+ clients?: ReturnType<typeof createClientSetup>;
150
+ onFinish?: (start: boolean) => void;
151
+ }
152
+ export async function createSetupServer(options: SetupOptions = {}) {
153
+ const apiUrl = setupApiUrl(
154
+ options.apiUrl ?? process.env.LUCIDITY_API_URL ?? 'https://api.lucidity.my',
155
+ );
156
+ const dir = options.directory ?? CONFIG_DIR;
157
+ const pendingPath = join(dir, 'setup-pending.json');
158
+ const configPath = join(dir, 'config.json');
159
+ const clients = options.clients ?? createClientSetup({ configPath });
160
+ const token = randomBytes(32).toString('hex');
161
+ const nonce = randomBytes(18).toString('base64');
162
+ let pending: Pending | undefined;
163
+ let finished = false;
164
+ let mutation = false;
165
+ let providerCheck: ReturnType<typeof checkSetupProviders> | undefined;
166
+ if (!existsSync(configPath) && existsSync(pendingPath)) {
167
+ const parsed = pendingSchema.safeParse(
168
+ JSON.parse(readFileSync(pendingPath, 'utf8')),
169
+ );
170
+ if (!parsed.success)
171
+ throw new Error(
172
+ 'Saved setup is invalid. Your existing configuration has not been changed.',
173
+ );
174
+ if (parsed.data.apiUrl !== apiUrl)
175
+ throw new Error(
176
+ 'A connection is pending for a different Lucidity server. Finish or cancel it using that server before starting again.',
177
+ );
178
+ pending = parsed.data;
179
+ }
180
+ const api = async (path: string, body: unknown) => {
181
+ const response = await (options.fetch ?? fetch)(
182
+ apiUrl + '/api/auth/computers/' + path,
183
+ {
184
+ method: 'POST',
185
+ headers: { 'Content-Type': 'application/json' },
186
+ body: JSON.stringify(body),
187
+ signal: AbortSignal.timeout(15000),
188
+ redirect: 'error',
189
+ },
190
+ );
191
+ const value = await response.json().catch(() => ({}));
192
+ if (!response.ok)
193
+ throw new Error(
194
+ response.status === 404
195
+ ? 'This Lucidity server does not support guided setup yet. Update the server before trying again.'
196
+ : typeof value.error === 'string'
197
+ ? value.error
198
+ : 'Lucidity could not be reached. Check your connection and try again.',
199
+ );
200
+ return value;
201
+ };
202
+ const publicState = () =>
203
+ pending
204
+ ? {
205
+ name: pending.name,
206
+ code: pending.code,
207
+ approvalUrl:
208
+ (apiUrl === 'https://api.lucidity.my'
209
+ ? 'https://lucidity.my'
210
+ : apiUrl) +
211
+ '/connect-computer#code=' +
212
+ pending.code,
213
+ }
214
+ : {};
215
+ const removePending = () => {
216
+ if (existsSync(pendingPath)) unlinkSync(pendingPath);
217
+ pending = undefined;
218
+ };
219
+ async function body(req: IncomingMessage) {
220
+ const chunks: Buffer[] = [];
221
+ let size = 0;
222
+ for await (const chunk of req) {
223
+ size += chunk.length;
224
+ if (size > 2048) throw new Error('Request too large.');
225
+ chunks.push(chunk);
226
+ }
227
+ return JSON.parse(Buffer.concat(chunks).toString('utf8')) as unknown;
228
+ }
229
+ const send = (res: ServerResponse, status: number, value: unknown) => {
230
+ res.writeHead(status, { 'Content-Type': 'application/json' });
231
+ res.end(JSON.stringify(value));
232
+ };
233
+ let origin = '';
234
+ const releaseLock = acquireSetupLock(dir);
235
+ const server = createServer(async (req, res) => {
236
+ res.setHeader('Cache-Control', 'no-store');
237
+ res.setHeader('Referrer-Policy', 'no-referrer');
238
+ res.setHeader('X-Content-Type-Options', 'nosniff');
239
+ res.setHeader(
240
+ 'Content-Security-Policy',
241
+ `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'`,
242
+ );
243
+ if (req.headers.host !== new URL(origin).host)
244
+ return send(res, 403, { error: 'Unrecognized setup host.' });
245
+ if (req.method === 'GET' && req.url === '/') {
246
+ res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
247
+ res.end(localSetupPage(nonce));
248
+ return;
249
+ }
250
+ const provided = req.headers['x-setup-token'];
251
+ if (
252
+ req.method !== 'POST' ||
253
+ req.headers.origin !== origin ||
254
+ req.headers['content-type'] !== 'application/json' ||
255
+ typeof provided !== 'string' ||
256
+ !/^[a-f0-9]{64}$/.test(provided) ||
257
+ !timingSafeEqual(Buffer.from(provided), Buffer.from(token))
258
+ )
259
+ return send(res, 403, {
260
+ error: 'This setup session is unavailable. Run lucidity setup again.',
261
+ });
262
+ try {
263
+ const input = await body(req);
264
+ if (finished) return send(res, 409, { error: 'Setup has finished.' });
265
+ if (req.url === '/api/state')
266
+ return send(res, 200, {
267
+ existing: existsSync(configPath),
268
+ ...publicState(),
269
+ });
270
+ if (req.url === '/api/poll') {
271
+ if (!pending) throw new Error('Start a connection first.');
272
+ return send(
273
+ res,
274
+ 200,
275
+ await api('poll', { id: pending.id, secret: pending.secret }),
276
+ );
277
+ }
278
+ if (req.url === '/api/providers') {
279
+ providerCheck ??= (options.providers ?? checkSetupProviders)().finally(
280
+ () => {
281
+ providerCheck = undefined;
282
+ },
283
+ );
284
+ return send(res, 200, { providers: await providerCheck });
285
+ }
286
+ if (req.url === '/api/clients')
287
+ return send(res, 200, { clients: await clients.inspect() });
288
+ if (mutation)
289
+ return send(res, 409, { error: 'A setup step is already running.' });
290
+ mutation = true;
291
+ try {
292
+ if (req.url === '/api/configure-clients') {
293
+ if (!existsSync(configPath))
294
+ throw new Error('Finish connecting your account first.');
295
+ const selected = z
296
+ .object({ clients: clientChoices })
297
+ .parse(input).clients;
298
+ return send(res, 200, { clients: await clients.configure(selected) });
299
+ }
300
+ if (req.url === '/api/begin') {
301
+ if (existsSync(configPath))
302
+ throw new Error(
303
+ 'This computer is already configured. Your settings have been kept.',
304
+ );
305
+ const restart = z
306
+ .object({ restart: z.boolean().optional() })
307
+ .parse(input).restart;
308
+ if (
309
+ pending &&
310
+ !restart &&
311
+ new Date(pending.expiresAt).getTime() > Date.now()
312
+ )
313
+ return send(res, 200, publicState());
314
+ if (pending) {
315
+ await api('cancel', { id: pending.id, secret: pending.secret });
316
+ removePending();
317
+ }
318
+ const secret = randomBytes(32).toString('hex');
319
+ const key = 'luc_pc_' + randomBytes(32).toString('hex');
320
+ const name = hostname().slice(0, 120) || 'My computer';
321
+ const created = await api('begin', {
322
+ name,
323
+ secretHash: sha(secret),
324
+ keyHash: sha(key),
325
+ });
326
+ pending = pendingSchema.parse({
327
+ ...created,
328
+ secret,
329
+ key,
330
+ apiUrl,
331
+ name,
332
+ });
333
+ mkdirSync(dir, { recursive: true, mode: 0o700 });
334
+ writeFileSync(pendingPath, JSON.stringify(pending), { mode: 0o600 });
335
+ chmodSync(pendingPath, 0o600);
336
+ return send(res, 200, publicState());
337
+ }
338
+ if (req.url === '/api/finish') {
339
+ const preferences = z
340
+ .object({
341
+ provider: z.enum(['claude', 'codex']),
342
+ tasks: z.boolean(),
343
+ scheduledWork: z.boolean(),
344
+ clients: clientChoices,
345
+ })
346
+ .parse(input);
347
+ if (!pending) throw new Error('Connect your account first.');
348
+ const approved = await api('poll', {
349
+ id: pending.id,
350
+ secret: pending.secret,
351
+ });
352
+ if (approved.status !== 'approved')
353
+ throw new Error(
354
+ 'Approve this computer in your Lucidity account first.',
355
+ );
356
+ const health = await (options.providers ?? checkSetupProviders)();
357
+ if (
358
+ !health.some(
359
+ (p) =>
360
+ p.id === preferences.provider && p.auth === 'authenticated',
361
+ )
362
+ )
363
+ throw new Error(
364
+ 'Sign in to your selected provider and check again.',
365
+ );
366
+ writeNewSetupConfig(dir, {
367
+ apiKey: pending.key,
368
+ apiUrl,
369
+ machineName: pending.name,
370
+ chatProvider: preferences.provider,
371
+ codeProvider: preferences.provider,
372
+ chatModel: 'default',
373
+ codeModel: 'default',
374
+ delivery: 'stdout',
375
+ scheduledWork: preferences.scheduledWork,
376
+ reflect: false,
377
+ weeklyReview: preferences.scheduledWork,
378
+ capabilities: {
379
+ tasks: preferences.tasks,
380
+ memory: false,
381
+ connected: false,
382
+ },
383
+ repos: [],
384
+ });
385
+ removePending();
386
+ let clientResults: ClientStatus[] = [];
387
+ if (preferences.clients.length) {
388
+ try {
389
+ clientResults = await clients.configure(preferences.clients);
390
+ } catch {
391
+ // Pairing has succeeded. A client-config failure must not send the
392
+ // user back through pairing or revoke the saved credential.
393
+ clientResults = preferences.clients.map((id) => ({
394
+ id,
395
+ label: id === 'claude' ? 'Claude Code' : 'Codex',
396
+ status: 'error',
397
+ message:
398
+ 'Your account is connected. Run lucidity setup-mcp to finish adding your tools.',
399
+ }));
400
+ }
401
+ }
402
+ finished = true;
403
+ send(res, 200, { ok: true, clients: clientResults });
404
+ setTimeout(() => {
405
+ server.close();
406
+ options.onFinish?.(true);
407
+ }, 500);
408
+ return;
409
+ }
410
+ if (req.url === '/api/cancel') {
411
+ if (pending)
412
+ await api('cancel', { id: pending.id, secret: pending.secret });
413
+ removePending();
414
+ finished = true;
415
+ send(res, 200, { ok: true });
416
+ setTimeout(() => {
417
+ server.close();
418
+ options.onFinish?.(false);
419
+ }, 500);
420
+ return;
421
+ }
422
+ send(res, 404, { error: 'Unknown setup action.' });
423
+ } finally {
424
+ mutation = false;
425
+ }
426
+ } catch (e) {
427
+ send(res, 400, {
428
+ error:
429
+ e instanceof z.ZodError
430
+ ? 'Invalid setup choice.'
431
+ : e instanceof Error
432
+ ? e.message
433
+ : 'Setup could not finish.',
434
+ });
435
+ }
436
+ });
437
+ server.once('close', releaseLock);
438
+ server.once('error', releaseLock);
439
+ server.requestTimeout = 20000;
440
+ await new Promise<void>((resolve, reject) => {
441
+ server.once('error', reject);
442
+ server.listen(0, '127.0.0.1', resolve);
443
+ });
444
+ const address = server.address();
445
+ if (!address || typeof address === 'string')
446
+ throw new Error('Could not open setup.');
447
+ origin = 'http://127.0.0.1:' + address.port;
448
+ const expires = setTimeout(
449
+ () => {
450
+ server.closeAllConnections();
451
+ server.close();
452
+ options.onFinish?.(false);
453
+ },
454
+ 30 * 60 * 1000,
455
+ );
456
+ expires.unref();
457
+ server.on('close', () => clearTimeout(expires));
458
+ return { server, url: origin + '/#session=' + token, token, origin };
459
+ }
460
+
461
+ export async function runSetup(): Promise<boolean> {
462
+ return new Promise<boolean>((resolve, reject) => {
463
+ void createSetupServer({ onFinish: resolve }).then(({ url }) => {
464
+ console.error('Open this private setup link on this computer:\n' + url);
465
+ const command =
466
+ process.platform === 'darwin'
467
+ ? 'open'
468
+ : process.platform === 'win32'
469
+ ? 'rundll32'
470
+ : 'xdg-open';
471
+ const args =
472
+ process.platform === 'win32'
473
+ ? ['url.dll,FileProtocolHandler', url]
474
+ : [url];
475
+ const child = spawn(command, args, {
476
+ stdio: 'ignore',
477
+ windowsHide: true,
478
+ });
479
+ child.on('error', () => {});
480
+ child.unref();
481
+ }, reject);
482
+ });
483
+ }