@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,162 @@
1
+ import { z } from 'zod';
2
+ import {
3
+ DaemonReleaseSchema, DaemonReleaseManifestSchema, DaemonUpdateChannelSchema, DaemonVersionSchema,
4
+ compareDaemonVersions, decideDaemonUpdate, type DaemonInstallation, type DaemonRelease, type DaemonUpdateDecision,
5
+ } from './daemonUpdates.js';
6
+
7
+ const ProtocolsSchema = z.array(z.number().int().positive().max(1000)).min(1).max(16)
8
+ .refine((values) => new Set(values).size === values.length, 'Duplicate protocol');
9
+ export const ClientReleaseSchema = z.object({
10
+ // Immutable identity includes native build and OTA revision, not only the display version.
11
+ id: z.string().regex(/^[a-zA-Z0-9._-]{1,120}$/),
12
+ generation: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
13
+ platform: z.enum(['ios', 'android', 'macos', 'windows']),
14
+ appVersion: DaemonVersionSchema,
15
+ protocols: ProtocolsSchema,
16
+ minimumDaemon: DaemonVersionSchema,
17
+ recommendedDaemon: DaemonVersionSchema,
18
+ supported: z.boolean(),
19
+ }).strict().refine((release) => compareDaemonVersions(release.recommendedDaemon, release.minimumDaemon) >= 0,
20
+ { message: 'Recommended daemon must meet the client minimum' });
21
+ export type ClientRelease = z.infer<typeof ClientReleaseSchema>;
22
+ /** Retained for existing mobile consumers. */
23
+ export const MobileReleaseSchema = ClientReleaseSchema;
24
+ export type MobileRelease = ClientRelease;
25
+
26
+ export const CompatibleDaemonSchema = z.object({
27
+ artifact: DaemonReleaseSchema,
28
+ clientProtocols: ProtocolsSchema,
29
+ serverProtocols: ProtocolsSchema,
30
+ features: z.array(z.string().min(1).max(80)).max(64),
31
+ }).strict();
32
+ export type CompatibleDaemon = z.infer<typeof CompatibleDaemonSchema>;
33
+
34
+ /** Highest mutually understood protocol. Features still need their own capability check. */
35
+ export function negotiateComputerProtocol(client: readonly number[], daemon: readonly number[]): number | null {
36
+ const common = client.filter((protocol) => daemon.includes(protocol));
37
+ return common.length ? Math.max(...common) : null;
38
+ }
39
+
40
+ export const ReleaseCatalogSchema = z.object({
41
+ schema: z.literal(2), channel: DaemonUpdateChannelSchema,
42
+ sequence: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
43
+ issuedAt: z.string().datetime(), expiresAt: z.string().datetime(),
44
+ minimumVersion: DaemonVersionSchema,
45
+ withdrawnVersions: z.array(DaemonVersionSchema).max(1000),
46
+ distributionPaused: z.boolean(),
47
+ serverProtocols: ProtocolsSchema,
48
+ rollout: z.object({ percent: z.number().int().min(0).max(100), salt: z.string().min(1).max(100) }).strict(),
49
+ clients: z.array(ClientReleaseSchema).max(512),
50
+ daemons: z.array(CompatibleDaemonSchema).min(1).max(128),
51
+ }).strict().superRefine((catalog, ctx) => {
52
+ const invalid = (message: string) => ctx.addIssue({ code: 'custom', message });
53
+ const lifetime = Date.parse(catalog.expiresAt) - Date.parse(catalog.issuedAt);
54
+ if (lifetime <= 0 || lifetime > 30 * 86400_000) invalid('Catalog validity must be between zero and 30 days');
55
+ if (new Set(catalog.clients.map((release) => release.id)).size !== catalog.clients.length) invalid('Duplicate client release ID');
56
+ if (new Set(catalog.clients.map((release) => `${release.platform}:${release.generation}`)).size !== catalog.clients.length)
57
+ invalid('Duplicate client release generation');
58
+ if (new Set(catalog.daemons.map((release) => release.artifact.version)).size !== catalog.daemons.length) invalid('Duplicate daemon version');
59
+ for (const client of catalog.clients.filter((release) => release.supported)) {
60
+ const recommended = catalog.daemons.find((release) => release.artifact.version === client.recommendedDaemon);
61
+ if (!recommended || negotiateComputerProtocol(client.protocols, recommended.clientProtocols) === null)
62
+ invalid(`Client release ${client.id} needs a declared compatible recommendation`);
63
+ }
64
+ });
65
+ export type ReleaseCatalog = z.infer<typeof ReleaseCatalogSchema>;
66
+ export const DaemonUpdatePolicySchema = z.union([DaemonReleaseManifestSchema, ReleaseCatalogSchema]);
67
+ export type DaemonUpdatePolicy = z.infer<typeof DaemonUpdatePolicySchema>;
68
+
69
+ /** Retire releases explicitly; removing and later reusing an identity must not rewrite history. */
70
+ export function assertCatalogEvolution(previous: ReleaseCatalog, next: ReleaseCatalog): void {
71
+ if (previous.channel !== next.channel) throw new Error('Release channel mismatch');
72
+ for (const old of previous.clients) {
73
+ const current = next.clients.find((client) => client.id === old.id);
74
+ if (!current) throw new Error('Published client releases must be retained or explicitly retired');
75
+ if (JSON.stringify({ ...old, supported: true }) !== JSON.stringify({ ...current, supported: true }))
76
+ throw new Error('Published client compatibility declarations are immutable');
77
+ }
78
+ for (const old of previous.daemons) {
79
+ const current = next.daemons.find((daemon) => daemon.artifact.version === old.artifact.version);
80
+ if (!current || JSON.stringify(old) !== JSON.stringify(current))
81
+ throw new Error('Published daemon compatibility declarations are immutable');
82
+ }
83
+ }
84
+
85
+ export const ComputerClientSchema = z.object({
86
+ deviceId: z.string().min(1).max(128),
87
+ releaseId: z.string().regex(/^[a-zA-Z0-9._-]{1,120}$/),
88
+ }).strict();
89
+ export type ComputerClient = z.infer<typeof ComputerClientSchema>;
90
+ export type DeviceCompatibility = ComputerClient & {
91
+ state: 'ready' | 'update_app' | 'update_computer' | 'unknown_release';
92
+ protocol: number | null;
93
+ };
94
+ export type CoordinatedUpdateDecision = Omit<DaemonUpdateDecision, 'reason'> & {
95
+ reason: DaemonUpdateDecision['reason'] | 'unknown_client' | 'unknown_daemon' | 'compatibility_conflict' | 'distribution_paused' | 'missing_capability';
96
+ target: DaemonRelease | null;
97
+ devices: DeviceCompatibility[];
98
+ };
99
+
100
+ export function catalogDaemonSupported(catalog: ReleaseCatalog, version: string): boolean {
101
+ const daemon = catalog.daemons.find((entry) => entry.artifact.version === version);
102
+ return Boolean(daemon && compareDaemonVersions(version, catalog.minimumVersion) >= 0 &&
103
+ !catalog.withdrawnVersions.includes(version) && negotiateComputerProtocol(daemon.serverProtocols, catalog.serverProtocols) !== null);
104
+ }
105
+
106
+ function supportsClient(daemon: CompatibleDaemon, client: ClientRelease): boolean {
107
+ return compareDaemonVersions(daemon.artifact.version, client.minimumDaemon) >= 0 &&
108
+ negotiateComputerProtocol(client.protocols, daemon.clientProtocols) !== null;
109
+ }
110
+
111
+ export function computerClientCompatibility(catalog: ReleaseCatalog, version: string, devices: readonly ComputerClient[]): DeviceCompatibility[] {
112
+ const daemon = catalog.daemons.find((entry) => entry.artifact.version === version);
113
+ return devices.map((device) => {
114
+ const client = catalog.clients.find((entry) => entry.id === device.releaseId);
115
+ const protocol = daemon && client ? negotiateComputerProtocol(client.protocols, daemon.clientProtocols) : null;
116
+ const state = !client ? 'unknown_release' : !client.supported ? 'update_app' :
117
+ daemon && catalogDaemonSupported(catalog, version) && supportsClient(daemon, client) ? 'ready' : 'update_computer';
118
+ return { ...device, state, protocol: state === 'ready' ? protocol : null };
119
+ });
120
+ }
121
+
122
+ /** Pure release selection. Only authenticated, catalog-recognized device reports may enroll. */
123
+ export function selectDaemonRelease(catalog: ReleaseCatalog, installed: DaemonInstallation, devices: readonly ComputerClient[], requiredFeatures: readonly string[] = []): CoordinatedUpdateDecision {
124
+ if (catalog.channel !== installed.channel) throw new Error('Update channel mismatch');
125
+ if (!Number.isFinite(installed.rolloutBucket) || installed.rolloutBucket < 0 || installed.rolloutBucket >= 100)
126
+ throw new Error('Invalid rollout bucket');
127
+ const deviceStates = computerClientCompatibility(catalog, installed.version, devices);
128
+ const globalBlock = !catalogDaemonSupported(catalog, installed.version);
129
+ const required = globalBlock || deviceStates.some((device) => device.state === 'update_computer');
130
+ const result = (action: CoordinatedUpdateDecision['action'], reason: CoordinatedUpdateDecision['reason'], target: DaemonRelease | null = null): CoordinatedUpdateDecision =>
131
+ ({ action, reason, target, required, allowNewWork: !globalBlock, devices: deviceStates });
132
+ if (!installed.managed) return result('unmanaged', 'unmanaged');
133
+ if (!catalog.daemons.some((daemon) => daemon.artifact.version === installed.version)) return result('blocked', 'unknown_daemon');
134
+ if (deviceStates.some((device) => device.state === 'unknown_release')) return result('blocked', 'unknown_client');
135
+ const clients = devices.flatMap((device) => catalog.clients.filter((client) => client.id === device.releaseId && client.supported));
136
+ let wanted = catalog.minimumVersion;
137
+ for (const client of clients) if (compareDaemonVersions(client.recommendedDaemon, wanted) > 0) wanted = client.recommendedDaemon;
138
+ const hasFeatures = (daemon: CompatibleDaemon) => requiredFeatures.every(feature => daemon.features.includes(feature));
139
+ const capabilityMissing = !hasFeatures(catalog.daemons.find(daemon => daemon.artifact.version === installed.version)!);
140
+ if (!required && !capabilityMissing && compareDaemonVersions(installed.version, wanted) >= 0)
141
+ return result('none', clients.length ? 'current' : 'no_client_requirement');
142
+ if (catalog.distributionPaused) return result('blocked', 'distribution_paused');
143
+ // Old supported devices constrain every candidate, even while asleep/disconnected.
144
+ const candidates = catalog.daemons.filter((daemon) =>
145
+ compareDaemonVersions(daemon.artifact.version, installed.version) > 0 &&
146
+ compareDaemonVersions(daemon.artifact.version, wanted) >= 0 &&
147
+ hasFeatures(daemon) && catalogDaemonSupported(catalog, daemon.artifact.version) && clients.every((client) => supportsClient(daemon, client)))
148
+ .sort((a, b) => compareDaemonVersions(a.artifact.version, b.artifact.version));
149
+ if (!candidates.length) return result('blocked', capabilityMissing ? 'missing_capability' : 'compatibility_conflict');
150
+ // Prefer the lowest tested release satisfying all requirements, never the newest by default.
151
+ let blocked: CoordinatedUpdateDecision | undefined;
152
+ for (const candidate of candidates) {
153
+ const gate = decideDaemonUpdate({ schema: 1, channel: catalog.channel, sequence: catalog.sequence,
154
+ issuedAt: catalog.issuedAt, expiresAt: catalog.expiresAt, minimumVersion: catalog.minimumVersion,
155
+ withdrawnVersions: catalog.withdrawnVersions, release: candidate.artifact,
156
+ rollout: required ? { ...catalog.rollout, percent: 100 } : catalog.rollout,
157
+ }, installed, true);
158
+ if (gate.action === 'stage') return result('stage', 'update', candidate.artifact);
159
+ blocked ??= result(gate.action, gate.reason);
160
+ }
161
+ return blocked!;
162
+ }
@@ -0,0 +1,44 @@
1
+ import { z } from 'zod';
2
+ import { ParticipantIdentitySchema } from './agentMessages.js';
3
+
4
+ export const RepositoryDestinationInputSchema = z.object({
5
+ id: z.uuidv7(), projectId: z.uuid(), computerId: z.string().min(1).max(128),
6
+ repoId: z.string().min(1).max(255), enabled: z.boolean(),
7
+ }).strict();
8
+ export const RepositoryDestinationSchema = RepositoryDestinationInputSchema.extend({
9
+ owner: ParticipantIdentitySchema, projectName: z.string(),
10
+ });
11
+ export const RepositoryRequestInputSchema = z.object({
12
+ id: z.uuidv7(), destinationId: z.uuidv7(), prompt: z.string().min(1).max(100_000).refine(value => !!value.trim(), 'Write a prompt first.'),
13
+ }).strict();
14
+ export const RepositoryRequestTargetSchema = z.object({
15
+ workerId: z.uuidv7().optional(), mode: z.enum(['in-place', 'worktree']),
16
+ conversationRevision: z.string().min(1).max(128), expectedBranch: z.string().min(1).max(255),
17
+ }).strict().refine(value => value.mode === 'in-place' || !!value.workerId, 'Choose an existing worktree.');
18
+ export const RepositoryRequestApprovalSchema = z.object({
19
+ digest: z.string().regex(/^[a-f0-9]{64}$/), target: RepositoryRequestTargetSchema,
20
+ }).strict();
21
+ export const RepositoryRequestSchema = RepositoryRequestInputSchema.extend({
22
+ digest: z.string(), status: z.enum(['pending', 'approved', 'delivering', 'queued', 'delivered', 'declined', 'cancelled', 'unavailable']),
23
+ sender: ParticipantIdentitySchema, recipient: ParticipantIdentitySchema,
24
+ repoId: z.string(), projectName: z.string(), computerId: z.string(),
25
+ createdAt: z.string(), target: RepositoryRequestTargetSchema.nullable(),
26
+ });
27
+ export const RepositoryInboxSchema = z.object({
28
+ requests: z.array(RepositoryRequestSchema), destinations: z.array(RepositoryDestinationSchema),
29
+ projects: z.array(z.object({ id: z.uuid(), name: z.string() })),
30
+ });
31
+ export type RepositoryDestination = z.infer<typeof RepositoryDestinationSchema>;
32
+ export type RepositoryRequest = z.infer<typeof RepositoryRequestSchema>;
33
+ export type RepositoryInbox = z.infer<typeof RepositoryInboxSchema>;
34
+ export type RepositoryRequestTarget = z.infer<typeof RepositoryRequestTargetSchema>;
35
+ export const RepositoryPendingCountSchema = z.object({
36
+ pending: z.number().int().nonnegative(),
37
+ // Optional while desktop/mobile and the API roll out independently.
38
+ repositories: z.array(z.object({ repoId: z.string(), pending: z.number().int().nonnegative() })).optional(),
39
+ });
40
+ export type RepositoryPendingCount = z.infer<typeof RepositoryPendingCountSchema>;
41
+ export const repositoryRequestStatus = {
42
+ pending: 'Awaiting approval', approved: 'Waiting for computer', delivering: 'Adding to queue', queued: 'Queued', delivered: 'Delivered to agent',
43
+ declined: 'Declined', cancelled: 'Cancelled', unavailable: 'Unavailable',
44
+ } satisfies Record<RepositoryRequest['status'], string>;
@@ -0,0 +1,117 @@
1
+ import { z } from 'zod';
2
+
3
+ export const RepositoryCandidateSchema = z
4
+ .object({
5
+ id: z.string().trim().min(1).max(200),
6
+ name: z.string().trim().min(1).max(200),
7
+ metadataRevision: z.string().min(1).max(100),
8
+ })
9
+ .strict();
10
+ export type RepositoryCandidate = z.infer<typeof RepositoryCandidateSchema>;
11
+
12
+ export const REPOSITORY_ROUTING_VERSION = '1';
13
+ export const ROUTING_CONSENT_VERSION = '2026-10-24.1';
14
+ export const ROUTING_CONSENT_DISCLOSURE = {
15
+ title: 'Allow repository routing?',
16
+ body: 'To choose a repository for an explicit Lucid request, Lucidity sends that comment or message, the task title and description when present, titles of related tasks with confirmed repository choices, and the names of repositories available on your computer to Vercel’s AI Gateway and TypeSafe’s Jev model. Confirmed repository choices may be reused on this computer for the same project. Other messages, notes and journal entries are not sent. You can turn this off from the request’s repository controls. This is separate from Fast AI consent.',
17
+ } as const;
18
+
19
+ export const RepositoryRoutingResultSchema = z.object({
20
+ kind: z.enum([
21
+ 'code',
22
+ 'general',
23
+ 'insufficient',
24
+ 'needs_consent',
25
+ 'unavailable',
26
+ ]),
27
+ repositoryId: z.string().nullable(),
28
+ method: z.enum([
29
+ 'selected',
30
+ 'named',
31
+ 'linked',
32
+ 'association',
33
+ 'jev',
34
+ 'local',
35
+ ]),
36
+ model: z.string(),
37
+ promptVersion: z.string(),
38
+ routingVersion: z.string(),
39
+ retrievalVersion: z.string(),
40
+ scores: z.record(z.string(), z.number().min(0).max(1)).default({}),
41
+ elapsedMs: z.number().nonnegative(),
42
+ costUsd: z.number().nonnegative().optional(),
43
+ });
44
+ export type RepositoryRoutingResult = z.infer<
45
+ typeof RepositoryRoutingResultSchema
46
+ >;
47
+
48
+ export const RepositoryRunSchema = z.object({
49
+ decisionId: z.uuid(),
50
+ workerId: z.uuid(),
51
+ runId: z.uuid(),
52
+ repositoryId: z.string(),
53
+ repositoryName: z.string(),
54
+ metadataRevision: z.string(),
55
+ state: z.enum([
56
+ 'selected',
57
+ 'verifying',
58
+ 'working',
59
+ 'completed',
60
+ 'stopped',
61
+ 'failed',
62
+ 'corrected',
63
+ ]),
64
+ });
65
+ export type RepositoryRun = z.infer<typeof RepositoryRunSchema>;
66
+
67
+ export const InvocationRoutingSchema = z.object({
68
+ computerId: z.uuid(),
69
+ revision: z.number().int().nonnegative(),
70
+ state: z.enum([
71
+ 'choosing',
72
+ 'needs_consent',
73
+ 'needs_repository',
74
+ 'general',
75
+ 'code',
76
+ ]),
77
+ candidates: z.array(RepositoryCandidateSchema).max(100),
78
+ runs: z.array(RepositoryRunSchema).max(10),
79
+ requestedRepositoryId: z.string().optional(),
80
+ requestedBy: z.enum(['user', 'agent']).optional(),
81
+ pendingDecisionId: z.uuid().optional(),
82
+ decisionStartedAt: z.string().optional(),
83
+ lastCommandId: z.uuid().optional(),
84
+ lastCommandHash: z.string().optional(),
85
+ });
86
+ export type InvocationRouting = z.infer<typeof InvocationRoutingSchema>;
87
+
88
+ /** Stored evidence contains identities and bounded reasons, never a conversation transcript. */
89
+ export const RepositoryRoutingEventSchema = z.object({
90
+ version: z.literal(1),
91
+ id: z.uuid(),
92
+ decisionId: z.uuid(),
93
+ invocationId: z.uuid(),
94
+ computerId: z.uuid(),
95
+ projectId: z.uuid().nullable(),
96
+ kind: z.enum(['decision', 'correction', 'outcome']),
97
+ candidates: z.array(RepositoryCandidateSchema).max(100),
98
+ selectedRepositoryId: z.string().nullable(),
99
+ previousRepositoryId: z.string().nullable().optional(),
100
+ reporter: z.enum(['router', 'user', 'agent']),
101
+ verification: z.enum(['tentative', 'user_confirmed', 'execution_verified']),
102
+ reason: z.string().max(1000),
103
+ evidence: z.array(z.string().max(500)).max(8),
104
+ outcome: z.enum([
105
+ 'selected',
106
+ 'unresolved',
107
+ 'started',
108
+ 'completed',
109
+ 'failed',
110
+ 'stopped',
111
+ 'corrected',
112
+ ]),
113
+ result: RepositoryRoutingResultSchema.optional(),
114
+ });
115
+ export type RepositoryRoutingEvent = z.infer<
116
+ typeof RepositoryRoutingEventSchema
117
+ >;
@@ -0,0 +1,351 @@
1
+ import { ComputerPresenceSchema, ControlDeviceProfileSchema, type ComputerPresence, type ControlDeviceProfile } from './computer.js';
2
+ import { HarnessRequestSchema, HarnessResponseSchema } from './schemas/harness.js';
3
+ import type { HarnessRequestInput, HarnessResponse } from './types.js';
4
+ import { WORKSPACE_IO_READ_ACTIONS } from './workspaceIO.js';
5
+ import { interactiveRoomRequest, type DeviceActivity } from './deviceInteraction.js';
6
+
7
+ function requestContext(input: HarnessRequestInput): { operation: string; readOnly: boolean } {
8
+ if (input.kind === 'repos') return { operation: 'repository list', readOnly: true };
9
+ if (input.kind === 'getConfig') return { operation: 'computer settings', readOnly: true };
10
+ if (input.kind === 'models') return { operation: 'provider model list', readOnly: true };
11
+ if (input.kind === 'mcp-status') return { operation: 'MCP status', readOnly: true };
12
+ if (input.kind === 'workspace-io') {
13
+ const action = input.command.operation.action;
14
+ const labels: Record<string, string> = { info: 'workspace details', files: 'file list', read: 'file preview', search: 'file search',
15
+ changes: 'Git changes', diff: 'file diff', terminalRead: 'terminal output', write: 'file save', commit: 'Git commit', push: 'Git push' };
16
+ return { operation: labels[action] ?? action, readOnly: WORKSPACE_IO_READ_ACTIONS.has(action) };
17
+ }
18
+ if (input.kind === 'workspaces') {
19
+ const action = input.command.action;
20
+ const labels: Record<string, string> = { list: 'workspace list', history: 'conversation history', settings: 'workspace settings',
21
+ 'model-settings': 'model settings', 'message-source': 'original message', 'message-image': 'image preview', 'pasted-text': 'pasted text', 'save-model-settings': 'model settings change',
22
+ create: 'worktree creation', archive: 'worktree archive', delete: 'worktree deletion', 'clear-history': 'history deletion' };
23
+ return { operation: labels[action] ?? action.replaceAll('-', ' '),
24
+ readOnly: ['list', 'settings', 'model-settings', 'message-source', 'message-image', 'pasted-text', 'delivery-status'].includes(action) || (action === 'history' && !input.command.open) };
25
+ }
26
+ return { operation: input.kind.replaceAll('-', ' '), readOnly: false };
27
+ }
28
+
29
+ /** Preserve the daemon's stable failure identity alongside its human message. */
30
+ export class RoomRequestError extends Error {
31
+ constructor(message: string, readonly code?: string) { super(message); this.name = 'RoomRequestError'; }
32
+ }
33
+
34
+ /** A missing response is not proof that a mutation failed. Keep its identity for diagnostics. */
35
+ export class RoomRequestTimeoutError extends Error {
36
+ readonly requestId: string;
37
+ readonly operation: string;
38
+ readonly readOnly: boolean;
39
+ constructor(input: HarnessRequestInput) {
40
+ const { operation, readOnly } = requestContext(input);
41
+ super(readOnly ? `Could not load ${operation} from your computer. Try again.`
42
+ : `Your computer has not confirmed ${operation}. It may still finish; check the result before trying again.`);
43
+ this.name = 'RoomRequestTimeoutError';
44
+ this.requestId = input.id; this.operation = operation; this.readOnly = readOnly;
45
+ }
46
+ }
47
+
48
+ /** Implemented by browser WebSocket, React Native, and Node ws. Credentials stay
49
+ * in the caller's socket factory; they never enter a URL or an event. */
50
+ type SocketHandler<T> = { handle(event: T): void }['handle'];
51
+ export interface ClientSocket {
52
+ readyState: number;
53
+ send(data: string): void;
54
+ close(code?: number, reason?: string): void;
55
+ onopen: SocketHandler<unknown> | null;
56
+ onmessage: SocketHandler<{ data: unknown }> | null;
57
+ onclose: SocketHandler<{ code: number }> | null;
58
+ onerror: SocketHandler<unknown> | null;
59
+ }
60
+ export type RoomFrame = Record<string, unknown>;
61
+ export type RoomClientEvent =
62
+ | { type: 'connection'; connected: boolean; presence: ComputerPresence | null; reason?: string }
63
+ | { type: 'frame'; frame: RoomFrame }
64
+ | { type: 'history-required'; requestId: string };
65
+ interface Pending {
66
+ resolve(value: HarnessResponse): void;
67
+ reject(error: Error): void;
68
+ timer: ReturnType<typeof setTimeout>;
69
+ }
70
+ interface WatchedTurn {
71
+ seq: number;
72
+ buffered: Map<number, RoomFrame>;
73
+ pulling: boolean;
74
+ }
75
+
76
+ export interface RoomClientOptions {
77
+ url: string;
78
+ deviceId: string;
79
+ deviceProfile?: ControlDeviceProfile;
80
+ explicitControl?: boolean;
81
+ automaticControl?: boolean;
82
+ release?: string;
83
+ socket(url: string): ClientSocket;
84
+ requestId(): string;
85
+ retryMs?: number;
86
+ requestTimeoutMs?: number;
87
+ }
88
+
89
+ /** A view onto the paired computer. Disconnects reject outstanding operations;
90
+ * reconnection replays output only. The caller reloads workspace history on a
91
+ * presence event, including after a computer identity change. */
92
+ export class RoomClient {
93
+ private foreground = true;
94
+ private lastInputAt = -Infinity;
95
+ private activityAnnounced = false;
96
+
97
+ activity(state: DeviceActivity): void {
98
+ if (state !== 'input') this.foreground = state === 'foreground';
99
+ if (!this.connected || !this.presence?.automaticControl) return;
100
+ if (state === 'input') {
101
+ if (Date.now() - this.lastInputAt < 1000) return;
102
+ this.lastInputAt = Date.now();
103
+ }
104
+ this.socket!.send(JSON.stringify({ type: 'client_activity', state }));
105
+ }
106
+ presence: ComputerPresence | null = null;
107
+ private socket?: ClientSocket;
108
+ private stopped = true;
109
+ private retry?: ReturnType<typeof setTimeout>;
110
+ private heartbeat?: ReturnType<typeof setInterval>;
111
+ private opening?: ReturnType<typeof setTimeout>;
112
+ private retries = 0;
113
+ private receivedAt = 0;
114
+ private computerId?: string;
115
+ private readonly listeners = new Set<(event: RoomClientEvent) => void>();
116
+ private readonly pending = new Map<string, Pending>();
117
+ private readonly turns = new Map<string, WatchedTurn>();
118
+
119
+ constructor(private readonly options: RoomClientOptions) {}
120
+
121
+ get connected(): boolean { return this.socket?.readyState === 1; }
122
+
123
+ subscribe(listener: (event: RoomClientEvent) => void): () => void {
124
+ this.listeners.add(listener);
125
+ return () => this.listeners.delete(listener);
126
+ }
127
+
128
+ start(): void {
129
+ if (!this.stopped) return;
130
+ this.stopped = false;
131
+ this.connect(false);
132
+ }
133
+
134
+ takeControl(): void {
135
+ if (this.connected && this.presence?.automaticControl) { this.activity('input'); return; }
136
+ this.disconnect('Switching control. Check saved history before retrying an operation.');
137
+ this.stopped = false;
138
+ this.connect(true);
139
+ }
140
+
141
+ renameDevice(name: string): void {
142
+ const profile = ControlDeviceProfileSchema.parse({ ...this.options.deviceProfile, name });
143
+ this.options.deviceProfile = profile;
144
+ try { if (this.connected && this.presence?.devices) this.socket!.send(JSON.stringify({ type: 'client_hello', ...profile })); }
145
+ catch { /* The next handshake carries the saved name after a socket closes. */ }
146
+ }
147
+
148
+ close(): void {
149
+ this.stopped = true;
150
+ this.disconnect('Disconnected. An operation already sent may still finish on your computer.');
151
+ this.turns.clear();
152
+ this.computerId = undefined;
153
+ }
154
+
155
+ /** Use for streaming turns, pull, and cancel. A successful send is not a
156
+ * durable receipt. Only the computer's accepted event confirms acceptance. */
157
+ send(input: HarnessRequestInput): void {
158
+ const request = HarnessRequestSchema.parse(input);
159
+ if (!this.connected || !this.presence?.daemonConnected)
160
+ throw new Error('Your computer is unavailable. Your request has not been sent.');
161
+ this.socket!.send(JSON.stringify(interactiveRoomRequest(request, this.presence)));
162
+ }
163
+
164
+ /** Buffered queries and controls return the correlated response. Nothing is
165
+ * automatically retried, including requests whose response was lost. */
166
+ request(input: HarnessRequestInput): Promise<HarnessResponse> {
167
+ if (this.pending.has(input.id)) return Promise.reject(new Error('Request is already pending.'));
168
+ return new Promise((resolve, reject) => {
169
+ const timer = setTimeout(() => {
170
+ this.pending.delete(input.id);
171
+ reject(new RoomRequestTimeoutError(input));
172
+ }, this.options.requestTimeoutMs ?? (input.kind === 'workspaces' && input.command.action === 'refresh-title' ? 90_000 : 30_000));
173
+ this.pending.set(input.id, { resolve, reject, timer });
174
+ try { this.send(input); }
175
+ catch (error) { this.finish(input.id, error instanceof Error ? error : new Error(String(error))); }
176
+ });
177
+ }
178
+
179
+ /** Install the cursor from durable history before following live output.
180
+ * Repeated calls may advance it but cannot erase already received frames. */
181
+ watchTurn(requestId: string, sinceSeq = 0, recover = true): void {
182
+ if (!Number.isSafeInteger(sinceSeq) || sinceSeq < 0) throw new Error('Invalid output cursor.');
183
+ let turn = this.turns.get(requestId);
184
+ if (!turn) {
185
+ if (this.turns.size >= 64) throw new Error('Too many watched turns.');
186
+ turn = { seq: sinceSeq, buffered: new Map(), pulling: false };
187
+ this.turns.set(requestId, turn);
188
+ } else {
189
+ turn.seq = Math.max(turn.seq, sinceSeq);
190
+ for (const seq of turn.buffered.keys()) if (seq <= turn.seq) turn.buffered.delete(seq);
191
+ this.drain(turn);
192
+ }
193
+ // A caller can install a new turn before sending it. Pulling at that point
194
+ // would ask the daemon for a request that it has not accepted yet.
195
+ if (recover) this.pull(requestId, turn);
196
+ }
197
+
198
+ unwatchTurn(requestId: string): void { this.turns.delete(requestId); }
199
+
200
+ private emit(event: RoomClientEvent): void {
201
+ for (const listener of this.listeners) listener(event);
202
+ }
203
+
204
+ private finish(id: string, result: HarnessResponse | Error): void {
205
+ const pending = this.pending.get(id);
206
+ if (!pending) return;
207
+ clearTimeout(pending.timer);
208
+ this.pending.delete(id);
209
+ if (result instanceof Error) pending.reject(result);
210
+ else pending.resolve(result);
211
+ }
212
+
213
+ private disconnect(reason: string): void {
214
+ clearTimeout(this.retry);
215
+ clearTimeout(this.opening);
216
+ clearInterval(this.heartbeat);
217
+ const socket = this.socket;
218
+ this.socket = undefined;
219
+ // A close from an older connection must not clear a newer connection.
220
+ if (socket) {
221
+ socket.onopen = socket.onmessage = socket.onclose = null;
222
+ socket.onerror = () => {};
223
+ socket.close();
224
+ }
225
+ for (const id of this.pending.keys()) this.finish(id, new Error(reason));
226
+ for (const turn of this.turns.values()) turn.pulling = false;
227
+ this.presence = null;
228
+ this.emit({ type: 'connection', connected: false, presence: null, reason });
229
+ }
230
+
231
+ private connect(takeover: boolean): void {
232
+ if (this.stopped) return;
233
+ const url = new URL(this.options.url);
234
+ if (!['http:', 'https:', 'ws:', 'wss:'].includes(url.protocol)) throw new Error('Invalid relay URL.');
235
+ url.protocol = url.protocol === 'http:' || url.protocol === 'ws:' ? 'ws:' : 'wss:';
236
+ url.searchParams.set('role', 'phone'); // Existing relay name for any UI client.
237
+ url.searchParams.set('device', this.options.deviceId);
238
+ if (this.options.deviceProfile) {
239
+ url.searchParams.set('deviceName', this.options.deviceProfile.name);
240
+ url.searchParams.set('deviceKind', this.options.deviceProfile.kind);
241
+ }
242
+ url.searchParams.set('observe', '1');
243
+ if (this.options.explicitControl) url.searchParams.set('control', 'explicit');
244
+ if (this.options.automaticControl) url.searchParams.set('control', 'automatic');
245
+ url.searchParams.delete('takeover');
246
+ if (takeover) url.searchParams.set('takeover', '1');
247
+ if (this.options.release) url.searchParams.set('release', this.options.release);
248
+ let socket: ClientSocket;
249
+ try { socket = this.options.socket(url.toString()); }
250
+ catch { this.reconnect('Could not connect to Lucidity.'); return; }
251
+ this.socket = socket;
252
+ this.activityAnnounced = false;
253
+ this.lastInputAt = -Infinity;
254
+ this.opening = setTimeout(() => this.reconnect('Connection timed out.'), 15_000);
255
+ socket.onopen = () => {
256
+ if (this.socket !== socket) return;
257
+ clearTimeout(this.opening);
258
+ this.receivedAt = Date.now();
259
+ this.heartbeat = setInterval(() => {
260
+ if (Date.now() - this.receivedAt > 30_000) this.reconnect('Connection interrupted.');
261
+ else try { socket.send('{"t":"ka"}'); } catch { this.reconnect('Connection interrupted.'); }
262
+ }, 10_000);
263
+ this.emit({ type: 'connection', connected: true, presence: null });
264
+ };
265
+ socket.onmessage = ({ data }) => {
266
+ if (this.socket !== socket) return;
267
+ this.receivedAt = Date.now();
268
+ let frame: RoomFrame;
269
+ try { frame = JSON.parse(String(data)); } catch { return; }
270
+ if (!frame || typeof frame !== 'object' || Array.isArray(frame)) return;
271
+ this.receive(frame);
272
+ };
273
+ socket.onerror = () => {}; // close or the opening/heartbeat timeout handles recovery.
274
+ socket.onclose = ({ code }) => {
275
+ if (this.socket !== socket) return;
276
+ if ([4401, 4403, 4410].includes(code)) {
277
+ this.stopped = true;
278
+ this.disconnect(code === 4401 ? 'Sign in to reconnect.' : 'Connection refused. Reconnect to try again.');
279
+ } else this.reconnect(code === 4409 ? 'Another device took control.' : 'Connection interrupted.');
280
+ };
281
+ }
282
+
283
+ private reconnect(reason: string): void {
284
+ this.disconnect(reason);
285
+ if (this.stopped) return;
286
+ const delay = Math.min(15_000, (this.options.retryMs ?? 500) * 2 ** Math.min(this.retries++, 5));
287
+ // Reconnect as an observer even after takeover. Never steal control on retry.
288
+ this.retry = setTimeout(() => this.connect(false), delay);
289
+ }
290
+
291
+ private receive(frame: RoomFrame): void {
292
+ if (frame.type === 'presence') {
293
+ const parsed = ComputerPresenceSchema.safeParse(frame);
294
+ if (!parsed.success) return;
295
+ const id = parsed.data.computer?.id;
296
+ if (id && this.computerId && id !== this.computerId) {
297
+ this.turns.clear();
298
+ for (const pending of this.pending.keys()) this.finish(pending, new Error('The paired computer changed. Reload your workspace.'));
299
+ }
300
+ if (id) this.computerId = id;
301
+ const wasOnline = this.presence?.daemonConnected;
302
+ this.presence = parsed.data;
303
+ if (!this.activityAnnounced && this.presence.automaticControl) {
304
+ this.activityAnnounced = true;
305
+ this.activity(this.foreground ? 'foreground' : 'background');
306
+ }
307
+ this.retries = 0;
308
+ this.emit({ type: 'connection', connected: true, presence: this.presence });
309
+ if (this.presence.daemonConnected && !wasOnline)
310
+ for (const [requestId, turn] of this.turns) { turn.pulling = false; this.pull(requestId, turn); }
311
+ return;
312
+ }
313
+ if (frame.t === 'kb') return;
314
+ const id = typeof frame.requestId === 'string' ? frame.requestId : undefined;
315
+ if (id && frame.type === 'error' && typeof frame.message === 'string') this.finish(id, new RoomRequestError(frame.message, typeof frame.code === 'string' ? frame.code : undefined));
316
+ else if (id && this.pending.has(id)) {
317
+ const parsed = HarnessResponseSchema.safeParse(frame);
318
+ if (parsed.success) this.finish(id, parsed.data);
319
+ }
320
+ const turn = id ? this.turns.get(id) : undefined;
321
+ const seq = frame.seq;
322
+ if (turn && typeof seq === 'number' && Number.isSafeInteger(seq) && seq > 0) {
323
+ if (seq <= turn.seq) return;
324
+ turn.buffered.set(seq, frame);
325
+ this.drain(turn);
326
+ if (turn.buffered.size > 256) {
327
+ this.turns.delete(id!);
328
+ this.emit({ type: 'history-required', requestId: id! });
329
+ } else if (turn.buffered.size) this.pull(id!, turn);
330
+ return;
331
+ }
332
+ this.emit({ type: 'frame', frame });
333
+ }
334
+
335
+ private drain(turn: WatchedTurn): void {
336
+ while (turn.buffered.has(turn.seq + 1)) {
337
+ const frame = turn.buffered.get(++turn.seq)!;
338
+ turn.buffered.delete(turn.seq);
339
+ this.emit({ type: 'frame', frame });
340
+ }
341
+ if (!turn.buffered.size) turn.pulling = false;
342
+ }
343
+
344
+ private pull(requestId: string, turn: WatchedTurn): void {
345
+ if (turn.pulling || !this.connected || !this.presence?.daemonConnected) return;
346
+ try {
347
+ this.send({ id: this.options.requestId(), kind: 'pull', targetId: requestId, sinceSeq: turn.seq });
348
+ turn.pulling = true;
349
+ } catch { /* Presence/reconnect triggers output recovery again. */ }
350
+ }
351
+ }