@opencorelabs/lucidity 0.3.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (512) hide show
  1. package/README.md +9 -2
  2. package/dist/assets/speech/licenses/FluidAudio/LICENSE +201 -0
  3. package/dist/assets/speech/licenses/FluidAudio/ThirdPartyLicenses/fastcluster-LICENSE.md +11 -0
  4. package/dist/assets/speech/licenses/FluidAudio/ThirdPartyLicenses/vbx-LICENSE.md +201 -0
  5. package/dist/assets/speech/lucidity-speech +0 -0
  6. package/dist/automations/agent.d.ts +16 -0
  7. package/dist/automations/agent.d.ts.map +1 -0
  8. package/dist/automations/agent.js +196 -0
  9. package/dist/automations/cli.d.ts +4 -0
  10. package/dist/automations/cli.d.ts.map +1 -0
  11. package/dist/automations/cli.js +44 -0
  12. package/dist/automations/connections.d.ts +11 -0
  13. package/dist/automations/connections.d.ts.map +1 -0
  14. package/dist/automations/connections.js +74 -0
  15. package/dist/automations/designer.d.ts +39 -0
  16. package/dist/automations/designer.d.ts.map +1 -0
  17. package/dist/automations/designer.js +450 -0
  18. package/dist/automations/history.d.ts +4 -0
  19. package/dist/automations/history.d.ts.map +1 -0
  20. package/dist/automations/history.js +57 -0
  21. package/dist/automations/learning.d.ts +19 -0
  22. package/dist/automations/learning.d.ts.map +1 -0
  23. package/dist/automations/learning.js +121 -0
  24. package/dist/automations/pinterest.d.ts +21 -0
  25. package/dist/automations/pinterest.d.ts.map +1 -0
  26. package/dist/automations/pinterest.js +113 -0
  27. package/dist/automations/service.d.ts +42 -0
  28. package/dist/automations/service.d.ts.map +1 -0
  29. package/dist/automations/service.js +406 -0
  30. package/dist/automations/setup.d.ts +3 -0
  31. package/dist/automations/setup.d.ts.map +1 -0
  32. package/dist/automations/setup.js +48 -0
  33. package/dist/automations/skill.d.ts +3 -0
  34. package/dist/automations/skill.d.ts.map +1 -0
  35. package/dist/automations/skill.js +29 -0
  36. package/dist/automations/store.d.ts +13 -0
  37. package/dist/automations/store.d.ts.map +1 -0
  38. package/dist/automations/store.js +46 -0
  39. package/dist/chat/server.d.ts +2 -0
  40. package/dist/chat/server.d.ts.map +1 -1
  41. package/dist/chat/server.js +46 -2
  42. package/dist/coding/commandContext.d.ts +6 -0
  43. package/dist/coding/commandContext.d.ts.map +1 -0
  44. package/dist/coding/commandContext.js +20 -0
  45. package/dist/coding/runCodeTurn.d.ts +12 -2
  46. package/dist/coding/runCodeTurn.d.ts.map +1 -1
  47. package/dist/coding/runCodeTurn.js +49 -19
  48. package/dist/coding/worktree.d.ts +3 -4
  49. package/dist/coding/worktree.d.ts.map +1 -1
  50. package/dist/coding/worktree.js +3 -4
  51. package/dist/config.d.ts +4 -0
  52. package/dist/config.d.ts.map +1 -1
  53. package/dist/config.js +20 -3
  54. package/dist/decisions/cli.d.ts +2 -0
  55. package/dist/decisions/cli.d.ts.map +1 -0
  56. package/dist/decisions/cli.js +106 -0
  57. package/dist/decisions/client.d.ts +20 -0
  58. package/dist/decisions/client.d.ts.map +1 -0
  59. package/dist/decisions/client.js +41 -0
  60. package/dist/handoff.d.ts +11 -0
  61. package/dist/handoff.d.ts.map +1 -0
  62. package/dist/handoff.js +21 -0
  63. package/dist/index.js +179 -40
  64. package/dist/jobs/briefing.js +1 -1
  65. package/dist/jobs/extraction.d.ts.map +1 -1
  66. package/dist/jobs/extraction.js +112 -22
  67. package/dist/jobs/fastModeReview.d.ts +39 -0
  68. package/dist/jobs/fastModeReview.d.ts.map +1 -0
  69. package/dist/jobs/fastModeReview.js +192 -0
  70. package/dist/jobs/voiceReview.d.ts +24 -0
  71. package/dist/jobs/voiceReview.d.ts.map +1 -0
  72. package/dist/jobs/voiceReview.js +128 -0
  73. package/dist/mcp/clients.d.ts +5 -0
  74. package/dist/mcp/clients.d.ts.map +1 -1
  75. package/dist/mcp/clients.js +1 -1
  76. package/dist/mcp/config.d.ts +3 -1
  77. package/dist/mcp/config.d.ts.map +1 -1
  78. package/dist/mcp/config.js +48 -6
  79. package/dist/mcp/paired.js +1 -0
  80. package/dist/notesContext.d.ts.map +1 -1
  81. package/dist/notesContext.js +3 -2
  82. package/dist/room/client.d.ts +20 -7
  83. package/dist/room/client.d.ts.map +1 -1
  84. package/dist/room/client.js +262 -45
  85. package/dist/room/computer.d.ts.map +1 -1
  86. package/dist/room/computer.js +8 -0
  87. package/dist/room/context.d.ts +3 -2
  88. package/dist/room/context.d.ts.map +1 -1
  89. package/dist/room/context.js +10 -3
  90. package/dist/room/turnQueue.d.ts +40 -0
  91. package/dist/room/turnQueue.d.ts.map +1 -0
  92. package/dist/room/turnQueue.js +301 -0
  93. package/dist/skills/lucidity-automations/SKILL.md +54 -0
  94. package/dist/speech/captures.d.ts +30 -0
  95. package/dist/speech/captures.d.ts.map +1 -0
  96. package/dist/speech/captures.js +209 -0
  97. package/dist/speech/fluidAudio.d.ts +28 -0
  98. package/dist/speech/fluidAudio.d.ts.map +1 -0
  99. package/dist/speech/fluidAudio.js +182 -0
  100. package/dist/speech/service.d.ts +14 -0
  101. package/dist/speech/service.d.ts.map +1 -0
  102. package/dist/speech/service.js +88 -0
  103. package/dist/speech/types.d.ts +19 -0
  104. package/dist/speech/types.d.ts.map +1 -0
  105. package/dist/speech/types.js +1 -0
  106. package/dist/turnLog.d.ts +1 -0
  107. package/dist/turnLog.d.ts.map +1 -1
  108. package/dist/turnLog.js +3 -0
  109. package/native/speech/Package.resolved +15 -0
  110. package/native/speech/Package.swift +16 -0
  111. package/native/speech/Sources/lucidity-speech/Speech.swift +81 -0
  112. package/package.json +6 -2
  113. package/src/automations/agent.ts +239 -0
  114. package/src/automations/cli.ts +52 -0
  115. package/src/automations/connections.ts +83 -0
  116. package/src/automations/designer.ts +594 -0
  117. package/src/automations/history.ts +59 -0
  118. package/src/automations/learning.ts +180 -0
  119. package/src/automations/pinterest.ts +146 -0
  120. package/src/automations/service.ts +505 -0
  121. package/src/automations/setup.ts +71 -0
  122. package/src/automations/skill.ts +40 -0
  123. package/src/automations/store.ts +63 -0
  124. package/src/chat/server.ts +62 -3
  125. package/src/coding/commandContext.ts +29 -0
  126. package/src/coding/runCodeTurn.ts +65 -21
  127. package/src/coding/worktree.ts +3 -4
  128. package/src/config.ts +29 -2
  129. package/src/decisions/cli.ts +136 -0
  130. package/src/decisions/client.ts +62 -0
  131. package/src/handoff.ts +28 -0
  132. package/src/index.ts +196 -67
  133. package/src/jobs/briefing.ts +1 -1
  134. package/src/jobs/extraction.ts +157 -32
  135. package/src/jobs/fastModeReview.ts +221 -0
  136. package/src/jobs/voiceReview.ts +156 -0
  137. package/src/mcp/clients.ts +1 -1
  138. package/src/mcp/config.ts +56 -6
  139. package/src/mcp/paired.ts +1 -0
  140. package/src/notesContext.ts +3 -2
  141. package/src/room/client.ts +316 -52
  142. package/src/room/computer.ts +8 -0
  143. package/src/room/context.ts +12 -3
  144. package/src/room/turnQueue.ts +358 -0
  145. package/src/speech/captures.ts +265 -0
  146. package/src/speech/fluidAudio.ts +242 -0
  147. package/src/speech/service.ts +108 -0
  148. package/src/speech/types.ts +13 -0
  149. package/src/turnLog.ts +4 -0
  150. package/vendor/decisions/LICENSE +662 -0
  151. package/vendor/decisions/dist/capture.d.ts +79 -0
  152. package/vendor/decisions/dist/capture.js +183 -0
  153. package/vendor/decisions/dist/command.d.ts +202 -0
  154. package/vendor/decisions/dist/command.js +750 -0
  155. package/vendor/decisions/dist/gate.d.ts +12 -0
  156. package/vendor/decisions/dist/gate.js +18 -0
  157. package/vendor/decisions/dist/index.d.ts +5 -0
  158. package/vendor/decisions/dist/index.js +5 -0
  159. package/vendor/decisions/dist/jev.d.ts +15 -0
  160. package/vendor/decisions/dist/jev.js +242 -0
  161. package/vendor/decisions/dist/types.d.ts +67 -0
  162. package/vendor/decisions/dist/types.js +1 -0
  163. package/vendor/decisions/package.json +22 -0
  164. package/vendor/decisions/src/capture.ts +199 -0
  165. package/vendor/decisions/src/command.ts +836 -0
  166. package/vendor/decisions/src/gate.ts +32 -0
  167. package/vendor/decisions/src/index.ts +5 -0
  168. package/vendor/decisions/src/jev.ts +293 -0
  169. package/vendor/decisions/src/types.ts +79 -0
  170. package/vendor/mcp-server/README.md +6 -1
  171. package/vendor/mcp-server/dist/client.d.ts +1 -0
  172. package/vendor/mcp-server/dist/client.d.ts.map +1 -1
  173. package/vendor/mcp-server/dist/client.js +8 -0
  174. package/vendor/mcp-server/dist/commentProvider.d.ts +3 -0
  175. package/vendor/mcp-server/dist/commentProvider.d.ts.map +1 -0
  176. package/vendor/mcp-server/dist/commentProvider.js +10 -0
  177. package/vendor/mcp-server/dist/index.js +21 -6
  178. package/vendor/mcp-server/dist/tools/automations.d.ts +6 -0
  179. package/vendor/mcp-server/dist/tools/automations.d.ts.map +1 -0
  180. package/vendor/mcp-server/dist/tools/automations.js +163 -0
  181. package/vendor/mcp-server/dist/tools/commandEventFormat.d.ts +52 -0
  182. package/vendor/mcp-server/dist/tools/commandEventFormat.d.ts.map +1 -0
  183. package/vendor/mcp-server/dist/tools/commandEventFormat.js +83 -0
  184. package/vendor/mcp-server/dist/tools/commandEvents.d.ts +3 -0
  185. package/vendor/mcp-server/dist/tools/commandEvents.d.ts.map +1 -0
  186. package/vendor/mcp-server/dist/tools/commandEvents.js +21 -0
  187. package/vendor/mcp-server/dist/tools/comments.d.ts.map +1 -1
  188. package/vendor/mcp-server/dist/tools/comments.js +25 -4
  189. package/vendor/mcp-server/dist/tools/index.d.ts +2 -0
  190. package/vendor/mcp-server/dist/tools/index.d.ts.map +1 -1
  191. package/vendor/mcp-server/dist/tools/index.js +2 -0
  192. package/vendor/mcp-server/dist/tools/journal.d.ts +3 -0
  193. package/vendor/mcp-server/dist/tools/journal.d.ts.map +1 -0
  194. package/vendor/mcp-server/dist/tools/journal.js +131 -0
  195. package/vendor/mcp-server/dist/tools/taskActivity.d.ts +3 -0
  196. package/vendor/mcp-server/dist/tools/taskActivity.d.ts.map +1 -0
  197. package/vendor/mcp-server/dist/tools/taskActivity.js +32 -0
  198. package/vendor/mcp-server/dist/tools/taskOccurrences.d.ts +3 -0
  199. package/vendor/mcp-server/dist/tools/taskOccurrences.d.ts.map +1 -0
  200. package/vendor/mcp-server/dist/tools/taskOccurrences.js +12 -0
  201. package/vendor/mcp-server/dist/tools/taskTrash.d.ts +3 -0
  202. package/vendor/mcp-server/dist/tools/taskTrash.d.ts.map +1 -0
  203. package/vendor/mcp-server/dist/tools/taskTrash.js +21 -0
  204. package/vendor/mcp-server/dist/tools/tasks.d.ts.map +1 -1
  205. package/vendor/mcp-server/dist/tools/tasks.js +67 -27
  206. package/vendor/mcp-server/package.json +5 -1
  207. package/vendor/mcp-server/src/client.ts +10 -0
  208. package/vendor/mcp-server/src/commentProvider.ts +9 -0
  209. package/vendor/mcp-server/src/index.ts +20 -6
  210. package/vendor/mcp-server/src/tools/automations.ts +199 -0
  211. package/vendor/mcp-server/src/tools/commandEventFormat.ts +108 -0
  212. package/vendor/mcp-server/src/tools/commandEvents.ts +27 -0
  213. package/vendor/mcp-server/src/tools/comments.ts +24 -3
  214. package/vendor/mcp-server/src/tools/index.ts +2 -0
  215. package/vendor/mcp-server/src/tools/journal.ts +168 -0
  216. package/vendor/mcp-server/src/tools/taskActivity.ts +55 -0
  217. package/vendor/mcp-server/src/tools/taskOccurrences.ts +26 -0
  218. package/vendor/mcp-server/src/tools/taskTrash.ts +23 -0
  219. package/vendor/mcp-server/src/tools/tasks.ts +66 -30
  220. package/vendor/notes/dist/index.d.ts +2 -0
  221. package/vendor/notes/dist/index.d.ts.map +1 -1
  222. package/vendor/notes/dist/index.js +2 -0
  223. package/vendor/notes/dist/journal-backend.d.ts +4 -0
  224. package/vendor/notes/dist/journal-backend.d.ts.map +1 -0
  225. package/vendor/notes/dist/journal-backend.js +33 -0
  226. package/vendor/notes/dist/journal.d.ts +7 -0
  227. package/vendor/notes/dist/journal.d.ts.map +1 -0
  228. package/vendor/notes/dist/journal.js +173 -0
  229. package/vendor/notes/dist/vault.d.ts.map +1 -1
  230. package/vendor/notes/dist/vault.js +6 -1
  231. package/vendor/notes/src/index.ts +2 -0
  232. package/vendor/notes/src/journal-backend.ts +53 -0
  233. package/vendor/notes/src/journal.ts +194 -0
  234. package/vendor/notes/src/vault.ts +9 -1
  235. package/vendor/runtime/README.md +4 -0
  236. package/vendor/runtime/dist/executor/claudeAgent.d.ts +2 -0
  237. package/vendor/runtime/dist/executor/claudeAgent.d.ts.map +1 -1
  238. package/vendor/runtime/dist/executor/claudeAgent.js +113 -8
  239. package/vendor/runtime/dist/executor/claudeCode.d.ts.map +1 -1
  240. package/vendor/runtime/dist/executor/claudeCode.js +8 -4
  241. package/vendor/runtime/dist/executor/codex.d.ts +2 -0
  242. package/vendor/runtime/dist/executor/codex.d.ts.map +1 -1
  243. package/vendor/runtime/dist/executor/codex.js +213 -11
  244. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts +2 -0
  245. package/vendor/runtime/dist/executor/codexProtocol/PlanType.d.ts.map +1 -0
  246. package/vendor/runtime/dist/executor/codexProtocol/PlanType.js +2 -0
  247. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.d.ts +6 -0
  248. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.d.ts.map +1 -0
  249. package/vendor/runtime/dist/executor/codexProtocol/v2/CreditsSnapshot.js +2 -0
  250. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts +26 -0
  251. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.d.ts.map +1 -0
  252. package/vendor/runtime/dist/executor/codexProtocol/v2/GetAccountRateLimitsResponse.js +2 -0
  253. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.d.ts +2 -0
  254. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.d.ts.map +1 -0
  255. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitReachedType.js +2 -0
  256. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.d.ts +27 -0
  257. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.d.ts.map +1 -0
  258. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCredit.js +2 -0
  259. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.d.ts +2 -0
  260. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.d.ts.map +1 -0
  261. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditStatus.js +2 -0
  262. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.d.ts +13 -0
  263. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.d.ts.map +1 -0
  264. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetCreditsSummary.js +2 -0
  265. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.d.ts +2 -0
  266. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.d.ts.map +1 -0
  267. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitResetType.js +2 -0
  268. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts +20 -0
  269. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.d.ts.map +1 -0
  270. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitSnapshot.js +2 -0
  271. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.d.ts +6 -0
  272. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.d.ts.map +1 -0
  273. package/vendor/runtime/dist/executor/codexProtocol/v2/RateLimitWindow.js +2 -0
  274. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.d.ts +2 -0
  275. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.d.ts.map +1 -0
  276. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewDelivery.js +2 -0
  277. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts +12 -0
  278. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.d.ts.map +1 -0
  279. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewStartParams.js +2 -0
  280. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.d.ts +17 -0
  281. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.d.ts.map +1 -0
  282. package/vendor/runtime/dist/executor/codexProtocol/v2/ReviewTarget.js +2 -0
  283. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.d.ts +5 -0
  284. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.d.ts.map +1 -0
  285. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillDependencies.js +2 -0
  286. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.d.ts +5 -0
  287. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.d.ts.map +1 -0
  288. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillErrorInfo.js +2 -0
  289. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.d.ts +18 -0
  290. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.d.ts.map +1 -0
  291. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillInterface.js +2 -0
  292. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.d.ts +22 -0
  293. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.d.ts.map +1 -0
  294. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillMetadata.js +2 -0
  295. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.d.ts +2 -0
  296. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.d.ts.map +1 -0
  297. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillScope.js +2 -0
  298. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.d.ts +9 -0
  299. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.d.ts.map +1 -0
  300. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillToolDependency.js +2 -0
  301. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.d.ts +8 -0
  302. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.d.ts.map +1 -0
  303. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListEntry.js +2 -0
  304. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.d.ts +5 -0
  305. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.d.ts.map +1 -0
  306. package/vendor/runtime/dist/executor/codexProtocol/v2/SkillsListResponse.js +2 -0
  307. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.d.ts +7 -0
  308. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.d.ts.map +1 -0
  309. package/vendor/runtime/dist/executor/codexProtocol/v2/SpendControlLimitSnapshot.js +2 -0
  310. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.d.ts +5 -0
  311. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.d.ts.map +1 -0
  312. package/vendor/runtime/dist/executor/codexProtocol/v2/ThreadSetNameParams.js +2 -0
  313. package/vendor/runtime/dist/executor/health.d.ts +1 -0
  314. package/vendor/runtime/dist/executor/health.d.ts.map +1 -1
  315. package/vendor/runtime/dist/executor/health.js +3 -0
  316. package/vendor/runtime/dist/executor/liveTurns.d.ts.map +1 -1
  317. package/vendor/runtime/dist/executor/liveTurns.js +3 -0
  318. package/vendor/runtime/dist/executor/providerRouter.d.ts.map +1 -1
  319. package/vendor/runtime/dist/executor/providerRouter.js +2 -1
  320. package/vendor/runtime/dist/executor/types.d.ts +8 -0
  321. package/vendor/runtime/dist/executor/types.d.ts.map +1 -1
  322. package/vendor/runtime/dist/harness/index.d.ts +1 -0
  323. package/vendor/runtime/dist/harness/index.d.ts.map +1 -1
  324. package/vendor/runtime/dist/harness/index.js +35 -1
  325. package/vendor/runtime/dist/harness/types.d.ts +4 -1
  326. package/vendor/runtime/dist/harness/types.d.ts.map +1 -1
  327. package/vendor/runtime/dist/index.d.ts +2 -1
  328. package/vendor/runtime/dist/index.d.ts.map +1 -1
  329. package/vendor/runtime/dist/index.js +2 -0
  330. package/vendor/runtime/dist/journal/context.d.ts +18 -0
  331. package/vendor/runtime/dist/journal/context.d.ts.map +1 -1
  332. package/vendor/runtime/dist/journal/context.js +19 -5
  333. package/vendor/runtime/dist/prompts/briefing.d.ts +4 -7
  334. package/vendor/runtime/dist/prompts/briefing.d.ts.map +1 -1
  335. package/vendor/runtime/dist/prompts/briefing.js +61 -12
  336. package/vendor/runtime/dist/prompts/cardStatement.d.ts +7 -0
  337. package/vendor/runtime/dist/prompts/cardStatement.d.ts.map +1 -0
  338. package/vendor/runtime/dist/prompts/cardStatement.js +52 -0
  339. package/vendor/runtime/dist/prompts/chat.d.ts +1 -0
  340. package/vendor/runtime/dist/prompts/chat.d.ts.map +1 -1
  341. package/vendor/runtime/dist/prompts/chat.js +15 -1
  342. package/vendor/runtime/dist/prompts/projectCapture.d.ts +7 -0
  343. package/vendor/runtime/dist/prompts/projectCapture.d.ts.map +1 -0
  344. package/vendor/runtime/dist/prompts/projectCapture.js +31 -0
  345. package/vendor/runtime/src/executor/claudeAgent.ts +133 -7
  346. package/vendor/runtime/src/executor/claudeCode.ts +6 -4
  347. package/vendor/runtime/src/executor/codex.ts +280 -20
  348. package/vendor/runtime/src/executor/codexProtocol/PlanType.ts +5 -0
  349. package/vendor/runtime/src/executor/codexProtocol/v2/CreditsSnapshot.ts +5 -0
  350. package/vendor/runtime/src/executor/codexProtocol/v2/GetAccountRateLimitsResponse.ts +25 -0
  351. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitReachedType.ts +5 -0
  352. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCredit.ts +27 -0
  353. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCreditStatus.ts +5 -0
  354. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetCreditsSummary.ts +14 -0
  355. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitResetType.ts +5 -0
  356. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitSnapshot.ts +14 -0
  357. package/vendor/runtime/src/executor/codexProtocol/v2/RateLimitWindow.ts +5 -0
  358. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewDelivery.ts +5 -0
  359. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewStartParams.ts +12 -0
  360. package/vendor/runtime/src/executor/codexProtocol/v2/ReviewTarget.ts +9 -0
  361. package/vendor/runtime/src/executor/codexProtocol/v2/SkillDependencies.ts +6 -0
  362. package/vendor/runtime/src/executor/codexProtocol/v2/SkillErrorInfo.ts +5 -0
  363. package/vendor/runtime/src/executor/codexProtocol/v2/SkillInterface.ts +14 -0
  364. package/vendor/runtime/src/executor/codexProtocol/v2/SkillMetadata.ts +17 -0
  365. package/vendor/runtime/src/executor/codexProtocol/v2/SkillScope.ts +5 -0
  366. package/vendor/runtime/src/executor/codexProtocol/v2/SkillToolDependency.ts +5 -0
  367. package/vendor/runtime/src/executor/codexProtocol/v2/SkillsListEntry.ts +7 -0
  368. package/vendor/runtime/src/executor/codexProtocol/v2/SkillsListResponse.ts +6 -0
  369. package/vendor/runtime/src/executor/codexProtocol/v2/SpendControlLimitSnapshot.ts +5 -0
  370. package/vendor/runtime/src/executor/codexProtocol/v2/ThreadSetNameParams.ts +5 -0
  371. package/vendor/runtime/src/executor/health.ts +3 -0
  372. package/vendor/runtime/src/executor/liveTurns.ts +3 -0
  373. package/vendor/runtime/src/executor/providerRouter.ts +2 -1
  374. package/vendor/runtime/src/executor/types.ts +8 -0
  375. package/vendor/runtime/src/harness/index.ts +40 -6
  376. package/vendor/runtime/src/harness/types.ts +4 -1
  377. package/vendor/runtime/src/index.ts +4 -1
  378. package/vendor/runtime/src/journal/context.ts +40 -7
  379. package/vendor/runtime/src/prompts/briefing.ts +62 -17
  380. package/vendor/runtime/src/prompts/cardStatement.ts +64 -0
  381. package/vendor/runtime/src/prompts/chat.ts +25 -3
  382. package/vendor/runtime/src/prompts/projectCapture.ts +51 -0
  383. package/vendor/shared/dist/agentCommands.d.ts +22 -0
  384. package/vendor/shared/dist/agentCommands.d.ts.map +1 -0
  385. package/vendor/shared/dist/agentCommands.js +11 -0
  386. package/vendor/shared/dist/automationTemplates.d.ts +37 -0
  387. package/vendor/shared/dist/automationTemplates.d.ts.map +1 -0
  388. package/vendor/shared/dist/automationTemplates.js +48 -0
  389. package/vendor/shared/dist/automations.d.ts +1052 -0
  390. package/vendor/shared/dist/automations.d.ts.map +1 -0
  391. package/vendor/shared/dist/automations.js +300 -0
  392. package/vendor/shared/dist/cardStatement.d.ts +28 -0
  393. package/vendor/shared/dist/cardStatement.d.ts.map +1 -0
  394. package/vendor/shared/dist/cardStatement.js +37 -0
  395. package/vendor/shared/dist/cardStudio.d.ts +756 -0
  396. package/vendor/shared/dist/cardStudio.d.ts.map +1 -0
  397. package/vendor/shared/dist/cardStudio.js +297 -0
  398. package/vendor/shared/dist/commandLocal.d.ts +218 -0
  399. package/vendor/shared/dist/commandLocal.d.ts.map +1 -0
  400. package/vendor/shared/dist/commandLocal.js +662 -0
  401. package/vendor/shared/dist/commandText.d.ts +12 -0
  402. package/vendor/shared/dist/commandText.d.ts.map +1 -0
  403. package/vendor/shared/dist/commandText.js +21 -0
  404. package/vendor/shared/dist/commands.d.ts +1516 -0
  405. package/vendor/shared/dist/commands.d.ts.map +1 -0
  406. package/vendor/shared/dist/commands.js +231 -0
  407. package/vendor/shared/dist/computer.d.ts +9 -9
  408. package/vendor/shared/dist/computer.d.ts.map +1 -1
  409. package/vendor/shared/dist/computer.js +11 -2
  410. package/vendor/shared/dist/constants.d.ts +3 -3
  411. package/vendor/shared/dist/constants.d.ts.map +1 -1
  412. package/vendor/shared/dist/constants.js +9 -2
  413. package/vendor/shared/dist/githubContributions.d.ts +93 -0
  414. package/vendor/shared/dist/githubContributions.d.ts.map +1 -0
  415. package/vendor/shared/dist/githubContributions.js +54 -0
  416. package/vendor/shared/dist/habitContributions.d.ts +26 -0
  417. package/vendor/shared/dist/habitContributions.d.ts.map +1 -0
  418. package/vendor/shared/dist/habitContributions.js +119 -0
  419. package/vendor/shared/dist/index.d.ts +26 -2
  420. package/vendor/shared/dist/index.d.ts.map +1 -1
  421. package/vendor/shared/dist/index.js +23 -2
  422. package/vendor/shared/dist/journal-migration.d.ts +29 -0
  423. package/vendor/shared/dist/journal-migration.d.ts.map +1 -0
  424. package/vendor/shared/dist/journal-migration.js +73 -0
  425. package/vendor/shared/dist/journal-vault.d.ts +414 -0
  426. package/vendor/shared/dist/journal-vault.d.ts.map +1 -0
  427. package/vendor/shared/dist/journal-vault.js +972 -0
  428. package/vendor/shared/dist/projectCapture.d.ts +73 -0
  429. package/vendor/shared/dist/projectCapture.d.ts.map +1 -0
  430. package/vendor/shared/dist/projectCapture.js +66 -0
  431. package/vendor/shared/dist/quickAdd.d.ts +90 -0
  432. package/vendor/shared/dist/quickAdd.d.ts.map +1 -0
  433. package/vendor/shared/dist/quickAdd.js +260 -0
  434. package/vendor/shared/dist/recurrence.d.ts +44 -0
  435. package/vendor/shared/dist/recurrence.d.ts.map +1 -0
  436. package/vendor/shared/dist/recurrence.js +37 -0
  437. package/vendor/shared/dist/reminderWords.d.ts +11 -0
  438. package/vendor/shared/dist/reminderWords.d.ts.map +1 -0
  439. package/vendor/shared/dist/reminderWords.js +63 -0
  440. package/vendor/shared/dist/schemas/comment.d.ts +13 -1
  441. package/vendor/shared/dist/schemas/comment.d.ts.map +1 -1
  442. package/vendor/shared/dist/schemas/comment.js +5 -0
  443. package/vendor/shared/dist/schemas/conversation.d.ts +3 -3
  444. package/vendor/shared/dist/schemas/harness.d.ts +922 -59
  445. package/vendor/shared/dist/schemas/harness.d.ts.map +1 -1
  446. package/vendor/shared/dist/schemas/harness.js +122 -3
  447. package/vendor/shared/dist/schemas/journal.d.ts +10 -0
  448. package/vendor/shared/dist/schemas/journal.d.ts.map +1 -1
  449. package/vendor/shared/dist/schemas/journal.js +10 -2
  450. package/vendor/shared/dist/schemas/notification.d.ts +1 -1
  451. package/vendor/shared/dist/schemas/organization.d.ts +3 -2
  452. package/vendor/shared/dist/schemas/organization.d.ts.map +1 -1
  453. package/vendor/shared/dist/schemas/organization.js +3 -2
  454. package/vendor/shared/dist/schemas/proposal.d.ts +7 -3
  455. package/vendor/shared/dist/schemas/proposal.d.ts.map +1 -1
  456. package/vendor/shared/dist/schemas/proposal.js +2 -1
  457. package/vendor/shared/dist/schemas/request.d.ts +44 -4
  458. package/vendor/shared/dist/schemas/request.d.ts.map +1 -1
  459. package/vendor/shared/dist/schemas/task.d.ts +83 -8
  460. package/vendor/shared/dist/schemas/task.d.ts.map +1 -1
  461. package/vendor/shared/dist/schemas/task.js +20 -2
  462. package/vendor/shared/dist/schemas/timeSession.d.ts +2 -2
  463. package/vendor/shared/dist/smartCapture.d.ts +60 -0
  464. package/vendor/shared/dist/smartCapture.d.ts.map +1 -0
  465. package/vendor/shared/dist/smartCapture.js +56 -0
  466. package/vendor/shared/dist/speech.d.ts +39 -0
  467. package/vendor/shared/dist/speech.d.ts.map +1 -0
  468. package/vendor/shared/dist/speech.js +36 -0
  469. package/vendor/shared/dist/spokenNames.d.ts +25 -0
  470. package/vendor/shared/dist/spokenNames.d.ts.map +1 -0
  471. package/vendor/shared/dist/spokenNames.js +120 -0
  472. package/vendor/shared/dist/taskActivity.d.ts +76 -0
  473. package/vendor/shared/dist/taskActivity.d.ts.map +1 -0
  474. package/vendor/shared/dist/taskActivity.js +27 -0
  475. package/vendor/shared/dist/vault-search.d.ts +50 -0
  476. package/vendor/shared/dist/vault-search.d.ts.map +1 -0
  477. package/vendor/shared/dist/vault-search.js +177 -0
  478. package/vendor/shared/dist/voiceCapture.d.ts +32 -0
  479. package/vendor/shared/dist/voiceCapture.d.ts.map +1 -0
  480. package/vendor/shared/dist/voiceCapture.js +29 -0
  481. package/vendor/shared/package.json +4 -0
  482. package/vendor/shared/src/agentCommands.ts +35 -0
  483. package/vendor/shared/src/automationTemplates.ts +54 -0
  484. package/vendor/shared/src/automations.ts +329 -0
  485. package/vendor/shared/src/cardStatement.ts +49 -0
  486. package/vendor/shared/src/cardStudio.ts +340 -0
  487. package/vendor/shared/src/commandLocal.ts +738 -0
  488. package/vendor/shared/src/commandText.ts +25 -0
  489. package/vendor/shared/src/commands.ts +253 -0
  490. package/vendor/shared/src/computer.ts +23 -6
  491. package/vendor/shared/src/constants.ts +9 -2
  492. package/vendor/shared/src/githubContributions.ts +70 -0
  493. package/vendor/shared/src/habitContributions.ts +144 -0
  494. package/vendor/shared/src/index.ts +42 -1
  495. package/vendor/shared/src/journal-migration.ts +130 -0
  496. package/vendor/shared/src/journal-vault.ts +1240 -0
  497. package/vendor/shared/src/projectCapture.ts +86 -0
  498. package/vendor/shared/src/quickAdd.ts +310 -0
  499. package/vendor/shared/src/recurrence.ts +37 -0
  500. package/vendor/shared/src/reminderWords.ts +54 -0
  501. package/vendor/shared/src/schemas/comment.ts +5 -0
  502. package/vendor/shared/src/schemas/harness.ts +144 -7
  503. package/vendor/shared/src/schemas/journal.ts +15 -6
  504. package/vendor/shared/src/schemas/organization.ts +3 -2
  505. package/vendor/shared/src/schemas/proposal.ts +6 -1
  506. package/vendor/shared/src/schemas/task.ts +20 -2
  507. package/vendor/shared/src/smartCapture.ts +67 -0
  508. package/vendor/shared/src/speech.ts +44 -0
  509. package/vendor/shared/src/spokenNames.ts +128 -0
  510. package/vendor/shared/src/taskActivity.ts +34 -0
  511. package/vendor/shared/src/vault-search.ts +243 -0
  512. package/vendor/shared/src/voiceCapture.ts +34 -0
