@opencorelabs/lucidity 0.9.5 → 0.9.6

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 (787) hide show
  1. package/README.md +46 -5
  2. package/bin/lucidity.js +9 -1
  3. package/dist/agentControls.d.ts +3 -3
  4. package/dist/agentControls.d.ts.map +1 -1
  5. package/dist/agentControls.js +9 -6
  6. package/dist/assets/speech/lucidity-speech +0 -0
  7. package/dist/automations/agent.d.ts.map +1 -1
  8. package/dist/automations/agent.js +8 -3
  9. package/dist/automations/githubIssues.d.ts +25 -0
  10. package/dist/automations/githubIssues.d.ts.map +1 -0
  11. package/dist/automations/githubIssues.js +48 -0
  12. package/dist/automations/service.d.ts +4 -0
  13. package/dist/automations/service.d.ts.map +1 -1
  14. package/dist/automations/service.js +24 -3
  15. package/dist/automations/skill.d.ts +1 -1
  16. package/dist/automations/skill.d.ts.map +1 -1
  17. package/dist/automations/skill.js +3 -25
  18. package/dist/automations/workflowCrash.integration.d.ts +2 -0
  19. package/dist/automations/workflowCrash.integration.d.ts.map +1 -0
  20. package/dist/automations/workflowCrash.integration.js +78 -0
  21. package/dist/chat/server.d.ts +18 -0
  22. package/dist/chat/server.d.ts.map +1 -1
  23. package/dist/chat/server.js +203 -84
  24. package/dist/coding/agentMessages.d.ts +37 -0
  25. package/dist/coding/agentMessages.d.ts.map +1 -0
  26. package/dist/coding/agentMessages.js +220 -0
  27. package/dist/coding/agentSettings.d.ts +9 -0
  28. package/dist/coding/agentSettings.d.ts.map +1 -0
  29. package/dist/coding/agentSettings.js +22 -0
  30. package/dist/coding/fileContext.d.ts +4 -0
  31. package/dist/coding/fileContext.d.ts.map +1 -0
  32. package/dist/coding/fileContext.js +61 -0
  33. package/dist/coding/listPrs.d.ts +4 -0
  34. package/dist/coding/listPrs.d.ts.map +1 -1
  35. package/dist/coding/listPrs.js +1 -1
  36. package/dist/coding/lucidRouting.d.ts +67 -0
  37. package/dist/coding/lucidRouting.d.ts.map +1 -0
  38. package/dist/coding/lucidRouting.js +216 -0
  39. package/dist/coding/overviewSources.d.ts +52 -0
  40. package/dist/coding/overviewSources.d.ts.map +1 -0
  41. package/dist/coding/overviewSources.js +78 -0
  42. package/dist/coding/progress.d.ts +27 -0
  43. package/dist/coding/progress.d.ts.map +1 -0
  44. package/dist/coding/progress.js +152 -0
  45. package/dist/coding/repositoryRequests.d.ts +38 -0
  46. package/dist/coding/repositoryRequests.d.ts.map +1 -0
  47. package/dist/coding/repositoryRequests.js +137 -0
  48. package/dist/coding/runCodeTurn.d.ts +25 -8
  49. package/dist/coding/runCodeTurn.d.ts.map +1 -1
  50. package/dist/coding/runCodeTurn.js +93 -77
  51. package/dist/coding/workspaceOverview.d.ts +106 -0
  52. package/dist/coding/workspaceOverview.d.ts.map +1 -0
  53. package/dist/coding/workspaceOverview.js +96 -0
  54. package/dist/coding/workspaceRegistry.d.ts +230 -4
  55. package/dist/coding/workspaceRegistry.d.ts.map +1 -1
  56. package/dist/coding/workspaceRegistry.js +827 -37
  57. package/dist/coding/workspaceTitle.d.ts +14 -0
  58. package/dist/coding/workspaceTitle.d.ts.map +1 -0
  59. package/dist/coding/workspaceTitle.js +8 -0
  60. package/dist/coding/worktree.d.ts +1 -1
  61. package/dist/coding/worktree.d.ts.map +1 -1
  62. package/dist/coding/worktree.js +3 -2
  63. package/dist/coding/worktreeSetup.d.ts +1 -1
  64. package/dist/coding/worktreeSetup.d.ts.map +1 -1
  65. package/dist/coding/worktreeSetup.js +43 -10
  66. package/dist/config.d.ts +5 -0
  67. package/dist/config.d.ts.map +1 -1
  68. package/dist/config.js +38 -3
  69. package/dist/editor/existingWorkspace.d.ts +3 -0
  70. package/dist/editor/existingWorkspace.d.ts.map +1 -0
  71. package/dist/editor/existingWorkspace.js +19 -0
  72. package/dist/editor/fileActions.d.ts +26 -0
  73. package/dist/editor/fileActions.d.ts.map +1 -0
  74. package/dist/editor/fileActions.js +134 -0
  75. package/dist/editor/files.d.ts +27 -0
  76. package/dist/editor/files.d.ts.map +1 -0
  77. package/dist/editor/files.js +279 -0
  78. package/dist/editor/gitActions.d.ts +18 -0
  79. package/dist/editor/gitActions.d.ts.map +1 -0
  80. package/dist/editor/gitActions.js +140 -0
  81. package/dist/editor/localEndpoint.d.ts +4 -0
  82. package/dist/editor/localEndpoint.d.ts.map +1 -0
  83. package/dist/editor/localEndpoint.js +35 -0
  84. package/dist/editor/service.d.ts +28 -0
  85. package/dist/editor/service.d.ts.map +1 -0
  86. package/dist/editor/service.js +101 -0
  87. package/dist/editor/shellCommands.d.ts +21 -0
  88. package/dist/editor/shellCommands.d.ts.map +1 -0
  89. package/dist/editor/shellCommands.js +165 -0
  90. package/dist/editor/terminals.d.ts +34 -0
  91. package/dist/editor/terminals.d.ts.map +1 -0
  92. package/dist/editor/terminals.js +161 -0
  93. package/dist/editor/types.d.ts +37 -0
  94. package/dist/editor/types.d.ts.map +1 -0
  95. package/dist/editor/types.js +1 -0
  96. package/dist/files/store.d.ts +13 -0
  97. package/dist/files/store.d.ts.map +1 -0
  98. package/dist/files/store.js +150 -0
  99. package/dist/goals/assessment.d.ts +6 -6
  100. package/dist/index.js +232 -56
  101. package/dist/install.d.ts +7 -0
  102. package/dist/install.d.ts.map +1 -1
  103. package/dist/install.js +5 -2
  104. package/dist/jobs/briefing.d.ts +1 -1
  105. package/dist/jobs/briefing.d.ts.map +1 -1
  106. package/dist/jobs/briefing.js +16 -33
  107. package/dist/jobs/extraction.d.ts +2 -1
  108. package/dist/jobs/extraction.d.ts.map +1 -1
  109. package/dist/jobs/extraction.js +2 -2
  110. package/dist/jobs/fastModeReview.d.ts +3 -1
  111. package/dist/jobs/fastModeReview.d.ts.map +1 -1
  112. package/dist/jobs/fastModeReview.js +20 -11
  113. package/dist/jobs/voiceReview.js +4 -4
  114. package/dist/jobs/weeklyReview.d.ts +1 -1
  115. package/dist/jobs/weeklyReview.d.ts.map +1 -1
  116. package/dist/jobs/weeklyReview.js +2 -5
  117. package/dist/lucidInvocations.d.ts +44 -0
  118. package/dist/lucidInvocations.d.ts.map +1 -0
  119. package/dist/lucidInvocations.js +164 -0
  120. package/dist/mcp/config.d.ts +8 -2
  121. package/dist/mcp/config.d.ts.map +1 -1
  122. package/dist/mcp/config.js +52 -10
  123. package/dist/mcp/paired.js +1 -0
  124. package/dist/providerFallbackContext.d.ts +5 -0
  125. package/dist/providerFallbackContext.d.ts.map +1 -0
  126. package/dist/providerFallbackContext.js +58 -0
  127. package/dist/providerRecovery.d.ts +18 -1
  128. package/dist/providerRecovery.d.ts.map +1 -1
  129. package/dist/providerRecovery.js +3 -1
  130. package/dist/providerRoles.d.ts +9 -0
  131. package/dist/providerRoles.d.ts.map +1 -0
  132. package/dist/providerRoles.js +25 -0
  133. package/dist/recall/command.d.ts +139 -0
  134. package/dist/recall/command.d.ts.map +1 -0
  135. package/dist/recall/command.js +35 -0
  136. package/dist/recall/context.d.ts +5 -0
  137. package/dist/recall/context.d.ts.map +1 -0
  138. package/dist/recall/context.js +66 -0
  139. package/dist/recall/conversations.d.ts +182 -0
  140. package/dist/recall/conversations.d.ts.map +1 -0
  141. package/dist/recall/conversations.js +58 -0
  142. package/dist/recall/documents.d.ts +76 -0
  143. package/dist/recall/documents.d.ts.map +1 -0
  144. package/dist/recall/documents.js +32 -0
  145. package/dist/recall/evaluation.d.ts +77 -0
  146. package/dist/recall/evaluation.d.ts.map +1 -0
  147. package/dist/recall/evaluation.js +88 -0
  148. package/dist/recall/factory.d.ts +6 -0
  149. package/dist/recall/factory.d.ts.map +1 -0
  150. package/dist/recall/factory.js +20 -0
  151. package/dist/recall/index.d.ts +13 -0
  152. package/dist/recall/index.d.ts.map +1 -0
  153. package/dist/recall/index.js +92 -0
  154. package/dist/recall/memories.d.ts +16 -0
  155. package/dist/recall/memories.d.ts.map +1 -0
  156. package/dist/recall/memories.js +136 -0
  157. package/dist/recall/memorySelection.d.ts +4 -0
  158. package/dist/recall/memorySelection.d.ts.map +1 -0
  159. package/dist/recall/memorySelection.js +16 -0
  160. package/dist/recall/memoryService.d.ts +22 -0
  161. package/dist/recall/memoryService.d.ts.map +1 -0
  162. package/dist/recall/memoryService.js +171 -0
  163. package/dist/recall/personal.d.ts +127 -0
  164. package/dist/recall/personal.d.ts.map +1 -0
  165. package/dist/recall/personal.js +125 -0
  166. package/dist/recall/projects.d.ts +67 -0
  167. package/dist/recall/projects.d.ts.map +1 -0
  168. package/dist/recall/projects.js +117 -0
  169. package/dist/recall/query.d.ts +5 -0
  170. package/dist/recall/query.d.ts.map +1 -0
  171. package/dist/recall/query.js +17 -0
  172. package/dist/recall/semanticEvaluation.d.ts +2 -0
  173. package/dist/recall/semanticEvaluation.d.ts.map +1 -0
  174. package/dist/recall/semanticEvaluation.js +123 -0
  175. package/dist/recall/service.d.ts +62 -0
  176. package/dist/recall/service.d.ts.map +1 -0
  177. package/dist/recall/service.js +94 -0
  178. package/dist/room/client.d.ts +41 -0
  179. package/dist/room/client.d.ts.map +1 -1
  180. package/dist/room/client.js +224 -25
  181. package/dist/room/codingActivity.d.ts +21 -0
  182. package/dist/room/codingActivity.d.ts.map +1 -0
  183. package/dist/room/codingActivity.js +86 -0
  184. package/dist/room/computer.d.ts.map +1 -1
  185. package/dist/room/computer.js +19 -3
  186. package/dist/room/context.d.ts +3 -2
  187. package/dist/room/context.d.ts.map +1 -1
  188. package/dist/room/context.js +5 -4
  189. package/dist/room/desktop-live.integration.d.ts +2 -0
  190. package/dist/room/desktop-live.integration.d.ts.map +1 -0
  191. package/dist/room/desktop-live.integration.js +219 -0
  192. package/dist/room/turnQueue.d.ts +24 -2
  193. package/dist/room/turnQueue.d.ts.map +1 -1
  194. package/dist/room/turnQueue.js +96 -30
  195. package/dist/runtimeStore.d.ts +17 -0
  196. package/dist/runtimeStore.d.ts.map +1 -1
  197. package/dist/runtimeStore.js +33 -4
  198. package/dist/setup/page.d.ts +1 -1
  199. package/dist/setup/page.d.ts.map +1 -1
  200. package/dist/setup/page.js +15 -2
  201. package/dist/setup/server.d.ts +5 -1
  202. package/dist/setup/server.d.ts.map +1 -1
  203. package/dist/setup/server.js +37 -13
  204. package/dist/skills/install.d.ts +8 -0
  205. package/dist/skills/install.d.ts.map +1 -0
  206. package/dist/skills/install.js +82 -0
  207. package/dist/skills/lucidity/SKILL.md +65 -0
  208. package/dist/skills/lucidity-task-handoff/SKILL.md +122 -0
  209. package/dist/speech/captures.d.ts +4 -0
  210. package/dist/speech/captures.d.ts.map +1 -1
  211. package/dist/speech/captures.js +53 -41
  212. package/dist/updateCli.d.ts +2 -0
  213. package/dist/updateCli.d.ts.map +1 -0
  214. package/dist/updateCli.js +40 -0
  215. package/dist/updateService.d.ts +3 -0
  216. package/dist/updateService.d.ts.map +1 -0
  217. package/dist/updateService.js +23 -0
  218. package/dist/updates/admission.d.ts +23 -0
  219. package/dist/updates/admission.d.ts.map +1 -0
  220. package/dist/updates/admission.js +76 -0
  221. package/dist/updates/bootstrap.d.ts +23 -0
  222. package/dist/updates/bootstrap.d.ts.map +1 -0
  223. package/dist/updates/bootstrap.js +95 -0
  224. package/dist/updates/bootstrapConfig.d.ts +34 -0
  225. package/dist/updates/bootstrapConfig.d.ts.map +1 -0
  226. package/dist/updates/bootstrapConfig.js +35 -0
  227. package/dist/updates/connection.d.ts +20 -0
  228. package/dist/updates/connection.d.ts.map +1 -0
  229. package/dist/updates/connection.js +111 -0
  230. package/dist/updates/developmentAdmission.d.ts +29 -0
  231. package/dist/updates/developmentAdmission.d.ts.map +1 -0
  232. package/dist/updates/developmentAdmission.js +73 -0
  233. package/dist/updates/developmentCli.d.ts +2 -0
  234. package/dist/updates/developmentCli.d.ts.map +1 -0
  235. package/dist/updates/developmentCli.js +61 -0
  236. package/dist/updates/developmentRefresh.d.ts +73 -0
  237. package/dist/updates/developmentRefresh.d.ts.map +1 -0
  238. package/dist/updates/developmentRefresh.js +157 -0
  239. package/dist/updates/developmentService.d.ts +13 -0
  240. package/dist/updates/developmentService.d.ts.map +1 -0
  241. package/dist/updates/developmentService.js +217 -0
  242. package/dist/updates/download.d.ts +7 -0
  243. package/dist/updates/download.d.ts.map +1 -0
  244. package/dist/updates/download.js +52 -0
  245. package/dist/updates/feed.d.ts +7 -0
  246. package/dist/updates/feed.d.ts.map +1 -0
  247. package/dist/updates/feed.js +37 -0
  248. package/dist/updates/installService.d.ts +3 -0
  249. package/dist/updates/installService.d.ts.map +1 -0
  250. package/dist/updates/installService.js +78 -0
  251. package/dist/updates/installationReferences.d.ts +17 -0
  252. package/dist/updates/installationReferences.d.ts.map +1 -0
  253. package/dist/updates/installationReferences.js +104 -0
  254. package/dist/updates/installationStore.d.ts +49 -0
  255. package/dist/updates/installationStore.d.ts.map +1 -0
  256. package/dist/updates/installationStore.js +237 -0
  257. package/dist/updates/installer.d.ts +29 -0
  258. package/dist/updates/installer.d.ts.map +1 -0
  259. package/dist/updates/installer.js +205 -0
  260. package/dist/updates/journal.d.ts +228 -0
  261. package/dist/updates/journal.d.ts.map +1 -0
  262. package/dist/updates/journal.js +249 -0
  263. package/dist/updates/managedLifecycle.d.ts +26 -0
  264. package/dist/updates/managedLifecycle.d.ts.map +1 -0
  265. package/dist/updates/managedLifecycle.js +60 -0
  266. package/dist/updates/migrateService.d.ts +2 -0
  267. package/dist/updates/migrateService.d.ts.map +1 -0
  268. package/dist/updates/migrateService.js +44 -0
  269. package/dist/updates/migration.d.ts +15 -0
  270. package/dist/updates/migration.d.ts.map +1 -0
  271. package/dist/updates/migration.js +108 -0
  272. package/dist/updates/processControl.d.ts +47 -0
  273. package/dist/updates/processControl.d.ts.map +1 -0
  274. package/dist/updates/processControl.js +98 -0
  275. package/dist/updates/processHost.d.ts +52 -0
  276. package/dist/updates/processHost.d.ts.map +1 -0
  277. package/dist/updates/processHost.js +165 -0
  278. package/dist/updates/registerService.d.ts +4 -0
  279. package/dist/updates/registerService.d.ts.map +1 -0
  280. package/dist/updates/registerService.js +34 -0
  281. package/dist/updates/releases.d.ts +84 -0
  282. package/dist/updates/releases.d.ts.map +1 -0
  283. package/dist/updates/releases.js +51 -0
  284. package/dist/updates/retention.d.ts +32 -0
  285. package/dist/updates/retention.d.ts.map +1 -0
  286. package/dist/updates/retention.js +188 -0
  287. package/dist/updates/runner.d.ts +6 -0
  288. package/dist/updates/runner.d.ts.map +1 -0
  289. package/dist/updates/runner.js +117 -0
  290. package/dist/updates/service.d.ts +53 -0
  291. package/dist/updates/service.d.ts.map +1 -0
  292. package/dist/updates/service.js +268 -0
  293. package/dist/updates/servicePlan.d.ts +29 -0
  294. package/dist/updates/servicePlan.d.ts.map +1 -0
  295. package/dist/updates/servicePlan.js +58 -0
  296. package/dist/updates/signCatalog.d.ts +10 -0
  297. package/dist/updates/signCatalog.d.ts.map +1 -0
  298. package/dist/updates/signCatalog.js +44 -0
  299. package/dist/updates/supervisor.d.ts +27 -0
  300. package/dist/updates/supervisor.d.ts.map +1 -0
  301. package/dist/updates/supervisor.js +137 -0
  302. package/dist/updates/windowsService.d.ts +12 -0
  303. package/dist/updates/windowsService.d.ts.map +1 -0
  304. package/dist/updates/windowsService.js +51 -0
  305. package/dist/video/context.d.ts +4 -0
  306. package/dist/video/context.d.ts.map +1 -0
  307. package/dist/video/context.js +74 -0
  308. package/dist/video/store.d.ts +22 -0
  309. package/dist/video/store.d.ts.map +1 -0
  310. package/dist/video/store.js +184 -0
  311. package/npm-shrinkwrap.json +1792 -0
  312. package/package.json +4 -1
  313. package/src/agentControls.ts +11 -7
  314. package/src/automations/agent.ts +11 -2
  315. package/src/automations/githubIssues.ts +63 -0
  316. package/src/automations/service.ts +25 -3
  317. package/src/automations/skill.ts +5 -37
  318. package/src/automations/workflowCrash.integration.ts +70 -0
  319. package/src/chat/server.ts +162 -89
  320. package/src/coding/agentMessages.ts +217 -0
  321. package/src/coding/agentSettings.ts +22 -0
  322. package/src/coding/fileContext.ts +72 -0
  323. package/src/coding/listPrs.ts +1 -1
  324. package/src/coding/lucidRouting.ts +211 -0
  325. package/src/coding/overviewSources.ts +86 -0
  326. package/src/coding/progress.ts +146 -0
  327. package/src/coding/repositoryRequests.ts +117 -0
  328. package/src/coding/runCodeTurn.ts +106 -92
  329. package/src/coding/workspaceOverview.ts +99 -0
  330. package/src/coding/workspaceRegistry.ts +762 -39
  331. package/src/coding/workspaceTitle.ts +10 -0
  332. package/src/coding/worktree.ts +3 -2
  333. package/src/coding/worktreeSetup.ts +33 -10
  334. package/src/config.ts +37 -2
  335. package/src/editor/existingWorkspace.ts +17 -0
  336. package/src/editor/fileActions.ts +162 -0
  337. package/src/editor/files.ts +276 -0
  338. package/src/editor/gitActions.ts +150 -0
  339. package/src/editor/localEndpoint.ts +28 -0
  340. package/src/editor/service.ts +93 -0
  341. package/src/editor/shellCommands.ts +132 -0
  342. package/src/editor/terminals.ts +129 -0
  343. package/src/editor/types.ts +32 -0
  344. package/src/files/store.ts +131 -0
  345. package/src/index.ts +224 -50
  346. package/src/install.ts +4 -2
  347. package/src/jobs/briefing.ts +18 -29
  348. package/src/jobs/extraction.ts +5 -4
  349. package/src/jobs/fastModeReview.ts +22 -11
  350. package/src/jobs/voiceReview.ts +4 -4
  351. package/src/jobs/weeklyReview.ts +2 -4
  352. package/src/lucidInvocations.ts +152 -0
  353. package/src/mcp/config.ts +48 -10
  354. package/src/mcp/paired.ts +1 -0
  355. package/src/providerFallbackContext.ts +48 -0
  356. package/src/providerRecovery.ts +3 -1
  357. package/src/providerRoles.ts +35 -0
  358. package/src/recall/command.ts +42 -0
  359. package/src/recall/context.ts +64 -0
  360. package/src/recall/conversations.ts +53 -0
  361. package/src/recall/documents.ts +32 -0
  362. package/src/recall/evaluation.ts +89 -0
  363. package/src/recall/factory.ts +21 -0
  364. package/src/recall/index.ts +87 -0
  365. package/src/recall/memories.ts +123 -0
  366. package/src/recall/memorySelection.ts +17 -0
  367. package/src/recall/memoryService.ts +138 -0
  368. package/src/recall/personal.ts +97 -0
  369. package/src/recall/projects.ts +98 -0
  370. package/src/recall/query.ts +21 -0
  371. package/src/recall/semanticEvaluation.ts +101 -0
  372. package/src/recall/service.ts +85 -0
  373. package/src/room/client.ts +238 -31
  374. package/src/room/codingActivity.ts +70 -0
  375. package/src/room/computer.ts +19 -3
  376. package/src/room/context.ts +7 -2
  377. package/src/room/desktop-live.integration.ts +203 -0
  378. package/src/room/turnQueue.ts +91 -34
  379. package/src/runtimeStore.ts +36 -4
  380. package/src/setup/page.ts +15 -2
  381. package/src/setup/server.ts +28 -5
  382. package/src/skills/install.ts +65 -0
  383. package/src/speech/captures.ts +56 -44
  384. package/src/updateCli.ts +37 -0
  385. package/src/updateService.ts +21 -0
  386. package/src/updates/admission.ts +70 -0
  387. package/src/updates/bootstrap.ts +77 -0
  388. package/src/updates/bootstrapConfig.ts +29 -0
  389. package/src/updates/connection.ts +84 -0
  390. package/src/updates/developmentAdmission.ts +56 -0
  391. package/src/updates/developmentCli.ts +47 -0
  392. package/src/updates/developmentRefresh.ts +130 -0
  393. package/src/updates/developmentService.ts +170 -0
  394. package/src/updates/download.ts +53 -0
  395. package/src/updates/feed.ts +34 -0
  396. package/src/updates/installService.ts +67 -0
  397. package/src/updates/installationReferences.ts +87 -0
  398. package/src/updates/installationStore.ts +196 -0
  399. package/src/updates/installer.ts +203 -0
  400. package/src/updates/journal.ts +250 -0
  401. package/src/updates/managedLifecycle.ts +64 -0
  402. package/src/updates/migrateService.ts +33 -0
  403. package/src/updates/migration.ts +92 -0
  404. package/src/updates/processControl.ts +96 -0
  405. package/src/updates/processHost.ts +159 -0
  406. package/src/updates/registerService.ts +27 -0
  407. package/src/updates/releases.ts +53 -0
  408. package/src/updates/retention.ts +154 -0
  409. package/src/updates/runner.ts +104 -0
  410. package/src/updates/service.ts +241 -0
  411. package/src/updates/servicePlan.ts +63 -0
  412. package/src/updates/signCatalog.ts +40 -0
  413. package/src/updates/supervisor.ts +114 -0
  414. package/src/updates/windowsService.ts +54 -0
  415. package/src/video/context.ts +101 -0
  416. package/src/video/store.ts +250 -0
  417. package/vendor/decisions/dist/followup.d.ts +14 -0
  418. package/vendor/decisions/dist/followup.js +86 -0
  419. package/vendor/decisions/dist/index.d.ts +3 -0
  420. package/vendor/decisions/dist/index.js +3 -0
  421. package/vendor/decisions/dist/repositoryReplay.d.ts +103 -0
  422. package/vendor/decisions/dist/repositoryReplay.js +177 -0
  423. package/vendor/decisions/dist/repositoryRouting.d.ts +21 -0
  424. package/vendor/decisions/dist/repositoryRouting.js +125 -0
  425. package/vendor/decisions/src/followup.ts +129 -0
  426. package/vendor/decisions/src/index.ts +3 -0
  427. package/vendor/decisions/src/repositoryReplay.ts +312 -0
  428. package/vendor/decisions/src/repositoryRouting.ts +167 -0
  429. package/vendor/mcp-server/README.md +6 -0
  430. package/vendor/mcp-server/dist/index.js +21 -7
  431. package/vendor/mcp-server/dist/localDaemon.d.ts +4 -0
  432. package/vendor/mcp-server/dist/localDaemon.d.ts.map +1 -0
  433. package/vendor/mcp-server/dist/localDaemon.js +41 -0
  434. package/vendor/mcp-server/dist/tools/agents.d.ts +3 -0
  435. package/vendor/mcp-server/dist/tools/agents.d.ts.map +1 -0
  436. package/vendor/mcp-server/dist/tools/agents.js +60 -0
  437. package/vendor/mcp-server/dist/tools/artifacts.d.ts +3 -0
  438. package/vendor/mcp-server/dist/tools/artifacts.d.ts.map +1 -0
  439. package/vendor/mcp-server/dist/tools/artifacts.js +22 -0
  440. package/vendor/mcp-server/dist/tools/automations.d.ts.map +1 -1
  441. package/vendor/mcp-server/dist/tools/automations.js +7 -32
  442. package/vendor/mcp-server/dist/tools/commandEventFormat.d.ts +1 -1
  443. package/vendor/mcp-server/dist/tools/commandEventFormat.js +2 -2
  444. package/vendor/mcp-server/dist/tools/commandEvents.js +1 -1
  445. package/vendor/mcp-server/dist/tools/comments.d.ts.map +1 -1
  446. package/vendor/mcp-server/dist/tools/comments.js +5 -1
  447. package/vendor/mcp-server/dist/tools/journal.d.ts.map +1 -1
  448. package/vendor/mcp-server/dist/tools/journal.js +1 -0
  449. package/vendor/mcp-server/dist/tools/memory.d.ts +0 -10
  450. package/vendor/mcp-server/dist/tools/memory.d.ts.map +1 -1
  451. package/vendor/mcp-server/dist/tools/memory.js +28 -102
  452. package/vendor/mcp-server/dist/tools/notes.d.ts.map +1 -1
  453. package/vendor/mcp-server/dist/tools/notes.js +38 -4
  454. package/vendor/mcp-server/dist/tools/recall.d.ts +6 -0
  455. package/vendor/mcp-server/dist/tools/recall.d.ts.map +1 -0
  456. package/vendor/mcp-server/dist/tools/recall.js +78 -0
  457. package/vendor/mcp-server/dist/tools/summary.d.ts +3 -0
  458. package/vendor/mcp-server/dist/tools/summary.d.ts.map +1 -0
  459. package/vendor/mcp-server/dist/tools/summary.js +22 -0
  460. package/vendor/mcp-server/dist/tools/taskSheet.d.ts +3 -0
  461. package/vendor/mcp-server/dist/tools/taskSheet.d.ts.map +1 -0
  462. package/vendor/mcp-server/dist/tools/taskSheet.js +32 -0
  463. package/vendor/mcp-server/dist/tools/tasks.d.ts.map +1 -1
  464. package/vendor/mcp-server/dist/tools/tasks.js +117 -24
  465. package/vendor/mcp-server/dist/tools/worktrees.d.ts +3 -0
  466. package/vendor/mcp-server/dist/tools/worktrees.d.ts.map +1 -0
  467. package/vendor/mcp-server/dist/tools/worktrees.js +51 -0
  468. package/vendor/mcp-server/package.json +1 -1
  469. package/vendor/mcp-server/src/index.ts +17 -7
  470. package/vendor/mcp-server/src/localDaemon.ts +56 -0
  471. package/vendor/mcp-server/src/tools/agents.ts +78 -0
  472. package/vendor/mcp-server/src/tools/artifacts.ts +26 -0
  473. package/vendor/mcp-server/src/tools/automations.ts +7 -47
  474. package/vendor/mcp-server/src/tools/commandEventFormat.ts +2 -2
  475. package/vendor/mcp-server/src/tools/commandEvents.ts +1 -1
  476. package/vendor/mcp-server/src/tools/comments.ts +4 -1
  477. package/vendor/mcp-server/src/tools/journal.ts +1 -0
  478. package/vendor/mcp-server/src/tools/memory.ts +37 -130
  479. package/vendor/mcp-server/src/tools/notes.ts +35 -5
  480. package/vendor/mcp-server/src/tools/recall.ts +89 -0
  481. package/vendor/mcp-server/src/tools/summary.ts +30 -0
  482. package/vendor/mcp-server/src/tools/taskSheet.ts +60 -0
  483. package/vendor/mcp-server/src/tools/tasks.ts +125 -24
  484. package/vendor/mcp-server/src/tools/worktrees.ts +61 -0
  485. package/vendor/notes/dist/artifacts.d.ts +8 -0
  486. package/vendor/notes/dist/artifacts.d.ts.map +1 -0
  487. package/vendor/notes/dist/artifacts.js +105 -0
  488. package/vendor/notes/dist/index.d.ts +1 -0
  489. package/vendor/notes/dist/index.d.ts.map +1 -1
  490. package/vendor/notes/dist/index.js +1 -0
  491. package/vendor/notes/dist/vault.d.ts.map +1 -1
  492. package/vendor/notes/dist/vault.js +2 -0
  493. package/vendor/notes/src/artifacts.ts +100 -0
  494. package/vendor/notes/src/index.ts +2 -0
  495. package/vendor/notes/src/vault.ts +1 -0
  496. package/vendor/runtime/README.md +8 -0
  497. package/vendor/runtime/dist/executor/claudeAgent.d.ts +18 -1
  498. package/vendor/runtime/dist/executor/claudeAgent.d.ts.map +1 -1
  499. package/vendor/runtime/dist/executor/claudeAgent.js +157 -39
  500. package/vendor/runtime/dist/executor/claudeCode.d.ts.map +1 -1
  501. package/vendor/runtime/dist/executor/claudeCode.js +19 -2
  502. package/vendor/runtime/dist/executor/claudeSession.d.ts +32 -0
  503. package/vendor/runtime/dist/executor/claudeSession.d.ts.map +1 -0
  504. package/vendor/runtime/dist/executor/claudeSession.js +154 -0
  505. package/vendor/runtime/dist/executor/codex.d.ts +18 -2
  506. package/vendor/runtime/dist/executor/codex.d.ts.map +1 -1
  507. package/vendor/runtime/dist/executor/codex.js +134 -18
  508. package/vendor/runtime/dist/executor/codexSessions.d.ts +5 -10
  509. package/vendor/runtime/dist/executor/codexSessions.d.ts.map +1 -1
  510. package/vendor/runtime/dist/executor/codexSessions.js +12 -78
  511. package/vendor/runtime/dist/executor/fallback.d.ts +27 -0
  512. package/vendor/runtime/dist/executor/fallback.d.ts.map +1 -0
  513. package/vendor/runtime/dist/executor/fallback.js +45 -0
  514. package/vendor/runtime/dist/executor/health.d.ts +19 -1
  515. package/vendor/runtime/dist/executor/health.d.ts.map +1 -1
  516. package/vendor/runtime/dist/executor/health.js +19 -2
  517. package/vendor/runtime/dist/executor/integrations.d.ts +4 -0
  518. package/vendor/runtime/dist/executor/integrations.d.ts.map +1 -0
  519. package/vendor/runtime/dist/executor/integrations.js +5 -0
  520. package/vendor/runtime/dist/executor/liveTurns.d.ts +2 -2
  521. package/vendor/runtime/dist/executor/liveTurns.d.ts.map +1 -1
  522. package/vendor/runtime/dist/executor/liveTurns.js +3 -3
  523. package/vendor/runtime/dist/executor/ownership.d.ts +18 -1
  524. package/vendor/runtime/dist/executor/ownership.d.ts.map +1 -1
  525. package/vendor/runtime/dist/executor/ownership.js +3 -1
  526. package/vendor/runtime/dist/executor/providerRouter.d.ts +13 -0
  527. package/vendor/runtime/dist/executor/providerRouter.d.ts.map +1 -1
  528. package/vendor/runtime/dist/executor/providerRouter.js +91 -5
  529. package/vendor/runtime/dist/executor/sessionRetention.d.ts +34 -0
  530. package/vendor/runtime/dist/executor/sessionRetention.d.ts.map +1 -0
  531. package/vendor/runtime/dist/executor/sessionRetention.js +126 -0
  532. package/vendor/runtime/dist/executor/types.d.ts +30 -7
  533. package/vendor/runtime/dist/executor/types.d.ts.map +1 -1
  534. package/vendor/runtime/dist/executor/usage.d.ts +5 -0
  535. package/vendor/runtime/dist/executor/usage.d.ts.map +1 -0
  536. package/vendor/runtime/dist/executor/usage.js +56 -0
  537. package/vendor/runtime/dist/harness/index.d.ts.map +1 -1
  538. package/vendor/runtime/dist/harness/index.js +2 -5
  539. package/vendor/runtime/dist/harness/types.d.ts +3 -1
  540. package/vendor/runtime/dist/harness/types.d.ts.map +1 -1
  541. package/vendor/runtime/dist/index.d.ts +6 -1
  542. package/vendor/runtime/dist/index.d.ts.map +1 -1
  543. package/vendor/runtime/dist/index.js +3 -0
  544. package/vendor/runtime/dist/prompts/recall.d.ts +15 -0
  545. package/vendor/runtime/dist/prompts/recall.d.ts.map +1 -0
  546. package/vendor/runtime/dist/prompts/recall.js +71 -0
  547. package/vendor/runtime/src/executor/claudeAgent.ts +149 -37
  548. package/vendor/runtime/src/executor/claudeCode.ts +17 -3
  549. package/vendor/runtime/src/executor/claudeSession.ts +180 -0
  550. package/vendor/runtime/src/executor/codex.ts +136 -21
  551. package/vendor/runtime/src/executor/codexSessions.ts +18 -82
  552. package/vendor/runtime/src/executor/fallback.ts +63 -0
  553. package/vendor/runtime/src/executor/health.ts +16 -2
  554. package/vendor/runtime/src/executor/integrations.ts +7 -0
  555. package/vendor/runtime/src/executor/liveTurns.ts +5 -5
  556. package/vendor/runtime/src/executor/ownership.ts +3 -1
  557. package/vendor/runtime/src/executor/providerRouter.ts +85 -4
  558. package/vendor/runtime/src/executor/sessionRetention.ts +166 -0
  559. package/vendor/runtime/src/executor/types.ts +27 -7
  560. package/vendor/runtime/src/executor/usage.ts +58 -0
  561. package/vendor/runtime/src/harness/index.ts +2 -5
  562. package/vendor/runtime/src/harness/types.ts +3 -1
  563. package/vendor/runtime/src/index.ts +7 -1
  564. package/vendor/runtime/src/prompts/recall.ts +72 -0
  565. package/vendor/shared/dist/accountDevices.d.ts +62 -0
  566. package/vendor/shared/dist/accountDevices.d.ts.map +1 -0
  567. package/vendor/shared/dist/accountDevices.js +25 -0
  568. package/vendor/shared/dist/activityRecovery.d.ts +37 -0
  569. package/vendor/shared/dist/activityRecovery.d.ts.map +1 -0
  570. package/vendor/shared/dist/activityRecovery.js +39 -0
  571. package/vendor/shared/dist/agentMessages.d.ts +187 -0
  572. package/vendor/shared/dist/agentMessages.d.ts.map +1 -0
  573. package/vendor/shared/dist/agentMessages.js +70 -0
  574. package/vendor/shared/dist/aiUsage.d.ts +30 -0
  575. package/vendor/shared/dist/aiUsage.d.ts.map +1 -0
  576. package/vendor/shared/dist/aiUsage.js +14 -0
  577. package/vendor/shared/dist/artifacts.d.ts +28 -0
  578. package/vendor/shared/dist/artifacts.d.ts.map +1 -0
  579. package/vendor/shared/dist/artifacts.js +47 -0
  580. package/vendor/shared/dist/automationTemplates.d.ts.map +1 -1
  581. package/vendor/shared/dist/automationTemplates.js +1 -0
  582. package/vendor/shared/dist/automations.d.ts +61 -14
  583. package/vendor/shared/dist/automations.d.ts.map +1 -1
  584. package/vendor/shared/dist/automations.js +10 -3
  585. package/vendor/shared/dist/cardStudio.d.ts +31 -31
  586. package/vendor/shared/dist/chatActivity.d.ts +17 -0
  587. package/vendor/shared/dist/chatActivity.d.ts.map +1 -0
  588. package/vendor/shared/dist/chatActivity.js +47 -0
  589. package/vendor/shared/dist/codingActivity.d.ts +60 -0
  590. package/vendor/shared/dist/codingActivity.d.ts.map +1 -0
  591. package/vendor/shared/dist/codingActivity.js +33 -0
  592. package/vendor/shared/dist/commandLocal.d.ts +1 -1
  593. package/vendor/shared/dist/commandLocal.d.ts.map +1 -1
  594. package/vendor/shared/dist/commands.d.ts +32 -32
  595. package/vendor/shared/dist/commands.d.ts.map +1 -1
  596. package/vendor/shared/dist/commands.js +1 -1
  597. package/vendor/shared/dist/commentMentions.d.ts +20 -0
  598. package/vendor/shared/dist/commentMentions.d.ts.map +1 -0
  599. package/vendor/shared/dist/commentMentions.js +14 -0
  600. package/vendor/shared/dist/computer.d.ts +48 -8
  601. package/vendor/shared/dist/computer.d.ts.map +1 -1
  602. package/vendor/shared/dist/computer.js +25 -0
  603. package/vendor/shared/dist/constants.d.ts +1 -1
  604. package/vendor/shared/dist/constants.d.ts.map +1 -1
  605. package/vendor/shared/dist/constants.js +5 -0
  606. package/vendor/shared/dist/daemonUpdates.d.ts +123 -0
  607. package/vendor/shared/dist/daemonUpdates.d.ts.map +1 -0
  608. package/vendor/shared/dist/daemonUpdates.js +106 -0
  609. package/vendor/shared/dist/deviceInteraction.d.ts +23 -0
  610. package/vendor/shared/dist/deviceInteraction.d.ts.map +1 -0
  611. package/vendor/shared/dist/deviceInteraction.js +32 -0
  612. package/vendor/shared/dist/doctor.d.ts +50 -0
  613. package/vendor/shared/dist/doctor.d.ts.map +1 -0
  614. package/vendor/shared/dist/doctor.js +15 -0
  615. package/vendor/shared/dist/fileUploads.d.ts +39 -0
  616. package/vendor/shared/dist/fileUploads.d.ts.map +1 -0
  617. package/vendor/shared/dist/fileUploads.js +24 -0
  618. package/vendor/shared/dist/files.d.ts +11 -0
  619. package/vendor/shared/dist/files.d.ts.map +1 -0
  620. package/vendor/shared/dist/files.js +19 -0
  621. package/vendor/shared/dist/githubContributions.d.ts +1 -1
  622. package/vendor/shared/dist/goals.d.ts +7 -7
  623. package/vendor/shared/dist/index.d.ts +29 -2
  624. package/vendor/shared/dist/index.d.ts.map +1 -1
  625. package/vendor/shared/dist/index.js +26 -1
  626. package/vendor/shared/dist/lucidFollowups.d.ts +95 -0
  627. package/vendor/shared/dist/lucidFollowups.d.ts.map +1 -0
  628. package/vendor/shared/dist/lucidFollowups.js +45 -0
  629. package/vendor/shared/dist/lucidInvocations.d.ts +82 -0
  630. package/vendor/shared/dist/lucidInvocations.d.ts.map +1 -0
  631. package/vendor/shared/dist/lucidInvocations.js +47 -0
  632. package/vendor/shared/dist/memory.d.ts +162 -0
  633. package/vendor/shared/dist/memory.d.ts.map +1 -0
  634. package/vendor/shared/dist/memory.js +26 -0
  635. package/vendor/shared/dist/messagingSafety.d.ts +43 -0
  636. package/vendor/shared/dist/messagingSafety.d.ts.map +1 -1
  637. package/vendor/shared/dist/messagingSafety.js +6 -0
  638. package/vendor/shared/dist/recall.d.ts +803 -0
  639. package/vendor/shared/dist/recall.d.ts.map +1 -0
  640. package/vendor/shared/dist/recall.js +56 -0
  641. package/vendor/shared/dist/releaseCompatibility.d.ts +228 -0
  642. package/vendor/shared/dist/releaseCompatibility.d.ts.map +1 -0
  643. package/vendor/shared/dist/releaseCompatibility.js +145 -0
  644. package/vendor/shared/dist/repositoryRequests.d.ts +173 -0
  645. package/vendor/shared/dist/repositoryRequests.d.ts.map +1 -0
  646. package/vendor/shared/dist/repositoryRequests.js +38 -0
  647. package/vendor/shared/dist/repositoryRouting.d.ts +169 -0
  648. package/vendor/shared/dist/repositoryRouting.d.ts.map +1 -0
  649. package/vendor/shared/dist/repositoryRouting.js +102 -0
  650. package/vendor/shared/dist/roomClient.d.ts +107 -0
  651. package/vendor/shared/dist/roomClient.d.ts.map +1 -0
  652. package/vendor/shared/dist/roomClient.js +371 -0
  653. package/vendor/shared/dist/schemas/comment.d.ts +46 -0
  654. package/vendor/shared/dist/schemas/comment.d.ts.map +1 -1
  655. package/vendor/shared/dist/schemas/comment.js +10 -0
  656. package/vendor/shared/dist/schemas/conversation.d.ts +80 -1
  657. package/vendor/shared/dist/schemas/conversation.d.ts.map +1 -1
  658. package/vendor/shared/dist/schemas/conversation.js +12 -1
  659. package/vendor/shared/dist/schemas/harness.d.ts +1631 -17
  660. package/vendor/shared/dist/schemas/harness.d.ts.map +1 -1
  661. package/vendor/shared/dist/schemas/harness.js +106 -3
  662. package/vendor/shared/dist/schemas/notification.d.ts +3 -1
  663. package/vendor/shared/dist/schemas/notification.d.ts.map +1 -1
  664. package/vendor/shared/dist/schemas/notification.js +2 -1
  665. package/vendor/shared/dist/schemas/organization.d.ts +2 -0
  666. package/vendor/shared/dist/schemas/organization.d.ts.map +1 -1
  667. package/vendor/shared/dist/schemas/organization.js +2 -0
  668. package/vendor/shared/dist/schemas/project.d.ts +2 -2
  669. package/vendor/shared/dist/schemas/request.d.ts +1 -1
  670. package/vendor/shared/dist/schemas/task.d.ts +1 -1
  671. package/vendor/shared/dist/smartCapture.js +1 -1
  672. package/vendor/shared/dist/spokenNames.d.ts +1 -1
  673. package/vendor/shared/dist/spokenNames.js +1 -1
  674. package/vendor/shared/dist/taskActivity.d.ts +5 -5
  675. package/vendor/shared/dist/taskSharing.d.ts +8 -0
  676. package/vendor/shared/dist/taskSharing.d.ts.map +1 -0
  677. package/vendor/shared/dist/taskSharing.js +9 -0
  678. package/vendor/shared/dist/thinking-orb/engine/core.d.ts +31 -0
  679. package/vendor/shared/dist/thinking-orb/engine/core.d.ts.map +1 -0
  680. package/vendor/shared/dist/thinking-orb/engine/core.js +62 -0
  681. package/vendor/shared/dist/thinking-orb/engine/ctx.d.ts +9 -0
  682. package/vendor/shared/dist/thinking-orb/engine/ctx.d.ts.map +1 -0
  683. package/vendor/shared/dist/thinking-orb/engine/ctx.js +1 -0
  684. package/vendor/shared/dist/thinking-orb/engine/lattice.d.ts +5 -0
  685. package/vendor/shared/dist/thinking-orb/engine/lattice.d.ts.map +1 -0
  686. package/vendor/shared/dist/thinking-orb/engine/lattice.js +184 -0
  687. package/vendor/shared/dist/thinking-orb/engine/morph.d.ts +3 -0
  688. package/vendor/shared/dist/thinking-orb/engine/morph.d.ts.map +1 -0
  689. package/vendor/shared/dist/thinking-orb/engine/morph.js +117 -0
  690. package/vendor/shared/dist/thinking-orb/engine/orbits.d.ts +3 -0
  691. package/vendor/shared/dist/thinking-orb/engine/orbits.d.ts.map +1 -0
  692. package/vendor/shared/dist/thinking-orb/engine/orbits.js +66 -0
  693. package/vendor/shared/dist/thinking-orb/engine/profiles.d.ts +8 -0
  694. package/vendor/shared/dist/thinking-orb/engine/profiles.d.ts.map +1 -0
  695. package/vendor/shared/dist/thinking-orb/engine/profiles.js +113 -0
  696. package/vendor/shared/dist/thinking-orb/engine/registry.d.ts +4 -0
  697. package/vendor/shared/dist/thinking-orb/engine/registry.d.ts.map +1 -0
  698. package/vendor/shared/dist/thinking-orb/engine/registry.js +14 -0
  699. package/vendor/shared/dist/thinking-orb/engine/ribbon.d.ts +3 -0
  700. package/vendor/shared/dist/thinking-orb/engine/ribbon.d.ts.map +1 -0
  701. package/vendor/shared/dist/thinking-orb/engine/ribbon.js +64 -0
  702. package/vendor/shared/dist/thinking-orb/engine/types.d.ts +6 -0
  703. package/vendor/shared/dist/thinking-orb/engine/types.d.ts.map +1 -0
  704. package/vendor/shared/dist/thinking-orb/engine/types.js +2 -0
  705. package/vendor/shared/dist/thinking-orb/index.d.ts +7 -0
  706. package/vendor/shared/dist/thinking-orb/index.d.ts.map +1 -0
  707. package/vendor/shared/dist/thinking-orb/index.js +2 -0
  708. package/vendor/shared/dist/thinking-orb/presets.d.ts +12 -0
  709. package/vendor/shared/dist/thinking-orb/presets.d.ts.map +1 -0
  710. package/vendor/shared/dist/thinking-orb/presets.js +67 -0
  711. package/vendor/shared/dist/thinking-orb/types.d.ts +24 -0
  712. package/vendor/shared/dist/thinking-orb/types.d.ts.map +1 -0
  713. package/vendor/shared/dist/thinking-orb/types.js +1 -0
  714. package/vendor/shared/dist/turnTiming.d.ts +13 -0
  715. package/vendor/shared/dist/turnTiming.d.ts.map +1 -0
  716. package/vendor/shared/dist/turnTiming.js +18 -0
  717. package/vendor/shared/dist/types.d.ts +3 -1
  718. package/vendor/shared/dist/types.d.ts.map +1 -1
  719. package/vendor/shared/dist/updateControl.d.ts +168 -0
  720. package/vendor/shared/dist/updateControl.d.ts.map +1 -0
  721. package/vendor/shared/dist/updateControl.js +43 -0
  722. package/vendor/shared/dist/videos.d.ts +31 -0
  723. package/vendor/shared/dist/videos.d.ts.map +1 -0
  724. package/vendor/shared/dist/videos.js +34 -0
  725. package/vendor/shared/dist/workspaceIO.d.ts +188 -0
  726. package/vendor/shared/dist/workspaceIO.d.ts.map +1 -0
  727. package/vendor/shared/dist/workspaceIO.js +50 -0
  728. package/vendor/shared/dist/workspaces.d.ts +740 -2
  729. package/vendor/shared/dist/workspaces.d.ts.map +1 -1
  730. package/vendor/shared/dist/workspaces.js +108 -2
  731. package/vendor/shared/package.json +12 -0
  732. package/vendor/shared/src/accountDevices.ts +28 -0
  733. package/vendor/shared/src/activityRecovery.ts +42 -0
  734. package/vendor/shared/src/agentMessages.ts +82 -0
  735. package/vendor/shared/src/aiUsage.ts +18 -0
  736. package/vendor/shared/src/artifacts.ts +48 -0
  737. package/vendor/shared/src/automationTemplates.ts +1 -0
  738. package/vendor/shared/src/automations.ts +10 -3
  739. package/vendor/shared/src/chatActivity.ts +56 -0
  740. package/vendor/shared/src/codingActivity.ts +40 -0
  741. package/vendor/shared/src/commandLocal.ts +1 -1
  742. package/vendor/shared/src/commands.ts +1 -1
  743. package/vendor/shared/src/commentMentions.ts +20 -0
  744. package/vendor/shared/src/computer.ts +40 -0
  745. package/vendor/shared/src/constants.ts +5 -0
  746. package/vendor/shared/src/daemonUpdates.ts +127 -0
  747. package/vendor/shared/src/deviceInteraction.ts +35 -0
  748. package/vendor/shared/src/doctor.ts +19 -0
  749. package/vendor/shared/src/fileUploads.ts +28 -0
  750. package/vendor/shared/src/files.ts +21 -0
  751. package/vendor/shared/src/index.ts +35 -1
  752. package/vendor/shared/src/lucidFollowups.ts +49 -0
  753. package/vendor/shared/src/lucidInvocations.ts +62 -0
  754. package/vendor/shared/src/memory.ts +30 -0
  755. package/vendor/shared/src/messagingSafety.ts +10 -0
  756. package/vendor/shared/src/recall.ts +69 -0
  757. package/vendor/shared/src/releaseCompatibility.ts +162 -0
  758. package/vendor/shared/src/repositoryRequests.ts +44 -0
  759. package/vendor/shared/src/repositoryRouting.ts +117 -0
  760. package/vendor/shared/src/roomClient.ts +351 -0
  761. package/vendor/shared/src/schemas/comment.ts +10 -0
  762. package/vendor/shared/src/schemas/conversation.ts +12 -1
  763. package/vendor/shared/src/schemas/harness.ts +120 -3
  764. package/vendor/shared/src/schemas/notification.ts +2 -1
  765. package/vendor/shared/src/schemas/organization.ts +2 -0
  766. package/vendor/shared/src/smartCapture.ts +1 -1
  767. package/vendor/shared/src/spokenNames.ts +1 -1
  768. package/vendor/shared/src/taskSharing.ts +13 -0
  769. package/vendor/shared/src/thinking-orb/ATTRIBUTION.md +36 -0
  770. package/vendor/shared/src/thinking-orb/engine/core.ts +81 -0
  771. package/vendor/shared/src/thinking-orb/engine/ctx.ts +15 -0
  772. package/vendor/shared/src/thinking-orb/engine/lattice.ts +205 -0
  773. package/vendor/shared/src/thinking-orb/engine/morph.ts +130 -0
  774. package/vendor/shared/src/thinking-orb/engine/orbits.ts +80 -0
  775. package/vendor/shared/src/thinking-orb/engine/profiles.ts +119 -0
  776. package/vendor/shared/src/thinking-orb/engine/registry.ts +18 -0
  777. package/vendor/shared/src/thinking-orb/engine/ribbon.ts +71 -0
  778. package/vendor/shared/src/thinking-orb/engine/types.ts +15 -0
  779. package/vendor/shared/src/thinking-orb/index.ts +6 -0
  780. package/vendor/shared/src/thinking-orb/presets.ts +88 -0
  781. package/vendor/shared/src/thinking-orb/types.ts +25 -0
  782. package/vendor/shared/src/turnTiming.ts +20 -0
  783. package/vendor/shared/src/types.ts +1 -1
  784. package/vendor/shared/src/updateControl.ts +45 -0
  785. package/vendor/shared/src/videos.ts +37 -0
  786. package/vendor/shared/src/workspaceIO.ts +61 -0
  787. package/vendor/shared/src/workspaces.ts +119 -2
