@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
@@ -1,10 +1,13 @@
1
+ import { ClaudeSession } from './claudeSession.js';
2
+ import { RetainedSessions, sessionBindingFingerprint, reportSession, type SessionRetention, type SessionObserver } from './sessionRetention.js';
3
+ import { artifactFromToolResult } from '@lucidity/shared';
4
+ import { claudeUsage } from './usage.js';
1
5
  import {
2
6
  findAgentCommand,
3
7
  parseAgentCommand,
4
8
  type AgentCommandOption,
5
9
  } from '@lucidity/shared';
6
10
  import { randomUUID } from 'node:crypto';
7
- import { spawn } from 'node:child_process';
8
11
  import { readFileSync } from 'node:fs';
9
12
  import {
10
13
  query,
@@ -16,6 +19,7 @@ import {
16
19
  import { stripUnsafeEnv } from './claudeCode.js';
17
20
  import { AsyncQueue } from './asyncQueue.js';
18
21
  import { LiveTurns } from './liveTurns.js';
22
+ import { inheritsCodingIntegrations } from './integrations.js';
19
23
  import type {
20
24
  AgentExecutor,
21
25
  ExecutorRunInput,
@@ -73,6 +77,8 @@ export function claudeAgentOptions(
73
77
  input: ExecutorRunInput,
74
78
  oauthToken?: string,
75
79
  ): Options {
80
+ if (input.isolateContext && (input.resume || input.permissionMode || input.readTools?.length || input.allowedTools?.length || (!input.noTools && !input.mcp)))
81
+ throw new Error('Isolated context requires a fresh session with only explicit MCP tools.');
76
82
  if (
77
83
  input.effort &&
78
84
  !['low', 'medium', 'high', 'xhigh', 'max'].includes(input.effort)
@@ -87,13 +93,14 @@ export function claudeAgentOptions(
87
93
  : {};
88
94
  return {
89
95
  cwd: input.cwd,
90
- env: { ...claudeSubscriptionEnv(oauthToken), ...input.env },
96
+ env: { ...claudeSubscriptionEnv(oauthToken), ...input.env,
97
+ ...(input.isolateContext ? { CLAUDE_CODE_DISABLE_AUTO_MEMORY: '1' } : {}) },
91
98
  model: input.model,
92
99
  effort: input.effort as Options['effort'],
93
100
  outputFormat: input.outputSchema ? { type: 'json_schema', schema: input.outputSchema } : undefined,
94
101
  resume: input.resume,
95
102
  sessionId: input.resume ? undefined : input.sessionId,
96
- systemPrompt: input.systemPrompt
103
+ systemPrompt: input.isolateContext ? (input.systemPrompt ?? 'Answer using only the supplied context.') : input.systemPrompt
97
104
  ? { type: 'preset', preset: 'claude_code', append: input.systemPrompt }
98
105
  : { type: 'preset', preset: 'claude_code' },
99
106
  includePartialMessages: true,
@@ -103,7 +110,7 @@ export function claudeAgentOptions(
103
110
  input.permissionMode && !input.readTools
104
111
  ? ['user', 'project', 'local']
105
112
  : [],
106
- strictMcpConfig: true,
113
+ strictMcpConfig: !inheritsCodingIntegrations(input),
107
114
  mcpServers,
108
115
  permissionMode: input.permissionMode ?? 'default',
109
116
  allowDangerouslySkipPermissions:
@@ -149,6 +156,7 @@ export function claudeAgentOptions(
149
156
  : { behavior: 'deny', message: 'Permission was not granted.' };
150
157
  },
151
158
  ...(input.noTools ? { tools: [], allowedTools: [], mcpServers: {}, settingSources: [] } : {}),
159
+ ...(input.isolateContext ? { persistSession: false, tools: [], settingSources: [] } : {}),
152
160
  };
153
161
  }
154
162
 
@@ -163,9 +171,10 @@ export function requireClaudeSubscription(account: AccountInfo): void {
163
171
  'CLAUDE_CODE_OAUTH_TOKEN',
164
172
  'CLAUDE_CODE_OAUTH_TOKEN_FILE_DESCRIPTOR',
165
173
  ].includes(account.tokenSource ?? '');
166
- const subscription = /^Claude (Pro|Max|Teams?|Enterprise)$/i.test(
167
- account.subscriptionType ?? '',
168
- );
174
+ // The CLI builds the label from the plan name on the account, so a new plan needs no SDK
175
+ // release. "Claude API" is its fallback for an account with no subscription.
176
+ const label = account.subscriptionType ?? '';
177
+ const subscription = /^Claude \S/i.test(label) && !/^Claude API$/i.test(label);
169
178
  if (
170
179
  account.apiProvider !== 'firstParty' ||
171
180
  (!oauthSource && !subscription) ||
@@ -204,23 +213,56 @@ export class ClaudeAgentExecutor implements AgentExecutor {
204
213
  return { status: 'unsupported', reason: 'Claude SDK 0.3.287 history contains messages, not a durable run-completion receipt. Partial text cannot establish completion.' };
205
214
  }
206
215
  private readonly turns = new LiveTurns();
216
+ private readonly sessions: RetainedSessions<ClaudeSession>;
207
217
  constructor(
208
218
  private readonly options: {
209
219
  oauthToken?: string;
220
+ sessionRetention?: SessionRetention;
221
+ onSessionEvent?: SessionObserver;
210
222
  query?: typeof query;
211
223
  /** How long to wait for a closing loop after the last background task ends. */
212
224
  backgroundGraceMs?: number;
213
225
  } = {},
214
- ) {}
226
+ ) {
227
+ this.sessions = new RetainedSessions((s) => s.close(), (s) => s.isConnected, options.sessionRetention, options.onSessionEvent);
228
+ }
215
229
 
216
- steer(requestId: string, text: string) {
217
- return this.turns.steer(requestId, text);
230
+ steer(requestId: string, text: string, images?: ExecutorRunInput['images']) {
231
+ return this.turns.steer(requestId, text, images);
218
232
  }
219
233
  async interrupt(requestId: string) {
220
234
  return this.turns.interrupt(requestId);
221
235
  }
222
236
  async dispose() {
223
- await this.turns.dispose();
237
+ await Promise.all([this.turns.dispose(), this.sessions.dispose()]);
238
+ }
239
+
240
+ async usage() {
241
+ const incoming = new AsyncQueue<SDKUserMessage>();
242
+ const abortController = new AbortController();
243
+ const active = (this.options.query ?? query)({ prompt: incoming, options: {
244
+ ...claudeAgentOptions({ userPrompt: '' }, this.options.oauthToken), abortController,
245
+ } });
246
+ let timer: ReturnType<typeof setTimeout> | undefined;
247
+ try {
248
+ return await Promise.race([
249
+ (async () => {
250
+ requireClaudeSubscription(await active.accountInfo());
251
+ const read = active.usage_EXPERIMENTAL_MAY_CHANGE_DO_NOT_RELY_ON_THIS_API_YET;
252
+ if (typeof read !== 'function') return claudeUsage(null);
253
+ return claudeUsage(await read.call(active, { skipBehaviors: true }));
254
+ })(),
255
+ new Promise<never>((_, reject) => {
256
+ timer = setTimeout(() => reject(new Error('Claude usage is unavailable.')), 15_000);
257
+ }),
258
+ ]);
259
+ } finally {
260
+ clearTimeout(timer);
261
+ incoming.end();
262
+ abortController.abort();
263
+ active.close();
264
+ await active.return();
265
+ }
224
266
  }
225
267
 
226
268
  /** Start the SDK control channel without ever supplying an inference prompt. */
@@ -300,6 +342,35 @@ export class ClaudeAgentExecutor implements AgentExecutor {
300
342
  }
301
343
  }
302
344
 
345
+ async mcpStatus(input: Pick<ExecutorRunInput, 'cwd' | 'permissionMode' | 'mcp'> = {}): Promise<import('@lucidity/shared').AgentMcpServer[]> {
346
+ const incoming = new AsyncQueue<SDKUserMessage>();
347
+ const abortController = new AbortController();
348
+ const active = (this.options.query ?? query)({ prompt: incoming, options: {
349
+ ...claudeAgentOptions({ ...input, userPrompt: '' }, this.options.oauthToken), abortController,
350
+ } });
351
+ let timer: ReturnType<typeof setTimeout> | undefined;
352
+ try {
353
+ return await Promise.race([
354
+ (async () => {
355
+ requireClaudeSubscription(await active.accountInfo());
356
+ const deadline = Date.now() + 12_000;
357
+ let servers = await active.mcpServerStatus();
358
+ while (servers.some(server => server.status === 'pending') && Date.now() < deadline && !abortController.signal.aborted) {
359
+ await new Promise(resolve => setTimeout(resolve, 300));
360
+ if (abortController.signal.aborted) break;
361
+ servers = await active.mcpServerStatus();
362
+ }
363
+ return servers.map(server => ({ name: server.name.slice(0, 200), status: server.status,
364
+ ...(server.tools ? { toolCount: server.tools.length } : {}),
365
+ }));
366
+ })(),
367
+ new Promise<never>((_, reject) => { timer = setTimeout(() => reject(new Error('MCP discovery timed out.')), 20_000); }),
368
+ ]);
369
+ } finally {
370
+ clearTimeout(timer); incoming.end(); abortController.abort(); active.close(); await active.return();
371
+ }
372
+ }
373
+
303
374
  async run(input: ExecutorRunInput): Promise<ExecutorResult> {
304
375
  for await (const event of this.runStream(input))
305
376
  if (event.type === 'done') return event;
@@ -314,9 +385,12 @@ export class ClaudeAgentExecutor implements AgentExecutor {
314
385
  throw new Error('Start a conversation before using commands.');
315
386
  if (command && input.images?.length)
316
387
  throw new Error('Send commands without image attachments.');
317
- const incoming = new AsyncQueue<SDKUserMessage>();
388
+ let session: ClaudeSession | undefined;
389
+ let reusable = false;
390
+ let hadAmbientTasks = false;
318
391
  let commandOutput = '';
319
392
  let compacted = false;
393
+ let compacting = false;
320
394
  let cleared = false;
321
395
  let commandName = command?.name;
322
396
  let active: Query | undefined;
@@ -329,37 +403,48 @@ export class ClaudeAgentExecutor implements AgentExecutor {
329
403
  const carried: string[] = [];
330
404
  let carriedSession = '';
331
405
  let grace: ReturnType<typeof setTimeout> | undefined;
332
- const owner = this.turns.open(input, async (text) => {
406
+ const owner = this.turns.open(input, async (text, images) => {
333
407
  if (command)
334
408
  throw new Error(
335
409
  'Wait for the command to finish before sending a message.',
336
410
  );
337
411
  if (ended || !active || !ready)
338
412
  throw new Error('Claude has no active turn to steer.');
339
- const update = message({ userPrompt: text }, 'now');
413
+ const update = message({ userPrompt: text, images }, 'now');
340
414
  pending.add(update.uuid!);
341
- incoming.push(update);
415
+ session!.send(update);
342
416
  });
343
417
  const toolNames = new Map<string, string>();
344
418
  let initial = message(input);
345
419
  try {
346
420
  owner.check();
347
- active = (this.options.query ?? query)({
348
- prompt: incoming,
349
- options: {
350
- ...claudeAgentOptions(input, this.options.oauthToken),
351
- abortController: owner.controller,
352
- ...(input.onRecovery ? { spawnClaudeCodeProcess: (options: import('@anthropic-ai/claude-agent-sdk').SpawnOptions) => {
353
- const child = spawn(options.command, options.args, { cwd: options.cwd, env: options.env, signal: options.signal, stdio: ['pipe', 'pipe', 'pipe'] });
354
- child.stderr.on('data', () => {});
355
- try { input.onRecovery!({ pid: child.pid }); }
356
- catch (error) { child.kill('SIGKILL'); throw error; }
357
- return child;
358
- } } : {}),
359
- },
360
- });
421
+ const setupStarted = performance.now();
422
+ const options = claudeAgentOptions(input, this.options.oauthToken);
423
+ const { resume: _resume, sessionId: _id, canUseTool: _approve, ...binding } = options;
424
+ const fingerprint = sessionBindingFingerprint(binding);
425
+ session = await this.sessions.take(input.resume);
426
+ if (session && session.fingerprint !== fingerprint) {
427
+ await session.close();
428
+ reportSession(this.options.onSessionEvent, { action: 'closed', sessionId: input.resume, reason: 'configuration' });
429
+ session = undefined;
430
+ }
431
+ owner.check();
432
+ const reused = !!session;
433
+ if (session) session.bind(input, owner.controller.signal, options.canUseTool);
434
+ else session = new ClaudeSession(this.options.query ?? query, options, fingerprint, input, owner.controller.signal);
435
+ active = session.query;
361
436
  requireClaudeSubscription(await active.accountInfo());
437
+ input.onExecutionSettings?.({ stage: 'runtime-confirmed', evidence: 'authenticated-provider-query',
438
+ settings: { provider: 'claude', model: null, effort: null,
439
+ provenance: { provider: 'provider-response', model: 'not-reported', effort: 'not-reported' } } });
362
440
  owner.check();
441
+ input.onRecovery?.({ ...(session.pid ? { pid: session.pid } : {}),
442
+ ...(session.sessionId ? { sessionId: session.sessionId } : {}), inspectionDisabled: !!command });
443
+ if (session.sessionId) yield { type: 'session', sessionId: session.sessionId };
444
+ reportSession(this.options.onSessionEvent, {
445
+ action: reused ? 'reused' : input.resume ? 'resumed' : 'started',
446
+ sessionId: session.sessionId ?? input.resume, durationMs: Math.round(performance.now() - setupStarted), requestId: input.requestId,
447
+ });
363
448
  if (command) {
364
449
  const supported = findAgentCommand(
365
450
  chatCommands(await active.supportedCommands()),
@@ -377,20 +462,25 @@ export class ClaudeAgentExecutor implements AgentExecutor {
377
462
  yield { type: 'tool_call', name: `/${commandName}`, phase: 'start' };
378
463
  }
379
464
  input.onRecovery?.({ turnId: initial.uuid, inspectionDisabled: !!command });
380
- incoming.push(initial);
465
+ session.send(initial);
381
466
  ready = true;
382
- for await (const event of active) {
467
+ for await (const event of session.events()) {
383
468
  owner.check();
384
469
  if (event.type === 'system' && event.subtype === 'background_tasks_changed') {
470
+ hadAmbientTasks ||= event.tasks.some((task) => task.ambient);
385
471
  background = event.tasks.filter((task) => !task.ambient).length;
386
472
  // Finished work normally starts another loop. If none follows (a task was stopped,
387
473
  // say), close the input so the query ends and the turn settles with what it has.
388
474
  if (!background && carried.length && !grace)
389
- grace = setTimeout(() => incoming.end(), this.options.backgroundGraceMs ?? 90_000);
475
+ grace = setTimeout(() => session!.incoming.end(), this.options.backgroundGraceMs ?? 90_000);
390
476
  continue;
391
477
  }
392
478
  if (grace) { clearTimeout(grace); grace = undefined; }
393
479
  if (event.type === 'system' && event.subtype === 'init') {
480
+ session.sessionId = event.session_id;
481
+ input.onExecutionSettings?.({ stage: 'runtime-confirmed', sessionId: event.session_id, evidence: 'system-init',
482
+ settings: { provider: 'claude', model: event.model ?? null, effort: null,
483
+ provenance: { provider: 'provider-response', model: event.model ? 'provider-response' : 'not-reported', effort: 'not-reported' } } });
394
484
  input.onRecovery?.({ sessionId: event.session_id });
395
485
  yield { type: 'session', sessionId: event.session_id };
396
486
  }
@@ -402,8 +492,20 @@ export class ClaudeAgentExecutor implements AgentExecutor {
402
492
  commandOutput += event.content;
403
493
  yield { type: 'delta', text: event.content };
404
494
  }
405
- if (event.type === 'system' && event.subtype === 'compact_boundary')
495
+ if (event.type === 'system' && event.subtype === 'status') {
496
+ const active = event.status === 'compacting';
497
+ if (active !== compacting) {
498
+ compacting = active;
499
+ yield { type: 'compaction', phase: active ? 'start' : 'end' };
500
+ }
501
+ }
502
+ if (event.type === 'system' && event.subtype === 'compact_boundary') {
406
503
  compacted = true;
504
+ if (compacting) {
505
+ compacting = false;
506
+ yield { type: 'compaction', phase: 'end' };
507
+ }
508
+ }
407
509
  if (event.type === 'conversation_reset') cleared = true;
408
510
  if (event.type === 'user' && event.uuid) pending.delete(event.uuid);
409
511
  if (event.type === 'stream_event') {
@@ -429,6 +531,10 @@ export class ClaudeAgentExecutor implements AgentExecutor {
429
531
  for (const block of event.message.content)
430
532
  if (block.type === 'tool_result') {
431
533
  const name = toolNames.get(block.tool_use_id);
534
+ if (name === 'mcp__lucidity__attach_file' && !block.is_error) {
535
+ const artifact = artifactFromToolResult(block.content);
536
+ if (artifact) yield { type: 'artifact', artifact };
537
+ }
432
538
  if (name) {
433
539
  yield { type: 'tool_call', name, phase: 'end', itemId: block.tool_use_id, outcome: block.is_error ? 'failed' : 'completed' };
434
540
  toolNames.delete(block.tool_use_id);
@@ -460,6 +566,11 @@ export class ClaudeAgentExecutor implements AgentExecutor {
460
566
  if (input.outputSchema && event.structured_output === undefined)
461
567
  throw new Error('Claude did not return the requested structured result.');
462
568
  ended = true;
569
+ session.sessionId = event.session_id;
570
+ reusable = !command && !hadAmbientTasks && !input.isolateContext && !input.outputSchema;
571
+ const costUsd = Math.max(0, event.total_cost_usd - session.totalCostUsd);
572
+ session.totalCostUsd = event.total_cost_usd;
573
+ session.detach();
463
574
  if (command)
464
575
  yield { type: 'tool_call', name: `/${commandName}`, phase: 'end' };
465
576
  yield {
@@ -476,7 +587,7 @@ export class ClaudeAgentExecutor implements AgentExecutor {
476
587
  ? `/${commandName} completed.`
477
588
  : ''),
478
589
  sessionId: event.session_id,
479
- costUsd: event.total_cost_usd,
590
+ costUsd,
480
591
  };
481
592
  return;
482
593
  }
@@ -496,10 +607,11 @@ export class ClaudeAgentExecutor implements AgentExecutor {
496
607
  } finally {
497
608
  ended = true;
498
609
  clearTimeout(grace);
499
- incoming.end();
500
610
  try {
501
- active?.close();
502
- await active?.return();
611
+ if (session && reusable && session.sessionId && !owner.controller.signal.aborted) {
612
+ session.idle();
613
+ await this.sessions.keep(session.sessionId, session);
614
+ } else await session?.close();
503
615
  } finally { owner.close(); }
504
616
  }
505
617
  }
@@ -1,3 +1,4 @@
1
+ import { artifactFromToolResult } from '@lucidity/shared';
1
2
  import { spawn } from 'node:child_process';
2
3
  import { createInterface } from 'node:readline';
3
4
  import type {
@@ -181,8 +182,9 @@ interface StreamLine {
181
182
  event?: {
182
183
  type?: string;
183
184
  delta?: { text?: string };
184
- content_block?: { type?: string; name?: string };
185
+ content_block?: { type?: string; name?: string; id?: string };
185
186
  };
187
+ message?: { content?: Array<{ type?: string; tool_use_id?: string; is_error?: boolean; content?: unknown }> };
186
188
  result?: string;
187
189
  session_id?: string;
188
190
  total_cost_usd?: number;
@@ -244,7 +246,7 @@ export class ClaudeCodeExecutor implements AgentExecutor {
244
246
  fn();
245
247
  };
246
248
 
247
- const timer = setTimeout(() => {
249
+ const timer = input.timeoutMs === null ? undefined : setTimeout(() => {
248
250
  timedOut = true;
249
251
  controller.abort();
250
252
  }, timeoutMs);
@@ -327,7 +329,7 @@ export class ClaudeCodeExecutor implements AgentExecutor {
327
329
  const timeoutMs = input.timeoutMs ?? this.defaultTimeoutMs;
328
330
  const controller = new AbortController();
329
331
  let timedOut = false;
330
- const timer = setTimeout(() => {
332
+ const timer = input.timeoutMs === null ? undefined : setTimeout(() => {
331
333
  timedOut = true;
332
334
  controller.abort();
333
335
  }, timeoutMs);
@@ -357,6 +359,7 @@ export class ClaudeCodeExecutor implements AgentExecutor {
357
359
  if (!child.stdout)
358
360
  throw new Error('Claude Code produced no stdout stream.');
359
361
  const rl = createInterface({ input: child.stdout, crlfDelay: Infinity });
362
+ const toolNames = new Map<string, string>();
360
363
  for await (const line of rl) {
361
364
  const trimmed = line.trim();
362
365
  if (!trimmed) continue;
@@ -381,8 +384,19 @@ export class ClaudeCodeExecutor implements AgentExecutor {
381
384
  // Agentic (coding) runs: surface each tool call so the phone can show a
382
385
  // tool-use timeline. `phase:'end'` (via tool_result correlation) is a follow-up.
383
386
  const name = evt.event.content_block.name;
387
+ if (name && evt.event.content_block.id) toolNames.set(evt.event.content_block.id, name);
384
388
  if (typeof name === 'string' && name.length > 0)
385
389
  yield { type: 'tool_call', name, phase: 'start' };
390
+ } else if (evt.type === 'user' && Array.isArray(evt.message?.content)) {
391
+ for (const block of evt.message.content) {
392
+ if (block.type !== 'tool_result' || !block.tool_use_id) continue;
393
+ const name = toolNames.get(block.tool_use_id);
394
+ if (name === 'mcp__lucidity__attach_file' && !block.is_error) {
395
+ const artifact = artifactFromToolResult(block.content);
396
+ if (artifact) yield { type: 'artifact', artifact };
397
+ }
398
+ toolNames.delete(block.tool_use_id);
399
+ }
386
400
  } else if (evt.type === 'result') {
387
401
  if (evt.is_error) {
388
402
  throw new Error(
@@ -0,0 +1,180 @@
1
+ import { spawn } from 'node:child_process';
2
+ import type {
3
+ Options,
4
+ Query,
5
+ SDKMessage,
6
+ SDKUserMessage,
7
+ query,
8
+ } from '@anthropic-ai/claude-agent-sdk';
9
+ import { AsyncQueue } from './asyncQueue.js';
10
+ import type { ExecutorRunInput } from './types.js';
11
+
12
+ /** One SDK process, with approval and cancellation ownership rebound for each turn. */
13
+ export class ClaudeSession {
14
+ readonly incoming = new AsyncQueue<SDKUserMessage>();
15
+ readonly query: Query;
16
+ readonly controller = new AbortController();
17
+ pid?: number;
18
+ sessionId?: string;
19
+ totalCostUsd = 0;
20
+ private connected = true;
21
+ private closing?: Promise<void>;
22
+ private iterator?: AsyncIterator<SDKMessage, void>;
23
+ private ahead?: Promise<IteratorResult<SDKMessage, void>>;
24
+ private commands = new Set<string>();
25
+ private binding?: {
26
+ input: ExecutorRunInput;
27
+ signal: AbortSignal;
28
+ abort: () => void;
29
+ approve: Options['canUseTool'];
30
+ };
31
+ get isConnected(): boolean {
32
+ return this.connected && !this.controller.signal.aborted;
33
+ }
34
+
35
+ constructor(
36
+ factory: typeof query,
37
+ options: Options,
38
+ readonly fingerprint: string,
39
+ input: ExecutorRunInput,
40
+ signal: AbortSignal,
41
+ ) {
42
+ this.bind(input, signal, options.canUseTool);
43
+ this.query = factory({
44
+ prompt: this.incoming,
45
+ options: {
46
+ ...options,
47
+ abortController: this.controller,
48
+ canUseTool: async (...args) => {
49
+ const owner = this.binding;
50
+ if (!owner || owner.signal.aborted || args[2].signal.aborted)
51
+ return { behavior: 'deny', message: 'Turn ended.' };
52
+ const answer = await owner.approve?.(...args);
53
+ return this.binding === owner &&
54
+ !owner.signal.aborted &&
55
+ !args[2].signal.aborted &&
56
+ answer
57
+ ? answer
58
+ : { behavior: 'deny', message: 'Turn ended.' };
59
+ },
60
+ spawnClaudeCodeProcess: (options) => {
61
+ const child = spawn(options.command, options.args, {
62
+ cwd: options.cwd,
63
+ env: options.env,
64
+ signal: options.signal,
65
+ stdio: ['pipe', 'pipe', 'pipe'],
66
+ });
67
+ child.stderr.on('data', () => {});
68
+ child.once('close', () => {
69
+ this.connected = false;
70
+ });
71
+ child.once('error', () => {
72
+ this.connected = false;
73
+ });
74
+ this.pid = child.pid;
75
+ try {
76
+ this.binding?.input.onRecovery?.({ pid: child.pid });
77
+ } catch (error) {
78
+ child.kill('SIGKILL');
79
+ throw error;
80
+ }
81
+ return child;
82
+ },
83
+ },
84
+ });
85
+ }
86
+
87
+ bind(
88
+ input: ExecutorRunInput,
89
+ signal: AbortSignal,
90
+ approve: Options['canUseTool'],
91
+ ): void {
92
+ if (this.binding)
93
+ throw new Error('Claude conversation already has an active turn.');
94
+ if (!this.isConnected) throw new Error('Claude conversation disconnected.');
95
+ this.commands.clear();
96
+ const abort = () => this.controller.abort();
97
+ this.binding = { input, signal, abort, approve };
98
+ signal.addEventListener('abort', abort, { once: true });
99
+ if (signal.aborted) abort();
100
+ }
101
+
102
+ detach(): void {
103
+ const owner = this.binding;
104
+ owner?.signal.removeEventListener('abort', owner.abort);
105
+ this.binding = undefined;
106
+ }
107
+
108
+ send(message: SDKUserMessage): void {
109
+ if (message.uuid) this.commands.add(message.uuid);
110
+ this.incoming.push(message);
111
+ }
112
+
113
+ private completedCommand(event: SDKMessage): boolean {
114
+ // The bundled CLI emits these receipts after result; this SDK's union omits them.
115
+ const receipt = event as unknown as { type?: unknown; state?: unknown; command_uuid?: unknown; session_id?: unknown };
116
+ if (receipt.type !== 'command_lifecycle' || receipt.state !== 'completed' ||
117
+ receipt.session_id !== this.sessionId || typeof receipt.command_uuid !== 'string' ||
118
+ !this.commands.has(receipt.command_uuid)) return false;
119
+ this.commands.delete(receipt.command_uuid);
120
+ return true;
121
+ }
122
+
123
+ private next(): Promise<IteratorResult<SDKMessage, void>> {
124
+ this.iterator ??= this.query[Symbol.asyncIterator]();
125
+ return this.iterator.next();
126
+ }
127
+
128
+ /** Breaking a turn's iterator must not call return() on the SDK's conversation. */
129
+ async *events(): AsyncGenerator<SDKMessage> {
130
+ for (;;) {
131
+ const next = this.ahead ?? this.next();
132
+ this.ahead = undefined;
133
+ const event = await next;
134
+ if (event.done) {
135
+ this.connected = false;
136
+ return;
137
+ }
138
+ if (!this.completedCommand(event.value)) yield event.value;
139
+ }
140
+ }
141
+
142
+ idle(): void {
143
+ this.detach();
144
+ // Drain bookkeeping between turns. Unsolicited work must never leak into a later reply.
145
+ void this.watchIdle().catch(() => {
146
+ void this.close().catch(() => {});
147
+ });
148
+ }
149
+
150
+ private async watchIdle(): Promise<void> {
151
+ while (this.isConnected && !this.binding) {
152
+ const pending = (this.ahead ??= this.next());
153
+ const event = await pending;
154
+ if (this.binding) return; // The next turn now owns this read.
155
+ this.ahead = undefined;
156
+ if (event.done) {
157
+ await this.close();
158
+ return;
159
+ }
160
+ if (
161
+ this.completedCommand(event.value) || event.value.type === 'rate_limit_event' ||
162
+ (event.value.type === 'system' && event.value.subtype === 'status')
163
+ )
164
+ continue;
165
+ await this.close();
166
+ }
167
+ }
168
+
169
+ close(): Promise<void> {
170
+ if (this.closing) return this.closing;
171
+ this.connected = false;
172
+ this.detach();
173
+ this.incoming.end();
174
+ this.closing = Promise.resolve().then(async () => {
175
+ this.query.close();
176
+ await this.query.return();
177
+ });
178
+ return this.closing;
179
+ }
180
+ }