@@ -0,0 +1,32 @@
1
+ import type { ChoiceAnswer } from './types.js';
2
+
3
+ /** Thresholds must be evaluated for each task. Acceptance is never permission to act. */
4
+ export function gateDecision<T extends string>(
5
+ answer: ChoiceAnswer<T>,
6
+ options: { minConfidence: number; abstain: readonly T[] },
7
+ ):
8
+ | { accepted: true; choice: T }
9
+ | {
10
+ accepted: false;
11
+ reason: 'unclear' | 'missing_confidence' | 'low_confidence';
12
+ } {
13
+ if (
14
+ !Number.isFinite(options.minConfidence) ||
15
+ options.minConfidence < 0 ||
16
+ options.minConfidence > 1
17
+ ) {
18
+ throw new Error('Decision confidence threshold must be between 0 and 1.');
19
+ }
20
+ if (options.abstain.includes(answer.choice))
21
+ return { accepted: false, reason: 'unclear' };
22
+ if (answer.confidence === undefined)
23
+ return { accepted: false, reason: 'missing_confidence' };
24
+ if (
25
+ !Number.isFinite(answer.confidence) ||
26
+ answer.confidence < options.minConfidence ||
27
+ answer.confidence > 1
28
+ ) {
29
+ return { accepted: false, reason: 'low_confidence' };
30
+ }
31
+ return { accepted: true, choice: answer.choice };
32
+ }
@@ -0,0 +1,5 @@
1
+ export * from './types.js';
2
+ export * from './jev.js';
3
+ export * from './gate.js';
4
+ export * from './capture.js';
5
+ export * from './command.js';
@@ -0,0 +1,293 @@
1
+ import type {
2
+ AnswerFor,
3
+ DecisionClient,
4
+ DecisionFailureReason,
5
+ DecisionQuestion,
6
+ DecisionRequest,
7
+ DecisionResult,
8
+ } from './types.js';
9
+
10
+ export const JEV_MODEL = 'typesafe-ai/jev';
11
+ const ENDPOINT = 'https://ai-gateway.vercel.sh/v1/evaluate';
12
+ export const DEFAULT_DECISION_TIMEOUT_MS = 2_000;
13
+
14
+ type ObjectValue = Record<string, unknown>;
15
+ function object(value: unknown): value is ObjectValue {
16
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
17
+ }
18
+ function probability(value: unknown): value is number {
19
+ return (
20
+ typeof value === 'number' &&
21
+ Number.isFinite(value) &&
22
+ value >= 0 &&
23
+ value <= 1
24
+ );
25
+ }
26
+ function nonnegative(value: unknown): value is number {
27
+ return typeof value === 'number' && Number.isFinite(value) && value >= 0;
28
+ }
29
+ function money(value: unknown): number | undefined {
30
+ if (typeof value !== 'string' && typeof value !== 'number') return;
31
+ if (typeof value === 'string' && !/^\d+(\.\d+)?$/.test(value)) return;
32
+ const parsed = Number(value);
33
+ return nonnegative(parsed) ? parsed : undefined;
34
+ }
35
+
36
+ function distribution(
37
+ value: unknown,
38
+ options: string[],
39
+ ): value is Record<string, number> {
40
+ if (!object(value) || Object.keys(value).length !== options.length)
41
+ return false;
42
+ if (
43
+ !options.every(
44
+ (key) => Object.hasOwn(value, key) && probability(value[key]),
45
+ )
46
+ )
47
+ return false;
48
+ // Allow provider rounding, but reject incomplete/invalid distributions.
49
+ const sum = options.reduce((total, key) => total + (value[key] as number), 0);
50
+ return Math.abs(sum - 1) <= 0.02;
51
+ }
52
+
53
+ function validQuestions(questions: Record<string, DecisionQuestion>): boolean {
54
+ if (!object(questions) || Object.keys(questions).length === 0) return false;
55
+ return Object.values(questions).every((question) => {
56
+ if (
57
+ !object(question) ||
58
+ typeof question.instructions !== 'string' ||
59
+ !question.instructions.trim()
60
+ )
61
+ return false;
62
+ if (question.type === 'boolean') return true;
63
+ if (question.type === 'choice') {
64
+ return (
65
+ object(question.criteria) &&
66
+ Object.keys(question.criteria).length >= 2 &&
67
+ Object.keys(question.criteria).length <= 255 &&
68
+ Object.entries(question.criteria).every(
69
+ ([key, value]) =>
70
+ key.length > 0 &&
71
+ typeof value === 'string' &&
72
+ value.trim().length > 0,
73
+ )
74
+ );
75
+ }
76
+ return (
77
+ question.type === 'score' &&
78
+ Array.isArray(question.criteria) &&
79
+ question.criteria.length >= 2 &&
80
+ question.criteria.length <= 10 &&
81
+ question.criteria.every(
82
+ (level) => typeof level === 'string' && level.trim().length > 0,
83
+ )
84
+ );
85
+ });
86
+ }
87
+
88
+ function parseAnswers<Q extends Record<string, DecisionQuestion>>(
89
+ body: ObjectValue,
90
+ questions: Q,
91
+ ) {
92
+ if (!object(body.answers)) return;
93
+ const metadata = object(body.providerMetadata) ? body.providerMetadata : {};
94
+ const typesafe = object(metadata.typesafe) ? metadata.typesafe : {};
95
+ const confidence = object(typesafe.confidence) ? typesafe.confidence : {};
96
+ const entries: [string, unknown][] = [];
97
+ for (const [key, question] of Object.entries(questions)) {
98
+ const answer = body.answers[key];
99
+ if (
100
+ !Object.hasOwn(body.answers, key) ||
101
+ !object(answer) ||
102
+ answer.type !== question.type
103
+ )
104
+ return;
105
+ if (question.type === 'boolean') {
106
+ if (!probability(answer.probability)) return;
107
+ entries.push([key, { type: 'boolean', probability: answer.probability }]);
108
+ continue;
109
+ }
110
+ const direct = answer.confidence;
111
+ const extra = Object.hasOwn(confidence, key) ? confidence[key] : undefined;
112
+ if (
113
+ (direct !== undefined && !probability(direct)) ||
114
+ (extra !== undefined && !probability(extra))
115
+ )
116
+ return;
117
+ if (
118
+ direct !== undefined &&
119
+ extra !== undefined &&
120
+ Math.abs((direct as number) - (extra as number)) > 0.000001
121
+ )
122
+ return;
123
+ const certainty = direct ?? extra;
124
+ const common = certainty === undefined ? {} : { confidence: certainty };
125
+ if (question.type === 'choice') {
126
+ if (
127
+ typeof answer.choice !== 'string' ||
128
+ !Object.hasOwn(question.criteria, answer.choice) ||
129
+ !distribution(answer.probabilities, Object.keys(question.criteria))
130
+ )
131
+ return;
132
+ entries.push([
133
+ key,
134
+ {
135
+ type: 'choice',
136
+ choice: answer.choice,
137
+ probabilities: answer.probabilities,
138
+ ...common,
139
+ },
140
+ ]);
141
+ } else {
142
+ const levels = question.criteria.map((_, index) => String(index));
143
+ if (
144
+ !nonnegative(answer.score) ||
145
+ answer.score > question.criteria.length - 1 ||
146
+ !distribution(answer.probabilities, levels)
147
+ )
148
+ return;
149
+ entries.push([
150
+ key,
151
+ {
152
+ type: 'score',
153
+ score: answer.score,
154
+ probabilities: answer.probabilities,
155
+ ...common,
156
+ },
157
+ ]);
158
+ }
159
+ }
160
+ return Object.fromEntries(entries) as { [K in keyof Q]: AnswerFor<Q[K]> };
161
+ }
162
+
163
+ function httpFailure(status: number, body: unknown): DecisionFailureReason {
164
+ const error = object(body) && object(body.error) ? body.error : {};
165
+ if (error.type === 'customer_verification_required' || status === 402)
166
+ return 'billing';
167
+ if (status === 401 || status === 403) return 'authentication';
168
+ if (status === 400 || status === 422) return 'invalid_request';
169
+ if (status === 429) return 'rate_limit';
170
+ return 'unavailable';
171
+ }
172
+
173
+ export interface JevDecisionClientOptions {
174
+ apiKey: string;
175
+ timeoutMs?: number;
176
+ /** Test seam. Production calls always use the fixed HTTPS Gateway endpoint. */
177
+ fetch?: typeof fetch;
178
+ }
179
+
180
+ /** A single bounded attempt. The caller owns fallback and any eventual action. */
181
+ export class JevDecisionClient implements DecisionClient {
182
+ #apiKey: string;
183
+ #fetch: typeof fetch;
184
+ #timeoutMs: number;
185
+
186
+ constructor(options: JevDecisionClientOptions) {
187
+ this.#apiKey = options.apiKey.trim();
188
+ this.#fetch = options.fetch ?? fetch;
189
+ this.#timeoutMs = options.timeoutMs ?? DEFAULT_DECISION_TIMEOUT_MS;
190
+ if (!this.#apiKey || /[\r\n]/.test(this.#apiKey))
191
+ throw new Error('A valid AI Gateway key is required.');
192
+ if (
193
+ !Number.isInteger(this.#timeoutMs) ||
194
+ this.#timeoutMs < 1 ||
195
+ this.#timeoutMs > 30_000
196
+ ) {
197
+ throw new Error('Decision timeout must be between 1 and 30000 ms.');
198
+ }
199
+ }
200
+
201
+ async evaluate<Q extends Record<string, DecisionQuestion>>(
202
+ request: DecisionRequest<Q>,
203
+ ): Promise<DecisionResult<Q>> {
204
+ const start = performance.now();
205
+ const elapsed = () => Math.round(performance.now() - start);
206
+ const fail = (
207
+ reason: DecisionFailureReason,
208
+ status?: number,
209
+ ): DecisionResult<Q> => ({
210
+ ok: false,
211
+ reason,
212
+ elapsedMs: elapsed(),
213
+ ...(status === undefined ? {} : { status }),
214
+ });
215
+ if (request.signal?.aborted) return fail('cancelled');
216
+ let payload: string;
217
+ try {
218
+ if (!validQuestions(request.questions) || request.state === undefined)
219
+ return fail('invalid_request');
220
+ payload = JSON.stringify({
221
+ model: JEV_MODEL,
222
+ state: request.state,
223
+ questions: request.questions,
224
+ });
225
+ // Byte guard, not a token estimate. Reject oversized state instead of silently truncating it.
226
+ if (new TextEncoder().encode(payload).length > 128_000)
227
+ return fail('invalid_request');
228
+ } catch {
229
+ return fail('invalid_request');
230
+ }
231
+ const controller = new AbortController();
232
+ const cancel = () => controller.abort();
233
+ request.signal?.addEventListener('abort', cancel, { once: true });
234
+ let timedOut = false;
235
+ const timer = setTimeout(() => {
236
+ timedOut = true;
237
+ controller.abort();
238
+ }, this.#timeoutMs);
239
+ try {
240
+ const response = await this.#fetch(ENDPOINT, {
241
+ method: 'POST',
242
+ headers: {
243
+ Authorization: `Bearer ${this.#apiKey}`,
244
+ 'Content-Type': 'application/json',
245
+ },
246
+ body: payload,
247
+ signal: controller.signal,
248
+ redirect: 'error',
249
+ });
250
+ const body: unknown = await response.json().catch(() => undefined);
251
+ if (request.signal?.aborted) return fail('cancelled');
252
+ if (timedOut) return fail('timeout');
253
+ if (!response.ok)
254
+ return fail(httpFailure(response.status, body), response.status);
255
+ if (!object(body) || body.model !== JEV_MODEL)
256
+ return fail('invalid_response');
257
+ const answers = parseAnswers(body, request.questions);
258
+ if (!answers) return fail('invalid_response');
259
+ const meta = object(body.providerMetadata) ? body.providerMetadata : {};
260
+ const gateway = object(meta.gateway) ? meta.gateway : {};
261
+ const usage =
262
+ object(body.usage) &&
263
+ nonnegative(body.usage.inputTokens) &&
264
+ nonnegative(body.usage.outputTokens)
265
+ ? {
266
+ inputTokens: body.usage.inputTokens,
267
+ outputTokens: body.usage.outputTokens,
268
+ }
269
+ : undefined;
270
+ return {
271
+ ok: true,
272
+ answers,
273
+ model: JEV_MODEL,
274
+ elapsedMs: elapsed(),
275
+ usage,
276
+ costUsd: money(gateway.cost),
277
+ marketCostUsd: money(gateway.marketCost),
278
+ };
279
+ } catch {
280
+ // Never propagate provider bodies, request state, headers, or credential-bearing exceptions.
281
+ return fail(
282
+ request.signal?.aborted
283
+ ? 'cancelled'
284
+ : timedOut
285
+ ? 'timeout'
286
+ : 'unavailable',
287
+ );
288
+ } finally {
289
+ clearTimeout(timer);
290
+ request.signal?.removeEventListener('abort', cancel);
291
+ }
292
+ }
293
+ }
@@ -0,0 +1,79 @@
1
+ export type DecisionState =
2
+ | string
3
+ | number
4
+ | boolean
5
+ | null
6
+ | DecisionState[]
7
+ | { [key: string]: DecisionState };
8
+
9
+ export type DecisionQuestion =
10
+ | { type: 'choice'; instructions: string; criteria: Record<string, string> }
11
+ | { type: 'boolean'; instructions: string }
12
+ | { type: 'score'; instructions: string; criteria: readonly string[] };
13
+
14
+ export interface ChoiceAnswer<T extends string = string> {
15
+ type: 'choice';
16
+ choice: T;
17
+ probabilities: Record<T, number>;
18
+ /** Provider statistic, distinct from the selected option's probability. */
19
+ confidence?: number;
20
+ }
21
+
22
+ export interface ScoreAnswer {
23
+ type: 'score';
24
+ score: number;
25
+ probabilities: Record<string, number>;
26
+ confidence?: number;
27
+ }
28
+
29
+ export interface BooleanAnswer {
30
+ type: 'boolean';
31
+ probability: number;
32
+ }
33
+
34
+ export type AnswerFor<Q extends DecisionQuestion> = Q extends { type: 'choice' }
35
+ ? ChoiceAnswer<Extract<keyof Q['criteria'], string>>
36
+ : Q extends { type: 'score' }
37
+ ? ScoreAnswer
38
+ : BooleanAnswer;
39
+
40
+ export interface DecisionRequest<Q extends Record<string, DecisionQuestion>> {
41
+ state: DecisionState;
42
+ questions: Q;
43
+ signal?: AbortSignal;
44
+ }
45
+
46
+ export type DecisionFailureReason =
47
+ | 'invalid_request'
48
+ | 'authentication'
49
+ | 'billing'
50
+ | 'rate_limit'
51
+ | 'unavailable'
52
+ | 'invalid_response'
53
+ | 'timeout'
54
+ | 'cancelled';
55
+
56
+ export type DecisionResult<Q extends Record<string, DecisionQuestion>> =
57
+ | {
58
+ ok: true;
59
+ answers: { [K in keyof Q]: AnswerFor<Q[K]> };
60
+ model: string;
61
+ elapsedMs: number;
62
+ usage?: { inputTokens: number; outputTokens: number };
63
+ /** Provider-reported dollars; absent means unknown, not free. */
64
+ costUsd?: number;
65
+ marketCostUsd?: number;
66
+ }
67
+ | {
68
+ ok: false;
69
+ reason: DecisionFailureReason;
70
+ elapsedMs: number;
71
+ status?: number;
72
+ };
73
+
74
+ /** Decisions only. Implementations cannot call tools or mutate Lucidity tasks. */
75
+ export interface DecisionClient {
76
+ evaluate<Q extends Record<string, DecisionQuestion>>(
77
+ request: DecisionRequest<Q>,
78
+ ): Promise<DecisionResult<Q>>;
79
+ }
@@ -151,6 +151,7 @@ from `packages/mcp-server` to remove that optional link.
151
151
  - **Comments:** `list_comments` `create_comment` `delete_comment`
152
152
  - **Queries:** `get_today` `get_week` `search` `get_task_stats` `get_unreviewed_tasks`
153
153
  - **Notes:** `list_notes` `read_note` `search_notes` `write_note` `edit_note`
154
+ - **Journal:** `search_journal` `read_journal_day` — search spoken entries across all dates, then read a matching day. Searches use corrected transcripts and return local journal dates, excerpts, and `nextOffset` for pagination.
154
155
  - **Memory (opt-in):** `read_memory` `remember` `forget`
155
156
 
156
157
  Tools advertise MCP annotations for reads, writes, destructive operations, and
@@ -159,6 +160,10 @@ client guidance; the API and local vault checks still enforce access.
159
160
  `complete_task` toggles state, so repeating it can
160
161
  undo a completion or advance a recurring task again. `create_comment.source`
161
162
  uses the legacy API value `claude` for AI-authored comments from any client,
162
- including Codex.
163
+ including Codex. Set `agent_provider` to `claude` or `codex` when known;
164
+ otherwise recognized Claude/Codex MCP client names supply it automatically for AI
165
+ comments. Generic hosts remain unknown unless the caller supplies the provider.
166
+ Human comments never carry provider attribution. The API stores this as optional
167
+ `agentProvider`; old comments remain unknown because their legacy source is ambiguous.
163
168
 
164
169
  See [/docs/mcp-server.md](../../docs/mcp-server.md) for architecture and auth design.
@@ -1,2 +1,3 @@
1
+ export declare function setClientNameReader(reader: () => string | undefined): void;
1
2
  export declare function apiRequest<T>(endpoint: string, options?: RequestInit): Promise<T>;
2
3
  //# sourceMappingURL=client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AA4BA,wBAAsB,UAAU,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC,CA2DZ"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,QAEnE;AA2BD,wBAAsB,UAAU,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC,CA8DZ"}
@@ -1,5 +1,10 @@
1
+ import { commentProvider } from './commentProvider.js';
1
2
  const API_KEY = process.env['LUCIDITY_API_KEY'];
2
3
  const API_URL = process.env['LUCIDITY_API_URL'] || 'https://api.lucidity.my';
4
+ let getClientName = () => undefined;
5
+ export function setClientNameReader(reader) {
6
+ getClientName = reader;
7
+ }
3
8
  if (!API_KEY) {
4
9
  console.error('LUCIDITY_API_KEY environment variable is required.\n' +
5
10
  'Generate one in Lucidity app: Settings → API Key → Generate.');
@@ -22,6 +27,7 @@ const BACKOFF_MS = [400, 1200];
22
27
  const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
23
28
  export async function apiRequest(endpoint, options = {}) {
24
29
  const url = `${API_URL}${endpoint}`;
30
+ const provider = commentProvider(getClientName());
25
31
  let lastStatus = 0;
26
32
  let lastMessage = '';
27
33
  for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
@@ -32,6 +38,8 @@ export async function apiRequest(endpoint, options = {}) {
32
38
  headers: {
33
39
  'Content-Type': 'application/json',
34
40
  Authorization: `Bearer ${API_KEY}`,
41
+ 'X-Lucidity-Actor': 'agent',
42
+ ...(provider ? { 'X-Lucidity-Agent-Provider': provider } : {}),
35
43
  ...options.headers,
36
44
  },
37
45
  });
@@ -0,0 +1,3 @@
1
+ /** Known provider-specific MCP hosts. Multi-provider hosts must supply agent_provider. */
2
+ export declare function commentProvider(clientName?: string): 'claude' | 'codex' | undefined;
3
+ //# sourceMappingURL=commentProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commentProvider.d.ts","sourceRoot":"","sources":["../src/commentProvider.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAOnF"}
@@ -0,0 +1,10 @@
1
+ /** Known provider-specific MCP hosts. Multi-provider hosts must supply agent_provider. */
2
+ export function commentProvider(clientName) {
3
+ const name = clientName?.toLowerCase().replace(/[ _]/g, '-');
4
+ if (name && ['codex', 'codex-mcp-client'].includes(name))
5
+ return 'codex';
6
+ if (name && ['claude', 'claude-code', 'claude-ai', 'claude-desktop'].includes(name)) {
7
+ return 'claude';
8
+ }
9
+ return undefined;
10
+ }
@@ -3,27 +3,42 @@ import { readFileSync } from 'node:fs';
3
3
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
4
4
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
5
5
  import { registerTaskTools } from './tools/tasks.js';
6
+ import { registerTaskActivityTools } from './tools/taskActivity.js';
7
+ import { registerTaskTrashTools } from './tools/taskTrash.js';
8
+ import { registerTaskOccurrenceTools } from './tools/taskOccurrences.js';
9
+ import { setClientNameReader } from './client.js';
6
10
  import { registerProjectTools } from './tools/projects.js';
7
11
  import { registerQueryTools } from './tools/queries.js';
8
12
  import { registerMilestoneTools } from './tools/milestones.js';
9
13
  import { registerCommentTools } from './tools/comments.js';
10
14
  import { registerNoteTools } from './tools/notes.js';
11
15
  import { registerMemoryTools } from './tools/memory.js';
16
+ import { registerJournalTools } from './tools/journal.js';
17
+ import { registerAutomationTools } from './tools/automations.js';
18
+ import { registerCommandEventTools } from './tools/commandEvents.js';
12
19
  const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
13
20
  const server = new McpServer({ name: 'lucidity', version }, {
14
- instructions: 'Manage Lucidity tasks, projects, milestones, comments, and local notes. ' +
15
- 'Use list/search tools to resolve IDs, then get_task for full details. ' +
16
- 'Filter and paginate list_tasks; use get_task_stats for counts. ' +
17
- 'complete_task toggles completion and advances recurring tasks; check state before repeating it. ' +
18
- "Note paths are relative to the configured vault. Memory tools, when available, share Lucid's MEMORY.md. " +
19
- 'For AI-authored comments, source="claude" is the legacy API value for every AI client.',
21
+ instructions: 'Lucidity tasks, projects, milestones, comments, notes and journal. ' +
22
+ 'Use search_journal for past events/visits; read_journal_day for context. ' +
23
+ 'Resolve IDs with list/search then get_task; paginate list_tasks. ' +
24
+ 'complete_task sets a desired state; repeats require occurrence_id from get_task. ' +
25
+ 'Note paths are vault-relative; memory shares MEMORY.md. ' +
26
+ 'AI comments use source="claude" plus agent_provider; set agent_model and agent_client only when known. Never infer a model from its host.',
20
27
  });
28
+ setClientNameReader(() => server.server.getClientVersion()?.name);
21
29
  registerTaskTools(server);
30
+ registerTaskActivityTools(server);
31
+ registerTaskTrashTools(server);
32
+ registerTaskOccurrenceTools(server);
22
33
  registerProjectTools(server);
23
34
  registerQueryTools(server);
24
35
  registerMilestoneTools(server);
25
36
  registerCommentTools(server);
26
37
  registerNoteTools(server);
38
+ registerJournalTools(server);
39
+ registerCommandEventTools(server);
40
+ if (process.env.LUCIDITY_DAEMON_CONFIG_PATH)
41
+ registerAutomationTools(server);
27
42
  // Lucid's own long-term memory — only when the daemon runs us with a vault
28
43
  // (`LUCIDITY_VAULT_PATH`). Standalone clients can opt in with the same variable.
29
44
  if (process.env['LUCIDITY_VAULT_PATH']?.trim())
@@ -0,0 +1,6 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ export declare function automationRequest(body: unknown, configPath?: string | undefined, request?: typeof fetch): Promise<{
3
+ error?: string;
4
+ }>;
5
+ export declare function registerAutomationTools(server: McpServer): void;
6
+ //# sourceMappingURL=automations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"automations.d.ts","sourceRoot":"","sources":["../../src/tools/automations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,OAAO,EACb,UAAU,qBAA0C,EACpD,OAAO,eAAQ;YAmCqC,MAAM;GAI3D;AA8GD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAyCxD"}