@@ -0,0 +1,10 @@
1
+ import { z } from 'zod';
2
+
3
+ export const isGreetingTitle = (title: string) => /^(?:initial greeting|greetings?|hello)[.!]?$/i.test(title.trim());
4
+ export const worktreeTitleSchema = z.string().trim().min(1).max(60)
5
+ .refine(value => !/[\r\n\t]/.test(value) && !/^Worktree\s+\d+$/i.test(value) && !isGreetingTitle(value));
6
+ export const titleSuggestionRequestSchema = z.object({ action: z.literal('suggest-title'),
7
+ requestId: z.string().uuid(), title: worktreeTitleSchema }).strict();
8
+ export const WORKTREE_TITLE_GUIDANCE = `Worktree title metadata: when the actual task is clear, quietly call suggest_worktree_title once near the end of this normal turn with a specific 2–6 word name (at most 60 characters). Use the conversation context you already have; do not run a separate model or research step for naming. Skip greetings or unclear tasks. This saves an internal suggestion, not a chat message or permission to rename files, branches or folders. Do not announce the call or mention the suggestion in commentary or your final answer. The app controls when it is displayed and preserves manual names.`;
9
+ export const isTitleSuggestionEvent = (event: { type: string; name?: string }) =>
10
+ event.type === 'tool_call' && /^(?:(?:functions\.)?mcp__lucidity__|lucidity[./])?suggest_worktree_title$/.test(event.name ?? '');
@@ -61,9 +61,10 @@ export function sessionWorktreePath(
61
61
  : join(baseDir, slug(repoId));
62
62
  }
