@ai-devkit/agent-manager 0.31.0 → 0.33.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 (519) hide show
  1. package/dist/AgentManager.d.ts +3 -3
  2. package/dist/AgentManager.d.ts.map +1 -1
  3. package/dist/AgentManager.js +80 -79
  4. package/dist/AgentManager.js.map +1 -1
  5. package/dist/__tests__/AgentManager.test.js +413 -388
  6. package/dist/__tests__/AgentManager.test.js.map +1 -1
  7. package/dist/__tests__/adapters/ClaudeCodeAdapter.test.js +642 -642
  8. package/dist/__tests__/adapters/ClaudeCodeAdapter.test.js.map +1 -1
  9. package/dist/__tests__/adapters/CodexAdapter.test.js +322 -2321
  10. package/dist/__tests__/adapters/CodexAdapter.test.js.map +1 -1
  11. package/dist/__tests__/adapters/CopilotAdapter.test.js +254 -248
  12. package/dist/__tests__/adapters/CopilotAdapter.test.js.map +1 -1
  13. package/dist/__tests__/adapters/GeminiCliAdapter.test.js +564 -558
  14. package/dist/__tests__/adapters/GeminiCliAdapter.test.js.map +1 -1
  15. package/dist/__tests__/adapters/GrokCliAdapter.test.js +114 -114
  16. package/dist/__tests__/adapters/GrokCliAdapter.test.js.map +1 -1
  17. package/dist/__tests__/adapters/OpenCodeAdapter.test.js +169 -169
  18. package/dist/__tests__/adapters/OpenCodeAdapter.test.js.map +1 -1
  19. package/dist/__tests__/capacity/codex.test.js +93 -93
  20. package/dist/__tests__/capacity/codex.test.js.map +1 -1
  21. package/dist/__tests__/capacity/index.test.js +17 -17
  22. package/dist/__tests__/capacity/index.test.js.map +1 -1
  23. package/dist/__tests__/durable/CodexCliProbe.test.js +60 -60
  24. package/dist/__tests__/durable/CodexCliProbe.test.js.map +1 -1
  25. package/dist/__tests__/durable/CodexDurableAgentRepository.test.js +28 -28
  26. package/dist/__tests__/durable/CodexDurableAgentRepository.test.js.map +1 -1
  27. package/dist/__tests__/durable/CodexPrintAgent.integration.test.js +30 -30
  28. package/dist/__tests__/durable/CodexPrintAgent.integration.test.js.map +1 -1
  29. package/dist/__tests__/durable/CodexPrintAgentService.test.js +71 -71
  30. package/dist/__tests__/durable/CodexPrintAgentService.test.js.map +1 -1
  31. package/dist/__tests__/durable/CodexPrintRunner.test.js +125 -125
  32. package/dist/__tests__/durable/CodexPrintRunner.test.js.map +1 -1
  33. package/dist/__tests__/print/ClaudeCliProbe.test.js +20 -20
  34. package/dist/__tests__/print/ClaudeCliProbe.test.js.map +1 -1
  35. package/dist/__tests__/print/ClaudePrintAgent.integration.test.js +20 -20
  36. package/dist/__tests__/print/ClaudePrintAgent.integration.test.js.map +1 -1
  37. package/dist/__tests__/print/ClaudePrintAgentService.test.js +58 -58
  38. package/dist/__tests__/print/ClaudePrintAgentService.test.js.map +1 -1
  39. package/dist/__tests__/print/ClaudePrintRunner.test.js +55 -55
  40. package/dist/__tests__/print/ClaudePrintRunner.test.js.map +1 -1
  41. package/dist/__tests__/print/DurableAgent.test.js +9 -9
  42. package/dist/__tests__/print/DurableAgent.test.js.map +1 -1
  43. package/dist/__tests__/print/DurableAgentRepository.sqlite.test.js +40 -40
  44. package/dist/__tests__/print/DurableAgentRepository.sqlite.test.js.map +1 -1
  45. package/dist/__tests__/print/DurableAgentRepository.test.js +66 -66
  46. package/dist/__tests__/print/DurableAgentRepository.test.js.map +1 -1
  47. package/dist/__tests__/providers/claude/ClaudeAgentMapper.test.js +34 -34
  48. package/dist/__tests__/providers/claude/ClaudeAgentMapper.test.js.map +1 -1
  49. package/dist/__tests__/providers/claude/ClaudeSessionLocator.test.js +132 -132
  50. package/dist/__tests__/providers/claude/ClaudeSessionLocator.test.js.map +1 -1
  51. package/dist/__tests__/providers/codex/CodexSessionLocator.test.js +194 -0
  52. package/dist/__tests__/providers/codex/CodexSessionLocator.test.js.map +1 -0
  53. package/dist/__tests__/providers/codex/CodexSessionMapping.test.js +86 -0
  54. package/dist/__tests__/providers/codex/CodexSessionMapping.test.js.map +1 -0
  55. package/dist/__tests__/providers/codex/CodexSessionParser.test.js +254 -0
  56. package/dist/__tests__/providers/codex/CodexSessionParser.test.js.map +1 -0
  57. package/dist/__tests__/providers/pi/PiAdapter.test.js +337 -0
  58. package/dist/__tests__/providers/pi/PiAdapter.test.js.map +1 -0
  59. package/dist/__tests__/providers/pi/PiSessionParser.test.js +246 -0
  60. package/dist/__tests__/providers/pi/PiSessionParser.test.js.map +1 -0
  61. package/dist/__tests__/providers/pi/PiSessionTracker.test.js +108 -0
  62. package/dist/__tests__/providers/pi/PiSessionTracker.test.js.map +1 -0
  63. package/dist/__tests__/providers/pi/durable/PiCliProbe.test.js +33 -33
  64. package/dist/__tests__/providers/pi/durable/PiCliProbe.test.js.map +1 -1
  65. package/dist/__tests__/providers/pi/durable/PiDurableAgentRepository.test.js +16 -16
  66. package/dist/__tests__/providers/pi/durable/PiDurableAgentRepository.test.js.map +1 -1
  67. package/dist/__tests__/providers/pi/durable/PiPrintAgentService.test.js +52 -52
  68. package/dist/__tests__/providers/pi/durable/PiPrintAgentService.test.js.map +1 -1
  69. package/dist/__tests__/providers/pi/durable/PiPrintProtocol.test.js +44 -44
  70. package/dist/__tests__/providers/pi/durable/PiPrintProtocol.test.js.map +1 -1
  71. package/dist/__tests__/providers/pi/durable/PiPrintRunner.test.js +126 -126
  72. package/dist/__tests__/providers/pi/durable/PiPrintRunner.test.js.map +1 -1
  73. package/dist/__tests__/providers/pi/durable/PiStreamParser.test.js +14 -14
  74. package/dist/__tests__/providers/pi/durable/PiStreamParser.test.js.map +1 -1
  75. package/dist/__tests__/readiness/AgentReadiness.test.js +301 -0
  76. package/dist/__tests__/readiness/AgentReadiness.test.js.map +1 -0
  77. package/dist/__tests__/runtime/AgentRuntime.test.js +13 -0
  78. package/dist/__tests__/runtime/AgentRuntime.test.js.map +1 -0
  79. package/dist/__tests__/runtime/HerdrAgentRuntime.test.js +452 -0
  80. package/dist/__tests__/runtime/HerdrAgentRuntime.test.js.map +1 -0
  81. package/dist/__tests__/runtime/ManagedAgentRuntime.test.js +588 -0
  82. package/dist/__tests__/runtime/ManagedAgentRuntime.test.js.map +1 -0
  83. package/dist/__tests__/terminal/TerminalFocusManager.test.js +100 -100
  84. package/dist/__tests__/terminal/TerminalFocusManager.test.js.map +1 -1
  85. package/dist/__tests__/terminal/TmuxManager.test.js +101 -101
  86. package/dist/__tests__/terminal/TmuxManager.test.js.map +1 -1
  87. package/dist/__tests__/terminal/TtyWriter.test.js +185 -185
  88. package/dist/__tests__/terminal/TtyWriter.test.js.map +1 -1
  89. package/dist/__tests__/utils/AgentRegistry.test.js +335 -217
  90. package/dist/__tests__/utils/AgentRegistry.test.js.map +1 -1
  91. package/dist/__tests__/utils/ClaudeSessionParser.test.js +103 -101
  92. package/dist/__tests__/utils/ClaudeSessionParser.test.js.map +1 -1
  93. package/dist/__tests__/utils/agent-requests.test.js +43 -43
  94. package/dist/__tests__/utils/agent-requests.test.js.map +1 -1
  95. package/dist/__tests__/utils/agents.test.js +17 -17
  96. package/dist/__tests__/utils/agents.test.js.map +1 -1
  97. package/dist/__tests__/utils/matching.test.js +92 -92
  98. package/dist/__tests__/utils/matching.test.js.map +1 -1
  99. package/dist/__tests__/utils/process.test.js +108 -108
  100. package/dist/__tests__/utils/process.test.js.map +1 -1
  101. package/dist/__tests__/utils/session.test.js +53 -53
  102. package/dist/__tests__/utils/session.test.js.map +1 -1
  103. package/dist/adapters/AgentAdapter.d.ts +2 -2
  104. package/dist/adapters/AgentAdapter.d.ts.map +1 -1
  105. package/dist/adapters/AgentAdapter.js +1 -1
  106. package/dist/adapters/AgentAdapter.js.map +1 -1
  107. package/dist/adapters/CopilotAdapter.d.ts +2 -2
  108. package/dist/adapters/CopilotAdapter.d.ts.map +1 -1
  109. package/dist/adapters/CopilotAdapter.js +51 -51
  110. package/dist/adapters/CopilotAdapter.js.map +1 -1
  111. package/dist/adapters/GeminiCliAdapter.d.ts +2 -2
  112. package/dist/adapters/GeminiCliAdapter.d.ts.map +1 -1
  113. package/dist/adapters/GeminiCliAdapter.js +86 -86
  114. package/dist/adapters/GeminiCliAdapter.js.map +1 -1
  115. package/dist/adapters/GrokCliAdapter.d.ts +1 -1
  116. package/dist/adapters/GrokCliAdapter.d.ts.map +1 -1
  117. package/dist/adapters/GrokCliAdapter.js +80 -80
  118. package/dist/adapters/GrokCliAdapter.js.map +1 -1
  119. package/dist/adapters/OpenCodeAdapter.d.ts +1 -1
  120. package/dist/adapters/OpenCodeAdapter.d.ts.map +1 -1
  121. package/dist/adapters/OpenCodeAdapter.js +37 -36
  122. package/dist/adapters/OpenCodeAdapter.js.map +1 -1
  123. package/dist/adapters/index.d.ts +9 -9
  124. package/dist/adapters/index.d.ts.map +1 -1
  125. package/dist/adapters/index.js +8 -8
  126. package/dist/adapters/index.js.map +1 -1
  127. package/dist/capacity/codex.d.ts +3 -3
  128. package/dist/capacity/codex.d.ts.map +1 -1
  129. package/dist/capacity/codex.js +57 -57
  130. package/dist/capacity/codex.js.map +1 -1
  131. package/dist/capacity/index.d.ts +3 -3
  132. package/dist/capacity/index.d.ts.map +1 -1
  133. package/dist/capacity/index.js +8 -8
  134. package/dist/capacity/index.js.map +1 -1
  135. package/dist/capacity/types.d.ts +1 -1
  136. package/dist/capacity/types.js.map +1 -1
  137. package/dist/database/connection.d.ts +1 -1
  138. package/dist/database/connection.d.ts.map +1 -1
  139. package/dist/database/connection.js +15 -15
  140. package/dist/database/connection.js.map +1 -1
  141. package/dist/database/index.d.ts +3 -3
  142. package/dist/database/index.d.ts.map +1 -1
  143. package/dist/database/index.js +2 -2
  144. package/dist/database/index.js.map +1 -1
  145. package/dist/database/migrations/005_agent_runtime.sql +2 -0
  146. package/dist/database/schema.d.ts +1 -1
  147. package/dist/database/schema.d.ts.map +1 -1
  148. package/dist/database/schema.js +7 -7
  149. package/dist/database/schema.js.map +1 -1
  150. package/dist/durable/DurableAgent.d.ts +9 -9
  151. package/dist/durable/DurableAgent.d.ts.map +1 -1
  152. package/dist/durable/DurableAgent.js +16 -16
  153. package/dist/durable/DurableAgent.js.map +1 -1
  154. package/dist/durable/DurableAgentRepository.d.ts +4 -4
  155. package/dist/durable/DurableAgentRepository.d.ts.map +1 -1
  156. package/dist/durable/DurableAgentRepository.js +49 -48
  157. package/dist/durable/DurableAgentRepository.js.map +1 -1
  158. package/dist/durable/process.d.ts +1 -1
  159. package/dist/durable/process.d.ts.map +1 -1
  160. package/dist/durable/process.js +14 -14
  161. package/dist/durable/process.js.map +1 -1
  162. package/dist/durable/run.d.ts +2 -2
  163. package/dist/durable/run.d.ts.map +1 -1
  164. package/dist/durable/run.js +6 -6
  165. package/dist/durable/run.js.map +1 -1
  166. package/dist/durable/utils.d.ts +1 -1
  167. package/dist/durable/utils.d.ts.map +1 -1
  168. package/dist/durable/utils.js +4 -4
  169. package/dist/durable/utils.js.map +1 -1
  170. package/dist/index.d.ts +46 -41
  171. package/dist/index.d.ts.map +1 -1
  172. package/dist/index.js +27 -25
  173. package/dist/index.js.map +1 -1
  174. package/dist/providers/claude/ClaudeAgentMapper.d.ts +4 -4
  175. package/dist/providers/claude/ClaudeAgentMapper.d.ts.map +1 -1
  176. package/dist/providers/claude/ClaudeAgentMapper.js +10 -10
  177. package/dist/providers/claude/ClaudeAgentMapper.js.map +1 -1
  178. package/dist/providers/claude/ClaudeCodeAdapter.d.ts +1 -1
  179. package/dist/providers/claude/ClaudeCodeAdapter.d.ts.map +1 -1
  180. package/dist/providers/claude/ClaudeCodeAdapter.js +14 -14
  181. package/dist/providers/claude/ClaudeCodeAdapter.js.map +1 -1
  182. package/dist/providers/claude/ClaudeSessionLocator.d.ts +4 -4
  183. package/dist/providers/claude/ClaudeSessionLocator.d.ts.map +1 -1
  184. package/dist/providers/claude/ClaudeSessionLocator.js +79 -79
  185. package/dist/providers/claude/ClaudeSessionLocator.js.map +1 -1
  186. package/dist/providers/claude/ClaudeSessionParser.d.ts +2 -2
  187. package/dist/providers/claude/ClaudeSessionParser.d.ts.map +1 -1
  188. package/dist/providers/claude/ClaudeSessionParser.js +99 -99
  189. package/dist/providers/claude/ClaudeSessionParser.js.map +1 -1
  190. package/dist/providers/claude/durable/ClaudeCliProbe.d.ts.map +1 -1
  191. package/dist/providers/claude/durable/ClaudeCliProbe.js +16 -16
  192. package/dist/providers/claude/durable/ClaudeCliProbe.js.map +1 -1
  193. package/dist/providers/claude/durable/ClaudePrintAgentService.d.ts +5 -5
  194. package/dist/providers/claude/durable/ClaudePrintAgentService.d.ts.map +1 -1
  195. package/dist/providers/claude/durable/ClaudePrintAgentService.js +10 -10
  196. package/dist/providers/claude/durable/ClaudePrintAgentService.js.map +1 -1
  197. package/dist/providers/claude/durable/ClaudePrintRunner.d.ts +4 -4
  198. package/dist/providers/claude/durable/ClaudePrintRunner.d.ts.map +1 -1
  199. package/dist/providers/claude/durable/ClaudePrintRunner.js +18 -18
  200. package/dist/providers/claude/durable/ClaudePrintRunner.js.map +1 -1
  201. package/dist/providers/claude/durable/ClaudeStreamParser.d.ts +2 -2
  202. package/dist/providers/claude/durable/ClaudeStreamParser.d.ts.map +1 -1
  203. package/dist/providers/claude/durable/ClaudeStreamParser.js +17 -17
  204. package/dist/providers/claude/durable/ClaudeStreamParser.js.map +1 -1
  205. package/dist/providers/codex/CodexAdapter.d.ts +27 -0
  206. package/dist/providers/codex/CodexAdapter.d.ts.map +1 -0
  207. package/dist/providers/codex/CodexAdapter.js +162 -0
  208. package/dist/providers/codex/CodexAdapter.js.map +1 -0
  209. package/dist/providers/codex/CodexAgentMapper.d.ts +9 -0
  210. package/dist/providers/codex/CodexAgentMapper.d.ts.map +1 -0
  211. package/dist/providers/codex/CodexAgentMapper.js +35 -0
  212. package/dist/providers/codex/CodexAgentMapper.js.map +1 -0
  213. package/dist/providers/codex/CodexSessionLocator.d.ts +44 -0
  214. package/dist/providers/codex/CodexSessionLocator.d.ts.map +1 -0
  215. package/dist/providers/codex/CodexSessionLocator.js +207 -0
  216. package/dist/providers/codex/CodexSessionLocator.js.map +1 -0
  217. package/dist/providers/codex/CodexSessionMapping.d.ts +23 -0
  218. package/dist/providers/codex/CodexSessionMapping.d.ts.map +1 -0
  219. package/dist/providers/codex/CodexSessionMapping.js +68 -0
  220. package/dist/providers/codex/CodexSessionMapping.js.map +1 -0
  221. package/dist/providers/codex/CodexSessionParser.d.ts +58 -0
  222. package/dist/providers/codex/CodexSessionParser.d.ts.map +1 -0
  223. package/dist/providers/codex/CodexSessionParser.js +262 -0
  224. package/dist/providers/codex/CodexSessionParser.js.map +1 -0
  225. package/dist/providers/codex/durable/CodexCliProbe.d.ts.map +1 -1
  226. package/dist/providers/codex/durable/CodexCliProbe.js +22 -22
  227. package/dist/providers/codex/durable/CodexCliProbe.js.map +1 -1
  228. package/dist/providers/codex/durable/CodexPrintAgentService.d.ts +6 -6
  229. package/dist/providers/codex/durable/CodexPrintAgentService.d.ts.map +1 -1
  230. package/dist/providers/codex/durable/CodexPrintAgentService.js +10 -10
  231. package/dist/providers/codex/durable/CodexPrintAgentService.js.map +1 -1
  232. package/dist/providers/codex/durable/CodexPrintRunner.d.ts +4 -4
  233. package/dist/providers/codex/durable/CodexPrintRunner.d.ts.map +1 -1
  234. package/dist/providers/codex/durable/CodexPrintRunner.js +20 -20
  235. package/dist/providers/codex/durable/CodexPrintRunner.js.map +1 -1
  236. package/dist/providers/codex/durable/CodexStreamParser.d.ts +2 -2
  237. package/dist/providers/codex/durable/CodexStreamParser.d.ts.map +1 -1
  238. package/dist/providers/codex/durable/CodexStreamParser.js +21 -21
  239. package/dist/providers/codex/durable/CodexStreamParser.js.map +1 -1
  240. package/dist/providers/pi/PiAdapter.d.ts +28 -0
  241. package/dist/providers/pi/PiAdapter.d.ts.map +1 -0
  242. package/dist/providers/pi/PiAdapter.js +153 -0
  243. package/dist/providers/pi/PiAdapter.js.map +1 -0
  244. package/dist/providers/pi/PiAgentMapper.d.ts +9 -0
  245. package/dist/providers/pi/PiAgentMapper.d.ts.map +1 -0
  246. package/dist/providers/pi/PiAgentMapper.js +37 -0
  247. package/dist/providers/pi/PiAgentMapper.js.map +1 -0
  248. package/dist/providers/pi/PiSessionLocator.d.ts +23 -0
  249. package/dist/providers/pi/PiSessionLocator.d.ts.map +1 -0
  250. package/dist/providers/pi/PiSessionLocator.js +79 -0
  251. package/dist/providers/pi/PiSessionLocator.js.map +1 -0
  252. package/dist/providers/pi/PiSessionParser.d.ts +36 -0
  253. package/dist/providers/pi/PiSessionParser.d.ts.map +1 -0
  254. package/dist/providers/pi/PiSessionParser.js +191 -0
  255. package/dist/providers/pi/PiSessionParser.js.map +1 -0
  256. package/dist/providers/pi/PiSessionTracker.d.ts +23 -0
  257. package/dist/providers/pi/PiSessionTracker.d.ts.map +1 -0
  258. package/dist/providers/pi/PiSessionTracker.js +69 -0
  259. package/dist/providers/pi/PiSessionTracker.js.map +1 -0
  260. package/dist/providers/pi/durable/PiCliProbe.d.ts.map +1 -1
  261. package/dist/providers/pi/durable/PiCliProbe.js +15 -15
  262. package/dist/providers/pi/durable/PiCliProbe.js.map +1 -1
  263. package/dist/providers/pi/durable/PiPrintAgentService.d.ts +6 -6
  264. package/dist/providers/pi/durable/PiPrintAgentService.d.ts.map +1 -1
  265. package/dist/providers/pi/durable/PiPrintAgentService.js +10 -10
  266. package/dist/providers/pi/durable/PiPrintAgentService.js.map +1 -1
  267. package/dist/providers/pi/durable/PiPrintProtocol.d.ts.map +1 -1
  268. package/dist/providers/pi/durable/PiPrintProtocol.js +18 -18
  269. package/dist/providers/pi/durable/PiPrintProtocol.js.map +1 -1
  270. package/dist/providers/pi/durable/PiPrintRunner.d.ts +4 -4
  271. package/dist/providers/pi/durable/PiPrintRunner.d.ts.map +1 -1
  272. package/dist/providers/pi/durable/PiPrintRunner.js +15 -15
  273. package/dist/providers/pi/durable/PiPrintRunner.js.map +1 -1
  274. package/dist/providers/pi/durable/PiStreamParser.d.ts +1 -1
  275. package/dist/providers/pi/durable/PiStreamParser.d.ts.map +1 -1
  276. package/dist/providers/pi/durable/PiStreamParser.js +16 -16
  277. package/dist/providers/pi/durable/PiStreamParser.js.map +1 -1
  278. package/dist/readiness/AgentReadiness.d.ts +67 -0
  279. package/dist/readiness/AgentReadiness.d.ts.map +1 -0
  280. package/dist/readiness/AgentReadiness.js +614 -0
  281. package/dist/readiness/AgentReadiness.js.map +1 -0
  282. package/dist/runtime/ManagedAgentRuntime.d.ts +69 -0
  283. package/dist/runtime/ManagedAgentRuntime.d.ts.map +1 -0
  284. package/dist/runtime/ManagedAgentRuntime.js +156 -0
  285. package/dist/runtime/ManagedAgentRuntime.js.map +1 -0
  286. package/dist/runtime/RuntimeFactory.d.ts +4 -0
  287. package/dist/runtime/RuntimeFactory.d.ts.map +1 -0
  288. package/dist/runtime/RuntimeFactory.js +11 -0
  289. package/dist/runtime/RuntimeFactory.js.map +1 -0
  290. package/dist/runtime/errors.d.ts +27 -0
  291. package/dist/runtime/errors.d.ts.map +1 -0
  292. package/dist/runtime/errors.js +42 -0
  293. package/dist/runtime/errors.js.map +1 -0
  294. package/dist/runtime/herdr/HerdrAgentRuntime.d.ts +31 -0
  295. package/dist/runtime/herdr/HerdrAgentRuntime.d.ts.map +1 -0
  296. package/dist/runtime/herdr/HerdrAgentRuntime.js +184 -0
  297. package/dist/runtime/herdr/HerdrAgentRuntime.js.map +1 -0
  298. package/dist/runtime/herdr/HerdrCliClient.d.ts +13 -0
  299. package/dist/runtime/herdr/HerdrCliClient.d.ts.map +1 -0
  300. package/dist/runtime/herdr/HerdrCliClient.js +60 -0
  301. package/dist/runtime/herdr/HerdrCliClient.js.map +1 -0
  302. package/dist/runtime/herdr/HerdrErrors.d.ts +7 -0
  303. package/dist/runtime/herdr/HerdrErrors.d.ts.map +1 -0
  304. package/dist/runtime/herdr/HerdrErrors.js +10 -0
  305. package/dist/runtime/herdr/HerdrErrors.js.map +1 -0
  306. package/dist/runtime/herdr/HerdrResponseParsers.d.ts +14 -0
  307. package/dist/runtime/herdr/HerdrResponseParsers.d.ts.map +1 -0
  308. package/dist/runtime/herdr/HerdrResponseParsers.js +96 -0
  309. package/dist/runtime/herdr/HerdrResponseParsers.js.map +1 -0
  310. package/dist/runtime/herdr/HerdrRuntimeRef.d.ts +9 -0
  311. package/dist/runtime/herdr/HerdrRuntimeRef.d.ts.map +1 -0
  312. package/dist/runtime/herdr/HerdrRuntimeRef.js +33 -0
  313. package/dist/runtime/herdr/HerdrRuntimeRef.js.map +1 -0
  314. package/dist/runtime/tmux/PidPolling.d.ts +5 -0
  315. package/dist/runtime/tmux/PidPolling.d.ts.map +1 -0
  316. package/dist/runtime/tmux/PidPolling.js +24 -0
  317. package/dist/runtime/tmux/PidPolling.js.map +1 -0
  318. package/dist/runtime/tmux/TmuxAgentRuntime.d.ts +17 -0
  319. package/dist/runtime/tmux/TmuxAgentRuntime.d.ts.map +1 -0
  320. package/dist/runtime/tmux/TmuxAgentRuntime.js +80 -0
  321. package/dist/runtime/tmux/TmuxAgentRuntime.js.map +1 -0
  322. package/dist/runtime/tmux/TmuxRuntimeRef.d.ts +5 -0
  323. package/dist/runtime/tmux/TmuxRuntimeRef.d.ts.map +1 -0
  324. package/dist/runtime/tmux/TmuxRuntimeRef.js +9 -0
  325. package/dist/runtime/tmux/TmuxRuntimeRef.js.map +1 -0
  326. package/dist/runtime/types.d.ts +54 -0
  327. package/dist/runtime/types.d.ts.map +1 -0
  328. package/dist/runtime/types.js +3 -0
  329. package/dist/runtime/types.js.map +1 -0
  330. package/dist/terminal/TerminalFocusManager.d.ts.map +1 -1
  331. package/dist/terminal/TerminalFocusManager.js +50 -50
  332. package/dist/terminal/TerminalFocusManager.js.map +1 -1
  333. package/dist/terminal/TmuxManager.d.ts.map +1 -1
  334. package/dist/terminal/TmuxManager.js +47 -47
  335. package/dist/terminal/TmuxManager.js.map +1 -1
  336. package/dist/terminal/TtyWriter.d.ts +1 -1
  337. package/dist/terminal/TtyWriter.d.ts.map +1 -1
  338. package/dist/terminal/TtyWriter.js +89 -89
  339. package/dist/terminal/TtyWriter.js.map +1 -1
  340. package/dist/terminal/index.d.ts +4 -4
  341. package/dist/terminal/index.js +3 -3
  342. package/dist/terminal/index.js.map +1 -1
  343. package/dist/utils/AgentRegistry.d.ts +10 -2
  344. package/dist/utils/AgentRegistry.d.ts.map +1 -1
  345. package/dist/utils/AgentRegistry.js +57 -24
  346. package/dist/utils/AgentRegistry.js.map +1 -1
  347. package/dist/utils/agent-requests.d.ts.map +1 -1
  348. package/dist/utils/agent-requests.js +5 -5
  349. package/dist/utils/agent-requests.js.map +1 -1
  350. package/dist/utils/agents.d.ts +2 -2
  351. package/dist/utils/agents.d.ts.map +1 -1
  352. package/dist/utils/agents.js +15 -15
  353. package/dist/utils/agents.js.map +1 -1
  354. package/dist/utils/applescript.js +1 -1
  355. package/dist/utils/applescript.js.map +1 -1
  356. package/dist/utils/index.d.ts +6 -6
  357. package/dist/utils/index.d.ts.map +1 -1
  358. package/dist/utils/index.js +4 -4
  359. package/dist/utils/index.js.map +1 -1
  360. package/dist/utils/matching.d.ts +2 -2
  361. package/dist/utils/matching.d.ts.map +1 -1
  362. package/dist/utils/matching.js +4 -4
  363. package/dist/utils/matching.js.map +1 -1
  364. package/dist/utils/process.d.ts +1 -1
  365. package/dist/utils/process.d.ts.map +1 -1
  366. package/dist/utils/process.js +74 -74
  367. package/dist/utils/process.js.map +1 -1
  368. package/dist/utils/session.d.ts +1 -1
  369. package/dist/utils/session.d.ts.map +1 -1
  370. package/dist/utils/session.js +7 -7
  371. package/dist/utils/session.js.map +1 -1
  372. package/dist/utils/sortAgents.d.ts +2 -2
  373. package/dist/utils/sortAgents.d.ts.map +1 -1
  374. package/dist/utils/sortAgents.js +5 -5
  375. package/dist/utils/sortAgents.js.map +1 -1
  376. package/package.json +18 -19
  377. package/src/AgentManager.ts +283 -281
  378. package/src/__tests__/AgentManager.test.ts +917 -907
  379. package/src/__tests__/adapters/ClaudeCodeAdapter.test.ts +1657 -1368
  380. package/src/__tests__/adapters/CodexAdapter.test.ts +365 -1698
  381. package/src/__tests__/adapters/CopilotAdapter.test.ts +576 -481
  382. package/src/__tests__/adapters/GeminiCliAdapter.test.ts +1189 -1157
  383. package/src/__tests__/adapters/GrokCliAdapter.test.ts +325 -272
  384. package/src/__tests__/adapters/OpenCodeAdapter.test.ts +510 -455
  385. package/src/__tests__/capacity/codex.test.ts +178 -91
  386. package/src/__tests__/capacity/index.test.ts +27 -18
  387. package/src/__tests__/durable/CodexCliProbe.test.ts +75 -53
  388. package/src/__tests__/durable/CodexDurableAgentRepository.test.ts +51 -40
  389. package/src/__tests__/durable/CodexPrintAgent.integration.test.ts +89 -64
  390. package/src/__tests__/durable/CodexPrintAgentService.test.ts +196 -118
  391. package/src/__tests__/durable/CodexPrintRunner.test.ts +282 -162
  392. package/src/__tests__/fixtures/fake-claude.cjs +20 -13
  393. package/src/__tests__/fixtures/fake-codex.cjs +41 -30
  394. package/src/__tests__/print/ClaudeCliProbe.test.ts +27 -21
  395. package/src/__tests__/print/ClaudePrintAgent.integration.test.ts +48 -40
  396. package/src/__tests__/print/ClaudePrintAgentService.test.ts +118 -67
  397. package/src/__tests__/print/ClaudePrintRunner.test.ts +136 -83
  398. package/src/__tests__/print/DurableAgent.test.ts +19 -16
  399. package/src/__tests__/print/DurableAgentRepository.sqlite.test.ts +109 -86
  400. package/src/__tests__/print/DurableAgentRepository.test.ts +170 -137
  401. package/src/__tests__/providers/claude/ClaudeAgentMapper.test.ts +65 -65
  402. package/src/__tests__/providers/claude/ClaudeSessionLocator.test.ts +400 -377
  403. package/src/__tests__/providers/codex/CodexSessionLocator.test.ts +182 -0
  404. package/src/__tests__/providers/codex/CodexSessionMapping.test.ts +63 -0
  405. package/src/__tests__/providers/codex/CodexSessionParser.test.ts +192 -0
  406. package/src/__tests__/providers/pi/PiAdapter.test.ts +310 -0
  407. package/src/__tests__/providers/pi/PiSessionParser.test.ts +190 -0
  408. package/src/__tests__/providers/pi/PiSessionTracker.test.ts +79 -0
  409. package/src/__tests__/providers/pi/durable/PiCliProbe.test.ts +48 -32
  410. package/src/__tests__/providers/pi/durable/PiDurableAgentRepository.test.ts +24 -23
  411. package/src/__tests__/providers/pi/durable/PiPrintAgentService.test.ts +131 -59
  412. package/src/__tests__/providers/pi/durable/PiPrintProtocol.test.ts +66 -28
  413. package/src/__tests__/providers/pi/durable/PiPrintRunner.test.ts +236 -90
  414. package/src/__tests__/providers/pi/durable/PiStreamParser.test.ts +20 -18
  415. package/src/__tests__/readiness/AgentReadiness.test.ts +242 -0
  416. package/src/__tests__/runtime/AgentRuntime.test.ts +8 -0
  417. package/src/__tests__/runtime/HerdrAgentRuntime.test.ts +358 -0
  418. package/src/__tests__/runtime/ManagedAgentRuntime.test.ts +555 -0
  419. package/src/__tests__/terminal/TerminalFocusManager.test.ts +254 -253
  420. package/src/__tests__/terminal/TmuxManager.test.ts +157 -157
  421. package/src/__tests__/terminal/TtyWriter.test.ts +423 -419
  422. package/src/__tests__/utils/AgentRegistry.test.ts +506 -402
  423. package/src/__tests__/utils/ClaudeSessionParser.test.ts +276 -242
  424. package/src/__tests__/utils/agent-requests.test.ts +76 -56
  425. package/src/__tests__/utils/agents.test.ts +20 -20
  426. package/src/__tests__/utils/matching.test.ts +206 -171
  427. package/src/__tests__/utils/process.test.ts +276 -262
  428. package/src/__tests__/utils/session.test.ts +133 -139
  429. package/src/adapters/AgentAdapter.ts +134 -126
  430. package/src/adapters/CopilotAdapter.ts +405 -395
  431. package/src/adapters/GeminiCliAdapter.ts +598 -600
  432. package/src/adapters/GrokCliAdapter.ts +353 -342
  433. package/src/adapters/OpenCodeAdapter.ts +285 -259
  434. package/src/adapters/index.ts +15 -9
  435. package/src/capacity/codex.ts +137 -84
  436. package/src/capacity/index.ts +18 -13
  437. package/src/capacity/types.ts +1 -1
  438. package/src/database/connection.ts +73 -68
  439. package/src/database/index.ts +6 -6
  440. package/src/database/migrations/005_agent_runtime.sql +2 -0
  441. package/src/database/schema.ts +40 -38
  442. package/src/durable/DurableAgent.ts +85 -85
  443. package/src/durable/DurableAgentRepository.ts +409 -260
  444. package/src/durable/process.ts +22 -21
  445. package/src/durable/run.ts +61 -51
  446. package/src/durable/utils.ts +46 -41
  447. package/src/index.ts +145 -86
  448. package/src/providers/claude/ClaudeAgentMapper.ts +51 -50
  449. package/src/providers/claude/ClaudeCodeAdapter.ts +144 -136
  450. package/src/providers/claude/ClaudeSessionLocator.ts +291 -293
  451. package/src/providers/claude/ClaudeSessionParser.ts +322 -338
  452. package/src/providers/claude/durable/ClaudeCliProbe.ts +42 -37
  453. package/src/providers/claude/durable/ClaudePrintAgentService.ts +63 -50
  454. package/src/providers/claude/durable/ClaudePrintRunner.ts +79 -69
  455. package/src/providers/claude/durable/ClaudeStreamParser.ts +91 -62
  456. package/src/providers/codex/CodexAdapter.ts +205 -0
  457. package/src/providers/codex/CodexAgentMapper.ts +35 -0
  458. package/src/providers/codex/CodexSessionLocator.ts +279 -0
  459. package/src/providers/codex/CodexSessionMapping.ts +89 -0
  460. package/src/providers/codex/CodexSessionParser.ts +385 -0
  461. package/src/providers/codex/durable/CodexCliProbe.ts +50 -42
  462. package/src/providers/codex/durable/CodexPrintAgentService.ts +63 -49
  463. package/src/providers/codex/durable/CodexPrintRunner.ts +79 -69
  464. package/src/providers/codex/durable/CodexStreamParser.ts +97 -84
  465. package/src/providers/pi/PiAdapter.ts +183 -0
  466. package/src/providers/pi/PiAgentMapper.ts +36 -0
  467. package/src/providers/pi/PiSessionLocator.ts +95 -0
  468. package/src/providers/pi/PiSessionParser.ts +284 -0
  469. package/src/providers/pi/PiSessionTracker.ts +87 -0
  470. package/src/providers/pi/durable/PiCliProbe.ts +42 -34
  471. package/src/providers/pi/durable/PiPrintAgentService.ts +61 -53
  472. package/src/providers/pi/durable/PiPrintProtocol.ts +31 -29
  473. package/src/providers/pi/durable/PiPrintRunner.ts +75 -68
  474. package/src/providers/pi/durable/PiStreamParser.ts +82 -72
  475. package/src/readiness/AgentReadiness.ts +727 -0
  476. package/src/runtime/ManagedAgentRuntime.ts +266 -0
  477. package/src/runtime/RuntimeFactory.ts +13 -0
  478. package/src/runtime/errors.ts +50 -0
  479. package/src/runtime/herdr/HerdrAgentRuntime.ts +190 -0
  480. package/src/runtime/herdr/HerdrCliClient.ts +78 -0
  481. package/src/runtime/herdr/HerdrErrors.ts +9 -0
  482. package/src/runtime/herdr/HerdrResponseParsers.ts +76 -0
  483. package/src/runtime/herdr/HerdrRuntimeRef.ts +41 -0
  484. package/src/runtime/tmux/PidPolling.ts +34 -0
  485. package/src/runtime/tmux/TmuxAgentRuntime.ts +113 -0
  486. package/src/runtime/tmux/TmuxRuntimeRef.ts +9 -0
  487. package/src/runtime/types.ts +56 -0
  488. package/src/terminal/TerminalFocusManager.ts +215 -212
  489. package/src/terminal/TmuxManager.ts +99 -92
  490. package/src/terminal/TtyWriter.ts +203 -194
  491. package/src/terminal/index.ts +4 -4
  492. package/src/utils/AgentRegistry.ts +299 -238
  493. package/src/utils/agent-requests.ts +16 -16
  494. package/src/utils/agents.ts +41 -38
  495. package/src/utils/applescript.ts +4 -4
  496. package/src/utils/index.ts +12 -6
  497. package/src/utils/matching.ts +43 -43
  498. package/src/utils/process.ts +261 -258
  499. package/src/utils/session.ts +66 -66
  500. package/src/utils/sortAgents.ts +35 -33
  501. package/tsconfig.json +2 -8
  502. package/vitest.config.ts +16 -16
  503. package/.eslintrc.json +0 -31
  504. package/dist/__tests__/adapters/PiAdapter.test.js +0 -618
  505. package/dist/__tests__/adapters/PiAdapter.test.js.map +0 -1
  506. package/dist/__tests__/database/DurableAgentsDatabase.test.js +0 -128
  507. package/dist/__tests__/database/DurableAgentsDatabase.test.js.map +0 -1
  508. package/dist/adapters/CodexAdapter.d.ts +0 -109
  509. package/dist/adapters/CodexAdapter.d.ts.map +0 -1
  510. package/dist/adapters/CodexAdapter.js +0 -710
  511. package/dist/adapters/CodexAdapter.js.map +0 -1
  512. package/dist/adapters/PiAdapter.d.ts +0 -63
  513. package/dist/adapters/PiAdapter.d.ts.map +0 -1
  514. package/dist/adapters/PiAdapter.js +0 -453
  515. package/dist/adapters/PiAdapter.js.map +0 -1
  516. package/src/__tests__/adapters/PiAdapter.test.ts +0 -458
  517. package/src/__tests__/database/DurableAgentsDatabase.test.ts +0 -102
  518. package/src/adapters/CodexAdapter.ts +0 -923
  519. package/src/adapters/PiAdapter.ts +0 -598
