@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,3 +1,6 @@
1
+ import { reportSession, type SessionRetention, type SessionObserver } from './sessionRetention.js';
2
+ import { artifactFromToolResult } from '@lucidity/shared';
3
+ import { codexUsage } from './usage.js';
1
4
  import {
2
5
  parseAgentCommand,
3
6
  findAgentCommand,
@@ -5,6 +8,7 @@ import {
5
8
  } from '@lucidity/shared';
6
9
  import { readFileSync } from 'node:fs';
7
10
  import { randomUUID } from 'node:crypto';
11
+ import { dirname } from 'node:path';
8
12
  import {
9
13
  CodexRpc,
10
14
  initializeCodex,
@@ -12,6 +16,7 @@ import {
12
16
  type RpcMessage,
13
17
  } from './codexRpc.js';
14
18
  import { LiveTurns, abortError } from './liveTurns.js';
19
+ import { inheritsCodingIntegrations } from './integrations.js';
15
20
  import {
16
21
  CodexSessions,
17
22
  codexBindingFingerprint,
@@ -57,18 +62,18 @@ function userInput(
57
62
  ];
58
63
  }
59
64
 
60
- /** Override inherited tool integrations before starting any thread. */
65
+ /** Keep coding integrations; isolate companion and scoped runs. */
61
66
  export function codexRunConfig(
62
67
  input: ExecutorRunInput,
63
68
  inherited: Record<string, unknown>,
64
69
  ): NonNullable<ThreadStartParams['config']> {
70
+ const inheritIntegrations = inheritsCodingIntegrations(input);
65
71
  const config: NonNullable<ThreadStartParams['config']> = {
66
72
  'features.shell_tool': !!input.permissionMode && !input.noTools,
67
- 'features.apps': false,
73
+ ...(!inheritIntegrations ? { 'features.apps': false, 'features.plugins': false } : {}),
68
74
  'features.multi_agent': false,
69
75
  'features.multi_agent_v2': false,
70
- // Keep inherited integrations outside Lucidity's permission surface disabled.
71
- 'features.plugins': false,
76
+ // These native capabilities still need their own Lucidity interaction support.
72
77
  'features.browser_use': false,
73
78
  'features.browser_use_external': false,
74
79
  'features.browser_use_full_cdp_access': false,
@@ -87,7 +92,7 @@ export function codexRunConfig(
87
92
  model_provider: 'openai',
88
93
  };
89
94
  // config/read expands optional fields to null; those cannot round-trip to TOML.
90
- // Disable inherited entries with their transport only, without copying defaults.
95
+ // Preserve coding server policy and transport, omitting absent optional fields.
91
96
  const serversConfig: Record<
92
97
  string,
93
98
  {
@@ -99,8 +104,9 @@ export function codexRunConfig(
99
104
  for (const [name, raw] of Object.entries(
100
105
  (inherited.mcp_servers ?? {}) as Record<string, Record<string, unknown>>,
101
106
  )) {
102
- serversConfig[name] =
103
- typeof raw.url === 'string'
107
+ serversConfig[name] = inheritIntegrations
108
+ ? JSON.parse(JSON.stringify(raw, (_key, value) => value ?? undefined))
109
+ : typeof raw.url === 'string'
104
110
  ? { url: raw.url, enabled: false }
105
111
  : {
106
112
  command:
@@ -113,13 +119,28 @@ export function codexRunConfig(
113
119
  config.web_search = input.readTools.includes('WebSearch')
114
120
  ? 'live'
115
121
  : 'disabled';
116
- config.plugins = Object.fromEntries(
117
- Object.keys((inherited.plugins ?? {}) as object).map((name) => [
118
- name,
119
- { enabled: false },
120
- ]),
121
- );
122
+ if (!inheritIntegrations) {
123
+ config.plugins = Object.fromEntries(
124
+ Object.keys((inherited.plugins ?? {}) as object).map((name) => [
125
+ name,
126
+ { enabled: false },
127
+ ]),
128
+ );
129
+ }
122
130
  if (input.noTools) config.web_search = 'disabled';
131
+ if (input.isolateContext) {
132
+ if (input.resume || input.permissionMode || input.readTools?.length || input.allowedTools?.length || (!input.noTools && !input.mcp))
133
+ throw new Error('Isolated context requires a fresh session with only explicit MCP tools.');
134
+ Object.assign(config, {
135
+ web_search: 'disabled',
136
+ project_doc_max_bytes: 0,
137
+ 'memories.use_memories': false,
138
+ 'memories.generate_memories': false,
139
+ 'tools.view_image': false,
140
+ 'features.apply_patch_freeform': false,
141
+ developer_instructions: input.systemPrompt ?? 'Answer using only the supplied context.',
142
+ });
143
+ }
123
144
  if (input.mcp && !input.noTools) {
124
145
  const servers = JSON.parse(readFileSync(input.mcp.configPath, 'utf8'))
125
146
  .mcpServers as Record<
@@ -167,13 +188,17 @@ export class CodexExecutor implements AgentExecutor {
167
188
  readonly strictResume = true;
168
189
  readonly recoveryCapability = 'native-turn';
169
190
  private readonly turns = new LiveTurns();
170
- private readonly sessions = new CodexSessions();
191
+ private readonly sessions: CodexSessions;
171
192
  constructor(
172
193
  private readonly options: {
173
194
  command?: string;
195
+ sessionRetention?: SessionRetention;
196
+ onSessionEvent?: SessionObserver;
174
197
  connect?: (cwd?: string, env?: Record<string, string>) => CodexConnection;
175
198
  } = {},
176
- ) {}
199
+ ) {
200
+ this.sessions = new CodexSessions(options.sessionRetention?.maxIdleSessions, options.sessionRetention?.idleTtlMs, options.onSessionEvent);
201
+ }
177
202
  private connect(cwd?: string, env?: Record<string, string>) {
178
203
  return (
179
204
  this.options.connect?.(cwd, env) ?? new CodexRpc(this.options.command, cwd, env)
@@ -212,8 +237,8 @@ export class CodexExecutor implements AgentExecutor {
212
237
  await rpc.close();
213
238
  }
214
239
  }
215
- steer(requestId: string, text: string) {
216
- return this.turns.steer(requestId, text);
240
+ steer(requestId: string, text: string, images?: ExecutorRunInput['images']) {
241
+ return this.turns.steer(requestId, text, images);
217
242
  }
218
243
  async interrupt(requestId: string) {
219
244
  return this.turns.interrupt(requestId);
@@ -222,6 +247,25 @@ export class CodexExecutor implements AgentExecutor {
222
247
  await Promise.all([this.turns.dispose(), this.sessions.dispose()]);
223
248
  }
224
249
 
250
+ async usage() {
251
+ const rpc = this.connect();
252
+ let timer: ReturnType<typeof setTimeout> | undefined;
253
+ try {
254
+ return await Promise.race([
255
+ (async () => {
256
+ await initializeCodex(rpc);
257
+ return codexUsage(await rpc.request('account/rateLimits/read', {}));
258
+ })(),
259
+ new Promise<never>((_, reject) => {
260
+ timer = setTimeout(() => reject(new Error('Codex usage is unavailable.')), 15_000);
261
+ }),
262
+ ]);
263
+ } finally {
264
+ clearTimeout(timer);
265
+ await rpc.close();
266
+ }
267
+ }
268
+
225
269
  async models(): Promise<ExecutorModel[]> {
226
270
  const rpc = this.connect();
227
271
  try {
@@ -254,6 +298,47 @@ export class CodexExecutor implements AgentExecutor {
254
298
  }
255
299
  }
256
300
 
301
+ async mcpStatus(input: Pick<ExecutorRunInput, 'cwd' | 'permissionMode' | 'mcp'> = {}): Promise<import('@lucidity/shared').AgentMcpServer[]> {
302
+ const rpc = this.connect(input.cwd);
303
+ let timer: ReturnType<typeof setTimeout> | undefined;
304
+ try {
305
+ return await Promise.race([
306
+ (async () => {
307
+ await initializeCodex(rpc);
308
+ const inherited = await rpc.request<{ config: Record<string, unknown> }>('config/read', { includeLayers: false, cwd: input.cwd });
309
+ // An ephemeral thread loads the same integrations without sending a prompt or changing the user's session.
310
+ const { thread } = await rpc.request<{ thread: { id: string } }>('thread/start', {
311
+ ephemeral: true, cwd: input.cwd, approvalPolicy: 'never', sandbox: 'read-only',
312
+ config: codexRunConfig({ ...input, userPrompt: '' }, inherited.config),
313
+ });
314
+ const servers: import('@lucidity/shared').AgentMcpServer[] = [];
315
+ let cursor: string | null = null;
316
+ const seen = new Set<string>();
317
+ do {
318
+ const page: { data: Array<{ name: string; runtimeStatus?: string | null; tools?: Record<string, unknown>; toolsError?: string | null; authStatus?: string }>; nextCursor: string | null } =
319
+ await rpc.request('mcpServerStatus/list', { threadId: thread.id, detail: 'toolsAndAuthOnly', cursor, limit: 100 });
320
+ for (const server of page.data) {
321
+ const status = server.runtimeStatus;
322
+ servers.push({ name: server.name.slice(0, 200),
323
+ status: status === 'connected' ? 'connected'
324
+ : status === 'authenticationRequired' || server.authStatus === 'notLoggedIn' ? 'needs-auth'
325
+ : status === 'disabled' ? 'disabled'
326
+ : status === 'failed' || status === 'cancelled' || server.toolsError ? 'failed'
327
+ : status === 'starting' || status === 'notStarted' ? 'pending' : 'unknown',
328
+ ...(server.tools && !server.toolsError ? { toolCount: Object.keys(server.tools).length } : {}),
329
+ });
330
+ }
331
+ cursor = page.nextCursor;
332
+ if (cursor && (seen.has(cursor) || servers.length >= 1000)) throw new Error('MCP discovery returned too many results.');
333
+ if (cursor) seen.add(cursor);
334
+ } while (cursor);
335
+ return servers;
336
+ })(),
337
+ new Promise<never>((_, reject) => { timer = setTimeout(() => reject(new Error('MCP discovery timed out.')), 20_000); }),
338
+ ]);
339
+ } finally { clearTimeout(timer); await rpc.close(); }
340
+ }
341
+
257
342
  async commands(
258
343
  input: Pick<ExecutorRunInput, 'cwd' | 'permissionMode'> = {},
259
344
  ): Promise<AgentCommandOption[]> {
@@ -361,7 +446,7 @@ export class CodexExecutor implements AgentExecutor {
361
446
  let thread: CodexThread | undefined;
362
447
  let fingerprint = '';
363
448
  let reusable = false;
364
- const owner = this.turns.open(input, async (text) => {
449
+ const owner = this.turns.open(input, async (text, images) => {
365
450
  if (command)
366
451
  throw new Error(
367
452
  'Wait for the command to finish before sending a message.',
@@ -371,7 +456,7 @@ export class CodexExecutor implements AgentExecutor {
371
456
  const params: TurnSteerParams = {
372
457
  threadId,
373
458
  expectedTurnId: turnId,
374
- input: userInput({ userPrompt: text }),
459
+ input: userInput({ userPrompt: text, images }),
375
460
  };
376
461
  await rpc.request('turn/steer', params);
377
462
  });
@@ -431,6 +516,7 @@ export class CodexExecutor implements AgentExecutor {
431
516
  };
432
517
  try {
433
518
  owner.check();
519
+ const setupStarted = performance.now();
434
520
  const pooled = await this.sessions.take(input.resume);
435
521
  rpc = pooled?.rpc ?? this.connect(input.cwd, input.env);
436
522
  input.onRecovery?.({ pid: rpc.pid, inspectionDisabled: !!command });
@@ -452,6 +538,7 @@ export class CodexExecutor implements AgentExecutor {
452
538
  { includeLayers: false, cwd: input.cwd },
453
539
  );
454
540
  const params: ThreadStartParams = {
541
+ ...(input.isolateContext ? { ephemeral: true, baseInstructions: 'You are Lucid. Use the supplied context and explicitly connected tools to fulfill the invoking user\'s request.' } : {}),
455
542
  cwd: input.cwd,
456
543
  model: input.model,
457
544
  modelProvider: 'openai',
@@ -474,11 +561,18 @@ export class CodexExecutor implements AgentExecutor {
474
561
  developerInstructions: input.systemPrompt,
475
562
  config: codexRunConfig(input, inherited.config),
476
563
  };
477
- fingerprint = codexBindingFingerprint(params);
564
+ if (input.isolateContext) {
565
+ const catalog = await rpc.request<SkillsListResponse>('skills/list', { cwds: [input.cwd], forceReload: true });
566
+ params.config!['skills.config'] = catalog.data.flatMap((entry) => entry.skills.map((skill) => ({
567
+ path: dirname(skill.path), enabled: false,
568
+ })));
569
+ }
570
+ fingerprint = codexBindingFingerprint({ params, env: input.env });
478
571
  if (pooled && pooled.fingerprint !== fingerprint) {
479
572
  // Permissions, MCP tools, model, cwd or instructions changed. A new transport
480
573
  // resumes only after the old owner has fully exited.
481
574
  await rpc.close();
575
+ reportSession(this.options.onSessionEvent, { action: 'closed', sessionId: input.resume, reason: 'configuration' });
482
576
  owner.check();
483
577
  rpc = this.connect(input.cwd, input.env);
484
578
  input.onRecovery?.({ pid: rpc.pid });
@@ -495,7 +589,20 @@ export class CodexExecutor implements AgentExecutor {
495
589
  } satisfies ThreadResumeParams)
496
590
  : await rpc.request<CodexThread>('thread/start', params);
497
591
  threadId = thread.thread.id;
592
+ reportSession(this.options.onSessionEvent, {
593
+ action: pooled?.fingerprint === fingerprint ? 'reused' : input.resume && !isEmptySession(input.resume) ? 'resumed' : 'started',
594
+ sessionId: threadId, durationMs: Math.round(performance.now() - setupStarted), requestId: input.requestId,
595
+ });
498
596
  input.onRecovery?.({ sessionId: threadId });
597
+ const retained = pooled?.fingerprint === fingerprint;
598
+ // A retained thread object predates this turn and may no longer describe its settings.
599
+ const reportedModel = retained ? null : thread.model ?? null;
600
+ const reportedEffort = retained || input.effort ? null : thread.reasoningEffort ?? null;
601
+ input.onExecutionSettings?.({ stage: 'runtime-confirmed', sessionId: threadId,
602
+ evidence: retained ? 'retained-connection-no-new-settings-response' : 'thread-start-or-resume-response',
603
+ settings: { provider: 'codex', model: reportedModel, effort: reportedEffort,
604
+ provenance: { provider: 'provider-response', model: reportedModel ? 'provider-response' : 'not-reported',
605
+ effort: input.effort ? 'turn-override-not-echoed' : reportedEffort ? 'provider-response' : 'not-reported' } } });
499
606
  const sessionId =
500
607
  isEmptySession(input.resume) &&
501
608
  command &&
@@ -626,6 +733,7 @@ export class CodexExecutor implements AgentExecutor {
626
733
  tool?: string;
627
734
  server?: string;
628
735
  review?: string;
736
+ result?: { content?: unknown; structuredContent?: unknown };
629
737
  };
630
738
  if (
631
739
  item.type === 'exitedReviewMode' &&
@@ -638,6 +746,11 @@ export class CodexExecutor implements AgentExecutor {
638
746
  item.phase !== 'commentary'
639
747
  )
640
748
  finalText = item.text ?? finalText;
749
+ if (event.method === 'item/completed' && item.type === 'mcpToolCall' &&
750
+ item.server === 'lucidity' && item.tool === 'attach_file' && item.status === 'completed') {
751
+ const artifact = artifactFromToolResult(item.result?.structuredContent) ?? artifactFromToolResult(item.result?.content);
752
+ if (artifact) yield { type: 'artifact', artifact };
753
+ }
641
754
  const name =
642
755
  item.type === 'commandExecution'
643
756
  ? 'Shell'
@@ -654,6 +767,8 @@ export class CodexExecutor implements AgentExecutor {
654
767
  : item.type === 'dynamicToolCall'
655
768
  ? (item.tool ?? 'Dynamic tool')
656
769
  : undefined;
770
+ if (item.type === 'contextCompaction')
771
+ yield { type: 'compaction', phase: event.method === 'item/started' ? 'start' : 'end' };
657
772
  if (name)
658
773
  yield {
659
774
  type: 'tool_call',
@@ -704,7 +819,7 @@ export class CodexExecutor implements AgentExecutor {
704
819
  ended = true;
705
820
  owner.controller.signal.removeEventListener('abort', abort);
706
821
  try {
707
- if (rpc && reusable && thread && !owner.controller.signal.aborted)
822
+ if (rpc && reusable && thread && !input.isolateContext && !owner.controller.signal.aborted)
708
823
  await this.sessions.keep({ rpc, thread, fingerprint });
709
824
  else await rpc?.close();
710
825
  } finally {
@@ -1,22 +1,6 @@
1
1
  import type { CodexConnection } from './codexRpc.js';
2
- import { createHash } from 'node:crypto';
3
-
4
- /** Rust maps may arrive in a different order; credentials never become a stored key. */
5
- export function codexBindingFingerprint(value: unknown): string {
6
- const ordered = (value: unknown): unknown =>
7
- Array.isArray(value)
8
- ? value.map(ordered)
9
- : value && typeof value === 'object'
10
- ? Object.fromEntries(
11
- Object.entries(value)
12
- .sort(([a], [b]) => a.localeCompare(b))
13
- .map(([key, item]) => [key, ordered(item)]),
14
- )
15
- : value;
16
- return createHash('sha256')
17
- .update(JSON.stringify(ordered(value)))
18
- .digest('hex');
19
- }
2
+ import { RetainedSessions, type SessionObserver } from './sessionRetention.js';
3
+ export { sessionBindingFingerprint as codexBindingFingerprint } from './sessionRetention.js';
20
4
 
21
5
  export interface CodexThread {
22
6
  thread: { id: string };
@@ -30,79 +14,31 @@ export interface CodexSession {
30
14
  fingerprint: string;
31
15
  }
32
16
 
33
- /** Completed threads retain one transport; idle eviction still awaits the native exit. */
17
+ /** Completed threads retain one transport; eviction awaits the native exit. */
34
18
  export class CodexSessions {
35
- private idle = new Map<
36
- string,
37
- CodexSession & { timer: ReturnType<typeof setTimeout> }
38
- >();
39
- private closing = new Map<string, Promise<void>>();
40
- private disposed = false;
41
- constructor(
42
- private readonly limit = 2,
43
- private readonly idleMs = 3 * 60_000,
44
- ) {}
19
+ private readonly pool: RetainedSessions<CodexSession>;
20
+ constructor(limit = 2, idleMs = 3 * 60_000, observer?: SessionObserver) {
21
+ this.pool = new RetainedSessions(
22
+ (session) => session.rpc.close(),
23
+ (session) => session.rpc.isConnected !== false && !!session.rpc.setIdle,
24
+ { maxIdleSessions: limit, idleTtlMs: idleMs },
25
+ observer,
26
+ );
27
+ }
45
28
 
46
29
  async take(id?: string): Promise<CodexSession | undefined> {
47
- if (!id) return;
48
- await this.closing.get(id);
49
- if (this.disposed) throw new Error('Codex is shutting down.');
50
- const session = this.idle.get(id);
51
- if (!session) return;
52
- clearTimeout(session.timer);
53
- this.idle.delete(id);
54
- if (session.rpc.isConnected === false) {
55
- await session.rpc.close();
56
- return;
57
- }
58
- session.rpc.setIdle?.(false);
30
+ const session = await this.pool.take(id);
31
+ session?.rpc.setIdle?.(false);
59
32
  return session;
60
33
  }
61
34
 
62
- private evict(id: string): Promise<void> {
63
- const session = this.idle.get(id);
64
- if (!session) return this.closing.get(id) ?? Promise.resolve();
65
- clearTimeout(session.timer);
66
- this.idle.delete(id);
67
- const closing = Promise.resolve()
68
- .then(() => session.rpc.close())
69
- .finally(() => {
70
- if (this.closing.get(id) === closing) this.closing.delete(id);
71
- });
72
- this.closing.set(id, closing);
73
- return closing;
74
- }
75
-
76
35
  async keep(session: CodexSession): Promise<void> {
77
- const id = session.thread.thread.id;
78
- if (
79
- this.disposed ||
80
- session.rpc.isConnected === false ||
81
- !session.rpc.setIdle ||
82
- this.limit <= 0
83
- ) {
84
- await session.rpc.close();
85
- return;
86
- }
87
- await this.evict(id);
88
- if (this.disposed) {
89
- await session.rpc.close();
90
- return;
91
- }
92
36
  session.rpc.onRequest = undefined;
93
- session.rpc.setIdle(true);
94
- const timer = setTimeout(() => {
95
- void this.evict(id).catch(() => {});
96
- }, this.idleMs);
97
- timer.unref();
98
- this.idle.set(id, { ...session, timer });
99
- while (this.idle.size > this.limit)
100
- await this.evict(this.idle.keys().next().value!);
37
+ session.rpc.setIdle?.(true);
38
+ await this.pool.keep(session.thread.thread.id, session);
101
39
  }
102
40
 
103
- async dispose(): Promise<void> {
104
- this.disposed = true;
105
- await Promise.all([...this.idle.keys()].map((id) => this.evict(id)));
106
- await Promise.all(this.closing.values());
41
+ dispose(): Promise<void> {
42
+ return this.pool.dispose();
107
43
  }
108
44
  }
@@ -0,0 +1,63 @@
1
+ import type { ProviderHealth } from '@lucidity/shared';
2
+ import { providerFailure } from './health.js';
3
+ import type { AgentExecutor, AgentProvider, ExecutorRunInput } from './types.js';
4
+
5
+ export interface ProviderMove {
6
+ from: AgentProvider;
7
+ to: AgentProvider;
8
+ reason: 'login' | 'allowance';
9
+ }
10
+
11
+ function unavailable(health: ProviderHealth) {
12
+ return health.auth === 'login_required' || health.allowance === 'exhausted';
13
+ }
14
+
15
+ /**
16
+ * Lets an unattended job finish on the other provider when its own is signed out or out of
17
+ * allowance. Off unless the owner opts in, because the job's text and billing move with it.
18
+ *
19
+ * The usual provider is always tried first: a rejected run costs nothing, and a job recovers by
20
+ * itself once that provider is back, without anyone refreshing its health.
21
+ */
22
+ export class ProviderFallback {
23
+ constructor(
24
+ private readonly deps: {
25
+ executor: Pick<AgentExecutor, 'run'>;
26
+ enabled: () => boolean;
27
+ provider: () => AgentProvider;
28
+ health: (provider: AgentProvider) => ProviderHealth;
29
+ /** Called after every finished run, with null when the job stayed on its usual provider. */
30
+ onRun?: (job: string, move: ProviderMove | null) => void;
31
+ },
32
+ ) {}
33
+
34
+ async run(job: string, input: ExecutorRunInput) {
35
+ try {
36
+ const result = await this.deps.executor.run({ ...input, automaticFallback: false });
37
+ this.deps.onRun?.(job, null);
38
+ return result;
39
+ } catch (error) {
40
+ const reason = providerFailure(error)?.problem;
41
+ const from = input.provider ?? this.deps.provider();
42
+ const to = from === 'claude' ? 'codex' : 'claude';
43
+ if (
44
+ !this.deps.enabled() ||
45
+ input.resume ||
46
+ input.signal?.aborted ||
47
+ (reason !== 'login' && reason !== 'allowance') ||
48
+ unavailable(this.deps.health(to))
49
+ )
50
+ throw error;
51
+ // Model names belong to one provider, so the other uses its own configured defaults.
52
+ const result = await this.deps.executor.run({
53
+ ...input,
54
+ automaticFallback: false,
55
+ provider: to,
56
+ model: undefined,
57
+ effort: undefined,
58
+ });
59
+ this.deps.onRun?.(job, { from, to, reason });
60
+ return result;
61
+ }
62
+ }
63
+ }
@@ -31,6 +31,7 @@ export class HealthAwareExecutor implements AgentExecutor {
31
31
  private state: ProviderHealth = { auth: 'unknown', allowance: 'unknown' };
32
32
  private listeners = new Set<() => void>();
33
33
  private check: Promise<import('./types.js').ExecutorModel[]> | undefined;
34
+ private mcpChecks = new Map<string, Promise<import('@lucidity/shared').AgentMcpServer[]>>();
34
35
  constructor(private readonly executor: AgentExecutor) {}
35
36
  get name() {
36
37
  return this.executor.name;
@@ -89,6 +90,19 @@ export class HealthAwareExecutor implements AgentExecutor {
89
90
  async commands(input?: Pick<ExecutorRunInput, 'cwd' | 'permissionMode' | 'mcp'>) {
90
91
  return (await this.executor.commands?.(input)) ?? [];
91
92
  }
93
+ async usage() {
94
+ if (!this.executor.usage) throw new Error('Usage is unavailable.');
95
+ return this.executor.usage();
96
+ }
97
+ async mcpStatus(input?: Pick<ExecutorRunInput, 'cwd' | 'permissionMode' | 'mcp'>) {
98
+ if (!this.executor.mcpStatus) throw new Error('MCP status is unavailable for this provider.');
99
+ const key = JSON.stringify(input ?? {});
100
+ const pending = this.mcpChecks.get(key);
101
+ if (pending) return pending;
102
+ const check = this.executor.mcpStatus(input).finally(() => this.mcpChecks.delete(key));
103
+ this.mcpChecks.set(key, check);
104
+ return check;
105
+ }
92
106
  withOwnership<T>(input: ExecutorRunInput, action: () => Promise<T>): Promise<T> {
93
107
  return this.executor.withOwnership ? this.executor.withOwnership(input, action) : action();
94
108
  }
@@ -116,10 +130,10 @@ export class HealthAwareExecutor implements AgentExecutor {
116
130
  throw error;
117
131
  }
118
132
  }
119
- steer(requestId: string, text: string) {
133
+ steer(requestId: string, text: string, images?: ExecutorRunInput['images']) {
120
134
  if (!this.executor.steer)
121
135
  return Promise.reject(new Error('Steering is unavailable.'));
122
- return this.executor.steer(requestId, text);
136
+ return this.executor.steer(requestId, text, images);
123
137
  }
124
138
  async interrupt(requestId: string) {
125
139
  return (await this.executor.interrupt?.(requestId)) ?? false;
@@ -0,0 +1,7 @@
1
+ import type { ExecutorRunInput } from './types.js';
2
+
3
+ /** Writable coding sessions use the user's provider integrations and permissions. */
4
+ export function inheritsCodingIntegrations(input: ExecutorRunInput): boolean {
5
+ return !!input.permissionMode && input.permissionMode !== 'plan' &&
6
+ !input.readTools && !input.noTools && !input.isolateContext;
7
+ }
@@ -13,10 +13,10 @@ export class LiveTurns {
13
13
  private disposed = false;
14
14
  private turns = new Map<
15
15
  string,
16
- { abort: () => void; steer: (text: string) => Promise<void>; settled: Promise<void> }
16
+ { abort: () => void; steer: (text: string, images?: ExecutorRunInput['images']) => Promise<void>; settled: Promise<void> }
17
17
  >();
18
18
 
19
- open(input: ExecutorRunInput, steer: (text: string) => Promise<void>) {
19
+ open(input: ExecutorRunInput, steer: (text: string, images?: ExecutorRunInput['images']) => Promise<void>) {
20
20
  if (this.disposed) throw new Error('The provider is shutting down.');
21
21
  const id = input.requestId ?? randomUUID();
22
22
  if (id && this.turns.has(id))
@@ -26,7 +26,7 @@ export class LiveTurns {
26
26
  if (input.signal?.aborted) abort();
27
27
  else input.signal?.addEventListener('abort', abort, { once: true });
28
28
  let timedOut = false;
29
- const timer = setTimeout(() => {
29
+ const timer = input.timeoutMs === null ? undefined : setTimeout(() => {
30
30
  timedOut = true;
31
31
  abort();
32
32
  }, input.timeoutMs ?? 120_000);
@@ -49,7 +49,7 @@ export class LiveTurns {
49
49
  };
50
50
  }
51
51
 
52
- async steer(id: string, text: string): Promise<void> {
52
+ async steer(id: string, text: string, images?: ExecutorRunInput['images']): Promise<void> {
53
53
  const turn = this.turns.get(id);
54
54
  if (!turn)
55
55
  throw new Error(
@@ -58,7 +58,7 @@ export class LiveTurns {
58
58
  if (!text.trim()) throw new Error('A correction cannot be empty.');
59
59
  if (parseAgentCommand(text))
60
60
  throw new Error('Send commands after the current response finishes.');
61
- await turn.steer(text);
61
+ await turn.steer(text, images);
62
62
  }
63
63
 
64
64
  interrupt(id: string): boolean {
@@ -76,8 +76,10 @@ export class OwnedExecutor implements AgentExecutor {
76
76
  } finally { release(); }
77
77
  }
78
78
  models() { return this.executor.models?.() ?? Promise.resolve([]); }
79
+ mcpStatus(input?: Pick<ExecutorRunInput, 'cwd' | 'permissionMode' | 'mcp'>) { return this.executor.mcpStatus?.(input) ?? Promise.reject(new Error('MCP status is unavailable.')); }
80
+ usage() { return this.executor.usage?.() ?? Promise.reject(new Error('Usage is unavailable.')); }
79
81
  commands(input?: Pick<ExecutorRunInput, 'cwd' | 'permissionMode' | 'mcp'>) { return this.executor.commands?.(input) ?? Promise.resolve([]); }
80
- steer(id: string, text: string) { return this.executor.steer?.(id, text) ?? Promise.reject(new Error('Steering is unavailable.')); }
82
+ steer(id: string, text: string, images?: ExecutorRunInput['images']) { return this.executor.steer?.(id, text, images) ?? Promise.reject(new Error('Steering is unavailable.')); }
81
83
  interrupt(id: string) { return this.executor.interrupt?.(id) ?? Promise.resolve(false); }
82
84
  async dispose() { await this.executor.dispose?.(); }
83
85
  }