63
63
 
64
- /** The branch checked out in `repoRoot`, or `HEAD` when detached. */
64
+ /** The branch checked out in `repoRoot`, including before its first commit, or `HEAD` when detached. */
65
65
  export async function currentBranch(repoRoot: string): Promise<string> {
66
- return (await git(repoRoot, ['rev-parse', '--abbrev-ref', 'HEAD'])).trim();
66
+ return (await git(repoRoot, ['symbolic-ref', '--quiet', '--short', 'HEAD'])
67
+ .catch(() => git(repoRoot, ['rev-parse', '--abbrev-ref', 'HEAD']))).trim();
67
68
  }
68
69
 
69
70
  export async function workspaceBranchExists(repoRoot: string, repoId: string, workerId?: string): Promise<boolean> {
@@ -1,9 +1,7 @@
1
- import { execFile } from 'node:child_process';
2
- import { promisify } from 'node:util';
1
+ import { spawn } from 'node:child_process';
3
2
  import { copyFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
4
3
  import { dirname, join, posix } from 'node:path';
5
4
 
6
- const exec = promisify(execFile);
7
5
  const SETUP_TIMEOUT_MS = 15 * 60 * 1000;
8
6
 
9
7
  /** Wildcards are honoured in the file name only: `.env*` and `apps/api/.env.*` work, `**` does not. */
@@ -39,12 +37,37 @@ export function copyIncludedFiles(repoRoot: string, worktree: string, include: s
39
37
  }
40
38
 
41
39
  /** Run one of the repository's commands (setup or archive) in the worktree. */
42
- export async function runSetupScript(repoRoot: string, worktree: string, name: string, setup: string, port?: number): Promise<void> {
43
- await exec('/bin/sh', ['-c', setup], {
44
- cwd: worktree,
45
- timeout: SETUP_TIMEOUT_MS,
46
- maxBuffer: 32 * 1024 * 1024,
47
- env: { ...process.env, LUCIDITY_ROOT_PATH: repoRoot, LUCIDITY_WORKTREE_PATH: worktree, LUCIDITY_WORKTREE_NAME: name,
48
- ...(port ? { LUCIDITY_PORT: String(port) } : {}) },
40
+ export async function runSetupScript(repoRoot: string, worktree: string, name: string, setup: string, port?: number, signal?: AbortSignal): Promise<void> {
41
+ signal?.throwIfAborted();
42
+ await new Promise<void>((resolve, reject) => {
43
+ const child = spawn('/bin/sh', ['-c', setup], {
44
+ cwd: worktree, detached: process.platform !== 'win32', stdio: ['ignore', 'pipe', 'pipe'],
45
+ env: { ...process.env, LUCIDITY_ROOT_PATH: repoRoot, LUCIDITY_WORKTREE_PATH: worktree, LUCIDITY_WORKTREE_NAME: name,
46
+ ...(port ? { LUCIDITY_PORT: String(port) } : {}) },
47
+ });
48
+ let error: Error | undefined, stderr = '', bytes = 0;
49
+ const stop = (reason: string) => {
50
+ error ??= new Error(reason);
51
+ // Stop the entire setup process group before a corrected destination can start.
52
+ try {
53
+ if (child.pid && process.platform !== 'win32') process.kill(-child.pid, 'SIGKILL');
54
+ else child.kill('SIGKILL');
55
+ } catch { /* already exited */ }
56
+ };
57
+ const abort = () => stop('Workspace setup was stopped.');
58
+ const timer = setTimeout(() => stop('Workspace setup timed out.'), SETUP_TIMEOUT_MS);
59
+ signal?.addEventListener('abort', abort, { once: true });
60
+ if (signal?.aborted) abort();
61
+ child.on('error', (failure) => { error = failure; });
62
+ child.stdout.on('data', (chunk: Buffer) => { bytes += chunk.length; if (bytes > 32 * 1024 * 1024) stop('Workspace setup output is too large.'); });
63
+ child.stderr.on('data', (chunk: Buffer) => {
64
+ stderr = (stderr + chunk.toString()).slice(-4000);
65
+ bytes += chunk.length; if (bytes > 32 * 1024 * 1024) stop('Workspace setup output is too large.');
66
+ });
67
+ child.on('close', (code) => {
68
+ clearTimeout(timer); signal?.removeEventListener('abort', abort);
69
+ if (error || code !== 0) reject(Object.assign(error ?? new Error(`Workspace setup exited with ${code}.`), { stderr }));
70
+ else resolve();
71
+ });
49
72
  });
50
73
  }
package/src/config.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { resolveSessionRetention, type SessionRetention } from '@lucidity/runtime';
1
2
  import { homedir, hostname } from 'node:os';
2
3
  import { join } from 'node:path';
3
4
  import {
@@ -72,12 +73,16 @@ export interface Capabilities {
72
73
  }
73
74
 
74
75
  export interface DaemonConfig {
76
+ /** Idle provider process budgets, read at daemon startup. */
77
+ sessionRetention?: Partial<Record<'claude' | 'codex', SessionRetention>>;
75
78
  /** Local recording transcription, independent of the chat/code providers. */
76
79
  sttModel?: string;
77
80
  /** Master switch for proactive jobs. Existing installations retain their behavior. */
78
81
  scheduledWork?: boolean;
79
82
  chatProvider?: 'claude' | 'codex';
80
83
  codeProvider?: 'claude' | 'codex';
84
+ /** Compatibility field for older clients. Provider fallback is now automatic. */
85
+ backgroundFallback?: boolean;
81
86
  /** Lucidity API key, `luc_…`. */
82
87
  apiKey: string;
83
88
  /** API base URL. Default: `http://localhost:3001`. */
@@ -145,9 +150,9 @@ const EXAMPLE = `{
145
150
  "apiKey": "luc_xxx", // from Lucidity → Settings → API Key
146
151
  "apiUrl": "http://localhost:3001",
147
152
  "briefingTime": "08:00",
148
- "chatModel": "haiku", // optional; model for Ask Lucid + voice (default haiku, tuned for speed)
153
+ "chatModel": "default", // optional; provider default for Ask Lucid + voice
149
154
  "chatEffort": "low", // optional; low | medium | high | xhigh | max (default low)
150
- "codeModel": "opus", // optional; model for repo coding + briefings (default opus)
155
+ "codeModel": "default", // optional; provider default for coding + briefings; Activity follows the coding conversation
151
156
  "codeEffort": "high", // optional; low | medium | high | xhigh | max (default high)
152
157
  "timezone": "Asia/Kolkata", // optional; IANA name
153
158
  "delivery": "macos", // optional; "macos" | "stdout"
@@ -373,6 +378,7 @@ export function loadConfig(configPath: string = CONFIG_PATH): DaemonConfig {
373
378
  fail(`${configPath}: "sttModel" must be a speech model ID.`);
374
379
 
375
380
  return {
381
+ sessionRetention: parseSessionRetention(obj['sessionRetention']),
376
382
  sttModel: sttModel.data,
377
383
  apiKey,
378
384
  apiUrl,
@@ -381,6 +387,7 @@ export function loadConfig(configPath: string = CONFIG_PATH): DaemonConfig {
381
387
  briefingTime,
382
388
  chatProvider,
383
389
  codeProvider,
390
+ backgroundFallback: true,
384
391
  chatModel,
385
392
  chatEffort,
386
393
  codeModel,
@@ -412,6 +419,7 @@ const EDITABLE_KEYS = [
412
419
  'sttModel',
413
420
  'chatProvider',
414
421
  'codeProvider',
422
+ 'backgroundFallback',
415
423
  'chatModel',
416
424
  'chatEffort',
417
425
  'codeModel',
@@ -438,6 +446,7 @@ export function configView(config: DaemonConfig): DaemonConfigView {
438
446
  sttModel: config.sttModel ?? DEFAULT_SPEECH_MODEL,
439
447
  chatProvider: config.chatProvider ?? 'claude',
440
448
  codeProvider: config.codeProvider ?? 'claude',
449
+ backgroundFallback: true,
441
450
  chatModel: config.chatModel,
442
451
  chatEffort: config.chatEffort,
443
452
  codeModel: config.codeModel,
@@ -495,6 +504,7 @@ export function writeConfigPatch(
495
504
  for (const key of EDITABLE_KEYS) {
496
505
  if (p[key] !== undefined) raw[key] = p[key];
497
506
  }
507
+ raw['backgroundFallback'] = true;
498
508
  if (patch.capabilities) {
499
509
  const cur =
500
510
  typeof raw['capabilities'] === 'object' && raw['capabilities'] !== null
@@ -540,6 +550,7 @@ export function persistNormalizedConfig(
540
550
  }
541
551
 
542
552
  const stale =
553
+ raw['backgroundFallback'] !== true ||
543
554
  'model' in raw ||
544
555
  'effort' in raw ||
545
556
  raw['chatModel'] !== config.chatModel ||
@@ -549,6 +560,7 @@ export function persistNormalizedConfig(
549
560
  if (!stale) return false;
550
561
 
551
562
  raw['chatModel'] = config.chatModel;
563
+ raw['backgroundFallback'] = true;
552
564
  raw['chatEffort'] = config.chatEffort;
553
565
  raw['codeModel'] = config.codeModel;
554
566
  raw['codeEffort'] = config.codeEffort;
@@ -639,6 +651,7 @@ export function applyPatchInMemory(
639
651
  config.chatProvider = patch.chatProvider;
640
652
  if (patch.codeProvider !== undefined)
641
653
  config.codeProvider = patch.codeProvider;
654
+ config.backgroundFallback = true;
642
655
  if (patch.chatModel !== undefined) config.chatModel = patch.chatModel;
643
656
  if (patch.chatEffort !== undefined) config.chatEffort = patch.chatEffort;
644
657
  if (patch.codeModel !== undefined) config.codeModel = patch.codeModel;
@@ -847,3 +860,25 @@ function parseDay(value: unknown): number {
847
860
  }
848
861
  return 0;
849
862
  }
863
+
864
+ /** Keep malformed process budgets from silently disabling or expanding retention. */
865
+ function parseSessionRetention(value: unknown): DaemonConfig['sessionRetention'] {
866
+ if (value === undefined) return;
867
+ if (!value || typeof value !== 'object' || Array.isArray(value))
868
+ throw new Error('sessionRetention must be an object keyed by claude or codex.');
869
+ const result: NonNullable<DaemonConfig['sessionRetention']> = {};
870
+ for (const [provider, raw] of Object.entries(value)) {
871
+ if (provider !== 'claude' && provider !== 'codex')
872
+ throw new Error('sessionRetention supports only claude and codex.');
873
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw) ||
874
+ Object.keys(raw).some((key) => key !== 'maxIdleSessions' && key !== 'idleTtlMs'))
875
+ throw new Error(`sessionRetention.${provider} must contain maxIdleSessions and/or idleTtlMs.`);
876
+ for (const key of ['maxIdleSessions', 'idleTtlMs']) {
877
+ if (key in raw && typeof (raw as Record<string, unknown>)[key] !== 'number')
878
+ throw new Error(`sessionRetention.${provider}.${key} must be a number.`);
879
+ }
880
+ try { result[provider] = resolveSessionRetention(raw as SessionRetention); }
881
+ catch (error) { throw new Error(`sessionRetention.${provider}: ${(error as Error).message}`); }
882
+ }
883
+ return result;
884
+ }
@@ -0,0 +1,17 @@
1
+ import { realpath } from 'node:fs/promises';
2
+ import path from 'node:path';
3
+ import { git } from './files.js';
4
+
5
+ /** Both locations must already be Git checkouts of the same repository. */
6
+ export async function existingWorkspace(repo: string, folder: string, branch: string): Promise<string> {
7
+ const [root, selected] = await Promise.all([realpath(repo), realpath(folder)]);
8
+ const top = await realpath((await git(selected, ['rev-parse', '--show-toplevel'])).trim());
9
+ if (top !== selected) throw new Error('The saved folder is no longer a Git workspace root.');
10
+ const common = async (cwd: string) => realpath(path.resolve(cwd, (await git(cwd, ['rev-parse', '--git-common-dir'])).trim()));
11
+ if (await common(root) !== await common(selected)) throw new Error('The saved folder belongs to a different repository.');
12
+ const actual = (await git(selected, ['branch', '--show-current'])).trim() || 'detached';
13
+ if (actual !== branch) throw new Error('The saved branch changed. Restore or review the original workspace before continuing.');
14
+ // Provider session stores can key by the spelling of cwd. Validate the real
15
+ // location, but retain the path the old host used (including macOS aliases).
16
+ return path.resolve(folder);
17
+ }
@@ -0,0 +1,162 @@
1
+ import { promises as fs } from 'node:fs';
2
+ import path from 'node:path';
3
+ import { randomUUID } from 'node:crypto';
4
+ import { execFile } from 'node:child_process';
5
+ import { promisify } from 'node:util';
6
+ import { WorkspaceFiles, validateEditorPath, MAX_FILE_BYTES } from './files.js';
7
+ const exec = promisify(execFile);
8
+ export interface SearchMatch {
9
+ path: string;
10
+ line: number;
11
+ column: number;
12
+ text: string;
13
+ }
14
+ export class FileActions {
15
+ constructor(private store: WorkspaceFiles) {}
16
+ private async destination(id: string, relative: string) {
17
+ validateEditorPath(relative);
18
+ const root = await fs.realpath(this.store.get(id).path);
19
+ const pieces = relative.split('/');
20
+ let parent = root;
21
+ for (const piece of pieces.slice(0, -1)) {
22
+ parent = path.join(parent, piece);
23
+ await fs.mkdir(parent, { recursive: true });
24
+ parent = await fs.realpath(parent);
25
+ const child = path.relative(root, parent);
26
+ if (
27
+ child === '..' ||
28
+ child.startsWith(`..${path.sep}`) ||
29
+ path.isAbsolute(child) ||
30
+ child.split(path.sep).some((part) => part.toLowerCase() === '.git')
31
+ )
32
+ throw new Error(
33
+ 'The destination resolves outside the editable workspace.',
34
+ );
35
+ }
36
+ return path.join(parent, pieces.at(-1)!);
37
+ }
38
+ async create(id: string, relative: string) {
39
+ const destination = await this.destination(id, relative);
40
+ await fs.writeFile(destination, '', { flag: 'wx', mode: 0o644 });
41
+ return this.store.read(id, relative);
42
+ }
43
+ async createFolder(id: string, relative: string) {
44
+ const destination = await this.destination(id, relative);
45
+ await fs.mkdir(destination);
46
+ return { path: relative };
47
+ }
48
+ async rename(id: string, relative: string, next: string) {
49
+ const source = await this.store.resolve(id, relative);
50
+ const lexical = path.join(this.store.get(id).path, relative);
51
+ if ((await fs.lstat(lexical)).isSymbolicLink())
52
+ throw new Error('Rename symbolic links in the terminal.');
53
+ if (!(await fs.stat(source)).isFile())
54
+ throw new Error('Choose a file to rename.');
55
+ const destination = await this.destination(id, next);
56
+ // link() fails if the destination exists; unlike rename(), it cannot replace it.
57
+ await fs.link(source, destination);
58
+ await fs.unlink(source);
59
+ return this.store.read(id, next);
60
+ }
61
+ async remove(id: string, relative: string, expectedVersion: string) {
62
+ const file = await this.store.read(id, relative);
63
+ if (file.version !== expectedVersion)
64
+ throw new Error(
65
+ 'This file changed. Review the current version before deleting it.',
66
+ );
67
+ const source = await this.store.resolve(id, relative);
68
+ if (
69
+ (
70
+ await fs.lstat(path.join(this.store.get(id).path, relative))
71
+ ).isSymbolicLink()
72
+ )
73
+ throw new Error('Delete symbolic links in the terminal.');
74
+ const recoveryId = randomUUID();
75
+ const dir = path.join(this.store.directory, 'recovery', recoveryId);
76
+ await fs.mkdir(dir, { recursive: true, mode: 0o700 });
77
+ await fs.writeFile(
78
+ path.join(dir, 'record.json'),
79
+ JSON.stringify({
80
+ workspaceId: id,
81
+ path: relative,
82
+ version: file.version,
83
+ }),
84
+ { mode: 0o600 },
85
+ );
86
+ await fs.rename(source, path.join(dir, 'content'));
87
+ return { recoveryId };
88
+ }
89
+ async restore(id: string, recoveryId: string) {
90
+ if (!/^[a-f0-9-]{36}$/.test(recoveryId))
91
+ throw new Error('Invalid recovery ID.');
92
+ const dir = path.join(this.store.directory, 'recovery', recoveryId);
93
+ const record = JSON.parse(
94
+ await fs.readFile(path.join(dir, 'record.json'), 'utf8'),
95
+ );
96
+ if (record.workspaceId !== id)
97
+ throw new Error('This deleted file belongs to another workspace.');
98
+ const destination = await this.destination(id, record.path);
99
+ await fs.copyFile(
100
+ path.join(dir, 'content'),
101
+ destination,
102
+ fs.constants.COPYFILE_EXCL,
103
+ );
104
+ await fs.rm(dir, { recursive: true });
105
+ return this.store.read(id, record.path);
106
+ }
107
+ async search(
108
+ id: string,
109
+ query: string,
110
+ ): Promise<{ matches: SearchMatch[]; truncated: boolean }> {
111
+ if (!query.trim()) return { matches: [], truncated: false };
112
+ let output = '';
113
+ let truncated = false;
114
+ try {
115
+ output = (
116
+ await exec(
117
+ 'git',
118
+ [
119
+ 'grep',
120
+ '--null',
121
+ '--line-number',
122
+ '--column',
123
+ '--untracked',
124
+ '--exclude-standard',
125
+ '-I',
126
+ '-i',
127
+ '-F',
128
+ '-e',
129
+ query,
130
+ ],
131
+ {
132
+ cwd: this.store.get(id).path,
133
+ maxBuffer: MAX_FILE_BYTES,
134
+ timeout: 15_000,
135
+ },
136
+ )
137
+ ).stdout;
138
+ } catch (error) {
139
+ const cause = error as { code?: string | number; stdout?: string };
140
+ if (cause.code === 1) return { matches: [], truncated: false };
141
+ if (cause.code !== 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER') throw error;
142
+ output = cause.stdout || '';
143
+ truncated = true;
144
+ }
145
+ const matches: SearchMatch[] = [];
146
+ const pattern = /([^\0]+)\0(\d+)\0(\d+)\0([^\n]*)\n/g;
147
+ for (const item of output.matchAll(pattern)) {
148
+ if (matches.length === 300) {
149
+ truncated = true;
150
+ break;
151
+ }
152
+ // A grep result can name an external symlink. The editor still validates on open.
153
+ matches.push({
154
+ path: item[1]!,
155
+ line: Number(item[2]),
156
+ column: Number(item[3]),
157
+ text: item[4]!.slice(0, 500),
158
+ });
159
+ }
160
+ return { matches, truncated };
161
+ }
162
+ }
@@ -0,0 +1,276 @@
1
+ import { createHash, randomUUID } from 'node:crypto';
2
+ import { execFile } from 'node:child_process';
3
+ import { promisify } from 'node:util';
4
+ import { promises as fs } from 'node:fs';
5
+ import path from 'node:path';
6
+ import type { ImagePreview } from '@lucidity/shared';
7
+ import type {
8
+ Changes,
9
+ FileContent,
10
+ FileDiff,
11
+ FileIndex,
12
+ SaveResult,
13
+ } from './types.js';
14
+
15
+ const exec = promisify(execFile);
16
+ export const MAX_FILE_BYTES = 2 * 1024 * 1024;
17
+ export const hash = (text: string | Buffer) =>
18
+ createHash('sha256').update(text).digest('hex');
19
+ export async function git(cwd: string, args: string[]): Promise<string> {
20
+ return (
21
+ await exec('git', ['--literal-pathspecs', ...args], {
22
+ cwd,
23
+ maxBuffer: 16 * 1024 * 1024,
24
+ timeout: 30_000,
25
+ env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
26
+ })
27
+ ).stdout;
28
+ }
29
+ const inside = (root: string, file: string) =>
30
+ file !== root &&
31
+ !path.relative(root, file).startsWith(`..${path.sep}`) &&
32
+ path.relative(root, file) !== '..' &&
33
+ !path.isAbsolute(path.relative(root, file));
34
+
35
+ export function validateEditorPath(relative: string): void {
36
+ // Use a portable lexical form: Windows ADS/drive names and case-insensitive
37
+ // Git metadata must not become a path escape when the host changes OS.
38
+ if (!relative || relative.includes('\0') || relative.includes('\\') || relative.includes(':') || path.isAbsolute(relative) ||
39
+ relative.split('/').some((part) => !part || part === '.' || part === '..' || part.replace(/[. ]+$/, '').toLowerCase() === '.git'))
40
+ throw new Error('Invalid workspace path.');
41
+ }
42
+
43
+ export interface EditorWorkspace { path: string; branch: string; status: 'idle' | 'running' | 'needs-approval'; }
44
+ export class WorkspaceFiles {
45
+ readonly mutations = new Set<string>();
46
+ private fileLocks = new Map<string, Promise<unknown>>();
47
+ constructor(readonly directory: string, private readonly lookup: (id: string) => EditorWorkspace) {}
48
+ get(id: string): EditorWorkspace { return this.lookup(id); }
49
+ async resolve(id: string, relative: string) {
50
+ validateEditorPath(relative);
51
+ const root = await fs.realpath(this.get(id).path);
52
+ const target = await fs.realpath(path.resolve(root, relative));
53
+ if (
54
+ !inside(root, target) ||
55
+ path.relative(root, target).split(path.sep).some((part) => part.toLowerCase() === '.git')
56
+ )
57
+ throw new Error('This file resolves outside the editable workspace.');
58
+ return target;
59
+ }
60
+ async files(id: string): Promise<FileIndex> {
61
+ const paths = (
62
+ await git(this.get(id).path, [
63
+ 'ls-files',
64
+ '--cached',
65
+ '--others',
66
+ '--exclude-standard',
67
+ '-z',
68
+ ])
69
+ )
70
+ .split('\0')
71
+ .filter(Boolean);
72
+ const unique = [...new Set(paths)]
73
+ .filter((p) => !p.split('/').includes('.git'))
74
+ .sort();
75
+ const bounded: string[] = []; let bytes = 0;
76
+ for (const file of unique) {
77
+ bytes += Buffer.byteLength(file) + 4;
78
+ if (bounded.length >= 15000 || bytes > 1024 * 1024) break;
79
+ bounded.push(file);
80
+ }
81
+ // Git's ordinary file index omits empty directories. Ask Git for untracked
82
+ // directory roots so ignored trees stay excluded, then descend with a bound.
83
+ const directories: string[] = [], queue = [''];
84
+ let scanned = 0;
85
+ while (queue.length && scanned++ < 64 && bytes < 1024 * 1024 && directories.length < 1000) {
86
+ const parent = queue.shift()!;
87
+ const cwd = parent ? await this.resolve(id, parent) : this.get(id).path;
88
+ const children = parent ? (await fs.readdir(cwd, { withFileTypes: true }))
89
+ .filter(entry => entry.isDirectory() && entry.name.toLowerCase() !== '.git').map(entry => entry.name) : [];
90
+ if (parent && !children.length) continue;
91
+ const entries = (await git(cwd, ['ls-files', '--others', '--directory', '--exclude-standard', '-z',
92
+ ...(parent ? ['--', ...children] : [])])).split('\0');
93
+ for (const entry of entries) {
94
+ if (!entry.endsWith('/')) continue;
95
+ const directory = `${parent ? parent + '/' : ''}${entry.slice(0, -1)}`;
96
+ validateEditorPath(directory);
97
+ bytes += Buffer.byteLength(directory) + 4;
98
+ if (bytes >= 1024 * 1024 || directories.length >= 1000) break;
99
+ directories.push(directory);
100
+ queue.push(directory);
101
+ }
102
+ }
103
+ return { paths: bounded, directories, truncated: bounded.length < unique.length || queue.length > 0 || bytes >= 1024 * 1024 };
104
+ }
105
+ async read(id: string, relative: string): Promise<FileContent> {
106
+ const target = await this.resolve(id, relative);
107
+ const stat = await fs.stat(target);
108
+ if (!stat.isFile()) throw new Error('Only regular files can be edited.');
109
+ if (stat.size > MAX_FILE_BYTES)
110
+ throw new Error('This file exceeds the 2 MB editor limit.');
111
+ const bytes = await fs.readFile(target);
112
+ if (bytes.includes(0))
113
+ throw new Error('Binary files cannot be edited as text.');
114
+ const text = new TextDecoder('utf-8', {
115
+ fatal: true,
116
+ ignoreBOM: true,
117
+ }).decode(bytes);
118
+ return { path: relative, text, version: hash(bytes) };
119
+ }
120
+ async imagePreview(id: string, relative: string): Promise<ImagePreview> {
121
+ const target = await this.resolve(id, relative);
122
+ const file = await fs.open(target, 'r');
123
+ try {
124
+ const stat = await file.stat();
125
+ if (!stat.isFile()) throw new Error('Only regular files can be previewed.');
126
+ if (stat.size > MAX_FILE_BYTES) throw new Error('This image exceeds the 2 MB preview limit.');
127
+ // Bound the read even if another process grows the file after stat.
128
+ const buffer = Buffer.alloc(MAX_FILE_BYTES + 1);
129
+ let bytesRead = 0;
130
+ while (bytesRead < buffer.length) {
131
+ const part = await file.read(buffer, bytesRead, buffer.length - bytesRead, bytesRead);
132
+ if (!part.bytesRead) break;
133
+ bytesRead += part.bytesRead;
134
+ }
135
+ if (bytesRead > MAX_FILE_BYTES) throw new Error('This image exceeds the 2 MB preview limit.');
136
+ const bytes = buffer.subarray(0, bytesRead);
137
+ const mime = bytes.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])) ? 'image/png'
138
+ : bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255 ? 'image/jpeg'
139
+ : ['GIF87a', 'GIF89a'].includes(bytes.subarray(0, 6).toString('ascii')) ? 'image/gif'
140
+ : bytes.subarray(0, 4).toString('ascii') === 'RIFF' && bytes.subarray(8, 12).toString('ascii') === 'WEBP' ? 'image/webp'
141
+ : undefined;
142
+ if (!mime) throw new Error('This file is not a supported PNG, JPEG, GIF or WebP image.');
143
+ return { path: relative, dataUrl: `data:${mime};base64,${bytes.toString('base64')}` };
144
+ } finally { await file.close(); }
145
+ }
146
+ async save(
147
+ id: string,
148
+ relative: string,
149
+ text: string,
150
+ version: string,
151
+ ): Promise<SaveResult> {
152
+ if (Buffer.byteLength(text) > MAX_FILE_BYTES)
153
+ throw new Error('This file exceeds the 2 MB editor limit.');
154
+ let key: string;
155
+ try { key = await this.resolve(id, relative); }
156
+ catch (error) {
157
+ if ((error as NodeJS.ErrnoException).code === 'ENOENT') return { ok: false, disk: null };
158
+ throw error;
159
+ }
160
+ const previous = this.fileLocks.get(key) ?? Promise.resolve();
161
+ const operation = previous
162
+ .catch(() => {})
163
+ .then(async (): Promise<SaveResult> => {
164
+ let disk: FileContent;
165
+ try {
166
+ disk = await this.read(id, relative);
167
+ } catch (error) {
168
+ if ((error as NodeJS.ErrnoException).code === 'ENOENT')
169
+ return { ok: false, disk: null };
170
+ throw error;
171
+ }
172
+ if (disk.version !== version) return { ok: false, disk };
173
+ const target = await this.resolve(id, relative);
174
+ const stat = await fs.stat(target);
175
+ const temporary = path.join(
176
+ path.dirname(target),
177
+ `.lucidity-save-${randomUUID()}`,
178
+ );
179
+ try {
180
+ await fs.writeFile(temporary, text, { mode: stat.mode, flag: 'wx' });
181
+ // Check again after preparing the replacement. Serializes app writes; external
182
+ // writers do not share this lock, so this is optimistic conflict detection.
183
+ const latest = await this.read(id, relative);
184
+ if (latest.version !== version) return { ok: false, disk: latest };
185
+ await fs.rename(temporary, target);
186
+ } finally {
187
+ await fs.rm(temporary, { force: true });
188
+ }
189
+ return {
190
+ ok: true,
191
+ file: { path: relative, text, version: hash(text) },
192
+ };
193
+ });
194
+ this.fileLocks.set(key, operation);
195
+ try {
196
+ return await operation;
197
+ } finally {
198
+ if (this.fileLocks.get(key) === operation) this.fileLocks.delete(key);
199
+ }
200
+ }
201
+ async changes(id: string): Promise<Changes> {
202
+ const ws = this.get(id);
203
+ const raw = (
204
+ await git(ws.path, [
205
+ 'status',
206
+ '--porcelain=v1',
207
+ '-z',
208
+ '--untracked-files=all',
209
+ ])
210
+ ).split('\0');
211
+ const files: Changes['files'] = [];
212
+ for (let i = 0; i < raw.length; i++) {
213
+ const item = raw[i];
214
+ if (!item) continue;
215
+ const status = item.slice(0, 2);
216
+ const file = item.slice(3);
217
+ const change: Changes['files'][number] = {
218
+ path: file,
219
+ status: status.trim(),
220
+ };
221
+ if (status.includes('R') || status.includes('C'))
222
+ change.previousPath = raw[++i];
223
+ files.push(change);
224
+ if (files.length > 3000) throw new Error('Too many changed files for the Git panel. Use the terminal to review this workspace.');
225
+ }
226
+ const branch =
227
+ (await git(ws.path, ['branch', '--show-current'])).trim() || 'detached';
228
+ let head = '';
229
+ try {
230
+ head = (await git(ws.path, ['rev-parse', '--verify', 'HEAD'])).trim();
231
+ } catch {
232
+ /* Unborn HEAD. */
233
+ }
234
+ ws.branch = branch;
235
+ const upstream = branch === 'detached' ? null :
236
+ (await git(ws.path, ['for-each-ref', '--format=%(upstream:short)', `refs/heads/${branch}`])).trim() || null;
237
+ let tracking: Pick<Changes, 'ahead' | 'behind'> = {};
238
+ if (upstream && head) {
239
+ try {
240
+ const [ahead, behind] = (await git(ws.path, ['rev-list', '--left-right', '--count', 'HEAD...@{upstream}'])).trim().split(/\s+/).map(Number);
241
+ if (Number.isSafeInteger(ahead) && Number.isSafeInteger(behind) && ahead! >= 0 && behind! >= 0)
242
+ tracking = { ahead, behind };
243
+ } catch { /* The upstream can be configured but not fetched yet. Never report zero for unknown counts. */ }
244
+ }
245
+ return { branch, head, files, upstream, ...tracking };
246
+ }
247
+ async diff(id: string, relative: string): Promise<FileDiff> {
248
+ // Validate lexically even for a deleted path; don't use arbitrary Git revisions.
249
+ validateEditorPath(relative);
250
+ const ws = this.get(id);
251
+ let before = '';
252
+ let after = '';
253
+ const change = (await this.changes(id)).files.find(
254
+ (f) => f.path === relative,
255
+ );
256
+ try {
257
+ before = await git(ws.path, [
258
+ 'show',
259
+ `HEAD:${change?.previousPath || relative}`,
260
+ ]);
261
+ } catch (error) {
262
+ // A missing HEAD blob is normal for untracked/added files; other Git errors
263
+ // are surfaced by the status request that supplies this path.
264
+ const listed = await this.changes(id);
265
+ if (!listed.files.some((f) => f.path === relative)) throw error;
266
+ }
267
+ try {
268
+ after = (await this.read(id, relative)).text;
269
+ } catch (error) {
270
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
271
+ }
272
+ if (before.includes('\0') || before.length > MAX_FILE_BYTES)
273
+ throw new Error('This diff is too large or contains binary data.');
274
+ return { path: relative, before, after, base: 'HEAD' };
275
+ }
276
+ }