@@ -1,710 +0,0 @@
1
- /**
2
- * Codex Adapter
3
- *
4
- * Detects running Codex agents by:
5
- * 1. Filtering Codex processes from a shared asynchronous process snapshot
6
- * 2. Using snapshot CWD and start-time enrichment
7
- * 3. Matching exact PID-to-session metadata from ~/.codex/ai-devkit/sessions.json
8
- * 4. Discovering session files from ~/.codex/sessions/YYYY/MM/DD/ via shared batchGetSessionFileBirthtimes()
9
- * 5. Setting resolvedCwd from session_meta first line
10
- * 6. Matching sessions to processes via shared matchProcessesToSessions()
11
- * 7. Extracting summary from last event entry in session JSONL
12
- */ import * as fs from 'fs';
13
- import * as path from 'path';
14
- import { AgentStatus } from './AgentAdapter.js';
15
- import { captureProcessSnapshot, executableBasename, filterByProcessNames } from '../utils/process.js';
16
- import { batchGetSessionFileBirthtimes, isDirectory, safeReadFile, safeReaddir, safeStat } from '../utils/session.js';
17
- import { matchProcessesToSessions, generateAgentName } from '../utils/matching.js';
18
- import { AgentRegistry } from '../utils/AgentRegistry.js';
19
- export class CodexAdapter {
20
- type = 'codex';
21
- processNames = [
22
- 'codex'
23
- ];
24
- static IDLE_THRESHOLD_MINUTES = 5;
25
- /** Include session files around process start day to recover long-lived processes. */ static PROCESS_START_DAY_WINDOW_DAYS = 1;
26
- codexSessionsDir;
27
- sessionMappingPath;
28
- registry;
29
- constructor(registry = AgentRegistry.default()){
30
- const homeDir = process.env.HOME || process.env.USERPROFILE || '';
31
- this.codexSessionsDir = path.join(homeDir, '.codex', 'sessions');
32
- this.sessionMappingPath = path.join(homeDir, '.codex', 'ai-devkit', 'sessions.json');
33
- this.registry = registry;
34
- }
35
- canHandle(processInfo) {
36
- return this.isCodexExecutable(processInfo.command);
37
- }
38
- /**
39
- * Detect running Codex agents
40
- */ async detectAgents(context) {
41
- const snapshot = context?.processes ?? await captureProcessSnapshot(this.processNames);
42
- const relevant = filterByProcessNames(snapshot, this.processNames);
43
- const processes = relevant.filter((process1)=>this.canHandle(process1));
44
- if (processes.length === 0) return [];
45
- const mappingResult = this.mapSessionMappingMatches(processes);
46
- const { cachedAgents, remaining } = this.tryRegistryCache(mappingResult.fallback);
47
- if (remaining.length === 0) return [
48
- ...mappingResult.agents,
49
- ...cachedAgents
50
- ];
51
- const { direct, fallback } = this.tryResumeMatching(remaining);
52
- const directResult = this.mapDirectMatches(direct);
53
- const { sessions, contentCache } = this.discoverSessions(fallback);
54
- if (sessions.length === 0) {
55
- return [
56
- ...cachedAgents,
57
- ...mappingResult.agents,
58
- ...directResult.agents,
59
- ...directResult.failedProcesses.map((p)=>this.mapProcessOnlyAgent(p)),
60
- ...fallback.map((p)=>this.mapProcessOnlyAgent(p))
61
- ];
62
- }
63
- const matches = matchProcessesToSessions(fallback, sessions);
64
- const matchedPids = new Set([
65
- ...directResult.agents.map((a)=>a.pid),
66
- ...matches.map((m)=>m.process.pid)
67
- ]);
68
- const agents = [
69
- ...directResult.agents
70
- ];
71
- for (const match of matches){
72
- const cachedContent = contentCache.get(match.session.filePath);
73
- const sessionData = this.parseSession(cachedContent, match.session.filePath);
74
- if (sessionData) {
75
- agents.push(this.mapSessionToAgent(sessionData, match.process, match.session.filePath));
76
- } else {
77
- matchedPids.delete(match.process.pid);
78
- }
79
- }
80
- for (const proc of fallback){
81
- if (!matchedPids.has(proc.pid)) {
82
- agents.push(this.mapProcessOnlyAgent(proc));
83
- }
84
- }
85
- for (const proc of directResult.failedProcesses){
86
- agents.push(this.mapProcessOnlyAgent(proc));
87
- }
88
- return [
89
- ...cachedAgents,
90
- ...mappingResult.agents,
91
- ...agents
92
- ];
93
- }
94
- mapSessionMappingMatches(processes) {
95
- const { matches, fallback } = this.matchFromSessionMapping(processes);
96
- const agents = [];
97
- for (const match of matches){
98
- const sessionData = this.parseSession(undefined, match.filePath);
99
- if (sessionData) {
100
- agents.push(this.mapSessionToAgent(sessionData, match.process, match.filePath));
101
- } else {
102
- fallback.push(match.process);
103
- }
104
- }
105
- return {
106
- agents,
107
- fallback
108
- };
109
- }
110
- matchFromSessionMapping(processes) {
111
- const mapping = this.readSessionMapping();
112
- if (mapping.size === 0) return {
113
- matches: [],
114
- fallback: processes
115
- };
116
- const matches = [];
117
- const fallback = [];
118
- for (const proc of processes){
119
- const filePath = mapping.get(proc.pid);
120
- if (!filePath || !this.isTrustedSessionPath(filePath) || !fs.existsSync(filePath)) {
121
- fallback.push(proc);
122
- continue;
123
- }
124
- matches.push({
125
- process: proc,
126
- filePath
127
- });
128
- }
129
- return {
130
- matches,
131
- fallback
132
- };
133
- }
134
- readSessionMapping() {
135
- const content = safeReadFile(this.sessionMappingPath);
136
- if (content === undefined) return new Map();
137
- let parsed;
138
- try {
139
- parsed = JSON.parse(content);
140
- } catch {
141
- return new Map();
142
- }
143
- if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return new Map();
144
- const map = new Map();
145
- for (const [key, value] of Object.entries(parsed)){
146
- const pid = this.toPid(key);
147
- if (pid !== null && typeof value === 'string' && value) {
148
- map.set(pid, value);
149
- }
150
- }
151
- return map;
152
- }
153
- toPid(value) {
154
- if (typeof value === 'number' && Number.isInteger(value) && value > 0) return value;
155
- if (typeof value !== 'string' || !/^\d+$/.test(value)) return null;
156
- const parsed = Number(value);
157
- return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
158
- }
159
- isTrustedSessionPath(filePath) {
160
- const resolvedRoot = path.resolve(this.codexSessionsDir);
161
- const resolvedPath = path.resolve(filePath);
162
- return resolvedPath === resolvedRoot || resolvedPath.startsWith(`${resolvedRoot}${path.sep}`);
163
- }
164
- tryRegistryCache(processes) {
165
- const cachedAgents = [];
166
- const remaining = [];
167
- const byPid = new Map(this.registry.list().map((e)=>[
168
- e.pid,
169
- e
170
- ]));
171
- for (const proc of processes){
172
- const entry = byPid.get(proc.pid);
173
- if (!entry || entry.type !== this.type || !entry.sessionFilePath || !fs.existsSync(entry.sessionFilePath)) {
174
- remaining.push(proc);
175
- continue;
176
- }
177
- const content = safeReadFile(entry.sessionFilePath);
178
- const sessionData = this.parseSession(content, entry.sessionFilePath);
179
- if (!sessionData) {
180
- remaining.push(proc);
181
- continue;
182
- }
183
- cachedAgents.push(this.mapSessionToAgent(sessionData, proc, entry.sessionFilePath));
184
- }
185
- return {
186
- cachedAgents,
187
- remaining
188
- };
189
- }
190
- /**
191
- * Match processes via `codex resume <uuid>` in their command line.
192
- * Resumed sessions predate the process, so birth-time proximity cannot
193
- * reliably pair them with the running PID.
194
- */ tryResumeMatching(processes) {
195
- const direct = [];
196
- const fallback = [];
197
- for (const proc of processes){
198
- const sessionId = this.extractResumeSessionId(proc.command);
199
- if (!sessionId) {
200
- fallback.push(proc);
201
- continue;
202
- }
203
- const sessionFile = this.findSessionFileById(sessionId);
204
- if (!sessionFile) {
205
- fallback.push(proc);
206
- continue;
207
- }
208
- direct.push({
209
- process: proc,
210
- sessionFile
211
- });
212
- }
213
- return {
214
- direct,
215
- fallback
216
- };
217
- }
218
- extractResumeSessionId(command) {
219
- const match = command.match(/(?:^|\s)resume\s+([0-9a-f-]{36})(?:\s|$)/i);
220
- return match?.[1] ?? null;
221
- }
222
- findSessionFileById(sessionId) {
223
- for (const filePath of this.getCandidateSessionFiles(sessionId)){
224
- if (!path.basename(filePath).includes(sessionId)) continue;
225
- const content = safeReadFile(filePath);
226
- const firstLine = content?.split('\n')[0]?.trim();
227
- if (!firstLine) continue;
228
- try {
229
- const parsed = JSON.parse(firstLine);
230
- if (parsed.type !== 'session_meta' || parsed.payload?.id !== sessionId) {
231
- continue;
232
- }
233
- const stat = safeStat(filePath);
234
- if (!stat) continue;
235
- const metaTimestampMs = this.parseMetaTimestampMs(parsed.payload?.timestamp);
236
- return {
237
- sessionId,
238
- filePath,
239
- projectDir: path.dirname(filePath),
240
- birthtimeMs: metaTimestampMs ?? stat.birthtimeMs,
241
- resolvedCwd: parsed.payload?.cwd || ''
242
- };
243
- } catch {
244
- continue;
245
- }
246
- }
247
- return null;
248
- }
249
- getCandidateSessionFiles(sessionId) {
250
- // Codex currently writes UUIDv7 session IDs, so the ID can narrow lookup
251
- // to the creation-date directory. Fall back for older or changed formats.
252
- const sessionDate = this.tryParseUuidV7Date(sessionId);
253
- if (!sessionDate) return this.collectAllSessionFiles();
254
- return this.collectSessionFilesInDateDirs(this.getDateDirsAroundDate(sessionDate, CodexAdapter.PROCESS_START_DAY_WINDOW_DAYS));
255
- }
256
- mapDirectMatches(matches) {
257
- const agents = [];
258
- const failedProcesses = [];
259
- for (const match of matches){
260
- const sessionData = this.parseSession(undefined, match.sessionFile.filePath);
261
- if (sessionData) {
262
- agents.push(this.mapSessionToAgent(sessionData, match.process, match.sessionFile.filePath));
263
- } else {
264
- failedProcesses.push(match.process);
265
- }
266
- }
267
- return {
268
- agents,
269
- failedProcesses
270
- };
271
- }
272
- /**
273
- * Discover session files for the given processes.
274
- *
275
- * Uses process start times to determine which YYYY/MM/DD date directories
276
- * to scan (±1 day window), then batches stat calls across all directories.
277
- * Reads each file once and caches content for later parsing by parseSession().
278
- * Sets resolvedCwd from session_meta first line.
279
- */ discoverSessions(processes) {
280
- const empty = {
281
- sessions: [],
282
- contentCache: new Map()
283
- };
284
- if (!fs.existsSync(this.codexSessionsDir)) return empty;
285
- const dateDirs = this.getDateDirs(processes);
286
- if (dateDirs.length === 0) return empty;
287
- const files = batchGetSessionFileBirthtimes(dateDirs);
288
- const contentCache = new Map();
289
- // Read each file once: extract CWD for matching, cache content for later parsing
290
- for (const file of files){
291
- try {
292
- const content = fs.readFileSync(file.filePath, 'utf-8');
293
- contentCache.set(file.filePath, content);
294
- const firstLine = content.split('\n')[0]?.trim();
295
- if (firstLine) {
296
- const parsed = JSON.parse(firstLine);
297
- if (parsed.type === 'session_meta') {
298
- file.resolvedCwd = parsed.payload?.cwd || '';
299
- const metaTimestampMs = this.parseMetaTimestampMs(parsed.payload?.timestamp);
300
- if (metaTimestampMs !== null) {
301
- file.birthtimeMs = metaTimestampMs;
302
- }
303
- }
304
- }
305
- } catch {
306
- // Skip unreadable files
307
- }
308
- }
309
- return {
310
- sessions: files,
311
- contentCache
312
- };
313
- }
314
- /**
315
- * Determine which date directories to scan based on process start times.
316
- * Returns only directories that actually exist.
317
- */ getDateDirs(processes) {
318
- const dayKeys = new Set();
319
- const window = CodexAdapter.PROCESS_START_DAY_WINDOW_DAYS;
320
- for (const proc of processes){
321
- const startTime = proc.startTime || new Date();
322
- for(let offset = -window; offset <= window; offset++){
323
- const day = new Date(startTime.getTime());
324
- day.setDate(day.getDate() + offset);
325
- dayKeys.add(this.toSessionDayKey(day));
326
- }
327
- }
328
- const dirs = [];
329
- for (const dayKey of dayKeys){
330
- const dayDir = path.join(this.codexSessionsDir, dayKey);
331
- try {
332
- if (fs.statSync(dayDir).isDirectory()) {
333
- dirs.push(dayDir);
334
- }
335
- } catch {
336
- continue;
337
- }
338
- }
339
- return dirs;
340
- }
341
- getDateDirsAroundDate(date, windowDays) {
342
- const dirs = [];
343
- for(let offset = -windowDays; offset <= windowDays; offset++){
344
- const day = new Date(date.getTime());
345
- day.setDate(day.getDate() + offset);
346
- const dayDir = path.join(this.codexSessionsDir, this.toSessionDayKey(day));
347
- if (isDirectory(dayDir)) {
348
- dirs.push(dayDir);
349
- }
350
- }
351
- return dirs;
352
- }
353
- toSessionDayKey(date) {
354
- const yyyy = String(date.getFullYear()).padStart(4, '0');
355
- const mm = String(date.getMonth() + 1).padStart(2, '0');
356
- const dd = String(date.getDate()).padStart(2, '0');
357
- return path.join(yyyy, mm, dd);
358
- }
359
- tryParseUuidV7Date(sessionId) {
360
- const match = sessionId.match(/^([0-9a-f]{8})-([0-9a-f]{4})-7[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
361
- if (!match) return null;
362
- const timestampMs = Number.parseInt(`${match[1]}${match[2]}`, 16);
363
- if (!Number.isSafeInteger(timestampMs) || timestampMs <= 0) return null;
364
- const date = new Date(timestampMs);
365
- return Number.isNaN(date.getTime()) ? null : date;
366
- }
367
- /**
368
- * Parse session file content into CodexSession.
369
- * Uses cached content if available, otherwise reads from disk.
370
- */ parseSession(cachedContent, filePath) {
371
- let content;
372
- if (cachedContent !== undefined) {
373
- content = cachedContent;
374
- } else {
375
- try {
376
- content = fs.readFileSync(filePath, 'utf-8');
377
- } catch {
378
- return null;
379
- }
380
- }
381
- const allLines = content.trim().split('\n');
382
- if (!allLines[0]) return null;
383
- let metaEntry;
384
- try {
385
- metaEntry = JSON.parse(allLines[0]);
386
- } catch {
387
- return null;
388
- }
389
- if (metaEntry.type !== 'session_meta' || !metaEntry.payload?.id) {
390
- return null;
391
- }
392
- const entries = [];
393
- for (const line of allLines){
394
- try {
395
- entries.push(JSON.parse(line));
396
- } catch {
397
- continue;
398
- }
399
- }
400
- const lastEntry = this.findLastEventEntry(entries);
401
- const lastPayloadType = lastEntry ? this.normalizedPayloadType(lastEntry) : undefined;
402
- const lastActive = this.parseTimestamp(lastEntry?.timestamp) || this.parseTimestamp(metaEntry.payload.timestamp) || fs.statSync(filePath).mtime;
403
- const sessionStart = this.parseTimestamp(metaEntry.payload.timestamp) || lastActive;
404
- return {
405
- sessionId: metaEntry.payload.id,
406
- projectPath: metaEntry.payload.cwd || '',
407
- summary: this.extractSummary(entries),
408
- sessionStart,
409
- lastActive,
410
- lastPayloadType
411
- };
412
- }
413
- mapSessionToAgent(session, processInfo, filePath) {
414
- return {
415
- name: generateAgentName(session.projectPath || processInfo.cwd || '', processInfo.pid),
416
- type: this.type,
417
- status: this.determineStatus(session),
418
- summary: session.summary || 'Codex session active',
419
- pid: processInfo.pid,
420
- projectPath: session.projectPath || processInfo.cwd || '',
421
- sessionId: session.sessionId,
422
- lastActive: session.lastActive,
423
- sessionFilePath: filePath
424
- };
425
- }
426
- mapProcessOnlyAgent(processInfo) {
427
- return {
428
- name: generateAgentName(processInfo.cwd || '', processInfo.pid),
429
- type: this.type,
430
- status: AgentStatus.RUNNING,
431
- summary: 'Codex process running',
432
- pid: processInfo.pid,
433
- projectPath: processInfo.cwd || '',
434
- sessionId: `pid-${processInfo.pid}`,
435
- lastActive: new Date()
436
- };
437
- }
438
- findLastEventEntry(entries) {
439
- for(let i = entries.length - 1; i >= 0; i--){
440
- const entry = entries[i];
441
- if (entry && typeof entry.type === 'string') {
442
- return entry;
443
- }
444
- }
445
- return undefined;
446
- }
447
- parseTimestamp(value) {
448
- if (!value) return null;
449
- const timestamp = new Date(value);
450
- return Number.isNaN(timestamp.getTime()) ? null : timestamp;
451
- }
452
- parseMetaTimestampMs(value) {
453
- if (typeof value !== 'string') return null;
454
- const timestamp = this.parseTimestamp(value);
455
- if (!timestamp) return null;
456
- const timestampMs = timestamp.getTime();
457
- return Number.isFinite(timestampMs) ? timestampMs : null;
458
- }
459
- determineStatus(session) {
460
- const diffMs = Date.now() - session.lastActive.getTime();
461
- const diffMinutes = diffMs / 60000;
462
- if (diffMinutes > CodexAdapter.IDLE_THRESHOLD_MINUTES) {
463
- return AgentStatus.IDLE;
464
- }
465
- if (session.lastPayloadType === 'agent_message' || session.lastPayloadType === 'task_complete' || session.lastPayloadType === 'turn_aborted') {
466
- return AgentStatus.WAITING;
467
- }
468
- return AgentStatus.RUNNING;
469
- }
470
- extractSummary(entries) {
471
- for(let i = entries.length - 1; i >= 0; i--){
472
- const message = this.extractEntryText(entries[i]);
473
- if (message) return this.truncate(message, 120);
474
- }
475
- return 'Codex session active';
476
- }
477
- normalizedPayloadType(entry) {
478
- const payloadType = entry.payload?.type;
479
- if (entry.type === 'response_item' && payloadType === 'message') {
480
- if (entry.payload?.role === 'assistant') return 'agent_message';
481
- if (entry.payload?.role === 'user') return 'user_message';
482
- return payloadType;
483
- }
484
- if (entry.type === 'event_msg' && payloadType === 'item_completed') {
485
- const itemType = entry.payload?.item?.type;
486
- if (itemType === 'AgentMessage') return 'agent_message';
487
- if (itemType === 'UserMessage') return 'user_message';
488
- return itemType ?? payloadType;
489
- }
490
- return payloadType;
491
- }
492
- extractEntryText(entry) {
493
- if (!entry) return '';
494
- const legacyMessage = entry.payload?.message;
495
- if (typeof legacyMessage === 'string' && legacyMessage.trim().length > 0) {
496
- return legacyMessage.trim();
497
- }
498
- const conversationMessage = this.toConversationMessage(entry, false);
499
- return conversationMessage?.content.trim() ?? '';
500
- }
501
- truncate(value, maxLength) {
502
- if (value.length <= maxLength) return value;
503
- return `${value.slice(0, maxLength - 3)}...`;
504
- }
505
- isCodexExecutable(command) {
506
- const base = executableBasename(command);
507
- return base === 'codex' || base === 'codex.exe';
508
- }
509
- /**
510
- * Read the full conversation from a Codex session JSONL file.
511
- *
512
- * Codex entries use either legacy payload.message fields or current
513
- * response_item/event_msg content arrays.
514
- */ getConversation(sessionFilePath, options) {
515
- const verbose = options?.verbose ?? false;
516
- const content = safeReadFile(sessionFilePath);
517
- if (content === undefined) return [];
518
- const lines = content.trim().split('\n');
519
- const entries = [];
520
- const messages = [];
521
- for (const line of lines){
522
- try {
523
- entries.push(JSON.parse(line));
524
- } catch {
525
- continue;
526
- }
527
- }
528
- const responseItemMirrorKeys = new Set();
529
- for (const entry of entries){
530
- if (entry.type !== 'response_item') continue;
531
- const message = this.toConversationMessage(entry, verbose);
532
- const mirrorKey = message ? this.mirroredMessageKey(entry, message) : null;
533
- if (mirrorKey) responseItemMirrorKeys.add(mirrorKey);
534
- }
535
- for (const entry of entries){
536
- const message = this.toConversationMessage(entry, verbose);
537
- if (!message) continue;
538
- const mirrorKey = this.mirroredMessageKey(entry, message);
539
- if (entry.type === 'event_msg' && mirrorKey && responseItemMirrorKeys.has(mirrorKey)) {
540
- continue;
541
- }
542
- messages.push(message);
543
- }
544
- return messages;
545
- }
546
- toConversationMessage(entry, verbose) {
547
- if (entry.type === 'session_meta') return null;
548
- const payloadType = entry.payload?.type;
549
- if (entry.type === 'response_item' && payloadType === 'message') {
550
- const role = this.mapCodexRole(entry.payload?.role, verbose);
551
- const text = this.extractContentText(entry.payload?.content);
552
- if (!role || !text) return null;
553
- return {
554
- role,
555
- content: text,
556
- timestamp: entry.timestamp
557
- };
558
- }
559
- if (entry.type === 'event_msg' && payloadType === 'item_completed') {
560
- const item = entry.payload?.item;
561
- const role = this.mapCodexItemRole(item?.type, verbose);
562
- const text = this.extractContentText(item?.content);
563
- if (!role || !text) return null;
564
- return {
565
- role,
566
- content: text,
567
- timestamp: entry.timestamp
568
- };
569
- }
570
- if (!payloadType) return null;
571
- let role;
572
- if (payloadType === 'user_message') {
573
- role = 'user';
574
- } else if (payloadType === 'agent_message' || payloadType === 'task_complete') {
575
- role = 'assistant';
576
- } else if (verbose) {
577
- role = 'system';
578
- } else {
579
- return null;
580
- }
581
- const text = entry.payload?.message?.trim();
582
- if (!text) return null;
583
- return {
584
- role,
585
- content: text,
586
- timestamp: entry.timestamp
587
- };
588
- }
589
- mapCodexRole(role, verbose) {
590
- if (role === 'user') return 'user';
591
- if (role === 'assistant') return 'assistant';
592
- return verbose ? 'system' : null;
593
- }
594
- mapCodexItemRole(itemType, verbose) {
595
- if (itemType === 'AgentMessage') return 'assistant';
596
- if (itemType === 'UserMessage') return 'user';
597
- return verbose ? 'system' : null;
598
- }
599
- mirroredMessageKey(entry, message) {
600
- const turnId = entry.payload?.turn_id || entry.payload?.internal_chat_message_metadata_passthrough?.turn_id;
601
- if (!turnId) return null;
602
- return `${turnId}\0${message.role}\0${message.content}`;
603
- }
604
- extractContentText(content) {
605
- if (typeof content === 'string') return content.trim();
606
- if (!Array.isArray(content)) return '';
607
- return content.map((part)=>part.text).filter((text)=>typeof text === 'string' && text.trim().length > 0).map((text)=>text.trim()).join('\n').trim();
608
- }
609
- async listSessions(opts) {
610
- if (!isDirectory(this.codexSessionsDir)) return [];
611
- const files = this.collectAllSessionFiles();
612
- const summaries = [];
613
- for (const filePath of files){
614
- const summary = this.fileToSessionSummary(filePath);
615
- if (!summary) continue;
616
- if (opts?.cwd !== undefined && summary.cwd !== opts.cwd) continue;
617
- summaries.push(summary);
618
- }
619
- return summaries;
620
- }
621
- /**
622
- * Walk every YYYY/MM/DD directory under `codexSessionsDir` and return
623
- * absolute paths of `.jsonl` files. Tolerates malformed layouts
624
- * (skips entries that aren't directories at the expected depth).
625
- */ collectAllSessionFiles() {
626
- const out = [];
627
- for (const yearEntry of safeReaddir(this.codexSessionsDir)){
628
- const yearDir = path.join(this.codexSessionsDir, yearEntry);
629
- if (!isDirectory(yearDir)) continue;
630
- for (const monthEntry of safeReaddir(yearDir)){
631
- const monthDir = path.join(yearDir, monthEntry);
632
- if (!isDirectory(monthDir)) continue;
633
- for (const dayEntry of safeReaddir(monthDir)){
634
- const dayDir = path.join(monthDir, dayEntry);
635
- if (!isDirectory(dayDir)) continue;
636
- for (const fileEntry of safeReaddir(dayDir)){
637
- if (!fileEntry.endsWith('.jsonl')) continue;
638
- out.push(path.join(dayDir, fileEntry));
639
- }
640
- }
641
- }
642
- }
643
- return out;
644
- }
645
- collectSessionFilesInDateDirs(dateDirs) {
646
- const out = [];
647
- for (const dayDir of dateDirs){
648
- for (const fileEntry of safeReaddir(dayDir)){
649
- if (!fileEntry.endsWith('.jsonl')) continue;
650
- out.push(path.join(dayDir, fileEntry));
651
- }
652
- }
653
- return out;
654
- }
655
- /**
656
- * Read a Codex session JSONL file and produce a {@link SessionSummary}.
657
- * Returns null when the file is unreadable, has no `session_meta`, or
658
- * lacks a session id.
659
- */ fileToSessionSummary(filePath) {
660
- const content = safeReadFile(filePath);
661
- if (content === undefined) return null;
662
- const allLines = content.trim().split('\n');
663
- if (!allLines[0]) return null;
664
- let metaEntry;
665
- try {
666
- metaEntry = JSON.parse(allLines[0]);
667
- } catch {
668
- return null;
669
- }
670
- if (metaEntry.type !== 'session_meta' || !metaEntry.payload?.id) {
671
- return null;
672
- }
673
- let firstUserMessage = '';
674
- let lastTimestamp = null;
675
- for(let i = 1; i < allLines.length; i++){
676
- let entry;
677
- try {
678
- entry = JSON.parse(allLines[i]);
679
- } catch {
680
- continue;
681
- }
682
- const ts = this.parseTimestamp(entry.timestamp);
683
- if (ts) lastTimestamp = ts;
684
- if (!firstUserMessage) {
685
- const message = this.toConversationMessage(entry, false);
686
- const content = message?.content.trim() ?? '';
687
- if (message?.role === 'user' && content.length > 0 && !this.isSyntheticUserMessage(content)) {
688
- firstUserMessage = content;
689
- }
690
- }
691
- }
692
- const stat = safeStat(filePath);
693
- const startedAt = this.parseTimestamp(metaEntry.payload.timestamp) || lastTimestamp || stat?.birthtime || stat?.mtime || new Date();
694
- const lastActive = lastTimestamp || startedAt;
695
- return {
696
- type: 'codex',
697
- sessionId: metaEntry.payload.id,
698
- cwd: metaEntry.payload.cwd || '',
699
- firstUserMessage,
700
- lastActive,
701
- startedAt,
702
- sessionFilePath: filePath
703
- };
704
- }
705
- isSyntheticUserMessage(content) {
706
- return content.startsWith('<environment_context>') && content.includes('</environment_context>');
707
- }
708
- }
709
-
710
- //# sourceMappingURL=CodexAdapter.js.map